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