Update to Getopt::Long 2.24_02, from Johan Vromans.
[p5sagit/p5-mst-13.2.git] / sv.c
1 /*    sv.c
2  *
3  *    Copyright (c) 1991-2001, Larry Wall
4  *
5  *    You may distribute under the terms of either the GNU General Public
6  *    License or the Artistic License, as specified in the README file.
7  *
8  */
9
10 /*
11  * "I wonder what the Entish is for 'yes' and 'no'," he thought.
12  */
13
14 #include "EXTERN.h"
15 #define PERL_IN_SV_C
16 #include "perl.h"
17
18 #define FCALL *f
19 #define SV_CHECK_THINKFIRST(sv) if (SvTHINKFIRST(sv)) sv_force_normal(sv)
20
21 static void do_report_used(pTHXo_ SV *sv);
22 static void do_clean_objs(pTHXo_ SV *sv);
23 #ifndef DISABLE_DESTRUCTOR_KLUDGE
24 static void do_clean_named_objs(pTHXo_ SV *sv);
25 #endif
26 static void do_clean_all(pTHXo_ SV *sv);
27
28 /*
29  * "A time to plant, and a time to uproot what was planted..."
30  */
31
32 #define plant_SV(p) \
33     STMT_START {                                        \
34         SvANY(p) = (void *)PL_sv_root;                  \
35         SvFLAGS(p) = SVTYPEMASK;                        \
36         PL_sv_root = (p);                               \
37         --PL_sv_count;                                  \
38     } STMT_END
39
40 /* sv_mutex must be held while calling uproot_SV() */
41 #define uproot_SV(p) \
42     STMT_START {                                        \
43         (p) = PL_sv_root;                               \
44         PL_sv_root = (SV*)SvANY(p);                     \
45         ++PL_sv_count;                                  \
46     } STMT_END
47
48 #define new_SV(p) \
49     STMT_START {                                        \
50         LOCK_SV_MUTEX;                                  \
51         if (PL_sv_root)                                 \
52             uproot_SV(p);                               \
53         else                                            \
54             (p) = more_sv();                            \
55         UNLOCK_SV_MUTEX;                                \
56         SvANY(p) = 0;                                   \
57         SvREFCNT(p) = 1;                                \
58         SvFLAGS(p) = 0;                                 \
59     } STMT_END
60
61 #ifdef DEBUGGING
62
63 #define del_SV(p) \
64     STMT_START {                                        \
65         LOCK_SV_MUTEX;                                  \
66         if (PL_debug & 32768)                           \
67             del_sv(p);                                  \
68         else                                            \
69             plant_SV(p);                                \
70         UNLOCK_SV_MUTEX;                                \
71     } STMT_END
72
73 STATIC void
74 S_del_sv(pTHX_ SV *p)
75 {
76     if (PL_debug & 32768) {
77         SV* sva;
78         SV* sv;
79         SV* svend;
80         int ok = 0;
81         for (sva = PL_sv_arenaroot; sva; sva = (SV *) SvANY(sva)) {
82             sv = sva + 1;
83             svend = &sva[SvREFCNT(sva)];
84             if (p >= sv && p < svend)
85                 ok = 1;
86         }
87         if (!ok) {
88             if (ckWARN_d(WARN_INTERNAL))        
89                 Perl_warner(aTHX_ WARN_INTERNAL,
90                             "Attempt to free non-arena SV: 0x%"UVxf,
91                             PTR2UV(p));
92             return;
93         }
94     }
95     plant_SV(p);
96 }
97
98 #else /* ! DEBUGGING */
99
100 #define del_SV(p)   plant_SV(p)
101
102 #endif /* DEBUGGING */
103
104 void
105 Perl_sv_add_arena(pTHX_ char *ptr, U32 size, U32 flags)
106 {
107     SV* sva = (SV*)ptr;
108     register SV* sv;
109     register SV* svend;
110     Zero(ptr, size, char);
111
112     /* The first SV in an arena isn't an SV. */
113     SvANY(sva) = (void *) PL_sv_arenaroot;              /* ptr to next arena */
114     SvREFCNT(sva) = size / sizeof(SV);          /* number of SV slots */
115     SvFLAGS(sva) = flags;                       /* FAKE if not to be freed */
116
117     PL_sv_arenaroot = sva;
118     PL_sv_root = sva + 1;
119
120     svend = &sva[SvREFCNT(sva) - 1];
121     sv = sva + 1;
122     while (sv < svend) {
123         SvANY(sv) = (void *)(SV*)(sv + 1);
124         SvFLAGS(sv) = SVTYPEMASK;
125         sv++;
126     }
127     SvANY(sv) = 0;
128     SvFLAGS(sv) = SVTYPEMASK;
129 }
130
131 /* sv_mutex must be held while calling more_sv() */
132 STATIC SV*
133 S_more_sv(pTHX)
134 {
135     register SV* sv;
136
137     if (PL_nice_chunk) {
138         sv_add_arena(PL_nice_chunk, PL_nice_chunk_size, 0);
139         PL_nice_chunk = Nullch;
140     }
141     else {
142         char *chunk;                /* must use New here to match call to */
143         New(704,chunk,1008,char);   /* Safefree() in sv_free_arenas()     */
144         sv_add_arena(chunk, 1008, 0);
145     }
146     uproot_SV(sv);
147     return sv;
148 }
149
150 STATIC void
151 S_visit(pTHX_ SVFUNC_t f)
152 {
153     SV* sva;
154     SV* sv;
155     register SV* svend;
156
157     for (sva = PL_sv_arenaroot; sva; sva = (SV*)SvANY(sva)) {
158         svend = &sva[SvREFCNT(sva)];
159         for (sv = sva + 1; sv < svend; ++sv) {
160             if (SvTYPE(sv) != SVTYPEMASK)
161                 (FCALL)(aTHXo_ sv);
162         }
163     }
164 }
165
166 void
167 Perl_sv_report_used(pTHX)
168 {
169     visit(do_report_used);
170 }
171
172 void
173 Perl_sv_clean_objs(pTHX)
174 {
175     PL_in_clean_objs = TRUE;
176     visit(do_clean_objs);
177 #ifndef DISABLE_DESTRUCTOR_KLUDGE
178     /* some barnacles may yet remain, clinging to typeglobs */
179     visit(do_clean_named_objs);
180 #endif
181     PL_in_clean_objs = FALSE;
182 }
183
184 void
185 Perl_sv_clean_all(pTHX)
186 {
187     PL_in_clean_all = TRUE;
188     visit(do_clean_all);
189     PL_in_clean_all = FALSE;
190 }
191
192 void
193 Perl_sv_free_arenas(pTHX)
194 {
195     SV* sva;
196     SV* svanext;
197     XPV *arena, *arenanext;
198
199     /* Free arenas here, but be careful about fake ones.  (We assume
200        contiguity of the fake ones with the corresponding real ones.) */
201
202     for (sva = PL_sv_arenaroot; sva; sva = svanext) {
203         svanext = (SV*) SvANY(sva);
204         while (svanext && SvFAKE(svanext))
205             svanext = (SV*) SvANY(svanext);
206
207         if (!SvFAKE(sva))
208             Safefree((void *)sva);
209     }
210
211     for (arena = PL_xiv_arenaroot; arena; arena = arenanext) {
212         arenanext = (XPV*)arena->xpv_pv;
213         Safefree(arena);
214     }
215     PL_xiv_arenaroot = 0;
216
217     for (arena = PL_xnv_arenaroot; arena; arena = arenanext) {
218         arenanext = (XPV*)arena->xpv_pv;
219         Safefree(arena);
220     }
221     PL_xnv_arenaroot = 0;
222
223     for (arena = PL_xrv_arenaroot; arena; arena = arenanext) {
224         arenanext = (XPV*)arena->xpv_pv;
225         Safefree(arena);
226     }
227     PL_xrv_arenaroot = 0;
228
229     for (arena = PL_xpv_arenaroot; arena; arena = arenanext) {
230         arenanext = (XPV*)arena->xpv_pv;
231         Safefree(arena);
232     }
233     PL_xpv_arenaroot = 0;
234
235     for (arena = (XPV*)PL_xpviv_arenaroot; arena; arena = arenanext) {
236         arenanext = (XPV*)arena->xpv_pv;
237         Safefree(arena);
238     }
239     PL_xpviv_arenaroot = 0;
240
241     for (arena = (XPV*)PL_xpvnv_arenaroot; arena; arena = arenanext) {
242         arenanext = (XPV*)arena->xpv_pv;
243         Safefree(arena);
244     }
245     PL_xpvnv_arenaroot = 0;
246
247     for (arena = (XPV*)PL_xpvcv_arenaroot; arena; arena = arenanext) {
248         arenanext = (XPV*)arena->xpv_pv;
249         Safefree(arena);
250     }
251     PL_xpvcv_arenaroot = 0;
252
253     for (arena = (XPV*)PL_xpvav_arenaroot; arena; arena = arenanext) {
254         arenanext = (XPV*)arena->xpv_pv;
255         Safefree(arena);
256     }
257     PL_xpvav_arenaroot = 0;
258
259     for (arena = (XPV*)PL_xpvhv_arenaroot; arena; arena = arenanext) {
260         arenanext = (XPV*)arena->xpv_pv;
261         Safefree(arena);
262     }
263     PL_xpvhv_arenaroot = 0;
264
265     for (arena = (XPV*)PL_xpvmg_arenaroot; arena; arena = arenanext) {
266         arenanext = (XPV*)arena->xpv_pv;
267         Safefree(arena);
268     }
269     PL_xpvmg_arenaroot = 0;
270
271     for (arena = (XPV*)PL_xpvlv_arenaroot; arena; arena = arenanext) {
272         arenanext = (XPV*)arena->xpv_pv;
273         Safefree(arena);
274     }
275     PL_xpvlv_arenaroot = 0;
276
277     for (arena = (XPV*)PL_xpvbm_arenaroot; arena; arena = arenanext) {
278         arenanext = (XPV*)arena->xpv_pv;
279         Safefree(arena);
280     }
281     PL_xpvbm_arenaroot = 0;
282
283     for (arena = (XPV*)PL_he_arenaroot; arena; arena = arenanext) {
284         arenanext = (XPV*)arena->xpv_pv;
285         Safefree(arena);
286     }
287     PL_he_arenaroot = 0;
288
289     if (PL_nice_chunk)
290         Safefree(PL_nice_chunk);
291     PL_nice_chunk = Nullch;
292     PL_nice_chunk_size = 0;
293     PL_sv_arenaroot = 0;
294     PL_sv_root = 0;
295 }
296
297 void
298 Perl_report_uninit(pTHX)
299 {
300     if (PL_op)
301         Perl_warner(aTHX_ WARN_UNINITIALIZED, PL_warn_uninit,
302                     " in ", PL_op_desc[PL_op->op_type]);
303     else
304         Perl_warner(aTHX_ WARN_UNINITIALIZED, PL_warn_uninit, "", "");
305 }
306
307 STATIC XPVIV*
308 S_new_xiv(pTHX)
309 {
310     IV* xiv;
311     LOCK_SV_MUTEX;
312     if (!PL_xiv_root)
313         more_xiv();
314     xiv = PL_xiv_root;
315     /*
316      * See comment in more_xiv() -- RAM.
317      */
318     PL_xiv_root = *(IV**)xiv;
319     UNLOCK_SV_MUTEX;
320     return (XPVIV*)((char*)xiv - STRUCT_OFFSET(XPVIV, xiv_iv));
321 }
322
323 STATIC void
324 S_del_xiv(pTHX_ XPVIV *p)
325 {
326     IV* xiv = (IV*)((char*)(p) + STRUCT_OFFSET(XPVIV, xiv_iv));
327     LOCK_SV_MUTEX;
328     *(IV**)xiv = PL_xiv_root;
329     PL_xiv_root = xiv;
330     UNLOCK_SV_MUTEX;
331 }
332
333 STATIC void
334 S_more_xiv(pTHX)
335 {
336     register IV* xiv;
337     register IV* xivend;
338     XPV* ptr;
339     New(705, ptr, 1008/sizeof(XPV), XPV);
340     ptr->xpv_pv = (char*)PL_xiv_arenaroot;              /* linked list of xiv arenas */
341     PL_xiv_arenaroot = ptr;                     /* to keep Purify happy */
342
343     xiv = (IV*) ptr;
344     xivend = &xiv[1008 / sizeof(IV) - 1];
345     xiv += (sizeof(XPV) - 1) / sizeof(IV) + 1;   /* fudge by size of XPV */
346     PL_xiv_root = xiv;
347     while (xiv < xivend) {
348         *(IV**)xiv = (IV *)(xiv + 1);
349         xiv++;
350     }
351     *(IV**)xiv = 0;
352 }
353
354 STATIC XPVNV*
355 S_new_xnv(pTHX)
356 {
357     NV* xnv;
358     LOCK_SV_MUTEX;
359     if (!PL_xnv_root)
360         more_xnv();
361     xnv = PL_xnv_root;
362     PL_xnv_root = *(NV**)xnv;
363     UNLOCK_SV_MUTEX;
364     return (XPVNV*)((char*)xnv - STRUCT_OFFSET(XPVNV, xnv_nv));
365 }
366
367 STATIC void
368 S_del_xnv(pTHX_ XPVNV *p)
369 {
370     NV* xnv = (NV*)((char*)(p) + STRUCT_OFFSET(XPVNV, xnv_nv));
371     LOCK_SV_MUTEX;
372     *(NV**)xnv = PL_xnv_root;
373     PL_xnv_root = xnv;
374     UNLOCK_SV_MUTEX;
375 }
376
377 STATIC void
378 S_more_xnv(pTHX)
379 {
380     register NV* xnv;
381     register NV* xnvend;
382     XPV *ptr;
383     New(711, ptr, 1008/sizeof(XPV), XPV);
384     ptr->xpv_pv = (char*)PL_xnv_arenaroot;
385     PL_xnv_arenaroot = ptr;
386
387     xnv = (NV*) ptr;
388     xnvend = &xnv[1008 / sizeof(NV) - 1];
389     xnv += (sizeof(XPVIV) - 1) / sizeof(NV) + 1; /* fudge by sizeof XPVIV */
390     PL_xnv_root = xnv;
391     while (xnv < xnvend) {
392         *(NV**)xnv = (NV*)(xnv + 1);
393         xnv++;
394     }
395     *(NV**)xnv = 0;
396 }
397
398 STATIC XRV*
399 S_new_xrv(pTHX)
400 {
401     XRV* xrv;
402     LOCK_SV_MUTEX;
403     if (!PL_xrv_root)
404         more_xrv();
405     xrv = PL_xrv_root;
406     PL_xrv_root = (XRV*)xrv->xrv_rv;
407     UNLOCK_SV_MUTEX;
408     return xrv;
409 }
410
411 STATIC void
412 S_del_xrv(pTHX_ XRV *p)
413 {
414     LOCK_SV_MUTEX;
415     p->xrv_rv = (SV*)PL_xrv_root;
416     PL_xrv_root = p;
417     UNLOCK_SV_MUTEX;
418 }
419
420 STATIC void
421 S_more_xrv(pTHX)
422 {
423     register XRV* xrv;
424     register XRV* xrvend;
425     XPV *ptr;
426     New(712, ptr, 1008/sizeof(XPV), XPV);
427     ptr->xpv_pv = (char*)PL_xrv_arenaroot;
428     PL_xrv_arenaroot = ptr;
429
430     xrv = (XRV*) ptr;
431     xrvend = &xrv[1008 / sizeof(XRV) - 1];
432     xrv += (sizeof(XPV) - 1) / sizeof(XRV) + 1;
433     PL_xrv_root = xrv;
434     while (xrv < xrvend) {
435         xrv->xrv_rv = (SV*)(xrv + 1);
436         xrv++;
437     }
438     xrv->xrv_rv = 0;
439 }
440
441 STATIC XPV*
442 S_new_xpv(pTHX)
443 {
444     XPV* xpv;
445     LOCK_SV_MUTEX;
446     if (!PL_xpv_root)
447         more_xpv();
448     xpv = PL_xpv_root;
449     PL_xpv_root = (XPV*)xpv->xpv_pv;
450     UNLOCK_SV_MUTEX;
451     return xpv;
452 }
453
454 STATIC void
455 S_del_xpv(pTHX_ XPV *p)
456 {
457     LOCK_SV_MUTEX;
458     p->xpv_pv = (char*)PL_xpv_root;
459     PL_xpv_root = p;
460     UNLOCK_SV_MUTEX;
461 }
462
463 STATIC void
464 S_more_xpv(pTHX)
465 {
466     register XPV* xpv;
467     register XPV* xpvend;
468     New(713, xpv, 1008/sizeof(XPV), XPV);
469     xpv->xpv_pv = (char*)PL_xpv_arenaroot;
470     PL_xpv_arenaroot = xpv;
471
472     xpvend = &xpv[1008 / sizeof(XPV) - 1];
473     PL_xpv_root = ++xpv;
474     while (xpv < xpvend) {
475         xpv->xpv_pv = (char*)(xpv + 1);
476         xpv++;
477     }
478     xpv->xpv_pv = 0;
479 }
480
481 STATIC XPVIV*
482 S_new_xpviv(pTHX)
483 {
484     XPVIV* xpviv;
485     LOCK_SV_MUTEX;
486     if (!PL_xpviv_root)
487         more_xpviv();
488     xpviv = PL_xpviv_root;
489     PL_xpviv_root = (XPVIV*)xpviv->xpv_pv;
490     UNLOCK_SV_MUTEX;
491     return xpviv;
492 }
493
494 STATIC void
495 S_del_xpviv(pTHX_ XPVIV *p)
496 {
497     LOCK_SV_MUTEX;
498     p->xpv_pv = (char*)PL_xpviv_root;
499     PL_xpviv_root = p;
500     UNLOCK_SV_MUTEX;
501 }
502
503 STATIC void
504 S_more_xpviv(pTHX)
505 {
506     register XPVIV* xpviv;
507     register XPVIV* xpvivend;
508     New(714, xpviv, 1008/sizeof(XPVIV), XPVIV);
509     xpviv->xpv_pv = (char*)PL_xpviv_arenaroot;
510     PL_xpviv_arenaroot = xpviv;
511
512     xpvivend = &xpviv[1008 / sizeof(XPVIV) - 1];
513     PL_xpviv_root = ++xpviv;
514     while (xpviv < xpvivend) {
515         xpviv->xpv_pv = (char*)(xpviv + 1);
516         xpviv++;
517     }
518     xpviv->xpv_pv = 0;
519 }
520
521 STATIC XPVNV*
522 S_new_xpvnv(pTHX)
523 {
524     XPVNV* xpvnv;
525     LOCK_SV_MUTEX;
526     if (!PL_xpvnv_root)
527         more_xpvnv();
528     xpvnv = PL_xpvnv_root;
529     PL_xpvnv_root = (XPVNV*)xpvnv->xpv_pv;
530     UNLOCK_SV_MUTEX;
531     return xpvnv;
532 }
533
534 STATIC void
535 S_del_xpvnv(pTHX_ XPVNV *p)
536 {
537     LOCK_SV_MUTEX;
538     p->xpv_pv = (char*)PL_xpvnv_root;
539     PL_xpvnv_root = p;
540     UNLOCK_SV_MUTEX;
541 }
542
543 STATIC void
544 S_more_xpvnv(pTHX)
545 {
546     register XPVNV* xpvnv;
547     register XPVNV* xpvnvend;
548     New(715, xpvnv, 1008/sizeof(XPVNV), XPVNV);
549     xpvnv->xpv_pv = (char*)PL_xpvnv_arenaroot;
550     PL_xpvnv_arenaroot = xpvnv;
551
552     xpvnvend = &xpvnv[1008 / sizeof(XPVNV) - 1];
553     PL_xpvnv_root = ++xpvnv;
554     while (xpvnv < xpvnvend) {
555         xpvnv->xpv_pv = (char*)(xpvnv + 1);
556         xpvnv++;
557     }
558     xpvnv->xpv_pv = 0;
559 }
560
561 STATIC XPVCV*
562 S_new_xpvcv(pTHX)
563 {
564     XPVCV* xpvcv;
565     LOCK_SV_MUTEX;
566     if (!PL_xpvcv_root)
567         more_xpvcv();
568     xpvcv = PL_xpvcv_root;
569     PL_xpvcv_root = (XPVCV*)xpvcv->xpv_pv;
570     UNLOCK_SV_MUTEX;
571     return xpvcv;
572 }
573
574 STATIC void
575 S_del_xpvcv(pTHX_ XPVCV *p)
576 {
577     LOCK_SV_MUTEX;
578     p->xpv_pv = (char*)PL_xpvcv_root;
579     PL_xpvcv_root = p;
580     UNLOCK_SV_MUTEX;
581 }
582
583 STATIC void
584 S_more_xpvcv(pTHX)
585 {
586     register XPVCV* xpvcv;
587     register XPVCV* xpvcvend;
588     New(716, xpvcv, 1008/sizeof(XPVCV), XPVCV);
589     xpvcv->xpv_pv = (char*)PL_xpvcv_arenaroot;
590     PL_xpvcv_arenaroot = xpvcv;
591
592     xpvcvend = &xpvcv[1008 / sizeof(XPVCV) - 1];
593     PL_xpvcv_root = ++xpvcv;
594     while (xpvcv < xpvcvend) {
595         xpvcv->xpv_pv = (char*)(xpvcv + 1);
596         xpvcv++;
597     }
598     xpvcv->xpv_pv = 0;
599 }
600
601 STATIC XPVAV*
602 S_new_xpvav(pTHX)
603 {
604     XPVAV* xpvav;
605     LOCK_SV_MUTEX;
606     if (!PL_xpvav_root)
607         more_xpvav();
608     xpvav = PL_xpvav_root;
609     PL_xpvav_root = (XPVAV*)xpvav->xav_array;
610     UNLOCK_SV_MUTEX;
611     return xpvav;
612 }
613
614 STATIC void
615 S_del_xpvav(pTHX_ XPVAV *p)
616 {
617     LOCK_SV_MUTEX;
618     p->xav_array = (char*)PL_xpvav_root;
619     PL_xpvav_root = p;
620     UNLOCK_SV_MUTEX;
621 }
622
623 STATIC void
624 S_more_xpvav(pTHX)
625 {
626     register XPVAV* xpvav;
627     register XPVAV* xpvavend;
628     New(717, xpvav, 1008/sizeof(XPVAV), XPVAV);
629     xpvav->xav_array = (char*)PL_xpvav_arenaroot;
630     PL_xpvav_arenaroot = xpvav;
631
632     xpvavend = &xpvav[1008 / sizeof(XPVAV) - 1];
633     PL_xpvav_root = ++xpvav;
634     while (xpvav < xpvavend) {
635         xpvav->xav_array = (char*)(xpvav + 1);
636         xpvav++;
637     }
638     xpvav->xav_array = 0;
639 }
640
641 STATIC XPVHV*
642 S_new_xpvhv(pTHX)
643 {
644     XPVHV* xpvhv;
645     LOCK_SV_MUTEX;
646     if (!PL_xpvhv_root)
647         more_xpvhv();
648     xpvhv = PL_xpvhv_root;
649     PL_xpvhv_root = (XPVHV*)xpvhv->xhv_array;
650     UNLOCK_SV_MUTEX;
651     return xpvhv;
652 }
653
654 STATIC void
655 S_del_xpvhv(pTHX_ XPVHV *p)
656 {
657     LOCK_SV_MUTEX;
658     p->xhv_array = (char*)PL_xpvhv_root;
659     PL_xpvhv_root = p;
660     UNLOCK_SV_MUTEX;
661 }
662
663 STATIC void
664 S_more_xpvhv(pTHX)
665 {
666     register XPVHV* xpvhv;
667     register XPVHV* xpvhvend;
668     New(718, xpvhv, 1008/sizeof(XPVHV), XPVHV);
669     xpvhv->xhv_array = (char*)PL_xpvhv_arenaroot;
670     PL_xpvhv_arenaroot = xpvhv;
671
672     xpvhvend = &xpvhv[1008 / sizeof(XPVHV) - 1];
673     PL_xpvhv_root = ++xpvhv;
674     while (xpvhv < xpvhvend) {
675         xpvhv->xhv_array = (char*)(xpvhv + 1);
676         xpvhv++;
677     }
678     xpvhv->xhv_array = 0;
679 }
680
681 STATIC XPVMG*
682 S_new_xpvmg(pTHX)
683 {
684     XPVMG* xpvmg;
685     LOCK_SV_MUTEX;
686     if (!PL_xpvmg_root)
687         more_xpvmg();
688     xpvmg = PL_xpvmg_root;
689     PL_xpvmg_root = (XPVMG*)xpvmg->xpv_pv;
690     UNLOCK_SV_MUTEX;
691     return xpvmg;
692 }
693
694 STATIC void
695 S_del_xpvmg(pTHX_ XPVMG *p)
696 {
697     LOCK_SV_MUTEX;
698     p->xpv_pv = (char*)PL_xpvmg_root;
699     PL_xpvmg_root = p;
700     UNLOCK_SV_MUTEX;
701 }
702
703 STATIC void
704 S_more_xpvmg(pTHX)
705 {
706     register XPVMG* xpvmg;
707     register XPVMG* xpvmgend;
708     New(719, xpvmg, 1008/sizeof(XPVMG), XPVMG);
709     xpvmg->xpv_pv = (char*)PL_xpvmg_arenaroot;
710     PL_xpvmg_arenaroot = xpvmg;
711
712     xpvmgend = &xpvmg[1008 / sizeof(XPVMG) - 1];
713     PL_xpvmg_root = ++xpvmg;
714     while (xpvmg < xpvmgend) {
715         xpvmg->xpv_pv = (char*)(xpvmg + 1);
716         xpvmg++;
717     }
718     xpvmg->xpv_pv = 0;
719 }
720
721 STATIC XPVLV*
722 S_new_xpvlv(pTHX)
723 {
724     XPVLV* xpvlv;
725     LOCK_SV_MUTEX;
726     if (!PL_xpvlv_root)
727         more_xpvlv();
728     xpvlv = PL_xpvlv_root;
729     PL_xpvlv_root = (XPVLV*)xpvlv->xpv_pv;
730     UNLOCK_SV_MUTEX;
731     return xpvlv;
732 }
733
734 STATIC void
735 S_del_xpvlv(pTHX_ XPVLV *p)
736 {
737     LOCK_SV_MUTEX;
738     p->xpv_pv = (char*)PL_xpvlv_root;
739     PL_xpvlv_root = p;
740     UNLOCK_SV_MUTEX;
741 }
742
743 STATIC void
744 S_more_xpvlv(pTHX)
745 {
746     register XPVLV* xpvlv;
747     register XPVLV* xpvlvend;
748     New(720, xpvlv, 1008/sizeof(XPVLV), XPVLV);
749     xpvlv->xpv_pv = (char*)PL_xpvlv_arenaroot;
750     PL_xpvlv_arenaroot = xpvlv;
751
752     xpvlvend = &xpvlv[1008 / sizeof(XPVLV) - 1];
753     PL_xpvlv_root = ++xpvlv;
754     while (xpvlv < xpvlvend) {
755         xpvlv->xpv_pv = (char*)(xpvlv + 1);
756         xpvlv++;
757     }
758     xpvlv->xpv_pv = 0;
759 }
760
761 STATIC XPVBM*
762 S_new_xpvbm(pTHX)
763 {
764     XPVBM* xpvbm;
765     LOCK_SV_MUTEX;
766     if (!PL_xpvbm_root)
767         more_xpvbm();
768     xpvbm = PL_xpvbm_root;
769     PL_xpvbm_root = (XPVBM*)xpvbm->xpv_pv;
770     UNLOCK_SV_MUTEX;
771     return xpvbm;
772 }
773
774 STATIC void
775 S_del_xpvbm(pTHX_ XPVBM *p)
776 {
777     LOCK_SV_MUTEX;
778     p->xpv_pv = (char*)PL_xpvbm_root;
779     PL_xpvbm_root = p;
780     UNLOCK_SV_MUTEX;
781 }
782
783 STATIC void
784 S_more_xpvbm(pTHX)
785 {
786     register XPVBM* xpvbm;
787     register XPVBM* xpvbmend;
788     New(721, xpvbm, 1008/sizeof(XPVBM), XPVBM);
789     xpvbm->xpv_pv = (char*)PL_xpvbm_arenaroot;
790     PL_xpvbm_arenaroot = xpvbm;
791
792     xpvbmend = &xpvbm[1008 / sizeof(XPVBM) - 1];
793     PL_xpvbm_root = ++xpvbm;
794     while (xpvbm < xpvbmend) {
795         xpvbm->xpv_pv = (char*)(xpvbm + 1);
796         xpvbm++;
797     }
798     xpvbm->xpv_pv = 0;
799 }
800
801 #ifdef LEAKTEST
802 #  define my_safemalloc(s)      (void*)safexmalloc(717,s)
803 #  define my_safefree(p)        safexfree((char*)p)
804 #else
805 #  define my_safemalloc(s)      (void*)safemalloc(s)
806 #  define my_safefree(p)        safefree((char*)p)
807 #endif
808
809 #ifdef PURIFY
810
811 #define new_XIV()       my_safemalloc(sizeof(XPVIV))
812 #define del_XIV(p)      my_safefree(p)
813
814 #define new_XNV()       my_safemalloc(sizeof(XPVNV))
815 #define del_XNV(p)      my_safefree(p)
816
817 #define new_XRV()       my_safemalloc(sizeof(XRV))
818 #define del_XRV(p)      my_safefree(p)
819
820 #define new_XPV()       my_safemalloc(sizeof(XPV))
821 #define del_XPV(p)      my_safefree(p)
822
823 #define new_XPVIV()     my_safemalloc(sizeof(XPVIV))
824 #define del_XPVIV(p)    my_safefree(p)
825
826 #define new_XPVNV()     my_safemalloc(sizeof(XPVNV))
827 #define del_XPVNV(p)    my_safefree(p)
828
829 #define new_XPVCV()     my_safemalloc(sizeof(XPVCV))
830 #define del_XPVCV(p)    my_safefree(p)
831
832 #define new_XPVAV()     my_safemalloc(sizeof(XPVAV))
833 #define del_XPVAV(p)    my_safefree(p)
834
835 #define new_XPVHV()     my_safemalloc(sizeof(XPVHV))
836 #define del_XPVHV(p)    my_safefree(p)
837
838 #define new_XPVMG()     my_safemalloc(sizeof(XPVMG))
839 #define del_XPVMG(p)    my_safefree(p)
840
841 #define new_XPVLV()     my_safemalloc(sizeof(XPVLV))
842 #define del_XPVLV(p)    my_safefree(p)
843
844 #define new_XPVBM()     my_safemalloc(sizeof(XPVBM))
845 #define del_XPVBM(p)    my_safefree(p)
846
847 #else /* !PURIFY */
848
849 #define new_XIV()       (void*)new_xiv()
850 #define del_XIV(p)      del_xiv((XPVIV*) p)
851
852 #define new_XNV()       (void*)new_xnv()
853 #define del_XNV(p)      del_xnv((XPVNV*) p)
854
855 #define new_XRV()       (void*)new_xrv()
856 #define del_XRV(p)      del_xrv((XRV*) p)
857
858 #define new_XPV()       (void*)new_xpv()
859 #define del_XPV(p)      del_xpv((XPV *)p)
860
861 #define new_XPVIV()     (void*)new_xpviv()
862 #define del_XPVIV(p)    del_xpviv((XPVIV *)p)
863
864 #define new_XPVNV()     (void*)new_xpvnv()
865 #define del_XPVNV(p)    del_xpvnv((XPVNV *)p)
866
867 #define new_XPVCV()     (void*)new_xpvcv()
868 #define del_XPVCV(p)    del_xpvcv((XPVCV *)p)
869
870 #define new_XPVAV()     (void*)new_xpvav()
871 #define del_XPVAV(p)    del_xpvav((XPVAV *)p)
872
873 #define new_XPVHV()     (void*)new_xpvhv()
874 #define del_XPVHV(p)    del_xpvhv((XPVHV *)p)
875
876 #define new_XPVMG()     (void*)new_xpvmg()
877 #define del_XPVMG(p)    del_xpvmg((XPVMG *)p)
878
879 #define new_XPVLV()     (void*)new_xpvlv()
880 #define del_XPVLV(p)    del_xpvlv((XPVLV *)p)
881
882 #define new_XPVBM()     (void*)new_xpvbm()
883 #define del_XPVBM(p)    del_xpvbm((XPVBM *)p)
884
885 #endif /* PURIFY */
886
887 #define new_XPVGV()     my_safemalloc(sizeof(XPVGV))
888 #define del_XPVGV(p)    my_safefree(p)
889
890 #define new_XPVFM()     my_safemalloc(sizeof(XPVFM))
891 #define del_XPVFM(p)    my_safefree(p)
892
893 #define new_XPVIO()     my_safemalloc(sizeof(XPVIO))
894 #define del_XPVIO(p)    my_safefree(p)
895
896 /*
897 =for apidoc sv_upgrade
898
899 Upgrade an SV to a more complex form.  Use C<SvUPGRADE>.  See
900 C<svtype>.
901
902 =cut
903 */
904
905 bool
906 Perl_sv_upgrade(pTHX_ register SV *sv, U32 mt)
907 {
908     char*       pv;
909     U32         cur;
910     U32         len;
911     IV          iv;
912     NV          nv;
913     MAGIC*      magic;
914     HV*         stash;
915
916     if (mt != SVt_PV && SvREADONLY(sv) && SvFAKE(sv)) {
917         sv_force_normal(sv);
918     }
919
920     if (SvTYPE(sv) == mt)
921         return TRUE;
922
923     if (mt < SVt_PVIV)
924         (void)SvOOK_off(sv);
925
926     switch (SvTYPE(sv)) {
927     case SVt_NULL:
928         pv      = 0;
929         cur     = 0;
930         len     = 0;
931         iv      = 0;
932         nv      = 0.0;
933         magic   = 0;
934         stash   = 0;
935         break;
936     case SVt_IV:
937         pv      = 0;
938         cur     = 0;
939         len     = 0;
940         iv      = SvIVX(sv);
941         nv      = (NV)SvIVX(sv);
942         del_XIV(SvANY(sv));
943         magic   = 0;
944         stash   = 0;
945         if (mt == SVt_NV)
946             mt = SVt_PVNV;
947         else if (mt < SVt_PVIV)
948             mt = SVt_PVIV;
949         break;
950     case SVt_NV:
951         pv      = 0;
952         cur     = 0;
953         len     = 0;
954         nv      = SvNVX(sv);
955         iv      = I_V(nv);
956         magic   = 0;
957         stash   = 0;
958         del_XNV(SvANY(sv));
959         SvANY(sv) = 0;
960         if (mt < SVt_PVNV)
961             mt = SVt_PVNV;
962         break;
963     case SVt_RV:
964         pv      = (char*)SvRV(sv);
965         cur     = 0;
966         len     = 0;
967         iv      = PTR2IV(pv);
968         nv      = PTR2NV(pv);
969         del_XRV(SvANY(sv));
970         magic   = 0;
971         stash   = 0;
972         break;
973     case SVt_PV:
974         pv      = SvPVX(sv);
975         cur     = SvCUR(sv);
976         len     = SvLEN(sv);
977         iv      = 0;
978         nv      = 0.0;
979         magic   = 0;
980         stash   = 0;
981         del_XPV(SvANY(sv));
982         if (mt <= SVt_IV)
983             mt = SVt_PVIV;
984         else if (mt == SVt_NV)
985             mt = SVt_PVNV;
986         break;
987     case SVt_PVIV:
988         pv      = SvPVX(sv);
989         cur     = SvCUR(sv);
990         len     = SvLEN(sv);
991         iv      = SvIVX(sv);
992         nv      = 0.0;
993         magic   = 0;
994         stash   = 0;
995         del_XPVIV(SvANY(sv));
996         break;
997     case SVt_PVNV:
998         pv      = SvPVX(sv);
999         cur     = SvCUR(sv);
1000         len     = SvLEN(sv);
1001         iv      = SvIVX(sv);
1002         nv      = SvNVX(sv);
1003         magic   = 0;
1004         stash   = 0;
1005         del_XPVNV(SvANY(sv));
1006         break;
1007     case SVt_PVMG:
1008         pv      = SvPVX(sv);
1009         cur     = SvCUR(sv);
1010         len     = SvLEN(sv);
1011         iv      = SvIVX(sv);
1012         nv      = SvNVX(sv);
1013         magic   = SvMAGIC(sv);
1014         stash   = SvSTASH(sv);
1015         del_XPVMG(SvANY(sv));
1016         break;
1017     default:
1018         Perl_croak(aTHX_ "Can't upgrade that kind of scalar");
1019     }
1020
1021     switch (mt) {
1022     case SVt_NULL:
1023         Perl_croak(aTHX_ "Can't upgrade to undef");
1024     case SVt_IV:
1025         SvANY(sv) = new_XIV();
1026         SvIVX(sv)       = iv;
1027         break;
1028     case SVt_NV:
1029         SvANY(sv) = new_XNV();
1030         SvNVX(sv)       = nv;
1031         break;
1032     case SVt_RV:
1033         SvANY(sv) = new_XRV();
1034         SvRV(sv) = (SV*)pv;
1035         break;
1036     case SVt_PV:
1037         SvANY(sv) = new_XPV();
1038         SvPVX(sv)       = pv;
1039         SvCUR(sv)       = cur;
1040         SvLEN(sv)       = len;
1041         break;
1042     case SVt_PVIV:
1043         SvANY(sv) = new_XPVIV();
1044         SvPVX(sv)       = pv;
1045         SvCUR(sv)       = cur;
1046         SvLEN(sv)       = len;
1047         SvIVX(sv)       = iv;
1048         if (SvNIOK(sv))
1049             (void)SvIOK_on(sv);
1050         SvNOK_off(sv);
1051         break;
1052     case SVt_PVNV:
1053         SvANY(sv) = new_XPVNV();
1054         SvPVX(sv)       = pv;
1055         SvCUR(sv)       = cur;
1056         SvLEN(sv)       = len;
1057         SvIVX(sv)       = iv;
1058         SvNVX(sv)       = nv;
1059         break;
1060     case SVt_PVMG:
1061         SvANY(sv) = new_XPVMG();
1062         SvPVX(sv)       = pv;
1063         SvCUR(sv)       = cur;
1064         SvLEN(sv)       = len;
1065         SvIVX(sv)       = iv;
1066         SvNVX(sv)       = nv;
1067         SvMAGIC(sv)     = magic;
1068         SvSTASH(sv)     = stash;
1069         break;
1070     case SVt_PVLV:
1071         SvANY(sv) = new_XPVLV();
1072         SvPVX(sv)       = pv;
1073         SvCUR(sv)       = cur;
1074         SvLEN(sv)       = len;
1075         SvIVX(sv)       = iv;
1076         SvNVX(sv)       = nv;
1077         SvMAGIC(sv)     = magic;
1078         SvSTASH(sv)     = stash;
1079         LvTARGOFF(sv)   = 0;
1080         LvTARGLEN(sv)   = 0;
1081         LvTARG(sv)      = 0;
1082         LvTYPE(sv)      = 0;
1083         break;
1084     case SVt_PVAV:
1085         SvANY(sv) = new_XPVAV();
1086         if (pv)
1087             Safefree(pv);
1088         SvPVX(sv)       = 0;
1089         AvMAX(sv)       = -1;
1090         AvFILLp(sv)     = -1;
1091         SvIVX(sv)       = 0;
1092         SvNVX(sv)       = 0.0;
1093         SvMAGIC(sv)     = magic;
1094         SvSTASH(sv)     = stash;
1095         AvALLOC(sv)     = 0;
1096         AvARYLEN(sv)    = 0;
1097         AvFLAGS(sv)     = 0;
1098         break;
1099     case SVt_PVHV:
1100         SvANY(sv) = new_XPVHV();
1101         if (pv)
1102             Safefree(pv);
1103         SvPVX(sv)       = 0;
1104         HvFILL(sv)      = 0;
1105         HvMAX(sv)       = 0;
1106         HvKEYS(sv)      = 0;
1107         SvNVX(sv)       = 0.0;
1108         SvMAGIC(sv)     = magic;
1109         SvSTASH(sv)     = stash;
1110         HvRITER(sv)     = 0;
1111         HvEITER(sv)     = 0;
1112         HvPMROOT(sv)    = 0;
1113         HvNAME(sv)      = 0;
1114         break;
1115     case SVt_PVCV:
1116         SvANY(sv) = new_XPVCV();
1117         Zero(SvANY(sv), 1, XPVCV);
1118         SvPVX(sv)       = pv;
1119         SvCUR(sv)       = cur;
1120         SvLEN(sv)       = len;
1121         SvIVX(sv)       = iv;
1122         SvNVX(sv)       = nv;
1123         SvMAGIC(sv)     = magic;
1124         SvSTASH(sv)     = stash;
1125         break;
1126     case SVt_PVGV:
1127         SvANY(sv) = new_XPVGV();
1128         SvPVX(sv)       = pv;
1129         SvCUR(sv)       = cur;
1130         SvLEN(sv)       = len;
1131         SvIVX(sv)       = iv;
1132         SvNVX(sv)       = nv;
1133         SvMAGIC(sv)     = magic;
1134         SvSTASH(sv)     = stash;
1135         GvGP(sv)        = 0;
1136         GvNAME(sv)      = 0;
1137         GvNAMELEN(sv)   = 0;
1138         GvSTASH(sv)     = 0;
1139         GvFLAGS(sv)     = 0;
1140         break;
1141     case SVt_PVBM:
1142         SvANY(sv) = new_XPVBM();
1143         SvPVX(sv)       = pv;
1144         SvCUR(sv)       = cur;
1145         SvLEN(sv)       = len;
1146         SvIVX(sv)       = iv;
1147         SvNVX(sv)       = nv;
1148         SvMAGIC(sv)     = magic;
1149         SvSTASH(sv)     = stash;
1150         BmRARE(sv)      = 0;
1151         BmUSEFUL(sv)    = 0;
1152         BmPREVIOUS(sv)  = 0;
1153         break;
1154     case SVt_PVFM:
1155         SvANY(sv) = new_XPVFM();
1156         Zero(SvANY(sv), 1, XPVFM);
1157         SvPVX(sv)       = pv;
1158         SvCUR(sv)       = cur;
1159         SvLEN(sv)       = len;
1160         SvIVX(sv)       = iv;
1161         SvNVX(sv)       = nv;
1162         SvMAGIC(sv)     = magic;
1163         SvSTASH(sv)     = stash;
1164         break;
1165     case SVt_PVIO:
1166         SvANY(sv) = new_XPVIO();
1167         Zero(SvANY(sv), 1, XPVIO);
1168         SvPVX(sv)       = pv;
1169         SvCUR(sv)       = cur;
1170         SvLEN(sv)       = len;
1171         SvIVX(sv)       = iv;
1172         SvNVX(sv)       = nv;
1173         SvMAGIC(sv)     = magic;
1174         SvSTASH(sv)     = stash;
1175         IoPAGE_LEN(sv)  = 60;
1176         break;
1177     }
1178     SvFLAGS(sv) &= ~SVTYPEMASK;
1179     SvFLAGS(sv) |= mt;
1180     return TRUE;
1181 }
1182
1183 int
1184 Perl_sv_backoff(pTHX_ register SV *sv)
1185 {
1186     assert(SvOOK(sv));
1187     if (SvIVX(sv)) {
1188         char *s = SvPVX(sv);
1189         SvLEN(sv) += SvIVX(sv);
1190         SvPVX(sv) -= SvIVX(sv);
1191         SvIV_set(sv, 0);
1192         Move(s, SvPVX(sv), SvCUR(sv)+1, char);
1193     }
1194     SvFLAGS(sv) &= ~SVf_OOK;
1195     return 0;
1196 }
1197
1198 /*
1199 =for apidoc sv_grow
1200
1201 Expands the character buffer in the SV.  This will use C<sv_unref> and will
1202 upgrade the SV to C<SVt_PV>.  Returns a pointer to the character buffer.
1203 Use C<SvGROW>.
1204
1205 =cut
1206 */
1207
1208 char *
1209 Perl_sv_grow(pTHX_ register SV *sv, register STRLEN newlen)
1210 {
1211     register char *s;
1212
1213 #ifdef HAS_64K_LIMIT
1214     if (newlen >= 0x10000) {
1215         PerlIO_printf(Perl_debug_log,
1216                       "Allocation too large: %"UVxf"\n", (UV)newlen);
1217         my_exit(1);
1218     }
1219 #endif /* HAS_64K_LIMIT */
1220     if (SvROK(sv))
1221         sv_unref(sv);
1222     if (SvTYPE(sv) < SVt_PV) {
1223         sv_upgrade(sv, SVt_PV);
1224         s = SvPVX(sv);
1225     }
1226     else if (SvOOK(sv)) {       /* pv is offset? */
1227         sv_backoff(sv);
1228         s = SvPVX(sv);
1229         if (newlen > SvLEN(sv))
1230             newlen += 10 * (newlen - SvCUR(sv)); /* avoid copy each time */
1231 #ifdef HAS_64K_LIMIT
1232         if (newlen >= 0x10000)
1233             newlen = 0xFFFF;
1234 #endif
1235     }
1236     else
1237         s = SvPVX(sv);
1238     if (newlen > SvLEN(sv)) {           /* need more room? */
1239         if (SvLEN(sv) && s) {
1240 #if defined(MYMALLOC) && !defined(LEAKTEST)
1241             STRLEN l = malloced_size((void*)SvPVX(sv));
1242             if (newlen <= l) {
1243                 SvLEN_set(sv, l);
1244                 return s;
1245             } else
1246 #endif
1247             Renew(s,newlen,char);
1248         }
1249         else
1250             New(703,s,newlen,char);
1251         SvPV_set(sv, s);
1252         SvLEN_set(sv, newlen);
1253     }
1254     return s;
1255 }
1256
1257 /*
1258 =for apidoc sv_setiv
1259
1260 Copies an integer into the given SV.  Does not handle 'set' magic.  See
1261 C<sv_setiv_mg>.
1262
1263 =cut
1264 */
1265
1266 void
1267 Perl_sv_setiv(pTHX_ register SV *sv, IV i)
1268 {
1269     SV_CHECK_THINKFIRST(sv);
1270     switch (SvTYPE(sv)) {
1271     case SVt_NULL:
1272         sv_upgrade(sv, SVt_IV);
1273         break;
1274     case SVt_NV:
1275         sv_upgrade(sv, SVt_PVNV);
1276         break;
1277     case SVt_RV:
1278     case SVt_PV:
1279         sv_upgrade(sv, SVt_PVIV);
1280         break;
1281
1282     case SVt_PVGV:
1283     case SVt_PVAV:
1284     case SVt_PVHV:
1285     case SVt_PVCV:
1286     case SVt_PVFM:
1287     case SVt_PVIO:
1288         Perl_croak(aTHX_ "Can't coerce %s to integer in %s", sv_reftype(sv,0),
1289                    PL_op_desc[PL_op->op_type]);
1290     }
1291     (void)SvIOK_only(sv);                       /* validate number */
1292     SvIVX(sv) = i;
1293     SvTAINT(sv);
1294 }
1295
1296 /*
1297 =for apidoc sv_setiv_mg
1298
1299 Like C<sv_setiv>, but also handles 'set' magic.
1300
1301 =cut
1302 */
1303
1304 void
1305 Perl_sv_setiv_mg(pTHX_ register SV *sv, IV i)
1306 {
1307     sv_setiv(sv,i);
1308     SvSETMAGIC(sv);
1309 }
1310
1311 /*
1312 =for apidoc sv_setuv
1313
1314 Copies an unsigned integer into the given SV.  Does not handle 'set' magic.
1315 See C<sv_setuv_mg>.
1316
1317 =cut
1318 */
1319
1320 void
1321 Perl_sv_setuv(pTHX_ register SV *sv, UV u)
1322 {
1323     /* With these two if statements:
1324        u=1.49  s=0.52  cu=72.49  cs=10.64  scripts=270  tests=20865
1325        
1326        without
1327        u=1.35  s=0.47  cu=73.45  cs=11.43  scripts=270  tests=20865
1328        
1329        If you wish to remove them, please benchmark to see what the effect is
1330     */
1331     if (u <= (UV)IV_MAX) {
1332        sv_setiv(sv, (IV)u);
1333        return;
1334     }
1335     sv_setiv(sv, 0);
1336     SvIsUV_on(sv);
1337     SvUVX(sv) = u;
1338 }
1339
1340 /*
1341 =for apidoc sv_setuv_mg
1342
1343 Like C<sv_setuv>, but also handles 'set' magic.
1344
1345 =cut
1346 */
1347
1348 void
1349 Perl_sv_setuv_mg(pTHX_ register SV *sv, UV u)
1350 {
1351     /* With these two if statements:
1352        u=1.49  s=0.52  cu=72.49  cs=10.64  scripts=270  tests=20865
1353        
1354        without
1355        u=1.35  s=0.47  cu=73.45  cs=11.43  scripts=270  tests=20865
1356        
1357        If you wish to remove them, please benchmark to see what the effect is
1358     */
1359     if (u <= (UV)IV_MAX) {
1360        sv_setiv(sv, (IV)u);
1361     } else {
1362        sv_setiv(sv, 0);
1363        SvIsUV_on(sv);
1364        sv_setuv(sv,u);
1365     }
1366     SvSETMAGIC(sv);
1367 }
1368
1369 /*
1370 =for apidoc sv_setnv
1371
1372 Copies a double into the given SV.  Does not handle 'set' magic.  See
1373 C<sv_setnv_mg>.
1374
1375 =cut
1376 */
1377
1378 void
1379 Perl_sv_setnv(pTHX_ register SV *sv, NV num)
1380 {
1381     SV_CHECK_THINKFIRST(sv);
1382     switch (SvTYPE(sv)) {
1383     case SVt_NULL:
1384     case SVt_IV:
1385         sv_upgrade(sv, SVt_NV);
1386         break;
1387     case SVt_RV:
1388     case SVt_PV:
1389     case SVt_PVIV:
1390         sv_upgrade(sv, SVt_PVNV);
1391         break;
1392
1393     case SVt_PVGV:
1394     case SVt_PVAV:
1395     case SVt_PVHV:
1396     case SVt_PVCV:
1397     case SVt_PVFM:
1398     case SVt_PVIO:
1399         Perl_croak(aTHX_ "Can't coerce %s to number in %s", sv_reftype(sv,0),
1400                    PL_op_name[PL_op->op_type]);
1401     }
1402     SvNVX(sv) = num;
1403     (void)SvNOK_only(sv);                       /* validate number */
1404     SvTAINT(sv);
1405 }
1406
1407 /*
1408 =for apidoc sv_setnv_mg
1409
1410 Like C<sv_setnv>, but also handles 'set' magic.
1411
1412 =cut
1413 */
1414
1415 void
1416 Perl_sv_setnv_mg(pTHX_ register SV *sv, NV num)
1417 {
1418     sv_setnv(sv,num);
1419     SvSETMAGIC(sv);
1420 }
1421
1422 STATIC void
1423 S_not_a_number(pTHX_ SV *sv)
1424 {
1425     char tmpbuf[64];
1426     char *d = tmpbuf;
1427     char *s;
1428     char *limit = tmpbuf + sizeof(tmpbuf) - 8;
1429                   /* each *s can expand to 4 chars + "...\0",
1430                      i.e. need room for 8 chars */
1431
1432     for (s = SvPVX(sv); *s && d < limit; s++) {
1433         int ch = *s & 0xFF;
1434         if (ch & 128 && !isPRINT_LC(ch)) {
1435             *d++ = 'M';
1436             *d++ = '-';
1437             ch &= 127;
1438         }
1439         if (ch == '\n') {
1440             *d++ = '\\';
1441             *d++ = 'n';
1442         }
1443         else if (ch == '\r') {
1444             *d++ = '\\';
1445             *d++ = 'r';
1446         }
1447         else if (ch == '\f') {
1448             *d++ = '\\';
1449             *d++ = 'f';
1450         }
1451         else if (ch == '\\') {
1452             *d++ = '\\';
1453             *d++ = '\\';
1454         }
1455         else if (isPRINT_LC(ch))
1456             *d++ = ch;
1457         else {
1458             *d++ = '^';
1459             *d++ = toCTRL(ch);
1460         }
1461     }
1462     if (*s) {
1463         *d++ = '.';
1464         *d++ = '.';
1465         *d++ = '.';
1466     }
1467     *d = '\0';
1468
1469     if (PL_op)
1470         Perl_warner(aTHX_ WARN_NUMERIC,
1471                     "Argument \"%s\" isn't numeric in %s", tmpbuf,
1472                 PL_op_desc[PL_op->op_type]);
1473     else
1474         Perl_warner(aTHX_ WARN_NUMERIC,
1475                     "Argument \"%s\" isn't numeric", tmpbuf);
1476 }
1477
1478 /* the number can be converted to integer with atol() or atoll() although */
1479 #define IS_NUMBER_TO_INT_BY_ATOL     0x01 /* integer (may have decimals) */
1480 #define IS_NUMBER_TO_INT_BY_STRTOL   0x02 /* it may exceed IV_MAX */
1481 #define IS_NUMBER_TO_INT_BY_ATOF     0x04 /* seen something like 123e4 */
1482 #define IS_NUMBER_LONGER_THAN_IV_MAX 0x08 /* more digits than IV_MAX */
1483 #define IS_NUMBER_AS_LONG_AS_IV_MAX  0x10 /* may(be not) larger than IV_MAX */
1484 #define IS_NUMBER_NOT_INT            0x20 /* seen a decimal point or e */
1485 #define IS_NUMBER_NEG                0x40 /* seen a leading - */
1486 #define IS_NUMBER_INFINITY           0x80 /* /^\s*-?Infinity\s*$/i */
1487
1488 /* Actually, ISO C leaves conversion of UV to IV undefined, but
1489    until proven guilty, assume that things are not that bad... */
1490
1491 /* As 64 bit platforms often have an NV that doesn't preserve all bits of
1492    an IV (an assumption perl has been based on to date) it becomes necessary
1493    to remove the assumption that the NV always carries enough precision to
1494    recreate the IV whenever needed, and that the NV is the canonical form.
1495    Instead, IV/UV and NV need to be given equal rights. So as to not lose
1496    precision as an side effect of conversion (which would lead to insanity
1497    and the dragon(s) in t/op/numconvert.t getting very angry) the intent is
1498    1) to distinguish between IV/UV/NV slots that have cached a valid
1499       conversion where precision was lost and IV/UV/NV slots that have a
1500       valid conversion which has lost no precision
1501    2) to ensure that if a numeric conversion to one form is request that
1502       would lose precision, the precise conversion (or differently
1503       imprecise conversion) is also performed and cached, to prevent
1504       requests for different numeric formats on the same SV causing
1505       lossy conversion chains. (lossless conversion chains are perfectly
1506       acceptable (still))
1507
1508
1509    flags are used:
1510    SvIOKp is true if the IV slot contains a valid value
1511    SvIOK  is true only if the IV value is accurate (UV if SvIOK_UV true)
1512    SvNOKp is true if the NV slot contains a valid value
1513    SvNOK  is true only if the NV value is accurate
1514
1515    so
1516    while converting from PV to NV check to see if converting that NV to an
1517    IV(or UV) would lose accuracy over a direct conversion from PV to
1518    IV(or UV). If it would, cache both conversions, return NV, but mark
1519    SV as IOK NOKp (ie not NOK).
1520
1521    while converting from PV to IV check to see if converting that IV to an
1522    NV would lose accuracy over a direct conversion from PV to NV. If it
1523    would, cache both conversions, flag similarly.
1524
1525    Before, the SV value "3.2" could become NV=3.2 IV=3 NOK, IOK quite
1526    correctly because if IV & NV were set NV *always* overruled.
1527    Now, "3.2" will become NV=3.2 IV=3 NOK, IOKp, because the flags meaning
1528    changes - now IV and NV together means that the two are interchangeable
1529    SvIVX == (IV) SvNVX && SvNVX == (NV) SvIVX;
1530    
1531    The benefit of this is operations such as pp_add know that if SvIOK is
1532    true for both left and right operands, then integer addition can be
1533    used instead of floating point. (for cases where the result won't
1534    overflow) Before, floating point was always used, which could lead to
1535    loss of precision compared with integer addition.
1536
1537    * making IV and NV equal status should make maths accurate on 64 bit
1538      platforms
1539    * may speed up maths somewhat if pp_add and friends start to use
1540      integers when possible instead of fp. (hopefully the overhead in
1541      looking for SvIOK and checking for overflow will not outweigh the
1542      fp to integer speedup)
1543    * will slow down integer operations (callers of SvIV) on "inaccurate"
1544      values, as the change from SvIOK to SvIOKp will cause a call into
1545      sv_2iv each time rather than a macro access direct to the IV slot
1546    * should speed up number->string conversion on integers as IV is
1547      favoured when IV and NV equally accurate
1548
1549    ####################################################################
1550    You had better be using SvIOK_notUV if you want an IV for arithmetic
1551    SvIOK is true if (IV or UV), so you might be getting (IV)SvUV
1552    SvUOK is true iff UV.
1553    ####################################################################
1554
1555    Your mileage will vary depending your CPUs relative fp to integer
1556    performance ratio.
1557 */
1558
1559 #ifndef NV_PRESERVES_UV
1560 #define IS_NUMBER_UNDERFLOW_IV 1
1561 #define IS_NUMBER_UNDERFLOW_UV 2
1562 #define IS_NUMBER_IV_AND_UV 2
1563 #define IS_NUMBER_OVERFLOW_IV 4
1564 #define IS_NUMBER_OVERFLOW_UV 5
1565 /* Hopefully your optimiser will consider inlining these two functions.  */
1566 STATIC int
1567 S_sv_2inuv_non_preserve (pTHX_ register SV *sv, I32 numtype) {
1568     NV nv = SvNVX(sv);          /* Code simpler and had compiler problems if */
1569     UV nv_as_uv = U_V(nv);      /*  these are not in simple variables.   */
1570     DEBUG_c(PerlIO_printf(Perl_debug_log,"sv_2inuv_non '%s', IV=0x%"UVxf" NV=%g inttype=%X\n", SvPVX(sv), SvIVX(sv), nv, numtype));
1571     if (nv_as_uv <= (UV)IV_MAX) {
1572         (void)SvIOKp_on(sv);
1573         (void)SvNOKp_on(sv);
1574         /* Within suitable range to fit in an IV,  atol won't overflow */
1575         /* XXX quite sure? Is that your final answer? not really, I'm
1576            trusting that nv_as_uv to round down if NV is (IV_MAX + 1) */
1577         SvIVX(sv) = (IV)Atol(SvPVX(sv));
1578         if (numtype & IS_NUMBER_NOT_INT) {
1579             /* I believe that even if the original PV had decimals, they
1580                are lost beyond the limit of the FP precision.
1581                However, neither is canonical, so both only get p flags.
1582                NWC, 2000/11/25 */
1583             /* Both already have p flags, so do nothing */
1584         } else if (SvIVX(sv) == I_V(nv)) {
1585             SvNOK_on(sv);
1586             SvIOK_on(sv);
1587         } else {
1588             SvIOK_on(sv);
1589             /* It had no "." so it must be integer.  assert (get in here from
1590                sv_2iv and sv_2uv only for ndef HAS_STRTOL and
1591                IS_NUMBER_AS_LONG_AS_IV_MAX) or my logic is faulty and all
1592                conversion routines need audit.  */
1593         }
1594         return nv < 0 ? IS_NUMBER_UNDERFLOW_UV : IS_NUMBER_IV_AND_UV;
1595     }
1596     /* between IV_MAX and NV(UV_MAX). Could be slightly> UV_MAX */
1597     (void)SvIOKp_on(sv);
1598     (void)SvNOKp_on(sv);
1599 #ifdef HAS_STRTOUL
1600     {
1601         int save_errno = errno;
1602         errno = 0;
1603         SvUVX(sv) = Strtoul(SvPVX(sv), Null(char**), 10);
1604         if (errno == 0) {
1605             if (numtype & IS_NUMBER_NOT_INT) {
1606                 /* UV and NV both imprecise.  */
1607                 SvIsUV_on(sv);
1608             } else if (SvUVX(sv) == nv_as_uv && SvUVX(sv) != UV_MAX) {
1609                 SvNOK_on(sv);
1610                 SvIOK_on(sv);
1611                 SvIsUV_on(sv);
1612             } else {
1613                 SvIOK_on(sv);
1614                 SvIsUV_on(sv);
1615             }
1616             errno = save_errno;
1617             return IS_NUMBER_OVERFLOW_IV;
1618         }
1619         errno = save_errno;
1620         SvNOK_on(sv);
1621         /* Must have just overflowed UV, but not enough that an NV could spot
1622            this.. */
1623         return IS_NUMBER_OVERFLOW_UV;
1624     }
1625 #else
1626     /* We've just lost integer precision, nothing we could do. */
1627     SvUVX(sv) = nv_as_uv;
1628     DEBUG_c(PerlIO_printf(Perl_debug_log,"sv_2niuv_non UV? '%s', UV=0x%"UVxf" NV=%g U_V(NV)=0x%"UVxf" inttype=%X\n", SvPVX(sv), SvIVX(sv), nv, nv_as_uv, numtype));
1629     /* UV and NV slots equally valid only if we have casting symmetry. */
1630     if (numtype & IS_NUMBER_NOT_INT) {
1631         SvIsUV_on(sv);
1632     } else if (SvUVX(sv) == nv_as_uv && SvUVX(sv) != UV_MAX) {
1633         /* UV_MAX can cast up to NV (UV_MAX+1), that NV casts down to UV_MAX
1634            UV_MAX ought to be 0xFF...FFF which won't preserve (We only
1635            get to this point if NVs don't preserve UVs) */
1636         SvNOK_on(sv);
1637         SvIOK_on(sv);
1638         SvIsUV_on(sv);
1639     } else {
1640         /* As above, I believe UV at least as good as NV */
1641         SvIsUV_on(sv);
1642     }
1643 #endif /* HAS_STRTOUL */
1644     return IS_NUMBER_OVERFLOW_IV;
1645 }
1646
1647 /* For sv_2nv these three cases are "SvNOK and don't bother casting"  */
1648 STATIC int
1649 S_sv_2iuv_non_preserve (pTHX_ register SV *sv, I32 numtype)
1650 {
1651     DEBUG_c(PerlIO_printf(Perl_debug_log,"sv_2iuv_non '%s', IV=0x%"UVxf" NV=%g inttype=%X\n", SvPVX(sv), SvIVX(sv), SvNVX(sv), numtype));
1652     if (SvNVX(sv) < (NV)IV_MIN) {
1653         (void)SvIOKp_on(sv);
1654         (void)SvNOK_on(sv);
1655         SvIVX(sv) = IV_MIN;
1656         return IS_NUMBER_UNDERFLOW_IV;
1657     }
1658     if (SvNVX(sv) > (NV)UV_MAX) {
1659         (void)SvIOKp_on(sv);
1660         (void)SvNOK_on(sv);
1661         SvIsUV_on(sv);
1662         SvUVX(sv) = UV_MAX;
1663         return IS_NUMBER_OVERFLOW_UV;
1664     }
1665     if (!(numtype & (IS_NUMBER_TO_INT_BY_ATOL | IS_NUMBER_TO_INT_BY_STRTOL))) {
1666         (void)SvIOKp_on(sv);
1667         (void)SvNOK_on(sv);
1668         /* Can't use strtol etc to convert this string */
1669         if (SvNVX(sv) <= (UV)IV_MAX) {
1670             SvIVX(sv) = I_V(SvNVX(sv));
1671             if ((NV)(SvIVX(sv)) == SvNVX(sv)) {
1672                 SvIOK_on(sv); /* Integer is precise. NOK, IOK */
1673             } else {
1674                 /* Integer is imprecise. NOK, IOKp */
1675             }
1676             return SvNVX(sv) < 0 ? IS_NUMBER_UNDERFLOW_UV : IS_NUMBER_IV_AND_UV;
1677         }
1678         SvIsUV_on(sv);
1679         SvUVX(sv) = U_V(SvNVX(sv));
1680         if ((NV)(SvUVX(sv)) == SvNVX(sv)) {
1681             SvIOK_on(sv); /* Integer is precise. NOK, UOK */
1682         } else {
1683             /* Integer is imprecise. NOK, IOKp */
1684         }
1685         return IS_NUMBER_OVERFLOW_IV;
1686     }
1687     return S_sv_2inuv_non_preserve(aTHX_ sv, numtype);
1688 }
1689 #endif /* NV_PRESERVES_UV*/
1690
1691 IV
1692 Perl_sv_2iv(pTHX_ register SV *sv)
1693 {
1694     if (!sv)
1695         return 0;
1696     if (SvGMAGICAL(sv)) {
1697         mg_get(sv);
1698         if (SvIOKp(sv))
1699             return SvIVX(sv);
1700         if (SvNOKp(sv)) {
1701             return I_V(SvNVX(sv));
1702         }
1703         if (SvPOKp(sv) && SvLEN(sv))
1704             return asIV(sv);
1705         if (!SvROK(sv)) {
1706             if (!(SvFLAGS(sv) & SVs_PADTMP)) {
1707                 if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
1708                     report_uninit();
1709             }
1710             return 0;
1711         }
1712     }
1713     if (SvTHINKFIRST(sv)) {
1714         if (SvROK(sv)) {
1715           SV* tmpstr;
1716           if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv,numer)) &&
1717                   (SvRV(tmpstr) != SvRV(sv)))
1718               return SvIV(tmpstr);
1719           return PTR2IV(SvRV(sv));
1720         }
1721         if (SvREADONLY(sv) && SvFAKE(sv)) {
1722             sv_force_normal(sv);
1723         }
1724         if (SvREADONLY(sv) && !SvOK(sv)) {
1725             if (ckWARN(WARN_UNINITIALIZED))
1726                 report_uninit();
1727             return 0;
1728         }
1729     }
1730     if (SvIOKp(sv)) {
1731         if (SvIsUV(sv)) {
1732             return (IV)(SvUVX(sv));
1733         }
1734         else {
1735             return SvIVX(sv);
1736         }
1737     }
1738     if (SvNOKp(sv)) {
1739         /* erm. not sure. *should* never get NOKp (without NOK) from sv_2nv
1740          * without also getting a cached IV/UV from it at the same time
1741          * (ie PV->NV conversion should detect loss of accuracy and cache
1742          * IV or UV at same time to avoid this.  NWC */
1743
1744         if (SvTYPE(sv) == SVt_NV)
1745             sv_upgrade(sv, SVt_PVNV);
1746
1747         (void)SvIOKp_on(sv);    /* Must do this first, to clear any SvOOK */
1748         /* < not <= as for NV doesn't preserve UV, ((NV)IV_MAX+1) will almost
1749            certainly cast into the IV range at IV_MAX, whereas the correct
1750            answer is the UV IV_MAX +1. Hence < ensures that dodgy boundary
1751            cases go to UV */
1752         if (SvNVX(sv) < (NV)IV_MAX + 0.5) {
1753             SvIVX(sv) = I_V(SvNVX(sv));
1754             if (SvNVX(sv) == (NV) SvIVX(sv)
1755 #ifndef NV_PRESERVES_UV
1756                 && (((UV)1 << NV_PRESERVES_UV_BITS) >
1757                     (UV)(SvIVX(sv) > 0 ? SvIVX(sv) : -SvIVX(sv)))
1758                 /* Don't flag it as "accurately an integer" if the number
1759                    came from a (by definition imprecise) NV operation, and
1760                    we're outside the range of NV integer precision */
1761 #endif
1762                 ) {
1763                 SvIOK_on(sv);  /* Can this go wrong with rounding? NWC */
1764                 DEBUG_c(PerlIO_printf(Perl_debug_log,
1765                                       "0x%"UVxf" iv(%g => %"IVdf") (precise)\n",
1766                                       PTR2UV(sv),
1767                                       SvNVX(sv),
1768                                       SvIVX(sv)));
1769
1770             } else {
1771                 /* IV not precise.  No need to convert from PV, as NV
1772                    conversion would already have cached IV if it detected
1773                    that PV->IV would be better than PV->NV->IV
1774                    flags already correct - don't set public IOK.  */
1775                 DEBUG_c(PerlIO_printf(Perl_debug_log,
1776                                       "0x%"UVxf" iv(%g => %"IVdf") (imprecise)\n",
1777                                       PTR2UV(sv),
1778                                       SvNVX(sv),
1779                                       SvIVX(sv)));
1780             }
1781             /* Can the above go wrong if SvIVX == IV_MIN and SvNVX < IV_MIN,
1782                but the cast (NV)IV_MIN rounds to a the value less (more
1783                negative) than IV_MIN which happens to be equal to SvNVX ??
1784                Analogous to 0xFFFFFFFFFFFFFFFF rounding up to NV (2**64) and
1785                NV rounding back to 0xFFFFFFFFFFFFFFFF, so UVX == UV(NVX) and
1786                (NV)UVX == NVX are both true, but the values differ. :-(
1787                Hopefully for 2s complement IV_MIN is something like
1788                0x8000000000000000 which will be exact. NWC */
1789         } 
1790         else {
1791             SvUVX(sv) = U_V(SvNVX(sv));
1792             if (
1793                 (SvNVX(sv) == (NV) SvUVX(sv))
1794 #ifndef  NV_PRESERVES_UV
1795                 /* Make sure it's not 0xFFFFFFFFFFFFFFFF */
1796                 /*&& (SvUVX(sv) != UV_MAX) irrelevant with code below */
1797                 && (((UV)1 << NV_PRESERVES_UV_BITS) > SvUVX(sv))
1798                 /* Don't flag it as "accurately an integer" if the number
1799                    came from a (by definition imprecise) NV operation, and
1800                    we're outside the range of NV integer precision */
1801 #endif
1802                 )
1803                 SvIOK_on(sv);
1804             SvIsUV_on(sv);
1805           ret_iv_max:
1806             DEBUG_c(PerlIO_printf(Perl_debug_log,
1807                                   "0x%"UVxf" 2iv(%"UVuf" => %"IVdf") (as unsigned)\n",
1808                                   PTR2UV(sv),
1809                                   SvUVX(sv),
1810                                   SvUVX(sv)));
1811             return (IV)SvUVX(sv);
1812         }
1813     }
1814     else if (SvPOKp(sv) && SvLEN(sv)) {
1815         I32 numtype = looks_like_number(sv);
1816
1817         /* We want to avoid a possible problem when we cache an IV which
1818            may be later translated to an NV, and the resulting NV is not
1819            the translation of the initial data.
1820         
1821            This means that if we cache such an IV, we need to cache the
1822            NV as well.  Moreover, we trade speed for space, and do not
1823            cache the NV if we are sure it's not needed.
1824          */
1825
1826         if ((numtype & ~IS_NUMBER_NEG) == IS_NUMBER_TO_INT_BY_ATOL) {
1827             /* The NV may be reconstructed from IV - safe to cache IV,
1828                 which may be calculated by atol(). */
1829             if (SvTYPE(sv) < SVt_PVIV)
1830                 sv_upgrade(sv, SVt_PVIV);
1831             (void)SvIOK_on(sv);
1832             SvIVX(sv) = Atol(SvPVX(sv));
1833         } else {
1834 #ifdef HAS_STRTOL
1835             IV i;
1836             int save_errno = errno;
1837             /* Is it an integer that we could convert with strtol?
1838                So try it, and if it doesn't set errno then it's pukka.
1839                This should be faster than going atof and then thinking.  */
1840             if (((numtype & (IS_NUMBER_TO_INT_BY_STRTOL | IS_NUMBER_NOT_INT))
1841                   == IS_NUMBER_TO_INT_BY_STRTOL)
1842                 /* && is a sequence point. Without it not sure if I'm trying
1843                    to do too much between sequence points and hence going
1844                    undefined */
1845                 && ((errno = 0), 1) /* , 1 so always true */
1846                 && ((i = Strtol(SvPVX(sv), Null(char**), 10)), 1)
1847                 && (errno == 0)) {
1848                 if (SvTYPE(sv) < SVt_PVIV)
1849                     sv_upgrade(sv, SVt_PVIV);
1850                 (void)SvIOK_on(sv);
1851                 SvIVX(sv) = i;
1852                 errno = save_errno;
1853             } else
1854 #endif
1855             {
1856                 NV d;
1857 #ifdef HAS_STRTOL
1858                 /* Hopefully trace flow will optimise this away where possible
1859                  */
1860                 errno = save_errno;
1861 #endif
1862                 /* It wasn't an integer, or it overflowed, or we don't have
1863                    strtol. Do things the slow way - check if it's a UV etc. */
1864                 d = Atof(SvPVX(sv));
1865
1866                 if (SvTYPE(sv) < SVt_PVNV)
1867                     sv_upgrade(sv, SVt_PVNV);
1868                 SvNVX(sv) = d;
1869
1870                 if (! numtype && ckWARN(WARN_NUMERIC))
1871                     not_a_number(sv);
1872
1873 #if defined(USE_LONG_DOUBLE)
1874                 DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2iv(%" PERL_PRIgldbl ")\n",
1875                                       PTR2UV(sv), SvNVX(sv)));
1876 #else
1877                 DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2iv(%g)\n",
1878                                       PTR2UV(sv), SvNVX(sv)));
1879 #endif
1880
1881
1882 #ifdef NV_PRESERVES_UV
1883                 (void)SvIOKp_on(sv);
1884                 (void)SvNOK_on(sv);
1885                 if (SvNVX(sv) < (NV)IV_MAX + 0.5) {
1886                     SvIVX(sv) = I_V(SvNVX(sv));
1887                     if ((NV)(SvIVX(sv)) == SvNVX(sv)) {
1888                         SvIOK_on(sv);
1889                     } else {
1890                         /* Integer is imprecise. NOK, IOKp */
1891                     }
1892                     /* UV will not work better than IV */
1893                 } else {
1894                     if (SvNVX(sv) > (NV)UV_MAX) {
1895                         SvIsUV_on(sv);
1896                         /* Integer is inaccurate. NOK, IOKp, is UV */
1897                         SvUVX(sv) = UV_MAX;
1898                         SvIsUV_on(sv);
1899                     } else {
1900                         SvUVX(sv) = U_V(SvNVX(sv));
1901                         /* 0xFFFFFFFFFFFFFFFF not an issue in here */
1902                         if ((NV)(SvUVX(sv)) == SvNVX(sv)) {
1903                             SvIOK_on(sv);
1904                             SvIsUV_on(sv);
1905                         } else {
1906                             /* Integer is imprecise. NOK, IOKp, is UV */
1907                             SvIsUV_on(sv);
1908                         }
1909                     }
1910                     goto ret_iv_max;
1911                 }
1912 #else /* NV_PRESERVES_UV */
1913                 if (((UV)1 << NV_PRESERVES_UV_BITS) >
1914                     U_V(SvNVX(sv) > 0 ? SvNVX(sv) : -SvNVX(sv))) {
1915                     /* Small enough to preserve all bits. */
1916                     (void)SvIOKp_on(sv);
1917                     SvNOK_on(sv);
1918                     SvIVX(sv) = I_V(SvNVX(sv));
1919                     if ((NV)(SvIVX(sv)) == SvNVX(sv))
1920                         SvIOK_on(sv);
1921                     /* Assumption: first non-preserved integer is < IV_MAX,
1922                        this NV is in the preserved range, therefore: */
1923                     if (!(U_V(SvNVX(sv) > 0 ? SvNVX(sv) : -SvNVX(sv))
1924                           < (UV)IV_MAX)) {
1925                         Perl_croak(aTHX_ "sv_2iv assumed (U_V(fabs(SvNVX(sv))) < (UV)IV_MAX) but SvNVX(sv)=%g U_V is 0x%"UVxf", IV_MAX is 0x%"UVxf"\n", SvNVX(sv), U_V(SvNVX(sv)), (UV)IV_MAX);
1926                     }
1927                 } else if (sv_2iuv_non_preserve (sv, numtype)
1928                            >= IS_NUMBER_OVERFLOW_IV)
1929                     goto ret_iv_max;
1930 #endif /* NV_PRESERVES_UV */
1931             }
1932         }
1933     } else  {
1934         if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing && !(SvFLAGS(sv) & SVs_PADTMP))
1935             report_uninit();
1936         if (SvTYPE(sv) < SVt_IV)
1937             /* Typically the caller expects that sv_any is not NULL now.  */
1938             sv_upgrade(sv, SVt_IV);
1939         return 0;
1940     }
1941     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2iv(%"IVdf")\n",
1942         PTR2UV(sv),SvIVX(sv)));
1943     return SvIsUV(sv) ? (IV)SvUVX(sv) : SvIVX(sv);
1944 }
1945
1946 UV
1947 Perl_sv_2uv(pTHX_ register SV *sv)
1948 {
1949     if (!sv)
1950         return 0;
1951     if (SvGMAGICAL(sv)) {
1952         mg_get(sv);
1953         if (SvIOKp(sv))
1954             return SvUVX(sv);
1955         if (SvNOKp(sv))
1956             return U_V(SvNVX(sv));
1957         if (SvPOKp(sv) && SvLEN(sv))
1958             return asUV(sv);
1959         if (!SvROK(sv)) {
1960             if (!(SvFLAGS(sv) & SVs_PADTMP)) {
1961                 if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
1962                     report_uninit();
1963             }
1964             return 0;
1965         }
1966     }
1967     if (SvTHINKFIRST(sv)) {
1968         if (SvROK(sv)) {
1969           SV* tmpstr;
1970           if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv,numer)) &&
1971                   (SvRV(tmpstr) != SvRV(sv)))
1972               return SvUV(tmpstr);
1973           return PTR2UV(SvRV(sv));
1974         }
1975         if (SvREADONLY(sv) && SvFAKE(sv)) {
1976             sv_force_normal(sv);
1977         }
1978         if (SvREADONLY(sv) && !SvOK(sv)) {
1979             if (ckWARN(WARN_UNINITIALIZED))
1980                 report_uninit();
1981             return 0;
1982         }
1983     }
1984     if (SvIOKp(sv)) {
1985         if (SvIsUV(sv)) {
1986             return SvUVX(sv);
1987         }
1988         else {
1989             return (UV)SvIVX(sv);
1990         }
1991     }
1992     if (SvNOKp(sv)) {
1993         /* erm. not sure. *should* never get NOKp (without NOK) from sv_2nv
1994          * without also getting a cached IV/UV from it at the same time
1995          * (ie PV->NV conversion should detect loss of accuracy and cache
1996          * IV or UV at same time to avoid this. */
1997         /* IV-over-UV optimisation - choose to cache IV if possible */
1998
1999         if (SvTYPE(sv) == SVt_NV)
2000             sv_upgrade(sv, SVt_PVNV);
2001
2002         (void)SvIOKp_on(sv);    /* Must do this first, to clear any SvOOK */
2003         if (SvNVX(sv) < (NV)IV_MAX + 0.5) {
2004             SvIVX(sv) = I_V(SvNVX(sv));
2005             if (SvNVX(sv) == (NV) SvIVX(sv)
2006 #ifndef NV_PRESERVES_UV
2007                 && (((UV)1 << NV_PRESERVES_UV_BITS) >
2008                     (UV)(SvIVX(sv) > 0 ? SvIVX(sv) : -SvIVX(sv)))
2009                 /* Don't flag it as "accurately an integer" if the number
2010                    came from a (by definition imprecise) NV operation, and
2011                    we're outside the range of NV integer precision */
2012 #endif
2013                 ) {
2014                 SvIOK_on(sv);  /* Can this go wrong with rounding? NWC */
2015                 DEBUG_c(PerlIO_printf(Perl_debug_log,
2016                                       "0x%"UVxf" uv(%g => %"IVdf") (precise)\n",
2017                                       PTR2UV(sv),
2018                                       SvNVX(sv),
2019                                       SvIVX(sv)));
2020
2021             } else {
2022                 /* IV not precise.  No need to convert from PV, as NV
2023                    conversion would already have cached IV if it detected
2024                    that PV->IV would be better than PV->NV->IV
2025                    flags already correct - don't set public IOK.  */
2026                 DEBUG_c(PerlIO_printf(Perl_debug_log,
2027                                       "0x%"UVxf" uv(%g => %"IVdf") (imprecise)\n",
2028                                       PTR2UV(sv),
2029                                       SvNVX(sv),
2030                                       SvIVX(sv)));
2031             }
2032             /* Can the above go wrong if SvIVX == IV_MIN and SvNVX < IV_MIN,
2033                but the cast (NV)IV_MIN rounds to a the value less (more
2034                negative) than IV_MIN which happens to be equal to SvNVX ??
2035                Analogous to 0xFFFFFFFFFFFFFFFF rounding up to NV (2**64) and
2036                NV rounding back to 0xFFFFFFFFFFFFFFFF, so UVX == UV(NVX) and
2037                (NV)UVX == NVX are both true, but the values differ. :-(
2038                Hopefully for 2s complement IV_MIN is something like
2039                0x8000000000000000 which will be exact. NWC */
2040         } 
2041         else {
2042             SvUVX(sv) = U_V(SvNVX(sv));
2043             if (
2044                 (SvNVX(sv) == (NV) SvUVX(sv))
2045 #ifndef  NV_PRESERVES_UV
2046                 /* Make sure it's not 0xFFFFFFFFFFFFFFFF */
2047                 /*&& (SvUVX(sv) != UV_MAX) irrelevant with code below */
2048                 && (((UV)1 << NV_PRESERVES_UV_BITS) > SvUVX(sv))
2049                 /* Don't flag it as "accurately an integer" if the number
2050                    came from a (by definition imprecise) NV operation, and
2051                    we're outside the range of NV integer precision */
2052 #endif
2053                 )
2054                 SvIOK_on(sv);
2055             SvIsUV_on(sv);
2056             DEBUG_c(PerlIO_printf(Perl_debug_log,
2057                                   "0x%"UVxf" 2uv(%"UVuf" => %"IVdf") (as unsigned)\n",
2058                                   PTR2UV(sv),
2059                                   SvUVX(sv),
2060                                   SvUVX(sv)));
2061         }
2062     }
2063     else if (SvPOKp(sv) && SvLEN(sv)) {
2064         I32 numtype = looks_like_number(sv);
2065
2066         /* We want to avoid a possible problem when we cache a UV which
2067            may be later translated to an NV, and the resulting NV is not
2068            the translation of the initial data.
2069         
2070            This means that if we cache such a UV, we need to cache the
2071            NV as well.  Moreover, we trade speed for space, and do not
2072            cache the NV if not needed.
2073          */
2074
2075         if ((numtype & ~IS_NUMBER_NEG) == IS_NUMBER_TO_INT_BY_ATOL) {
2076             /* The NV may be reconstructed from IV - safe to cache IV,
2077                 which may be calculated by atol(). */
2078             if (SvTYPE(sv) < SVt_PVIV)
2079                 sv_upgrade(sv, SVt_PVIV);
2080             (void)SvIOK_on(sv);
2081             SvIVX(sv) = Atol(SvPVX(sv));
2082         } else {
2083 #ifdef HAS_STRTOUL
2084             UV u;
2085             char *num_begin = SvPVX(sv);
2086             int save_errno = errno;
2087             
2088             /* seems that strtoul taking numbers that start with - is
2089                implementation dependant, and can't be relied upon.  */
2090             if (numtype & IS_NUMBER_NEG) {
2091                 /* Not totally defensive. assumine that looks_like_num
2092                    didn't lie about a - sign */
2093                 while (isSPACE(*num_begin))
2094                     num_begin++;
2095                 if (*num_begin == '-')
2096                     num_begin++;
2097             }
2098     
2099             /* Is it an integer that we could convert with strtoul?
2100                So try it, and if it doesn't set errno then it's pukka.
2101                This should be faster than going atof and then thinking.  */
2102             if (((numtype & (IS_NUMBER_TO_INT_BY_STRTOL | IS_NUMBER_NOT_INT))
2103                  == IS_NUMBER_TO_INT_BY_STRTOL)
2104                 && ((errno = 0), 1) /* always true */
2105                 && ((u = Strtoul(num_begin, Null(char**), 10)), 1) /* ditto */
2106                 && (errno == 0)
2107                 /* If known to be negative, check it didn't undeflow IV 
2108                    XXX possibly we should put more negative values as NVs
2109                    direct rather than go via atof below */
2110                 && ((numtype & IS_NUMBER_NEG) ? (u <= (UV)IV_MIN) : 1)) {
2111                 errno = save_errno;
2112
2113                 if (SvTYPE(sv) < SVt_PVIV)
2114                     sv_upgrade(sv, SVt_PVIV);
2115                 (void)SvIOK_on(sv);
2116
2117                 /* If it's negative must use IV.
2118                    IV-over-UV optimisation */
2119                 if (numtype & IS_NUMBER_NEG) {
2120                     SvIVX(sv) = -(IV)u;
2121                 } else if (u <= (UV) IV_MAX) {
2122                     SvIVX(sv) = (IV)u;
2123                 } else {
2124                     /* it didn't overflow, and it was positive. */
2125                     SvUVX(sv) = u;
2126                     SvIsUV_on(sv);
2127                 }
2128             } else
2129 #endif
2130             {
2131                 NV d;
2132 #ifdef HAS_STRTOUL
2133                 /* Hopefully trace flow will optimise this away where possible
2134                  */
2135                 errno = save_errno;
2136 #endif
2137                 /* It wasn't an integer, or it overflowed, or we don't have
2138                    strtol. Do things the slow way - check if it's a IV etc. */
2139                 d = Atof(SvPVX(sv));
2140
2141                 if (SvTYPE(sv) < SVt_PVNV)
2142                     sv_upgrade(sv, SVt_PVNV);
2143                 SvNVX(sv) = d;
2144
2145                 if (! numtype && ckWARN(WARN_NUMERIC))
2146                     not_a_number(sv);
2147
2148 #if defined(USE_LONG_DOUBLE)
2149                 DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2uv(%" PERL_PRIgldbl ")\n",
2150                                       PTR2UV(sv), SvNVX(sv)));
2151 #else
2152                 DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2uv(%g)\n",
2153                                       PTR2UV(sv), SvNVX(sv)));
2154 #endif
2155
2156 #ifdef NV_PRESERVES_UV
2157                 (void)SvIOKp_on(sv);
2158                 (void)SvNOK_on(sv);
2159                 if (SvNVX(sv) < (NV)IV_MAX + 0.5) {
2160                     SvIVX(sv) = I_V(SvNVX(sv));
2161                     if ((NV)(SvIVX(sv)) == SvNVX(sv)) {
2162                         SvIOK_on(sv);
2163                     } else {
2164                         /* Integer is imprecise. NOK, IOKp */
2165                     }
2166                     /* UV will not work better than IV */
2167                 } else {
2168                     if (SvNVX(sv) > (NV)UV_MAX) {
2169                         SvIsUV_on(sv);
2170                         /* Integer is inaccurate. NOK, IOKp, is UV */
2171                         SvUVX(sv) = UV_MAX;
2172                         SvIsUV_on(sv);
2173                     } else {
2174                         SvUVX(sv) = U_V(SvNVX(sv));
2175                         /* 0xFFFFFFFFFFFFFFFF not an issue in here, NVs
2176                            NV preservse UV so can do correct comparison.  */
2177                         if ((NV)(SvUVX(sv)) == SvNVX(sv)) {
2178                             SvIOK_on(sv);
2179                             SvIsUV_on(sv);
2180                         } else {
2181                             /* Integer is imprecise. NOK, IOKp, is UV */
2182                             SvIsUV_on(sv);
2183                         }
2184                     }
2185                 }
2186 #else /* NV_PRESERVES_UV */
2187                 if (((UV)1 << NV_PRESERVES_UV_BITS) >
2188                     U_V(SvNVX(sv) > 0 ? SvNVX(sv) : -SvNVX(sv))) {
2189                     /* Small enough to preserve all bits. */
2190                     (void)SvIOKp_on(sv);
2191                     SvNOK_on(sv);
2192                     SvIVX(sv) = I_V(SvNVX(sv));
2193                     if ((NV)(SvIVX(sv)) == SvNVX(sv))
2194                         SvIOK_on(sv);
2195                     /* Assumption: first non-preserved integer is < IV_MAX,
2196                        this NV is in the preserved range, therefore: */
2197                     if (!(U_V(SvNVX(sv) > 0 ? SvNVX(sv) : -SvNVX(sv))
2198                           < (UV)IV_MAX)) {
2199                         Perl_croak(aTHX_ "sv_2uv assumed (U_V(fabs(SvNVX(sv))) < (UV)IV_MAX) but SvNVX(sv)=%g U_V is 0x%"UVxf", IV_MAX is 0x%"UVxf"\n", SvNVX(sv), U_V(SvNVX(sv)), (UV)IV_MAX);
2200                     }
2201                 } else
2202                     sv_2iuv_non_preserve (sv, numtype);
2203 #endif /* NV_PRESERVES_UV */
2204             }
2205         }
2206     }
2207     else  {
2208         if (!(SvFLAGS(sv) & SVs_PADTMP)) {
2209             if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
2210                 report_uninit();
2211         }
2212         if (SvTYPE(sv) < SVt_IV)
2213             /* Typically the caller expects that sv_any is not NULL now.  */
2214             sv_upgrade(sv, SVt_IV);
2215         return 0;
2216     }
2217
2218     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2uv(%"UVuf")\n",
2219                           PTR2UV(sv),SvUVX(sv)));
2220     return SvIsUV(sv) ? SvUVX(sv) : (UV)SvIVX(sv);
2221 }
2222
2223 NV
2224 Perl_sv_2nv(pTHX_ register SV *sv)
2225 {
2226     if (!sv)
2227         return 0.0;
2228     if (SvGMAGICAL(sv)) {
2229         mg_get(sv);
2230         if (SvNOKp(sv))
2231             return SvNVX(sv);
2232         if (SvPOKp(sv) && SvLEN(sv)) {
2233             if (ckWARN(WARN_NUMERIC) && !SvIOKp(sv) && !looks_like_number(sv))
2234                 not_a_number(sv);
2235             return Atof(SvPVX(sv));
2236         }
2237         if (SvIOKp(sv)) {
2238             if (SvIsUV(sv))
2239                 return (NV)SvUVX(sv);
2240             else
2241                 return (NV)SvIVX(sv);
2242         }       
2243         if (!SvROK(sv)) {
2244             if (!(SvFLAGS(sv) & SVs_PADTMP)) {
2245                 if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
2246                     report_uninit();
2247             }
2248             return 0;
2249         }
2250     }
2251     if (SvTHINKFIRST(sv)) {
2252         if (SvROK(sv)) {
2253           SV* tmpstr;
2254           if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv,numer)) &&
2255                   (SvRV(tmpstr) != SvRV(sv)))
2256               return SvNV(tmpstr);
2257           return PTR2NV(SvRV(sv));
2258         }
2259         if (SvREADONLY(sv) && SvFAKE(sv)) {
2260             sv_force_normal(sv);
2261         }
2262         if (SvREADONLY(sv) && !SvOK(sv)) {
2263             if (ckWARN(WARN_UNINITIALIZED))
2264                 report_uninit();
2265             return 0.0;
2266         }
2267     }
2268     if (SvTYPE(sv) < SVt_NV) {
2269         if (SvTYPE(sv) == SVt_IV)
2270             sv_upgrade(sv, SVt_PVNV);
2271         else
2272             sv_upgrade(sv, SVt_NV);
2273 #if defined(USE_LONG_DOUBLE)
2274         DEBUG_c({
2275             STORE_NUMERIC_LOCAL_SET_STANDARD();
2276             PerlIO_printf(Perl_debug_log,
2277                           "0x%"UVxf" num(%" PERL_PRIgldbl ")\n",
2278                           PTR2UV(sv), SvNVX(sv));
2279             RESTORE_NUMERIC_LOCAL();
2280         });
2281 #else
2282         DEBUG_c({
2283             STORE_NUMERIC_LOCAL_SET_STANDARD();
2284             PerlIO_printf(Perl_debug_log, "0x%"UVxf" num(%g)\n",
2285                           PTR2UV(sv), SvNVX(sv));
2286             RESTORE_NUMERIC_LOCAL();
2287         });
2288 #endif
2289     }
2290     else if (SvTYPE(sv) < SVt_PVNV)
2291         sv_upgrade(sv, SVt_PVNV);
2292     if (SvIOKp(sv) &&
2293             (!SvPOKp(sv) || !strchr(SvPVX(sv),'.') || !looks_like_number(sv)))
2294     {
2295         SvNVX(sv) = SvIsUV(sv) ? (NV)SvUVX(sv) : (NV)SvIVX(sv);
2296 #ifdef NV_PRESERVES_UV
2297         SvNOK_on(sv);
2298 #else
2299         /* Only set the public NV OK flag if this NV preserves the IV  */
2300         /* Check it's not 0xFFFFFFFFFFFFFFFF */
2301         if (SvIsUV(sv) ? ((SvUVX(sv) != UV_MAX)&&(SvUVX(sv) == U_V(SvNVX(sv))))
2302                        : (SvIVX(sv) == I_V(SvNVX(sv))))
2303             SvNOK_on(sv);
2304         else
2305             SvNOKp_on(sv);
2306 #endif
2307     }
2308     else if (SvPOKp(sv) && SvLEN(sv)) {
2309         if (ckWARN(WARN_NUMERIC) && !SvIOKp(sv) && !looks_like_number(sv))
2310             not_a_number(sv);
2311         SvNVX(sv) = Atof(SvPVX(sv));
2312 #ifdef NV_PRESERVES_UV
2313         SvNOK_on(sv);
2314 #else
2315         /* Only set the public NV OK flag if this NV preserves the value in
2316            the PV at least as well as an IV/UV would.
2317            Not sure how to do this 100% reliably. */
2318         /* if that shift count is out of range then Configure's test is
2319            wonky. We shouldn't be in here with NV_PRESERVES_UV_BITS ==
2320            UV_BITS */
2321         if (((UV)1 << NV_PRESERVES_UV_BITS) >
2322             U_V(SvNVX(sv) > 0 ? SvNVX(sv) : -SvNVX(sv)))
2323             SvNOK_on(sv); /* Definitely small enough to preserve all bits */
2324         else if (SvNVX(sv) < (NV)IV_MIN || SvNVX(sv) > (NV)UV_MAX) {
2325                 /* Definitely too large/small to fit in an integer, so no loss
2326                    of precision going to integer in the future via NV */
2327             SvNOK_on(sv);
2328         } else {
2329             /* Is it something we can run through strtol etc (ie no
2330                trailing exponent part)? */
2331             int numtype = looks_like_number(sv);
2332             /* XXX probably should cache this if called above */
2333
2334             if (!(numtype &
2335                   (IS_NUMBER_TO_INT_BY_ATOL | IS_NUMBER_TO_INT_BY_STRTOL))) {
2336                 /* Can't use strtol etc to convert this string, so don't try */
2337                 SvNOK_on(sv);
2338             } else
2339                 sv_2inuv_non_preserve (sv, numtype);
2340         }
2341 #endif /* NV_PRESERVES_UV */
2342     }
2343     else  {
2344         if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing && !(SvFLAGS(sv) & SVs_PADTMP))
2345             report_uninit();
2346         if (SvTYPE(sv) < SVt_NV)
2347             /* Typically the caller expects that sv_any is not NULL now.  */
2348             /* XXX Ilya implies that this is a bug in callers that assume this
2349                and ideally should be fixed.  */
2350             sv_upgrade(sv, SVt_NV);
2351         return 0.0;
2352     }
2353 #if defined(USE_LONG_DOUBLE)
2354     DEBUG_c({
2355         STORE_NUMERIC_LOCAL_SET_STANDARD();
2356         PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2nv(%" PERL_PRIgldbl ")\n",
2357                       PTR2UV(sv), SvNVX(sv));
2358         RESTORE_NUMERIC_LOCAL();
2359     });
2360 #else
2361     DEBUG_c({
2362         STORE_NUMERIC_LOCAL_SET_STANDARD();
2363         PerlIO_printf(Perl_debug_log, "0x%"UVxf" 1nv(%g)\n",
2364                       PTR2UV(sv), SvNVX(sv));
2365         RESTORE_NUMERIC_LOCAL();
2366     });
2367 #endif
2368     return SvNVX(sv);
2369 }
2370
2371 STATIC IV
2372 S_asIV(pTHX_ SV *sv)
2373 {
2374     I32 numtype = looks_like_number(sv);
2375     NV d;
2376
2377     if (numtype & IS_NUMBER_TO_INT_BY_ATOL)
2378         return Atol(SvPVX(sv));
2379     if (!numtype) {
2380         if (ckWARN(WARN_NUMERIC))
2381             not_a_number(sv);
2382     }
2383     d = Atof(SvPVX(sv));
2384     return I_V(d);
2385 }
2386
2387 STATIC UV
2388 S_asUV(pTHX_ SV *sv)
2389 {
2390     I32 numtype = looks_like_number(sv);
2391
2392 #ifdef HAS_STRTOUL
2393     if (numtype & IS_NUMBER_TO_INT_BY_ATOL)
2394         return Strtoul(SvPVX(sv), Null(char**), 10);
2395 #endif
2396     if (!numtype) {
2397         if (ckWARN(WARN_NUMERIC))
2398             not_a_number(sv);
2399     }
2400     return U_V(Atof(SvPVX(sv)));
2401 }
2402
2403 /*
2404  * Returns a combination of (advisory only - can get false negatives)
2405  * IS_NUMBER_TO_INT_BY_ATOL, IS_NUMBER_TO_INT_BY_ATOF
2406  * IS_NUMBER_LONGER_THAN_IV_MAX, IS_NUMBER_AS_LONG_AS_IV_MAX
2407  * IS_NUMBER_NOT_INT, IS_NUMBER_NEG, IS_NUMBER_INFINITY
2408  * 0 if does not look like number.
2409  *
2410  * (atol and strtol stop when they hit a decimal point. strtol will return
2411  * LONG_MAX and LONG_MIN when given out of range values. ANSI says they should
2412  * do this, and vendors have had 11 years to get it right.
2413  * However, will try to make it still work with only atol
2414  *  
2415  * IS_NUMBER_TO_INT_BY_ATOL     123456789 or 123456789.3  definitely < IV_MAX
2416  * IS_NUMBER_TO_INT_BY_STRTOL   123456789 or 123456789.3  if digits = IV_MAX
2417  * IS_NUMBER_TO_INT_BY_ATOF     123456789e0               or >> IV_MAX
2418  * IS_NUMBER_LONGER_THAN_IV_MAX   lots of digits, don't bother with atol
2419  * IS_NUMBER_AS_LONG_AS_IV_MAX    atol might hit LONG_MAX, might not.
2420  * IS_NUMBER_NOT_INT            saw "." or "e"
2421  * IS_NUMBER_NEG
2422  * IS_NUMBER_INFINITY
2423  */
2424
2425 /*
2426 =for apidoc looks_like_number
2427
2428 Test if an the content of an SV looks like a number (or is a
2429 number). C<Inf> and C<Infinity> are treated as numbers (so will not
2430 issue a non-numeric warning), even if your atof() doesn't grok them.
2431
2432 =cut
2433 */
2434
2435 I32
2436 Perl_looks_like_number(pTHX_ SV *sv)
2437 {
2438     register char *s;
2439     register char *send;
2440     register char *sbegin;
2441     register char *nbegin;
2442     I32 numtype = 0;
2443     I32 sawinf  = 0;
2444     STRLEN len;
2445
2446     if (SvPOK(sv)) {
2447         sbegin = SvPVX(sv);
2448         len = SvCUR(sv);
2449     }
2450     else if (SvPOKp(sv))
2451         sbegin = SvPV(sv, len);
2452     else
2453         return 1;
2454     send = sbegin + len;
2455
2456     s = sbegin;
2457     while (isSPACE(*s))
2458         s++;
2459     if (*s == '-') {
2460         s++;
2461         numtype = IS_NUMBER_NEG;
2462     }
2463     else if (*s == '+')
2464         s++;
2465
2466     nbegin = s;
2467     /*
2468      * we return IS_NUMBER_TO_INT_BY_ATOL if the number can converted to 
2469      * integer with atol() without overflow, IS_NUMBER_TO_INT_BY_STRTOL if
2470      * possibly slightly larger than max int, IS_NUMBER_TO_INT_BY_ATOF if you
2471      * will need (int)atof().
2472      */
2473
2474     /* next must be digit or the radix separator or beginning of infinity */
2475     if (isDIGIT(*s)) {
2476         do {
2477             s++;
2478         } while (isDIGIT(*s));
2479
2480         /* Aaargh. long long really is irritating.
2481            In the gospel according to ANSI 1989, it is an axiom that "long"
2482            is the longest integer type, and that if you don't know how long
2483            something is you can cast it to long, and nothing will be lost
2484            (except possibly speed of execution if long is slower than the
2485            type is was).
2486            Now, one can't be sure if the old rules apply, or long long
2487            (or some other newfangled thing) is actually longer than the
2488            (formerly) longest thing.
2489         */
2490         /* This lot will work for 64 bit  *as long as* either
2491            either long is 64 bit
2492            or     we can find both strtol/strtoq and strtoul/strtouq
2493            If not, we really should refuse to let the user use 64 bit IVs
2494            By "64 bit" I really mean IVs that don't get preserved by NVs
2495            It also should work for 128 bit IVs. Can any lend me a machine to
2496            test this?
2497         */
2498         if (s - nbegin > TYPE_DIGITS(UV)) /* Cannot cache ato[ul]() */
2499             numtype |= IS_NUMBER_TO_INT_BY_ATOF | IS_NUMBER_LONGER_THAN_IV_MAX;
2500         else if (s - nbegin < BIT_DIGITS(((sizeof (IV)>sizeof (long))
2501                                           ? sizeof(long) : sizeof (IV))*8-1))
2502             numtype |= IS_NUMBER_TO_INT_BY_ATOL;
2503         else
2504             /* Can't be sure either way. (For 64 bit UV, 63 bit IV is 1 decimal
2505                digit less (IV_MAX=  9223372036854775807,
2506                            UV_MAX= 18446744073709551615) so be cautious  */
2507             numtype |= IS_NUMBER_TO_INT_BY_STRTOL | IS_NUMBER_AS_LONG_AS_IV_MAX;
2508
2509         if (*s == '.'
2510 #ifdef USE_LOCALE_NUMERIC
2511             || IS_NUMERIC_RADIX(*s)
2512 #endif
2513             ) {
2514             s++;
2515             numtype |= IS_NUMBER_NOT_INT;
2516             while (isDIGIT(*s))  /* optional digits after the radix */
2517                 s++;
2518         }
2519     }
2520     else if (*s == '.'
2521 #ifdef USE_LOCALE_NUMERIC
2522             || IS_NUMERIC_RADIX(*s)
2523 #endif
2524             ) {
2525         s++;
2526         numtype |= IS_NUMBER_TO_INT_BY_ATOL | IS_NUMBER_NOT_INT;
2527         /* no digits before the radix means we need digits after it */
2528         if (isDIGIT(*s)) {
2529             do {
2530                 s++;
2531             } while (isDIGIT(*s));
2532         }
2533         else
2534             return 0;
2535     }
2536     else if (*s == 'I' || *s == 'i') {
2537         s++; if (*s != 'N' && *s != 'n') return 0;
2538         s++; if (*s != 'F' && *s != 'f') return 0;
2539         s++; if (*s == 'I' || *s == 'i') {
2540             s++; if (*s != 'N' && *s != 'n') return 0;
2541             s++; if (*s != 'I' && *s != 'i') return 0;
2542             s++; if (*s != 'T' && *s != 't') return 0;
2543             s++; if (*s != 'Y' && *s != 'y') return 0;
2544             s++;
2545         }
2546         sawinf = 1;
2547     }
2548     else
2549         return 0;
2550
2551     if (sawinf)
2552         numtype = (numtype & IS_NUMBER_NEG) /* Keep track of sign  */
2553           | IS_NUMBER_INFINITY | IS_NUMBER_NOT_INT;
2554     else {
2555         /* we can have an optional exponent part */
2556         if (*s == 'e' || *s == 'E') {
2557             numtype &= IS_NUMBER_NEG;
2558             numtype |= IS_NUMBER_TO_INT_BY_ATOF | IS_NUMBER_NOT_INT;
2559             s++;
2560             if (*s == '+' || *s == '-')
2561                 s++;
2562             if (isDIGIT(*s)) {
2563                 do {
2564                     s++;
2565                 } while (isDIGIT(*s));
2566             }
2567             else
2568                 return 0;
2569         }
2570     }
2571     while (isSPACE(*s))
2572         s++;
2573     if (s >= send)
2574         return numtype;
2575     if (len == 10 && memEQ(sbegin, "0 but true", 10))
2576         return IS_NUMBER_TO_INT_BY_ATOL;
2577     return 0;
2578 }
2579
2580 char *
2581 Perl_sv_2pv_nolen(pTHX_ register SV *sv)
2582 {
2583     STRLEN n_a;
2584     return sv_2pv(sv, &n_a);
2585 }
2586
2587 /* We assume that buf is at least TYPE_CHARS(UV) long. */
2588 static char *
2589 uiv_2buf(char *buf, IV iv, UV uv, int is_uv, char **peob)
2590 {
2591     char *ptr = buf + TYPE_CHARS(UV);
2592     char *ebuf = ptr;
2593     int sign;
2594
2595     if (is_uv)
2596         sign = 0;
2597     else if (iv >= 0) {
2598         uv = iv;
2599         sign = 0;
2600     } else {
2601         uv = -iv;
2602         sign = 1;
2603     }
2604     do {
2605         *--ptr = '0' + (uv % 10);
2606     } while (uv /= 10);
2607     if (sign)
2608         *--ptr = '-';
2609     *peob = ebuf;
2610     return ptr;
2611 }
2612
2613 char *
2614 Perl_sv_2pv(pTHX_ register SV *sv, STRLEN *lp)
2615 {
2616     register char *s;
2617     int olderrno;
2618     SV *tsv;
2619     char tbuf[64];      /* Must fit sprintf/Gconvert of longest IV/NV */
2620     char *tmpbuf = tbuf;
2621
2622     if (!sv) {
2623         *lp = 0;
2624         return "";
2625     }
2626     if (SvGMAGICAL(sv)) {
2627         mg_get(sv);
2628         if (SvPOKp(sv)) {
2629             *lp = SvCUR(sv);
2630             return SvPVX(sv);
2631         }
2632         if (SvIOKp(sv)) {
2633             if (SvIsUV(sv))
2634                 (void)sprintf(tmpbuf,"%"UVuf, (UV)SvUVX(sv));
2635             else
2636                 (void)sprintf(tmpbuf,"%"IVdf, (IV)SvIVX(sv));
2637             tsv = Nullsv;
2638             goto tokensave;
2639         }
2640         if (SvNOKp(sv)) {
2641             Gconvert(SvNVX(sv), NV_DIG, 0, tmpbuf);
2642             tsv = Nullsv;
2643             goto tokensave;
2644         }
2645         if (!SvROK(sv)) {
2646             if (!(SvFLAGS(sv) & SVs_PADTMP)) {
2647                 if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
2648                     report_uninit();
2649             }
2650             *lp = 0;
2651             return "";
2652         }
2653     }
2654     if (SvTHINKFIRST(sv)) {
2655         if (SvROK(sv)) {
2656             SV* tmpstr;
2657             if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv,string)) &&
2658                     (SvRV(tmpstr) != SvRV(sv)))
2659                 return SvPV(tmpstr,*lp);
2660             sv = (SV*)SvRV(sv);
2661             if (!sv)
2662                 s = "NULLREF";
2663             else {
2664                 MAGIC *mg;
2665                 
2666                 switch (SvTYPE(sv)) {
2667                 case SVt_PVMG:
2668                     if ( ((SvFLAGS(sv) &
2669                            (SVs_OBJECT|SVf_OK|SVs_GMG|SVs_SMG|SVs_RMG))
2670                           == (SVs_OBJECT|SVs_RMG))
2671                          && strEQ(s=HvNAME(SvSTASH(sv)), "Regexp")
2672                          && (mg = mg_find(sv, 'r'))) {
2673                         regexp *re = (regexp *)mg->mg_obj;
2674
2675                         if (!mg->mg_ptr) {
2676                             char *fptr = "msix";
2677                             char reflags[6];
2678                             char ch;
2679                             int left = 0;
2680                             int right = 4;
2681                             U16 reganch = (re->reganch & PMf_COMPILETIME) >> 12;
2682
2683                             while((ch = *fptr++)) {
2684                                 if(reganch & 1) {
2685                                     reflags[left++] = ch;
2686                                 }
2687                                 else {
2688                                     reflags[right--] = ch;
2689                                 }
2690                                 reganch >>= 1;
2691                             }
2692                             if(left != 4) {
2693                                 reflags[left] = '-';
2694                                 left = 5;
2695                             }
2696
2697                             mg->mg_len = re->prelen + 4 + left;
2698                             New(616, mg->mg_ptr, mg->mg_len + 1 + left, char);
2699                             Copy("(?", mg->mg_ptr, 2, char);
2700                             Copy(reflags, mg->mg_ptr+2, left, char);
2701                             Copy(":", mg->mg_ptr+left+2, 1, char);
2702                             Copy(re->precomp, mg->mg_ptr+3+left, re->prelen, char);
2703                             mg->mg_ptr[mg->mg_len - 1] = ')';
2704                             mg->mg_ptr[mg->mg_len] = 0;
2705                         }
2706                         PL_reginterp_cnt += re->program[0].next_off;
2707                         *lp = mg->mg_len;
2708                         return mg->mg_ptr;
2709                     }
2710                                         /* Fall through */
2711                 case SVt_NULL:
2712                 case SVt_IV:
2713                 case SVt_NV:
2714                 case SVt_RV:
2715                 case SVt_PV:
2716                 case SVt_PVIV:
2717                 case SVt_PVNV:
2718                 case SVt_PVBM:  if (SvROK(sv))
2719                                     s = "REF";
2720                                 else
2721                                     s = "SCALAR";               break;
2722                 case SVt_PVLV:  s = "LVALUE";                   break;
2723                 case SVt_PVAV:  s = "ARRAY";                    break;
2724                 case SVt_PVHV:  s = "HASH";                     break;
2725                 case SVt_PVCV:  s = "CODE";                     break;
2726                 case SVt_PVGV:  s = "GLOB";                     break;
2727                 case SVt_PVFM:  s = "FORMAT";                   break;
2728                 case SVt_PVIO:  s = "IO";                       break;
2729                 default:        s = "UNKNOWN";                  break;
2730                 }
2731                 tsv = NEWSV(0,0);
2732                 if (SvOBJECT(sv))
2733                     Perl_sv_setpvf(aTHX_ tsv, "%s=%s", HvNAME(SvSTASH(sv)), s);
2734                 else
2735                     sv_setpv(tsv, s);
2736                 Perl_sv_catpvf(aTHX_ tsv, "(0x%"UVxf")", PTR2UV(sv));
2737                 goto tokensaveref;
2738             }
2739             *lp = strlen(s);
2740             return s;
2741         }
2742         if (SvREADONLY(sv) && !SvOK(sv)) {
2743             if (ckWARN(WARN_UNINITIALIZED))
2744                 report_uninit();
2745             *lp = 0;
2746             return "";
2747         }
2748     }
2749     if (SvIOK(sv) || ((SvIOKp(sv) && !SvNOKp(sv)))) {
2750         /* I'm assuming that if both IV and NV are equally valid then
2751            converting the IV is going to be more efficient */
2752         U32 isIOK = SvIOK(sv);
2753         U32 isUIOK = SvIsUV(sv);
2754         char buf[TYPE_CHARS(UV)];
2755         char *ebuf, *ptr;
2756
2757         if (SvTYPE(sv) < SVt_PVIV)
2758             sv_upgrade(sv, SVt_PVIV);
2759         if (isUIOK)
2760             ptr = uiv_2buf(buf, 0, SvUVX(sv), 1, &ebuf);
2761         else
2762             ptr = uiv_2buf(buf, SvIVX(sv), 0, 0, &ebuf);
2763         SvGROW(sv, ebuf - ptr + 1);     /* inlined from sv_setpvn */
2764         Move(ptr,SvPVX(sv),ebuf - ptr,char);
2765         SvCUR_set(sv, ebuf - ptr);
2766         s = SvEND(sv);
2767         *s = '\0';
2768         if (isIOK)
2769             SvIOK_on(sv);
2770         else
2771             SvIOKp_on(sv);
2772         if (isUIOK)
2773             SvIsUV_on(sv);
2774     }
2775     else if (SvNOKp(sv)) {
2776         if (SvTYPE(sv) < SVt_PVNV)
2777             sv_upgrade(sv, SVt_PVNV);
2778         /* The +20 is pure guesswork.  Configure test needed. --jhi */
2779         SvGROW(sv, NV_DIG + 20);
2780         s = SvPVX(sv);
2781         olderrno = errno;       /* some Xenix systems wipe out errno here */
2782 #ifdef apollo
2783         if (SvNVX(sv) == 0.0)
2784             (void)strcpy(s,"0");
2785         else
2786 #endif /*apollo*/
2787         {
2788             Gconvert(SvNVX(sv), NV_DIG, 0, s);
2789         }
2790         errno = olderrno;
2791 #ifdef FIXNEGATIVEZERO
2792         if (*s == '-' && s[1] == '0' && !s[2])
2793             strcpy(s,"0");
2794 #endif
2795         while (*s) s++;
2796 #ifdef hcx
2797         if (s[-1] == '.')
2798             *--s = '\0';
2799 #endif
2800     }
2801     else {
2802         if (ckWARN(WARN_UNINITIALIZED)
2803             && !PL_localizing && !(SvFLAGS(sv) & SVs_PADTMP))
2804             report_uninit();
2805         *lp = 0;
2806         if (SvTYPE(sv) < SVt_PV)
2807             /* Typically the caller expects that sv_any is not NULL now.  */
2808             sv_upgrade(sv, SVt_PV);
2809         return "";
2810     }
2811     *lp = s - SvPVX(sv);
2812     SvCUR_set(sv, *lp);
2813     SvPOK_on(sv);
2814     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2pv(%s)\n",
2815                           PTR2UV(sv),SvPVX(sv)));
2816     return SvPVX(sv);
2817
2818   tokensave:
2819     if (SvROK(sv)) {    /* XXX Skip this when sv_pvn_force calls */
2820         /* Sneaky stuff here */
2821
2822       tokensaveref:
2823         if (!tsv)
2824             tsv = newSVpv(tmpbuf, 0);
2825         sv_2mortal(tsv);
2826         *lp = SvCUR(tsv);
2827         return SvPVX(tsv);
2828     }
2829     else {
2830         STRLEN len;
2831         char *t;
2832
2833         if (tsv) {
2834             sv_2mortal(tsv);
2835             t = SvPVX(tsv);
2836             len = SvCUR(tsv);
2837         }
2838         else {
2839             t = tmpbuf;
2840             len = strlen(tmpbuf);
2841         }
2842 #ifdef FIXNEGATIVEZERO
2843         if (len == 2 && t[0] == '-' && t[1] == '0') {
2844             t = "0";
2845             len = 1;
2846         }
2847 #endif
2848         (void)SvUPGRADE(sv, SVt_PV);
2849         *lp = len;
2850         s = SvGROW(sv, len + 1);
2851         SvCUR_set(sv, len);
2852         (void)strcpy(s, t);
2853         SvPOKp_on(sv);
2854         return s;
2855     }
2856 }
2857
2858 char *
2859 Perl_sv_2pvbyte_nolen(pTHX_ register SV *sv)
2860 {
2861     STRLEN n_a;
2862     return sv_2pvbyte(sv, &n_a);
2863 }
2864
2865 char *
2866 Perl_sv_2pvbyte(pTHX_ register SV *sv, STRLEN *lp)
2867 {
2868     return sv_2pv(sv,lp);
2869 }
2870
2871 char *
2872 Perl_sv_2pvutf8_nolen(pTHX_ register SV *sv)
2873 {
2874     STRLEN n_a;
2875     return sv_2pvutf8(sv, &n_a);
2876 }
2877
2878 char *
2879 Perl_sv_2pvutf8(pTHX_ register SV *sv, STRLEN *lp)
2880 {
2881     sv_utf8_upgrade(sv);
2882     return SvPV(sv,*lp);
2883 }
2884
2885 /* This function is only called on magical items */
2886 bool
2887 Perl_sv_2bool(pTHX_ register SV *sv)
2888 {
2889     if (SvGMAGICAL(sv))
2890         mg_get(sv);
2891
2892     if (!SvOK(sv))
2893         return 0;
2894     if (SvROK(sv)) {
2895         SV* tmpsv;
2896         if (SvAMAGIC(sv) && (tmpsv=AMG_CALLun(sv,bool_)) &&
2897                 (SvRV(tmpsv) != SvRV(sv)))
2898             return SvTRUE(tmpsv);
2899       return SvRV(sv) != 0;
2900     }
2901     if (SvPOKp(sv)) {
2902         register XPV* Xpvtmp;
2903         if ((Xpvtmp = (XPV*)SvANY(sv)) &&
2904                 (*Xpvtmp->xpv_pv > '0' ||
2905                 Xpvtmp->xpv_cur > 1 ||
2906                 (Xpvtmp->xpv_cur && *Xpvtmp->xpv_pv != '0')))
2907             return 1;
2908         else
2909             return 0;
2910     }
2911     else {
2912         if (SvIOKp(sv))
2913             return SvIVX(sv) != 0;
2914         else {
2915             if (SvNOKp(sv))
2916                 return SvNVX(sv) != 0.0;
2917             else
2918                 return FALSE;
2919         }
2920     }
2921 }
2922
2923 /*
2924 =for apidoc sv_utf8_upgrade
2925
2926 Convert the PV of an SV to its UTF8-encoded form.
2927
2928 =cut
2929 */
2930
2931 void
2932 Perl_sv_utf8_upgrade(pTHX_ register SV *sv)
2933 {
2934     char *s, *t, *e;
2935     int  hibit = 0;
2936
2937     if (!sv || !SvPOK(sv) || SvUTF8(sv))
2938         return;
2939
2940     /* This function could be much more efficient if we had a FLAG in SVs
2941      * to signal if there are any hibit chars in the PV.
2942      * Given that there isn't make loop fast as possible
2943      */
2944     s = SvPVX(sv);
2945     e = SvEND(sv);
2946     t = s;
2947     while (t < e) {
2948         if ((hibit = UTF8_IS_CONTINUED(*t++)))
2949             break;
2950     }
2951
2952     if (hibit) {
2953         STRLEN len;
2954         if (SvREADONLY(sv) && SvFAKE(sv)) {
2955             sv_force_normal(sv);
2956             s = SvPVX(sv);
2957         }
2958         len = SvCUR(sv) + 1; /* Plus the \0 */
2959         SvPVX(sv) = (char*)bytes_to_utf8((U8*)s, &len);
2960         SvCUR(sv) = len - 1;
2961         if (SvLEN(sv) != 0)
2962             Safefree(s); /* No longer using what was there before. */
2963         SvLEN(sv) = len; /* No longer know the real size. */
2964         SvUTF8_on(sv);
2965     }
2966 }
2967
2968 /*
2969 =for apidoc sv_utf8_downgrade
2970
2971 Attempt to convert the PV of an SV from UTF8-encoded to byte encoding.
2972 This may not be possible if the PV contains non-byte encoding characters;
2973 if this is the case, either returns false or, if C<fail_ok> is not
2974 true, croaks.
2975
2976 =cut
2977 */
2978
2979 bool
2980 Perl_sv_utf8_downgrade(pTHX_ register SV* sv, bool fail_ok)
2981 {
2982     if (SvPOK(sv) && SvUTF8(sv)) {
2983         if (SvCUR(sv)) {
2984             char *c = SvPVX(sv);
2985             STRLEN len = SvCUR(sv);
2986
2987             if (!utf8_to_bytes((U8*)c, &len)) {
2988                 if (fail_ok)
2989                     return FALSE;
2990                 else {
2991                     if (PL_op)
2992                         Perl_croak(aTHX_ "Wide character in %s",
2993                                    PL_op_desc[PL_op->op_type]);
2994                     else
2995                         Perl_croak(aTHX_ "Wide character");
2996                 }
2997             }
2998             SvCUR(sv) = len;
2999         }
3000         SvUTF8_off(sv);
3001     }
3002
3003     return TRUE;
3004 }
3005
3006 /*
3007 =for apidoc sv_utf8_encode
3008
3009 Convert the PV of an SV to UTF8-encoded, but then turn off the C<SvUTF8>
3010 flag so that it looks like bytes again. Nothing calls this.
3011
3012 =cut
3013 */
3014
3015 void
3016 Perl_sv_utf8_encode(pTHX_ register SV *sv)
3017 {
3018     sv_utf8_upgrade(sv);
3019     SvUTF8_off(sv);
3020 }
3021
3022 bool
3023 Perl_sv_utf8_decode(pTHX_ register SV *sv)
3024 {
3025     if (SvPOK(sv)) {
3026         char *c;
3027         char *e;
3028         bool has_utf = FALSE;
3029         if (!sv_utf8_downgrade(sv, TRUE))
3030             return FALSE;
3031
3032         /* it is actually just a matter of turning the utf8 flag on, but
3033          * we want to make sure everything inside is valid utf8 first.
3034          */
3035         c = SvPVX(sv);
3036         if (!is_utf8_string((U8*)c, SvCUR(sv)+1))
3037             return FALSE;
3038         e = SvEND(sv);
3039         while (c < e) {
3040             if (UTF8_IS_CONTINUED(*c++)) {
3041                 SvUTF8_on(sv);
3042                 break;
3043             }
3044         }
3045     }
3046     return TRUE;
3047 }
3048
3049
3050 /* Note: sv_setsv() should not be called with a source string that needs
3051  * to be reused, since it may destroy the source string if it is marked
3052  * as temporary.
3053  */
3054
3055 /*
3056 =for apidoc sv_setsv
3057
3058 Copies the contents of the source SV C<ssv> into the destination SV C<dsv>.
3059 The source SV may be destroyed if it is mortal.  Does not handle 'set'
3060 magic.  See the macro forms C<SvSetSV>, C<SvSetSV_nosteal> and
3061 C<sv_setsv_mg>.
3062
3063 =cut
3064 */
3065
3066 void
3067 Perl_sv_setsv(pTHX_ SV *dstr, register SV *sstr)
3068 {
3069     register U32 sflags;
3070     register int dtype;
3071     register int stype;
3072
3073     if (sstr == dstr)
3074         return;
3075     SV_CHECK_THINKFIRST(dstr);
3076     if (!sstr)
3077         sstr = &PL_sv_undef;
3078     stype = SvTYPE(sstr);
3079     dtype = SvTYPE(dstr);
3080
3081     SvAMAGIC_off(dstr);
3082
3083     /* There's a lot of redundancy below but we're going for speed here */
3084
3085     switch (stype) {
3086     case SVt_NULL:
3087       undef_sstr:
3088         if (dtype != SVt_PVGV) {
3089             (void)SvOK_off(dstr);
3090             return;
3091         }
3092         break;
3093     case SVt_IV:
3094         if (SvIOK(sstr)) {
3095             switch (dtype) {
3096             case SVt_NULL:
3097                 sv_upgrade(dstr, SVt_IV);
3098                 break;
3099             case SVt_NV:
3100                 sv_upgrade(dstr, SVt_PVNV);
3101                 break;
3102             case SVt_RV:
3103             case SVt_PV:
3104                 sv_upgrade(dstr, SVt_PVIV);
3105                 break;
3106             }
3107             (void)SvIOK_only(dstr);
3108             SvIVX(dstr) = SvIVX(sstr);
3109             if (SvIsUV(sstr))
3110                 SvIsUV_on(dstr);
3111             if (SvTAINTED(sstr))
3112                 SvTAINT(dstr);
3113             return;
3114         }
3115         goto undef_sstr;
3116
3117     case SVt_NV:
3118         if (SvNOK(sstr)) {
3119             switch (dtype) {
3120             case SVt_NULL:
3121             case SVt_IV:
3122                 sv_upgrade(dstr, SVt_NV);
3123                 break;
3124             case SVt_RV:
3125             case SVt_PV:
3126             case SVt_PVIV:
3127                 sv_upgrade(dstr, SVt_PVNV);
3128                 break;
3129             }
3130             SvNVX(dstr) = SvNVX(sstr);
3131             (void)SvNOK_only(dstr);
3132             if (SvTAINTED(sstr))
3133                 SvTAINT(dstr);
3134             return;
3135         }
3136         goto undef_sstr;
3137
3138     case SVt_RV:
3139         if (dtype < SVt_RV)
3140             sv_upgrade(dstr, SVt_RV);
3141         else if (dtype == SVt_PVGV &&
3142                  SvTYPE(SvRV(sstr)) == SVt_PVGV) {
3143             sstr = SvRV(sstr);
3144             if (sstr == dstr) {
3145                 if (GvIMPORTED(dstr) != GVf_IMPORTED
3146                     && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
3147                 {
3148                     GvIMPORTED_on(dstr);
3149                 }
3150                 GvMULTI_on(dstr);
3151                 return;
3152             }
3153             goto glob_assign;
3154         }
3155         break;
3156     case SVt_PV:
3157     case SVt_PVFM:
3158         if (dtype < SVt_PV)
3159             sv_upgrade(dstr, SVt_PV);
3160         break;
3161     case SVt_PVIV:
3162         if (dtype < SVt_PVIV)
3163             sv_upgrade(dstr, SVt_PVIV);
3164         break;
3165     case SVt_PVNV:
3166         if (dtype < SVt_PVNV)
3167             sv_upgrade(dstr, SVt_PVNV);
3168         break;
3169     case SVt_PVAV:
3170     case SVt_PVHV:
3171     case SVt_PVCV:
3172     case SVt_PVIO:
3173         if (PL_op)
3174             Perl_croak(aTHX_ "Bizarre copy of %s in %s", sv_reftype(sstr, 0),
3175                 PL_op_name[PL_op->op_type]);
3176         else
3177             Perl_croak(aTHX_ "Bizarre copy of %s", sv_reftype(sstr, 0));
3178         break;
3179
3180     case SVt_PVGV:
3181         if (dtype <= SVt_PVGV) {
3182   glob_assign:
3183             if (dtype != SVt_PVGV) {
3184                 char *name = GvNAME(sstr);
3185                 STRLEN len = GvNAMELEN(sstr);
3186                 sv_upgrade(dstr, SVt_PVGV);
3187                 sv_magic(dstr, dstr, '*', Nullch, 0);
3188                 GvSTASH(dstr) = (HV*)SvREFCNT_inc(GvSTASH(sstr));
3189                 GvNAME(dstr) = savepvn(name, len);
3190                 GvNAMELEN(dstr) = len;
3191                 SvFAKE_on(dstr);        /* can coerce to non-glob */
3192             }
3193             /* ahem, death to those who redefine active sort subs */
3194             else if (PL_curstackinfo->si_type == PERLSI_SORT
3195                      && GvCV(dstr) && PL_sortcop == CvSTART(GvCV(dstr)))
3196                 Perl_croak(aTHX_ "Can't redefine active sort subroutine %s",
3197                       GvNAME(dstr));
3198             (void)SvOK_off(dstr);
3199             GvINTRO_off(dstr);          /* one-shot flag */
3200             gp_free((GV*)dstr);
3201             GvGP(dstr) = gp_ref(GvGP(sstr));
3202             if (SvTAINTED(sstr))
3203                 SvTAINT(dstr);
3204             if (GvIMPORTED(dstr) != GVf_IMPORTED
3205                 && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
3206             {
3207                 GvIMPORTED_on(dstr);
3208             }
3209             GvMULTI_on(dstr);
3210             return;
3211         }
3212         /* FALL THROUGH */
3213
3214     default:
3215         if (SvGMAGICAL(sstr)) {
3216             mg_get(sstr);
3217             if (SvTYPE(sstr) != stype) {
3218                 stype = SvTYPE(sstr);
3219                 if (stype == SVt_PVGV && dtype <= SVt_PVGV)
3220                     goto glob_assign;
3221             }
3222         }
3223         if (stype == SVt_PVLV)
3224             (void)SvUPGRADE(dstr, SVt_PVNV);
3225         else
3226             (void)SvUPGRADE(dstr, stype);
3227     }
3228
3229     sflags = SvFLAGS(sstr);
3230
3231     if (sflags & SVf_ROK) {
3232         if (dtype >= SVt_PV) {
3233             if (dtype == SVt_PVGV) {
3234                 SV *sref = SvREFCNT_inc(SvRV(sstr));
3235                 SV *dref = 0;
3236                 int intro = GvINTRO(dstr);
3237
3238                 if (intro) {
3239                     GP *gp;
3240                     gp_free((GV*)dstr);
3241                     GvINTRO_off(dstr);  /* one-shot flag */
3242                     Newz(602,gp, 1, GP);
3243                     GvGP(dstr) = gp_ref(gp);
3244                     GvSV(dstr) = NEWSV(72,0);
3245                     GvLINE(dstr) = CopLINE(PL_curcop);
3246                     GvEGV(dstr) = (GV*)dstr;
3247                 }
3248                 GvMULTI_on(dstr);
3249                 switch (SvTYPE(sref)) {
3250                 case SVt_PVAV:
3251                     if (intro)
3252                         SAVESPTR(GvAV(dstr));
3253                     else
3254                         dref = (SV*)GvAV(dstr);
3255                     GvAV(dstr) = (AV*)sref;
3256                     if (!GvIMPORTED_AV(dstr)
3257                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
3258                     {
3259                         GvIMPORTED_AV_on(dstr);
3260                     }
3261                     break;
3262                 case SVt_PVHV:
3263                     if (intro)
3264                         SAVESPTR(GvHV(dstr));
3265                     else
3266                         dref = (SV*)GvHV(dstr);
3267                     GvHV(dstr) = (HV*)sref;
3268                     if (!GvIMPORTED_HV(dstr)
3269                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
3270                     {
3271                         GvIMPORTED_HV_on(dstr);
3272                     }
3273                     break;
3274                 case SVt_PVCV:
3275                     if (intro) {
3276                         if (GvCVGEN(dstr) && GvCV(dstr) != (CV*)sref) {
3277                             SvREFCNT_dec(GvCV(dstr));
3278                             GvCV(dstr) = Nullcv;
3279                             GvCVGEN(dstr) = 0; /* Switch off cacheness. */
3280                             PL_sub_generation++;
3281                         }
3282                         SAVESPTR(GvCV(dstr));
3283                     }
3284                     else
3285                         dref = (SV*)GvCV(dstr);
3286                     if (GvCV(dstr) != (CV*)sref) {
3287                         CV* cv = GvCV(dstr);
3288                         if (cv) {
3289                             if (!GvCVGEN((GV*)dstr) &&
3290                                 (CvROOT(cv) || CvXSUB(cv)))
3291                             {
3292                                 SV *const_sv;
3293                                 /* ahem, death to those who redefine
3294                                  * active sort subs */
3295                                 if (PL_curstackinfo->si_type == PERLSI_SORT &&
3296                                       PL_sortcop == CvSTART(cv))
3297                                     Perl_croak(aTHX_
3298                                     "Can't redefine active sort subroutine %s",
3299                                           GvENAME((GV*)dstr));
3300                                 /* Redefining a sub - warning is mandatory if
3301                                    it was a const and its value changed. */
3302                                 if (ckWARN(WARN_REDEFINE)
3303                                     || (CvCONST(cv)
3304                                         && (!CvCONST((CV*)sref)
3305                                             || sv_cmp(cv_const_sv(cv),
3306                                                       cv_const_sv((CV*)sref)))))
3307                                 {
3308                                     Perl_warner(aTHX_ WARN_REDEFINE,
3309                                         CvCONST(cv)
3310                                         ? "Constant subroutine %s redefined"
3311                                         : "Subroutine %s redefined",
3312                                         GvENAME((GV*)dstr));
3313                                 }
3314                             }
3315                             cv_ckproto(cv, (GV*)dstr,
3316                                        SvPOK(sref) ? SvPVX(sref) : Nullch);
3317                         }
3318                         GvCV(dstr) = (CV*)sref;
3319                         GvCVGEN(dstr) = 0; /* Switch off cacheness. */
3320                         GvASSUMECV_on(dstr);
3321                         PL_sub_generation++;
3322                     }
3323                     if (!GvIMPORTED_CV(dstr)
3324                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
3325                     {
3326                         GvIMPORTED_CV_on(dstr);
3327                     }
3328                     break;
3329                 case SVt_PVIO:
3330                     if (intro)
3331                         SAVESPTR(GvIOp(dstr));
3332                     else
3333                         dref = (SV*)GvIOp(dstr);
3334                     GvIOp(dstr) = (IO*)sref;
3335                     break;
3336                 case SVt_PVFM:
3337                     if (intro)
3338                         SAVESPTR(GvFORM(dstr));
3339                     else
3340                         dref = (SV*)GvFORM(dstr);
3341                     GvFORM(dstr) = (CV*)sref;
3342                     break;
3343                 default:
3344                     if (intro)
3345                         SAVESPTR(GvSV(dstr));
3346                     else
3347                         dref = (SV*)GvSV(dstr);
3348                     GvSV(dstr) = sref;
3349                     if (!GvIMPORTED_SV(dstr)
3350                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
3351                     {
3352                         GvIMPORTED_SV_on(dstr);
3353                     }
3354                     break;
3355                 }
3356                 if (dref)
3357                     SvREFCNT_dec(dref);
3358                 if (intro)
3359                     SAVEFREESV(sref);
3360                 if (SvTAINTED(sstr))
3361                     SvTAINT(dstr);
3362                 return;
3363             }
3364             if (SvPVX(dstr)) {
3365                 (void)SvOOK_off(dstr);          /* backoff */
3366                 if (SvLEN(dstr))
3367                     Safefree(SvPVX(dstr));
3368                 SvLEN(dstr)=SvCUR(dstr)=0;
3369             }
3370         }
3371         (void)SvOK_off(dstr);
3372         SvRV(dstr) = SvREFCNT_inc(SvRV(sstr));
3373         SvROK_on(dstr);
3374         if (sflags & SVp_NOK) {
3375             SvNOK_on(dstr);
3376             SvNVX(dstr) = SvNVX(sstr);
3377         }
3378         if (sflags & SVp_IOK) {
3379             (void)SvIOK_on(dstr);
3380             SvIVX(dstr) = SvIVX(sstr);
3381             if (sflags & SVf_IVisUV)
3382                 SvIsUV_on(dstr);
3383         }
3384         if (SvAMAGIC(sstr)) {
3385             SvAMAGIC_on(dstr);
3386         }
3387     }
3388     else if (sflags & SVp_POK) {
3389
3390         /*
3391          * Check to see if we can just swipe the string.  If so, it's a
3392          * possible small lose on short strings, but a big win on long ones.
3393          * It might even be a win on short strings if SvPVX(dstr)
3394          * has to be allocated and SvPVX(sstr) has to be freed.
3395          */
3396
3397         if (SvTEMP(sstr) &&             /* slated for free anyway? */
3398             SvREFCNT(sstr) == 1 &&      /* and no other references to it? */
3399             !(sflags & SVf_OOK) &&      /* and not involved in OOK hack? */
3400             SvLEN(sstr)         &&      /* and really is a string */
3401             !(PL_op && PL_op->op_type == OP_AASSIGN)) /* and won't be needed again, potentially */
3402         {
3403             if (SvPVX(dstr)) {          /* we know that dtype >= SVt_PV */
3404                 if (SvOOK(dstr)) {
3405                     SvFLAGS(dstr) &= ~SVf_OOK;
3406                     Safefree(SvPVX(dstr) - SvIVX(dstr));
3407                 }
3408                 else if (SvLEN(dstr))
3409                     Safefree(SvPVX(dstr));
3410             }
3411             (void)SvPOK_only(dstr);
3412             SvPV_set(dstr, SvPVX(sstr));
3413             SvLEN_set(dstr, SvLEN(sstr));
3414             SvCUR_set(dstr, SvCUR(sstr));
3415
3416             SvTEMP_off(dstr);
3417             (void)SvOK_off(sstr);               /* NOTE: nukes most SvFLAGS on sstr */
3418             SvPV_set(sstr, Nullch);
3419             SvLEN_set(sstr, 0);
3420             SvCUR_set(sstr, 0);
3421             SvTEMP_off(sstr);
3422         }
3423         else {                                  /* have to copy actual string */
3424             STRLEN len = SvCUR(sstr);
3425
3426             SvGROW(dstr, len + 1);              /* inlined from sv_setpvn */
3427             Move(SvPVX(sstr),SvPVX(dstr),len,char);
3428             SvCUR_set(dstr, len);
3429             *SvEND(dstr) = '\0';
3430             (void)SvPOK_only(dstr);
3431         }
3432         if ((sflags & SVf_UTF8) && !IN_BYTE)
3433             SvUTF8_on(dstr);
3434         /*SUPPRESS 560*/
3435         if (sflags & SVp_NOK) {
3436             SvNOK_on(dstr);
3437             SvNVX(dstr) = SvNVX(sstr);
3438         }
3439         if (sflags & SVp_IOK) {
3440             (void)SvIOK_on(dstr);
3441             SvIVX(dstr) = SvIVX(sstr);
3442             if (sflags & SVf_IVisUV)
3443                 SvIsUV_on(dstr);
3444         }
3445     }
3446     else if (sflags & SVp_NOK) {
3447         SvNVX(dstr) = SvNVX(sstr);
3448         (void)SvNOK_only(dstr);
3449         if (sflags & SVf_IOK) {
3450             (void)SvIOK_on(dstr);
3451             SvIVX(dstr) = SvIVX(sstr);
3452             /* XXXX Do we want to set IsUV for IV(ROK)?  Be extra safe... */
3453             if (sflags & SVf_IVisUV)
3454                 SvIsUV_on(dstr);
3455         }
3456     }
3457     else if (sflags & SVp_IOK) {
3458         (void)SvIOK_only(dstr);
3459         SvIVX(dstr) = SvIVX(sstr);
3460         if (sflags & SVf_IVisUV)
3461             SvIsUV_on(dstr);
3462     }
3463     else {
3464         if (dtype == SVt_PVGV) {
3465             if (ckWARN(WARN_MISC))
3466                 Perl_warner(aTHX_ WARN_MISC, "Undefined value assigned to typeglob");
3467         }
3468         else
3469             (void)SvOK_off(dstr);
3470     }
3471     if (SvTAINTED(sstr))
3472         SvTAINT(dstr);
3473 }
3474
3475 /*
3476 =for apidoc sv_setsv_mg
3477
3478 Like C<sv_setsv>, but also handles 'set' magic.
3479
3480 =cut
3481 */
3482
3483 void
3484 Perl_sv_setsv_mg(pTHX_ SV *dstr, register SV *sstr)
3485 {
3486     sv_setsv(dstr,sstr);
3487     SvSETMAGIC(dstr);
3488 }
3489
3490 /*
3491 =for apidoc sv_setpvn
3492
3493 Copies a string into an SV.  The C<len> parameter indicates the number of
3494 bytes to be copied.  Does not handle 'set' magic.  See C<sv_setpvn_mg>.
3495
3496 =cut
3497 */
3498
3499 void
3500 Perl_sv_setpvn(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3501 {
3502     register char *dptr;
3503     {
3504         /* len is STRLEN which is unsigned, need to copy to signed */
3505         IV iv = len;
3506         assert(iv >= 0);
3507     }
3508     SV_CHECK_THINKFIRST(sv);
3509     if (!ptr) {
3510         (void)SvOK_off(sv);
3511         return;
3512     }
3513     (void)SvUPGRADE(sv, SVt_PV);
3514
3515     SvGROW(sv, len + 1);
3516     dptr = SvPVX(sv);
3517     Move(ptr,dptr,len,char);
3518     dptr[len] = '\0';
3519     SvCUR_set(sv, len);
3520     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3521     SvTAINT(sv);
3522 }
3523
3524 /*
3525 =for apidoc sv_setpvn_mg
3526
3527 Like C<sv_setpvn>, but also handles 'set' magic.
3528
3529 =cut
3530 */
3531
3532 void
3533 Perl_sv_setpvn_mg(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3534 {
3535     sv_setpvn(sv,ptr,len);
3536     SvSETMAGIC(sv);
3537 }
3538
3539 /*
3540 =for apidoc sv_setpv
3541
3542 Copies a string into an SV.  The string must be null-terminated.  Does not
3543 handle 'set' magic.  See C<sv_setpv_mg>.
3544
3545 =cut
3546 */
3547
3548 void
3549 Perl_sv_setpv(pTHX_ register SV *sv, register const char *ptr)
3550 {
3551     register STRLEN len;
3552
3553     SV_CHECK_THINKFIRST(sv);
3554     if (!ptr) {
3555         (void)SvOK_off(sv);
3556         return;
3557     }
3558     len = strlen(ptr);
3559     (void)SvUPGRADE(sv, SVt_PV);
3560
3561     SvGROW(sv, len + 1);
3562     Move(ptr,SvPVX(sv),len+1,char);
3563     SvCUR_set(sv, len);
3564     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3565     SvTAINT(sv);
3566 }
3567
3568 /*
3569 =for apidoc sv_setpv_mg
3570
3571 Like C<sv_setpv>, but also handles 'set' magic.
3572
3573 =cut
3574 */
3575
3576 void
3577 Perl_sv_setpv_mg(pTHX_ register SV *sv, register const char *ptr)
3578 {
3579     sv_setpv(sv,ptr);
3580     SvSETMAGIC(sv);
3581 }
3582
3583 /*
3584 =for apidoc sv_usepvn
3585
3586 Tells an SV to use C<ptr> to find its string value.  Normally the string is
3587 stored inside the SV but sv_usepvn allows the SV to use an outside string.
3588 The C<ptr> should point to memory that was allocated by C<malloc>.  The
3589 string length, C<len>, must be supplied.  This function will realloc the
3590 memory pointed to by C<ptr>, so that pointer should not be freed or used by
3591 the programmer after giving it to sv_usepvn.  Does not handle 'set' magic.
3592 See C<sv_usepvn_mg>.
3593
3594 =cut
3595 */
3596
3597 void
3598 Perl_sv_usepvn(pTHX_ register SV *sv, register char *ptr, register STRLEN len)
3599 {
3600     SV_CHECK_THINKFIRST(sv);
3601     (void)SvUPGRADE(sv, SVt_PV);
3602     if (!ptr) {
3603         (void)SvOK_off(sv);
3604         return;
3605     }
3606     (void)SvOOK_off(sv);
3607     if (SvPVX(sv) && SvLEN(sv))
3608         Safefree(SvPVX(sv));
3609     Renew(ptr, len+1, char);
3610     SvPVX(sv) = ptr;
3611     SvCUR_set(sv, len);
3612     SvLEN_set(sv, len+1);
3613     *SvEND(sv) = '\0';
3614     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3615     SvTAINT(sv);
3616 }
3617
3618 /*
3619 =for apidoc sv_usepvn_mg
3620
3621 Like C<sv_usepvn>, but also handles 'set' magic.
3622
3623 =cut
3624 */
3625
3626 void
3627 Perl_sv_usepvn_mg(pTHX_ register SV *sv, register char *ptr, register STRLEN len)
3628 {
3629     sv_usepvn(sv,ptr,len);
3630     SvSETMAGIC(sv);
3631 }
3632
3633 void
3634 Perl_sv_force_normal_flags(pTHX_ register SV *sv, U32 flags)
3635 {
3636     if (SvREADONLY(sv)) {
3637         if (SvFAKE(sv)) {
3638             char *pvx = SvPVX(sv);
3639             STRLEN len = SvCUR(sv);
3640             U32 hash   = SvUVX(sv);
3641             SvGROW(sv, len + 1);
3642             Move(pvx,SvPVX(sv),len,char);
3643             *SvEND(sv) = '\0';
3644             SvFAKE_off(sv);
3645             SvREADONLY_off(sv);
3646             unsharepvn(pvx,SvUTF8(sv)?-len:len,hash);
3647         }
3648         else if (PL_curcop != &PL_compiling)
3649             Perl_croak(aTHX_ PL_no_modify);
3650     }
3651     if (SvROK(sv))
3652         sv_unref_flags(sv, flags);
3653     else if (SvFAKE(sv) && SvTYPE(sv) == SVt_PVGV)
3654         sv_unglob(sv);
3655 }
3656
3657 void
3658 Perl_sv_force_normal(pTHX_ register SV *sv)
3659 {
3660     sv_force_normal_flags(sv, 0);
3661 }
3662
3663 /*
3664 =for apidoc sv_chop
3665
3666 Efficient removal of characters from the beginning of the string buffer.
3667 SvPOK(sv) must be true and the C<ptr> must be a pointer to somewhere inside
3668 the string buffer.  The C<ptr> becomes the first character of the adjusted
3669 string.
3670
3671 =cut
3672 */
3673
3674 void
3675 Perl_sv_chop(pTHX_ register SV *sv, register char *ptr) /* like set but assuming ptr is in sv */
3676
3677
3678 {
3679     register STRLEN delta;
3680
3681     if (!ptr || !SvPOKp(sv))
3682         return;
3683     SV_CHECK_THINKFIRST(sv);
3684     if (SvTYPE(sv) < SVt_PVIV)
3685         sv_upgrade(sv,SVt_PVIV);
3686
3687     if (!SvOOK(sv)) {
3688         if (!SvLEN(sv)) { /* make copy of shared string */
3689             char *pvx = SvPVX(sv);
3690             STRLEN len = SvCUR(sv);
3691             SvGROW(sv, len + 1);
3692             Move(pvx,SvPVX(sv),len,char);
3693             *SvEND(sv) = '\0';
3694         }
3695         SvIVX(sv) = 0;
3696         SvFLAGS(sv) |= SVf_OOK;
3697     }
3698     SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVp_IOK|SVp_NOK|SVf_IVisUV);
3699     delta = ptr - SvPVX(sv);
3700     SvLEN(sv) -= delta;
3701     SvCUR(sv) -= delta;
3702     SvPVX(sv) += delta;
3703     SvIVX(sv) += delta;
3704 }
3705
3706 /*
3707 =for apidoc sv_catpvn
3708
3709 Concatenates the string onto the end of the string which is in the SV.  The
3710 C<len> indicates number of bytes to copy.  Handles 'get' magic, but not
3711 'set' magic.  See C<sv_catpvn_mg>.
3712
3713 =cut
3714 */
3715
3716 void
3717 Perl_sv_catpvn(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3718 {
3719     STRLEN tlen;
3720     char *junk;
3721
3722     junk = SvPV_force(sv, tlen);
3723     SvGROW(sv, tlen + len + 1);
3724     if (ptr == junk)
3725         ptr = SvPVX(sv);
3726     Move(ptr,SvPVX(sv)+tlen,len,char);
3727     SvCUR(sv) += len;
3728     *SvEND(sv) = '\0';
3729     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3730     SvTAINT(sv);
3731 }
3732
3733 /*
3734 =for apidoc sv_catpvn_mg
3735
3736 Like C<sv_catpvn>, but also handles 'set' magic.
3737
3738 =cut
3739 */
3740
3741 void
3742 Perl_sv_catpvn_mg(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3743 {
3744     sv_catpvn(sv,ptr,len);
3745     SvSETMAGIC(sv);
3746 }
3747
3748 /*
3749 =for apidoc sv_catsv
3750
3751 Concatenates the string from SV C<ssv> onto the end of the string in
3752 SV C<dsv>.  Modifies C<dsv> but not C<ssv>.  Handles 'get' magic, but
3753 not 'set' magic.  See C<sv_catsv_mg>.
3754
3755 =cut */
3756
3757 void
3758 Perl_sv_catsv(pTHX_ SV *dsv, register SV *ssv)
3759 {
3760     char *spv;
3761     STRLEN slen;
3762     if (!ssv)
3763         return;
3764     if ((spv = SvPV(ssv, slen))) {
3765         bool dutf8 = DO_UTF8(dsv);
3766         bool sutf8 = DO_UTF8(ssv);
3767
3768         if (dutf8 == sutf8)
3769             sv_catpvn(dsv,spv,slen);
3770         else {
3771             if (dutf8) {
3772                 /* Not modifying source SV, so taking a temporary copy. */
3773                 SV* csv = sv_2mortal(newSVsv(ssv));
3774                 char *cpv;
3775                 STRLEN clen;
3776
3777                 sv_utf8_upgrade(csv);
3778                 cpv = SvPV(csv,clen);
3779                 sv_catpvn(dsv,cpv,clen);
3780             }
3781             else {
3782                 sv_utf8_upgrade(dsv);
3783                 sv_catpvn(dsv,spv,slen);
3784                 SvUTF8_on(dsv); /* If dsv has no wide characters. */
3785             }
3786         }
3787     }
3788 }
3789
3790 /*
3791 =for apidoc sv_catsv_mg
3792
3793 Like C<sv_catsv>, but also handles 'set' magic.
3794
3795 =cut
3796 */
3797
3798 void
3799 Perl_sv_catsv_mg(pTHX_ SV *dsv, register SV *ssv)
3800 {
3801     sv_catsv(dsv,ssv);
3802     SvSETMAGIC(dsv);
3803 }
3804
3805 /*
3806 =for apidoc sv_catpv
3807
3808 Concatenates the string onto the end of the string which is in the SV.
3809 Handles 'get' magic, but not 'set' magic.  See C<sv_catpv_mg>.
3810
3811 =cut
3812 */
3813
3814 void
3815 Perl_sv_catpv(pTHX_ register SV *sv, register const char *ptr)
3816 {
3817     register STRLEN len;
3818     STRLEN tlen;
3819     char *junk;
3820
3821     if (!ptr)
3822         return;
3823     junk = SvPV_force(sv, tlen);
3824     len = strlen(ptr);
3825     SvGROW(sv, tlen + len + 1);
3826     if (ptr == junk)
3827         ptr = SvPVX(sv);
3828     Move(ptr,SvPVX(sv)+tlen,len+1,char);
3829     SvCUR(sv) += len;
3830     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3831     SvTAINT(sv);
3832 }
3833
3834 /*
3835 =for apidoc sv_catpv_mg
3836
3837 Like C<sv_catpv>, but also handles 'set' magic.
3838
3839 =cut
3840 */
3841
3842 void
3843 Perl_sv_catpv_mg(pTHX_ register SV *sv, register const char *ptr)
3844 {
3845     sv_catpv(sv,ptr);
3846     SvSETMAGIC(sv);
3847 }
3848
3849 SV *
3850 Perl_newSV(pTHX_ STRLEN len)
3851 {
3852     register SV *sv;
3853
3854     new_SV(sv);
3855     if (len) {
3856         sv_upgrade(sv, SVt_PV);
3857         SvGROW(sv, len + 1);
3858     }
3859     return sv;
3860 }
3861
3862 /* name is assumed to contain an SV* if (name && namelen == HEf_SVKEY) */
3863
3864 /*
3865 =for apidoc sv_magic
3866
3867 Adds magic to an SV.
3868
3869 =cut
3870 */
3871
3872 void
3873 Perl_sv_magic(pTHX_ register SV *sv, SV *obj, int how, const char *name, I32 namlen)
3874 {
3875     MAGIC* mg;
3876
3877     if (SvREADONLY(sv)) {
3878         if (PL_curcop != &PL_compiling && !strchr("gBf", how))
3879             Perl_croak(aTHX_ PL_no_modify);
3880     }
3881     if (SvMAGICAL(sv) || (how == 't' && SvTYPE(sv) >= SVt_PVMG)) {
3882         if (SvMAGIC(sv) && (mg = mg_find(sv, how))) {
3883             if (how == 't')
3884                 mg->mg_len |= 1;
3885             return;
3886         }
3887     }
3888     else {
3889         (void)SvUPGRADE(sv, SVt_PVMG);
3890     }
3891     Newz(702,mg, 1, MAGIC);
3892     mg->mg_moremagic = SvMAGIC(sv);
3893
3894     SvMAGIC(sv) = mg;
3895     if (!obj || obj == sv || how == '#' || how == 'r')
3896         mg->mg_obj = obj;
3897     else {
3898         mg->mg_obj = SvREFCNT_inc(obj);
3899         mg->mg_flags |= MGf_REFCOUNTED;
3900     }
3901     mg->mg_type = how;
3902     mg->mg_len = namlen;
3903     if (name)
3904         if (namlen >= 0)
3905             mg->mg_ptr = savepvn(name, namlen);
3906         else if (namlen == HEf_SVKEY)
3907             mg->mg_ptr = (char*)SvREFCNT_inc((SV*)name);
3908
3909     switch (how) {
3910     case 0:
3911         mg->mg_virtual = &PL_vtbl_sv;
3912         break;
3913     case 'A':
3914         mg->mg_virtual = &PL_vtbl_amagic;
3915         break;
3916     case 'a':
3917         mg->mg_virtual = &PL_vtbl_amagicelem;
3918         break;
3919     case 'c':
3920         mg->mg_virtual = 0;
3921         break;
3922     case 'B':
3923         mg->mg_virtual = &PL_vtbl_bm;
3924         break;
3925     case 'D':
3926         mg->mg_virtual = &PL_vtbl_regdata;
3927         break;
3928     case 'd':
3929         mg->mg_virtual = &PL_vtbl_regdatum;
3930         break;
3931     case 'E':
3932         mg->mg_virtual = &PL_vtbl_env;
3933         break;
3934     case 'f':
3935         mg->mg_virtual = &PL_vtbl_fm;
3936         break;
3937     case 'e':
3938         mg->mg_virtual = &PL_vtbl_envelem;
3939         break;
3940     case 'g':
3941         mg->mg_virtual = &PL_vtbl_mglob;
3942         break;
3943     case 'I':
3944         mg->mg_virtual = &PL_vtbl_isa;
3945         break;
3946     case 'i':
3947         mg->mg_virtual = &PL_vtbl_isaelem;
3948         break;
3949     case 'k':
3950         mg->mg_virtual = &PL_vtbl_nkeys;
3951         break;
3952     case 'L':
3953         SvRMAGICAL_on(sv);
3954         mg->mg_virtual = 0;
3955         break;
3956     case 'l':
3957         mg->mg_virtual = &PL_vtbl_dbline;
3958         break;
3959 #ifdef USE_THREADS
3960     case 'm':
3961         mg->mg_virtual = &PL_vtbl_mutex;
3962         break;
3963 #endif /* USE_THREADS */
3964 #ifdef USE_LOCALE_COLLATE
3965     case 'o':
3966         mg->mg_virtual = &PL_vtbl_collxfrm;
3967         break;
3968 #endif /* USE_LOCALE_COLLATE */
3969     case 'P':
3970         mg->mg_virtual = &PL_vtbl_pack;
3971         break;
3972     case 'p':
3973     case 'q':
3974         mg->mg_virtual = &PL_vtbl_packelem;
3975         break;
3976     case 'r':
3977         mg->mg_virtual = &PL_vtbl_regexp;
3978         break;
3979     case 'S':
3980         mg->mg_virtual = &PL_vtbl_sig;
3981         break;
3982     case 's':
3983         mg->mg_virtual = &PL_vtbl_sigelem;
3984         break;
3985     case 't':
3986         mg->mg_virtual = &PL_vtbl_taint;
3987         mg->mg_len = 1;
3988         break;
3989     case 'U':
3990         mg->mg_virtual = &PL_vtbl_uvar;
3991         break;
3992     case 'v':
3993         mg->mg_virtual = &PL_vtbl_vec;
3994         break;
3995     case 'x':
3996         mg->mg_virtual = &PL_vtbl_substr;
3997         break;
3998     case 'y':
3999         mg->mg_virtual = &PL_vtbl_defelem;
4000         break;
4001     case '*':
4002         mg->mg_virtual = &PL_vtbl_glob;
4003         break;
4004     case '#':
4005         mg->mg_virtual = &PL_vtbl_arylen;
4006         break;
4007     case '.':
4008         mg->mg_virtual = &PL_vtbl_pos;
4009         break;
4010     case '<':
4011         mg->mg_virtual = &PL_vtbl_backref;
4012         break;
4013     case '~':   /* Reserved for use by extensions not perl internals.   */
4014         /* Useful for attaching extension internal data to perl vars.   */
4015         /* Note that multiple extensions may clash if magical scalars   */
4016         /* etc holding private data from one are passed to another.     */
4017         SvRMAGICAL_on(sv);
4018         break;
4019     default:
4020         Perl_croak(aTHX_ "Don't know how to handle magic of type '%c'", how);
4021     }
4022     mg_magical(sv);
4023     if (SvGMAGICAL(sv))
4024         SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVf_POK);
4025 }
4026
4027 /*
4028 =for apidoc sv_unmagic
4029
4030 Removes magic from an SV.
4031
4032 =cut
4033 */
4034
4035 int
4036 Perl_sv_unmagic(pTHX_ SV *sv, int type)
4037 {
4038     MAGIC* mg;
4039     MAGIC** mgp;
4040     if (SvTYPE(sv) < SVt_PVMG || !SvMAGIC(sv))
4041         return 0;
4042     mgp = &SvMAGIC(sv);
4043     for (mg = *mgp; mg; mg = *mgp) {
4044         if (mg->mg_type == type) {
4045             MGVTBL* vtbl = mg->mg_virtual;
4046             *mgp = mg->mg_moremagic;
4047             if (vtbl && vtbl->svt_free)
4048                 CALL_FPTR(vtbl->svt_free)(aTHX_ sv, mg);
4049             if (mg->mg_ptr && mg->mg_type != 'g')
4050                 if (mg->mg_len >= 0)
4051                     Safefree(mg->mg_ptr);
4052                 else if (mg->mg_len == HEf_SVKEY)
4053                     SvREFCNT_dec((SV*)mg->mg_ptr);
4054             if (mg->mg_flags & MGf_REFCOUNTED)
4055                 SvREFCNT_dec(mg->mg_obj);
4056             Safefree(mg);
4057         }
4058         else
4059             mgp = &mg->mg_moremagic;
4060     }
4061     if (!SvMAGIC(sv)) {
4062         SvMAGICAL_off(sv);
4063         SvFLAGS(sv) |= (SvFLAGS(sv) & (SVp_IOK|SVp_NOK|SVp_POK)) >> PRIVSHIFT;
4064     }
4065
4066     return 0;
4067 }
4068
4069 /*
4070 =for apidoc sv_rvweaken
4071
4072 Weaken a reference.
4073
4074 =cut
4075 */
4076
4077 SV *
4078 Perl_sv_rvweaken(pTHX_ SV *sv)
4079 {
4080     SV *tsv;
4081     if (!SvOK(sv))  /* let undefs pass */
4082         return sv;
4083     if (!SvROK(sv))
4084         Perl_croak(aTHX_ "Can't weaken a nonreference");
4085     else if (SvWEAKREF(sv)) {
4086         if (ckWARN(WARN_MISC))
4087             Perl_warner(aTHX_ WARN_MISC, "Reference is already weak");
4088         return sv;
4089     }
4090     tsv = SvRV(sv);
4091     sv_add_backref(tsv, sv);
4092     SvWEAKREF_on(sv);
4093     SvREFCNT_dec(tsv);
4094     return sv;
4095 }
4096
4097 STATIC void
4098 S_sv_add_backref(pTHX_ SV *tsv, SV *sv)
4099 {
4100     AV *av;
4101     MAGIC *mg;
4102     if (SvMAGICAL(tsv) && (mg = mg_find(tsv, '<')))
4103         av = (AV*)mg->mg_obj;
4104     else {
4105         av = newAV();
4106         sv_magic(tsv, (SV*)av, '<', NULL, 0);
4107         SvREFCNT_dec(av);           /* for sv_magic */
4108     }
4109     av_push(av,sv);
4110 }
4111
4112 STATIC void
4113 S_sv_del_backref(pTHX_ SV *sv)
4114 {
4115     AV *av;
4116     SV **svp;
4117     I32 i;
4118     SV *tsv = SvRV(sv);
4119     MAGIC *mg;
4120     if (!SvMAGICAL(tsv) || !(mg = mg_find(tsv, '<')))
4121         Perl_croak(aTHX_ "panic: del_backref");
4122     av = (AV *)mg->mg_obj;
4123     svp = AvARRAY(av);
4124     i = AvFILLp(av);
4125     while (i >= 0) {
4126         if (svp[i] == sv) {
4127             svp[i] = &PL_sv_undef; /* XXX */
4128         }
4129         i--;
4130     }
4131 }
4132
4133 /*
4134 =for apidoc sv_insert
4135
4136 Inserts a string at the specified offset/length within the SV. Similar to
4137 the Perl substr() function.
4138
4139 =cut
4140 */
4141
4142 void
4143 Perl_sv_insert(pTHX_ SV *bigstr, STRLEN offset, STRLEN len, char *little, STRLEN littlelen)
4144 {
4145     register char *big;
4146     register char *mid;
4147     register char *midend;
4148     register char *bigend;
4149     register I32 i;
4150     STRLEN curlen;
4151
4152
4153     if (!bigstr)
4154         Perl_croak(aTHX_ "Can't modify non-existent substring");
4155     SvPV_force(bigstr, curlen);
4156     (void)SvPOK_only_UTF8(bigstr);
4157     if (offset + len > curlen) {
4158         SvGROW(bigstr, offset+len+1);
4159         Zero(SvPVX(bigstr)+curlen, offset+len-curlen, char);
4160         SvCUR_set(bigstr, offset+len);
4161     }
4162
4163     SvTAINT(bigstr);
4164     i = littlelen - len;
4165     if (i > 0) {                        /* string might grow */
4166         big = SvGROW(bigstr, SvCUR(bigstr) + i + 1);
4167         mid = big + offset + len;
4168         midend = bigend = big + SvCUR(bigstr);
4169         bigend += i;
4170         *bigend = '\0';
4171         while (midend > mid)            /* shove everything down */
4172             *--bigend = *--midend;
4173         Move(little,big+offset,littlelen,char);
4174         SvCUR(bigstr) += i;
4175         SvSETMAGIC(bigstr);
4176         return;
4177     }
4178     else if (i == 0) {
4179         Move(little,SvPVX(bigstr)+offset,len,char);
4180         SvSETMAGIC(bigstr);
4181         return;
4182     }
4183
4184     big = SvPVX(bigstr);
4185     mid = big + offset;
4186     midend = mid + len;
4187     bigend = big + SvCUR(bigstr);
4188
4189     if (midend > bigend)
4190         Perl_croak(aTHX_ "panic: sv_insert");
4191
4192     if (mid - big > bigend - midend) {  /* faster to shorten from end */
4193         if (littlelen) {
4194             Move(little, mid, littlelen,char);
4195             mid += littlelen;
4196         }
4197         i = bigend - midend;
4198         if (i > 0) {
4199             Move(midend, mid, i,char);
4200             mid += i;
4201         }
4202         *mid = '\0';
4203         SvCUR_set(bigstr, mid - big);
4204     }
4205     /*SUPPRESS 560*/
4206     else if ((i = mid - big)) { /* faster from front */
4207         midend -= littlelen;
4208         mid = midend;
4209         sv_chop(bigstr,midend-i);
4210         big += i;
4211         while (i--)
4212             *--midend = *--big;
4213         if (littlelen)
4214             Move(little, mid, littlelen,char);
4215     }
4216     else if (littlelen) {
4217         midend -= littlelen;
4218         sv_chop(bigstr,midend);
4219         Move(little,midend,littlelen,char);
4220     }
4221     else {
4222         sv_chop(bigstr,midend);
4223     }
4224     SvSETMAGIC(bigstr);
4225 }
4226
4227 /*
4228 =for apidoc sv_replace
4229
4230 Make the first argument a copy of the second, then delete the original.
4231
4232 =cut
4233 */
4234
4235 void
4236 Perl_sv_replace(pTHX_ register SV *sv, register SV *nsv)
4237 {
4238     U32 refcnt = SvREFCNT(sv);
4239     SV_CHECK_THINKFIRST(sv);
4240     if (SvREFCNT(nsv) != 1 && ckWARN_d(WARN_INTERNAL))
4241         Perl_warner(aTHX_ WARN_INTERNAL, "Reference miscount in sv_replace()");
4242     if (SvMAGICAL(sv)) {
4243         if (SvMAGICAL(nsv))
4244             mg_free(nsv);
4245         else
4246             sv_upgrade(nsv, SVt_PVMG);
4247         SvMAGIC(nsv) = SvMAGIC(sv);
4248         SvFLAGS(nsv) |= SvMAGICAL(sv);
4249         SvMAGICAL_off(sv);
4250         SvMAGIC(sv) = 0;
4251     }
4252     SvREFCNT(sv) = 0;
4253     sv_clear(sv);
4254     assert(!SvREFCNT(sv));
4255     StructCopy(nsv,sv,SV);
4256     SvREFCNT(sv) = refcnt;
4257     SvFLAGS(nsv) |= SVTYPEMASK;         /* Mark as freed */
4258     del_SV(nsv);
4259 }
4260
4261 /*
4262 =for apidoc sv_clear
4263
4264 Clear an SV, making it empty. Does not free the memory used by the SV
4265 itself.
4266
4267 =cut
4268 */
4269
4270 void
4271 Perl_sv_clear(pTHX_ register SV *sv)
4272 {
4273     HV* stash;
4274     assert(sv);
4275     assert(SvREFCNT(sv) == 0);
4276
4277     if (SvOBJECT(sv)) {
4278         if (PL_defstash) {              /* Still have a symbol table? */
4279             djSP;
4280             CV* destructor;
4281             SV tmpref;
4282
4283             Zero(&tmpref, 1, SV);
4284             sv_upgrade(&tmpref, SVt_RV);
4285             SvROK_on(&tmpref);
4286             SvREADONLY_on(&tmpref);     /* DESTROY() could be naughty */
4287             SvREFCNT(&tmpref) = 1;
4288
4289             do {            
4290                 stash = SvSTASH(sv);
4291                 destructor = StashHANDLER(stash,DESTROY);
4292                 if (destructor) {
4293                     ENTER;
4294                     PUSHSTACKi(PERLSI_DESTROY);
4295                     SvRV(&tmpref) = SvREFCNT_inc(sv);
4296                     EXTEND(SP, 2);
4297                     PUSHMARK(SP);
4298                     PUSHs(&tmpref);
4299                     PUTBACK;
4300                     call_sv((SV*)destructor, G_DISCARD|G_EVAL|G_KEEPERR);
4301                     SvREFCNT(sv)--;
4302                     POPSTACK;
4303                     SPAGAIN;
4304                     LEAVE;
4305                 }
4306             } while (SvOBJECT(sv) && SvSTASH(sv) != stash);
4307
4308             del_XRV(SvANY(&tmpref));
4309
4310             if (SvREFCNT(sv)) {
4311                 if (PL_in_clean_objs)
4312                     Perl_croak(aTHX_ "DESTROY created new reference to dead object '%s'",
4313                           HvNAME(stash));
4314                 /* DESTROY gave object new lease on life */
4315                 return;
4316             }
4317         }
4318
4319         if (SvOBJECT(sv)) {
4320             SvREFCNT_dec(SvSTASH(sv));  /* possibly of changed persuasion */
4321             SvOBJECT_off(sv);   /* Curse the object. */
4322             if (SvTYPE(sv) != SVt_PVIO)
4323                 --PL_sv_objcount;       /* XXX Might want something more general */
4324         }
4325     }
4326     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv))
4327         mg_free(sv);
4328     stash = NULL;
4329     switch (SvTYPE(sv)) {
4330     case SVt_PVIO:
4331         if (IoIFP(sv) &&
4332             IoIFP(sv) != PerlIO_stdin() &&
4333             IoIFP(sv) != PerlIO_stdout() &&
4334             IoIFP(sv) != PerlIO_stderr())
4335         {
4336             io_close((IO*)sv, FALSE);
4337         }
4338         if (IoDIRP(sv) && !(IoFLAGS(sv) & IOf_FAKE_DIRP))
4339             PerlDir_close(IoDIRP(sv));
4340         IoDIRP(sv) = (DIR*)NULL;
4341         Safefree(IoTOP_NAME(sv));
4342         Safefree(IoFMT_NAME(sv));
4343         Safefree(IoBOTTOM_NAME(sv));
4344         /* FALL THROUGH */
4345     case SVt_PVBM:
4346         goto freescalar;
4347     case SVt_PVCV:
4348     case SVt_PVFM:
4349         cv_undef((CV*)sv);
4350         goto freescalar;
4351     case SVt_PVHV:
4352         hv_undef((HV*)sv);
4353         break;
4354     case SVt_PVAV:
4355         av_undef((AV*)sv);
4356         break;
4357     case SVt_PVLV:
4358         SvREFCNT_dec(LvTARG(sv));
4359         goto freescalar;
4360     case SVt_PVGV:
4361         gp_free((GV*)sv);
4362         Safefree(GvNAME(sv));
4363         /* cannot decrease stash refcount yet, as we might recursively delete
4364            ourselves when the refcnt drops to zero. Delay SvREFCNT_dec
4365            of stash until current sv is completely gone.
4366            -- JohnPC, 27 Mar 1998 */
4367         stash = GvSTASH(sv);
4368         /* FALL THROUGH */
4369     case SVt_PVMG:
4370     case SVt_PVNV:
4371     case SVt_PVIV:
4372       freescalar:
4373         (void)SvOOK_off(sv);
4374         /* FALL THROUGH */
4375     case SVt_PV:
4376     case SVt_RV:
4377         if (SvROK(sv)) {
4378             if (SvWEAKREF(sv))
4379                 sv_del_backref(sv);
4380             else
4381                 SvREFCNT_dec(SvRV(sv));
4382         }
4383         else if (SvPVX(sv) && SvLEN(sv))
4384             Safefree(SvPVX(sv));
4385         else if (SvPVX(sv) && SvREADONLY(sv) && SvFAKE(sv)) {
4386             unsharepvn(SvPVX(sv),SvUTF8(sv)?-SvCUR(sv):SvCUR(sv),SvUVX(sv));
4387             SvFAKE_off(sv);
4388         }
4389         break;
4390 /*
4391     case SVt_NV:
4392     case SVt_IV:
4393     case SVt_NULL:
4394         break;
4395 */
4396     }
4397
4398     switch (SvTYPE(sv)) {
4399     case SVt_NULL:
4400         break;
4401     case SVt_IV:
4402         del_XIV(SvANY(sv));
4403         break;
4404     case SVt_NV:
4405         del_XNV(SvANY(sv));
4406         break;
4407     case SVt_RV:
4408         del_XRV(SvANY(sv));
4409         break;
4410     case SVt_PV:
4411         del_XPV(SvANY(sv));
4412         break;
4413     case SVt_PVIV:
4414         del_XPVIV(SvANY(sv));
4415         break;
4416     case SVt_PVNV:
4417         del_XPVNV(SvANY(sv));
4418         break;
4419     case SVt_PVMG:
4420         del_XPVMG(SvANY(sv));
4421         break;
4422     case SVt_PVLV:
4423         del_XPVLV(SvANY(sv));
4424         break;
4425     case SVt_PVAV:
4426         del_XPVAV(SvANY(sv));
4427         break;
4428     case SVt_PVHV:
4429         del_XPVHV(SvANY(sv));
4430         break;
4431     case SVt_PVCV:
4432         del_XPVCV(SvANY(sv));
4433         break;
4434     case SVt_PVGV:
4435         del_XPVGV(SvANY(sv));
4436         /* code duplication for increased performance. */
4437         SvFLAGS(sv) &= SVf_BREAK;
4438         SvFLAGS(sv) |= SVTYPEMASK;
4439         /* decrease refcount of the stash that owns this GV, if any */
4440         if (stash)
4441             SvREFCNT_dec(stash);
4442         return; /* not break, SvFLAGS reset already happened */
4443     case SVt_PVBM:
4444         del_XPVBM(SvANY(sv));
4445         break;
4446     case SVt_PVFM:
4447         del_XPVFM(SvANY(sv));
4448         break;
4449     case SVt_PVIO:
4450         del_XPVIO(SvANY(sv));
4451         break;
4452     }
4453     SvFLAGS(sv) &= SVf_BREAK;
4454     SvFLAGS(sv) |= SVTYPEMASK;
4455 }
4456
4457 SV *
4458 Perl_sv_newref(pTHX_ SV *sv)
4459 {
4460     if (sv)
4461         ATOMIC_INC(SvREFCNT(sv));
4462     return sv;
4463 }
4464
4465 /*
4466 =for apidoc sv_free
4467
4468 Free the memory used by an SV.
4469
4470 =cut
4471 */
4472
4473 void
4474 Perl_sv_free(pTHX_ SV *sv)
4475 {
4476     int refcount_is_zero;
4477
4478     if (!sv)
4479         return;
4480     if (SvREFCNT(sv) == 0) {
4481         if (SvFLAGS(sv) & SVf_BREAK)
4482             return;
4483         if (PL_in_clean_all) /* All is fair */
4484             return;
4485         if (SvREADONLY(sv) && SvIMMORTAL(sv)) {
4486             /* make sure SvREFCNT(sv)==0 happens very seldom */
4487             SvREFCNT(sv) = (~(U32)0)/2;
4488             return;
4489         }
4490         if (ckWARN_d(WARN_INTERNAL))
4491             Perl_warner(aTHX_ WARN_INTERNAL, "Attempt to free unreferenced scalar");
4492         return;
4493     }
4494     ATOMIC_DEC_AND_TEST(refcount_is_zero, SvREFCNT(sv));
4495     if (!refcount_is_zero)
4496         return;
4497 #ifdef DEBUGGING
4498     if (SvTEMP(sv)) {
4499         if (ckWARN_d(WARN_DEBUGGING))
4500             Perl_warner(aTHX_ WARN_DEBUGGING,
4501                         "Attempt to free temp prematurely: SV 0x%"UVxf,
4502                         PTR2UV(sv));
4503         return;
4504     }
4505 #endif
4506     if (SvREADONLY(sv) && SvIMMORTAL(sv)) {
4507         /* make sure SvREFCNT(sv)==0 happens very seldom */
4508         SvREFCNT(sv) = (~(U32)0)/2;
4509         return;
4510     }
4511     sv_clear(sv);
4512     if (! SvREFCNT(sv))
4513         del_SV(sv);
4514 }
4515
4516 /*
4517 =for apidoc sv_len
4518
4519 Returns the length of the string in the SV.  See also C<SvCUR>.
4520
4521 =cut
4522 */
4523
4524 STRLEN
4525 Perl_sv_len(pTHX_ register SV *sv)
4526 {
4527     char *junk;
4528     STRLEN len;
4529
4530     if (!sv)
4531         return 0;
4532
4533     if (SvGMAGICAL(sv))
4534         len = mg_length(sv);
4535     else
4536         junk = SvPV(sv, len);
4537     return len;
4538 }
4539
4540 /*
4541 =for apidoc sv_len_utf8
4542
4543 Returns the number of characters in the string in an SV, counting wide
4544 UTF8 bytes as a single character.
4545
4546 =cut
4547 */
4548
4549 STRLEN
4550 Perl_sv_len_utf8(pTHX_ register SV *sv)
4551 {
4552     if (!sv)
4553         return 0;
4554
4555     if (SvGMAGICAL(sv))
4556         return mg_length(sv);
4557     else
4558     {
4559         STRLEN len;
4560         U8 *s = (U8*)SvPV(sv, len);
4561
4562         return Perl_utf8_length(aTHX_ s, s + len);
4563     }
4564 }
4565
4566 void
4567 Perl_sv_pos_u2b(pTHX_ register SV *sv, I32* offsetp, I32* lenp)
4568 {
4569     U8 *start;
4570     U8 *s;
4571     U8 *send;
4572     I32 uoffset = *offsetp;
4573     STRLEN len;
4574
4575     if (!sv)
4576         return;
4577
4578     start = s = (U8*)SvPV(sv, len);
4579     send = s + len;
4580     while (s < send && uoffset--)
4581         s += UTF8SKIP(s);
4582     if (s >= send)
4583         s = send;
4584     *offsetp = s - start;
4585     if (lenp) {
4586         I32 ulen = *lenp;
4587         start = s;
4588         while (s < send && ulen--)
4589             s += UTF8SKIP(s);
4590         if (s >= send)
4591             s = send;
4592         *lenp = s - start;
4593     }
4594     return;
4595 }
4596
4597 void
4598 Perl_sv_pos_b2u(pTHX_ register SV *sv, I32* offsetp)
4599 {
4600     U8 *s;
4601     U8 *send;
4602     STRLEN len;
4603
4604     if (!sv)
4605         return;
4606
4607     s = (U8*)SvPV(sv, len);
4608     if (len < *offsetp)
4609         Perl_croak(aTHX_ "panic: sv_pos_b2u: bad byte offset");
4610     send = s + *offsetp;
4611     len = 0;
4612     while (s < send) {
4613         STRLEN n;
4614
4615         if (utf8_to_uv(s, UTF8SKIP(s), &n, 0)) {
4616             s += n;
4617             len++;
4618         }
4619         else
4620             break;
4621     }
4622     *offsetp = len;
4623     return;
4624 }
4625
4626 /*
4627 =for apidoc sv_eq
4628
4629 Returns a boolean indicating whether the strings in the two SVs are
4630 identical.
4631
4632 =cut
4633 */
4634
4635 I32
4636 Perl_sv_eq(pTHX_ register SV *sv1, register SV *sv2)
4637 {
4638     char *pv1;
4639     STRLEN cur1;
4640     char *pv2;
4641     STRLEN cur2;
4642     I32  eq     = 0;
4643     bool pv1tmp = FALSE;
4644     bool pv2tmp = FALSE;
4645
4646     if (!sv1) {
4647         pv1 = "";
4648         cur1 = 0;
4649     }
4650     else
4651         pv1 = SvPV(sv1, cur1);
4652
4653     if (!sv2){
4654         pv2 = "";
4655         cur2 = 0;
4656     }
4657     else
4658         pv2 = SvPV(sv2, cur2);
4659
4660     /* do not utf8ize the comparands as a side-effect */
4661     if (cur1 && cur2 && SvUTF8(sv1) != SvUTF8(sv2) && !IN_BYTE) {
4662         if (PL_hints & HINT_UTF8_DISTINCT)
4663             return FALSE;
4664
4665         if (SvUTF8(sv1)) {
4666             (void)utf8_to_bytes((U8*)(pv1 = savepvn(pv1, cur1)), &cur1);
4667             {
4668                 IV scur1 = cur1;
4669                 if (scur1 < 0) {
4670                     Safefree(pv1);
4671                     return 0;
4672                 }
4673             }
4674             pv1tmp = TRUE;
4675         }
4676         else {
4677             (void)utf8_to_bytes((U8*)(pv2 = savepvn(pv2, cur2)), &cur2);
4678             {
4679                 IV scur2 = cur2;
4680                 if (scur2 < 0) {
4681                     Safefree(pv2);
4682                     return 0;
4683                 }
4684             }
4685             pv2tmp = TRUE;
4686         }
4687     }
4688
4689     if (cur1 == cur2)
4690         eq = memEQ(pv1, pv2, cur1);
4691         
4692     if (pv1tmp)
4693         Safefree(pv1);
4694     if (pv2tmp)
4695         Safefree(pv2);
4696
4697     return eq;
4698 }
4699
4700 /*
4701 =for apidoc sv_cmp
4702
4703 Compares the strings in two SVs.  Returns -1, 0, or 1 indicating whether the
4704 string in C<sv1> is less than, equal to, or greater than the string in
4705 C<sv2>.
4706
4707 =cut
4708 */
4709
4710 I32
4711 Perl_sv_cmp(pTHX_ register SV *sv1, register SV *sv2)
4712 {
4713     STRLEN cur1, cur2;
4714     char *pv1, *pv2;
4715     I32  cmp;
4716     bool pv1tmp = FALSE;
4717     bool pv2tmp = FALSE;
4718
4719     if (!sv1) {
4720         pv1 = "";
4721         cur1 = 0;
4722     }
4723     else
4724         pv1 = SvPV(sv1, cur1);
4725
4726     if (!sv2){
4727         pv2 = "";
4728         cur2 = 0;
4729     }
4730     else
4731         pv2 = SvPV(sv2, cur2);
4732
4733     /* do not utf8ize the comparands as a side-effect */
4734     if (cur1 && cur2 && SvUTF8(sv1) != SvUTF8(sv2) && !IN_BYTE) {
4735         if (PL_hints & HINT_UTF8_DISTINCT)
4736             return SvUTF8(sv1) ? 1 : -1;
4737
4738         if (SvUTF8(sv1)) {
4739             pv2 = (char*)bytes_to_utf8((U8*)pv2, &cur2);
4740             pv2tmp = TRUE;
4741         }
4742         else {
4743             pv1 = (char*)bytes_to_utf8((U8*)pv1, &cur1);
4744             pv1tmp = TRUE;
4745         }
4746     }
4747
4748     if (!cur1) {
4749         cmp = cur2 ? -1 : 0;
4750     } else if (!cur2) {
4751         cmp = 1;
4752     } else {
4753         I32 retval = memcmp((void*)pv1, (void*)pv2, cur1 < cur2 ? cur1 : cur2);
4754
4755         if (retval) {
4756             cmp = retval < 0 ? -1 : 1;
4757         } else if (cur1 == cur2) {
4758             cmp = 0;
4759         } else {
4760             cmp = cur1 < cur2 ? -1 : 1;
4761         }
4762     }
4763
4764     if (pv1tmp)
4765         Safefree(pv1);
4766     if (pv2tmp)
4767         Safefree(pv2);
4768
4769     return cmp;
4770 }
4771
4772 /*
4773 =for apidoc sv_cmp_locale
4774
4775 Compares the strings in two SVs in a locale-aware manner. See
4776 L</sv_cmp_locale>
4777
4778 =cut
4779 */
4780
4781 I32
4782 Perl_sv_cmp_locale(pTHX_ register SV *sv1, register SV *sv2)
4783 {
4784 #ifdef USE_LOCALE_COLLATE
4785
4786     char *pv1, *pv2;
4787     STRLEN len1, len2;
4788     I32 retval;
4789
4790     if (PL_collation_standard)
4791         goto raw_compare;
4792
4793     len1 = 0;
4794     pv1 = sv1 ? sv_collxfrm(sv1, &len1) : (char *) NULL;
4795     len2 = 0;
4796     pv2 = sv2 ? sv_collxfrm(sv2, &len2) : (char *) NULL;
4797
4798     if (!pv1 || !len1) {
4799         if (pv2 && len2)
4800             return -1;
4801         else
4802             goto raw_compare;
4803     }
4804     else {
4805         if (!pv2 || !len2)
4806             return 1;
4807     }
4808
4809     retval = memcmp((void*)pv1, (void*)pv2, len1 < len2 ? len1 : len2);
4810
4811     if (retval)
4812         return retval < 0 ? -1 : 1;
4813
4814     /*
4815      * When the result of collation is equality, that doesn't mean
4816      * that there are no differences -- some locales exclude some
4817      * characters from consideration.  So to avoid false equalities,
4818      * we use the raw string as a tiebreaker.
4819      */
4820
4821   raw_compare:
4822     /* FALL THROUGH */
4823
4824 #endif /* USE_LOCALE_COLLATE */
4825
4826     return sv_cmp(sv1, sv2);
4827 }
4828
4829 #ifdef USE_LOCALE_COLLATE
4830 /*
4831  * Any scalar variable may carry an 'o' magic that contains the
4832  * scalar data of the variable transformed to such a format that
4833  * a normal memory comparison can be used to compare the data
4834  * according to the locale settings.
4835  */
4836 char *
4837 Perl_sv_collxfrm(pTHX_ SV *sv, STRLEN *nxp)
4838 {
4839     MAGIC *mg;
4840
4841     mg = SvMAGICAL(sv) ? mg_find(sv, 'o') : (MAGIC *) NULL;
4842     if (!mg || !mg->mg_ptr || *(U32*)mg->mg_ptr != PL_collation_ix) {
4843         char *s, *xf;
4844         STRLEN len, xlen;
4845
4846         if (mg)
4847             Safefree(mg->mg_ptr);
4848         s = SvPV(sv, len);
4849         if ((xf = mem_collxfrm(s, len, &xlen))) {
4850             if (SvREADONLY(sv)) {
4851                 SAVEFREEPV(xf);
4852                 *nxp = xlen;
4853                 return xf + sizeof(PL_collation_ix);
4854             }
4855             if (! mg) {
4856                 sv_magic(sv, 0, 'o', 0, 0);
4857                 mg = mg_find(sv, 'o');
4858                 assert(mg);
4859             }
4860             mg->mg_ptr = xf;
4861             mg->mg_len = xlen;
4862         }
4863         else {
4864             if (mg) {
4865                 mg->mg_ptr = NULL;
4866                 mg->mg_len = -1;
4867             }
4868         }
4869     }
4870     if (mg && mg->mg_ptr) {
4871         *nxp = mg->mg_len;
4872         return mg->mg_ptr + sizeof(PL_collation_ix);
4873     }
4874     else {
4875         *nxp = 0;
4876         return NULL;
4877     }
4878 }
4879
4880 #endif /* USE_LOCALE_COLLATE */
4881
4882 /*
4883 =for apidoc sv_gets
4884
4885 Get a line from the filehandle and store it into the SV, optionally
4886 appending to the currently-stored string.
4887
4888 =cut
4889 */
4890
4891 char *
4892 Perl_sv_gets(pTHX_ register SV *sv, register PerlIO *fp, I32 append)
4893 {
4894     char *rsptr;
4895     STRLEN rslen;
4896     register STDCHAR rslast;
4897     register STDCHAR *bp;
4898     register I32 cnt;
4899     I32 i;
4900
4901     SV_CHECK_THINKFIRST(sv);
4902     (void)SvUPGRADE(sv, SVt_PV);
4903
4904     SvSCREAM_off(sv);
4905
4906     if (RsSNARF(PL_rs)) {
4907         rsptr = NULL;
4908         rslen = 0;
4909     }
4910     else if (RsRECORD(PL_rs)) {
4911       I32 recsize, bytesread;
4912       char *buffer;
4913
4914       /* Grab the size of the record we're getting */
4915       recsize = SvIV(SvRV(PL_rs));
4916       (void)SvPOK_only(sv);    /* Validate pointer */
4917       buffer = SvGROW(sv, recsize + 1);
4918       /* Go yank in */
4919 #ifdef VMS
4920       /* VMS wants read instead of fread, because fread doesn't respect */
4921       /* RMS record boundaries. This is not necessarily a good thing to be */
4922       /* doing, but we've got no other real choice */
4923       bytesread = PerlLIO_read(PerlIO_fileno(fp), buffer, recsize);
4924 #else
4925       bytesread = PerlIO_read(fp, buffer, recsize);
4926 #endif
4927       SvCUR_set(sv, bytesread);
4928       buffer[bytesread] = '\0';
4929       if (PerlIO_isutf8(fp))
4930         SvUTF8_on(sv);
4931       else
4932         SvUTF8_off(sv);
4933       return(SvCUR(sv) ? SvPVX(sv) : Nullch);
4934     }
4935     else if (RsPARA(PL_rs)) {
4936         rsptr = "\n\n";
4937         rslen = 2;
4938     }
4939     else {
4940         /* Get $/ i.e. PL_rs into same encoding as stream wants */
4941         if (PerlIO_isutf8(fp)) {
4942             rsptr = SvPVutf8(PL_rs, rslen);
4943         }
4944         else {
4945             if (SvUTF8(PL_rs)) {
4946                 if (!sv_utf8_downgrade(PL_rs, TRUE)) {
4947                     Perl_croak(aTHX_ "Wide character in $/");
4948                 }
4949             }
4950             rsptr = SvPV(PL_rs, rslen);
4951         }
4952     }
4953
4954     rslast = rslen ? rsptr[rslen - 1] : '\0';
4955
4956     if (RsPARA(PL_rs)) {                /* have to do this both before and after */
4957         do {                    /* to make sure file boundaries work right */
4958             if (PerlIO_eof(fp))
4959                 return 0;
4960             i = PerlIO_getc(fp);
4961             if (i != '\n') {
4962                 if (i == -1)
4963                     return 0;
4964                 PerlIO_ungetc(fp,i);
4965                 break;
4966             }
4967         } while (i != EOF);
4968     }
4969
4970     /* See if we know enough about I/O mechanism to cheat it ! */
4971
4972     /* This used to be #ifdef test - it is made run-time test for ease
4973        of abstracting out stdio interface. One call should be cheap
4974        enough here - and may even be a macro allowing compile
4975        time optimization.
4976      */
4977
4978     if (PerlIO_fast_gets(fp)) {
4979
4980     /*
4981      * We're going to steal some values from the stdio struct
4982      * and put EVERYTHING in the innermost loop into registers.
4983      */
4984     register STDCHAR *ptr;
4985     STRLEN bpx;
4986     I32 shortbuffered;
4987
4988 #if defined(VMS) && defined(PERLIO_IS_STDIO)
4989     /* An ungetc()d char is handled separately from the regular
4990      * buffer, so we getc() it back out and stuff it in the buffer.
4991      */
4992     i = PerlIO_getc(fp);
4993     if (i == EOF) return 0;
4994     *(--((*fp)->_ptr)) = (unsigned char) i;
4995     (*fp)->_cnt++;
4996 #endif
4997
4998     /* Here is some breathtakingly efficient cheating */
4999
5000     cnt = PerlIO_get_cnt(fp);                   /* get count into register */
5001     (void)SvPOK_only(sv);               /* validate pointer */
5002     if (SvLEN(sv) - append <= cnt + 1) { /* make sure we have the room */
5003         if (cnt > 80 && SvLEN(sv) > append) {
5004             shortbuffered = cnt - SvLEN(sv) + append + 1;
5005             cnt -= shortbuffered;
5006         }
5007         else {
5008             shortbuffered = 0;
5009             /* remember that cnt can be negative */
5010             SvGROW(sv, append + (cnt <= 0 ? 2 : (cnt + 1)));
5011         }
5012     }
5013     else
5014         shortbuffered = 0;
5015     bp = (STDCHAR*)SvPVX(sv) + append;  /* move these two too to registers */
5016     ptr = (STDCHAR*)PerlIO_get_ptr(fp);
5017     DEBUG_P(PerlIO_printf(Perl_debug_log,
5018         "Screamer: entering, ptr=%"UVuf", cnt=%ld\n",PTR2UV(ptr),(long)cnt));
5019     DEBUG_P(PerlIO_printf(Perl_debug_log,
5020         "Screamer: entering: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
5021                PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp),
5022                PTR2UV(PerlIO_has_base(fp) ? PerlIO_get_base(fp) : 0)));
5023     for (;;) {
5024       screamer:
5025         if (cnt > 0) {
5026             if (rslen) {
5027                 while (cnt > 0) {                    /* this     |  eat */
5028                     cnt--;
5029                     if ((*bp++ = *ptr++) == rslast)  /* really   |  dust */
5030                         goto thats_all_folks;        /* screams  |  sed :-) */
5031                 }
5032             }
5033             else {
5034                 Copy(ptr, bp, cnt, char);            /* this     |  eat */
5035                 bp += cnt;                           /* screams  |  dust */
5036                 ptr += cnt;                          /* louder   |  sed :-) */
5037                 cnt = 0;
5038             }
5039         }
5040         
5041         if (shortbuffered) {            /* oh well, must extend */
5042             cnt = shortbuffered;
5043             shortbuffered = 0;
5044             bpx = bp - (STDCHAR*)SvPVX(sv); /* box up before relocation */
5045             SvCUR_set(sv, bpx);
5046             SvGROW(sv, SvLEN(sv) + append + cnt + 2);
5047             bp = (STDCHAR*)SvPVX(sv) + bpx; /* unbox after relocation */
5048             continue;
5049         }
5050
5051         DEBUG_P(PerlIO_printf(Perl_debug_log,
5052                               "Screamer: going to getc, ptr=%"UVuf", cnt=%ld\n",
5053                               PTR2UV(ptr),(long)cnt));
5054         PerlIO_set_ptrcnt(fp, ptr, cnt); /* deregisterize cnt and ptr */
5055         DEBUG_P(PerlIO_printf(Perl_debug_log,
5056             "Screamer: pre: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
5057             PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp),
5058             PTR2UV(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
5059         /* This used to call 'filbuf' in stdio form, but as that behaves like
5060            getc when cnt <= 0 we use PerlIO_getc here to avoid introducing
5061            another abstraction.  */
5062         i   = PerlIO_getc(fp);          /* get more characters */
5063         DEBUG_P(PerlIO_printf(Perl_debug_log,
5064             "Screamer: post: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
5065             PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp),
5066             PTR2UV(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
5067         cnt = PerlIO_get_cnt(fp);
5068         ptr = (STDCHAR*)PerlIO_get_ptr(fp);     /* reregisterize cnt and ptr */
5069         DEBUG_P(PerlIO_printf(Perl_debug_log,
5070             "Screamer: after getc, ptr=%"UVuf", cnt=%ld\n",PTR2UV(ptr),(long)cnt));
5071
5072         if (i == EOF)                   /* all done for ever? */
5073             goto thats_really_all_folks;
5074
5075         bpx = bp - (STDCHAR*)SvPVX(sv); /* box up before relocation */
5076         SvCUR_set(sv, bpx);
5077         SvGROW(sv, bpx + cnt + 2);
5078         bp = (STDCHAR*)SvPVX(sv) + bpx; /* unbox after relocation */
5079
5080         *bp++ = i;                      /* store character from PerlIO_getc */
5081
5082         if (rslen && (STDCHAR)i == rslast)  /* all done for now? */
5083             goto thats_all_folks;
5084     }
5085
5086 thats_all_folks:
5087     if ((rslen > 1 && (bp - (STDCHAR*)SvPVX(sv) < rslen)) ||
5088           memNE((char*)bp - rslen, rsptr, rslen))
5089         goto screamer;                          /* go back to the fray */
5090 thats_really_all_folks:
5091     if (shortbuffered)
5092         cnt += shortbuffered;
5093         DEBUG_P(PerlIO_printf(Perl_debug_log,
5094             "Screamer: quitting, ptr=%"UVuf", cnt=%ld\n",PTR2UV(ptr),(long)cnt));
5095     PerlIO_set_ptrcnt(fp, ptr, cnt);    /* put these back or we're in trouble */
5096     DEBUG_P(PerlIO_printf(Perl_debug_log,
5097         "Screamer: end: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
5098         PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp),
5099         PTR2UV(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
5100     *bp = '\0';
5101     SvCUR_set(sv, bp - (STDCHAR*)SvPVX(sv));    /* set length */
5102     DEBUG_P(PerlIO_printf(Perl_debug_log,
5103         "Screamer: done, len=%ld, string=|%.*s|\n",
5104         (long)SvCUR(sv),(int)SvCUR(sv),SvPVX(sv)));
5105     }
5106    else
5107     {
5108 #ifndef EPOC
5109        /*The big, slow, and stupid way */
5110         STDCHAR buf[8192];
5111 #else
5112         /* Need to work around EPOC SDK features          */
5113         /* On WINS: MS VC5 generates calls to _chkstk,    */
5114         /* if a `large' stack frame is allocated          */
5115         /* gcc on MARM does not generate calls like these */
5116         STDCHAR buf[1024];
5117 #endif
5118
5119 screamer2:
5120         if (rslen) {
5121             register STDCHAR *bpe = buf + sizeof(buf);
5122             bp = buf;
5123             while ((i = PerlIO_getc(fp)) != EOF && (*bp++ = i) != rslast && bp < bpe)
5124                 ; /* keep reading */
5125             cnt = bp - buf;
5126         }
5127         else {
5128             cnt = PerlIO_read(fp,(char*)buf, sizeof(buf));
5129             /* Accomodate broken VAXC compiler, which applies U8 cast to
5130              * both args of ?: operator, causing EOF to change into 255
5131              */
5132             if (cnt) { i = (U8)buf[cnt - 1]; } else { i = EOF; }
5133         }
5134
5135         if (append)
5136             sv_catpvn(sv, (char *) buf, cnt);
5137         else
5138             sv_setpvn(sv, (char *) buf, cnt);
5139
5140         if (i != EOF &&                 /* joy */
5141             (!rslen ||
5142              SvCUR(sv) < rslen ||
5143              memNE(SvPVX(sv) + SvCUR(sv) - rslen, rsptr, rslen)))
5144         {
5145             append = -1;
5146             /*
5147              * If we're reading from a TTY and we get a short read,
5148              * indicating that the user hit his EOF character, we need
5149              * to notice it now, because if we try to read from the TTY
5150              * again, the EOF condition will disappear.
5151              *
5152              * The comparison of cnt to sizeof(buf) is an optimization
5153              * that prevents unnecessary calls to feof().
5154              *
5155              * - jik 9/25/96
5156              */
5157             if (!(cnt < sizeof(buf) && PerlIO_eof(fp)))
5158                 goto screamer2;
5159         }
5160     }
5161
5162     if (RsPARA(PL_rs)) {                /* have to do this both before and after */
5163         while (i != EOF) {      /* to make sure file boundaries work right */
5164             i = PerlIO_getc(fp);
5165             if (i != '\n') {
5166                 PerlIO_ungetc(fp,i);
5167                 break;
5168             }
5169         }
5170     }
5171
5172     if (PerlIO_isutf8(fp))
5173         SvUTF8_on(sv);
5174     else
5175         SvUTF8_off(sv);
5176
5177     return (SvCUR(sv) - append) ? SvPVX(sv) : Nullch;
5178 }
5179
5180
5181 /*
5182 =for apidoc sv_inc
5183
5184 Auto-increment of the value in the SV.
5185
5186 =cut
5187 */
5188
5189 void
5190 Perl_sv_inc(pTHX_ register SV *sv)
5191 {
5192     register char *d;
5193     int flags;
5194
5195     if (!sv)
5196         return;
5197     if (SvGMAGICAL(sv))
5198         mg_get(sv);
5199     if (SvTHINKFIRST(sv)) {
5200         if (SvREADONLY(sv)) {
5201             if (PL_curcop != &PL_compiling)
5202                 Perl_croak(aTHX_ PL_no_modify);
5203         }
5204         if (SvROK(sv)) {
5205             IV i;
5206             if (SvAMAGIC(sv) && AMG_CALLun(sv,inc))
5207                 return;
5208             i = PTR2IV(SvRV(sv));
5209             sv_unref(sv);
5210             sv_setiv(sv, i);
5211         }
5212     }
5213     flags = SvFLAGS(sv);
5214     if ((flags & (SVp_NOK|SVp_IOK)) == SVp_NOK) {
5215         /* It's (privately or publicly) a float, but not tested as an
5216            integer, so test it to see. */
5217         (void) SvIV(sv); 
5218         flags = SvFLAGS(sv);
5219     }
5220     if ((flags & SVf_IOK) || ((flags & (SVp_IOK | SVp_NOK)) == SVp_IOK)) {
5221         /* It's publicly an integer, or privately an integer-not-float */
5222       oops_its_int:
5223         if (SvIsUV(sv)) {
5224             if (SvUVX(sv) == UV_MAX)
5225                 sv_setnv(sv, (NV)UV_MAX + 1.0);
5226             else
5227                 (void)SvIOK_only_UV(sv);
5228                 ++SvUVX(sv);
5229         } else {
5230             if (SvIVX(sv) == IV_MAX)
5231                 sv_setuv(sv, (UV)IV_MAX + 1);
5232             else {
5233                 (void)SvIOK_only(sv);
5234                 ++SvIVX(sv);
5235             }   
5236         }
5237         return;
5238     }
5239     if (flags & SVp_NOK) {
5240         (void)SvNOK_only(sv);
5241         SvNVX(sv) += 1.0;
5242         return;
5243     }
5244
5245     if (!(flags & SVp_POK) || !*SvPVX(sv)) {
5246         if ((flags & SVTYPEMASK) < SVt_PVIV)
5247             sv_upgrade(sv, SVt_IV);
5248         (void)SvIOK_only(sv);
5249         SvIVX(sv) = 1;
5250         return;
5251     }
5252     d = SvPVX(sv);
5253     while (isALPHA(*d)) d++;
5254     while (isDIGIT(*d)) d++;
5255     if (*d) {
5256 #ifdef PERL_PRESERVE_IVUV
5257         /* Got to punt this an an integer if needs be, but we don't issue
5258            warnings. Probably ought to make the sv_iv_please() that does
5259            the conversion if possible, and silently.  */
5260         I32 numtype = looks_like_number(sv);
5261         if (numtype && !(numtype & IS_NUMBER_INFINITY)) {
5262             /* Need to try really hard to see if it's an integer.
5263                9.22337203685478e+18 is an integer.
5264                but "9.22337203685478e+18" + 0 is UV=9223372036854779904
5265                so $a="9.22337203685478e+18"; $a+0; $a++
5266                needs to be the same as $a="9.22337203685478e+18"; $a++
5267                or we go insane. */
5268             
5269             (void) sv_2iv(sv);
5270             if (SvIOK(sv))
5271                 goto oops_its_int;
5272
5273             /* sv_2iv *should* have made this an NV */
5274             if (flags & SVp_NOK) {
5275                 (void)SvNOK_only(sv);
5276                 SvNVX(sv) += 1.0;
5277                 return;
5278             }
5279             /* I don't think we can get here. Maybe I should assert this
5280                And if we do get here I suspect that sv_setnv will croak. NWC
5281                Fall through. */
5282 #if defined(USE_LONG_DOUBLE)
5283             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",
5284                                   SvPVX(sv), SvIVX(sv), SvNVX(sv)));
5285 #else
5286             DEBUG_c(PerlIO_printf(Perl_debug_log,"sv_inc punt failed to convert '%s' to IOK or NOKp, UV=0x%"UVxf" NV=%g\n",
5287                                   SvPVX(sv), SvIVX(sv), SvNVX(sv)));
5288 #endif
5289         }
5290 #endif /* PERL_PRESERVE_IVUV */
5291         sv_setnv(sv,Atof(SvPVX(sv)) + 1.0);
5292         return;
5293     }
5294     d--;
5295     while (d >= SvPVX(sv)) {
5296         if (isDIGIT(*d)) {
5297             if (++*d <= '9')
5298                 return;
5299             *(d--) = '0';
5300         }
5301         else {
5302 #ifdef EBCDIC
5303             /* MKS: The original code here died if letters weren't consecutive.
5304              * at least it didn't have to worry about non-C locales.  The
5305              * new code assumes that ('z'-'a')==('Z'-'A'), letters are
5306              * arranged in order (although not consecutively) and that only
5307              * [A-Za-z] are accepted by isALPHA in the C locale.
5308              */
5309             if (*d != 'z' && *d != 'Z') {
5310                 do { ++*d; } while (!isALPHA(*d));
5311                 return;
5312             }
5313             *(d--) -= 'z' - 'a';
5314 #else
5315             ++*d;
5316             if (isALPHA(*d))
5317                 return;
5318             *(d--) -= 'z' - 'a' + 1;
5319 #endif
5320         }
5321     }
5322     /* oh,oh, the number grew */
5323     SvGROW(sv, SvCUR(sv) + 2);
5324     SvCUR(sv)++;
5325     for (d = SvPVX(sv) + SvCUR(sv); d > SvPVX(sv); d--)
5326         *d = d[-1];
5327     if (isDIGIT(d[1]))
5328         *d = '1';
5329     else
5330         *d = d[1];
5331 }
5332
5333 /*
5334 =for apidoc sv_dec
5335
5336 Auto-decrement of the value in the SV.
5337
5338 =cut
5339 */
5340
5341 void
5342 Perl_sv_dec(pTHX_ register SV *sv)
5343 {
5344     int flags;
5345
5346     if (!sv)
5347         return;
5348     if (SvGMAGICAL(sv))
5349         mg_get(sv);
5350     if (SvTHINKFIRST(sv)) {
5351         if (SvREADONLY(sv)) {
5352             if (PL_curcop != &PL_compiling)
5353                 Perl_croak(aTHX_ PL_no_modify);
5354         }
5355         if (SvROK(sv)) {
5356             IV i;
5357             if (SvAMAGIC(sv) && AMG_CALLun(sv,dec))
5358                 return;
5359             i = PTR2IV(SvRV(sv));
5360             sv_unref(sv);
5361             sv_setiv(sv, i);
5362         }
5363     }
5364     /* Unlike sv_inc we don't have to worry about string-never-numbers
5365        and keeping them magic. But we mustn't warn on punting */
5366     flags = SvFLAGS(sv);
5367     if ((flags & SVf_IOK) || ((flags & (SVp_IOK | SVp_NOK)) == SVp_IOK)) {
5368         /* It's publicly an integer, or privately an integer-not-float */
5369       oops_its_int:
5370         if (SvIsUV(sv)) {
5371             if (SvUVX(sv) == 0) {
5372                 (void)SvIOK_only(sv);
5373                 SvIVX(sv) = -1;
5374             }
5375             else {
5376                 (void)SvIOK_only_UV(sv);
5377                 --SvUVX(sv);
5378             }   
5379         } else {
5380             if (SvIVX(sv) == IV_MIN)
5381                 sv_setnv(sv, (NV)IV_MIN - 1.0);
5382             else {
5383                 (void)SvIOK_only(sv);
5384                 --SvIVX(sv);
5385             }   
5386         }
5387         return;
5388     }
5389     if (flags & SVp_NOK) {
5390         SvNVX(sv) -= 1.0;
5391         (void)SvNOK_only(sv);
5392         return;
5393     }
5394     if (!(flags & SVp_POK)) {
5395         if ((flags & SVTYPEMASK) < SVt_PVNV)
5396             sv_upgrade(sv, SVt_NV);
5397         SvNVX(sv) = -1.0;
5398         (void)SvNOK_only(sv);
5399         return;
5400     }
5401 #ifdef PERL_PRESERVE_IVUV
5402     {
5403         I32 numtype = looks_like_number(sv);
5404         if (numtype && !(numtype & IS_NUMBER_INFINITY)) {
5405             /* Need to try really hard to see if it's an integer.
5406                9.22337203685478e+18 is an integer.
5407                but "9.22337203685478e+18" + 0 is UV=9223372036854779904
5408                so $a="9.22337203685478e+18"; $a+0; $a--
5409                needs to be the same as $a="9.22337203685478e+18"; $a--
5410                or we go insane. */
5411             
5412             (void) sv_2iv(sv);
5413             if (SvIOK(sv))
5414                 goto oops_its_int;
5415
5416             /* sv_2iv *should* have made this an NV */
5417             if (flags & SVp_NOK) {
5418                 (void)SvNOK_only(sv);
5419                 SvNVX(sv) -= 1.0;
5420                 return;
5421             }
5422             /* I don't think we can get here. Maybe I should assert this
5423                And if we do get here I suspect that sv_setnv will croak. NWC
5424                Fall through. */
5425 #if defined(USE_LONG_DOUBLE)
5426             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",
5427                                   SvPVX(sv), SvIVX(sv), SvNVX(sv)));
5428 #else
5429             DEBUG_c(PerlIO_printf(Perl_debug_log,"sv_dec punt failed to convert '%s' to IOK or NOKp, UV=0x%"UVxf" NV=%g\n",
5430                                   SvPVX(sv), SvIVX(sv), SvNVX(sv)));
5431 #endif
5432         }
5433     }
5434 #endif /* PERL_PRESERVE_IVUV */
5435     sv_setnv(sv,Atof(SvPVX(sv)) - 1.0); /* punt */
5436 }
5437
5438 /*
5439 =for apidoc sv_mortalcopy
5440
5441 Creates a new SV which is a copy of the original SV.  The new SV is marked
5442 as mortal.
5443
5444 =cut
5445 */
5446
5447 /* Make a string that will exist for the duration of the expression
5448  * evaluation.  Actually, it may have to last longer than that, but
5449  * hopefully we won't free it until it has been assigned to a
5450  * permanent location. */
5451
5452 SV *
5453 Perl_sv_mortalcopy(pTHX_ SV *oldstr)
5454 {
5455     register SV *sv;
5456
5457     new_SV(sv);
5458     sv_setsv(sv,oldstr);
5459     EXTEND_MORTAL(1);
5460     PL_tmps_stack[++PL_tmps_ix] = sv;
5461     SvTEMP_on(sv);
5462     return sv;
5463 }
5464
5465 /*
5466 =for apidoc sv_newmortal
5467
5468 Creates a new SV which is mortal.  The reference count of the SV is set to 1.
5469
5470 =cut
5471 */
5472
5473 SV *
5474 Perl_sv_newmortal(pTHX)
5475 {
5476     register SV *sv;
5477
5478     new_SV(sv);
5479     SvFLAGS(sv) = SVs_TEMP;
5480     EXTEND_MORTAL(1);
5481     PL_tmps_stack[++PL_tmps_ix] = sv;
5482     return sv;
5483 }
5484
5485 /*
5486 =for apidoc sv_2mortal
5487
5488 Marks an SV as mortal.  The SV will be destroyed when the current context
5489 ends.
5490
5491 =cut
5492 */
5493
5494 /* same thing without the copying */
5495
5496 SV *
5497 Perl_sv_2mortal(pTHX_ register SV *sv)
5498 {
5499     if (!sv)
5500         return sv;
5501     if (SvREADONLY(sv) && SvIMMORTAL(sv))
5502         return sv;
5503     EXTEND_MORTAL(1);
5504     PL_tmps_stack[++PL_tmps_ix] = sv;
5505     SvTEMP_on(sv);
5506     return sv;
5507 }
5508
5509 /*
5510 =for apidoc newSVpv
5511
5512 Creates a new SV and copies a string into it.  The reference count for the
5513 SV is set to 1.  If C<len> is zero, Perl will compute the length using
5514 strlen().  For efficiency, consider using C<newSVpvn> instead.
5515
5516 =cut
5517 */
5518
5519 SV *
5520 Perl_newSVpv(pTHX_ const char *s, STRLEN len)
5521 {
5522     register SV *sv;
5523
5524     new_SV(sv);
5525     if (!len)
5526         len = strlen(s);
5527     sv_setpvn(sv,s,len);
5528     return sv;
5529 }
5530
5531 /*
5532 =for apidoc newSVpvn
5533
5534 Creates a new SV and copies a string into it.  The reference count for the
5535 SV is set to 1.  Note that if C<len> is zero, Perl will create a zero length
5536 string.  You are responsible for ensuring that the source string is at least
5537 C<len> bytes long.
5538
5539 =cut
5540 */
5541
5542 SV *
5543 Perl_newSVpvn(pTHX_ const char *s, STRLEN len)
5544 {
5545     register SV *sv;
5546
5547     new_SV(sv);
5548     sv_setpvn(sv,s,len);
5549     return sv;
5550 }
5551
5552 /*
5553 =for apidoc newSVpvn_share
5554
5555 Creates a new SV and populates it with a string from
5556 the string table. Turns on READONLY and FAKE.
5557 The idea here is that as string table is used for shared hash
5558 keys these strings will have SvPVX == HeKEY and hash lookup
5559 will avoid string compare.
5560
5561 =cut
5562 */
5563
5564 SV *
5565 Perl_newSVpvn_share(pTHX_ const char *src, I32 len, U32 hash)
5566 {
5567     register SV *sv;
5568     bool is_utf8 = FALSE;
5569     if (len < 0) {
5570         len = -len;
5571         is_utf8 = TRUE;
5572     }
5573     if (!hash)
5574         PERL_HASH(hash, src, len);
5575     new_SV(sv);
5576     sv_upgrade(sv, SVt_PVIV);
5577     SvPVX(sv) = sharepvn(src, is_utf8?-len:len, hash);
5578     SvCUR(sv) = len;
5579     SvUVX(sv) = hash;
5580     SvLEN(sv) = 0;
5581     SvREADONLY_on(sv);
5582     SvFAKE_on(sv);
5583     SvPOK_on(sv);
5584     if (is_utf8)
5585         SvUTF8_on(sv);
5586     return sv;
5587 }
5588
5589 #if defined(PERL_IMPLICIT_CONTEXT)
5590 SV *
5591 Perl_newSVpvf_nocontext(const char* pat, ...)
5592 {
5593     dTHX;
5594     register SV *sv;
5595     va_list args;
5596     va_start(args, pat);
5597     sv = vnewSVpvf(pat, &args);
5598     va_end(args);
5599     return sv;
5600 }
5601 #endif
5602
5603 /*
5604 =for apidoc newSVpvf
5605
5606 Creates a new SV an initialize it with the string formatted like
5607 C<sprintf>.
5608
5609 =cut
5610 */
5611
5612 SV *
5613 Perl_newSVpvf(pTHX_ const char* pat, ...)
5614 {
5615     register SV *sv;
5616     va_list args;
5617     va_start(args, pat);
5618     sv = vnewSVpvf(pat, &args);
5619     va_end(args);
5620     return sv;
5621 }
5622
5623 SV *
5624 Perl_vnewSVpvf(pTHX_ const char* pat, va_list* args)
5625 {
5626     register SV *sv;
5627     new_SV(sv);
5628     sv_vsetpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*));
5629     return sv;
5630 }
5631
5632 /*
5633 =for apidoc newSVnv
5634
5635 Creates a new SV and copies a floating point value into it.
5636 The reference count for the SV is set to 1.
5637
5638 =cut
5639 */
5640
5641 SV *
5642 Perl_newSVnv(pTHX_ NV n)
5643 {
5644     register SV *sv;
5645
5646     new_SV(sv);
5647     sv_setnv(sv,n);
5648     return sv;
5649 }
5650
5651 /*
5652 =for apidoc newSViv
5653
5654 Creates a new SV and copies an integer into it.  The reference count for the
5655 SV is set to 1.
5656
5657 =cut
5658 */
5659
5660 SV *
5661 Perl_newSViv(pTHX_ IV i)
5662 {
5663     register SV *sv;
5664
5665     new_SV(sv);
5666     sv_setiv(sv,i);
5667     return sv;
5668 }
5669
5670 /*
5671 =for apidoc newSVuv
5672
5673 Creates a new SV and copies an unsigned integer into it.
5674 The reference count for the SV is set to 1.
5675
5676 =cut
5677 */
5678
5679 SV *
5680 Perl_newSVuv(pTHX_ UV u)
5681 {
5682     register SV *sv;
5683
5684     new_SV(sv);
5685     sv_setuv(sv,u);
5686     return sv;
5687 }
5688
5689 /*
5690 =for apidoc newRV_noinc
5691
5692 Creates an RV wrapper for an SV.  The reference count for the original
5693 SV is B<not> incremented.
5694
5695 =cut
5696 */
5697
5698 SV *
5699 Perl_newRV_noinc(pTHX_ SV *tmpRef)
5700 {
5701     register SV *sv;
5702
5703     new_SV(sv);
5704     sv_upgrade(sv, SVt_RV);
5705     SvTEMP_off(tmpRef);
5706     SvRV(sv) = tmpRef;
5707     SvROK_on(sv);
5708     return sv;
5709 }
5710
5711 /* newRV_inc is #defined to newRV in sv.h */
5712 SV *
5713 Perl_newRV(pTHX_ SV *tmpRef)
5714 {
5715     return newRV_noinc(SvREFCNT_inc(tmpRef));
5716 }
5717
5718 /*
5719 =for apidoc newSVsv
5720
5721 Creates a new SV which is an exact duplicate of the original SV.
5722
5723 =cut
5724 */
5725
5726 /* make an exact duplicate of old */
5727
5728 SV *
5729 Perl_newSVsv(pTHX_ register SV *old)
5730 {
5731     register SV *sv;
5732
5733     if (!old)
5734         return Nullsv;
5735     if (SvTYPE(old) == SVTYPEMASK) {
5736         if (ckWARN_d(WARN_INTERNAL))
5737             Perl_warner(aTHX_ WARN_INTERNAL, "semi-panic: attempt to dup freed string");
5738         return Nullsv;
5739     }
5740     new_SV(sv);
5741     if (SvTEMP(old)) {
5742         SvTEMP_off(old);
5743         sv_setsv(sv,old);
5744         SvTEMP_on(old);
5745     }
5746     else
5747         sv_setsv(sv,old);
5748     return sv;
5749 }
5750
5751 void
5752 Perl_sv_reset(pTHX_ register char *s, HV *stash)
5753 {
5754     register HE *entry;
5755     register GV *gv;
5756     register SV *sv;
5757     register I32 i;
5758     register PMOP *pm;
5759     register I32 max;
5760     char todo[PERL_UCHAR_MAX+1];
5761
5762     if (!stash)
5763         return;
5764
5765     if (!*s) {          /* reset ?? searches */
5766         for (pm = HvPMROOT(stash); pm; pm = pm->op_pmnext) {
5767             pm->op_pmdynflags &= ~PMdf_USED;
5768         }
5769         return;
5770     }
5771
5772     /* reset variables */
5773
5774     if (!HvARRAY(stash))
5775         return;
5776
5777     Zero(todo, 256, char);
5778     while (*s) {
5779         i = (unsigned char)*s;
5780         if (s[1] == '-') {
5781             s += 2;
5782         }
5783         max = (unsigned char)*s++;
5784         for ( ; i <= max; i++) {
5785             todo[i] = 1;
5786         }
5787         for (i = 0; i <= (I32) HvMAX(stash); i++) {
5788             for (entry = HvARRAY(stash)[i];
5789                  entry;
5790                  entry = HeNEXT(entry))
5791             {
5792                 if (!todo[(U8)*HeKEY(entry)])
5793                     continue;
5794                 gv = (GV*)HeVAL(entry);
5795                 sv = GvSV(gv);
5796                 if (SvTHINKFIRST(sv)) {
5797                     if (!SvREADONLY(sv) && SvROK(sv))
5798                         sv_unref(sv);
5799                     continue;
5800                 }
5801                 (void)SvOK_off(sv);
5802                 if (SvTYPE(sv) >= SVt_PV) {
5803                     SvCUR_set(sv, 0);
5804                     if (SvPVX(sv) != Nullch)
5805                         *SvPVX(sv) = '\0';
5806                     SvTAINT(sv);
5807                 }
5808                 if (GvAV(gv)) {
5809                     av_clear(GvAV(gv));
5810                 }
5811                 if (GvHV(gv) && !HvNAME(GvHV(gv))) {
5812                     hv_clear(GvHV(gv));
5813 #ifdef USE_ENVIRON_ARRAY
5814                     if (gv == PL_envgv)
5815                         environ[0] = Nullch;
5816 #endif
5817                 }
5818             }
5819         }
5820     }
5821 }
5822
5823 IO*
5824 Perl_sv_2io(pTHX_ SV *sv)
5825 {
5826     IO* io;
5827     GV* gv;
5828     STRLEN n_a;
5829
5830     switch (SvTYPE(sv)) {
5831     case SVt_PVIO:
5832         io = (IO*)sv;
5833         break;
5834     case SVt_PVGV:
5835         gv = (GV*)sv;
5836         io = GvIO(gv);
5837         if (!io)
5838             Perl_croak(aTHX_ "Bad filehandle: %s", GvNAME(gv));
5839         break;
5840     default:
5841         if (!SvOK(sv))
5842             Perl_croak(aTHX_ PL_no_usym, "filehandle");
5843         if (SvROK(sv))
5844             return sv_2io(SvRV(sv));
5845         gv = gv_fetchpv(SvPV(sv,n_a), FALSE, SVt_PVIO);
5846         if (gv)
5847             io = GvIO(gv);
5848         else
5849             io = 0;
5850         if (!io)
5851             Perl_croak(aTHX_ "Bad filehandle: %s", SvPV(sv,n_a));
5852         break;
5853     }
5854     return io;
5855 }
5856
5857 CV *
5858 Perl_sv_2cv(pTHX_ SV *sv, HV **st, GV **gvp, I32 lref)
5859 {
5860     GV *gv;
5861     CV *cv;
5862     STRLEN n_a;
5863
5864     if (!sv)
5865         return *gvp = Nullgv, Nullcv;
5866     switch (SvTYPE(sv)) {
5867     case SVt_PVCV:
5868         *st = CvSTASH(sv);
5869         *gvp = Nullgv;
5870         return (CV*)sv;
5871     case SVt_PVHV:
5872     case SVt_PVAV:
5873         *gvp = Nullgv;
5874         return Nullcv;
5875     case SVt_PVGV:
5876         gv = (GV*)sv;
5877         *gvp = gv;
5878         *st = GvESTASH(gv);
5879         goto fix_gv;
5880
5881     default:
5882         if (SvGMAGICAL(sv))
5883             mg_get(sv);
5884         if (SvROK(sv)) {
5885             SV **sp = &sv;              /* Used in tryAMAGICunDEREF macro. */
5886             tryAMAGICunDEREF(to_cv);
5887
5888             sv = SvRV(sv);
5889             if (SvTYPE(sv) == SVt_PVCV) {
5890                 cv = (CV*)sv;
5891                 *gvp = Nullgv;
5892                 *st = CvSTASH(cv);
5893                 return cv;
5894             }
5895             else if(isGV(sv))
5896                 gv = (GV*)sv;
5897             else
5898                 Perl_croak(aTHX_ "Not a subroutine reference");
5899         }
5900         else if (isGV(sv))
5901             gv = (GV*)sv;
5902         else
5903             gv = gv_fetchpv(SvPV(sv, n_a), lref, SVt_PVCV);
5904         *gvp = gv;
5905         if (!gv)
5906             return Nullcv;
5907         *st = GvESTASH(gv);
5908     fix_gv:
5909         if (lref && !GvCVu(gv)) {
5910             SV *tmpsv;
5911             ENTER;
5912             tmpsv = NEWSV(704,0);
5913             gv_efullname3(tmpsv, gv, Nullch);
5914             /* XXX this is probably not what they think they're getting.
5915              * It has the same effect as "sub name;", i.e. just a forward
5916              * declaration! */
5917             newSUB(start_subparse(FALSE, 0),
5918                    newSVOP(OP_CONST, 0, tmpsv),
5919                    Nullop,
5920                    Nullop);
5921             LEAVE;
5922             if (!GvCVu(gv))
5923                 Perl_croak(aTHX_ "Unable to create sub named \"%s\"", SvPV(sv,n_a));
5924         }
5925         return GvCVu(gv);
5926     }
5927 }
5928
5929 /*
5930 =for apidoc sv_true
5931
5932 Returns true if the SV has a true value by Perl's rules.
5933
5934 =cut
5935 */
5936
5937 I32
5938 Perl_sv_true(pTHX_ register SV *sv)
5939 {
5940     if (!sv)
5941         return 0;
5942     if (SvPOK(sv)) {
5943         register XPV* tXpv;
5944         if ((tXpv = (XPV*)SvANY(sv)) &&
5945                 (tXpv->xpv_cur > 1 ||
5946                 (tXpv->xpv_cur && *tXpv->xpv_pv != '0')))
5947             return 1;
5948         else
5949             return 0;
5950     }
5951     else {
5952         if (SvIOK(sv))
5953             return SvIVX(sv) != 0;
5954         else {
5955             if (SvNOK(sv))
5956                 return SvNVX(sv) != 0.0;
5957             else
5958                 return sv_2bool(sv);
5959         }
5960     }
5961 }
5962
5963 IV
5964 Perl_sv_iv(pTHX_ register SV *sv)
5965 {
5966     if (SvIOK(sv)) {
5967         if (SvIsUV(sv))
5968             return (IV)SvUVX(sv);
5969         return SvIVX(sv);
5970     }
5971     return sv_2iv(sv);
5972 }
5973
5974 UV
5975 Perl_sv_uv(pTHX_ register SV *sv)
5976 {
5977     if (SvIOK(sv)) {
5978         if (SvIsUV(sv))
5979             return SvUVX(sv);
5980         return (UV)SvIVX(sv);
5981     }
5982     return sv_2uv(sv);
5983 }
5984
5985 NV
5986 Perl_sv_nv(pTHX_ register SV *sv)
5987 {
5988     if (SvNOK(sv))
5989         return SvNVX(sv);
5990     return sv_2nv(sv);
5991 }
5992
5993 char *
5994 Perl_sv_pv(pTHX_ SV *sv)
5995 {
5996     STRLEN n_a;
5997
5998     if (SvPOK(sv))
5999         return SvPVX(sv);
6000
6001     return sv_2pv(sv, &n_a);
6002 }
6003
6004 char *
6005 Perl_sv_pvn(pTHX_ SV *sv, STRLEN *lp)
6006 {
6007     if (SvPOK(sv)) {
6008         *lp = SvCUR(sv);
6009         return SvPVX(sv);
6010     }
6011     return sv_2pv(sv, lp);
6012 }
6013
6014 /*
6015 =for apidoc sv_pvn_force
6016
6017 Get a sensible string out of the SV somehow.
6018
6019 =cut
6020 */
6021
6022 char *
6023 Perl_sv_pvn_force(pTHX_ SV *sv, STRLEN *lp)
6024 {
6025     char *s;
6026
6027     if (SvTHINKFIRST(sv) && !SvROK(sv))
6028         sv_force_normal(sv);
6029
6030     if (SvPOK(sv)) {
6031         *lp = SvCUR(sv);
6032     }
6033     else {
6034         if (SvTYPE(sv) > SVt_PVLV && SvTYPE(sv) != SVt_PVFM) {
6035             Perl_croak(aTHX_ "Can't coerce %s to string in %s", sv_reftype(sv,0),
6036                 PL_op_name[PL_op->op_type]);
6037         }
6038         else
6039             s = sv_2pv(sv, lp);
6040         if (s != SvPVX(sv)) {   /* Almost, but not quite, sv_setpvn() */
6041             STRLEN len = *lp;
6042         
6043             if (SvROK(sv))
6044                 sv_unref(sv);
6045             (void)SvUPGRADE(sv, SVt_PV);                /* Never FALSE */
6046             SvGROW(sv, len + 1);
6047             Move(s,SvPVX(sv),len,char);
6048             SvCUR_set(sv, len);
6049             *SvEND(sv) = '\0';
6050         }
6051         if (!SvPOK(sv)) {
6052             SvPOK_on(sv);               /* validate pointer */
6053             SvTAINT(sv);
6054             DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2pv(%s)\n",
6055                                   PTR2UV(sv),SvPVX(sv)));
6056         }
6057     }
6058     return SvPVX(sv);
6059 }
6060
6061 char *
6062 Perl_sv_pvbyte(pTHX_ SV *sv)
6063 {
6064     return sv_pv(sv);
6065 }
6066
6067 char *
6068 Perl_sv_pvbyten(pTHX_ SV *sv, STRLEN *lp)
6069 {
6070     return sv_pvn(sv,lp);
6071 }
6072
6073 char *
6074 Perl_sv_pvbyten_force(pTHX_ SV *sv, STRLEN *lp)
6075 {
6076     return sv_pvn_force(sv,lp);
6077 }
6078
6079 char *
6080 Perl_sv_pvutf8(pTHX_ SV *sv)
6081 {
6082     sv_utf8_upgrade(sv);
6083     return sv_pv(sv);
6084 }
6085
6086 char *
6087 Perl_sv_pvutf8n(pTHX_ SV *sv, STRLEN *lp)
6088 {
6089     sv_utf8_upgrade(sv);
6090     return sv_pvn(sv,lp);
6091 }
6092
6093 /*
6094 =for apidoc sv_pvutf8n_force
6095
6096 Get a sensible UTF8-encoded string out of the SV somehow. See
6097 L</sv_pvn_force>.
6098
6099 =cut
6100 */
6101
6102 char *
6103 Perl_sv_pvutf8n_force(pTHX_ SV *sv, STRLEN *lp)
6104 {
6105     sv_utf8_upgrade(sv);
6106     return sv_pvn_force(sv,lp);
6107 }
6108
6109 /*
6110 =for apidoc sv_reftype
6111
6112 Returns a string describing what the SV is a reference to.
6113
6114 =cut
6115 */
6116
6117 char *
6118 Perl_sv_reftype(pTHX_ SV *sv, int ob)
6119 {
6120     if (ob && SvOBJECT(sv))
6121         return HvNAME(SvSTASH(sv));
6122     else {
6123         switch (SvTYPE(sv)) {
6124         case SVt_NULL:
6125         case SVt_IV:
6126         case SVt_NV:
6127         case SVt_RV:
6128         case SVt_PV:
6129         case SVt_PVIV:
6130         case SVt_PVNV:
6131         case SVt_PVMG:
6132         case SVt_PVBM:
6133                                 if (SvROK(sv))
6134                                     return "REF";
6135                                 else
6136                                     return "SCALAR";
6137         case SVt_PVLV:          return "LVALUE";
6138         case SVt_PVAV:          return "ARRAY";
6139         case SVt_PVHV:          return "HASH";
6140         case SVt_PVCV:          return "CODE";
6141         case SVt_PVGV:          return "GLOB";
6142         case SVt_PVFM:          return "FORMAT";
6143         case SVt_PVIO:          return "IO";
6144         default:                return "UNKNOWN";
6145         }
6146     }
6147 }
6148
6149 /*
6150 =for apidoc sv_isobject
6151
6152 Returns a boolean indicating whether the SV is an RV pointing to a blessed
6153 object.  If the SV is not an RV, or if the object is not blessed, then this
6154 will return false.
6155
6156 =cut
6157 */
6158
6159 int
6160 Perl_sv_isobject(pTHX_ SV *sv)
6161 {
6162     if (!sv)
6163         return 0;
6164     if (SvGMAGICAL(sv))
6165         mg_get(sv);
6166     if (!SvROK(sv))
6167         return 0;
6168     sv = (SV*)SvRV(sv);
6169     if (!SvOBJECT(sv))
6170         return 0;
6171     return 1;
6172 }
6173
6174 /*
6175 =for apidoc sv_isa
6176
6177 Returns a boolean indicating whether the SV is blessed into the specified
6178 class.  This does not check for subtypes; use C<sv_derived_from> to verify
6179 an inheritance relationship.
6180
6181 =cut
6182 */
6183
6184 int
6185 Perl_sv_isa(pTHX_ SV *sv, const char *name)
6186 {
6187     if (!sv)
6188         return 0;
6189     if (SvGMAGICAL(sv))
6190         mg_get(sv);
6191     if (!SvROK(sv))
6192         return 0;
6193     sv = (SV*)SvRV(sv);
6194     if (!SvOBJECT(sv))
6195         return 0;
6196
6197     return strEQ(HvNAME(SvSTASH(sv)), name);
6198 }
6199
6200 /*
6201 =for apidoc newSVrv
6202
6203 Creates a new SV for the RV, C<rv>, to point to.  If C<rv> is not an RV then
6204 it will be upgraded to one.  If C<classname> is non-null then the new SV will
6205 be blessed in the specified package.  The new SV is returned and its
6206 reference count is 1.
6207
6208 =cut
6209 */
6210
6211 SV*
6212 Perl_newSVrv(pTHX_ SV *rv, const char *classname)
6213 {
6214     SV *sv;
6215
6216     new_SV(sv);
6217
6218     SV_CHECK_THINKFIRST(rv);
6219     SvAMAGIC_off(rv);
6220
6221     if (SvTYPE(rv) >= SVt_PVMG) {
6222         U32 refcnt = SvREFCNT(rv);
6223         SvREFCNT(rv) = 0;
6224         sv_clear(rv);
6225         SvFLAGS(rv) = 0;
6226         SvREFCNT(rv) = refcnt;
6227     }
6228
6229     if (SvTYPE(rv) < SVt_RV)
6230         sv_upgrade(rv, SVt_RV);
6231     else if (SvTYPE(rv) > SVt_RV) {
6232         (void)SvOOK_off(rv);
6233         if (SvPVX(rv) && SvLEN(rv))
6234             Safefree(SvPVX(rv));
6235         SvCUR_set(rv, 0);
6236         SvLEN_set(rv, 0);
6237     }
6238
6239     (void)SvOK_off(rv);
6240     SvRV(rv) = sv;
6241     SvROK_on(rv);
6242
6243     if (classname) {
6244         HV* stash = gv_stashpv(classname, TRUE);
6245         (void)sv_bless(rv, stash);
6246     }
6247     return sv;
6248 }
6249
6250 /*
6251 =for apidoc sv_setref_pv
6252
6253 Copies a pointer into a new SV, optionally blessing the SV.  The C<rv>
6254 argument will be upgraded to an RV.  That RV will be modified to point to
6255 the new SV.  If the C<pv> argument is NULL then C<PL_sv_undef> will be placed
6256 into the SV.  The C<classname> argument indicates the package for the
6257 blessing.  Set C<classname> to C<Nullch> to avoid the blessing.  The new SV
6258 will be returned and will have a reference count of 1.
6259
6260 Do not use with other Perl types such as HV, AV, SV, CV, because those
6261 objects will become corrupted by the pointer copy process.
6262
6263 Note that C<sv_setref_pvn> copies the string while this copies the pointer.
6264
6265 =cut
6266 */
6267
6268 SV*
6269 Perl_sv_setref_pv(pTHX_ SV *rv, const char *classname, void *pv)
6270 {
6271     if (!pv) {
6272         sv_setsv(rv, &PL_sv_undef);
6273         SvSETMAGIC(rv);
6274     }
6275     else
6276         sv_setiv(newSVrv(rv,classname), PTR2IV(pv));
6277     return rv;
6278 }
6279
6280 /*
6281 =for apidoc sv_setref_iv
6282
6283 Copies an integer into a new SV, optionally blessing the SV.  The C<rv>
6284 argument will be upgraded to an RV.  That RV will be modified to point to
6285 the new SV.  The C<classname> argument indicates the package for the
6286 blessing.  Set C<classname> to C<Nullch> to avoid the blessing.  The new SV
6287 will be returned and will have a reference count of 1.
6288
6289 =cut
6290 */
6291
6292 SV*
6293 Perl_sv_setref_iv(pTHX_ SV *rv, const char *classname, IV iv)
6294 {
6295     sv_setiv(newSVrv(rv,classname), iv);
6296     return rv;
6297 }
6298
6299 /*
6300 =for apidoc sv_setref_nv
6301
6302 Copies a double into a new SV, optionally blessing the SV.  The C<rv>
6303 argument will be upgraded to an RV.  That RV will be modified to point to
6304 the new SV.  The C<classname> argument indicates the package for the
6305 blessing.  Set C<classname> to C<Nullch> to avoid the blessing.  The new SV
6306 will be returned and will have a reference count of 1.
6307
6308 =cut
6309 */
6310
6311 SV*
6312 Perl_sv_setref_nv(pTHX_ SV *rv, const char *classname, NV nv)
6313 {
6314     sv_setnv(newSVrv(rv,classname), nv);
6315     return rv;
6316 }
6317
6318 /*
6319 =for apidoc sv_setref_pvn
6320
6321 Copies a string into a new SV, optionally blessing the SV.  The length of the
6322 string must be specified with C<n>.  The C<rv> argument will be upgraded to
6323 an RV.  That RV will be modified to point to the new SV.  The C<classname>
6324 argument indicates the package for the blessing.  Set C<classname> to
6325 C<Nullch> to avoid the blessing.  The new SV will be returned and will have
6326 a reference count of 1.
6327
6328 Note that C<sv_setref_pv> copies the pointer while this copies the string.
6329
6330 =cut
6331 */
6332
6333 SV*
6334 Perl_sv_setref_pvn(pTHX_ SV *rv, const char *classname, char *pv, STRLEN n)
6335 {
6336     sv_setpvn(newSVrv(rv,classname), pv, n);
6337     return rv;
6338 }
6339
6340 /*
6341 =for apidoc sv_bless
6342
6343 Blesses an SV into a specified package.  The SV must be an RV.  The package
6344 must be designated by its stash (see C<gv_stashpv()>).  The reference count
6345 of the SV is unaffected.
6346
6347 =cut
6348 */
6349
6350 SV*
6351 Perl_sv_bless(pTHX_ SV *sv, HV *stash)
6352 {
6353     SV *tmpRef;
6354     if (!SvROK(sv))
6355         Perl_croak(aTHX_ "Can't bless non-reference value");
6356     tmpRef = SvRV(sv);
6357     if (SvFLAGS(tmpRef) & (SVs_OBJECT|SVf_READONLY)) {
6358         if (SvREADONLY(tmpRef))
6359             Perl_croak(aTHX_ PL_no_modify);
6360         if (SvOBJECT(tmpRef)) {
6361             if (SvTYPE(tmpRef) != SVt_PVIO)
6362                 --PL_sv_objcount;
6363             SvREFCNT_dec(SvSTASH(tmpRef));
6364         }
6365     }
6366     SvOBJECT_on(tmpRef);
6367     if (SvTYPE(tmpRef) != SVt_PVIO)
6368         ++PL_sv_objcount;
6369     (void)SvUPGRADE(tmpRef, SVt_PVMG);
6370     SvSTASH(tmpRef) = (HV*)SvREFCNT_inc(stash);
6371
6372     if (Gv_AMG(stash))
6373         SvAMAGIC_on(sv);
6374     else
6375         SvAMAGIC_off(sv);
6376
6377     return sv;
6378 }
6379
6380 STATIC void
6381 S_sv_unglob(pTHX_ SV *sv)
6382 {
6383     void *xpvmg;
6384
6385     assert(SvTYPE(sv) == SVt_PVGV);
6386     SvFAKE_off(sv);
6387     if (GvGP(sv))
6388         gp_free((GV*)sv);
6389     if (GvSTASH(sv)) {
6390         SvREFCNT_dec(GvSTASH(sv));
6391         GvSTASH(sv) = Nullhv;
6392     }
6393     sv_unmagic(sv, '*');
6394     Safefree(GvNAME(sv));
6395     GvMULTI_off(sv);
6396
6397     /* need to keep SvANY(sv) in the right arena */
6398     xpvmg = new_XPVMG();
6399     StructCopy(SvANY(sv), xpvmg, XPVMG);
6400     del_XPVGV(SvANY(sv));
6401     SvANY(sv) = xpvmg;
6402
6403     SvFLAGS(sv) &= ~SVTYPEMASK;
6404     SvFLAGS(sv) |= SVt_PVMG;
6405 }
6406
6407 /*
6408 =for apidoc sv_unref_flags
6409
6410 Unsets the RV status of the SV, and decrements the reference count of
6411 whatever was being referenced by the RV.  This can almost be thought of
6412 as a reversal of C<newSVrv>.  The C<cflags> argument can contain
6413 C<SV_IMMEDIATE_UNREF> to force the reference count to be decremented
6414 (otherwise the decrementing is conditional on the reference count being
6415 different from one or the reference being a readonly SV).
6416 See C<SvROK_off>.
6417
6418 =cut
6419 */
6420
6421 void
6422 Perl_sv_unref_flags(pTHX_ SV *sv, U32 flags)
6423 {
6424     SV* rv = SvRV(sv);
6425
6426     if (SvWEAKREF(sv)) {
6427         sv_del_backref(sv);
6428         SvWEAKREF_off(sv);
6429         SvRV(sv) = 0;
6430         return;
6431     }
6432     SvRV(sv) = 0;
6433     SvROK_off(sv);
6434     if (SvREFCNT(rv) != 1 || SvREADONLY(rv) || flags) /* SV_IMMEDIATE_UNREF */
6435         SvREFCNT_dec(rv);
6436     else /* XXX Hack, but hard to make $a=$a->[1] work otherwise */
6437         sv_2mortal(rv);         /* Schedule for freeing later */
6438 }
6439
6440 /*
6441 =for apidoc sv_unref
6442
6443 Unsets the RV status of the SV, and decrements the reference count of
6444 whatever was being referenced by the RV.  This can almost be thought of
6445 as a reversal of C<newSVrv>.  This is C<sv_unref_flags> with the C<flag>
6446 being zero.  See C<SvROK_off>.
6447
6448 =cut
6449 */
6450
6451 void
6452 Perl_sv_unref(pTHX_ SV *sv)
6453 {
6454     sv_unref_flags(sv, 0);
6455 }
6456
6457 void
6458 Perl_sv_taint(pTHX_ SV *sv)
6459 {
6460     sv_magic((sv), Nullsv, 't', Nullch, 0);
6461 }
6462
6463 void
6464 Perl_sv_untaint(pTHX_ SV *sv)
6465 {
6466     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv)) {
6467         MAGIC *mg = mg_find(sv, 't');
6468         if (mg)
6469             mg->mg_len &= ~1;
6470     }
6471 }
6472
6473 bool
6474 Perl_sv_tainted(pTHX_ SV *sv)
6475 {
6476     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv)) {
6477         MAGIC *mg = mg_find(sv, 't');
6478         if (mg && ((mg->mg_len & 1) || ((mg->mg_len & 2) && mg->mg_obj == sv)))
6479             return TRUE;
6480     }
6481     return FALSE;
6482 }
6483
6484 /*
6485 =for apidoc sv_setpviv
6486
6487 Copies an integer into the given SV, also updating its string value.
6488 Does not handle 'set' magic.  See C<sv_setpviv_mg>.
6489
6490 =cut
6491 */
6492
6493 void
6494 Perl_sv_setpviv(pTHX_ SV *sv, IV iv)
6495 {
6496     char buf[TYPE_CHARS(UV)];
6497     char *ebuf;
6498     char *ptr = uiv_2buf(buf, iv, 0, 0, &ebuf);
6499
6500     sv_setpvn(sv, ptr, ebuf - ptr);
6501 }
6502
6503
6504 /*
6505 =for apidoc sv_setpviv_mg
6506
6507 Like C<sv_setpviv>, but also handles 'set' magic.
6508
6509 =cut
6510 */
6511
6512 void
6513 Perl_sv_setpviv_mg(pTHX_ SV *sv, IV iv)
6514 {
6515     char buf[TYPE_CHARS(UV)];
6516     char *ebuf;
6517     char *ptr = uiv_2buf(buf, iv, 0, 0, &ebuf);
6518
6519     sv_setpvn(sv, ptr, ebuf - ptr);
6520     SvSETMAGIC(sv);
6521 }
6522
6523 #if defined(PERL_IMPLICIT_CONTEXT)
6524 void
6525 Perl_sv_setpvf_nocontext(SV *sv, const char* pat, ...)
6526 {
6527     dTHX;
6528     va_list args;
6529     va_start(args, pat);
6530     sv_vsetpvf(sv, pat, &args);
6531     va_end(args);
6532 }
6533
6534
6535 void
6536 Perl_sv_setpvf_mg_nocontext(SV *sv, const char* pat, ...)
6537 {
6538     dTHX;
6539     va_list args;
6540     va_start(args, pat);
6541     sv_vsetpvf_mg(sv, pat, &args);
6542     va_end(args);
6543 }
6544 #endif
6545
6546 /*
6547 =for apidoc sv_setpvf
6548
6549 Processes its arguments like C<sprintf> and sets an SV to the formatted
6550 output.  Does not handle 'set' magic.  See C<sv_setpvf_mg>.
6551
6552 =cut
6553 */
6554
6555 void
6556 Perl_sv_setpvf(pTHX_ SV *sv, const char* pat, ...)
6557 {
6558     va_list args;
6559     va_start(args, pat);
6560     sv_vsetpvf(sv, pat, &args);
6561     va_end(args);
6562 }
6563
6564 void
6565 Perl_sv_vsetpvf(pTHX_ SV *sv, const char* pat, va_list* args)
6566 {
6567     sv_vsetpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*));
6568 }
6569
6570 /*
6571 =for apidoc sv_setpvf_mg
6572
6573 Like C<sv_setpvf>, but also handles 'set' magic.
6574
6575 =cut
6576 */
6577
6578 void
6579 Perl_sv_setpvf_mg(pTHX_ SV *sv, const char* pat, ...)
6580 {
6581     va_list args;
6582     va_start(args, pat);
6583     sv_vsetpvf_mg(sv, pat, &args);
6584     va_end(args);
6585 }
6586
6587 void
6588 Perl_sv_vsetpvf_mg(pTHX_ SV *sv, const char* pat, va_list* args)
6589 {
6590     sv_vsetpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*));
6591     SvSETMAGIC(sv);
6592 }
6593
6594 #if defined(PERL_IMPLICIT_CONTEXT)
6595 void
6596 Perl_sv_catpvf_nocontext(SV *sv, const char* pat, ...)
6597 {
6598     dTHX;
6599     va_list args;
6600     va_start(args, pat);
6601     sv_vcatpvf(sv, pat, &args);
6602     va_end(args);
6603 }
6604
6605 void
6606 Perl_sv_catpvf_mg_nocontext(SV *sv, const char* pat, ...)
6607 {
6608     dTHX;
6609     va_list args;
6610     va_start(args, pat);
6611     sv_vcatpvf_mg(sv, pat, &args);
6612     va_end(args);
6613 }
6614 #endif
6615
6616 /*
6617 =for apidoc sv_catpvf
6618
6619 Processes its arguments like C<sprintf> and appends the formatted output
6620 to an SV.  Handles 'get' magic, but not 'set' magic.  C<SvSETMAGIC()> must
6621 typically be called after calling this function to handle 'set' magic.
6622
6623 =cut
6624 */
6625
6626 void
6627 Perl_sv_catpvf(pTHX_ SV *sv, const char* pat, ...)
6628 {
6629     va_list args;
6630     va_start(args, pat);
6631     sv_vcatpvf(sv, pat, &args);
6632     va_end(args);
6633 }
6634
6635 void
6636 Perl_sv_vcatpvf(pTHX_ SV *sv, const char* pat, va_list* args)
6637 {
6638     sv_vcatpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*));
6639 }
6640
6641 /*
6642 =for apidoc sv_catpvf_mg
6643
6644 Like C<sv_catpvf>, but also handles 'set' magic.
6645
6646 =cut
6647 */
6648
6649 void
6650 Perl_sv_catpvf_mg(pTHX_ SV *sv, const char* pat, ...)
6651 {
6652     va_list args;
6653     va_start(args, pat);
6654     sv_vcatpvf_mg(sv, pat, &args);
6655     va_end(args);
6656 }
6657
6658 void
6659 Perl_sv_vcatpvf_mg(pTHX_ SV *sv, const char* pat, va_list* args)
6660 {
6661     sv_vcatpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*));
6662     SvSETMAGIC(sv);
6663 }
6664
6665 /*
6666 =for apidoc sv_vsetpvfn
6667
6668 Works like C<vcatpvfn> but copies the text into the SV instead of
6669 appending it.
6670
6671 =cut
6672 */
6673
6674 void
6675 Perl_sv_vsetpvfn(pTHX_ SV *sv, const char *pat, STRLEN patlen, va_list *args, SV **svargs, I32 svmax, bool *maybe_tainted)
6676 {
6677     sv_setpvn(sv, "", 0);
6678     sv_vcatpvfn(sv, pat, patlen, args, svargs, svmax, maybe_tainted);
6679 }
6680
6681 /*
6682 =for apidoc sv_vcatpvfn
6683
6684 Processes its arguments like C<vsprintf> and appends the formatted output
6685 to an SV.  Uses an array of SVs if the C style variable argument list is
6686 missing (NULL).  When running with taint checks enabled, indicates via
6687 C<maybe_tainted> if results are untrustworthy (often due to the use of
6688 locales).
6689
6690 =cut
6691 */
6692
6693 void
6694 Perl_sv_vcatpvfn(pTHX_ SV *sv, const char *pat, STRLEN patlen, va_list *args, SV **svargs, I32 svmax, bool *maybe_tainted)
6695 {
6696     char *p;
6697     char *q;
6698     char *patend;
6699     STRLEN origlen;
6700     I32 svix = 0;
6701     static char nullstr[] = "(null)";
6702     SV *argsv;
6703
6704     /* no matter what, this is a string now */
6705     (void)SvPV_force(sv, origlen);
6706
6707     /* special-case "", "%s", and "%_" */
6708     if (patlen == 0)
6709         return;
6710     if (patlen == 2 && pat[0] == '%') {
6711         switch (pat[1]) {
6712         case 's':
6713             if (args) {
6714                 char *s = va_arg(*args, char*);
6715                 sv_catpv(sv, s ? s : nullstr);
6716             }
6717             else if (svix < svmax) {
6718                 sv_catsv(sv, *svargs);
6719                 if (DO_UTF8(*svargs))
6720                     SvUTF8_on(sv);
6721             }
6722             return;
6723         case '_':
6724             if (args) {
6725                 argsv = va_arg(*args, SV*);
6726                 sv_catsv(sv, argsv);
6727                 if (DO_UTF8(argsv))
6728                     SvUTF8_on(sv);
6729                 return;
6730             }
6731             /* See comment on '_' below */
6732             break;
6733         }
6734     }
6735
6736     patend = (char*)pat + patlen;
6737     for (p = (char*)pat; p < patend; p = q) {
6738         bool alt = FALSE;
6739         bool left = FALSE;
6740         bool vectorize = FALSE;
6741         bool utf = FALSE;
6742         char fill = ' ';
6743         char plus = 0;
6744         char intsize = 0;
6745         STRLEN width = 0;
6746         STRLEN zeros = 0;
6747         bool has_precis = FALSE;
6748         STRLEN precis = 0;
6749         bool is_utf = FALSE;
6750         
6751         char esignbuf[4];
6752         U8 utf8buf[UTF8_MAXLEN+1];
6753         STRLEN esignlen = 0;
6754
6755         char *eptr = Nullch;
6756         STRLEN elen = 0;
6757         /* Times 4: a decimal digit takes more than 3 binary digits.
6758          * NV_DIG: mantissa takes than many decimal digits.
6759          * Plus 32: Playing safe. */
6760         char ebuf[IV_DIG * 4 + NV_DIG + 32];
6761         /* large enough for "%#.#f" --chip */
6762         /* what about long double NVs? --jhi */
6763
6764         SV *vecsv;
6765         U8 *vecstr = Null(U8*);
6766         STRLEN veclen = 0;
6767         char c;
6768         int i;
6769         unsigned base;
6770         IV iv;
6771         UV uv;
6772         NV nv;
6773         STRLEN have;
6774         STRLEN need;
6775         STRLEN gap;
6776         char *dotstr = ".";
6777         STRLEN dotstrlen = 1;
6778         I32 epix = 0; /* explicit parameter index */
6779         I32 ewix = 0; /* explicit width index */
6780         bool asterisk = FALSE;
6781
6782         for (q = p; q < patend && *q != '%'; ++q) ;
6783         if (q > p) {
6784             sv_catpvn(sv, p, q - p);
6785             p = q;
6786         }
6787         if (q++ >= patend)
6788             break;
6789
6790         /* FLAGS */
6791
6792         while (*q) {
6793             switch (*q) {
6794             case ' ':
6795             case '+':
6796                 plus = *q++;
6797                 continue;
6798
6799             case '-':
6800                 left = TRUE;
6801                 q++;
6802                 continue;
6803
6804             case '0':
6805                 fill = *q++;
6806                 continue;
6807
6808             case '#':
6809                 alt = TRUE;
6810                 q++;
6811                 continue;
6812
6813             case '*':                   /* printf("%*vX",":",$ipv6addr) */
6814                 if (q[1] != 'v')
6815                     break;
6816                 q++;
6817                 if (args)
6818                     vecsv = va_arg(*args, SV*);
6819                 else if (svix < svmax)
6820                     vecsv = svargs[svix++];
6821                 else
6822                     continue;
6823                 dotstr = SvPVx(vecsv,dotstrlen);
6824                 if (DO_UTF8(vecsv))
6825                     is_utf = TRUE;
6826                 /* FALL THROUGH */
6827
6828             case 'v':
6829                 vectorize = TRUE;
6830                 q++;
6831                 continue;
6832
6833             default:
6834                 break;
6835             }
6836             break;
6837         }
6838
6839         /* WIDTH */
6840
6841     scanwidth:
6842
6843         if (*q == '*') {
6844             if (asterisk)
6845                 goto unknown;
6846             asterisk = TRUE;
6847             q++;
6848         }
6849
6850         switch (*q) {
6851         case '1': case '2': case '3':
6852         case '4': case '5': case '6':
6853         case '7': case '8': case '9':
6854             width = 0;
6855             while (isDIGIT(*q))
6856                 width = width * 10 + (*q++ - '0');
6857             if (*q == '$') {
6858                 if (asterisk && ewix == 0) {
6859                     ewix  = width;
6860                     width = 0;
6861                     q++;
6862                     goto scanwidth;
6863                 } else if (epix == 0) {
6864                     epix  = width;
6865                     width = 0;
6866                     q++;
6867                     goto scanwidth;
6868                 } else
6869                     goto unknown;
6870             }
6871         }
6872
6873         if (asterisk) {
6874             if (args)
6875                 i = va_arg(*args, int);
6876             else
6877                 i = (ewix ? ewix <= svmax : svix < svmax) ?
6878                     SvIVx(svargs[ewix ? ewix-1 : svix++]) : 0;
6879             left |= (i < 0);
6880             width = (i < 0) ? -i : i;
6881         }
6882
6883         /* PRECISION */
6884
6885         if (*q == '.') {
6886             q++;
6887             if (*q == '*') {
6888                 if (args)
6889                     i = va_arg(*args, int);
6890                 else
6891                     i = (ewix ? ewix <= svmax : svix < svmax)
6892                         ? SvIVx(svargs[ewix ? ewix-1 : svix++]) : 0;
6893                 precis = (i < 0) ? 0 : i;
6894                 q++;
6895             }
6896             else {
6897                 precis = 0;
6898                 while (isDIGIT(*q))
6899                     precis = precis * 10 + (*q++ - '0');
6900             }
6901             has_precis = TRUE;
6902         }
6903
6904         if (vectorize) {
6905             if (args) {
6906                 vecsv = va_arg(*args, SV*);
6907                 vecstr = (U8*)SvPVx(vecsv,veclen);
6908                 utf = DO_UTF8(vecsv);
6909             }
6910             else if (epix ? epix <= svmax : svix < svmax) {
6911                 vecsv = svargs[epix ? epix-1 : svix++];
6912                 vecstr = (U8*)SvPVx(vecsv,veclen);
6913                 utf = DO_UTF8(vecsv);
6914             }
6915             else {
6916                 vecstr = (U8*)"";
6917                 veclen = 0;
6918             }
6919         }
6920
6921         /* SIZE */
6922
6923         switch (*q) {
6924 #if defined(HAS_QUAD) || (defined(HAS_LONG_DOUBLE) && defined(USE_LONG_DOUBLE))
6925         case 'L':                       /* Ld */
6926             /* FALL THROUGH */
6927 #endif
6928 #ifdef HAS_QUAD
6929         case 'q':                       /* qd */
6930             intsize = 'q';
6931             q++;
6932             break;
6933 #endif
6934         case 'l':
6935 #if defined(HAS_QUAD) || (defined(HAS_LONG_DOUBLE) && defined(USE_LONG_DOUBLE))
6936              if (*(q + 1) == 'l') {     /* lld, llf */
6937                 intsize = 'q';
6938                 q += 2;
6939                 break;
6940              }
6941 #endif
6942             /* FALL THROUGH */
6943         case 'h':
6944             /* FALL THROUGH */
6945         case 'V':
6946             intsize = *q++;
6947             break;
6948         }
6949
6950         /* CONVERSION */
6951
6952         switch (c = *q++) {
6953
6954             /* STRINGS */
6955
6956         case '%':
6957             eptr = q - 1;
6958             elen = 1;
6959             goto string;
6960
6961         case 'c':
6962             if (args)
6963                 uv = va_arg(*args, int);
6964             else
6965                 uv = (epix ? epix <= svmax : svix < svmax) ?
6966                     SvIVx(svargs[epix ? epix-1 : svix++]) : 0;
6967             if ((uv > 255 || (uv > 127 && SvUTF8(sv))) && !IN_BYTE) {
6968                 eptr = (char*)utf8buf;
6969                 elen = uv_to_utf8((U8*)eptr, uv) - utf8buf;
6970                 is_utf = TRUE;
6971             }
6972             else {
6973                 c = (char)uv;
6974                 eptr = &c;
6975                 elen = 1;
6976             }
6977             goto string;
6978
6979         case 's':
6980             if (args) {
6981                 eptr = va_arg(*args, char*);
6982                 if (eptr)
6983 #ifdef MACOS_TRADITIONAL
6984                   /* On MacOS, %#s format is used for Pascal strings */
6985                   if (alt)
6986                     elen = *eptr++;
6987                   else
6988 #endif
6989                     elen = strlen(eptr);
6990                 else {
6991                     eptr = nullstr;
6992                     elen = sizeof nullstr - 1;
6993                 }
6994             }
6995             else if (epix ? epix <= svmax : svix < svmax) {
6996                 argsv = svargs[epix ? epix-1 : svix++];
6997                 eptr = SvPVx(argsv, elen);
6998                 if (DO_UTF8(argsv)) {
6999                     if (has_precis && precis < elen) {
7000                         I32 p = precis;
7001                         sv_pos_u2b(argsv, &p, 0); /* sticks at end */
7002                         precis = p;
7003                     }
7004                     if (width) { /* fudge width (can't fudge elen) */
7005                         width += elen - sv_len_utf8(argsv);
7006                     }
7007                     is_utf = TRUE;
7008                 }
7009             }
7010             goto string;
7011
7012         case '_':
7013             /*
7014              * The "%_" hack might have to be changed someday,
7015              * if ISO or ANSI decide to use '_' for something.
7016              * So we keep it hidden from users' code.
7017              */
7018             if (!args)
7019                 goto unknown;
7020             argsv = va_arg(*args,SV*);
7021             eptr = SvPVx(argsv, elen);
7022             if (DO_UTF8(argsv))
7023                 is_utf = TRUE;
7024
7025         string:
7026             vectorize = FALSE;
7027             if (has_precis && elen > precis)
7028                 elen = precis;
7029             break;
7030
7031             /* INTEGERS */
7032
7033         case 'p':
7034             if (alt)
7035                 goto unknown;
7036             if (args)
7037                 uv = PTR2UV(va_arg(*args, void*));
7038             else
7039                 uv = (epix ? epix <= svmax : svix < svmax) ?
7040                     PTR2UV(svargs[epix ? epix-1 : svix++]) : 0;
7041             base = 16;
7042             goto integer;
7043
7044         case 'D':
7045 #ifdef IV_IS_QUAD
7046             intsize = 'q';
7047 #else
7048             intsize = 'l';
7049 #endif
7050             /* FALL THROUGH */
7051         case 'd':
7052         case 'i':
7053             if (vectorize) {
7054                 STRLEN ulen;
7055                 if (!veclen) {
7056                     vectorize = FALSE;
7057                     break;
7058                 }
7059                 if (utf)
7060                     iv = (IV)utf8_to_uv(vecstr, veclen, &ulen, 0);
7061                 else {
7062                     iv = *vecstr;
7063                     ulen = 1;
7064                 }
7065                 vecstr += ulen;
7066                 veclen -= ulen;
7067             }
7068             else if (args) {
7069                 switch (intsize) {
7070                 case 'h':       iv = (short)va_arg(*args, int); break;
7071                 default:        iv = va_arg(*args, int); break;
7072                 case 'l':       iv = va_arg(*args, long); break;
7073                 case 'V':       iv = va_arg(*args, IV); break;
7074 #ifdef HAS_QUAD
7075                 case 'q':       iv = va_arg(*args, Quad_t); break;
7076 #endif
7077                 }
7078             }
7079             else {
7080                 iv = (epix ? epix <= svmax : svix < svmax) ?
7081                     SvIVx(svargs[epix ? epix-1 : svix++]) : 0;
7082                 switch (intsize) {
7083                 case 'h':       iv = (short)iv; break;
7084                 default:        break;
7085                 case 'l':       iv = (long)iv; break;
7086                 case 'V':       break;
7087 #ifdef HAS_QUAD
7088                 case 'q':       iv = (Quad_t)iv; break;
7089 #endif
7090                 }
7091             }
7092             if (iv >= 0) {
7093                 uv = iv;
7094                 if (plus)
7095                     esignbuf[esignlen++] = plus;
7096             }
7097             else {
7098                 uv = -iv;
7099                 esignbuf[esignlen++] = '-';
7100             }
7101             base = 10;
7102             goto integer;
7103
7104         case 'U':
7105 #ifdef IV_IS_QUAD
7106             intsize = 'q';
7107 #else
7108             intsize = 'l';
7109 #endif
7110             /* FALL THROUGH */
7111         case 'u':
7112             base = 10;
7113             goto uns_integer;
7114
7115         case 'b':
7116             base = 2;
7117             goto uns_integer;
7118
7119         case 'O':
7120 #ifdef IV_IS_QUAD
7121             intsize = 'q';
7122 #else
7123             intsize = 'l';
7124 #endif
7125             /* FALL THROUGH */
7126         case 'o':
7127             base = 8;
7128             goto uns_integer;
7129
7130         case 'X':
7131         case 'x':
7132             base = 16;
7133
7134         uns_integer:
7135             if (vectorize) {
7136                 STRLEN ulen;
7137         vector:
7138                 if (!veclen) {
7139                     vectorize = FALSE;
7140                     break;
7141                 }
7142                 if (utf)
7143                     uv = utf8_to_uv(vecstr, veclen, &ulen, 0);
7144                 else {
7145                     uv = *vecstr;
7146                     ulen = 1;
7147                 }
7148                 vecstr += ulen;
7149                 veclen -= ulen;
7150             }
7151             else if (args) {
7152                 switch (intsize) {
7153                 case 'h':  uv = (unsigned short)va_arg(*args, unsigned); break;
7154                 default:   uv = va_arg(*args, unsigned); break;
7155                 case 'l':  uv = va_arg(*args, unsigned long); break;
7156                 case 'V':  uv = va_arg(*args, UV); break;
7157 #ifdef HAS_QUAD
7158                 case 'q':  uv = va_arg(*args, Quad_t); break;
7159 #endif
7160                 }
7161             }
7162             else {
7163                 uv = (epix ? epix <= svmax : svix < svmax) ?
7164                     SvUVx(svargs[epix ? epix-1 : svix++]) : 0;
7165                 switch (intsize) {
7166                 case 'h':       uv = (unsigned short)uv; break;
7167                 default:        break;
7168                 case 'l':       uv = (unsigned long)uv; break;
7169                 case 'V':       break;
7170 #ifdef HAS_QUAD
7171                 case 'q':       uv = (Quad_t)uv; break;
7172 #endif
7173                 }
7174             }
7175
7176         integer:
7177             eptr = ebuf + sizeof ebuf;
7178             switch (base) {
7179                 unsigned dig;
7180             case 16:
7181                 if (!uv)
7182                     alt = FALSE;
7183                 p = (char*)((c == 'X')
7184                             ? "0123456789ABCDEF" : "0123456789abcdef");
7185                 do {
7186                     dig = uv & 15;
7187                     *--eptr = p[dig];
7188                 } while (uv >>= 4);
7189                 if (alt) {
7190                     esignbuf[esignlen++] = '0';
7191                     esignbuf[esignlen++] = c;  /* 'x' or 'X' */
7192                 }
7193                 break;
7194             case 8:
7195                 do {
7196                     dig = uv & 7;
7197                     *--eptr = '0' + dig;
7198                 } while (uv >>= 3);
7199                 if (alt && *eptr != '0')
7200                     *--eptr = '0';
7201                 break;
7202             case 2:
7203                 do {
7204                     dig = uv & 1;
7205                     *--eptr = '0' + dig;
7206                 } while (uv >>= 1);
7207                 if (alt) {
7208                     esignbuf[esignlen++] = '0';
7209                     esignbuf[esignlen++] = 'b';
7210                 }
7211                 break;
7212             default:            /* it had better be ten or less */
7213 #if defined(PERL_Y2KWARN)
7214                 if (ckWARN(WARN_Y2K)) {
7215                     STRLEN n;
7216                     char *s = SvPV(sv,n);
7217                     if (n >= 2 && s[n-2] == '1' && s[n-1] == '9'
7218                         && (n == 2 || !isDIGIT(s[n-3])))
7219                     {
7220                         Perl_warner(aTHX_ WARN_Y2K,
7221                                     "Possible Y2K bug: %%%c %s",
7222                                     c, "format string following '19'");
7223                     }
7224                 }
7225 #endif
7226                 do {
7227                     dig = uv % base;
7228                     *--eptr = '0' + dig;
7229                 } while (uv /= base);
7230                 break;
7231             }
7232             elen = (ebuf + sizeof ebuf) - eptr;
7233             if (has_precis) {
7234                 if (precis > elen)
7235                     zeros = precis - elen;
7236                 else if (precis == 0 && elen == 1 && *eptr == '0')
7237                     elen = 0;
7238             }
7239             break;
7240
7241             /* FLOATING POINT */
7242
7243         case 'F':
7244             c = 'f';            /* maybe %F isn't supported here */
7245             /* FALL THROUGH */
7246         case 'e': case 'E':
7247         case 'f':
7248         case 'g': case 'G':
7249
7250             /* This is evil, but floating point is even more evil */
7251
7252             vectorize = FALSE;
7253             if (args)
7254                 nv = va_arg(*args, NV);
7255             else
7256                 nv = (epix ? epix <= svmax : svix < svmax) ?
7257                     SvNVx(svargs[epix ? epix-1 : svix++]) : 0.0;
7258
7259             need = 0;
7260             if (c != 'e' && c != 'E') {
7261                 i = PERL_INT_MIN;
7262                 (void)Perl_frexp(nv, &i);
7263                 if (i == PERL_INT_MIN)
7264                     Perl_die(aTHX_ "panic: frexp");
7265                 if (i > 0)
7266                     need = BIT_DIGITS(i);
7267             }
7268             need += has_precis ? precis : 6; /* known default */
7269             if (need < width)
7270                 need = width;
7271
7272             need += 20; /* fudge factor */
7273             if (PL_efloatsize < need) {
7274                 Safefree(PL_efloatbuf);
7275                 PL_efloatsize = need + 20; /* more fudge */
7276                 New(906, PL_efloatbuf, PL_efloatsize, char);
7277                 PL_efloatbuf[0] = '\0';
7278             }
7279
7280             eptr = ebuf + sizeof ebuf;
7281             *--eptr = '\0';
7282             *--eptr = c;
7283 #if defined(USE_LONG_DOUBLE) && defined(PERL_PRIfldbl)
7284             {
7285                 /* Copy the one or more characters in a long double
7286                  * format before the 'base' ([efgEFG]) character to
7287                  * the format string. */
7288                 static char const prifldbl[] = PERL_PRIfldbl;
7289                 char const *p = prifldbl + sizeof(prifldbl) - 3;
7290                 while (p >= prifldbl) { *--eptr = *p--; }
7291             }
7292 #endif
7293             if (has_precis) {
7294                 base = precis;
7295                 do { *--eptr = '0' + (base % 10); } while (base /= 10);
7296                 *--eptr = '.';
7297             }
7298             if (width) {
7299                 base = width;
7300                 do { *--eptr = '0' + (base % 10); } while (base /= 10);
7301             }
7302             if (fill == '0')
7303                 *--eptr = fill;
7304             if (left)
7305                 *--eptr = '-';
7306             if (plus)
7307                 *--eptr = plus;
7308             if (alt)
7309                 *--eptr = '#';
7310             *--eptr = '%';
7311
7312             /* No taint.  Otherwise we are in the strange situation
7313              * where printf() taints but print($float) doesn't.
7314              * --jhi */
7315             (void)sprintf(PL_efloatbuf, eptr, nv);
7316
7317             eptr = PL_efloatbuf;
7318             elen = strlen(PL_efloatbuf);
7319             break;
7320
7321             /* SPECIAL */
7322
7323         case 'n':
7324             vectorize = FALSE;
7325             i = SvCUR(sv) - origlen;
7326             if (args) {
7327                 switch (intsize) {
7328                 case 'h':       *(va_arg(*args, short*)) = i; break;
7329                 default:        *(va_arg(*args, int*)) = i; break;
7330                 case 'l':       *(va_arg(*args, long*)) = i; break;
7331                 case 'V':       *(va_arg(*args, IV*)) = i; break;
7332 #ifdef HAS_QUAD
7333                 case 'q':       *(va_arg(*args, Quad_t*)) = i; break;
7334 #endif
7335                 }
7336             }
7337             else if (epix ? epix <= svmax : svix < svmax)
7338                 sv_setuv_mg(svargs[epix ? epix-1 : svix++], (UV)i);
7339             continue;   /* not "break" */
7340
7341             /* UNKNOWN */
7342
7343         default:
7344       unknown:
7345             vectorize = FALSE;
7346             if (!args && ckWARN(WARN_PRINTF) &&
7347                   (PL_op->op_type == OP_PRTF || PL_op->op_type == OP_SPRINTF)) {
7348                 SV *msg = sv_newmortal();
7349                 Perl_sv_setpvf(aTHX_ msg, "Invalid conversion in %s: ",
7350                           (PL_op->op_type == OP_PRTF) ? "printf" : "sprintf");
7351                 if (c) {
7352                     if (isPRINT(c))
7353                         Perl_sv_catpvf(aTHX_ msg,
7354                                        "\"%%%c\"", c & 0xFF);
7355                     else
7356                         Perl_sv_catpvf(aTHX_ msg,
7357                                        "\"%%\\%03"UVof"\"",
7358                                        (UV)c & 0xFF);
7359                 } else
7360                     sv_catpv(msg, "end of string");
7361                 Perl_warner(aTHX_ WARN_PRINTF, "%"SVf, msg); /* yes, this is reentrant */
7362             }
7363
7364             /* output mangled stuff ... */
7365             if (c == '\0')
7366                 --q;
7367             eptr = p;
7368             elen = q - p;
7369
7370             /* ... right here, because formatting flags should not apply */
7371             SvGROW(sv, SvCUR(sv) + elen + 1);
7372             p = SvEND(sv);
7373             memcpy(p, eptr, elen);
7374             p += elen;
7375             *p = '\0';
7376             SvCUR(sv) = p - SvPVX(sv);
7377             continue;   /* not "break" */
7378         }
7379
7380         have = esignlen + zeros + elen;
7381         need = (have > width ? have : width);
7382         gap = need - have;
7383
7384         SvGROW(sv, SvCUR(sv) + need + dotstrlen + 1);
7385         p = SvEND(sv);
7386         if (esignlen && fill == '0') {
7387             for (i = 0; i < esignlen; i++)
7388                 *p++ = esignbuf[i];
7389         }
7390         if (gap && !left) {
7391             memset(p, fill, gap);
7392             p += gap;
7393         }
7394         if (esignlen && fill != '0') {
7395             for (i = 0; i < esignlen; i++)
7396                 *p++ = esignbuf[i];
7397         }
7398         if (zeros) {
7399             for (i = zeros; i; i--)
7400                 *p++ = '0';
7401         }
7402         if (elen) {
7403             memcpy(p, eptr, elen);
7404             p += elen;
7405         }
7406         if (gap && left) {
7407             memset(p, ' ', gap);
7408             p += gap;
7409         }
7410         if (vectorize) {
7411             if (veclen) {
7412                 memcpy(p, dotstr, dotstrlen);
7413                 p += dotstrlen;
7414             }
7415             else
7416                 vectorize = FALSE;              /* done iterating over vecstr */
7417         }
7418         if (is_utf)
7419             SvUTF8_on(sv);
7420         *p = '\0';
7421         SvCUR(sv) = p - SvPVX(sv);
7422         if (vectorize) {
7423             esignlen = 0;
7424             goto vector;
7425         }
7426     }
7427 }
7428
7429 #if defined(USE_ITHREADS)
7430
7431 #if defined(USE_THREADS)
7432 #  include "error: USE_THREADS and USE_ITHREADS are incompatible"
7433 #endif
7434
7435 #ifndef GpREFCNT_inc
7436 #  define GpREFCNT_inc(gp)      ((gp) ? (++(gp)->gp_refcnt, (gp)) : (GP*)NULL)
7437 #endif
7438
7439
7440 #define sv_dup_inc(s)   SvREFCNT_inc(sv_dup(s))
7441 #define av_dup(s)       (AV*)sv_dup((SV*)s)
7442 #define av_dup_inc(s)   (AV*)SvREFCNT_inc(sv_dup((SV*)s))
7443 #define hv_dup(s)       (HV*)sv_dup((SV*)s)
7444 #define hv_dup_inc(s)   (HV*)SvREFCNT_inc(sv_dup((SV*)s))
7445 #define cv_dup(s)       (CV*)sv_dup((SV*)s)
7446 #define cv_dup_inc(s)   (CV*)SvREFCNT_inc(sv_dup((SV*)s))
7447 #define io_dup(s)       (IO*)sv_dup((SV*)s)
7448 #define io_dup_inc(s)   (IO*)SvREFCNT_inc(sv_dup((SV*)s))
7449 #define gv_dup(s)       (GV*)sv_dup((SV*)s)
7450 #define gv_dup_inc(s)   (GV*)SvREFCNT_inc(sv_dup((SV*)s))
7451 #define SAVEPV(p)       (p ? savepv(p) : Nullch)
7452 #define SAVEPVN(p,n)    (p ? savepvn(p,n) : Nullch)
7453
7454 REGEXP *
7455 Perl_re_dup(pTHX_ REGEXP *r)
7456 {
7457     /* XXX fix when pmop->op_pmregexp becomes shared */
7458     return ReREFCNT_inc(r);
7459 }
7460
7461 PerlIO *
7462 Perl_fp_dup(pTHX_ PerlIO *fp, char type)
7463 {
7464     PerlIO *ret;
7465     if (!fp)
7466         return (PerlIO*)NULL;
7467
7468     /* look for it in the table first */
7469     ret = (PerlIO*)ptr_table_fetch(PL_ptr_table, fp);
7470     if (ret)
7471         return ret;
7472
7473     /* create anew and remember what it is */
7474     ret = PerlIO_fdupopen(aTHX_ fp);
7475     ptr_table_store(PL_ptr_table, fp, ret);
7476     return ret;
7477 }
7478
7479 DIR *
7480 Perl_dirp_dup(pTHX_ DIR *dp)
7481 {
7482     if (!dp)
7483         return (DIR*)NULL;
7484     /* XXX TODO */
7485     return dp;
7486 }
7487
7488 GP *
7489 Perl_gp_dup(pTHX_ GP *gp)
7490 {
7491     GP *ret;
7492     if (!gp)
7493         return (GP*)NULL;
7494     /* look for it in the table first */
7495     ret = (GP*)ptr_table_fetch(PL_ptr_table, gp);
7496     if (ret)
7497         return ret;
7498
7499     /* create anew and remember what it is */
7500     Newz(0, ret, 1, GP);
7501     ptr_table_store(PL_ptr_table, gp, ret);
7502
7503     /* clone */
7504     ret->gp_refcnt      = 0;                    /* must be before any other dups! */
7505     ret->gp_sv          = sv_dup_inc(gp->gp_sv);
7506     ret->gp_io          = io_dup_inc(gp->gp_io);
7507     ret->gp_form        = cv_dup_inc(gp->gp_form);
7508     ret->gp_av          = av_dup_inc(gp->gp_av);
7509     ret->gp_hv          = hv_dup_inc(gp->gp_hv);
7510     ret->gp_egv         = gv_dup(gp->gp_egv);   /* GvEGV is not refcounted */
7511     ret->gp_cv          = cv_dup_inc(gp->gp_cv);
7512     ret->gp_cvgen       = gp->gp_cvgen;
7513     ret->gp_flags       = gp->gp_flags;
7514     ret->gp_line        = gp->gp_line;
7515     ret->gp_file        = gp->gp_file;          /* points to COP.cop_file */
7516     return ret;
7517 }
7518
7519 MAGIC *
7520 Perl_mg_dup(pTHX_ MAGIC *mg)
7521 {
7522     MAGIC *mgret = (MAGIC*)NULL;
7523     MAGIC *mgprev;
7524     if (!mg)
7525         return (MAGIC*)NULL;
7526     /* look for it in the table first */
7527     mgret = (MAGIC*)ptr_table_fetch(PL_ptr_table, mg);
7528     if (mgret)
7529         return mgret;
7530
7531     for (; mg; mg = mg->mg_moremagic) {
7532         MAGIC *nmg;
7533         Newz(0, nmg, 1, MAGIC);
7534         if (!mgret)
7535             mgret = nmg;
7536         else
7537             mgprev->mg_moremagic = nmg;
7538         nmg->mg_virtual = mg->mg_virtual;       /* XXX copy dynamic vtable? */
7539         nmg->mg_private = mg->mg_private;
7540         nmg->mg_type    = mg->mg_type;
7541         nmg->mg_flags   = mg->mg_flags;
7542         if (mg->mg_type == 'r') {
7543             nmg->mg_obj = (SV*)re_dup((REGEXP*)mg->mg_obj);
7544         }
7545         else {
7546             nmg->mg_obj = (mg->mg_flags & MGf_REFCOUNTED)
7547                               ? sv_dup_inc(mg->mg_obj)
7548                               : sv_dup(mg->mg_obj);
7549         }
7550         nmg->mg_len     = mg->mg_len;
7551         nmg->mg_ptr     = mg->mg_ptr;   /* XXX random ptr? */
7552         if (mg->mg_ptr && mg->mg_type != 'g') {
7553             if (mg->mg_len >= 0) {
7554                 nmg->mg_ptr     = SAVEPVN(mg->mg_ptr, mg->mg_len);
7555                 if (mg->mg_type == 'c' && AMT_AMAGIC((AMT*)mg->mg_ptr)) {
7556                     AMT *amtp = (AMT*)mg->mg_ptr;
7557                     AMT *namtp = (AMT*)nmg->mg_ptr;
7558                     I32 i;
7559                     for (i = 1; i < NofAMmeth; i++) {
7560                         namtp->table[i] = cv_dup_inc(amtp->table[i]);
7561                     }
7562                 }
7563             }
7564             else if (mg->mg_len == HEf_SVKEY)
7565                 nmg->mg_ptr     = (char*)sv_dup_inc((SV*)mg->mg_ptr);
7566         }
7567         mgprev = nmg;
7568     }
7569     return mgret;
7570 }
7571
7572 PTR_TBL_t *
7573 Perl_ptr_table_new(pTHX)
7574 {
7575     PTR_TBL_t *tbl;
7576     Newz(0, tbl, 1, PTR_TBL_t);
7577     tbl->tbl_max        = 511;
7578     tbl->tbl_items      = 0;
7579     Newz(0, tbl->tbl_ary, tbl->tbl_max + 1, PTR_TBL_ENT_t*);
7580     return tbl;
7581 }
7582
7583 void *
7584 Perl_ptr_table_fetch(pTHX_ PTR_TBL_t *tbl, void *sv)
7585 {
7586     PTR_TBL_ENT_t *tblent;
7587     UV hash = PTR2UV(sv);
7588     assert(tbl);
7589     tblent = tbl->tbl_ary[hash & tbl->tbl_max];
7590     for (; tblent; tblent = tblent->next) {
7591         if (tblent->oldval == sv)
7592             return tblent->newval;
7593     }
7594     return (void*)NULL;
7595 }
7596
7597 void
7598 Perl_ptr_table_store(pTHX_ PTR_TBL_t *tbl, void *oldv, void *newv)
7599 {
7600     PTR_TBL_ENT_t *tblent, **otblent;
7601     /* XXX this may be pessimal on platforms where pointers aren't good
7602      * hash values e.g. if they grow faster in the most significant
7603      * bits */
7604     UV hash = PTR2UV(oldv);
7605     bool i = 1;
7606
7607     assert(tbl);
7608     otblent = &tbl->tbl_ary[hash & tbl->tbl_max];
7609     for (tblent = *otblent; tblent; i=0, tblent = tblent->next) {
7610         if (tblent->oldval == oldv) {
7611             tblent->newval = newv;
7612             tbl->tbl_items++;
7613             return;
7614         }
7615     }
7616     Newz(0, tblent, 1, PTR_TBL_ENT_t);
7617     tblent->oldval = oldv;
7618     tblent->newval = newv;
7619     tblent->next = *otblent;
7620     *otblent = tblent;
7621     tbl->tbl_items++;
7622     if (i && tbl->tbl_items > tbl->tbl_max)
7623         ptr_table_split(tbl);
7624 }
7625
7626 void
7627 Perl_ptr_table_split(pTHX_ PTR_TBL_t *tbl)
7628 {
7629     PTR_TBL_ENT_t **ary = tbl->tbl_ary;
7630     UV oldsize = tbl->tbl_max + 1;
7631     UV newsize = oldsize * 2;
7632     UV i;
7633
7634     Renew(ary, newsize, PTR_TBL_ENT_t*);
7635     Zero(&ary[oldsize], newsize-oldsize, PTR_TBL_ENT_t*);
7636     tbl->tbl_max = --newsize;
7637     tbl->tbl_ary = ary;
7638     for (i=0; i < oldsize; i++, ary++) {
7639         PTR_TBL_ENT_t **curentp, **entp, *ent;
7640         if (!*ary)
7641             continue;
7642         curentp = ary + oldsize;
7643         for (entp = ary, ent = *ary; ent; ent = *entp) {
7644             if ((newsize & PTR2UV(ent->oldval)) != i) {
7645                 *entp = ent->next;
7646                 ent->next = *curentp;
7647                 *curentp = ent;
7648                 continue;
7649             }
7650             else
7651                 entp = &ent->next;
7652         }
7653     }
7654 }
7655
7656 #ifdef DEBUGGING
7657 char *PL_watch_pvx;
7658 #endif
7659
7660 SV *
7661 Perl_sv_dup(pTHX_ SV *sstr)
7662 {
7663     SV *dstr;
7664
7665     if (!sstr || SvTYPE(sstr) == SVTYPEMASK)
7666         return Nullsv;
7667     /* look for it in the table first */
7668     dstr = (SV*)ptr_table_fetch(PL_ptr_table, sstr);
7669     if (dstr)
7670         return dstr;
7671
7672     /* create anew and remember what it is */
7673     new_SV(dstr);
7674     ptr_table_store(PL_ptr_table, sstr, dstr);
7675
7676     /* clone */
7677     SvFLAGS(dstr)       = SvFLAGS(sstr);
7678     SvFLAGS(dstr)       &= ~SVf_OOK;            /* don't propagate OOK hack */
7679     SvREFCNT(dstr)      = 0;                    /* must be before any other dups! */
7680
7681 #ifdef DEBUGGING
7682     if (SvANY(sstr) && PL_watch_pvx && SvPVX(sstr) == PL_watch_pvx)
7683         PerlIO_printf(Perl_debug_log, "watch at %p hit, found string \"%s\"\n",
7684                       PL_watch_pvx, SvPVX(sstr));
7685 #endif
7686
7687     switch (SvTYPE(sstr)) {
7688     case SVt_NULL:
7689         SvANY(dstr)     = NULL;
7690         break;
7691     case SVt_IV:
7692         SvANY(dstr)     = new_XIV();
7693         SvIVX(dstr)     = SvIVX(sstr);
7694         break;
7695     case SVt_NV:
7696         SvANY(dstr)     = new_XNV();
7697         SvNVX(dstr)     = SvNVX(sstr);
7698         break;
7699     case SVt_RV:
7700         SvANY(dstr)     = new_XRV();
7701         SvRV(dstr)      = sv_dup_inc(SvRV(sstr));
7702         break;
7703     case SVt_PV:
7704         SvANY(dstr)     = new_XPV();
7705         SvCUR(dstr)     = SvCUR(sstr);
7706         SvLEN(dstr)     = SvLEN(sstr);
7707         if (SvROK(sstr))
7708             SvRV(dstr)  = sv_dup_inc(SvRV(sstr));
7709         else if (SvPVX(sstr) && SvLEN(sstr))
7710             SvPVX(dstr) = SAVEPVN(SvPVX(sstr), SvLEN(sstr)-1);
7711         else
7712             SvPVX(dstr) = SvPVX(sstr);          /* XXX shared string/random ptr? */
7713         break;
7714     case SVt_PVIV:
7715         SvANY(dstr)     = new_XPVIV();
7716         SvCUR(dstr)     = SvCUR(sstr);
7717         SvLEN(dstr)     = SvLEN(sstr);
7718         SvIVX(dstr)     = SvIVX(sstr);
7719         if (SvROK(sstr))
7720             SvRV(dstr)  = sv_dup_inc(SvRV(sstr));
7721         else if (SvPVX(sstr) && SvLEN(sstr))
7722             SvPVX(dstr) = SAVEPVN(SvPVX(sstr), SvLEN(sstr)-1);
7723         else
7724             SvPVX(dstr) = SvPVX(sstr);          /* XXX shared string/random ptr? */
7725         break;
7726     case SVt_PVNV:
7727         SvANY(dstr)     = new_XPVNV();
7728         SvCUR(dstr)     = SvCUR(sstr);
7729         SvLEN(dstr)     = SvLEN(sstr);
7730         SvIVX(dstr)     = SvIVX(sstr);
7731         SvNVX(dstr)     = SvNVX(sstr);
7732         if (SvROK(sstr))
7733             SvRV(dstr)  = sv_dup_inc(SvRV(sstr));
7734         else if (SvPVX(sstr) && SvLEN(sstr))
7735             SvPVX(dstr) = SAVEPVN(SvPVX(sstr), SvLEN(sstr)-1);
7736         else
7737             SvPVX(dstr) = SvPVX(sstr);          /* XXX shared string/random ptr? */
7738         break;
7739     case SVt_PVMG:
7740         SvANY(dstr)     = new_XPVMG();
7741         SvCUR(dstr)     = SvCUR(sstr);
7742         SvLEN(dstr)     = SvLEN(sstr);
7743         SvIVX(dstr)     = SvIVX(sstr);
7744         SvNVX(dstr)     = SvNVX(sstr);
7745         SvMAGIC(dstr)   = mg_dup(SvMAGIC(sstr));
7746         SvSTASH(dstr)   = hv_dup_inc(SvSTASH(sstr));
7747         if (SvROK(sstr))
7748             SvRV(dstr)  = sv_dup_inc(SvRV(sstr));
7749         else if (SvPVX(sstr) && SvLEN(sstr))
7750             SvPVX(dstr) = SAVEPVN(SvPVX(sstr), SvLEN(sstr)-1);
7751         else
7752             SvPVX(dstr) = SvPVX(sstr);          /* XXX shared string/random ptr? */
7753         break;
7754     case SVt_PVBM:
7755         SvANY(dstr)     = new_XPVBM();
7756         SvCUR(dstr)     = SvCUR(sstr);
7757         SvLEN(dstr)     = SvLEN(sstr);
7758         SvIVX(dstr)     = SvIVX(sstr);
7759         SvNVX(dstr)     = SvNVX(sstr);
7760         SvMAGIC(dstr)   = mg_dup(SvMAGIC(sstr));
7761         SvSTASH(dstr)   = hv_dup_inc(SvSTASH(sstr));
7762         if (SvROK(sstr))
7763             SvRV(dstr)  = sv_dup_inc(SvRV(sstr));
7764         else if (SvPVX(sstr) && SvLEN(sstr))
7765             SvPVX(dstr) = SAVEPVN(SvPVX(sstr), SvLEN(sstr)-1);
7766         else
7767             SvPVX(dstr) = SvPVX(sstr);          /* XXX shared string/random ptr? */
7768         BmRARE(dstr)    = BmRARE(sstr);
7769         BmUSEFUL(dstr)  = BmUSEFUL(sstr);
7770         BmPREVIOUS(dstr)= BmPREVIOUS(sstr);
7771         break;
7772     case SVt_PVLV:
7773         SvANY(dstr)     = new_XPVLV();
7774         SvCUR(dstr)     = SvCUR(sstr);
7775         SvLEN(dstr)     = SvLEN(sstr);
7776         SvIVX(dstr)     = SvIVX(sstr);
7777         SvNVX(dstr)     = SvNVX(sstr);
7778         SvMAGIC(dstr)   = mg_dup(SvMAGIC(sstr));
7779         SvSTASH(dstr)   = hv_dup_inc(SvSTASH(sstr));
7780         if (SvROK(sstr))
7781             SvRV(dstr)  = sv_dup_inc(SvRV(sstr));
7782         else if (SvPVX(sstr) && SvLEN(sstr))
7783             SvPVX(dstr) = SAVEPVN(SvPVX(sstr), SvLEN(sstr)-1);
7784         else
7785             SvPVX(dstr) = SvPVX(sstr);          /* XXX shared string/random ptr? */
7786         LvTARGOFF(dstr) = LvTARGOFF(sstr);      /* XXX sometimes holds PMOP* when DEBUGGING */
7787         LvTARGLEN(dstr) = LvTARGLEN(sstr);
7788         LvTARG(dstr)    = sv_dup_inc(LvTARG(sstr));
7789         LvTYPE(dstr)    = LvTYPE(sstr);
7790         break;
7791     case SVt_PVGV:
7792         SvANY(dstr)     = new_XPVGV();
7793         SvCUR(dstr)     = SvCUR(sstr);
7794         SvLEN(dstr)     = SvLEN(sstr);
7795         SvIVX(dstr)     = SvIVX(sstr);
7796         SvNVX(dstr)     = SvNVX(sstr);
7797         SvMAGIC(dstr)   = mg_dup(SvMAGIC(sstr));
7798         SvSTASH(dstr)   = hv_dup_inc(SvSTASH(sstr));
7799         if (SvROK(sstr))
7800             SvRV(dstr)  = sv_dup_inc(SvRV(sstr));
7801         else if (SvPVX(sstr) && SvLEN(sstr))
7802             SvPVX(dstr) = SAVEPVN(SvPVX(sstr), SvLEN(sstr)-1);
7803         else
7804             SvPVX(dstr) = SvPVX(sstr);          /* XXX shared string/random ptr? */
7805         GvNAMELEN(dstr) = GvNAMELEN(sstr);
7806         GvNAME(dstr)    = SAVEPVN(GvNAME(sstr), GvNAMELEN(sstr));
7807         GvSTASH(dstr)   = hv_dup_inc(GvSTASH(sstr));
7808         GvFLAGS(dstr)   = GvFLAGS(sstr);
7809         GvGP(dstr)      = gp_dup(GvGP(sstr));
7810         (void)GpREFCNT_inc(GvGP(dstr));
7811         break;
7812     case SVt_PVIO:
7813         SvANY(dstr)     = new_XPVIO();
7814         SvCUR(dstr)     = SvCUR(sstr);
7815         SvLEN(dstr)     = SvLEN(sstr);
7816         SvIVX(dstr)     = SvIVX(sstr);
7817         SvNVX(dstr)     = SvNVX(sstr);
7818         SvMAGIC(dstr)   = mg_dup(SvMAGIC(sstr));
7819         SvSTASH(dstr)   = hv_dup_inc(SvSTASH(sstr));
7820         if (SvROK(sstr))
7821             SvRV(dstr)  = sv_dup_inc(SvRV(sstr));
7822         else if (SvPVX(sstr) && SvLEN(sstr))
7823             SvPVX(dstr) = SAVEPVN(SvPVX(sstr), SvLEN(sstr)-1);
7824         else
7825             SvPVX(dstr) = SvPVX(sstr);          /* XXX shared string/random ptr? */
7826         IoIFP(dstr)     = fp_dup(IoIFP(sstr), IoTYPE(sstr));
7827         if (IoOFP(sstr) == IoIFP(sstr))
7828             IoOFP(dstr) = IoIFP(dstr);
7829         else
7830             IoOFP(dstr) = fp_dup(IoOFP(sstr), IoTYPE(sstr));
7831         /* PL_rsfp_filters entries have fake IoDIRP() */
7832         if (IoDIRP(sstr) && !(IoFLAGS(sstr) & IOf_FAKE_DIRP))
7833             IoDIRP(dstr)        = dirp_dup(IoDIRP(sstr));
7834         else
7835             IoDIRP(dstr)        = IoDIRP(sstr);
7836         IoLINES(dstr)           = IoLINES(sstr);
7837         IoPAGE(dstr)            = IoPAGE(sstr);
7838         IoPAGE_LEN(dstr)        = IoPAGE_LEN(sstr);
7839         IoLINES_LEFT(dstr)      = IoLINES_LEFT(sstr);
7840         IoTOP_NAME(dstr)        = SAVEPV(IoTOP_NAME(sstr));
7841         IoTOP_GV(dstr)          = gv_dup(IoTOP_GV(sstr));
7842         IoFMT_NAME(dstr)        = SAVEPV(IoFMT_NAME(sstr));
7843         IoFMT_GV(dstr)          = gv_dup(IoFMT_GV(sstr));
7844         IoBOTTOM_NAME(dstr)     = SAVEPV(IoBOTTOM_NAME(sstr));
7845         IoBOTTOM_GV(dstr)       = gv_dup(IoBOTTOM_GV(sstr));
7846         IoSUBPROCESS(dstr)      = IoSUBPROCESS(sstr);
7847         IoTYPE(dstr)            = IoTYPE(sstr);
7848         IoFLAGS(dstr)           = IoFLAGS(sstr);
7849         break;
7850     case SVt_PVAV:
7851         SvANY(dstr)     = new_XPVAV();
7852         SvCUR(dstr)     = SvCUR(sstr);
7853         SvLEN(dstr)     = SvLEN(sstr);
7854         SvIVX(dstr)     = SvIVX(sstr);
7855         SvNVX(dstr)     = SvNVX(sstr);
7856         SvMAGIC(dstr)   = mg_dup(SvMAGIC(sstr));
7857         SvSTASH(dstr)   = hv_dup_inc(SvSTASH(sstr));
7858         AvARYLEN((AV*)dstr) = sv_dup_inc(AvARYLEN((AV*)sstr));
7859         AvFLAGS((AV*)dstr) = AvFLAGS((AV*)sstr);
7860         if (AvARRAY((AV*)sstr)) {
7861             SV **dst_ary, **src_ary;
7862             SSize_t items = AvFILLp((AV*)sstr) + 1;
7863
7864             src_ary = AvARRAY((AV*)sstr);
7865             Newz(0, dst_ary, AvMAX((AV*)sstr)+1, SV*);
7866             ptr_table_store(PL_ptr_table, src_ary, dst_ary);
7867             SvPVX(dstr) = (char*)dst_ary;
7868             AvALLOC((AV*)dstr) = dst_ary;
7869             if (AvREAL((AV*)sstr)) {
7870                 while (items-- > 0)
7871                     *dst_ary++ = sv_dup_inc(*src_ary++);
7872             }
7873             else {
7874                 while (items-- > 0)
7875                     *dst_ary++ = sv_dup(*src_ary++);
7876             }
7877             items = AvMAX((AV*)sstr) - AvFILLp((AV*)sstr);
7878             while (items-- > 0) {
7879                 *dst_ary++ = &PL_sv_undef;
7880             }
7881         }
7882         else {
7883             SvPVX(dstr)         = Nullch;
7884             AvALLOC((AV*)dstr)  = (SV**)NULL;
7885         }
7886         break;
7887     case SVt_PVHV:
7888         SvANY(dstr)     = new_XPVHV();
7889         SvCUR(dstr)     = SvCUR(sstr);
7890         SvLEN(dstr)     = SvLEN(sstr);
7891         SvIVX(dstr)     = SvIVX(sstr);
7892         SvNVX(dstr)     = SvNVX(sstr);
7893         SvMAGIC(dstr)   = mg_dup(SvMAGIC(sstr));
7894         SvSTASH(dstr)   = hv_dup_inc(SvSTASH(sstr));
7895         HvRITER((HV*)dstr)      = HvRITER((HV*)sstr);
7896         if (HvARRAY((HV*)sstr)) {
7897             STRLEN i = 0;
7898             XPVHV *dxhv = (XPVHV*)SvANY(dstr);
7899             XPVHV *sxhv = (XPVHV*)SvANY(sstr);
7900             Newz(0, dxhv->xhv_array,
7901                  PERL_HV_ARRAY_ALLOC_BYTES(dxhv->xhv_max+1), char);
7902             while (i <= sxhv->xhv_max) {
7903                 ((HE**)dxhv->xhv_array)[i] = he_dup(((HE**)sxhv->xhv_array)[i],
7904                                                     !!HvSHAREKEYS(sstr));
7905                 ++i;
7906             }
7907             dxhv->xhv_eiter = he_dup(sxhv->xhv_eiter, !!HvSHAREKEYS(sstr));
7908         }
7909         else {
7910             SvPVX(dstr)         = Nullch;
7911             HvEITER((HV*)dstr)  = (HE*)NULL;
7912         }
7913         HvPMROOT((HV*)dstr)     = HvPMROOT((HV*)sstr);          /* XXX */
7914         HvNAME((HV*)dstr)       = SAVEPV(HvNAME((HV*)sstr));
7915         break;
7916     case SVt_PVFM:
7917         SvANY(dstr)     = new_XPVFM();
7918         FmLINES(dstr)   = FmLINES(sstr);
7919         goto dup_pvcv;
7920         /* NOTREACHED */
7921     case SVt_PVCV:
7922         SvANY(dstr)     = new_XPVCV();
7923 dup_pvcv:
7924         SvCUR(dstr)     = SvCUR(sstr);
7925         SvLEN(dstr)     = SvLEN(sstr);
7926         SvIVX(dstr)     = SvIVX(sstr);
7927         SvNVX(dstr)     = SvNVX(sstr);
7928         SvMAGIC(dstr)   = mg_dup(SvMAGIC(sstr));
7929         SvSTASH(dstr)   = hv_dup_inc(SvSTASH(sstr));
7930         if (SvPVX(sstr) && SvLEN(sstr))
7931             SvPVX(dstr) = SAVEPVN(SvPVX(sstr), SvLEN(sstr)-1);
7932         else
7933             SvPVX(dstr) = SvPVX(sstr);          /* XXX shared string/random ptr? */
7934         CvSTASH(dstr)   = hv_dup(CvSTASH(sstr));/* NOTE: not refcounted */
7935         CvSTART(dstr)   = CvSTART(sstr);
7936         CvROOT(dstr)    = OpREFCNT_inc(CvROOT(sstr));
7937         CvXSUB(dstr)    = CvXSUB(sstr);
7938         CvXSUBANY(dstr) = CvXSUBANY(sstr);
7939         CvGV(dstr)      = gv_dup_inc(CvGV(sstr));
7940         CvDEPTH(dstr)   = CvDEPTH(sstr);
7941         if (CvPADLIST(sstr) && !AvREAL(CvPADLIST(sstr))) {
7942             /* XXX padlists are real, but pretend to be not */
7943             AvREAL_on(CvPADLIST(sstr));
7944             CvPADLIST(dstr)     = av_dup_inc(CvPADLIST(sstr));
7945             AvREAL_off(CvPADLIST(sstr));
7946             AvREAL_off(CvPADLIST(dstr));
7947         }
7948         else
7949             CvPADLIST(dstr)     = av_dup_inc(CvPADLIST(sstr));
7950         CvOUTSIDE(dstr) = cv_dup_inc(CvOUTSIDE(sstr));
7951         CvFLAGS(dstr)   = CvFLAGS(sstr);
7952         break;
7953     default:
7954         Perl_croak(aTHX_ "Bizarre SvTYPE [%d]", SvTYPE(sstr));
7955         break;
7956     }
7957
7958     if (SvOBJECT(dstr) && SvTYPE(dstr) != SVt_PVIO)
7959         ++PL_sv_objcount;
7960
7961     return dstr;
7962 }
7963
7964 PERL_CONTEXT *
7965 Perl_cx_dup(pTHX_ PERL_CONTEXT *cxs, I32 ix, I32 max)
7966 {
7967     PERL_CONTEXT *ncxs;
7968
7969     if (!cxs)
7970         return (PERL_CONTEXT*)NULL;
7971
7972     /* look for it in the table first */
7973     ncxs = (PERL_CONTEXT*)ptr_table_fetch(PL_ptr_table, cxs);
7974     if (ncxs)
7975         return ncxs;
7976
7977     /* create anew and remember what it is */
7978     Newz(56, ncxs, max + 1, PERL_CONTEXT);
7979     ptr_table_store(PL_ptr_table, cxs, ncxs);
7980
7981     while (ix >= 0) {
7982         PERL_CONTEXT *cx = &cxs[ix];
7983         PERL_CONTEXT *ncx = &ncxs[ix];
7984         ncx->cx_type    = cx->cx_type;
7985         if (CxTYPE(cx) == CXt_SUBST) {
7986             Perl_croak(aTHX_ "Cloning substitution context is unimplemented");
7987         }
7988         else {
7989             ncx->blk_oldsp      = cx->blk_oldsp;
7990             ncx->blk_oldcop     = cx->blk_oldcop;
7991             ncx->blk_oldretsp   = cx->blk_oldretsp;
7992             ncx->blk_oldmarksp  = cx->blk_oldmarksp;
7993             ncx->blk_oldscopesp = cx->blk_oldscopesp;
7994             ncx->blk_oldpm      = cx->blk_oldpm;
7995             ncx->blk_gimme      = cx->blk_gimme;
7996             switch (CxTYPE(cx)) {
7997             case CXt_SUB:
7998                 ncx->blk_sub.cv         = (cx->blk_sub.olddepth == 0
7999                                            ? cv_dup_inc(cx->blk_sub.cv)
8000                                            : cv_dup(cx->blk_sub.cv));
8001                 ncx->blk_sub.argarray   = (cx->blk_sub.hasargs
8002                                            ? av_dup_inc(cx->blk_sub.argarray)
8003                                            : Nullav);
8004                 ncx->blk_sub.savearray  = av_dup(cx->blk_sub.savearray);
8005                 ncx->blk_sub.olddepth   = cx->blk_sub.olddepth;
8006                 ncx->blk_sub.hasargs    = cx->blk_sub.hasargs;
8007                 ncx->blk_sub.lval       = cx->blk_sub.lval;
8008                 break;
8009             case CXt_EVAL:
8010                 ncx->blk_eval.old_in_eval = cx->blk_eval.old_in_eval;
8011                 ncx->blk_eval.old_op_type = cx->blk_eval.old_op_type;
8012                 ncx->blk_eval.old_namesv = sv_dup_inc(cx->blk_eval.old_namesv);
8013                 ncx->blk_eval.old_eval_root = cx->blk_eval.old_eval_root;
8014                 ncx->blk_eval.cur_text  = sv_dup(cx->blk_eval.cur_text);
8015                 break;
8016             case CXt_LOOP:
8017                 ncx->blk_loop.label     = cx->blk_loop.label;
8018                 ncx->blk_loop.resetsp   = cx->blk_loop.resetsp;
8019                 ncx->blk_loop.redo_op   = cx->blk_loop.redo_op;
8020                 ncx->blk_loop.next_op   = cx->blk_loop.next_op;
8021                 ncx->blk_loop.last_op   = cx->blk_loop.last_op;
8022                 ncx->blk_loop.iterdata  = (CxPADLOOP(cx)
8023                                            ? cx->blk_loop.iterdata
8024                                            : gv_dup((GV*)cx->blk_loop.iterdata));
8025                 ncx->blk_loop.oldcurpad
8026                     = (SV**)ptr_table_fetch(PL_ptr_table,
8027                                             cx->blk_loop.oldcurpad);
8028                 ncx->blk_loop.itersave  = sv_dup_inc(cx->blk_loop.itersave);
8029                 ncx->blk_loop.iterlval  = sv_dup_inc(cx->blk_loop.iterlval);
8030                 ncx->blk_loop.iterary   = av_dup_inc(cx->blk_loop.iterary);
8031                 ncx->blk_loop.iterix    = cx->blk_loop.iterix;
8032                 ncx->blk_loop.itermax   = cx->blk_loop.itermax;
8033                 break;
8034             case CXt_FORMAT:
8035                 ncx->blk_sub.cv         = cv_dup(cx->blk_sub.cv);
8036                 ncx->blk_sub.gv         = gv_dup(cx->blk_sub.gv);
8037                 ncx->blk_sub.dfoutgv    = gv_dup_inc(cx->blk_sub.dfoutgv);
8038                 ncx->blk_sub.hasargs    = cx->blk_sub.hasargs;
8039                 break;
8040             case CXt_BLOCK:
8041             case CXt_NULL:
8042                 break;
8043             }
8044         }
8045         --ix;
8046     }
8047     return ncxs;
8048 }
8049
8050 PERL_SI *
8051 Perl_si_dup(pTHX_ PERL_SI *si)
8052 {
8053     PERL_SI *nsi;
8054
8055     if (!si)
8056         return (PERL_SI*)NULL;
8057
8058     /* look for it in the table first */
8059     nsi = (PERL_SI*)ptr_table_fetch(PL_ptr_table, si);
8060     if (nsi)
8061         return nsi;
8062
8063     /* create anew and remember what it is */
8064     Newz(56, nsi, 1, PERL_SI);
8065     ptr_table_store(PL_ptr_table, si, nsi);
8066
8067     nsi->si_stack       = av_dup_inc(si->si_stack);
8068     nsi->si_cxix        = si->si_cxix;
8069     nsi->si_cxmax       = si->si_cxmax;
8070     nsi->si_cxstack     = cx_dup(si->si_cxstack, si->si_cxix, si->si_cxmax);
8071     nsi->si_type        = si->si_type;
8072     nsi->si_prev        = si_dup(si->si_prev);
8073     nsi->si_next        = si_dup(si->si_next);
8074     nsi->si_markoff     = si->si_markoff;
8075
8076     return nsi;
8077 }
8078
8079 #define POPINT(ss,ix)   ((ss)[--(ix)].any_i32)
8080 #define TOPINT(ss,ix)   ((ss)[ix].any_i32)
8081 #define POPLONG(ss,ix)  ((ss)[--(ix)].any_long)
8082 #define TOPLONG(ss,ix)  ((ss)[ix].any_long)
8083 #define POPIV(ss,ix)    ((ss)[--(ix)].any_iv)
8084 #define TOPIV(ss,ix)    ((ss)[ix].any_iv)
8085 #define POPPTR(ss,ix)   ((ss)[--(ix)].any_ptr)
8086 #define TOPPTR(ss,ix)   ((ss)[ix].any_ptr)
8087 #define POPDPTR(ss,ix)  ((ss)[--(ix)].any_dptr)
8088 #define TOPDPTR(ss,ix)  ((ss)[ix].any_dptr)
8089 #define POPDXPTR(ss,ix) ((ss)[--(ix)].any_dxptr)
8090 #define TOPDXPTR(ss,ix) ((ss)[ix].any_dxptr)
8091
8092 /* XXXXX todo */
8093 #define pv_dup_inc(p)   SAVEPV(p)
8094 #define pv_dup(p)       SAVEPV(p)
8095 #define svp_dup_inc(p,pp)       any_dup(p,pp)
8096
8097 void *
8098 Perl_any_dup(pTHX_ void *v, PerlInterpreter *proto_perl)
8099 {
8100     void *ret;
8101
8102     if (!v)
8103         return (void*)NULL;
8104
8105     /* look for it in the table first */
8106     ret = ptr_table_fetch(PL_ptr_table, v);
8107     if (ret)
8108         return ret;
8109
8110     /* see if it is part of the interpreter structure */
8111     if (v >= (void*)proto_perl && v < (void*)(proto_perl+1))
8112         ret = (void*)(((char*)aTHXo) + (((char*)v) - (char*)proto_perl));
8113     else
8114         ret = v;
8115
8116     return ret;
8117 }
8118
8119 ANY *
8120 Perl_ss_dup(pTHX_ PerlInterpreter *proto_perl)
8121 {
8122     ANY *ss     = proto_perl->Tsavestack;
8123     I32 ix      = proto_perl->Tsavestack_ix;
8124     I32 max     = proto_perl->Tsavestack_max;
8125     ANY *nss;
8126     SV *sv;
8127     GV *gv;
8128     AV *av;
8129     HV *hv;
8130     void* ptr;
8131     int intval;
8132     long longval;
8133     GP *gp;
8134     IV iv;
8135     I32 i;
8136     char *c;
8137     void (*dptr) (void*);
8138     void (*dxptr) (pTHXo_ void*);
8139     OP *o;
8140
8141     Newz(54, nss, max, ANY);
8142
8143     while (ix > 0) {
8144         i = POPINT(ss,ix);
8145         TOPINT(nss,ix) = i;
8146         switch (i) {
8147         case SAVEt_ITEM:                        /* normal string */
8148             sv = (SV*)POPPTR(ss,ix);
8149             TOPPTR(nss,ix) = sv_dup_inc(sv);
8150             sv = (SV*)POPPTR(ss,ix);
8151             TOPPTR(nss,ix) = sv_dup_inc(sv);
8152             break;
8153         case SAVEt_SV:                          /* scalar reference */
8154             sv = (SV*)POPPTR(ss,ix);
8155             TOPPTR(nss,ix) = sv_dup_inc(sv);
8156             gv = (GV*)POPPTR(ss,ix);
8157             TOPPTR(nss,ix) = gv_dup_inc(gv);
8158             break;
8159         case SAVEt_GENERIC_PVREF:               /* generic char* */
8160             c = (char*)POPPTR(ss,ix);
8161             TOPPTR(nss,ix) = pv_dup(c);
8162             ptr = POPPTR(ss,ix);
8163             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
8164             break;
8165         case SAVEt_GENERIC_SVREF:               /* generic sv */
8166         case SAVEt_SVREF:                       /* scalar reference */
8167             sv = (SV*)POPPTR(ss,ix);
8168             TOPPTR(nss,ix) = sv_dup_inc(sv);
8169             ptr = POPPTR(ss,ix);
8170             TOPPTR(nss,ix) = svp_dup_inc((SV**)ptr, proto_perl);/* XXXXX */
8171             break;
8172         case SAVEt_AV:                          /* array reference */
8173             av = (AV*)POPPTR(ss,ix);
8174             TOPPTR(nss,ix) = av_dup_inc(av);
8175             gv = (GV*)POPPTR(ss,ix);
8176             TOPPTR(nss,ix) = gv_dup(gv);
8177             break;
8178         case SAVEt_HV:                          /* hash reference */
8179             hv = (HV*)POPPTR(ss,ix);
8180             TOPPTR(nss,ix) = hv_dup_inc(hv);
8181             gv = (GV*)POPPTR(ss,ix);
8182             TOPPTR(nss,ix) = gv_dup(gv);
8183             break;
8184         case SAVEt_INT:                         /* int reference */
8185             ptr = POPPTR(ss,ix);
8186             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
8187             intval = (int)POPINT(ss,ix);
8188             TOPINT(nss,ix) = intval;
8189             break;
8190         case SAVEt_LONG:                        /* long reference */
8191             ptr = POPPTR(ss,ix);
8192             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
8193             longval = (long)POPLONG(ss,ix);
8194             TOPLONG(nss,ix) = longval;
8195             break;
8196         case SAVEt_I32:                         /* I32 reference */
8197         case SAVEt_I16:                         /* I16 reference */
8198         case SAVEt_I8:                          /* I8 reference */
8199             ptr = POPPTR(ss,ix);
8200             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
8201             i = POPINT(ss,ix);
8202             TOPINT(nss,ix) = i;
8203             break;
8204         case SAVEt_IV:                          /* IV reference */
8205             ptr = POPPTR(ss,ix);
8206             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
8207             iv = POPIV(ss,ix);
8208             TOPIV(nss,ix) = iv;
8209             break;
8210         case SAVEt_SPTR:                        /* SV* reference */
8211             ptr = POPPTR(ss,ix);
8212             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
8213             sv = (SV*)POPPTR(ss,ix);
8214             TOPPTR(nss,ix) = sv_dup(sv);
8215             break;
8216         case SAVEt_VPTR:                        /* random* reference */
8217             ptr = POPPTR(ss,ix);
8218             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
8219             ptr = POPPTR(ss,ix);
8220             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
8221             break;
8222         case SAVEt_PPTR:                        /* char* reference */
8223             ptr = POPPTR(ss,ix);
8224             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
8225             c = (char*)POPPTR(ss,ix);
8226             TOPPTR(nss,ix) = pv_dup(c);
8227             break;
8228         case SAVEt_HPTR:                        /* HV* reference */
8229             ptr = POPPTR(ss,ix);
8230             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
8231             hv = (HV*)POPPTR(ss,ix);
8232             TOPPTR(nss,ix) = hv_dup(hv);
8233             break;
8234         case SAVEt_APTR:                        /* AV* reference */
8235             ptr = POPPTR(ss,ix);
8236             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
8237             av = (AV*)POPPTR(ss,ix);
8238             TOPPTR(nss,ix) = av_dup(av);
8239             break;
8240         case SAVEt_NSTAB:
8241             gv = (GV*)POPPTR(ss,ix);
8242             TOPPTR(nss,ix) = gv_dup(gv);
8243             break;
8244         case SAVEt_GP:                          /* scalar reference */
8245             gp = (GP*)POPPTR(ss,ix);
8246             TOPPTR(nss,ix) = gp = gp_dup(gp);
8247             (void)GpREFCNT_inc(gp);
8248             gv = (GV*)POPPTR(ss,ix);
8249             TOPPTR(nss,ix) = gv_dup_inc(c);
8250             c = (char*)POPPTR(ss,ix);
8251             TOPPTR(nss,ix) = pv_dup(c);
8252             iv = POPIV(ss,ix);
8253             TOPIV(nss,ix) = iv;
8254             iv = POPIV(ss,ix);
8255             TOPIV(nss,ix) = iv;
8256             break;
8257         case SAVEt_FREESV:
8258             sv = (SV*)POPPTR(ss,ix);
8259             TOPPTR(nss,ix) = sv_dup_inc(sv);
8260             break;
8261         case SAVEt_FREEOP:
8262             ptr = POPPTR(ss,ix);
8263             if (ptr && (((OP*)ptr)->op_private & OPpREFCOUNTED)) {
8264                 /* these are assumed to be refcounted properly */
8265                 switch (((OP*)ptr)->op_type) {
8266                 case OP_LEAVESUB:
8267                 case OP_LEAVESUBLV:
8268                 case OP_LEAVEEVAL:
8269                 case OP_LEAVE:
8270                 case OP_SCOPE:
8271                 case OP_LEAVEWRITE:
8272                     TOPPTR(nss,ix) = ptr;
8273                     o = (OP*)ptr;
8274                     OpREFCNT_inc(o);
8275                     break;
8276                 default:
8277                     TOPPTR(nss,ix) = Nullop;
8278                     break;
8279                 }
8280             }
8281             else
8282                 TOPPTR(nss,ix) = Nullop;
8283             break;
8284         case SAVEt_FREEPV:
8285             c = (char*)POPPTR(ss,ix);
8286             TOPPTR(nss,ix) = pv_dup_inc(c);
8287             break;
8288         case SAVEt_CLEARSV:
8289             longval = POPLONG(ss,ix);
8290             TOPLONG(nss,ix) = longval;
8291             break;
8292         case SAVEt_DELETE:
8293             hv = (HV*)POPPTR(ss,ix);
8294             TOPPTR(nss,ix) = hv_dup_inc(hv);
8295             c = (char*)POPPTR(ss,ix);
8296             TOPPTR(nss,ix) = pv_dup_inc(c);
8297             i = POPINT(ss,ix);
8298             TOPINT(nss,ix) = i;
8299             break;
8300         case SAVEt_DESTRUCTOR:
8301             ptr = POPPTR(ss,ix);
8302             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);  /* XXX quite arbitrary */
8303             dptr = POPDPTR(ss,ix);
8304             TOPDPTR(nss,ix) = (void (*)(void*))any_dup((void *)dptr, proto_perl);
8305             break;
8306         case SAVEt_DESTRUCTOR_X:
8307             ptr = POPPTR(ss,ix);
8308             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);  /* XXX quite arbitrary */
8309             dxptr = POPDXPTR(ss,ix);
8310             TOPDXPTR(nss,ix) = (void (*)(pTHXo_ void*))any_dup((void *)dxptr, proto_perl);
8311             break;
8312         case SAVEt_REGCONTEXT:
8313         case SAVEt_ALLOC:
8314             i = POPINT(ss,ix);
8315             TOPINT(nss,ix) = i;
8316             ix -= i;
8317             break;
8318         case SAVEt_STACK_POS:           /* Position on Perl stack */
8319             i = POPINT(ss,ix);
8320             TOPINT(nss,ix) = i;
8321             break;
8322         case SAVEt_AELEM:               /* array element */
8323             sv = (SV*)POPPTR(ss,ix);
8324             TOPPTR(nss,ix) = sv_dup_inc(sv);
8325             i = POPINT(ss,ix);
8326             TOPINT(nss,ix) = i;
8327             av = (AV*)POPPTR(ss,ix);
8328             TOPPTR(nss,ix) = av_dup_inc(av);
8329             break;
8330         case SAVEt_HELEM:               /* hash element */
8331             sv = (SV*)POPPTR(ss,ix);
8332             TOPPTR(nss,ix) = sv_dup_inc(sv);
8333             sv = (SV*)POPPTR(ss,ix);
8334             TOPPTR(nss,ix) = sv_dup_inc(sv);
8335             hv = (HV*)POPPTR(ss,ix);
8336             TOPPTR(nss,ix) = hv_dup_inc(hv);
8337             break;
8338         case SAVEt_OP:
8339             ptr = POPPTR(ss,ix);
8340             TOPPTR(nss,ix) = ptr;
8341             break;
8342         case SAVEt_HINTS:
8343             i = POPINT(ss,ix);
8344             TOPINT(nss,ix) = i;
8345             break;
8346         case SAVEt_COMPPAD:
8347             av = (AV*)POPPTR(ss,ix);
8348             TOPPTR(nss,ix) = av_dup(av);
8349             break;
8350         case SAVEt_PADSV:
8351             longval = (long)POPLONG(ss,ix);
8352             TOPLONG(nss,ix) = longval;
8353             ptr = POPPTR(ss,ix);
8354             TOPPTR(nss,ix) = any_dup(ptr, proto_perl);
8355             sv = (SV*)POPPTR(ss,ix);
8356             TOPPTR(nss,ix) = sv_dup(sv);
8357             break;
8358         default:
8359             Perl_croak(aTHX_ "panic: ss_dup inconsistency");
8360         }
8361     }
8362
8363     return nss;
8364 }
8365
8366 #ifdef PERL_OBJECT
8367 #include "XSUB.h"
8368 #endif
8369
8370 PerlInterpreter *
8371 perl_clone(PerlInterpreter *proto_perl, UV flags)
8372 {
8373 #ifdef PERL_OBJECT
8374     CPerlObj *pPerl = (CPerlObj*)proto_perl;
8375 #endif
8376
8377 #ifdef PERL_IMPLICIT_SYS
8378     return perl_clone_using(proto_perl, flags,
8379                             proto_perl->IMem,
8380                             proto_perl->IMemShared,
8381                             proto_perl->IMemParse,
8382                             proto_perl->IEnv,
8383                             proto_perl->IStdIO,
8384                             proto_perl->ILIO,
8385                             proto_perl->IDir,
8386                             proto_perl->ISock,
8387                             proto_perl->IProc);
8388 }
8389
8390 PerlInterpreter *
8391 perl_clone_using(PerlInterpreter *proto_perl, UV flags,
8392                  struct IPerlMem* ipM, struct IPerlMem* ipMS,
8393                  struct IPerlMem* ipMP, struct IPerlEnv* ipE,
8394                  struct IPerlStdIO* ipStd, struct IPerlLIO* ipLIO,
8395                  struct IPerlDir* ipD, struct IPerlSock* ipS,
8396                  struct IPerlProc* ipP)
8397 {
8398     /* XXX many of the string copies here can be optimized if they're
8399      * constants; they need to be allocated as common memory and just
8400      * their pointers copied. */
8401
8402     IV i;
8403 #  ifdef PERL_OBJECT
8404     CPerlObj *pPerl = new(ipM) CPerlObj(ipM, ipMS, ipMP, ipE, ipStd, ipLIO,
8405                                         ipD, ipS, ipP);
8406     PERL_SET_THX(pPerl);
8407 #  else         /* !PERL_OBJECT */
8408     PerlInterpreter *my_perl = (PerlInterpreter*)(*ipM->pMalloc)(ipM, sizeof(PerlInterpreter));
8409     PERL_SET_THX(my_perl);
8410
8411 #    ifdef DEBUGGING
8412     memset(my_perl, 0xab, sizeof(PerlInterpreter));
8413     PL_markstack = 0;
8414     PL_scopestack = 0;
8415     PL_savestack = 0;
8416     PL_retstack = 0;
8417 #    else       /* !DEBUGGING */
8418     Zero(my_perl, 1, PerlInterpreter);
8419 #    endif      /* DEBUGGING */
8420
8421     /* host pointers */
8422     PL_Mem              = ipM;
8423     PL_MemShared        = ipMS;
8424     PL_MemParse         = ipMP;
8425     PL_Env              = ipE;
8426     PL_StdIO            = ipStd;
8427     PL_LIO              = ipLIO;
8428     PL_Dir              = ipD;
8429     PL_Sock             = ipS;
8430     PL_Proc             = ipP;
8431 #  endif        /* PERL_OBJECT */
8432 #else           /* !PERL_IMPLICIT_SYS */
8433     IV i;
8434     PerlInterpreter *my_perl = (PerlInterpreter*)PerlMem_malloc(sizeof(PerlInterpreter));
8435     PERL_SET_THX(my_perl);
8436
8437 #    ifdef DEBUGGING
8438     memset(my_perl, 0xab, sizeof(PerlInterpreter));
8439     PL_markstack = 0;
8440     PL_scopestack = 0;
8441     PL_savestack = 0;
8442     PL_retstack = 0;
8443 #    else       /* !DEBUGGING */
8444     Zero(my_perl, 1, PerlInterpreter);
8445 #    endif      /* DEBUGGING */
8446 #endif          /* PERL_IMPLICIT_SYS */
8447
8448     /* arena roots */
8449     PL_xiv_arenaroot    = NULL;
8450     PL_xiv_root         = NULL;
8451     PL_xnv_arenaroot    = NULL;
8452     PL_xnv_root         = NULL;
8453     PL_xrv_arenaroot    = NULL;
8454     PL_xrv_root         = NULL;
8455     PL_xpv_arenaroot    = NULL;
8456     PL_xpv_root         = NULL;
8457     PL_xpviv_arenaroot  = NULL;
8458     PL_xpviv_root       = NULL;
8459     PL_xpvnv_arenaroot  = NULL;
8460     PL_xpvnv_root       = NULL;
8461     PL_xpvcv_arenaroot  = NULL;
8462     PL_xpvcv_root       = NULL;
8463     PL_xpvav_arenaroot  = NULL;
8464     PL_xpvav_root       = NULL;
8465     PL_xpvhv_arenaroot  = NULL;
8466     PL_xpvhv_root       = NULL;
8467     PL_xpvmg_arenaroot  = NULL;
8468     PL_xpvmg_root       = NULL;
8469     PL_xpvlv_arenaroot  = NULL;
8470     PL_xpvlv_root       = NULL;
8471     PL_xpvbm_arenaroot  = NULL;
8472     PL_xpvbm_root       = NULL;
8473     PL_he_arenaroot     = NULL;
8474     PL_he_root          = NULL;
8475     PL_nice_chunk       = NULL;
8476     PL_nice_chunk_size  = 0;
8477     PL_sv_count         = 0;
8478     PL_sv_objcount      = 0;
8479     PL_sv_root          = Nullsv;
8480     PL_sv_arenaroot     = Nullsv;
8481
8482     PL_debug            = proto_perl->Idebug;
8483
8484     /* create SV map for pointer relocation */
8485     PL_ptr_table = ptr_table_new();
8486
8487     /* initialize these special pointers as early as possible */
8488     SvANY(&PL_sv_undef)         = NULL;
8489     SvREFCNT(&PL_sv_undef)      = (~(U32)0)/2;
8490     SvFLAGS(&PL_sv_undef)       = SVf_READONLY|SVt_NULL;
8491     ptr_table_store(PL_ptr_table, &proto_perl->Isv_undef, &PL_sv_undef);
8492
8493 #ifdef PERL_OBJECT
8494     SvUPGRADE(&PL_sv_no, SVt_PVNV);
8495 #else
8496     SvANY(&PL_sv_no)            = new_XPVNV();
8497 #endif
8498     SvREFCNT(&PL_sv_no)         = (~(U32)0)/2;
8499     SvFLAGS(&PL_sv_no)          = SVp_NOK|SVf_NOK|SVp_POK|SVf_POK|SVf_READONLY|SVt_PVNV;
8500     SvPVX(&PL_sv_no)            = SAVEPVN(PL_No, 0);
8501     SvCUR(&PL_sv_no)            = 0;
8502     SvLEN(&PL_sv_no)            = 1;
8503     SvNVX(&PL_sv_no)            = 0;
8504     ptr_table_store(PL_ptr_table, &proto_perl->Isv_no, &PL_sv_no);
8505
8506 #ifdef PERL_OBJECT
8507     SvUPGRADE(&PL_sv_yes, SVt_PVNV);
8508 #else
8509     SvANY(&PL_sv_yes)           = new_XPVNV();
8510 #endif
8511     SvREFCNT(&PL_sv_yes)        = (~(U32)0)/2;
8512     SvFLAGS(&PL_sv_yes)         = SVp_NOK|SVf_NOK|SVp_POK|SVf_POK|SVf_READONLY|SVt_PVNV;
8513     SvPVX(&PL_sv_yes)           = SAVEPVN(PL_Yes, 1);
8514     SvCUR(&PL_sv_yes)           = 1;
8515     SvLEN(&PL_sv_yes)           = 2;
8516     SvNVX(&PL_sv_yes)           = 1;
8517     ptr_table_store(PL_ptr_table, &proto_perl->Isv_yes, &PL_sv_yes);
8518
8519     /* create shared string table */
8520     PL_strtab           = newHV();
8521     HvSHAREKEYS_off(PL_strtab);
8522     hv_ksplit(PL_strtab, 512);
8523     ptr_table_store(PL_ptr_table, proto_perl->Istrtab, PL_strtab);
8524
8525     PL_compiling                = proto_perl->Icompiling;
8526     PL_compiling.cop_stashpv    = SAVEPV(PL_compiling.cop_stashpv);
8527     PL_compiling.cop_file       = SAVEPV(PL_compiling.cop_file);
8528     ptr_table_store(PL_ptr_table, &proto_perl->Icompiling, &PL_compiling);
8529     if (!specialWARN(PL_compiling.cop_warnings))
8530         PL_compiling.cop_warnings = sv_dup_inc(PL_compiling.cop_warnings);
8531     if (!specialCopIO(PL_compiling.cop_io))
8532         PL_compiling.cop_io = sv_dup_inc(PL_compiling.cop_io);
8533     PL_curcop           = (COP*)any_dup(proto_perl->Tcurcop, proto_perl);
8534
8535     /* pseudo environmental stuff */
8536     PL_origargc         = proto_perl->Iorigargc;
8537     i = PL_origargc;
8538     New(0, PL_origargv, i+1, char*);
8539     PL_origargv[i] = '\0';
8540     while (i-- > 0) {
8541         PL_origargv[i]  = SAVEPV(proto_perl->Iorigargv[i]);
8542     }
8543     PL_envgv            = gv_dup(proto_perl->Ienvgv);
8544     PL_incgv            = gv_dup(proto_perl->Iincgv);
8545     PL_hintgv           = gv_dup(proto_perl->Ihintgv);
8546     PL_origfilename     = SAVEPV(proto_perl->Iorigfilename);
8547     PL_diehook          = sv_dup_inc(proto_perl->Idiehook);
8548     PL_warnhook         = sv_dup_inc(proto_perl->Iwarnhook);
8549
8550     /* switches */
8551     PL_minus_c          = proto_perl->Iminus_c;
8552     PL_patchlevel       = sv_dup_inc(proto_perl->Ipatchlevel);
8553     PL_localpatches     = proto_perl->Ilocalpatches;
8554     PL_splitstr         = proto_perl->Isplitstr;
8555     PL_preprocess       = proto_perl->Ipreprocess;
8556     PL_minus_n          = proto_perl->Iminus_n;
8557     PL_minus_p          = proto_perl->Iminus_p;
8558     PL_minus_l          = proto_perl->Iminus_l;
8559     PL_minus_a          = proto_perl->Iminus_a;
8560     PL_minus_F          = proto_perl->Iminus_F;
8561     PL_doswitches       = proto_perl->Idoswitches;
8562     PL_dowarn           = proto_perl->Idowarn;
8563     PL_doextract        = proto_perl->Idoextract;
8564     PL_sawampersand     = proto_perl->Isawampersand;
8565     PL_unsafe           = proto_perl->Iunsafe;
8566     PL_inplace          = SAVEPV(proto_perl->Iinplace);
8567     PL_e_script         = sv_dup_inc(proto_perl->Ie_script);
8568     PL_perldb           = proto_perl->Iperldb;
8569     PL_perl_destruct_level = proto_perl->Iperl_destruct_level;
8570
8571     /* magical thingies */
8572     /* XXX time(&PL_basetime) when asked for? */
8573     PL_basetime         = proto_perl->Ibasetime;
8574     PL_formfeed         = sv_dup(proto_perl->Iformfeed);
8575
8576     PL_maxsysfd         = proto_perl->Imaxsysfd;
8577     PL_multiline        = proto_perl->Imultiline;
8578     PL_statusvalue      = proto_perl->Istatusvalue;
8579 #ifdef VMS
8580     PL_statusvalue_vms  = proto_perl->Istatusvalue_vms;
8581 #endif
8582
8583     /* shortcuts to various I/O objects */
8584     PL_stdingv          = gv_dup(proto_perl->Istdingv);
8585     PL_stderrgv         = gv_dup(proto_perl->Istderrgv);
8586     PL_defgv            = gv_dup(proto_perl->Idefgv);
8587     PL_argvgv           = gv_dup(proto_perl->Iargvgv);
8588     PL_argvoutgv        = gv_dup(proto_perl->Iargvoutgv);
8589     PL_argvout_stack    = av_dup(proto_perl->Iargvout_stack);
8590
8591     /* shortcuts to regexp stuff */
8592     PL_replgv           = gv_dup(proto_perl->Ireplgv);
8593
8594     /* shortcuts to misc objects */
8595     PL_errgv            = gv_dup(proto_perl->Ierrgv);
8596
8597     /* shortcuts to debugging objects */
8598     PL_DBgv             = gv_dup(proto_perl->IDBgv);
8599     PL_DBline           = gv_dup(proto_perl->IDBline);
8600     PL_DBsub            = gv_dup(proto_perl->IDBsub);
8601     PL_DBsingle         = sv_dup(proto_perl->IDBsingle);
8602     PL_DBtrace          = sv_dup(proto_perl->IDBtrace);
8603     PL_DBsignal         = sv_dup(proto_perl->IDBsignal);
8604     PL_lineary          = av_dup(proto_perl->Ilineary);
8605     PL_dbargs           = av_dup(proto_perl->Idbargs);
8606
8607     /* symbol tables */
8608     PL_defstash         = hv_dup_inc(proto_perl->Tdefstash);
8609     PL_curstash         = hv_dup(proto_perl->Tcurstash);
8610     PL_debstash         = hv_dup(proto_perl->Idebstash);
8611     PL_globalstash      = hv_dup(proto_perl->Iglobalstash);
8612     PL_curstname        = sv_dup_inc(proto_perl->Icurstname);
8613
8614     PL_beginav          = av_dup_inc(proto_perl->Ibeginav);
8615     PL_endav            = av_dup_inc(proto_perl->Iendav);
8616     PL_checkav          = av_dup_inc(proto_perl->Icheckav);
8617     PL_initav           = av_dup_inc(proto_perl->Iinitav);
8618
8619     PL_sub_generation   = proto_perl->Isub_generation;
8620
8621     /* funky return mechanisms */
8622     PL_forkprocess      = proto_perl->Iforkprocess;
8623
8624     /* subprocess state */
8625     PL_fdpid            = av_dup_inc(proto_perl->Ifdpid);
8626
8627     /* internal state */
8628     PL_tainting         = proto_perl->Itainting;
8629     PL_maxo             = proto_perl->Imaxo;
8630     if (proto_perl->Iop_mask)
8631         PL_op_mask      = SAVEPVN(proto_perl->Iop_mask, PL_maxo);
8632     else
8633         PL_op_mask      = Nullch;
8634
8635     /* current interpreter roots */
8636     PL_main_cv          = cv_dup_inc(proto_perl->Imain_cv);
8637     PL_main_root        = OpREFCNT_inc(proto_perl->Imain_root);
8638     PL_main_start       = proto_perl->Imain_start;
8639     PL_eval_root        = proto_perl->Ieval_root;
8640     PL_eval_start       = proto_perl->Ieval_start;
8641
8642     /* runtime control stuff */
8643     PL_curcopdb         = (COP*)any_dup(proto_perl->Icurcopdb, proto_perl);
8644     PL_copline          = proto_perl->Icopline;
8645
8646     PL_filemode         = proto_perl->Ifilemode;
8647     PL_lastfd           = proto_perl->Ilastfd;
8648     PL_oldname          = proto_perl->Ioldname;         /* XXX not quite right */
8649     PL_Argv             = NULL;
8650     PL_Cmd              = Nullch;
8651     PL_gensym           = proto_perl->Igensym;
8652     PL_preambled        = proto_perl->Ipreambled;
8653     PL_preambleav       = av_dup_inc(proto_perl->Ipreambleav);
8654     PL_laststatval      = proto_perl->Ilaststatval;
8655     PL_laststype        = proto_perl->Ilaststype;
8656     PL_mess_sv          = Nullsv;
8657
8658     PL_ors_sv           = sv_dup_inc(proto_perl->Iors_sv);
8659     PL_ofmt             = SAVEPV(proto_perl->Iofmt);
8660
8661     /* interpreter atexit processing */
8662     PL_exitlistlen      = proto_perl->Iexitlistlen;
8663     if (PL_exitlistlen) {
8664         New(0, PL_exitlist, PL_exitlistlen, PerlExitListEntry);
8665         Copy(proto_perl->Iexitlist, PL_exitlist, PL_exitlistlen, PerlExitListEntry);
8666     }
8667     else
8668         PL_exitlist     = (PerlExitListEntry*)NULL;
8669     PL_modglobal        = hv_dup_inc(proto_perl->Imodglobal);
8670
8671     PL_profiledata      = NULL;
8672     PL_rsfp             = fp_dup(proto_perl->Irsfp, '<');
8673     /* PL_rsfp_filters entries have fake IoDIRP() */
8674     PL_rsfp_filters     = av_dup_inc(proto_perl->Irsfp_filters);
8675
8676     PL_compcv                   = cv_dup(proto_perl->Icompcv);
8677     PL_comppad                  = av_dup(proto_perl->Icomppad);
8678     PL_comppad_name             = av_dup(proto_perl->Icomppad_name);
8679     PL_comppad_name_fill        = proto_perl->Icomppad_name_fill;
8680     PL_comppad_name_floor       = proto_perl->Icomppad_name_floor;
8681     PL_curpad                   = (SV**)ptr_table_fetch(PL_ptr_table,
8682                                                         proto_perl->Tcurpad);
8683
8684 #ifdef HAVE_INTERP_INTERN
8685     sys_intern_dup(&proto_perl->Isys_intern, &PL_sys_intern);
8686 #endif
8687
8688     /* more statics moved here */
8689     PL_generation       = proto_perl->Igeneration;
8690     PL_DBcv             = cv_dup(proto_perl->IDBcv);
8691
8692     PL_in_clean_objs    = proto_perl->Iin_clean_objs;
8693     PL_in_clean_all     = proto_perl->Iin_clean_all;
8694
8695     PL_uid              = proto_perl->Iuid;
8696     PL_euid             = proto_perl->Ieuid;
8697     PL_gid              = proto_perl->Igid;
8698     PL_egid             = proto_perl->Iegid;
8699     PL_nomemok          = proto_perl->Inomemok;
8700     PL_an               = proto_perl->Ian;
8701     PL_cop_seqmax       = proto_perl->Icop_seqmax;
8702     PL_op_seqmax        = proto_perl->Iop_seqmax;
8703     PL_evalseq          = proto_perl->Ievalseq;
8704     PL_origenviron      = proto_perl->Iorigenviron;     /* XXX not quite right */
8705     PL_origalen         = proto_perl->Iorigalen;
8706     PL_pidstatus        = newHV();                      /* XXX flag for cloning? */
8707     PL_osname           = SAVEPV(proto_perl->Iosname);
8708     PL_sh_path          = SAVEPV(proto_perl->Ish_path);
8709     PL_sighandlerp      = proto_perl->Isighandlerp;
8710
8711
8712     PL_runops           = proto_perl->Irunops;
8713
8714     Copy(proto_perl->Itokenbuf, PL_tokenbuf, 256, char);
8715
8716 #ifdef CSH
8717     PL_cshlen           = proto_perl->Icshlen;
8718     PL_cshname          = SAVEPVN(proto_perl->Icshname, PL_cshlen);
8719 #endif
8720
8721     PL_lex_state        = proto_perl->Ilex_state;
8722     PL_lex_defer        = proto_perl->Ilex_defer;
8723     PL_lex_expect       = proto_perl->Ilex_expect;
8724     PL_lex_formbrack    = proto_perl->Ilex_formbrack;
8725     PL_lex_dojoin       = proto_perl->Ilex_dojoin;
8726     PL_lex_starts       = proto_perl->Ilex_starts;
8727     PL_lex_stuff        = sv_dup_inc(proto_perl->Ilex_stuff);
8728     PL_lex_repl         = sv_dup_inc(proto_perl->Ilex_repl);
8729     PL_lex_op           = proto_perl->Ilex_op;
8730     PL_lex_inpat        = proto_perl->Ilex_inpat;
8731     PL_lex_inwhat       = proto_perl->Ilex_inwhat;
8732     PL_lex_brackets     = proto_perl->Ilex_brackets;
8733     i = (PL_lex_brackets < 120 ? 120 : PL_lex_brackets);
8734     PL_lex_brackstack   = SAVEPVN(proto_perl->Ilex_brackstack,i);
8735     PL_lex_casemods     = proto_perl->Ilex_casemods;
8736     i = (PL_lex_casemods < 12 ? 12 : PL_lex_casemods);
8737     PL_lex_casestack    = SAVEPVN(proto_perl->Ilex_casestack,i);
8738
8739     Copy(proto_perl->Inextval, PL_nextval, 5, YYSTYPE);
8740     Copy(proto_perl->Inexttype, PL_nexttype, 5, I32);
8741     PL_nexttoke         = proto_perl->Inexttoke;
8742
8743     PL_linestr          = sv_dup_inc(proto_perl->Ilinestr);
8744     i = proto_perl->Ibufptr - SvPVX(proto_perl->Ilinestr);
8745     PL_bufptr           = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
8746     i = proto_perl->Ioldbufptr - SvPVX(proto_perl->Ilinestr);
8747     PL_oldbufptr        = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
8748     i = proto_perl->Ioldoldbufptr - SvPVX(proto_perl->Ilinestr);
8749     PL_oldoldbufptr     = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
8750     PL_bufend           = SvPVX(PL_linestr) + SvCUR(PL_linestr);
8751     i = proto_perl->Ilinestart - SvPVX(proto_perl->Ilinestr);
8752     PL_linestart        = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
8753     PL_pending_ident    = proto_perl->Ipending_ident;
8754     PL_sublex_info      = proto_perl->Isublex_info;     /* XXX not quite right */
8755
8756     PL_expect           = proto_perl->Iexpect;
8757
8758     PL_multi_start      = proto_perl->Imulti_start;
8759     PL_multi_end        = proto_perl->Imulti_end;
8760     PL_multi_open       = proto_perl->Imulti_open;
8761     PL_multi_close      = proto_perl->Imulti_close;
8762
8763     PL_error_count      = proto_perl->Ierror_count;
8764     PL_subline          = proto_perl->Isubline;
8765     PL_subname          = sv_dup_inc(proto_perl->Isubname);
8766
8767     PL_min_intro_pending        = proto_perl->Imin_intro_pending;
8768     PL_max_intro_pending        = proto_perl->Imax_intro_pending;
8769     PL_padix                    = proto_perl->Ipadix;
8770     PL_padix_floor              = proto_perl->Ipadix_floor;
8771     PL_pad_reset_pending        = proto_perl->Ipad_reset_pending;
8772
8773     i = proto_perl->Ilast_uni - SvPVX(proto_perl->Ilinestr);
8774     PL_last_uni         = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
8775     i = proto_perl->Ilast_lop - SvPVX(proto_perl->Ilinestr);
8776     PL_last_lop         = SvPVX(PL_linestr) + (i < 0 ? 0 : i);
8777     PL_last_lop_op      = proto_perl->Ilast_lop_op;
8778     PL_in_my            = proto_perl->Iin_my;
8779     PL_in_my_stash      = hv_dup(proto_perl->Iin_my_stash);
8780 #ifdef FCRYPT
8781     PL_cryptseen        = proto_perl->Icryptseen;
8782 #endif
8783
8784     PL_hints            = proto_perl->Ihints;
8785
8786     PL_amagic_generation        = proto_perl->Iamagic_generation;
8787
8788 #ifdef USE_LOCALE_COLLATE
8789     PL_collation_ix     = proto_perl->Icollation_ix;
8790     PL_collation_name   = SAVEPV(proto_perl->Icollation_name);
8791     PL_collation_standard       = proto_perl->Icollation_standard;
8792     PL_collxfrm_base    = proto_perl->Icollxfrm_base;
8793     PL_collxfrm_mult    = proto_perl->Icollxfrm_mult;
8794 #endif /* USE_LOCALE_COLLATE */
8795
8796 #ifdef USE_LOCALE_NUMERIC
8797     PL_numeric_name     = SAVEPV(proto_perl->Inumeric_name);
8798     PL_numeric_standard = proto_perl->Inumeric_standard;
8799     PL_numeric_local    = proto_perl->Inumeric_local;
8800     PL_numeric_radix    = proto_perl->Inumeric_radix;
8801 #endif /* !USE_LOCALE_NUMERIC */
8802
8803     /* utf8 character classes */
8804     PL_utf8_alnum       = sv_dup_inc(proto_perl->Iutf8_alnum);
8805     PL_utf8_alnumc      = sv_dup_inc(proto_perl->Iutf8_alnumc);
8806     PL_utf8_ascii       = sv_dup_inc(proto_perl->Iutf8_ascii);
8807     PL_utf8_alpha       = sv_dup_inc(proto_perl->Iutf8_alpha);
8808     PL_utf8_space       = sv_dup_inc(proto_perl->Iutf8_space);
8809     PL_utf8_cntrl       = sv_dup_inc(proto_perl->Iutf8_cntrl);
8810     PL_utf8_graph       = sv_dup_inc(proto_perl->Iutf8_graph);
8811     PL_utf8_digit       = sv_dup_inc(proto_perl->Iutf8_digit);
8812     PL_utf8_upper       = sv_dup_inc(proto_perl->Iutf8_upper);
8813     PL_utf8_lower       = sv_dup_inc(proto_perl->Iutf8_lower);
8814     PL_utf8_print       = sv_dup_inc(proto_perl->Iutf8_print);
8815     PL_utf8_punct       = sv_dup_inc(proto_perl->Iutf8_punct);
8816     PL_utf8_xdigit      = sv_dup_inc(proto_perl->Iutf8_xdigit);
8817     PL_utf8_mark        = sv_dup_inc(proto_perl->Iutf8_mark);
8818     PL_utf8_toupper     = sv_dup_inc(proto_perl->Iutf8_toupper);
8819     PL_utf8_totitle     = sv_dup_inc(proto_perl->Iutf8_totitle);
8820     PL_utf8_tolower     = sv_dup_inc(proto_perl->Iutf8_tolower);
8821
8822     /* swatch cache */
8823     PL_last_swash_hv    = Nullhv;       /* reinits on demand */
8824     PL_last_swash_klen  = 0;
8825     PL_last_swash_key[0]= '\0';
8826     PL_last_swash_tmps  = (U8*)NULL;
8827     PL_last_swash_slen  = 0;
8828
8829     /* perly.c globals */
8830     PL_yydebug          = proto_perl->Iyydebug;
8831     PL_yynerrs          = proto_perl->Iyynerrs;
8832     PL_yyerrflag        = proto_perl->Iyyerrflag;
8833     PL_yychar           = proto_perl->Iyychar;
8834     PL_yyval            = proto_perl->Iyyval;
8835     PL_yylval           = proto_perl->Iyylval;
8836
8837     PL_glob_index       = proto_perl->Iglob_index;
8838     PL_srand_called     = proto_perl->Isrand_called;
8839     PL_uudmap['M']      = 0;            /* reinits on demand */
8840     PL_bitcount         = Nullch;       /* reinits on demand */
8841
8842     if (proto_perl->Ipsig_ptr) {
8843         int sig_num[] = { SIG_NUM };
8844         Newz(0, PL_psig_ptr, sizeof(sig_num)/sizeof(*sig_num), SV*);
8845         Newz(0, PL_psig_name, sizeof(sig_num)/sizeof(*sig_num), SV*);
8846         for (i = 1; PL_sig_name[i]; i++) {
8847             PL_psig_ptr[i] = sv_dup_inc(proto_perl->Ipsig_ptr[i]);
8848             PL_psig_name[i] = sv_dup_inc(proto_perl->Ipsig_name[i]);
8849         }
8850     }
8851     else {
8852         PL_psig_ptr     = (SV**)NULL;
8853         PL_psig_name    = (SV**)NULL;
8854     }
8855
8856     /* thrdvar.h stuff */
8857
8858     if (flags & 1) {
8859         /* next allocation will be PL_tmps_stack[PL_tmps_ix+1] */
8860         PL_tmps_ix              = proto_perl->Ttmps_ix;
8861         PL_tmps_max             = proto_perl->Ttmps_max;
8862         PL_tmps_floor           = proto_perl->Ttmps_floor;
8863         Newz(50, PL_tmps_stack, PL_tmps_max, SV*);
8864         i = 0;
8865         while (i <= PL_tmps_ix) {
8866             PL_tmps_stack[i]    = sv_dup_inc(proto_perl->Ttmps_stack[i]);
8867             ++i;
8868         }
8869
8870         /* next PUSHMARK() sets *(PL_markstack_ptr+1) */
8871         i = proto_perl->Tmarkstack_max - proto_perl->Tmarkstack;
8872         Newz(54, PL_markstack, i, I32);
8873         PL_markstack_max        = PL_markstack + (proto_perl->Tmarkstack_max
8874                                                   - proto_perl->Tmarkstack);
8875         PL_markstack_ptr        = PL_markstack + (proto_perl->Tmarkstack_ptr
8876                                                   - proto_perl->Tmarkstack);
8877         Copy(proto_perl->Tmarkstack, PL_markstack,
8878              PL_markstack_ptr - PL_markstack + 1, I32);
8879
8880         /* next push_scope()/ENTER sets PL_scopestack[PL_scopestack_ix]
8881          * NOTE: unlike the others! */
8882         PL_scopestack_ix        = proto_perl->Tscopestack_ix;
8883         PL_scopestack_max       = proto_perl->Tscopestack_max;
8884         Newz(54, PL_scopestack, PL_scopestack_max, I32);
8885         Copy(proto_perl->Tscopestack, PL_scopestack, PL_scopestack_ix, I32);
8886
8887         /* next push_return() sets PL_retstack[PL_retstack_ix]
8888          * NOTE: unlike the others! */
8889         PL_retstack_ix          = proto_perl->Tretstack_ix;
8890         PL_retstack_max         = proto_perl->Tretstack_max;
8891         Newz(54, PL_retstack, PL_retstack_max, OP*);
8892         Copy(proto_perl->Tretstack, PL_retstack, PL_retstack_ix, I32);
8893
8894         /* NOTE: si_dup() looks at PL_markstack */
8895         PL_curstackinfo         = si_dup(proto_perl->Tcurstackinfo);
8896
8897         /* PL_curstack          = PL_curstackinfo->si_stack; */
8898         PL_curstack             = av_dup(proto_perl->Tcurstack);
8899         PL_mainstack            = av_dup(proto_perl->Tmainstack);
8900
8901         /* next PUSHs() etc. set *(PL_stack_sp+1) */
8902         PL_stack_base           = AvARRAY(PL_curstack);
8903         PL_stack_sp             = PL_stack_base + (proto_perl->Tstack_sp
8904                                                    - proto_perl->Tstack_base);
8905         PL_stack_max            = PL_stack_base + AvMAX(PL_curstack);
8906
8907         /* next SSPUSHFOO() sets PL_savestack[PL_savestack_ix]
8908          * NOTE: unlike the others! */
8909         PL_savestack_ix         = proto_perl->Tsavestack_ix;
8910         PL_savestack_max        = proto_perl->Tsavestack_max;
8911         /*Newz(54, PL_savestack, PL_savestack_max, ANY);*/
8912         PL_savestack            = ss_dup(proto_perl);
8913     }
8914     else {
8915         init_stacks();
8916         ENTER;                  /* perl_destruct() wants to LEAVE; */
8917     }
8918
8919     PL_start_env        = proto_perl->Tstart_env;       /* XXXXXX */
8920     PL_top_env          = &PL_start_env;
8921
8922     PL_op               = proto_perl->Top;
8923
8924     PL_Sv               = Nullsv;
8925     PL_Xpv              = (XPV*)NULL;
8926     PL_na               = proto_perl->Tna;
8927
8928     PL_statbuf          = proto_perl->Tstatbuf;
8929     PL_statcache        = proto_perl->Tstatcache;
8930     PL_statgv           = gv_dup(proto_perl->Tstatgv);
8931     PL_statname         = sv_dup_inc(proto_perl->Tstatname);
8932 #ifdef HAS_TIMES
8933     PL_timesbuf         = proto_perl->Ttimesbuf;
8934 #endif
8935
8936     PL_tainted          = proto_perl->Ttainted;
8937     PL_curpm            = proto_perl->Tcurpm;   /* XXX No PMOP ref count */
8938     PL_nrs              = sv_dup_inc(proto_perl->Tnrs);
8939     PL_rs               = sv_dup_inc(proto_perl->Trs);
8940     PL_last_in_gv       = gv_dup(proto_perl->Tlast_in_gv);
8941     PL_ofs_sv           = sv_dup_inc(proto_perl->Tofs_sv);
8942     PL_defoutgv         = gv_dup_inc(proto_perl->Tdefoutgv);
8943     PL_chopset          = proto_perl->Tchopset; /* XXX never deallocated */
8944     PL_toptarget        = sv_dup_inc(proto_perl->Ttoptarget);
8945     PL_bodytarget       = sv_dup_inc(proto_perl->Tbodytarget);
8946     PL_formtarget       = sv_dup(proto_perl->Tformtarget);
8947
8948     PL_restartop        = proto_perl->Trestartop;
8949     PL_in_eval          = proto_perl->Tin_eval;
8950     PL_delaymagic       = proto_perl->Tdelaymagic;
8951     PL_dirty            = proto_perl->Tdirty;
8952     PL_localizing       = proto_perl->Tlocalizing;
8953
8954 #ifdef PERL_FLEXIBLE_EXCEPTIONS
8955     PL_protect          = proto_perl->Tprotect;
8956 #endif
8957     PL_errors           = sv_dup_inc(proto_perl->Terrors);
8958     PL_av_fetch_sv      = Nullsv;
8959     PL_hv_fetch_sv      = Nullsv;
8960     Zero(&PL_hv_fetch_ent_mh, 1, HE);                   /* XXX */
8961     PL_modcount         = proto_perl->Tmodcount;
8962     PL_lastgotoprobe    = Nullop;
8963     PL_dumpindent       = proto_perl->Tdumpindent;
8964
8965     PL_sortcop          = (OP*)any_dup(proto_perl->Tsortcop, proto_perl);
8966     PL_sortstash        = hv_dup(proto_perl->Tsortstash);
8967     PL_firstgv          = gv_dup(proto_perl->Tfirstgv);
8968     PL_secondgv         = gv_dup(proto_perl->Tsecondgv);
8969     PL_sortcxix         = proto_perl->Tsortcxix;
8970     PL_efloatbuf        = Nullch;               /* reinits on demand */
8971     PL_efloatsize       = 0;                    /* reinits on demand */
8972
8973     /* regex stuff */
8974
8975     PL_screamfirst      = NULL;
8976     PL_screamnext       = NULL;
8977     PL_maxscream        = -1;                   /* reinits on demand */
8978     PL_lastscream       = Nullsv;
8979
8980     PL_watchaddr        = NULL;
8981     PL_watchok          = Nullch;
8982
8983     PL_regdummy         = proto_perl->Tregdummy;
8984     PL_regcomp_parse    = Nullch;
8985     PL_regxend          = Nullch;
8986     PL_regcode          = (regnode*)NULL;
8987     PL_regnaughty       = 0;
8988     PL_regsawback       = 0;
8989     PL_regprecomp       = Nullch;
8990     PL_regnpar          = 0;
8991     PL_regsize          = 0;
8992     PL_regflags         = 0;
8993     PL_regseen          = 0;
8994     PL_seen_zerolen     = 0;
8995     PL_seen_evals       = 0;
8996     PL_regcomp_rx       = (regexp*)NULL;
8997     PL_extralen         = 0;
8998     PL_colorset         = 0;            /* reinits PL_colors[] */
8999     /*PL_colors[6]      = {0,0,0,0,0,0};*/
9000     PL_reg_whilem_seen  = 0;
9001     PL_reginput         = Nullch;
9002     PL_regbol           = Nullch;
9003     PL_regeol           = Nullch;
9004     PL_regstartp        = (I32*)NULL;
9005     PL_regendp          = (I32*)NULL;
9006     PL_reglastparen     = (U32*)NULL;
9007     PL_regtill          = Nullch;
9008     PL_regprev          = '\n';
9009     PL_reg_start_tmp    = (char**)NULL;
9010     PL_reg_start_tmpl   = 0;
9011     PL_regdata          = (struct reg_data*)NULL;
9012     PL_bostr            = Nullch;
9013     PL_reg_flags        = 0;
9014     PL_reg_eval_set     = 0;
9015     PL_regnarrate       = 0;
9016     PL_regprogram       = (regnode*)NULL;
9017     PL_regindent        = 0;
9018     PL_regcc            = (CURCUR*)NULL;
9019     PL_reg_call_cc      = (struct re_cc_state*)NULL;
9020     PL_reg_re           = (regexp*)NULL;
9021     PL_reg_ganch        = Nullch;
9022     PL_reg_sv           = Nullsv;
9023     PL_reg_magic        = (MAGIC*)NULL;
9024     PL_reg_oldpos       = 0;
9025     PL_reg_oldcurpm     = (PMOP*)NULL;
9026     PL_reg_curpm        = (PMOP*)NULL;
9027     PL_reg_oldsaved     = Nullch;
9028     PL_reg_oldsavedlen  = 0;
9029     PL_reg_maxiter      = 0;
9030     PL_reg_leftiter     = 0;
9031     PL_reg_poscache     = Nullch;
9032     PL_reg_poscache_size= 0;
9033
9034     /* RE engine - function pointers */
9035     PL_regcompp         = proto_perl->Tregcompp;
9036     PL_regexecp         = proto_perl->Tregexecp;
9037     PL_regint_start     = proto_perl->Tregint_start;
9038     PL_regint_string    = proto_perl->Tregint_string;
9039     PL_regfree          = proto_perl->Tregfree;
9040
9041     PL_reginterp_cnt    = 0;
9042     PL_reg_starttry     = 0;
9043
9044 #ifdef PERL_OBJECT
9045     return (PerlInterpreter*)pPerl;
9046 #else
9047     return my_perl;
9048 #endif
9049 }
9050
9051 #else   /* !USE_ITHREADS */
9052
9053 #ifdef PERL_OBJECT
9054 #include "XSUB.h"
9055 #endif
9056
9057 #endif /* USE_ITHREADS */
9058
9059 static void
9060 do_report_used(pTHXo_ SV *sv)
9061 {
9062     if (SvTYPE(sv) != SVTYPEMASK) {
9063         PerlIO_printf(Perl_debug_log, "****\n");
9064         sv_dump(sv);
9065     }
9066 }
9067
9068 static void
9069 do_clean_objs(pTHXo_ SV *sv)
9070 {
9071     SV* rv;
9072
9073     if (SvROK(sv) && SvOBJECT(rv = SvRV(sv))) {
9074         DEBUG_D((PerlIO_printf(Perl_debug_log, "Cleaning object ref:\n "), sv_dump(sv));)
9075         if (SvWEAKREF(sv)) {
9076             sv_del_backref(sv);
9077             SvWEAKREF_off(sv);
9078             SvRV(sv) = 0;
9079         } else {
9080             SvROK_off(sv);
9081             SvRV(sv) = 0;
9082             SvREFCNT_dec(rv);
9083         }
9084     }
9085
9086     /* XXX Might want to check arrays, etc. */
9087 }
9088
9089 #ifndef DISABLE_DESTRUCTOR_KLUDGE
9090 static void
9091 do_clean_named_objs(pTHXo_ SV *sv)
9092 {
9093     if (SvTYPE(sv) == SVt_PVGV && GvGP(sv)) {
9094         if ( SvOBJECT(GvSV(sv)) ||
9095              (GvAV(sv) && SvOBJECT(GvAV(sv))) ||
9096              (GvHV(sv) && SvOBJECT(GvHV(sv))) ||
9097              (GvIO(sv) && SvOBJECT(GvIO(sv))) ||
9098              (GvCV(sv) && SvOBJECT(GvCV(sv))) )
9099         {
9100             DEBUG_D((PerlIO_printf(Perl_debug_log, "Cleaning named glob object:\n "), sv_dump(sv));)
9101             SvREFCNT_dec(sv);
9102         }
9103     }
9104 }
9105 #endif
9106
9107 static void
9108 do_clean_all(pTHXo_ SV *sv)
9109 {
9110     DEBUG_D((PerlIO_printf(Perl_debug_log, "Cleaning loops: SV at 0x%"UVxf"\n", PTR2UV(sv)) );)
9111     SvFLAGS(sv) |= SVf_BREAK;
9112     SvREFCNT_dec(sv);
9113 }
9114