This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
patch@27082 Allow fatal exceptions to bring up VMS debugger
[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         /* FALL THROUGH */
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     /* FALL THROUGH */
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                    Nullop,
7036                    Nullop);
7037             LEAVE;
7038             if (!GvCVu(gv))
7039                 Perl_croak(aTHX_ "Unable to create sub named \"%"SVf"\"",
7040                            sv);
7041         }
7042         return GvCVu(gv);
7043     }
7044 }
7045
7046 /*
7047 =for apidoc sv_true
7048
7049 Returns true if the SV has a true value by Perl's rules.
7050 Use the C<SvTRUE> macro instead, which may call C<sv_true()> or may
7051 instead use an in-line version.
7052
7053 =cut
7054 */
7055
7056 I32
7057 Perl_sv_true(pTHX_ register SV *sv)
7058 {
7059     if (!sv)
7060         return 0;
7061     if (SvPOK(sv)) {
7062         register const XPV* const tXpv = (XPV*)SvANY(sv);
7063         if (tXpv &&
7064                 (tXpv->xpv_cur > 1 ||
7065                 (tXpv->xpv_cur && *sv->sv_u.svu_pv != '0')))
7066             return 1;
7067         else
7068             return 0;
7069     }
7070     else {
7071         if (SvIOK(sv))
7072             return SvIVX(sv) != 0;
7073         else {
7074             if (SvNOK(sv))
7075                 return SvNVX(sv) != 0.0;
7076             else
7077                 return sv_2bool(sv);
7078         }
7079     }
7080 }
7081
7082 /*
7083 =for apidoc sv_pvn_force
7084
7085 Get a sensible string out of the SV somehow.
7086 A private implementation of the C<SvPV_force> macro for compilers which
7087 can't cope with complex macro expressions. Always use the macro instead.
7088
7089 =for apidoc sv_pvn_force_flags
7090
7091 Get a sensible string out of the SV somehow.
7092 If C<flags> has C<SV_GMAGIC> bit set, will C<mg_get> on C<sv> if
7093 appropriate, else not. C<sv_pvn_force> and C<sv_pvn_force_nomg> are
7094 implemented in terms of this function.
7095 You normally want to use the various wrapper macros instead: see
7096 C<SvPV_force> and C<SvPV_force_nomg>
7097
7098 =cut
7099 */
7100
7101 char *
7102 Perl_sv_pvn_force_flags(pTHX_ SV *sv, STRLEN *lp, I32 flags)
7103 {
7104     dVAR;
7105     if (SvTHINKFIRST(sv) && !SvROK(sv))
7106         sv_force_normal_flags(sv, 0);
7107
7108     if (SvPOK(sv)) {
7109         if (lp)
7110             *lp = SvCUR(sv);
7111     }
7112     else {
7113         char *s;
7114         STRLEN len;
7115  
7116         if (SvREADONLY(sv) && !(flags & SV_MUTABLE_RETURN)) {
7117             const char * const ref = sv_reftype(sv,0);
7118             if (PL_op)
7119                 Perl_croak(aTHX_ "Can't coerce readonly %s to string in %s",
7120                            ref, OP_NAME(PL_op));
7121             else
7122                 Perl_croak(aTHX_ "Can't coerce readonly %s to string", ref);
7123         }
7124         if (SvTYPE(sv) > SVt_PVLV && SvTYPE(sv) != SVt_PVFM)
7125             Perl_croak(aTHX_ "Can't coerce %s to string in %s", sv_reftype(sv,0),
7126                 OP_NAME(PL_op));
7127         s = sv_2pv_flags(sv, &len, flags);
7128         if (lp)
7129             *lp = len;
7130
7131         if (s != SvPVX_const(sv)) {     /* Almost, but not quite, sv_setpvn() */
7132             if (SvROK(sv))
7133                 sv_unref(sv);
7134             SvUPGRADE(sv, SVt_PV);              /* Never FALSE */
7135             SvGROW(sv, len + 1);
7136             Move(s,SvPVX(sv),len,char);
7137             SvCUR_set(sv, len);
7138             *SvEND(sv) = '\0';
7139         }
7140         if (!SvPOK(sv)) {
7141             SvPOK_on(sv);               /* validate pointer */
7142             SvTAINT(sv);
7143             DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2pv(%s)\n",
7144                                   PTR2UV(sv),SvPVX_const(sv)));
7145         }
7146     }
7147     return SvPVX_mutable(sv);
7148 }
7149
7150 /*
7151 =for apidoc sv_pvbyten_force
7152
7153 The backend for the C<SvPVbytex_force> macro. Always use the macro instead.
7154
7155 =cut
7156 */
7157
7158 char *
7159 Perl_sv_pvbyten_force(pTHX_ SV *sv, STRLEN *lp)
7160 {
7161     sv_pvn_force(sv,lp);
7162     sv_utf8_downgrade(sv,0);
7163     *lp = SvCUR(sv);
7164     return SvPVX(sv);
7165 }
7166
7167 /*
7168 =for apidoc sv_pvutf8n_force
7169
7170 The backend for the C<SvPVutf8x_force> macro. Always use the macro instead.
7171
7172 =cut
7173 */
7174
7175 char *
7176 Perl_sv_pvutf8n_force(pTHX_ SV *sv, STRLEN *lp)
7177 {
7178     sv_pvn_force(sv,lp);
7179     sv_utf8_upgrade(sv);
7180     *lp = SvCUR(sv);
7181     return SvPVX(sv);
7182 }
7183
7184 /*
7185 =for apidoc sv_reftype
7186
7187 Returns a string describing what the SV is a reference to.
7188
7189 =cut
7190 */
7191
7192 char *
7193 Perl_sv_reftype(pTHX_ const SV *sv, int ob)
7194 {
7195     /* The fact that I don't need to downcast to char * everywhere, only in ?:
7196        inside return suggests a const propagation bug in g++.  */
7197     if (ob && SvOBJECT(sv)) {
7198         char * const name = HvNAME_get(SvSTASH(sv));
7199         return name ? name : (char *) "__ANON__";
7200     }
7201     else {
7202         switch (SvTYPE(sv)) {
7203         case SVt_NULL:
7204         case SVt_IV:
7205         case SVt_NV:
7206         case SVt_RV:
7207         case SVt_PV:
7208         case SVt_PVIV:
7209         case SVt_PVNV:
7210         case SVt_PVMG:
7211         case SVt_PVBM:
7212                                 if (SvVOK(sv))
7213                                     return "VSTRING";
7214                                 if (SvROK(sv))
7215                                     return "REF";
7216                                 else
7217                                     return "SCALAR";
7218
7219         case SVt_PVLV:          return (char *)  (SvROK(sv) ? "REF"
7220                                 /* tied lvalues should appear to be
7221                                  * scalars for backwards compatitbility */
7222                                 : (LvTYPE(sv) == 't' || LvTYPE(sv) == 'T')
7223                                     ? "SCALAR" : "LVALUE");
7224         case SVt_PVAV:          return "ARRAY";
7225         case SVt_PVHV:          return "HASH";
7226         case SVt_PVCV:          return "CODE";
7227         case SVt_PVGV:          return "GLOB";
7228         case SVt_PVFM:          return "FORMAT";
7229         case SVt_PVIO:          return "IO";
7230         default:                return "UNKNOWN";
7231         }
7232     }
7233 }
7234
7235 /*
7236 =for apidoc sv_isobject
7237
7238 Returns a boolean indicating whether the SV is an RV pointing to a blessed
7239 object.  If the SV is not an RV, or if the object is not blessed, then this
7240 will return false.
7241
7242 =cut
7243 */
7244
7245 int
7246 Perl_sv_isobject(pTHX_ SV *sv)
7247 {
7248     if (!sv)
7249         return 0;
7250     SvGETMAGIC(sv);
7251     if (!SvROK(sv))
7252         return 0;
7253     sv = (SV*)SvRV(sv);
7254     if (!SvOBJECT(sv))
7255         return 0;
7256     return 1;
7257 }
7258
7259 /*
7260 =for apidoc sv_isa
7261
7262 Returns a boolean indicating whether the SV is blessed into the specified
7263 class.  This does not check for subtypes; use C<sv_derived_from> to verify
7264 an inheritance relationship.
7265
7266 =cut
7267 */
7268
7269 int
7270 Perl_sv_isa(pTHX_ SV *sv, const char *name)
7271 {
7272     const char *hvname;
7273     if (!sv)
7274         return 0;
7275     SvGETMAGIC(sv);
7276     if (!SvROK(sv))
7277         return 0;
7278     sv = (SV*)SvRV(sv);
7279     if (!SvOBJECT(sv))
7280         return 0;
7281     hvname = HvNAME_get(SvSTASH(sv));
7282     if (!hvname)
7283         return 0;
7284
7285     return strEQ(hvname, name);
7286 }
7287
7288 /*
7289 =for apidoc newSVrv
7290
7291 Creates a new SV for the RV, C<rv>, to point to.  If C<rv> is not an RV then
7292 it will be upgraded to one.  If C<classname> is non-null then the new SV will
7293 be blessed in the specified package.  The new SV is returned and its
7294 reference count is 1.
7295
7296 =cut
7297 */
7298
7299 SV*
7300 Perl_newSVrv(pTHX_ SV *rv, const char *classname)
7301 {
7302     dVAR;
7303     SV *sv;
7304
7305     new_SV(sv);
7306
7307     SV_CHECK_THINKFIRST_COW_DROP(rv);
7308     SvAMAGIC_off(rv);
7309
7310     if (SvTYPE(rv) >= SVt_PVMG) {
7311         const U32 refcnt = SvREFCNT(rv);
7312         SvREFCNT(rv) = 0;
7313         sv_clear(rv);
7314         SvFLAGS(rv) = 0;
7315         SvREFCNT(rv) = refcnt;
7316     }
7317
7318     if (SvTYPE(rv) < SVt_RV)
7319         sv_upgrade(rv, SVt_RV);
7320     else if (SvTYPE(rv) > SVt_RV) {
7321         SvPV_free(rv);
7322         SvCUR_set(rv, 0);
7323         SvLEN_set(rv, 0);
7324     }
7325
7326     SvOK_off(rv);
7327     SvRV_set(rv, sv);
7328     SvROK_on(rv);
7329
7330     if (classname) {
7331         HV* const stash = gv_stashpv(classname, TRUE);
7332         (void)sv_bless(rv, stash);
7333     }
7334     return sv;
7335 }
7336
7337 /*
7338 =for apidoc sv_setref_pv
7339
7340 Copies a pointer into a new SV, optionally blessing the SV.  The C<rv>
7341 argument will be upgraded to an RV.  That RV will be modified to point to
7342 the new SV.  If the C<pv> argument is NULL then C<PL_sv_undef> will be placed
7343 into the SV.  The C<classname> argument indicates the package for the
7344 blessing.  Set C<classname> to C<NULL> to avoid the blessing.  The new SV
7345 will have a reference count of 1, and the RV will be returned.
7346
7347 Do not use with other Perl types such as HV, AV, SV, CV, because those
7348 objects will become corrupted by the pointer copy process.
7349
7350 Note that C<sv_setref_pvn> copies the string while this copies the pointer.
7351
7352 =cut
7353 */
7354
7355 SV*
7356 Perl_sv_setref_pv(pTHX_ SV *rv, const char *classname, void *pv)
7357 {
7358     dVAR;
7359     if (!pv) {
7360         sv_setsv(rv, &PL_sv_undef);
7361         SvSETMAGIC(rv);
7362     }
7363     else
7364         sv_setiv(newSVrv(rv,classname), PTR2IV(pv));
7365     return rv;
7366 }
7367
7368 /*
7369 =for apidoc sv_setref_iv
7370
7371 Copies an integer into a new SV, optionally blessing the SV.  The C<rv>
7372 argument will be upgraded to an RV.  That RV will be modified to point to
7373 the new SV.  The C<classname> argument indicates the package for the
7374 blessing.  Set C<classname> to C<NULL> to avoid the blessing.  The new SV
7375 will have a reference count of 1, and the RV will be returned.
7376
7377 =cut
7378 */
7379
7380 SV*
7381 Perl_sv_setref_iv(pTHX_ SV *rv, const char *classname, IV iv)
7382 {
7383     sv_setiv(newSVrv(rv,classname), iv);
7384     return rv;
7385 }
7386
7387 /*
7388 =for apidoc sv_setref_uv
7389
7390 Copies an unsigned integer into a new SV, optionally blessing the SV.  The C<rv>
7391 argument will be upgraded to an RV.  That RV will be modified to point to
7392 the new SV.  The C<classname> argument indicates the package for the
7393 blessing.  Set C<classname> to C<NULL> to avoid the blessing.  The new SV
7394 will have a reference count of 1, and the RV will be returned.
7395
7396 =cut
7397 */
7398
7399 SV*
7400 Perl_sv_setref_uv(pTHX_ SV *rv, const char *classname, UV uv)
7401 {
7402     sv_setuv(newSVrv(rv,classname), uv);
7403     return rv;
7404 }
7405
7406 /*
7407 =for apidoc sv_setref_nv
7408
7409 Copies a double into a new SV, optionally blessing the SV.  The C<rv>
7410 argument will be upgraded to an RV.  That RV will be modified to point to
7411 the new SV.  The C<classname> argument indicates the package for the
7412 blessing.  Set C<classname> to C<NULL> to avoid the blessing.  The new SV
7413 will have a reference count of 1, and the RV will be returned.
7414
7415 =cut
7416 */
7417
7418 SV*
7419 Perl_sv_setref_nv(pTHX_ SV *rv, const char *classname, NV nv)
7420 {
7421     sv_setnv(newSVrv(rv,classname), nv);
7422     return rv;
7423 }
7424
7425 /*
7426 =for apidoc sv_setref_pvn
7427
7428 Copies a string into a new SV, optionally blessing the SV.  The length of the
7429 string must be specified with C<n>.  The C<rv> argument will be upgraded to
7430 an RV.  That RV will be modified to point to the new SV.  The C<classname>
7431 argument indicates the package for the blessing.  Set C<classname> to
7432 C<NULL> to avoid the blessing.  The new SV will have a reference count
7433 of 1, and the RV will be returned.
7434
7435 Note that C<sv_setref_pv> copies the pointer while this copies the string.
7436
7437 =cut
7438 */
7439
7440 SV*
7441 Perl_sv_setref_pvn(pTHX_ SV *rv, const char *classname, const char *pv, STRLEN n)
7442 {
7443     sv_setpvn(newSVrv(rv,classname), pv, n);
7444     return rv;
7445 }
7446
7447 /*
7448 =for apidoc sv_bless
7449
7450 Blesses an SV into a specified package.  The SV must be an RV.  The package
7451 must be designated by its stash (see C<gv_stashpv()>).  The reference count
7452 of the SV is unaffected.
7453
7454 =cut
7455 */
7456
7457 SV*
7458 Perl_sv_bless(pTHX_ SV *sv, HV *stash)
7459 {
7460     dVAR;
7461     SV *tmpRef;
7462     if (!SvROK(sv))
7463         Perl_croak(aTHX_ "Can't bless non-reference value");
7464     tmpRef = SvRV(sv);
7465     if (SvFLAGS(tmpRef) & (SVs_OBJECT|SVf_READONLY)) {
7466         if (SvREADONLY(tmpRef))
7467             Perl_croak(aTHX_ PL_no_modify);
7468         if (SvOBJECT(tmpRef)) {
7469             if (SvTYPE(tmpRef) != SVt_PVIO)
7470                 --PL_sv_objcount;
7471             SvREFCNT_dec(SvSTASH(tmpRef));
7472         }
7473     }
7474     SvOBJECT_on(tmpRef);
7475     if (SvTYPE(tmpRef) != SVt_PVIO)
7476         ++PL_sv_objcount;
7477     SvUPGRADE(tmpRef, SVt_PVMG);
7478     SvSTASH_set(tmpRef, (HV*)SvREFCNT_inc(stash));
7479
7480     if (Gv_AMG(stash))
7481         SvAMAGIC_on(sv);
7482     else
7483         SvAMAGIC_off(sv);
7484
7485     if(SvSMAGICAL(tmpRef))
7486         if(mg_find(tmpRef, PERL_MAGIC_ext) || mg_find(tmpRef, PERL_MAGIC_uvar))
7487             mg_set(tmpRef);
7488
7489
7490
7491     return sv;
7492 }
7493
7494 /* Downgrades a PVGV to a PVMG.
7495  */
7496
7497 STATIC void
7498 S_sv_unglob(pTHX_ SV *sv)
7499 {
7500     dVAR;
7501     void *xpvmg;
7502
7503     assert(SvTYPE(sv) == SVt_PVGV);
7504     SvFAKE_off(sv);
7505     if (GvGP(sv))
7506         gp_free((GV*)sv);
7507     if (GvSTASH(sv)) {
7508         sv_del_backref((SV*)GvSTASH(sv), sv);
7509         GvSTASH(sv) = NULL;
7510     }
7511     sv_unmagic(sv, PERL_MAGIC_glob);
7512     Safefree(GvNAME(sv));
7513     GvMULTI_off(sv);
7514
7515     /* need to keep SvANY(sv) in the right arena */
7516     xpvmg = new_XPVMG();
7517     StructCopy(SvANY(sv), xpvmg, XPVMG);
7518     del_XPVGV(SvANY(sv));
7519     SvANY(sv) = xpvmg;
7520
7521     SvFLAGS(sv) &= ~SVTYPEMASK;
7522     SvFLAGS(sv) |= SVt_PVMG;
7523 }
7524
7525 /*
7526 =for apidoc sv_unref_flags
7527
7528 Unsets the RV status of the SV, and decrements the reference count of
7529 whatever was being referenced by the RV.  This can almost be thought of
7530 as a reversal of C<newSVrv>.  The C<cflags> argument can contain
7531 C<SV_IMMEDIATE_UNREF> to force the reference count to be decremented
7532 (otherwise the decrementing is conditional on the reference count being
7533 different from one or the reference being a readonly SV).
7534 See C<SvROK_off>.
7535
7536 =cut
7537 */
7538
7539 void
7540 Perl_sv_unref_flags(pTHX_ SV *ref, U32 flags)
7541 {
7542     SV* const target = SvRV(ref);
7543
7544     if (SvWEAKREF(ref)) {
7545         sv_del_backref(target, ref);
7546         SvWEAKREF_off(ref);
7547         SvRV_set(ref, NULL);
7548         return;
7549     }
7550     SvRV_set(ref, NULL);
7551     SvROK_off(ref);
7552     /* You can't have a || SvREADONLY(target) here, as $a = $$a, where $a was
7553        assigned to as BEGIN {$a = \"Foo"} will fail.  */
7554     if (SvREFCNT(target) != 1 || (flags & SV_IMMEDIATE_UNREF))
7555         SvREFCNT_dec(target);
7556     else /* XXX Hack, but hard to make $a=$a->[1] work otherwise */
7557         sv_2mortal(target);     /* Schedule for freeing later */
7558 }
7559
7560 /*
7561 =for apidoc sv_untaint
7562
7563 Untaint an SV. Use C<SvTAINTED_off> instead.
7564 =cut
7565 */
7566
7567 void
7568 Perl_sv_untaint(pTHX_ SV *sv)
7569 {
7570     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv)) {
7571         MAGIC * const mg = mg_find(sv, PERL_MAGIC_taint);
7572         if (mg)
7573             mg->mg_len &= ~1;
7574     }
7575 }
7576
7577 /*
7578 =for apidoc sv_tainted
7579
7580 Test an SV for taintedness. Use C<SvTAINTED> instead.
7581 =cut
7582 */
7583
7584 bool
7585 Perl_sv_tainted(pTHX_ SV *sv)
7586 {
7587     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv)) {
7588         const MAGIC * const mg = mg_find(sv, PERL_MAGIC_taint);
7589         if (mg && (mg->mg_len & 1) )
7590             return TRUE;
7591     }
7592     return FALSE;
7593 }
7594
7595 /*
7596 =for apidoc sv_setpviv
7597
7598 Copies an integer into the given SV, also updating its string value.
7599 Does not handle 'set' magic.  See C<sv_setpviv_mg>.
7600
7601 =cut
7602 */
7603
7604 void
7605 Perl_sv_setpviv(pTHX_ SV *sv, IV iv)
7606 {
7607     char buf[TYPE_CHARS(UV)];
7608     char *ebuf;
7609     char * const ptr = uiv_2buf(buf, iv, 0, 0, &ebuf);
7610
7611     sv_setpvn(sv, ptr, ebuf - ptr);
7612 }
7613
7614 /*
7615 =for apidoc sv_setpviv_mg
7616
7617 Like C<sv_setpviv>, but also handles 'set' magic.
7618
7619 =cut
7620 */
7621
7622 void
7623 Perl_sv_setpviv_mg(pTHX_ SV *sv, IV iv)
7624 {
7625     sv_setpviv(sv, iv);
7626     SvSETMAGIC(sv);
7627 }
7628
7629 #if defined(PERL_IMPLICIT_CONTEXT)
7630
7631 /* pTHX_ magic can't cope with varargs, so this is a no-context
7632  * version of the main function, (which may itself be aliased to us).
7633  * Don't access this version directly.
7634  */
7635
7636 void
7637 Perl_sv_setpvf_nocontext(SV *sv, const char* pat, ...)
7638 {
7639     dTHX;
7640     va_list args;
7641     va_start(args, pat);
7642     sv_vsetpvf(sv, pat, &args);
7643     va_end(args);
7644 }
7645
7646 /* pTHX_ magic can't cope with varargs, so this is a no-context
7647  * version of the main function, (which may itself be aliased to us).
7648  * Don't access this version directly.
7649  */
7650
7651 void
7652 Perl_sv_setpvf_mg_nocontext(SV *sv, const char* pat, ...)
7653 {
7654     dTHX;
7655     va_list args;
7656     va_start(args, pat);
7657     sv_vsetpvf_mg(sv, pat, &args);
7658     va_end(args);
7659 }
7660 #endif
7661
7662 /*
7663 =for apidoc sv_setpvf
7664
7665 Works like C<sv_catpvf> but copies the text into the SV instead of
7666 appending it.  Does not handle 'set' magic.  See C<sv_setpvf_mg>.
7667
7668 =cut
7669 */
7670
7671 void
7672 Perl_sv_setpvf(pTHX_ SV *sv, const char* pat, ...)
7673 {
7674     va_list args;
7675     va_start(args, pat);
7676     sv_vsetpvf(sv, pat, &args);
7677     va_end(args);
7678 }
7679
7680 /*
7681 =for apidoc sv_vsetpvf
7682
7683 Works like C<sv_vcatpvf> but copies the text into the SV instead of
7684 appending it.  Does not handle 'set' magic.  See C<sv_vsetpvf_mg>.
7685
7686 Usually used via its frontend C<sv_setpvf>.
7687
7688 =cut
7689 */
7690
7691 void
7692 Perl_sv_vsetpvf(pTHX_ SV *sv, const char* pat, va_list* args)
7693 {
7694     sv_vsetpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*));
7695 }
7696
7697 /*
7698 =for apidoc sv_setpvf_mg
7699
7700 Like C<sv_setpvf>, but also handles 'set' magic.
7701
7702 =cut
7703 */
7704
7705 void
7706 Perl_sv_setpvf_mg(pTHX_ SV *sv, const char* pat, ...)
7707 {
7708     va_list args;
7709     va_start(args, pat);
7710     sv_vsetpvf_mg(sv, pat, &args);
7711     va_end(args);
7712 }
7713
7714 /*
7715 =for apidoc sv_vsetpvf_mg
7716
7717 Like C<sv_vsetpvf>, but also handles 'set' magic.
7718
7719 Usually used via its frontend C<sv_setpvf_mg>.
7720
7721 =cut
7722 */
7723
7724 void
7725 Perl_sv_vsetpvf_mg(pTHX_ SV *sv, const char* pat, va_list* args)
7726 {
7727     sv_vsetpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*));
7728     SvSETMAGIC(sv);
7729 }
7730
7731 #if defined(PERL_IMPLICIT_CONTEXT)
7732
7733 /* pTHX_ magic can't cope with varargs, so this is a no-context
7734  * version of the main function, (which may itself be aliased to us).
7735  * Don't access this version directly.
7736  */
7737
7738 void
7739 Perl_sv_catpvf_nocontext(SV *sv, const char* pat, ...)
7740 {
7741     dTHX;
7742     va_list args;
7743     va_start(args, pat);
7744     sv_vcatpvf(sv, pat, &args);
7745     va_end(args);
7746 }
7747
7748 /* pTHX_ magic can't cope with varargs, so this is a no-context
7749  * version of the main function, (which may itself be aliased to us).
7750  * Don't access this version directly.
7751  */
7752
7753 void
7754 Perl_sv_catpvf_mg_nocontext(SV *sv, const char* pat, ...)
7755 {
7756     dTHX;
7757     va_list args;
7758     va_start(args, pat);
7759     sv_vcatpvf_mg(sv, pat, &args);
7760     va_end(args);
7761 }
7762 #endif
7763
7764 /*
7765 =for apidoc sv_catpvf
7766
7767 Processes its arguments like C<sprintf> and appends the formatted
7768 output to an SV.  If the appended data contains "wide" characters
7769 (including, but not limited to, SVs with a UTF-8 PV formatted with %s,
7770 and characters >255 formatted with %c), the original SV might get
7771 upgraded to UTF-8.  Handles 'get' magic, but not 'set' magic.  See
7772 C<sv_catpvf_mg>. If the original SV was UTF-8, the pattern should be
7773 valid UTF-8; if the original SV was bytes, the pattern should be too.
7774
7775 =cut */
7776
7777 void
7778 Perl_sv_catpvf(pTHX_ SV *sv, const char* pat, ...)
7779 {
7780     va_list args;
7781     va_start(args, pat);
7782     sv_vcatpvf(sv, pat, &args);
7783     va_end(args);
7784 }
7785
7786 /*
7787 =for apidoc sv_vcatpvf
7788
7789 Processes its arguments like C<vsprintf> and appends the formatted output
7790 to an SV.  Does not handle 'set' magic.  See C<sv_vcatpvf_mg>.
7791
7792 Usually used via its frontend C<sv_catpvf>.
7793
7794 =cut
7795 */
7796
7797 void
7798 Perl_sv_vcatpvf(pTHX_ SV *sv, const char* pat, va_list* args)
7799 {
7800     sv_vcatpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*));
7801 }
7802
7803 /*
7804 =for apidoc sv_catpvf_mg
7805
7806 Like C<sv_catpvf>, but also handles 'set' magic.
7807
7808 =cut
7809 */
7810
7811 void
7812 Perl_sv_catpvf_mg(pTHX_ SV *sv, const char* pat, ...)
7813 {
7814     va_list args;
7815     va_start(args, pat);
7816     sv_vcatpvf_mg(sv, pat, &args);
7817     va_end(args);
7818 }
7819
7820 /*
7821 =for apidoc sv_vcatpvf_mg
7822
7823 Like C<sv_vcatpvf>, but also handles 'set' magic.
7824
7825 Usually used via its frontend C<sv_catpvf_mg>.
7826
7827 =cut
7828 */
7829
7830 void
7831 Perl_sv_vcatpvf_mg(pTHX_ SV *sv, const char* pat, va_list* args)
7832 {
7833     sv_vcatpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*));
7834     SvSETMAGIC(sv);
7835 }
7836
7837 /*
7838 =for apidoc sv_vsetpvfn
7839
7840 Works like C<sv_vcatpvfn> but copies the text into the SV instead of
7841 appending it.
7842
7843 Usually used via one of its frontends C<sv_vsetpvf> and C<sv_vsetpvf_mg>.
7844
7845 =cut
7846 */
7847
7848 void
7849 Perl_sv_vsetpvfn(pTHX_ SV *sv, const char *pat, STRLEN patlen, va_list *args, SV **svargs, I32 svmax, bool *maybe_tainted)
7850 {
7851     sv_setpvn(sv, "", 0);
7852     sv_vcatpvfn(sv, pat, patlen, args, svargs, svmax, maybe_tainted);
7853 }
7854
7855 STATIC I32
7856 S_expect_number(pTHX_ char** pattern)
7857 {
7858     dVAR;
7859     I32 var = 0;
7860     switch (**pattern) {
7861     case '1': case '2': case '3':
7862     case '4': case '5': case '6':
7863     case '7': case '8': case '9':
7864         var = *(*pattern)++ - '0';
7865         while (isDIGIT(**pattern)) {
7866             I32 tmp = var * 10 + (*(*pattern)++ - '0');
7867             if (tmp < var)
7868                 Perl_croak(aTHX_ "Integer overflow in format string for %s", (PL_op ? OP_NAME(PL_op) : "sv_vcatpvfn"));
7869             var = tmp;
7870         }
7871     }
7872     return var;
7873 }
7874
7875 STATIC char *
7876 S_F0convert(NV nv, char *endbuf, STRLEN *len)
7877 {
7878     const int neg = nv < 0;
7879     UV uv;
7880
7881     if (neg)
7882         nv = -nv;
7883     if (nv < UV_MAX) {
7884         char *p = endbuf;
7885         nv += 0.5;
7886         uv = (UV)nv;
7887         if (uv & 1 && uv == nv)
7888             uv--;                       /* Round to even */
7889         do {
7890             const unsigned dig = uv % 10;
7891             *--p = '0' + dig;
7892         } while (uv /= 10);
7893         if (neg)
7894             *--p = '-';
7895         *len = endbuf - p;
7896         return p;
7897     }
7898     return NULL;
7899 }
7900
7901
7902 /*
7903 =for apidoc sv_vcatpvfn
7904
7905 Processes its arguments like C<vsprintf> and appends the formatted output
7906 to an SV.  Uses an array of SVs if the C style variable argument list is
7907 missing (NULL).  When running with taint checks enabled, indicates via
7908 C<maybe_tainted> if results are untrustworthy (often due to the use of
7909 locales).
7910
7911 Usually used via one of its frontends C<sv_vcatpvf> and C<sv_vcatpvf_mg>.
7912
7913 =cut
7914 */
7915
7916
7917 #define VECTORIZE_ARGS  vecsv = va_arg(*args, SV*);\
7918                         vecstr = (U8*)SvPV_const(vecsv,veclen);\
7919                         vec_utf8 = DO_UTF8(vecsv);
7920
7921 /* XXX maybe_tainted is never assigned to, so the doc above is lying. */
7922
7923 void
7924 Perl_sv_vcatpvfn(pTHX_ SV *sv, const char *pat, STRLEN patlen, va_list *args, SV **svargs, I32 svmax, bool *maybe_tainted)
7925 {
7926     dVAR;
7927     char *p;
7928     char *q;
7929     const char *patend;
7930     STRLEN origlen;
7931     I32 svix = 0;
7932     static const char nullstr[] = "(null)";
7933     SV *argsv = NULL;
7934     bool has_utf8 = DO_UTF8(sv);    /* has the result utf8? */
7935     const bool pat_utf8 = has_utf8; /* the pattern is in utf8? */
7936     SV *nsv = NULL;
7937     /* Times 4: a decimal digit takes more than 3 binary digits.
7938      * NV_DIG: mantissa takes than many decimal digits.
7939      * Plus 32: Playing safe. */
7940     char ebuf[IV_DIG * 4 + NV_DIG + 32];
7941     /* large enough for "%#.#f" --chip */
7942     /* what about long double NVs? --jhi */
7943
7944     PERL_UNUSED_ARG(maybe_tainted);
7945
7946     /* no matter what, this is a string now */
7947     (void)SvPV_force(sv, origlen);
7948
7949     /* special-case "", "%s", and "%-p" (SVf - see below) */
7950     if (patlen == 0)
7951         return;
7952     if (patlen == 2 && pat[0] == '%' && pat[1] == 's') {
7953         if (args) {
7954             const char * const s = va_arg(*args, char*);
7955             sv_catpv(sv, s ? s : nullstr);
7956         }
7957         else if (svix < svmax) {
7958             sv_catsv(sv, *svargs);
7959         }
7960         return;
7961     }
7962     if (args && patlen == 3 && pat[0] == '%' &&
7963                 pat[1] == '-' && pat[2] == 'p') {
7964         argsv = va_arg(*args, SV*);
7965         sv_catsv(sv, argsv);
7966         return;
7967     }
7968
7969 #ifndef USE_LONG_DOUBLE
7970     /* special-case "%.<number>[gf]" */
7971     if ( !args && patlen <= 5 && pat[0] == '%' && pat[1] == '.'
7972          && (pat[patlen-1] == 'g' || pat[patlen-1] == 'f') ) {
7973         unsigned digits = 0;
7974         const char *pp;
7975
7976         pp = pat + 2;
7977         while (*pp >= '0' && *pp <= '9')
7978             digits = 10 * digits + (*pp++ - '0');
7979         if (pp - pat == (int)patlen - 1) {
7980             NV nv;
7981
7982             if (svix < svmax)
7983                 nv = SvNV(*svargs);
7984             else
7985                 return;
7986             if (*pp == 'g') {
7987                 /* Add check for digits != 0 because it seems that some
7988                    gconverts are buggy in this case, and we don't yet have
7989                    a Configure test for this.  */
7990                 if (digits && digits < sizeof(ebuf) - NV_DIG - 10) {
7991                      /* 0, point, slack */
7992                     Gconvert(nv, (int)digits, 0, ebuf);
7993                     sv_catpv(sv, ebuf);
7994                     if (*ebuf)  /* May return an empty string for digits==0 */
7995                         return;
7996                 }
7997             } else if (!digits) {
7998                 STRLEN l;
7999
8000                 if ((p = F0convert(nv, ebuf + sizeof ebuf, &l))) {
8001                     sv_catpvn(sv, p, l);
8002                     return;
8003                 }
8004             }
8005         }
8006     }
8007 #endif /* !USE_LONG_DOUBLE */
8008
8009     if (!args && svix < svmax && DO_UTF8(*svargs))
8010         has_utf8 = TRUE;
8011
8012     patend = (char*)pat + patlen;
8013     for (p = (char*)pat; p < patend; p = q) {
8014         bool alt = FALSE;
8015         bool left = FALSE;
8016         bool vectorize = FALSE;
8017         bool vectorarg = FALSE;
8018         bool vec_utf8 = FALSE;
8019         char fill = ' ';
8020         char plus = 0;
8021         char intsize = 0;
8022         STRLEN width = 0;
8023         STRLEN zeros = 0;
8024         bool has_precis = FALSE;
8025         STRLEN precis = 0;
8026         const I32 osvix = svix;
8027         bool is_utf8 = FALSE;  /* is this item utf8?   */
8028 #ifdef HAS_LDBL_SPRINTF_BUG
8029         /* This is to try to fix a bug with irix/nonstop-ux/powerux and
8030            with sfio - Allen <allens@cpan.org> */
8031         bool fix_ldbl_sprintf_bug = FALSE;
8032 #endif
8033
8034         char esignbuf[4];
8035         U8 utf8buf[UTF8_MAXBYTES+1];
8036         STRLEN esignlen = 0;
8037
8038         const char *eptr = NULL;
8039         STRLEN elen = 0;
8040         SV *vecsv = NULL;
8041         const U8 *vecstr = Null(U8*);
8042         STRLEN veclen = 0;
8043         char c = 0;
8044         int i;
8045         unsigned base = 0;
8046         IV iv = 0;
8047         UV uv = 0;
8048         /* we need a long double target in case HAS_LONG_DOUBLE but
8049            not USE_LONG_DOUBLE
8050         */
8051 #if defined(HAS_LONG_DOUBLE) && LONG_DOUBLESIZE > DOUBLESIZE
8052         long double nv;
8053 #else
8054         NV nv;
8055 #endif
8056         STRLEN have;
8057         STRLEN need;
8058         STRLEN gap;
8059         const char *dotstr = ".";
8060         STRLEN dotstrlen = 1;
8061         I32 efix = 0; /* explicit format parameter index */
8062         I32 ewix = 0; /* explicit width index */
8063         I32 epix = 0; /* explicit precision index */
8064         I32 evix = 0; /* explicit vector index */
8065         bool asterisk = FALSE;
8066
8067         /* echo everything up to the next format specification */
8068         for (q = p; q < patend && *q != '%'; ++q) ;
8069         if (q > p) {
8070             if (has_utf8 && !pat_utf8)
8071                 sv_catpvn_utf8_upgrade(sv, p, q - p, nsv);
8072             else
8073                 sv_catpvn(sv, p, q - p);
8074             p = q;
8075         }
8076         if (q++ >= patend)
8077             break;
8078
8079 /*
8080     We allow format specification elements in this order:
8081         \d+\$              explicit format parameter index
8082         [-+ 0#]+           flags
8083         v|\*(\d+\$)?v      vector with optional (optionally specified) arg
8084         0                  flag (as above): repeated to allow "v02"     
8085         \d+|\*(\d+\$)?     width using optional (optionally specified) arg
8086         \.(\d*|\*(\d+\$)?) precision using optional (optionally specified) arg
8087         [hlqLV]            size
8088     [%bcdefginopsuxDFOUX] format (mandatory)
8089 */
8090
8091         if (args) {
8092 /*  
8093         As of perl5.9.3, printf format checking is on by default.
8094         Internally, perl uses %p formats to provide an escape to
8095         some extended formatting.  This block deals with those
8096         extensions: if it does not match, (char*)q is reset and
8097         the normal format processing code is used.
8098
8099         Currently defined extensions are:
8100                 %p              include pointer address (standard)      
8101                 %-p     (SVf)   include an SV (previously %_)
8102                 %-<num>p        include an SV with precision <num>      
8103                 %1p     (VDf)   include a v-string (as %vd)
8104                 %<num>p         reserved for future extensions
8105
8106         Robin Barker 2005-07-14
8107 */
8108             char* r = q; 
8109             bool sv = FALSE;    
8110             STRLEN n = 0;
8111             if (*q == '-')
8112                 sv = *q++;
8113             n = expect_number(&q);
8114             if (*q++ == 'p') {
8115                 if (sv) {                       /* SVf */
8116                     if (n) {
8117                         precis = n;
8118                         has_precis = TRUE;
8119                     }
8120                     argsv = va_arg(*args, SV*);
8121                     eptr = SvPVx_const(argsv, elen);
8122                     if (DO_UTF8(argsv))
8123                         is_utf8 = TRUE;
8124                     goto string;
8125                 }
8126 #if vdNUMBER
8127                 else if (n == vdNUMBER) {       /* VDf */
8128                     vectorize = TRUE;
8129                     VECTORIZE_ARGS
8130                     goto format_vd;
8131                 }
8132 #endif
8133                 else if (n) {
8134                     if (ckWARN_d(WARN_INTERNAL))
8135                         Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
8136                         "internal %%<num>p might conflict with future printf extensions");
8137                 }
8138             }
8139             q = r; 
8140         }
8141
8142         if ( (width = expect_number(&q)) ) {
8143             if (*q == '$') {
8144                 ++q;
8145                 efix = width;
8146             } else {
8147                 goto gotwidth;
8148             }
8149         }
8150
8151         /* FLAGS */
8152
8153         while (*q) {
8154             switch (*q) {
8155             case ' ':
8156             case '+':
8157                 plus = *q++;
8158                 continue;
8159
8160             case '-':
8161                 left = TRUE;
8162                 q++;
8163                 continue;
8164
8165             case '0':
8166                 fill = *q++;
8167                 continue;
8168
8169             case '#':
8170                 alt = TRUE;
8171                 q++;
8172                 continue;
8173
8174             default:
8175                 break;
8176             }
8177             break;
8178         }
8179
8180       tryasterisk:
8181         if (*q == '*') {
8182             q++;
8183             if ( (ewix = expect_number(&q)) )
8184                 if (*q++ != '$')
8185                     goto unknown;
8186             asterisk = TRUE;
8187         }
8188         if (*q == 'v') {
8189             q++;
8190             if (vectorize)
8191                 goto unknown;
8192             if ((vectorarg = asterisk)) {
8193                 evix = ewix;
8194                 ewix = 0;
8195                 asterisk = FALSE;
8196             }
8197             vectorize = TRUE;
8198             goto tryasterisk;
8199         }
8200
8201         if (!asterisk)
8202         {
8203             if( *q == '0' )
8204                 fill = *q++;
8205             width = expect_number(&q);
8206         }
8207
8208         if (vectorize) {
8209             if (vectorarg) {
8210                 if (args)
8211                     vecsv = va_arg(*args, SV*);
8212                 else if (evix) {
8213                     vecsv = (evix > 0 && evix <= svmax)
8214                         ? svargs[evix-1] : &PL_sv_undef;
8215                 } else {
8216                     vecsv = svix < svmax ? svargs[svix++] : &PL_sv_undef;
8217                 }
8218                 dotstr = SvPV_const(vecsv, dotstrlen);
8219                 /* Keep the DO_UTF8 test *after* the SvPV call, else things go
8220                    bad with tied or overloaded values that return UTF8.  */
8221                 if (DO_UTF8(vecsv))
8222                     is_utf8 = TRUE;
8223                 else if (has_utf8) {
8224                     vecsv = sv_mortalcopy(vecsv);
8225                     sv_utf8_upgrade(vecsv);
8226                     dotstr = SvPV_const(vecsv, dotstrlen);
8227                     is_utf8 = TRUE;
8228                 }                   
8229             }
8230             if (args) {
8231                 VECTORIZE_ARGS
8232             }
8233             else if (efix ? (efix > 0 && efix <= svmax) : svix < svmax) {
8234                 vecsv = svargs[efix ? efix-1 : svix++];
8235                 vecstr = (U8*)SvPV_const(vecsv,veclen);
8236                 vec_utf8 = DO_UTF8(vecsv);
8237
8238                 /* if this is a version object, we need to convert
8239                  * back into v-string notation and then let the
8240                  * vectorize happen normally
8241                  */
8242                 if (sv_derived_from(vecsv, "version")) {
8243                     char *version = savesvpv(vecsv);
8244                     if ( hv_exists((HV*)SvRV(vecsv), "alpha", 5 ) ) {
8245                         Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
8246                         "vector argument not supported with alpha versions");
8247                         goto unknown;
8248                     }
8249                     vecsv = sv_newmortal();
8250                     /* scan_vstring is expected to be called during
8251                      * tokenization, so we need to fake up the end
8252                      * of the buffer for it
8253                      */
8254                     PL_bufend = version + veclen;
8255                     scan_vstring(version, vecsv);
8256                     vecstr = (U8*)SvPV_const(vecsv, veclen);
8257                     vec_utf8 = DO_UTF8(vecsv);
8258                     Safefree(version);
8259                 }
8260             }
8261             else {
8262                 vecstr = (U8*)"";
8263                 veclen = 0;
8264             }
8265         }
8266
8267         if (asterisk) {
8268             if (args)
8269                 i = va_arg(*args, int);
8270             else
8271                 i = (ewix ? ewix <= svmax : svix < svmax) ?
8272                     SvIVx(svargs[ewix ? ewix-1 : svix++]) : 0;
8273             left |= (i < 0);
8274             width = (i < 0) ? -i : i;
8275         }
8276       gotwidth:
8277
8278         /* PRECISION */
8279
8280         if (*q == '.') {
8281             q++;
8282             if (*q == '*') {
8283                 q++;
8284                 if ( ((epix = expect_number(&q))) && (*q++ != '$') )
8285                     goto unknown;
8286                 /* XXX: todo, support specified precision parameter */
8287                 if (epix)
8288                     goto unknown;
8289                 if (args)
8290                     i = va_arg(*args, int);
8291                 else
8292                     i = (ewix ? ewix <= svmax : svix < svmax)
8293                         ? SvIVx(svargs[ewix ? ewix-1 : svix++]) : 0;
8294                 precis = (i < 0) ? 0 : i;
8295             }
8296             else {
8297                 precis = 0;
8298                 while (isDIGIT(*q))
8299                     precis = precis * 10 + (*q++ - '0');
8300             }
8301             has_precis = TRUE;
8302         }
8303
8304         /* SIZE */
8305
8306         switch (*q) {
8307 #ifdef WIN32
8308         case 'I':                       /* Ix, I32x, and I64x */
8309 #  ifdef WIN64
8310             if (q[1] == '6' && q[2] == '4') {
8311                 q += 3;
8312                 intsize = 'q';
8313                 break;
8314             }
8315 #  endif
8316             if (q[1] == '3' && q[2] == '2') {
8317                 q += 3;
8318                 break;
8319             }
8320 #  ifdef WIN64
8321             intsize = 'q';
8322 #  endif
8323             q++;
8324             break;
8325 #endif
8326 #if defined(HAS_QUAD) || defined(HAS_LONG_DOUBLE)
8327         case 'L':                       /* Ld */
8328             /* FALL THROUGH */
8329 #ifdef HAS_QUAD
8330         case 'q':                       /* qd */
8331 #endif
8332             intsize = 'q';
8333             q++;
8334             break;
8335 #endif
8336         case 'l':
8337 #if defined(HAS_QUAD) || defined(HAS_LONG_DOUBLE)
8338             if (*(q + 1) == 'l') {      /* lld, llf */
8339                 intsize = 'q';
8340                 q += 2;
8341                 break;
8342              }
8343 #endif
8344             /* FALL THROUGH */
8345         case 'h':
8346             /* FALL THROUGH */
8347         case 'V':
8348             intsize = *q++;
8349             break;
8350         }
8351
8352         /* CONVERSION */
8353
8354         if (*q == '%') {
8355             eptr = q++;
8356             elen = 1;
8357             if (vectorize) {
8358                 c = '%';
8359                 goto unknown;
8360             }
8361             goto string;
8362         }
8363
8364         if (!vectorize && !args) {
8365             if (efix) {
8366                 const I32 i = efix-1;
8367                 argsv = (i >= 0 && i < svmax) ? svargs[i] : &PL_sv_undef;
8368             } else {
8369                 argsv = (svix >= 0 && svix < svmax)
8370                     ? svargs[svix++] : &PL_sv_undef;
8371             }
8372         }
8373
8374         switch (c = *q++) {
8375
8376             /* STRINGS */
8377
8378         case 'c':
8379             if (vectorize)
8380                 goto unknown;
8381             uv = (args) ? va_arg(*args, int) : SvIVx(argsv);
8382             if ((uv > 255 ||
8383                  (!UNI_IS_INVARIANT(uv) && SvUTF8(sv)))
8384                 && !IN_BYTES) {
8385                 eptr = (char*)utf8buf;
8386                 elen = uvchr_to_utf8((U8*)eptr, uv) - utf8buf;
8387                 is_utf8 = TRUE;
8388             }
8389             else {
8390                 c = (char)uv;
8391                 eptr = &c;
8392                 elen = 1;
8393             }
8394             goto string;
8395
8396         case 's':
8397             if (vectorize)
8398                 goto unknown;
8399             if (args) {
8400                 eptr = va_arg(*args, char*);
8401                 if (eptr)
8402 #ifdef MACOS_TRADITIONAL
8403                   /* On MacOS, %#s format is used for Pascal strings */
8404                   if (alt)
8405                     elen = *eptr++;
8406                   else
8407 #endif
8408                     elen = strlen(eptr);
8409                 else {
8410                     eptr = (char *)nullstr;
8411                     elen = sizeof nullstr - 1;
8412                 }
8413             }
8414             else {
8415                 eptr = SvPVx_const(argsv, elen);
8416                 if (DO_UTF8(argsv)) {
8417                     if (has_precis && precis < elen) {
8418                         I32 p = precis;
8419                         sv_pos_u2b(argsv, &p, 0); /* sticks at end */
8420                         precis = p;
8421                     }
8422                     if (width) { /* fudge width (can't fudge elen) */
8423                         width += elen - sv_len_utf8(argsv);
8424                     }
8425                     is_utf8 = TRUE;
8426                 }
8427             }
8428
8429         string:
8430             if (has_precis && elen > precis)
8431                 elen = precis;
8432             break;
8433
8434             /* INTEGERS */
8435
8436         case 'p':
8437             if (alt || vectorize)
8438                 goto unknown;
8439             uv = PTR2UV(args ? va_arg(*args, void*) : argsv);
8440             base = 16;
8441             goto integer;
8442
8443         case 'D':
8444 #ifdef IV_IS_QUAD
8445             intsize = 'q';
8446 #else
8447             intsize = 'l';
8448 #endif
8449             /* FALL THROUGH */
8450         case 'd':
8451         case 'i':
8452 #if vdNUMBER
8453         format_vd:
8454 #endif
8455             if (vectorize) {
8456                 STRLEN ulen;
8457                 if (!veclen)
8458                     continue;
8459                 if (vec_utf8)
8460                     uv = utf8n_to_uvchr(vecstr, veclen, &ulen,
8461                                         UTF8_ALLOW_ANYUV);
8462                 else {
8463                     uv = *vecstr;
8464                     ulen = 1;
8465                 }
8466                 vecstr += ulen;
8467                 veclen -= ulen;
8468                 if (plus)
8469                      esignbuf[esignlen++] = plus;
8470             }
8471             else if (args) {
8472                 switch (intsize) {
8473                 case 'h':       iv = (short)va_arg(*args, int); break;
8474                 case 'l':       iv = va_arg(*args, long); break;
8475                 case 'V':       iv = va_arg(*args, IV); break;
8476                 default:        iv = va_arg(*args, int); break;
8477 #ifdef HAS_QUAD
8478                 case 'q':       iv = va_arg(*args, Quad_t); break;
8479 #endif
8480                 }
8481             }
8482             else {
8483                 IV tiv = SvIVx(argsv); /* work around GCC bug #13488 */
8484                 switch (intsize) {
8485                 case 'h':       iv = (short)tiv; break;
8486                 case 'l':       iv = (long)tiv; break;
8487                 case 'V':
8488                 default:        iv = tiv; break;
8489 #ifdef HAS_QUAD
8490                 case 'q':       iv = (Quad_t)tiv; break;
8491 #endif
8492                 }
8493             }
8494             if ( !vectorize )   /* we already set uv above */
8495             {
8496                 if (iv >= 0) {
8497                     uv = iv;
8498                     if (plus)
8499                         esignbuf[esignlen++] = plus;
8500                 }
8501                 else {
8502                     uv = -iv;
8503                     esignbuf[esignlen++] = '-';
8504                 }
8505             }
8506             base = 10;
8507             goto integer;
8508
8509         case 'U':
8510 #ifdef IV_IS_QUAD
8511             intsize = 'q';
8512 #else
8513             intsize = 'l';
8514 #endif
8515             /* FALL THROUGH */
8516         case 'u':
8517             base = 10;
8518             goto uns_integer;
8519
8520         case 'b':
8521             base = 2;
8522             goto uns_integer;
8523
8524         case 'O':
8525 #ifdef IV_IS_QUAD
8526             intsize = 'q';
8527 #else
8528             intsize = 'l';
8529 #endif
8530             /* FALL THROUGH */
8531         case 'o':
8532             base = 8;
8533             goto uns_integer;
8534
8535         case 'X':
8536         case 'x':
8537             base = 16;
8538
8539         uns_integer:
8540             if (vectorize) {
8541                 STRLEN ulen;
8542         vector:
8543                 if (!veclen)
8544                     continue;
8545                 if (vec_utf8)
8546                     uv = utf8n_to_uvchr(vecstr, veclen, &ulen,
8547                                         UTF8_ALLOW_ANYUV);
8548                 else {
8549                     uv = *vecstr;
8550                     ulen = 1;
8551                 }
8552                 vecstr += ulen;
8553                 veclen -= ulen;
8554             }
8555             else if (args) {
8556                 switch (intsize) {
8557                 case 'h':  uv = (unsigned short)va_arg(*args, unsigned); break;
8558                 case 'l':  uv = va_arg(*args, unsigned long); break;
8559                 case 'V':  uv = va_arg(*args, UV); break;
8560                 default:   uv = va_arg(*args, unsigned); break;
8561 #ifdef HAS_QUAD
8562                 case 'q':  uv = va_arg(*args, Uquad_t); break;
8563 #endif
8564                 }
8565             }
8566             else {
8567                 UV tuv = SvUVx(argsv); /* work around GCC bug #13488 */
8568                 switch (intsize) {
8569                 case 'h':       uv = (unsigned short)tuv; break;
8570                 case 'l':       uv = (unsigned long)tuv; break;
8571                 case 'V':
8572                 default:        uv = tuv; break;
8573 #ifdef HAS_QUAD
8574                 case 'q':       uv = (Uquad_t)tuv; break;
8575 #endif
8576                 }
8577             }
8578
8579         integer:
8580             {
8581                 char *ptr = ebuf + sizeof ebuf;
8582                 switch (base) {
8583                     unsigned dig;
8584                 case 16:
8585                     if (!uv)
8586                         alt = FALSE;
8587                     p = (char*)((c == 'X')
8588                                 ? "0123456789ABCDEF" : "0123456789abcdef");
8589                     do {
8590                         dig = uv & 15;
8591                         *--ptr = p[dig];
8592                     } while (uv >>= 4);
8593                     if (alt) {
8594                         esignbuf[esignlen++] = '0';
8595                         esignbuf[esignlen++] = c;  /* 'x' or 'X' */
8596                     }
8597                     break;
8598                 case 8:
8599                     do {
8600                         dig = uv & 7;
8601                         *--ptr = '0' + dig;
8602                     } while (uv >>= 3);
8603                     if (alt && *ptr != '0')
8604                         *--ptr = '0';
8605                     break;
8606                 case 2:
8607                     if (!uv)
8608                         alt = FALSE;
8609                     do {
8610                         dig = uv & 1;
8611                         *--ptr = '0' + dig;
8612                     } while (uv >>= 1);
8613                     if (alt) {
8614                         esignbuf[esignlen++] = '0';
8615                         esignbuf[esignlen++] = 'b';
8616                     }
8617                     break;
8618                 default:                /* it had better be ten or less */
8619                     do {
8620                         dig = uv % base;
8621                         *--ptr = '0' + dig;
8622                     } while (uv /= base);
8623                     break;
8624                 }
8625                 elen = (ebuf + sizeof ebuf) - ptr;
8626                 eptr = ptr;
8627                 if (has_precis) {
8628                     if (precis > elen)
8629                         zeros = precis - elen;
8630                     else if (precis == 0 && elen == 1 && *eptr == '0')
8631                         elen = 0;
8632                 }
8633             }
8634             break;
8635
8636             /* FLOATING POINT */
8637
8638         case 'F':
8639             c = 'f';            /* maybe %F isn't supported here */
8640             /* FALL THROUGH */
8641         case 'e': case 'E':
8642         case 'f':
8643         case 'g': case 'G':
8644             if (vectorize)
8645                 goto unknown;
8646
8647             /* This is evil, but floating point is even more evil */
8648
8649             /* for SV-style calling, we can only get NV
8650                for C-style calling, we assume %f is double;
8651                for simplicity we allow any of %Lf, %llf, %qf for long double
8652             */
8653             switch (intsize) {
8654             case 'V':
8655 #if defined(USE_LONG_DOUBLE)
8656                 intsize = 'q';
8657 #endif
8658                 break;
8659 /* [perl #20339] - we should accept and ignore %lf rather than die */
8660             case 'l':
8661                 /* FALL THROUGH */
8662             default:
8663 #if defined(USE_LONG_DOUBLE)
8664                 intsize = args ? 0 : 'q';
8665 #endif
8666                 break;
8667             case 'q':
8668 #if defined(HAS_LONG_DOUBLE)
8669                 break;
8670 #else
8671                 /* FALL THROUGH */
8672 #endif
8673             case 'h':
8674                 goto unknown;
8675             }
8676
8677             /* now we need (long double) if intsize == 'q', else (double) */
8678             nv = (args) ?
8679 #if LONG_DOUBLESIZE > DOUBLESIZE
8680                 intsize == 'q' ?
8681                     va_arg(*args, long double) :
8682                     va_arg(*args, double)
8683 #else
8684                     va_arg(*args, double)
8685 #endif
8686                 : SvNVx(argsv);
8687
8688             need = 0;
8689             if (c != 'e' && c != 'E') {
8690                 i = PERL_INT_MIN;
8691                 /* FIXME: if HAS_LONG_DOUBLE but not USE_LONG_DOUBLE this
8692                    will cast our (long double) to (double) */
8693                 (void)Perl_frexp(nv, &i);
8694                 if (i == PERL_INT_MIN)
8695                     Perl_die(aTHX_ "panic: frexp");
8696                 if (i > 0)
8697                     need = BIT_DIGITS(i);
8698             }
8699             need += has_precis ? precis : 6; /* known default */
8700
8701             if (need < width)
8702                 need = width;
8703
8704 #ifdef HAS_LDBL_SPRINTF_BUG
8705             /* This is to try to fix a bug with irix/nonstop-ux/powerux and
8706                with sfio - Allen <allens@cpan.org> */
8707
8708 #  ifdef DBL_MAX
8709 #    define MY_DBL_MAX DBL_MAX
8710 #  else /* XXX guessing! HUGE_VAL may be defined as infinity, so not using */
8711 #    if DOUBLESIZE >= 8
8712 #      define MY_DBL_MAX 1.7976931348623157E+308L
8713 #    else
8714 #      define MY_DBL_MAX 3.40282347E+38L
8715 #    endif
8716 #  endif
8717
8718 #  ifdef HAS_LDBL_SPRINTF_BUG_LESS1 /* only between -1L & 1L - Allen */
8719 #    define MY_DBL_MAX_BUG 1L
8720 #  else
8721 #    define MY_DBL_MAX_BUG MY_DBL_MAX
8722 #  endif
8723
8724 #  ifdef DBL_MIN
8725 #    define MY_DBL_MIN DBL_MIN
8726 #  else  /* XXX guessing! -Allen */
8727 #    if DOUBLESIZE >= 8
8728 #      define MY_DBL_MIN 2.2250738585072014E-308L
8729 #    else
8730 #      define MY_DBL_MIN 1.17549435E-38L
8731 #    endif
8732 #  endif
8733
8734             if ((intsize == 'q') && (c == 'f') &&
8735                 ((nv < MY_DBL_MAX_BUG) && (nv > -MY_DBL_MAX_BUG)) &&
8736                 (need < DBL_DIG)) {
8737                 /* it's going to be short enough that
8738                  * long double precision is not needed */
8739
8740                 if ((nv <= 0L) && (nv >= -0L))
8741                     fix_ldbl_sprintf_bug = TRUE; /* 0 is 0 - easiest */
8742                 else {
8743                     /* would use Perl_fp_class as a double-check but not
8744                      * functional on IRIX - see perl.h comments */
8745
8746                     if ((nv >= MY_DBL_MIN) || (nv <= -MY_DBL_MIN)) {
8747                         /* It's within the range that a double can represent */
8748 #if defined(DBL_MAX) && !defined(DBL_MIN)
8749                         if ((nv >= ((long double)1/DBL_MAX)) ||
8750                             (nv <= (-(long double)1/DBL_MAX)))
8751 #endif
8752                         fix_ldbl_sprintf_bug = TRUE;
8753                     }
8754                 }
8755                 if (fix_ldbl_sprintf_bug == TRUE) {
8756                     double temp;
8757
8758                     intsize = 0;
8759                     temp = (double)nv;
8760                     nv = (NV)temp;
8761                 }
8762             }
8763
8764 #  undef MY_DBL_MAX
8765 #  undef MY_DBL_MAX_BUG
8766 #  undef MY_DBL_MIN
8767
8768 #endif /* HAS_LDBL_SPRINTF_BUG */
8769
8770             need += 20; /* fudge factor */
8771             if (PL_efloatsize < need) {
8772                 Safefree(PL_efloatbuf);
8773                 PL_efloatsize = need + 20; /* more fudge */
8774                 Newx(PL_efloatbuf, PL_efloatsize, char);
8775                 PL_efloatbuf[0] = '\0';
8776             }
8777
8778             if ( !(width || left || plus || alt) && fill != '0'
8779                  && has_precis && intsize != 'q' ) {    /* Shortcuts */
8780                 /* See earlier comment about buggy Gconvert when digits,
8781                    aka precis is 0  */
8782                 if ( c == 'g' && precis) {
8783                     Gconvert((NV)nv, (int)precis, 0, PL_efloatbuf);
8784                     /* May return an empty string for digits==0 */
8785                     if (*PL_efloatbuf) {
8786                         elen = strlen(PL_efloatbuf);
8787                         goto float_converted;
8788                     }
8789                 } else if ( c == 'f' && !precis) {
8790                     if ((eptr = F0convert(nv, ebuf + sizeof ebuf, &elen)))
8791                         break;
8792                 }
8793             }
8794             {
8795                 char *ptr = ebuf + sizeof ebuf;
8796                 *--ptr = '\0';
8797                 *--ptr = c;
8798                 /* FIXME: what to do if HAS_LONG_DOUBLE but not PERL_PRIfldbl? */
8799 #if defined(HAS_LONG_DOUBLE) && defined(PERL_PRIfldbl)
8800                 if (intsize == 'q') {
8801                     /* Copy the one or more characters in a long double
8802                      * format before the 'base' ([efgEFG]) character to
8803                      * the format string. */
8804                     static char const prifldbl[] = PERL_PRIfldbl;
8805                     char const *p = prifldbl + sizeof(prifldbl) - 3;
8806                     while (p >= prifldbl) { *--ptr = *p--; }
8807                 }
8808 #endif
8809                 if (has_precis) {
8810                     base = precis;
8811                     do { *--ptr = '0' + (base % 10); } while (base /= 10);
8812                     *--ptr = '.';
8813                 }
8814                 if (width) {
8815                     base = width;
8816                     do { *--ptr = '0' + (base % 10); } while (base /= 10);
8817                 }
8818                 if (fill == '0')
8819                     *--ptr = fill;
8820                 if (left)
8821                     *--ptr = '-';
8822                 if (plus)
8823                     *--ptr = plus;
8824                 if (alt)
8825                     *--ptr = '#';
8826                 *--ptr = '%';
8827
8828                 /* No taint.  Otherwise we are in the strange situation
8829                  * where printf() taints but print($float) doesn't.
8830                  * --jhi */
8831 #if defined(HAS_LONG_DOUBLE)
8832                 elen = ((intsize == 'q')
8833                         ? my_sprintf(PL_efloatbuf, ptr, nv)
8834                         : my_sprintf(PL_efloatbuf, ptr, (double)nv));
8835 #else
8836                 elen = my_sprintf(PL_efloatbuf, ptr, nv);
8837 #endif
8838             }
8839         float_converted:
8840             eptr = PL_efloatbuf;
8841             break;
8842
8843             /* SPECIAL */
8844
8845         case 'n':
8846             if (vectorize)
8847                 goto unknown;
8848             i = SvCUR(sv) - origlen;
8849             if (args) {
8850                 switch (intsize) {
8851                 case 'h':       *(va_arg(*args, short*)) = i; break;
8852                 default:        *(va_arg(*args, int*)) = i; break;
8853                 case 'l':       *(va_arg(*args, long*)) = i; break;
8854                 case 'V':       *(va_arg(*args, IV*)) = i; break;
8855 #ifdef HAS_QUAD
8856                 case 'q':       *(va_arg(*args, Quad_t*)) = i; break;
8857 #endif
8858                 }
8859             }
8860             else
8861                 sv_setuv_mg(argsv, (UV)i);
8862             continue;   /* not "break" */
8863
8864             /* UNKNOWN */
8865
8866         default:
8867       unknown:
8868             if (!args
8869                 && (PL_op->op_type == OP_PRTF || PL_op->op_type == OP_SPRINTF)
8870                 && ckWARN(WARN_PRINTF))
8871             {
8872                 SV * const msg = sv_newmortal();
8873                 Perl_sv_setpvf(aTHX_ msg, "Invalid conversion in %sprintf: ",
8874                           (PL_op->op_type == OP_PRTF) ? "" : "s");
8875                 if (c) {
8876                     if (isPRINT(c))
8877                         Perl_sv_catpvf(aTHX_ msg,
8878                                        "\"%%%c\"", c & 0xFF);
8879                     else
8880                         Perl_sv_catpvf(aTHX_ msg,
8881                                        "\"%%\\%03"UVof"\"",
8882                                        (UV)c & 0xFF);
8883                 } else
8884                     sv_catpvs(msg, "end of string");
8885                 Perl_warner(aTHX_ packWARN(WARN_PRINTF), "%"SVf, msg); /* yes, this is reentrant */
8886             }
8887
8888             /* output mangled stuff ... */
8889             if (c == '\0')
8890                 --q;
8891             eptr = p;
8892             elen = q - p;
8893
8894             /* ... right here, because formatting flags should not apply */
8895             SvGROW(sv, SvCUR(sv) + elen + 1);
8896             p = SvEND(sv);
8897             Copy(eptr, p, elen, char);
8898             p += elen;
8899             *p = '\0';
8900             SvCUR_set(sv, p - SvPVX_const(sv));
8901             svix = osvix;
8902             continue;   /* not "break" */
8903         }
8904
8905         /* calculate width before utf8_upgrade changes it */
8906         have = esignlen + zeros + elen;
8907         if (have < zeros)
8908             Perl_croak_nocontext(PL_memory_wrap);
8909
8910         if (is_utf8 != has_utf8) {
8911              if (is_utf8) {
8912                   if (SvCUR(sv))
8913                        sv_utf8_upgrade(sv);
8914              }
8915              else {
8916                   SV * const nsv = sv_2mortal(newSVpvn(eptr, elen));
8917                   sv_utf8_upgrade(nsv);
8918                   eptr = SvPVX_const(nsv);
8919                   elen = SvCUR(nsv);
8920              }
8921              SvGROW(sv, SvCUR(sv) + elen + 1);
8922              p = SvEND(sv);
8923              *p = '\0';
8924         }
8925
8926         need = (have > width ? have : width);
8927         gap = need - have;
8928
8929         if (need >= (((STRLEN)~0) - SvCUR(sv) - dotstrlen - 1))
8930             Perl_croak_nocontext(PL_memory_wrap);
8931         SvGROW(sv, SvCUR(sv) + need + dotstrlen + 1);
8932         p = SvEND(sv);
8933         if (esignlen && fill == '0') {
8934             int i;
8935             for (i = 0; i < (int)esignlen; i++)
8936                 *p++ = esignbuf[i];
8937         }
8938         if (gap && !left) {
8939             memset(p, fill, gap);
8940             p += gap;
8941         }
8942         if (esignlen && fill != '0') {
8943             int i;
8944             for (i = 0; i < (int)esignlen; i++)
8945                 *p++ = esignbuf[i];
8946         }
8947         if (zeros) {
8948             int i;
8949             for (i = zeros; i; i--)
8950                 *p++ = '0';
8951         }
8952         if (elen) {
8953             Copy(eptr, p, elen, char);
8954             p += elen;
8955         }
8956         if (gap && left) {
8957             memset(p, ' ', gap);
8958             p += gap;
8959         }
8960         if (vectorize) {
8961             if (veclen) {
8962                 Copy(dotstr, p, dotstrlen, char);
8963                 p += dotstrlen;
8964             }
8965             else
8966                 vectorize = FALSE;              /* done iterating over vecstr */
8967         }
8968         if (is_utf8)
8969             has_utf8 = TRUE;
8970         if (has_utf8)
8971             SvUTF8_on(sv);
8972         *p = '\0';
8973         SvCUR_set(sv, p - SvPVX_const(sv));
8974         if (vectorize) {
8975             esignlen = 0;
8976             goto vector;
8977         }
8978     }
8979 }
8980
8981 /* =========================================================================
8982
8983 =head1 Cloning an interpreter
8984
8985 All the macros and functions in this section are for the private use of
8986 the main function, perl_clone().
8987
8988 The foo_dup() functions make an exact copy of an existing foo thinngy.
8989 During the course of a cloning, a hash table is used to map old addresses
8990 to new addresses. The table is created and manipulated with the
8991 ptr_table_* functions.
8992
8993 =cut
8994
8995 ============================================================================*/
8996
8997
8998 #if defined(USE_ITHREADS)
8999
9000 #ifndef GpREFCNT_inc
9001 #  define GpREFCNT_inc(gp)      ((gp) ? (++(gp)->gp_refcnt, (gp)) : (GP*)NULL)
9002 #endif
9003
9004
9005 #define sv_dup_inc(s,t) SvREFCNT_inc(sv_dup(s,t))
9006 #define av_dup(s,t)     (AV*)sv_dup((SV*)s,t)
9007 #define av_dup_inc(s,t) (AV*)SvREFCNT_inc(sv_dup((SV*)s,t))
9008 #define hv_dup(s,t)     (HV*)sv_dup((SV*)s,t)
9009 #define hv_dup_inc(s,t) (HV*)SvREFCNT_inc(sv_dup((SV*)s,t))
9010 #define cv_dup(s,t)     (CV*)sv_dup((SV*)s,t)
9011 #define cv_dup_inc(s,t) (CV*)SvREFCNT_inc(sv_dup((SV*)s,t))
9012 #define io_dup(s,t)     (IO*)sv_dup((SV*)s,t)
9013 #define io_dup_inc(s,t) (IO*)SvREFCNT_inc(sv_dup((SV*)s,t))
9014 #define gv_dup(s,t)     (GV*)sv_dup((SV*)s,t)
9015 #define gv_dup_inc(s,t) (GV*)SvREFCNT_inc(sv_dup((SV*)s,t))
9016 #define SAVEPV(p)       ((p) ? savepv(p) : NULL)
9017 #define SAVEPVN(p,n)    ((p) ? savepvn(p,n) : NULL)
9018
9019
9020 /* Duplicate a regexp. Required reading: pregcomp() and pregfree() in
9021    regcomp.c. AMS 20010712 */
9022
9023 REGEXP *
9024 Perl_re_dup(pTHX_ const REGEXP *r, CLONE_PARAMS *param)
9025 {
9026     dVAR;
9027     REGEXP *ret;
9028     int i, len, npar;
9029     struct reg_substr_datum *s;
9030
9031     if (!r)
9032         return (REGEXP *)NULL;
9033
9034     if ((ret = (REGEXP *)ptr_table_fetch(PL_ptr_table, r)))
9035         return ret;
9036
9037     len = r->offsets[0];
9038     npar = r->nparens+1;
9039
9040     Newxc(ret, sizeof(regexp) + (len+1)*sizeof(regnode), char, regexp);
9041     Copy(r->program, ret->program, len+1, regnode);
9042
9043     Newx(ret->startp, npar, I32);
9044     Copy(r->startp, ret->startp, npar, I32);
9045     Newx(ret->endp, npar, I32);
9046     Copy(r->startp, ret->startp, npar, I32);
9047
9048     Newx(ret->substrs, 1, struct reg_substr_data);
9049     for (s = ret->substrs->data, i = 0; i < 3; i++, s++) {
9050         s->min_offset = r->substrs->data[i].min_offset;
9051         s->max_offset = r->substrs->data[i].max_offset;
9052         s->substr     = sv_dup_inc(r->substrs->data[i].substr, param);
9053         s->utf8_substr = sv_dup_inc(r->substrs->data[i].utf8_substr, param);
9054     }
9055
9056     ret->regstclass = NULL;
9057     if (r->data) {
9058         struct reg_data *d;
9059         const int count = r->data->count;
9060         int i;
9061
9062         Newxc(d, sizeof(struct reg_data) + count*sizeof(void *),
9063                 char, struct reg_data);
9064         Newx(d->what, count, U8);
9065
9066         d->count = count;
9067         for (i = 0; i < count; i++) {
9068             d->what[i] = r->data->what[i];
9069             switch (d->what[i]) {
9070                 /* legal options are one of: sfpont
9071                    see also regcomp.h and pregfree() */
9072             case 's':
9073                 d->data[i] = sv_dup_inc((SV *)r->data->data[i], param);
9074                 break;
9075             case 'p':
9076                 d->data[i] = av_dup_inc((AV *)r->data->data[i], param);
9077                 break;
9078             case 'f':
9079                 /* This is cheating. */
9080                 Newx(d->data[i], 1, struct regnode_charclass_class);
9081                 StructCopy(r->data->data[i], d->data[i],
9082                             struct regnode_charclass_class);
9083                 ret->regstclass = (regnode*)d->data[i];
9084                 break;
9085             case 'o':
9086                 /* Compiled op trees are readonly, and can thus be
9087                    shared without duplication. */
9088                 OP_REFCNT_LOCK;
9089                 d->data[i] = (void*)OpREFCNT_inc((OP*)r->data->data[i]);
9090                 OP_REFCNT_UNLOCK;
9091                 break;
9092             case 'n':
9093                 d->data[i] = r->data->data[i];
9094                 break;
9095             case 't':
9096                 d->data[i] = r->data->data[i];
9097                 OP_REFCNT_LOCK;
9098                 ((reg_trie_data*)d->data[i])->refcount++;
9099                 OP_REFCNT_UNLOCK;
9100                 break;
9101             default:
9102                 Perl_croak(aTHX_ "panic: re_dup unknown data code '%c'", r->data->what[i]);
9103             }
9104         }
9105
9106         ret->data = d;
9107     }
9108     else
9109         ret->data = NULL;
9110
9111     Newx(ret->offsets, 2*len+1, U32);
9112     Copy(r->offsets, ret->offsets, 2*len+1, U32);
9113
9114     ret->precomp        = SAVEPVN(r->precomp, r->prelen);
9115     ret->refcnt         = r->refcnt;
9116     ret->minlen         = r->minlen;
9117     ret->prelen         = r->prelen;
9118     ret->nparens        = r->nparens;
9119     ret->lastparen      = r->lastparen;
9120     ret->lastcloseparen = r->lastcloseparen;
9121     ret->reganch        = r->reganch;
9122
9123     ret->sublen         = r->sublen;
9124
9125     if (RX_MATCH_COPIED(ret))
9126         ret->subbeg  = SAVEPVN(r->subbeg, r->sublen);
9127     else
9128         ret->subbeg = NULL;
9129 #ifdef PERL_OLD_COPY_ON_WRITE
9130     ret->saved_copy = NULL;
9131 #endif
9132
9133     ptr_table_store(PL_ptr_table, r, ret);
9134     return ret;
9135 }
9136
9137 /* duplicate a file handle */
9138
9139 PerlIO *
9140 Perl_fp_dup(pTHX_ PerlIO *fp, char type, CLONE_PARAMS *param)
9141 {
9142     PerlIO *ret;
9143
9144     PERL_UNUSED_ARG(type);
9145
9146     if (!fp)
9147         return (PerlIO*)NULL;
9148
9149     /* look for it in the table first */
9150     ret = (PerlIO*)ptr_table_fetch(PL_ptr_table, fp);
9151     if (ret)
9152         return ret;
9153
9154     /* create anew and remember what it is */
9155     ret = PerlIO_fdupopen(aTHX_ fp, param, PERLIO_DUP_CLONE);
9156     ptr_table_store(PL_ptr_table, fp, ret);
9157     return ret;
9158 }
9159
9160 /* duplicate a directory handle */
9161
9162 DIR *
9163 Perl_dirp_dup(pTHX_ DIR *dp)
9164 {
9165     if (!dp)
9166         return (DIR*)NULL;
9167     /* XXX TODO */
9168     return dp;
9169 }
9170
9171 /* duplicate a typeglob */
9172
9173 GP *
9174 Perl_gp_dup(pTHX_ GP *gp, CLONE_PARAMS* param)
9175 {
9176     GP *ret;
9177     if (!gp)
9178         return (GP*)NULL;
9179     /* look for it in the table first */
9180     ret = (GP*)ptr_table_fetch(PL_ptr_table, gp);
9181     if (ret)
9182         return ret;
9183
9184     /* create anew and remember what it is */
9185     Newxz(ret, 1, GP);
9186     ptr_table_store(PL_ptr_table, gp, ret);
9187
9188     /* clone */
9189     ret->gp_refcnt      = 0;                    /* must be before any other dups! */
9190     ret->gp_sv          = sv_dup_inc(gp->gp_sv, param);
9191     ret->gp_io          = io_dup_inc(gp->gp_io, param);
9192     ret->gp_form        = cv_dup_inc(gp->gp_form, param);
9193     ret->gp_av          = av_dup_inc(gp->gp_av, param);
9194     ret->gp_hv          = hv_dup_inc(gp->gp_hv, param);
9195     ret->gp_egv = gv_dup(gp->gp_egv, param);/* GvEGV is not refcounted */
9196     ret->gp_cv          = cv_dup_inc(gp->gp_cv, param);
9197     ret->gp_cvgen       = gp->gp_cvgen;
9198     ret->gp_line        = gp->gp_line;
9199     ret->gp_file        = gp->gp_file;          /* points to COP.cop_file */
9200     return ret;
9201 }
9202
9203 /* duplicate a chain of magic */
9204
9205 MAGIC *
9206 Perl_mg_dup(pTHX_ MAGIC *mg, CLONE_PARAMS* param)
9207 {
9208     MAGIC *mgprev = (MAGIC*)NULL;
9209     MAGIC *mgret;
9210     if (!mg)
9211         return (MAGIC*)NULL;
9212     /* look for it in the table first */
9213     mgret = (MAGIC*)ptr_table_fetch(PL_ptr_table, mg);
9214     if (mgret)
9215         return mgret;
9216
9217     for (; mg; mg = mg->mg_moremagic) {
9218         MAGIC *nmg;
9219         Newxz(nmg, 1, MAGIC);
9220         if (mgprev)
9221             mgprev->mg_moremagic = nmg;
9222         else
9223             mgret = nmg;
9224         nmg->mg_virtual = mg->mg_virtual;       /* XXX copy dynamic vtable? */
9225         nmg->mg_private = mg->mg_private;
9226         nmg->mg_type    = mg->mg_type;
9227         nmg->mg_flags   = mg->mg_flags;
9228         if (mg->mg_type == PERL_MAGIC_qr) {
9229             nmg->mg_obj = (SV*)re_dup((REGEXP*)mg->mg_obj, param);
9230         }
9231         else if(mg->mg_type == PERL_MAGIC_backref) {
9232             /* The backref AV has its reference count deliberately bumped by
9233                1.  */
9234             nmg->mg_obj = SvREFCNT_inc(av_dup_inc((AV*) mg->mg_obj, param));
9235         }
9236         else if (mg->mg_type == PERL_MAGIC_symtab) {
9237             nmg->mg_obj = mg->mg_obj;
9238         }
9239         else {
9240             nmg->mg_obj = (mg->mg_flags & MGf_REFCOUNTED)
9241                               ? sv_dup_inc(mg->mg_obj, param)
9242                               : sv_dup(mg->mg_obj, param);
9243         }
9244         nmg->mg_len     = mg->mg_len;
9245         nmg->mg_ptr     = mg->mg_ptr;   /* XXX random ptr? */
9246         if (mg->mg_ptr && mg->mg_type != PERL_MAGIC_regex_global) {
9247             if (mg->mg_len > 0) {
9248                 nmg->mg_ptr     = SAVEPVN(mg->mg_ptr, mg->mg_len);
9249                 if (mg->mg_type == PERL_MAGIC_overload_table &&
9250                         AMT_AMAGIC((AMT*)mg->mg_ptr))
9251                 {
9252                     const AMT * const amtp = (AMT*)mg->mg_ptr;
9253                     AMT * const namtp = (AMT*)nmg->mg_ptr;
9254                     I32 i;
9255                     for (i = 1; i < NofAMmeth; i++) {
9256                         namtp->table[i] = cv_dup_inc(amtp->table[i], param);
9257                     }
9258                 }
9259             }
9260             else if (mg->mg_len == HEf_SVKEY)
9261                 nmg->mg_ptr     = (char*)sv_dup_inc((SV*)mg->mg_ptr, param);
9262         }
9263         if ((mg->mg_flags & MGf_DUP) && mg->mg_virtual && mg->mg_virtual->svt_dup) {
9264             CALL_FPTR(nmg->mg_virtual->svt_dup)(aTHX_ nmg, param);
9265         }
9266         mgprev = nmg;
9267     }
9268     return mgret;
9269 }
9270
9271 /* create a new pointer-mapping table */
9272
9273 PTR_TBL_t *
9274 Perl_ptr_table_new(pTHX)
9275 {
9276     PTR_TBL_t *tbl;
9277     Newxz(tbl, 1, PTR_TBL_t);
9278     tbl->tbl_max        = 511;
9279     tbl->tbl_items      = 0;
9280     Newxz(tbl->tbl_ary, tbl->tbl_max + 1, PTR_TBL_ENT_t*);
9281     return tbl;
9282 }
9283
9284 #define PTR_TABLE_HASH(ptr) \
9285   ((PTR2UV(ptr) >> 3) ^ (PTR2UV(ptr) >> (3 + 7)) ^ (PTR2UV(ptr) >> (3 + 17)))
9286
9287 /* 
9288    we use the PTE_SVSLOT 'reservation' made above, both here (in the
9289    following define) and at call to new_body_inline made below in 
9290    Perl_ptr_table_store()
9291  */
9292
9293 #define del_pte(p)     del_body_type(p, PTE_SVSLOT)
9294
9295 /* map an existing pointer using a table */
9296
9297 STATIC PTR_TBL_ENT_t *
9298 S_ptr_table_find(pTHX_ PTR_TBL_t *tbl, const void *sv) {
9299     PTR_TBL_ENT_t *tblent;
9300     const UV hash = PTR_TABLE_HASH(sv);
9301     assert(tbl);
9302     tblent = tbl->tbl_ary[hash & tbl->tbl_max];
9303     for (; tblent; tblent = tblent->next) {
9304         if (tblent->oldval == sv)
9305             return tblent;
9306     }
9307     return 0;
9308 }
9309
9310 void *
9311 Perl_ptr_table_fetch(pTHX_ PTR_TBL_t *tbl, const void *sv)
9312 {
9313     PTR_TBL_ENT_t const *const tblent = S_ptr_table_find(aTHX_ tbl, sv);
9314     return tblent ? tblent->newval : (void *) 0;
9315 }
9316
9317 /* add a new entry to a pointer-mapping table */
9318
9319 void
9320 Perl_ptr_table_store(pTHX_ PTR_TBL_t *tbl, const void *oldsv, void *newsv)
9321 {
9322     PTR_TBL_ENT_t *tblent = S_ptr_table_find(aTHX_ tbl, oldsv);
9323
9324     if (tblent) {
9325         tblent->newval = newsv;
9326     } else {
9327         const UV entry = PTR_TABLE_HASH(oldsv) & tbl->tbl_max;
9328
9329         new_body_inline(tblent, sizeof(struct ptr_tbl_ent), PTE_SVSLOT);
9330         tblent->oldval = oldsv;
9331         tblent->newval = newsv;
9332         tblent->next = tbl->tbl_ary[entry];
9333         tbl->tbl_ary[entry] = tblent;
9334         tbl->tbl_items++;
9335         if (tblent->next && tbl->tbl_items > tbl->tbl_max)
9336             ptr_table_split(tbl);
9337     }
9338 }
9339
9340 /* double the hash bucket size of an existing ptr table */
9341
9342 void
9343 Perl_ptr_table_split(pTHX_ PTR_TBL_t *tbl)
9344 {
9345     PTR_TBL_ENT_t **ary = tbl->tbl_ary;
9346     const UV oldsize = tbl->tbl_max + 1;
9347     UV newsize = oldsize * 2;
9348     UV i;
9349
9350     Renew(ary, newsize, PTR_TBL_ENT_t*);
9351     Zero(&ary[oldsize], newsize-oldsize, PTR_TBL_ENT_t*);
9352     tbl->tbl_max = --newsize;
9353     tbl->tbl_ary = ary;
9354     for (i=0; i < oldsize; i++, ary++) {
9355         PTR_TBL_ENT_t **curentp, **entp, *ent;
9356         if (!*ary)
9357             continue;
9358         curentp = ary + oldsize;
9359         for (entp = ary, ent = *ary; ent; ent = *entp) {
9360             if ((newsize & PTR_TABLE_HASH(ent->oldval)) != i) {
9361                 *entp = ent->next;
9362                 ent->next = *curentp;
9363                 *curentp = ent;
9364                 continue;
9365             }
9366             else
9367                 entp = &ent->next;
9368         }
9369     }
9370 }
9371
9372 /* remove all the entries from a ptr table */
9373
9374 void
9375 Perl_ptr_table_clear(pTHX_ PTR_TBL_t *tbl)
9376 {
9377     if (tbl && tbl->tbl_items) {
9378         register PTR_TBL_ENT_t * const * const array = tbl->tbl_ary;
9379         UV riter = tbl->tbl_max;
9380
9381         do {
9382             PTR_TBL_ENT_t *entry = array[riter];
9383
9384             while (entry) {
9385                 PTR_TBL_ENT_t * const oentry = entry;
9386                 entry = entry->next;
9387                 del_pte(oentry);
9388             }
9389         } while (riter--);
9390
9391         tbl->tbl_items = 0;
9392     }
9393 }
9394
9395 /* clear and free a ptr table */
9396
9397 void
9398 Perl_ptr_table_free(pTHX_ PTR_TBL_t *tbl)
9399 {
9400     if (!tbl) {
9401         return;
9402     }
9403     ptr_table_clear(tbl);
9404     Safefree(tbl->tbl_ary);
9405     Safefree(tbl);
9406 }
9407
9408
9409 void
9410 Perl_rvpv_dup(pTHX_ SV *dstr, const SV *sstr, CLONE_PARAMS* param)
9411 {
9412     if (SvROK(sstr)) {
9413         SvRV_set(dstr, SvWEAKREF(sstr)
9414                        ? sv_dup(SvRV(sstr), param)
9415                        : sv_dup_inc(SvRV(sstr), param));
9416
9417     }
9418     else if (SvPVX_const(sstr)) {
9419         /* Has something there */
9420         if (SvLEN(sstr)) {
9421             /* Normal PV - clone whole allocated space */
9422             SvPV_set(dstr, SAVEPVN(SvPVX_const(sstr), SvLEN(sstr)-1));
9423             if (SvREADONLY(sstr) && SvFAKE(sstr)) {
9424                 /* Not that normal - actually sstr is copy on write.
9425                    But we are a true, independant SV, so:  */
9426                 SvREADONLY_off(dstr);
9427                 SvFAKE_off(dstr);
9428             }
9429         }
9430         else {
9431             /* Special case - not normally malloced for some reason */
9432             if ((SvREADONLY(sstr) && SvFAKE(sstr))) {
9433                 /* A "shared" PV - clone it as "shared" PV */
9434                 SvPV_set(dstr,
9435                          HEK_KEY(hek_dup(SvSHARED_HEK_FROM_PV(SvPVX_const(sstr)),
9436                                          param)));
9437             }
9438             else {
9439                 /* Some other special case - random pointer */
9440                 SvPV_set(dstr, SvPVX(sstr));            
9441             }
9442         }
9443     }
9444     else {
9445         /* Copy the Null */
9446         if (SvTYPE(dstr) == SVt_RV)
9447             SvRV_set(dstr, NULL);
9448         else
9449             SvPV_set(dstr, NULL);
9450     }
9451 }
9452
9453 /* duplicate an SV of any type (including AV, HV etc) */
9454
9455 SV *
9456 Perl_sv_dup(pTHX_ const SV *sstr, CLONE_PARAMS* param)
9457 {
9458     dVAR;
9459     SV *dstr;
9460
9461     if (!sstr || SvTYPE(sstr) == SVTYPEMASK)
9462         return NULL;
9463     /* look for it in the table first */
9464     dstr = (SV*)ptr_table_fetch(PL_ptr_table, sstr);
9465     if (dstr)
9466         return dstr;
9467
9468     if(param->flags & CLONEf_JOIN_IN) {
9469         /** We are joining here so we don't want do clone
9470             something that is bad **/
9471         if (SvTYPE(sstr) == SVt_PVHV) {
9472             const char * const hvname = HvNAME_get(sstr);
9473             if (hvname)
9474                 /** don't clone stashes if they already exist **/
9475                 return (SV*)gv_stashpv(hvname,0);
9476         }
9477     }
9478
9479     /* create anew and remember what it is */
9480     new_SV(dstr);
9481
9482 #ifdef DEBUG_LEAKING_SCALARS
9483     dstr->sv_debug_optype = sstr->sv_debug_optype;
9484     dstr->sv_debug_line = sstr->sv_debug_line;
9485     dstr->sv_debug_inpad = sstr->sv_debug_inpad;
9486     dstr->sv_debug_cloned = 1;
9487     dstr->sv_debug_file = savepv(sstr->sv_debug_file);
9488 #endif
9489
9490     ptr_table_store(PL_ptr_table, sstr, dstr);
9491
9492     /* clone */
9493     SvFLAGS(dstr)       = SvFLAGS(sstr);
9494     SvFLAGS(dstr)       &= ~SVf_OOK;            /* don't propagate OOK hack */
9495     SvREFCNT(dstr)      = 0;                    /* must be before any other dups! */
9496
9497 #ifdef DEBUGGING
9498     if (SvANY(sstr) && PL_watch_pvx && SvPVX_const(sstr) == PL_watch_pvx)
9499         PerlIO_printf(Perl_debug_log, "watch at %p hit, found string \"%s\"\n",
9500                       PL_watch_pvx, SvPVX_const(sstr));
9501 #endif
9502
9503     /* don't clone objects whose class has asked us not to */
9504     if (SvOBJECT(sstr) && ! (SvFLAGS(SvSTASH(sstr)) & SVphv_CLONEABLE)) {
9505         SvFLAGS(dstr) &= ~SVTYPEMASK;
9506         SvOBJECT_off(dstr);
9507         return dstr;
9508     }
9509
9510     switch (SvTYPE(sstr)) {
9511     case SVt_NULL:
9512         SvANY(dstr)     = NULL;
9513         break;
9514     case SVt_IV:
9515         SvANY(dstr)     = (XPVIV*)((char*)&(dstr->sv_u.svu_iv) - STRUCT_OFFSET(XPVIV, xiv_iv));
9516         SvIV_set(dstr, SvIVX(sstr));
9517         break;
9518     case SVt_NV:
9519         SvANY(dstr)     = new_XNV();
9520         SvNV_set(dstr, SvNVX(sstr));
9521         break;
9522     case SVt_RV:
9523         SvANY(dstr)     = &(dstr->sv_u.svu_rv);
9524         Perl_rvpv_dup(aTHX_ dstr, sstr, param);
9525         break;
9526     default:
9527         {
9528             /* These are all the types that need complex bodies allocating.  */
9529             void *new_body;
9530             const svtype sv_type = SvTYPE(sstr);
9531             const struct body_details *const sv_type_details
9532                 = bodies_by_type + sv_type;
9533
9534             switch (sv_type) {
9535             default:
9536                 Perl_croak(aTHX_ "Bizarre SvTYPE [%" IVdf "]",
9537                            (IV)SvTYPE(sstr));
9538                 break;
9539
9540             case SVt_PVGV:
9541                 if (GvUNIQUE((GV*)sstr)) {
9542                     /* Do sharing here, and fall through */
9543                 }
9544             case SVt_PVIO:
9545             case SVt_PVFM:
9546             case SVt_PVHV:
9547             case SVt_PVAV:
9548             case SVt_PVBM:
9549             case SVt_PVCV:
9550             case SVt_PVLV:
9551             case SVt_PVMG:
9552             case SVt_PVNV:
9553             case SVt_PVIV:
9554             case SVt_PV:
9555                 assert(sv_type_details->size);
9556                 if (sv_type_details->arena) {
9557                     new_body_inline(new_body, sv_type_details->size, sv_type);
9558                     new_body
9559                         = (void*)((char*)new_body - sv_type_details->offset);
9560                 } else {
9561                     new_body = new_NOARENA(sv_type_details);
9562                 }
9563             }
9564             assert(new_body);
9565             SvANY(dstr) = new_body;
9566
9567 #ifndef PURIFY
9568             Copy(((char*)SvANY(sstr)) + sv_type_details->offset,
9569                  ((char*)SvANY(dstr)) + sv_type_details->offset,
9570                  sv_type_details->copy, char);
9571 #else
9572             Copy(((char*)SvANY(sstr)),
9573                  ((char*)SvANY(dstr)),
9574                  sv_type_details->size + sv_type_details->offset, char);
9575 #endif
9576
9577             if (sv_type != SVt_PVAV && sv_type != SVt_PVHV)
9578                 Perl_rvpv_dup(aTHX_ dstr, sstr, param);
9579
9580             /* The Copy above means that all the source (unduplicated) pointers
9581                are now in the destination.  We can check the flags and the
9582                pointers in either, but it's possible that there's less cache
9583                missing by always going for the destination.
9584                FIXME - instrument and check that assumption  */
9585             if (sv_type >= SVt_PVMG) {
9586                 if (SvMAGIC(dstr))
9587                     SvMAGIC_set(dstr, mg_dup(SvMAGIC(dstr), param));
9588                 if (SvSTASH(dstr))
9589                     SvSTASH_set(dstr, hv_dup_inc(SvSTASH(dstr), param));
9590             }
9591
9592             /* The cast silences a GCC warning about unhandled types.  */
9593             switch ((int)sv_type) {
9594             case SVt_PV:
9595                 break;
9596             case SVt_PVIV:
9597                 break;
9598             case SVt_PVNV:
9599                 break;
9600             case SVt_PVMG:
9601                 break;
9602             case SVt_PVBM:
9603                 break;
9604             case SVt_PVLV:
9605                 /* XXX LvTARGOFF sometimes holds PMOP* when DEBUGGING */
9606                 if (LvTYPE(dstr) == 't') /* for tie: unrefcnted fake (SV**) */
9607                     LvTARG(dstr) = dstr;
9608                 else if (LvTYPE(dstr) == 'T') /* for tie: fake HE */
9609                     LvTARG(dstr) = (SV*)he_dup((HE*)LvTARG(dstr), 0, param);
9610                 else
9611                     LvTARG(dstr) = sv_dup_inc(LvTARG(dstr), param);
9612                 break;
9613             case SVt_PVGV:
9614                 GvNAME(dstr)    = SAVEPVN(GvNAME(dstr), GvNAMELEN(dstr));
9615                 GvSTASH(dstr)   = hv_dup(GvSTASH(dstr), param);
9616                 /* Don't call sv_add_backref here as it's going to be created
9617                    as part of the magic cloning of the symbol table.  */
9618                 GvGP(dstr)      = gp_dup(GvGP(dstr), param);
9619                 (void)GpREFCNT_inc(GvGP(dstr));
9620                 break;
9621             case SVt_PVIO:
9622                 IoIFP(dstr)     = fp_dup(IoIFP(dstr), IoTYPE(dstr), param);
9623                 if (IoOFP(dstr) == IoIFP(sstr))
9624                     IoOFP(dstr) = IoIFP(dstr);
9625                 else
9626                     IoOFP(dstr) = fp_dup(IoOFP(dstr), IoTYPE(dstr), param);
9627                 /* PL_rsfp_filters entries have fake IoDIRP() */
9628                 if (IoDIRP(dstr) && !(IoFLAGS(dstr) & IOf_FAKE_DIRP))
9629                     IoDIRP(dstr)        = dirp_dup(IoDIRP(dstr));
9630                 if(IoFLAGS(dstr) & IOf_FAKE_DIRP) {
9631                     /* I have no idea why fake dirp (rsfps)
9632                        should be treated differently but otherwise
9633                        we end up with leaks -- sky*/
9634                     IoTOP_GV(dstr)      = gv_dup_inc(IoTOP_GV(dstr), param);
9635                     IoFMT_GV(dstr)      = gv_dup_inc(IoFMT_GV(dstr), param);
9636                     IoBOTTOM_GV(dstr)   = gv_dup_inc(IoBOTTOM_GV(dstr), param);
9637                 } else {
9638                     IoTOP_GV(dstr)      = gv_dup(IoTOP_GV(dstr), param);
9639                     IoFMT_GV(dstr)      = gv_dup(IoFMT_GV(dstr), param);
9640                     IoBOTTOM_GV(dstr)   = gv_dup(IoBOTTOM_GV(dstr), param);
9641                 }
9642                 IoTOP_NAME(dstr)        = SAVEPV(IoTOP_NAME(dstr));
9643                 IoFMT_NAME(dstr)        = SAVEPV(IoFMT_NAME(dstr));
9644                 IoBOTTOM_NAME(dstr)     = SAVEPV(IoBOTTOM_NAME(dstr));
9645                 break;
9646             case SVt_PVAV:
9647                 if (AvARRAY((AV*)sstr)) {
9648                     SV **dst_ary, **src_ary;
9649                     SSize_t items = AvFILLp((AV*)sstr) + 1;
9650
9651                     src_ary = AvARRAY((AV*)sstr);
9652                     Newxz(dst_ary, AvMAX((AV*)sstr)+1, SV*);
9653                     ptr_table_store(PL_ptr_table, src_ary, dst_ary);
9654                     SvPV_set(dstr, (char*)dst_ary);
9655                     AvALLOC((AV*)dstr) = dst_ary;
9656                     if (AvREAL((AV*)sstr)) {
9657                         while (items-- > 0)
9658                             *dst_ary++ = sv_dup_inc(*src_ary++, param);
9659                     }
9660                     else {
9661                         while (items-- > 0)
9662                             *dst_ary++ = sv_dup(*src_ary++, param);
9663                     }
9664                     items = AvMAX((AV*)sstr) - AvFILLp((AV*)sstr);
9665                     while (items-- > 0) {
9666                         *dst_ary++ = &PL_sv_undef;
9667                     }
9668                 }
9669                 else {
9670                     SvPV_set(dstr, NULL);
9671                     AvALLOC((AV*)dstr)  = (SV**)NULL;
9672                 }
9673                 break;
9674             case SVt_PVHV:
9675                 {
9676                     HEK *hvname = NULL;
9677
9678                     if (HvARRAY((HV*)sstr)) {
9679                         STRLEN i = 0;
9680                         const bool sharekeys = !!HvSHAREKEYS(sstr);
9681                         XPVHV * const dxhv = (XPVHV*)SvANY(dstr);
9682                         XPVHV * const sxhv = (XPVHV*)SvANY(sstr);
9683                         char *darray;
9684                         Newx(darray, PERL_HV_ARRAY_ALLOC_BYTES(dxhv->xhv_max+1)
9685                             + (SvOOK(sstr) ? sizeof(struct xpvhv_aux) : 0),
9686                             char);
9687                         HvARRAY(dstr) = (HE**)darray;
9688                         while (i <= sxhv->xhv_max) {
9689                             const HE *source = HvARRAY(sstr)[i];
9690                             HvARRAY(dstr)[i] = source
9691                                 ? he_dup(source, sharekeys, param) : 0;
9692                             ++i;
9693                         }
9694                         if (SvOOK(sstr)) {
9695                             struct xpvhv_aux * const saux = HvAUX(sstr);
9696                             struct xpvhv_aux * const daux = HvAUX(dstr);
9697                             /* This flag isn't copied.  */
9698                             /* SvOOK_on(hv) attacks the IV flags.  */
9699                             SvFLAGS(dstr) |= SVf_OOK;
9700
9701                             hvname = saux->xhv_name;
9702                             daux->xhv_name
9703                                 = hvname ? hek_dup(hvname, param) : hvname;
9704
9705                             daux->xhv_riter = saux->xhv_riter;
9706                             daux->xhv_eiter = saux->xhv_eiter
9707                                 ? he_dup(saux->xhv_eiter,
9708                                          (bool)!!HvSHAREKEYS(sstr), param) : 0;
9709                             daux->xhv_backreferences = saux->xhv_backreferences
9710                                 ? (AV*) SvREFCNT_inc(
9711                                                      sv_dup((SV*)saux->
9712                                                             xhv_backreferences,
9713                                                             param))
9714                                 : 0;
9715                         }
9716                     }
9717                     else {
9718                         SvPV_set(dstr, NULL);
9719                     }
9720                     /* Record stashes for possible cloning in Perl_clone(). */
9721                     if(hvname)
9722                         av_push(param->stashes, dstr);
9723                 }
9724                 break;
9725             case SVt_PVFM:
9726             case SVt_PVCV:
9727                 /* NOTE: not refcounted */
9728                 CvSTASH(dstr)   = hv_dup(CvSTASH(dstr), param);
9729                 OP_REFCNT_LOCK;
9730                 CvROOT(dstr)    = OpREFCNT_inc(CvROOT(dstr));
9731                 OP_REFCNT_UNLOCK;
9732                 if (CvCONST(dstr)) {
9733                     CvXSUBANY(dstr).any_ptr = GvUNIQUE(CvGV(dstr)) ?
9734                         SvREFCNT_inc(CvXSUBANY(dstr).any_ptr) :
9735                         sv_dup_inc((SV *)CvXSUBANY(dstr).any_ptr, param);
9736                 }
9737                 /* don't dup if copying back - CvGV isn't refcounted, so the
9738                  * duped GV may never be freed. A bit of a hack! DAPM */
9739                 CvGV(dstr)      = (param->flags & CLONEf_JOIN_IN) ?
9740                     NULL : gv_dup(CvGV(dstr), param) ;
9741                 if (!(param->flags & CLONEf_COPY_STACKS)) {
9742                     CvDEPTH(dstr) = 0;
9743                 }
9744                 PAD_DUP(CvPADLIST(dstr), CvPADLIST(sstr), param);
9745                 CvOUTSIDE(dstr) =
9746                     CvWEAKOUTSIDE(sstr)
9747                     ? cv_dup(    CvOUTSIDE(dstr), param)
9748                     : cv_dup_inc(CvOUTSIDE(dstr), param);
9749                 if (!CvXSUB(dstr))
9750                     CvFILE(dstr) = SAVEPV(CvFILE(dstr));
9751                 break;
9752             }
9753         }
9754     }
9755
9756     if (SvOBJECT(dstr) && SvTYPE(dstr) != SVt_PVIO)
9757         ++PL_sv_objcount;
9758
9759     return dstr;
9760  }
9761
9762 /* duplicate a context */
9763
9764 PERL_CONTEXT *
9765 Perl_cx_dup(pTHX_ PERL_CONTEXT *cxs, I32 ix, I32 max, CLONE_PARAMS* param)
9766 {
9767     PERL_CONTEXT *ncxs;
9768
9769     if (!cxs)
9770         return (PERL_CONTEXT*)NULL;
9771
9772     /* look for it in the table first */
9773     ncxs = (PERL_CONTEXT*)ptr_table_fetch(PL_ptr_table, cxs);
9774     if (ncxs)
9775         return ncxs;
9776
9777     /* create anew and remember what it is */
9778     Newxz(ncxs, max + 1, PERL_CONTEXT);
9779     ptr_table_store(PL_ptr_table, cxs, ncxs);
9780
9781     while (ix >= 0) {
9782         PERL_CONTEXT * const cx = &cxs[ix];
9783         PERL_CONTEXT * const ncx = &ncxs[ix];
9784         ncx->cx_type    = cx->cx_type;
9785         if (CxTYPE(cx) == CXt_SUBST) {
9786             Perl_croak(aTHX_ "Cloning substitution context is unimplemented");
9787         }
9788         else {
9789             ncx->blk_oldsp      = cx->blk_oldsp;
9790             ncx->blk_oldcop     = cx->blk_oldcop;
9791             ncx->blk_oldmarksp  = cx->blk_oldmarksp;
9792             ncx->blk_oldscopesp = cx->blk_oldscopesp;
9793             ncx->blk_oldpm      = cx->blk_oldpm;
9794             ncx->blk_gimme      = cx->blk_gimme;
9795             switch (CxTYPE(cx)) {
9796             case CXt_SUB:
9797                 ncx->blk_sub.cv         = (cx->blk_sub.olddepth == 0
9798                                            ? cv_dup_inc(cx->blk_sub.cv, param)
9799                                            : cv_dup(cx->blk_sub.cv,param));
9800                 ncx->blk_sub.argarray   = (cx->blk_sub.hasargs
9801                                            ? av_dup_inc(cx->blk_sub.argarray, param)
9802                                            : NULL);
9803                 ncx->blk_sub.savearray  = av_dup_inc(cx->blk_sub.savearray, param);
9804                 ncx->blk_sub.olddepth   = cx->blk_sub.olddepth;
9805                 ncx->blk_sub.hasargs    = cx->blk_sub.hasargs;
9806                 ncx->blk_sub.lval       = cx->blk_sub.lval;
9807                 ncx->blk_sub.retop      = cx->blk_sub.retop;
9808                 break;
9809             case CXt_EVAL:
9810                 ncx->blk_eval.old_in_eval = cx->blk_eval.old_in_eval;
9811                 ncx->blk_eval.old_op_type = cx->blk_eval.old_op_type;
9812                 ncx->blk_eval.old_namesv = sv_dup_inc(cx->blk_eval.old_namesv, param);
9813                 ncx->blk_eval.old_eval_root = cx->blk_eval.old_eval_root;
9814                 ncx->blk_eval.cur_text  = sv_dup(cx->blk_eval.cur_text, param);
9815                 ncx->blk_eval.retop = cx->blk_eval.retop;
9816                 break;
9817             case CXt_LOOP:
9818                 ncx->blk_loop.label     = cx->blk_loop.label;
9819                 ncx->blk_loop.resetsp   = cx->blk_loop.resetsp;
9820                 ncx->blk_loop.redo_op   = cx->blk_loop.redo_op;
9821                 ncx->blk_loop.next_op   = cx->blk_loop.next_op;
9822                 ncx->blk_loop.last_op   = cx->blk_loop.last_op;
9823                 ncx->blk_loop.iterdata  = (CxPADLOOP(cx)
9824                                            ? cx->blk_loop.iterdata
9825                                            : gv_dup((GV*)cx->blk_loop.iterdata, param));
9826                 ncx->blk_loop.oldcomppad
9827                     = (PAD*)ptr_table_fetch(PL_ptr_table,
9828                                             cx->blk_loop.oldcomppad);
9829                 ncx->blk_loop.itersave  = sv_dup_inc(cx->blk_loop.itersave, param);
9830                 ncx->blk_loop.iterlval  = sv_dup_inc(cx->blk_loop.iterlval, param);
9831                 ncx->blk_loop.iterary   = av_dup_inc(cx->blk_loop.iterary, param);
9832                 ncx->blk_loop.iterix    = cx->blk_loop.iterix;
9833                 ncx->blk_loop.itermax   = cx->blk_loop.itermax;
9834                 break;
9835             case CXt_FORMAT:
9836                 ncx->blk_sub.cv         = cv_dup(cx->blk_sub.cv, param);
9837                 ncx->blk_sub.gv         = gv_dup(cx->blk_sub.gv, param);
9838                 ncx->blk_sub.dfoutgv    = gv_dup_inc(cx->blk_sub.dfoutgv, param);
9839                 ncx->blk_sub.hasargs    = cx->blk_sub.hasargs;
9840                 ncx->blk_sub.retop      = cx->blk_sub.retop;
9841                 break;
9842             case CXt_BLOCK:
9843             case CXt_NULL:
9844                 break;
9845             }
9846         }
9847         --ix;
9848     }
9849     return ncxs;
9850 }
9851
9852 /* duplicate a stack info structure */
9853
9854 PERL_SI *
9855 Perl_si_dup(pTHX_ PERL_SI *si, CLONE_PARAMS* param)
9856 {
9857     PERL_SI *nsi;
9858
9859     if (!si)
9860         return (PERL_SI*)NULL;
9861
9862     /* look for it in the table first */
9863     nsi = (PERL_SI*)ptr_table_fetch(PL_ptr_table, si);
9864     if (nsi)
9865         return nsi;
9866
9867     /* create anew and remember what it is */
9868     Newxz(nsi, 1, PERL_SI);
9869     ptr_table_store(PL_ptr_table, si, nsi);
9870
9871     nsi->si_stack       = av_dup_inc(si->si_stack, param);
9872     nsi->si_cxix        = si->si_cxix;
9873     nsi->si_cxmax       = si->si_cxmax;
9874     nsi->si_cxstack     = cx_dup(si->si_cxstack, si->si_cxix, si->si_cxmax, param);
9875     nsi->si_type        = si->si_type;
9876     nsi->si_prev        = si_dup(si->si_prev, param);
9877     nsi->si_next        = si_dup(si->si_next, param);
9878     nsi->si_markoff     = si->si_markoff;
9879
9880     return nsi;
9881 }
9882
9883 #define POPINT(ss,ix)   ((ss)[--(ix)].any_i32)
9884 #define TOPINT(ss,ix)   ((ss)[ix].any_i32)
9885 #define POPLONG(ss,ix)  ((ss)[--(ix)].any_long)
9886 #define TOPLONG(ss,ix)  ((ss)[ix].any_long)
9887 #define POPIV(ss,ix)    ((ss)[--(ix)].any_iv)
9888 #define TOPIV(ss,ix)    ((ss)[ix].any_iv)
9889 #define POPBOOL(ss,ix)  ((ss)[--(ix)].any_bool)
9890 #define TOPBOOL(ss,ix)  ((ss)[ix].any_bool)
9891 #define POPPTR(ss,ix)   ((ss)[--(ix)].any_ptr)
9892 #define TOPPTR(ss,ix)   ((ss)[ix].any_ptr)
9893 #define POPDPTR(ss,ix)  ((ss)[--(ix)].any_dptr)
9894 #define TOPDPTR(ss,ix)  ((ss)[ix].any_dptr)
9895 #define POPDXPTR(ss,ix) ((ss)[--(ix)].any_dxptr)
9896 #define TOPDXPTR(ss,ix) ((ss)[ix].any_dxptr)
9897
9898 /* XXXXX todo */
9899 #define pv_dup_inc(p)   SAVEPV(p)
9900 #define pv_dup(p)       SAVEPV(p)
9901 #define svp_dup_inc(p,pp)       any_dup(p,pp)
9902
9903 /* map any object to the new equivent - either something in the
9904  * ptr table, or something in the interpreter structure
9905  */
9906
9907 void *
9908 Perl_any_dup(pTHX_ void *v, const PerlInterpreter *proto_perl)
9909 {
9910     void *ret;
9911
9912     if (!v)
9913         return (void*)NULL;
9914
9915     /* look for it in the table first */
9916     ret = ptr_table_fetch(PL_ptr_table, v);
9917     if (ret)
9918         return ret;
9919
9920     /* see if it is part of the interpreter structure */
9921     if (v >= (void*)proto_perl && v < (void*)(proto_perl+1))
9922         ret = (void*)(((char*)aTHX) + (((char*)v) - (char*)proto_perl));
9923     else {
9924         ret = v;
9925     }
9926
9927     return ret;
9928 }
9929
9930 /* duplicate the save stack */
9931
9932 ANY *
9933 Perl_ss_dup(pTHX_ PerlInterpreter *proto_perl, CLONE_PARAMS* param)
9934 {
9935     ANY * const ss      = proto_perl->Tsavestack;
9936     const I32 max       = proto_perl->Tsavestack_max;
9937     I32 ix              = proto_perl->Tsavestack_ix;
9938     ANY *nss;
9939     SV *sv;
9940     GV *gv;
9941     AV *av;
9942     HV *hv;
9943     void* ptr;
9944     int intval;
9945     long longval;
9946     GP *gp;
9947     IV iv;
9948     char *c = NULL;
9949     void (*dptr) (void*);
9950     void (*dxptr) (pTHX_ void*);
9951
9952     Newxz(nss, max, ANY);
9953
9954     while (ix > 0) {
9955         I32 i = POPINT(ss,ix);
9956         TOPINT(nss,ix) = i;
9957         switch (i) {
9958         case SAVEt_ITEM:                        /* normal string */
9959             sv = (SV*)POPPTR(ss,ix);
9960             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
9961             sv = (SV*)POPPTR(ss,ix);
9962             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
9963             break;
9964         case SAVEt_SV:                          /* scalar reference */
9965             sv = (SV*)POPPTR(ss,ix);
9966             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
9967             gv = (GV*)POPPTR(ss,ix);
9968             TOPPTR(nss,ix) = gv_dup_inc(gv, param);
9969             break;
9970         case SAVEt_GENERIC_PVREF:               /* generic char* */
9971             c = (char*)POPPTR(ss,ix);
9972             TOPPTR(nss,ix) = pv_dup(c);
9973             ptr = POPPTR(ss,ix);
9974             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
9975             break;
9976         case SAVEt_SHARED_PVREF:                /* char* in shared space */
9977             c = (char*)POPPTR(ss,ix);
9978             TOPPTR(nss,ix) = savesharedpv(c);
9979             ptr = POPPTR(ss,ix);
9980             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
9981             break;
9982         case SAVEt_GENERIC_SVREF:               /* generic sv */
9983         case SAVEt_SVREF:                       /* scalar reference */
9984             sv = (SV*)POPPTR(ss,ix);
9985             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
9986             ptr = POPPTR(ss,ix);
9987             TOPPTR(nss,ix) = svp_dup_inc((SV**)ptr, proto_perl);/* XXXXX */
9988             break;
9989         case SAVEt_AV:                          /* array reference */
9990             av = (AV*)POPPTR(ss,ix);
9991             TOPPTR(nss,ix) = av_dup_inc(av, param);
9992             gv = (GV*)POPPTR(ss,ix);
9993             TOPPTR(nss,ix) = gv_dup(gv, param);
9994             break;
9995         case SAVEt_HV:                          /* hash reference */
9996             hv = (HV*)POPPTR(ss,ix);
9997             TOPPTR(nss,ix) = hv_dup_inc(hv, param);
9998             gv = (GV*)POPPTR(ss,ix);
9999             TOPPTR(nss,ix) = gv_dup(gv, param);
10000             break;
10001         case SAVEt_INT:                         /* int reference */
10002             ptr = POPPTR(ss,ix);
10003             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10004             intval = (int)POPINT(ss,ix);
10005             TOPINT(nss,ix) = intval;
10006             break;
10007         case SAVEt_LONG:                        /* long reference */
10008             ptr = POPPTR(ss,ix);
10009             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10010             longval = (long)POPLONG(ss,ix);
10011             TOPLONG(nss,ix) = longval;
10012             break;
10013         case SAVEt_I32:                         /* I32 reference */
10014         case SAVEt_I16:                         /* I16 reference */
10015         case SAVEt_I8:                          /* I8 reference */
10016             ptr = POPPTR(ss,ix);
10017             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10018             i = POPINT(ss,ix);
10019             TOPINT(nss,ix) = i;
10020             break;
10021         case SAVEt_IV:                          /* IV reference */
10022             ptr = POPPTR(ss,ix);
10023             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10024             iv = POPIV(ss,ix);
10025             TOPIV(nss,ix) = iv;
10026             break;
10027         case SAVEt_SPTR:                        /* SV* reference */
10028             ptr = POPPTR(ss,ix);
10029             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10030             sv = (SV*)POPPTR(ss,ix);
10031             TOPPTR(nss,ix) = sv_dup(sv, param);
10032             break;
10033         case SAVEt_VPTR:                        /* random* reference */
10034             ptr = POPPTR(ss,ix);
10035             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10036             ptr = POPPTR(ss,ix);
10037             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10038             break;
10039         case SAVEt_PPTR:                        /* char* reference */
10040             ptr = POPPTR(ss,ix);
10041             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10042             c = (char*)POPPTR(ss,ix);
10043             TOPPTR(nss,ix) = pv_dup(c);
10044             break;
10045         case SAVEt_HPTR:                        /* HV* reference */
10046             ptr = POPPTR(ss,ix);
10047             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10048             hv = (HV*)POPPTR(ss,ix);
10049             TOPPTR(nss,ix) = hv_dup(hv, param);
10050             break;
10051         case SAVEt_APTR:                        /* AV* reference */
10052             ptr = POPPTR(ss,ix);
10053             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10054             av = (AV*)POPPTR(ss,ix);
10055             TOPPTR(nss,ix) = av_dup(av, param);
10056             break;
10057         case SAVEt_NSTAB:
10058             gv = (GV*)POPPTR(ss,ix);
10059             TOPPTR(nss,ix) = gv_dup(gv, param);
10060             break;
10061         case SAVEt_GP:                          /* scalar reference */
10062             gp = (GP*)POPPTR(ss,ix);
10063             TOPPTR(nss,ix) = gp = gp_dup(gp, param);
10064             (void)GpREFCNT_inc(gp);
10065             gv = (GV*)POPPTR(ss,ix);
10066             TOPPTR(nss,ix) = gv_dup_inc(gv, param);
10067             c = (char*)POPPTR(ss,ix);
10068             TOPPTR(nss,ix) = pv_dup(c);
10069             iv = POPIV(ss,ix);
10070             TOPIV(nss,ix) = iv;
10071             iv = POPIV(ss,ix);
10072             TOPIV(nss,ix) = iv;
10073             break;
10074         case SAVEt_FREESV:
10075         case SAVEt_MORTALIZESV:
10076             sv = (SV*)POPPTR(ss,ix);
10077             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
10078             break;
10079         case SAVEt_FREEOP:
10080             ptr = POPPTR(ss,ix);
10081             if (ptr && (((OP*)ptr)->op_private & OPpREFCOUNTED)) {
10082                 /* these are assumed to be refcounted properly */
10083                 OP *o;
10084                 switch (((OP*)ptr)->op_type) {
10085                 case OP_LEAVESUB:
10086                 case OP_LEAVESUBLV:
10087                 case OP_LEAVEEVAL:
10088                 case OP_LEAVE:
10089                 case OP_SCOPE:
10090                 case OP_LEAVEWRITE:
10091                     TOPPTR(nss,ix) = ptr;
10092                     o = (OP*)ptr;
10093                     OpREFCNT_inc(o);
10094                     break;
10095                 default:
10096                     TOPPTR(nss,ix) = Nullop;
10097                     break;
10098                 }
10099             }
10100             else
10101                 TOPPTR(nss,ix) = Nullop;
10102             break;
10103         case SAVEt_FREEPV:
10104             c = (char*)POPPTR(ss,ix);
10105             TOPPTR(nss,ix) = pv_dup_inc(c);
10106             break;
10107         case SAVEt_CLEARSV:
10108             longval = POPLONG(ss,ix);
10109             TOPLONG(nss,ix) = longval;
10110             break;
10111         case SAVEt_DELETE:
10112             hv = (HV*)POPPTR(ss,ix);
10113             TOPPTR(nss,ix) = hv_dup_inc(hv, param);
10114             c = (char*)POPPTR(ss,ix);
10115             TOPPTR(nss,ix) = pv_dup_inc(c);
10116             i = POPINT(ss,ix);
10117             TOPINT(nss,ix) = i;
10118             break;
10119         case SAVEt_DESTRUCTOR:
10120             ptr = POPPTR(ss,ix);
10121             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);  /* XXX quite arbitrary */
10122             dptr = POPDPTR(ss,ix);
10123             TOPDPTR(nss,ix) = DPTR2FPTR(void (*)(void*),
10124                                         any_dup(FPTR2DPTR(void *, dptr),
10125                                                 proto_perl));
10126             break;
10127         case SAVEt_DESTRUCTOR_X:
10128             ptr = POPPTR(ss,ix);
10129             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);  /* XXX quite arbitrary */
10130             dxptr = POPDXPTR(ss,ix);
10131             TOPDXPTR(nss,ix) = DPTR2FPTR(void (*)(pTHX_ void*),
10132                                          any_dup(FPTR2DPTR(void *, dxptr),
10133                                                  proto_perl));
10134             break;
10135         case SAVEt_REGCONTEXT:
10136         case SAVEt_ALLOC:
10137             i = POPINT(ss,ix);
10138             TOPINT(nss,ix) = i;
10139             ix -= i;
10140             break;
10141         case SAVEt_STACK_POS:           /* Position on Perl stack */
10142             i = POPINT(ss,ix);
10143             TOPINT(nss,ix) = i;
10144             break;
10145         case SAVEt_AELEM:               /* array element */
10146             sv = (SV*)POPPTR(ss,ix);
10147             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
10148             i = POPINT(ss,ix);
10149             TOPINT(nss,ix) = i;
10150             av = (AV*)POPPTR(ss,ix);
10151             TOPPTR(nss,ix) = av_dup_inc(av, param);
10152             break;
10153         case SAVEt_HELEM:               /* hash element */
10154             sv = (SV*)POPPTR(ss,ix);
10155             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
10156             sv = (SV*)POPPTR(ss,ix);
10157             TOPPTR(nss,ix) = sv_dup_inc(sv, param);
10158             hv = (HV*)POPPTR(ss,ix);
10159             TOPPTR(nss,ix) = hv_dup_inc(hv, param);
10160             break;
10161         case SAVEt_OP:
10162             ptr = POPPTR(ss,ix);
10163             TOPPTR(nss,ix) = ptr;
10164             break;
10165         case SAVEt_HINTS:
10166             i = POPINT(ss,ix);
10167             TOPINT(nss,ix) = i;
10168             break;
10169         case SAVEt_COMPPAD:
10170             av = (AV*)POPPTR(ss,ix);
10171             TOPPTR(nss,ix) = av_dup(av, param);
10172             break;
10173         case SAVEt_PADSV:
10174             longval = (long)POPLONG(ss,ix);
10175             TOPLONG(nss,ix) = longval;
10176             ptr = POPPTR(ss,ix);
10177             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10178             sv = (SV*)POPPTR(ss,ix);
10179             TOPPTR(nss,ix) = sv_dup(sv, param);
10180             break;
10181         case SAVEt_BOOL:
10182             ptr = POPPTR(ss,ix);
10183             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
10184             longval = (long)POPBOOL(ss,ix);
10185             TOPBOOL(nss,ix) = (bool)longval;
10186             break;
10187         case SAVEt_SET_SVFLAGS:
10188             i = POPINT(ss,ix);
10189             TOPINT(nss,ix) = i;
10190             i = POPINT(ss,ix);
10191             TOPINT(nss,ix) = i;
10192             sv = (SV*)POPPTR(ss,ix);
10193             TOPPTR(nss,ix) = sv_dup(sv, param);
10194             break;
10195         default:
10196             Perl_croak(aTHX_ "panic: ss_dup inconsistency");
10197         }
10198     }
10199
10200     return nss;
10201 }
10202
10203
10204 /* if sv is a stash, call $class->CLONE_SKIP(), and set the SVphv_CLONEABLE
10205  * flag to the result. This is done for each stash before cloning starts,
10206  * so we know which stashes want their objects cloned */
10207
10208 static void
10209 do_mark_cloneable_stash(pTHX_ SV *sv)
10210 {
10211     const HEK * const hvname = HvNAME_HEK((HV*)sv);
10212     if (hvname) {
10213         GV* const cloner = gv_fetchmethod_autoload((HV*)sv, "CLONE_SKIP", 0);
10214         SvFLAGS(sv) |= SVphv_CLONEABLE; /* clone objects by default */
10215         if (cloner && GvCV(cloner)) {
10216             dSP;
10217             UV status;
10218
10219             ENTER;
10220             SAVETMPS;
10221             PUSHMARK(SP);
10222             XPUSHs(sv_2mortal(newSVhek(hvname)));
10223             PUTBACK;
10224             call_sv((SV*)GvCV(cloner), G_SCALAR);
10225             SPAGAIN;
10226             status = POPu;
10227             PUTBACK;
10228             FREETMPS;
10229             LEAVE;
10230             if (status)
10231                 SvFLAGS(sv) &= ~SVphv_CLONEABLE;
10232         }
10233     }
10234 }
10235
10236
10237
10238 /*
10239 =for apidoc perl_clone
10240
10241 Create and return a new interpreter by cloning the current one.
10242
10243 perl_clone takes these flags as parameters:
10244
10245 CLONEf_COPY_STACKS - is used to, well, copy the stacks also,
10246 without it we only clone the data and zero the stacks,
10247 with it we copy the stacks and the new perl interpreter is
10248 ready to run at the exact same point as the previous one.
10249 The pseudo-fork code uses COPY_STACKS while the
10250 threads->new doesn't.
10251
10252 CLONEf_KEEP_PTR_TABLE
10253 perl_clone keeps a ptr_table with the pointer of the old
10254 variable as a key and the new variable as a value,
10255 this allows it to check if something has been cloned and not
10256 clone it again but rather just use the value and increase the
10257 refcount. If KEEP_PTR_TABLE is not set then perl_clone will kill
10258 the ptr_table using the function
10259 C<ptr_table_free(PL_ptr_table); PL_ptr_table = NULL;>,
10260 reason to keep it around is if you want to dup some of your own
10261 variable who are outside the graph perl scans, example of this
10262 code is in threads.xs create
10263
10264 CLONEf_CLONE_HOST
10265 This is a win32 thing, it is ignored on unix, it tells perls
10266 win32host code (which is c++) to clone itself, this is needed on
10267 win32 if you want to run two threads at the same time,
10268 if you just want to do some stuff in a separate perl interpreter
10269 and then throw it away and return to the original one,
10270 you don't need to do anything.
10271
10272 =cut
10273 */
10274
10275 /* XXX the above needs expanding by someone who actually understands it ! */
10276 EXTERN_C PerlInterpreter *
10277 perl_clone_host(PerlInterpreter* proto_perl, UV flags);
10278
10279 PerlInterpreter *
10280 perl_clone(PerlInterpreter *proto_perl, UV flags)
10281 {
10282    dVAR;
10283 #ifdef PERL_IMPLICIT_SYS
10284
10285    /* perlhost.h so we need to call into it
10286    to clone the host, CPerlHost should have a c interface, sky */
10287
10288    if (flags & CLONEf_CLONE_HOST) {
10289        return perl_clone_host(proto_perl,flags);
10290    }
10291    return perl_clone_using(proto_perl, flags,
10292                             proto_perl->IMem,
10293                             proto_perl->IMemShared,
10294                             proto_perl->IMemParse,
10295                             proto_perl->IEnv,
10296                             proto_perl->IStdIO,
10297                             proto_perl->ILIO,
10298                             proto_perl->IDir,
10299                             proto_perl->ISock,
10300                             proto_perl->IProc);
10301 }
10302
10303 PerlInterpreter *
10304 perl_clone_using(PerlInterpreter *proto_perl, UV flags,
10305                  struct IPerlMem* ipM, struct IPerlMem* ipMS,
10306                  struct IPerlMem* ipMP, struct IPerlEnv* ipE,
10307                  struct IPerlStdIO* ipStd, struct IPerlLIO* ipLIO,
10308                  struct IPerlDir* ipD, struct IPerlSock* ipS,
10309                  struct IPerlProc* ipP)
10310 {
10311     /* XXX many of the string copies here can be optimized if they're
10312      * constants; they need to be allocated as common memory and just
10313      * their pointers copied. */
10314
10315     IV i;
10316     CLONE_PARAMS clone_params;
10317     CLONE_PARAMS* param = &clone_params;
10318
10319     PerlInterpreter *my_perl = (PerlInterpreter*)(*ipM->pMalloc)(ipM, sizeof(PerlInterpreter));
10320     /* for each stash, determine whether its objects should be cloned */
10321     S_visit(proto_perl, do_mark_cloneable_stash, SVt_PVHV, SVTYPEMASK);
10322     PERL_SET_THX(my_perl);
10323
10324 #  ifdef DEBUGGING
10325     Poison(my_perl, 1, PerlInterpreter);
10326     PL_op = Nullop;
10327     PL_curcop = (COP *)Nullop;
10328     PL_markstack = 0;
10329     PL_scopestack = 0;
10330     PL_savestack = 0;
10331     PL_savestack_ix = 0;
10332     PL_savestack_max = -1;
10333     PL_sig_pending = 0;
10334     Zero(&PL_debug_pad, 1, struct perl_debug_pad);
10335 #  else /* !DEBUGGING */
10336     Zero(my_perl, 1, PerlInterpreter);
10337 #  endif        /* DEBUGGING */
10338
10339     /* host pointers */
10340     PL_Mem              = ipM;
10341     PL_MemShared        = ipMS;
10342     PL_MemParse         = ipMP;
10343     PL_Env              = ipE;
10344     PL_StdIO            = ipStd;
10345     PL_LIO              = ipLIO;
10346     PL_Dir              = ipD;
10347     PL_Sock             = ipS;
10348     PL_Proc             = ipP;
10349 #else           /* !PERL_IMPLICIT_SYS */
10350     IV i;
10351     CLONE_PARAMS clone_params;
10352     CLONE_PARAMS* param = &clone_params;
10353     PerlInterpreter *my_perl = (PerlInterpreter*)PerlMem_malloc(sizeof(PerlInterpreter));
10354     /* for each stash, determine whether its objects should be cloned */
10355     S_visit(proto_perl, do_mark_cloneable_stash, SVt_PVHV, SVTYPEMASK);
10356     PERL_SET_THX(my_perl);
10357
10358 #    ifdef DEBUGGING
10359     Poison(my_perl, 1, PerlInterpreter);
10360     PL_op = Nullop;
10361     PL_curcop = (COP *)Nullop;
10362     PL_markstack = 0;
10363     PL_scopestack = 0;
10364     PL_savestack = 0;
10365     PL_savestack_ix = 0;
10366     PL_savestack_max = -1;
10367     PL_sig_pending = 0;
10368     Zero(&PL_debug_pad, 1, struct perl_debug_pad);
10369 #    else       /* !DEBUGGING */
10370     Zero(my_perl, 1, PerlInterpreter);
10371 #    endif      /* DEBUGGING */
10372 #endif          /* PERL_IMPLICIT_SYS */
10373     param->flags = flags;
10374     param->proto_perl = proto_perl;
10375
10376     INIT_TRACK_MEMPOOL(my_perl->Imemory_debug_header, my_perl);
10377
10378     PL_body_arenas = NULL;
10379     Zero(&PL_body_roots, 1, PL_body_roots);
10380     
10381     PL_nice_chunk       = NULL;
10382     PL_nice_chunk_size  = 0;
10383     PL_sv_count         = 0;
10384     PL_sv_objcount      = 0;
10385     PL_sv_root          = NULL;
10386     PL_sv_arenaroot     = NULL;
10387
10388     PL_debug            = proto_perl->Idebug;
10389
10390     PL_hash_seed        = proto_perl->Ihash_seed;
10391     PL_rehash_seed      = proto_perl->Irehash_seed;
10392
10393 #ifdef USE_REENTRANT_API
10394     /* XXX: things like -Dm will segfault here in perlio, but doing
10395      *  PERL_SET_CONTEXT(proto_perl);
10396      * breaks too many other things
10397      */
10398     Perl_reentrant_init(aTHX);
10399 #endif
10400
10401     /* create SV map for pointer relocation */
10402     PL_ptr_table = ptr_table_new();
10403
10404     /* initialize these special pointers as early as possible */
10405     SvANY(&PL_sv_undef)         = NULL;
10406     SvREFCNT(&PL_sv_undef)      = (~(U32)0)/2;
10407     SvFLAGS(&PL_sv_undef)       = SVf_READONLY|SVt_NULL;
10408     ptr_table_store(PL_ptr_table, &proto_perl->Isv_undef, &PL_sv_undef);
10409
10410     SvANY(&PL_sv_no)            = new_XPVNV();
10411     SvREFCNT(&PL_sv_no)         = (~(U32)0)/2;
10412     SvFLAGS(&PL_sv_no)          = SVp_IOK|SVf_IOK|SVp_NOK|SVf_NOK
10413                                   |SVp_POK|SVf_POK|SVf_READONLY|SVt_PVNV;
10414     SvPV_set(&PL_sv_no, SAVEPVN(PL_No, 0));
10415     SvCUR_set(&PL_sv_no, 0);
10416     SvLEN_set(&PL_sv_no, 1);
10417     SvIV_set(&PL_sv_no, 0);
10418     SvNV_set(&PL_sv_no, 0);
10419     ptr_table_store(PL_ptr_table, &proto_perl->Isv_no, &PL_sv_no);
10420
10421     SvANY(&PL_sv_yes)           = new_XPVNV();
10422     SvREFCNT(&PL_sv_yes)        = (~(U32)0)/2;
10423     SvFLAGS(&PL_sv_yes)         = SVp_IOK|SVf_IOK|SVp_NOK|SVf_NOK
10424                                   |SVp_POK|SVf_POK|SVf_READONLY|SVt_PVNV;
10425     SvPV_set(&PL_sv_yes, SAVEPVN(PL_Yes, 1));
10426     SvCUR_set(&PL_sv_yes, 1);
10427     SvLEN_set(&PL_sv_yes, 2);
10428     SvIV_set(&PL_sv_yes, 1);
10429     SvNV_set(&PL_sv_yes, 1);
10430     ptr_table_store(PL_ptr_table, &proto_perl->Isv_yes, &PL_sv_yes);
10431
10432     /* create (a non-shared!) shared string table */
10433     PL_strtab           = newHV();
10434     HvSHAREKEYS_off(PL_strtab);
10435     hv_ksplit(PL_strtab, HvTOTALKEYS(proto_perl->Istrtab));
10436     ptr_table_store(PL_ptr_table, proto_perl->Istrtab, PL_strtab);
10437
10438     PL_compiling = proto_perl->Icompiling;
10439
10440     /* These two PVs will be free'd special way so must set them same way op.c does */
10441     PL_compiling.cop_stashpv = savesharedpv(PL_compiling.cop_stashpv);
10442     ptr_table_store(PL_ptr_table, proto_perl->Icompiling.cop_stashpv, PL_compiling.cop_stashpv);
10443
10444     PL_compiling.cop_file    = savesharedpv(PL_compiling.cop_file);
10445     ptr_table_store(PL_ptr_table, proto_perl->Icompiling.cop_file, PL_compiling.cop_file);
10446
10447     ptr_table_store(PL_ptr_table, &proto_perl->Icompiling, &PL_compiling);
10448     if (!specialWARN(PL_compiling.cop_warnings))
10449         PL_compiling.cop_warnings = sv_dup_inc(PL_compiling.cop_warnings, param);
10450     if (!specialCopIO(PL_compiling.cop_io))
10451         PL_compiling.cop_io = sv_dup_inc(PL_compiling.cop_io, param);
10452     PL_curcop           = (COP*)any_dup(proto_perl->Tcurcop, proto_perl);
10453
10454     /* pseudo environmental stuff */
10455     PL_origargc         = proto_perl->Iorigargc;
10456     PL_origargv         = proto_perl->Iorigargv;
10457
10458     param->stashes      = newAV();  /* Setup array of objects to call clone on */
10459
10460     /* Set tainting stuff before PerlIO_debug can possibly get called */
10461     PL_tainting         = proto_perl->Itainting;
10462     PL_taint_warn       = proto_perl->Itaint_warn;
10463
10464 #ifdef PERLIO_LAYERS
10465     /* Clone PerlIO tables as soon as we can handle general xx_dup() */
10466     PerlIO_clone(aTHX_ proto_perl, param);
10467 #endif
10468
10469     PL_envgv            = gv_dup(proto_perl->Ienvgv, param);
10470     PL_incgv            = gv_dup(proto_perl->Iincgv, param);
10471     PL_hintgv           = gv_dup(proto_perl->Ihintgv, param);
10472     PL_origfilename     = SAVEPV(proto_perl->Iorigfilename);
10473     PL_diehook          = sv_dup_inc(proto_perl->Idiehook, param);
10474     PL_warnhook         = sv_dup_inc(proto_perl->Iwarnhook, param);
10475
10476     /* switches */
10477     PL_minus_c          = proto_perl->Iminus_c;
10478     PL_patchlevel       = sv_dup_inc(proto_perl->Ipatchlevel, param);
10479     PL_localpatches     = proto_perl->Ilocalpatches;
10480     PL_splitstr         = proto_perl->Isplitstr;
10481     PL_preprocess       = proto_perl->Ipreprocess;
10482     PL_minus_n          = proto_perl->Iminus_n;
10483     PL_minus_p          = proto_perl->Iminus_p;
10484     PL_minus_l          = proto_perl->Iminus_l;
10485     PL_minus_a          = proto_perl->Iminus_a;
10486     PL_minus_E          = proto_perl->Iminus_E;
10487     PL_minus_F          = proto_perl->Iminus_F;
10488     PL_doswitches       = proto_perl->Idoswitches;
10489     PL_dowarn           = proto_perl->Idowarn;
10490     PL_doextract        = proto_perl->Idoextract;
10491     PL_sawampersand     = proto_perl->Isawampersand;
10492     PL_unsafe           = proto_perl->Iunsafe;
10493     PL_inplace          = SAVEPV(proto_perl->Iinplace);
10494     PL_e_script         = sv_dup_inc(proto_perl->Ie_script, param);
10495     PL_perldb           = proto_perl->Iperldb;
10496     PL_perl_destruct_level = proto_perl->Iperl_destruct_level;
10497     PL_exit_flags       = proto_perl->Iexit_flags;
10498
10499     /* magical thingies */
10500     /* XXX time(&PL_basetime) when asked for? */
10501     PL_basetime         = proto_perl->Ibasetime;
10502     PL_formfeed         = sv_dup(proto_perl->Iformfeed, param);
10503
10504     PL_maxsysfd         = proto_perl->Imaxsysfd;
10505     PL_multiline        = proto_perl->Imultiline;
10506     PL_statusvalue      = proto_perl->Istatusvalue;
10507 #ifdef VMS
10508     PL_statusvalue_vms  = proto_perl->Istatusvalue_vms;
10509 #else
10510     PL_statusvalue_posix = proto_perl->Istatusvalue_posix;
10511 #endif
10512     PL_encoding         = sv_dup(proto_perl->Iencoding, param);
10513
10514     sv_setpvn(PERL_DEBUG_PAD(0), "", 0);        /* For regex debugging. */
10515     sv_setpvn(PERL_DEBUG_PAD(1), "", 0);        /* ext/re needs these */
10516     sv_setpvn(PERL_DEBUG_PAD(2), "", 0);        /* even without DEBUGGING. */
10517
10518     /* Clone the regex array */
10519     PL_regex_padav = newAV();
10520     {
10521         const I32 len = av_len((AV*)proto_perl->Iregex_padav);
10522         SV* const * const regexen = AvARRAY((AV*)proto_perl->Iregex_padav);
10523         IV i;
10524         av_push(PL_regex_padav,
10525                 sv_dup_inc(regexen[0],param));
10526         for(i = 1; i <= len; i++) {
10527             const SV * const regex = regexen[i];
10528             SV * const sv =
10529                 SvREPADTMP(regex)
10530                     ? sv_dup_inc(regex, param)
10531                     : SvREFCNT_inc(
10532                         newSViv(PTR2IV(re_dup(
10533                                 INT2PTR(REGEXP *, SvIVX(regex)), param))))
10534                 ;
10535             av_push(PL_regex_padav, sv);
10536         }
10537     }
10538     PL_regex_pad = AvARRAY(PL_regex_padav);
10539
10540     /* shortcuts to various I/O objects */
10541     PL_stdingv          = gv_dup(proto_perl->Istdingv, param);
10542     PL_stderrgv         = gv_dup(proto_perl->Istderrgv, param);
10543     PL_defgv            = gv_dup(proto_perl->Idefgv, param);
10544     PL_argvgv           = gv_dup(proto_perl->Iargvgv, param);
10545     PL_argvoutgv        = gv_dup(proto_perl->Iargvoutgv, param);
10546     PL_argvout_stack    = av_dup_inc(proto_perl->Iargvout_stack, param);
10547
10548     /* shortcuts to regexp stuff */
10549     PL_replgv           = gv_dup(proto_perl->Ireplgv, param);
10550
10551     /* shortcuts to misc objects */
10552     PL_errgv            = gv_dup(proto_perl->Ierrgv, param);
10553
10554     /* shortcuts to debugging objects */
10555     PL_DBgv             = gv_dup(proto_perl->IDBgv, param);
10556     PL_DBline           = gv_dup(proto_perl->IDBline, param);
10557     PL_DBsub            = gv_dup(proto_perl->IDBsub, param);
10558     PL_DBsingle         = sv_dup(proto_perl->IDBsingle, param);
10559     PL_DBtrace          = sv_dup(proto_perl->IDBtrace, param);
10560     PL_DBsignal         = sv_dup(proto_perl->IDBsignal, param);
10561     PL_DBassertion      = sv_dup(proto_perl->IDBassertion, param);
10562     PL_lineary          = av_dup(proto_perl->Ilineary, param);
10563     PL_dbargs           = av_dup(proto_perl->Idbargs, param);
10564
10565     /* symbol tables */
10566     PL_defstash         = hv_dup_inc(proto_perl->Tdefstash, param);
10567     PL_curstash         = hv_dup(proto_perl->Tcurstash, param);
10568     PL_debstash         = hv_dup(proto_perl->Idebstash, param);
10569     PL_globalstash      = hv_dup(proto_perl->Iglobalstash, param);
10570     PL_curstname        = sv_dup_inc(proto_perl->Icurstname, param);
10571
10572     PL_beginav          = av_dup_inc(proto_perl->Ibeginav, param);
10573     PL_beginav_save     = av_dup_inc(proto_perl->Ibeginav_save, param);
10574     PL_checkav_save     = av_dup_inc(proto_perl->Icheckav_save, param);
10575     PL_endav            = av_dup_inc(proto_perl->Iendav, param);
10576     PL_checkav          = av_dup_inc(proto_perl->Icheckav, param);
10577     PL_initav           = av_dup_inc(proto_perl->Iinitav, param);
10578
10579     PL_sub_generation   = proto_perl->Isub_generation;
10580
10581     /* funky return mechanisms */
10582     PL_forkprocess      = proto_perl->Iforkprocess;
10583
10584     /* subprocess state */
10585     PL_fdpid            = av_dup_inc(proto_perl->Ifdpid, param);
10586
10587     /* internal state */
10588     PL_maxo             = proto_perl->Imaxo;
10589     if (proto_perl->Iop_mask)
10590         PL_op_mask      = SAVEPVN(proto_perl->Iop_mask, PL_maxo);
10591     else
10592         PL_op_mask      = NULL;
10593     /* PL_asserting        = proto_perl->Iasserting; */
10594
10595     /* current interpreter roots */
10596     PL_main_cv          = cv_dup_inc(proto_perl->Imain_cv, param);
10597     PL_main_root        = OpREFCNT_inc(proto_perl->Imain_root);
10598     PL_main_start       = proto_perl->Imain_start;
10599     PL_eval_root        = proto_perl->Ieval_root;
10600     PL_eval_start       = proto_perl->Ieval_start;
10601
10602     /* runtime control stuff */
10603     PL_curcopdb         = (COP*)any_dup(proto_perl->Icurcopdb, proto_perl);
10604     PL_copline          = proto_perl->Icopline;
10605
10606     PL_filemode         = proto_perl->Ifilemode;
10607     PL_lastfd           = proto_perl->Ilastfd;
10608     PL_oldname          = proto_perl->Ioldname;         /* XXX not quite right */
10609     PL_Argv             = NULL;
10610     PL_Cmd              = NULL;
10611     PL_gensym           = proto_perl->Igensym;
10612     PL_preambled        = proto_perl->Ipreambled;
10613     PL_preambleav       = av_dup_inc(proto_perl->Ipreambleav, param);
10614     PL_laststatval      = proto_perl->Ilaststatval;
10615     PL_laststype        = proto_perl->Ilaststype;
10616     PL_mess_sv          = NULL;
10617
10618     PL_ors_sv           = sv_dup_inc(proto_perl->Iors_sv, param);
10619
10620     /* interpreter atexit processing */
10621     PL_exitlistlen      = proto_perl->Iexitlistlen;
10622     if (PL_exitlistlen) {
10623         Newx(PL_exitlist, PL_exitlistlen, PerlExitListEntry);
10624         Copy(proto_perl->Iexitlist, PL_exitlist, PL_exitlistlen, PerlExitListEntry);
10625     }
10626     else
10627         PL_exitlist     = (PerlExitListEntry*)NULL;
10628
10629     PL_my_cxt_size = proto_perl->Imy_cxt_size;
10630     if (PL_my_cxt_size) {
10631         Newx(PL_my_cxt_list, PL_my_cxt_size, void *);
10632         Copy(proto_perl->Imy_cxt_list, PL_my_cxt_list, PL_my_cxt_size, void *);
10633     }
10634     else
10635         PL_my_cxt_list  = (void**)NULL;
10636     PL_modglobal        = hv_dup_inc(proto_perl->Imodglobal, param);
10637     PL_custom_op_names  = hv_dup_inc(proto_perl->Icustom_op_names,param);
10638     PL_custom_op_descs  = hv_dup_inc(proto_perl->Icustom_op_descs,param);
10639
10640     PL_profiledata      = NULL;
10641     PL_rsfp             = fp_dup(proto_perl->Irsfp, '<', param);
10642     /* PL_rsfp_filters entries have fake IoDIRP() */
10643     PL_rsfp_filters     = av_dup_inc(proto_perl->Irsfp_filters, param);
10644
10645     PL_compcv                   = cv_dup(proto_perl->Icompcv, param);
10646
10647     PAD_CLONE_VARS(proto_perl, param);
10648
10649 #ifdef HAVE_INTERP_INTERN
10650     sys_intern_dup(&proto_perl->Isys_intern, &PL_sys_intern);
10651 #endif
10652
10653     /* more statics moved here */
10654     PL_generation       = proto_perl->Igeneration;
10655     PL_DBcv             = cv_dup(proto_perl->IDBcv, param);
10656
10657     PL_in_clean_objs    = proto_perl->Iin_clean_objs;
10658     PL_in_clean_all     = proto_perl->Iin_clean_all;
10659
10660     PL_uid              = proto_perl->Iuid;
10661     PL_euid             = proto_perl->Ieuid;
10662     PL_gid              = proto_perl->Igid;
10663     PL_egid             = proto_perl->Iegid;
10664     PL_nomemok          = proto_perl->Inomemok;
10665     PL_an               = proto_perl->Ian;
10666     PL_evalseq          = proto_perl->Ievalseq;
10667     PL_origenviron      = proto_perl->Iorigenviron;     /* XXX not quite right */
10668     PL_origalen         = proto_perl->Iorigalen;
10669 #ifdef PERL_USES_PL_PIDSTATUS
10670     PL_pidstatus        = newHV();                      /* XXX flag for cloning? */
10671 #endif
10672     PL_osname           = SAVEPV(proto_perl->Iosname);
10673     PL_sighandlerp      = proto_perl->Isighandlerp;
10674
10675     PL_runops           = proto_perl->Irunops;
10676
10677     Copy(proto_perl->Itokenbuf, PL_tokenbuf, 256, char);
10678
10679 #ifdef CSH
10680     PL_cshlen           = proto_perl->Icshlen;
10681     PL_cshname          = proto_perl->Icshname; /* XXX never deallocated */
10682 #endif
10683
10684     PL_lex_state        = proto_perl->Ilex_state;
10685     PL_lex_defer        = proto_perl->Ilex_defer;
10686     PL_lex_expect       = proto_perl->Ilex_expect;
10687     PL_lex_formbrack    = proto_perl->Ilex_formbrack;
10688     PL_lex_dojoin       = proto_perl->Ilex_dojoin;
10689     PL_lex_starts       = proto_perl->Ilex_starts;
10690     PL_lex_stuff        = sv_dup_inc(proto_perl->Ilex_stuff, param);
10691     PL_lex_repl         = sv_dup_inc(proto_perl->Ilex_repl, param);
10692     PL_lex_op           = proto_perl->Ilex_op;
10693     PL_lex_inpat        = proto_perl->Ilex_inpat;
10694     PL_lex_inwhat       = proto_perl->Ilex_inwhat;
10695     PL_lex_brackets     = proto_perl->Ilex_brackets;
10696     i = (PL_lex_brackets < 120 ? 120 : PL_lex_brackets);
10697     PL_lex_brackstack   = SAVEPVN(proto_perl->Ilex_brackstack,i);
10698     PL_lex_casemods     = proto_perl->Ilex_casemods;
10699     i = (PL_lex_casemods < 12 ? 12 : PL_lex_casemods);
10700     PL_lex_casestack    = SAVEPVN(proto_perl->Ilex_casestack,i);
10701
10702     Copy(proto_perl->Inextval, PL_nextval, 5, YYSTYPE);
10703     Copy(proto_perl->Inexttype, PL_nexttype, 5, I32);
10704     PL_nexttoke         = proto_perl->Inexttoke;
10705
10706     /* XXX This is probably masking the deeper issue of why
10707      * SvANY(proto_perl->Ilinestr) can be NULL at this point. For test case:
10708      * http://archive.develooper.com/perl5-porters%40perl.org/msg83298.html
10709      * (A little debugging with a watchpoint on it may help.)
10710      */
10711     if (SvANY(proto_perl->Ilinestr)) {
10712         PL_linestr              = sv_dup_inc(proto_perl->Ilinestr, param);
10713         i = proto_perl->Ibufptr - SvPVX_const(proto_perl->Ilinestr);
10714         PL_bufptr               = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
10715         i = proto_perl->Ioldbufptr - SvPVX_const(proto_perl->Ilinestr);
10716         PL_oldbufptr    = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
10717         i = proto_perl->Ioldoldbufptr - SvPVX_const(proto_perl->Ilinestr);
10718         PL_oldoldbufptr = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
10719         i = proto_perl->Ilinestart - SvPVX_const(proto_perl->Ilinestr);
10720         PL_linestart    = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
10721     }
10722     else {
10723         PL_linestr = newSV(79);
10724         sv_upgrade(PL_linestr,SVt_PVIV);
10725         sv_setpvn(PL_linestr,"",0);
10726         PL_bufptr = PL_oldbufptr = PL_oldoldbufptr = PL_linestart = SvPVX(PL_linestr);
10727     }
10728     PL_bufend           = SvPVX(PL_linestr) + SvCUR(PL_linestr);
10729     PL_pending_ident    = proto_perl->Ipending_ident;
10730     PL_sublex_info      = proto_perl->Isublex_info;     /* XXX not quite right */
10731
10732     PL_expect           = proto_perl->Iexpect;
10733
10734     PL_multi_start      = proto_perl->Imulti_start;
10735     PL_multi_end        = proto_perl->Imulti_end;
10736     PL_multi_open       = proto_perl->Imulti_open;
10737     PL_multi_close      = proto_perl->Imulti_close;
10738
10739     PL_error_count      = proto_perl->Ierror_count;
10740     PL_subline          = proto_perl->Isubline;
10741     PL_subname          = sv_dup_inc(proto_perl->Isubname, param);
10742
10743     /* XXX See comment on SvANY(proto_perl->Ilinestr) above */
10744     if (SvANY(proto_perl->Ilinestr)) {
10745         i = proto_perl->Ilast_uni - SvPVX_const(proto_perl->Ilinestr);
10746         PL_last_uni             = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
10747         i = proto_perl->Ilast_lop - SvPVX_const(proto_perl->Ilinestr);
10748         PL_last_lop             = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
10749         PL_last_lop_op  = proto_perl->Ilast_lop_op;
10750     }
10751     else {
10752         PL_last_uni     = SvPVX(PL_linestr);
10753         PL_last_lop     = SvPVX(PL_linestr);
10754         PL_last_lop_op  = 0;
10755     }
10756     PL_in_my            = proto_perl->Iin_my;
10757     PL_in_my_stash      = hv_dup(proto_perl->Iin_my_stash, param);
10758 #ifdef FCRYPT
10759     PL_cryptseen        = proto_perl->Icryptseen;
10760 #endif
10761
10762     PL_hints            = proto_perl->Ihints;
10763
10764     PL_amagic_generation        = proto_perl->Iamagic_generation;
10765
10766 #ifdef USE_LOCALE_COLLATE
10767     PL_collation_ix     = proto_perl->Icollation_ix;
10768     PL_collation_name   = SAVEPV(proto_perl->Icollation_name);
10769     PL_collation_standard       = proto_perl->Icollation_standard;
10770     PL_collxfrm_base    = proto_perl->Icollxfrm_base;
10771     PL_collxfrm_mult    = proto_perl->Icollxfrm_mult;
10772 #endif /* USE_LOCALE_COLLATE */
10773
10774 #ifdef USE_LOCALE_NUMERIC
10775     PL_numeric_name     = SAVEPV(proto_perl->Inumeric_name);
10776     PL_numeric_standard = proto_perl->Inumeric_standard;
10777     PL_numeric_local    = proto_perl->Inumeric_local;
10778     PL_numeric_radix_sv = sv_dup_inc(proto_perl->Inumeric_radix_sv, param);
10779 #endif /* !USE_LOCALE_NUMERIC */
10780
10781     /* utf8 character classes */
10782     PL_utf8_alnum       = sv_dup_inc(proto_perl->Iutf8_alnum, param);
10783     PL_utf8_alnumc      = sv_dup_inc(proto_perl->Iutf8_alnumc, param);
10784     PL_utf8_ascii       = sv_dup_inc(proto_perl->Iutf8_ascii, param);
10785     PL_utf8_alpha       = sv_dup_inc(proto_perl->Iutf8_alpha, param);
10786     PL_utf8_space       = sv_dup_inc(proto_perl->Iutf8_space, param);
10787     PL_utf8_cntrl       = sv_dup_inc(proto_perl->Iutf8_cntrl, param);
10788     PL_utf8_graph       = sv_dup_inc(proto_perl->Iutf8_graph, param);
10789     PL_utf8_digit       = sv_dup_inc(proto_perl->Iutf8_digit, param);
10790     PL_utf8_upper       = sv_dup_inc(proto_perl->Iutf8_upper, param);
10791     PL_utf8_lower       = sv_dup_inc(proto_perl->Iutf8_lower, param);
10792     PL_utf8_print       = sv_dup_inc(proto_perl->Iutf8_print, param);
10793     PL_utf8_punct       = sv_dup_inc(proto_perl->Iutf8_punct, param);
10794     PL_utf8_xdigit      = sv_dup_inc(proto_perl->Iutf8_xdigit, param);
10795     PL_utf8_mark        = sv_dup_inc(proto_perl->Iutf8_mark, param);
10796     PL_utf8_toupper     = sv_dup_inc(proto_perl->Iutf8_toupper, param);
10797     PL_utf8_totitle     = sv_dup_inc(proto_perl->Iutf8_totitle, param);
10798     PL_utf8_tolower     = sv_dup_inc(proto_perl->Iutf8_tolower, param);
10799     PL_utf8_tofold      = sv_dup_inc(proto_perl->Iutf8_tofold, param);
10800     PL_utf8_idstart     = sv_dup_inc(proto_perl->Iutf8_idstart, param);
10801     PL_utf8_idcont      = sv_dup_inc(proto_perl->Iutf8_idcont, param);
10802
10803     /* Did the locale setup indicate UTF-8? */
10804     PL_utf8locale       = proto_perl->Iutf8locale;
10805     /* Unicode features (see perlrun/-C) */
10806     PL_unicode          = proto_perl->Iunicode;
10807
10808     /* Pre-5.8 signals control */
10809     PL_signals          = proto_perl->Isignals;
10810
10811     /* times() ticks per second */
10812     PL_clocktick        = proto_perl->Iclocktick;
10813
10814     /* Recursion stopper for PerlIO_find_layer */
10815     PL_in_load_module   = proto_perl->Iin_load_module;
10816
10817     /* sort() routine */
10818     PL_sort_RealCmp     = proto_perl->Isort_RealCmp;
10819
10820     /* Not really needed/useful since the reenrant_retint is "volatile",
10821      * but do it for consistency's sake. */
10822     PL_reentrant_retint = proto_perl->Ireentrant_retint;
10823
10824     /* Hooks to shared SVs and locks. */
10825     PL_sharehook        = proto_perl->Isharehook;
10826     PL_lockhook         = proto_perl->Ilockhook;
10827     PL_unlockhook       = proto_perl->Iunlockhook;
10828     PL_threadhook       = proto_perl->Ithreadhook;
10829
10830     PL_runops_std       = proto_perl->Irunops_std;
10831     PL_runops_dbg       = proto_perl->Irunops_dbg;
10832
10833 #ifdef THREADS_HAVE_PIDS
10834     PL_ppid             = proto_perl->Ippid;
10835 #endif
10836
10837     /* swatch cache */
10838     PL_last_swash_hv    = NULL; /* reinits on demand */
10839     PL_last_swash_klen  = 0;
10840     PL_last_swash_key[0]= '\0';
10841     PL_last_swash_tmps  = (U8*)NULL;
10842     PL_last_swash_slen  = 0;
10843
10844     PL_glob_index       = proto_perl->Iglob_index;
10845     PL_srand_called     = proto_perl->Isrand_called;
10846     PL_uudmap['M']      = 0;            /* reinits on demand */
10847     PL_bitcount         = NULL; /* reinits on demand */
10848
10849     if (proto_perl->Ipsig_pend) {
10850         Newxz(PL_psig_pend, SIG_SIZE, int);
10851     }
10852     else {
10853         PL_psig_pend    = (int*)NULL;
10854     }
10855
10856     if (proto_perl->Ipsig_ptr) {
10857         Newxz(PL_psig_ptr,  SIG_SIZE, SV*);
10858         Newxz(PL_psig_name, SIG_SIZE, SV*);
10859         for (i = 1; i < SIG_SIZE; i++) {
10860             PL_psig_ptr[i]  = sv_dup_inc(proto_perl->Ipsig_ptr[i], param);
10861             PL_psig_name[i] = sv_dup_inc(proto_perl->Ipsig_name[i], param);
10862         }
10863     }
10864     else {
10865         PL_psig_ptr     = (SV**)NULL;
10866         PL_psig_name    = (SV**)NULL;
10867     }
10868
10869     /* thrdvar.h stuff */
10870
10871     if (flags & CLONEf_COPY_STACKS) {
10872         /* next allocation will be PL_tmps_stack[PL_tmps_ix+1] */
10873         PL_tmps_ix              = proto_perl->Ttmps_ix;
10874         PL_tmps_max             = proto_perl->Ttmps_max;
10875         PL_tmps_floor           = proto_perl->Ttmps_floor;
10876         Newxz(PL_tmps_stack, PL_tmps_max, SV*);
10877         i = 0;
10878         while (i <= PL_tmps_ix) {
10879             PL_tmps_stack[i]    = sv_dup_inc(proto_perl->Ttmps_stack[i], param);
10880             ++i;
10881         }
10882
10883         /* next PUSHMARK() sets *(PL_markstack_ptr+1) */
10884         i = proto_perl->Tmarkstack_max - proto_perl->Tmarkstack;
10885         Newxz(PL_markstack, i, I32);
10886         PL_markstack_max        = PL_markstack + (proto_perl->Tmarkstack_max
10887                                                   - proto_perl->Tmarkstack);
10888         PL_markstack_ptr        = PL_markstack + (proto_perl->Tmarkstack_ptr
10889                                                   - proto_perl->Tmarkstack);
10890         Copy(proto_perl->Tmarkstack, PL_markstack,
10891              PL_markstack_ptr - PL_markstack + 1, I32);
10892
10893         /* next push_scope()/ENTER sets PL_scopestack[PL_scopestack_ix]
10894          * NOTE: unlike the others! */
10895         PL_scopestack_ix        = proto_perl->Tscopestack_ix;
10896         PL_scopestack_max       = proto_perl->Tscopestack_max;
10897         Newxz(PL_scopestack, PL_scopestack_max, I32);
10898         Copy(proto_perl->Tscopestack, PL_scopestack, PL_scopestack_ix, I32);
10899
10900         /* NOTE: si_dup() looks at PL_markstack */
10901         PL_curstackinfo         = si_dup(proto_perl->Tcurstackinfo, param);
10902
10903         /* PL_curstack          = PL_curstackinfo->si_stack; */
10904         PL_curstack             = av_dup(proto_perl->Tcurstack, param);
10905         PL_mainstack            = av_dup(proto_perl->Tmainstack, param);
10906
10907         /* next PUSHs() etc. set *(PL_stack_sp+1) */
10908         PL_stack_base           = AvARRAY(PL_curstack);
10909         PL_stack_sp             = PL_stack_base + (proto_perl->Tstack_sp
10910                                                    - proto_perl->Tstack_base);
10911         PL_stack_max            = PL_stack_base + AvMAX(PL_curstack);
10912
10913         /* next SSPUSHFOO() sets PL_savestack[PL_savestack_ix]
10914          * NOTE: unlike the others! */
10915         PL_savestack_ix         = proto_perl->Tsavestack_ix;
10916         PL_savestack_max        = proto_perl->Tsavestack_max;
10917         /*Newxz(PL_savestack, PL_savestack_max, ANY);*/
10918         PL_savestack            = ss_dup(proto_perl, param);
10919     }
10920     else {
10921         init_stacks();
10922         ENTER;                  /* perl_destruct() wants to LEAVE; */
10923
10924         /* although we're not duplicating the tmps stack, we should still
10925          * add entries for any SVs on the tmps stack that got cloned by a
10926          * non-refcount means (eg a temp in @_); otherwise they will be
10927          * orphaned
10928          */
10929         for (i = 0; i<= proto_perl->Ttmps_ix; i++) {
10930             SV * const nsv = (SV*)ptr_table_fetch(PL_ptr_table,
10931                     proto_perl->Ttmps_stack[i]);
10932             if (nsv && !SvREFCNT(nsv)) {
10933                 EXTEND_MORTAL(1);
10934                 PL_tmps_stack[++PL_tmps_ix] = SvREFCNT_inc(nsv);
10935             }
10936         }
10937     }
10938
10939     PL_start_env        = proto_perl->Tstart_env;       /* XXXXXX */
10940     PL_top_env          = &PL_start_env;
10941
10942     PL_op               = proto_perl->Top;
10943
10944     PL_Sv               = NULL;
10945     PL_Xpv              = (XPV*)NULL;
10946     PL_na               = proto_perl->Tna;
10947
10948     PL_statbuf          = proto_perl->Tstatbuf;
10949     PL_statcache        = proto_perl->Tstatcache;
10950     PL_statgv           = gv_dup(proto_perl->Tstatgv, param);
10951     PL_statname         = sv_dup_inc(proto_perl->Tstatname, param);
10952 #ifdef HAS_TIMES
10953     PL_timesbuf         = proto_perl->Ttimesbuf;
10954 #endif
10955
10956     PL_tainted          = proto_perl->Ttainted;
10957     PL_curpm            = proto_perl->Tcurpm;   /* XXX No PMOP ref count */
10958     PL_rs               = sv_dup_inc(proto_perl->Trs, param);
10959     PL_last_in_gv       = gv_dup(proto_perl->Tlast_in_gv, param);
10960     PL_ofs_sv           = sv_dup_inc(proto_perl->Tofs_sv, param);
10961     PL_defoutgv         = gv_dup_inc(proto_perl->Tdefoutgv, param);
10962     PL_chopset          = proto_perl->Tchopset; /* XXX never deallocated */
10963     PL_toptarget        = sv_dup_inc(proto_perl->Ttoptarget, param);
10964     PL_bodytarget       = sv_dup_inc(proto_perl->Tbodytarget, param);
10965     PL_formtarget       = sv_dup(proto_perl->Tformtarget, param);
10966
10967     PL_restartop        = proto_perl->Trestartop;
10968     PL_in_eval          = proto_perl->Tin_eval;
10969     PL_delaymagic       = proto_perl->Tdelaymagic;
10970     PL_dirty            = proto_perl->Tdirty;
10971     PL_localizing       = proto_perl->Tlocalizing;
10972
10973     PL_errors           = sv_dup_inc(proto_perl->Terrors, param);
10974     PL_hv_fetch_ent_mh  = Nullhe;
10975     PL_modcount         = proto_perl->Tmodcount;
10976     PL_lastgotoprobe    = Nullop;
10977     PL_dumpindent       = proto_perl->Tdumpindent;
10978
10979     PL_sortcop          = (OP*)any_dup(proto_perl->Tsortcop, proto_perl);
10980     PL_sortstash        = hv_dup(proto_perl->Tsortstash, param);
10981     PL_firstgv          = gv_dup(proto_perl->Tfirstgv, param);
10982     PL_secondgv         = gv_dup(proto_perl->Tsecondgv, param);
10983     PL_efloatbuf        = NULL;         /* reinits on demand */
10984     PL_efloatsize       = 0;                    /* reinits on demand */
10985
10986     /* regex stuff */
10987
10988     PL_screamfirst      = NULL;
10989     PL_screamnext       = NULL;
10990     PL_maxscream        = -1;                   /* reinits on demand */
10991     PL_lastscream       = NULL;
10992
10993     PL_watchaddr        = NULL;
10994     PL_watchok          = NULL;
10995
10996     PL_regdummy         = proto_perl->Tregdummy;
10997     PL_regprecomp       = NULL;
10998     PL_regnpar          = 0;
10999     PL_regsize          = 0;
11000     PL_colorset         = 0;            /* reinits PL_colors[] */
11001     /*PL_colors[6]      = {0,0,0,0,0,0};*/
11002     PL_reginput         = NULL;
11003     PL_regbol           = NULL;
11004     PL_regeol           = NULL;
11005     PL_regstartp        = (I32*)NULL;
11006     PL_regendp          = (I32*)NULL;
11007     PL_reglastparen     = (U32*)NULL;
11008     PL_reglastcloseparen        = (U32*)NULL;
11009     PL_regtill          = NULL;
11010     PL_reg_start_tmp    = (char**)NULL;
11011     PL_reg_start_tmpl   = 0;
11012     PL_regdata          = (struct reg_data*)NULL;
11013     PL_bostr            = NULL;
11014     PL_reg_flags        = 0;
11015     PL_reg_eval_set     = 0;
11016     PL_regnarrate       = 0;
11017     PL_regprogram       = (regnode*)NULL;
11018     PL_regindent        = 0;
11019     PL_regcc            = (CURCUR*)NULL;
11020     PL_reg_call_cc      = (struct re_cc_state*)NULL;
11021     PL_reg_re           = (regexp*)NULL;
11022     PL_reg_ganch        = NULL;
11023     PL_reg_sv           = NULL;
11024     PL_reg_match_utf8   = FALSE;
11025     PL_reg_magic        = (MAGIC*)NULL;
11026     PL_reg_oldpos       = 0;
11027     PL_reg_oldcurpm     = (PMOP*)NULL;
11028     PL_reg_curpm        = (PMOP*)NULL;
11029     PL_reg_oldsaved     = NULL;
11030     PL_reg_oldsavedlen  = 0;
11031 #ifdef PERL_OLD_COPY_ON_WRITE
11032     PL_nrs              = NULL;
11033 #endif
11034     PL_reg_maxiter      = 0;
11035     PL_reg_leftiter     = 0;
11036     PL_reg_poscache     = NULL;
11037     PL_reg_poscache_size= 0;
11038
11039     /* RE engine - function pointers */
11040     PL_regcompp         = proto_perl->Tregcompp;
11041     PL_regexecp         = proto_perl->Tregexecp;
11042     PL_regint_start     = proto_perl->Tregint_start;
11043     PL_regint_string    = proto_perl->Tregint_string;
11044     PL_regfree          = proto_perl->Tregfree;
11045
11046     PL_reginterp_cnt    = 0;
11047     PL_reg_starttry     = 0;
11048
11049     /* Pluggable optimizer */
11050     PL_peepp            = proto_perl->Tpeepp;
11051
11052     PL_stashcache       = newHV();
11053
11054     if (!(flags & CLONEf_KEEP_PTR_TABLE)) {
11055         ptr_table_free(PL_ptr_table);
11056         PL_ptr_table = NULL;
11057     }
11058
11059     /* Call the ->CLONE method, if it exists, for each of the stashes
11060        identified by sv_dup() above.
11061     */
11062     while(av_len(param->stashes) != -1) {
11063         HV* const stash = (HV*) av_shift(param->stashes);
11064         GV* const cloner = gv_fetchmethod_autoload(stash, "CLONE", 0);
11065         if (cloner && GvCV(cloner)) {
11066             dSP;
11067             ENTER;
11068             SAVETMPS;
11069             PUSHMARK(SP);
11070             XPUSHs(sv_2mortal(newSVhek(HvNAME_HEK(stash))));
11071             PUTBACK;
11072             call_sv((SV*)GvCV(cloner), G_DISCARD);
11073             FREETMPS;
11074             LEAVE;
11075         }
11076     }
11077
11078     SvREFCNT_dec(param->stashes);
11079
11080     /* orphaned? eg threads->new inside BEGIN or use */
11081     if (PL_compcv && ! SvREFCNT(PL_compcv)) {
11082         (void)SvREFCNT_inc(PL_compcv);
11083         SAVEFREESV(PL_compcv);
11084     }
11085
11086     return my_perl;
11087 }
11088
11089 #endif /* USE_ITHREADS */
11090
11091 /*
11092 =head1 Unicode Support
11093
11094 =for apidoc sv_recode_to_utf8
11095
11096 The encoding is assumed to be an Encode object, on entry the PV
11097 of the sv is assumed to be octets in that encoding, and the sv
11098 will be converted into Unicode (and UTF-8).
11099
11100 If the sv already is UTF-8 (or if it is not POK), or if the encoding
11101 is not a reference, nothing is done to the sv.  If the encoding is not
11102 an C<Encode::XS> Encoding object, bad things will happen.
11103 (See F<lib/encoding.pm> and L<Encode>).
11104
11105 The PV of the sv is returned.
11106
11107 =cut */
11108
11109 char *
11110 Perl_sv_recode_to_utf8(pTHX_ SV *sv, SV *encoding)
11111 {
11112     dVAR;
11113     if (SvPOK(sv) && !SvUTF8(sv) && !IN_BYTES && SvROK(encoding)) {
11114         SV *uni;
11115         STRLEN len;
11116         const char *s;
11117         dSP;
11118         ENTER;
11119         SAVETMPS;
11120         save_re_context();
11121         PUSHMARK(sp);
11122         EXTEND(SP, 3);
11123         XPUSHs(encoding);
11124         XPUSHs(sv);
11125 /*
11126   NI-S 2002/07/09
11127   Passing sv_yes is wrong - it needs to be or'ed set of constants
11128   for Encode::XS, while UTf-8 decode (currently) assumes a true value means
11129   remove converted chars from source.
11130
11131   Both will default the value - let them.
11132
11133         XPUSHs(&PL_sv_yes);
11134 */
11135         PUTBACK;
11136         call_method("decode", G_SCALAR);
11137         SPAGAIN;
11138         uni = POPs;
11139         PUTBACK;
11140         s = SvPV_const(uni, len);
11141         if (s != SvPVX_const(sv)) {
11142             SvGROW(sv, len + 1);
11143             Move(s, SvPVX(sv), len + 1, char);
11144             SvCUR_set(sv, len);
11145         }
11146         FREETMPS;
11147         LEAVE;
11148         SvUTF8_on(sv);
11149         return SvPVX(sv);
11150     }
11151     return SvPOKp(sv) ? SvPVX(sv) : NULL;
11152 }
11153
11154 /*
11155 =for apidoc sv_cat_decode
11156
11157 The encoding is assumed to be an Encode object, the PV of the ssv is
11158 assumed to be octets in that encoding and decoding the input starts
11159 from the position which (PV + *offset) pointed to.  The dsv will be
11160 concatenated the decoded UTF-8 string from ssv.  Decoding will terminate
11161 when the string tstr appears in decoding output or the input ends on
11162 the PV of the ssv. The value which the offset points will be modified
11163 to the last input position on the ssv.
11164
11165 Returns TRUE if the terminator was found, else returns FALSE.
11166
11167 =cut */
11168
11169 bool
11170 Perl_sv_cat_decode(pTHX_ SV *dsv, SV *encoding,
11171                    SV *ssv, int *offset, char *tstr, int tlen)
11172 {
11173     dVAR;
11174     bool ret = FALSE;
11175     if (SvPOK(ssv) && SvPOK(dsv) && SvROK(encoding) && offset) {
11176         SV *offsv;
11177         dSP;
11178         ENTER;
11179         SAVETMPS;
11180         save_re_context();
11181         PUSHMARK(sp);
11182         EXTEND(SP, 6);
11183         XPUSHs(encoding);
11184         XPUSHs(dsv);
11185         XPUSHs(ssv);
11186         XPUSHs(offsv = sv_2mortal(newSViv(*offset)));
11187         XPUSHs(sv_2mortal(newSVpvn(tstr, tlen)));
11188         PUTBACK;
11189         call_method("cat_decode", G_SCALAR);
11190         SPAGAIN;
11191         ret = SvTRUE(TOPs);
11192         *offset = SvIV(offsv);
11193         PUTBACK;
11194         FREETMPS;
11195         LEAVE;
11196     }
11197     else
11198         Perl_croak(aTHX_ "Invalid argument to sv_cat_decode");
11199     return ret;
11200
11201 }
11202
11203 /* ---------------------------------------------------------------------
11204  *
11205  * support functions for report_uninit()
11206  */
11207
11208 /* the maxiumum size of array or hash where we will scan looking
11209  * for the undefined element that triggered the warning */
11210
11211 #define FUV_MAX_SEARCH_SIZE 1000
11212
11213 /* Look for an entry in the hash whose value has the same SV as val;
11214  * If so, return a mortal copy of the key. */
11215
11216 STATIC SV*
11217 S_find_hash_subscript(pTHX_ HV *hv, SV* val)
11218 {
11219     dVAR;
11220     register HE **array;
11221     I32 i;
11222
11223     if (!hv || SvMAGICAL(hv) || !HvARRAY(hv) ||
11224                         (HvTOTALKEYS(hv) > FUV_MAX_SEARCH_SIZE))
11225         return NULL;
11226
11227     array = HvARRAY(hv);
11228
11229     for (i=HvMAX(hv); i>0; i--) {
11230         register HE *entry;
11231         for (entry = array[i]; entry; entry = HeNEXT(entry)) {
11232             if (HeVAL(entry) != val)
11233                 continue;
11234             if (    HeVAL(entry) == &PL_sv_undef ||
11235                     HeVAL(entry) == &PL_sv_placeholder)
11236                 continue;
11237             if (!HeKEY(entry))
11238                 return NULL;
11239             if (HeKLEN(entry) == HEf_SVKEY)
11240                 return sv_mortalcopy(HeKEY_sv(entry));
11241             return sv_2mortal(newSVpvn(HeKEY(entry), HeKLEN(entry)));
11242         }
11243     }
11244     return NULL;
11245 }
11246
11247 /* Look for an entry in the array whose value has the same SV as val;
11248  * If so, return the index, otherwise return -1. */
11249
11250 STATIC I32
11251 S_find_array_subscript(pTHX_ AV *av, SV* val)
11252 {
11253     dVAR;
11254     SV** svp;
11255     I32 i;
11256     if (!av || SvMAGICAL(av) || !AvARRAY(av) ||
11257                         (AvFILLp(av) > FUV_MAX_SEARCH_SIZE))
11258         return -1;
11259
11260     svp = AvARRAY(av);
11261     for (i=AvFILLp(av); i>=0; i--) {
11262         if (svp[i] == val && svp[i] != &PL_sv_undef)
11263             return i;
11264     }
11265     return -1;
11266 }
11267
11268 /* S_varname(): return the name of a variable, optionally with a subscript.
11269  * If gv is non-zero, use the name of that global, along with gvtype (one
11270  * of "$", "@", "%"); otherwise use the name of the lexical at pad offset
11271  * targ.  Depending on the value of the subscript_type flag, return:
11272  */
11273
11274 #define FUV_SUBSCRIPT_NONE      1       /* "@foo"          */
11275 #define FUV_SUBSCRIPT_ARRAY     2       /* "$foo[aindex]"  */
11276 #define FUV_SUBSCRIPT_HASH      3       /* "$foo{keyname}" */
11277 #define FUV_SUBSCRIPT_WITHIN    4       /* "within @foo"   */
11278
11279 STATIC SV*
11280 S_varname(pTHX_ GV *gv, const char gvtype, PADOFFSET targ,
11281         SV* keyname, I32 aindex, int subscript_type)
11282 {
11283
11284     SV * const name = sv_newmortal();
11285     if (gv) {
11286         char buffer[2];
11287         buffer[0] = gvtype;
11288         buffer[1] = 0;
11289
11290         /* as gv_fullname4(), but add literal '^' for $^FOO names  */
11291
11292         gv_fullname4(name, gv, buffer, 0);
11293
11294         if ((unsigned int)SvPVX(name)[1] <= 26) {
11295             buffer[0] = '^';
11296             buffer[1] = SvPVX(name)[1] + 'A' - 1;
11297
11298             /* Swap the 1 unprintable control character for the 2 byte pretty
11299                version - ie substr($name, 1, 1) = $buffer; */
11300             sv_insert(name, 1, 1, buffer, 2);
11301         }
11302     }
11303     else {
11304         U32 unused;
11305         CV * const cv = find_runcv(&unused);
11306         SV *sv;
11307         AV *av;
11308
11309         if (!cv || !CvPADLIST(cv))
11310             return NULL;
11311         av = (AV*)(*av_fetch(CvPADLIST(cv), 0, FALSE));
11312         sv = *av_fetch(av, targ, FALSE);
11313         /* SvLEN in a pad name is not to be trusted */
11314         sv_setpv(name, SvPV_nolen_const(sv));
11315     }
11316
11317     if (subscript_type == FUV_SUBSCRIPT_HASH) {
11318         SV * const sv = newSV(0);
11319         *SvPVX(name) = '$';
11320         Perl_sv_catpvf(aTHX_ name, "{%s}",
11321             pv_display(sv,SvPVX_const(keyname), SvCUR(keyname), 0, 32));
11322         SvREFCNT_dec(sv);
11323     }
11324     else if (subscript_type == FUV_SUBSCRIPT_ARRAY) {
11325         *SvPVX(name) = '$';
11326         Perl_sv_catpvf(aTHX_ name, "[%"IVdf"]", (IV)aindex);
11327     }
11328     else if (subscript_type == FUV_SUBSCRIPT_WITHIN)
11329         Perl_sv_insert(aTHX_ name, 0, 0,  STR_WITH_LEN("within "));
11330
11331     return name;
11332 }
11333
11334
11335 /*
11336 =for apidoc find_uninit_var
11337
11338 Find the name of the undefined variable (if any) that caused the operator o
11339 to issue a "Use of uninitialized value" warning.
11340 If match is true, only return a name if it's value matches uninit_sv.
11341 So roughly speaking, if a unary operator (such as OP_COS) generates a
11342 warning, then following the direct child of the op may yield an
11343 OP_PADSV or OP_GV that gives the name of the undefined variable. On the
11344 other hand, with OP_ADD there are two branches to follow, so we only print
11345 the variable name if we get an exact match.
11346
11347 The name is returned as a mortal SV.
11348
11349 Assumes that PL_op is the op that originally triggered the error, and that
11350 PL_comppad/PL_curpad points to the currently executing pad.
11351
11352 =cut
11353 */
11354
11355 STATIC SV *
11356 S_find_uninit_var(pTHX_ OP* obase, SV* uninit_sv, bool match)
11357 {
11358     dVAR;
11359     SV *sv;
11360     AV *av;
11361     GV *gv;
11362     OP *o, *o2, *kid;
11363
11364     if (!obase || (match && (!uninit_sv || uninit_sv == &PL_sv_undef ||
11365                             uninit_sv == &PL_sv_placeholder)))
11366         return NULL;
11367
11368     switch (obase->op_type) {
11369
11370     case OP_RV2AV:
11371     case OP_RV2HV:
11372     case OP_PADAV:
11373     case OP_PADHV:
11374       {
11375         const bool pad  = (obase->op_type == OP_PADAV || obase->op_type == OP_PADHV);
11376         const bool hash = (obase->op_type == OP_PADHV || obase->op_type == OP_RV2HV);
11377         I32 index = 0;
11378         SV *keysv = NULL;
11379         int subscript_type = FUV_SUBSCRIPT_WITHIN;
11380
11381         if (pad) { /* @lex, %lex */
11382             sv = PAD_SVl(obase->op_targ);
11383             gv = NULL;
11384         }
11385         else {
11386             if (cUNOPx(obase)->op_first->op_type == OP_GV) {
11387             /* @global, %global */
11388                 gv = cGVOPx_gv(cUNOPx(obase)->op_first);
11389                 if (!gv)
11390                     break;
11391                 sv = hash ? (SV*)GvHV(gv): (SV*)GvAV(gv);
11392             }
11393             else /* @{expr}, %{expr} */
11394                 return find_uninit_var(cUNOPx(obase)->op_first,
11395                                                     uninit_sv, match);
11396         }
11397
11398         /* attempt to find a match within the aggregate */
11399         if (hash) {
11400             keysv = S_find_hash_subscript(aTHX_ (HV*)sv, uninit_sv);
11401             if (keysv)
11402                 subscript_type = FUV_SUBSCRIPT_HASH;
11403         }
11404         else {
11405             index = S_find_array_subscript(aTHX_ (AV*)sv, uninit_sv);
11406             if (index >= 0)
11407                 subscript_type = FUV_SUBSCRIPT_ARRAY;
11408         }
11409
11410         if (match && subscript_type == FUV_SUBSCRIPT_WITHIN)
11411             break;
11412
11413         return varname(gv, hash ? '%' : '@', obase->op_targ,
11414                                     keysv, index, subscript_type);
11415       }
11416
11417     case OP_PADSV:
11418         if (match && PAD_SVl(obase->op_targ) != uninit_sv)
11419             break;
11420         return varname(NULL, '$', obase->op_targ,
11421                                     NULL, 0, FUV_SUBSCRIPT_NONE);
11422
11423     case OP_GVSV:
11424         gv = cGVOPx_gv(obase);
11425         if (!gv || (match && GvSV(gv) != uninit_sv))
11426             break;
11427         return varname(gv, '$', 0, NULL, 0, FUV_SUBSCRIPT_NONE);
11428
11429     case OP_AELEMFAST:
11430         if (obase->op_flags & OPf_SPECIAL) { /* lexical array */
11431             if (match) {
11432                 SV **svp;
11433                 av = (AV*)PAD_SV(obase->op_targ);
11434                 if (!av || SvRMAGICAL(av))
11435                     break;
11436                 svp = av_fetch(av, (I32)obase->op_private, FALSE);
11437                 if (!svp || *svp != uninit_sv)
11438                     break;
11439             }
11440             return varname(NULL, '$', obase->op_targ,
11441                     NULL, (I32)obase->op_private, FUV_SUBSCRIPT_ARRAY);
11442         }
11443         else {
11444             gv = cGVOPx_gv(obase);
11445             if (!gv)
11446                 break;
11447             if (match) {
11448                 SV **svp;
11449                 av = GvAV(gv);
11450                 if (!av || SvRMAGICAL(av))
11451                     break;
11452                 svp = av_fetch(av, (I32)obase->op_private, FALSE);
11453                 if (!svp || *svp != uninit_sv)
11454                     break;
11455             }
11456             return varname(gv, '$', 0,
11457                     NULL, (I32)obase->op_private, FUV_SUBSCRIPT_ARRAY);
11458         }
11459         break;
11460
11461     case OP_EXISTS:
11462         o = cUNOPx(obase)->op_first;
11463         if (!o || o->op_type != OP_NULL ||
11464                 ! (o->op_targ == OP_AELEM || o->op_targ == OP_HELEM))
11465             break;
11466         return find_uninit_var(cBINOPo->op_last, uninit_sv, match);
11467
11468     case OP_AELEM:
11469     case OP_HELEM:
11470         if (PL_op == obase)
11471             /* $a[uninit_expr] or $h{uninit_expr} */
11472             return find_uninit_var(cBINOPx(obase)->op_last, uninit_sv, match);
11473
11474         gv = NULL;
11475         o = cBINOPx(obase)->op_first;
11476         kid = cBINOPx(obase)->op_last;
11477
11478         /* get the av or hv, and optionally the gv */
11479         sv = NULL;
11480         if  (o->op_type == OP_PADAV || o->op_type == OP_PADHV) {
11481             sv = PAD_SV(o->op_targ);
11482         }
11483         else if ((o->op_type == OP_RV2AV || o->op_type == OP_RV2HV)
11484                 && cUNOPo->op_first->op_type == OP_GV)
11485         {
11486             gv = cGVOPx_gv(cUNOPo->op_first);
11487             if (!gv)
11488                 break;
11489             sv = o->op_type == OP_RV2HV ? (SV*)GvHV(gv) : (SV*)GvAV(gv);
11490         }
11491         if (!sv)
11492             break;
11493
11494         if (kid && kid->op_type == OP_CONST && SvOK(cSVOPx_sv(kid))) {
11495             /* index is constant */
11496             if (match) {
11497                 if (SvMAGICAL(sv))
11498                     break;
11499                 if (obase->op_type == OP_HELEM) {
11500                     HE* he = hv_fetch_ent((HV*)sv, cSVOPx_sv(kid), 0, 0);
11501                     if (!he || HeVAL(he) != uninit_sv)
11502                         break;
11503                 }
11504                 else {
11505                     SV * const * const svp = av_fetch((AV*)sv, SvIV(cSVOPx_sv(kid)), FALSE);
11506                     if (!svp || *svp != uninit_sv)
11507                         break;
11508                 }
11509             }
11510             if (obase->op_type == OP_HELEM)
11511                 return varname(gv, '%', o->op_targ,
11512                             cSVOPx_sv(kid), 0, FUV_SUBSCRIPT_HASH);
11513             else
11514                 return varname(gv, '@', o->op_targ, NULL,
11515                             SvIV(cSVOPx_sv(kid)), FUV_SUBSCRIPT_ARRAY);
11516         }
11517         else  {
11518             /* index is an expression;
11519              * attempt to find a match within the aggregate */
11520             if (obase->op_type == OP_HELEM) {
11521                 SV * const keysv = S_find_hash_subscript(aTHX_ (HV*)sv, uninit_sv);
11522                 if (keysv)
11523                     return varname(gv, '%', o->op_targ,
11524                                                 keysv, 0, FUV_SUBSCRIPT_HASH);
11525             }
11526             else {
11527                 const I32 index = S_find_array_subscript(aTHX_ (AV*)sv, uninit_sv);
11528                 if (index >= 0)
11529                     return varname(gv, '@', o->op_targ,
11530                                         NULL, index, FUV_SUBSCRIPT_ARRAY);
11531             }
11532             if (match)
11533                 break;
11534             return varname(gv,
11535                 (o->op_type == OP_PADAV || o->op_type == OP_RV2AV)
11536                 ? '@' : '%',
11537                 o->op_targ, NULL, 0, FUV_SUBSCRIPT_WITHIN);
11538         }
11539
11540         break;
11541
11542     case OP_AASSIGN:
11543         /* only examine RHS */
11544         return find_uninit_var(cBINOPx(obase)->op_first, uninit_sv, match);
11545
11546     case OP_OPEN:
11547         o = cUNOPx(obase)->op_first;
11548         if (o->op_type == OP_PUSHMARK)
11549             o = o->op_sibling;
11550
11551         if (!o->op_sibling) {
11552             /* one-arg version of open is highly magical */
11553
11554             if (o->op_type == OP_GV) { /* open FOO; */
11555                 gv = cGVOPx_gv(o);
11556                 if (match && GvSV(gv) != uninit_sv)
11557                     break;
11558                 return varname(gv, '$', 0,
11559                             NULL, 0, FUV_SUBSCRIPT_NONE);
11560             }
11561             /* other possibilities not handled are:
11562              * open $x; or open my $x;  should return '${*$x}'
11563              * open expr;               should return '$'.expr ideally
11564              */
11565              break;
11566         }
11567         goto do_op;
11568
11569     /* ops where $_ may be an implicit arg */
11570     case OP_TRANS:
11571     case OP_SUBST:
11572     case OP_MATCH:
11573         if ( !(obase->op_flags & OPf_STACKED)) {
11574             if (uninit_sv == ((obase->op_private & OPpTARGET_MY)
11575                                  ? PAD_SVl(obase->op_targ)
11576                                  : DEFSV))
11577             {
11578                 sv = sv_newmortal();
11579                 sv_setpvn(sv, "$_", 2);
11580                 return sv;
11581             }
11582         }
11583         goto do_op;
11584
11585     case OP_PRTF:
11586     case OP_PRINT:
11587         /* skip filehandle as it can't produce 'undef' warning  */
11588         o = cUNOPx(obase)->op_first;
11589         if ((obase->op_flags & OPf_STACKED) && o->op_type == OP_PUSHMARK)
11590             o = o->op_sibling->op_sibling;
11591         goto do_op2;
11592
11593
11594     case OP_RV2SV:
11595     case OP_CUSTOM:
11596     case OP_ENTERSUB:
11597         match = 1; /* XS or custom code could trigger random warnings */
11598         goto do_op;
11599
11600     case OP_SCHOMP:
11601     case OP_CHOMP:
11602         if (SvROK(PL_rs) && uninit_sv == SvRV(PL_rs))
11603             return sv_2mortal(newSVpvs("${$/}"));
11604         /* FALL THROUGH */
11605
11606     default:
11607     do_op:
11608         if (!(obase->op_flags & OPf_KIDS))
11609             break;
11610         o = cUNOPx(obase)->op_first;
11611         
11612     do_op2:
11613         if (!o)
11614             break;
11615
11616         /* if all except one arg are constant, or have no side-effects,
11617          * or are optimized away, then it's unambiguous */
11618         o2 = Nullop;
11619         for (kid=o; kid; kid = kid->op_sibling) {
11620             if (kid &&
11621                 (    (kid->op_type == OP_CONST && SvOK(cSVOPx_sv(kid)))
11622                   || (kid->op_type == OP_NULL  && ! (kid->op_flags & OPf_KIDS))
11623                   || (kid->op_type == OP_PUSHMARK)
11624                 )
11625             )
11626                 continue;
11627             if (o2) { /* more than one found */
11628                 o2 = Nullop;
11629                 break;
11630             }
11631             o2 = kid;
11632         }
11633         if (o2)
11634             return find_uninit_var(o2, uninit_sv, match);
11635
11636         /* scan all args */
11637         while (o) {
11638             sv = find_uninit_var(o, uninit_sv, 1);
11639             if (sv)
11640                 return sv;
11641             o = o->op_sibling;
11642         }
11643         break;
11644     }
11645     return NULL;
11646 }
11647
11648
11649 /*
11650 =for apidoc report_uninit
11651
11652 Print appropriate "Use of uninitialized variable" warning
11653
11654 =cut
11655 */
11656
11657 void
11658 Perl_report_uninit(pTHX_ SV* uninit_sv)
11659 {
11660     dVAR;
11661     if (PL_op) {
11662         SV* varname = NULL;
11663         if (uninit_sv) {
11664             varname = find_uninit_var(PL_op, uninit_sv,0);
11665             if (varname)
11666                 sv_insert(varname, 0, 0, " ", 1);
11667         }
11668         Perl_warner(aTHX_ packWARN(WARN_UNINITIALIZED), PL_warn_uninit,
11669                 varname ? SvPV_nolen_const(varname) : "",
11670                 " in ", OP_DESC(PL_op));
11671     }
11672     else
11673         Perl_warner(aTHX_ packWARN(WARN_UNINITIALIZED), PL_warn_uninit,
11674                     "", "", "");
11675 }
11676
11677 /*
11678  * Local variables:
11679  * c-indentation-style: bsd
11680  * c-basic-offset: 4
11681  * indent-tabs-mode: t
11682  * End:
11683  *
11684  * ex: set ts=8 sts=4 sw=4 noet:
11685  */