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