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