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