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