69232be8c170ebada9434f256442074b4c3e0cec
[p5sagit/p5-mst-13.2.git] / sv.c
1 /*    sv.c
2  *
3  *    Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
4  *    2000, 2001, 2002, 2003, 2004, 2005, 2006, by Larry Wall and others
5  *
6  *    You may distribute under the terms of either the GNU General Public
7  *    License or the Artistic License, as specified in the README file.
8  *
9  * "I wonder what the Entish is for 'yes' and 'no'," he thought.
10  *
11  *
12  * This file contains the code that creates, manipulates and destroys
13  * scalar values (SVs). The other types (AV, HV, GV, etc.) reuse the
14  * structure of an SV, so their creation and destruction is handled
15  * here; higher-level functions are in av.c, hv.c, and so on. Opcode
16  * level functions (eg. substr, split, join) for each of the types are
17  * in the pp*.c files.
18  */
19
20 #include "EXTERN.h"
21 #define PERL_IN_SV_C
22 #include "perl.h"
23 #include "regcomp.h"
24
25 #define FCALL *f
26
27 #ifdef __Lynx__
28 /* Missing proto on LynxOS */
29   char *gconvert(double, int, int,  char *);
30 #endif
31
32 #ifdef PERL_UTF8_CACHE_ASSERT
33 /* The cache element 0 is the Unicode offset;
34  * the cache element 1 is the byte offset of the element 0;
35  * the cache element 2 is the Unicode length of the substring;
36  * the cache element 3 is the byte length of the substring;
37  * The checking of the substring side would be good
38  * but substr() has enough code paths to make my head spin;
39  * if adding more checks watch out for the following tests:
40  *   t/op/index.t t/op/length.t t/op/pat.t t/op/substr.t
41  *   lib/utf8.t lib/Unicode/Collate/t/index.t
42  * --jhi
43  */
44 #define ASSERT_UTF8_CACHE(cache) \
45     STMT_START { if (cache) { assert((cache)[0] <= (cache)[1]); } } STMT_END
46 #else
47 #define ASSERT_UTF8_CACHE(cache) NOOP
48 #endif
49
50 #ifdef PERL_OLD_COPY_ON_WRITE
51 #define SV_COW_NEXT_SV(sv)      INT2PTR(SV *,SvUVX(sv))
52 #define SV_COW_NEXT_SV_SET(current,next)        SvUV_set(current, PTR2UV(next))
53 /* This is a pessimistic view. Scalar must be purely a read-write PV to copy-
54    on-write.  */
55 #endif
56
57 /* ============================================================================
58
59 =head1 Allocation and deallocation of SVs.
60
61 An SV (or AV, HV, etc.) is allocated in two parts: the head (struct
62 sv, av, hv...) contains type and reference count information, and for
63 many types, a pointer to the body (struct xrv, xpv, xpviv...), which
64 contains fields specific to each type.  Some types store all they need
65 in the head, so don't have a body.
66
67 In all but the most memory-paranoid configuations (ex: PURIFY), heads
68 and bodies are allocated out of arenas, which by default are
69 approximately 4K chunks of memory parcelled up into N heads or bodies.
70 Sv-bodies are allocated by their sv-type, guaranteeing size
71 consistency needed to allocate safely from arrays.
72
73 For SV-heads, the first slot in each arena is reserved, and holds a
74 link to the next arena, some flags, and a note of the number of slots.
75 Snaked through each arena chain is a linked list of free items; when
76 this becomes empty, an extra arena is allocated and divided up into N
77 items which are threaded into the free list.
78
79 SV-bodies are similar, but they use arena-sets by default, which
80 separate the link and info from the arena itself, and reclaim the 1st
81 slot in the arena.  SV-bodies are further described later.
82
83 The following global variables are associated with arenas:
84
85     PL_sv_arenaroot     pointer to list of SV arenas
86     PL_sv_root          pointer to list of free SV structures
87
88     PL_body_arenas      head of linked-list of body arenas
89     PL_body_roots[]     array of pointers to list of free bodies of svtype
90                         arrays are indexed by the svtype needed
91
92 A few special SV heads are not allocated from an arena, but are
93 instead directly created in the interpreter structure, eg PL_sv_undef.
94 The size of arenas can be changed from the default by setting
95 PERL_ARENA_SIZE appropriately at compile time.
96
97 The SV arena serves the secondary purpose of allowing still-live SVs
98 to be located and destroyed during final cleanup.
99
100 At the lowest level, the macros new_SV() and del_SV() grab and free
101 an SV head.  (If debugging with -DD, del_SV() calls the function S_del_sv()
102 to return the SV to the free list with error checking.) new_SV() calls
103 more_sv() / sv_add_arena() to add an extra arena if the free list is empty.
104 SVs in the free list have their SvTYPE field set to all ones.
105
106 At the time of very final cleanup, sv_free_arenas() is called from
107 perl_destruct() to physically free all the arenas allocated since the
108 start of the interpreter.
109
110 Manipulation of any of the PL_*root pointers is protected by enclosing
111 LOCK_SV_MUTEX; ... UNLOCK_SV_MUTEX calls which should Do the Right Thing
112 if threads are enabled.
113
114 The function visit() scans the SV arenas list, and calls a specified
115 function for each SV it finds which is still live - ie which has an SvTYPE
116 other than all 1's, and a non-zero SvREFCNT. visit() is used by the
117 following functions (specified as [function that calls visit()] / [function
118 called by visit() for each SV]):
119
120     sv_report_used() / do_report_used()
121                         dump all remaining SVs (debugging aid)
122
123     sv_clean_objs() / do_clean_objs(),do_clean_named_objs()
124                         Attempt to free all objects pointed to by RVs,
125                         and, unless DISABLE_DESTRUCTOR_KLUDGE is defined,
126                         try to do the same for all objects indirectly
127                         referenced by typeglobs too.  Called once from
128                         perl_destruct(), prior to calling sv_clean_all()
129                         below.
130
131     sv_clean_all() / do_clean_all()
132                         SvREFCNT_dec(sv) each remaining SV, possibly
133                         triggering an sv_free(). It also sets the
134                         SVf_BREAK flag on the SV to indicate that the
135                         refcnt has been artificially lowered, and thus
136                         stopping sv_free() from giving spurious warnings
137                         about SVs which unexpectedly have a refcnt
138                         of zero.  called repeatedly from perl_destruct()
139                         until there are no SVs left.
140
141 =head2 Arena allocator API Summary
142
143 Private API to rest of sv.c
144
145     new_SV(),  del_SV(),
146
147     new_XIV(), del_XIV(),
148     new_XNV(), del_XNV(),
149     etc
150
151 Public API:
152
153     sv_report_used(), sv_clean_objs(), sv_clean_all(), sv_free_arenas()
154
155 =cut
156
157 ============================================================================ */
158
159 /*
160  * "A time to plant, and a time to uproot what was planted..."
161  */
162
163 /*
164  * nice_chunk and nice_chunk size need to be set
165  * and queried under the protection of sv_mutex
166  */
167 void
168 Perl_offer_nice_chunk(pTHX_ void *chunk, U32 chunk_size)
169 {
170     dVAR;
171     void *new_chunk;
172     U32 new_chunk_size;
173     LOCK_SV_MUTEX;
174     new_chunk = (void *)(chunk);
175     new_chunk_size = (chunk_size);
176     if (new_chunk_size > PL_nice_chunk_size) {
177         Safefree(PL_nice_chunk);
178         PL_nice_chunk = (char *) new_chunk;
179         PL_nice_chunk_size = new_chunk_size;
180     } else {
181         Safefree(chunk);
182     }
183     UNLOCK_SV_MUTEX;
184 }
185
186 #ifdef DEBUG_LEAKING_SCALARS
187 #  define FREE_SV_DEBUG_FILE(sv) Safefree((sv)->sv_debug_file)
188 #else
189 #  define FREE_SV_DEBUG_FILE(sv)
190 #endif
191
192 #ifdef PERL_POISON
193 #  define SvARENA_CHAIN(sv)     ((sv)->sv_u.svu_rv)
194 /* Whilst I'd love to do this, it seems that things like to check on
195    unreferenced scalars
196 #  define POSION_SV_HEAD(sv)    Poison(sv, 1, struct STRUCT_SV)
197 */
198 #  define POSION_SV_HEAD(sv)    Poison(&SvANY(sv), 1, void *), \
199                                 Poison(&SvREFCNT(sv), 1, U32)
200 #else
201 #  define SvARENA_CHAIN(sv)     SvANY(sv)
202 #  define POSION_SV_HEAD(sv)
203 #endif
204
205 #define plant_SV(p) \
206     STMT_START {                                        \
207         FREE_SV_DEBUG_FILE(p);                          \
208         POSION_SV_HEAD(p);                              \
209         SvARENA_CHAIN(p) = (void *)PL_sv_root;          \
210         SvFLAGS(p) = SVTYPEMASK;                        \
211         PL_sv_root = (p);                               \
212         --PL_sv_count;                                  \
213     } STMT_END
214
215 /* sv_mutex must be held while calling uproot_SV() */
216 #define uproot_SV(p) \
217     STMT_START {                                        \
218         (p) = PL_sv_root;                               \
219         PL_sv_root = (SV*)SvARENA_CHAIN(p);             \
220         ++PL_sv_count;                                  \
221     } STMT_END
222
223
224 /* make some more SVs by adding another arena */
225
226 /* sv_mutex must be held while calling more_sv() */
227 STATIC SV*
228 S_more_sv(pTHX)
229 {
230     dVAR;
231     SV* sv;
232
233     if (PL_nice_chunk) {
234         sv_add_arena(PL_nice_chunk, PL_nice_chunk_size, 0);
235         PL_nice_chunk = NULL;
236         PL_nice_chunk_size = 0;
237     }
238     else {
239         char *chunk;                /* must use New here to match call to */
240         Newx(chunk,PERL_ARENA_SIZE,char);  /* Safefree() in sv_free_arenas() */
241         sv_add_arena(chunk, PERL_ARENA_SIZE, 0);
242     }
243     uproot_SV(sv);
244     return sv;
245 }
246
247 /* new_SV(): return a new, empty SV head */
248
249 #ifdef DEBUG_LEAKING_SCALARS
250 /* provide a real function for a debugger to play with */
251 STATIC SV*
252 S_new_SV(pTHX)
253 {
254     SV* sv;
255
256     LOCK_SV_MUTEX;
257     if (PL_sv_root)
258         uproot_SV(sv);
259     else
260         sv = S_more_sv(aTHX);
261     UNLOCK_SV_MUTEX;
262     SvANY(sv) = 0;
263     SvREFCNT(sv) = 1;
264     SvFLAGS(sv) = 0;
265     sv->sv_debug_optype = PL_op ? PL_op->op_type : 0;
266     sv->sv_debug_line = (U16) ((PL_copline == NOLINE) ?
267         (PL_curcop ? CopLINE(PL_curcop) : 0) : PL_copline);
268     sv->sv_debug_inpad = 0;
269     sv->sv_debug_cloned = 0;
270     sv->sv_debug_file = PL_curcop ? savepv(CopFILE(PL_curcop)): NULL;
271     
272     return sv;
273 }
274 #  define new_SV(p) (p)=S_new_SV(aTHX)
275
276 #else
277 #  define new_SV(p) \
278     STMT_START {                                        \
279         LOCK_SV_MUTEX;                                  \
280         if (PL_sv_root)                                 \
281             uproot_SV(p);                               \
282         else                                            \
283             (p) = S_more_sv(aTHX);                      \
284         UNLOCK_SV_MUTEX;                                \
285         SvANY(p) = 0;                                   \
286         SvREFCNT(p) = 1;                                \
287         SvFLAGS(p) = 0;                                 \
288     } STMT_END
289 #endif
290
291
292 /* del_SV(): return an empty SV head to the free list */
293
294 #ifdef DEBUGGING
295
296 #define del_SV(p) \
297     STMT_START {                                        \
298         LOCK_SV_MUTEX;                                  \
299         if (DEBUG_D_TEST)                               \
300             del_sv(p);                                  \
301         else                                            \
302             plant_SV(p);                                \
303         UNLOCK_SV_MUTEX;                                \
304     } STMT_END
305
306 STATIC void
307 S_del_sv(pTHX_ SV *p)
308 {
309     dVAR;
310     if (DEBUG_D_TEST) {
311         SV* sva;
312         bool ok = 0;
313         for (sva = PL_sv_arenaroot; sva; sva = (SV *) SvANY(sva)) {
314             const SV * const sv = sva + 1;
315             const SV * const svend = &sva[SvREFCNT(sva)];
316             if (p >= sv && p < svend) {
317                 ok = 1;
318                 break;
319             }
320         }
321         if (!ok) {
322             if (ckWARN_d(WARN_INTERNAL))        
323                 Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
324                             "Attempt to free non-arena SV: 0x%"UVxf
325                             pTHX__FORMAT, PTR2UV(p) pTHX__VALUE);
326             return;
327         }
328     }
329     plant_SV(p);
330 }
331
332 #else /* ! DEBUGGING */
333
334 #define del_SV(p)   plant_SV(p)
335
336 #endif /* DEBUGGING */
337
338
339 /*
340 =head1 SV Manipulation Functions
341
342 =for apidoc sv_add_arena
343
344 Given a chunk of memory, link it to the head of the list of arenas,
345 and split it into a list of free SVs.
346
347 =cut
348 */
349
350 void
351 Perl_sv_add_arena(pTHX_ char *ptr, U32 size, U32 flags)
352 {
353     dVAR;
354     SV* const sva = (SV*)ptr;
355     register SV* sv;
356     register SV* svend;
357
358     /* The first SV in an arena isn't an SV. */
359     SvANY(sva) = (void *) PL_sv_arenaroot;              /* ptr to next arena */
360     SvREFCNT(sva) = size / sizeof(SV);          /* number of SV slots */
361     SvFLAGS(sva) = flags;                       /* FAKE if not to be freed */
362
363     PL_sv_arenaroot = sva;
364     PL_sv_root = sva + 1;
365
366     svend = &sva[SvREFCNT(sva) - 1];
367     sv = sva + 1;
368     while (sv < svend) {
369         SvARENA_CHAIN(sv) = (void *)(SV*)(sv + 1);
370 #ifdef DEBUGGING
371         SvREFCNT(sv) = 0;
372 #endif
373         /* Must always set typemask because it's awlays checked in on cleanup
374            when the arenas are walked looking for objects.  */
375         SvFLAGS(sv) = SVTYPEMASK;
376         sv++;
377     }
378     SvARENA_CHAIN(sv) = 0;
379 #ifdef DEBUGGING
380     SvREFCNT(sv) = 0;
381 #endif
382     SvFLAGS(sv) = SVTYPEMASK;
383 }
384
385 /* visit(): call the named function for each non-free SV in the arenas
386  * whose flags field matches the flags/mask args. */
387
388 STATIC I32
389 S_visit(pTHX_ SVFUNC_t f, U32 flags, U32 mask)
390 {
391     dVAR;
392     SV* sva;
393     I32 visited = 0;
394
395     for (sva = PL_sv_arenaroot; sva; sva = (SV*)SvANY(sva)) {
396         register const SV * const svend = &sva[SvREFCNT(sva)];
397         register SV* sv;
398         for (sv = sva + 1; sv < svend; ++sv) {
399             if (SvTYPE(sv) != SVTYPEMASK
400                     && (sv->sv_flags & mask) == flags
401                     && SvREFCNT(sv))
402             {
403                 (FCALL)(aTHX_ sv);
404                 ++visited;
405             }
406         }
407     }
408     return visited;
409 }
410
411 #ifdef DEBUGGING
412
413 /* called by sv_report_used() for each live SV */
414
415 static void
416 do_report_used(pTHX_ SV *sv)
417 {
418     if (SvTYPE(sv) != SVTYPEMASK) {
419         PerlIO_printf(Perl_debug_log, "****\n");
420         sv_dump(sv);
421     }
422 }
423 #endif
424
425 /*
426 =for apidoc sv_report_used
427
428 Dump the contents of all SVs not yet freed. (Debugging aid).
429
430 =cut
431 */
432
433 void
434 Perl_sv_report_used(pTHX)
435 {
436 #ifdef DEBUGGING
437     visit(do_report_used, 0, 0);
438 #else
439     PERL_UNUSED_CONTEXT;
440 #endif
441 }
442
443 /* called by sv_clean_objs() for each live SV */
444
445 static void
446 do_clean_objs(pTHX_ SV *ref)
447 {
448     dVAR;
449     if (SvROK(ref)) {
450         SV * const target = SvRV(ref);
451         if (SvOBJECT(target)) {
452             DEBUG_D((PerlIO_printf(Perl_debug_log, "Cleaning object ref:\n "), sv_dump(ref)));
453             if (SvWEAKREF(ref)) {
454                 sv_del_backref(target, ref);
455                 SvWEAKREF_off(ref);
456                 SvRV_set(ref, NULL);
457             } else {
458                 SvROK_off(ref);
459                 SvRV_set(ref, NULL);
460                 SvREFCNT_dec(target);
461             }
462         }
463     }
464
465     /* XXX Might want to check arrays, etc. */
466 }
467
468 /* called by sv_clean_objs() for each live SV */
469
470 #ifndef DISABLE_DESTRUCTOR_KLUDGE
471 static void
472 do_clean_named_objs(pTHX_ SV *sv)
473 {
474     dVAR;
475     if (SvTYPE(sv) == SVt_PVGV && isGV_with_GP(sv) && GvGP(sv)) {
476         if ((
477 #ifdef PERL_DONT_CREATE_GVSV
478              GvSV(sv) &&
479 #endif
480              SvOBJECT(GvSV(sv))) ||
481              (GvAV(sv) && SvOBJECT(GvAV(sv))) ||
482              (GvHV(sv) && SvOBJECT(GvHV(sv))) ||
483              (GvIO(sv) && SvOBJECT(GvIO(sv))) ||
484              (GvCV(sv) && SvOBJECT(GvCV(sv))) )
485         {
486             DEBUG_D((PerlIO_printf(Perl_debug_log, "Cleaning named glob object:\n "), sv_dump(sv)));
487             SvFLAGS(sv) |= SVf_BREAK;
488             SvREFCNT_dec(sv);
489         }
490     }
491 }
492 #endif
493
494 /*
495 =for apidoc sv_clean_objs
496
497 Attempt to destroy all objects not yet freed
498
499 =cut
500 */
501
502 void
503 Perl_sv_clean_objs(pTHX)
504 {
505     dVAR;
506     PL_in_clean_objs = TRUE;
507     visit(do_clean_objs, SVf_ROK, SVf_ROK);
508 #ifndef DISABLE_DESTRUCTOR_KLUDGE
509     /* some barnacles may yet remain, clinging to typeglobs */
510     visit(do_clean_named_objs, SVt_PVGV, SVTYPEMASK);
511 #endif
512     PL_in_clean_objs = FALSE;
513 }
514
515 /* called by sv_clean_all() for each live SV */
516
517 static void
518 do_clean_all(pTHX_ SV *sv)
519 {
520     dVAR;
521     DEBUG_D((PerlIO_printf(Perl_debug_log, "Cleaning loops: SV at 0x%"UVxf"\n", PTR2UV(sv)) ));
522     SvFLAGS(sv) |= SVf_BREAK;
523     if (PL_comppad == (AV*)sv) {
524         PL_comppad = NULL;
525         PL_curpad = NULL;
526     }
527     SvREFCNT_dec(sv);
528 }
529
530 /*
531 =for apidoc sv_clean_all
532
533 Decrement the refcnt of each remaining SV, possibly triggering a
534 cleanup. This function may have to be called multiple times to free
535 SVs which are in complex self-referential hierarchies.
536
537 =cut
538 */
539
540 I32
541 Perl_sv_clean_all(pTHX)
542 {
543     dVAR;
544     I32 cleaned;
545     PL_in_clean_all = TRUE;
546     cleaned = visit(do_clean_all, 0,0);
547     PL_in_clean_all = FALSE;
548     return cleaned;
549 }
550
551 /*
552   ARENASETS: a meta-arena implementation which separates arena-info
553   into struct arena_set, which contains an array of struct
554   arena_descs, each holding info for a single arena.  By separating
555   the meta-info from the arena, we recover the 1st slot, formerly
556   borrowed for list management.  The arena_set is about the size of an
557   arena, avoiding the needless malloc overhead of a naive linked-list
558
559   The cost is 1 arena-set malloc per ~320 arena-mallocs, + the unused
560   memory in the last arena-set (1/2 on average).  In trade, we get
561   back the 1st slot in each arena (ie 1.7% of a CV-arena, less for
562   smaller types).  The recovery of the wasted space allows use of
563   small arenas for large, rare body types,
564 */
565 struct arena_desc {
566     char       *arena;          /* the raw storage, allocated aligned */
567     size_t      size;           /* its size ~4k typ */
568     int         unit_type;      /* useful for arena audits */
569     /* info for sv-heads (eventually)
570        int count, flags;
571     */
572 };
573
574 struct arena_set;
575
576 /* Get the maximum number of elements in set[] such that struct arena_set
577    will fit within PERL_ARENA_SIZE, which is probabably just under 4K, and
578    therefore likely to be 1 aligned memory page.  */
579
580 #define ARENAS_PER_SET  ((PERL_ARENA_SIZE - sizeof(struct arena_set*) \
581                           - 2 * sizeof(int)) / sizeof (struct arena_desc))
582
583 struct arena_set {
584     struct arena_set* next;
585     int   set_size;             /* ie ARENAS_PER_SET */
586     int   curr;                 /* index of next available arena-desc */
587     struct arena_desc set[ARENAS_PER_SET];
588 };
589
590 /*
591 =for apidoc sv_free_arenas
592
593 Deallocate the memory used by all arenas. Note that all the individual SV
594 heads and bodies within the arenas must already have been freed.
595
596 =cut
597 */
598 void
599 Perl_sv_free_arenas(pTHX)
600 {
601     dVAR;
602     SV* sva;
603     SV* svanext;
604     int i;
605
606     /* Free arenas here, but be careful about fake ones.  (We assume
607        contiguity of the fake ones with the corresponding real ones.) */
608
609     for (sva = PL_sv_arenaroot; sva; sva = svanext) {
610         svanext = (SV*) SvANY(sva);
611         while (svanext && SvFAKE(svanext))
612             svanext = (SV*) SvANY(svanext);
613
614         if (!SvFAKE(sva))
615             Safefree(sva);
616     }
617
618     {
619         struct arena_set *next, *aroot = (struct arena_set*) PL_body_arenas;
620         
621         for (; aroot; aroot = next) {
622             const int max = aroot->curr;
623             for (i=0; i<max; i++) {
624                 assert(aroot->set[i].arena);
625                 Safefree(aroot->set[i].arena);
626             }
627             next = aroot->next;
628             Safefree(aroot);
629         }
630     }
631     PL_body_arenas = 0;
632
633     for (i=0; i<PERL_ARENA_ROOTS_SIZE; i++)
634         PL_body_roots[i] = 0;
635
636     Safefree(PL_nice_chunk);
637     PL_nice_chunk = NULL;
638     PL_nice_chunk_size = 0;
639     PL_sv_arenaroot = 0;
640     PL_sv_root = 0;
641 }
642
643 /*
644   Here are mid-level routines that manage the allocation of bodies out
645   of the various arenas.  There are 5 kinds of arenas:
646
647   1. SV-head arenas, which are discussed and handled above
648   2. regular body arenas
649   3. arenas for reduced-size bodies
650   4. Hash-Entry arenas
651   5. pte arenas (thread related)
652
653   Arena types 2 & 3 are chained by body-type off an array of
654   arena-root pointers, which is indexed by svtype.  Some of the
655   larger/less used body types are malloced singly, since a large
656   unused block of them is wasteful.  Also, several svtypes dont have
657   bodies; the data fits into the sv-head itself.  The arena-root
658   pointer thus has a few unused root-pointers (which may be hijacked
659   later for arena types 4,5)
660
661   3 differs from 2 as an optimization; some body types have several
662   unused fields in the front of the structure (which are kept in-place
663   for consistency).  These bodies can be allocated in smaller chunks,
664   because the leading fields arent accessed.  Pointers to such bodies
665   are decremented to point at the unused 'ghost' memory, knowing that
666   the pointers are used with offsets to the real memory.
667
668   HE, HEK arenas are managed separately, with separate code, but may
669   be merge-able later..
670
671   PTE arenas are not sv-bodies, but they share these mid-level
672   mechanics, so are considered here.  The new mid-level mechanics rely
673   on the sv_type of the body being allocated, so we just reserve one
674   of the unused body-slots for PTEs, then use it in those (2) PTE
675   contexts below (line ~10k)
676 */
677
678 /* get_arena(size): this creates custom-sized arenas
679    TBD: export properly for hv.c: S_more_he().
680 */
681 void*
682 Perl_get_arena(pTHX_ int arena_size)
683 {
684     struct arena_desc* adesc;
685     struct arena_set *newroot, **aroot = (struct arena_set**) &PL_body_arenas;
686     int curr;
687
688     /* shouldnt need this
689     if (!arena_size)    arena_size = PERL_ARENA_SIZE;
690     */
691
692     /* may need new arena-set to hold new arena */
693     if (!*aroot || (*aroot)->curr >= (*aroot)->set_size) {
694         Newxz(newroot, 1, struct arena_set);
695         newroot->set_size = ARENAS_PER_SET;
696         newroot->next = *aroot;
697         *aroot = newroot;
698         DEBUG_m(PerlIO_printf(Perl_debug_log, "new arenaset %p\n", *aroot));
699     }
700
701     /* ok, now have arena-set with at least 1 empty/available arena-desc */
702     curr = (*aroot)->curr++;
703     adesc = &((*aroot)->set[curr]);
704     assert(!adesc->arena);
705     
706     Newxz(adesc->arena, arena_size, char);
707     adesc->size = arena_size;
708     DEBUG_m(PerlIO_printf(Perl_debug_log, "arena %d added: %p size %d\n", 
709                           curr, adesc->arena, arena_size));
710
711     return adesc->arena;
712 }
713
714
715 /* return a thing to the free list */
716
717 #define del_body(thing, root)                   \
718     STMT_START {                                \
719         void ** const thing_copy = (void **)thing;\
720         LOCK_SV_MUTEX;                          \
721         *thing_copy = *root;                    \
722         *root = (void*)thing_copy;              \
723         UNLOCK_SV_MUTEX;                        \
724     } STMT_END
725
726 /* 
727
728 =head1 SV-Body Allocation
729
730 Allocation of SV-bodies is similar to SV-heads, differing as follows;
731 the allocation mechanism is used for many body types, so is somewhat
732 more complicated, it uses arena-sets, and has no need for still-live
733 SV detection.
734
735 At the outermost level, (new|del)_X*V macros return bodies of the
736 appropriate type.  These macros call either (new|del)_body_type or
737 (new|del)_body_allocated macro pairs, depending on specifics of the
738 type.  Most body types use the former pair, the latter pair is used to
739 allocate body types with "ghost fields".
740
741 "ghost fields" are fields that are unused in certain types, and
742 consequently dont need to actually exist.  They are declared because
743 they're part of a "base type", which allows use of functions as
744 methods.  The simplest examples are AVs and HVs, 2 aggregate types
745 which don't use the fields which support SCALAR semantics.
746
747 For these types, the arenas are carved up into *_allocated size
748 chunks, we thus avoid wasted memory for those unaccessed members.
749 When bodies are allocated, we adjust the pointer back in memory by the
750 size of the bit not allocated, so it's as if we allocated the full
751 structure.  (But things will all go boom if you write to the part that
752 is "not there", because you'll be overwriting the last members of the
753 preceding structure in memory.)
754
755 We calculate the correction using the STRUCT_OFFSET macro. For
756 example, if xpv_allocated is the same structure as XPV then the two
757 OFFSETs sum to zero, and the pointer is unchanged. If the allocated
758 structure is smaller (no initial NV actually allocated) then the net
759 effect is to subtract the size of the NV from the pointer, to return a
760 new pointer as if an initial NV were actually allocated.
761
762 This is the same trick as was used for NV and IV bodies. Ironically it
763 doesn't need to be used for NV bodies any more, because NV is now at
764 the start of the structure. IV bodies don't need it either, because
765 they are no longer allocated.
766
767 In turn, the new_body_* allocators call S_new_body(), which invokes
768 new_body_inline macro, which takes a lock, and takes a body off the
769 linked list at PL_body_roots[sv_type], calling S_more_bodies() if
770 necessary to refresh an empty list.  Then the lock is released, and
771 the body is returned.
772
773 S_more_bodies calls get_arena(), and carves it up into an array of N
774 bodies, which it strings into a linked list.  It looks up arena-size
775 and body-size from the body_details table described below, thus
776 supporting the multiple body-types.
777
778 If PURIFY is defined, or PERL_ARENA_SIZE=0, arenas are not used, and
779 the (new|del)_X*V macros are mapped directly to malloc/free.
780
781 */
782
783 /* 
784
785 For each sv-type, struct body_details bodies_by_type[] carries
786 parameters which control these aspects of SV handling:
787
788 Arena_size determines whether arenas are used for this body type, and if
789 so, how big they are.  PURIFY or PERL_ARENA_SIZE=0 set this field to
790 zero, forcing individual mallocs and frees.
791
792 Body_size determines how big a body is, and therefore how many fit into
793 each arena.  Offset carries the body-pointer adjustment needed for
794 *_allocated body types, and is used in *_allocated macros.
795
796 But its main purpose is to parameterize info needed in
797 Perl_sv_upgrade().  The info here dramatically simplifies the function
798 vs the implementation in 5.8.7, making it table-driven.  All fields
799 are used for this, except for arena_size.
800
801 For the sv-types that have no bodies, arenas are not used, so those
802 PL_body_roots[sv_type] are unused, and can be overloaded.  In
803 something of a special case, SVt_NULL is borrowed for HE arenas;
804 PL_body_roots[SVt_NULL] is filled by S_more_he, but the
805 bodies_by_type[SVt_NULL] slot is not used, as the table is not
806 available in hv.c,
807
808 PTEs also use arenas, but are never seen in Perl_sv_upgrade.
809 Nonetheless, they get their own slot in bodies_by_type[SVt_NULL], so
810 they can just use the same allocation semantics.  At first, PTEs were
811 also overloaded to a non-body sv-type, but this yielded hard-to-find
812 malloc bugs, so was simplified by claiming a new slot.  This choice
813 has no consequence at this time.
814
815 */
816
817 struct body_details {
818     U8 body_size;       /* Size to allocate  */
819     U8 copy;            /* Size of structure to copy (may be shorter)  */
820     U8 offset;
821     unsigned int type : 4;          /* We have space for a sanity check.  */
822     unsigned int cant_upgrade : 1;  /* Cannot upgrade this type */
823     unsigned int zero_nv : 1;       /* zero the NV when upgrading from this */
824     unsigned int arena : 1;         /* Allocated from an arena */
825     size_t arena_size;              /* Size of arena to allocate */
826 };
827
828 #define HADNV FALSE
829 #define NONV TRUE
830
831
832 #ifdef PURIFY
833 /* With -DPURFIY we allocate everything directly, and don't use arenas.
834    This seems a rather elegant way to simplify some of the code below.  */
835 #define HASARENA FALSE
836 #else
837 #define HASARENA TRUE
838 #endif
839 #define NOARENA FALSE
840
841 /* Size the arenas to exactly fit a given number of bodies.  A count
842    of 0 fits the max number bodies into a PERL_ARENA_SIZE.block,
843    simplifying the default.  If count > 0, the arena is sized to fit
844    only that many bodies, allowing arenas to be used for large, rare
845    bodies (XPVFM, XPVIO) without undue waste.  The arena size is
846    limited by PERL_ARENA_SIZE, so we can safely oversize the
847    declarations.
848  */
849 #define FIT_ARENA0(body_size)                           \
850     ((size_t)(PERL_ARENA_SIZE / body_size) * body_size)
851 #define FIT_ARENAn(count,body_size)                     \
852     ( count * body_size <= PERL_ARENA_SIZE)             \
853     ? count * body_size                                 \
854     : FIT_ARENA0 (body_size)
855 #define FIT_ARENA(count,body_size)                      \
856     count                                               \
857     ? FIT_ARENAn (count, body_size)                     \
858     : FIT_ARENA0 (body_size)
859
860 /* A macro to work out the offset needed to subtract from a pointer to (say)
861
862 typedef struct {
863     STRLEN      xpv_cur;
864     STRLEN      xpv_len;
865 } xpv_allocated;
866
867 to make its members accessible via a pointer to (say)
868
869 struct xpv {
870     NV          xnv_nv;
871     STRLEN      xpv_cur;
872     STRLEN      xpv_len;
873 };
874
875 */
876
877 #define relative_STRUCT_OFFSET(longer, shorter, member) \
878     (STRUCT_OFFSET(shorter, member) - STRUCT_OFFSET(longer, member))
879
880 /* Calculate the length to copy. Specifically work out the length less any
881    final padding the compiler needed to add.  See the comment in sv_upgrade
882    for why copying the padding proved to be a bug.  */
883
884 #define copy_length(type, last_member) \
885         STRUCT_OFFSET(type, last_member) \
886         + sizeof (((type*)SvANY((SV*)0))->last_member)
887
888 static const struct body_details bodies_by_type[] = {
889     { sizeof(HE), 0, 0, SVt_NULL,
890       FALSE, NONV, NOARENA, FIT_ARENA(0, sizeof(HE)) },
891
892     /* IVs are in the head, so the allocation size is 0.
893        However, the slot is overloaded for PTEs.  */
894     { sizeof(struct ptr_tbl_ent), /* This is used for PTEs.  */
895       sizeof(IV), /* This is used to copy out the IV body.  */
896       STRUCT_OFFSET(XPVIV, xiv_iv), SVt_IV, FALSE, NONV,
897       NOARENA /* IVS don't need an arena  */,
898       /* But PTEs need to know the size of their arena  */
899       FIT_ARENA(0, sizeof(struct ptr_tbl_ent))
900     },
901
902     /* 8 bytes on most ILP32 with IEEE doubles */
903     { sizeof(NV), sizeof(NV), 0, SVt_NV, FALSE, HADNV, HASARENA,
904       FIT_ARENA(0, sizeof(NV)) },
905
906     /* RVs are in the head now.  */
907     { 0, 0, 0, SVt_RV, FALSE, NONV, NOARENA, 0 },
908
909     /* 8 bytes on most ILP32 with IEEE doubles */
910     { sizeof(xpv_allocated),
911       copy_length(XPV, xpv_len)
912       - relative_STRUCT_OFFSET(xpv_allocated, XPV, xpv_cur),
913       + relative_STRUCT_OFFSET(xpv_allocated, XPV, xpv_cur),
914       SVt_PV, FALSE, NONV, HASARENA, FIT_ARENA(0, sizeof(xpv_allocated)) },
915
916     /* 12 */
917     { sizeof(xpviv_allocated),
918       copy_length(XPVIV, xiv_u)
919       - relative_STRUCT_OFFSET(xpviv_allocated, XPVIV, xpv_cur),
920       + relative_STRUCT_OFFSET(xpviv_allocated, XPVIV, xpv_cur),
921       SVt_PVIV, FALSE, NONV, HASARENA, FIT_ARENA(0, sizeof(xpviv_allocated)) },
922
923     /* 20 */
924     { sizeof(XPVNV), copy_length(XPVNV, xiv_u), 0, SVt_PVNV, FALSE, HADNV,
925       HASARENA, FIT_ARENA(0, sizeof(XPVNV)) },
926
927     /* 28 */
928     { sizeof(XPVMG), copy_length(XPVMG, xmg_stash), 0, SVt_PVMG, FALSE, HADNV,
929       HASARENA, FIT_ARENA(0, sizeof(XPVMG)) },
930     
931     /* 36 */
932     { sizeof(XPVBM), sizeof(XPVBM), 0, SVt_PVBM, TRUE, HADNV,
933       HASARENA, FIT_ARENA(0, sizeof(XPVBM)) },
934
935     /* 48 */
936     { sizeof(XPVGV), sizeof(XPVGV), 0, SVt_PVGV, TRUE, HADNV,
937       HASARENA, FIT_ARENA(0, sizeof(XPVGV)) },
938     
939     /* 64 */
940     { sizeof(XPVLV), sizeof(XPVLV), 0, SVt_PVLV, TRUE, HADNV,
941       HASARENA, FIT_ARENA(0, sizeof(XPVLV)) },
942
943     { sizeof(xpvav_allocated),
944       copy_length(XPVAV, xmg_stash)
945       - relative_STRUCT_OFFSET(xpvav_allocated, XPVAV, xav_fill),
946       + relative_STRUCT_OFFSET(xpvav_allocated, XPVAV, xav_fill),
947       SVt_PVAV, TRUE, HADNV, HASARENA, FIT_ARENA(0, sizeof(xpvav_allocated)) },
948
949     { sizeof(xpvhv_allocated),
950       copy_length(XPVHV, xmg_stash)
951       - relative_STRUCT_OFFSET(xpvhv_allocated, XPVHV, xhv_fill),
952       + relative_STRUCT_OFFSET(xpvhv_allocated, XPVHV, xhv_fill),
953       SVt_PVHV, TRUE, HADNV, HASARENA, FIT_ARENA(0, sizeof(xpvhv_allocated)) },
954
955     /* 56 */
956     { sizeof(xpvcv_allocated), sizeof(xpvcv_allocated),
957       + relative_STRUCT_OFFSET(xpvcv_allocated, XPVCV, xpv_cur),
958       SVt_PVCV, TRUE, NONV, HASARENA, FIT_ARENA(0, sizeof(xpvcv_allocated)) },
959
960     { sizeof(xpvfm_allocated), sizeof(xpvfm_allocated),
961       + relative_STRUCT_OFFSET(xpvfm_allocated, XPVFM, xpv_cur),
962       SVt_PVFM, TRUE, NONV, NOARENA, FIT_ARENA(20, sizeof(xpvfm_allocated)) },
963
964     /* XPVIO is 84 bytes, fits 48x */
965     { sizeof(XPVIO), sizeof(XPVIO), 0, SVt_PVIO, TRUE, HADNV,
966       HASARENA, FIT_ARENA(24, sizeof(XPVIO)) },
967 };
968
969 #define new_body_type(sv_type)          \
970     (void *)((char *)S_new_body(aTHX_ sv_type))
971
972 #define del_body_type(p, sv_type)       \
973     del_body(p, &PL_body_roots[sv_type])
974
975
976 #define new_body_allocated(sv_type)             \
977     (void *)((char *)S_new_body(aTHX_ sv_type)  \
978              - bodies_by_type[sv_type].offset)
979
980 #define del_body_allocated(p, sv_type)          \
981     del_body(p + bodies_by_type[sv_type].offset, &PL_body_roots[sv_type])
982
983
984 #define my_safemalloc(s)        (void*)safemalloc(s)
985 #define my_safecalloc(s)        (void*)safecalloc(s, 1)
986 #define my_safefree(p)  safefree((char*)p)
987
988 #ifdef PURIFY
989
990 #define new_XNV()       my_safemalloc(sizeof(XPVNV))
991 #define del_XNV(p)      my_safefree(p)
992
993 #define new_XPVNV()     my_safemalloc(sizeof(XPVNV))
994 #define del_XPVNV(p)    my_safefree(p)
995
996 #define new_XPVAV()     my_safemalloc(sizeof(XPVAV))
997 #define del_XPVAV(p)    my_safefree(p)
998
999 #define new_XPVHV()     my_safemalloc(sizeof(XPVHV))
1000 #define del_XPVHV(p)    my_safefree(p)
1001
1002 #define new_XPVMG()     my_safemalloc(sizeof(XPVMG))
1003 #define del_XPVMG(p)    my_safefree(p)
1004
1005 #define new_XPVGV()     my_safemalloc(sizeof(XPVGV))
1006 #define del_XPVGV(p)    my_safefree(p)
1007
1008 #else /* !PURIFY */
1009
1010 #define new_XNV()       new_body_type(SVt_NV)
1011 #define del_XNV(p)      del_body_type(p, SVt_NV)
1012
1013 #define new_XPVNV()     new_body_type(SVt_PVNV)
1014 #define del_XPVNV(p)    del_body_type(p, SVt_PVNV)
1015
1016 #define new_XPVAV()     new_body_allocated(SVt_PVAV)
1017 #define del_XPVAV(p)    del_body_allocated(p, SVt_PVAV)
1018
1019 #define new_XPVHV()     new_body_allocated(SVt_PVHV)
1020 #define del_XPVHV(p)    del_body_allocated(p, SVt_PVHV)
1021
1022 #define new_XPVMG()     new_body_type(SVt_PVMG)
1023 #define del_XPVMG(p)    del_body_type(p, SVt_PVMG)
1024
1025 #define new_XPVGV()     new_body_type(SVt_PVGV)
1026 #define del_XPVGV(p)    del_body_type(p, SVt_PVGV)
1027
1028 #endif /* PURIFY */
1029
1030 /* no arena for you! */
1031
1032 #define new_NOARENA(details) \
1033         my_safemalloc((details)->body_size + (details)->offset)
1034 #define new_NOARENAZ(details) \
1035         my_safecalloc((details)->body_size + (details)->offset)
1036
1037 #ifdef DEBUGGING
1038 static bool done_sanity_check;
1039 #endif
1040
1041 STATIC void *
1042 S_more_bodies (pTHX_ svtype sv_type)
1043 {
1044     dVAR;
1045     void ** const root = &PL_body_roots[sv_type];
1046     const struct body_details * const bdp = &bodies_by_type[sv_type];
1047     const size_t body_size = bdp->body_size;
1048     char *start;
1049     const char *end;
1050
1051     assert(bdp->arena_size);
1052
1053 #ifdef DEBUGGING
1054     if (!done_sanity_check) {
1055         unsigned int i = SVt_LAST;
1056
1057         done_sanity_check = TRUE;
1058
1059         while (i--)
1060             assert (bodies_by_type[i].type == i);
1061     }
1062 #endif
1063
1064     start = (char*) Perl_get_arena(aTHX_ bdp->arena_size);
1065
1066     end = start + bdp->arena_size - body_size;
1067
1068     /* computed count doesnt reflect the 1st slot reservation */
1069     DEBUG_m(PerlIO_printf(Perl_debug_log,
1070                           "arena %p end %p arena-size %d type %d size %d ct %d\n",
1071                           start, end, bdp->arena_size, sv_type, body_size,
1072                           bdp->arena_size / body_size));
1073
1074     *root = (void *)start;
1075
1076     while (start < end) {
1077         char * const next = start + body_size;
1078         *(void**) start = (void *)next;
1079         start = next;
1080     }
1081     *(void **)start = 0;
1082
1083     return *root;
1084 }
1085
1086 /* grab a new thing from the free list, allocating more if necessary.
1087    The inline version is used for speed in hot routines, and the
1088    function using it serves the rest (unless PURIFY).
1089 */
1090 #define new_body_inline(xpv, sv_type) \
1091     STMT_START { \
1092         void ** const r3wt = &PL_body_roots[sv_type]; \
1093         LOCK_SV_MUTEX; \
1094         xpv = *((void **)(r3wt)) \
1095           ? *((void **)(r3wt)) : S_more_bodies(aTHX_ sv_type); \
1096         *(r3wt) = *(void**)(xpv); \
1097         UNLOCK_SV_MUTEX; \
1098     } STMT_END
1099
1100 #ifndef PURIFY
1101
1102 STATIC void *
1103 S_new_body(pTHX_ svtype sv_type)
1104 {
1105     dVAR;
1106     void *xpv;
1107     new_body_inline(xpv, sv_type);
1108     return xpv;
1109 }
1110
1111 #endif
1112
1113 /*
1114 =for apidoc sv_upgrade
1115
1116 Upgrade an SV to a more complex form.  Generally adds a new body type to the
1117 SV, then copies across as much information as possible from the old body.
1118 You generally want to use the C<SvUPGRADE> macro wrapper. See also C<svtype>.
1119
1120 =cut
1121 */
1122
1123 void
1124 Perl_sv_upgrade(pTHX_ register SV *sv, U32 new_type)
1125 {
1126     dVAR;
1127     void*       old_body;
1128     void*       new_body;
1129     const U32   old_type = SvTYPE(sv);
1130     const struct body_details *new_type_details;
1131     const struct body_details *const old_type_details
1132         = bodies_by_type + old_type;
1133
1134     if (new_type != SVt_PV && SvIsCOW(sv)) {
1135         sv_force_normal_flags(sv, 0);
1136     }
1137
1138     if (old_type == new_type)
1139         return;
1140
1141     if (old_type > new_type)
1142         Perl_croak(aTHX_ "sv_upgrade from type %d down to type %d",
1143                 (int)old_type, (int)new_type);
1144
1145
1146     old_body = SvANY(sv);
1147
1148     /* Copying structures onto other structures that have been neatly zeroed
1149        has a subtle gotcha. Consider XPVMG
1150
1151        +------+------+------+------+------+-------+-------+
1152        |     NV      | CUR  | LEN  |  IV  | MAGIC | STASH |
1153        +------+------+------+------+------+-------+-------+
1154        0      4      8     12     16     20      24      28
1155
1156        where NVs are aligned to 8 bytes, so that sizeof that structure is
1157        actually 32 bytes long, with 4 bytes of padding at the end:
1158
1159        +------+------+------+------+------+-------+-------+------+
1160        |     NV      | CUR  | LEN  |  IV  | MAGIC | STASH | ???  |
1161        +------+------+------+------+------+-------+-------+------+
1162        0      4      8     12     16     20      24      28     32
1163
1164        so what happens if you allocate memory for this structure:
1165
1166        +------+------+------+------+------+-------+-------+------+------+...
1167        |     NV      | CUR  | LEN  |  IV  | MAGIC | STASH |  GP  | NAME |
1168        +------+------+------+------+------+-------+-------+------+------+...
1169        0      4      8     12     16     20      24      28     32     36
1170
1171        zero it, then copy sizeof(XPVMG) bytes on top of it? Not quite what you
1172        expect, because you copy the area marked ??? onto GP. Now, ??? may have
1173        started out as zero once, but it's quite possible that it isn't. So now,
1174        rather than a nicely zeroed GP, you have it pointing somewhere random.
1175        Bugs ensue.
1176
1177        (In fact, GP ends up pointing at a previous GP structure, because the
1178        principle cause of the padding in XPVMG getting garbage is a copy of
1179        sizeof(XPVMG) bytes from a XPVGV structure in sv_unglob)
1180
1181        So we are careful and work out the size of used parts of all the
1182        structures.  */
1183
1184     switch (old_type) {
1185     case SVt_NULL:
1186         break;
1187     case SVt_IV:
1188         if (new_type < SVt_PVIV) {
1189             new_type = (new_type == SVt_NV)
1190                 ? SVt_PVNV : SVt_PVIV;
1191         }
1192         break;
1193     case SVt_NV:
1194         if (new_type < SVt_PVNV) {
1195             new_type = SVt_PVNV;
1196         }
1197         break;
1198     case SVt_RV:
1199         break;
1200     case SVt_PV:
1201         assert(new_type > SVt_PV);
1202         assert(SVt_IV < SVt_PV);
1203         assert(SVt_NV < SVt_PV);
1204         break;
1205     case SVt_PVIV:
1206         break;
1207     case SVt_PVNV:
1208         break;
1209     case SVt_PVMG:
1210         /* Because the XPVMG of PL_mess_sv isn't allocated from the arena,
1211            there's no way that it can be safely upgraded, because perl.c
1212            expects to Safefree(SvANY(PL_mess_sv))  */
1213         assert(sv != PL_mess_sv);
1214         /* This flag bit is used to mean other things in other scalar types.
1215            Given that it only has meaning inside the pad, it shouldn't be set
1216            on anything that can get upgraded.  */
1217         assert(!SvPAD_TYPED(sv));
1218         break;
1219     default:
1220         if (old_type_details->cant_upgrade)
1221             Perl_croak(aTHX_ "Can't upgrade %s (%" UVuf ") to %" UVuf,
1222                        sv_reftype(sv, 0), (UV) old_type, (UV) new_type);
1223     }
1224     new_type_details = bodies_by_type + new_type;
1225
1226     SvFLAGS(sv) &= ~SVTYPEMASK;
1227     SvFLAGS(sv) |= new_type;
1228
1229     /* This can't happen, as SVt_NULL is <= all values of new_type, so one of
1230        the return statements above will have triggered.  */
1231     assert (new_type != SVt_NULL);
1232     switch (new_type) {
1233     case SVt_IV:
1234         assert(old_type == SVt_NULL);
1235         SvANY(sv) = (XPVIV*)((char*)&(sv->sv_u.svu_iv) - STRUCT_OFFSET(XPVIV, xiv_iv));
1236         SvIV_set(sv, 0);
1237         return;
1238     case SVt_NV:
1239         assert(old_type == SVt_NULL);
1240         SvANY(sv) = new_XNV();
1241         SvNV_set(sv, 0);
1242         return;
1243     case SVt_RV:
1244         assert(old_type == SVt_NULL);
1245         SvANY(sv) = &sv->sv_u.svu_rv;
1246         SvRV_set(sv, 0);
1247         return;
1248     case SVt_PVHV:
1249     case SVt_PVAV:
1250         assert(new_type_details->body_size);
1251
1252 #ifndef PURIFY  
1253         assert(new_type_details->arena);
1254         assert(new_type_details->arena_size);
1255         /* This points to the start of the allocated area.  */
1256         new_body_inline(new_body, new_type);
1257         Zero(new_body, new_type_details->body_size, char);
1258         new_body = ((char *)new_body) - new_type_details->offset;
1259 #else
1260         /* We always allocated the full length item with PURIFY. To do this
1261            we fake things so that arena is false for all 16 types..  */
1262         new_body = new_NOARENAZ(new_type_details);
1263 #endif
1264         SvANY(sv) = new_body;
1265         if (new_type == SVt_PVAV) {
1266             AvMAX(sv)   = -1;
1267             AvFILLp(sv) = -1;
1268             AvREAL_only(sv);
1269         }
1270
1271         /* SVt_NULL isn't the only thing upgraded to AV or HV.
1272            The target created by newSVrv also is, and it can have magic.
1273            However, it never has SvPVX set.
1274         */
1275         if (old_type >= SVt_RV) {
1276             assert(SvPVX_const(sv) == 0);
1277         }
1278
1279         /* Could put this in the else clause below, as PVMG must have SvPVX
1280            0 already (the assertion above)  */
1281         SvPV_set(sv, NULL);
1282
1283         if (old_type >= SVt_PVMG) {
1284             SvMAGIC_set(sv, ((XPVMG*)old_body)->xmg_u.xmg_magic);
1285             SvSTASH_set(sv, ((XPVMG*)old_body)->xmg_stash);
1286         }
1287         break;
1288
1289
1290     case SVt_PVIV:
1291         /* XXX Is this still needed?  Was it ever needed?   Surely as there is
1292            no route from NV to PVIV, NOK can never be true  */
1293         assert(!SvNOKp(sv));
1294         assert(!SvNOK(sv));
1295     case SVt_PVIO:
1296     case SVt_PVFM:
1297     case SVt_PVBM:
1298     case SVt_PVGV:
1299     case SVt_PVCV:
1300     case SVt_PVLV:
1301     case SVt_PVMG:
1302     case SVt_PVNV:
1303     case SVt_PV:
1304
1305         assert(new_type_details->body_size);
1306         /* We always allocated the full length item with PURIFY. To do this
1307            we fake things so that arena is false for all 16 types..  */
1308         if(new_type_details->arena) {
1309             /* This points to the start of the allocated area.  */
1310             new_body_inline(new_body, new_type);
1311             Zero(new_body, new_type_details->body_size, char);
1312             new_body = ((char *)new_body) - new_type_details->offset;
1313         } else {
1314             new_body = new_NOARENAZ(new_type_details);
1315         }
1316         SvANY(sv) = new_body;
1317
1318         if (old_type_details->copy) {
1319             /* There is now the potential for an upgrade from something without
1320                an offset (PVNV or PVMG) to something with one (PVCV, PVFM)  */
1321             int offset = old_type_details->offset;
1322             int length = old_type_details->copy;
1323
1324             if (new_type_details->offset > old_type_details->offset) {
1325                 int difference
1326                     = new_type_details->offset - old_type_details->offset;
1327                 offset += difference;
1328                 length -= difference;
1329             }
1330             assert (length >= 0);
1331                 
1332             Copy((char *)old_body + offset, (char *)new_body + offset, length,
1333                  char);
1334         }
1335
1336 #ifndef NV_ZERO_IS_ALLBITS_ZERO
1337         /* If NV 0.0 is stores as all bits 0 then Zero() already creates a
1338          * correct 0.0 for us.  Otherwise, if the old body didn't have an
1339          * NV slot, but the new one does, then we need to initialise the
1340          * freshly created NV slot with whatever the correct bit pattern is
1341          * for 0.0  */
1342         if (old_type_details->zero_nv && !new_type_details->zero_nv)
1343             SvNV_set(sv, 0);
1344 #endif
1345
1346         if (new_type == SVt_PVIO)
1347             IoPAGE_LEN(sv) = 60;
1348         if (old_type < SVt_RV)
1349             SvPV_set(sv, NULL);
1350         break;
1351     default:
1352         Perl_croak(aTHX_ "panic: sv_upgrade to unknown type %lu",
1353                    (unsigned long)new_type);
1354     }
1355
1356     if (old_type_details->arena) {
1357         /* If there was an old body, then we need to free it.
1358            Note that there is an assumption that all bodies of types that
1359            can be upgraded came from arenas. Only the more complex non-
1360            upgradable types are allowed to be directly malloc()ed.  */
1361 #ifdef PURIFY
1362         my_safefree(old_body);
1363 #else
1364         del_body((void*)((char*)old_body + old_type_details->offset),
1365                  &PL_body_roots[old_type]);
1366 #endif
1367     }
1368 }
1369
1370 /*
1371 =for apidoc sv_backoff
1372
1373 Remove any string offset. You should normally use the C<SvOOK_off> macro
1374 wrapper instead.
1375
1376 =cut
1377 */
1378
1379 int
1380 Perl_sv_backoff(pTHX_ register SV *sv)
1381 {
1382     PERL_UNUSED_CONTEXT;
1383     assert(SvOOK(sv));
1384     assert(SvTYPE(sv) != SVt_PVHV);
1385     assert(SvTYPE(sv) != SVt_PVAV);
1386     if (SvIVX(sv)) {
1387         const char * const s = SvPVX_const(sv);
1388         SvLEN_set(sv, SvLEN(sv) + SvIVX(sv));
1389         SvPV_set(sv, SvPVX(sv) - SvIVX(sv));
1390         SvIV_set(sv, 0);
1391         Move(s, SvPVX(sv), SvCUR(sv)+1, char);
1392     }
1393     SvFLAGS(sv) &= ~SVf_OOK;
1394     return 0;
1395 }
1396
1397 /*
1398 =for apidoc sv_grow
1399
1400 Expands the character buffer in the SV.  If necessary, uses C<sv_unref> and
1401 upgrades the SV to C<SVt_PV>.  Returns a pointer to the character buffer.
1402 Use the C<SvGROW> wrapper instead.
1403
1404 =cut
1405 */
1406
1407 char *
1408 Perl_sv_grow(pTHX_ register SV *sv, register STRLEN newlen)
1409 {
1410     register char *s;
1411
1412     if (PL_madskills && newlen >= 0x100000) {
1413         PerlIO_printf(Perl_debug_log,
1414                       "Allocation too large: %"UVxf"\n", (UV)newlen);
1415     }
1416 #ifdef HAS_64K_LIMIT
1417     if (newlen >= 0x10000) {
1418         PerlIO_printf(Perl_debug_log,
1419                       "Allocation too large: %"UVxf"\n", (UV)newlen);
1420         my_exit(1);
1421     }
1422 #endif /* HAS_64K_LIMIT */
1423     if (SvROK(sv))
1424         sv_unref(sv);
1425     if (SvTYPE(sv) < SVt_PV) {
1426         sv_upgrade(sv, SVt_PV);
1427         s = SvPVX_mutable(sv);
1428     }
1429     else if (SvOOK(sv)) {       /* pv is offset? */
1430         sv_backoff(sv);
1431         s = SvPVX_mutable(sv);
1432         if (newlen > SvLEN(sv))
1433             newlen += 10 * (newlen - SvCUR(sv)); /* avoid copy each time */
1434 #ifdef HAS_64K_LIMIT
1435         if (newlen >= 0x10000)
1436             newlen = 0xFFFF;
1437 #endif
1438     }
1439     else
1440         s = SvPVX_mutable(sv);
1441
1442     if (newlen > SvLEN(sv)) {           /* need more room? */
1443         newlen = PERL_STRLEN_ROUNDUP(newlen);
1444         if (SvLEN(sv) && s) {
1445 #ifdef MYMALLOC
1446             const STRLEN l = malloced_size((void*)SvPVX_const(sv));
1447             if (newlen <= l) {
1448                 SvLEN_set(sv, l);
1449                 return s;
1450             } else
1451 #endif
1452             s = saferealloc(s, newlen);
1453         }
1454         else {
1455             s = safemalloc(newlen);
1456             if (SvPVX_const(sv) && SvCUR(sv)) {
1457                 Move(SvPVX_const(sv), s, (newlen < SvCUR(sv)) ? newlen : SvCUR(sv), char);
1458             }
1459         }
1460         SvPV_set(sv, s);
1461         SvLEN_set(sv, newlen);
1462     }
1463     return s;
1464 }
1465
1466 /*
1467 =for apidoc sv_setiv
1468
1469 Copies an integer into the given SV, upgrading first if necessary.
1470 Does not handle 'set' magic.  See also C<sv_setiv_mg>.
1471
1472 =cut
1473 */
1474
1475 void
1476 Perl_sv_setiv(pTHX_ register SV *sv, IV i)
1477 {
1478     dVAR;
1479     SV_CHECK_THINKFIRST_COW_DROP(sv);
1480     switch (SvTYPE(sv)) {
1481     case SVt_NULL:
1482         sv_upgrade(sv, SVt_IV);
1483         break;
1484     case SVt_NV:
1485         sv_upgrade(sv, SVt_PVNV);
1486         break;
1487     case SVt_RV:
1488     case SVt_PV:
1489         sv_upgrade(sv, SVt_PVIV);
1490         break;
1491
1492     case SVt_PVGV:
1493     case SVt_PVAV:
1494     case SVt_PVHV:
1495     case SVt_PVCV:
1496     case SVt_PVFM:
1497     case SVt_PVIO:
1498         Perl_croak(aTHX_ "Can't coerce %s to integer in %s", sv_reftype(sv,0),
1499                    OP_DESC(PL_op));
1500     }
1501     (void)SvIOK_only(sv);                       /* validate number */
1502     SvIV_set(sv, i);
1503     SvTAINT(sv);
1504 }
1505
1506 /*
1507 =for apidoc sv_setiv_mg
1508
1509 Like C<sv_setiv>, but also handles 'set' magic.
1510
1511 =cut
1512 */
1513
1514 void
1515 Perl_sv_setiv_mg(pTHX_ register SV *sv, IV i)
1516 {
1517     sv_setiv(sv,i);
1518     SvSETMAGIC(sv);
1519 }
1520
1521 /*
1522 =for apidoc sv_setuv
1523
1524 Copies an unsigned integer into the given SV, upgrading first if necessary.
1525 Does not handle 'set' magic.  See also C<sv_setuv_mg>.
1526
1527 =cut
1528 */
1529
1530 void
1531 Perl_sv_setuv(pTHX_ register SV *sv, UV u)
1532 {
1533     /* With these two if statements:
1534        u=1.49  s=0.52  cu=72.49  cs=10.64  scripts=270  tests=20865
1535
1536        without
1537        u=1.35  s=0.47  cu=73.45  cs=11.43  scripts=270  tests=20865
1538
1539        If you wish to remove them, please benchmark to see what the effect is
1540     */
1541     if (u <= (UV)IV_MAX) {
1542        sv_setiv(sv, (IV)u);
1543        return;
1544     }
1545     sv_setiv(sv, 0);
1546     SvIsUV_on(sv);
1547     SvUV_set(sv, u);
1548 }
1549
1550 /*
1551 =for apidoc sv_setuv_mg
1552
1553 Like C<sv_setuv>, but also handles 'set' magic.
1554
1555 =cut
1556 */
1557
1558 void
1559 Perl_sv_setuv_mg(pTHX_ register SV *sv, UV u)
1560 {
1561     sv_setiv(sv, 0);
1562     SvIsUV_on(sv);
1563     sv_setuv(sv,u);
1564     SvSETMAGIC(sv);
1565 }
1566
1567 /*
1568 =for apidoc sv_setnv
1569
1570 Copies a double into the given SV, upgrading first if necessary.
1571 Does not handle 'set' magic.  See also C<sv_setnv_mg>.
1572
1573 =cut
1574 */
1575
1576 void
1577 Perl_sv_setnv(pTHX_ register SV *sv, NV num)
1578 {
1579     dVAR;
1580     SV_CHECK_THINKFIRST_COW_DROP(sv);
1581     switch (SvTYPE(sv)) {
1582     case SVt_NULL:
1583     case SVt_IV:
1584         sv_upgrade(sv, SVt_NV);
1585         break;
1586     case SVt_RV:
1587     case SVt_PV:
1588     case SVt_PVIV:
1589         sv_upgrade(sv, SVt_PVNV);
1590         break;
1591
1592     case SVt_PVGV:
1593     case SVt_PVAV:
1594     case SVt_PVHV:
1595     case SVt_PVCV:
1596     case SVt_PVFM:
1597     case SVt_PVIO:
1598         Perl_croak(aTHX_ "Can't coerce %s to number in %s", sv_reftype(sv,0),
1599                    OP_NAME(PL_op));
1600     }
1601     SvNV_set(sv, num);
1602     (void)SvNOK_only(sv);                       /* validate number */
1603     SvTAINT(sv);
1604 }
1605
1606 /*
1607 =for apidoc sv_setnv_mg
1608
1609 Like C<sv_setnv>, but also handles 'set' magic.
1610
1611 =cut
1612 */
1613
1614 void
1615 Perl_sv_setnv_mg(pTHX_ register SV *sv, NV num)
1616 {
1617     sv_setnv(sv,num);
1618     SvSETMAGIC(sv);
1619 }
1620
1621 /* Print an "isn't numeric" warning, using a cleaned-up,
1622  * printable version of the offending string
1623  */
1624
1625 STATIC void
1626 S_not_a_number(pTHX_ SV *sv)
1627 {
1628      dVAR;
1629      SV *dsv;
1630      char tmpbuf[64];
1631      const char *pv;
1632
1633      if (DO_UTF8(sv)) {
1634           dsv = sv_2mortal(newSVpvs(""));
1635           pv = sv_uni_display(dsv, sv, 10, 0);
1636      } else {
1637           char *d = tmpbuf;
1638           const char * const limit = tmpbuf + sizeof(tmpbuf) - 8;
1639           /* each *s can expand to 4 chars + "...\0",
1640              i.e. need room for 8 chars */
1641         
1642           const char *s = SvPVX_const(sv);
1643           const char * const end = s + SvCUR(sv);
1644           for ( ; s < end && d < limit; s++ ) {
1645                int ch = *s & 0xFF;
1646                if (ch & 128 && !isPRINT_LC(ch)) {
1647                     *d++ = 'M';
1648                     *d++ = '-';
1649                     ch &= 127;
1650                }
1651                if (ch == '\n') {
1652                     *d++ = '\\';
1653                     *d++ = 'n';
1654                }
1655                else if (ch == '\r') {
1656                     *d++ = '\\';
1657                     *d++ = 'r';
1658                }
1659                else if (ch == '\f') {
1660                     *d++ = '\\';
1661                     *d++ = 'f';
1662                }
1663                else if (ch == '\\') {
1664                     *d++ = '\\';
1665                     *d++ = '\\';
1666                }
1667                else if (ch == '\0') {
1668                     *d++ = '\\';
1669                     *d++ = '0';
1670                }
1671                else if (isPRINT_LC(ch))
1672                     *d++ = ch;
1673                else {
1674                     *d++ = '^';
1675                     *d++ = toCTRL(ch);
1676                }
1677           }
1678           if (s < end) {
1679                *d++ = '.';
1680                *d++ = '.';
1681                *d++ = '.';
1682           }
1683           *d = '\0';
1684           pv = tmpbuf;
1685     }
1686
1687     if (PL_op)
1688         Perl_warner(aTHX_ packWARN(WARN_NUMERIC),
1689                     "Argument \"%s\" isn't numeric in %s", pv,
1690                     OP_DESC(PL_op));
1691     else
1692         Perl_warner(aTHX_ packWARN(WARN_NUMERIC),
1693                     "Argument \"%s\" isn't numeric", pv);
1694 }
1695
1696 /*
1697 =for apidoc looks_like_number
1698
1699 Test if the content of an SV looks like a number (or is a number).
1700 C<Inf> and C<Infinity> are treated as numbers (so will not issue a
1701 non-numeric warning), even if your atof() doesn't grok them.
1702
1703 =cut
1704 */
1705
1706 I32
1707 Perl_looks_like_number(pTHX_ SV *sv)
1708 {
1709     register const char *sbegin;
1710     STRLEN len;
1711
1712     if (SvPOK(sv)) {
1713         sbegin = SvPVX_const(sv);
1714         len = SvCUR(sv);
1715     }
1716     else if (SvPOKp(sv))
1717         sbegin = SvPV_const(sv, len);
1718     else
1719         return SvFLAGS(sv) & (SVf_NOK|SVp_NOK|SVf_IOK|SVp_IOK);
1720     return grok_number(sbegin, len, NULL);
1721 }
1722
1723 STATIC char *
1724 S_glob_2inpuv(pTHX_ GV *gv, STRLEN *len, bool want_number)
1725 {
1726     const U32 wasfake = SvFLAGS(gv) & SVf_FAKE;
1727     SV *const buffer = sv_newmortal();
1728
1729     /* FAKE globs can get coerced, so need to turn this off temporarily if it
1730        is on.  */
1731     SvFAKE_off(gv);
1732     gv_efullname3(buffer, gv, "*");
1733     SvFLAGS(gv) |= wasfake;
1734
1735     if (want_number) {
1736         /* We know that all GVs stringify to something that is not-a-number,
1737            so no need to test that.  */
1738         if (ckWARN(WARN_NUMERIC))
1739             not_a_number(buffer);
1740         /* We just want something true to return, so that S_sv_2iuv_common
1741            can tail call us and return true.  */
1742         return (char *) 1;
1743     } else {
1744         return SvPV(buffer, *len);
1745     }
1746 }
1747
1748 /* Actually, ISO C leaves conversion of UV to IV undefined, but
1749    until proven guilty, assume that things are not that bad... */
1750
1751 /*
1752    NV_PRESERVES_UV:
1753
1754    As 64 bit platforms often have an NV that doesn't preserve all bits of
1755    an IV (an assumption perl has been based on to date) it becomes necessary
1756    to remove the assumption that the NV always carries enough precision to
1757    recreate the IV whenever needed, and that the NV is the canonical form.
1758    Instead, IV/UV and NV need to be given equal rights. So as to not lose
1759    precision as a side effect of conversion (which would lead to insanity
1760    and the dragon(s) in t/op/numconvert.t getting very angry) the intent is
1761    1) to distinguish between IV/UV/NV slots that have cached a valid
1762       conversion where precision was lost and IV/UV/NV slots that have a
1763       valid conversion which has lost no precision
1764    2) to ensure that if a numeric conversion to one form is requested that
1765       would lose precision, the precise conversion (or differently
1766       imprecise conversion) is also performed and cached, to prevent
1767       requests for different numeric formats on the same SV causing
1768       lossy conversion chains. (lossless conversion chains are perfectly
1769       acceptable (still))
1770
1771
1772    flags are used:
1773    SvIOKp is true if the IV slot contains a valid value
1774    SvIOK  is true only if the IV value is accurate (UV if SvIOK_UV true)
1775    SvNOKp is true if the NV slot contains a valid value
1776    SvNOK  is true only if the NV value is accurate
1777
1778    so
1779    while converting from PV to NV, check to see if converting that NV to an
1780    IV(or UV) would lose accuracy over a direct conversion from PV to
1781    IV(or UV). If it would, cache both conversions, return NV, but mark
1782    SV as IOK NOKp (ie not NOK).
1783
1784    While converting from PV to IV, check to see if converting that IV to an
1785    NV would lose accuracy over a direct conversion from PV to NV. If it
1786    would, cache both conversions, flag similarly.
1787
1788    Before, the SV value "3.2" could become NV=3.2 IV=3 NOK, IOK quite
1789    correctly because if IV & NV were set NV *always* overruled.
1790    Now, "3.2" will become NV=3.2 IV=3 NOK, IOKp, because the flag's meaning
1791    changes - now IV and NV together means that the two are interchangeable:
1792    SvIVX == (IV) SvNVX && SvNVX == (NV) SvIVX;
1793
1794    The benefit of this is that operations such as pp_add know that if
1795    SvIOK is true for both left and right operands, then integer addition
1796    can be used instead of floating point (for cases where the result won't
1797    overflow). Before, floating point was always used, which could lead to
1798    loss of precision compared with integer addition.
1799
1800    * making IV and NV equal status should make maths accurate on 64 bit
1801      platforms
1802    * may speed up maths somewhat if pp_add and friends start to use
1803      integers when possible instead of fp. (Hopefully the overhead in
1804      looking for SvIOK and checking for overflow will not outweigh the
1805      fp to integer speedup)
1806    * will slow down integer operations (callers of SvIV) on "inaccurate"
1807      values, as the change from SvIOK to SvIOKp will cause a call into
1808      sv_2iv each time rather than a macro access direct to the IV slot
1809    * should speed up number->string conversion on integers as IV is
1810      favoured when IV and NV are equally accurate
1811
1812    ####################################################################
1813    You had better be using SvIOK_notUV if you want an IV for arithmetic:
1814    SvIOK is true if (IV or UV), so you might be getting (IV)SvUV.
1815    On the other hand, SvUOK is true iff UV.
1816    ####################################################################
1817
1818    Your mileage will vary depending your CPU's relative fp to integer
1819    performance ratio.
1820 */
1821
1822 #ifndef NV_PRESERVES_UV
1823 #  define IS_NUMBER_UNDERFLOW_IV 1
1824 #  define IS_NUMBER_UNDERFLOW_UV 2
1825 #  define IS_NUMBER_IV_AND_UV    2
1826 #  define IS_NUMBER_OVERFLOW_IV  4
1827 #  define IS_NUMBER_OVERFLOW_UV  5
1828
1829 /* sv_2iuv_non_preserve(): private routine for use by sv_2iv() and sv_2uv() */
1830
1831 /* For sv_2nv these three cases are "SvNOK and don't bother casting"  */
1832 STATIC int
1833 S_sv_2iuv_non_preserve(pTHX_ register SV *sv, I32 numtype)
1834 {
1835     dVAR;
1836     DEBUG_c(PerlIO_printf(Perl_debug_log,"sv_2iuv_non '%s', IV=0x%"UVxf" NV=%"NVgf" inttype=%"UVXf"\n", SvPVX_const(sv), SvIVX(sv), SvNVX(sv), (UV)numtype));
1837     if (SvNVX(sv) < (NV)IV_MIN) {
1838         (void)SvIOKp_on(sv);
1839         (void)SvNOK_on(sv);
1840         SvIV_set(sv, IV_MIN);
1841         return IS_NUMBER_UNDERFLOW_IV;
1842     }
1843     if (SvNVX(sv) > (NV)UV_MAX) {
1844         (void)SvIOKp_on(sv);
1845         (void)SvNOK_on(sv);
1846         SvIsUV_on(sv);
1847         SvUV_set(sv, UV_MAX);
1848         return IS_NUMBER_OVERFLOW_UV;
1849     }
1850     (void)SvIOKp_on(sv);
1851     (void)SvNOK_on(sv);
1852     /* Can't use strtol etc to convert this string.  (See truth table in
1853        sv_2iv  */
1854     if (SvNVX(sv) <= (UV)IV_MAX) {
1855         SvIV_set(sv, I_V(SvNVX(sv)));
1856         if ((NV)(SvIVX(sv)) == SvNVX(sv)) {
1857             SvIOK_on(sv); /* Integer is precise. NOK, IOK */
1858         } else {
1859             /* Integer is imprecise. NOK, IOKp */
1860         }
1861         return SvNVX(sv) < 0 ? IS_NUMBER_UNDERFLOW_UV : IS_NUMBER_IV_AND_UV;
1862     }
1863     SvIsUV_on(sv);
1864     SvUV_set(sv, U_V(SvNVX(sv)));
1865     if ((NV)(SvUVX(sv)) == SvNVX(sv)) {
1866         if (SvUVX(sv) == UV_MAX) {
1867             /* As we know that NVs don't preserve UVs, UV_MAX cannot
1868                possibly be preserved by NV. Hence, it must be overflow.
1869                NOK, IOKp */
1870             return IS_NUMBER_OVERFLOW_UV;
1871         }
1872         SvIOK_on(sv); /* Integer is precise. NOK, UOK */
1873     } else {
1874         /* Integer is imprecise. NOK, IOKp */
1875     }
1876     return IS_NUMBER_OVERFLOW_IV;
1877 }
1878 #endif /* !NV_PRESERVES_UV*/
1879
1880 STATIC bool
1881 S_sv_2iuv_common(pTHX_ SV *sv) {
1882     dVAR;
1883     if (SvNOKp(sv)) {
1884         /* erm. not sure. *should* never get NOKp (without NOK) from sv_2nv
1885          * without also getting a cached IV/UV from it at the same time
1886          * (ie PV->NV conversion should detect loss of accuracy and cache
1887          * IV or UV at same time to avoid this. */
1888         /* IV-over-UV optimisation - choose to cache IV if possible */
1889
1890         if (SvTYPE(sv) == SVt_NV)
1891             sv_upgrade(sv, SVt_PVNV);
1892
1893         (void)SvIOKp_on(sv);    /* Must do this first, to clear any SvOOK */
1894         /* < not <= as for NV doesn't preserve UV, ((NV)IV_MAX+1) will almost
1895            certainly cast into the IV range at IV_MAX, whereas the correct
1896            answer is the UV IV_MAX +1. Hence < ensures that dodgy boundary
1897            cases go to UV */
1898         if (SvNVX(sv) < (NV)IV_MAX + 0.5) {
1899             SvIV_set(sv, I_V(SvNVX(sv)));
1900             if (SvNVX(sv) == (NV) SvIVX(sv)
1901 #ifndef NV_PRESERVES_UV
1902                 && (((UV)1 << NV_PRESERVES_UV_BITS) >
1903                     (UV)(SvIVX(sv) > 0 ? SvIVX(sv) : -SvIVX(sv)))
1904                 /* Don't flag it as "accurately an integer" if the number
1905                    came from a (by definition imprecise) NV operation, and
1906                    we're outside the range of NV integer precision */
1907 #endif
1908                 ) {
1909                 SvIOK_on(sv);  /* Can this go wrong with rounding? NWC */
1910                 DEBUG_c(PerlIO_printf(Perl_debug_log,
1911                                       "0x%"UVxf" iv(%"NVgf" => %"IVdf") (precise)\n",
1912                                       PTR2UV(sv),
1913                                       SvNVX(sv),
1914                                       SvIVX(sv)));
1915
1916             } else {
1917                 /* IV not precise.  No need to convert from PV, as NV
1918                    conversion would already have cached IV if it detected
1919                    that PV->IV would be better than PV->NV->IV
1920                    flags already correct - don't set public IOK.  */
1921                 DEBUG_c(PerlIO_printf(Perl_debug_log,
1922                                       "0x%"UVxf" iv(%"NVgf" => %"IVdf") (imprecise)\n",
1923                                       PTR2UV(sv),
1924                                       SvNVX(sv),
1925                                       SvIVX(sv)));
1926             }
1927             /* Can the above go wrong if SvIVX == IV_MIN and SvNVX < IV_MIN,
1928                but the cast (NV)IV_MIN rounds to a the value less (more
1929                negative) than IV_MIN which happens to be equal to SvNVX ??
1930                Analogous to 0xFFFFFFFFFFFFFFFF rounding up to NV (2**64) and
1931                NV rounding back to 0xFFFFFFFFFFFFFFFF, so UVX == UV(NVX) and
1932                (NV)UVX == NVX are both true, but the values differ. :-(
1933                Hopefully for 2s complement IV_MIN is something like
1934                0x8000000000000000 which will be exact. NWC */
1935         }
1936         else {
1937             SvUV_set(sv, U_V(SvNVX(sv)));
1938             if (
1939                 (SvNVX(sv) == (NV) SvUVX(sv))
1940 #ifndef  NV_PRESERVES_UV
1941                 /* Make sure it's not 0xFFFFFFFFFFFFFFFF */
1942                 /*&& (SvUVX(sv) != UV_MAX) irrelevant with code below */
1943                 && (((UV)1 << NV_PRESERVES_UV_BITS) > SvUVX(sv))
1944                 /* Don't flag it as "accurately an integer" if the number
1945                    came from a (by definition imprecise) NV operation, and
1946                    we're outside the range of NV integer precision */
1947 #endif
1948                 )
1949                 SvIOK_on(sv);
1950             SvIsUV_on(sv);
1951             DEBUG_c(PerlIO_printf(Perl_debug_log,
1952                                   "0x%"UVxf" 2iv(%"UVuf" => %"IVdf") (as unsigned)\n",
1953                                   PTR2UV(sv),
1954                                   SvUVX(sv),
1955                                   SvUVX(sv)));
1956         }
1957     }
1958     else if (SvPOKp(sv) && SvLEN(sv)) {
1959         UV value;
1960         const int numtype = grok_number(SvPVX_const(sv), SvCUR(sv), &value);
1961         /* We want to avoid a possible problem when we cache an IV/ a UV which
1962            may be later translated to an NV, and the resulting NV is not
1963            the same as the direct translation of the initial string
1964            (eg 123.456 can shortcut to the IV 123 with atol(), but we must
1965            be careful to ensure that the value with the .456 is around if the
1966            NV value is requested in the future).
1967         
1968            This means that if we cache such an IV/a UV, we need to cache the
1969            NV as well.  Moreover, we trade speed for space, and do not
1970            cache the NV if we are sure it's not needed.
1971          */
1972
1973         /* SVt_PVNV is one higher than SVt_PVIV, hence this order  */
1974         if ((numtype & (IS_NUMBER_IN_UV | IS_NUMBER_NOT_INT))
1975              == IS_NUMBER_IN_UV) {
1976             /* It's definitely an integer, only upgrade to PVIV */
1977             if (SvTYPE(sv) < SVt_PVIV)
1978                 sv_upgrade(sv, SVt_PVIV);
1979             (void)SvIOK_on(sv);
1980         } else if (SvTYPE(sv) < SVt_PVNV)
1981             sv_upgrade(sv, SVt_PVNV);
1982
1983         /* If NVs preserve UVs then we only use the UV value if we know that
1984            we aren't going to call atof() below. If NVs don't preserve UVs
1985            then the value returned may have more precision than atof() will
1986            return, even though value isn't perfectly accurate.  */
1987         if ((numtype & (IS_NUMBER_IN_UV
1988 #ifdef NV_PRESERVES_UV
1989                         | IS_NUMBER_NOT_INT
1990 #endif
1991             )) == IS_NUMBER_IN_UV) {
1992             /* This won't turn off the public IOK flag if it was set above  */
1993             (void)SvIOKp_on(sv);
1994
1995             if (!(numtype & IS_NUMBER_NEG)) {
1996                 /* positive */;
1997                 if (value <= (UV)IV_MAX) {
1998                     SvIV_set(sv, (IV)value);
1999                 } else {
2000                     /* it didn't overflow, and it was positive. */
2001                     SvUV_set(sv, value);
2002                     SvIsUV_on(sv);
2003                 }
2004             } else {
2005                 /* 2s complement assumption  */
2006                 if (value <= (UV)IV_MIN) {
2007                     SvIV_set(sv, -(IV)value);
2008                 } else {
2009                     /* Too negative for an IV.  This is a double upgrade, but
2010                        I'm assuming it will be rare.  */
2011                     if (SvTYPE(sv) < SVt_PVNV)
2012                         sv_upgrade(sv, SVt_PVNV);
2013                     SvNOK_on(sv);
2014                     SvIOK_off(sv);
2015                     SvIOKp_on(sv);
2016                     SvNV_set(sv, -(NV)value);
2017                     SvIV_set(sv, IV_MIN);
2018                 }
2019             }
2020         }
2021         /* For !NV_PRESERVES_UV and IS_NUMBER_IN_UV and IS_NUMBER_NOT_INT we
2022            will be in the previous block to set the IV slot, and the next
2023            block to set the NV slot.  So no else here.  */
2024         
2025         if ((numtype & (IS_NUMBER_IN_UV | IS_NUMBER_NOT_INT))
2026             != IS_NUMBER_IN_UV) {
2027             /* It wasn't an (integer that doesn't overflow the UV). */
2028             SvNV_set(sv, Atof(SvPVX_const(sv)));
2029
2030             if (! numtype && ckWARN(WARN_NUMERIC))
2031                 not_a_number(sv);
2032
2033 #if defined(USE_LONG_DOUBLE)
2034             DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2iv(%" PERL_PRIgldbl ")\n",
2035                                   PTR2UV(sv), SvNVX(sv)));
2036 #else
2037             DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2iv(%"NVgf")\n",
2038                                   PTR2UV(sv), SvNVX(sv)));
2039 #endif
2040
2041 #ifdef NV_PRESERVES_UV
2042             (void)SvIOKp_on(sv);
2043             (void)SvNOK_on(sv);
2044             if (SvNVX(sv) < (NV)IV_MAX + 0.5) {
2045                 SvIV_set(sv, I_V(SvNVX(sv)));
2046                 if ((NV)(SvIVX(sv)) == SvNVX(sv)) {
2047                     SvIOK_on(sv);
2048                 } else {
2049                     /*EMPTY*/;  /* Integer is imprecise. NOK, IOKp */
2050                 }
2051                 /* UV will not work better than IV */
2052             } else {
2053                 if (SvNVX(sv) > (NV)UV_MAX) {
2054                     SvIsUV_on(sv);
2055                     /* Integer is inaccurate. NOK, IOKp, is UV */
2056                     SvUV_set(sv, UV_MAX);
2057                 } else {
2058                     SvUV_set(sv, U_V(SvNVX(sv)));
2059                     /* 0xFFFFFFFFFFFFFFFF not an issue in here, NVs
2060                        NV preservse UV so can do correct comparison.  */
2061                     if ((NV)(SvUVX(sv)) == SvNVX(sv)) {
2062                         SvIOK_on(sv);
2063                     } else {
2064                         /*EMPTY*/;   /* Integer is imprecise. NOK, IOKp, is UV */
2065                     }
2066                 }
2067                 SvIsUV_on(sv);
2068             }
2069 #else /* NV_PRESERVES_UV */
2070             if ((numtype & (IS_NUMBER_IN_UV | IS_NUMBER_NOT_INT))
2071                 == (IS_NUMBER_IN_UV | IS_NUMBER_NOT_INT)) {
2072                 /* The IV/UV slot will have been set from value returned by
2073                    grok_number above.  The NV slot has just been set using
2074                    Atof.  */
2075                 SvNOK_on(sv);
2076                 assert (SvIOKp(sv));
2077             } else {
2078                 if (((UV)1 << NV_PRESERVES_UV_BITS) >
2079                     U_V(SvNVX(sv) > 0 ? SvNVX(sv) : -SvNVX(sv))) {
2080                     /* Small enough to preserve all bits. */
2081                     (void)SvIOKp_on(sv);
2082                     SvNOK_on(sv);
2083                     SvIV_set(sv, I_V(SvNVX(sv)));
2084                     if ((NV)(SvIVX(sv)) == SvNVX(sv))
2085                         SvIOK_on(sv);
2086                     /* Assumption: first non-preserved integer is < IV_MAX,
2087                        this NV is in the preserved range, therefore: */
2088                     if (!(U_V(SvNVX(sv) > 0 ? SvNVX(sv) : -SvNVX(sv))
2089                           < (UV)IV_MAX)) {
2090                         Perl_croak(aTHX_ "sv_2iv assumed (U_V(fabs((double)SvNVX(sv))) < (UV)IV_MAX) but SvNVX(sv)=%"NVgf" U_V is 0x%"UVxf", IV_MAX is 0x%"UVxf"\n", SvNVX(sv), U_V(SvNVX(sv)), (UV)IV_MAX);
2091                     }
2092                 } else {
2093                     /* IN_UV NOT_INT
2094                          0      0       already failed to read UV.
2095                          0      1       already failed to read UV.
2096                          1      0       you won't get here in this case. IV/UV
2097                                         slot set, public IOK, Atof() unneeded.
2098                          1      1       already read UV.
2099                        so there's no point in sv_2iuv_non_preserve() attempting
2100                        to use atol, strtol, strtoul etc.  */
2101                     sv_2iuv_non_preserve (sv, numtype);
2102                 }
2103             }
2104 #endif /* NV_PRESERVES_UV */
2105         }
2106     }
2107     else  {
2108         if (isGV_with_GP(sv)) {
2109             return (bool)PTR2IV(glob_2inpuv((GV *)sv, NULL, TRUE));
2110         }
2111
2112         if (!(SvFLAGS(sv) & SVs_PADTMP)) {
2113             if (!PL_localizing && ckWARN(WARN_UNINITIALIZED))
2114                 report_uninit(sv);
2115         }
2116         if (SvTYPE(sv) < SVt_IV)
2117             /* Typically the caller expects that sv_any is not NULL now.  */
2118             sv_upgrade(sv, SVt_IV);
2119         /* Return 0 from the caller.  */
2120         return TRUE;
2121     }
2122     return FALSE;
2123 }
2124
2125 /*
2126 =for apidoc sv_2iv_flags
2127
2128 Return the integer value of an SV, doing any necessary string
2129 conversion.  If flags includes SV_GMAGIC, does an mg_get() first.
2130 Normally used via the C<SvIV(sv)> and C<SvIVx(sv)> macros.
2131
2132 =cut
2133 */
2134
2135 IV
2136 Perl_sv_2iv_flags(pTHX_ register SV *sv, I32 flags)
2137 {
2138     dVAR;
2139     if (!sv)
2140         return 0;
2141     if (SvGMAGICAL(sv)) {
2142         if (flags & SV_GMAGIC)
2143             mg_get(sv);
2144         if (SvIOKp(sv))
2145             return SvIVX(sv);
2146         if (SvNOKp(sv)) {
2147             return I_V(SvNVX(sv));
2148         }
2149         if (SvPOKp(sv) && SvLEN(sv)) {
2150             UV value;
2151             const int numtype
2152                 = grok_number(SvPVX_const(sv), SvCUR(sv), &value);
2153
2154             if ((numtype & (IS_NUMBER_IN_UV | IS_NUMBER_NOT_INT))
2155                 == IS_NUMBER_IN_UV) {
2156                 /* It's definitely an integer */
2157                 if (numtype & IS_NUMBER_NEG) {
2158                     if (value < (UV)IV_MIN)
2159                         return -(IV)value;
2160                 } else {
2161                     if (value < (UV)IV_MAX)
2162                         return (IV)value;
2163                 }
2164             }
2165             if (!numtype) {
2166                 if (ckWARN(WARN_NUMERIC))
2167                     not_a_number(sv);
2168             }
2169             return I_V(Atof(SvPVX_const(sv)));
2170         }
2171         if (SvROK(sv)) {
2172             goto return_rok;
2173         }
2174         assert(SvTYPE(sv) >= SVt_PVMG);
2175         /* This falls through to the report_uninit inside S_sv_2iuv_common.  */
2176     } else if (SvTHINKFIRST(sv)) {
2177         if (SvROK(sv)) {
2178         return_rok:
2179             if (SvAMAGIC(sv)) {
2180                 SV * const tmpstr=AMG_CALLun(sv,numer);
2181                 if (tmpstr && (!SvROK(tmpstr) || (SvRV(tmpstr) != SvRV(sv)))) {
2182                     return SvIV(tmpstr);
2183                 }
2184             }
2185             return PTR2IV(SvRV(sv));
2186         }
2187         if (SvIsCOW(sv)) {
2188             sv_force_normal_flags(sv, 0);
2189         }
2190         if (SvREADONLY(sv) && !SvOK(sv)) {
2191             if (ckWARN(WARN_UNINITIALIZED))
2192                 report_uninit(sv);
2193             return 0;
2194         }
2195     }
2196     if (!SvIOKp(sv)) {
2197         if (S_sv_2iuv_common(aTHX_ sv))
2198             return 0;
2199     }
2200     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2iv(%"IVdf")\n",
2201         PTR2UV(sv),SvIVX(sv)));
2202     return SvIsUV(sv) ? (IV)SvUVX(sv) : SvIVX(sv);
2203 }
2204
2205 /*
2206 =for apidoc sv_2uv_flags
2207
2208 Return the unsigned integer value of an SV, doing any necessary string
2209 conversion.  If flags includes SV_GMAGIC, does an mg_get() first.
2210 Normally used via the C<SvUV(sv)> and C<SvUVx(sv)> macros.
2211
2212 =cut
2213 */
2214
2215 UV
2216 Perl_sv_2uv_flags(pTHX_ register SV *sv, I32 flags)
2217 {
2218     dVAR;
2219     if (!sv)
2220         return 0;
2221     if (SvGMAGICAL(sv)) {
2222         if (flags & SV_GMAGIC)
2223             mg_get(sv);
2224         if (SvIOKp(sv))
2225             return SvUVX(sv);
2226         if (SvNOKp(sv))
2227             return U_V(SvNVX(sv));
2228         if (SvPOKp(sv) && SvLEN(sv)) {
2229             UV value;
2230             const int numtype
2231                 = grok_number(SvPVX_const(sv), SvCUR(sv), &value);
2232
2233             if ((numtype & (IS_NUMBER_IN_UV | IS_NUMBER_NOT_INT))
2234                 == IS_NUMBER_IN_UV) {
2235                 /* It's definitely an integer */
2236                 if (!(numtype & IS_NUMBER_NEG))
2237                     return value;
2238             }
2239             if (!numtype) {
2240                 if (ckWARN(WARN_NUMERIC))
2241                     not_a_number(sv);
2242             }
2243             return U_V(Atof(SvPVX_const(sv)));
2244         }
2245         if (SvROK(sv)) {
2246             goto return_rok;
2247         }
2248         assert(SvTYPE(sv) >= SVt_PVMG);
2249         /* This falls through to the report_uninit inside S_sv_2iuv_common.  */
2250     } else if (SvTHINKFIRST(sv)) {
2251         if (SvROK(sv)) {
2252         return_rok:
2253             if (SvAMAGIC(sv)) {
2254                 SV *const tmpstr = AMG_CALLun(sv,numer);
2255                 if (tmpstr && (!SvROK(tmpstr) || (SvRV(tmpstr) != SvRV(sv)))) {
2256                     return SvUV(tmpstr);
2257                 }
2258             }
2259             return PTR2UV(SvRV(sv));
2260         }
2261         if (SvIsCOW(sv)) {
2262             sv_force_normal_flags(sv, 0);
2263         }
2264         if (SvREADONLY(sv) && !SvOK(sv)) {
2265             if (ckWARN(WARN_UNINITIALIZED))
2266                 report_uninit(sv);
2267             return 0;
2268         }
2269     }
2270     if (!SvIOKp(sv)) {
2271         if (S_sv_2iuv_common(aTHX_ sv))
2272             return 0;
2273     }
2274
2275     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2uv(%"UVuf")\n",
2276                           PTR2UV(sv),SvUVX(sv)));
2277     return SvIsUV(sv) ? SvUVX(sv) : (UV)SvIVX(sv);
2278 }
2279
2280 /*
2281 =for apidoc sv_2nv
2282
2283 Return the num value of an SV, doing any necessary string or integer
2284 conversion, magic etc. Normally used via the C<SvNV(sv)> and C<SvNVx(sv)>
2285 macros.
2286
2287 =cut
2288 */
2289
2290 NV
2291 Perl_sv_2nv(pTHX_ register SV *sv)
2292 {
2293     dVAR;
2294     if (!sv)
2295         return 0.0;
2296     if (SvGMAGICAL(sv)) {
2297         mg_get(sv);
2298         if (SvNOKp(sv))
2299             return SvNVX(sv);
2300         if ((SvPOKp(sv) && SvLEN(sv)) && !SvIOKp(sv)) {
2301             if (!SvIOKp(sv) && ckWARN(WARN_NUMERIC) &&
2302                 !grok_number(SvPVX_const(sv), SvCUR(sv), NULL))
2303                 not_a_number(sv);
2304             return Atof(SvPVX_const(sv));
2305         }
2306         if (SvIOKp(sv)) {
2307             if (SvIsUV(sv))
2308                 return (NV)SvUVX(sv);
2309             else
2310                 return (NV)SvIVX(sv);
2311         }
2312         if (SvROK(sv)) {
2313             goto return_rok;
2314         }
2315         assert(SvTYPE(sv) >= SVt_PVMG);
2316         /* This falls through to the report_uninit near the end of the
2317            function. */
2318     } else if (SvTHINKFIRST(sv)) {
2319         if (SvROK(sv)) {
2320         return_rok:
2321             if (SvAMAGIC(sv)) {
2322                 SV *const tmpstr = AMG_CALLun(sv,numer);
2323                 if (tmpstr && (!SvROK(tmpstr) || (SvRV(tmpstr) != SvRV(sv)))) {
2324                     return SvNV(tmpstr);
2325                 }
2326             }
2327             return PTR2NV(SvRV(sv));
2328         }
2329         if (SvIsCOW(sv)) {
2330             sv_force_normal_flags(sv, 0);
2331         }
2332         if (SvREADONLY(sv) && !SvOK(sv)) {
2333             if (ckWARN(WARN_UNINITIALIZED))
2334                 report_uninit(sv);
2335             return 0.0;
2336         }
2337     }
2338     if (SvTYPE(sv) < SVt_NV) {
2339         /* The logic to use SVt_PVNV if necessary is in sv_upgrade.  */
2340         sv_upgrade(sv, SVt_NV);
2341 #ifdef USE_LONG_DOUBLE
2342         DEBUG_c({
2343             STORE_NUMERIC_LOCAL_SET_STANDARD();
2344             PerlIO_printf(Perl_debug_log,
2345                           "0x%"UVxf" num(%" PERL_PRIgldbl ")\n",
2346                           PTR2UV(sv), SvNVX(sv));
2347             RESTORE_NUMERIC_LOCAL();
2348         });
2349 #else
2350         DEBUG_c({
2351             STORE_NUMERIC_LOCAL_SET_STANDARD();
2352             PerlIO_printf(Perl_debug_log, "0x%"UVxf" num(%"NVgf")\n",
2353                           PTR2UV(sv), SvNVX(sv));
2354             RESTORE_NUMERIC_LOCAL();
2355         });
2356 #endif
2357     }
2358     else if (SvTYPE(sv) < SVt_PVNV)
2359         sv_upgrade(sv, SVt_PVNV);
2360     if (SvNOKp(sv)) {
2361         return SvNVX(sv);
2362     }
2363     if (SvIOKp(sv)) {
2364         SvNV_set(sv, SvIsUV(sv) ? (NV)SvUVX(sv) : (NV)SvIVX(sv));
2365 #ifdef NV_PRESERVES_UV
2366         SvNOK_on(sv);
2367 #else
2368         /* Only set the public NV OK flag if this NV preserves the IV  */
2369         /* Check it's not 0xFFFFFFFFFFFFFFFF */
2370         if (SvIsUV(sv) ? ((SvUVX(sv) != UV_MAX)&&(SvUVX(sv) == U_V(SvNVX(sv))))
2371                        : (SvIVX(sv) == I_V(SvNVX(sv))))
2372             SvNOK_on(sv);
2373         else
2374             SvNOKp_on(sv);
2375 #endif
2376     }
2377     else if (SvPOKp(sv) && SvLEN(sv)) {
2378         UV value;
2379         const int numtype = grok_number(SvPVX_const(sv), SvCUR(sv), &value);
2380         if (!SvIOKp(sv) && !numtype && ckWARN(WARN_NUMERIC))
2381             not_a_number(sv);
2382 #ifdef NV_PRESERVES_UV
2383         if ((numtype & (IS_NUMBER_IN_UV | IS_NUMBER_NOT_INT))
2384             == IS_NUMBER_IN_UV) {
2385             /* It's definitely an integer */
2386             SvNV_set(sv, (numtype & IS_NUMBER_NEG) ? -(NV)value : (NV)value);
2387         } else
2388             SvNV_set(sv, Atof(SvPVX_const(sv)));
2389         SvNOK_on(sv);
2390 #else
2391         SvNV_set(sv, Atof(SvPVX_const(sv)));
2392         /* Only set the public NV OK flag if this NV preserves the value in
2393            the PV at least as well as an IV/UV would.
2394            Not sure how to do this 100% reliably. */
2395         /* if that shift count is out of range then Configure's test is
2396            wonky. We shouldn't be in here with NV_PRESERVES_UV_BITS ==
2397            UV_BITS */
2398         if (((UV)1 << NV_PRESERVES_UV_BITS) >
2399             U_V(SvNVX(sv) > 0 ? SvNVX(sv) : -SvNVX(sv))) {
2400             SvNOK_on(sv); /* Definitely small enough to preserve all bits */
2401         } else if (!(numtype & IS_NUMBER_IN_UV)) {
2402             /* Can't use strtol etc to convert this string, so don't try.
2403                sv_2iv and sv_2uv will use the NV to convert, not the PV.  */
2404             SvNOK_on(sv);
2405         } else {
2406             /* value has been set.  It may not be precise.  */
2407             if ((numtype & IS_NUMBER_NEG) && (value > (UV)IV_MIN)) {
2408                 /* 2s complement assumption for (UV)IV_MIN  */
2409                 SvNOK_on(sv); /* Integer is too negative.  */
2410             } else {
2411                 SvNOKp_on(sv);
2412                 SvIOKp_on(sv);
2413
2414                 if (numtype & IS_NUMBER_NEG) {
2415                     SvIV_set(sv, -(IV)value);
2416                 } else if (value <= (UV)IV_MAX) {
2417                     SvIV_set(sv, (IV)value);
2418                 } else {
2419                     SvUV_set(sv, value);
2420                     SvIsUV_on(sv);
2421                 }
2422
2423                 if (numtype & IS_NUMBER_NOT_INT) {
2424                     /* I believe that even if the original PV had decimals,
2425                        they are lost beyond the limit of the FP precision.
2426                        However, neither is canonical, so both only get p
2427                        flags.  NWC, 2000/11/25 */
2428                     /* Both already have p flags, so do nothing */
2429                 } else {
2430                     const NV nv = SvNVX(sv);
2431                     if (SvNVX(sv) < (NV)IV_MAX + 0.5) {
2432                         if (SvIVX(sv) == I_V(nv)) {
2433                             SvNOK_on(sv);
2434                         } else {
2435                             /* It had no "." so it must be integer.  */
2436                         }
2437                         SvIOK_on(sv);
2438                     } else {
2439                         /* between IV_MAX and NV(UV_MAX).
2440                            Could be slightly > UV_MAX */
2441
2442                         if (numtype & IS_NUMBER_NOT_INT) {
2443                             /* UV and NV both imprecise.  */
2444                         } else {
2445                             const UV nv_as_uv = U_V(nv);
2446
2447                             if (value == nv_as_uv && SvUVX(sv) != UV_MAX) {
2448                                 SvNOK_on(sv);
2449                             }
2450                             SvIOK_on(sv);
2451                         }
2452                     }
2453                 }
2454             }
2455         }
2456 #endif /* NV_PRESERVES_UV */
2457     }
2458     else  {
2459         if (isGV_with_GP(sv)) {
2460             glob_2inpuv((GV *)sv, NULL, TRUE);
2461             return 0.0;
2462         }
2463
2464         if (!PL_localizing && !(SvFLAGS(sv) & SVs_PADTMP) && ckWARN(WARN_UNINITIALIZED))
2465             report_uninit(sv);
2466         assert (SvTYPE(sv) >= SVt_NV);
2467         /* Typically the caller expects that sv_any is not NULL now.  */
2468         /* XXX Ilya implies that this is a bug in callers that assume this
2469            and ideally should be fixed.  */
2470         return 0.0;
2471     }
2472 #if defined(USE_LONG_DOUBLE)
2473     DEBUG_c({
2474         STORE_NUMERIC_LOCAL_SET_STANDARD();
2475         PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2nv(%" PERL_PRIgldbl ")\n",
2476                       PTR2UV(sv), SvNVX(sv));
2477         RESTORE_NUMERIC_LOCAL();
2478     });
2479 #else
2480     DEBUG_c({
2481         STORE_NUMERIC_LOCAL_SET_STANDARD();
2482         PerlIO_printf(Perl_debug_log, "0x%"UVxf" 1nv(%"NVgf")\n",
2483                       PTR2UV(sv), SvNVX(sv));
2484         RESTORE_NUMERIC_LOCAL();
2485     });
2486 #endif
2487     return SvNVX(sv);
2488 }
2489
2490 /* uiv_2buf(): private routine for use by sv_2pv_flags(): print an IV or
2491  * UV as a string towards the end of buf, and return pointers to start and
2492  * end of it.
2493  *
2494  * We assume that buf is at least TYPE_CHARS(UV) long.
2495  */
2496
2497 static char *
2498 S_uiv_2buf(char *buf, IV iv, UV uv, int is_uv, char **peob)
2499 {
2500     char *ptr = buf + TYPE_CHARS(UV);
2501     char * const ebuf = ptr;
2502     int sign;
2503
2504     if (is_uv)
2505         sign = 0;
2506     else if (iv >= 0) {
2507         uv = iv;
2508         sign = 0;
2509     } else {
2510         uv = -iv;
2511         sign = 1;
2512     }
2513     do {
2514         *--ptr = '0' + (char)(uv % 10);
2515     } while (uv /= 10);
2516     if (sign)
2517         *--ptr = '-';
2518     *peob = ebuf;
2519     return ptr;
2520 }
2521
2522 /* stringify_regexp(): private routine for use by sv_2pv_flags(): converts
2523  * a regexp to its stringified form.
2524  */
2525
2526 static char *
2527 S_stringify_regexp(pTHX_ SV *sv, MAGIC *mg, STRLEN *lp) {
2528     dVAR;
2529     const regexp * const re = (regexp *)mg->mg_obj;
2530
2531     if (!mg->mg_ptr) {
2532         const char *fptr = "msix";
2533         char reflags[6];
2534         char ch;
2535         int left = 0;
2536         int right = 4;
2537         bool need_newline = 0;
2538         U16 reganch = (U16)((re->reganch & PMf_COMPILETIME) >> 12);
2539
2540         while((ch = *fptr++)) {
2541             if(reganch & 1) {
2542                 reflags[left++] = ch;
2543             }
2544             else {
2545                 reflags[right--] = ch;
2546             }
2547             reganch >>= 1;
2548         }
2549         if(left != 4) {
2550             reflags[left] = '-';
2551             left = 5;
2552         }
2553
2554         mg->mg_len = re->prelen + 4 + left;
2555         /*
2556          * If /x was used, we have to worry about a regex ending with a
2557          * comment later being embedded within another regex. If so, we don't
2558          * want this regex's "commentization" to leak out to the right part of
2559          * the enclosing regex, we must cap it with a newline.
2560          *
2561          * So, if /x was used, we scan backwards from the end of the regex. If
2562          * we find a '#' before we find a newline, we need to add a newline
2563          * ourself. If we find a '\n' first (or if we don't find '#' or '\n'),
2564          * we don't need to add anything.  -jfriedl
2565          */
2566         if (PMf_EXTENDED & re->reganch) {
2567             const char *endptr = re->precomp + re->prelen;
2568             while (endptr >= re->precomp) {
2569                 const char c = *(endptr--);
2570                 if (c == '\n')
2571                     break; /* don't need another */
2572                 if (c == '#') {
2573                     /* we end while in a comment, so we need a newline */
2574                     mg->mg_len++; /* save space for it */
2575                     need_newline = 1; /* note to add it */
2576                     break;
2577                 }
2578             }
2579         }
2580
2581         Newx(mg->mg_ptr, mg->mg_len + 1 + left, char);
2582         mg->mg_ptr[0] = '(';
2583         mg->mg_ptr[1] = '?';
2584         Copy(reflags, mg->mg_ptr+2, left, char);
2585         *(mg->mg_ptr+left+2) = ':';
2586         Copy(re->precomp, mg->mg_ptr+3+left, re->prelen, char);
2587         if (need_newline)
2588             mg->mg_ptr[mg->mg_len - 2] = '\n';
2589         mg->mg_ptr[mg->mg_len - 1] = ')';
2590         mg->mg_ptr[mg->mg_len] = 0;
2591     }
2592     PL_reginterp_cnt += re->program[0].next_off;
2593     
2594     if (re->reganch & ROPT_UTF8)
2595         SvUTF8_on(sv);
2596     else
2597         SvUTF8_off(sv);
2598     if (lp)
2599         *lp = mg->mg_len;
2600     return mg->mg_ptr;
2601 }
2602
2603 /*
2604 =for apidoc sv_2pv_flags
2605
2606 Returns a pointer to the string value of an SV, and sets *lp to its length.
2607 If flags includes SV_GMAGIC, does an mg_get() first. Coerces sv to a string
2608 if necessary.
2609 Normally invoked via the C<SvPV_flags> macro. C<sv_2pv()> and C<sv_2pv_nomg>
2610 usually end up here too.
2611
2612 =cut
2613 */
2614
2615 char *
2616 Perl_sv_2pv_flags(pTHX_ register SV *sv, STRLEN *lp, I32 flags)
2617 {
2618     dVAR;
2619     register char *s;
2620
2621     if (!sv) {
2622         if (lp)
2623             *lp = 0;
2624         return (char *)"";
2625     }
2626     if (SvGMAGICAL(sv)) {
2627         if (flags & SV_GMAGIC)
2628             mg_get(sv);
2629         if (SvPOKp(sv)) {
2630             if (lp)
2631                 *lp = SvCUR(sv);
2632             if (flags & SV_MUTABLE_RETURN)
2633                 return SvPVX_mutable(sv);
2634             if (flags & SV_CONST_RETURN)
2635                 return (char *)SvPVX_const(sv);
2636             return SvPVX(sv);
2637         }
2638         if (SvIOKp(sv) || SvNOKp(sv)) {
2639             char tbuf[64];  /* Must fit sprintf/Gconvert of longest IV/NV */
2640             STRLEN len;
2641
2642             if (SvIOKp(sv)) {
2643                 len = SvIsUV(sv) ? my_sprintf(tbuf,"%"UVuf, (UV)SvUVX(sv))
2644                     : my_sprintf(tbuf,"%"IVdf, (IV)SvIVX(sv));
2645             } else {
2646                 Gconvert(SvNVX(sv), NV_DIG, 0, tbuf);
2647                 len = strlen(tbuf);
2648             }
2649             assert(!SvROK(sv));
2650             {
2651                 dVAR;
2652
2653 #ifdef FIXNEGATIVEZERO
2654                 if (len == 2 && tbuf[0] == '-' && tbuf[1] == '0') {
2655                     tbuf[0] = '0';
2656                     tbuf[1] = 0;
2657                     len = 1;
2658                 }
2659 #endif
2660                 SvUPGRADE(sv, SVt_PV);
2661                 if (lp)
2662                     *lp = len;
2663                 s = SvGROW_mutable(sv, len + 1);
2664                 SvCUR_set(sv, len);
2665                 SvPOKp_on(sv);
2666                 return memcpy(s, tbuf, len + 1);
2667             }
2668         }
2669         if (SvROK(sv)) {
2670             goto return_rok;
2671         }
2672         assert(SvTYPE(sv) >= SVt_PVMG);
2673         /* This falls through to the report_uninit near the end of the
2674            function. */
2675     } else if (SvTHINKFIRST(sv)) {
2676         if (SvROK(sv)) {
2677         return_rok:
2678             if (SvAMAGIC(sv)) {
2679                 SV *const tmpstr = AMG_CALLun(sv,string);
2680                 if (tmpstr && (!SvROK(tmpstr) || (SvRV(tmpstr) != SvRV(sv)))) {
2681                     /* Unwrap this:  */
2682                     /* char *pv = lp ? SvPV(tmpstr, *lp) : SvPV_nolen(tmpstr);
2683                      */
2684
2685                     char *pv;
2686                     if ((SvFLAGS(tmpstr) & (SVf_POK)) == SVf_POK) {
2687                         if (flags & SV_CONST_RETURN) {
2688                             pv = (char *) SvPVX_const(tmpstr);
2689                         } else {
2690                             pv = (flags & SV_MUTABLE_RETURN)
2691                                 ? SvPVX_mutable(tmpstr) : SvPVX(tmpstr);
2692                         }
2693                         if (lp)
2694                             *lp = SvCUR(tmpstr);
2695                     } else {
2696                         pv = sv_2pv_flags(tmpstr, lp, flags);
2697                     }
2698                     if (SvUTF8(tmpstr))
2699                         SvUTF8_on(sv);
2700                     else
2701                         SvUTF8_off(sv);
2702                     return pv;
2703                 }
2704             }
2705             {
2706                 SV *tsv;
2707                 MAGIC *mg;
2708                 const SV *const referent = (SV*)SvRV(sv);
2709
2710                 if (!referent) {
2711                     tsv = sv_2mortal(newSVpvs("NULLREF"));
2712                 } else if (SvTYPE(referent) == SVt_PVMG
2713                            && ((SvFLAGS(referent) &
2714                                 (SVs_OBJECT|SVf_OK|SVs_GMG|SVs_SMG|SVs_RMG))
2715                                == (SVs_OBJECT|SVs_SMG))
2716                            && (mg = mg_find(referent, PERL_MAGIC_qr))) {
2717                     return stringify_regexp(sv, mg, lp);
2718                 } else {
2719                     const char *const typestr = sv_reftype(referent, 0);
2720
2721                     tsv = sv_newmortal();
2722                     if (SvOBJECT(referent)) {
2723                         const char *const name = HvNAME_get(SvSTASH(referent));
2724                         Perl_sv_setpvf(aTHX_ tsv, "%s=%s(0x%"UVxf")",
2725                                        name ? name : "__ANON__" , typestr,
2726                                        PTR2UV(referent));
2727                     }
2728                     else
2729                         Perl_sv_setpvf(aTHX_ tsv, "%s(0x%"UVxf")", typestr,
2730                                        PTR2UV(referent));
2731                 }
2732                 if (lp)
2733                     *lp = SvCUR(tsv);
2734                 return SvPVX(tsv);
2735             }
2736         }
2737         if (SvREADONLY(sv) && !SvOK(sv)) {
2738             if (ckWARN(WARN_UNINITIALIZED))
2739                 report_uninit(sv);
2740             if (lp)
2741                 *lp = 0;
2742             return (char *)"";
2743         }
2744     }
2745     if (SvIOK(sv) || ((SvIOKp(sv) && !SvNOKp(sv)))) {
2746         /* I'm assuming that if both IV and NV are equally valid then
2747            converting the IV is going to be more efficient */
2748         const U32 isIOK = SvIOK(sv);
2749         const U32 isUIOK = SvIsUV(sv);
2750         char buf[TYPE_CHARS(UV)];
2751         char *ebuf, *ptr;
2752
2753         if (SvTYPE(sv) < SVt_PVIV)
2754             sv_upgrade(sv, SVt_PVIV);
2755         ptr = uiv_2buf(buf, SvIVX(sv), SvUVX(sv), isUIOK, &ebuf);
2756         /* inlined from sv_setpvn */
2757         SvGROW_mutable(sv, (STRLEN)(ebuf - ptr + 1));
2758         Move(ptr,SvPVX_mutable(sv),ebuf - ptr,char);
2759         SvCUR_set(sv, ebuf - ptr);
2760         s = SvEND(sv);
2761         *s = '\0';
2762         if (isIOK)
2763             SvIOK_on(sv);
2764         else
2765             SvIOKp_on(sv);
2766         if (isUIOK)
2767             SvIsUV_on(sv);
2768     }
2769     else if (SvNOKp(sv)) {
2770         const int olderrno = errno;
2771         if (SvTYPE(sv) < SVt_PVNV)
2772             sv_upgrade(sv, SVt_PVNV);
2773         /* The +20 is pure guesswork.  Configure test needed. --jhi */
2774         s = SvGROW_mutable(sv, NV_DIG + 20);
2775         /* some Xenix systems wipe out errno here */
2776 #ifdef apollo
2777         if (SvNVX(sv) == 0.0)
2778             (void)strcpy(s,"0");
2779         else
2780 #endif /*apollo*/
2781         {
2782             Gconvert(SvNVX(sv), NV_DIG, 0, s);
2783         }
2784         errno = olderrno;
2785 #ifdef FIXNEGATIVEZERO
2786         if (*s == '-' && s[1] == '0' && !s[2])
2787             strcpy(s,"0");
2788 #endif
2789         while (*s) s++;
2790 #ifdef hcx
2791         if (s[-1] == '.')
2792             *--s = '\0';
2793 #endif
2794     }
2795     else {
2796         if (isGV_with_GP(sv)) {
2797             return glob_2inpuv((GV *)sv, lp, FALSE);
2798         }
2799
2800         if (!PL_localizing && !(SvFLAGS(sv) & SVs_PADTMP) && ckWARN(WARN_UNINITIALIZED))
2801             report_uninit(sv);
2802         if (lp)
2803             *lp = 0;
2804         if (SvTYPE(sv) < SVt_PV)
2805             /* Typically the caller expects that sv_any is not NULL now.  */
2806             sv_upgrade(sv, SVt_PV);
2807         return (char *)"";
2808     }
2809     {
2810         const STRLEN len = s - SvPVX_const(sv);
2811         if (lp) 
2812             *lp = len;
2813         SvCUR_set(sv, len);
2814     }
2815     SvPOK_on(sv);
2816     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2pv(%s)\n",
2817                           PTR2UV(sv),SvPVX_const(sv)));
2818     if (flags & SV_CONST_RETURN)
2819         return (char *)SvPVX_const(sv);
2820     if (flags & SV_MUTABLE_RETURN)
2821         return SvPVX_mutable(sv);
2822     return SvPVX(sv);
2823 }
2824
2825 /*
2826 =for apidoc sv_copypv
2827
2828 Copies a stringified representation of the source SV into the
2829 destination SV.  Automatically performs any necessary mg_get and
2830 coercion of numeric values into strings.  Guaranteed to preserve
2831 UTF-8 flag even from overloaded objects.  Similar in nature to
2832 sv_2pv[_flags] but operates directly on an SV instead of just the
2833 string.  Mostly uses sv_2pv_flags to do its work, except when that
2834 would lose the UTF-8'ness of the PV.
2835
2836 =cut
2837 */
2838
2839 void
2840 Perl_sv_copypv(pTHX_ SV *dsv, register SV *ssv)
2841 {
2842     STRLEN len;
2843     const char * const s = SvPV_const(ssv,len);
2844     sv_setpvn(dsv,s,len);
2845     if (SvUTF8(ssv))
2846         SvUTF8_on(dsv);
2847     else
2848         SvUTF8_off(dsv);
2849 }
2850
2851 /*
2852 =for apidoc sv_2pvbyte
2853
2854 Return a pointer to the byte-encoded representation of the SV, and set *lp
2855 to its length.  May cause the SV to be downgraded from UTF-8 as a
2856 side-effect.
2857
2858 Usually accessed via the C<SvPVbyte> macro.
2859
2860 =cut
2861 */
2862
2863 char *
2864 Perl_sv_2pvbyte(pTHX_ register SV *sv, STRLEN *lp)
2865 {
2866     sv_utf8_downgrade(sv,0);
2867     return lp ? SvPV(sv,*lp) : SvPV_nolen(sv);
2868 }
2869
2870 /*
2871 =for apidoc sv_2pvutf8
2872
2873 Return a pointer to the UTF-8-encoded representation of the SV, and set *lp
2874 to its length.  May cause the SV to be upgraded to UTF-8 as a side-effect.
2875
2876 Usually accessed via the C<SvPVutf8> macro.
2877
2878 =cut
2879 */
2880
2881 char *
2882 Perl_sv_2pvutf8(pTHX_ register SV *sv, STRLEN *lp)
2883 {
2884     sv_utf8_upgrade(sv);
2885     return lp ? SvPV(sv,*lp) : SvPV_nolen(sv);
2886 }
2887
2888
2889 /*
2890 =for apidoc sv_2bool
2891
2892 This function is only called on magical items, and is only used by
2893 sv_true() or its macro equivalent.
2894
2895 =cut
2896 */
2897
2898 bool
2899 Perl_sv_2bool(pTHX_ register SV *sv)
2900 {
2901     dVAR;
2902     SvGETMAGIC(sv);
2903
2904     if (!SvOK(sv))
2905         return 0;
2906     if (SvROK(sv)) {
2907         if (SvAMAGIC(sv)) {
2908             SV * const tmpsv = AMG_CALLun(sv,bool_);
2909             if (tmpsv && (!SvROK(tmpsv) || (SvRV(tmpsv) != SvRV(sv))))
2910                 return (bool)SvTRUE(tmpsv);
2911         }
2912         return SvRV(sv) != 0;
2913     }
2914     if (SvPOKp(sv)) {
2915         register XPV* const Xpvtmp = (XPV*)SvANY(sv);
2916         if (Xpvtmp &&
2917                 (*sv->sv_u.svu_pv > '0' ||
2918                 Xpvtmp->xpv_cur > 1 ||
2919                 (Xpvtmp->xpv_cur && *sv->sv_u.svu_pv != '0')))
2920             return 1;
2921         else
2922             return 0;
2923     }
2924     else {
2925         if (SvIOKp(sv))
2926             return SvIVX(sv) != 0;
2927         else {
2928             if (SvNOKp(sv))
2929                 return SvNVX(sv) != 0.0;
2930             else {
2931                 if (isGV_with_GP(sv))
2932                     return TRUE;
2933                 else
2934                     return FALSE;
2935             }
2936         }
2937     }
2938 }
2939
2940 /*
2941 =for apidoc sv_utf8_upgrade
2942
2943 Converts the PV of an SV to its UTF-8-encoded form.
2944 Forces the SV to string form if it is not already.
2945 Always sets the SvUTF8 flag to avoid future validity checks even
2946 if all the bytes have hibit clear.
2947
2948 This is not as a general purpose byte encoding to Unicode interface:
2949 use the Encode extension for that.
2950
2951 =for apidoc sv_utf8_upgrade_flags
2952
2953 Converts the PV of an SV to its UTF-8-encoded form.
2954 Forces the SV to string form if it is not already.
2955 Always sets the SvUTF8 flag to avoid future validity checks even
2956 if all the bytes have hibit clear. If C<flags> has C<SV_GMAGIC> bit set,
2957 will C<mg_get> on C<sv> if appropriate, else not. C<sv_utf8_upgrade> and
2958 C<sv_utf8_upgrade_nomg> are implemented in terms of this function.
2959
2960 This is not as a general purpose byte encoding to Unicode interface:
2961 use the Encode extension for that.
2962
2963 =cut
2964 */
2965
2966 STRLEN
2967 Perl_sv_utf8_upgrade_flags(pTHX_ register SV *sv, I32 flags)
2968 {
2969     dVAR;
2970     if (sv == &PL_sv_undef)
2971         return 0;
2972     if (!SvPOK(sv)) {
2973         STRLEN len = 0;
2974         if (SvREADONLY(sv) && (SvPOKp(sv) || SvIOKp(sv) || SvNOKp(sv))) {
2975             (void) sv_2pv_flags(sv,&len, flags);
2976             if (SvUTF8(sv))
2977                 return len;
2978         } else {
2979             (void) SvPV_force(sv,len);
2980         }
2981     }
2982
2983     if (SvUTF8(sv)) {
2984         return SvCUR(sv);
2985     }
2986
2987     if (SvIsCOW(sv)) {
2988         sv_force_normal_flags(sv, 0);
2989     }
2990
2991     if (PL_encoding && !(flags & SV_UTF8_NO_ENCODING))
2992         sv_recode_to_utf8(sv, PL_encoding);
2993     else { /* Assume Latin-1/EBCDIC */
2994         /* This function could be much more efficient if we
2995          * had a FLAG in SVs to signal if there are any hibit
2996          * chars in the PV.  Given that there isn't such a flag
2997          * make the loop as fast as possible. */
2998         const U8 * const s = (U8 *) SvPVX_const(sv);
2999         const U8 * const e = (U8 *) SvEND(sv);
3000         const U8 *t = s;
3001         
3002         while (t < e) {
3003             const U8 ch = *t++;
3004             /* Check for hi bit */
3005             if (!NATIVE_IS_INVARIANT(ch)) {
3006                 STRLEN len = SvCUR(sv) + 1; /* Plus the \0 */
3007                 U8 * const recoded = bytes_to_utf8((U8*)s, &len);
3008
3009                 SvPV_free(sv); /* No longer using what was there before. */
3010                 SvPV_set(sv, (char*)recoded);
3011                 SvCUR_set(sv, len - 1);
3012                 SvLEN_set(sv, len); /* No longer know the real size. */
3013                 break;
3014             }
3015         }
3016         /* Mark as UTF-8 even if no hibit - saves scanning loop */
3017         SvUTF8_on(sv);
3018     }
3019     return SvCUR(sv);
3020 }
3021
3022 /*
3023 =for apidoc sv_utf8_downgrade
3024
3025 Attempts to convert the PV of an SV from characters to bytes.
3026 If the PV contains a character beyond byte, this conversion will fail;
3027 in this case, either returns false or, if C<fail_ok> is not
3028 true, croaks.
3029
3030 This is not as a general purpose Unicode to byte encoding interface:
3031 use the Encode extension for that.
3032
3033 =cut
3034 */
3035
3036 bool
3037 Perl_sv_utf8_downgrade(pTHX_ register SV* sv, bool fail_ok)
3038 {
3039     dVAR;
3040     if (SvPOKp(sv) && SvUTF8(sv)) {
3041         if (SvCUR(sv)) {
3042             U8 *s;
3043             STRLEN len;
3044
3045             if (SvIsCOW(sv)) {
3046                 sv_force_normal_flags(sv, 0);
3047             }
3048             s = (U8 *) SvPV(sv, len);
3049             if (!utf8_to_bytes(s, &len)) {
3050                 if (fail_ok)
3051                     return FALSE;
3052                 else {
3053                     if (PL_op)
3054                         Perl_croak(aTHX_ "Wide character in %s",
3055                                    OP_DESC(PL_op));
3056                     else
3057                         Perl_croak(aTHX_ "Wide character");
3058                 }
3059             }
3060             SvCUR_set(sv, len);
3061         }
3062     }
3063     SvUTF8_off(sv);
3064     return TRUE;
3065 }
3066
3067 /*
3068 =for apidoc sv_utf8_encode
3069
3070 Converts the PV of an SV to UTF-8, but then turns the C<SvUTF8>
3071 flag off so that it looks like octets again.
3072
3073 =cut
3074 */
3075
3076 void
3077 Perl_sv_utf8_encode(pTHX_ register SV *sv)
3078 {
3079     (void) sv_utf8_upgrade(sv);
3080     if (SvIsCOW(sv)) {
3081         sv_force_normal_flags(sv, 0);
3082     }
3083     if (SvREADONLY(sv)) {
3084         Perl_croak(aTHX_ PL_no_modify);
3085     }
3086     SvUTF8_off(sv);
3087 }
3088
3089 /*
3090 =for apidoc sv_utf8_decode
3091
3092 If the PV of the SV is an octet sequence in UTF-8
3093 and contains a multiple-byte character, the C<SvUTF8> flag is turned on
3094 so that it looks like a character. If the PV contains only single-byte
3095 characters, the C<SvUTF8> flag stays being off.
3096 Scans PV for validity and returns false if the PV is invalid UTF-8.
3097
3098 =cut
3099 */
3100
3101 bool
3102 Perl_sv_utf8_decode(pTHX_ register SV *sv)
3103 {
3104     if (SvPOKp(sv)) {
3105         const U8 *c;
3106         const U8 *e;
3107
3108         /* The octets may have got themselves encoded - get them back as
3109          * bytes
3110          */
3111         if (!sv_utf8_downgrade(sv, TRUE))
3112             return FALSE;
3113
3114         /* it is actually just a matter of turning the utf8 flag on, but
3115          * we want to make sure everything inside is valid utf8 first.
3116          */
3117         c = (const U8 *) SvPVX_const(sv);
3118         if (!is_utf8_string(c, SvCUR(sv)+1))
3119             return FALSE;
3120         e = (const U8 *) SvEND(sv);
3121         while (c < e) {
3122             const U8 ch = *c++;
3123             if (!UTF8_IS_INVARIANT(ch)) {
3124                 SvUTF8_on(sv);
3125                 break;
3126             }
3127         }
3128     }
3129     return TRUE;
3130 }
3131
3132 /*
3133 =for apidoc sv_setsv
3134
3135 Copies the contents of the source SV C<ssv> into the destination SV
3136 C<dsv>.  The source SV may be destroyed if it is mortal, so don't use this
3137 function if the source SV needs to be reused. Does not handle 'set' magic.
3138 Loosely speaking, it performs a copy-by-value, obliterating any previous
3139 content of the destination.
3140
3141 You probably want to use one of the assortment of wrappers, such as
3142 C<SvSetSV>, C<SvSetSV_nosteal>, C<SvSetMagicSV> and
3143 C<SvSetMagicSV_nosteal>.
3144
3145 =for apidoc sv_setsv_flags
3146
3147 Copies the contents of the source SV C<ssv> into the destination SV
3148 C<dsv>.  The source SV may be destroyed if it is mortal, so don't use this
3149 function if the source SV needs to be reused. Does not handle 'set' magic.
3150 Loosely speaking, it performs a copy-by-value, obliterating any previous
3151 content of the destination.
3152 If the C<flags> parameter has the C<SV_GMAGIC> bit set, will C<mg_get> on
3153 C<ssv> if appropriate, else not. If the C<flags> parameter has the
3154 C<NOSTEAL> bit set then the buffers of temps will not be stolen. <sv_setsv>
3155 and C<sv_setsv_nomg> are implemented in terms of this function.
3156
3157 You probably want to use one of the assortment of wrappers, such as
3158 C<SvSetSV>, C<SvSetSV_nosteal>, C<SvSetMagicSV> and
3159 C<SvSetMagicSV_nosteal>.
3160
3161 This is the primary function for copying scalars, and most other
3162 copy-ish functions and macros use this underneath.
3163
3164 =cut
3165 */
3166
3167 static void
3168 S_glob_assign_glob(pTHX_ SV *dstr, SV *sstr, const int dtype)
3169 {
3170     if (dtype != SVt_PVGV) {
3171         const char * const name = GvNAME(sstr);
3172         const STRLEN len = GvNAMELEN(sstr);
3173         /* don't upgrade SVt_PVLV: it can hold a glob */
3174         if (dtype != SVt_PVLV) {
3175             if (dtype >= SVt_PV) {
3176                 SvPV_free(dstr);
3177                 SvPV_set(dstr, 0);
3178                 SvLEN_set(dstr, 0);
3179                 SvCUR_set(dstr, 0);
3180             }
3181             sv_upgrade(dstr, SVt_PVGV);
3182             (void)SvOK_off(dstr);
3183             SvSCREAM_on(dstr);
3184         }
3185         GvSTASH(dstr) = GvSTASH(sstr);
3186         if (GvSTASH(dstr))
3187             Perl_sv_add_backref(aTHX_ (SV*)GvSTASH(dstr), dstr);
3188         gv_name_set((GV *)dstr, name, len, GV_ADD);
3189         SvFAKE_on(dstr);        /* can coerce to non-glob */
3190     }
3191
3192 #ifdef GV_UNIQUE_CHECK
3193     if (GvUNIQUE((GV*)dstr)) {
3194         Perl_croak(aTHX_ PL_no_modify);
3195     }
3196 #endif
3197
3198     gp_free((GV*)dstr);
3199     SvSCREAM_off(dstr);
3200     (void)SvOK_off(dstr);
3201     SvSCREAM_on(dstr);
3202     GvINTRO_off(dstr);          /* one-shot flag */
3203     GvGP(dstr) = gp_ref(GvGP(sstr));
3204     if (SvTAINTED(sstr))
3205         SvTAINT(dstr);
3206     if (GvIMPORTED(dstr) != GVf_IMPORTED
3207         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
3208         {
3209             GvIMPORTED_on(dstr);
3210         }
3211     GvMULTI_on(dstr);
3212     return;
3213 }
3214
3215 static void
3216 S_glob_assign_ref(pTHX_ SV *dstr, SV *sstr) {
3217     SV * const sref = SvREFCNT_inc(SvRV(sstr));
3218     SV *dref = NULL;
3219     const int intro = GvINTRO(dstr);
3220     SV **location;
3221     U8 import_flag = 0;
3222     const U32 stype = SvTYPE(sref);
3223
3224
3225 #ifdef GV_UNIQUE_CHECK
3226     if (GvUNIQUE((GV*)dstr)) {
3227         Perl_croak(aTHX_ PL_no_modify);
3228     }
3229 #endif
3230
3231     if (intro) {
3232         GvINTRO_off(dstr);      /* one-shot flag */
3233         GvLINE(dstr) = CopLINE(PL_curcop);
3234         GvEGV(dstr) = (GV*)dstr;
3235     }
3236     GvMULTI_on(dstr);
3237     switch (stype) {
3238     case SVt_PVCV:
3239         location = (SV **) &GvCV(dstr);
3240         import_flag = GVf_IMPORTED_CV;
3241         goto common;
3242     case SVt_PVHV:
3243         location = (SV **) &GvHV(dstr);
3244         import_flag = GVf_IMPORTED_HV;
3245         goto common;
3246     case SVt_PVAV:
3247         location = (SV **) &GvAV(dstr);
3248         import_flag = GVf_IMPORTED_AV;
3249         goto common;
3250     case SVt_PVIO:
3251         location = (SV **) &GvIOp(dstr);
3252         goto common;
3253     case SVt_PVFM:
3254         location = (SV **) &GvFORM(dstr);
3255     default:
3256         location = &GvSV(dstr);
3257         import_flag = GVf_IMPORTED_SV;
3258     common:
3259         if (intro) {
3260             if (stype == SVt_PVCV) {
3261                 if (GvCVGEN(dstr) && GvCV(dstr) != (CV*)sref) {
3262                     SvREFCNT_dec(GvCV(dstr));
3263                     GvCV(dstr) = NULL;
3264                     GvCVGEN(dstr) = 0; /* Switch off cacheness. */
3265                     PL_sub_generation++;
3266                 }
3267             }
3268             SAVEGENERICSV(*location);
3269         }
3270         else
3271             dref = *location;
3272         if (stype == SVt_PVCV && *location != sref) {
3273             CV* const cv = (CV*)*location;
3274             if (cv) {
3275                 if (!GvCVGEN((GV*)dstr) &&
3276                     (CvROOT(cv) || CvXSUB(cv)))
3277                     {
3278                         /* Redefining a sub - warning is mandatory if
3279                            it was a const and its value changed. */
3280                         if (CvCONST(cv) && CvCONST((CV*)sref)
3281                             && cv_const_sv(cv) == cv_const_sv((CV*)sref)) {
3282                             /*EMPTY*/
3283                             /* They are 2 constant subroutines generated from
3284                                the same constant. This probably means that
3285                                they are really the "same" proxy subroutine
3286                                instantiated in 2 places. Most likely this is
3287                                when a constant is exported twice.  Don't warn.
3288                             */
3289                         }
3290                         else if (ckWARN(WARN_REDEFINE)
3291                                  || (CvCONST(cv)
3292                                      && (!CvCONST((CV*)sref)
3293                                          || sv_cmp(cv_const_sv(cv),
3294                                                    cv_const_sv((CV*)sref))))) {
3295                             Perl_warner(aTHX_ packWARN(WARN_REDEFINE),
3296                                         CvCONST(cv)
3297                                         ? "Constant subroutine %s::%s redefined"
3298                                         : "Subroutine %s::%s redefined",
3299                                         HvNAME_get(GvSTASH((GV*)dstr)),
3300                                         GvENAME((GV*)dstr));
3301                         }
3302                     }
3303                 if (!intro)
3304                     cv_ckproto(cv, (GV*)dstr,
3305                                SvPOK(sref) ? SvPVX_const(sref) : NULL);
3306             }
3307             GvCVGEN(dstr) = 0; /* Switch off cacheness. */
3308             GvASSUMECV_on(dstr);
3309             PL_sub_generation++;
3310         }
3311         *location = sref;
3312         if (import_flag && !(GvFLAGS(dstr) & import_flag)
3313             && CopSTASH_ne(PL_curcop, GvSTASH(dstr))) {
3314             GvFLAGS(dstr) |= import_flag;
3315         }
3316         break;
3317     }
3318     SvREFCNT_dec(dref);
3319     if (SvTAINTED(sstr))
3320         SvTAINT(dstr);
3321     return;
3322 }
3323
3324 void
3325 Perl_sv_setsv_flags(pTHX_ SV *dstr, register SV *sstr, I32 flags)
3326 {
3327     dVAR;
3328     register U32 sflags;
3329     register int dtype;
3330     register int stype;
3331
3332     if (sstr == dstr)
3333         return;
3334     SV_CHECK_THINKFIRST_COW_DROP(dstr);
3335     if (!sstr)
3336         sstr = &PL_sv_undef;
3337     stype = SvTYPE(sstr);
3338     dtype = SvTYPE(dstr);
3339
3340     SvAMAGIC_off(dstr);
3341     if ( SvVOK(dstr) )
3342     {
3343         /* need to nuke the magic */
3344         mg_free(dstr);
3345         SvRMAGICAL_off(dstr);
3346     }
3347
3348     /* There's a lot of redundancy below but we're going for speed here */
3349
3350     switch (stype) {
3351     case SVt_NULL:
3352       undef_sstr:
3353         if (dtype != SVt_PVGV) {
3354             (void)SvOK_off(dstr);
3355             return;
3356         }
3357         break;
3358     case SVt_IV:
3359         if (SvIOK(sstr)) {
3360             switch (dtype) {
3361             case SVt_NULL:
3362                 sv_upgrade(dstr, SVt_IV);
3363                 break;
3364             case SVt_NV:
3365             case SVt_RV:
3366             case SVt_PV:
3367                 sv_upgrade(dstr, SVt_PVIV);
3368                 break;
3369             }
3370             (void)SvIOK_only(dstr);
3371             SvIV_set(dstr,  SvIVX(sstr));
3372             if (SvIsUV(sstr))
3373                 SvIsUV_on(dstr);
3374             /* SvTAINTED can only be true if the SV has taint magic, which in
3375                turn means that the SV type is PVMG (or greater). This is the
3376                case statement for SVt_IV, so this cannot be true (whatever gcov
3377                may say).  */
3378             assert(!SvTAINTED(sstr));
3379             return;
3380         }
3381         goto undef_sstr;
3382
3383     case SVt_NV:
3384         if (SvNOK(sstr)) {
3385             switch (dtype) {
3386             case SVt_NULL:
3387             case SVt_IV:
3388                 sv_upgrade(dstr, SVt_NV);
3389                 break;
3390             case SVt_RV:
3391             case SVt_PV:
3392             case SVt_PVIV:
3393                 sv_upgrade(dstr, SVt_PVNV);
3394                 break;
3395             }
3396             SvNV_set(dstr, SvNVX(sstr));
3397             (void)SvNOK_only(dstr);
3398             /* SvTAINTED can only be true if the SV has taint magic, which in
3399                turn means that the SV type is PVMG (or greater). This is the
3400                case statement for SVt_NV, so this cannot be true (whatever gcov
3401                may say).  */
3402             assert(!SvTAINTED(sstr));
3403             return;
3404         }
3405         goto undef_sstr;
3406
3407     case SVt_RV:
3408         if (dtype < SVt_RV)
3409             sv_upgrade(dstr, SVt_RV);
3410         break;
3411     case SVt_PVFM:
3412 #ifdef PERL_OLD_COPY_ON_WRITE
3413         if ((SvFLAGS(sstr) & CAN_COW_MASK) == CAN_COW_FLAGS) {
3414             if (dtype < SVt_PVIV)
3415                 sv_upgrade(dstr, SVt_PVIV);
3416             break;
3417         }
3418         /* Fall through */
3419 #endif
3420     case SVt_PV:
3421         if (dtype < SVt_PV)
3422             sv_upgrade(dstr, SVt_PV);
3423         break;
3424     case SVt_PVIV:
3425         if (dtype < SVt_PVIV)
3426             sv_upgrade(dstr, SVt_PVIV);
3427         break;
3428     case SVt_PVNV:
3429         if (dtype < SVt_PVNV)
3430             sv_upgrade(dstr, SVt_PVNV);
3431         break;
3432     default:
3433         {
3434         const char * const type = sv_reftype(sstr,0);
3435         if (PL_op)
3436             Perl_croak(aTHX_ "Bizarre copy of %s in %s", type, OP_NAME(PL_op));
3437         else
3438             Perl_croak(aTHX_ "Bizarre copy of %s", type);
3439         }
3440         break;
3441
3442     case SVt_PVGV:
3443         if (dtype <= SVt_PVGV) {
3444             S_glob_assign_glob(aTHX_ dstr, sstr, dtype);
3445             return;
3446         }
3447         /*FALLTHROUGH*/
3448
3449     case SVt_PVMG:
3450     case SVt_PVLV:
3451     case SVt_PVBM:
3452         if (SvGMAGICAL(sstr) && (flags & SV_GMAGIC)) {
3453             mg_get(sstr);
3454             if ((int)SvTYPE(sstr) != stype) {
3455                 stype = SvTYPE(sstr);
3456                 if (stype == SVt_PVGV && dtype <= SVt_PVGV) {
3457                     S_glob_assign_glob(aTHX_ dstr, sstr, dtype);
3458                     return;
3459                 }
3460             }
3461         }
3462         if (stype == SVt_PVLV)
3463             SvUPGRADE(dstr, SVt_PVNV);
3464         else
3465             SvUPGRADE(dstr, (U32)stype);
3466     }
3467
3468     /* dstr may have been upgraded.  */
3469     dtype = SvTYPE(dstr);
3470     sflags = SvFLAGS(sstr);
3471
3472     if (sflags & SVf_ROK) {
3473         if (dtype == SVt_PVGV &&
3474             SvROK(sstr) && SvTYPE(SvRV(sstr)) == SVt_PVGV) {
3475             sstr = SvRV(sstr);
3476             if (sstr == dstr) {
3477                 if (GvIMPORTED(dstr) != GVf_IMPORTED
3478                     && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
3479                 {
3480                     GvIMPORTED_on(dstr);
3481                 }
3482                 GvMULTI_on(dstr);
3483                 return;
3484             }
3485             S_glob_assign_glob(aTHX_ dstr, sstr, dtype);
3486             return;
3487         }
3488
3489         if (dtype >= SVt_PV) {
3490             if (dtype == SVt_PVGV) {
3491                 S_glob_assign_ref(aTHX_ dstr, sstr);
3492                 return;
3493             }
3494             if (SvPVX_const(dstr)) {
3495                 SvPV_free(dstr);
3496                 SvLEN_set(dstr, 0);
3497                 SvCUR_set(dstr, 0);
3498             }
3499         }
3500         (void)SvOK_off(dstr);
3501         SvRV_set(dstr, SvREFCNT_inc(SvRV(sstr)));
3502         SvFLAGS(dstr) |= sflags & (SVf_ROK|SVf_AMAGIC);
3503         assert(!(sflags & SVp_NOK));
3504         assert(!(sflags & SVp_IOK));
3505         assert(!(sflags & SVf_NOK));
3506         assert(!(sflags & SVf_IOK));
3507     }
3508     else if (dtype == SVt_PVGV) {
3509         if (!(sflags & SVf_OK)) {
3510             if (ckWARN(WARN_MISC))
3511                 Perl_warner(aTHX_ packWARN(WARN_MISC),
3512                             "Undefined value assigned to typeglob");
3513         }
3514         else {
3515             GV *gv = gv_fetchsv(sstr, GV_ADD, SVt_PVGV);
3516             if (dstr != (SV*)gv) {
3517                 if (GvGP(dstr))
3518                     gp_free((GV*)dstr);
3519                 GvGP(dstr) = gp_ref(GvGP(gv));
3520             }
3521         }
3522     }
3523     else if (sflags & SVp_POK) {
3524         bool isSwipe = 0;
3525
3526         /*
3527          * Check to see if we can just swipe the string.  If so, it's a
3528          * possible small lose on short strings, but a big win on long ones.
3529          * It might even be a win on short strings if SvPVX_const(dstr)
3530          * has to be allocated and SvPVX_const(sstr) has to be freed.
3531          */
3532
3533         /* Whichever path we take through the next code, we want this true,
3534            and doing it now facilitates the COW check.  */
3535         (void)SvPOK_only(dstr);
3536
3537         if (
3538             /* We're not already COW  */
3539             ((sflags & (SVf_FAKE | SVf_READONLY)) != (SVf_FAKE | SVf_READONLY)
3540 #ifndef PERL_OLD_COPY_ON_WRITE
3541              /* or we are, but dstr isn't a suitable target.  */
3542              || (SvFLAGS(dstr) & CAN_COW_MASK) != CAN_COW_FLAGS
3543 #endif
3544              )
3545             &&
3546             !(isSwipe =
3547                  (sflags & SVs_TEMP) &&   /* slated for free anyway? */
3548                  !(sflags & SVf_OOK) &&   /* and not involved in OOK hack? */
3549                  (!(flags & SV_NOSTEAL)) &&
3550                                         /* and we're allowed to steal temps */
3551                  SvREFCNT(sstr) == 1 &&   /* and no other references to it? */
3552                  SvLEN(sstr)    &&        /* and really is a string */
3553                                 /* and won't be needed again, potentially */
3554               !(PL_op && PL_op->op_type == OP_AASSIGN))
3555 #ifdef PERL_OLD_COPY_ON_WRITE
3556             && !((sflags & CAN_COW_MASK) == CAN_COW_FLAGS
3557                  && (SvFLAGS(dstr) & CAN_COW_MASK) == CAN_COW_FLAGS
3558                  && SvTYPE(sstr) >= SVt_PVIV)
3559 #endif
3560             ) {
3561             /* Failed the swipe test, and it's not a shared hash key either.
3562                Have to copy the string.  */
3563             STRLEN len = SvCUR(sstr);
3564             SvGROW(dstr, len + 1);      /* inlined from sv_setpvn */
3565             Move(SvPVX_const(sstr),SvPVX(dstr),len,char);
3566             SvCUR_set(dstr, len);
3567             *SvEND(dstr) = '\0';
3568         } else {
3569             /* If PERL_OLD_COPY_ON_WRITE is not defined, then isSwipe will always
3570                be true in here.  */
3571             /* Either it's a shared hash key, or it's suitable for
3572                copy-on-write or we can swipe the string.  */
3573             if (DEBUG_C_TEST) {
3574                 PerlIO_printf(Perl_debug_log, "Copy on write: sstr --> dstr\n");
3575                 sv_dump(sstr);
3576                 sv_dump(dstr);
3577             }
3578 #ifdef PERL_OLD_COPY_ON_WRITE
3579             if (!isSwipe) {
3580                 /* I believe I should acquire a global SV mutex if
3581                    it's a COW sv (not a shared hash key) to stop
3582                    it going un copy-on-write.
3583                    If the source SV has gone un copy on write between up there
3584                    and down here, then (assert() that) it is of the correct
3585                    form to make it copy on write again */
3586                 if ((sflags & (SVf_FAKE | SVf_READONLY))
3587                     != (SVf_FAKE | SVf_READONLY)) {
3588                     SvREADONLY_on(sstr);
3589                     SvFAKE_on(sstr);
3590                     /* Make the source SV into a loop of 1.
3591                        (about to become 2) */
3592                     SV_COW_NEXT_SV_SET(sstr, sstr);
3593                 }
3594             }
3595 #endif
3596             /* Initial code is common.  */
3597             if (SvPVX_const(dstr)) {    /* we know that dtype >= SVt_PV */
3598                 SvPV_free(dstr);
3599             }
3600
3601             if (!isSwipe) {
3602                 /* making another shared SV.  */
3603                 STRLEN cur = SvCUR(sstr);
3604                 STRLEN len = SvLEN(sstr);
3605 #ifdef PERL_OLD_COPY_ON_WRITE
3606                 if (len) {
3607                     assert (SvTYPE(dstr) >= SVt_PVIV);
3608                     /* SvIsCOW_normal */
3609                     /* splice us in between source and next-after-source.  */
3610                     SV_COW_NEXT_SV_SET(dstr, SV_COW_NEXT_SV(sstr));
3611                     SV_COW_NEXT_SV_SET(sstr, dstr);
3612                     SvPV_set(dstr, SvPVX_mutable(sstr));
3613                 } else
3614 #endif
3615                 {
3616                     /* SvIsCOW_shared_hash */
3617                     DEBUG_C(PerlIO_printf(Perl_debug_log,
3618                                           "Copy on write: Sharing hash\n"));
3619
3620                     assert (SvTYPE(dstr) >= SVt_PV);
3621                     SvPV_set(dstr,
3622                              HEK_KEY(share_hek_hek(SvSHARED_HEK_FROM_PV(SvPVX_const(sstr)))));
3623                 }
3624                 SvLEN_set(dstr, len);
3625                 SvCUR_set(dstr, cur);
3626                 SvREADONLY_on(dstr);
3627                 SvFAKE_on(dstr);
3628                 /* Relesase a global SV mutex.  */
3629             }
3630             else
3631                 {       /* Passes the swipe test.  */
3632                 SvPV_set(dstr, SvPVX_mutable(sstr));
3633                 SvLEN_set(dstr, SvLEN(sstr));
3634                 SvCUR_set(dstr, SvCUR(sstr));
3635
3636                 SvTEMP_off(dstr);
3637                 (void)SvOK_off(sstr);   /* NOTE: nukes most SvFLAGS on sstr */
3638                 SvPV_set(sstr, NULL);
3639                 SvLEN_set(sstr, 0);
3640                 SvCUR_set(sstr, 0);
3641                 SvTEMP_off(sstr);
3642             }
3643         }
3644         if (sflags & SVp_NOK) {
3645             SvNV_set(dstr, SvNVX(sstr));
3646         }
3647         if (sflags & SVp_IOK) {
3648             SvRELEASE_IVX(dstr);
3649             SvIV_set(dstr, SvIVX(sstr));
3650             /* Must do this otherwise some other overloaded use of 0x80000000
3651                gets confused. I guess SVpbm_VALID */
3652             if (sflags & SVf_IVisUV)
3653                 SvIsUV_on(dstr);
3654         }
3655         SvFLAGS(dstr) |= sflags & (SVf_IOK|SVp_IOK|SVf_NOK|SVp_NOK|SVf_UTF8
3656                                    |SVf_AMAGIC);
3657         {
3658             const MAGIC * const smg = SvVOK(sstr);
3659             if (smg) {
3660                 sv_magic(dstr, NULL, PERL_MAGIC_vstring,
3661                          smg->mg_ptr, smg->mg_len);
3662                 SvRMAGICAL_on(dstr);
3663             }
3664         }
3665     }
3666     else if (sflags & (SVp_IOK|SVp_NOK)) {
3667         (void)SvOK_off(dstr);
3668         SvFLAGS(dstr) |= sflags & (SVf_IOK|SVp_IOK|SVf_IVisUV|SVf_NOK|SVp_NOK
3669                                    |SVf_AMAGIC);
3670         if (sflags & SVp_IOK) {
3671             /* XXXX Do we want to set IsUV for IV(ROK)?  Be extra safe... */
3672             SvIV_set(dstr, SvIVX(sstr));
3673         }
3674         if (sflags & SVp_NOK) {
3675             SvNV_set(dstr, SvNVX(sstr));
3676         }
3677     }
3678     else {
3679         if (isGV_with_GP(sstr)) {
3680             /* This stringification rule for globs is spread in 3 places.
3681                This feels bad. FIXME.  */
3682             const U32 wasfake = sflags & SVf_FAKE;
3683
3684             /* FAKE globs can get coerced, so need to turn this off
3685                temporarily if it is on.  */
3686             SvFAKE_off(sstr);
3687             gv_efullname3(dstr, (GV *)sstr, "*");
3688             SvFLAGS(sstr) |= wasfake;
3689             SvFLAGS(dstr) |= sflags & SVf_AMAGIC;
3690         }
3691         else
3692             (void)SvOK_off(dstr);
3693     }
3694     if (SvTAINTED(sstr))
3695         SvTAINT(dstr);
3696 }
3697
3698 /*
3699 =for apidoc sv_setsv_mg
3700
3701 Like C<sv_setsv>, but also handles 'set' magic.
3702
3703 =cut
3704 */
3705
3706 void
3707 Perl_sv_setsv_mg(pTHX_ SV *dstr, register SV *sstr)
3708 {
3709     sv_setsv(dstr,sstr);
3710     SvSETMAGIC(dstr);
3711 }
3712
3713 #ifdef PERL_OLD_COPY_ON_WRITE
3714 SV *
3715 Perl_sv_setsv_cow(pTHX_ SV *dstr, SV *sstr)
3716 {
3717     STRLEN cur = SvCUR(sstr);
3718     STRLEN len = SvLEN(sstr);
3719     register char *new_pv;
3720
3721     if (DEBUG_C_TEST) {
3722         PerlIO_printf(Perl_debug_log, "Fast copy on write: %p -> %p\n",
3723                       sstr, dstr);
3724         sv_dump(sstr);
3725         if (dstr)
3726                     sv_dump(dstr);
3727     }
3728
3729     if (dstr) {
3730         if (SvTHINKFIRST(dstr))
3731             sv_force_normal_flags(dstr, SV_COW_DROP_PV);
3732         else if (SvPVX_const(dstr))
3733             Safefree(SvPVX_const(dstr));
3734     }
3735     else
3736         new_SV(dstr);
3737     SvUPGRADE(dstr, SVt_PVIV);
3738
3739     assert (SvPOK(sstr));
3740     assert (SvPOKp(sstr));
3741     assert (!SvIOK(sstr));
3742     assert (!SvIOKp(sstr));
3743     assert (!SvNOK(sstr));
3744     assert (!SvNOKp(sstr));
3745
3746     if (SvIsCOW(sstr)) {
3747
3748         if (SvLEN(sstr) == 0) {
3749             /* source is a COW shared hash key.  */
3750             DEBUG_C(PerlIO_printf(Perl_debug_log,
3751                                   "Fast copy on write: Sharing hash\n"));
3752             new_pv = HEK_KEY(share_hek_hek(SvSHARED_HEK_FROM_PV(SvPVX_const(sstr))));
3753             goto common_exit;
3754         }
3755         SV_COW_NEXT_SV_SET(dstr, SV_COW_NEXT_SV(sstr));
3756     } else {
3757         assert ((SvFLAGS(sstr) & CAN_COW_MASK) == CAN_COW_FLAGS);
3758         SvUPGRADE(sstr, SVt_PVIV);
3759         SvREADONLY_on(sstr);
3760         SvFAKE_on(sstr);
3761         DEBUG_C(PerlIO_printf(Perl_debug_log,
3762                               "Fast copy on write: Converting sstr to COW\n"));
3763         SV_COW_NEXT_SV_SET(dstr, sstr);
3764     }
3765     SV_COW_NEXT_SV_SET(sstr, dstr);
3766     new_pv = SvPVX_mutable(sstr);
3767
3768   common_exit:
3769     SvPV_set(dstr, new_pv);
3770     SvFLAGS(dstr) = (SVt_PVIV|SVf_POK|SVp_POK|SVf_FAKE|SVf_READONLY);
3771     if (SvUTF8(sstr))
3772         SvUTF8_on(dstr);
3773     SvLEN_set(dstr, len);
3774     SvCUR_set(dstr, cur);
3775     if (DEBUG_C_TEST) {
3776         sv_dump(dstr);
3777     }
3778     return dstr;
3779 }
3780 #endif
3781
3782 /*
3783 =for apidoc sv_setpvn
3784
3785 Copies a string into an SV.  The C<len> parameter indicates the number of
3786 bytes to be copied.  If the C<ptr> argument is NULL the SV will become
3787 undefined.  Does not handle 'set' magic.  See C<sv_setpvn_mg>.
3788
3789 =cut
3790 */
3791
3792 void
3793 Perl_sv_setpvn(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3794 {
3795     dVAR;
3796     register char *dptr;
3797
3798     SV_CHECK_THINKFIRST_COW_DROP(sv);
3799     if (!ptr) {
3800         (void)SvOK_off(sv);
3801         return;
3802     }
3803     else {
3804         /* len is STRLEN which is unsigned, need to copy to signed */
3805         const IV iv = len;
3806         if (iv < 0)
3807             Perl_croak(aTHX_ "panic: sv_setpvn called with negative strlen");
3808     }
3809     SvUPGRADE(sv, SVt_PV);
3810
3811     dptr = SvGROW(sv, len + 1);
3812     Move(ptr,dptr,len,char);
3813     dptr[len] = '\0';
3814     SvCUR_set(sv, len);
3815     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3816     SvTAINT(sv);
3817 }
3818
3819 /*
3820 =for apidoc sv_setpvn_mg
3821
3822 Like C<sv_setpvn>, but also handles 'set' magic.
3823
3824 =cut
3825 */
3826
3827 void
3828 Perl_sv_setpvn_mg(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3829 {
3830     sv_setpvn(sv,ptr,len);
3831     SvSETMAGIC(sv);
3832 }
3833
3834 /*
3835 =for apidoc sv_setpv
3836
3837 Copies a string into an SV.  The string must be null-terminated.  Does not
3838 handle 'set' magic.  See C<sv_setpv_mg>.
3839
3840 =cut
3841 */
3842
3843 void
3844 Perl_sv_setpv(pTHX_ register SV *sv, register const char *ptr)
3845 {
3846     dVAR;
3847     register STRLEN len;
3848
3849     SV_CHECK_THINKFIRST_COW_DROP(sv);
3850     if (!ptr) {
3851         (void)SvOK_off(sv);
3852         return;
3853     }
3854     len = strlen(ptr);
3855     SvUPGRADE(sv, SVt_PV);
3856
3857     SvGROW(sv, len + 1);
3858     Move(ptr,SvPVX(sv),len+1,char);
3859     SvCUR_set(sv, len);
3860     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3861     SvTAINT(sv);
3862 }
3863
3864 /*
3865 =for apidoc sv_setpv_mg
3866
3867 Like C<sv_setpv>, but also handles 'set' magic.
3868
3869 =cut
3870 */
3871
3872 void
3873 Perl_sv_setpv_mg(pTHX_ register SV *sv, register const char *ptr)
3874 {
3875     sv_setpv(sv,ptr);
3876     SvSETMAGIC(sv);
3877 }
3878
3879 /*
3880 =for apidoc sv_usepvn
3881
3882 Tells an SV to use C<ptr> to find its string value.  Normally the string is
3883 stored inside the SV but sv_usepvn allows the SV to use an outside string.
3884 The C<ptr> should point to memory that was allocated by C<malloc>.  The
3885 string length, C<len>, must be supplied.  This function will realloc the
3886 memory pointed to by C<ptr>, so that pointer should not be freed or used by
3887 the programmer after giving it to sv_usepvn.  Does not handle 'set' magic.
3888 See C<sv_usepvn_mg>.
3889
3890 =cut
3891 */
3892
3893 void
3894 Perl_sv_usepvn(pTHX_ register SV *sv, register char *ptr, register STRLEN len)
3895 {
3896     dVAR;
3897     STRLEN allocate;
3898     SV_CHECK_THINKFIRST_COW_DROP(sv);
3899     SvUPGRADE(sv, SVt_PV);
3900     if (!ptr) {
3901         (void)SvOK_off(sv);
3902         return;
3903     }
3904     if (SvPVX_const(sv))
3905         SvPV_free(sv);
3906
3907     allocate = PERL_STRLEN_ROUNDUP(len + 1);
3908     ptr = saferealloc (ptr, allocate);
3909     SvPV_set(sv, ptr);
3910     SvCUR_set(sv, len);
3911     SvLEN_set(sv, allocate);
3912     *SvEND(sv) = '\0';
3913     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3914     SvTAINT(sv);
3915 }
3916
3917 /*
3918 =for apidoc sv_usepvn_mg
3919
3920 Like C<sv_usepvn>, but also handles 'set' magic.
3921
3922 =cut
3923 */
3924
3925 void
3926 Perl_sv_usepvn_mg(pTHX_ register SV *sv, register char *ptr, register STRLEN len)
3927 {
3928     sv_usepvn(sv,ptr,len);
3929     SvSETMAGIC(sv);
3930 }
3931
3932 #ifdef PERL_OLD_COPY_ON_WRITE
3933 /* Need to do this *after* making the SV normal, as we need the buffer
3934    pointer to remain valid until after we've copied it.  If we let go too early,
3935    another thread could invalidate it by unsharing last of the same hash key
3936    (which it can do by means other than releasing copy-on-write Svs)
3937    or by changing the other copy-on-write SVs in the loop.  */
3938 STATIC void
3939 S_sv_release_COW(pTHX_ register SV *sv, const char *pvx, STRLEN len, SV *after)
3940 {
3941     if (len) { /* this SV was SvIsCOW_normal(sv) */
3942          /* we need to find the SV pointing to us.  */
3943         SV *current = SV_COW_NEXT_SV(after);
3944
3945         if (current == sv) {
3946             /* The SV we point to points back to us (there were only two of us
3947                in the loop.)
3948                Hence other SV is no longer copy on write either.  */
3949             SvFAKE_off(after);
3950             SvREADONLY_off(after);
3951         } else {
3952             /* We need to follow the pointers around the loop.  */
3953             SV *next;
3954             while ((next = SV_COW_NEXT_SV(current)) != sv) {
3955                 assert (next);
3956                 current = next;
3957                  /* don't loop forever if the structure is bust, and we have
3958                     a pointer into a closed loop.  */
3959                 assert (current != after);
3960                 assert (SvPVX_const(current) == pvx);
3961             }
3962             /* Make the SV before us point to the SV after us.  */
3963             SV_COW_NEXT_SV_SET(current, after);
3964         }
3965     } else {
3966         unshare_hek(SvSHARED_HEK_FROM_PV(pvx));
3967     }
3968 }
3969
3970 int
3971 Perl_sv_release_IVX(pTHX_ register SV *sv)
3972 {
3973     if (SvIsCOW(sv))
3974         sv_force_normal_flags(sv, 0);
3975     SvOOK_off(sv);
3976     return 0;
3977 }
3978 #endif
3979 /*
3980 =for apidoc sv_force_normal_flags
3981
3982 Undo various types of fakery on an SV: if the PV is a shared string, make
3983 a private copy; if we're a ref, stop refing; if we're a glob, downgrade to
3984 an xpvmg; if we're a copy-on-write scalar, this is the on-write time when
3985 we do the copy, and is also used locally. If C<SV_COW_DROP_PV> is set
3986 then a copy-on-write scalar drops its PV buffer (if any) and becomes
3987 SvPOK_off rather than making a copy. (Used where this scalar is about to be
3988 set to some other value.) In addition, the C<flags> parameter gets passed to
3989 C<sv_unref_flags()> when unrefing. C<sv_force_normal> calls this function
3990 with flags set to 0.
3991
3992 =cut
3993 */
3994
3995 void
3996 Perl_sv_force_normal_flags(pTHX_ register SV *sv, U32 flags)
3997 {
3998     dVAR;
3999 #ifdef PERL_OLD_COPY_ON_WRITE
4000     if (SvREADONLY(sv)) {
4001         /* At this point I believe I should acquire a global SV mutex.  */
4002         if (SvFAKE(sv)) {
4003             const char * const pvx = SvPVX_const(sv);
4004             const STRLEN len = SvLEN(sv);
4005             const STRLEN cur = SvCUR(sv);
4006             SV * const next = SV_COW_NEXT_SV(sv);   /* next COW sv in the loop. */
4007             if (DEBUG_C_TEST) {
4008                 PerlIO_printf(Perl_debug_log,
4009                               "Copy on write: Force normal %ld\n",
4010                               (long) flags);
4011                 sv_dump(sv);
4012             }
4013             SvFAKE_off(sv);
4014             SvREADONLY_off(sv);
4015             /* This SV doesn't own the buffer, so need to Newx() a new one:  */
4016             SvPV_set(sv, NULL);
4017             SvLEN_set(sv, 0);
4018             if (flags & SV_COW_DROP_PV) {
4019                 /* OK, so we don't need to copy our buffer.  */
4020                 SvPOK_off(sv);
4021             } else {
4022                 SvGROW(sv, cur + 1);
4023                 Move(pvx,SvPVX(sv),cur,char);
4024                 SvCUR_set(sv, cur);
4025                 *SvEND(sv) = '\0';
4026             }
4027             sv_release_COW(sv, pvx, len, next);
4028             if (DEBUG_C_TEST) {
4029                 sv_dump(sv);
4030             }
4031         }
4032         else if (IN_PERL_RUNTIME)
4033             Perl_croak(aTHX_ PL_no_modify);
4034         /* At this point I believe that I can drop the global SV mutex.  */
4035     }
4036 #else
4037     if (SvREADONLY(sv)) {
4038         if (SvFAKE(sv)) {
4039             const char * const pvx = SvPVX_const(sv);
4040             const STRLEN len = SvCUR(sv);
4041             SvFAKE_off(sv);
4042             SvREADONLY_off(sv);
4043             SvPV_set(sv, NULL);
4044             SvLEN_set(sv, 0);
4045             SvGROW(sv, len + 1);
4046             Move(pvx,SvPVX(sv),len,char);
4047             *SvEND(sv) = '\0';
4048             unshare_hek(SvSHARED_HEK_FROM_PV(pvx));
4049         }
4050         else if (IN_PERL_RUNTIME)
4051             Perl_croak(aTHX_ PL_no_modify);
4052     }
4053 #endif
4054     if (SvROK(sv))
4055         sv_unref_flags(sv, flags);
4056     else if (SvFAKE(sv) && SvTYPE(sv) == SVt_PVGV)
4057         sv_unglob(sv);
4058 }
4059
4060 /*
4061 =for apidoc sv_chop
4062
4063 Efficient removal of characters from the beginning of the string buffer.
4064 SvPOK(sv) must be true and the C<ptr> must be a pointer to somewhere inside
4065 the string buffer.  The C<ptr> becomes the first character of the adjusted
4066 string. Uses the "OOK hack".
4067 Beware: after this function returns, C<ptr> and SvPVX_const(sv) may no longer
4068 refer to the same chunk of data.
4069
4070 =cut
4071 */
4072
4073 void
4074 Perl_sv_chop(pTHX_ register SV *sv, register const char *ptr)
4075 {
4076     register STRLEN delta;
4077     if (!ptr || !SvPOKp(sv))
4078         return;
4079     delta = ptr - SvPVX_const(sv);
4080     SV_CHECK_THINKFIRST(sv);
4081     if (SvTYPE(sv) < SVt_PVIV)
4082         sv_upgrade(sv,SVt_PVIV);
4083
4084     if (!SvOOK(sv)) {
4085         if (!SvLEN(sv)) { /* make copy of shared string */
4086             const char *pvx = SvPVX_const(sv);
4087             const STRLEN len = SvCUR(sv);
4088             SvGROW(sv, len + 1);
4089             Move(pvx,SvPVX(sv),len,char);
4090             *SvEND(sv) = '\0';
4091         }
4092         SvIV_set(sv, 0);
4093         /* Same SvOOK_on but SvOOK_on does a SvIOK_off
4094            and we do that anyway inside the SvNIOK_off
4095         */
4096         SvFLAGS(sv) |= SVf_OOK;
4097     }
4098     SvNIOK_off(sv);
4099     SvLEN_set(sv, SvLEN(sv) - delta);
4100     SvCUR_set(sv, SvCUR(sv) - delta);
4101     SvPV_set(sv, SvPVX(sv) + delta);
4102     SvIV_set(sv, SvIVX(sv) + delta);
4103 }
4104
4105 /*
4106 =for apidoc sv_catpvn
4107
4108 Concatenates the string onto the end of the string which is in the SV.  The
4109 C<len> indicates number of bytes to copy.  If the SV has the UTF-8
4110 status set, then the bytes appended should be valid UTF-8.
4111 Handles 'get' magic, but not 'set' magic.  See C<sv_catpvn_mg>.
4112
4113 =for apidoc sv_catpvn_flags
4114
4115 Concatenates the string onto the end of the string which is in the SV.  The
4116 C<len> indicates number of bytes to copy.  If the SV has the UTF-8
4117 status set, then the bytes appended should be valid UTF-8.
4118 If C<flags> has C<SV_GMAGIC> bit set, will C<mg_get> on C<dsv> if
4119 appropriate, else not. C<sv_catpvn> and C<sv_catpvn_nomg> are implemented
4120 in terms of this function.
4121
4122 =cut
4123 */
4124
4125 void
4126 Perl_sv_catpvn_flags(pTHX_ register SV *dsv, register const char *sstr, register STRLEN slen, I32 flags)
4127 {
4128     dVAR;
4129     STRLEN dlen;
4130     const char * const dstr = SvPV_force_flags(dsv, dlen, flags);
4131
4132     SvGROW(dsv, dlen + slen + 1);
4133     if (sstr == dstr)
4134         sstr = SvPVX_const(dsv);
4135     Move(sstr, SvPVX(dsv) + dlen, slen, char);
4136     SvCUR_set(dsv, SvCUR(dsv) + slen);
4137     *SvEND(dsv) = '\0';
4138     (void)SvPOK_only_UTF8(dsv);         /* validate pointer */
4139     SvTAINT(dsv);
4140     if (flags & SV_SMAGIC)
4141         SvSETMAGIC(dsv);
4142 }
4143
4144 /*
4145 =for apidoc sv_catsv
4146
4147 Concatenates the string from SV C<ssv> onto the end of the string in
4148 SV C<dsv>.  Modifies C<dsv> but not C<ssv>.  Handles 'get' magic, but
4149 not 'set' magic.  See C<sv_catsv_mg>.
4150
4151 =for apidoc sv_catsv_flags
4152
4153 Concatenates the string from SV C<ssv> onto the end of the string in
4154 SV C<dsv>.  Modifies C<dsv> but not C<ssv>.  If C<flags> has C<SV_GMAGIC>
4155 bit set, will C<mg_get> on the SVs if appropriate, else not. C<sv_catsv>
4156 and C<sv_catsv_nomg> are implemented in terms of this function.
4157
4158 =cut */
4159
4160 void
4161 Perl_sv_catsv_flags(pTHX_ SV *dsv, register SV *ssv, I32 flags)
4162 {
4163     dVAR;
4164     if (ssv) {
4165         STRLEN slen;
4166         const char *spv = SvPV_const(ssv, slen);
4167         if (spv) {
4168             /*  sutf8 and dutf8 were type bool, but under USE_ITHREADS,
4169                 gcc version 2.95.2 20000220 (Debian GNU/Linux) for
4170                 Linux xxx 2.2.17 on sparc64 with gcc -O2, we erroneously
4171                 get dutf8 = 0x20000000, (i.e.  SVf_UTF8) even though
4172                 dsv->sv_flags doesn't have that bit set.
4173                 Andy Dougherty  12 Oct 2001
4174             */
4175             const I32 sutf8 = DO_UTF8(ssv);
4176             I32 dutf8;
4177
4178             if (SvGMAGICAL(dsv) && (flags & SV_GMAGIC))
4179                 mg_get(dsv);
4180             dutf8 = DO_UTF8(dsv);
4181
4182             if (dutf8 != sutf8) {
4183                 if (dutf8) {
4184                     /* Not modifying source SV, so taking a temporary copy. */
4185                     SV* const csv = sv_2mortal(newSVpvn(spv, slen));
4186
4187                     sv_utf8_upgrade(csv);
4188                     spv = SvPV_const(csv, slen);
4189                 }
4190                 else
4191                     sv_utf8_upgrade_nomg(dsv);
4192             }
4193             sv_catpvn_nomg(dsv, spv, slen);
4194         }
4195     }
4196     if (flags & SV_SMAGIC)
4197         SvSETMAGIC(dsv);
4198 }
4199
4200 /*
4201 =for apidoc sv_catpv
4202
4203 Concatenates the string onto the end of the string which is in the SV.
4204 If the SV has the UTF-8 status set, then the bytes appended should be
4205 valid UTF-8.  Handles 'get' magic, but not 'set' magic.  See C<sv_catpv_mg>.
4206
4207 =cut */
4208
4209 void
4210 Perl_sv_catpv(pTHX_ register SV *sv, register const char *ptr)
4211 {
4212     dVAR;
4213     register STRLEN len;
4214     STRLEN tlen;
4215     char *junk;
4216
4217     if (!ptr)
4218         return;
4219     junk = SvPV_force(sv, tlen);
4220     len = strlen(ptr);
4221     SvGROW(sv, tlen + len + 1);
4222     if (ptr == junk)
4223         ptr = SvPVX_const(sv);
4224     Move(ptr,SvPVX(sv)+tlen,len+1,char);
4225     SvCUR_set(sv, SvCUR(sv) + len);
4226     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
4227     SvTAINT(sv);
4228 }
4229
4230 /*
4231 =for apidoc sv_catpv_mg
4232
4233 Like C<sv_catpv>, but also handles 'set' magic.
4234
4235 =cut
4236 */
4237
4238 void
4239 Perl_sv_catpv_mg(pTHX_ register SV *sv, register const char *ptr)
4240 {
4241     sv_catpv(sv,ptr);
4242     SvSETMAGIC(sv);
4243 }
4244
4245 /*
4246 =for apidoc newSV
4247
4248 Creates a new SV.  A non-zero C<len> parameter indicates the number of
4249 bytes of preallocated string space the SV should have.  An extra byte for a
4250 trailing NUL is also reserved.  (SvPOK is not set for the SV even if string
4251 space is allocated.)  The reference count for the new SV is set to 1.
4252
4253 In 5.9.3, newSV() replaces the older NEWSV() API, and drops the first
4254 parameter, I<x>, a debug aid which allowed callers to identify themselves.
4255 This aid has been superseded by a new build option, PERL_MEM_LOG (see
4256 L<perlhack/PERL_MEM_LOG>).  The older API is still there for use in XS
4257 modules supporting older perls.
4258
4259 =cut
4260 */
4261
4262 SV *
4263 Perl_newSV(pTHX_ STRLEN len)
4264 {
4265     dVAR;
4266     register SV *sv;
4267
4268     new_SV(sv);
4269     if (len) {
4270         sv_upgrade(sv, SVt_PV);
4271         SvGROW(sv, len + 1);
4272     }
4273     return sv;
4274 }
4275 /*
4276 =for apidoc sv_magicext
4277
4278 Adds magic to an SV, upgrading it if necessary. Applies the
4279 supplied vtable and returns a pointer to the magic added.
4280
4281 Note that C<sv_magicext> will allow things that C<sv_magic> will not.
4282 In particular, you can add magic to SvREADONLY SVs, and add more than
4283 one instance of the same 'how'.
4284
4285 If C<namlen> is greater than zero then a C<savepvn> I<copy> of C<name> is
4286 stored, if C<namlen> is zero then C<name> is stored as-is and - as another
4287 special case - if C<(name && namlen == HEf_SVKEY)> then C<name> is assumed
4288 to contain an C<SV*> and is stored as-is with its REFCNT incremented.
4289
4290 (This is now used as a subroutine by C<sv_magic>.)
4291
4292 =cut
4293 */
4294 MAGIC * 
4295 Perl_sv_magicext(pTHX_ SV* sv, SV* obj, int how, MGVTBL *vtable,
4296                  const char* name, I32 namlen)
4297 {
4298     dVAR;
4299     MAGIC* mg;
4300
4301     if (SvTYPE(sv) < SVt_PVMG) {
4302         SvUPGRADE(sv, SVt_PVMG);
4303     }
4304     Newxz(mg, 1, MAGIC);
4305     mg->mg_moremagic = SvMAGIC(sv);
4306     SvMAGIC_set(sv, mg);
4307
4308     /* Sometimes a magic contains a reference loop, where the sv and
4309        object refer to each other.  To prevent a reference loop that
4310        would prevent such objects being freed, we look for such loops
4311        and if we find one we avoid incrementing the object refcount.
4312
4313        Note we cannot do this to avoid self-tie loops as intervening RV must
4314        have its REFCNT incremented to keep it in existence.
4315
4316     */
4317     if (!obj || obj == sv ||
4318         how == PERL_MAGIC_arylen ||
4319         how == PERL_MAGIC_qr ||
4320         how == PERL_MAGIC_symtab ||
4321         (SvTYPE(obj) == SVt_PVGV &&
4322             (GvSV(obj) == sv || GvHV(obj) == (HV*)sv || GvAV(obj) == (AV*)sv ||
4323             GvCV(obj) == (CV*)sv || GvIOp(obj) == (IO*)sv ||
4324             GvFORM(obj) == (CV*)sv)))
4325     {
4326         mg->mg_obj = obj;
4327     }
4328     else {
4329         mg->mg_obj = SvREFCNT_inc_simple(obj);
4330         mg->mg_flags |= MGf_REFCOUNTED;
4331     }
4332
4333     /* Normal self-ties simply pass a null object, and instead of
4334        using mg_obj directly, use the SvTIED_obj macro to produce a
4335        new RV as needed.  For glob "self-ties", we are tieing the PVIO
4336        with an RV obj pointing to the glob containing the PVIO.  In
4337        this case, to avoid a reference loop, we need to weaken the
4338        reference.
4339     */
4340
4341     if (how == PERL_MAGIC_tiedscalar && SvTYPE(sv) == SVt_PVIO &&
4342         obj && SvROK(obj) && GvIO(SvRV(obj)) == (IO*)sv)
4343     {
4344       sv_rvweaken(obj);
4345     }
4346
4347     mg->mg_type = how;
4348     mg->mg_len = namlen;
4349     if (name) {
4350         if (namlen > 0)
4351             mg->mg_ptr = savepvn(name, namlen);
4352         else if (namlen == HEf_SVKEY)
4353             mg->mg_ptr = (char*)SvREFCNT_inc_simple_NN((SV*)name);
4354         else
4355             mg->mg_ptr = (char *) name;
4356     }
4357     mg->mg_virtual = vtable;
4358
4359     mg_magical(sv);
4360     if (SvGMAGICAL(sv))
4361         SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVf_POK);
4362     return mg;
4363 }
4364
4365 /*
4366 =for apidoc sv_magic
4367
4368 Adds magic to an SV. First upgrades C<sv> to type C<SVt_PVMG> if necessary,
4369 then adds a new magic item of type C<how> to the head of the magic list.
4370
4371 See C<sv_magicext> (which C<sv_magic> now calls) for a description of the
4372 handling of the C<name> and C<namlen> arguments.
4373
4374 You need to use C<sv_magicext> to add magic to SvREADONLY SVs and also
4375 to add more than one instance of the same 'how'.
4376
4377 =cut
4378 */
4379
4380 void
4381 Perl_sv_magic(pTHX_ register SV *sv, SV *obj, int how, const char *name, I32 namlen)
4382 {
4383     dVAR;
4384     MGVTBL *vtable;
4385     MAGIC* mg;
4386
4387 #ifdef PERL_OLD_COPY_ON_WRITE
4388     if (SvIsCOW(sv))
4389         sv_force_normal_flags(sv, 0);
4390 #endif
4391     if (SvREADONLY(sv)) {
4392         if (
4393             /* its okay to attach magic to shared strings; the subsequent
4394              * upgrade to PVMG will unshare the string */
4395             !(SvFAKE(sv) && SvTYPE(sv) < SVt_PVMG)
4396
4397             && IN_PERL_RUNTIME
4398             && how != PERL_MAGIC_regex_global
4399             && how != PERL_MAGIC_bm
4400             && how != PERL_MAGIC_fm
4401             && how != PERL_MAGIC_sv
4402             && how != PERL_MAGIC_backref
4403            )
4404         {
4405             Perl_croak(aTHX_ PL_no_modify);
4406         }
4407     }
4408     if (SvMAGICAL(sv) || (how == PERL_MAGIC_taint && SvTYPE(sv) >= SVt_PVMG)) {
4409         if (SvMAGIC(sv) && (mg = mg_find(sv, how))) {
4410             /* sv_magic() refuses to add a magic of the same 'how' as an
4411                existing one
4412              */
4413             if (how == PERL_MAGIC_taint) {
4414                 mg->mg_len |= 1;
4415                 /* Any scalar which already had taint magic on which someone
4416                    (erroneously?) did SvIOK_on() or similar will now be
4417                    incorrectly sporting public "OK" flags.  */
4418                 SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVf_POK);
4419             }
4420             return;
4421         }
4422     }
4423
4424     switch (how) {
4425     case PERL_MAGIC_sv:
4426         vtable = &PL_vtbl_sv;
4427         break;
4428     case PERL_MAGIC_overload:
4429         vtable = &PL_vtbl_amagic;
4430         break;
4431     case PERL_MAGIC_overload_elem:
4432         vtable = &PL_vtbl_amagicelem;
4433         break;
4434     case PERL_MAGIC_overload_table:
4435         vtable = &PL_vtbl_ovrld;
4436         break;
4437     case PERL_MAGIC_bm:
4438         vtable = &PL_vtbl_bm;
4439         break;
4440     case PERL_MAGIC_regdata:
4441         vtable = &PL_vtbl_regdata;
4442         break;
4443     case PERL_MAGIC_regdatum:
4444         vtable = &PL_vtbl_regdatum;
4445         break;
4446     case PERL_MAGIC_env:
4447         vtable = &PL_vtbl_env;
4448         break;
4449     case PERL_MAGIC_fm:
4450         vtable = &PL_vtbl_fm;
4451         break;
4452     case PERL_MAGIC_envelem:
4453         vtable = &PL_vtbl_envelem;
4454         break;
4455     case PERL_MAGIC_regex_global:
4456         vtable = &PL_vtbl_mglob;
4457         break;
4458     case PERL_MAGIC_isa:
4459         vtable = &PL_vtbl_isa;
4460         break;
4461     case PERL_MAGIC_isaelem:
4462         vtable = &PL_vtbl_isaelem;
4463         break;
4464     case PERL_MAGIC_nkeys:
4465         vtable = &PL_vtbl_nkeys;
4466         break;
4467     case PERL_MAGIC_dbfile:
4468         vtable = NULL;
4469         break;
4470     case PERL_MAGIC_dbline:
4471         vtable = &PL_vtbl_dbline;
4472         break;
4473 #ifdef USE_LOCALE_COLLATE
4474     case PERL_MAGIC_collxfrm:
4475         vtable = &PL_vtbl_collxfrm;
4476         break;
4477 #endif /* USE_LOCALE_COLLATE */
4478     case PERL_MAGIC_tied:
4479         vtable = &PL_vtbl_pack;
4480         break;
4481     case PERL_MAGIC_tiedelem:
4482     case PERL_MAGIC_tiedscalar:
4483         vtable = &PL_vtbl_packelem;
4484         break;
4485     case PERL_MAGIC_qr:
4486         vtable = &PL_vtbl_regexp;
4487         break;
4488     case PERL_MAGIC_sig:
4489         vtable = &PL_vtbl_sig;
4490         break;
4491     case PERL_MAGIC_sigelem:
4492         vtable = &PL_vtbl_sigelem;
4493         break;
4494     case PERL_MAGIC_taint:
4495         vtable = &PL_vtbl_taint;
4496         break;
4497     case PERL_MAGIC_uvar:
4498         vtable = &PL_vtbl_uvar;
4499         break;
4500     case PERL_MAGIC_vec:
4501         vtable = &PL_vtbl_vec;
4502         break;
4503     case PERL_MAGIC_arylen_p:
4504     case PERL_MAGIC_rhash:
4505     case PERL_MAGIC_symtab:
4506     case PERL_MAGIC_vstring:
4507         vtable = NULL;
4508         break;
4509     case PERL_MAGIC_utf8:
4510         vtable = &PL_vtbl_utf8;
4511         break;
4512     case PERL_MAGIC_substr:
4513         vtable = &PL_vtbl_substr;
4514         break;
4515     case PERL_MAGIC_defelem:
4516         vtable = &PL_vtbl_defelem;
4517         break;
4518     case PERL_MAGIC_arylen:
4519         vtable = &PL_vtbl_arylen;
4520         break;
4521     case PERL_MAGIC_pos:
4522         vtable = &PL_vtbl_pos;
4523         break;
4524     case PERL_MAGIC_backref:
4525         vtable = &PL_vtbl_backref;
4526         break;
4527     case PERL_MAGIC_ext:
4528         /* Reserved for use by extensions not perl internals.           */
4529         /* Useful for attaching extension internal data to perl vars.   */
4530         /* Note that multiple extensions may clash if magical scalars   */
4531         /* etc holding private data from one are passed to another.     */
4532         vtable = NULL;
4533         break;
4534     default:
4535         Perl_croak(aTHX_ "Don't know how to handle magic of type \\%o", how);
4536     }
4537
4538     /* Rest of work is done else where */
4539     mg = sv_magicext(sv,obj,how,vtable,name,namlen);
4540
4541     switch (how) {
4542     case PERL_MAGIC_taint:
4543         mg->mg_len = 1;
4544         break;
4545     case PERL_MAGIC_ext:
4546     case PERL_MAGIC_dbfile:
4547         SvRMAGICAL_on(sv);
4548         break;
4549     }
4550 }
4551
4552 /*
4553 =for apidoc sv_unmagic
4554
4555 Removes all magic of type C<type> from an SV.
4556
4557 =cut
4558 */
4559
4560 int
4561 Perl_sv_unmagic(pTHX_ SV *sv, int type)
4562 {
4563     MAGIC* mg;
4564     MAGIC** mgp;
4565     if (SvTYPE(sv) < SVt_PVMG || !SvMAGIC(sv))
4566         return 0;
4567     mgp = &(((XPVMG*) SvANY(sv))->xmg_u.xmg_magic);
4568     for (mg = *mgp; mg; mg = *mgp) {
4569         if (mg->mg_type == type) {
4570             const MGVTBL* const vtbl = mg->mg_virtual;
4571             *mgp = mg->mg_moremagic;
4572             if (vtbl && vtbl->svt_free)
4573                 CALL_FPTR(vtbl->svt_free)(aTHX_ sv, mg);
4574             if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global) {
4575                 if (mg->mg_len > 0)
4576                     Safefree(mg->mg_ptr);
4577                 else if (mg->mg_len == HEf_SVKEY)
4578                     SvREFCNT_dec((SV*)mg->mg_ptr);
4579                 else if (mg->mg_type == PERL_MAGIC_utf8)
4580                     Safefree(mg->mg_ptr);
4581             }
4582             if (mg->mg_flags & MGf_REFCOUNTED)
4583                 SvREFCNT_dec(mg->mg_obj);
4584             Safefree(mg);
4585         }
4586         else
4587             mgp = &mg->mg_moremagic;
4588     }
4589     if (!SvMAGIC(sv)) {
4590         SvMAGICAL_off(sv);
4591         SvFLAGS(sv) |= (SvFLAGS(sv) & (SVp_IOK|SVp_NOK|SVp_POK)) >> PRIVSHIFT;
4592         SvMAGIC_set(sv, NULL);
4593     }
4594
4595     return 0;
4596 }
4597
4598 /*
4599 =for apidoc sv_rvweaken
4600
4601 Weaken a reference: set the C<SvWEAKREF> flag on this RV; give the
4602 referred-to SV C<PERL_MAGIC_backref> magic if it hasn't already; and
4603 push a back-reference to this RV onto the array of backreferences
4604 associated with that magic.
4605
4606 =cut
4607 */
4608
4609 SV *
4610 Perl_sv_rvweaken(pTHX_ SV *sv)
4611 {
4612     SV *tsv;
4613     if (!SvOK(sv))  /* let undefs pass */
4614         return sv;
4615     if (!SvROK(sv))
4616         Perl_croak(aTHX_ "Can't weaken a nonreference");
4617     else if (SvWEAKREF(sv)) {
4618         if (ckWARN(WARN_MISC))
4619             Perl_warner(aTHX_ packWARN(WARN_MISC), "Reference is already weak");
4620         return sv;
4621     }
4622     tsv = SvRV(sv);
4623     Perl_sv_add_backref(aTHX_ tsv, sv);
4624     SvWEAKREF_on(sv);
4625     SvREFCNT_dec(tsv);
4626     return sv;
4627 }
4628
4629 /* Give tsv backref magic if it hasn't already got it, then push a
4630  * back-reference to sv onto the array associated with the backref magic.
4631  */
4632
4633 void
4634 Perl_sv_add_backref(pTHX_ SV *tsv, SV *sv)
4635 {
4636     dVAR;
4637     AV *av;
4638
4639     if (SvTYPE(tsv) == SVt_PVHV) {
4640         AV **const avp = Perl_hv_backreferences_p(aTHX_ (HV*)tsv);
4641
4642         av = *avp;
4643         if (!av) {
4644             /* There is no AV in the offical place - try a fixup.  */
4645             MAGIC *const mg = mg_find(tsv, PERL_MAGIC_backref);
4646
4647             if (mg) {
4648                 /* Aha. They've got it stowed in magic.  Bring it back.  */
4649                 av = (AV*)mg->mg_obj;
4650                 /* Stop mg_free decreasing the refernce count.  */
4651                 mg->mg_obj = NULL;
4652                 /* Stop mg_free even calling the destructor, given that
4653                    there's no AV to free up.  */
4654                 mg->mg_virtual = 0;
4655                 sv_unmagic(tsv, PERL_MAGIC_backref);
4656             } else {
4657                 av = newAV();
4658                 AvREAL_off(av);
4659                 SvREFCNT_inc_simple_void(av);
4660             }
4661             *avp = av;
4662         }
4663     } else {
4664         const MAGIC *const mg
4665             = SvMAGICAL(tsv) ? mg_find(tsv, PERL_MAGIC_backref) : NULL;
4666         if (mg)
4667             av = (AV*)mg->mg_obj;
4668         else {
4669             av = newAV();
4670             AvREAL_off(av);
4671             sv_magic(tsv, (SV*)av, PERL_MAGIC_backref, NULL, 0);
4672             /* av now has a refcnt of 2, which avoids it getting freed
4673              * before us during global cleanup. The extra ref is removed
4674              * by magic_killbackrefs() when tsv is being freed */
4675         }
4676     }
4677     if (AvFILLp(av) >= AvMAX(av)) {
4678         av_extend(av, AvFILLp(av)+1);
4679     }
4680     AvARRAY(av)[++AvFILLp(av)] = sv; /* av_push() */
4681 }
4682
4683 /* delete a back-reference to ourselves from the backref magic associated
4684  * with the SV we point to.
4685  */
4686
4687 STATIC void
4688 S_sv_del_backref(pTHX_ SV *tsv, SV *sv)
4689 {
4690     dVAR;
4691     AV *av = NULL;
4692     SV **svp;
4693     I32 i;
4694
4695     if (SvTYPE(tsv) == SVt_PVHV && SvOOK(tsv)) {
4696         av = *Perl_hv_backreferences_p(aTHX_ (HV*)tsv);
4697         /* We mustn't attempt to "fix up" the hash here by moving the
4698            backreference array back to the hv_aux structure, as that is stored
4699            in the main HvARRAY(), and hfreentries assumes that no-one
4700            reallocates HvARRAY() while it is running.  */
4701     }
4702     if (!av) {
4703         const MAGIC *const mg
4704             = SvMAGICAL(tsv) ? mg_find(tsv, PERL_MAGIC_backref) : NULL;
4705         if (mg)
4706             av = (AV *)mg->mg_obj;
4707     }
4708     if (!av) {
4709         if (PL_in_clean_all)
4710             return;
4711         Perl_croak(aTHX_ "panic: del_backref");
4712     }
4713
4714     if (SvIS_FREED(av))
4715         return;
4716
4717     svp = AvARRAY(av);
4718     /* We shouldn't be in here more than once, but for paranoia reasons lets
4719        not assume this.  */
4720     for (i = AvFILLp(av); i >= 0; i--) {
4721         if (svp[i] == sv) {
4722             const SSize_t fill = AvFILLp(av);
4723             if (i != fill) {
4724                 /* We weren't the last entry.
4725                    An unordered list has this property that you can take the
4726                    last element off the end to fill the hole, and it's still
4727                    an unordered list :-)
4728                 */
4729                 svp[i] = svp[fill];
4730             }
4731             svp[fill] = NULL;
4732             AvFILLp(av) = fill - 1;
4733         }
4734     }
4735 }
4736
4737 int
4738 Perl_sv_kill_backrefs(pTHX_ SV *sv, AV *av)
4739 {
4740     SV **svp = AvARRAY(av);
4741
4742     PERL_UNUSED_ARG(sv);
4743
4744     /* Not sure why the av can get freed ahead of its sv, but somehow it does
4745        in ext/B/t/bytecode.t test 15 (involving print <DATA>)  */
4746     if (svp && !SvIS_FREED(av)) {
4747         SV *const *const last = svp + AvFILLp(av);
4748
4749         while (svp <= last) {
4750             if (*svp) {
4751                 SV *const referrer = *svp;
4752                 if (SvWEAKREF(referrer)) {
4753                     /* XXX Should we check that it hasn't changed? */
4754                     SvRV_set(referrer, 0);
4755                     SvOK_off(referrer);
4756                     SvWEAKREF_off(referrer);
4757                 } else if (SvTYPE(referrer) == SVt_PVGV ||
4758                            SvTYPE(referrer) == SVt_PVLV) {
4759                     /* You lookin' at me?  */
4760                     assert(GvSTASH(referrer));
4761                     assert(GvSTASH(referrer) == (HV*)sv);
4762                     GvSTASH(referrer) = 0;
4763                 } else {
4764                     Perl_croak(aTHX_
4765                                "panic: magic_killbackrefs (flags=%"UVxf")",
4766                                (UV)SvFLAGS(referrer));
4767                 }
4768
4769                 *svp = NULL;
4770             }
4771             svp++;
4772         }
4773     }
4774     SvREFCNT_dec(av); /* remove extra count added by sv_add_backref() */
4775     return 0;
4776 }
4777
4778 /*
4779 =for apidoc sv_insert
4780
4781 Inserts a string at the specified offset/length within the SV. Similar to
4782 the Perl substr() function.
4783
4784 =cut
4785 */
4786
4787 void
4788 Perl_sv_insert(pTHX_ SV *bigstr, STRLEN offset, STRLEN len, const char *little, STRLEN littlelen)
4789 {
4790     dVAR;
4791     register char *big;
4792     register char *mid;
4793     register char *midend;
4794     register char *bigend;
4795     register I32 i;
4796     STRLEN curlen;
4797
4798
4799     if (!bigstr)
4800         Perl_croak(aTHX_ "Can't modify non-existent substring");
4801     SvPV_force(bigstr, curlen);
4802     (void)SvPOK_only_UTF8(bigstr);
4803     if (offset + len > curlen) {
4804         SvGROW(bigstr, offset+len+1);
4805         Zero(SvPVX(bigstr)+curlen, offset+len-curlen, char);
4806         SvCUR_set(bigstr, offset+len);
4807     }
4808
4809     SvTAINT(bigstr);
4810     i = littlelen - len;
4811     if (i > 0) {                        /* string might grow */
4812         big = SvGROW(bigstr, SvCUR(bigstr) + i + 1);
4813         mid = big + offset + len;
4814         midend = bigend = big + SvCUR(bigstr);
4815         bigend += i;
4816         *bigend = '\0';
4817         while (midend > mid)            /* shove everything down */
4818             *--bigend = *--midend;
4819         Move(little,big+offset,littlelen,char);
4820         SvCUR_set(bigstr, SvCUR(bigstr) + i);
4821         SvSETMAGIC(bigstr);
4822         return;
4823     }
4824     else if (i == 0) {
4825         Move(little,SvPVX(bigstr)+offset,len,char);
4826         SvSETMAGIC(bigstr);
4827         return;
4828     }
4829
4830     big = SvPVX(bigstr);
4831     mid = big + offset;
4832     midend = mid + len;
4833     bigend = big + SvCUR(bigstr);
4834
4835     if (midend > bigend)
4836         Perl_croak(aTHX_ "panic: sv_insert");
4837
4838     if (mid - big > bigend - midend) {  /* faster to shorten from end */
4839         if (littlelen) {
4840             Move(little, mid, littlelen,char);
4841             mid += littlelen;
4842         }
4843         i = bigend - midend;
4844         if (i > 0) {
4845             Move(midend, mid, i,char);
4846             mid += i;
4847         }
4848         *mid = '\0';
4849         SvCUR_set(bigstr, mid - big);
4850     }
4851     else if ((i = mid - big)) { /* faster from front */
4852         midend -= littlelen;
4853         mid = midend;
4854         sv_chop(bigstr,midend-i);
4855         big += i;
4856         while (i--)
4857             *--midend = *--big;
4858         if (littlelen)
4859             Move(little, mid, littlelen,char);
4860     }
4861     else if (littlelen) {
4862         midend -= littlelen;
4863         sv_chop(bigstr,midend);
4864         Move(little,midend,littlelen,char);
4865     }
4866     else {
4867         sv_chop(bigstr,midend);
4868     }
4869     SvSETMAGIC(bigstr);
4870 }
4871
4872 /*
4873 =for apidoc sv_replace
4874
4875 Make the first argument a copy of the second, then delete the original.
4876 The target SV physically takes over ownership of the body of the source SV
4877 and inherits its flags; however, the target keeps any magic it owns,
4878 and any magic in the source is discarded.
4879 Note that this is a rather specialist SV copying operation; most of the
4880 time you'll want to use C<sv_setsv> or one of its many macro front-ends.
4881
4882 =cut
4883 */
4884
4885 void
4886 Perl_sv_replace(pTHX_ register SV *sv, register SV *nsv)
4887 {
4888     dVAR;
4889     const U32 refcnt = SvREFCNT(sv);
4890     SV_CHECK_THINKFIRST_COW_DROP(sv);
4891     if (SvREFCNT(nsv) != 1) {
4892         Perl_croak(aTHX_ "panic: reference miscount on nsv in sv_replace() (%"
4893                    UVuf " != 1)", (UV) SvREFCNT(nsv));
4894     }
4895     if (SvMAGICAL(sv)) {
4896         if (SvMAGICAL(nsv))
4897             mg_free(nsv);
4898         else
4899             sv_upgrade(nsv, SVt_PVMG);
4900         SvMAGIC_set(nsv, SvMAGIC(sv));
4901         SvFLAGS(nsv) |= SvMAGICAL(sv);
4902         SvMAGICAL_off(sv);
4903         SvMAGIC_set(sv, NULL);
4904     }
4905     SvREFCNT(sv) = 0;
4906     sv_clear(sv);
4907     assert(!SvREFCNT(sv));
4908 #ifdef DEBUG_LEAKING_SCALARS
4909     sv->sv_flags  = nsv->sv_flags;
4910     sv->sv_any    = nsv->sv_any;
4911     sv->sv_refcnt = nsv->sv_refcnt;
4912     sv->sv_u      = nsv->sv_u;
4913 #else
4914     StructCopy(nsv,sv,SV);
4915 #endif
4916     /* Currently could join these into one piece of pointer arithmetic, but
4917        it would be unclear.  */
4918     if(SvTYPE(sv) == SVt_IV)
4919         SvANY(sv)
4920             = (XPVIV*)((char*)&(sv->sv_u.svu_iv) - STRUCT_OFFSET(XPVIV, xiv_iv));
4921     else if (SvTYPE(sv) == SVt_RV) {
4922         SvANY(sv) = &sv->sv_u.svu_rv;
4923     }
4924         
4925
4926 #ifdef PERL_OLD_COPY_ON_WRITE
4927     if (SvIsCOW_normal(nsv)) {
4928         /* We need to follow the pointers around the loop to make the
4929            previous SV point to sv, rather than nsv.  */
4930         SV *next;
4931         SV *current = nsv;
4932         while ((next = SV_COW_NEXT_SV(current)) != nsv) {
4933             assert(next);
4934             current = next;
4935             assert(SvPVX_const(current) == SvPVX_const(nsv));
4936         }
4937         /* Make the SV before us point to the SV after us.  */
4938         if (DEBUG_C_TEST) {
4939             PerlIO_printf(Perl_debug_log, "previous is\n");
4940             sv_dump(current);
4941             PerlIO_printf(Perl_debug_log,
4942                           "move it from 0x%"UVxf" to 0x%"UVxf"\n",
4943                           (UV) SV_COW_NEXT_SV(current), (UV) sv);
4944         }
4945         SV_COW_NEXT_SV_SET(current, sv);
4946     }
4947 #endif
4948     SvREFCNT(sv) = refcnt;
4949     SvFLAGS(nsv) |= SVTYPEMASK;         /* Mark as freed */
4950     SvREFCNT(nsv) = 0;
4951     del_SV(nsv);
4952 }
4953
4954 /*
4955 =for apidoc sv_clear
4956
4957 Clear an SV: call any destructors, free up any memory used by the body,
4958 and free the body itself. The SV's head is I<not> freed, although
4959 its type is set to all 1's so that it won't inadvertently be assumed
4960 to be live during global destruction etc.
4961 This function should only be called when REFCNT is zero. Most of the time
4962 you'll want to call C<sv_free()> (or its macro wrapper C<SvREFCNT_dec>)
4963 instead.
4964
4965 =cut
4966 */
4967
4968 void
4969 Perl_sv_clear(pTHX_ register SV *sv)
4970 {
4971     dVAR;
4972     const U32 type = SvTYPE(sv);
4973     const struct body_details *const sv_type_details
4974         = bodies_by_type + type;
4975
4976     assert(sv);
4977     assert(SvREFCNT(sv) == 0);
4978
4979     if (type <= SVt_IV) {
4980         /* See the comment in sv.h about the collusion between this early
4981            return and the overloading of the NULL and IV slots in the size
4982            table.  */
4983         return;
4984     }
4985
4986     if (SvOBJECT(sv)) {
4987         if (PL_defstash) {              /* Still have a symbol table? */
4988             dSP;
4989             HV* stash;
4990             do {        
4991                 CV* destructor;
4992                 stash = SvSTASH(sv);
4993                 destructor = StashHANDLER(stash,DESTROY);
4994                 if (destructor) {
4995                     SV* const tmpref = newRV(sv);
4996                     SvREADONLY_on(tmpref);   /* DESTROY() could be naughty */
4997                     ENTER;
4998                     PUSHSTACKi(PERLSI_DESTROY);
4999                     EXTEND(SP, 2);
5000                     PUSHMARK(SP);
5001                     PUSHs(tmpref);
5002                     PUTBACK;
5003                     call_sv((SV*)destructor, G_DISCARD|G_EVAL|G_KEEPERR|G_VOID);
5004                 
5005                 
5006                     POPSTACK;
5007                     SPAGAIN;
5008                     LEAVE;
5009                     if(SvREFCNT(tmpref) < 2) {
5010                         /* tmpref is not kept alive! */
5011                         SvREFCNT(sv)--;
5012                         SvRV_set(tmpref, NULL);
5013                         SvROK_off(tmpref);
5014                     }
5015                     SvREFCNT_dec(tmpref);
5016                 }
5017             } while (SvOBJECT(sv) && SvSTASH(sv) != stash);
5018
5019
5020             if (SvREFCNT(sv)) {
5021                 if (PL_in_clean_objs)
5022                     Perl_croak(aTHX_ "DESTROY created new reference to dead object '%s'",
5023                           HvNAME_get(stash));
5024                 /* DESTROY gave object new lease on life */
5025                 return;
5026             }
5027         }
5028
5029         if (SvOBJECT(sv)) {
5030             SvREFCNT_dec(SvSTASH(sv));  /* possibly of changed persuasion */
5031             SvOBJECT_off(sv);   /* Curse the object. */
5032             if (type != SVt_PVIO)
5033                 --PL_sv_objcount;       /* XXX Might want something more general */
5034         }
5035     }
5036     if (type >= SVt_PVMG) {
5037         HV *ourstash;
5038         if ((type == SVt_PVMG || type == SVt_PVGV) &&
5039             (ourstash = OURSTASH(sv))) {
5040             SvREFCNT_dec(ourstash);
5041         } else if (SvMAGIC(sv))
5042             mg_free(sv);
5043         if (type == SVt_PVMG && SvPAD_TYPED(sv))
5044             SvREFCNT_dec(SvSTASH(sv));
5045     }
5046     switch (type) {
5047     case SVt_PVIO:
5048         if (IoIFP(sv) &&
5049             IoIFP(sv) != PerlIO_stdin() &&
5050             IoIFP(sv) != PerlIO_stdout() &&
5051             IoIFP(sv) != PerlIO_stderr())
5052         {
5053             io_close((IO*)sv, FALSE);
5054         }
5055         if (IoDIRP(sv) && !(IoFLAGS(sv) & IOf_FAKE_DIRP))
5056             PerlDir_close(IoDIRP(sv));
5057         IoDIRP(sv) = (DIR*)NULL;
5058         Safefree(IoTOP_NAME(sv));
5059         Safefree(IoFMT_NAME(sv));
5060         Safefree(IoBOTTOM_NAME(sv));
5061         goto freescalar;
5062     case SVt_PVBM:
5063         goto freescalar;
5064     case SVt_PVCV:
5065     case SVt_PVFM:
5066         cv_undef((CV*)sv);
5067         goto freescalar;
5068     case SVt_PVHV:
5069         Perl_hv_kill_backrefs(aTHX_ (HV*)sv);
5070         hv_undef((HV*)sv);
5071         break;
5072     case SVt_PVAV:
5073         av_undef((AV*)sv);
5074         break;
5075     case SVt_PVLV:
5076         if (LvTYPE(sv) == 'T') { /* for tie: return HE to pool */
5077             SvREFCNT_dec(HeKEY_sv((HE*)LvTARG(sv)));
5078             HeNEXT((HE*)LvTARG(sv)) = PL_hv_fetch_ent_mh;
5079             PL_hv_fetch_ent_mh = (HE*)LvTARG(sv);
5080         }
5081         else if (LvTYPE(sv) != 't') /* unless tie: unrefcnted fake SV**  */
5082             SvREFCNT_dec(LvTARG(sv));
5083         goto freescalar;
5084     case SVt_PVGV:
5085         gp_free((GV*)sv);
5086         if (GvNAME_HEK(sv)) {
5087             unshare_hek(GvNAME_HEK(sv));
5088         }
5089         /* If we're in a stash, we don't own a reference to it. However it does
5090            have a back reference to us, which needs to be cleared.  */
5091         if (GvSTASH(sv))
5092             sv_del_backref((SV*)GvSTASH(sv), sv);
5093     case SVt_PVMG:
5094     case SVt_PVNV:
5095     case SVt_PVIV:
5096       freescalar:
5097         /* Don't bother with SvOOK_off(sv); as we're only going to free it.  */
5098         if (SvOOK(sv)) {
5099             SvPV_set(sv, SvPVX_mutable(sv) - SvIVX(sv));
5100             /* Don't even bother with turning off the OOK flag.  */
5101         }
5102     case SVt_PV:
5103     case SVt_RV:
5104         if (SvROK(sv)) {
5105             SV * const target = SvRV(sv);
5106             if (SvWEAKREF(sv))
5107                 sv_del_backref(target, sv);
5108             else
5109                 SvREFCNT_dec(target);
5110         }
5111 #ifdef PERL_OLD_COPY_ON_WRITE
5112         else if (SvPVX_const(sv)) {
5113             if (SvIsCOW(sv)) {
5114                 /* I believe I need to grab the global SV mutex here and
5115                    then recheck the COW status.  */
5116                 if (DEBUG_C_TEST) {
5117                     PerlIO_printf(Perl_debug_log, "Copy on write: clear\n");
5118                     sv_dump(sv);
5119                 }
5120                 sv_release_COW(sv, SvPVX_const(sv), SvLEN(sv),
5121                                SV_COW_NEXT_SV(sv));
5122                 /* And drop it here.  */
5123                 SvFAKE_off(sv);
5124             } else if (SvLEN(sv)) {
5125                 Safefree(SvPVX_const(sv));
5126             }
5127         }
5128 #else
5129         else if (SvPVX_const(sv) && SvLEN(sv))
5130             Safefree(SvPVX_mutable(sv));
5131         else if (SvPVX_const(sv) && SvREADONLY(sv) && SvFAKE(sv)) {
5132             unshare_hek(SvSHARED_HEK_FROM_PV(SvPVX_const(sv)));
5133             SvFAKE_off(sv);
5134         }
5135 #endif
5136         break;
5137     case SVt_NV:
5138         break;
5139     }
5140
5141     SvFLAGS(sv) &= SVf_BREAK;
5142     SvFLAGS(sv) |= SVTYPEMASK;
5143
5144     if (sv_type_details->arena) {
5145         del_body(((char *)SvANY(sv) + sv_type_details->offset),
5146                  &PL_body_roots[type]);
5147     }
5148     else if (sv_type_details->body_size) {
5149         my_safefree(SvANY(sv));
5150     }
5151 }
5152
5153 /*
5154 =for apidoc sv_newref
5155
5156 Increment an SV's reference count. Use the C<SvREFCNT_inc()> wrapper
5157 instead.
5158
5159 =cut
5160 */
5161
5162 SV *
5163 Perl_sv_newref(pTHX_ SV *sv)
5164 {
5165     PERL_UNUSED_CONTEXT;
5166     if (sv)
5167         (SvREFCNT(sv))++;
5168     return sv;
5169 }
5170
5171 /*
5172 =for apidoc sv_free
5173
5174 Decrement an SV's reference count, and if it drops to zero, call
5175 C<sv_clear> to invoke destructors and free up any memory used by
5176 the body; finally, deallocate the SV's head itself.
5177 Normally called via a wrapper macro C<SvREFCNT_dec>.
5178
5179 =cut
5180 */
5181
5182 void
5183 Perl_sv_free(pTHX_ SV *sv)
5184 {
5185     dVAR;
5186     if (!sv)
5187         return;
5188     if (SvREFCNT(sv) == 0) {
5189         if (SvFLAGS(sv) & SVf_BREAK)
5190             /* this SV's refcnt has been artificially decremented to
5191              * trigger cleanup */
5192             return;
5193         if (PL_in_clean_all) /* All is fair */
5194             return;
5195         if (SvREADONLY(sv) && SvIMMORTAL(sv)) {
5196             /* make sure SvREFCNT(sv)==0 happens very seldom */
5197             SvREFCNT(sv) = (~(U32)0)/2;
5198             return;
5199         }
5200         if (ckWARN_d(WARN_INTERNAL)) {
5201             Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
5202                         "Attempt to free unreferenced scalar: SV 0x%"UVxf
5203                         pTHX__FORMAT, PTR2UV(sv) pTHX__VALUE);
5204 #ifdef DEBUG_LEAKING_SCALARS_FORK_DUMP
5205             Perl_dump_sv_child(aTHX_ sv);
5206 #endif
5207         }
5208         return;
5209     }
5210     if (--(SvREFCNT(sv)) > 0)
5211         return;
5212     Perl_sv_free2(aTHX_ sv);
5213 }
5214
5215 void
5216 Perl_sv_free2(pTHX_ SV *sv)
5217 {
5218     dVAR;
5219 #ifdef DEBUGGING
5220     if (SvTEMP(sv)) {
5221         if (ckWARN_d(WARN_DEBUGGING))
5222             Perl_warner(aTHX_ packWARN(WARN_DEBUGGING),
5223                         "Attempt to free temp prematurely: SV 0x%"UVxf
5224                         pTHX__FORMAT, PTR2UV(sv) pTHX__VALUE);
5225         return;
5226     }
5227 #endif
5228     if (SvREADONLY(sv) && SvIMMORTAL(sv)) {
5229         /* make sure SvREFCNT(sv)==0 happens very seldom */
5230         SvREFCNT(sv) = (~(U32)0)/2;
5231         return;
5232     }
5233     sv_clear(sv);
5234     if (! SvREFCNT(sv))
5235         del_SV(sv);
5236 }
5237
5238 /*
5239 =for apidoc sv_len
5240
5241 Returns the length of the string in the SV. Handles magic and type
5242 coercion.  See also C<SvCUR>, which gives raw access to the xpv_cur slot.
5243
5244 =cut
5245 */
5246
5247 STRLEN
5248 Perl_sv_len(pTHX_ register SV *sv)
5249 {
5250     STRLEN len;
5251
5252     if (!sv)
5253         return 0;
5254
5255     if (SvGMAGICAL(sv))
5256         len = mg_length(sv);
5257     else
5258         (void)SvPV_const(sv, len);
5259     return len;
5260 }
5261
5262 /*
5263 =for apidoc sv_len_utf8
5264
5265 Returns the number of characters in the string in an SV, counting wide
5266 UTF-8 bytes as a single character. Handles magic and type coercion.
5267
5268 =cut
5269 */
5270
5271 /*
5272  * The length is cached in PERL_UTF8_magic, in the mg_len field.  Also the
5273  * mg_ptr is used, by sv_pos_u2b(), see the comments of S_utf8_mg_pos_init().
5274  * (Note that the mg_len is not the length of the mg_ptr field.)
5275  *
5276  */
5277
5278 STRLEN
5279 Perl_sv_len_utf8(pTHX_ register SV *sv)
5280 {
5281     if (!sv)
5282         return 0;
5283
5284     if (SvGMAGICAL(sv))
5285         return mg_length(sv);
5286     else
5287     {
5288         STRLEN len;
5289         const U8 *s = (U8*)SvPV_const(sv, len);
5290
5291         if (PL_utf8cache) {
5292             STRLEN ulen;
5293             MAGIC *mg = SvMAGICAL(sv) ? mg_find(sv, PERL_MAGIC_utf8) : 0;
5294
5295             if (mg && mg->mg_len != -1) {
5296                 ulen = mg->mg_len;
5297                 if (PL_utf8cache < 0) {
5298                     const STRLEN real = Perl_utf8_length(aTHX_ s, s + len);
5299                     if (real != ulen) {
5300                         /* Need to turn the assertions off otherwise we may
5301                            recurse infinitely while printing error messages.
5302                         */
5303                         SAVEI8(PL_utf8cache);
5304                         PL_utf8cache = 0;
5305                         Perl_croak(aTHX_ "panic: sv_len_utf8 cache %"UVf
5306                                    " real %"UVf" for %"SVf,
5307                                    (UV) ulen, (UV) real, sv);
5308                     }
5309                 }
5310             }
5311             else {
5312                 ulen = Perl_utf8_length(aTHX_ s, s + len);
5313                 if (!SvREADONLY(sv)) {
5314                     if (!mg) {
5315                         mg = sv_magicext(sv, 0, PERL_MAGIC_utf8,
5316                                          &PL_vtbl_utf8, 0, 0);
5317                     }
5318                     assert(mg);
5319                     mg->mg_len = ulen;
5320                 }
5321             }
5322             return ulen;
5323         }
5324         return Perl_utf8_length(aTHX_ s, s + len);
5325     }
5326 }
5327
5328 /* S_utf8_mg_pos_init() is used to initialize the mg_ptr field of
5329  * a PERL_UTF8_magic.  The mg_ptr is used to store the mapping
5330  * between UTF-8 and byte offsets.  There are two (substr offset and substr
5331  * length, the i offset, PERL_MAGIC_UTF8_CACHESIZE) times two (UTF-8 offset
5332  * and byte offset) cache positions.
5333  *
5334  * The mg_len field is used by sv_len_utf8(), see its comments.
5335  * Note that the mg_len is not the length of the mg_ptr field.
5336  *
5337  */
5338 STATIC bool
5339 S_utf8_mg_pos_init(pTHX_ SV *sv, MAGIC **mgp, STRLEN **cachep, I32 i,
5340                    I32 offsetp, const U8 *s, const U8 *start)
5341 {
5342     bool found = FALSE;
5343
5344     if (SvMAGICAL(sv) && !SvREADONLY(sv)) {
5345         if (!*mgp) {
5346             *mgp = sv_magicext(sv, 0, PERL_MAGIC_utf8, (MGVTBL*)&PL_vtbl_utf8, 0, 0);
5347             (*mgp)->mg_len = -1;
5348         }
5349         assert(*mgp);
5350
5351         if ((*mgp)->mg_ptr)
5352             *cachep = (STRLEN *) (*mgp)->mg_ptr;
5353         else {
5354             Newxz(*cachep, PERL_MAGIC_UTF8_CACHESIZE * 2, STRLEN);
5355             (*mgp)->mg_ptr = (char *) *cachep;
5356         }
5357         assert(*cachep);
5358
5359         (*cachep)[i]   = offsetp;
5360         (*cachep)[i+1] = s - start;
5361         found = TRUE;
5362     }
5363
5364     return found;
5365 }
5366
5367 /*
5368  * S_utf8_mg_pos() is used to query and update mg_ptr field of
5369  * a PERL_UTF8_magic.  The mg_ptr is used to store the mapping
5370  * between UTF-8 and byte offsets.  See also the comments of
5371  * S_utf8_mg_pos_init().
5372  *
5373  */
5374 STATIC bool
5375 S_utf8_mg_pos(pTHX_ SV *sv, MAGIC **mgp, STRLEN **cachep, I32 i, I32 *offsetp, I32 uoff, const U8 **sp, const U8 *start, const U8 *send)
5376 {
5377     bool found = FALSE;
5378
5379     if (SvMAGICAL(sv) && !SvREADONLY(sv)) {
5380         if (!*mgp)
5381             *mgp = mg_find(sv, PERL_MAGIC_utf8);
5382         if (*mgp && (*mgp)->mg_ptr) {
5383             *cachep = (STRLEN *) (*mgp)->mg_ptr;
5384             ASSERT_UTF8_CACHE(*cachep);
5385             if ((*cachep)[i] == (STRLEN)uoff)   /* An exact match. */
5386                  found = TRUE;
5387             else {                      /* We will skip to the right spot. */
5388                  STRLEN forw  = 0;
5389                  STRLEN backw = 0;
5390                  const U8* p = NULL;
5391
5392                  /* The assumption is that going backward is half
5393                   * the speed of going forward (that's where the
5394                   * 2 * backw in the below comes from).  (The real
5395                   * figure of course depends on the UTF-8 data.) */
5396
5397                  if ((*cachep)[i] > (STRLEN)uoff) {
5398                       forw  = uoff;
5399                       backw = (*cachep)[i] - (STRLEN)uoff;
5400
5401                       if (forw < 2 * backw)
5402                            p = start;
5403                       else
5404                            p = start + (*cachep)[i+1];
5405                  }
5406                  /* Try this only for the substr offset (i == 0),
5407                   * not for the substr length (i == 2). */
5408                  else if (i == 0) { /* (*cachep)[i] < uoff */
5409                       const STRLEN ulen = sv_len_utf8(sv);
5410
5411                       if ((STRLEN)uoff < ulen) {
5412                            forw  = (STRLEN)uoff - (*cachep)[i];
5413                            backw = ulen - (STRLEN)uoff;
5414
5415                            if (forw < 2 * backw)
5416                                 p = start + (*cachep)[i+1];
5417                            else
5418                                 p = send;
5419                       }
5420
5421                       /* If the string is not long enough for uoff,
5422                        * we could extend it, but not at this low a level. */
5423                  }
5424
5425                  if (p) {
5426                       if (forw < 2 * backw) {
5427                            while (forw--)
5428                                 p += UTF8SKIP(p);
5429                       }
5430                       else {
5431                            while (backw--) {
5432                                 p--;
5433                                 while (UTF8_IS_CONTINUATION(*p))
5434                                      p--;
5435                            }
5436                       }
5437
5438                       /* Update the cache. */
5439                       (*cachep)[i]   = (STRLEN)uoff;
5440                       (*cachep)[i+1] = p - start;
5441
5442                       /* Drop the stale "length" cache */
5443                       if (i == 0) {
5444                           (*cachep)[2] = 0;
5445                           (*cachep)[3] = 0;
5446                       }
5447
5448                       found = TRUE;
5449                  }
5450             }
5451             if (found) {        /* Setup the return values. */
5452                  *offsetp = (*cachep)[i+1];
5453                  *sp = start + *offsetp;
5454                  if (*sp >= send) {
5455                       *sp = send;
5456                       *offsetp = send - start;
5457                  }
5458                  else if (*sp < start) {
5459                       *sp = start;
5460                       *offsetp = 0;
5461                  }
5462             }
5463         }
5464 #ifdef PERL_UTF8_CACHE_ASSERT
5465         if (found) {
5466              const U8 *s = start;
5467              I32 n = uoff;
5468
5469              while (n-- && s < send)
5470                   s += UTF8SKIP(s);
5471
5472              if (i == 0) {
5473                   assert(*offsetp == s - start);
5474                   assert((*cachep)[0] == (STRLEN)uoff);
5475                   assert((*cachep)[1] == *offsetp);
5476              }
5477              ASSERT_UTF8_CACHE(*cachep);
5478         }
5479 #endif
5480     }
5481
5482     return found;
5483 }
5484
5485 /*
5486 =for apidoc sv_pos_u2b
5487
5488 Converts the value pointed to by offsetp from a count of UTF-8 chars from
5489 the start of the string, to a count of the equivalent number of bytes; if
5490 lenp is non-zero, it does the same to lenp, but this time starting from
5491 the offset, rather than from the start of the string. Handles magic and
5492 type coercion.
5493
5494 =cut
5495 */
5496
5497 /*
5498  * sv_pos_u2b() uses, like sv_pos_b2u(), the mg_ptr of the potential
5499  * PERL_UTF8_magic of the sv to store the mapping between UTF-8 and
5500  * byte offsets.  See also the comments of S_utf8_mg_pos().
5501  *
5502  */
5503
5504 static STRLEN
5505 S_sv_pos_u2b_forwards(pTHX_ const U8 *const start, const U8 *const send,
5506                       STRLEN uoffset)
5507 {
5508     const U8 *s = start;
5509
5510     while (s < send && uoffset--)
5511         s += UTF8SKIP(s);
5512     if (s > send) {
5513         /* This is the existing behaviour. Possibly it should be a croak, as
5514            it's actually a bounds error  */
5515         s = send;
5516     }
5517     return s - start;
5518 }
5519
5520
5521 static STRLEN
5522 S_sv_pos_u2b_midway(pTHX_ const U8 *const start, const U8 *send,
5523                       STRLEN uoffset, STRLEN uend)
5524 {
5525     STRLEN backw = uend - uoffset;
5526     if (uoffset < 2 * backw) {
5527         /* The assumption is that going fowards is twice the speed of going
5528            forward (that's where the 2 * backw comes from).
5529            (The real figure of course depends on the UTF-8 data.)  */
5530         return S_sv_pos_u2b_forwards(aTHX_ start, send, uoffset);
5531     }
5532
5533     while (backw--) {
5534         send--;
5535         while (UTF8_IS_CONTINUATION(*send))
5536             send--;
5537     }
5538     return send - start;
5539 }
5540
5541 static STRLEN
5542 S_sv_pos_u2b_cached(pTHX_ SV *sv, MAGIC **mgp, const U8 *const start,
5543                     const U8 *const send, STRLEN uoffset,
5544                     STRLEN uoffset0, STRLEN boffset0) {
5545     STRLEN boffset;
5546     bool found = FALSE;
5547
5548     if (SvMAGICAL(sv) && !SvREADONLY(sv) && PL_utf8cache
5549         && (*mgp = mg_find(sv, PERL_MAGIC_utf8))) {
5550         if ((*mgp)->mg_len != -1) {
5551             boffset = S_sv_pos_u2b_midway(aTHX_ start, send, uoffset,
5552                                           (*mgp)->mg_len);
5553             found = TRUE;
5554         }
5555     }
5556
5557     if (!found || PL_utf8cache < 0) {
5558         STRLEN real_boffset;
5559         if (uoffset >= uoffset0) {
5560             real_boffset
5561                 = boffset0 + S_sv_pos_u2b_forwards(aTHX_ start + boffset0,
5562                                                    send, uoffset - uoffset0);
5563         }
5564         else {
5565             real_boffset = S_sv_pos_u2b_forwards(aTHX_ start, send, uoffset);
5566         }
5567         if (found && PL_utf8cache < 0) {
5568             if (real_boffset != boffset) {
5569                 /* Need to turn the assertions off otherwise we may recurse
5570                    infinitely while printing error messages.  */
5571                 SAVEI8(PL_utf8cache);
5572                 PL_utf8cache = 0;
5573                 Perl_croak(aTHX_ "panic: sv_pos_u2b_cache cache %"UVf
5574                            " real %"UVf" for %"SVf,
5575                            (UV) boffset, (UV) real_boffset, sv);
5576             }
5577         }
5578         boffset = real_boffset;
5579     }
5580     return boffset;
5581 }
5582
5583 void
5584 Perl_sv_pos_u2b(pTHX_ register SV *sv, I32* offsetp, I32* lenp)
5585 {
5586     const U8 *start;
5587     STRLEN len;
5588
5589     if (!sv)
5590         return;
5591
5592     start = (U8*)SvPV_const(sv, len);
5593     if (len) {
5594         STRLEN uoffset = (STRLEN) *offsetp;
5595         const U8 * const send = start + len;
5596         MAGIC *mg;
5597         STRLEN boffset = S_sv_pos_u2b_cached(aTHX_ sv, &mg, start, send,
5598                                              uoffset, 0, 0);
5599
5600         *offsetp = (I32) boffset;
5601
5602         if (lenp) {
5603             /* Convert the relative offset to absolute.  */
5604             STRLEN uoffset2 = uoffset + (STRLEN) *lenp;
5605             STRLEN boffset2
5606                 = S_sv_pos_u2b_cached(aTHX_ sv, &mg, start, send, uoffset2,
5607                                       uoffset, boffset) - boffset;
5608
5609             *lenp = boffset2;
5610         }
5611     }
5612     else {
5613          *offsetp = 0;
5614          if (lenp)
5615               *lenp = 0;
5616     }
5617
5618     return;
5619 }
5620
5621 /*
5622 =for apidoc sv_pos_b2u
5623
5624 Converts the value pointed to by offsetp from a count of bytes from the
5625 start of the string, to a count of the equivalent number of UTF-8 chars.
5626 Handles magic and type coercion.
5627
5628 =cut
5629 */
5630
5631 /*
5632  * sv_pos_b2u() uses, like sv_pos_u2b(), the mg_ptr of the potential
5633  * PERL_UTF8_magic of the sv to store the mapping between UTF-8 and
5634  * byte offsets.  See also the comments of S_utf8_mg_pos().
5635  *
5636  */
5637
5638
5639 static STRLEN
5640 S_sv_pos_b2u_forwards(pTHX_ const U8 *s, const U8 *const target);
5641
5642 static void
5643 S_utf8_mg_pos_cache_update(pTHX_ SV *sv, MAGIC **mgp, STRLEN byte, STRLEN utf8)
5644 {
5645     STRLEN *cache;
5646     if (SvREADONLY(sv))
5647         return;
5648
5649     if (!*mgp) {
5650         *mgp = sv_magicext(sv, 0, PERL_MAGIC_utf8, (MGVTBL*)&PL_vtbl_utf8, 0,
5651                            0);
5652         (*mgp)->mg_len = -1;
5653     }
5654     assert(*mgp);
5655
5656     if (!(cache = (STRLEN *)(*mgp)->mg_ptr)) {
5657         Newxz(cache, PERL_MAGIC_UTF8_CACHESIZE * 2, STRLEN);
5658         (*mgp)->mg_ptr = (char *) cache;
5659     }
5660     assert(cache);
5661
5662     if (PL_utf8cache < 0) {
5663         const U8 *start = (const U8 *) SvPVX_const(sv);
5664         const STRLEN realutf8
5665             = S_sv_pos_b2u_forwards(aTHX_ start, start + byte);
5666
5667         if (realutf8 != utf8) {
5668             /* Need to turn the assertions off otherwise we may recurse
5669                infinitely while printing error messages.  */
5670             SAVEI8(PL_utf8cache);
5671             PL_utf8cache = 0;
5672             Perl_croak(aTHX_ "panic: utf8_mg_pos_cache_update cache %"UVf
5673                        " real %"UVf" for %"SVf, (UV) utf8, (UV) realutf8, sv);
5674         }
5675     }
5676     cache[0] = utf8;
5677     cache[1] = byte;
5678     /* Drop the stale "length" cache */
5679     cache[2] = 0;
5680     cache[3] = 0;
5681 }
5682
5683 /* If we don't know the character offset of the end of a region, our only
5684    option is to walk forwards to the target byte offset.  */
5685 static STRLEN
5686 S_sv_pos_b2u_forwards(pTHX_ const U8 *s, const U8 *const target)
5687 {
5688     STRLEN len = 0;
5689     while (s < target) {
5690         STRLEN n = 1;
5691
5692         /* Call utf8n_to_uvchr() to validate the sequence
5693          * (unless a simple non-UTF character) */
5694         if (!UTF8_IS_INVARIANT(*s))
5695             utf8n_to_uvchr(s, UTF8SKIP(s), &n, 0);
5696         if (n > 0) {
5697             s += n;
5698             len++;
5699         }
5700         else
5701             break;
5702     }
5703     return len;
5704 }
5705
5706 /* We already know all of the way, now we may be able to walk back.  The same
5707    assumption is made as in S_utf8_mg_pos(), namely that walking backward is
5708    twice slower than walking forward. */
5709 static STRLEN
5710 S_sv_pos_b2u_midway(pTHX_ const U8 *s, const U8 *const target, const U8 *end,
5711                     STRLEN endu)
5712 {
5713     const STRLEN forw = target - s;
5714     STRLEN backw = end - target;
5715
5716     if (forw < 2 * backw) {
5717         return S_sv_pos_b2u_forwards(aTHX_ s, target);
5718     }
5719
5720     while (end > target) {
5721         end--;
5722         while (UTF8_IS_CONTINUATION(*end)) {
5723             end--;
5724         }
5725         endu--;
5726     }
5727     return endu;
5728 }
5729
5730 void
5731 Perl_sv_pos_b2u(pTHX_ register SV* sv, I32* offsetp)
5732 {
5733     const U8* s;
5734     const STRLEN byte = *offsetp;
5735     STRLEN len;
5736     MAGIC* mg = NULL;
5737     const U8* send;
5738
5739     if (!sv)
5740         return;
5741
5742     s = (const U8*)SvPV_const(sv, len);
5743
5744     if (len < byte)
5745         Perl_croak(aTHX_ "panic: sv_pos_b2u: bad byte offset");
5746
5747     send = s + byte;
5748
5749     if (SvMAGICAL(sv) && !SvREADONLY(sv) && PL_utf8cache
5750         && (mg = mg_find(sv, PERL_MAGIC_utf8))) {
5751         if (mg->mg_ptr) {
5752             STRLEN *cache = (STRLEN *) mg->mg_ptr;
5753             if (cache[1] == byte) {
5754                 /* An exact match. */
5755                 *offsetp = cache[0];
5756
5757                 return;
5758             }
5759             else if (cache[1] < byte) {
5760                 /* We already know part of the way. */
5761                 if (mg->mg_len != -1) {
5762                     /* Actually, we know the end too.  */
5763                     len = cache[0]
5764                         + S_sv_pos_b2u_midway(aTHX_ s + cache[1], send,
5765                                               s + len, mg->mg_len - cache[0]);
5766                 } else {
5767                     len = cache[0]
5768                         + S_sv_pos_b2u_forwards(aTHX_ s + cache[1], send);
5769                 }
5770             }
5771             else { /* cache[1] > byte */
5772                 len = S_sv_pos_b2u_midway(aTHX_ s, send, s + cache[1],
5773                                           cache[0]);
5774
5775             }
5776             ASSERT_UTF8_CACHE(cache);
5777             if (PL_utf8cache < 0) {
5778                 const STRLEN reallen = S_sv_pos_b2u_forwards(aTHX_ s, send);
5779
5780                 if (len != reallen) {
5781                     /* Need to turn the assertions off otherwise we may recurse
5782                        infinitely while printing error messages.  */
5783                     SAVEI8(PL_utf8cache);
5784                     PL_utf8cache = 0;
5785                     Perl_croak(aTHX_ "panic: sv_pos_b2u cache %"UVf
5786                                " real %"UVf" for %"SVf,
5787                                (UV) len, (UV) reallen, sv);
5788                 }
5789             }
5790         } else if (mg->mg_len != -1) {
5791             len = S_sv_pos_b2u_midway(aTHX_ s, send, s + len, mg->mg_len);
5792         } else {
5793             len = S_sv_pos_b2u_forwards(aTHX_ s, send);
5794         }
5795     }
5796     else {
5797         len = S_sv_pos_b2u_forwards(aTHX_ s, send);
5798     }
5799     *offsetp = len;
5800
5801     S_utf8_mg_pos_cache_update(aTHX_ sv, &mg, byte, len);
5802 }
5803
5804 /*
5805 =for apidoc sv_eq
5806
5807 Returns a boolean indicating whether the strings in the two SVs are
5808 identical. Is UTF-8 and 'use bytes' aware, handles get magic, and will
5809 coerce its args to strings if necessary.
5810
5811 =cut
5812 */
5813
5814 I32
5815 Perl_sv_eq(pTHX_ register SV *sv1, register SV *sv2)
5816 {
5817     dVAR;
5818     const char *pv1;
5819     STRLEN cur1;
5820     const char *pv2;
5821     STRLEN cur2;
5822     I32  eq     = 0;
5823     char *tpv   = NULL;
5824     SV* svrecode = NULL;
5825
5826     if (!sv1) {
5827         pv1 = "";
5828         cur1 = 0;
5829     }
5830     else
5831         pv1 = SvPV_const(sv1, cur1);
5832
5833     if (!sv2){
5834         pv2 = "";
5835         cur2 = 0;
5836     }
5837     else
5838         pv2 = SvPV_const(sv2, cur2);
5839
5840     if (cur1 && cur2 && SvUTF8(sv1) != SvUTF8(sv2) && !IN_BYTES) {
5841         /* Differing utf8ness.
5842          * Do not UTF8size the comparands as a side-effect. */
5843          if (PL_encoding) {
5844               if (SvUTF8(sv1)) {
5845                    svrecode = newSVpvn(pv2, cur2);
5846                    sv_recode_to_utf8(svrecode, PL_encoding);
5847                    pv2 = SvPV_const(svrecode, cur2);
5848               }
5849               else {
5850                    svrecode = newSVpvn(pv1, cur1);
5851                    sv_recode_to_utf8(svrecode, PL_encoding);
5852                    pv1 = SvPV_const(svrecode, cur1);
5853               }
5854               /* Now both are in UTF-8. */
5855               if (cur1 != cur2) {
5856                    SvREFCNT_dec(svrecode);
5857                    return FALSE;
5858               }
5859          }
5860          else {
5861               bool is_utf8 = TRUE;
5862
5863               if (SvUTF8(sv1)) {
5864                    /* sv1 is the UTF-8 one,
5865                     * if is equal it must be downgrade-able */
5866                    char * const pv = (char*)bytes_from_utf8((const U8*)pv1,
5867                                                      &cur1, &is_utf8);
5868                    if (pv != pv1)
5869                         pv1 = tpv = pv;
5870               }
5871               else {
5872                    /* sv2 is the UTF-8 one,
5873                     * if is equal it must be downgrade-able */
5874                    char * const pv = (char *)bytes_from_utf8((const U8*)pv2,
5875                                                       &cur2, &is_utf8);
5876                    if (pv != pv2)
5877                         pv2 = tpv = pv;
5878               }
5879               if (is_utf8) {
5880                    /* Downgrade not possible - cannot be eq */
5881                    assert (tpv == 0);
5882                    return FALSE;
5883               }
5884          }
5885     }
5886
5887     if (cur1 == cur2)
5888         eq = (pv1 == pv2) || memEQ(pv1, pv2, cur1);
5889         
5890     SvREFCNT_dec(svrecode);
5891     if (tpv)
5892         Safefree(tpv);
5893
5894     return eq;
5895 }
5896
5897 /*
5898 =for apidoc sv_cmp
5899
5900 Compares the strings in two SVs.  Returns -1, 0, or 1 indicating whether the
5901 string in C<sv1> is less than, equal to, or greater than the string in
5902 C<sv2>. Is UTF-8 and 'use bytes' aware, handles get magic, and will
5903 coerce its args to strings if necessary.  See also C<sv_cmp_locale>.
5904
5905 =cut
5906 */
5907
5908 I32
5909 Perl_sv_cmp(pTHX_ register SV *sv1, register SV *sv2)
5910 {
5911     dVAR;
5912     STRLEN cur1, cur2;
5913     const char *pv1, *pv2;
5914     char *tpv = NULL;
5915     I32  cmp;
5916     SV *svrecode = NULL;
5917
5918     if (!sv1) {
5919         pv1 = "";
5920         cur1 = 0;
5921     }
5922     else
5923         pv1 = SvPV_const(sv1, cur1);
5924
5925     if (!sv2) {
5926         pv2 = "";
5927         cur2 = 0;
5928     }
5929     else
5930         pv2 = SvPV_const(sv2, cur2);
5931
5932     if (cur1 && cur2 && SvUTF8(sv1) != SvUTF8(sv2) && !IN_BYTES) {
5933         /* Differing utf8ness.
5934          * Do not UTF8size the comparands as a side-effect. */
5935         if (SvUTF8(sv1)) {
5936             if (PL_encoding) {
5937                  svrecode = newSVpvn(pv2, cur2);
5938                  sv_recode_to_utf8(svrecode, PL_encoding);
5939                  pv2 = SvPV_const(svrecode, cur2);
5940             }
5941             else {
5942                  pv2 = tpv = (char*)bytes_to_utf8((const U8*)pv2, &cur2);
5943             }
5944         }
5945         else {
5946             if (PL_encoding) {
5947                  svrecode = newSVpvn(pv1, cur1);
5948                  sv_recode_to_utf8(svrecode, PL_encoding);
5949                  pv1 = SvPV_const(svrecode, cur1);
5950             }
5951             else {
5952                  pv1 = tpv = (char*)bytes_to_utf8((const U8*)pv1, &cur1);
5953             }
5954         }
5955     }
5956
5957     if (!cur1) {
5958         cmp = cur2 ? -1 : 0;
5959     } else if (!cur2) {
5960         cmp = 1;
5961     } else {
5962         const I32 retval = memcmp((const void*)pv1, (const void*)pv2, cur1 < cur2 ? cur1 : cur2);
5963
5964         if (retval) {
5965             cmp = retval < 0 ? -1 : 1;
5966         } else if (cur1 == cur2) {
5967             cmp = 0;
5968         } else {
5969             cmp = cur1 < cur2 ? -1 : 1;
5970         }
5971     }
5972
5973     SvREFCNT_dec(svrecode);
5974     if (tpv)
5975         Safefree(tpv);
5976
5977     return cmp;
5978 }
5979
5980 /*
5981 =for apidoc sv_cmp_locale
5982
5983 Compares the strings in two SVs in a locale-aware manner. Is UTF-8 and
5984 'use bytes' aware, handles get magic, and will coerce its args to strings
5985 if necessary.  See also C<sv_cmp_locale>.  See also C<sv_cmp>.
5986
5987 =cut
5988 */
5989
5990 I32
5991 Perl_sv_cmp_locale(pTHX_ register SV *sv1, register SV *sv2)
5992 {
5993     dVAR;
5994 #ifdef USE_LOCALE_COLLATE
5995
5996     char *pv1, *pv2;
5997     STRLEN len1, len2;
5998     I32 retval;
5999
6000     if (PL_collation_standard)
6001         goto raw_compare;
6002
6003     len1 = 0;
6004     pv1 = sv1 ? sv_collxfrm(sv1, &len1) : (char *) NULL;
6005     len2 = 0;
6006     pv2 = sv2 ? sv_collxfrm(sv2, &len2) : (char *) NULL;
6007
6008     if (!pv1 || !len1) {
6009         if (pv2 && len2)
6010             return -1;
6011         else
6012             goto raw_compare;
6013     }
6014     else {
6015         if (!pv2 || !len2)
6016             return 1;
6017     }
6018
6019     retval = memcmp((void*)pv1, (void*)pv2, len1 < len2 ? len1 : len2);
6020
6021     if (retval)
6022         return retval < 0 ? -1 : 1;
6023
6024     /*
6025      * When the result of collation is equality, that doesn't mean
6026      * that there are no differences -- some locales exclude some
6027      * characters from consideration.  So to avoid false equalities,
6028      * we use the raw string as a tiebreaker.
6029      */
6030
6031   raw_compare:
6032     /*FALLTHROUGH*/
6033
6034 #endif /* USE_LOCALE_COLLATE */
6035
6036     return sv_cmp(sv1, sv2);
6037 }
6038
6039
6040 #ifdef USE_LOCALE_COLLATE
6041
6042 /*
6043 =for apidoc sv_collxfrm
6044
6045 Add Collate Transform magic to an SV if it doesn't already have it.
6046
6047 Any scalar variable may carry PERL_MAGIC_collxfrm magic that contains the
6048 scalar data of the variable, but transformed to such a format that a normal
6049 memory comparison can be used to compare the data according to the locale
6050 settings.
6051
6052 =cut
6053 */
6054
6055 char *
6056 Perl_sv_collxfrm(pTHX_ SV *sv, STRLEN *nxp)
6057 {
6058     dVAR;
6059     MAGIC *mg;
6060
6061     mg = SvMAGICAL(sv) ? mg_find(sv, PERL_MAGIC_collxfrm) : (MAGIC *) NULL;
6062     if (!mg || !mg->mg_ptr || *(U32*)mg->mg_ptr != PL_collation_ix) {
6063         const char *s;
6064         char *xf;
6065         STRLEN len, xlen;
6066
6067         if (mg)
6068             Safefree(mg->mg_ptr);
6069         s = SvPV_const(sv, len);
6070         if ((xf = mem_collxfrm(s, len, &xlen))) {
6071             if (SvREADONLY(sv)) {
6072                 SAVEFREEPV(xf);
6073                 *nxp = xlen;
6074                 return xf + sizeof(PL_collation_ix);
6075             }
6076             if (! mg) {
6077 #ifdef PERL_OLD_COPY_ON_WRITE
6078                 if (SvIsCOW(sv))
6079                     sv_force_normal_flags(sv, 0);
6080 #endif
6081                 mg = sv_magicext(sv, 0, PERL_MAGIC_collxfrm, &PL_vtbl_collxfrm,
6082                                  0, 0);
6083                 assert(mg);
6084             }
6085             mg->mg_ptr = xf;
6086             mg->mg_len = xlen;
6087         }
6088         else {
6089             if (mg) {
6090                 mg->mg_ptr = NULL;
6091                 mg->mg_len = -1;
6092             }
6093         }
6094     }
6095     if (mg && mg->mg_ptr) {
6096         *nxp = mg->mg_len;
6097         return mg->mg_ptr + sizeof(PL_collation_ix);
6098     }
6099     else {
6100         *nxp = 0;
6101         return NULL;
6102     }
6103 }
6104
6105 #endif /* USE_LOCALE_COLLATE */
6106
6107 /*
6108 =for apidoc sv_gets
6109
6110 Get a line from the filehandle and store it into the SV, optionally
6111 appending to the currently-stored string.
6112
6113 =cut
6114 */
6115
6116 char *
6117 Perl_sv_gets(pTHX_ register SV *sv, register PerlIO *fp, I32 append)
6118 {
6119     dVAR;
6120     const char *rsptr;
6121     STRLEN rslen;
6122     register STDCHAR rslast;
6123     register STDCHAR *bp;
6124     register I32 cnt;
6125     I32 i = 0;
6126     I32 rspara = 0;
6127     I32 recsize;
6128
6129     if (SvTHINKFIRST(sv))
6130         sv_force_normal_flags(sv, append ? 0 : SV_COW_DROP_PV);
6131     /* XXX. If you make this PVIV, then copy on write can copy scalars read
6132        from <>.
6133        However, perlbench says it's slower, because the existing swipe code
6134        is faster than copy on write.
6135        Swings and roundabouts.  */
6136     SvUPGRADE(sv, SVt_PV);
6137
6138     SvSCREAM_off(sv);
6139
6140     if (append) {
6141         if (PerlIO_isutf8(fp)) {
6142             if (!SvUTF8(sv)) {
6143                 sv_utf8_upgrade_nomg(sv);
6144                 sv_pos_u2b(sv,&append,0);
6145             }
6146         } else if (SvUTF8(sv)) {
6147             SV * const tsv = newSV(0);
6148             sv_gets(tsv, fp, 0);
6149             sv_utf8_upgrade_nomg(tsv);
6150             SvCUR_set(sv,append);
6151             sv_catsv(sv,tsv);
6152             sv_free(tsv);
6153             goto return_string_or_null;
6154         }
6155     }
6156
6157     SvPOK_only(sv);
6158     if (PerlIO_isutf8(fp))
6159         SvUTF8_on(sv);
6160
6161     if (IN_PERL_COMPILETIME) {
6162         /* we always read code in line mode */
6163         rsptr = "\n";
6164         rslen = 1;
6165     }
6166     else if (RsSNARF(PL_rs)) {
6167         /* If it is a regular disk file use size from stat() as estimate
6168            of amount we are going to read - may result in malloc-ing
6169            more memory than we realy need if layers bellow reduce
6170            size we read (e.g. CRLF or a gzip layer)
6171          */
6172         Stat_t st;
6173         if (!PerlLIO_fstat(PerlIO_fileno(fp), &st) && S_ISREG(st.st_mode))  {
6174             const Off_t offset = PerlIO_tell(fp);
6175             if (offset != (Off_t) -1 && st.st_size + append > offset) {
6176                 (void) SvGROW(sv, (STRLEN)((st.st_size - offset) + append + 1));
6177             }
6178         }
6179         rsptr = NULL;
6180         rslen = 0;
6181     }
6182     else if (RsRECORD(PL_rs)) {
6183       I32 bytesread;
6184       char *buffer;
6185
6186       /* Grab the size of the record we're getting */
6187       recsize = SvIV(SvRV(PL_rs));
6188       buffer = SvGROW(sv, (STRLEN)(recsize + append + 1)) + append;
6189       /* Go yank in */
6190 #ifdef VMS
6191       /* VMS wants read instead of fread, because fread doesn't respect */
6192       /* RMS record boundaries. This is not necessarily a good thing to be */
6193       /* doing, but we've got no other real choice - except avoid stdio
6194          as implementation - perhaps write a :vms layer ?
6195        */
6196       bytesread = PerlLIO_read(PerlIO_fileno(fp), buffer, recsize);
6197 #else
6198       bytesread = PerlIO_read(fp, buffer, recsize);
6199 #endif
6200       if (bytesread < 0)
6201           bytesread = 0;
6202       SvCUR_set(sv, bytesread += append);
6203       buffer[bytesread] = '\0';
6204       goto return_string_or_null;
6205     }
6206     else if (RsPARA(PL_rs)) {
6207         rsptr = "\n\n";
6208         rslen = 2;
6209         rspara = 1;
6210     }
6211     else {
6212         /* Get $/ i.e. PL_rs into same encoding as stream wants */
6213         if (PerlIO_isutf8(fp)) {
6214             rsptr = SvPVutf8(PL_rs, rslen);
6215         }
6216         else {
6217             if (SvUTF8(PL_rs)) {
6218                 if (!sv_utf8_downgrade(PL_rs, TRUE)) {
6219                     Perl_croak(aTHX_ "Wide character in $/");
6220                 }
6221             }
6222             rsptr = SvPV_const(PL_rs, rslen);
6223         }
6224     }
6225
6226     rslast = rslen ? rsptr[rslen - 1] : '\0';
6227
6228     if (rspara) {               /* have to do this both before and after */
6229         do {                    /* to make sure file boundaries work right */
6230             if (PerlIO_eof(fp))
6231                 return 0;
6232             i = PerlIO_getc(fp);
6233             if (i != '\n') {
6234                 if (i == -1)
6235                     return 0;
6236                 PerlIO_ungetc(fp,i);
6237                 break;
6238             }
6239         } while (i != EOF);
6240     }
6241
6242     /* See if we know enough about I/O mechanism to cheat it ! */
6243
6244     /* This used to be #ifdef test - it is made run-time test for ease
6245        of abstracting out stdio interface. One call should be cheap
6246        enough here - and may even be a macro allowing compile
6247        time optimization.
6248      */
6249
6250     if (PerlIO_fast_gets(fp)) {
6251
6252     /*
6253      * We're going to steal some values from the stdio struct
6254      * and put EVERYTHING in the innermost loop into registers.
6255      */
6256     register STDCHAR *ptr;
6257     STRLEN bpx;
6258     I32 shortbuffered;
6259
6260 #if defined(VMS) && defined(PERLIO_IS_STDIO)
6261     /* An ungetc()d char is handled separately from the regular
6262      * buffer, so we getc() it back out and stuff it in the buffer.
6263      */
6264     i = PerlIO_getc(fp);
6265     if (i == EOF) return 0;
6266     *(--((*fp)->_ptr)) = (unsigned char) i;
6267     (*fp)->_cnt++;
6268 #endif
6269
6270     /* Here is some breathtakingly efficient cheating */
6271
6272     cnt = PerlIO_get_cnt(fp);                   /* get count into register */
6273     /* make sure we have the room */
6274     if ((I32)(SvLEN(sv) - append) <= cnt + 1) {
6275         /* Not room for all of it
6276            if we are looking for a separator and room for some
6277          */
6278         if (rslen && cnt > 80 && (I32)SvLEN(sv) > append) {
6279             /* just process what we have room for */
6280             shortbuffered = cnt - SvLEN(sv) + append + 1;
6281             cnt -= shortbuffered;
6282         }
6283         else {
6284             shortbuffered = 0;
6285             /* remember that cnt can be negative */
6286             SvGROW(sv, (STRLEN)(append + (cnt <= 0 ? 2 : (cnt + 1))));
6287         }
6288     }
6289     else
6290         shortbuffered = 0;
6291     bp = (STDCHAR*)SvPVX_const(sv) + append;  /* move these two too to registers */
6292     ptr = (STDCHAR*)PerlIO_get_ptr(fp);
6293     DEBUG_P(PerlIO_printf(Perl_debug_log,
6294         "Screamer: entering, ptr=%"UVuf", cnt=%ld\n",PTR2UV(ptr),(long)cnt));
6295     DEBUG_P(PerlIO_printf(Perl_debug_log,
6296         "Screamer: entering: PerlIO * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
6297                PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp),
6298                PTR2UV(PerlIO_has_base(fp) ? PerlIO_get_base(fp) : 0)));
6299     for (;;) {
6300       screamer:
6301         if (cnt > 0) {
6302             if (rslen) {
6303                 while (cnt > 0) {                    /* this     |  eat */
6304                     cnt--;
6305                     if ((*bp++ = *ptr++) == rslast)  /* really   |  dust */
6306                         goto thats_all_folks;        /* screams  |  sed :-) */
6307                 }
6308             }
6309             else {
6310                 Copy(ptr, bp, cnt, char);            /* this     |  eat */
6311                 bp += cnt;                           /* screams  |  dust */
6312                 ptr += cnt;                          /* louder   |  sed :-) */
6313                 cnt = 0;
6314             }
6315         }
6316         
6317         if (shortbuffered) {            /* oh well, must extend */
6318             cnt = shortbuffered;
6319             shortbuffered = 0;
6320             bpx = bp - (STDCHAR*)SvPVX_const(sv); /* box up before relocation */
6321             SvCUR_set(sv, bpx);
6322             SvGROW(sv, SvLEN(sv) + append + cnt + 2);
6323             bp = (STDCHAR*)SvPVX_const(sv) + bpx; /* unbox after relocation */
6324             continue;
6325         }
6326
6327         DEBUG_P(PerlIO_printf(Perl_debug_log,
6328                               "Screamer: going to getc, ptr=%"UVuf", cnt=%ld\n",
6329                               PTR2UV(ptr),(long)cnt));
6330         PerlIO_set_ptrcnt(fp, (STDCHAR*)ptr, cnt); /* deregisterize cnt and ptr */
6331 #if 0
6332         DEBUG_P(PerlIO_printf(Perl_debug_log,
6333             "Screamer: pre: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
6334             PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp),
6335             PTR2UV(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
6336 #endif
6337         /* This used to call 'filbuf' in stdio form, but as that behaves like
6338            getc when cnt <= 0 we use PerlIO_getc here to avoid introducing
6339            another abstraction.  */
6340         i   = PerlIO_getc(fp);          /* get more characters */
6341 #if 0
6342         DEBUG_P(PerlIO_printf(Perl_debug_log,
6343             "Screamer: post: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
6344             PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp),
6345             PTR2UV(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
6346 #endif
6347         cnt = PerlIO_get_cnt(fp);
6348         ptr = (STDCHAR*)PerlIO_get_ptr(fp);     /* reregisterize cnt and ptr */
6349         DEBUG_P(PerlIO_printf(Perl_debug_log,
6350             "Screamer: after getc, ptr=%"UVuf", cnt=%ld\n",PTR2UV(ptr),(long)cnt));
6351
6352         if (i == EOF)                   /* all done for ever? */
6353             goto thats_really_all_folks;
6354
6355         bpx = bp - (STDCHAR*)SvPVX_const(sv);   /* box up before relocation */
6356         SvCUR_set(sv, bpx);
6357         SvGROW(sv, bpx + cnt + 2);
6358         bp = (STDCHAR*)SvPVX_const(sv) + bpx;   /* unbox after relocation */
6359
6360         *bp++ = (STDCHAR)i;             /* store character from PerlIO_getc */
6361
6362         if (rslen && (STDCHAR)i == rslast)  /* all done for now? */
6363             goto thats_all_folks;
6364     }
6365
6366 thats_all_folks:
6367     if ((rslen > 1 && (STRLEN)(bp - (STDCHAR*)SvPVX_const(sv)) < rslen) ||
6368           memNE((char*)bp - rslen, rsptr, rslen))
6369         goto screamer;                          /* go back to the fray */
6370 thats_really_all_folks:
6371     if (shortbuffered)
6372         cnt += shortbuffered;
6373         DEBUG_P(PerlIO_printf(Perl_debug_log,
6374             "Screamer: quitting, ptr=%"UVuf", cnt=%ld\n",PTR2UV(ptr),(long)cnt));
6375     PerlIO_set_ptrcnt(fp, (STDCHAR*)ptr, cnt);  /* put these back or we're in trouble */
6376     DEBUG_P(PerlIO_printf(Perl_debug_log,
6377         "Screamer: end: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
6378         PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp),
6379         PTR2UV(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
6380     *bp = '\0';
6381     SvCUR_set(sv, bp - (STDCHAR*)SvPVX_const(sv));      /* set length */
6382     DEBUG_P(PerlIO_printf(Perl_debug_log,
6383         "Screamer: done, len=%ld, string=|%.*s|\n",
6384         (long)SvCUR(sv),(int)SvCUR(sv),SvPVX_const(sv)));
6385     }
6386    else
6387     {
6388        /*The big, slow, and stupid way. */
6389 #ifdef USE_HEAP_INSTEAD_OF_STACK        /* Even slower way. */
6390         STDCHAR *buf = NULL;
6391         Newx(buf, 8192, STDCHAR);
6392         assert(buf);
6393 #else
6394         STDCHAR buf[8192];
6395 #endif
6396
6397 screamer2:
6398         if (rslen) {
6399             register const STDCHAR * const bpe = buf + sizeof(buf);
6400             bp = buf;
6401             while ((i = PerlIO_getc(fp)) != EOF && (*bp++ = (STDCHAR)i) != rslast && bp < bpe)
6402                 ; /* keep reading */
6403             cnt = bp - buf;
6404         }
6405         else {
6406             cnt = PerlIO_read(fp,(char*)buf, sizeof(buf));
6407             /* Accomodate broken VAXC compiler, which applies U8 cast to
6408              * both args of ?: operator, causing EOF to change into 255
6409              */
6410             if (cnt > 0)
6411                  i = (U8)buf[cnt - 1];
6412             else
6413                  i = EOF;
6414         }
6415
6416         if (cnt < 0)
6417             cnt = 0;  /* we do need to re-set the sv even when cnt <= 0 */
6418         if (append)
6419              sv_catpvn(sv, (char *) buf, cnt);
6420         else
6421              sv_setpvn(sv, (char *) buf, cnt);
6422
6423         if (i != EOF &&                 /* joy */
6424             (!rslen ||
6425              SvCUR(sv) < rslen ||
6426              memNE(SvPVX_const(sv) + SvCUR(sv) - rslen, rsptr, rslen)))
6427         {
6428             append = -1;
6429             /*
6430              * If we're reading from a TTY and we get a short read,
6431              * indicating that the user hit his EOF character, we need
6432              * to notice it now, because if we try to read from the TTY
6433              * again, the EOF condition will disappear.
6434              *
6435              * The comparison of cnt to sizeof(buf) is an optimization
6436              * that prevents unnecessary calls to feof().
6437              *
6438              * - jik 9/25/96
6439              */
6440             if (!(cnt < sizeof(buf) && PerlIO_eof(fp)))
6441                 goto screamer2;
6442         }
6443
6444 #ifdef USE_HEAP_INSTEAD_OF_STACK
6445         Safefree(buf);
6446 #endif
6447     }
6448
6449     if (rspara) {               /* have to do this both before and after */
6450         while (i != EOF) {      /* to make sure file boundaries work right */
6451             i = PerlIO_getc(fp);
6452             if (i != '\n') {
6453                 PerlIO_ungetc(fp,i);
6454                 break;
6455             }
6456         }
6457     }
6458
6459 return_string_or_null:
6460     return (SvCUR(sv) - append) ? SvPVX(sv) : NULL;
6461 }
6462
6463 /*
6464 =for apidoc sv_inc
6465
6466 Auto-increment of the value in the SV, doing string to numeric conversion
6467 if necessary. Handles 'get' magic.
6468
6469 =cut
6470 */
6471
6472 void
6473 Perl_sv_inc(pTHX_ register SV *sv)
6474 {
6475     dVAR;
6476     register char *d;
6477     int flags;
6478
6479     if (!sv)
6480         return;
6481     SvGETMAGIC(sv);
6482     if (SvTHINKFIRST(sv)) {
6483         if (SvIsCOW(sv))
6484             sv_force_normal_flags(sv, 0);
6485         if (SvREADONLY(sv)) {
6486             if (IN_PERL_RUNTIME)
6487                 Perl_croak(aTHX_ PL_no_modify);
6488         }
6489         if (SvROK(sv)) {
6490             IV i;
6491             if (SvAMAGIC(sv) && AMG_CALLun(sv,inc))
6492                 return;
6493             i = PTR2IV(SvRV(sv));
6494             sv_unref(sv);
6495             sv_setiv(sv, i);
6496         }
6497     }
6498     flags = SvFLAGS(sv);
6499     if ((flags & (SVp_NOK|SVp_IOK)) == SVp_NOK) {
6500         /* It's (privately or publicly) a float, but not tested as an
6501            integer, so test it to see. */
6502         (void) SvIV(sv);
6503         flags = SvFLAGS(sv);
6504     }
6505     if ((flags & SVf_IOK) || ((flags & (SVp_IOK | SVp_NOK)) == SVp_IOK)) {
6506         /* It's publicly an integer, or privately an integer-not-float */
6507 #ifdef PERL_PRESERVE_IVUV
6508       oops_its_int:
6509 #endif
6510         if (SvIsUV(sv)) {
6511             if (SvUVX(sv) == UV_MAX)
6512                 sv_setnv(sv, UV_MAX_P1);
6513             else
6514                 (void)SvIOK_only_UV(sv);
6515                 SvUV_set(sv, SvUVX(sv) + 1);
6516         } else {
6517             if (SvIVX(sv) == IV_MAX)
6518                 sv_setuv(sv, (UV)IV_MAX + 1);
6519             else {
6520                 (void)SvIOK_only(sv);
6521                 SvIV_set(sv, SvIVX(sv) + 1);
6522             }   
6523         }
6524         return;
6525     }
6526     if (flags & SVp_NOK) {
6527         (void)SvNOK_only(sv);
6528         SvNV_set(sv, SvNVX(sv) + 1.0);
6529         return;
6530     }
6531
6532     if (!(flags & SVp_POK) || !*SvPVX_const(sv)) {
6533         if ((flags & SVTYPEMASK) < SVt_PVIV)
6534             sv_upgrade(sv, ((flags & SVTYPEMASK) > SVt_IV ? SVt_PVIV : SVt_IV));
6535         (void)SvIOK_only(sv);
6536         SvIV_set(sv, 1);
6537         return;
6538     }
6539     d = SvPVX(sv);
6540     while (isALPHA(*d)) d++;
6541     while (isDIGIT(*d)) d++;
6542     if (*d) {
6543 #ifdef PERL_PRESERVE_IVUV
6544         /* Got to punt this as an integer if needs be, but we don't issue
6545            warnings. Probably ought to make the sv_iv_please() that does
6546            the conversion if possible, and silently.  */
6547         const int numtype = grok_number(SvPVX_const(sv), SvCUR(sv), NULL);
6548         if (numtype && !(numtype & IS_NUMBER_INFINITY)) {
6549             /* Need to try really hard to see if it's an integer.
6550                9.22337203685478e+18 is an integer.
6551                but "9.22337203685478e+18" + 0 is UV=9223372036854779904
6552                so $a="9.22337203685478e+18"; $a+0; $a++
6553                needs to be the same as $a="9.22337203685478e+18"; $a++
6554                or we go insane. */
6555         
6556             (void) sv_2iv(sv);
6557             if (SvIOK(sv))
6558                 goto oops_its_int;
6559
6560             /* sv_2iv *should* have made this an NV */
6561             if (flags & SVp_NOK) {
6562                 (void)SvNOK_only(sv);
6563                 SvNV_set(sv, SvNVX(sv) + 1.0);
6564                 return;
6565             }
6566             /* I don't think we can get here. Maybe I should assert this
6567                And if we do get here I suspect that sv_setnv will croak. NWC
6568                Fall through. */
6569 #if defined(USE_LONG_DOUBLE)
6570             DEBUG_c(PerlIO_printf(Perl_debug_log,"sv_inc punt failed to convert '%s' to IOK or NOKp, UV=0x%"UVxf" NV=%"PERL_PRIgldbl"\n",
6571                                   SvPVX_const(sv), SvIVX(sv), SvNVX(sv)));
6572 #else
6573             DEBUG_c(PerlIO_printf(Perl_debug_log,"sv_inc punt failed to convert '%s' to IOK or NOKp, UV=0x%"UVxf" NV=%"NVgf"\n",
6574                                   SvPVX_const(sv), SvIVX(sv), SvNVX(sv)));
6575 #endif
6576         }
6577 #endif /* PERL_PRESERVE_IVUV */
6578         sv_setnv(sv,Atof(SvPVX_const(sv)) + 1.0);
6579         return;
6580     }
6581     d--;
6582     while (d >= SvPVX_const(sv)) {
6583         if (isDIGIT(*d)) {
6584             if (++*d <= '9')
6585                 return;
6586             *(d--) = '0';
6587         }
6588         else {
6589 #ifdef EBCDIC
6590             /* MKS: The original code here died if letters weren't consecutive.
6591              * at least it didn't have to worry about non-C locales.  The
6592              * new code assumes that ('z'-'a')==('Z'-'A'), letters are
6593              * arranged in order (although not consecutively) and that only
6594              * [A-Za-z] are accepted by isALPHA in the C locale.
6595              */
6596             if (*d != 'z' && *d != 'Z') {
6597                 do { ++*d; } while (!isALPHA(*d));
6598                 return;
6599             }
6600             *(d--) -= 'z' - 'a';
6601 #else
6602             ++*d;
6603             if (isALPHA(*d))
6604                 return;
6605             *(d--) -= 'z' - 'a' + 1;
6606 #endif
6607         }
6608     }
6609     /* oh,oh, the number grew */
6610     SvGROW(sv, SvCUR(sv) + 2);
6611     SvCUR_set(sv, SvCUR(sv) + 1);
6612     for (d = SvPVX(sv) + SvCUR(sv); d > SvPVX_const(sv); d--)
6613         *d = d[-1];
6614     if (isDIGIT(d[1]))
6615         *d = '1';
6616     else
6617         *d = d[1];
6618 }
6619
6620 /*
6621 =for apidoc sv_dec
6622
6623 Auto-decrement of the value in the SV, doing string to numeric conversion
6624 if necessary. Handles 'get' magic.
6625
6626 =cut
6627 */
6628
6629 void
6630 Perl_sv_dec(pTHX_ register SV *sv)
6631 {
6632     dVAR;
6633     int flags;
6634
6635     if (!sv)
6636         return;
6637     SvGETMAGIC(sv);
6638     if (SvTHINKFIRST(sv)) {
6639         if (SvIsCOW(sv))
6640             sv_force_normal_flags(sv, 0);
6641         if (SvREADONLY(sv)) {
6642             if (IN_PERL_RUNTIME)
6643                 Perl_croak(aTHX_ PL_no_modify);
6644         }
6645         if (SvROK(sv)) {
6646             IV i;
6647             if (SvAMAGIC(sv) && AMG_CALLun(sv,dec))
6648                 return;
6649             i = PTR2IV(SvRV(sv));
6650             sv_unref(sv);
6651             sv_setiv(sv, i);
6652         }
6653     }
6654     /* Unlike sv_inc we don't have to worry about string-never-numbers
6655        and keeping them magic. But we mustn't warn on punting */
6656     flags = SvFLAGS(sv);
6657     if ((flags & SVf_IOK) || ((flags & (SVp_IOK | SVp_NOK)) == SVp_IOK)) {
6658         /* It's publicly an integer, or privately an integer-not-float */
6659 #ifdef PERL_PRESERVE_IVUV
6660       oops_its_int:
6661 #endif
6662         if (SvIsUV(sv)) {
6663             if (SvUVX(sv) == 0) {
6664                 (void)SvIOK_only(sv);
6665                 SvIV_set(sv, -1);
6666             }
6667             else {
6668                 (void)SvIOK_only_UV(sv);
6669                 SvUV_set(sv, SvUVX(sv) - 1);
6670             }   
6671         } else {
6672             if (SvIVX(sv) == IV_MIN)
6673                 sv_setnv(sv, (NV)IV_MIN - 1.0);
6674             else {
6675                 (void)SvIOK_only(sv);
6676                 SvIV_set(sv, SvIVX(sv) - 1);
6677             }   
6678         }
6679         return;
6680     }
6681     if (flags & SVp_NOK) {
6682         SvNV_set(sv, SvNVX(sv) - 1.0);
6683         (void)SvNOK_only(sv);
6684         return;
6685     }
6686     if (!(flags & SVp_POK)) {
6687         if ((flags & SVTYPEMASK) < SVt_PVIV)
6688             sv_upgrade(sv, ((flags & SVTYPEMASK) > SVt_IV) ? SVt_PVIV : SVt_IV);
6689         SvIV_set(sv, -1);
6690         (void)SvIOK_only(sv);
6691         return;
6692     }
6693 #ifdef PERL_PRESERVE_IVUV
6694     {
6695         const int numtype = grok_number(SvPVX_const(sv), SvCUR(sv), NULL);
6696         if (numtype && !(numtype & IS_NUMBER_INFINITY)) {
6697             /* Need to try really hard to see if it's an integer.
6698                9.22337203685478e+18 is an integer.
6699                but "9.22337203685478e+18" + 0 is UV=9223372036854779904
6700                so $a="9.22337203685478e+18"; $a+0; $a--
6701                needs to be the same as $a="9.22337203685478e+18"; $a--
6702                or we go insane. */
6703         
6704             (void) sv_2iv(sv);
6705             if (SvIOK(sv))
6706                 goto oops_its_int;
6707
6708             /* sv_2iv *should* have made this an NV */
6709             if (flags & SVp_NOK) {
6710                 (void)SvNOK_only(sv);
6711                 SvNV_set(sv, SvNVX(sv) - 1.0);
6712                 return;
6713             }
6714             /* I don't think we can get here. Maybe I should assert this
6715                And if we do get here I suspect that sv_setnv will croak. NWC
6716                Fall through. */
6717 #if defined(USE_LONG_DOUBLE)
6718             DEBUG_c(PerlIO_printf(Perl_debug_log,"sv_dec punt failed to convert '%s' to IOK or NOKp, UV=0x%"UVxf" NV=%"PERL_PRIgldbl"\n",
6719                                   SvPVX_const(sv), SvIVX(sv), SvNVX(sv)));
6720 #else
6721             DEBUG_c(PerlIO_printf(Perl_debug_log,"sv_dec punt failed to convert '%s' to IOK or NOKp, UV=0x%"UVxf" NV=%"NVgf"\n",
6722                                   SvPVX_const(sv), SvIVX(sv), SvNVX(sv)));
6723 #endif
6724         }
6725     }
6726 #endif /* PERL_PRESERVE_IVUV */
6727     sv_setnv(sv,Atof(SvPVX_const(sv)) - 1.0);   /* punt */
6728 }
6729
6730 /*
6731 =for apidoc sv_mortalcopy
6732
6733 Creates a new SV which is a copy of the original SV (using C<sv_setsv>).
6734 The new SV is marked as mortal. It will be destroyed "soon", either by an
6735 explicit call to FREETMPS, or by an implicit call at places such as
6736 statement boundaries.  See also C<sv_newmortal> and C<sv_2mortal>.
6737
6738 =cut
6739 */
6740
6741 /* Make a string that will exist for the duration of the expression
6742  * evaluation.  Actually, it may have to last longer than that, but
6743  * hopefully we won't free it until it has been assigned to a
6744  * permanent location. */
6745
6746 SV *
6747 Perl_sv_mortalcopy(pTHX_ SV *oldstr)
6748 {
6749     dVAR;
6750     register SV *sv;
6751
6752     new_SV(sv);
6753     sv_setsv(sv,oldstr);
6754     EXTEND_MORTAL(1);
6755     PL_tmps_stack[++PL_tmps_ix] = sv;
6756     SvTEMP_on(sv);
6757     return sv;
6758 }
6759
6760 /*
6761 =for apidoc sv_newmortal
6762
6763 Creates a new null SV which is mortal.  The reference count of the SV is
6764 set to 1. It will be destroyed "soon", either by an explicit call to
6765 FREETMPS, or by an implicit call at places such as statement boundaries.
6766 See also C<sv_mortalcopy> and C<sv_2mortal>.
6767
6768 =cut
6769 */
6770
6771 SV *
6772 Perl_sv_newmortal(pTHX)
6773 {
6774     dVAR;
6775     register SV *sv;
6776
6777     new_SV(sv);
6778     SvFLAGS(sv) = SVs_TEMP;
6779     EXTEND_MORTAL(1);
6780     PL_tmps_stack[++PL_tmps_ix] = sv;
6781     return sv;
6782 }
6783
6784 /*
6785 =for apidoc sv_2mortal
6786
6787 Marks an existing SV as mortal.  The SV will be destroyed "soon", either
6788 by an explicit call to FREETMPS, or by an implicit call at places such as
6789 statement boundaries.  SvTEMP() is turned on which means that the SV's
6790 string buffer can be "stolen" if this SV is copied. See also C<sv_newmortal>
6791 and C<sv_mortalcopy>.
6792
6793 =cut
6794 */
6795
6796 SV *
6797 Perl_sv_2mortal(pTHX_ register SV *sv)
6798 {
6799     dVAR;
6800     if (!sv)
6801         return NULL;
6802     if (SvREADONLY(sv) && SvIMMORTAL(sv))
6803         return sv;
6804     EXTEND_MORTAL(1);
6805     PL_tmps_stack[++PL_tmps_ix] = sv;
6806     SvTEMP_on(sv);
6807     return sv;
6808 }
6809
6810 /*
6811 =for apidoc newSVpv
6812
6813 Creates a new SV and copies a string into it.  The reference count for the
6814 SV is set to 1.  If C<len> is zero, Perl will compute the length using
6815 strlen().  For efficiency, consider using C<newSVpvn> instead.
6816
6817 =cut
6818 */
6819
6820 SV *
6821 Perl_newSVpv(pTHX_ const char *s, STRLEN len)
6822 {
6823     dVAR;
6824     register SV *sv;
6825
6826     new_SV(sv);
6827     sv_setpvn(sv,s,len ? len : strlen(s));
6828     return sv;
6829 }
6830
6831 /*
6832 =for apidoc newSVpvn
6833
6834 Creates a new SV and copies a string into it.  The reference count for the
6835 SV is set to 1.  Note that if C<len> is zero, Perl will create a zero length
6836 string.  You are responsible for ensuring that the source string is at least
6837 C<len> bytes long.  If the C<s> argument is NULL the new SV will be undefined.
6838
6839 =cut
6840 */
6841
6842 SV *
6843 Perl_newSVpvn(pTHX_ const char *s, STRLEN len)
6844 {
6845     dVAR;
6846     register SV *sv;
6847
6848     new_SV(sv);
6849     sv_setpvn(sv,s,len);
6850     return sv;
6851 }
6852
6853
6854 /*
6855 =for apidoc newSVhek
6856
6857 Creates a new SV from the hash key structure.  It will generate scalars that
6858 point to the shared string table where possible. Returns a new (undefined)
6859 SV if the hek is NULL.
6860
6861 =cut
6862 */
6863
6864 SV *
6865 Perl_newSVhek(pTHX_ const HEK *hek)
6866 {
6867     dVAR;
6868     if (!hek) {
6869         SV *sv;
6870
6871         new_SV(sv);
6872         return sv;
6873     }
6874
6875     if (HEK_LEN(hek) == HEf_SVKEY) {
6876         return newSVsv(*(SV**)HEK_KEY(hek));
6877     } else {
6878         const int flags = HEK_FLAGS(hek);
6879         if (flags & HVhek_WASUTF8) {
6880             /* Trouble :-)
6881                Andreas would like keys he put in as utf8 to come back as utf8
6882             */
6883             STRLEN utf8_len = HEK_LEN(hek);
6884             const U8 *as_utf8 = bytes_to_utf8 ((U8*)HEK_KEY(hek), &utf8_len);
6885             SV * const sv = newSVpvn ((const char*)as_utf8, utf8_len);
6886
6887             SvUTF8_on (sv);
6888             Safefree (as_utf8); /* bytes_to_utf8() allocates a new string */
6889             return sv;
6890         } else if (flags & HVhek_REHASH) {
6891             /* We don't have a pointer to the hv, so we have to replicate the
6892                flag into every HEK. This hv is using custom a hasing
6893                algorithm. Hence we can't return a shared string scalar, as
6894                that would contain the (wrong) hash value, and might get passed
6895                into an hv routine with a regular hash  */
6896
6897             SV * const sv = newSVpvn (HEK_KEY(hek), HEK_LEN(hek));
6898             if (HEK_UTF8(hek))
6899                 SvUTF8_on (sv);
6900             return sv;
6901         }
6902         /* This will be overwhelminly the most common case.  */
6903         return newSVpvn_share(HEK_KEY(hek),
6904                               (HEK_UTF8(hek) ? -HEK_LEN(hek) : HEK_LEN(hek)),
6905                               HEK_HASH(hek));
6906     }
6907 }
6908
6909 /*
6910 =for apidoc newSVpvn_share
6911
6912 Creates a new SV with its SvPVX_const pointing to a shared string in the string
6913 table. If the string does not already exist in the table, it is created
6914 first.  Turns on READONLY and FAKE.  The string's hash is stored in the UV
6915 slot of the SV; if the C<hash> parameter is non-zero, that value is used;
6916 otherwise the hash is computed.  The idea here is that as the string table
6917 is used for shared hash keys these strings will have SvPVX_const == HeKEY and
6918 hash lookup will avoid string compare.
6919
6920 =cut
6921 */
6922
6923 SV *
6924 Perl_newSVpvn_share(pTHX_ const char *src, I32 len, U32 hash)
6925 {
6926     dVAR;
6927     register SV *sv;
6928     bool is_utf8 = FALSE;
6929     if (len < 0) {
6930         STRLEN tmplen = -len;
6931         is_utf8 = TRUE;
6932         /* See the note in hv.c:hv_fetch() --jhi */
6933         src = (char*)bytes_from_utf8((const U8*)src, &tmplen, &is_utf8);
6934         len = tmplen;
6935     }
6936     if (!hash)
6937         PERL_HASH(hash, src, len);
6938     new_SV(sv);
6939     sv_upgrade(sv, SVt_PV);
6940     SvPV_set(sv, sharepvn(src, is_utf8?-len:len, hash));
6941     SvCUR_set(sv, len);
6942     SvLEN_set(sv, 0);
6943     SvREADONLY_on(sv);
6944     SvFAKE_on(sv);
6945     SvPOK_on(sv);
6946     if (is_utf8)
6947         SvUTF8_on(sv);
6948     return sv;
6949 }
6950
6951
6952 #if defined(PERL_IMPLICIT_CONTEXT)
6953
6954 /* pTHX_ magic can't cope with varargs, so this is a no-context
6955  * version of the main function, (which may itself be aliased to us).
6956  * Don't access this version directly.
6957  */
6958
6959 SV *
6960 Perl_newSVpvf_nocontext(const char* pat, ...)
6961 {
6962     dTHX;
6963     register SV *sv;
6964     va_list args;
6965     va_start(args, pat);
6966     sv = vnewSVpvf(pat, &args);
6967     va_end(args);
6968     return sv;
6969 }
6970 #endif
6971
6972 /*
6973 =for apidoc newSVpvf
6974
6975 Creates a new SV and initializes it with the string formatted like
6976 C<sprintf>.
6977
6978 =cut
6979 */
6980
6981 SV *
6982 Perl_newSVpvf(pTHX_ const char* pat, ...)
6983 {
6984     register SV *sv;
6985     va_list args;
6986     va_start(args, pat);
6987     sv = vnewSVpvf(pat, &args);
6988     va_end(args);
6989     return sv;
6990 }
6991
6992 /* backend for newSVpvf() and newSVpvf_nocontext() */
6993
6994 SV *
6995 Perl_vnewSVpvf(pTHX_ const char* pat, va_list* args)
6996 {
6997     dVAR;
6998     register SV *sv;
6999     new_SV(sv);
7000     sv_vsetpvfn(sv, pat, strlen(pat), args, NULL, 0, NULL);
7001     return sv;
7002 }
7003
7004 /*
7005 =for apidoc newSVnv
7006
7007 Creates a new SV and copies a floating point value into it.
7008 The reference count for the SV is set to 1.
7009
7010 =cut
7011 */
7012
7013 SV *
7014 Perl_newSVnv(pTHX_ NV n)
7015 {
7016     dVAR;
7017     register SV *sv;
7018
7019     new_SV(sv);
7020     sv_setnv(sv,n);
7021     return sv;
7022 }
7023
7024 /*
7025 =for apidoc newSViv
7026
7027 Creates a new SV and copies an integer into it.  The reference count for the
7028 SV is set to 1.
7029
7030 =cut
7031 */
7032
7033 SV *
7034 Perl_newSViv(pTHX_ IV i)
7035 {
7036     dVAR;
7037     register SV *sv;
7038
7039     new_SV(sv);
7040     sv_setiv(sv,i);
7041     return sv;
7042 }
7043
7044 /*
7045 =for apidoc newSVuv
7046
7047 Creates a new SV and copies an unsigned integer into it.
7048 The reference count for the SV is set to 1.
7049
7050 =cut
7051 */
7052
7053 SV *
7054 Perl_newSVuv(pTHX_ UV u)
7055 {
7056     dVAR;
7057     register SV *sv;
7058
7059     new_SV(sv);
7060     sv_setuv(sv,u);
7061     return sv;
7062 }
7063
7064 /*
7065 =for apidoc newRV_noinc
7066
7067 Creates an RV wrapper for an SV.  The reference count for the original
7068 SV is B<not> incremented.
7069
7070 =cut
7071 */
7072
7073 SV *
7074 Perl_newRV_noinc(pTHX_ SV *tmpRef)
7075 {
7076     dVAR;
7077     register SV *sv;
7078
7079     new_SV(sv);
7080     sv_upgrade(sv, SVt_RV);
7081     SvTEMP_off(tmpRef);
7082     SvRV_set(sv, tmpRef);
7083     SvROK_on(sv);
7084     return sv;
7085 }
7086
7087 /* newRV_inc is the official function name to use now.
7088  * newRV_inc is in fact #defined to newRV in sv.h
7089  */
7090
7091 SV *
7092 Perl_newRV(pTHX_ SV *sv)
7093 {
7094     dVAR;
7095     return newRV_noinc(SvREFCNT_inc_simple_NN(sv));
7096 }
7097
7098 /*
7099 =for apidoc newSVsv
7100
7101 Creates a new SV which is an exact duplicate of the original SV.
7102 (Uses C<sv_setsv>).
7103
7104 =cut
7105 */
7106
7107 SV *
7108 Perl_newSVsv(pTHX_ register SV *old)
7109 {
7110     dVAR;
7111     register SV *sv;
7112
7113     if (!old)
7114         return NULL;
7115     if (SvTYPE(old) == SVTYPEMASK) {
7116         if (ckWARN_d(WARN_INTERNAL))
7117             Perl_warner(aTHX_ packWARN(WARN_INTERNAL), "semi-panic: attempt to dup freed string");
7118         return NULL;
7119     }
7120     new_SV(sv);
7121     /* SV_GMAGIC is the default for sv_setv()
7122        SV_NOSTEAL prevents TEMP buffers being, well, stolen, and saves games
7123        with SvTEMP_off and SvTEMP_on round a call to sv_setsv.  */
7124     sv_setsv_flags(sv, old, SV_GMAGIC | SV_NOSTEAL);
7125     return sv;
7126 }
7127
7128 /*
7129 =for apidoc sv_reset
7130
7131 Underlying implementation for the C<reset> Perl function.
7132 Note that the perl-level function is vaguely deprecated.
7133
7134 =cut
7135 */
7136
7137 void
7138 Perl_sv_reset(pTHX_ register const char *s, HV *stash)
7139 {
7140     dVAR;
7141     char todo[PERL_UCHAR_MAX+1];
7142
7143     if (!stash)
7144         return;
7145
7146     if (!*s) {          /* reset ?? searches */
7147         MAGIC * const mg = mg_find((SV *)stash, PERL_MAGIC_symtab);
7148         if (mg) {
7149             PMOP *pm = (PMOP *) mg->mg_obj;
7150             while (pm) {
7151                 pm->op_pmdynflags &= ~PMdf_USED;
7152                 pm = pm->op_pmnext;
7153             }
7154         }
7155         return;
7156     }
7157
7158     /* reset variables */
7159
7160     if (!HvARRAY(stash))
7161         return;
7162
7163     Zero(todo, 256, char);
7164     while (*s) {
7165         I32 max;
7166         I32 i = (unsigned char)*s;
7167         if (s[1] == '-') {
7168             s += 2;
7169         }
7170         max = (unsigned char)*s++;
7171         for ( ; i <= max; i++) {
7172             todo[i] = 1;
7173         }
7174         for (i = 0; i <= (I32) HvMAX(stash); i++) {
7175             HE *entry;
7176             for (entry = HvARRAY(stash)[i];
7177                  entry;
7178                  entry = HeNEXT(entry))
7179             {
7180                 register GV *gv;
7181                 register SV *sv;
7182
7183                 if (!todo[(U8)*HeKEY(entry)])
7184                     continue;
7185                 gv = (GV*)HeVAL(entry);
7186                 sv = GvSV(gv);
7187                 if (sv) {
7188                     if (SvTHINKFIRST(sv)) {
7189                         if (!SvREADONLY(sv) && SvROK(sv))
7190                             sv_unref(sv);
7191                         /* XXX Is this continue a bug? Why should THINKFIRST
7192                            exempt us from resetting arrays and hashes?  */
7193                         continue;
7194                     }
7195                     SvOK_off(sv);
7196                     if (SvTYPE(sv) >= SVt_PV) {
7197                         SvCUR_set(sv, 0);
7198                         if (SvPVX_const(sv) != NULL)
7199                             *SvPVX(sv) = '\0';
7200                         SvTAINT(sv);
7201                     }
7202                 }
7203                 if (GvAV(gv)) {
7204                     av_clear(GvAV(gv));
7205                 }
7206                 if (GvHV(gv) && !HvNAME_get(GvHV(gv))) {
7207 #if defined(VMS)
7208                     Perl_die(aTHX_ "Can't reset %%ENV on this system");
7209 #else /* ! VMS */
7210                     hv_clear(GvHV(gv));
7211 #  if defined(USE_ENVIRON_ARRAY)
7212                     if (gv == PL_envgv)
7213                         my_clearenv();
7214 #  endif /* USE_ENVIRON_ARRAY */
7215 #endif /* VMS */
7216                 }
7217             }
7218         }
7219     }
7220 }
7221
7222 /*
7223 =for apidoc sv_2io
7224
7225 Using various gambits, try to get an IO from an SV: the IO slot if its a
7226 GV; or the recursive result if we're an RV; or the IO slot of the symbol
7227 named after the PV if we're a string.
7228
7229 =cut
7230 */
7231
7232 IO*
7233 Perl_sv_2io(pTHX_ SV *sv)
7234 {
7235     IO* io;
7236     GV* gv;
7237
7238     switch (SvTYPE(sv)) {
7239     case SVt_PVIO:
7240         io = (IO*)sv;
7241         break;
7242     case SVt_PVGV:
7243         gv = (GV*)sv;
7244         io = GvIO(gv);
7245         if (!io)
7246             Perl_croak(aTHX_ "Bad filehandle: %s", GvNAME(gv));
7247         break;
7248     default:
7249         if (!SvOK(sv))
7250             Perl_croak(aTHX_ PL_no_usym, "filehandle");
7251         if (SvROK(sv))
7252             return sv_2io(SvRV(sv));
7253         gv = gv_fetchsv(sv, 0, SVt_PVIO);
7254         if (gv)
7255             io = GvIO(gv);
7256         else
7257             io = 0;
7258         if (!io)
7259             Perl_croak(aTHX_ "Bad filehandle: %"SVf, sv);
7260         break;
7261     }
7262     return io;
7263 }
7264
7265 /*
7266 =for apidoc sv_2cv
7267
7268 Using various gambits, try to get a CV from an SV; in addition, try if
7269 possible to set C<*st> and C<*gvp> to the stash and GV associated with it.
7270 The flags in C<lref> are passed to sv_fetchsv.
7271
7272 =cut
7273 */
7274
7275 CV *
7276 Perl_sv_2cv(pTHX_ SV *sv, HV **st, GV **gvp, I32 lref)
7277 {
7278     dVAR;
7279     GV *gv = NULL;
7280     CV *cv = NULL;
7281
7282     if (!sv) {
7283         *st = NULL;
7284         *gvp = NULL;
7285         return NULL;
7286     }
7287     switch (SvTYPE(sv)) {
7288     case SVt_PVCV:
7289         *st = CvSTASH(sv);
7290         *gvp = NULL;
7291         return (CV*)sv;
7292     case SVt_PVHV:
7293     case SVt_PVAV:
7294         *st = NULL;
7295         *gvp = NULL;
7296         return NULL;
7297     case SVt_PVGV:
7298         gv = (GV*)sv;
7299         *gvp = gv;
7300         *st = GvESTASH(gv);
7301         goto fix_gv;
7302
7303     default:
7304         SvGETMAGIC(sv);
7305         if (SvROK(sv)) {
7306             SV * const *sp = &sv;       /* Used in tryAMAGICunDEREF macro. */
7307             tryAMAGICunDEREF(to_cv);
7308
7309             sv = SvRV(sv);
7310             if (SvTYPE(sv) == SVt_PVCV) {
7311                 cv = (CV*)sv;
7312                 *gvp = NULL;
7313                 *st = CvSTASH(cv);
7314                 return cv;
7315             }
7316             else if(isGV(sv))
7317                 gv = (GV*)sv;
7318             else
7319                 Perl_croak(aTHX_ "Not a subroutine reference");
7320         }
7321         else if (isGV(sv))
7322             gv = (GV*)sv;
7323         else
7324             gv = gv_fetchsv(sv, lref, SVt_PVCV);
7325         *gvp = gv;
7326         if (!gv) {
7327             *st = NULL;
7328             return NULL;
7329         }
7330         /* Some flags to gv_fetchsv mean don't really create the GV  */
7331         if (SvTYPE(gv) != SVt_PVGV) {
7332             *st = NULL;
7333             return NULL;
7334         }
7335         *st = GvESTASH(gv);
7336     fix_gv:
7337         if (lref && !GvCVu(gv)) {
7338             SV *tmpsv;
7339             ENTER;
7340             tmpsv = newSV(0);
7341             gv_efullname3(tmpsv, gv, NULL);
7342             /* XXX this is probably not what they think they're getting.
7343              * It has the same effect as "sub name;", i.e. just a forward
7344              * declaration! */
7345             newSUB(start_subparse(FALSE, 0),
7346                    newSVOP(OP_CONST, 0, tmpsv),
7347                    NULL, NULL);
7348             LEAVE;
7349             if (!GvCVu(gv))
7350                 Perl_croak(aTHX_ "Unable to create sub named \"%"SVf"\"",
7351                            sv);
7352         }
7353         return GvCVu(gv);
7354     }
7355 }
7356
7357 /*
7358 =for apidoc sv_true
7359
7360 Returns true if the SV has a true value by Perl's rules.
7361 Use the C<SvTRUE> macro instead, which may call C<sv_true()> or may
7362 instead use an in-line version.
7363
7364 =cut
7365 */
7366
7367 I32
7368 Perl_sv_true(pTHX_ register SV *sv)
7369 {
7370     if (!sv)
7371         return 0;
7372     if (SvPOK(sv)) {
7373         register const XPV* const tXpv = (XPV*)SvANY(sv);
7374         if (tXpv &&
7375                 (tXpv->xpv_cur > 1 ||
7376                 (tXpv->xpv_cur && *sv->sv_u.svu_pv != '0')))
7377             return 1;
7378         else
7379             return 0;
7380     }
7381     else {
7382         if (SvIOK(sv))
7383             return SvIVX(sv) != 0;
7384         else {
7385             if (SvNOK(sv))
7386                 return SvNVX(sv) != 0.0;
7387             else
7388                 return sv_2bool(sv);
7389         }
7390     }
7391 }
7392
7393 /*
7394 =for apidoc sv_pvn_force
7395
7396 Get a sensible string out of the SV somehow.
7397 A private implementation of the C<SvPV_force> macro for compilers which
7398 can't cope with complex macro expressions. Always use the macro instead.
7399
7400 =for apidoc sv_pvn_force_flags
7401
7402 Get a sensible string out of the SV somehow.
7403 If C<flags> has C<SV_GMAGIC> bit set, will C<mg_get> on C<sv> if
7404 appropriate, else not. C<sv_pvn_force> and C<sv_pvn_force_nomg> are
7405 implemented in terms of this function.
7406 You normally want to use the various wrapper macros instead: see
7407 C<SvPV_force> and C<SvPV_force_nomg>
7408
7409 =cut
7410 */
7411
7412 char *
7413 Perl_sv_pvn_force_flags(pTHX_ SV *sv, STRLEN *lp, I32 flags)
7414 {
7415     dVAR;
7416     if (SvTHINKFIRST(sv) && !SvROK(sv))
7417         sv_force_normal_flags(sv, 0);
7418
7419     if (SvPOK(sv)) {
7420         if (lp)
7421             *lp = SvCUR(sv);
7422     }
7423     else {
7424         char *s;
7425         STRLEN len;
7426  
7427         if (SvREADONLY(sv) && !(flags & SV_MUTABLE_RETURN)) {
7428             const char * const ref = sv_reftype(sv,0);
7429             if (PL_op)
7430                 Perl_croak(aTHX_ "Can't coerce readonly %s to string in %s",
7431                            ref, OP_NAME(PL_op));
7432             else
7433                 Perl_croak(aTHX_ "Can't coerce readonly %s to string", ref);
7434         }
7435         if (SvTYPE(sv) > SVt_PVLV && SvTYPE(sv) != SVt_PVFM)
7436             Perl_croak(aTHX_ "Can't coerce %s to string in %s", sv_reftype(sv,0),
7437                 OP_NAME(PL_op));
7438         s = sv_2pv_flags(sv, &len, flags);
7439         if (lp)
7440             *lp = len;
7441
7442         if (s != SvPVX_const(sv)) {     /* Almost, but not quite, sv_setpvn() */
7443             if (SvROK(sv))
7444                 sv_unref(sv);
7445             SvUPGRADE(sv, SVt_PV);              /* Never FALSE */
7446             SvGROW(sv, len + 1);
7447             Move(s,SvPVX(sv),len,char);
7448             SvCUR_set(sv, len);
7449             *SvEND(sv) = '\0';
7450         }
7451         if (!SvPOK(sv)) {
7452             SvPOK_on(sv);               /* validate pointer */
7453             SvTAINT(sv);
7454             DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2pv(%s)\n",
7455                                   PTR2UV(sv),SvPVX_const(sv)));
7456         }
7457     }
7458     return SvPVX_mutable(sv);
7459 }
7460
7461 /*
7462 =for apidoc sv_pvbyten_force
7463
7464 The backend for the C<SvPVbytex_force> macro. Always use the macro instead.
7465
7466 =cut
7467 */
7468
7469 char *
7470 Perl_sv_pvbyten_force(pTHX_ SV *sv, STRLEN *lp)
7471 {
7472     sv_pvn_force(sv,lp);
7473     sv_utf8_downgrade(sv,0);
7474     *lp = SvCUR(sv);
7475     return SvPVX(sv);
7476 }
7477
7478 /*
7479 =for apidoc sv_pvutf8n_force
7480
7481 The backend for the C<SvPVutf8x_force> macro. Always use the macro instead.
7482
7483 =cut
7484 */
7485
7486 char *
7487 Perl_sv_pvutf8n_force(pTHX_ SV *sv, STRLEN *lp)
7488 {
7489     sv_pvn_force(sv,lp);
7490     sv_utf8_upgrade(sv);
7491     *lp = SvCUR(sv);
7492     return SvPVX(sv);
7493 }
7494
7495 /*
7496 =for apidoc sv_reftype
7497
7498 Returns a string describing what the SV is a reference to.
7499
7500 =cut
7501 */
7502
7503 char *
7504 Perl_sv_reftype(pTHX_ const SV *sv, int ob)
7505 {
7506     /* The fact that I don't need to downcast to char * everywhere, only in ?:
7507        inside return suggests a const propagation bug in g++.  */
7508     if (ob && SvOBJECT(sv)) {
7509         char * const name = HvNAME_get(SvSTASH(sv));
7510         return name ? name : (char *) "__ANON__";
7511     }
7512     else {
7513         switch (SvTYPE(sv)) {
7514         case SVt_NULL:
7515         case SVt_IV:
7516         case SVt_NV:
7517         case SVt_RV:
7518         case SVt_PV:
7519         case SVt_PVIV:
7520         case SVt_PVNV:
7521         case SVt_PVMG:
7522         case SVt_PVBM:
7523                                 if (SvVOK(sv))
7524                                     return "VSTRING";
7525                                 if (SvROK(sv))
7526                                     return "REF";
7527                                 else
7528                                     return "SCALAR";
7529
7530         case SVt_PVLV:          return (char *)  (SvROK(sv) ? "REF"
7531                                 /* tied lvalues should appear to be
7532                                  * scalars for backwards compatitbility */
7533                                 : (LvTYPE(sv) == 't' || LvTYPE(sv) == 'T')
7534                                     ? "SCALAR" : "LVALUE");
7535         case SVt_PVAV:          return "ARRAY";
7536         case SVt_PVHV:          return "HASH";
7537         case SVt_PVCV:          return "CODE";
7538         case SVt_PVGV:          return "GLOB";
7539         case SVt_PVFM:          return "FORMAT";
7540         case SVt_PVIO:          return "IO";
7541         default:                return "UNKNOWN";
7542         }
7543     }
7544 }
7545
7546 /*
7547 =for apidoc sv_isobject
7548
7549 Returns a boolean indicating whether the SV is an RV pointing to a blessed
7550 object.  If the SV is not an RV, or if the object is not blessed, then this
7551 will return false.
7552
7553 =cut
7554 */
7555
7556 int
7557 Perl_sv_isobject(pTHX_ SV *sv)
7558 {
7559     if (!sv)
7560         return 0;
7561     SvGETMAGIC(sv);
7562     if (!SvROK(sv))
7563         return 0;
7564     sv = (SV*)SvRV(sv);
7565     if (!SvOBJECT(sv))
7566         return 0;
7567     return 1;
7568 }
7569
7570 /*
7571 =for apidoc sv_isa
7572
7573 Returns a boolean indicating whether the SV is blessed into the specified
7574 class.  This does not check for subtypes; use C<sv_derived_from> to verify
7575 an inheritance relationship.
7576
7577 =cut
7578 */
7579
7580 int
7581 Perl_sv_isa(pTHX_ SV *sv, const char *name)
7582 {
7583     const char *hvname;
7584     if (!sv)
7585         return 0;
7586     SvGETMAGIC(sv);
7587     if (!SvROK(sv))
7588         return 0;
7589     sv = (SV*)SvRV(sv);
7590     if (!SvOBJECT(sv))
7591         return 0;
7592     hvname = HvNAME_get(SvSTASH(sv));
7593     if (!hvname)
7594         return 0;
7595
7596     return strEQ(hvname, name);
7597 }
7598
7599 /*
7600 =for apidoc newSVrv
7601
7602 Creates a new SV for the RV, C<rv>, to point to.  If C<rv> is not an RV then
7603 it will be upgraded to one.  If C<classname> is non-null then the new SV will
7604 be blessed in the specified package.  The new SV is returned and its
7605 reference count is 1.
7606
7607 =cut
7608 */
7609
7610 SV*
7611 Perl_newSVrv(pTHX_ SV *rv, const char *classname)
7612 {
7613     dVAR;
7614     SV *sv;
7615
7616     new_SV(sv);
7617
7618     SV_CHECK_THINKFIRST_COW_DROP(rv);
7619     SvAMAGIC_off(rv);
7620
7621     if (SvTYPE(rv) >= SVt_PVMG) {
7622         const U32 refcnt = SvREFCNT(rv);
7623         SvREFCNT(rv) = 0;
7624         sv_clear(rv);
7625         SvFLAGS(rv) = 0;
7626         SvREFCNT(rv) = refcnt;
7627     }
7628
7629     if (SvTYPE(rv) < SVt_RV)
7630         sv_upgrade(rv, SVt_RV);
7631     else if (SvTYPE(rv) > SVt_RV) {
7632         SvPV_free(rv);
7633         SvCUR_set(rv, 0);
7634         SvLEN_set(rv, 0);
7635     }
7636
7637     SvOK_off(rv);
7638     SvRV_set(rv, sv);
7639     SvROK_on(rv);
7640
7641     if (classname) {
7642         HV* const stash = gv_stashpv(classname, TRUE);
7643         (void)sv_bless(rv, stash);
7644     }
7645     return sv;
7646 }
7647
7648 /*
7649 =for apidoc sv_setref_pv
7650
7651 Copies a pointer into a new SV, optionally blessing the SV.  The C<rv>
7652 argument will be upgraded to an RV.  That RV will be modified to point to
7653 the new SV.  If the C<pv> argument is NULL then C<PL_sv_undef> will be placed
7654 into the SV.  The C<classname> argument indicates the package for the
7655 blessing.  Set C<classname> to C<NULL> to avoid the blessing.  The new SV
7656 will have a reference count of 1, and the RV will be returned.
7657
7658 Do not use with other Perl types such as HV, AV, SV, CV, because those
7659 objects will become corrupted by the pointer copy process.
7660
7661 Note that C<sv_setref_pvn> copies the string while this copies the pointer.
7662
7663 =cut
7664 */
7665
7666 SV*
7667 Perl_sv_setref_pv(pTHX_ SV *rv, const char *classname, void *pv)
7668 {
7669     dVAR;
7670     if (!pv) {
7671         sv_setsv(rv, &PL_sv_undef);
7672         SvSETMAGIC(rv);
7673     }
7674     else
7675         sv_setiv(newSVrv(rv,classname), PTR2IV(pv));
7676     return rv;
7677 }
7678
7679 /*
7680 =for apidoc sv_setref_iv
7681
7682 Copies an integer into a new SV, optionally blessing the SV.  The C<rv>
7683 argument will be upgraded to an RV.  That RV will be modified to point to
7684 the new SV.  The C<classname> argument indicates the package for the
7685 blessing.  Set C<classname> to C<NULL> to avoid the blessing.  The new SV
7686 will have a reference count of 1, and the RV will be returned.
7687
7688 =cut
7689 */
7690
7691 SV*
7692 Perl_sv_setref_iv(pTHX_ SV *rv, const char *classname, IV iv)
7693 {
7694     sv_setiv(newSVrv(rv,classname), iv);
7695     return rv;
7696 }
7697
7698 /*
7699 =for apidoc sv_setref_uv
7700
7701 Copies an unsigned integer into a new SV, optionally blessing the SV.  The C<rv>
7702 argument will be upgraded to an RV.  That RV will be modified to point to
7703 the new SV.  The C<classname> argument indicates the package for the
7704 blessing.  Set C<classname> to C<NULL> to avoid the blessing.  The new SV
7705 will have a reference count of 1, and the RV will be returned.
7706
7707 =cut
7708 */
7709
7710 SV*
7711 Perl_sv_setref_uv(pTHX_ SV *rv, const char *classname, UV uv)
7712 {
7713     sv_setuv(newSVrv(rv,classname), uv);
7714     return rv;
7715 }
7716
7717 /*
7718 =for apidoc sv_setref_nv
7719
7720 Copies a double into a new SV, optionally blessing the SV.  The C<rv>
7721 argument will be upgraded to an RV.  That RV will be modified to point to
7722 the new SV.  The C<classname> argument indicates the package for the
7723 blessing.  Set C<classname> to C<NULL> to avoid the blessing.  The new SV
7724 will have a reference count of 1, and the RV will be returned.
7725
7726 =cut
7727 */
7728
7729 SV*
7730 Perl_sv_setref_nv(pTHX_ SV *rv, const char *classname, NV nv)
7731 {
7732     sv_setnv(newSVrv(rv,classname), nv);
7733     return rv;
7734 }
7735
7736 /*
7737 =for apidoc sv_setref_pvn
7738
7739 Copies a string into a new SV, optionally blessing the SV.  The length of the
7740 string must be specified with C<n>.  The C<rv> argument will be upgraded to
7741 an RV.  That RV will be modified to point to the new SV.  The C<classname>
7742 argument indicates the package for the blessing.  Set C<classname> to
7743 C<NULL> to avoid the blessing.  The new SV will have a reference count
7744 of 1, and the RV will be returned.
7745
7746 Note that C<sv_setref_pv> copies the pointer while this copies the string.
7747
7748 =cut
7749 */
7750
7751 SV*
7752 Perl_sv_setref_pvn(pTHX_ SV *rv, const char *classname, const char *pv, STRLEN n)
7753 {
7754     sv_setpvn(newSVrv(rv,classname), pv, n);
7755     return rv;
7756 }
7757
7758 /*
7759 =for apidoc sv_bless
7760
7761 Blesses an SV into a specified package.  The SV must be an RV.  The package
7762 must be designated by its stash (see C<gv_stashpv()>).  The reference count
7763 of the SV is unaffected.
7764
7765 =cut
7766 */
7767
7768 SV*
7769 Perl_sv_bless(pTHX_ SV *sv, HV *stash)
7770 {
7771     dVAR;
7772     SV *tmpRef;
7773     if (!SvROK(sv))
7774         Perl_croak(aTHX_ "Can't bless non-reference value");
7775     tmpRef = SvRV(sv);
7776     if (SvFLAGS(tmpRef) & (SVs_OBJECT|SVf_READONLY)) {
7777         if (SvREADONLY(tmpRef))
7778             Perl_croak(aTHX_ PL_no_modify);
7779         if (SvOBJECT(tmpRef)) {
7780             if (SvTYPE(tmpRef) != SVt_PVIO)
7781                 --PL_sv_objcount;
7782             SvREFCNT_dec(SvSTASH(tmpRef));
7783         }
7784     }
7785     SvOBJECT_on(tmpRef);
7786     if (SvTYPE(tmpRef) != SVt_PVIO)
7787         ++PL_sv_objcount;
7788     SvUPGRADE(tmpRef, SVt_PVMG);
7789     SvSTASH_set(tmpRef, (HV*)SvREFCNT_inc_simple(stash));
7790
7791     if (Gv_AMG(stash))
7792         SvAMAGIC_on(sv);
7793     else
7794         SvAMAGIC_off(sv);
7795
7796     if(SvSMAGICAL(tmpRef))
7797         if(mg_find(tmpRef, PERL_MAGIC_ext) || mg_find(tmpRef, PERL_MAGIC_uvar))
7798             mg_set(tmpRef);
7799
7800
7801
7802     return sv;
7803 }
7804
7805 /* Downgrades a PVGV to a PVMG.
7806  */
7807
7808 STATIC void
7809 S_sv_unglob(pTHX_ SV *sv)
7810 {
7811     dVAR;
7812     void *xpvmg;
7813     SV * const temp = sv_newmortal();
7814
7815     assert(SvTYPE(sv) == SVt_PVGV);
7816     SvFAKE_off(sv);
7817     gv_efullname3(temp, (GV *) sv, "*");
7818
7819     if (GvGP(sv)) {
7820         gp_free((GV*)sv);
7821     }
7822     if (GvSTASH(sv)) {
7823         sv_del_backref((SV*)GvSTASH(sv), sv);
7824         GvSTASH(sv) = NULL;
7825     }
7826     GvMULTI_off(sv);
7827     if (GvNAME_HEK(sv)) {
7828         unshare_hek(GvNAME_HEK(sv));
7829     }
7830     SvSCREAM_off(sv);
7831
7832     /* need to keep SvANY(sv) in the right arena */
7833     xpvmg = new_XPVMG();
7834     StructCopy(SvANY(sv), xpvmg, XPVMG);
7835     del_XPVGV(SvANY(sv));
7836     SvANY(sv) = xpvmg;
7837
7838     SvFLAGS(sv) &= ~SVTYPEMASK;
7839     SvFLAGS(sv) |= SVt_PVMG;
7840
7841     /* Intentionally not calling any local SET magic, as this isn't so much a
7842        set operation as merely an internal storage change.  */
7843     sv_setsv_flags(sv, temp, 0);
7844 }
7845
7846 /*
7847 =for apidoc sv_unref_flags
7848
7849 Unsets the RV status of the SV, and decrements the reference count of
7850 whatever was being referenced by the RV.  This can almost be thought of
7851 as a reversal of C<newSVrv>.  The C<cflags> argument can contain
7852 C<SV_IMMEDIATE_UNREF> to force the reference count to be decremented
7853 (otherwise the decrementing is conditional on the reference count being
7854 different from one or the reference being a readonly SV).
7855 See C<SvROK_off>.
7856
7857 =cut
7858 */
7859
7860 void
7861 Perl_sv_unref_flags(pTHX_ SV *ref, U32 flags)
7862 {
7863     SV* const target = SvRV(ref);
7864
7865     if (SvWEAKREF(ref)) {
7866         sv_del_backref(target, ref);
7867         SvWEAKREF_off(ref);
7868         SvRV_set(ref, NULL);
7869         return;
7870     }
7871     SvRV_set(ref, NULL);
7872     SvROK_off(ref);
7873     /* You can't have a || SvREADONLY(target) here, as $a = $$a, where $a was
7874        assigned to as BEGIN {$a = \"Foo"} will fail.  */
7875     if (SvREFCNT(target) != 1 || (flags & SV_IMMEDIATE_UNREF))
7876         SvREFCNT_dec(target);
7877     else /* XXX Hack, but hard to make $a=$a->[1] work otherwise */
7878         sv_2mortal(target);     /* Schedule for freeing later */
7879 }
7880
7881 /*
7882 =for apidoc sv_untaint
7883
7884 Untaint an SV. Use C<SvTAINTED_off> instead.
7885 =cut
7886 */
7887
7888 void
7889 Perl_sv_untaint(pTHX_ SV *sv)
7890 {
7891     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv)) {
7892         MAGIC * const mg = mg_find(sv, PERL_MAGIC_taint);
7893         if (mg)
7894             mg->mg_len &= ~1;
7895     }
7896 }
7897
7898 /*
7899 =for apidoc sv_tainted
7900
7901 Test an SV for taintedness. Use C<SvTAINTED> instead.
7902 =cut
7903 */
7904
7905 bool
7906 Perl_sv_tainted(pTHX_ SV *sv)
7907 {
7908     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv)) {
7909         const MAGIC * const mg = mg_find(sv, PERL_MAGIC_taint);
7910         if (mg && (mg->mg_len & 1) )
7911             return TRUE;
7912     }
7913     return FALSE;
7914 }
7915
7916 /*
7917 =for apidoc sv_setpviv
7918
7919 Copies an integer into the given SV, also updating its string value.
7920 Does not handle 'set' magic.  See C<sv_setpviv_mg>.
7921
7922 =cut
7923 */
7924
7925 void
7926 Perl_sv_setpviv(pTHX_ SV *sv, IV iv)
7927 {
7928     char buf[TYPE_CHARS(UV)];
7929     char *ebuf;
7930     char * const ptr = uiv_2buf(buf, iv, 0, 0, &ebuf);
7931
7932     sv_setpvn(sv, ptr, ebuf - ptr);
7933 }
7934
7935 /*
7936 =for apidoc sv_setpviv_mg
7937
7938 Like C<sv_setpviv>, but also handles 'set' magic.
7939
7940 =cut
7941 */
7942
7943 void
7944 Perl_sv_setpviv_mg(pTHX_ SV *sv, IV iv)
7945 {
7946     sv_setpviv(sv, iv);
7947     SvSETMAGIC(sv);
7948 }
7949
7950 #if defined(PERL_IMPLICIT_CONTEXT)
7951
7952 /* pTHX_ magic can't cope with varargs, so this is a no-context
7953  * version of the main function, (which may itself be aliased to us).
7954  * Don't access this version directly.
7955  */
7956
7957 void
7958 Perl_sv_setpvf_nocontext(SV *sv, const char* pat, ...)
7959 {
7960     dTHX;
7961     va_list args;
7962     va_start(args, pat);
7963     sv_vsetpvf(sv, pat, &args);
7964     va_end(args);
7965 }
7966
7967 /* pTHX_ magic can't cope with varargs, so this is a no-context
7968  * version of the main function, (which may itself be aliased to us).
7969  * Don't access this version directly.
7970  */
7971
7972 void
7973 Perl_sv_setpvf_mg_nocontext(SV *sv, const char* pat, ...)
7974 {
7975     dTHX;
7976     va_list args;
7977     va_start(args, pat);
7978     sv_vsetpvf_mg(sv, pat, &args);
7979     va_end(args);
7980 }
7981 #endif
7982
7983 /*
7984 =for apidoc sv_setpvf
7985
7986 Works like C<sv_catpvf> but copies the text into the SV instead of
7987 appending it.  Does not handle 'set' magic.  See C<sv_setpvf_mg>.
7988
7989 =cut
7990 */
7991
7992 void
7993 Perl_sv_setpvf(pTHX_ SV *sv, const char* pat, ...)
7994 {
7995     va_list args;
7996     va_start(args, pat);
7997     sv_vsetpvf(sv, pat, &args);
7998     va_end(args);
7999 }
8000
8001 /*
8002 =for apidoc sv_vsetpvf
8003
8004 Works like C<sv_vcatpvf> but copies the text into the SV instead of
8005 appending it.  Does not handle 'set' magic.  See C<sv_vsetpvf_mg>.
8006
8007 Usually used via its frontend C<sv_setpvf>.
8008
8009 =cut
8010 */
8011
8012 void
8013 Perl_sv_vsetpvf(pTHX_ SV *sv, const char* pat, va_list* args)
8014 {
8015     sv_vsetpvfn(sv, pat, strlen(pat), args, NULL, 0, NULL);
8016 }
8017
8018 /*
8019 =for apidoc sv_setpvf_mg
8020
8021 Like C<sv_setpvf>, but also handles 'set' magic.
8022
8023 =cut
8024 */
8025
8026 void
8027 Perl_sv_setpvf_mg(pTHX_ SV *sv, const char* pat, ...)
8028 {
8029     va_list args;
8030     va_start(args, pat);
8031     sv_vsetpvf_mg(sv, pat, &args);
8032     va_end(args);
8033 }
8034
8035 /*
8036 =for apidoc sv_vsetpvf_mg
8037
8038 Like C<sv_vsetpvf>, but also handles 'set' magic.
8039
8040 Usually used via its frontend C<sv_setpvf_mg>.
8041
8042 =cut
8043 */
8044
8045 void
8046 Perl_sv_vsetpvf_mg(pTHX_ SV *sv, const char* pat, va_list* args)
8047 {
8048     sv_vsetpvfn(sv, pat, strlen(pat), args, NULL, 0, NULL);
8049     SvSETMAGIC(sv);
8050 }
8051
8052 #if defined(PERL_IMPLICIT_CONTEXT)
8053
8054 /* pTHX_ magic can't cope with varargs, so this is a no-context
8055  * version of the main function, (which may itself be aliased to us).
8056  * Don't access this version directly.
8057  */
8058
8059 void
8060 Perl_sv_catpvf_nocontext(SV *sv, const char* pat, ...)
8061 {
8062     dTHX;
8063     va_list args;
8064     va_start(args, pat);
8065     sv_vcatpvf(sv, pat, &args);
8066     va_end(args);
8067 }
8068
8069 /* pTHX_ magic can't cope with varargs, so this is a no-context
8070  * version of the main function, (which may itself be aliased to us).
8071  * Don't access this version directly.
8072  */
8073
8074 void
8075 Perl_sv_catpvf_mg_nocontext(SV *sv, const char* pat, ...)
8076 {
8077     dTHX;
8078     va_list args;
8079     va_start(args, pat);
8080     sv_vcatpvf_mg(sv, pat, &args);
8081     va_end(args);
8082 }
8083 #endif
8084
8085 /*
8086 =for apidoc sv_catpvf
8087
8088 Processes its arguments like C<sprintf> and appends the formatted
8089 output to an SV.  If the appended data contains "wide" characters
8090 (including, but not limited to, SVs with a UTF-8 PV formatted with %s,
8091 and characters >255 formatted with %c), the original SV might get
8092 upgraded to UTF-8.  Handles 'get' magic, but not 'set' magic.  See
8093 C<sv_catpvf_mg>. If the original SV was UTF-8, the pattern should be
8094 valid UTF-8; if the original SV was bytes, the pattern should be too.
8095
8096 =cut */
8097
8098 void
8099 Perl_sv_catpvf(pTHX_ SV *sv, const char* pat, ...)
8100 {
8101     va_list args;
8102     va_start(args, pat);
8103     sv_vcatpvf(sv, pat, &args);
8104     va_end(args);
8105 }
8106
8107 /*
8108 =for apidoc sv_vcatpvf
8109
8110 Processes its arguments like C<vsprintf> and appends the formatted output
8111 to an SV.  Does not handle 'set' magic.  See C<sv_vcatpvf_mg>.
8112
8113 Usually used via its frontend C<sv_catpvf>.
8114
8115 =cut
8116 */
8117
8118 void
8119 Perl_sv_vcatpvf(pTHX_ SV *sv, const char* pat, va_list* args)
8120 {
8121     sv_vcatpvfn(sv, pat, strlen(pat), args, NULL, 0, NULL);
8122 }
8123
8124 /*
8125 =for apidoc sv_catpvf_mg
8126
8127 Like C<sv_catpvf>, but also handles 'set' magic.
8128
8129 =cut
8130 */
8131
8132 void
8133 Perl_sv_catpvf_mg(pTHX_ SV *sv, const char* pat, ...)
8134 {
8135     va_list args;
8136     va_start(args, pat);
8137     sv_vcatpvf_mg(sv, pat, &args);
8138     va_end(args);
8139 }
8140
8141 /*
8142 =for apidoc sv_vcatpvf_mg
8143
8144 Like C<sv_vcatpvf>, but also handles 'set' magic.
8145
8146 Usually used via its frontend C<sv_catpvf_mg>.
8147
8148 =cut
8149 */
8150
8151 void
8152 Perl_sv_vcatpvf_mg(pTHX_ SV *sv, const char* pat, va_list* args)
8153 {
8154     sv_vcatpvfn(sv, pat, strlen(pat), args, NULL, 0, NULL);
8155     SvSETMAGIC(sv);
8156 }
8157
8158 /*
8159 =for apidoc sv_vsetpvfn
8160
8161 Works like C<sv_vcatpvfn> but copies the text into the SV instead of
8162 appending it.
8163
8164 Usually used via one of its frontends C<sv_vsetpvf> and C<sv_vsetpvf_mg>.
8165
8166 =cut
8167 */
8168
8169 void
8170 Perl_sv_vsetpvfn(pTHX_ SV *sv, const char *pat, STRLEN patlen, va_list *args, SV **svargs, I32 svmax, bool *maybe_tainted)
8171 {
8172     sv_setpvn(sv, "", 0);
8173     sv_vcatpvfn(sv, pat, patlen, args, svargs, svmax, maybe_tainted);
8174 }
8175
8176 STATIC I32
8177 S_expect_number(pTHX_ char** pattern)
8178 {
8179     dVAR;
8180     I32 var = 0;
8181     switch (**pattern) {
8182     case '1': case '2': case '3':
8183     case '4': case '5': case '6':
8184     case '7': case '8': case '9':
8185         var = *(*pattern)++ - '0';
8186         while (isDIGIT(**pattern)) {
8187             const I32 tmp = var * 10 + (*(*pattern)++ - '0');
8188             if (tmp < var)
8189                 Perl_croak(aTHX_ "Integer overflow in format string for %s", (PL_op ? OP_NAME(PL_op) : "sv_vcatpvfn"));
8190             var = tmp;
8191         }
8192     }
8193     return var;
8194 }
8195
8196 STATIC char *
8197 S_F0convert(NV nv, char *endbuf, STRLEN *len)
8198 {
8199     const int neg = nv < 0;
8200     UV uv;
8201
8202     if (neg)
8203         nv = -nv;
8204     if (nv < UV_MAX) {
8205         char *p = endbuf;
8206         nv += 0.5;
8207         uv = (UV)nv;
8208         if (uv & 1 && uv == nv)
8209             uv--;                       /* Round to even */
8210         do {
8211             const unsigned dig = uv % 10;
8212             *--p = '0' + dig;
8213         } while (uv /= 10);
8214         if (neg)
8215             *--p = '-';
8216         *len = endbuf - p;
8217         return p;
8218     }
8219     return NULL;
8220 }
8221
8222
8223 /*
8224 =for apidoc sv_vcatpvfn
8225
8226 Processes its arguments like C<vsprintf> and appends the formatted output
8227 to an SV.  Uses an array of SVs if the C style variable argument list is
8228 missing (NULL).  When running with taint checks enabled, indicates via
8229 C<maybe_tainted> if results are untrustworthy (often due to the use of
8230 locales).
8231
8232 Usually used via one of its frontends C<sv_vcatpvf> and C<sv_vcatpvf_mg>.
8233
8234 =cut
8235 */
8236
8237
8238 #define VECTORIZE_ARGS  vecsv = va_arg(*args, SV*);\
8239                         vecstr = (U8*)SvPV_const(vecsv,veclen);\
8240                         vec_utf8 = DO_UTF8(vecsv);
8241
8242 /* XXX maybe_tainted is never assigned to, so the doc above is lying. */
8243
8244 void
8245 Perl_sv_vcatpvfn(pTHX_ SV *sv, const char *pat, STRLEN patlen, va_list *args, SV **svargs, I32 svmax, bool *maybe_tainted)
8246 {
8247     dVAR;
8248     char *p;
8249     char *q;
8250     const char *patend;
8251     STRLEN origlen;
8252     I32 svix = 0;
8253     static const char nullstr[] = "(null)";
8254     SV *argsv = NULL;
8255     bool has_utf8 = DO_UTF8(sv);    /* has the result utf8? */
8256     const bool pat_utf8 = has_utf8; /* the pattern is in utf8? */
8257     SV *nsv = NULL;
8258     /* Times 4: a decimal digit takes more than 3 binary digits.
8259      * NV_DIG: mantissa takes than many decimal digits.
8260      * Plus 32: Playing safe. */
8261     char ebuf[IV_DIG * 4 + NV_DIG + 32];
8262     /* large enough for "%#.#f" --chip */
8263     /* what about long double NVs? --jhi */
8264
8265     PERL_UNUSED_ARG(maybe_tainted);
8266
8267     /* no matter what, this is a string now */
8268     (void)SvPV_force(sv, origlen);
8269
8270     /* special-case "", "%s", and "%-p" (SVf - see below) */
8271     if (patlen == 0)
8272         return;
8273     if (patlen == 2 && pat[0] == '%' && pat[1] == 's') {
8274         if (args) {
8275             const char * const s = va_arg(*args, char*);
8276             sv_catpv(sv, s ? s : nullstr);
8277         }
8278         else if (svix < svmax) {
8279             sv_catsv(sv, *svargs);
8280         }
8281         return;
8282     }
8283     if (args && patlen == 3 && pat[0] == '%' &&
8284                 pat[1] == '-' && pat[2] == 'p') {
8285         argsv = va_arg(*args, SV*);
8286         sv_catsv(sv, argsv);
8287         return;
8288     }
8289
8290 #ifndef USE_LONG_DOUBLE
8291     /* special-case "%.<number>[gf]" */
8292     if ( !args && patlen <= 5 && pat[0] == '%' && pat[1] == '.'
8293          && (pat[patlen-1] == 'g' || pat[patlen-1] == 'f') ) {
8294         unsigned digits = 0;
8295         const char *pp;
8296
8297         pp = pat + 2;
8298         while (*pp >= '0' && *pp <= '9')
8299             digits = 10 * digits + (*pp++ - '0');
8300         if (pp - pat == (int)patlen - 1) {
8301             NV nv;
8302
8303             if (svix < svmax)
8304                 nv = SvNV(*svargs);
8305             else
8306                 return;
8307             if (*pp == 'g') {
8308                 /* Add check for digits != 0 because it seems that some
8309                    gconverts are buggy in this case, and we don't yet have
8310                    a Configure test for this.  */
8311                 if (digits && digits < sizeof(ebuf) - NV_DIG - 10) {
8312                      /* 0, point, slack */
8313                     Gconvert(nv, (int)digits, 0, ebuf);
8314                     sv_catpv(sv, ebuf);
8315                     if (*ebuf)  /* May return an empty string for digits==0 */
8316                         return;
8317                 }
8318             } else if (!digits) {
8319                 STRLEN l;
8320
8321                 if ((p = F0convert(nv, ebuf + sizeof ebuf, &l))) {
8322                     sv_catpvn(sv, p, l);
8323                     return;
8324                 }
8325             }
8326         }
8327     }
8328 #endif /* !USE_LONG_DOUBLE */
8329
8330     if (!args && svix < svmax && DO_UTF8(*svargs))
8331         has_utf8 = TRUE;
8332
8333     patend = (char*)pat + patlen;
8334     for (p = (char*)pat; p < patend; p = q) {
8335         bool alt = FALSE;
8336         bool left = FALSE;
8337         bool vectorize = FALSE;
8338         bool vectorarg = FALSE;
8339         bool vec_utf8 = FALSE;
8340         char fill = ' ';
8341         char plus = 0;
8342         char intsize = 0;
8343         STRLEN width = 0;
8344         STRLEN zeros = 0;
8345         bool has_precis = FALSE;
8346         STRLEN precis = 0;
8347         const I32 osvix = svix;
8348         bool is_utf8 = FALSE;  /* is this item utf8?   */
8349 #ifdef HAS_LDBL_SPRINTF_BUG
8350         /* This is to try to fix a bug with irix/nonstop-ux/powerux and
8351            with sfio - Allen <allens@cpan.org> */
8352         bool fix_ldbl_sprintf_bug = FALSE;
8353 #endif
8354
8355         char esignbuf[4];
8356         U8 utf8buf[UTF8_MAXBYTES+1];
8357         STRLEN esignlen = 0;
8358
8359         const char *eptr = NULL;
8360         STRLEN elen = 0;
8361         SV *vecsv = NULL;
8362         const U8 *vecstr = NULL;
8363         STRLEN veclen = 0;
8364         char c = 0;
8365         int i;
8366         unsigned base = 0;
8367         IV iv = 0;
8368         UV uv = 0;
8369         /* we need a long double target in case HAS_LONG_DOUBLE but
8370            not USE_LONG_DOUBLE
8371         */
8372 #if defined(HAS_LONG_DOUBLE) && LONG_DOUBLESIZE > DOUBLESIZE
8373         long double nv;
8374 #else
8375         NV nv;
8376 #endif
8377         STRLEN have;
8378         STRLEN need;
8379         STRLEN gap;
8380         const char *dotstr = ".";
8381         STRLEN dotstrlen = 1;
8382         I32 efix = 0; /* explicit format parameter index */
8383         I32 ewix = 0; /* explicit width index */
8384         I32 epix = 0; /* explicit precision index */
8385         I32 evix = 0; /* explicit vector index */
8386         bool asterisk = FALSE;
8387
8388         /* echo everything up to the next format specification */
8389         for (q = p; q < patend && *q != '%'; ++q) ;
8390         if (q > p) {
8391             if (has_utf8 && !pat_utf8)
8392                 sv_catpvn_utf8_upgrade(sv, p, q - p, nsv);
8393             else
8394                 sv_catpvn(sv, p, q - p);
8395             p = q;
8396         }
8397         if (q++ >= patend)
8398             break;
8399
8400 /*
8401     We allow format specification elements in this order:
8402         \d+\$              explicit format parameter index
8403         [-+ 0#]+           flags
8404         v|\*(\d+\$)?v      vector with optional (optionally specified) arg
8405         0                  flag (as above): repeated to allow "v02"     
8406         \d+|\*(\d+\$)?     width using optional (optionally specified) arg
8407         \.(\d*|\*(\d+\$)?) precision using optional (optionally specified) arg
8408         [hlqLV]            size
8409     [%bcdefginopsuxDFOUX] format (mandatory)
8410 */
8411
8412         if (args) {
8413 /*  
8414         As of perl5.9.3, printf format checking is on by default.
8415         Internally, perl uses %p formats to provide an escape to
8416         some extended formatting.  This block deals with those
8417         extensions: if it does not match, (char*)q is reset and
8418         the normal format processing code is used.
8419
8420         Currently defined extensions are:
8421                 %p              include pointer address (standard)      
8422                 %-p     (SVf)   include an SV (previously %_)
8423                 %-<num>p        include an SV with precision <num>      
8424                 %1p     (VDf)   include a v-string (as %vd)
8425                 %<num>p         reserved for future extensions
8426
8427         Robin Barker 2005-07-14
8428 */
8429             char* r = q; 
8430             bool sv = FALSE;    
8431             STRLEN n = 0;
8432             if (*q == '-')
8433                 sv = *q++;
8434             n = expect_number(&q);
8435             if (*q++ == 'p') {
8436                 if (sv) {                       /* SVf */
8437                     if (n) {
8438                         precis = n;
8439                         has_precis = TRUE;
8440                     }
8441                     argsv = va_arg(*args, SV*);
8442                     eptr = SvPVx_const(argsv, elen);
8443                     if (DO_UTF8(argsv))
8444                         is_utf8 = TRUE;
8445                     goto string;
8446                 }
8447 #if vdNUMBER
8448                 else if (n == vdNUMBER) {       /* VDf */
8449                     vectorize = TRUE;
8450                     VECTORIZE_ARGS
8451                     goto format_vd;
8452                 }
8453 #endif
8454                 else if (n) {
8455                     if (ckWARN_d(WARN_INTERNAL))
8456                         Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
8457                         "internal %%<num>p might conflict with future printf extensions");
8458                 }
8459             }
8460             q = r; 
8461         }
8462
8463         if ( (width = expect_number(&q)) ) {
8464             if (*q == '$') {
8465                 ++q;
8466                 efix = width;
8467             } else {
8468                 goto gotwidth;
8469             }
8470         }
8471
8472         /* FLAGS */
8473
8474         while (*q) {
8475             switch (*q) {
8476             case ' ':
8477             case '+':
8478                 plus = *q++;
8479                 continue;
8480
8481             case '-':
8482                 left = TRUE;
8483                 q++;
8484                 continue;
8485
8486             case '0':
8487                 fill = *q++;
8488                 continue;
8489
8490             case '#':
8491                 alt = TRUE;
8492                 q++;
8493                 continue;
8494
8495             default:
8496                 break;
8497             }
8498             break;
8499         }
8500
8501       tryasterisk:
8502         if (*q == '*') {
8503             q++;
8504             if ( (ewix = expect_number(&q)) )
8505                 if (*q++ != '$')
8506                     goto unknown;
8507             asterisk = TRUE;
8508         }
8509         if (*q == 'v') {
8510             q++;
8511             if (vectorize)
8512                 goto unknown;
8513             if ((vectorarg = asterisk)) {
8514                 evix = ewix;
8515                 ewix = 0;
8516                 asterisk = FALSE;
8517             }
8518             vectorize = TRUE;
8519             goto tryasterisk;
8520         }
8521
8522         if (!asterisk)
8523         {
8524             if( *q == '0' )
8525                 fill = *q++;
8526             width = expect_number(&q);
8527         }
8528
8529         if (vectorize) {
8530             if (vectorarg) {
8531                 if (args)
8532                     vecsv = va_arg(*args, SV*);
8533                 else if (evix) {
8534                     vecsv = (evix > 0 && evix <= svmax)
8535                         ? svargs[evix-1] : &PL_sv_undef;
8536                 } else {
8537                     vecsv = svix < svmax ? svargs[svix++] : &PL_sv_undef;
8538                 }
8539                 dotstr = SvPV_const(vecsv, dotstrlen);
8540                 /* Keep the DO_UTF8 test *after* the SvPV call, else things go
8541                    bad with tied or overloaded values that return UTF8.  */
8542                 if (DO_UTF8(vecsv))
8543                     is_utf8 = TRUE;
8544                 else if (has_utf8) {
8545                     vecsv = sv_mortalcopy(vecsv);
8546                     sv_utf8_upgrade(vecsv);
8547                     dotstr = SvPV_const(vecsv, dotstrlen);
8548                     is_utf8 = TRUE;
8549                 }                   
8550             }
8551             if (args) {
8552                 VECTORIZE_ARGS
8553             }
8554             else if (efix ? (efix > 0 && efix <= svmax) : svix < svmax) {
8555                 vecsv = svargs[efix ? efix-1 : svix++];
8556                 vecstr = (U8*)SvPV_const(vecsv,veclen);
8557                 vec_utf8 = DO_UTF8(vecsv);
8558
8559                 /* if this is a version object, we need to convert
8560                  * back into v-string notation and then let the
8561                  * vectorize happen normally
8562                  */
8563                 if (sv_derived_from(vecsv, "version")) {
8564                     char *version = savesvpv(vecsv);
8565                     if ( hv_exists((HV*)SvRV(vecsv), "alpha", 5 ) ) {
8566                         Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
8567                         "vector argument not supported with alpha versions");
8568                         goto unknown;
8569                     }
8570                     vecsv = sv_newmortal();
8571                     /* scan_vstring is expected to be called during
8572                      * tokenization, so we need to fake up the end
8573                      * of the buffer for it
8574                      */
8575                     PL_bufend = version + veclen;
8576                     scan_vstring(version, vecsv);
8577                     vecstr = (U8*)SvPV_const(vecsv, veclen);
8578                     vec_utf8 = DO_UTF8(vecsv);
8579                     Safefree(version);
8580                 }
8581             }
8582             else {
8583                 vecstr = (U8*)"";
8584                 veclen = 0;
8585             }
8586         }
8587
8588         if (asterisk) {
8589             if (args)
8590                 i = va_arg(*args, int);
8591             else
8592                 i = (ewix ? ewix <= svmax : svix < svmax) ?
8593                     SvIVx(svargs[ewix ? ewix-1 : svix++]) : 0;
8594             left |= (i < 0);
8595             width = (i < 0) ? -i : i;
8596         }
8597       gotwidth:
8598
8599         /* PRECISION */
8600
8601         if (*q == '.') {
8602             q++;
8603             if (*q == '*') {
8604                 q++;
8605                 if ( ((epix = expect_number(&q))) && (*q++ != '$') )
8606                     goto unknown;
8607                 /* XXX: todo, support specified precision parameter */
8608                 if (epix)
8609                     goto unknown;
8610                 if (args)
8611                     i = va_arg(*args, int);
8612                 else
8613                     i = (ewix ? ewix <= svmax : svix < svmax)
8614                         ? SvIVx(svargs[ewix ? ewix-1 : svix++]) : 0;
8615                 precis = (i < 0) ? 0 : i;
8616             }
8617             else {
8618                 precis = 0;
8619                 while (isDIGIT(*q))
8620                     precis = precis * 10 + (*q++ - '0');
8621             }
8622             has_precis = TRUE;
8623         }
8624
8625         /* SIZE */
8626
8627         switch (*q) {
8628 #ifdef WIN32
8629         case 'I':                       /* Ix, I32x, and I64x */
8630 #  ifdef WIN64
8631             if (q[1] == '6' && q[2] == '4') {
8632                 q += 3;
8633                 intsize = 'q';
8634                 break;
8635             }
8636 #  endif
8637             if (q[1] == '3' && q[2] == '2') {
8638                 q += 3;
8639                 break;
8640             }
8641 #  ifdef WIN64
8642             intsize = 'q';
8643 #  endif
8644             q++;
8645             break;
8646 #endif
8647 #if defined(HAS_QUAD) || defined(HAS_LONG_DOUBLE)
8648         case 'L':                       /* Ld */
8649             /*FALLTHROUGH*/
8650 #ifdef HAS_QUAD
8651         case 'q':                       /* qd */
8652 #endif
8653             intsize = 'q';
8654             q++;
8655             break;
8656 #endif
8657         case 'l':
8658 #if defined(HAS_QUAD) || defined(HAS_LONG_DOUBLE)
8659             if (*(q + 1) == 'l') {      /* lld, llf */
8660                 intsize = 'q';
8661                 q += 2;
8662                 break;
8663              }
8664 #endif
8665             /*FALLTHROUGH*/
8666         case 'h':
8667             /*FALLTHROUGH*/
8668         case 'V':
8669             intsize = *q++;
8670             break;
8671         }
8672
8673         /* CONVERSION */
8674
8675         if (*q == '%') {
8676             eptr = q++;
8677             elen = 1;
8678             if (vectorize) {
8679                 c = '%';
8680                 goto unknown;
8681             }
8682             goto string;
8683         }
8684
8685         if (!vectorize && !args) {
8686             if (efix) {
8687                 const I32 i = efix-1;
8688                 argsv = (i >= 0 && i < svmax) ? svargs[i] : &PL_sv_undef;
8689             } else {
8690                 argsv = (svix >= 0 && svix < svmax)
8691                     ? svargs[svix++] : &PL_sv_undef;
8692             }
8693         }
8694
8695         switch (c = *q++) {
8696
8697             /* STRINGS */
8698
8699         case 'c':
8700             if (vectorize)
8701                 goto unknown;
8702             uv = (args) ? va_arg(*args, int) : SvIVx(argsv);
8703             if ((uv > 255 ||
8704                  (!UNI_IS_INVARIANT(uv) && SvUTF8(sv)))
8705                 && !IN_BYTES) {
8706                 eptr = (char*)utf8buf;
8707                 elen = uvchr_to_utf8((U8*)eptr, uv) - utf8buf;
8708                 is_utf8 = TRUE;
8709             }
8710             else {
8711                 c = (char)uv;
8712                 eptr = &c;
8713                 elen = 1;
8714             }
8715             goto string;
8716
8717         case 's':
8718             if (vectorize)
8719                 goto unknown;
8720             if (args) {
8721                 eptr = va_arg(*args, char*);
8722                 if (eptr)
8723 #ifdef MACOS_TRADITIONAL
8724                   /* On MacOS, %#s format is used for Pascal strings */
8725                   if (alt)
8726                     elen = *eptr++;
8727                   else
8728 #endif
8729                     elen = strlen(eptr);
8730                 else {
8731                     eptr = (char *)nullstr;
8732                     elen = sizeof nullstr - 1;
8733                 }
8734             }
8735             else {
8736                 eptr = SvPVx_const(argsv, elen);
8737                 if (DO_UTF8(argsv)) {
8738                     if (has_precis && precis < elen) {
8739                         I32 p = precis;
8740                         sv_pos_u2b(argsv, &p, 0); /* sticks at end */
8741                         precis = p;
8742                     }
8743                     if (width) { /* fudge width (can't fudge elen) */
8744                         width += elen - sv_len_utf8(argsv);
8745                     }
8746                     is_utf8 = TRUE;
8747                 }
8748             }
8749
8750         string:
8751             if (has_precis && elen > precis)
8752                 elen = precis;
8753             break;
8754
8755             /* INTEGERS */
8756
8757         case 'p':
8758             if (alt || vectorize)
8759                 goto unknown;
8760             uv = PTR2UV(args ? va_arg(*args, void*) : argsv);
8761             base = 16;
8762             goto integer;
8763
8764         case 'D':
8765 #ifdef IV_IS_QUAD
8766             intsize = 'q';
8767 #else
8768             intsize = 'l';
8769 #endif
8770             /*FALLTHROUGH*/
8771         case 'd':
8772         case 'i':
8773 #if vdNUMBER
8774         format_vd:
8775 #endif
8776             if (vectorize) {
8777                 STRLEN ulen;
8778                 if (!veclen)
8779                     continue;
8780                 if (vec_utf8)
8781                     uv = utf8n_to_uvchr(vecstr, veclen, &ulen,
8782                                         UTF8_ALLOW_ANYUV);
8783                 else {
8784                     uv = *vecstr;
8785                     ulen = 1;
8786                 }
8787                 vecstr += ulen;
8788                 veclen -= ulen;
8789                 if (plus)
8790                      esignbuf[esignlen++] = plus;
8791             }
8792             else if (args) {
8793                 switch (intsize) {
8794                 case 'h':       iv = (short)va_arg(*args, int); break;
8795                 case 'l':       iv = va_arg(*args, long); break;
8796                 case 'V':       iv = va_arg(*args, IV); break;
8797                 default:        iv = va_arg(*args, int); break;
8798 #ifdef HAS_QUAD
8799                 case 'q':       iv = va_arg(*args, Quad_t); break;
8800 #endif
8801                 }
8802             }
8803             else {
8804                 IV tiv = SvIVx(argsv); /* work around GCC bug #13488 */
8805                 switch (intsize) {
8806                 case 'h':       iv = (short)tiv; break;
8807                 case 'l':       iv = (long)tiv; break;
8808                 case 'V':
8809                 default:        iv = tiv; break;
8810 #ifdef HAS_QUAD
8811                 case 'q':       iv = (Quad_t)tiv; break;
8812 #endif
8813                 }
8814             }
8815             if ( !vectorize )   /* we already set uv above */
8816             {
8817                 if (iv >= 0) {
8818                     uv = iv;
8819                     if (plus)
8820                         esignbuf[esignlen++] = plus;
8821                 }
8822                 else {
8823                     uv = -iv;
8824                     esignbuf[esignlen++] = '-';
8825                 }
8826             }
8827             base = 10;
8828             goto integer;
8829
8830         case 'U':
8831 #ifdef IV_IS_QUAD
8832             intsize = 'q';
8833 #else
8834             intsize = 'l';
8835 #endif
8836             /*FALLTHROUGH*/
8837         case 'u':
8838             base = 10;
8839             goto uns_integer;
8840
8841         case 'b':
8842             base = 2;
8843             goto uns_integer;
8844
8845         case 'O':
8846 #ifdef IV_IS_QUAD
8847             intsize = 'q';
8848 #else
8849             intsize = 'l';
8850 #endif
8851             /*FALLTHROUGH*/
8852         case 'o':
8853             base = 8;
8854             goto uns_integer;
8855
8856         case 'X':
8857         case 'x':
8858             base = 16;
8859
8860         uns_integer:
8861             if (vectorize) {
8862                 STRLEN ulen;
8863         vector:
8864                 if (!veclen)
8865                     continue;
8866                 if (vec_utf8)
8867                     uv = utf8n_to_uvchr(vecstr, veclen, &ulen,
8868                                         UTF8_ALLOW_ANYUV);
8869                 else {
8870                     uv = *vecstr;
8871                     ulen = 1;
8872                 }
8873                 vecstr += ulen;
8874                 veclen -= ulen;
8875             }
8876             else if (args) {
8877                 switch (intsize) {
8878                 case 'h':  uv = (unsigned short)va_arg(*args, unsigned); break;
8879                 case 'l':  uv = va_arg(*args, unsigned long); break;
8880                 case 'V':  uv = va_arg(*args, UV); break;
8881                 default:   uv = va_arg(*args, unsigned); break;
8882 #ifdef HAS_QUAD
8883                 case 'q':  uv = va_arg(*args, Uquad_t); break;
8884 #endif
8885                 }
8886             }
8887             else {
8888                 UV tuv = SvUVx(argsv); /* work around GCC bug #13488 */
8889                 switch (intsize) {
8890                 case 'h':       uv = (unsigned short)tuv; break;
8891                 case 'l':       uv = (unsigned long)tuv; break;
8892                 case 'V':
8893                 default:        uv = tuv; break;
8894 #ifdef HAS_QUAD
8895                 case 'q':       uv = (Uquad_t)tuv; break;
8896 #endif
8897                 }
8898             }
8899
8900         integer:
8901             {
8902                 char *ptr = ebuf + sizeof ebuf;
8903                 switch (base) {
8904                     unsigned dig;
8905                 case 16:
8906                     if (!uv)
8907                         alt = FALSE;
8908                     p = (char*)((c == 'X')
8909                                 ? "0123456789ABCDEF" : "0123456789abcdef");
8910                     do {
8911                         dig = uv & 15;
8912                         *--ptr = p[dig];
8913                     } while (uv >>= 4);
8914                     if (alt) {
8915                         esignbuf[esignlen++] = '0';
8916                         esignbuf[esignlen++] = c;  /* 'x' or 'X' */
8917                     }
8918                     break;
8919                 case 8:
8920                     do {
8921                         dig = uv & 7;
8922                         *--ptr = '0' + dig;
8923                     } while (uv >>= 3);
8924                     if (alt && *ptr != '0')
8925                         *--ptr = '0';
8926                     break;
8927                 case 2:
8928                     if (!uv)
8929                         alt = FALSE;
8930                     do {
8931                         dig = uv & 1;
8932                         *--ptr = '0' + dig;
8933                     } while (uv >>= 1);
8934                     if (alt) {
8935                         esignbuf[esignlen++] = '0';
8936                         esignbuf[esignlen++] = 'b';
8937                     }
8938                     break;
8939                 default:                /* it had better be ten or less */
8940                     do {
8941                         dig = uv % base;
8942                         *--ptr = '0' + dig;
8943                     } while (uv /= base);
8944                     break;
8945                 }
8946                 elen = (ebuf + sizeof ebuf) - ptr;
8947                 eptr = ptr;
8948                 if (has_precis) {
8949                     if (precis > elen)
8950                         zeros = precis - elen;
8951                     else if (precis == 0 && elen == 1 && *eptr == '0')
8952                         elen = 0;
8953                 }
8954             }
8955             break;
8956
8957             /* FLOATING POINT */
8958
8959         case 'F':
8960             c = 'f';            /* maybe %F isn't supported here */
8961             /*FALLTHROUGH*/
8962         case 'e': case 'E':
8963         case 'f':
8964         case 'g': case 'G':
8965             if (vectorize)
8966                 goto unknown;
8967
8968             /* This is evil, but floating point is even more evil */
8969
8970             /* for SV-style calling, we can only get NV
8971                for C-style calling, we assume %f is double;
8972                for simplicity we allow any of %Lf, %llf, %qf for long double
8973             */
8974             switch (intsize) {
8975             case 'V':
8976 #if defined(USE_LONG_DOUBLE)
8977                 intsize = 'q';
8978 #endif
8979                 break;
8980 /* [perl #20339] - we should accept and ignore %lf rather than die */
8981             case 'l':
8982                 /*FALLTHROUGH*/
8983             default:
8984 #if defined(USE_LONG_DOUBLE)
8985                 intsize = args ? 0 : 'q';
8986 #endif
8987                 break;
8988             case 'q':
8989 #if defined(HAS_LONG_DOUBLE)
8990                 break;
8991 #else
8992                 /*FALLTHROUGH*/
8993 #endif
8994             case 'h':
8995                 goto unknown;
8996             }
8997
8998             /* now we need (long double) if intsize == 'q', else (double) */
8999             nv = (args) ?
9000 #if LONG_DOUBLESIZE > DOUBLESIZE
9001                 intsize == 'q' ?
9002                     va_arg(*args, long double) :
9003                     va_arg(*args, double)
9004 #else
9005                     va_arg(*args, double)
9006 #endif
9007                 : SvNVx(argsv);
9008
9009             need = 0;
9010             if (c != 'e' && c != 'E') {
9011                 i = PERL_INT_MIN;
9012                 /* FIXME: if HAS_LONG_DOUBLE but not USE_LONG_DOUBLE this
9013                    will cast our (long double) to (double) */
9014                 (void)Perl_frexp(nv, &i);
9015                 if (i == PERL_INT_MIN)
9016                     Perl_die(aTHX_ "panic: frexp");
9017                 if (i > 0)
9018                     need = BIT_DIGITS(i);
9019             }
9020             need += has_precis ? precis : 6; /* known default */
9021
9022             if (need < width)
9023                 need = width;
9024
9025 #ifdef HAS_LDBL_SPRINTF_BUG
9026             /* This is to try to fix a bug with irix/nonstop-ux/powerux and
9027                with sfio - Allen <allens@cpan.org> */
9028
9029 #  ifdef DBL_MAX
9030 #    define MY_DBL_MAX DBL_MAX
9031 #  else /* XXX guessing! HUGE_VAL may be defined as infinity, so not using */
9032 #    if DOUBLESIZE >= 8
9033 #      define MY_DBL_MAX 1.7976931348623157E+308L
9034 #    else
9035 #      define MY_DBL_MAX 3.40282347E+38L
9036 #    endif
9037 #  endif
9038
9039 #  ifdef HAS_LDBL_SPRINTF_BUG_LESS1 /* only between -1L & 1L - Allen */
9040 #    define MY_DBL_MAX_BUG 1L
9041 #  else
9042 #    define MY_DBL_MAX_BUG MY_DBL_MAX
9043 #  endif
9044
9045 #  ifdef DBL_MIN
9046 #    define MY_DBL_MIN DBL_MIN
9047 #  else  /* XXX guessing! -Allen */
9048 #    if DOUBLESIZE >= 8
9049 #      define MY_DBL_MIN 2.2250738585072014E-308L
9050 #    else
9051 #      define MY_DBL_MIN 1.17549435E-38L
9052 #    endif
9053 #  endif
9054
9055             if ((intsize == 'q') && (c == 'f') &&
9056                 ((nv < MY_DBL_MAX_BUG) && (nv > -MY_DBL_MAX_BUG)) &&
9057                 (need < DBL_DIG)) {
9058                 /* it's going to be short enough that
9059                  * long double precision is not needed */
9060
9061                 if ((nv <= 0L) && (nv >= -0L))
9062                     fix_ldbl_sprintf_bug = TRUE; /* 0 is 0 - easiest */
9063                 else {
9064                     /* would use Perl_fp_class as a double-check but not
9065                      * functional on IRIX - see perl.h comments */
9066
9067                     if ((nv >= MY_DBL_MIN) || (nv <= -MY_DBL_MIN)) {
9068                         /* It's within the range that a double can represent */
9069 #if defined(DBL_MAX) && !defined(DBL_MIN)
9070                         if ((nv >= ((long double)1/DBL_MAX)) ||
9071                             (nv <= (-(long double)1/DBL_MAX)))
9072 #endif
9073                         fix_ldbl_sprintf_bug = TRUE;
9074                     }
9075                 }
9076                 if (fix_ldbl_sprintf_bug == TRUE) {
9077                     double temp;
9078
9079                     intsize = 0;
9080                     temp = (double)nv;
9081                     nv = (NV)temp;
9082                 }
9083             }
9084
9085 #  undef MY_DBL_MAX
9086 #  undef MY_DBL_MAX_BUG
9087 #  undef MY_DBL_MIN
9088
9089 #endif /* HAS_LDBL_SPRINTF_BUG */
9090
9091             need += 20; /* fudge factor */
9092             if (PL_efloatsize < need) {
9093                 Safefree(PL_efloatbuf);
9094                 PL_efloatsize = need + 20; /* more fudge */
9095                 Newx(PL_efloatbuf, PL_efloatsize, char);
9096                 PL_efloatbuf[0] = '\0';
9097             }
9098
9099             if ( !(width || left || plus || alt) && fill != '0'
9100                  && has_precis && intsize != 'q' ) {    /* Shortcuts */
9101                 /* See earlier comment about buggy Gconvert when digits,
9102                    aka precis is 0  */
9103                 if ( c == 'g' && precis) {
9104                     Gconvert((NV)nv, (int)precis, 0, PL_efloatbuf);
9105                     /* May return an empty string for digits==0 */
9106                     if (*PL_efloatbuf) {
9107                         elen = strlen(PL_efloatbuf);
9108                         goto float_converted;
9109                     }
9110                 } else if ( c == 'f' && !precis) {
9111                     if ((eptr = F0convert(nv, ebuf + sizeof ebuf, &elen)))
9112                         break;
9113                 }
9114             }
9115             {
9116                 char *ptr = ebuf + sizeof ebuf;
9117                 *--ptr = '\0';
9118                 *--ptr = c;
9119                 /* FIXME: what to do if HAS_LONG_DOUBLE but not PERL_PRIfldbl? */
9120 #if defined(HAS_LONG_DOUBLE) && defined(PERL_PRIfldbl)
9121                 if (intsize == 'q') {
9122                     /* Copy the one or more characters in a long double
9123                      * format before the 'base' ([efgEFG]) character to
9124                      * the format string. */
9125                     static char const prifldbl[] = PERL_PRIfldbl;
9126                     char const *p = prifldbl + sizeof(prifldbl) - 3;
9127                     while (p >= prifldbl) { *--ptr = *p--; }
9128                 }
9129 #endif
9130                 if (has_precis) {
9131                     base = precis;
9132                     do { *--ptr = '0' + (base % 10); } while (base /= 10);
9133                     *--ptr = '.';
9134                 }
9135                 if (width) {
9136                     base = width;
9137                     do { *--ptr = '0' + (base % 10); } while (base /= 10);
9138                 }
9139                 if (fill == '0')
9140                     *--ptr = fill;
9141                 if (left)
9142                     *--ptr = '-';
9143                 if (plus)
9144                     *--ptr = plus;
9145                 if (alt)
9146                     *--ptr = '#';
9147                 *--ptr = '%';
9148
9149                 /* No taint.  Otherwise we are in the strange situation
9150                  * where printf() taints but print($float) doesn't.
9151                  * --jhi */
9152 #if defined(HAS_LONG_DOUBLE)
9153                 elen = ((intsize == 'q')
9154                         ? my_sprintf(PL_efloatbuf, ptr, nv)
9155                         : my_sprintf(PL_efloatbuf, ptr, (double)nv));
9156 #else
9157                 elen = my_sprintf(PL_efloatbuf, ptr, nv);
9158 #endif
9159             }
9160         float_converted:
9161             eptr = PL_efloatbuf;
9162             break;
9163
9164             /* SPECIAL */
9165
9166         case 'n':
9167             if (vectorize)
9168                 goto unknown;
9169             i = SvCUR(sv) - origlen;
9170             if (args) {
9171                 switch (intsize) {
9172                 case 'h':       *(va_arg(*args, short*)) = i; break;
9173                 default:        *(va_arg(*args, int*)) = i; break;
9174                 case 'l':       *(va_arg(*args, long*)) = i; break;
9175                 case 'V':       *(va_arg(*args, IV*)) = i; break;
9176 #ifdef HAS_QUAD
9177                 case 'q':       *(va_arg(*args, Quad_t*)) = i; break;
9178 #endif
9179                 }
9180             }
9181             else
9182                 sv_setuv_mg(argsv, (UV)i);
9183             continue;   /* not "break" */
9184
9185             /* UNKNOWN */
9186
9187         default:
9188       unknown:
9189             if (!args
9190                 && (PL_op->op_type == OP_PRTF || PL_op->op_type == OP_SPRINTF)
9191                 && ckWARN(WARN_PRINTF))
9192             {
9193                 SV * const msg = sv_newmortal();
9194                 Perl_sv_setpvf(aTHX_ msg, "Invalid conversion in %sprintf: ",
9195                           (PL_op->op_type == OP_PRTF) ? "" : "s");
9196                 if (c) {
9197                     if (isPRINT(c))
9198                         Perl_sv_catpvf(aTHX_ msg,
9199                                        "\"%%%c\"", c & 0xFF);
9200                     else
9201                         Perl_sv_catpvf(aTHX_ msg,
9202                                        "\"%%\\%03"UVof"\"",
9203                                        (UV)c & 0xFF);
9204                 } else
9205                     sv_catpvs(msg, "end of string");
9206                 Perl_warner(aTHX_ packWARN(WARN_PRINTF), "%"SVf, msg); /* yes, this is reentrant */
9207             }
9208
9209             /* output mangled stuff ... */
9210             if (c == '\0')
9211                 --q;
9212             eptr = p;
9213             elen = q - p;
9214
9215             /* ... right here, because formatting flags should not apply */
9216             SvGROW(sv, SvCUR(sv) + elen + 1);
9217             p = SvEND(sv);
9218             Copy(eptr, p, elen, char);
9219             p += elen;
9220             *p = '\0';
9221             SvCUR_set(sv, p - SvPVX_const(sv));
9222             svix = osvix;
9223             continue;   /* not "break" */
9224         }
9225
9226         /* calculate width before utf8_upgrade changes it */
9227         have = esignlen + zeros + elen;
9228         if (have < zeros)
9229             Perl_croak_nocontext(PL_memory_wrap);
9230
9231         if (is_utf8 != has_utf8) {
9232              if (is_utf8) {
9233                   if (SvCUR(sv))
9234                        sv_utf8_upgrade(sv);
9235              }
9236              else {
9237                   SV * const nsv = sv_2mortal(newSVpvn(eptr, elen));
9238                   sv_utf8_upgrade(nsv);
9239                   eptr = SvPVX_const(nsv);
9240                   elen = SvCUR(nsv);
9241              }
9242              SvGROW(sv, SvCUR(sv) + elen + 1);
9243              p = SvEND(sv);
9244              *p = '\0';
9245         }
9246
9247         need = (have > width ? have : width);
9248         gap = need - have;
9249
9250         if (need >= (((STRLEN)~0) - SvCUR(sv) - dotstrlen - 1))
9251             Perl_croak_nocontext(PL_memory_wrap);
9252         SvGROW(sv, SvCUR(sv) + need + dotstrlen + 1);
9253         p = SvEND(sv);
9254         if (esignlen && fill == '0') {
9255             int i;
9256             for (i = 0; i < (int)esignlen; i++)
9257                 *p++ = esignbuf[i];
9258         }
9259         if (gap && !left) {
9260             memset(p, fill, gap);
9261             p += gap;
9262         }
9263         if (esignlen && fill != '0') {
9264             int i;
9265             for (i = 0; i < (int)esignlen; i++)
9266                 *p++ = esignbuf[i];
9267         }
9268         if (zeros) {
9269             int i;
9270             for (i = zeros; i; i--)
9271                 *p++ = '0';
9272         }
9273         if (elen) {
9274             Copy(eptr, p, elen, char);
9275             p += elen;
9276         }
9277         if (gap && left) {
9278             memset(p, ' ', gap);
9279             p += gap;
9280         }
9281         if (vectorize) {
9282             if (veclen) {
9283                 Copy(dotstr, p, dotstrlen, char);
9284                 p += dotstrlen;
9285             }
9286             else
9287                 vectorize = FALSE;              /* done iterating over vecstr */
9288         }
9289         if (is_utf8)
9290             has_utf8 = TRUE;
9291         if (has_utf8)
9292             SvUTF8_on(sv);
9293         *p = '\0';
9294         SvCUR_set(sv, p - SvPVX_const(sv));
9295         if (vectorize) {
9296             esignlen = 0;
9297             goto vector;
9298         }
9299     }
9300 }
9301
9302 /* =========================================================================
9303
9304 =head1 Cloning an interpreter
9305
9306 All the macros and functions in this section are for the private use of
9307 the main function, perl_clone().
9308
9309 The foo_dup() functions make an exact copy of an existing foo thinngy.
9310 During the course of a cloning, a hash table is used to map old addresses
9311 to new addresses. The table is created and manipulated with the
9312 ptr_table_* functions.
9313
9314 =cut
9315
9316 ============================================================================*/
9317
9318
9319 #if defined(USE_ITHREADS)
9320
9321 #ifndef GpREFCNT_inc
9322 #  define GpREFCNT_inc(gp)      ((gp) ? (++(gp)->gp_refcnt, (gp)) : (GP*)NULL)
9323 #endif
9324
9325
9326 #define sv_dup_inc(s,t) SvREFCNT_inc(sv_dup(s,t))
9327 #define sv_dup_inc_NN(s,t)      SvREFCNT_inc_NN(sv_dup(s,t))
9328 #define av_dup(s,t)     (AV*)sv_dup((SV*)s,t)
9329 #define av_dup_inc(s,t) (AV*)SvREFCNT_inc(sv_dup((SV*)s,t))
9330 #define hv_dup(s,t)     (HV*)sv_dup((SV*)s,t)
9331 #define hv_dup_inc(s,t) (HV*)SvREFCNT_inc(sv_dup((SV*)s,t))
9332 #define cv_dup(s,t)     (CV*)sv_dup((SV*)s,t)
9333 #define cv_dup_inc(s,t) (CV*)SvREFCNT_inc(sv_dup((SV*)s,t))
9334 #define io_dup(s,t)     (IO*)sv_dup((SV*)s,t)
9335 #define io_dup_inc(s,t) (IO*)SvREFCNT_inc(sv_dup((SV*)s,t))
9336 #define gv_dup(s,t)     (GV*)sv_dup((SV*)s,t)
9337 #define gv_dup_inc(s,t) (GV*)SvREFCNT_inc(sv_dup((SV*)s,t))
9338 #define SAVEPV(p)       ((p) ? savepv(p) : NULL)
9339 #define SAVEPVN(p,n)    ((p) ? savepvn(p,n) : NULL)
9340
9341
9342 /* Duplicate a regexp. Required reading: pregcomp() and pregfree() in
9343    regcomp.c. AMS 20010712 */
9344
9345 REGEXP *
9346 Perl_re_dup(pTHX_ const REGEXP *r, CLONE_PARAMS *param)
9347 {
9348     dVAR;
9349     REGEXP *ret;
9350     int i, len, npar;
9351     struct reg_substr_datum *s;
9352
9353     if (!r)
9354         return (REGEXP *)NULL;
9355
9356     if ((ret = (REGEXP *)ptr_table_fetch(PL_ptr_table, r)))
9357         return ret;
9358
9359     len = r->offsets[0];
9360     npar = r->nparens+1;
9361
9362     Newxc(ret, sizeof(regexp) + (len+1)*sizeof(regnode), char, regexp);
9363     Copy(r->program, ret->program, len+1, regnode);
9364
9365     Newx(ret->startp, npar, I32);
9366     Copy(r->startp, ret->startp, npar, I32);
9367     Newx(ret->endp, npar, I32);
9368     Copy(r->startp, ret->startp, npar, I32);
9369
9370     Newx(ret->substrs, 1, struct reg_substr_data);
9371     for (s = ret->substrs->data, i = 0; i < 3; i++, s++) {
9372         s->min_offset = r->substrs->data[i].min_offset;
9373         s->max_offset = r->substrs->data[i].max_offset;
9374         s->substr     = sv_dup_inc(r->substrs->data[i].substr, param);
9375         s->utf8_substr = sv_dup_inc(r->substrs->data[i].utf8_substr, param);
9376     }
9377
9378     ret->regstclass = NULL;
9379     if (r->data) {
9380         struct reg_data *d;
9381         const int count = r->data->count;
9382         int i;
9383
9384         Newxc(d, sizeof(struct reg_data) + count*sizeof(void *),
9385                 char, struct reg_data);
9386         Newx(d->what, count, U8);
9387
9388         d->count = count;
9389         for (i = 0; i < count; i++) {
9390             d->what[i] = r->data->what[i];
9391             switch (d->what[i]) {
9392                 /* legal options are one of: sfpont
9393                    see also regcomp.h and pregfree() */
9394             case 's':
9395                 d->data[i] = sv_dup_inc((SV *)r->data->data[i], param);
9396                 break;
9397             case 'p':
9398                 d->data[i] = av_dup_inc((AV *)r->data->data[i], param);
9399                 break;
9400             case 'f':
9401                 /* This is cheating. */
9402                 Newx(d->data[i], 1, struct regnode_charclass_class);
9403                 StructCopy(r->data->data[i], d->data[i],
9404                             struct regnode_charclass_class);
9405                 ret->regstclass = (regnode*)d->data[i];
9406                 break;
9407             case 'o':
9408                 /* Compiled op trees are readonly, and can thus be
9409                    shared without duplication. */
9410                 OP_REFCNT_LOCK;
9411                 d->data[i] = (void*)OpREFCNT_inc((OP*)r->data->data[i]);
9412                 OP_REFCNT_UNLOCK;
9413                 break;
9414             case 'n':
9415                 d->data[i] = r->data->data[i];
9416                 break;
9417             case 't':
9418                 d->data[i] = r->data->data[i];
9419                 OP_REFCNT_LOCK;
9420                 ((reg_trie_data*)d->data[i])->refcount++;
9421                 OP_REFCNT_UNLOCK;
9422                 break;
9423             default:
9424                 Perl_croak(aTHX_ "panic: re_dup unknown data code '%c'", r->data->what[i]);
9425             }
9426         }
9427
9428         ret->data = d;
9429     }
9430     else
9431         ret->data = NULL;
9432
9433     Newx(ret->offsets, 2*len+1, U32);
9434     Copy(r->offsets, ret->offsets, 2*len+1, U32);
9435
9436     ret->precomp        = SAVEPVN(r->precomp, r->prelen);
9437     ret->refcnt         = r->refcnt;
9438     ret->minlen         = r->minlen;
9439     ret->prelen         = r->prelen;
9440     ret->nparens        = r->nparens;
9441     ret->lastparen      = r->lastparen;
9442     ret->lastcloseparen = r->lastcloseparen;
9443     ret->reganch        = r->reganch;
9444
9445     ret->sublen         = r->sublen;
9446
9447     if (RX_MATCH_COPIED(ret))
9448         ret->subbeg  = SAVEPVN(r->subbeg, r->sublen);
9449     else
9450         ret->subbeg = NULL;
9451 #ifdef PERL_OLD_COPY_ON_WRITE
9452     ret->saved_copy = NULL;
9453 #endif
9454
9455     ptr_table_store(PL_ptr_table, r, ret);
9456     return ret;
9457 }
9458
9459 /* duplicate a file handle */
9460
9461 PerlIO *
9462 Perl_fp_dup(pTHX_ PerlIO *fp, char type, CLONE_PARAMS *param)
9463 {
9464     PerlIO *ret;
9465
9466     PERL_UNUSED_ARG(type);
9467
9468     if (!fp)
9469         return (PerlIO*)NULL;
9470
9471     /* look for it in the table first */
9472     ret = (PerlIO*)ptr_table_fetch(PL_ptr_table, fp);
9473     if (ret)
9474         return ret;
9475
9476     /* create anew and remember what it is */
9477     ret = PerlIO_fdupopen(aTHX_ fp, param, PERLIO_DUP_CLONE);
9478     ptr_table_store(PL_ptr_table, fp, ret);
9479     return ret;
9480 }
9481
9482 /* duplicate a directory handle */
9483
9484 DIR *
9485 Perl_dirp_dup(pTHX_ DIR *dp)
9486 {
9487     PERL_UNUSED_CONTEXT;
9488     if (!dp)
9489         return (DIR*)NULL;
9490     /* XXX TODO */
9491     return dp;
9492 }
9493
9494 /* duplicate a typeglob */
9495
9496 GP *
9497 Perl_gp_dup(pTHX_ GP *gp, CLONE_PARAMS* param)
9498 {
9499     GP *ret;
9500
9501     if (!gp)
9502         return (GP*)NULL;
9503     /* look for it in the table first */
9504     ret = (GP*)ptr_table_fetch(PL_ptr_table, gp);
9505     if (ret)
9506         return ret;
9507
9508     /* create anew and remember what it is */
9509     Newxz(ret, 1, GP);
9510     ptr_table_store(PL_ptr_table, gp, ret);
9511
9512     /* clone */
9513     ret->gp_refcnt      = 0;                    /* must be before any other dups! */
9514     ret->gp_sv          = sv_dup_inc(gp->gp_sv, param);
9515     ret->gp_io          = io_dup_inc(gp->gp_io, param);
9516     ret->gp_form        = cv_dup_inc(gp->gp_form, param);
9517     ret->gp_av          = av_dup_inc(gp->gp_av, param);
9518     ret->gp_hv          = hv_dup_inc(gp->gp_hv, param);
9519     ret->gp_egv = gv_dup(gp->gp_egv, param);/* GvEGV is not refcounted */
9520     ret->gp_cv          = cv_dup_inc(gp->gp_cv, param);
9521     ret->gp_cvgen       = gp->gp_cvgen;
9522     ret->gp_line        = gp->gp_line;
9523     ret->gp_file        = gp->gp_file;          /* points to COP.cop_file */
9524     return ret;
9525 }
9526
9527 /* duplicate a chain of magic */
9528
9529 MAGIC *
9530 Perl_mg_dup(pTHX_ MAGIC *mg, CLONE_PARAMS* param)
9531 {
9532     MAGIC *mgprev = (MAGIC*)NULL;
9533     MAGIC *mgret;
9534     if (!mg)
9535         return (MAGIC*)NULL;
9536     /* look for it in the table first */
9537     mgret = (MAGIC*)ptr_table_fetch(PL_ptr_table, mg);
9538     if (mgret)
9539         return mgret;
9540
9541     for (; mg; mg = mg->mg_moremagic) {
9542         MAGIC *nmg;
9543         Newxz(nmg, 1, MAGIC);
9544         if (mgprev)
9545             mgprev->mg_moremagic = nmg;
9546         else
9547             mgret = nmg;
9548         nmg->mg_virtual = mg->mg_virtual;       /* XXX copy dynamic vtable? */
9549         nmg->mg_private = mg->mg_private;
9550         nmg->mg_type    = mg->mg_type;
9551         nmg->mg_flags   = mg->mg_flags;
9552         if (mg->mg_type == PERL_MAGIC_qr) {
9553             nmg->mg_obj = (SV*)re_dup((REGEXP*)mg->mg_obj, param);
9554         }
9555         else if(mg->mg_type == PERL_MAGIC_backref) {
9556             /* The backref AV has its reference count deliberately bumped by
9557                1.  */
9558             nmg->mg_obj = SvREFCNT_inc(av_dup_inc((AV*) mg->mg_obj, param));
9559         }
9560         else if (mg->mg_type == PERL_MAGIC_symtab) {
9561             nmg->mg_obj = mg->mg_obj;
9562         }
9563         else {
9564             nmg->mg_obj = (mg->mg_flags & MGf_REFCOUNTED)
9565                               ? sv_dup_inc(mg->mg_obj, param)
9566                               : sv_dup(mg->mg_obj, param);
9567         }
9568         nmg->mg_len     = mg->mg_len;
9569         nmg->mg_ptr     = mg->mg_ptr;   /* XXX random ptr? */
9570         if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global) {
9571             if (mg->mg_len > 0) {
9572                 nmg->mg_ptr     = SAVEPVN(mg->mg_ptr, mg->mg_len);
9573                 if (mg->mg_type == PERL_MAGIC_overload_table &&
9574                         AMT_AMAGIC((AMT*)mg->mg_ptr))
9575                 {
9576                     const AMT * const amtp = (AMT*)mg->mg_ptr;
9577                     AMT * const namtp = (AMT*)nmg->mg_ptr;
9578                     I32 i;
9579                     for (i = 1; i < NofAMmeth; i++) {
9580                         namtp->table[i] = cv_dup_inc(amtp->table[i], param);
9581                     }
9582                 }
9583             }
9584             else if (mg->mg_len == HEf_SVKEY)
9585                 nmg->mg_ptr     = (char*)sv_dup_inc((SV*)mg->mg_ptr, param);
9586         }
9587         if ((mg->mg_flags & MGf_DUP) && mg->mg_virtual && mg->mg_virtual->svt_dup) {
9588             CALL_FPTR(nmg->mg_virtual->svt_dup)(aTHX_ nmg, param);
9589         }
9590         mgprev = nmg;
9591     }
9592     return mgret;
9593 }
9594
9595 /* create a new pointer-mapping table */
9596
9597 PTR_TBL_t *
9598 Perl_ptr_table_new(pTHX)
9599 {
9600     PTR_TBL_t *tbl;
9601     PERL_UNUSED_CONTEXT;
9602
9603     Newxz(tbl, 1, PTR_TBL_t);
9604     tbl->tbl_max        = 511;
9605     tbl->tbl_items      = 0;
9606     Newxz(tbl->tbl_ary, tbl->tbl_max + 1, PTR_TBL_ENT_t*);
9607     return tbl;
9608 }
9609
9610 #define PTR_TABLE_HASH(ptr) \
9611   ((PTR2UV(ptr) >> 3) ^ (PTR2UV(ptr) >> (3 + 7)) ^ (PTR2UV(ptr) >> (3 + 17)))
9612
9613 /* 
9614    we use the PTE_SVSLOT 'reservation' made above, both here (in the
9615    following define) and at call to new_body_inline made below in 
9616    Perl_ptr_table_store()
9617  */
9618
9619 #define del_pte(p)     del_body_type(p, PTE_SVSLOT)
9620
9621 /* map an existing pointer using a table */
9622
9623 STATIC PTR_TBL_ENT_t *
9624 S_ptr_table_find(PTR_TBL_t *tbl, const void *sv) {
9625     PTR_TBL_ENT_t *tblent;
9626     const UV hash = PTR_TABLE_HASH(sv);
9627     assert(tbl);
9628     tblent = tbl->tbl_ary[hash & tbl->tbl_max];
9629     for (; tblent; tblent = tblent->next) {
9630         if (tblent->oldval == sv)
9631             return tblent;
9632     }
9633     return 0;
9634 }
9635
9636 void *
9637 Perl_ptr_table_fetch(pTHX_ PTR_TBL_t *tbl, const void *sv)
9638 {
9639     PTR_TBL_ENT_t const *const tblent = ptr_table_find(tbl, sv);
9640     PERL_UNUSED_CONTEXT;
9641     return tblent ? tblent->newval : (void *) 0;
9642 }
9643
9644 /* add a new entry to a pointer-mapping table */
9645
9646 void
9647 Perl_ptr_table_store(pTHX_ PTR_TBL_t *tbl, const void *oldsv, void *newsv)
9648 {
9649     PTR_TBL_ENT_t *tblent = ptr_table_find(tbl, oldsv);
9650     PERL_UNUSED_CONTEXT;
9651
9652     if (tblent) {
9653         tblent->newval = newsv;
9654     } else {
9655         const UV entry = PTR_TABLE_HASH(oldsv) & tbl->tbl_max;
9656
9657         new_body_inline(tblent, PTE_SVSLOT);
9658
9659         tblent->oldval = oldsv;
9660         tblent->newval = newsv;
9661         tblent->next = tbl->tbl_ary[entry];
9662         tbl->tbl_ary[entry] = tblent;
9663         tbl->tbl_items++;
9664         if (tblent->next && tbl->tbl_items > tbl->tbl_max)
9665             ptr_table_split(tbl);
9666     }
9667 }
9668
9669 /* double the hash bucket size of an existing ptr table */
9670
9671 void
9672 Perl_ptr_table_split(pTHX_ PTR_TBL_t *tbl)
9673 {
9674     PTR_TBL_ENT_t **ary = tbl->tbl_ary;
9675     const UV oldsize = tbl->tbl_max + 1;
9676     UV newsize = oldsize * 2;
9677     UV i;
9678     PERL_UNUSED_CONTEXT;
9679
9680     Renew(ary, newsize, PTR_TBL_ENT_t*);
9681     Zero(&ary[oldsize], newsize-oldsize, PTR_TBL_ENT_t*);
9682     tbl->tbl_max = --newsize;
9683     tbl->tbl_ary = ary;
9684     for (i=0; i < oldsize; i++, ary++) {
9685         PTR_TBL_ENT_t **curentp, **entp, *ent;
9686         if (!*ary)
9687             continue;
9688         curentp = ary + oldsize;
9689         for (entp = ary, ent = *ary; ent; ent = *entp) {
9690             if ((newsize & PTR_TABLE_HASH(ent->oldval)) != i) {
9691                 *entp = ent->next;
9692                 ent->next = *curentp;
9693                 *curentp = ent;
9694                 continue;
9695             }
9696             else
9697                 entp = &ent->next;
9698         }
9699     }
9700 }
9701
9702 /* remove all the entries from a ptr table */
9703
9704 void
9705 Perl_ptr_table_clear(pTHX_ PTR_TBL_t *tbl)
9706 {
9707     if (tbl && tbl->tbl_items) {
9708         register PTR_TBL_ENT_t * const * const array = tbl->tbl_ary;
9709         UV riter = tbl->tbl_max;
9710
9711         do {
9712             PTR_TBL_ENT_t *entry = array[riter];
9713
9714             while (entry) {
9715                 PTR_TBL_ENT_t * const oentry = entry;
9716                 entry = entry->next;
9717                 del_pte(oentry);
9718             }
9719         } while (riter--);
9720
9721         tbl->tbl_items = 0;
9722     }
9723 }
9724
9725 /* clear and free a ptr table */
9726
9727 void
9728 Perl_ptr_table_free(pTHX_ PTR_TBL_t *tbl)
9729 {
9730     if (!tbl) {
9731         return;
9732     }
9733     ptr_table_clear(tbl);
9734     Safefree(tbl->tbl_ary);
9735     Safefree(tbl);
9736 }
9737
9738
9739 void
9740 Perl_rvpv_dup(pTHX_ SV *dstr, const SV *sstr, CLONE_PARAMS* param)
9741 {
9742     if (SvROK(sstr)) {
9743         SvRV_set(dstr, SvWEAKREF(sstr)
9744                        ? sv_dup(SvRV(sstr), param)
9745                        : sv_dup_inc(SvRV(sstr), param));
9746
9747     }
9748     else if (SvPVX_const(sstr)) {
9749         /* Has something there */
9750         if (SvLEN(sstr)) {
9751             /* Normal PV - clone whole allocated space */
9752             SvPV_set(dstr, SAVEPVN(SvPVX_const(sstr), SvLEN(sstr)-1));
9753             if (SvREADONLY(sstr) && SvFAKE(sstr)) {
9754                 /* Not that normal - actually sstr is copy on write.
9755                    But we are a true, independant SV, so:  */
9756                 SvREADONLY_off(dstr);
9757                 SvFAKE_off(dstr);
9758             }
9759         }
9760         else {
9761             /* Special case - not normally malloced for some reason */
9762             if (isGV_with_GP(sstr)) {
9763                 /* Don't need to do anything here.  */
9764             }
9765             else if ((SvREADONLY(sstr) && SvFAKE(sstr))) {
9766                 /* A "shared" PV - clone it as "shared" PV */
9767                 SvPV_set(dstr,
9768                          HEK_KEY(hek_dup(SvSHARED_HEK_FROM_PV(SvPVX_const(sstr)),
9769                                          param)));
9770             }
9771             else {
9772                 /* Some other special case - random pointer */
9773                 SvPV_set(dstr, SvPVX(sstr));            
9774             }
9775         }
9776     }
9777     else {
9778         /* Copy the NULL */
9779         if (SvTYPE(dstr) == SVt_RV)
9780             SvRV_set(dstr, NULL);
9781         else
9782             SvPV_set(dstr, NULL);
9783     }
9784 }
9785
9786 /* duplicate an SV of any type (including AV, HV etc) */
9787
9788 SV *
9789 Perl_sv_dup(pTHX_ const SV *sstr, CLONE_PARAMS* param)
9790 {
9791     dVAR;
9792     SV *dstr;
9793
9794     if (!sstr || SvTYPE(sstr) == SVTYPEMASK)
9795         return NULL;
9796     /* look for it in the table first */
9797     dstr = (SV*)ptr_table_fetch(PL_ptr_table, sstr);
9798     if (dstr)
9799         return dstr;
9800
9801     if(param->flags & CLONEf_JOIN_IN) {
9802         /** We are joining here so we don't want do clone
9803             something that is bad **/
9804         if (SvTYPE(sstr) == SVt_PVHV) {
9805             const char * const hvname = HvNAME_get(sstr);
9806             if (hvname)
9807                 /** don't clone stashes if they already exist **/
9808                 return (SV*)gv_stashpv(hvname,0);
9809         }
9810     }
9811
9812     /* create anew and remember what it is */
9813     new_SV(dstr);
9814
9815 #ifdef DEBUG_LEAKING_SCALARS
9816     dstr->sv_debug_optype = sstr->sv_debug_optype;
9817     dstr->sv_debug_line = sstr->sv_debug_line;
9818     dstr->sv_debug_inpad = sstr->sv_debug_inpad;
9819     dstr->sv_debug_cloned = 1;
9820     dstr->sv_debug_file = savepv(sstr->sv_debug_file);
9821 #endif
9822
9823     ptr_table_store(PL_ptr_table, sstr, dstr);
9824
9825     /* clone */
9826     SvFLAGS(dstr)       = SvFLAGS(sstr);
9827     SvFLAGS(dstr)       &= ~SVf_OOK;            /* don't propagate OOK hack */
9828     SvREFCNT(dstr)      = 0;                    /* must be before any other dups! */
9829
9830 #ifdef DEBUGGING
9831     if (SvANY(sstr) && PL_watch_pvx && SvPVX_const(sstr) == PL_watch_pvx)
9832         PerlIO_printf(Perl_debug_log, "watch at %p hit, found string \"%s\"\n",
9833                       PL_watch_pvx, SvPVX_const(sstr));
9834 #endif
9835
9836     /* don't clone objects whose class has asked us not to */
9837     if (SvOBJECT(sstr) && ! (SvFLAGS(SvSTASH(sstr)) & SVphv_CLONEABLE)) {
9838         SvFLAGS(dstr) &= ~SVTYPEMASK;
9839         SvOBJECT_off(dstr);
9840         return dstr;
9841     }
9842
9843     switch (SvTYPE(sstr)) {
9844     case SVt_NULL:
9845         SvANY(dstr)     = NULL;
9846         break;
9847     case SVt_IV:
9848         SvANY(dstr)     = (XPVIV*)((char*)&(dstr->sv_u.svu_iv) - STRUCT_OFFSET(XPVIV, xiv_iv));
9849         SvIV_set(dstr, SvIVX(sstr));
9850         break;
9851     case SVt_NV:
9852         SvANY(dstr)     = new_XNV();
9853         SvNV_set(dstr, SvNVX(sstr));
9854         break;
9855     case SVt_RV:
9856         SvANY(dstr)     = &(dstr->sv_u.svu_rv);
9857         Perl_rvpv_dup(aTHX_ dstr, sstr, param);
9858         break;
9859     default:
9860         {
9861             /* These are all the types that need complex bodies allocating.  */
9862             void *new_body;
9863             const svtype sv_type = SvTYPE(sstr);
9864             const struct body_details *const sv_type_details
9865                 = bodies_by_type + sv_type;
9866
9867             switch (sv_type) {
9868             default:
9869                 Perl_croak(aTHX_ "Bizarre SvTYPE [%" IVdf "]", (IV)SvTYPE(sstr));
9870                 break;
9871
9872             case SVt_PVGV:
9873                 if (GvUNIQUE((GV*)sstr)) {
9874                     /*EMPTY*/;   /* Do sharing here, and fall through */
9875                 }
9876             case SVt_PVIO:
9877             case SVt_PVFM:
9878             case SVt_PVHV:
9879             case SVt_PVAV:
9880             case SVt_PVBM:
9881             case SVt_PVCV:
9882             case SVt_PVLV:
9883             case SVt_PVMG:
9884             case SVt_PVNV:
9885             case SVt_PVIV:
9886             case SVt_PV:
9887                 assert(sv_type_details->body_size);
9888                 if (sv_type_details->arena) {
9889                     new_body_inline(new_body, sv_type);
9890                     new_body
9891                         = (void*)((char*)new_body - sv_type_details->offset);
9892                 } else {
9893                     new_body = new_NOARENA(sv_type_details);
9894                 }
9895             }
9896             assert(new_body);
9897             SvANY(dstr) = new_body;
9898
9899 #ifndef PURIFY
9900             Copy(((char*)SvANY(sstr)) + sv_type_details->offset,
9901                  ((char*)SvANY(dstr)) + sv_type_details->offset,
9902                  sv_type_details->copy, char);
9903 #else
9904             Copy(((char*)SvANY(sstr)),
9905                  ((char*)SvANY(dstr)),
9906                  sv_type_details->body_size + sv_type_details->offset, char);
9907 #endif
9908
9909             if (sv_type != SVt_PVAV && sv_type != SVt_PVHV
9910                 && !isGV_with_GP(dstr))
9911                 Perl_rvpv_dup(aTHX_ dstr, sstr, param);
9912
9913             /* The Copy above means that all the source (unduplicated) pointers
9914                are now in the destination.  We can check the flags and the
9915                pointers in either, but it's possible that there's less cache
9916                missing by always going for the destination.
9917                FIXME - instrument and check that assumption  */
9918             if (sv_type >= SVt_PVMG) {
9919                 HV *ourstash;
9920                 if ((sv_type == SVt_PVMG) && (ourstash = OURSTASH(dstr))) {
9921                     OURSTASH_set(dstr, hv_dup_inc(ourstash, param));
9922                 } else if (SvMAGIC(dstr))
9923                     SvMAGIC_set(dstr, mg_dup(SvMAGIC(dstr), param));
9924                 if (SvSTASH(dstr))
9925                     SvSTASH_set(dstr, hv_dup_inc(SvSTASH(dstr), param));
9926             }
9927
9928             /* The cast silences a GCC warning about unhandled types.  */
9929             switch ((int)sv_type) {
9930             case SVt_PV:
9931                 break;
9932             case SVt_PVIV:
9933                 break;
9934             case SVt_PVNV:
9935                 break;
9936             case SVt_PVMG:
9937                 break;
9938             case SVt_PVBM:
9939                 break;
9940             case SVt_PVLV:
9941                 /* XXX LvTARGOFF sometimes holds PMOP* when DEBUGGING */
9942                 if (LvTYPE(dstr) == 't') /* for tie: unrefcnted fake (SV**) */
9943                     LvTARG(dstr) = dstr;
9944                 else if (LvTYPE(dstr) == 'T') /* for tie: fake HE */
9945                     LvTARG(dstr) = (SV*)he_dup((HE*)LvTARG(dstr), 0, param);
9946                 else
9947                     LvTARG(dstr) = sv_dup_inc(LvTARG(dstr), param);
9948                 break;
9949             case SVt_PVGV:
9950                 if (GvNAME_HEK(dstr))
9951                     GvNAME_HEK(dstr) = hek_dup(GvNAME_HEK(dstr), param);
9952
9953                 /* Don't call sv_add_backref here as it's going to be created
9954                    as part of the magic cloning of the symbol table.  */
9955                 GvSTASH(dstr)   = hv_dup(GvSTASH(dstr), param);
9956                 if(isGV_with_GP(sstr)) {
9957                     /* Danger Will Robinson - GvGP(dstr) isn't initialised
9958                        at the point of this comment.  */
9959                     GvGP(dstr)  = gp_dup(GvGP(sstr), param);
9960                     (void)GpREFCNT_inc(GvGP(dstr));
9961                 } else
9962                     Perl_rvpv_dup(aTHX_ dstr, sstr, param);
9963                 break;
9964             case SVt_PVIO:
9965                 IoIFP(dstr)     = fp_dup(IoIFP(dstr), IoTYPE(dstr), param);
9966                 if (IoOFP(dstr) == IoIFP(sstr))
9967                     IoOFP(dstr) = IoIFP(dstr);
9968                 else
9969                     IoOFP(dstr) = fp_dup(IoOFP(dstr), IoTYPE(dstr), param);
9970                 /* PL_rsfp_filters entries have fake IoDIRP() */
9971                 if(IoFLAGS(dstr) & IOf_FAKE_DIRP) {
9972                     /* I have no idea why fake dirp (rsfps)
9973                        should be treated differently but otherwise
9974                        we end up with leaks -- sky*/
9975                     IoTOP_GV(dstr)      = gv_dup_inc(IoTOP_GV(dstr), param);
9976                     IoFMT_GV(dstr)      = gv_dup_inc(IoFMT_GV(dstr), param);
9977                     IoBOTTOM_GV(dstr)   = gv_dup_inc(IoBOTTOM_GV(dstr), param);
9978                 } else {
9979                     IoTOP_GV(dstr)      = gv_dup(IoTOP_GV(dstr), param);
9980                     IoFMT_GV(dstr)      = gv_dup(IoFMT_GV(dstr), param);
9981                     IoBOTTOM_GV(dstr)   = gv_dup(IoBOTTOM_GV(dstr), param);
9982                     if (IoDIRP(dstr)) {
9983                         IoDIRP(dstr)    = dirp_dup(IoDIRP(dstr));
9984                     } else {
9985                         /*EMPTY*/;
9986                         /* IoDIRP(dstr) is already a copy of IoDIRP(sstr)  */
9987                     }
9988                 }
9989                 IoTOP_NAME(dstr)        = SAVEPV(IoTOP_NAME(dstr));
9990                 IoFMT_NAME(dstr)        = SAVEPV(IoFMT_NAME(dstr));
9991                 IoBOTTOM_NAME(dstr)     = SAVEPV(IoBOTTOM_NAME(dstr));
9992                 break;
9993             case SVt_PVAV:
9994                 if (AvARRAY((AV*)sstr)) {
9995                     SV **dst_ary, **src_ary;
9996                     SSize_t items = AvFILLp((AV*)sstr) + 1;
9997
9998                     src_ary = AvARRAY((AV*)sstr);
9999                     Newxz(dst_ary, AvMAX((AV*)sstr)+1, SV*);
10000                     ptr_table_store(PL_ptr_table, src_ary, dst_ary);
10001                     SvPV_set(dstr, (char*)dst_ary);
10002                     AvALLOC((AV*)dstr) = dst_ary;
10003                     if (AvREAL((AV*)sstr)) {
10004                         while (items-- > 0)
10005                             *dst_ary++ = sv_dup_inc(*src_ary++, param);
10006                     }
10007                     else {
10008                         while (items-- > 0)
10009                             *dst_ary++ = sv_dup(*src_ary++, param);
10010                     }
10011                     items = AvMAX((AV*)sstr) - AvFILLp((AV*)sstr);
10012                     while (items-- > 0) {
10013                         *dst_ary++ = &PL_sv_undef;
10014                     }
10015                 }
10016                 else {
10017                     SvPV_set(dstr, NULL);
10018                     AvALLOC((AV*)dstr)  = (SV**)NULL;
10019                 }
10020                 break;
10021             case SVt_PVHV:
10022                 {
10023                     HEK *hvname = NULL;
10024
10025                     if (HvARRAY((HV*)sstr)) {
10026                         STRLEN i = 0;
10027                         const bool sharekeys = !!HvSHAREKEYS(sstr);
10028                         XPVHV * const dxhv = (XPVHV*)SvANY(dstr);
10029                         XPVHV * const sxhv = (XPVHV*)SvANY(sstr);
10030                         char *darray;
10031                         Newx(darray, PERL_HV_ARRAY_ALLOC_BYTES(dxhv->xhv_max+1)
10032                             + (SvOOK(sstr) ? sizeof(struct xpvhv_aux) : 0),
10033                             char);
10034                         HvARRAY(dstr) = (HE**)darray;
10035                         while (i <= sxhv->xhv_max) {
10036                             const HE *source = HvARRAY(sstr)[i];
10037                             HvARRAY(dstr)[i] = source
10038                                 ? he_dup(source, sharekeys, param) : 0;
10039                             ++i;
10040                         }
10041                         if (SvOOK(sstr)) {
10042                             struct xpvhv_aux * const saux = HvAUX(sstr);
10043                             struct xpvhv_aux * const daux = HvAUX(dstr);
10044                             /* This flag isn't copied.  */
10045                             /* SvOOK_on(hv) attacks the IV flags.  */
10046                             SvFLAGS(dstr) |= SVf_OOK;
10047
10048                             hvname = saux->xhv_name;
10049                             daux->xhv_name
10050                                 = hvname ? hek_dup(hvname, param) : hvname;
10051
10052                             daux->xhv_riter = saux->xhv_riter;
10053                             daux->xhv_eiter = saux->xhv_eiter
10054                                 ? he_dup(saux->xhv_eiter,
10055                                          (bool)!!HvSHAREKEYS(sstr), param) : 0;
10056                             daux->xhv_backreferences = saux->xhv_backreferences
10057                                 ? (AV*) SvREFCNT_inc(
10058                                                      sv_dup((SV*)saux->
10059                                                             xhv_backreferences,
10060                                                             param))
10061                                 : 0;
10062                         }
10063                     }
10064                     else {
10065                         SvPV_set(dstr, NULL);
10066                     }
10067                     /* Record stashes for possible cloning in Perl_clone(). */
10068                     if(hvname)
10069                         av_push(param->stashes, dstr);
10070                 }
10071                 break;
10072             case SVt_PVCV:
10073                 if (!(param->flags & CLONEf_COPY_STACKS)) {
10074                     CvDEPTH(dstr) = 0;
10075                 }
10076             case SVt_PVFM:
10077                 /* NOTE: not refcounted */
10078                 CvSTASH(dstr)   = hv_dup(CvSTASH(dstr), param);
10079                 OP_REFCNT_LOCK;
10080                 if (!CvISXSUB(dstr))
10081                     CvROOT(dstr) = OpREFCNT_inc(CvROOT(dstr));
10082                 OP_REFCNT_UNLOCK;
10083                 if (CvCONST(dstr) && CvISXSUB(dstr)) {
10084                     CvXSUBANY(dstr).any_ptr = GvUNIQUE(CvGV(dstr)) ?
10085                         SvREFCNT_inc(CvXSUBANY(dstr).any_ptr) :
10086                         sv_dup_inc((SV *)CvXSUBANY(dstr).any_ptr, param);
10087                 }
10088                 /* don't dup if copying back - CvGV isn't refcounted, so the
10089                  * duped GV may never be freed. A bit of a hack! DAPM */
10090                 CvGV(dstr)      = (param->flags & CLONEf_JOIN_IN) ?
10091                     NULL : gv_dup(CvGV(dstr), param) ;
10092                 PAD_DUP(CvPADLIST(dstr), CvPADLIST(sstr), param);
10093                 CvOUTSIDE(dstr) =
10094                     CvWEAKOUTSIDE(sstr)
10095                     ? cv_dup(    CvOUTSIDE(dstr), param)
10096                     : cv_dup_inc(CvOUTSIDE(dstr), param);
10097                 if (!CvISXSUB(dstr))
10098                     CvFILE(dstr) = SAVEPV(CvFILE(dstr));
10099                 break;
10100             }
10101         }
10102     }
10103
10104     if (SvOBJECT(dstr) && SvTYPE(dstr) != SVt_PVIO)
10105         ++PL_sv_objcount;
10106
10107     return dstr;
10108  }
10109
10110 /* duplicate a context */
10111
10112 PERL_CONTEXT *
10113 Perl_cx_dup(pTHX_ PERL_CONTEXT *cxs, I32 ix, I32 max, CLONE_PARAMS* param)
10114 {
10115     PERL_CONTEXT *ncxs;
10116
10117     if (!cxs)
10118         return (PERL_CONTEXT*)NULL;
10119
10120     /* look for it in the table first */
10121     ncxs = (PERL_CONTEXT*)ptr_table_fetch(PL_ptr_table, cxs);
10122     if (ncxs)
10123         return ncxs;
10124
10125     /* create anew and remember what it is */
10126     Newxz(ncxs, max + 1, PERL_CONTEXT);
10127     ptr_table_store(PL_ptr_table, cxs, ncxs);
10128
10129     while (ix >= 0) {
10130         PERL_CONTEXT * const cx = &cxs[ix];
10131         PERL_CONTEXT * const ncx = &ncxs[ix];
10132         ncx->cx_type    = cx->cx_type;
10133         if (CxTYPE(cx) == CXt_SUBST) {
10134             Perl_croak(aTHX_ "Cloning substitution context is unimplemented");
10135         }
10136         else {
10137             ncx->blk_oldsp      = cx->blk_oldsp;
10138             ncx->blk_oldcop     = cx->blk_oldcop;
10139             ncx->blk_oldmarksp  = cx->blk_oldmarksp;
10140             ncx->blk_oldscopesp = cx->blk_oldscopesp;
10141             ncx->blk_oldpm      = cx->blk_oldpm;
10142             ncx->blk_gimme      = cx->blk_gimme;
10143             switch (CxTYPE(cx)) {
10144             case CXt_SUB:
10145                 ncx->blk_sub.cv         = (cx->blk_sub.olddepth == 0
10146                                            ? cv_dup_inc(cx->blk_sub.cv, param)
10147                                            : cv_dup(cx->blk_sub.cv,param));
10148                 ncx->blk_sub.argarray   = (cx->blk_sub.hasargs
10149                                            ? av_dup_inc(cx->blk_sub.argarray, param)
10150                                            : NULL);
10151                 ncx->blk_sub.savearray  = av_dup_inc(cx->blk_sub.savearray, param);
10152                 ncx->blk_sub.olddepth   = cx->blk_sub.olddepth;
10153                 ncx->blk_sub.hasargs    = cx->blk_sub.hasargs;
10154                 ncx->blk_sub.lval       = cx->blk_sub.lval;
10155                 ncx->blk_sub.retop      = cx->blk_sub.retop;
10156                 break;
10157             case CXt_EVAL:
10158                 ncx->blk_eval.old_in_eval = cx->blk_eval.old_in_eval;
10159                 ncx->blk_eval.old_op_type = cx->blk_eval.old_op_type;
10160                 ncx->blk_eval.old_namesv = sv_dup_inc(cx->blk_eval.old_namesv, param);
10161                 ncx->blk_eval.old_eval_root = cx->blk_eval.old_eval_root;
10162                 ncx->blk_eval.cur_text  = sv_dup(cx->blk_eval.cur_text, param);
10163                 ncx->blk_eval.retop = cx->blk_eval.retop;
10164                 break;
10165             case CXt_LOOP:
10166                 ncx->blk_loop.label     = cx->blk_loop.label;
10167                 ncx->blk_loop.resetsp   = cx->blk_loop.resetsp;
10168                 ncx->blk_loop.redo_op   = cx->blk_loop.redo_op;
10169                 ncx->blk_loop.next_op   = cx->blk_loop.next_op;
10170                 ncx->blk_loop.last_op   = cx->blk_loop.last_op;
10171                 ncx->blk_loop.iterdata  = (CxPADLOOP(cx)
10172                                            ? cx->blk_loop.iterdata
10173                                            : gv_dup((GV*)cx->blk_loop.iterdata, param));
10174                 ncx->blk_loop.oldcomppad
10175                     = (PAD*)ptr_table_fetch(PL_ptr_table,
10176                                             cx->blk_loop.oldcomppad);
10177                 ncx->blk_loop.itersave  = sv_dup_inc(cx->blk_loop.itersave, param);
10178                 ncx->blk_loop.iterlval  = sv_dup_inc(cx->blk_loop.iterlval, param);
10179                 ncx->blk_loop.iterary   = av_dup_inc(cx->blk_loop.iterary, param);
10180                 ncx->blk_loop.iterix    = cx->blk_loop.iterix;
10181                 ncx->blk_loop.itermax   = cx->blk_loop.itermax;
10182                 break;
10183             case CXt_FORMAT:
10184                 ncx->blk_sub.cv         = cv_dup(cx->blk_sub.cv, param);
10185                 ncx->blk_sub.gv         = gv_dup(cx->blk_sub.gv, param);
10186                 ncx->blk_sub.dfoutgv    = gv_dup_inc(cx->blk_sub.dfoutgv, param);
10187                 ncx->blk_sub.hasargs    = cx->blk_sub.hasargs;
10188                 ncx->blk_sub.retop      = cx->blk_sub.retop;
10189                 break;
10190             case CXt_BLOCK:
10191             case CXt_NULL:
10192                 break;
10193             }
10194         }
10195         --ix;
10196     }
10197     return ncxs;
10198 }
10199
10200 /* duplicate a stack info structure */
10201
10202 PERL_SI *
10203 Perl_si_dup(pTHX_ PERL_SI *si, CLONE_PARAMS* param)
10204 {
10205     PERL_SI *nsi;
10206
10207     if (!si)
10208         return (PERL_SI*)NULL;
10209
10210     /* look for it in the table first */
10211     nsi = (PERL_SI*)ptr_table_fetch(PL_ptr_table, si);
10212     if (nsi)
10213         return nsi;
10214
10215     /* create anew and remember what it is */
10216     Newxz(nsi, 1, PERL_SI);
10217     ptr_table_store(PL_ptr_table, si, nsi);
10218
10219     nsi->si_stack       = av_dup_inc(si->si_stack, param);
10220     nsi->si_cxix        = si->si_cxix;
10221     nsi->si_cxmax       = si->si_cxmax;
10222     nsi->si_cxstack     = cx_dup(si->si_cxstack, si->si_cxix, si->si_cxmax, param);
10223     nsi->si_type        = si->si_type;
10224     nsi->si_prev        = si_dup(si->si_prev, param);
10225     nsi->si_next        = si_dup(si->si_next, param);
10226     nsi->si_markoff     = si->si_markoff;
10227
10228     return nsi;
10229 }
10230
10231 #define POPINT(ss,ix)   ((ss)[--(ix)].any_i32)
10232 #define TOPINT(ss,ix)   ((ss)[ix].any_i32)
10233 #define POPLONG(ss,ix)  ((ss)[--(ix)].any_long)
10234 #define TOPLONG(ss,ix)  ((ss)[ix].any_long)
10235 #define POPIV(ss,ix)    ((ss)[--(ix)].any_iv)
10236 #define TOPIV(ss,ix)    ((ss)[ix].any_iv)
10237 #define POPBOOL(ss,ix)  ((ss)[--(ix)].any_bool)
10238 #define TOPBOOL(ss,ix)  ((ss)[ix].any_bool)
10239 #define POPPTR(ss,ix)   ((ss)[--(ix)].any_ptr)
10240 #define TOPPTR(ss,ix)   ((ss)[ix].any_ptr)
10241 #define POPDPTR(ss,ix)  ((ss)[--(ix)].any_dptr)
10242 #define TOPDPTR(ss,ix)  ((ss)[ix].any_dptr)
10243 #define POPDXPTR(ss,ix) ((ss)[--(ix)].any_dxptr)
10244 #define TOPDXPTR(ss,ix) ((ss)[ix].any_dxptr)
10245
10246 /* XXXXX todo */
10247 #define pv_dup_inc(p)   SAVEPV(p)
10248 #define pv_dup(p)       SAVEPV(p)
10249 #define svp_dup_inc(p,pp)       any_dup(p,pp)
10250
10251 /* map any object to the new equivent - either something in the
10252  * ptr table, or something in the interpreter structure
10253  */
10254
10255 void *
10256 Perl_any_dup(pTHX_ void *v, const PerlInterpreter *proto_perl)
10257 {
10258     void *ret;
10259
10260     if (!v)
10261         return (void*)NULL;
10262
10263     /* look for it in the table first */
10264     ret = ptr_table_fetch(PL_ptr_table, v);
10265     if (ret)
10266         return ret;
10267
10268     /* see if it is part of the interpreter structure */
10269     if (v >= (void*)proto_perl && v < (void*)(proto_perl+1))
10270         ret = (void*)(((char*)aTHX) + (((char*)v) - (char*)proto_perl));
10271     else {
10272         ret = v;
10273     }
10274
10275     return ret;
10276 }
10277
10278 /* duplicate the save stack */
10279
10280 ANY *
10281 Perl_ss_dup(pTHX_ PerlInterpreter *proto_perl, CLONE_PARAMS* param)
10282 {
10283     ANY * const ss      = proto_perl->Tsavestack;
10284     const I32 max       = proto_perl->Tsavestack_max;
10285     I32 ix              = proto_perl->Tsavestack_ix;
10286     ANY *nss;
10287     SV *sv;
10288     GV *gv;
10289     AV *av;
10290     HV *hv;
10291     void* ptr;
10292     int intval;
10293     long longval;
10294     GP *gp;
10295     IV iv;
10296     char *c = NULL;
10297     void (*dptr) (void*);
10298     void (*dxptr) (pTHX_ void*);
10299
10300     Newxz(nss, max, ANY);
10301
10302     while (ix > 0) {
10303         I32 i = POPINT(ss,ix);
10304         TOPINT(nss,ix) = i;
10305         switch (i) {
10306         case SAVEt_ITEM:                        /* normal string */
10307             sv = (SV*)POPPTR(ss,ix);
10308             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
10309             sv = (SV*)POPPTR(ss,ix);
10310             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
10311             break;
10312         case SAVEt_SV:                          /* scalar reference */
10313             sv = (SV*)POPPTR(ss,ix);
10314             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
10315             gv = (GV*)POPPTR(ss,ix);
10316             TOPPTR(nss,ix) = gv_dup_inc(gv, param);
10317             break;
10318         case SAVEt_GENERIC_PVREF:               /* generic char* */
10319             c = (char*)POPPTR(ss,ix);
10320             TOPPTR(nss,ix) = pv_dup(c);
10321             ptr = POPPTR(ss,ix);
10322             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10323             break;
10324         case SAVEt_SHARED_PVREF:                /* char* in shared space */
10325             c = (char*)POPPTR(ss,ix);
10326             TOPPTR(nss,ix) = savesharedpv(c);
10327             ptr = POPPTR(ss,ix);
10328             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10329             break;
10330         case SAVEt_GENERIC_SVREF:               /* generic sv */
10331         case SAVEt_SVREF:                       /* scalar reference */
10332             sv = (SV*)POPPTR(ss,ix);
10333             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
10334             ptr = POPPTR(ss,ix);
10335             TOPPTR(nss,ix) = svp_dup_inc((SV**)ptr, proto_perl);/* XXXXX */
10336             break;
10337         case SAVEt_AV:                          /* array reference */
10338             av = (AV*)POPPTR(ss,ix);
10339             TOPPTR(nss,ix) = av_dup_inc(av, param);
10340             gv = (GV*)POPPTR(ss,ix);
10341             TOPPTR(nss,ix) = gv_dup(gv, param);
10342             break;
10343         case SAVEt_HV:                          /* hash reference */
10344             hv = (HV*)POPPTR(ss,ix);
10345             TOPPTR(nss,ix) = hv_dup_inc(hv, param);
10346             gv = (GV*)POPPTR(ss,ix);
10347             TOPPTR(nss,ix) = gv_dup(gv, param);
10348             break;
10349         case SAVEt_INT:                         /* int reference */
10350             ptr = POPPTR(ss,ix);
10351             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10352             intval = (int)POPINT(ss,ix);
10353             TOPINT(nss,ix) = intval;
10354             break;
10355         case SAVEt_LONG:                        /* long reference */
10356             ptr = POPPTR(ss,ix);
10357             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10358             longval = (long)POPLONG(ss,ix);
10359             TOPLONG(nss,ix) = longval;
10360             break;
10361         case SAVEt_I32:                         /* I32 reference */
10362         case SAVEt_I16:                         /* I16 reference */
10363         case SAVEt_I8:                          /* I8 reference */
10364             ptr = POPPTR(ss,ix);
10365             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10366             i = POPINT(ss,ix);
10367             TOPINT(nss,ix) = i;
10368             break;
10369         case SAVEt_IV:                          /* IV reference */
10370             ptr = POPPTR(ss,ix);
10371             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10372             iv = POPIV(ss,ix);
10373             TOPIV(nss,ix) = iv;
10374             break;
10375         case SAVEt_SPTR:                        /* SV* reference */
10376             ptr = POPPTR(ss,ix);
10377             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10378             sv = (SV*)POPPTR(ss,ix);
10379             TOPPTR(nss,ix) = sv_dup(sv, param);
10380             break;
10381         case SAVEt_VPTR:                        /* random* reference */
10382             ptr = POPPTR(ss,ix);
10383             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10384             ptr = POPPTR(ss,ix);
10385             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10386             break;
10387         case SAVEt_PPTR:                        /* char* reference */
10388             ptr = POPPTR(ss,ix);
10389             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10390             c = (char*)POPPTR(ss,ix);
10391             TOPPTR(nss,ix) = pv_dup(c);
10392             break;
10393         case SAVEt_HPTR:                        /* HV* reference */
10394             ptr = POPPTR(ss,ix);
10395             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10396             hv = (HV*)POPPTR(ss,ix);
10397             TOPPTR(nss,ix) = hv_dup(hv, param);
10398             break;
10399         case SAVEt_APTR:                        /* AV* reference */
10400             ptr = POPPTR(ss,ix);
10401             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10402             av = (AV*)POPPTR(ss,ix);
10403             TOPPTR(nss,ix) = av_dup(av, param);
10404             break;
10405         case SAVEt_NSTAB:
10406             gv = (GV*)POPPTR(ss,ix);
10407             TOPPTR(nss,ix) = gv_dup(gv, param);
10408             break;
10409         case SAVEt_GP:                          /* scalar reference */
10410             gp = (GP*)POPPTR(ss,ix);
10411             TOPPTR(nss,ix) = gp = gp_dup(gp, param);
10412             (void)GpREFCNT_inc(gp);
10413             gv = (GV*)POPPTR(ss,ix);
10414             TOPPTR(nss,ix) = gv_dup_inc(gv, param);
10415             c = (char*)POPPTR(ss,ix);
10416             TOPPTR(nss,ix) = pv_dup(c);
10417             iv = POPIV(ss,ix);
10418             TOPIV(nss,ix) = iv;
10419             iv = POPIV(ss,ix);
10420             TOPIV(nss,ix) = iv;
10421             break;
10422         case SAVEt_FREESV:
10423         case SAVEt_MORTALIZESV:
10424             sv = (SV*)POPPTR(ss,ix);
10425             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
10426             break;
10427         case SAVEt_FREEOP:
10428             ptr = POPPTR(ss,ix);
10429             if (ptr && (((OP*)ptr)->op_private & OPpREFCOUNTED)) {
10430                 /* these are assumed to be refcounted properly */
10431                 OP *o;
10432                 switch (((OP*)ptr)->op_type) {
10433                 case OP_LEAVESUB:
10434                 case OP_LEAVESUBLV:
10435                 case OP_LEAVEEVAL:
10436                 case OP_LEAVE:
10437                 case OP_SCOPE:
10438                 case OP_LEAVEWRITE:
10439                     TOPPTR(nss,ix) = ptr;
10440                     o = (OP*)ptr;
10441                     OpREFCNT_inc(o);
10442                     break;
10443                 default:
10444                     TOPPTR(nss,ix) = NULL;
10445                     break;
10446                 }
10447             }
10448             else
10449                 TOPPTR(nss,ix) = NULL;
10450             break;
10451         case SAVEt_FREEPV:
10452             c = (char*)POPPTR(ss,ix);
10453             TOPPTR(nss,ix) = pv_dup_inc(c);
10454             break;
10455         case SAVEt_CLEARSV:
10456             longval = POPLONG(ss,ix);
10457             TOPLONG(nss,ix) = longval;
10458             break;
10459         case SAVEt_DELETE:
10460             hv = (HV*)POPPTR(ss,ix);
10461             TOPPTR(nss,ix) = hv_dup_inc(hv, param);
10462             c = (char*)POPPTR(ss,ix);
10463             TOPPTR(nss,ix) = pv_dup_inc(c);
10464             i = POPINT(ss,ix);
10465             TOPINT(nss,ix) = i;
10466             break;
10467         case SAVEt_DESTRUCTOR:
10468             ptr = POPPTR(ss,ix);
10469             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);  /* XXX quite arbitrary */
10470             dptr = POPDPTR(ss,ix);
10471             TOPDPTR(nss,ix) = DPTR2FPTR(void (*)(void*),
10472                                         any_dup(FPTR2DPTR(void *, dptr),
10473                                                 proto_perl));
10474             break;
10475         case SAVEt_DESTRUCTOR_X:
10476             ptr = POPPTR(ss,ix);
10477             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);  /* XXX quite arbitrary */
10478             dxptr = POPDXPTR(ss,ix);
10479             TOPDXPTR(nss,ix) = DPTR2FPTR(void (*)(pTHX_ void*),
10480                                          any_dup(FPTR2DPTR(void *, dxptr),
10481                                                  proto_perl));
10482             break;
10483         case SAVEt_REGCONTEXT:
10484         case SAVEt_ALLOC:
10485             i = POPINT(ss,ix);
10486             TOPINT(nss,ix) = i;
10487             ix -= i;
10488             break;
10489         case SAVEt_STACK_POS:           /* Position on Perl stack */
10490             i = POPINT(ss,ix);
10491             TOPINT(nss,ix) = i;
10492             break;
10493         case SAVEt_AELEM:               /* array element */
10494             sv = (SV*)POPPTR(ss,ix);
10495             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
10496             i = POPINT(ss,ix);
10497             TOPINT(nss,ix) = i;
10498             av = (AV*)POPPTR(ss,ix);
10499             TOPPTR(nss,ix) = av_dup_inc(av, param);
10500             break;
10501         case SAVEt_HELEM:               /* hash element */
10502             sv = (SV*)POPPTR(ss,ix);
10503             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
10504             sv = (SV*)POPPTR(ss,ix);
10505             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
10506             hv = (HV*)POPPTR(ss,ix);
10507             TOPPTR(nss,ix) = hv_dup_inc(hv, param);
10508             break;
10509         case SAVEt_OP:
10510             ptr = POPPTR(ss,ix);
10511             TOPPTR(nss,ix) = ptr;
10512             break;
10513         case SAVEt_HINTS:
10514             i = POPINT(ss,ix);
10515             TOPINT(nss,ix) = i;
10516             break;
10517         case SAVEt_COMPPAD:
10518             av = (AV*)POPPTR(ss,ix);
10519             TOPPTR(nss,ix) = av_dup(av, param);
10520             break;
10521         case SAVEt_PADSV:
10522             longval = (long)POPLONG(ss,ix);
10523             TOPLONG(nss,ix) = longval;
10524             ptr = POPPTR(ss,ix);
10525             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10526             sv = (SV*)POPPTR(ss,ix);
10527             TOPPTR(nss,ix) = sv_dup(sv, param);
10528             break;
10529         case SAVEt_BOOL:
10530             ptr = POPPTR(ss,ix);
10531             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10532             longval = (long)POPBOOL(ss,ix);
10533             TOPBOOL(nss,ix) = (bool)longval;
10534             break;
10535         case SAVEt_SET_SVFLAGS:
10536             i = POPINT(ss,ix);
10537             TOPINT(nss,ix) = i;
10538             i = POPINT(ss,ix);
10539             TOPINT(nss,ix) = i;
10540             sv = (SV*)POPPTR(ss,ix);
10541             TOPPTR(nss,ix) = sv_dup(sv, param);
10542             break;
10543         default:
10544             Perl_croak(aTHX_ "panic: ss_dup inconsistency");
10545         }
10546     }
10547
10548     return nss;
10549 }
10550
10551
10552 /* if sv is a stash, call $class->CLONE_SKIP(), and set the SVphv_CLONEABLE
10553  * flag to the result. This is done for each stash before cloning starts,
10554  * so we know which stashes want their objects cloned */
10555
10556 static void
10557 do_mark_cloneable_stash(pTHX_ SV *sv)
10558 {
10559     const HEK * const hvname = HvNAME_HEK((HV*)sv);
10560     if (hvname) {
10561         GV* const cloner = gv_fetchmethod_autoload((HV*)sv, "CLONE_SKIP", 0);
10562         SvFLAGS(sv) |= SVphv_CLONEABLE; /* clone objects by default */
10563         if (cloner && GvCV(cloner)) {
10564             dSP;
10565             UV status;
10566
10567             ENTER;
10568             SAVETMPS;
10569             PUSHMARK(SP);
10570             XPUSHs(sv_2mortal(newSVhek(hvname)));
10571             PUTBACK;
10572             call_sv((SV*)GvCV(cloner), G_SCALAR);
10573             SPAGAIN;
10574             status = POPu;
10575             PUTBACK;
10576             FREETMPS;
10577             LEAVE;
10578             if (status)
10579                 SvFLAGS(sv) &= ~SVphv_CLONEABLE;
10580         }
10581     }
10582 }
10583
10584
10585
10586 /*
10587 =for apidoc perl_clone
10588
10589 Create and return a new interpreter by cloning the current one.
10590
10591 perl_clone takes these flags as parameters:
10592
10593 CLONEf_COPY_STACKS - is used to, well, copy the stacks also,
10594 without it we only clone the data and zero the stacks,
10595 with it we copy the stacks and the new perl interpreter is
10596 ready to run at the exact same point as the previous one.
10597 The pseudo-fork code uses COPY_STACKS while the
10598 threads->new doesn't.
10599
10600 CLONEf_KEEP_PTR_TABLE
10601 perl_clone keeps a ptr_table with the pointer of the old
10602 variable as a key and the new variable as a value,
10603 this allows it to check if something has been cloned and not
10604 clone it again but rather just use the value and increase the
10605 refcount. If KEEP_PTR_TABLE is not set then perl_clone will kill
10606 the ptr_table using the function
10607 C<ptr_table_free(PL_ptr_table); PL_ptr_table = NULL;>,
10608 reason to keep it around is if you want to dup some of your own
10609 variable who are outside the graph perl scans, example of this
10610 code is in threads.xs create
10611
10612 CLONEf_CLONE_HOST
10613 This is a win32 thing, it is ignored on unix, it tells perls
10614 win32host code (which is c++) to clone itself, this is needed on
10615 win32 if you want to run two threads at the same time,
10616 if you just want to do some stuff in a separate perl interpreter
10617 and then throw it away and return to the original one,
10618 you don't need to do anything.
10619
10620 =cut
10621 */
10622
10623 /* XXX the above needs expanding by someone who actually understands it ! */
10624 EXTERN_C PerlInterpreter *
10625 perl_clone_host(PerlInterpreter* proto_perl, UV flags);
10626
10627 PerlInterpreter *
10628 perl_clone(PerlInterpreter *proto_perl, UV flags)
10629 {
10630    dVAR;
10631 #ifdef PERL_IMPLICIT_SYS
10632
10633    /* perlhost.h so we need to call into it
10634    to clone the host, CPerlHost should have a c interface, sky */
10635
10636    if (flags & CLONEf_CLONE_HOST) {
10637        return perl_clone_host(proto_perl,flags);
10638    }
10639    return perl_clone_using(proto_perl, flags,
10640                             proto_perl->IMem,
10641                             proto_perl->IMemShared,
10642                             proto_perl->IMemParse,
10643                             proto_perl->IEnv,
10644                             proto_perl->IStdIO,
10645                             proto_perl->ILIO,
10646                             proto_perl->IDir,
10647                             proto_perl->ISock,
10648                             proto_perl->IProc);
10649 }
10650
10651 PerlInterpreter *
10652 perl_clone_using(PerlInterpreter *proto_perl, UV flags,
10653                  struct IPerlMem* ipM, struct IPerlMem* ipMS,
10654                  struct IPerlMem* ipMP, struct IPerlEnv* ipE,
10655                  struct IPerlStdIO* ipStd, struct IPerlLIO* ipLIO,
10656                  struct IPerlDir* ipD, struct IPerlSock* ipS,
10657                  struct IPerlProc* ipP)
10658 {
10659     /* XXX many of the string copies here can be optimized if they're
10660      * constants; they need to be allocated as common memory and just
10661      * their pointers copied. */
10662
10663     IV i;
10664     CLONE_PARAMS clone_params;
10665     CLONE_PARAMS* const param = &clone_params;
10666
10667     PerlInterpreter * const my_perl = (PerlInterpreter*)(*ipM->pMalloc)(ipM, sizeof(PerlInterpreter));
10668     /* for each stash, determine whether its objects should be cloned */
10669     S_visit(proto_perl, do_mark_cloneable_stash, SVt_PVHV, SVTYPEMASK);
10670     PERL_SET_THX(my_perl);
10671
10672 #  ifdef DEBUGGING
10673     Poison(my_perl, 1, PerlInterpreter);
10674     PL_op = NULL;
10675     PL_curcop = NULL;
10676     PL_markstack = 0;
10677     PL_scopestack = 0;
10678     PL_savestack = 0;
10679     PL_savestack_ix = 0;
10680     PL_savestack_max = -1;
10681     PL_sig_pending = 0;
10682     Zero(&PL_debug_pad, 1, struct perl_debug_pad);
10683 #  else /* !DEBUGGING */
10684     Zero(my_perl, 1, PerlInterpreter);
10685 #  endif        /* DEBUGGING */
10686
10687     /* host pointers */
10688     PL_Mem              = ipM;
10689     PL_MemShared        = ipMS;
10690     PL_MemParse         = ipMP;
10691     PL_Env              = ipE;
10692     PL_StdIO            = ipStd;
10693     PL_LIO              = ipLIO;
10694     PL_Dir              = ipD;
10695     PL_Sock             = ipS;
10696     PL_Proc             = ipP;
10697 #else           /* !PERL_IMPLICIT_SYS */
10698     IV i;
10699     CLONE_PARAMS clone_params;
10700     CLONE_PARAMS* param = &clone_params;
10701     PerlInterpreter * const my_perl = (PerlInterpreter*)PerlMem_malloc(sizeof(PerlInterpreter));
10702     /* for each stash, determine whether its objects should be cloned */
10703     S_visit(proto_perl, do_mark_cloneable_stash, SVt_PVHV, SVTYPEMASK);
10704     PERL_SET_THX(my_perl);
10705
10706 #    ifdef DEBUGGING
10707     Poison(my_perl, 1, PerlInterpreter);
10708     PL_op = NULL;
10709     PL_curcop = NULL;
10710     PL_markstack = 0;
10711     PL_scopestack = 0;
10712     PL_savestack = 0;
10713     PL_savestack_ix = 0;
10714     PL_savestack_max = -1;
10715     PL_sig_pending = 0;
10716     Zero(&PL_debug_pad, 1, struct perl_debug_pad);
10717 #    else       /* !DEBUGGING */
10718     Zero(my_perl, 1, PerlInterpreter);
10719 #    endif      /* DEBUGGING */
10720 #endif          /* PERL_IMPLICIT_SYS */
10721     param->flags = flags;
10722     param->proto_perl = proto_perl;
10723
10724     INIT_TRACK_MEMPOOL(my_perl->Imemory_debug_header, my_perl);
10725
10726     PL_body_arenas = NULL;
10727     Zero(&PL_body_roots, 1, PL_body_roots);
10728     
10729     PL_nice_chunk       = NULL;
10730     PL_nice_chunk_size  = 0;
10731     PL_sv_count         = 0;
10732     PL_sv_objcount      = 0;
10733     PL_sv_root          = NULL;
10734     PL_sv_arenaroot     = NULL;
10735
10736     PL_debug            = proto_perl->Idebug;
10737
10738     PL_hash_seed        = proto_perl->Ihash_seed;
10739     PL_rehash_seed      = proto_perl->Irehash_seed;
10740
10741 #ifdef USE_REENTRANT_API
10742     /* XXX: things like -Dm will segfault here in perlio, but doing
10743      *  PERL_SET_CONTEXT(proto_perl);
10744      * breaks too many other things
10745      */
10746     Perl_reentrant_init(aTHX);
10747 #endif
10748
10749     /* create SV map for pointer relocation */
10750     PL_ptr_table = ptr_table_new();
10751
10752     /* initialize these special pointers as early as possible */
10753     SvANY(&PL_sv_undef)         = NULL;
10754     SvREFCNT(&PL_sv_undef)      = (~(U32)0)/2;
10755     SvFLAGS(&PL_sv_undef)       = SVf_READONLY|SVt_NULL;
10756     ptr_table_store(PL_ptr_table, &proto_perl->Isv_undef, &PL_sv_undef);
10757
10758     SvANY(&PL_sv_no)            = new_XPVNV();
10759     SvREFCNT(&PL_sv_no)         = (~(U32)0)/2;
10760     SvFLAGS(&PL_sv_no)          = SVp_IOK|SVf_IOK|SVp_NOK|SVf_NOK
10761                                   |SVp_POK|SVf_POK|SVf_READONLY|SVt_PVNV;
10762     SvPV_set(&PL_sv_no, SAVEPVN(PL_No, 0));
10763     SvCUR_set(&PL_sv_no, 0);
10764     SvLEN_set(&PL_sv_no, 1);
10765     SvIV_set(&PL_sv_no, 0);
10766     SvNV_set(&PL_sv_no, 0);
10767     ptr_table_store(PL_ptr_table, &proto_perl->Isv_no, &PL_sv_no);
10768
10769     SvANY(&PL_sv_yes)           = new_XPVNV();
10770     SvREFCNT(&PL_sv_yes)        = (~(U32)0)/2;
10771     SvFLAGS(&PL_sv_yes)         = SVp_IOK|SVf_IOK|SVp_NOK|SVf_NOK
10772                                   |SVp_POK|SVf_POK|SVf_READONLY|SVt_PVNV;
10773     SvPV_set(&PL_sv_yes, SAVEPVN(PL_Yes, 1));
10774     SvCUR_set(&PL_sv_yes, 1);
10775     SvLEN_set(&PL_sv_yes, 2);
10776     SvIV_set(&PL_sv_yes, 1);
10777     SvNV_set(&PL_sv_yes, 1);
10778     ptr_table_store(PL_ptr_table, &proto_perl->Isv_yes, &PL_sv_yes);
10779
10780     /* create (a non-shared!) shared string table */
10781     PL_strtab           = newHV();
10782     HvSHAREKEYS_off(PL_strtab);
10783     hv_ksplit(PL_strtab, HvTOTALKEYS(proto_perl->Istrtab));
10784     ptr_table_store(PL_ptr_table, proto_perl->Istrtab, PL_strtab);
10785
10786     PL_compiling = proto_perl->Icompiling;
10787
10788     /* These two PVs will be free'd special way so must set them same way op.c does */
10789     PL_compiling.cop_stashpv = savesharedpv(PL_compiling.cop_stashpv);
10790     ptr_table_store(PL_ptr_table, proto_perl->Icompiling.cop_stashpv, PL_compiling.cop_stashpv);
10791
10792     PL_compiling.cop_file    = savesharedpv(PL_compiling.cop_file);
10793     ptr_table_store(PL_ptr_table, proto_perl->Icompiling.cop_file, PL_compiling.cop_file);
10794
10795     ptr_table_store(PL_ptr_table, &proto_perl->Icompiling, &PL_compiling);
10796     if (!specialWARN(PL_compiling.cop_warnings))
10797         PL_compiling.cop_warnings = sv_dup_inc(PL_compiling.cop_warnings, param);
10798     if (!specialCopIO(PL_compiling.cop_io))
10799         PL_compiling.cop_io = sv_dup_inc(PL_compiling.cop_io, param);
10800     PL_curcop           = (COP*)any_dup(proto_perl->Tcurcop, proto_perl);
10801
10802     /* pseudo environmental stuff */
10803     PL_origargc         = proto_perl->Iorigargc;
10804     PL_origargv         = proto_perl->Iorigargv;
10805
10806     param->stashes      = newAV();  /* Setup array of objects to call clone on */
10807
10808     /* Set tainting stuff before PerlIO_debug can possibly get called */
10809     PL_tainting         = proto_perl->Itainting;
10810     PL_taint_warn       = proto_perl->Itaint_warn;
10811
10812 #ifdef PERLIO_LAYERS
10813     /* Clone PerlIO tables as soon as we can handle general xx_dup() */
10814     PerlIO_clone(aTHX_ proto_perl, param);
10815 #endif
10816
10817     PL_envgv            = gv_dup(proto_perl->Ienvgv, param);
10818     PL_incgv            = gv_dup(proto_perl->Iincgv, param);
10819     PL_hintgv           = gv_dup(proto_perl->Ihintgv, param);
10820     PL_origfilename     = SAVEPV(proto_perl->Iorigfilename);
10821     PL_diehook          = sv_dup_inc(proto_perl->Idiehook, param);
10822     PL_warnhook         = sv_dup_inc(proto_perl->Iwarnhook, param);
10823
10824     /* switches */
10825     PL_minus_c          = proto_perl->Iminus_c;
10826     PL_patchlevel       = sv_dup_inc(proto_perl->Ipatchlevel, param);
10827     PL_localpatches     = proto_perl->Ilocalpatches;
10828     PL_splitstr         = proto_perl->Isplitstr;
10829     PL_preprocess       = proto_perl->Ipreprocess;
10830     PL_minus_n          = proto_perl->Iminus_n;
10831     PL_minus_p          = proto_perl->Iminus_p;
10832     PL_minus_l          = proto_perl->Iminus_l;
10833     PL_minus_a          = proto_perl->Iminus_a;
10834     PL_minus_E          = proto_perl->Iminus_E;
10835     PL_minus_F          = proto_perl->Iminus_F;
10836     PL_doswitches       = proto_perl->Idoswitches;
10837     PL_dowarn           = proto_perl->Idowarn;
10838     PL_doextract        = proto_perl->Idoextract;
10839     PL_sawampersand     = proto_perl->Isawampersand;
10840     PL_unsafe           = proto_perl->Iunsafe;
10841     PL_inplace          = SAVEPV(proto_perl->Iinplace);
10842     PL_e_script         = sv_dup_inc(proto_perl->Ie_script, param);
10843     PL_perldb           = proto_perl->Iperldb;
10844     PL_perl_destruct_level = proto_perl->Iperl_destruct_level;
10845     PL_exit_flags       = proto_perl->Iexit_flags;
10846
10847     /* magical thingies */
10848     /* XXX time(&PL_basetime) when asked for? */
10849     PL_basetime         = proto_perl->Ibasetime;
10850     PL_formfeed         = sv_dup(proto_perl->Iformfeed, param);
10851
10852     PL_maxsysfd         = proto_perl->Imaxsysfd;
10853     PL_multiline        = proto_perl->Imultiline;
10854     PL_statusvalue      = proto_perl->Istatusvalue;
10855 #ifdef VMS
10856     PL_statusvalue_vms  = proto_perl->Istatusvalue_vms;
10857 #else
10858     PL_statusvalue_posix = proto_perl->Istatusvalue_posix;
10859 #endif
10860     PL_encoding         = sv_dup(proto_perl->Iencoding, param);
10861
10862     sv_setpvn(PERL_DEBUG_PAD(0), "", 0);        /* For regex debugging. */
10863     sv_setpvn(PERL_DEBUG_PAD(1), "", 0);        /* ext/re needs these */
10864     sv_setpvn(PERL_DEBUG_PAD(2), "", 0);        /* even without DEBUGGING. */
10865
10866     /* Clone the regex array */
10867     PL_regex_padav = newAV();
10868     {
10869         const I32 len = av_len((AV*)proto_perl->Iregex_padav);
10870         SV* const * const regexen = AvARRAY((AV*)proto_perl->Iregex_padav);
10871         IV i;
10872         av_push(PL_regex_padav, sv_dup_inc_NN(regexen[0],param));
10873         for(i = 1; i <= len; i++) {
10874             const SV * const regex = regexen[i];
10875             SV * const sv =
10876                 SvREPADTMP(regex)
10877                     ? sv_dup_inc(regex, param)
10878                     : SvREFCNT_inc(
10879                         newSViv(PTR2IV(re_dup(
10880                                 INT2PTR(REGEXP *, SvIVX(regex)), param))))
10881                 ;
10882             av_push(PL_regex_padav, sv);
10883         }
10884     }
10885     PL_regex_pad = AvARRAY(PL_regex_padav);
10886
10887     /* shortcuts to various I/O objects */
10888     PL_stdingv          = gv_dup(proto_perl->Istdingv, param);
10889     PL_stderrgv         = gv_dup(proto_perl->Istderrgv, param);
10890     PL_defgv            = gv_dup(proto_perl->Idefgv, param);
10891     PL_argvgv           = gv_dup(proto_perl->Iargvgv, param);
10892     PL_argvoutgv        = gv_dup(proto_perl->Iargvoutgv, param);
10893     PL_argvout_stack    = av_dup_inc(proto_perl->Iargvout_stack, param);
10894
10895     /* shortcuts to regexp stuff */
10896     PL_replgv           = gv_dup(proto_perl->Ireplgv, param);
10897
10898     /* shortcuts to misc objects */
10899     PL_errgv            = gv_dup(proto_perl->Ierrgv, param);
10900
10901     /* shortcuts to debugging objects */
10902     PL_DBgv             = gv_dup(proto_perl->IDBgv, param);
10903     PL_DBline           = gv_dup(proto_perl->IDBline, param);
10904     PL_DBsub            = gv_dup(proto_perl->IDBsub, param);
10905     PL_DBsingle         = sv_dup(proto_perl->IDBsingle, param);
10906     PL_DBtrace          = sv_dup(proto_perl->IDBtrace, param);
10907     PL_DBsignal         = sv_dup(proto_perl->IDBsignal, param);
10908     PL_DBassertion      = sv_dup(proto_perl->IDBassertion, param);
10909     PL_lineary          = av_dup(proto_perl->Ilineary, param);
10910     PL_dbargs           = av_dup(proto_perl->Idbargs, param);
10911
10912     /* symbol tables */
10913     PL_defstash         = hv_dup_inc(proto_perl->Tdefstash, param);
10914     PL_curstash         = hv_dup(proto_perl->Tcurstash, param);
10915     PL_debstash         = hv_dup(proto_perl->Idebstash, param);
10916     PL_globalstash      = hv_dup(proto_perl->Iglobalstash, param);
10917     PL_curstname        = sv_dup_inc(proto_perl->Icurstname, param);
10918
10919     PL_beginav          = av_dup_inc(proto_perl->Ibeginav, param);
10920     PL_beginav_save     = av_dup_inc(proto_perl->Ibeginav_save, param);
10921     PL_checkav_save     = av_dup_inc(proto_perl->Icheckav_save, param);
10922     PL_endav            = av_dup_inc(proto_perl->Iendav, param);
10923     PL_checkav          = av_dup_inc(proto_perl->Icheckav, param);
10924     PL_initav           = av_dup_inc(proto_perl->Iinitav, param);
10925
10926     PL_sub_generation   = proto_perl->Isub_generation;
10927
10928     /* funky return mechanisms */
10929     PL_forkprocess      = proto_perl->Iforkprocess;
10930
10931     /* subprocess state */
10932     PL_fdpid            = av_dup_inc(proto_perl->Ifdpid, param);
10933
10934     /* internal state */
10935     PL_maxo             = proto_perl->Imaxo;
10936     if (proto_perl->Iop_mask)
10937         PL_op_mask      = SAVEPVN(proto_perl->Iop_mask, PL_maxo);
10938     else
10939         PL_op_mask      = NULL;
10940     /* PL_asserting        = proto_perl->Iasserting; */
10941
10942     /* current interpreter roots */
10943     PL_main_cv          = cv_dup_inc(proto_perl->Imain_cv, param);
10944     PL_main_root        = OpREFCNT_inc(proto_perl->Imain_root);
10945     PL_main_start       = proto_perl->Imain_start;
10946     PL_eval_root        = proto_perl->Ieval_root;
10947     PL_eval_start       = proto_perl->Ieval_start;
10948
10949     /* runtime control stuff */
10950     PL_curcopdb         = (COP*)any_dup(proto_perl->Icurcopdb, proto_perl);
10951     PL_copline          = proto_perl->Icopline;
10952
10953     PL_filemode         = proto_perl->Ifilemode;
10954     PL_lastfd           = proto_perl->Ilastfd;
10955     PL_oldname          = proto_perl->Ioldname;         /* XXX not quite right */
10956     PL_Argv             = NULL;
10957     PL_Cmd              = NULL;
10958     PL_gensym           = proto_perl->Igensym;
10959     PL_preambled        = proto_perl->Ipreambled;
10960     PL_preambleav       = av_dup_inc(proto_perl->Ipreambleav, param);
10961     PL_laststatval      = proto_perl->Ilaststatval;
10962     PL_laststype        = proto_perl->Ilaststype;
10963     PL_mess_sv          = NULL;
10964
10965     PL_ors_sv           = sv_dup_inc(proto_perl->Iors_sv, param);
10966
10967     /* interpreter atexit processing */
10968     PL_exitlistlen      = proto_perl->Iexitlistlen;
10969     if (PL_exitlistlen) {
10970         Newx(PL_exitlist, PL_exitlistlen, PerlExitListEntry);
10971         Copy(proto_perl->Iexitlist, PL_exitlist, PL_exitlistlen, PerlExitListEntry);
10972     }
10973     else
10974         PL_exitlist     = (PerlExitListEntry*)NULL;
10975
10976     PL_my_cxt_size = proto_perl->Imy_cxt_size;
10977     if (PL_my_cxt_size) {
10978         Newx(PL_my_cxt_list, PL_my_cxt_size, void *);
10979         Copy(proto_perl->Imy_cxt_list, PL_my_cxt_list, PL_my_cxt_size, void *);
10980     }
10981     else
10982         PL_my_cxt_list  = (void**)NULL;
10983     PL_modglobal        = hv_dup_inc(proto_perl->Imodglobal, param);
10984     PL_custom_op_names  = hv_dup_inc(proto_perl->Icustom_op_names,param);
10985     PL_custom_op_descs  = hv_dup_inc(proto_perl->Icustom_op_descs,param);
10986
10987     PL_profiledata      = NULL;
10988     PL_rsfp             = fp_dup(proto_perl->Irsfp, '<', param);
10989     /* PL_rsfp_filters entries have fake IoDIRP() */
10990     PL_rsfp_filters     = av_dup_inc(proto_perl->Irsfp_filters, param);
10991
10992     PL_compcv                   = cv_dup(proto_perl->Icompcv, param);
10993
10994     PAD_CLONE_VARS(proto_perl, param);
10995
10996 #ifdef HAVE_INTERP_INTERN
10997     sys_intern_dup(&proto_perl->Isys_intern, &PL_sys_intern);
10998 #endif
10999
11000     /* more statics moved here */
11001     PL_generation       = proto_perl->Igeneration;
11002     PL_DBcv             = cv_dup(proto_perl->IDBcv, param);
11003
11004     PL_in_clean_objs    = proto_perl->Iin_clean_objs;
11005     PL_in_clean_all     = proto_perl->Iin_clean_all;
11006
11007     PL_uid              = proto_perl->Iuid;
11008     PL_euid             = proto_perl->Ieuid;
11009     PL_gid              = proto_perl->Igid;
11010     PL_egid             = proto_perl->Iegid;
11011     PL_nomemok          = proto_perl->Inomemok;
11012     PL_an               = proto_perl->Ian;
11013     PL_evalseq          = proto_perl->Ievalseq;
11014     PL_origenviron      = proto_perl->Iorigenviron;     /* XXX not quite right */
11015     PL_origalen         = proto_perl->Iorigalen;
11016 #ifdef PERL_USES_PL_PIDSTATUS
11017     PL_pidstatus        = newHV();                      /* XXX flag for cloning? */
11018 #endif
11019     PL_osname           = SAVEPV(proto_perl->Iosname);
11020     PL_sighandlerp      = proto_perl->Isighandlerp;
11021
11022     PL_runops           = proto_perl->Irunops;
11023
11024     Copy(proto_perl->Itokenbuf, PL_tokenbuf, 256, char);
11025
11026 #ifdef CSH
11027     PL_cshlen           = proto_perl->Icshlen;
11028     PL_cshname          = proto_perl->Icshname; /* XXX never deallocated */
11029 #endif
11030
11031     PL_lex_state        = proto_perl->Ilex_state;
11032     PL_lex_defer        = proto_perl->Ilex_defer;
11033     PL_lex_expect       = proto_perl->Ilex_expect;
11034     PL_lex_formbrack    = proto_perl->Ilex_formbrack;
11035     PL_lex_dojoin       = proto_perl->Ilex_dojoin;
11036     PL_lex_starts       = proto_perl->Ilex_starts;
11037     PL_lex_stuff        = sv_dup_inc(proto_perl->Ilex_stuff, param);
11038     PL_lex_repl         = sv_dup_inc(proto_perl->Ilex_repl, param);
11039     PL_lex_op           = proto_perl->Ilex_op;
11040     PL_lex_inpat        = proto_perl->Ilex_inpat;
11041     PL_lex_inwhat       = proto_perl->Ilex_inwhat;
11042     PL_lex_brackets     = proto_perl->Ilex_brackets;
11043     i = (PL_lex_brackets < 120 ? 120 : PL_lex_brackets);
11044     PL_lex_brackstack   = SAVEPVN(proto_perl->Ilex_brackstack,i);
11045     PL_lex_casemods     = proto_perl->Ilex_casemods;
11046     i = (PL_lex_casemods < 12 ? 12 : PL_lex_casemods);
11047     PL_lex_casestack    = SAVEPVN(proto_perl->Ilex_casestack,i);
11048
11049 #ifdef PERL_MAD
11050     Copy(proto_perl->Inexttoke, PL_nexttoke, 5, NEXTTOKE);
11051     PL_lasttoke         = proto_perl->Ilasttoke;
11052     PL_realtokenstart   = proto_perl->Irealtokenstart;
11053     PL_faketokens       = proto_perl->Ifaketokens;
11054     PL_thismad          = proto_perl->Ithismad;
11055     PL_thistoken        = proto_perl->Ithistoken;
11056     PL_thisopen         = proto_perl->Ithisopen;
11057     PL_thisstuff        = proto_perl->Ithisstuff;
11058     PL_thisclose        = proto_perl->Ithisclose;
11059     PL_thiswhite        = proto_perl->Ithiswhite;
11060     PL_nextwhite        = proto_perl->Inextwhite;
11061     PL_skipwhite        = proto_perl->Iskipwhite;
11062     PL_endwhite         = proto_perl->Iendwhite;
11063     PL_curforce         = proto_perl->Icurforce;
11064 #else
11065     Copy(proto_perl->Inextval, PL_nextval, 5, YYSTYPE);
11066     Copy(proto_perl->Inexttype, PL_nexttype, 5, I32);
11067     PL_nexttoke         = proto_perl->Inexttoke;
11068 #endif
11069
11070     /* XXX This is probably masking the deeper issue of why
11071      * SvANY(proto_perl->Ilinestr) can be NULL at this point. For test case:
11072      * http://archive.develooper.com/perl5-porters%40perl.org/msg83298.html
11073      * (A little debugging with a watchpoint on it may help.)
11074      */
11075     if (SvANY(proto_perl->Ilinestr)) {
11076         PL_linestr              = sv_dup_inc(proto_perl->Ilinestr, param);
11077         i = proto_perl->Ibufptr - SvPVX_const(proto_perl->Ilinestr);
11078         PL_bufptr               = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
11079         i = proto_perl->Ioldbufptr - SvPVX_const(proto_perl->Ilinestr);
11080         PL_oldbufptr    = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
11081         i = proto_perl->Ioldoldbufptr - SvPVX_const(proto_perl->Ilinestr);
11082         PL_oldoldbufptr = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
11083         i = proto_perl->Ilinestart - SvPVX_const(proto_perl->Ilinestr);
11084         PL_linestart    = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
11085     }
11086     else {
11087         PL_linestr = newSV(79);
11088         sv_upgrade(PL_linestr,SVt_PVIV);
11089         sv_setpvn(PL_linestr,"",0);
11090         PL_bufptr = PL_oldbufptr = PL_oldoldbufptr = PL_linestart = SvPVX(PL_linestr);
11091     }
11092     PL_bufend           = SvPVX(PL_linestr) + SvCUR(PL_linestr);
11093     PL_pending_ident    = proto_perl->Ipending_ident;
11094     PL_sublex_info      = proto_perl->Isublex_info;     /* XXX not quite right */
11095
11096     PL_expect           = proto_perl->Iexpect;
11097
11098     PL_multi_start      = proto_perl->Imulti_start;
11099     PL_multi_end        = proto_perl->Imulti_end;
11100     PL_multi_open       = proto_perl->Imulti_open;
11101     PL_multi_close      = proto_perl->Imulti_close;
11102
11103     PL_error_count      = proto_perl->Ierror_count;
11104     PL_subline          = proto_perl->Isubline;
11105     PL_subname          = sv_dup_inc(proto_perl->Isubname, param);
11106
11107     /* XXX See comment on SvANY(proto_perl->Ilinestr) above */
11108     if (SvANY(proto_perl->Ilinestr)) {
11109         i = proto_perl->Ilast_uni - SvPVX_const(proto_perl->Ilinestr);
11110         PL_last_uni             = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
11111         i = proto_perl->Ilast_lop - SvPVX_const(proto_perl->Ilinestr);
11112         PL_last_lop             = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
11113         PL_last_lop_op  = proto_perl->Ilast_lop_op;
11114     }
11115     else {
11116         PL_last_uni     = SvPVX(PL_linestr);
11117         PL_last_lop     = SvPVX(PL_linestr);
11118         PL_last_lop_op  = 0;
11119     }
11120     PL_in_my            = proto_perl->Iin_my;
11121     PL_in_my_stash      = hv_dup(proto_perl->Iin_my_stash, param);
11122 #ifdef FCRYPT
11123     PL_cryptseen        = proto_perl->Icryptseen;
11124 #endif
11125
11126     PL_hints            = proto_perl->Ihints;
11127
11128     PL_amagic_generation        = proto_perl->Iamagic_generation;
11129
11130 #ifdef USE_LOCALE_COLLATE
11131     PL_collation_ix     = proto_perl->Icollation_ix;
11132     PL_collation_name   = SAVEPV(proto_perl->Icollation_name);
11133     PL_collation_standard       = proto_perl->Icollation_standard;
11134     PL_collxfrm_base    = proto_perl->Icollxfrm_base;
11135     PL_collxfrm_mult    = proto_perl->Icollxfrm_mult;
11136 #endif /* USE_LOCALE_COLLATE */
11137
11138 #ifdef USE_LOCALE_NUMERIC
11139     PL_numeric_name     = SAVEPV(proto_perl->Inumeric_name);
11140     PL_numeric_standard = proto_perl->Inumeric_standard;
11141     PL_numeric_local    = proto_perl->Inumeric_local;
11142     PL_numeric_radix_sv = sv_dup_inc(proto_perl->Inumeric_radix_sv, param);
11143 #endif /* !USE_LOCALE_NUMERIC */
11144
11145     /* utf8 character classes */
11146     PL_utf8_alnum       = sv_dup_inc(proto_perl->Iutf8_alnum, param);
11147     PL_utf8_alnumc      = sv_dup_inc(proto_perl->Iutf8_alnumc, param);
11148     PL_utf8_ascii       = sv_dup_inc(proto_perl->Iutf8_ascii, param);
11149     PL_utf8_alpha       = sv_dup_inc(proto_perl->Iutf8_alpha, param);
11150     PL_utf8_space       = sv_dup_inc(proto_perl->Iutf8_space, param);
11151     PL_utf8_cntrl       = sv_dup_inc(proto_perl->Iutf8_cntrl, param);
11152     PL_utf8_graph       = sv_dup_inc(proto_perl->Iutf8_graph, param);
11153     PL_utf8_digit       = sv_dup_inc(proto_perl->Iutf8_digit, param);
11154     PL_utf8_upper       = sv_dup_inc(proto_perl->Iutf8_upper, param);
11155     PL_utf8_lower       = sv_dup_inc(proto_perl->Iutf8_lower, param);
11156     PL_utf8_print       = sv_dup_inc(proto_perl->Iutf8_print, param);
11157     PL_utf8_punct       = sv_dup_inc(proto_perl->Iutf8_punct, param);
11158     PL_utf8_xdigit      = sv_dup_inc(proto_perl->Iutf8_xdigit, param);
11159     PL_utf8_mark        = sv_dup_inc(proto_perl->Iutf8_mark, param);
11160     PL_utf8_toupper     = sv_dup_inc(proto_perl->Iutf8_toupper, param);
11161     PL_utf8_totitle     = sv_dup_inc(proto_perl->Iutf8_totitle, param);
11162     PL_utf8_tolower     = sv_dup_inc(proto_perl->Iutf8_tolower, param);
11163     PL_utf8_tofold      = sv_dup_inc(proto_perl->Iutf8_tofold, param);
11164     PL_utf8_idstart     = sv_dup_inc(proto_perl->Iutf8_idstart, param);
11165     PL_utf8_idcont      = sv_dup_inc(proto_perl->Iutf8_idcont, param);
11166
11167     /* Did the locale setup indicate UTF-8? */
11168     PL_utf8locale       = proto_perl->Iutf8locale;
11169     /* Unicode features (see perlrun/-C) */
11170     PL_unicode          = proto_perl->Iunicode;
11171
11172     /* Pre-5.8 signals control */
11173     PL_signals          = proto_perl->Isignals;
11174
11175     /* times() ticks per second */
11176     PL_clocktick        = proto_perl->Iclocktick;
11177
11178     /* Recursion stopper for PerlIO_find_layer */
11179     PL_in_load_module   = proto_perl->Iin_load_module;
11180
11181     /* sort() routine */
11182     PL_sort_RealCmp     = proto_perl->Isort_RealCmp;
11183
11184     /* Not really needed/useful since the reenrant_retint is "volatile",
11185      * but do it for consistency's sake. */
11186     PL_reentrant_retint = proto_perl->Ireentrant_retint;
11187
11188     /* Hooks to shared SVs and locks. */
11189     PL_sharehook        = proto_perl->Isharehook;
11190     PL_lockhook         = proto_perl->Ilockhook;
11191     PL_unlockhook       = proto_perl->Iunlockhook;
11192     PL_threadhook       = proto_perl->Ithreadhook;
11193
11194     PL_runops_std       = proto_perl->Irunops_std;
11195     PL_runops_dbg       = proto_perl->Irunops_dbg;
11196
11197 #ifdef THREADS_HAVE_PIDS
11198     PL_ppid             = proto_perl->Ippid;
11199 #endif
11200
11201     /* swatch cache */
11202     PL_last_swash_hv    = NULL; /* reinits on demand */
11203     PL_last_swash_klen  = 0;
11204     PL_last_swash_key[0]= '\0';
11205     PL_last_swash_tmps  = (U8*)NULL;
11206     PL_last_swash_slen  = 0;
11207
11208     PL_glob_index       = proto_perl->Iglob_index;
11209     PL_srand_called     = proto_perl->Isrand_called;
11210     PL_uudmap['M']      = 0;            /* reinits on demand */
11211     PL_bitcount         = NULL; /* reinits on demand */
11212
11213     if (proto_perl->Ipsig_pend) {
11214         Newxz(PL_psig_pend, SIG_SIZE, int);
11215     }
11216     else {
11217         PL_psig_pend    = (int*)NULL;
11218     }
11219
11220     if (proto_perl->Ipsig_ptr) {
11221         Newxz(PL_psig_ptr,  SIG_SIZE, SV*);
11222         Newxz(PL_psig_name, SIG_SIZE, SV*);
11223         for (i = 1; i < SIG_SIZE; i++) {
11224             PL_psig_ptr[i]  = sv_dup_inc(proto_perl->Ipsig_ptr[i], param);
11225             PL_psig_name[i] = sv_dup_inc(proto_perl->Ipsig_name[i], param);
11226         }
11227     }
11228     else {
11229         PL_psig_ptr     = (SV**)NULL;
11230         PL_psig_name    = (SV**)NULL;
11231     }
11232
11233     /* thrdvar.h stuff */
11234
11235     if (flags & CLONEf_COPY_STACKS) {
11236         /* next allocation will be PL_tmps_stack[PL_tmps_ix+1] */
11237         PL_tmps_ix              = proto_perl->Ttmps_ix;
11238         PL_tmps_max             = proto_perl->Ttmps_max;
11239         PL_tmps_floor           = proto_perl->Ttmps_floor;
11240         Newxz(PL_tmps_stack, PL_tmps_max, SV*);
11241         i = 0;
11242         while (i <= PL_tmps_ix) {
11243             PL_tmps_stack[i]    = sv_dup_inc(proto_perl->Ttmps_stack[i], param);
11244             ++i;
11245         }
11246
11247         /* next PUSHMARK() sets *(PL_markstack_ptr+1) */
11248         i = proto_perl->Tmarkstack_max - proto_perl->Tmarkstack;
11249         Newxz(PL_markstack, i, I32);
11250         PL_markstack_max        = PL_markstack + (proto_perl->Tmarkstack_max
11251                                                   - proto_perl->Tmarkstack);
11252         PL_markstack_ptr        = PL_markstack + (proto_perl->Tmarkstack_ptr
11253                                                   - proto_perl->Tmarkstack);
11254         Copy(proto_perl->Tmarkstack, PL_markstack,
11255              PL_markstack_ptr - PL_markstack + 1, I32);
11256
11257         /* next push_scope()/ENTER sets PL_scopestack[PL_scopestack_ix]
11258          * NOTE: unlike the others! */
11259         PL_scopestack_ix        = proto_perl->Tscopestack_ix;
11260         PL_scopestack_max       = proto_perl->Tscopestack_max;
11261         Newxz(PL_scopestack, PL_scopestack_max, I32);
11262         Copy(proto_perl->Tscopestack, PL_scopestack, PL_scopestack_ix, I32);
11263
11264         /* NOTE: si_dup() looks at PL_markstack */
11265         PL_curstackinfo         = si_dup(proto_perl->Tcurstackinfo, param);
11266
11267         /* PL_curstack          = PL_curstackinfo->si_stack; */
11268         PL_curstack             = av_dup(proto_perl->Tcurstack, param);
11269         PL_mainstack            = av_dup(proto_perl->Tmainstack, param);
11270
11271         /* next PUSHs() etc. set *(PL_stack_sp+1) */
11272         PL_stack_base           = AvARRAY(PL_curstack);
11273         PL_stack_sp             = PL_stack_base + (proto_perl->Tstack_sp
11274                                                    - proto_perl->Tstack_base);
11275         PL_stack_max            = PL_stack_base + AvMAX(PL_curstack);
11276
11277         /* next SSPUSHFOO() sets PL_savestack[PL_savestack_ix]
11278          * NOTE: unlike the others! */
11279         PL_savestack_ix         = proto_perl->Tsavestack_ix;
11280         PL_savestack_max        = proto_perl->Tsavestack_max;
11281         /*Newxz(PL_savestack, PL_savestack_max, ANY);*/
11282         PL_savestack            = ss_dup(proto_perl, param);
11283     }
11284     else {
11285         init_stacks();
11286         ENTER;                  /* perl_destruct() wants to LEAVE; */
11287
11288         /* although we're not duplicating the tmps stack, we should still
11289          * add entries for any SVs on the tmps stack that got cloned by a
11290          * non-refcount means (eg a temp in @_); otherwise they will be
11291          * orphaned
11292          */
11293         for (i = 0; i<= proto_perl->Ttmps_ix; i++) {
11294             SV * const nsv = (SV*)ptr_table_fetch(PL_ptr_table,
11295                     proto_perl->Ttmps_stack[i]);
11296             if (nsv && !SvREFCNT(nsv)) {
11297                 EXTEND_MORTAL(1);
11298                 PL_tmps_stack[++PL_tmps_ix] = SvREFCNT_inc_simple(nsv);
11299             }
11300         }
11301     }
11302
11303     PL_start_env        = proto_perl->Tstart_env;       /* XXXXXX */
11304     PL_top_env          = &PL_start_env;
11305
11306     PL_op               = proto_perl->Top;
11307
11308     PL_Sv               = NULL;
11309     PL_Xpv              = (XPV*)NULL;
11310     PL_na               = proto_perl->Tna;
11311
11312     PL_statbuf          = proto_perl->Tstatbuf;
11313     PL_statcache        = proto_perl->Tstatcache;
11314     PL_statgv           = gv_dup(proto_perl->Tstatgv, param);
11315     PL_statname         = sv_dup_inc(proto_perl->Tstatname, param);
11316 #ifdef HAS_TIMES
11317     PL_timesbuf         = proto_perl->Ttimesbuf;
11318 #endif
11319
11320     PL_tainted          = proto_perl->Ttainted;
11321     PL_curpm            = proto_perl->Tcurpm;   /* XXX No PMOP ref count */
11322     PL_rs               = sv_dup_inc(proto_perl->Trs, param);
11323     PL_last_in_gv       = gv_dup(proto_perl->Tlast_in_gv, param);
11324     PL_ofs_sv           = sv_dup_inc(proto_perl->Tofs_sv, param);
11325     PL_defoutgv         = gv_dup_inc(proto_perl->Tdefoutgv, param);
11326     PL_chopset          = proto_perl->Tchopset; /* XXX never deallocated */
11327     PL_toptarget        = sv_dup_inc(proto_perl->Ttoptarget, param);
11328     PL_bodytarget       = sv_dup_inc(proto_perl->Tbodytarget, param);
11329     PL_formtarget       = sv_dup(proto_perl->Tformtarget, param);
11330
11331     PL_restartop        = proto_perl->Trestartop;
11332     PL_in_eval          = proto_perl->Tin_eval;
11333     PL_delaymagic       = proto_perl->Tdelaymagic;
11334     PL_dirty            = proto_perl->Tdirty;
11335     PL_localizing       = proto_perl->Tlocalizing;
11336
11337     PL_errors           = sv_dup_inc(proto_perl->Terrors, param);
11338     PL_hv_fetch_ent_mh  = NULL;
11339     PL_modcount         = proto_perl->Tmodcount;
11340     PL_lastgotoprobe    = NULL;
11341     PL_dumpindent       = proto_perl->Tdumpindent;
11342
11343     PL_sortcop          = (OP*)any_dup(proto_perl->Tsortcop, proto_perl);
11344     PL_sortstash        = hv_dup(proto_perl->Tsortstash, param);
11345     PL_firstgv          = gv_dup(proto_perl->Tfirstgv, param);
11346     PL_secondgv         = gv_dup(proto_perl->Tsecondgv, param);
11347     PL_efloatbuf        = NULL;         /* reinits on demand */
11348     PL_efloatsize       = 0;                    /* reinits on demand */
11349
11350     /* regex stuff */
11351
11352     PL_screamfirst      = NULL;
11353     PL_screamnext       = NULL;
11354     PL_maxscream        = -1;                   /* reinits on demand */
11355     PL_lastscream       = NULL;
11356
11357     PL_watchaddr        = NULL;
11358     PL_watchok          = NULL;
11359
11360     PL_regdummy         = proto_perl->Tregdummy;
11361     PL_regprecomp       = NULL;
11362     PL_regnpar          = 0;
11363     PL_regsize          = 0;
11364     PL_colorset         = 0;            /* reinits PL_colors[] */
11365     /*PL_colors[6]      = {0,0,0,0,0,0};*/
11366     PL_reginput         = NULL;
11367     PL_regbol           = NULL;
11368     PL_regeol           = NULL;
11369     PL_regstartp        = (I32*)NULL;
11370     PL_regendp          = (I32*)NULL;
11371     PL_reglastparen     = (U32*)NULL;
11372     PL_reglastcloseparen        = (U32*)NULL;
11373     PL_regtill          = NULL;
11374     PL_reg_start_tmp    = (char**)NULL;
11375     PL_reg_start_tmpl   = 0;
11376     PL_regdata          = (struct reg_data*)NULL;
11377     PL_bostr            = NULL;
11378     PL_reg_flags        = 0;
11379     PL_reg_eval_set     = 0;
11380     PL_regnarrate       = 0;
11381     PL_regprogram       = (regnode*)NULL;
11382     PL_regindent        = 0;
11383     PL_regcc            = (CURCUR*)NULL;
11384     PL_reg_call_cc      = (struct re_cc_state*)NULL;
11385     PL_reg_re           = (regexp*)NULL;
11386     PL_reg_ganch        = NULL;
11387     PL_reg_sv           = NULL;
11388     PL_reg_match_utf8   = FALSE;
11389     PL_reg_magic        = (MAGIC*)NULL;
11390     PL_reg_oldpos       = 0;
11391     PL_reg_oldcurpm     = (PMOP*)NULL;
11392     PL_reg_curpm        = (PMOP*)NULL;
11393     PL_reg_oldsaved     = NULL;
11394     PL_reg_oldsavedlen  = 0;
11395 #ifdef PERL_OLD_COPY_ON_WRITE
11396     PL_nrs              = NULL;
11397 #endif
11398     PL_reg_maxiter      = 0;
11399     PL_reg_leftiter     = 0;
11400     PL_reg_poscache     = NULL;
11401     PL_reg_poscache_size= 0;
11402
11403     /* RE engine - function pointers */
11404     PL_regcompp         = proto_perl->Tregcompp;
11405     PL_regexecp         = proto_perl->Tregexecp;
11406     PL_regint_start     = proto_perl->Tregint_start;
11407     PL_regint_string    = proto_perl->Tregint_string;
11408     PL_regfree          = proto_perl->Tregfree;
11409
11410     PL_reginterp_cnt    = 0;
11411     PL_reg_starttry     = 0;
11412
11413     /* Pluggable optimizer */
11414     PL_peepp            = proto_perl->Tpeepp;
11415
11416     PL_stashcache       = newHV();
11417
11418     if (!(flags & CLONEf_KEEP_PTR_TABLE)) {
11419         ptr_table_free(PL_ptr_table);
11420         PL_ptr_table = NULL;
11421     }
11422
11423     /* Call the ->CLONE method, if it exists, for each of the stashes
11424        identified by sv_dup() above.
11425     */
11426     while(av_len(param->stashes) != -1) {
11427         HV* const stash = (HV*) av_shift(param->stashes);
11428         GV* const cloner = gv_fetchmethod_autoload(stash, "CLONE", 0);
11429         if (cloner && GvCV(cloner)) {
11430             dSP;
11431             ENTER;
11432             SAVETMPS;
11433             PUSHMARK(SP);
11434             XPUSHs(sv_2mortal(newSVhek(HvNAME_HEK(stash))));
11435             PUTBACK;
11436             call_sv((SV*)GvCV(cloner), G_DISCARD);
11437             FREETMPS;
11438             LEAVE;
11439         }
11440     }
11441
11442     SvREFCNT_dec(param->stashes);
11443
11444     /* orphaned? eg threads->new inside BEGIN or use */
11445     if (PL_compcv && ! SvREFCNT(PL_compcv)) {
11446         SvREFCNT_inc_simple_void(PL_compcv);
11447         SAVEFREESV(PL_compcv);
11448     }
11449
11450     return my_perl;
11451 }
11452
11453 #endif /* USE_ITHREADS */
11454
11455 /*
11456 =head1 Unicode Support
11457
11458 =for apidoc sv_recode_to_utf8
11459
11460 The encoding is assumed to be an Encode object, on entry the PV
11461 of the sv is assumed to be octets in that encoding, and the sv
11462 will be converted into Unicode (and UTF-8).
11463
11464 If the sv already is UTF-8 (or if it is not POK), or if the encoding
11465 is not a reference, nothing is done to the sv.  If the encoding is not
11466 an C<Encode::XS> Encoding object, bad things will happen.
11467 (See F<lib/encoding.pm> and L<Encode>).
11468
11469 The PV of the sv is returned.
11470
11471 =cut */
11472
11473 char *
11474 Perl_sv_recode_to_utf8(pTHX_ SV *sv, SV *encoding)
11475 {
11476     dVAR;
11477     if (SvPOK(sv) && !SvUTF8(sv) && !IN_BYTES && SvROK(encoding)) {
11478         SV *uni;
11479         STRLEN len;
11480         const char *s;
11481         dSP;
11482         ENTER;
11483         SAVETMPS;
11484         save_re_context();
11485         PUSHMARK(sp);
11486         EXTEND(SP, 3);
11487         XPUSHs(encoding);
11488         XPUSHs(sv);
11489 /*
11490   NI-S 2002/07/09
11491   Passing sv_yes is wrong - it needs to be or'ed set of constants
11492   for Encode::XS, while UTf-8 decode (currently) assumes a true value means
11493   remove converted chars from source.
11494
11495   Both will default the value - let them.
11496
11497         XPUSHs(&PL_sv_yes);
11498 */
11499         PUTBACK;
11500         call_method("decode", G_SCALAR);
11501         SPAGAIN;
11502         uni = POPs;
11503         PUTBACK;
11504         s = SvPV_const(uni, len);
11505         if (s != SvPVX_const(sv)) {
11506             SvGROW(sv, len + 1);
11507             Move(s, SvPVX(sv), len + 1, char);
11508             SvCUR_set(sv, len);
11509         }
11510         FREETMPS;
11511         LEAVE;
11512         SvUTF8_on(sv);
11513         return SvPVX(sv);
11514     }
11515     return SvPOKp(sv) ? SvPVX(sv) : NULL;
11516 }
11517
11518 /*
11519 =for apidoc sv_cat_decode
11520
11521 The encoding is assumed to be an Encode object, the PV of the ssv is
11522 assumed to be octets in that encoding and decoding the input starts
11523 from the position which (PV + *offset) pointed to.  The dsv will be
11524 concatenated the decoded UTF-8 string from ssv.  Decoding will terminate
11525 when the string tstr appears in decoding output or the input ends on
11526 the PV of the ssv. The value which the offset points will be modified
11527 to the last input position on the ssv.
11528
11529 Returns TRUE if the terminator was found, else returns FALSE.
11530
11531 =cut */
11532
11533 bool
11534 Perl_sv_cat_decode(pTHX_ SV *dsv, SV *encoding,
11535                    SV *ssv, int *offset, char *tstr, int tlen)
11536 {
11537     dVAR;
11538     bool ret = FALSE;
11539     if (SvPOK(ssv) && SvPOK(dsv) && SvROK(encoding) && offset) {
11540         SV *offsv;
11541         dSP;
11542         ENTER;
11543         SAVETMPS;
11544         save_re_context();
11545         PUSHMARK(sp);
11546         EXTEND(SP, 6);
11547         XPUSHs(encoding);
11548         XPUSHs(dsv);
11549         XPUSHs(ssv);
11550         XPUSHs(offsv = sv_2mortal(newSViv(*offset)));
11551         XPUSHs(sv_2mortal(newSVpvn(tstr, tlen)));
11552         PUTBACK;
11553         call_method("cat_decode", G_SCALAR);
11554         SPAGAIN;
11555         ret = SvTRUE(TOPs);
11556         *offset = SvIV(offsv);
11557         PUTBACK;
11558         FREETMPS;
11559         LEAVE;
11560     }
11561     else
11562         Perl_croak(aTHX_ "Invalid argument to sv_cat_decode");
11563     return ret;
11564
11565 }
11566
11567 /* ---------------------------------------------------------------------
11568  *
11569  * support functions for report_uninit()
11570  */
11571
11572 /* the maxiumum size of array or hash where we will scan looking
11573  * for the undefined element that triggered the warning */
11574
11575 #define FUV_MAX_SEARCH_SIZE 1000
11576
11577 /* Look for an entry in the hash whose value has the same SV as val;
11578  * If so, return a mortal copy of the key. */
11579
11580 STATIC SV*
11581 S_find_hash_subscript(pTHX_ HV *hv, SV* val)
11582 {
11583     dVAR;
11584     register HE **array;
11585     I32 i;
11586
11587     if (!hv || SvMAGICAL(hv) || !HvARRAY(hv) ||
11588                         (HvTOTALKEYS(hv) > FUV_MAX_SEARCH_SIZE))
11589         return NULL;
11590
11591     array = HvARRAY(hv);
11592
11593     for (i=HvMAX(hv); i>0; i--) {
11594         register HE *entry;
11595         for (entry = array[i]; entry; entry = HeNEXT(entry)) {
11596             if (HeVAL(entry) != val)
11597                 continue;
11598             if (    HeVAL(entry) == &PL_sv_undef ||
11599                     HeVAL(entry) == &PL_sv_placeholder)
11600                 continue;
11601             if (!HeKEY(entry))
11602                 return NULL;
11603             if (HeKLEN(entry) == HEf_SVKEY)
11604                 return sv_mortalcopy(HeKEY_sv(entry));
11605             return sv_2mortal(newSVpvn(HeKEY(entry), HeKLEN(entry)));
11606         }
11607     }
11608     return NULL;
11609 }
11610
11611 /* Look for an entry in the array whose value has the same SV as val;
11612  * If so, return the index, otherwise return -1. */
11613
11614 STATIC I32
11615 S_find_array_subscript(pTHX_ AV *av, SV* val)
11616 {
11617     dVAR;
11618     SV** svp;
11619     I32 i;
11620     if (!av || SvMAGICAL(av) || !AvARRAY(av) ||
11621                         (AvFILLp(av) > FUV_MAX_SEARCH_SIZE))
11622         return -1;
11623
11624     svp = AvARRAY(av);
11625     for (i=AvFILLp(av); i>=0; i--) {
11626         if (svp[i] == val && svp[i] != &PL_sv_undef)
11627             return i;
11628     }
11629     return -1;
11630 }
11631
11632 /* S_varname(): return the name of a variable, optionally with a subscript.
11633  * If gv is non-zero, use the name of that global, along with gvtype (one
11634  * of "$", "@", "%"); otherwise use the name of the lexical at pad offset
11635  * targ.  Depending on the value of the subscript_type flag, return:
11636  */
11637
11638 #define FUV_SUBSCRIPT_NONE      1       /* "@foo"          */
11639 #define FUV_SUBSCRIPT_ARRAY     2       /* "$foo[aindex]"  */
11640 #define FUV_SUBSCRIPT_HASH      3       /* "$foo{keyname}" */
11641 #define FUV_SUBSCRIPT_WITHIN    4       /* "within @foo"   */
11642
11643 STATIC SV*
11644 S_varname(pTHX_ GV *gv, const char gvtype, PADOFFSET targ,
11645         SV* keyname, I32 aindex, int subscript_type)
11646 {
11647
11648     SV * const name = sv_newmortal();
11649     if (gv) {
11650         char buffer[2];
11651         buffer[0] = gvtype;
11652         buffer[1] = 0;
11653
11654         /* as gv_fullname4(), but add literal '^' for $^FOO names  */
11655
11656         gv_fullname4(name, gv, buffer, 0);
11657
11658         if ((unsigned int)SvPVX(name)[1] <= 26) {
11659             buffer[0] = '^';
11660             buffer[1] = SvPVX(name)[1] + 'A' - 1;
11661
11662             /* Swap the 1 unprintable control character for the 2 byte pretty
11663                version - ie substr($name, 1, 1) = $buffer; */
11664             sv_insert(name, 1, 1, buffer, 2);
11665         }
11666     }
11667     else {
11668         U32 unused;
11669         CV * const cv = find_runcv(&unused);
11670         SV *sv;
11671         AV *av;
11672
11673         if (!cv || !CvPADLIST(cv))
11674             return NULL;
11675         av = (AV*)(*av_fetch(CvPADLIST(cv), 0, FALSE));
11676         sv = *av_fetch(av, targ, FALSE);
11677         /* SvLEN in a pad name is not to be trusted */
11678         sv_setpv(name, SvPV_nolen_const(sv));
11679     }
11680
11681     if (subscript_type == FUV_SUBSCRIPT_HASH) {
11682         SV * const sv = newSV(0);
11683         *SvPVX(name) = '$';
11684         Perl_sv_catpvf(aTHX_ name, "{%s}",
11685             pv_display(sv,SvPVX_const(keyname), SvCUR(keyname), 0, 32));
11686         SvREFCNT_dec(sv);
11687     }
11688     else if (subscript_type == FUV_SUBSCRIPT_ARRAY) {
11689         *SvPVX(name) = '$';
11690         Perl_sv_catpvf(aTHX_ name, "[%"IVdf"]", (IV)aindex);
11691     }
11692     else if (subscript_type == FUV_SUBSCRIPT_WITHIN)
11693         Perl_sv_insert(aTHX_ name, 0, 0,  STR_WITH_LEN("within "));
11694
11695     return name;
11696 }
11697
11698
11699 /*
11700 =for apidoc find_uninit_var
11701
11702 Find the name of the undefined variable (if any) that caused the operator o
11703 to issue a "Use of uninitialized value" warning.
11704 If match is true, only return a name if it's value matches uninit_sv.
11705 So roughly speaking, if a unary operator (such as OP_COS) generates a
11706 warning, then following the direct child of the op may yield an
11707 OP_PADSV or OP_GV that gives the name of the undefined variable. On the
11708 other hand, with OP_ADD there are two branches to follow, so we only print
11709 the variable name if we get an exact match.
11710
11711 The name is returned as a mortal SV.
11712
11713 Assumes that PL_op is the op that originally triggered the error, and that
11714 PL_comppad/PL_curpad points to the currently executing pad.
11715
11716 =cut
11717 */
11718
11719 STATIC SV *
11720 S_find_uninit_var(pTHX_ OP* obase, SV* uninit_sv, bool match)
11721 {
11722     dVAR;
11723     SV *sv;
11724     AV *av;
11725     GV *gv;
11726     OP *o, *o2, *kid;
11727
11728     if (!obase || (match && (!uninit_sv || uninit_sv == &PL_sv_undef ||
11729                             uninit_sv == &PL_sv_placeholder)))
11730         return NULL;
11731
11732     switch (obase->op_type) {
11733
11734     case OP_RV2AV:
11735     case OP_RV2HV:
11736     case OP_PADAV:
11737     case OP_PADHV:
11738       {
11739         const bool pad  = (obase->op_type == OP_PADAV || obase->op_type == OP_PADHV);
11740         const bool hash = (obase->op_type == OP_PADHV || obase->op_type == OP_RV2HV);
11741         I32 index = 0;
11742         SV *keysv = NULL;
11743         int subscript_type = FUV_SUBSCRIPT_WITHIN;
11744
11745         if (pad) { /* @lex, %lex */
11746             sv = PAD_SVl(obase->op_targ);
11747             gv = NULL;
11748         }
11749         else {
11750             if (cUNOPx(obase)->op_first->op_type == OP_GV) {
11751             /* @global, %global */
11752                 gv = cGVOPx_gv(cUNOPx(obase)->op_first);
11753                 if (!gv)
11754                     break;
11755                 sv = hash ? (SV*)GvHV(gv): (SV*)GvAV(gv);
11756             }
11757             else /* @{expr}, %{expr} */
11758                 return find_uninit_var(cUNOPx(obase)->op_first,
11759                                                     uninit_sv, match);
11760         }
11761
11762         /* attempt to find a match within the aggregate */
11763         if (hash) {
11764             keysv = S_find_hash_subscript(aTHX_ (HV*)sv, uninit_sv);
11765             if (keysv)
11766                 subscript_type = FUV_SUBSCRIPT_HASH;
11767         }
11768         else {
11769             index = S_find_array_subscript(aTHX_ (AV*)sv, uninit_sv);
11770             if (index >= 0)
11771                 subscript_type = FUV_SUBSCRIPT_ARRAY;
11772         }
11773
11774         if (match && subscript_type == FUV_SUBSCRIPT_WITHIN)
11775             break;
11776
11777         return varname(gv, hash ? '%' : '@', obase->op_targ,
11778                                     keysv, index, subscript_type);
11779       }
11780
11781     case OP_PADSV:
11782         if (match && PAD_SVl(obase->op_targ) != uninit_sv)
11783             break;
11784         return varname(NULL, '$', obase->op_targ,
11785                                     NULL, 0, FUV_SUBSCRIPT_NONE);
11786
11787     case OP_GVSV:
11788         gv = cGVOPx_gv(obase);
11789         if (!gv || (match && GvSV(gv) != uninit_sv))
11790             break;
11791         return varname(gv, '$', 0, NULL, 0, FUV_SUBSCRIPT_NONE);
11792
11793     case OP_AELEMFAST:
11794         if (obase->op_flags & OPf_SPECIAL) { /* lexical array */
11795             if (match) {
11796                 SV **svp;
11797                 av = (AV*)PAD_SV(obase->op_targ);
11798                 if (!av || SvRMAGICAL(av))
11799                     break;
11800                 svp = av_fetch(av, (I32)obase->op_private, FALSE);
11801                 if (!svp || *svp != uninit_sv)
11802                     break;
11803             }
11804             return varname(NULL, '$', obase->op_targ,
11805                     NULL, (I32)obase->op_private, FUV_SUBSCRIPT_ARRAY);
11806         }
11807         else {
11808             gv = cGVOPx_gv(obase);
11809             if (!gv)
11810                 break;
11811             if (match) {
11812                 SV **svp;
11813                 av = GvAV(gv);
11814                 if (!av || SvRMAGICAL(av))
11815                     break;
11816                 svp = av_fetch(av, (I32)obase->op_private, FALSE);
11817                 if (!svp || *svp != uninit_sv)
11818                     break;
11819             }
11820             return varname(gv, '$', 0,
11821                     NULL, (I32)obase->op_private, FUV_SUBSCRIPT_ARRAY);
11822         }
11823         break;
11824
11825     case OP_EXISTS:
11826         o = cUNOPx(obase)->op_first;
11827         if (!o || o->op_type != OP_NULL ||
11828                 ! (o->op_targ == OP_AELEM || o->op_targ == OP_HELEM))
11829             break;
11830         return find_uninit_var(cBINOPo->op_last, uninit_sv, match);
11831
11832     case OP_AELEM:
11833     case OP_HELEM:
11834         if (PL_op == obase)
11835             /* $a[uninit_expr] or $h{uninit_expr} */
11836             return find_uninit_var(cBINOPx(obase)->op_last, uninit_sv, match);
11837
11838         gv = NULL;
11839         o = cBINOPx(obase)->op_first;
11840         kid = cBINOPx(obase)->op_last;
11841
11842         /* get the av or hv, and optionally the gv */
11843         sv = NULL;
11844         if  (o->op_type == OP_PADAV || o->op_type == OP_PADHV) {
11845             sv = PAD_SV(o->op_targ);
11846         }
11847         else if ((o->op_type == OP_RV2AV || o->op_type == OP_RV2HV)
11848                 && cUNOPo->op_first->op_type == OP_GV)
11849         {
11850             gv = cGVOPx_gv(cUNOPo->op_first);
11851             if (!gv)
11852                 break;
11853             sv = o->op_type == OP_RV2HV ? (SV*)GvHV(gv) : (SV*)GvAV(gv);
11854         }
11855         if (!sv)
11856             break;
11857
11858         if (kid && kid->op_type == OP_CONST && SvOK(cSVOPx_sv(kid))) {
11859             /* index is constant */
11860             if (match) {
11861                 if (SvMAGICAL(sv))
11862                     break;
11863                 if (obase->op_type == OP_HELEM) {
11864                     HE* he = hv_fetch_ent((HV*)sv, cSVOPx_sv(kid), 0, 0);
11865                     if (!he || HeVAL(he) != uninit_sv)
11866                         break;
11867                 }
11868                 else {
11869                     SV * const * const svp = av_fetch((AV*)sv, SvIV(cSVOPx_sv(kid)), FALSE);
11870                     if (!svp || *svp != uninit_sv)
11871                         break;
11872                 }
11873             }
11874             if (obase->op_type == OP_HELEM)
11875                 return varname(gv, '%', o->op_targ,
11876                             cSVOPx_sv(kid), 0, FUV_SUBSCRIPT_HASH);
11877             else
11878                 return varname(gv, '@', o->op_targ, NULL,
11879                             SvIV(cSVOPx_sv(kid)), FUV_SUBSCRIPT_ARRAY);
11880         }
11881         else  {
11882             /* index is an expression;
11883              * attempt to find a match within the aggregate */
11884             if (obase->op_type == OP_HELEM) {
11885                 SV * const keysv = S_find_hash_subscript(aTHX_ (HV*)sv, uninit_sv);
11886                 if (keysv)
11887                     return varname(gv, '%', o->op_targ,
11888                                                 keysv, 0, FUV_SUBSCRIPT_HASH);
11889             }
11890             else {
11891                 const I32 index = S_find_array_subscript(aTHX_ (AV*)sv, uninit_sv);
11892                 if (index >= 0)
11893                     return varname(gv, '@', o->op_targ,
11894                                         NULL, index, FUV_SUBSCRIPT_ARRAY);
11895             }
11896             if (match)
11897                 break;
11898             return varname(gv,
11899                 (o->op_type == OP_PADAV || o->op_type == OP_RV2AV)
11900                 ? '@' : '%',
11901                 o->op_targ, NULL, 0, FUV_SUBSCRIPT_WITHIN);
11902         }
11903         break;
11904
11905     case OP_AASSIGN:
11906         /* only examine RHS */
11907         return find_uninit_var(cBINOPx(obase)->op_first, uninit_sv, match);
11908
11909     case OP_OPEN:
11910         o = cUNOPx(obase)->op_first;
11911         if (o->op_type == OP_PUSHMARK)
11912             o = o->op_sibling;
11913
11914         if (!o->op_sibling) {
11915             /* one-arg version of open is highly magical */
11916
11917             if (o->op_type == OP_GV) { /* open FOO; */
11918                 gv = cGVOPx_gv(o);
11919                 if (match && GvSV(gv) != uninit_sv)
11920                     break;
11921                 return varname(gv, '$', 0,
11922                             NULL, 0, FUV_SUBSCRIPT_NONE);
11923             }
11924             /* other possibilities not handled are:
11925              * open $x; or open my $x;  should return '${*$x}'
11926              * open expr;               should return '$'.expr ideally
11927              */
11928              break;
11929         }
11930         goto do_op;
11931
11932     /* ops where $_ may be an implicit arg */
11933     case OP_TRANS:
11934     case OP_SUBST:
11935     case OP_MATCH:
11936         if ( !(obase->op_flags & OPf_STACKED)) {
11937             if (uninit_sv == ((obase->op_private & OPpTARGET_MY)
11938                                  ? PAD_SVl(obase->op_targ)
11939                                  : DEFSV))
11940             {
11941                 sv = sv_newmortal();
11942                 sv_setpvn(sv, "$_", 2);
11943                 return sv;
11944             }
11945         }
11946         goto do_op;
11947
11948     case OP_PRTF:
11949     case OP_PRINT:
11950         /* skip filehandle as it can't produce 'undef' warning  */
11951         o = cUNOPx(obase)->op_first;
11952         if ((obase->op_flags & OPf_STACKED) && o->op_type == OP_PUSHMARK)
11953             o = o->op_sibling->op_sibling;
11954         goto do_op2;
11955
11956
11957     case OP_RV2SV:
11958     case OP_CUSTOM:
11959     case OP_ENTERSUB:
11960         match = 1; /* XS or custom code could trigger random warnings */
11961         goto do_op;
11962
11963     case OP_SCHOMP:
11964     case OP_CHOMP:
11965         if (SvROK(PL_rs) && uninit_sv == SvRV(PL_rs))
11966             return sv_2mortal(newSVpvs("${$/}"));
11967         /*FALLTHROUGH*/
11968
11969     default:
11970     do_op:
11971         if (!(obase->op_flags & OPf_KIDS))
11972             break;
11973         o = cUNOPx(obase)->op_first;
11974         
11975     do_op2:
11976         if (!o)
11977             break;
11978
11979         /* if all except one arg are constant, or have no side-effects,
11980          * or are optimized away, then it's unambiguous */
11981         o2 = NULL;
11982         for (kid=o; kid; kid = kid->op_sibling) {
11983             if (kid &&
11984                 (    (kid->op_type == OP_CONST && SvOK(cSVOPx_sv(kid)))
11985                   || (kid->op_type == OP_NULL  && ! (kid->op_flags & OPf_KIDS))
11986                   || (kid->op_type == OP_PUSHMARK)
11987                 )
11988             )
11989                 continue;
11990             if (o2) { /* more than one found */
11991                 o2 = NULL;
11992                 break;
11993             }
11994             o2 = kid;
11995         }
11996         if (o2)
11997             return find_uninit_var(o2, uninit_sv, match);
11998
11999         /* scan all args */
12000         while (o) {
12001             sv = find_uninit_var(o, uninit_sv, 1);
12002             if (sv)
12003                 return sv;
12004             o = o->op_sibling;
12005         }
12006         break;
12007     }
12008     return NULL;
12009 }
12010
12011
12012 /*
12013 =for apidoc report_uninit
12014
12015 Print appropriate "Use of uninitialized variable" warning
12016
12017 =cut
12018 */
12019
12020 void
12021 Perl_report_uninit(pTHX_ SV* uninit_sv)
12022 {
12023     dVAR;
12024     if (PL_op) {
12025         SV* varname = NULL;
12026         if (uninit_sv) {
12027             varname = find_uninit_var(PL_op, uninit_sv,0);
12028             if (varname)
12029                 sv_insert(varname, 0, 0, " ", 1);
12030         }
12031         Perl_warner(aTHX_ packWARN(WARN_UNINITIALIZED), PL_warn_uninit,
12032                 varname ? SvPV_nolen_const(varname) : "",
12033                 " in ", OP_DESC(PL_op));
12034     }
12035     else
12036         Perl_warner(aTHX_ packWARN(WARN_UNINITIALIZED), PL_warn_uninit,
12037                     "", "", "");
12038 }
12039
12040 /*
12041  * Local variables:
12042  * c-indentation-style: bsd
12043  * c-basic-offset: 4
12044  * indent-tabs-mode: t
12045  * End:
12046  *
12047  * ex: set ts=8 sts=4 sw=4 noet:
12048  */