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