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