This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Heap decorruption.
[perl5.git] / sv.c
1 /*    sv.c
2  *
3  *    Copyright (c) 1991-2000, 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 (SvTYPE(sv) == mt)
917         return TRUE;
918
919     if (mt < SVt_PVIV)
920         (void)SvOOK_off(sv);
921
922     switch (SvTYPE(sv)) {
923     case SVt_NULL:
924         pv      = 0;
925         cur     = 0;
926         len     = 0;
927         iv      = 0;
928         nv      = 0.0;
929         magic   = 0;
930         stash   = 0;
931         break;
932     case SVt_IV:
933         pv      = 0;
934         cur     = 0;
935         len     = 0;
936         iv      = SvIVX(sv);
937         nv      = (NV)SvIVX(sv);
938         del_XIV(SvANY(sv));
939         magic   = 0;
940         stash   = 0;
941         if (mt == SVt_NV)
942             mt = SVt_PVNV;
943         else if (mt < SVt_PVIV)
944             mt = SVt_PVIV;
945         break;
946     case SVt_NV:
947         pv      = 0;
948         cur     = 0;
949         len     = 0;
950         nv      = SvNVX(sv);
951         iv      = I_V(nv);
952         magic   = 0;
953         stash   = 0;
954         del_XNV(SvANY(sv));
955         SvANY(sv) = 0;
956         if (mt < SVt_PVNV)
957             mt = SVt_PVNV;
958         break;
959     case SVt_RV:
960         pv      = (char*)SvRV(sv);
961         cur     = 0;
962         len     = 0;
963         iv      = PTR2IV(pv);
964         nv      = PTR2NV(pv);
965         del_XRV(SvANY(sv));
966         magic   = 0;
967         stash   = 0;
968         break;
969     case SVt_PV:
970         pv      = SvPVX(sv);
971         cur     = SvCUR(sv);
972         len     = SvLEN(sv);
973         iv      = 0;
974         nv      = 0.0;
975         magic   = 0;
976         stash   = 0;
977         del_XPV(SvANY(sv));
978         if (mt <= SVt_IV)
979             mt = SVt_PVIV;
980         else if (mt == SVt_NV)
981             mt = SVt_PVNV;
982         break;
983     case SVt_PVIV:
984         pv      = SvPVX(sv);
985         cur     = SvCUR(sv);
986         len     = SvLEN(sv);
987         iv      = SvIVX(sv);
988         nv      = 0.0;
989         magic   = 0;
990         stash   = 0;
991         del_XPVIV(SvANY(sv));
992         break;
993     case SVt_PVNV:
994         pv      = SvPVX(sv);
995         cur     = SvCUR(sv);
996         len     = SvLEN(sv);
997         iv      = SvIVX(sv);
998         nv      = SvNVX(sv);
999         magic   = 0;
1000         stash   = 0;
1001         del_XPVNV(SvANY(sv));
1002         break;
1003     case SVt_PVMG:
1004         pv      = SvPVX(sv);
1005         cur     = SvCUR(sv);
1006         len     = SvLEN(sv);
1007         iv      = SvIVX(sv);
1008         nv      = SvNVX(sv);
1009         magic   = SvMAGIC(sv);
1010         stash   = SvSTASH(sv);
1011         del_XPVMG(SvANY(sv));
1012         break;
1013     default:
1014         Perl_croak(aTHX_ "Can't upgrade that kind of scalar");
1015     }
1016
1017     switch (mt) {
1018     case SVt_NULL:
1019         Perl_croak(aTHX_ "Can't upgrade to undef");
1020     case SVt_IV:
1021         SvANY(sv) = new_XIV();
1022         SvIVX(sv)       = iv;
1023         break;
1024     case SVt_NV:
1025         SvANY(sv) = new_XNV();
1026         SvNVX(sv)       = nv;
1027         break;
1028     case SVt_RV:
1029         SvANY(sv) = new_XRV();
1030         SvRV(sv) = (SV*)pv;
1031         break;
1032     case SVt_PV:
1033         SvANY(sv) = new_XPV();
1034         SvPVX(sv)       = pv;
1035         SvCUR(sv)       = cur;
1036         SvLEN(sv)       = len;
1037         break;
1038     case SVt_PVIV:
1039         SvANY(sv) = new_XPVIV();
1040         SvPVX(sv)       = pv;
1041         SvCUR(sv)       = cur;
1042         SvLEN(sv)       = len;
1043         SvIVX(sv)       = iv;
1044         if (SvNIOK(sv))
1045             (void)SvIOK_on(sv);
1046         SvNOK_off(sv);
1047         break;
1048     case SVt_PVNV:
1049         SvANY(sv) = new_XPVNV();
1050         SvPVX(sv)       = pv;
1051         SvCUR(sv)       = cur;
1052         SvLEN(sv)       = len;
1053         SvIVX(sv)       = iv;
1054         SvNVX(sv)       = nv;
1055         break;
1056     case SVt_PVMG:
1057         SvANY(sv) = new_XPVMG();
1058         SvPVX(sv)       = pv;
1059         SvCUR(sv)       = cur;
1060         SvLEN(sv)       = len;
1061         SvIVX(sv)       = iv;
1062         SvNVX(sv)       = nv;
1063         SvMAGIC(sv)     = magic;
1064         SvSTASH(sv)     = stash;
1065         break;
1066     case SVt_PVLV:
1067         SvANY(sv) = new_XPVLV();
1068         SvPVX(sv)       = pv;
1069         SvCUR(sv)       = cur;
1070         SvLEN(sv)       = len;
1071         SvIVX(sv)       = iv;
1072         SvNVX(sv)       = nv;
1073         SvMAGIC(sv)     = magic;
1074         SvSTASH(sv)     = stash;
1075         LvTARGOFF(sv)   = 0;
1076         LvTARGLEN(sv)   = 0;
1077         LvTARG(sv)      = 0;
1078         LvTYPE(sv)      = 0;
1079         break;
1080     case SVt_PVAV:
1081         SvANY(sv) = new_XPVAV();
1082         if (pv)
1083             Safefree(pv);
1084         SvPVX(sv)       = 0;
1085         AvMAX(sv)       = -1;
1086         AvFILLp(sv)     = -1;
1087         SvIVX(sv)       = 0;
1088         SvNVX(sv)       = 0.0;
1089         SvMAGIC(sv)     = magic;
1090         SvSTASH(sv)     = stash;
1091         AvALLOC(sv)     = 0;
1092         AvARYLEN(sv)    = 0;
1093         AvFLAGS(sv)     = 0;
1094         break;
1095     case SVt_PVHV:
1096         SvANY(sv) = new_XPVHV();
1097         if (pv)
1098             Safefree(pv);
1099         SvPVX(sv)       = 0;
1100         HvFILL(sv)      = 0;
1101         HvMAX(sv)       = 0;
1102         HvKEYS(sv)      = 0;
1103         SvNVX(sv)       = 0.0;
1104         SvMAGIC(sv)     = magic;
1105         SvSTASH(sv)     = stash;
1106         HvRITER(sv)     = 0;
1107         HvEITER(sv)     = 0;
1108         HvPMROOT(sv)    = 0;
1109         HvNAME(sv)      = 0;
1110         break;
1111     case SVt_PVCV:
1112         SvANY(sv) = new_XPVCV();
1113         Zero(SvANY(sv), 1, XPVCV);
1114         SvPVX(sv)       = pv;
1115         SvCUR(sv)       = cur;
1116         SvLEN(sv)       = len;
1117         SvIVX(sv)       = iv;
1118         SvNVX(sv)       = nv;
1119         SvMAGIC(sv)     = magic;
1120         SvSTASH(sv)     = stash;
1121         break;
1122     case SVt_PVGV:
1123         SvANY(sv) = new_XPVGV();
1124         SvPVX(sv)       = pv;
1125         SvCUR(sv)       = cur;
1126         SvLEN(sv)       = len;
1127         SvIVX(sv)       = iv;
1128         SvNVX(sv)       = nv;
1129         SvMAGIC(sv)     = magic;
1130         SvSTASH(sv)     = stash;
1131         GvGP(sv)        = 0;
1132         GvNAME(sv)      = 0;
1133         GvNAMELEN(sv)   = 0;
1134         GvSTASH(sv)     = 0;
1135         GvFLAGS(sv)     = 0;
1136         break;
1137     case SVt_PVBM:
1138         SvANY(sv) = new_XPVBM();
1139         SvPVX(sv)       = pv;
1140         SvCUR(sv)       = cur;
1141         SvLEN(sv)       = len;
1142         SvIVX(sv)       = iv;
1143         SvNVX(sv)       = nv;
1144         SvMAGIC(sv)     = magic;
1145         SvSTASH(sv)     = stash;
1146         BmRARE(sv)      = 0;
1147         BmUSEFUL(sv)    = 0;
1148         BmPREVIOUS(sv)  = 0;
1149         break;
1150     case SVt_PVFM:
1151         SvANY(sv) = new_XPVFM();
1152         Zero(SvANY(sv), 1, XPVFM);
1153         SvPVX(sv)       = pv;
1154         SvCUR(sv)       = cur;
1155         SvLEN(sv)       = len;
1156         SvIVX(sv)       = iv;
1157         SvNVX(sv)       = nv;
1158         SvMAGIC(sv)     = magic;
1159         SvSTASH(sv)     = stash;
1160         break;
1161     case SVt_PVIO:
1162         SvANY(sv) = new_XPVIO();
1163         Zero(SvANY(sv), 1, XPVIO);
1164         SvPVX(sv)       = pv;
1165         SvCUR(sv)       = cur;
1166         SvLEN(sv)       = len;
1167         SvIVX(sv)       = iv;
1168         SvNVX(sv)       = nv;
1169         SvMAGIC(sv)     = magic;
1170         SvSTASH(sv)     = stash;
1171         IoPAGE_LEN(sv)  = 60;
1172         break;
1173     }
1174     SvFLAGS(sv) &= ~SVTYPEMASK;
1175     SvFLAGS(sv) |= mt;
1176     return TRUE;
1177 }
1178
1179 int
1180 Perl_sv_backoff(pTHX_ register SV *sv)
1181 {
1182     assert(SvOOK(sv));
1183     if (SvIVX(sv)) {
1184         char *s = SvPVX(sv);
1185         SvLEN(sv) += SvIVX(sv);
1186         SvPVX(sv) -= SvIVX(sv);
1187         SvIV_set(sv, 0);
1188         Move(s, SvPVX(sv), SvCUR(sv)+1, char);
1189     }
1190     SvFLAGS(sv) &= ~SVf_OOK;
1191     return 0;
1192 }
1193
1194 /*
1195 =for apidoc sv_grow
1196
1197 Expands the character buffer in the SV.  This will use C<sv_unref> and will
1198 upgrade the SV to C<SVt_PV>.  Returns a pointer to the character buffer.
1199 Use C<SvGROW>.
1200
1201 =cut
1202 */
1203
1204 char *
1205 Perl_sv_grow(pTHX_ register SV *sv, register STRLEN newlen)
1206 {
1207     register char *s;
1208
1209 #ifdef HAS_64K_LIMIT
1210     if (newlen >= 0x10000) {
1211         PerlIO_printf(Perl_debug_log,
1212                       "Allocation too large: %"UVxf"\n", (UV)newlen);
1213         my_exit(1);
1214     }
1215 #endif /* HAS_64K_LIMIT */
1216     if (SvROK(sv))
1217         sv_unref(sv);
1218     if (SvTYPE(sv) < SVt_PV) {
1219         sv_upgrade(sv, SVt_PV);
1220         s = SvPVX(sv);
1221     }
1222     else if (SvOOK(sv)) {       /* pv is offset? */
1223         sv_backoff(sv);
1224         s = SvPVX(sv);
1225         if (newlen > SvLEN(sv))
1226             newlen += 10 * (newlen - SvCUR(sv)); /* avoid copy each time */
1227 #ifdef HAS_64K_LIMIT
1228         if (newlen >= 0x10000)
1229             newlen = 0xFFFF;
1230 #endif
1231     }
1232     else
1233         s = SvPVX(sv);
1234     if (newlen > SvLEN(sv)) {           /* need more room? */
1235         if (SvLEN(sv) && s) {
1236 #if defined(MYMALLOC) && !defined(LEAKTEST)
1237             STRLEN l = malloced_size((void*)SvPVX(sv));
1238             if (newlen <= l) {
1239                 SvLEN_set(sv, l);
1240                 return s;
1241             } else
1242 #endif
1243             Renew(s,newlen,char);
1244         }
1245         else
1246             New(703,s,newlen,char);
1247         SvPV_set(sv, s);
1248         SvLEN_set(sv, newlen);
1249     }
1250     return s;
1251 }
1252
1253 /*
1254 =for apidoc sv_setiv
1255
1256 Copies an integer into the given SV.  Does not handle 'set' magic.  See
1257 C<sv_setiv_mg>.
1258
1259 =cut
1260 */
1261
1262 void
1263 Perl_sv_setiv(pTHX_ register SV *sv, IV i)
1264 {
1265     SV_CHECK_THINKFIRST(sv);
1266     switch (SvTYPE(sv)) {
1267     case SVt_NULL:
1268         sv_upgrade(sv, SVt_IV);
1269         break;
1270     case SVt_NV:
1271         sv_upgrade(sv, SVt_PVNV);
1272         break;
1273     case SVt_RV:
1274     case SVt_PV:
1275         sv_upgrade(sv, SVt_PVIV);
1276         break;
1277
1278     case SVt_PVGV:
1279     case SVt_PVAV:
1280     case SVt_PVHV:
1281     case SVt_PVCV:
1282     case SVt_PVFM:
1283     case SVt_PVIO:
1284         {
1285             dTHR;
1286             Perl_croak(aTHX_ "Can't coerce %s to integer in %s", sv_reftype(sv,0),
1287                   PL_op_desc[PL_op->op_type]);
1288         }
1289     }
1290     (void)SvIOK_only(sv);                       /* validate number */
1291     SvIVX(sv) = i;
1292     SvTAINT(sv);
1293 }
1294
1295 /*
1296 =for apidoc sv_setiv_mg
1297
1298 Like C<sv_setiv>, but also handles 'set' magic.
1299
1300 =cut
1301 */
1302
1303 void
1304 Perl_sv_setiv_mg(pTHX_ register SV *sv, IV i)
1305 {
1306     sv_setiv(sv,i);
1307     SvSETMAGIC(sv);
1308 }
1309
1310 /*
1311 =for apidoc sv_setuv
1312
1313 Copies an unsigned integer into the given SV.  Does not handle 'set' magic.
1314 See C<sv_setuv_mg>.
1315
1316 =cut
1317 */
1318
1319 void
1320 Perl_sv_setuv(pTHX_ register SV *sv, UV u)
1321 {
1322     sv_setiv(sv, 0);
1323     SvIsUV_on(sv);
1324     SvUVX(sv) = u;
1325 }
1326
1327 /*
1328 =for apidoc sv_setuv_mg
1329
1330 Like C<sv_setuv>, but also handles 'set' magic.
1331
1332 =cut
1333 */
1334
1335 void
1336 Perl_sv_setuv_mg(pTHX_ register SV *sv, UV u)
1337 {
1338     sv_setuv(sv,u);
1339     SvSETMAGIC(sv);
1340 }
1341
1342 /*
1343 =for apidoc sv_setnv
1344
1345 Copies a double into the given SV.  Does not handle 'set' magic.  See
1346 C<sv_setnv_mg>.
1347
1348 =cut
1349 */
1350
1351 void
1352 Perl_sv_setnv(pTHX_ register SV *sv, NV num)
1353 {
1354     SV_CHECK_THINKFIRST(sv);
1355     switch (SvTYPE(sv)) {
1356     case SVt_NULL:
1357     case SVt_IV:
1358         sv_upgrade(sv, SVt_NV);
1359         break;
1360     case SVt_RV:
1361     case SVt_PV:
1362     case SVt_PVIV:
1363         sv_upgrade(sv, SVt_PVNV);
1364         break;
1365
1366     case SVt_PVGV:
1367     case SVt_PVAV:
1368     case SVt_PVHV:
1369     case SVt_PVCV:
1370     case SVt_PVFM:
1371     case SVt_PVIO:
1372         {
1373             dTHR;
1374             Perl_croak(aTHX_ "Can't coerce %s to number in %s", sv_reftype(sv,0),
1375                   PL_op_name[PL_op->op_type]);
1376         }
1377     }
1378     SvNVX(sv) = num;
1379     (void)SvNOK_only(sv);                       /* validate number */
1380     SvTAINT(sv);
1381 }
1382
1383 /*
1384 =for apidoc sv_setnv_mg
1385
1386 Like C<sv_setnv>, but also handles 'set' magic.
1387
1388 =cut
1389 */
1390
1391 void
1392 Perl_sv_setnv_mg(pTHX_ register SV *sv, NV num)
1393 {
1394     sv_setnv(sv,num);
1395     SvSETMAGIC(sv);
1396 }
1397
1398 STATIC void
1399 S_not_a_number(pTHX_ SV *sv)
1400 {
1401     dTHR;
1402     char tmpbuf[64];
1403     char *d = tmpbuf;
1404     char *s;
1405     char *limit = tmpbuf + sizeof(tmpbuf) - 8;
1406                   /* each *s can expand to 4 chars + "...\0",
1407                      i.e. need room for 8 chars */
1408
1409     for (s = SvPVX(sv); *s && d < limit; s++) {
1410         int ch = *s & 0xFF;
1411         if (ch & 128 && !isPRINT_LC(ch)) {
1412             *d++ = 'M';
1413             *d++ = '-';
1414             ch &= 127;
1415         }
1416         if (ch == '\n') {
1417             *d++ = '\\';
1418             *d++ = 'n';
1419         }
1420         else if (ch == '\r') {
1421             *d++ = '\\';
1422             *d++ = 'r';
1423         }
1424         else if (ch == '\f') {
1425             *d++ = '\\';
1426             *d++ = 'f';
1427         }
1428         else if (ch == '\\') {
1429             *d++ = '\\';
1430             *d++ = '\\';
1431         }
1432         else if (isPRINT_LC(ch))
1433             *d++ = ch;
1434         else {
1435             *d++ = '^';
1436             *d++ = toCTRL(ch);
1437         }
1438     }
1439     if (*s) {
1440         *d++ = '.';
1441         *d++ = '.';
1442         *d++ = '.';
1443     }
1444     *d = '\0';
1445
1446     if (PL_op)
1447         Perl_warner(aTHX_ WARN_NUMERIC,
1448                     "Argument \"%s\" isn't numeric in %s", tmpbuf,
1449                 PL_op_desc[PL_op->op_type]);
1450     else
1451         Perl_warner(aTHX_ WARN_NUMERIC,
1452                     "Argument \"%s\" isn't numeric", tmpbuf);
1453 }
1454
1455 /* the number can be converted to integer with atol() or atoll() */
1456 #define IS_NUMBER_TO_INT_BY_ATOL 0x01
1457 #define IS_NUMBER_TO_INT_BY_ATOF 0x02 /* atol() may be != atof() */
1458 #define IS_NUMBER_NOT_IV         0x04 /* (IV)atof() may be != atof() */
1459 #define IS_NUMBER_NEG            0x08 /* not good to cache UV */
1460 #define IS_NUMBER_INFINITY       0x10 /* this is big */
1461
1462 /* Actually, ISO C leaves conversion of UV to IV undefined, but
1463    until proven guilty, assume that things are not that bad... */
1464
1465 IV
1466 Perl_sv_2iv(pTHX_ register SV *sv)
1467 {
1468     if (!sv)
1469         return 0;
1470     if (SvGMAGICAL(sv)) {
1471         mg_get(sv);
1472         if (SvIOKp(sv))
1473             return SvIVX(sv);
1474         if (SvNOKp(sv)) {
1475             return I_V(SvNVX(sv));
1476         }
1477         if (SvPOKp(sv) && SvLEN(sv))
1478             return asIV(sv);
1479         if (!SvROK(sv)) {
1480             if (!(SvFLAGS(sv) & SVs_PADTMP)) {
1481                 dTHR;
1482                 if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
1483                     report_uninit();
1484             }
1485             return 0;
1486         }
1487     }
1488     if (SvTHINKFIRST(sv)) {
1489         if (SvROK(sv)) {
1490           SV* tmpstr;
1491           if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv, numer)))
1492               return SvIV(tmpstr);
1493           return PTR2IV(SvRV(sv));
1494         }
1495         if (SvREADONLY(sv) && !SvOK(sv)) {
1496             dTHR;
1497             if (ckWARN(WARN_UNINITIALIZED))
1498                 report_uninit();
1499             return 0;
1500         }
1501     }
1502     if (SvIOKp(sv)) {
1503         if (SvIsUV(sv)) {
1504             return (IV)(SvUVX(sv));
1505         }
1506         else {
1507             return SvIVX(sv);
1508         }
1509     }
1510     if (SvNOKp(sv)) {
1511         /* We can cache the IV/UV value even if it not good enough
1512          * to reconstruct NV, since the conversion to PV will prefer
1513          * NV over IV/UV.
1514          */
1515
1516         if (SvTYPE(sv) == SVt_NV)
1517             sv_upgrade(sv, SVt_PVNV);
1518
1519         (void)SvIOK_on(sv);
1520         if (SvNVX(sv) < (NV)IV_MAX + 0.5)
1521             SvIVX(sv) = I_V(SvNVX(sv));
1522         else {
1523             SvUVX(sv) = U_V(SvNVX(sv));
1524             SvIsUV_on(sv);
1525           ret_iv_max:
1526             DEBUG_c(PerlIO_printf(Perl_debug_log, 
1527                                   "0x%"UVxf" 2iv(%"UVuf" => %"IVdf") (as unsigned)\n",
1528                                   PTR2UV(sv),
1529                                   SvUVX(sv),
1530                                   SvUVX(sv)));
1531             return (IV)SvUVX(sv);
1532         }
1533     }
1534     else if (SvPOKp(sv) && SvLEN(sv)) {
1535         I32 numtype = looks_like_number(sv);
1536
1537         /* We want to avoid a possible problem when we cache an IV which
1538            may be later translated to an NV, and the resulting NV is not
1539            the translation of the initial data.
1540           
1541            This means that if we cache such an IV, we need to cache the
1542            NV as well.  Moreover, we trade speed for space, and do not
1543            cache the NV if not needed.
1544          */
1545         if (numtype & IS_NUMBER_NOT_IV) {
1546             /* May be not an integer.  Need to cache NV if we cache IV
1547              * - otherwise future conversion to NV will be wrong.  */
1548             NV d;
1549
1550             d = Atof(SvPVX(sv));
1551
1552             if (SvTYPE(sv) < SVt_PVNV)
1553                 sv_upgrade(sv, SVt_PVNV);
1554             SvNVX(sv) = d;
1555             (void)SvNOK_on(sv);
1556             (void)SvIOK_on(sv);
1557 #if defined(USE_LONG_DOUBLE)
1558             DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2nv(%" PERL_PRIgldbl ")\n",
1559                                   PTR2UV(sv), SvNVX(sv)));
1560 #else
1561             DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2nv(%g)\n",
1562                                   PTR2UV(sv), SvNVX(sv)));
1563 #endif
1564             if (SvNVX(sv) < (NV)IV_MAX + 0.5)
1565                 SvIVX(sv) = I_V(SvNVX(sv));
1566             else {
1567                 SvUVX(sv) = U_V(SvNVX(sv));
1568                 SvIsUV_on(sv);
1569                 goto ret_iv_max;
1570             }
1571         }
1572         else {  /* The NV may be reconstructed from IV - safe to cache IV,
1573                    which may be calculated by atol(). */
1574             if (SvTYPE(sv) < SVt_PVIV)
1575                 sv_upgrade(sv, SVt_PVIV);
1576             (void)SvIOK_on(sv);
1577             SvIVX(sv) = Atol(SvPVX(sv));
1578             if (! numtype && ckWARN(WARN_NUMERIC))
1579                 not_a_number(sv);
1580         }
1581     }
1582     else  {
1583         dTHR;
1584         if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing && !(SvFLAGS(sv) & SVs_PADTMP))
1585             report_uninit();
1586         if (SvTYPE(sv) < SVt_IV)
1587             /* Typically the caller expects that sv_any is not NULL now.  */
1588             sv_upgrade(sv, SVt_IV);
1589         return 0;
1590     }
1591     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2iv(%"IVdf")\n",
1592         PTR2UV(sv),SvIVX(sv)));
1593     return SvIsUV(sv) ? (IV)SvUVX(sv) : SvIVX(sv);
1594 }
1595
1596 UV
1597 Perl_sv_2uv(pTHX_ register SV *sv)
1598 {
1599     if (!sv)
1600         return 0;
1601     if (SvGMAGICAL(sv)) {
1602         mg_get(sv);
1603         if (SvIOKp(sv))
1604             return SvUVX(sv);
1605         if (SvNOKp(sv))
1606             return U_V(SvNVX(sv));
1607         if (SvPOKp(sv) && SvLEN(sv))
1608             return asUV(sv);
1609         if (!SvROK(sv)) {
1610             if (!(SvFLAGS(sv) & SVs_PADTMP)) {
1611                 dTHR;
1612                 if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
1613                     report_uninit();
1614             }
1615             return 0;
1616         }
1617     }
1618     if (SvTHINKFIRST(sv)) {
1619         if (SvROK(sv)) {
1620           SV* tmpstr;
1621           if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv, numer)))
1622               return SvUV(tmpstr);
1623           return PTR2UV(SvRV(sv));
1624         }
1625         if (SvREADONLY(sv) && !SvOK(sv)) {
1626             dTHR;
1627             if (ckWARN(WARN_UNINITIALIZED))
1628                 report_uninit();
1629             return 0;
1630         }
1631     }
1632     if (SvIOKp(sv)) {
1633         if (SvIsUV(sv)) {
1634             return SvUVX(sv);
1635         }
1636         else {
1637             return (UV)SvIVX(sv);
1638         }
1639     }
1640     if (SvNOKp(sv)) {
1641         /* We can cache the IV/UV value even if it not good enough
1642          * to reconstruct NV, since the conversion to PV will prefer
1643          * NV over IV/UV.
1644          */
1645         if (SvTYPE(sv) == SVt_NV)
1646             sv_upgrade(sv, SVt_PVNV);
1647         (void)SvIOK_on(sv);
1648         if (SvNVX(sv) >= -0.5) {
1649             SvIsUV_on(sv);
1650             SvUVX(sv) = U_V(SvNVX(sv));
1651         }
1652         else {
1653             SvIVX(sv) = I_V(SvNVX(sv));
1654           ret_zero:
1655             DEBUG_c(PerlIO_printf(Perl_debug_log, 
1656                                   "0x%"UVxf" 2uv(%"IVdf" => %"IVdf") (as signed)\n",
1657                                   PTR2UV(sv),
1658                                   SvIVX(sv),
1659                                   (IV)(UV)SvIVX(sv)));
1660             return (UV)SvIVX(sv);
1661         }
1662     }
1663     else if (SvPOKp(sv) && SvLEN(sv)) {
1664         I32 numtype = looks_like_number(sv);
1665
1666         /* We want to avoid a possible problem when we cache a UV which
1667            may be later translated to an NV, and the resulting NV is not
1668            the translation of the initial data.
1669           
1670            This means that if we cache such a UV, we need to cache the
1671            NV as well.  Moreover, we trade speed for space, and do not
1672            cache the NV if not needed.
1673          */
1674         if (numtype & IS_NUMBER_NOT_IV) {
1675             /* May be not an integer.  Need to cache NV if we cache IV
1676              * - otherwise future conversion to NV will be wrong.  */
1677             NV d;
1678
1679             d = Atof(SvPVX(sv));
1680
1681             if (SvTYPE(sv) < SVt_PVNV)
1682                 sv_upgrade(sv, SVt_PVNV);
1683             SvNVX(sv) = d;
1684             (void)SvNOK_on(sv);
1685             (void)SvIOK_on(sv);
1686 #if defined(USE_LONG_DOUBLE)
1687             DEBUG_c(PerlIO_printf(Perl_debug_log,
1688                                   "0x%"UVxf" 2nv(%" PERL_PRIgldbl ")\n",
1689                                   PTR2UV(sv), SvNVX(sv)));
1690 #else
1691             DEBUG_c(PerlIO_printf(Perl_debug_log,
1692                                   "0x%"UVxf" 2nv(%g)\n",
1693                                   PTR2UV(sv), SvNVX(sv)));
1694 #endif
1695             if (SvNVX(sv) < -0.5) {
1696                 SvIVX(sv) = I_V(SvNVX(sv));
1697                 goto ret_zero;
1698             } else {
1699                 SvUVX(sv) = U_V(SvNVX(sv));
1700                 SvIsUV_on(sv);
1701             }
1702         }
1703         else if (numtype & IS_NUMBER_NEG) {
1704             /* The NV may be reconstructed from IV - safe to cache IV,
1705                which may be calculated by atol(). */
1706             if (SvTYPE(sv) == SVt_PV)
1707                 sv_upgrade(sv, SVt_PVIV);
1708             (void)SvIOK_on(sv);
1709             SvIVX(sv) = (IV)Atol(SvPVX(sv));
1710         }
1711         else if (numtype) {             /* Non-negative */
1712             /* The NV may be reconstructed from UV - safe to cache UV,
1713                which may be calculated by strtoul()/atol. */
1714             if (SvTYPE(sv) == SVt_PV)
1715                 sv_upgrade(sv, SVt_PVIV);
1716             (void)SvIOK_on(sv);
1717             (void)SvIsUV_on(sv);
1718 #ifdef HAS_STRTOUL
1719             SvUVX(sv) = Strtoul(SvPVX(sv), Null(char**), 10);
1720 #else                   /* no atou(), but we know the number fits into IV... */
1721                         /* The only problem may be if it is negative... */
1722             SvUVX(sv) = (UV)Atol(SvPVX(sv));
1723 #endif
1724         }
1725         else {                          /* Not a number.  Cache 0. */
1726             dTHR;
1727
1728             if (SvTYPE(sv) < SVt_PVIV)
1729                 sv_upgrade(sv, SVt_PVIV);
1730             (void)SvIOK_on(sv);
1731             (void)SvIsUV_on(sv);
1732             SvUVX(sv) = 0;              /* We assume that 0s have the
1733                                            same bitmap in IV and UV. */
1734             if (ckWARN(WARN_NUMERIC))
1735                 not_a_number(sv);
1736         }
1737     }
1738     else  {
1739         if (!(SvFLAGS(sv) & SVs_PADTMP)) {
1740             dTHR;
1741             if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
1742                 report_uninit();
1743         }
1744         if (SvTYPE(sv) < SVt_IV)
1745             /* Typically the caller expects that sv_any is not NULL now.  */
1746             sv_upgrade(sv, SVt_IV);
1747         return 0;
1748     }
1749
1750     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2uv(%"UVuf")\n",
1751                           PTR2UV(sv),SvUVX(sv)));
1752     return SvIsUV(sv) ? SvUVX(sv) : (UV)SvIVX(sv);
1753 }
1754
1755 NV
1756 Perl_sv_2nv(pTHX_ register SV *sv)
1757 {
1758     if (!sv)
1759         return 0.0;
1760     if (SvGMAGICAL(sv)) {
1761         mg_get(sv);
1762         if (SvNOKp(sv))
1763             return SvNVX(sv);
1764         if (SvPOKp(sv) && SvLEN(sv)) {
1765             dTHR;
1766             if (ckWARN(WARN_NUMERIC) && !SvIOKp(sv) && !looks_like_number(sv))
1767                 not_a_number(sv);
1768             return Atof(SvPVX(sv));
1769         }
1770         if (SvIOKp(sv)) {
1771             if (SvIsUV(sv)) 
1772                 return (NV)SvUVX(sv);
1773             else
1774                 return (NV)SvIVX(sv);
1775         }       
1776         if (!SvROK(sv)) {
1777             if (!(SvFLAGS(sv) & SVs_PADTMP)) {
1778                 dTHR;
1779                 if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
1780                     report_uninit();
1781             }
1782             return 0;
1783         }
1784     }
1785     if (SvTHINKFIRST(sv)) {
1786         if (SvROK(sv)) {
1787           SV* tmpstr;
1788           if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv,numer)))
1789               return SvNV(tmpstr);
1790           return PTR2NV(SvRV(sv));
1791         }
1792         if (SvREADONLY(sv) && !SvOK(sv)) {
1793             dTHR;
1794             if (ckWARN(WARN_UNINITIALIZED))
1795                 report_uninit();
1796             return 0.0;
1797         }
1798     }
1799     if (SvTYPE(sv) < SVt_NV) {
1800         if (SvTYPE(sv) == SVt_IV)
1801             sv_upgrade(sv, SVt_PVNV);
1802         else
1803             sv_upgrade(sv, SVt_NV);
1804 #if defined(USE_LONG_DOUBLE)
1805         DEBUG_c({
1806             STORE_NUMERIC_LOCAL_SET_STANDARD();
1807             PerlIO_printf(Perl_debug_log,
1808                           "0x%"UVxf" num(%" PERL_PRIgldbl ")\n",
1809                           PTR2UV(sv), SvNVX(sv));
1810             RESTORE_NUMERIC_LOCAL();
1811         });
1812 #else
1813         DEBUG_c({
1814             STORE_NUMERIC_LOCAL_SET_STANDARD();
1815             PerlIO_printf(Perl_debug_log, "0x%"UVxf" num(%g)\n",
1816                           PTR2UV(sv), SvNVX(sv));
1817             RESTORE_NUMERIC_LOCAL();
1818         });
1819 #endif
1820     }
1821     else if (SvTYPE(sv) < SVt_PVNV)
1822         sv_upgrade(sv, SVt_PVNV);
1823     if (SvIOKp(sv) &&
1824             (!SvPOKp(sv) || !strchr(SvPVX(sv),'.') || !looks_like_number(sv)))
1825     {
1826         SvNVX(sv) = SvIsUV(sv) ? (NV)SvUVX(sv) : (NV)SvIVX(sv);
1827     }
1828     else if (SvPOKp(sv) && SvLEN(sv)) {
1829         dTHR;
1830         if (ckWARN(WARN_NUMERIC) && !SvIOKp(sv) && !looks_like_number(sv))
1831             not_a_number(sv);
1832         SvNVX(sv) = Atof(SvPVX(sv));
1833     }
1834     else  {
1835         dTHR;
1836         if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing && !(SvFLAGS(sv) & SVs_PADTMP))
1837             report_uninit();
1838         if (SvTYPE(sv) < SVt_NV)
1839             /* Typically the caller expects that sv_any is not NULL now.  */
1840             sv_upgrade(sv, SVt_NV);
1841         return 0.0;
1842     }
1843     SvNOK_on(sv);
1844 #if defined(USE_LONG_DOUBLE)
1845     DEBUG_c({
1846         STORE_NUMERIC_LOCAL_SET_STANDARD();
1847         PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2nv(%" PERL_PRIgldbl ")\n",
1848                       PTR2UV(sv), SvNVX(sv));
1849         RESTORE_NUMERIC_LOCAL();
1850     });
1851 #else
1852     DEBUG_c({
1853         STORE_NUMERIC_LOCAL_SET_STANDARD();
1854         PerlIO_printf(Perl_debug_log, "0x%"UVxf" 1nv(%g)\n",
1855                       PTR2UV(sv), SvNVX(sv));
1856         RESTORE_NUMERIC_LOCAL();
1857     });
1858 #endif
1859     return SvNVX(sv);
1860 }
1861
1862 STATIC IV
1863 S_asIV(pTHX_ SV *sv)
1864 {
1865     I32 numtype = looks_like_number(sv);
1866     NV d;
1867
1868     if (numtype & IS_NUMBER_TO_INT_BY_ATOL)
1869         return Atol(SvPVX(sv));
1870     if (!numtype) {
1871         dTHR;
1872         if (ckWARN(WARN_NUMERIC))
1873             not_a_number(sv);
1874     }
1875     d = Atof(SvPVX(sv));
1876     return I_V(d);
1877 }
1878
1879 STATIC UV
1880 S_asUV(pTHX_ SV *sv)
1881 {
1882     I32 numtype = looks_like_number(sv);
1883
1884 #ifdef HAS_STRTOUL
1885     if (numtype & IS_NUMBER_TO_INT_BY_ATOL)
1886         return Strtoul(SvPVX(sv), Null(char**), 10);
1887 #endif
1888     if (!numtype) {
1889         dTHR;
1890         if (ckWARN(WARN_NUMERIC))
1891             not_a_number(sv);
1892     }
1893     return U_V(Atof(SvPVX(sv)));
1894 }
1895
1896 /*
1897  * Returns a combination of (advisory only - can get false negatives)
1898  *      IS_NUMBER_TO_INT_BY_ATOL, IS_NUMBER_TO_INT_BY_ATOF, IS_NUMBER_NOT_IV,
1899  *      IS_NUMBER_NEG
1900  * 0 if does not look like number.
1901  *
1902  * In fact possible values are 0 and
1903  * IS_NUMBER_TO_INT_BY_ATOL                             123
1904  * IS_NUMBER_TO_INT_BY_ATOL | IS_NUMBER_NOT_IV          123.1
1905  * IS_NUMBER_TO_INT_BY_ATOF | IS_NUMBER_NOT_IV          123e0
1906  * IS_NUMBER_INFINITY
1907  * with a possible addition of IS_NUMBER_NEG.
1908  */
1909
1910 /*
1911 =for apidoc looks_like_number
1912
1913 Test if an the content of an SV looks like a number (or is a
1914 number).
1915
1916 =cut
1917 */
1918
1919 I32
1920 Perl_looks_like_number(pTHX_ SV *sv)
1921 {
1922     register char *s;
1923     register char *send;
1924     register char *sbegin;
1925     register char *nbegin;
1926     I32 numtype = 0;
1927     I32 sawinf  = 0;
1928     STRLEN len;
1929
1930     if (SvPOK(sv)) {
1931         sbegin = SvPVX(sv); 
1932         len = SvCUR(sv);
1933     }
1934     else if (SvPOKp(sv))
1935         sbegin = SvPV(sv, len);
1936     else
1937         return 1;
1938     send = sbegin + len;
1939
1940     s = sbegin;
1941     while (isSPACE(*s))
1942         s++;
1943     if (*s == '-') {
1944         s++;
1945         numtype = IS_NUMBER_NEG;
1946     }
1947     else if (*s == '+')
1948         s++;
1949
1950     nbegin = s;
1951     /*
1952      * we return IS_NUMBER_TO_INT_BY_ATOL if the number can be converted
1953      * to _integer_ with atol() and IS_NUMBER_TO_INT_BY_ATOF if you need
1954      * (int)atof().
1955      */
1956
1957     /* next must be digit or the radix separator or beginning of infinity */
1958     if (isDIGIT(*s)) {
1959         do {
1960             s++;
1961         } while (isDIGIT(*s));
1962
1963         if (s - nbegin >= TYPE_DIGITS(IV))      /* Cannot cache ato[ul]() */
1964             numtype |= IS_NUMBER_TO_INT_BY_ATOF | IS_NUMBER_NOT_IV;
1965         else
1966             numtype |= IS_NUMBER_TO_INT_BY_ATOL;
1967
1968         if (*s == '.'
1969 #ifdef USE_LOCALE_NUMERIC 
1970             || IS_NUMERIC_RADIX(*s)
1971 #endif
1972             ) {
1973             s++;
1974             numtype |= IS_NUMBER_NOT_IV;
1975             while (isDIGIT(*s))  /* optional digits after the radix */
1976                 s++;
1977         }
1978     }
1979     else if (*s == '.'
1980 #ifdef USE_LOCALE_NUMERIC 
1981             || IS_NUMERIC_RADIX(*s)
1982 #endif
1983             ) {
1984         s++;
1985         numtype |= IS_NUMBER_TO_INT_BY_ATOL | IS_NUMBER_NOT_IV;
1986         /* no digits before the radix means we need digits after it */
1987         if (isDIGIT(*s)) {
1988             do {
1989                 s++;
1990             } while (isDIGIT(*s));
1991         }
1992         else
1993             return 0;
1994     }
1995     else if (*s == 'I' || *s == 'i') {
1996         s++; if (*s != 'N' && *s != 'n') return 0;
1997         s++; if (*s != 'F' && *s != 'f') return 0;
1998         s++; if (*s == 'I' || *s == 'i') {
1999             s++; if (*s != 'N' && *s != 'n') return 0;
2000             s++; if (*s != 'I' && *s != 'i') return 0;
2001             s++; if (*s != 'T' && *s != 't') return 0;
2002             s++; if (*s != 'Y' && *s != 'y') return 0;
2003         }
2004         sawinf = 1;
2005     }
2006     else
2007         return 0;
2008
2009     if (sawinf)
2010         numtype = IS_NUMBER_INFINITY;
2011     else {
2012         /* we can have an optional exponent part */
2013         if (*s == 'e' || *s == 'E') {
2014             numtype &= ~IS_NUMBER_NEG;
2015             numtype |= IS_NUMBER_TO_INT_BY_ATOF | IS_NUMBER_NOT_IV;
2016             s++;
2017             if (*s == '+' || *s == '-')
2018                 s++;
2019             if (isDIGIT(*s)) {
2020                 do {
2021                     s++;
2022                 } while (isDIGIT(*s));
2023             }
2024             else
2025                 return 0;
2026         }
2027     }
2028     while (isSPACE(*s))
2029         s++;
2030     if (s >= send)
2031         return numtype;
2032     if (len == 10 && memEQ(sbegin, "0 but true", 10))
2033         return IS_NUMBER_TO_INT_BY_ATOL;
2034     return 0;
2035 }
2036
2037 char *
2038 Perl_sv_2pv_nolen(pTHX_ register SV *sv)
2039 {
2040     STRLEN n_a;
2041     return sv_2pv(sv, &n_a);
2042 }
2043
2044 /* We assume that buf is at least TYPE_CHARS(UV) long. */
2045 static char *
2046 uiv_2buf(char *buf, IV iv, UV uv, int is_uv, char **peob)
2047 {
2048     char *ptr = buf + TYPE_CHARS(UV);
2049     char *ebuf = ptr;
2050     int sign;
2051
2052     if (is_uv)
2053         sign = 0;
2054     else if (iv >= 0) {
2055         uv = iv;
2056         sign = 0;
2057     } else {
2058         uv = -iv;
2059         sign = 1;
2060     }
2061     do {
2062         *--ptr = '0' + (uv % 10);
2063     } while (uv /= 10);
2064     if (sign)
2065         *--ptr = '-';
2066     *peob = ebuf;
2067     return ptr;
2068 }
2069
2070 char *
2071 Perl_sv_2pv(pTHX_ register SV *sv, STRLEN *lp)
2072 {
2073     register char *s;
2074     int olderrno;
2075     SV *tsv;
2076     char tbuf[64];      /* Must fit sprintf/Gconvert of longest IV/NV */
2077     char *tmpbuf = tbuf;
2078
2079     if (!sv) {
2080         *lp = 0;
2081         return "";
2082     }
2083     if (SvGMAGICAL(sv)) {
2084         mg_get(sv);
2085         if (SvPOKp(sv)) {
2086             *lp = SvCUR(sv);
2087             return SvPVX(sv);
2088         }
2089         if (SvIOKp(sv)) {
2090             if (SvIsUV(sv)) 
2091                 (void)sprintf(tmpbuf,"%"UVuf, (UV)SvUVX(sv));
2092             else
2093                 (void)sprintf(tmpbuf,"%"IVdf, (IV)SvIVX(sv));
2094             tsv = Nullsv;
2095             goto tokensave;
2096         }
2097         if (SvNOKp(sv)) {
2098             Gconvert(SvNVX(sv), NV_DIG, 0, tmpbuf);
2099             tsv = Nullsv;
2100             goto tokensave;
2101         }
2102         if (!SvROK(sv)) {
2103             if (!(SvFLAGS(sv) & SVs_PADTMP)) {
2104                 dTHR;
2105                 if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
2106                     report_uninit();
2107             }
2108             *lp = 0;
2109             return "";
2110         }
2111     }
2112     if (SvTHINKFIRST(sv)) {
2113         if (SvROK(sv)) {
2114             SV* tmpstr;
2115             if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv,string)))
2116                 return SvPV(tmpstr,*lp);
2117             sv = (SV*)SvRV(sv);
2118             if (!sv)
2119                 s = "NULLREF";
2120             else {
2121                 MAGIC *mg;
2122                 
2123                 switch (SvTYPE(sv)) {
2124                 case SVt_PVMG:
2125                     if ( ((SvFLAGS(sv) &
2126                            (SVs_OBJECT|SVf_OK|SVs_GMG|SVs_SMG|SVs_RMG)) 
2127                           == (SVs_OBJECT|SVs_RMG))
2128                          && strEQ(s=HvNAME(SvSTASH(sv)), "Regexp")
2129                          && (mg = mg_find(sv, 'r'))) {
2130                         dTHR;
2131                         regexp *re = (regexp *)mg->mg_obj;
2132
2133                         if (!mg->mg_ptr) {
2134                             char *fptr = "msix";
2135                             char reflags[6];
2136                             char ch;
2137                             int left = 0;
2138                             int right = 4;
2139                             U16 reganch = (re->reganch & PMf_COMPILETIME) >> 12;
2140
2141                             while((ch = *fptr++)) {
2142                                 if(reganch & 1) {
2143                                     reflags[left++] = ch;
2144                                 }
2145                                 else {
2146                                     reflags[right--] = ch;
2147                                 }
2148                                 reganch >>= 1;
2149                             }
2150                             if(left != 4) {
2151                                 reflags[left] = '-';
2152                                 left = 5;
2153                             }
2154
2155                             mg->mg_len = re->prelen + 4 + left;
2156                             New(616, mg->mg_ptr, mg->mg_len + 1 + left, char);
2157                             Copy("(?", mg->mg_ptr, 2, char);
2158                             Copy(reflags, mg->mg_ptr+2, left, char);
2159                             Copy(":", mg->mg_ptr+left+2, 1, char);
2160                             Copy(re->precomp, mg->mg_ptr+3+left, re->prelen, char);
2161                             mg->mg_ptr[mg->mg_len - 1] = ')';
2162                             mg->mg_ptr[mg->mg_len] = 0;
2163                         }
2164                         PL_reginterp_cnt += re->program[0].next_off;
2165                         *lp = mg->mg_len;
2166                         return mg->mg_ptr;
2167                     }
2168                                         /* Fall through */
2169                 case SVt_NULL:
2170                 case SVt_IV:
2171                 case SVt_NV:
2172                 case SVt_RV:
2173                 case SVt_PV:
2174                 case SVt_PVIV:
2175                 case SVt_PVNV:
2176                 case SVt_PVBM:  if (SvROK(sv))
2177                                     s = "REF";
2178                                 else
2179                                     s = "SCALAR";               break;
2180                 case SVt_PVLV:  s = "LVALUE";                   break;
2181                 case SVt_PVAV:  s = "ARRAY";                    break;
2182                 case SVt_PVHV:  s = "HASH";                     break;
2183                 case SVt_PVCV:  s = "CODE";                     break;
2184                 case SVt_PVGV:  s = "GLOB";                     break;
2185                 case SVt_PVFM:  s = "FORMAT";                   break;
2186                 case SVt_PVIO:  s = "IO";                       break;
2187                 default:        s = "UNKNOWN";                  break;
2188                 }
2189                 tsv = NEWSV(0,0);
2190                 if (SvOBJECT(sv))
2191                     Perl_sv_setpvf(aTHX_ tsv, "%s=%s", HvNAME(SvSTASH(sv)), s);
2192                 else
2193                     sv_setpv(tsv, s);
2194                 Perl_sv_catpvf(aTHX_ tsv, "(0x%"UVxf")", PTR2UV(sv));
2195                 goto tokensaveref;
2196             }
2197             *lp = strlen(s);
2198             return s;
2199         }
2200         if (SvREADONLY(sv) && !SvOK(sv)) {
2201             dTHR;
2202             if (ckWARN(WARN_UNINITIALIZED))
2203                 report_uninit();
2204             *lp = 0;
2205             return "";
2206         }
2207     }
2208     if (SvNOKp(sv)) {                   /* See note in sv_2uv() */
2209         /* XXXX 64-bit?  IV may have better precision... */
2210         /* I tried changing this to be 64-bit-aware and
2211          * the t/op/numconvert.t became very, very, angry.
2212          * --jhi Sep 1999 */
2213         if (SvTYPE(sv) < SVt_PVNV)
2214             sv_upgrade(sv, SVt_PVNV);
2215         SvGROW(sv, NV_DIG + 1);
2216         s = SvPVX(sv);
2217         olderrno = errno;       /* some Xenix systems wipe out errno here */
2218 #ifdef apollo
2219         if (SvNVX(sv) == 0.0)
2220             (void)strcpy(s,"0");
2221         else
2222 #endif /*apollo*/
2223         {
2224             Gconvert(SvNVX(sv), NV_DIG, 0, s);
2225         }
2226         errno = olderrno;
2227 #ifdef FIXNEGATIVEZERO
2228         if (*s == '-' && s[1] == '0' && !s[2])
2229             strcpy(s,"0");
2230 #endif
2231         while (*s) s++;
2232 #ifdef hcx
2233         if (s[-1] == '.')
2234             *--s = '\0';
2235 #endif
2236     }
2237     else if (SvIOKp(sv)) {
2238         U32 isIOK = SvIOK(sv);
2239         U32 isUIOK = SvIsUV(sv);
2240         char buf[TYPE_CHARS(UV)];
2241         char *ebuf, *ptr;
2242
2243         if (SvTYPE(sv) < SVt_PVIV)
2244             sv_upgrade(sv, SVt_PVIV);
2245         if (isUIOK)
2246             ptr = uiv_2buf(buf, 0, SvUVX(sv), 1, &ebuf);
2247         else
2248             ptr = uiv_2buf(buf, SvIVX(sv), 0, 0, &ebuf);
2249         SvGROW(sv, ebuf - ptr + 1);     /* inlined from sv_setpvn */
2250         Move(ptr,SvPVX(sv),ebuf - ptr,char);
2251         SvCUR_set(sv, ebuf - ptr);
2252         s = SvEND(sv);
2253         *s = '\0';
2254         if (isIOK)
2255             SvIOK_on(sv);
2256         else
2257             SvIOKp_on(sv);
2258         if (isUIOK)
2259             SvIsUV_on(sv);
2260         SvPOK_on(sv);
2261     }
2262     else {
2263         dTHR;
2264         if (ckWARN(WARN_UNINITIALIZED)
2265             && !PL_localizing && !(SvFLAGS(sv) & SVs_PADTMP))
2266         {
2267             report_uninit();
2268         }
2269         *lp = 0;
2270         if (SvTYPE(sv) < SVt_PV)
2271             /* Typically the caller expects that sv_any is not NULL now.  */
2272             sv_upgrade(sv, SVt_PV);
2273         return "";
2274     }
2275     *lp = s - SvPVX(sv);
2276     SvCUR_set(sv, *lp);
2277     SvPOK_on(sv);
2278     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2pv(%s)\n",
2279                           PTR2UV(sv),SvPVX(sv)));
2280     return SvPVX(sv);
2281
2282   tokensave:
2283     if (SvROK(sv)) {    /* XXX Skip this when sv_pvn_force calls */
2284         /* Sneaky stuff here */
2285
2286       tokensaveref:
2287         if (!tsv)
2288             tsv = newSVpv(tmpbuf, 0);
2289         sv_2mortal(tsv);
2290         *lp = SvCUR(tsv);
2291         return SvPVX(tsv);
2292     }
2293     else {
2294         STRLEN len;
2295         char *t;
2296
2297         if (tsv) {
2298             sv_2mortal(tsv);
2299             t = SvPVX(tsv);
2300             len = SvCUR(tsv);
2301         }
2302         else {
2303             t = tmpbuf;
2304             len = strlen(tmpbuf);
2305         }
2306 #ifdef FIXNEGATIVEZERO
2307         if (len == 2 && t[0] == '-' && t[1] == '0') {
2308             t = "0";
2309             len = 1;
2310         }
2311 #endif
2312         (void)SvUPGRADE(sv, SVt_PV);
2313         *lp = len;
2314         s = SvGROW(sv, len + 1);
2315         SvCUR_set(sv, len);
2316         (void)strcpy(s, t);
2317         SvPOKp_on(sv);
2318         return s;
2319     }
2320 }
2321
2322 char *
2323 Perl_sv_2pvbyte_nolen(pTHX_ register SV *sv)
2324 {
2325     STRLEN n_a;
2326     return sv_2pvbyte(sv, &n_a);
2327 }
2328
2329 char *
2330 Perl_sv_2pvbyte(pTHX_ register SV *sv, STRLEN *lp)
2331 {
2332     return sv_2pv(sv,lp);
2333 }
2334
2335 char *
2336 Perl_sv_2pvutf8_nolen(pTHX_ register SV *sv)
2337 {
2338     STRLEN n_a;
2339     return sv_2pvutf8(sv, &n_a);
2340 }
2341
2342 char *
2343 Perl_sv_2pvutf8(pTHX_ register SV *sv, STRLEN *lp)
2344 {
2345     sv_utf8_upgrade(sv);
2346     return sv_2pv(sv,lp);
2347 }
2348  
2349 /* This function is only called on magical items */
2350 bool
2351 Perl_sv_2bool(pTHX_ register SV *sv)
2352 {
2353     if (SvGMAGICAL(sv))
2354         mg_get(sv);
2355
2356     if (!SvOK(sv))
2357         return 0;
2358     if (SvROK(sv)) {
2359         dTHR;
2360         SV* tmpsv;
2361         if (SvAMAGIC(sv) && (tmpsv = AMG_CALLun(sv,bool_)))
2362             return SvTRUE(tmpsv);
2363       return SvRV(sv) != 0;
2364     }
2365     if (SvPOKp(sv)) {
2366         register XPV* Xpvtmp;
2367         if ((Xpvtmp = (XPV*)SvANY(sv)) &&
2368                 (*Xpvtmp->xpv_pv > '0' ||
2369                 Xpvtmp->xpv_cur > 1 ||
2370                 (Xpvtmp->xpv_cur && *Xpvtmp->xpv_pv != '0')))
2371             return 1;
2372         else
2373             return 0;
2374     }
2375     else {
2376         if (SvIOKp(sv))
2377             return SvIVX(sv) != 0;
2378         else {
2379             if (SvNOKp(sv))
2380                 return SvNVX(sv) != 0.0;
2381             else
2382                 return FALSE;
2383         }
2384     }
2385 }
2386
2387 /*
2388 =for apidoc sv_utf8_upgrade
2389
2390 Convert the PV of an SV to its UTF8-encoded form.
2391
2392 =cut
2393 */
2394
2395 void
2396 Perl_sv_utf8_upgrade(pTHX_ register SV *sv)
2397 {
2398     int hicount;
2399     char *c;
2400
2401     if (!sv || !SvPOK(sv) || SvUTF8(sv))
2402         return;
2403
2404     /* This function could be much more efficient if we had a FLAG
2405      * to signal if there are any hibit chars in the string
2406      */
2407     hicount = 0;
2408     for (c = SvPVX(sv); c < SvEND(sv); c++) {
2409         if (*c & 0x80)
2410             hicount++;
2411     }
2412
2413     if (hicount) {
2414         char *src, *dst;
2415         SvGROW(sv, SvCUR(sv) + hicount + 1);
2416
2417         src = SvEND(sv) - 1;
2418         SvCUR_set(sv, SvCUR(sv) + hicount);
2419         dst = SvEND(sv) - 1;
2420
2421         while (src < dst) {
2422             if (*src & 0x80) {
2423                 dst--;
2424                 uv_to_utf8((U8*)dst, (U8)*src--);
2425                 dst--;
2426             }
2427             else {
2428                 *dst-- = *src--;
2429             }
2430         }
2431
2432         SvUTF8_on(sv);
2433     }
2434 }
2435
2436 /*
2437 =for apidoc sv_utf8_downgrade
2438
2439 Attempt to convert the PV of an SV from UTF8-encoded to byte encoding.
2440 This may not be possible if the PV contains non-byte encoding characters;
2441 if this is the case, either returns false or, if C<fail_ok> is not
2442 true, croaks.
2443
2444 =cut
2445 */
2446
2447 bool
2448 Perl_sv_utf8_downgrade(pTHX_ register SV* sv, bool fail_ok)
2449 {
2450     if (SvPOK(sv) && SvUTF8(sv)) {
2451         char *c = SvPVX(sv);
2452         char *first_hi = 0;
2453         /* need to figure out if this is possible at all first */
2454         while (c < SvEND(sv)) {
2455             if (*c & 0x80) {
2456                 I32 len;
2457                 UV uv = utf8_to_uv((U8*)c, &len);
2458                 if (uv >= 256) {
2459                     if (fail_ok)
2460                         return FALSE;
2461                     else {
2462                         /* XXX might want to make a callback here instead */
2463                         Perl_croak(aTHX_ "Big byte");
2464                     }
2465                 }
2466                 if (!first_hi)
2467                     first_hi = c;
2468                 c += len;
2469             }
2470             else {
2471                 c++;
2472             }
2473         }
2474
2475         if (first_hi) {
2476             char *src = first_hi;
2477             char *dst = first_hi;
2478             while (src < SvEND(sv)) {
2479                 if (*src & 0x80) {
2480                     I32 len;
2481                     U8 u = (U8)utf8_to_uv((U8*)src, &len);
2482                     *dst++ = u;
2483                     src += len;
2484                 }
2485                 else {
2486                     *dst++ = *src++;
2487                 }
2488             }
2489             SvCUR_set(sv, dst - SvPVX(sv));
2490         }
2491         SvUTF8_off(sv);
2492     }
2493     return TRUE;
2494 }
2495
2496 /*
2497 =for apidoc sv_utf8_encode
2498
2499 Convert the PV of an SV to UTF8-encoded, but then turn off the C<SvUTF8>
2500 flag so that it looks like bytes again. Nothing calls this. 
2501
2502 =cut
2503 */
2504
2505 void
2506 Perl_sv_utf8_encode(pTHX_ register SV *sv)
2507 {
2508     sv_utf8_upgrade(sv);
2509     SvUTF8_off(sv);
2510 }
2511
2512 bool
2513 Perl_sv_utf8_decode(pTHX_ register SV *sv)
2514 {
2515     if (SvPOK(sv)) {
2516         char *c;
2517         bool has_utf = FALSE;
2518         if (!sv_utf8_downgrade(sv, TRUE))
2519             return FALSE;
2520
2521         /* it is actually just a matter of turning the utf8 flag on, but
2522          * we want to make sure everything inside is valid utf8 first.
2523          */
2524         c = SvPVX(sv);
2525         while (c < SvEND(sv)) {
2526             if (*c & 0x80) {
2527                 I32 len;
2528                 (void)utf8_to_uv((U8*)c, &len);
2529                 if (len == 1) {
2530                     /* bad utf8 */
2531                     return FALSE;
2532                 }
2533                 c += len;
2534                 has_utf = TRUE;
2535             }
2536             else {
2537                 c++;
2538             }
2539         }
2540
2541         if (has_utf)
2542             SvUTF8_on(sv);
2543     }
2544     return TRUE;
2545 }
2546
2547
2548 /* Note: sv_setsv() should not be called with a source string that needs
2549  * to be reused, since it may destroy the source string if it is marked
2550  * as temporary.
2551  */
2552
2553 /*
2554 =for apidoc sv_setsv
2555
2556 Copies the contents of the source SV C<ssv> into the destination SV C<dsv>.
2557 The source SV may be destroyed if it is mortal.  Does not handle 'set'
2558 magic.  See the macro forms C<SvSetSV>, C<SvSetSV_nosteal> and
2559 C<sv_setsv_mg>.
2560
2561 =cut
2562 */
2563
2564 void
2565 Perl_sv_setsv(pTHX_ SV *dstr, register SV *sstr)
2566 {
2567     dTHR;
2568     register U32 sflags;
2569     register int dtype;
2570     register int stype;
2571
2572     if (sstr == dstr)
2573         return;
2574     SV_CHECK_THINKFIRST(dstr);
2575     if (!sstr)
2576         sstr = &PL_sv_undef;
2577     stype = SvTYPE(sstr);
2578     dtype = SvTYPE(dstr);
2579
2580     SvAMAGIC_off(dstr);
2581
2582     /* There's a lot of redundancy below but we're going for speed here */
2583
2584     switch (stype) {
2585     case SVt_NULL:
2586       undef_sstr:
2587         if (dtype != SVt_PVGV) {
2588             (void)SvOK_off(dstr);
2589             return;
2590         }
2591         break;
2592     case SVt_IV:
2593         if (SvIOK(sstr)) {
2594             switch (dtype) {
2595             case SVt_NULL:
2596                 sv_upgrade(dstr, SVt_IV);
2597                 break;
2598             case SVt_NV:
2599                 sv_upgrade(dstr, SVt_PVNV);
2600                 break;
2601             case SVt_RV:
2602             case SVt_PV:
2603                 sv_upgrade(dstr, SVt_PVIV);
2604                 break;
2605             }
2606             (void)SvIOK_only(dstr);
2607             SvIVX(dstr) = SvIVX(sstr);
2608             if (SvIsUV(sstr))
2609                 SvIsUV_on(dstr);
2610             SvTAINT(dstr);
2611             return;
2612         }
2613         goto undef_sstr;
2614
2615     case SVt_NV:
2616         if (SvNOK(sstr)) {
2617             switch (dtype) {
2618             case SVt_NULL:
2619             case SVt_IV:
2620                 sv_upgrade(dstr, SVt_NV);
2621                 break;
2622             case SVt_RV:
2623             case SVt_PV:
2624             case SVt_PVIV:
2625                 sv_upgrade(dstr, SVt_PVNV);
2626                 break;
2627             }
2628             SvNVX(dstr) = SvNVX(sstr);
2629             (void)SvNOK_only(dstr);
2630             SvTAINT(dstr);
2631             return;
2632         }
2633         goto undef_sstr;
2634
2635     case SVt_RV:
2636         if (dtype < SVt_RV)
2637             sv_upgrade(dstr, SVt_RV);
2638         else if (dtype == SVt_PVGV &&
2639                  SvTYPE(SvRV(sstr)) == SVt_PVGV) {
2640             sstr = SvRV(sstr);
2641             if (sstr == dstr) {
2642                 if (GvIMPORTED(dstr) != GVf_IMPORTED
2643                     && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
2644                 {
2645                     GvIMPORTED_on(dstr);
2646                 }
2647                 GvMULTI_on(dstr);
2648                 return;
2649             }
2650             goto glob_assign;
2651         }
2652         break;
2653     case SVt_PV:
2654     case SVt_PVFM:
2655         if (dtype < SVt_PV)
2656             sv_upgrade(dstr, SVt_PV);
2657         break;
2658     case SVt_PVIV:
2659         if (dtype < SVt_PVIV)
2660             sv_upgrade(dstr, SVt_PVIV);
2661         break;
2662     case SVt_PVNV:
2663         if (dtype < SVt_PVNV)
2664             sv_upgrade(dstr, SVt_PVNV);
2665         break;
2666     case SVt_PVAV:
2667     case SVt_PVHV:
2668     case SVt_PVCV:
2669     case SVt_PVIO:
2670         if (PL_op)
2671             Perl_croak(aTHX_ "Bizarre copy of %s in %s", sv_reftype(sstr, 0),
2672                 PL_op_name[PL_op->op_type]);
2673         else
2674             Perl_croak(aTHX_ "Bizarre copy of %s", sv_reftype(sstr, 0));
2675         break;
2676
2677     case SVt_PVGV:
2678         if (dtype <= SVt_PVGV) {
2679   glob_assign:
2680             if (dtype != SVt_PVGV) {
2681                 char *name = GvNAME(sstr);
2682                 STRLEN len = GvNAMELEN(sstr);
2683                 sv_upgrade(dstr, SVt_PVGV);
2684                 sv_magic(dstr, dstr, '*', Nullch, 0);
2685                 GvSTASH(dstr) = (HV*)SvREFCNT_inc(GvSTASH(sstr));
2686                 GvNAME(dstr) = savepvn(name, len);
2687                 GvNAMELEN(dstr) = len;
2688                 SvFAKE_on(dstr);        /* can coerce to non-glob */
2689             }
2690             /* ahem, death to those who redefine active sort subs */
2691             else if (PL_curstackinfo->si_type == PERLSI_SORT
2692                      && GvCV(dstr) && PL_sortcop == CvSTART(GvCV(dstr)))
2693                 Perl_croak(aTHX_ "Can't redefine active sort subroutine %s",
2694                       GvNAME(dstr));
2695             (void)SvOK_off(dstr);
2696             GvINTRO_off(dstr);          /* one-shot flag */
2697             gp_free((GV*)dstr);
2698             GvGP(dstr) = gp_ref(GvGP(sstr));
2699             SvTAINT(dstr);
2700             if (GvIMPORTED(dstr) != GVf_IMPORTED
2701                 && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
2702             {
2703                 GvIMPORTED_on(dstr);
2704             }
2705             GvMULTI_on(dstr);
2706             return;
2707         }
2708         /* FALL THROUGH */
2709
2710     default:
2711         if (SvGMAGICAL(sstr)) {
2712             mg_get(sstr);
2713             if (SvTYPE(sstr) != stype) {
2714                 stype = SvTYPE(sstr);
2715                 if (stype == SVt_PVGV && dtype <= SVt_PVGV)
2716                     goto glob_assign;
2717             }
2718         }
2719         if (stype == SVt_PVLV)
2720             (void)SvUPGRADE(dstr, SVt_PVNV);
2721         else
2722             (void)SvUPGRADE(dstr, stype);
2723     }
2724
2725     sflags = SvFLAGS(sstr);
2726
2727     if (sflags & SVf_ROK) {
2728         if (dtype >= SVt_PV) {
2729             if (dtype == SVt_PVGV) {
2730                 SV *sref = SvREFCNT_inc(SvRV(sstr));
2731                 SV *dref = 0;
2732                 int intro = GvINTRO(dstr);
2733
2734                 if (intro) {
2735                     GP *gp;
2736                     gp_free((GV*)dstr);
2737                     GvINTRO_off(dstr);  /* one-shot flag */
2738                     Newz(602,gp, 1, GP);
2739                     GvGP(dstr) = gp_ref(gp);
2740                     GvSV(dstr) = NEWSV(72,0);
2741                     GvLINE(dstr) = CopLINE(PL_curcop);
2742                     GvEGV(dstr) = (GV*)dstr;
2743                 }
2744                 GvMULTI_on(dstr);
2745                 switch (SvTYPE(sref)) {
2746                 case SVt_PVAV:
2747                     if (intro)
2748                         SAVESPTR(GvAV(dstr));
2749                     else
2750                         dref = (SV*)GvAV(dstr);
2751                     GvAV(dstr) = (AV*)sref;
2752                     if (!GvIMPORTED_AV(dstr)
2753                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
2754                     {
2755                         GvIMPORTED_AV_on(dstr);
2756                     }
2757                     break;
2758                 case SVt_PVHV:
2759                     if (intro)
2760                         SAVESPTR(GvHV(dstr));
2761                     else
2762                         dref = (SV*)GvHV(dstr);
2763                     GvHV(dstr) = (HV*)sref;
2764                     if (!GvIMPORTED_HV(dstr)
2765                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
2766                     {
2767                         GvIMPORTED_HV_on(dstr);
2768                     }
2769                     break;
2770                 case SVt_PVCV:
2771                     if (intro) {
2772                         if (GvCVGEN(dstr) && GvCV(dstr) != (CV*)sref) {
2773                             SvREFCNT_dec(GvCV(dstr));
2774                             GvCV(dstr) = Nullcv;
2775                             GvCVGEN(dstr) = 0; /* Switch off cacheness. */
2776                             PL_sub_generation++;
2777                         }
2778                         SAVESPTR(GvCV(dstr));
2779                     }
2780                     else
2781                         dref = (SV*)GvCV(dstr);
2782                     if (GvCV(dstr) != (CV*)sref) {
2783                         CV* cv = GvCV(dstr);
2784                         if (cv) {
2785                             if (!GvCVGEN((GV*)dstr) &&
2786                                 (CvROOT(cv) || CvXSUB(cv)))
2787                             {
2788                                 SV *const_sv = cv_const_sv(cv);
2789                                 bool const_changed = TRUE; 
2790                                 if(const_sv)
2791                                     const_changed = sv_cmp(const_sv, 
2792                                            op_const_sv(CvSTART((CV*)sref), 
2793                                                        (CV*)sref));
2794                                 /* ahem, death to those who redefine
2795                                  * active sort subs */
2796                                 if (PL_curstackinfo->si_type == PERLSI_SORT &&
2797                                       PL_sortcop == CvSTART(cv))
2798                                     Perl_croak(aTHX_ 
2799                                     "Can't redefine active sort subroutine %s",
2800                                           GvENAME((GV*)dstr));
2801                                 if ((const_changed && const_sv) || ckWARN(WARN_REDEFINE))
2802                                     Perl_warner(aTHX_ WARN_REDEFINE, const_sv ? 
2803                                              "Constant subroutine %s redefined"
2804                                              : "Subroutine %s redefined", 
2805                                              GvENAME((GV*)dstr));
2806                             }
2807                             cv_ckproto(cv, (GV*)dstr,
2808                                        SvPOK(sref) ? SvPVX(sref) : Nullch);
2809                         }
2810                         GvCV(dstr) = (CV*)sref;
2811                         GvCVGEN(dstr) = 0; /* Switch off cacheness. */
2812                         GvASSUMECV_on(dstr);
2813                         PL_sub_generation++;
2814                     }
2815                     if (!GvIMPORTED_CV(dstr)
2816                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
2817                     {
2818                         GvIMPORTED_CV_on(dstr);
2819                     }
2820                     break;
2821                 case SVt_PVIO:
2822                     if (intro)
2823                         SAVESPTR(GvIOp(dstr));
2824                     else
2825                         dref = (SV*)GvIOp(dstr);
2826                     GvIOp(dstr) = (IO*)sref;
2827                     break;
2828                 case SVt_PVFM:
2829                     if (intro)
2830                         SAVESPTR(GvFORM(dstr));
2831                     else
2832                         dref = (SV*)GvFORM(dstr);
2833                     GvFORM(dstr) = (CV*)sref;
2834                     break;
2835                 default:
2836                     if (intro)
2837                         SAVESPTR(GvSV(dstr));
2838                     else
2839                         dref = (SV*)GvSV(dstr);
2840                     GvSV(dstr) = sref;
2841                     if (!GvIMPORTED_SV(dstr)
2842                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
2843                     {
2844                         GvIMPORTED_SV_on(dstr);
2845                     }
2846                     break;
2847                 }
2848                 if (dref)
2849                     SvREFCNT_dec(dref);
2850                 if (intro)
2851                     SAVEFREESV(sref);
2852                 SvTAINT(dstr);
2853                 return;
2854             }
2855             if (SvPVX(dstr)) {
2856                 (void)SvOOK_off(dstr);          /* backoff */
2857                 if (SvLEN(dstr))
2858                     Safefree(SvPVX(dstr));
2859                 SvLEN(dstr)=SvCUR(dstr)=0;
2860             }
2861         }
2862         (void)SvOK_off(dstr);
2863         SvRV(dstr) = SvREFCNT_inc(SvRV(sstr));
2864         SvROK_on(dstr);
2865         if (sflags & SVp_NOK) {
2866             SvNOK_on(dstr);
2867             SvNVX(dstr) = SvNVX(sstr);
2868         }
2869         if (sflags & SVp_IOK) {
2870             (void)SvIOK_on(dstr);
2871             SvIVX(dstr) = SvIVX(sstr);
2872             if (sflags & SVf_IVisUV)
2873                 SvIsUV_on(dstr);
2874         }
2875         if (SvAMAGIC(sstr)) {
2876             SvAMAGIC_on(dstr);
2877         }
2878     }
2879     else if (sflags & SVp_POK) {
2880
2881         /*
2882          * Check to see if we can just swipe the string.  If so, it's a
2883          * possible small lose on short strings, but a big win on long ones.
2884          * It might even be a win on short strings if SvPVX(dstr)
2885          * has to be allocated and SvPVX(sstr) has to be freed.
2886          */
2887
2888         if (SvTEMP(sstr) &&             /* slated for free anyway? */
2889             SvREFCNT(sstr) == 1 &&      /* and no other references to it? */
2890             !(sflags & SVf_OOK))        /* and not involved in OOK hack? */
2891         {
2892             if (SvPVX(dstr)) {          /* we know that dtype >= SVt_PV */
2893                 if (SvOOK(dstr)) {
2894                     SvFLAGS(dstr) &= ~SVf_OOK;
2895                     Safefree(SvPVX(dstr) - SvIVX(dstr));
2896                 }
2897                 else if (SvLEN(dstr))
2898                     Safefree(SvPVX(dstr));
2899             }
2900             (void)SvPOK_only(dstr);
2901             SvPV_set(dstr, SvPVX(sstr));
2902             SvLEN_set(dstr, SvLEN(sstr));
2903             SvCUR_set(dstr, SvCUR(sstr));
2904
2905             SvTEMP_off(dstr);
2906             (void)SvOK_off(sstr);               /* NOTE: nukes most SvFLAGS on sstr */
2907             SvPV_set(sstr, Nullch);
2908             SvLEN_set(sstr, 0);
2909             SvCUR_set(sstr, 0);
2910             SvTEMP_off(sstr);
2911         }
2912         else {                                  /* have to copy actual string */
2913             STRLEN len = SvCUR(sstr);
2914
2915             SvGROW(dstr, len + 1);              /* inlined from sv_setpvn */
2916             Move(SvPVX(sstr),SvPVX(dstr),len,char);
2917             SvCUR_set(dstr, len);
2918             *SvEND(dstr) = '\0';
2919             (void)SvPOK_only(dstr);
2920         }
2921         if ((sflags & SVf_UTF8) && !IN_BYTE)
2922             SvUTF8_on(dstr);
2923         /*SUPPRESS 560*/
2924         if (sflags & SVp_NOK) {
2925             SvNOK_on(dstr);
2926             SvNVX(dstr) = SvNVX(sstr);
2927         }
2928         if (sflags & SVp_IOK) {
2929             (void)SvIOK_on(dstr);
2930             SvIVX(dstr) = SvIVX(sstr);
2931             if (sflags & SVf_IVisUV)
2932                 SvIsUV_on(dstr);
2933         }
2934     }
2935     else if (sflags & SVp_NOK) {
2936         SvNVX(dstr) = SvNVX(sstr);
2937         (void)SvNOK_only(dstr);
2938         if (sflags & SVf_IOK) {
2939             (void)SvIOK_on(dstr);
2940             SvIVX(dstr) = SvIVX(sstr);
2941             /* XXXX Do we want to set IsUV for IV(ROK)?  Be extra safe... */
2942             if (sflags & SVf_IVisUV)
2943                 SvIsUV_on(dstr);
2944         }
2945     }
2946     else if (sflags & SVp_IOK) {
2947         (void)SvIOK_only(dstr);
2948         SvIVX(dstr) = SvIVX(sstr);
2949         if (sflags & SVf_IVisUV)
2950             SvIsUV_on(dstr);
2951     }
2952     else {
2953         if (dtype == SVt_PVGV) {
2954             if (ckWARN(WARN_MISC))
2955                 Perl_warner(aTHX_ WARN_MISC, "Undefined value assigned to typeglob");
2956         }
2957         else
2958             (void)SvOK_off(dstr);
2959     }
2960     SvTAINT(dstr);
2961 }
2962
2963 /*
2964 =for apidoc sv_setsv_mg
2965
2966 Like C<sv_setsv>, but also handles 'set' magic.
2967
2968 =cut
2969 */
2970
2971 void
2972 Perl_sv_setsv_mg(pTHX_ SV *dstr, register SV *sstr)
2973 {
2974     sv_setsv(dstr,sstr);
2975     SvSETMAGIC(dstr);
2976 }
2977
2978 /*
2979 =for apidoc sv_setpvn
2980
2981 Copies a string into an SV.  The C<len> parameter indicates the number of
2982 bytes to be copied.  Does not handle 'set' magic.  See C<sv_setpvn_mg>.
2983
2984 =cut
2985 */
2986
2987 void
2988 Perl_sv_setpvn(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
2989 {
2990     register char *dptr;
2991     assert(len >= 0);  /* STRLEN is probably unsigned, so this may
2992                           elicit a warning, but it won't hurt. */
2993     SV_CHECK_THINKFIRST(sv);
2994     if (!ptr) {
2995         (void)SvOK_off(sv);
2996         return;
2997     }
2998     (void)SvUPGRADE(sv, SVt_PV);
2999
3000     SvGROW(sv, len + 1);
3001     dptr = SvPVX(sv);
3002     Move(ptr,dptr,len,char);
3003     dptr[len] = '\0';
3004     SvCUR_set(sv, len);
3005     (void)SvPOK_only(sv);               /* validate pointer */
3006     SvTAINT(sv);
3007 }
3008
3009 /*
3010 =for apidoc sv_setpvn_mg
3011
3012 Like C<sv_setpvn>, but also handles 'set' magic.
3013
3014 =cut
3015 */
3016
3017 void
3018 Perl_sv_setpvn_mg(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3019 {
3020     sv_setpvn(sv,ptr,len);
3021     SvSETMAGIC(sv);
3022 }
3023
3024 /*
3025 =for apidoc sv_setpv
3026
3027 Copies a string into an SV.  The string must be null-terminated.  Does not
3028 handle 'set' magic.  See C<sv_setpv_mg>.
3029
3030 =cut
3031 */
3032
3033 void
3034 Perl_sv_setpv(pTHX_ register SV *sv, register const char *ptr)
3035 {
3036     register STRLEN len;
3037
3038     SV_CHECK_THINKFIRST(sv);
3039     if (!ptr) {
3040         (void)SvOK_off(sv);
3041         return;
3042     }
3043     len = strlen(ptr);
3044     (void)SvUPGRADE(sv, SVt_PV);
3045
3046     SvGROW(sv, len + 1);
3047     Move(ptr,SvPVX(sv),len+1,char);
3048     SvCUR_set(sv, len);
3049     (void)SvPOK_only(sv);               /* validate pointer */
3050     SvTAINT(sv);
3051 }
3052
3053 /*
3054 =for apidoc sv_setpv_mg
3055
3056 Like C<sv_setpv>, but also handles 'set' magic.
3057
3058 =cut
3059 */
3060
3061 void
3062 Perl_sv_setpv_mg(pTHX_ register SV *sv, register const char *ptr)
3063 {
3064     sv_setpv(sv,ptr);
3065     SvSETMAGIC(sv);
3066 }
3067
3068 /*
3069 =for apidoc sv_usepvn
3070
3071 Tells an SV to use C<ptr> to find its string value.  Normally the string is
3072 stored inside the SV but sv_usepvn allows the SV to use an outside string. 
3073 The C<ptr> should point to memory that was allocated by C<malloc>.  The
3074 string length, C<len>, must be supplied.  This function will realloc the
3075 memory pointed to by C<ptr>, so that pointer should not be freed or used by
3076 the programmer after giving it to sv_usepvn.  Does not handle 'set' magic.
3077 See C<sv_usepvn_mg>.
3078
3079 =cut
3080 */
3081
3082 void
3083 Perl_sv_usepvn(pTHX_ register SV *sv, register char *ptr, register STRLEN len)
3084 {
3085     SV_CHECK_THINKFIRST(sv);
3086     (void)SvUPGRADE(sv, SVt_PV);
3087     if (!ptr) {
3088         (void)SvOK_off(sv);
3089         return;
3090     }
3091     (void)SvOOK_off(sv);
3092     if (SvPVX(sv) && SvLEN(sv))
3093         Safefree(SvPVX(sv));
3094     Renew(ptr, len+1, char);
3095     SvPVX(sv) = ptr;
3096     SvCUR_set(sv, len);
3097     SvLEN_set(sv, len+1);
3098     *SvEND(sv) = '\0';
3099     (void)SvPOK_only(sv);               /* validate pointer */
3100     SvTAINT(sv);
3101 }
3102
3103 /*
3104 =for apidoc sv_usepvn_mg
3105
3106 Like C<sv_usepvn>, but also handles 'set' magic.
3107
3108 =cut
3109 */
3110
3111 void
3112 Perl_sv_usepvn_mg(pTHX_ register SV *sv, register char *ptr, register STRLEN len)
3113 {
3114     sv_usepvn(sv,ptr,len);
3115     SvSETMAGIC(sv);
3116 }
3117
3118 void
3119 Perl_sv_force_normal(pTHX_ register SV *sv)
3120 {
3121     if (SvREADONLY(sv)) {
3122         dTHR;
3123         if (PL_curcop != &PL_compiling)
3124             Perl_croak(aTHX_ PL_no_modify);
3125     }
3126     if (SvROK(sv))
3127         sv_unref(sv);
3128     else if (SvFAKE(sv) && SvTYPE(sv) == SVt_PVGV)
3129         sv_unglob(sv);
3130 }
3131     
3132 /*
3133 =for apidoc sv_chop
3134
3135 Efficient removal of characters from the beginning of the string buffer. 
3136 SvPOK(sv) must be true and the C<ptr> must be a pointer to somewhere inside
3137 the string buffer.  The C<ptr> becomes the first character of the adjusted
3138 string.
3139
3140 =cut
3141 */
3142
3143 void
3144 Perl_sv_chop(pTHX_ register SV *sv, register char *ptr) /* like set but assuming ptr is in sv */
3145                 
3146                    
3147 {
3148     register STRLEN delta;
3149
3150     if (!ptr || !SvPOKp(sv))
3151         return;
3152     SV_CHECK_THINKFIRST(sv);
3153     if (SvTYPE(sv) < SVt_PVIV)
3154         sv_upgrade(sv,SVt_PVIV);
3155
3156     if (!SvOOK(sv)) {
3157         if (!SvLEN(sv)) { /* make copy of shared string */
3158             char *pvx = SvPVX(sv);
3159             STRLEN len = SvCUR(sv);
3160             SvGROW(sv, len + 1);
3161             Move(pvx,SvPVX(sv),len,char);
3162             *SvEND(sv) = '\0';
3163         }
3164         SvIVX(sv) = 0;
3165         SvFLAGS(sv) |= SVf_OOK;
3166     }
3167     SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVp_IOK|SVp_NOK|SVf_IVisUV);
3168     delta = ptr - SvPVX(sv);
3169     SvLEN(sv) -= delta;
3170     SvCUR(sv) -= delta;
3171     SvPVX(sv) += delta;
3172     SvIVX(sv) += delta;
3173 }
3174
3175 /*
3176 =for apidoc sv_catpvn
3177
3178 Concatenates the string onto the end of the string which is in the SV.  The
3179 C<len> indicates number of bytes to copy.  Handles 'get' magic, but not
3180 'set' magic.  See C<sv_catpvn_mg>.
3181
3182 =cut
3183 */
3184
3185 void
3186 Perl_sv_catpvn(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3187 {
3188     STRLEN tlen;
3189     char *junk;
3190
3191     junk = SvPV_force(sv, tlen);
3192     SvGROW(sv, tlen + len + 1);
3193     if (ptr == junk)
3194         ptr = SvPVX(sv);
3195     Move(ptr,SvPVX(sv)+tlen,len,char);
3196     SvCUR(sv) += len;
3197     *SvEND(sv) = '\0';
3198     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3199     SvTAINT(sv);
3200 }
3201
3202 /*
3203 =for apidoc sv_catpvn_mg
3204
3205 Like C<sv_catpvn>, but also handles 'set' magic.
3206
3207 =cut
3208 */
3209
3210 void
3211 Perl_sv_catpvn_mg(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3212 {
3213     sv_catpvn(sv,ptr,len);
3214     SvSETMAGIC(sv);
3215 }
3216
3217 /*
3218 =for apidoc sv_catsv
3219
3220 Concatenates the string from SV C<ssv> onto the end of the string in SV
3221 C<dsv>.  Handles 'get' magic, but not 'set' magic.  See C<sv_catsv_mg>.
3222
3223 =cut
3224 */
3225
3226 void
3227 Perl_sv_catsv(pTHX_ SV *dstr, register SV *sstr)
3228 {
3229     char *s;
3230     STRLEN len;
3231     if (!sstr)
3232         return;
3233     if ((s = SvPV(sstr, len))) {
3234         if (DO_UTF8(sstr)) {
3235             sv_utf8_upgrade(dstr);
3236             sv_catpvn(dstr,s,len);
3237             SvUTF8_on(dstr);
3238         }
3239         else
3240             sv_catpvn(dstr,s,len);
3241     }
3242 }
3243
3244 /*
3245 =for apidoc sv_catsv_mg
3246
3247 Like C<sv_catsv>, but also handles 'set' magic.
3248
3249 =cut
3250 */
3251
3252 void
3253 Perl_sv_catsv_mg(pTHX_ SV *dstr, register SV *sstr)
3254 {
3255     sv_catsv(dstr,sstr);
3256     SvSETMAGIC(dstr);
3257 }
3258
3259 /*
3260 =for apidoc sv_catpv
3261
3262 Concatenates the string onto the end of the string which is in the SV.
3263 Handles 'get' magic, but not 'set' magic.  See C<sv_catpv_mg>.
3264
3265 =cut
3266 */
3267
3268 void
3269 Perl_sv_catpv(pTHX_ register SV *sv, register const char *ptr)
3270 {
3271     register STRLEN len;
3272     STRLEN tlen;
3273     char *junk;
3274
3275     if (!ptr)
3276         return;
3277     junk = SvPV_force(sv, tlen);
3278     len = strlen(ptr);
3279     SvGROW(sv, tlen + len + 1);
3280     if (ptr == junk)
3281         ptr = SvPVX(sv);
3282     Move(ptr,SvPVX(sv)+tlen,len+1,char);
3283     SvCUR(sv) += len;
3284     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3285     SvTAINT(sv);
3286 }
3287
3288 /*
3289 =for apidoc sv_catpv_mg
3290
3291 Like C<sv_catpv>, but also handles 'set' magic.
3292
3293 =cut
3294 */
3295
3296 void
3297 Perl_sv_catpv_mg(pTHX_ register SV *sv, register const char *ptr)
3298 {
3299     sv_catpv(sv,ptr);
3300     SvSETMAGIC(sv);
3301 }
3302
3303 SV *
3304 Perl_newSV(pTHX_ STRLEN len)
3305 {
3306     register SV *sv;
3307     
3308     new_SV(sv);
3309     if (len) {
3310         sv_upgrade(sv, SVt_PV);
3311         SvGROW(sv, len + 1);
3312     }
3313     return sv;
3314 }
3315
3316 /* name is assumed to contain an SV* if (name && namelen == HEf_SVKEY) */
3317
3318 /*
3319 =for apidoc sv_magic
3320
3321 Adds magic to an SV.
3322
3323 =cut
3324 */
3325
3326 void
3327 Perl_sv_magic(pTHX_ register SV *sv, SV *obj, int how, const char *name, I32 namlen)
3328 {
3329     MAGIC* mg;
3330     
3331     if (SvREADONLY(sv)) {
3332         dTHR;
3333         if (PL_curcop != &PL_compiling && !strchr("gBf", how))
3334             Perl_croak(aTHX_ PL_no_modify);
3335     }
3336     if (SvMAGICAL(sv) || (how == 't' && SvTYPE(sv) >= SVt_PVMG)) {
3337         if (SvMAGIC(sv) && (mg = mg_find(sv, how))) {
3338             if (how == 't')
3339                 mg->mg_len |= 1;
3340             return;
3341         }
3342     }
3343     else {
3344         (void)SvUPGRADE(sv, SVt_PVMG);
3345     }
3346     Newz(702,mg, 1, MAGIC);
3347     mg->mg_moremagic = SvMAGIC(sv);
3348
3349     SvMAGIC(sv) = mg;
3350     if (!obj || obj == sv || how == '#' || how == 'r')
3351         mg->mg_obj = obj;
3352     else {
3353         dTHR;
3354         mg->mg_obj = SvREFCNT_inc(obj);
3355         mg->mg_flags |= MGf_REFCOUNTED;
3356     }
3357     mg->mg_type = how;
3358     mg->mg_len = namlen;
3359     if (name)
3360         if (namlen >= 0)
3361             mg->mg_ptr = savepvn(name, namlen);
3362         else if (namlen == HEf_SVKEY)
3363             mg->mg_ptr = (char*)SvREFCNT_inc((SV*)name);
3364     
3365     switch (how) {
3366     case 0:
3367         mg->mg_virtual = &PL_vtbl_sv;
3368         break;
3369     case 'A':
3370         mg->mg_virtual = &PL_vtbl_amagic;
3371         break;
3372     case 'a':
3373         mg->mg_virtual = &PL_vtbl_amagicelem;
3374         break;
3375     case 'c':
3376         mg->mg_virtual = 0;
3377         break;
3378     case 'B':
3379         mg->mg_virtual = &PL_vtbl_bm;
3380         break;
3381     case 'D':
3382         mg->mg_virtual = &PL_vtbl_regdata;
3383         break;
3384     case 'd':
3385         mg->mg_virtual = &PL_vtbl_regdatum;
3386         break;
3387     case 'E':
3388         mg->mg_virtual = &PL_vtbl_env;
3389         break;
3390     case 'f':
3391         mg->mg_virtual = &PL_vtbl_fm;
3392         break;
3393     case 'e':
3394         mg->mg_virtual = &PL_vtbl_envelem;
3395         break;
3396     case 'g':
3397         mg->mg_virtual = &PL_vtbl_mglob;
3398         break;
3399     case 'I':
3400         mg->mg_virtual = &PL_vtbl_isa;
3401         break;
3402     case 'i':
3403         mg->mg_virtual = &PL_vtbl_isaelem;
3404         break;
3405     case 'k':
3406         mg->mg_virtual = &PL_vtbl_nkeys;
3407         break;
3408     case 'L':
3409         SvRMAGICAL_on(sv);
3410         mg->mg_virtual = 0;
3411         break;
3412     case 'l':
3413         mg->mg_virtual = &PL_vtbl_dbline;
3414         break;
3415 #ifdef USE_THREADS
3416     case 'm':
3417         mg->mg_virtual = &PL_vtbl_mutex;
3418         break;
3419 #endif /* USE_THREADS */
3420 #ifdef USE_LOCALE_COLLATE
3421     case 'o':
3422         mg->mg_virtual = &PL_vtbl_collxfrm;
3423         break;
3424 #endif /* USE_LOCALE_COLLATE */
3425     case 'P':
3426         mg->mg_virtual = &PL_vtbl_pack;
3427         break;
3428     case 'p':
3429     case 'q':
3430         mg->mg_virtual = &PL_vtbl_packelem;
3431         break;
3432     case 'r':
3433         mg->mg_virtual = &PL_vtbl_regexp;
3434         break;
3435     case 'S':
3436         mg->mg_virtual = &PL_vtbl_sig;
3437         break;
3438     case 's':
3439         mg->mg_virtual = &PL_vtbl_sigelem;
3440         break;
3441     case 't':
3442         mg->mg_virtual = &PL_vtbl_taint;
3443         mg->mg_len = 1;
3444         break;
3445     case 'U':
3446         mg->mg_virtual = &PL_vtbl_uvar;
3447         break;
3448     case 'v':
3449         mg->mg_virtual = &PL_vtbl_vec;
3450         break;
3451     case 'x':
3452         mg->mg_virtual = &PL_vtbl_substr;
3453         break;
3454     case 'y':
3455         mg->mg_virtual = &PL_vtbl_defelem;
3456         break;
3457     case '*':
3458         mg->mg_virtual = &PL_vtbl_glob;
3459         break;
3460     case '#':
3461         mg->mg_virtual = &PL_vtbl_arylen;
3462         break;
3463     case '.':
3464         mg->mg_virtual = &PL_vtbl_pos;
3465         break;
3466     case '<':
3467         mg->mg_virtual = &PL_vtbl_backref;
3468         break;
3469     case '~':   /* Reserved for use by extensions not perl internals.   */
3470         /* Useful for attaching extension internal data to perl vars.   */
3471         /* Note that multiple extensions may clash if magical scalars   */
3472         /* etc holding private data from one are passed to another.     */
3473         SvRMAGICAL_on(sv);
3474         break;
3475     default:
3476         Perl_croak(aTHX_ "Don't know how to handle magic of type '%c'", how);
3477     }
3478     mg_magical(sv);
3479     if (SvGMAGICAL(sv))
3480         SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVf_POK);
3481 }
3482
3483 /*
3484 =for apidoc sv_unmagic
3485
3486 Removes magic from an SV.
3487
3488 =cut
3489 */
3490
3491 int
3492 Perl_sv_unmagic(pTHX_ SV *sv, int type)
3493 {
3494     MAGIC* mg;
3495     MAGIC** mgp;
3496     if (SvTYPE(sv) < SVt_PVMG || !SvMAGIC(sv))
3497         return 0;
3498     mgp = &SvMAGIC(sv);
3499     for (mg = *mgp; mg; mg = *mgp) {
3500         if (mg->mg_type == type) {
3501             MGVTBL* vtbl = mg->mg_virtual;
3502             *mgp = mg->mg_moremagic;
3503             if (vtbl && vtbl->svt_free)
3504                 CALL_FPTR(vtbl->svt_free)(aTHX_ sv, mg);
3505             if (mg->mg_ptr && mg->mg_type != 'g')
3506                 if (mg->mg_len >= 0)
3507                     Safefree(mg->mg_ptr);
3508                 else if (mg->mg_len == HEf_SVKEY)
3509                     SvREFCNT_dec((SV*)mg->mg_ptr);
3510             if (mg->mg_flags & MGf_REFCOUNTED)
3511                 SvREFCNT_dec(mg->mg_obj);
3512             Safefree(mg);
3513         }
3514         else
3515             mgp = &mg->mg_moremagic;
3516     }
3517     if (!SvMAGIC(sv)) {
3518         SvMAGICAL_off(sv);
3519         SvFLAGS(sv) |= (SvFLAGS(sv) & (SVp_IOK|SVp_NOK|SVp_POK)) >> PRIVSHIFT;
3520     }
3521
3522     return 0;
3523 }
3524
3525 /*
3526 =for apidoc sv_rvweaken
3527
3528 Weaken a reference.
3529
3530 =cut
3531 */
3532
3533 SV *
3534 Perl_sv_rvweaken(pTHX_ SV *sv)
3535 {
3536     SV *tsv;
3537     if (!SvOK(sv))  /* let undefs pass */
3538         return sv;
3539     if (!SvROK(sv))
3540         Perl_croak(aTHX_ "Can't weaken a nonreference");
3541     else if (SvWEAKREF(sv)) {
3542         dTHR;
3543         if (ckWARN(WARN_MISC))
3544             Perl_warner(aTHX_ WARN_MISC, "Reference is already weak");
3545         return sv;
3546     }
3547     tsv = SvRV(sv);
3548     sv_add_backref(tsv, sv);
3549     SvWEAKREF_on(sv);
3550     SvREFCNT_dec(tsv);              
3551     return sv;
3552 }
3553
3554 STATIC void
3555 S_sv_add_backref(pTHX_ SV *tsv, SV *sv)
3556 {
3557     AV *av;
3558     MAGIC *mg;
3559     if (SvMAGICAL(tsv) && (mg = mg_find(tsv, '<')))
3560         av = (AV*)mg->mg_obj;
3561     else {
3562         av = newAV();
3563         sv_magic(tsv, (SV*)av, '<', NULL, 0);
3564         SvREFCNT_dec(av);           /* for sv_magic */
3565     }
3566     av_push(av,sv);
3567 }
3568
3569 STATIC void 
3570 S_sv_del_backref(pTHX_ SV *sv)
3571 {
3572     AV *av;
3573     SV **svp;
3574     I32 i;
3575     SV *tsv = SvRV(sv);
3576     MAGIC *mg;
3577     if (!SvMAGICAL(tsv) || !(mg = mg_find(tsv, '<')))
3578         Perl_croak(aTHX_ "panic: del_backref");
3579     av = (AV *)mg->mg_obj;
3580     svp = AvARRAY(av);
3581     i = AvFILLp(av);
3582     while (i >= 0) {
3583         if (svp[i] == sv) {
3584             svp[i] = &PL_sv_undef; /* XXX */
3585         }
3586         i--;
3587     }
3588 }
3589
3590 /*
3591 =for apidoc sv_insert
3592
3593 Inserts a string at the specified offset/length within the SV. Similar to
3594 the Perl substr() function.
3595
3596 =cut
3597 */
3598
3599 void
3600 Perl_sv_insert(pTHX_ SV *bigstr, STRLEN offset, STRLEN len, char *little, STRLEN littlelen)
3601 {
3602     register char *big;
3603     register char *mid;
3604     register char *midend;
3605     register char *bigend;
3606     register I32 i;
3607     STRLEN curlen;
3608     
3609
3610     if (!bigstr)
3611         Perl_croak(aTHX_ "Can't modify non-existent substring");
3612     SvPV_force(bigstr, curlen);
3613     (void)SvPOK_only_UTF8(bigstr);
3614     if (offset + len > curlen) {
3615         SvGROW(bigstr, offset+len+1);
3616         Zero(SvPVX(bigstr)+curlen, offset+len-curlen, char);
3617         SvCUR_set(bigstr, offset+len);
3618     }
3619
3620     SvTAINT(bigstr);
3621     i = littlelen - len;
3622     if (i > 0) {                        /* string might grow */
3623         big = SvGROW(bigstr, SvCUR(bigstr) + i + 1);
3624         mid = big + offset + len;
3625         midend = bigend = big + SvCUR(bigstr);
3626         bigend += i;
3627         *bigend = '\0';
3628         while (midend > mid)            /* shove everything down */
3629             *--bigend = *--midend;
3630         Move(little,big+offset,littlelen,char);
3631         SvCUR(bigstr) += i;
3632         SvSETMAGIC(bigstr);
3633         return;
3634     }
3635     else if (i == 0) {
3636         Move(little,SvPVX(bigstr)+offset,len,char);
3637         SvSETMAGIC(bigstr);
3638         return;
3639     }
3640
3641     big = SvPVX(bigstr);
3642     mid = big + offset;
3643     midend = mid + len;
3644     bigend = big + SvCUR(bigstr);
3645
3646     if (midend > bigend)
3647         Perl_croak(aTHX_ "panic: sv_insert");
3648
3649     if (mid - big > bigend - midend) {  /* faster to shorten from end */
3650         if (littlelen) {
3651             Move(little, mid, littlelen,char);
3652             mid += littlelen;
3653         }
3654         i = bigend - midend;
3655         if (i > 0) {
3656             Move(midend, mid, i,char);
3657             mid += i;
3658         }
3659         *mid = '\0';
3660         SvCUR_set(bigstr, mid - big);
3661     }
3662     /*SUPPRESS 560*/
3663     else if ((i = mid - big)) { /* faster from front */
3664         midend -= littlelen;
3665         mid = midend;
3666         sv_chop(bigstr,midend-i);
3667         big += i;
3668         while (i--)
3669             *--midend = *--big;
3670         if (littlelen)
3671             Move(little, mid, littlelen,char);
3672     }
3673     else if (littlelen) {
3674         midend -= littlelen;
3675         sv_chop(bigstr,midend);
3676         Move(little,midend,littlelen,char);
3677     }
3678     else {
3679         sv_chop(bigstr,midend);
3680     }
3681     SvSETMAGIC(bigstr);
3682 }
3683
3684 /*
3685 =for apidoc sv_replace
3686
3687 Make the first argument a copy of the second, then delete the original.
3688
3689 =cut
3690 */
3691
3692 void
3693 Perl_sv_replace(pTHX_ register SV *sv, register SV *nsv)
3694 {
3695     dTHR;
3696     U32 refcnt = SvREFCNT(sv);
3697     SV_CHECK_THINKFIRST(sv);
3698     if (SvREFCNT(nsv) != 1 && ckWARN_d(WARN_INTERNAL))
3699         Perl_warner(aTHX_ WARN_INTERNAL, "Reference miscount in sv_replace()");
3700     if (SvMAGICAL(sv)) {
3701         if (SvMAGICAL(nsv))
3702             mg_free(nsv);
3703         else
3704             sv_upgrade(nsv, SVt_PVMG);
3705         SvMAGIC(nsv) = SvMAGIC(sv);
3706         SvFLAGS(nsv) |= SvMAGICAL(sv);
3707         SvMAGICAL_off(sv);
3708         SvMAGIC(sv) = 0;
3709     }
3710     SvREFCNT(sv) = 0;
3711     sv_clear(sv);
3712     assert(!SvREFCNT(sv));
3713     StructCopy(nsv,sv,SV);
3714     SvREFCNT(sv) = refcnt;
3715     SvFLAGS(nsv) |= SVTYPEMASK;         /* Mark as freed */
3716     del_SV(nsv);
3717 }
3718
3719 /*
3720 =for apidoc sv_clear
3721
3722 Clear an SV, making it empty. Does not free the memory used by the SV
3723 itself.
3724
3725 =cut
3726 */
3727
3728 void
3729 Perl_sv_clear(pTHX_ register SV *sv)
3730 {
3731     HV* stash;
3732     assert(sv);
3733     assert(SvREFCNT(sv) == 0);
3734
3735     if (SvOBJECT(sv)) {
3736         dTHR;
3737         if (PL_defstash) {              /* Still have a symbol table? */
3738             djSP;
3739             GV* destructor;
3740             SV tmpref;
3741
3742             Zero(&tmpref, 1, SV);
3743             sv_upgrade(&tmpref, SVt_RV);
3744             SvROK_on(&tmpref);
3745             SvREADONLY_on(&tmpref);     /* DESTROY() could be naughty */
3746             SvREFCNT(&tmpref) = 1;
3747
3748             do {
3749                 stash = SvSTASH(sv);
3750                 destructor = gv_fetchmethod(SvSTASH(sv), "DESTROY");
3751                 if (destructor) {
3752                     ENTER;
3753                     PUSHSTACKi(PERLSI_DESTROY);
3754                     SvRV(&tmpref) = SvREFCNT_inc(sv);
3755                     EXTEND(SP, 2);
3756                     PUSHMARK(SP);
3757                     PUSHs(&tmpref);
3758                     PUTBACK;
3759                     call_sv((SV*)GvCV(destructor),
3760                             G_DISCARD|G_EVAL|G_KEEPERR);
3761                     SvREFCNT(sv)--;
3762                     POPSTACK;
3763                     SPAGAIN;
3764                     LEAVE;
3765                 }
3766             } while (SvOBJECT(sv) && SvSTASH(sv) != stash);
3767
3768             del_XRV(SvANY(&tmpref));
3769
3770             if (SvREFCNT(sv)) {
3771                 if (PL_in_clean_objs)
3772                     Perl_croak(aTHX_ "DESTROY created new reference to dead object '%s'",
3773                           HvNAME(stash));
3774                 /* DESTROY gave object new lease on life */
3775                 return;
3776             }
3777         }
3778
3779         if (SvOBJECT(sv)) {
3780             SvREFCNT_dec(SvSTASH(sv));  /* possibly of changed persuasion */
3781             SvOBJECT_off(sv);   /* Curse the object. */
3782             if (SvTYPE(sv) != SVt_PVIO)
3783                 --PL_sv_objcount;       /* XXX Might want something more general */
3784         }
3785     }
3786     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv))
3787         mg_free(sv);
3788     stash = NULL;
3789     switch (SvTYPE(sv)) {
3790     case SVt_PVIO:
3791         if (IoIFP(sv) &&
3792             IoIFP(sv) != PerlIO_stdin() &&
3793             IoIFP(sv) != PerlIO_stdout() &&
3794             IoIFP(sv) != PerlIO_stderr())
3795         {
3796             io_close((IO*)sv, FALSE);
3797         }
3798         if (IoDIRP(sv) && !(IoFLAGS(sv) & IOf_FAKE_DIRP))
3799             PerlDir_close(IoDIRP(sv));
3800         IoDIRP(sv) = (DIR*)NULL;
3801         Safefree(IoTOP_NAME(sv));
3802         Safefree(IoFMT_NAME(sv));
3803         Safefree(IoBOTTOM_NAME(sv));
3804         /* FALL THROUGH */
3805     case SVt_PVBM:
3806         goto freescalar;
3807     case SVt_PVCV:
3808     case SVt_PVFM:
3809         cv_undef((CV*)sv);
3810         goto freescalar;
3811     case SVt_PVHV:
3812         hv_undef((HV*)sv);
3813         break;
3814     case SVt_PVAV:
3815         av_undef((AV*)sv);
3816         break;
3817     case SVt_PVLV:
3818         SvREFCNT_dec(LvTARG(sv));
3819         goto freescalar;
3820     case SVt_PVGV:
3821         gp_free((GV*)sv);
3822         Safefree(GvNAME(sv));
3823         /* cannot decrease stash refcount yet, as we might recursively delete
3824            ourselves when the refcnt drops to zero. Delay SvREFCNT_dec
3825            of stash until current sv is completely gone.
3826            -- JohnPC, 27 Mar 1998 */
3827         stash = GvSTASH(sv);
3828         /* FALL THROUGH */
3829     case SVt_PVMG:
3830     case SVt_PVNV:
3831     case SVt_PVIV:
3832       freescalar:
3833         (void)SvOOK_off(sv);
3834         /* FALL THROUGH */
3835     case SVt_PV:
3836     case SVt_RV:
3837         if (SvROK(sv)) {
3838             if (SvWEAKREF(sv))
3839                 sv_del_backref(sv);
3840             else
3841                 SvREFCNT_dec(SvRV(sv));
3842         }
3843         else if (SvPVX(sv) && SvLEN(sv))
3844             Safefree(SvPVX(sv));
3845         break;
3846 /*
3847     case SVt_NV:
3848     case SVt_IV:
3849     case SVt_NULL:
3850         break;
3851 */
3852     }
3853
3854     switch (SvTYPE(sv)) {
3855     case SVt_NULL:
3856         break;
3857     case SVt_IV:
3858         del_XIV(SvANY(sv));
3859         break;
3860     case SVt_NV:
3861         del_XNV(SvANY(sv));
3862         break;
3863     case SVt_RV:
3864         del_XRV(SvANY(sv));
3865         break;
3866     case SVt_PV:
3867         del_XPV(SvANY(sv));
3868         break;
3869     case SVt_PVIV:
3870         del_XPVIV(SvANY(sv));
3871         break;
3872     case SVt_PVNV:
3873         del_XPVNV(SvANY(sv));
3874         break;
3875     case SVt_PVMG:
3876         del_XPVMG(SvANY(sv));
3877         break;
3878     case SVt_PVLV:
3879         del_XPVLV(SvANY(sv));
3880         break;
3881     case SVt_PVAV:
3882         del_XPVAV(SvANY(sv));
3883         break;
3884     case SVt_PVHV:
3885         del_XPVHV(SvANY(sv));
3886         break;
3887     case SVt_PVCV:
3888         del_XPVCV(SvANY(sv));
3889         break;
3890     case SVt_PVGV:
3891         del_XPVGV(SvANY(sv));
3892         /* code duplication for increased performance. */
3893         SvFLAGS(sv) &= SVf_BREAK;
3894         SvFLAGS(sv) |= SVTYPEMASK;
3895         /* decrease refcount of the stash that owns this GV, if any */
3896         if (stash)
3897             SvREFCNT_dec(stash);
3898         return; /* not break, SvFLAGS reset already happened */
3899     case SVt_PVBM:
3900         del_XPVBM(SvANY(sv));
3901         break;
3902     case SVt_PVFM:
3903         del_XPVFM(SvANY(sv));
3904         break;
3905     case SVt_PVIO:
3906         del_XPVIO(SvANY(sv));
3907         break;
3908     }
3909     SvFLAGS(sv) &= SVf_BREAK;
3910     SvFLAGS(sv) |= SVTYPEMASK;
3911 }
3912
3913 SV *
3914 Perl_sv_newref(pTHX_ SV *sv)
3915 {
3916     if (sv)
3917         ATOMIC_INC(SvREFCNT(sv));
3918     return sv;
3919 }
3920
3921 /*
3922 =for apidoc sv_free
3923
3924 Free the memory used by an SV.
3925
3926 =cut
3927 */
3928
3929 void
3930 Perl_sv_free(pTHX_ SV *sv)
3931 {
3932     dTHR;
3933     int refcount_is_zero;
3934
3935     if (!sv)
3936         return;
3937     if (SvREFCNT(sv) == 0) {
3938         if (SvFLAGS(sv) & SVf_BREAK)
3939             return;
3940         if (PL_in_clean_all) /* All is fair */
3941             return;
3942         if (SvREADONLY(sv) && SvIMMORTAL(sv)) {
3943             /* make sure SvREFCNT(sv)==0 happens very seldom */
3944             SvREFCNT(sv) = (~(U32)0)/2;
3945             return;
3946         }
3947         if (ckWARN_d(WARN_INTERNAL))
3948             Perl_warner(aTHX_ WARN_INTERNAL, "Attempt to free unreferenced scalar");
3949         return;
3950     }
3951     ATOMIC_DEC_AND_TEST(refcount_is_zero, SvREFCNT(sv));
3952     if (!refcount_is_zero)
3953         return;
3954 #ifdef DEBUGGING
3955     if (SvTEMP(sv)) {
3956         if (ckWARN_d(WARN_DEBUGGING))
3957             Perl_warner(aTHX_ WARN_DEBUGGING,
3958                         "Attempt to free temp prematurely: SV 0x%"UVxf,
3959                         PTR2UV(sv));
3960         return;
3961     }
3962 #endif
3963     if (SvREADONLY(sv) && SvIMMORTAL(sv)) {
3964         /* make sure SvREFCNT(sv)==0 happens very seldom */
3965         SvREFCNT(sv) = (~(U32)0)/2;
3966         return;
3967     }
3968     sv_clear(sv);
3969     if (! SvREFCNT(sv))
3970         del_SV(sv);
3971 }
3972
3973 /*
3974 =for apidoc sv_len
3975
3976 Returns the length of the string in the SV.  See also C<SvCUR>.
3977
3978 =cut
3979 */
3980
3981 STRLEN
3982 Perl_sv_len(pTHX_ register SV *sv)
3983 {
3984     char *junk;
3985     STRLEN len;
3986
3987     if (!sv)
3988         return 0;
3989
3990     if (SvGMAGICAL(sv))
3991         len = mg_length(sv);
3992     else
3993         junk = SvPV(sv, len);
3994     return len;
3995 }
3996
3997 /*
3998 =for apidoc sv_len_utf8
3999
4000 Returns the number of characters in the string in an SV, counting wide
4001 UTF8 bytes as a single character.
4002
4003 =cut
4004 */
4005
4006 STRLEN
4007 Perl_sv_len_utf8(pTHX_ register SV *sv)
4008 {
4009     U8 *s;
4010     U8 *send;
4011     STRLEN len;
4012
4013     if (!sv)
4014         return 0;
4015
4016 #ifdef NOTYET
4017     if (SvGMAGICAL(sv))
4018         len = mg_length(sv);
4019     else
4020 #endif
4021         s = (U8*)SvPV(sv, len);
4022     send = s + len;
4023     len = 0;
4024     while (s < send) {
4025         s += UTF8SKIP(s);
4026         len++;
4027     }
4028     return len;
4029 }
4030
4031 void
4032 Perl_sv_pos_u2b(pTHX_ register SV *sv, I32* offsetp, I32* lenp)
4033 {
4034     U8 *start;
4035     U8 *s;
4036     U8 *send;
4037     I32 uoffset = *offsetp;
4038     STRLEN len;
4039
4040     if (!sv)
4041         return;
4042
4043     start = s = (U8*)SvPV(sv, len);
4044     send = s + len;
4045     while (s < send && uoffset--)
4046         s += UTF8SKIP(s);
4047     if (s >= send)
4048         s = send;
4049     *offsetp = s - start;
4050     if (lenp) {
4051         I32 ulen = *lenp;
4052         start = s;
4053         while (s < send && ulen--)
4054             s += UTF8SKIP(s);
4055         if (s >= send)
4056             s = send;
4057         *lenp = s - start;
4058     }
4059     return;
4060 }
4061
4062 void
4063 Perl_sv_pos_b2u(pTHX_ register SV *sv, I32* offsetp)
4064 {
4065     U8 *s;
4066     U8 *send;
4067     STRLEN len;
4068
4069     if (!sv)
4070         return;
4071
4072     s = (U8*)SvPV(sv, len);
4073     if (len < *offsetp)
4074         Perl_croak(aTHX_ "panic: bad byte offset");
4075     send = s + *offsetp;
4076     len = 0;
4077     while (s < send) {
4078         s += UTF8SKIP(s);
4079         ++len;
4080     }
4081     if (s != send) {
4082         dTHR;
4083         if (ckWARN_d(WARN_UTF8))    
4084             Perl_warner(aTHX_ WARN_UTF8, "Malformed UTF-8 character");
4085         --len;
4086     }
4087     *offsetp = len;
4088     return;
4089 }
4090
4091 /*
4092 =for apidoc sv_eq
4093
4094 Returns a boolean indicating whether the strings in the two SVs are
4095 identical.
4096
4097 =cut
4098 */
4099
4100 I32
4101 Perl_sv_eq(pTHX_ register SV *sv1, register SV *sv2)
4102 {
4103     char *pv1;
4104     STRLEN cur1;
4105     char *pv2;
4106     STRLEN cur2;
4107     I32  eq     = 0;
4108     bool pv1tmp = FALSE;
4109     bool pv2tmp = FALSE;
4110
4111     if (!sv1) {
4112         pv1 = "";
4113         cur1 = 0;
4114     }
4115     else
4116         pv1 = SvPV(sv1, cur1);
4117
4118     if (!sv2){
4119         pv2 = "";
4120         cur2 = 0;
4121     }
4122     else
4123         pv2 = SvPV(sv2, cur2);
4124
4125     /* do not utf8ize the comparands as a side-effect */
4126     if (cur1 && cur2 && SvUTF8(sv1) != SvUTF8(sv2) && !IN_BYTE && 0) {
4127         if (SvUTF8(sv1)) {
4128             pv2 = (char*)bytes_to_utf8((U8*)pv2, &cur2);
4129             pv2tmp = TRUE;
4130         }
4131         else {
4132             pv1 = (char*)bytes_to_utf8((U8*)pv1, &cur1);
4133             pv1tmp = TRUE;
4134         }
4135     }
4136
4137     if (cur1 == cur2)
4138         eq = memEQ(pv1, pv2, cur1);
4139         
4140     if (pv1tmp)
4141         Safefree(pv1);
4142     if (pv2tmp)
4143         Safefree(pv2);
4144
4145     return eq;
4146 }
4147
4148 /*
4149 =for apidoc sv_cmp
4150
4151 Compares the strings in two SVs.  Returns -1, 0, or 1 indicating whether the
4152 string in C<sv1> is less than, equal to, or greater than the string in
4153 C<sv2>.
4154
4155 =cut
4156 */
4157
4158 I32
4159 Perl_sv_cmp(pTHX_ register SV *sv1, register SV *sv2)
4160 {
4161     STRLEN cur1, cur2;
4162     char *pv1, *pv2;
4163     I32  cmp; 
4164     bool pv1tmp = FALSE;
4165     bool pv2tmp = FALSE;
4166
4167     if (!sv1) {
4168         pv1 = "";
4169         cur1 = 0;
4170     }
4171     else
4172         pv1 = SvPV(sv1, cur1);
4173
4174     if (!sv2){
4175         pv2 = "";
4176         cur2 = 0;
4177     }
4178     else
4179         pv2 = SvPV(sv2, cur2);
4180
4181     /* do not utf8ize the comparands as a side-effect */
4182     if (cur1 && cur2 && SvUTF8(sv1) != SvUTF8(sv2) && !IN_BYTE) {
4183         if (SvUTF8(sv1)) {
4184             pv2 = (char*)bytes_to_utf8((U8*)pv2, &cur2);
4185             pv2tmp = TRUE;
4186         }
4187         else {
4188             pv1 = (char*)bytes_to_utf8((U8*)pv1, &cur1);
4189             pv1tmp = TRUE;
4190         }
4191     }
4192
4193     if (!cur1) {
4194         cmp = cur2 ? -1 : 0;
4195     } else if (!cur2) {
4196         cmp = 1;
4197     } else {
4198         I32 retval = memcmp((void*)pv1, (void*)pv2, cur1 < cur2 ? cur1 : cur2);
4199
4200         if (retval) {
4201             cmp = retval < 0 ? -1 : 1;
4202         } else if (cur1 == cur2) {
4203             cmp = 0;
4204         } else {
4205             cmp = cur1 < cur2 ? -1 : 1;
4206         }
4207     }
4208
4209     if (pv1tmp)
4210         Safefree(pv1);
4211     if (pv2tmp)
4212         Safefree(pv2);
4213
4214     return cmp;
4215 }
4216
4217 /*
4218 =for apidoc sv_cmp_locale
4219
4220 Compares the strings in two SVs in a locale-aware manner. See
4221 L</sv_cmp_locale>
4222
4223 =cut
4224 */
4225
4226 I32
4227 Perl_sv_cmp_locale(pTHX_ register SV *sv1, register SV *sv2)
4228 {
4229 #ifdef USE_LOCALE_COLLATE
4230
4231     char *pv1, *pv2;
4232     STRLEN len1, len2;
4233     I32 retval;
4234
4235     if (PL_collation_standard)
4236         goto raw_compare;
4237
4238     len1 = 0;
4239     pv1 = sv1 ? sv_collxfrm(sv1, &len1) : (char *) NULL;
4240     len2 = 0;
4241     pv2 = sv2 ? sv_collxfrm(sv2, &len2) : (char *) NULL;
4242
4243     if (!pv1 || !len1) {
4244         if (pv2 && len2)
4245             return -1;
4246         else
4247             goto raw_compare;
4248     }
4249     else {
4250         if (!pv2 || !len2)
4251             return 1;
4252     }
4253
4254     retval = memcmp((void*)pv1, (void*)pv2, len1 < len2 ? len1 : len2);
4255
4256     if (retval)
4257         return retval < 0 ? -1 : 1;
4258
4259     /*
4260      * When the result of collation is equality, that doesn't mean
4261      * that there are no differences -- some locales exclude some
4262      * characters from consideration.  So to avoid false equalities,
4263      * we use the raw string as a tiebreaker.
4264      */
4265
4266   raw_compare:
4267     /* FALL THROUGH */
4268
4269 #endif /* USE_LOCALE_COLLATE */
4270
4271     return sv_cmp(sv1, sv2);
4272 }
4273
4274 #ifdef USE_LOCALE_COLLATE
4275 /*
4276  * Any scalar variable may carry an 'o' magic that contains the
4277  * scalar data of the variable transformed to such a format that
4278  * a normal memory comparison can be used to compare the data
4279  * according to the locale settings.
4280  */
4281 char *
4282 Perl_sv_collxfrm(pTHX_ SV *sv, STRLEN *nxp)
4283 {
4284     MAGIC *mg;
4285
4286     mg = SvMAGICAL(sv) ? mg_find(sv, 'o') : (MAGIC *) NULL;
4287     if (!mg || !mg->mg_ptr || *(U32*)mg->mg_ptr != PL_collation_ix) {
4288         char *s, *xf;
4289         STRLEN len, xlen;
4290
4291         if (mg)
4292             Safefree(mg->mg_ptr);
4293         s = SvPV(sv, len);
4294         if ((xf = mem_collxfrm(s, len, &xlen))) {
4295             if (SvREADONLY(sv)) {
4296                 SAVEFREEPV(xf);
4297                 *nxp = xlen;
4298                 return xf + sizeof(PL_collation_ix);
4299             }
4300             if (! mg) {
4301                 sv_magic(sv, 0, 'o', 0, 0);
4302                 mg = mg_find(sv, 'o');
4303                 assert(mg);
4304             }
4305             mg->mg_ptr = xf;
4306             mg->mg_len = xlen;
4307         }
4308         else {
4309             if (mg) {
4310                 mg->mg_ptr = NULL;
4311                 mg->mg_len = -1;
4312             }
4313         }
4314     }
4315     if (mg && mg->mg_ptr) {
4316         *nxp = mg->mg_len;
4317         return mg->mg_ptr + sizeof(PL_collation_ix);
4318     }
4319     else {
4320         *nxp = 0;
4321         return NULL;
4322     }
4323 }
4324
4325 #endif /* USE_LOCALE_COLLATE */
4326
4327 /*
4328 =for apidoc sv_gets
4329
4330 Get a line from the filehandle and store it into the SV, optionally
4331 appending to the currently-stored string.
4332
4333 =cut
4334 */
4335
4336 char *
4337 Perl_sv_gets(pTHX_ register SV *sv, register PerlIO *fp, I32 append)
4338 {
4339     dTHR;
4340     char *rsptr;
4341     STRLEN rslen;
4342     register STDCHAR rslast;
4343     register STDCHAR *bp;
4344     register I32 cnt;
4345     I32 i;
4346
4347     SV_CHECK_THINKFIRST(sv);
4348     (void)SvUPGRADE(sv, SVt_PV);
4349
4350     SvSCREAM_off(sv);
4351
4352     if (RsSNARF(PL_rs)) {
4353         rsptr = NULL;
4354         rslen = 0;
4355     }
4356     else if (RsRECORD(PL_rs)) {
4357       I32 recsize, bytesread;
4358       char *buffer;
4359
4360       /* Grab the size of the record we're getting */
4361       recsize = SvIV(SvRV(PL_rs));
4362       (void)SvPOK_only(sv);    /* Validate pointer */
4363       buffer = SvGROW(sv, recsize + 1);
4364       /* Go yank in */
4365 #ifdef VMS
4366       /* VMS wants read instead of fread, because fread doesn't respect */
4367       /* RMS record boundaries. This is not necessarily a good thing to be */
4368       /* doing, but we've got no other real choice */
4369       bytesread = PerlLIO_read(PerlIO_fileno(fp), buffer, recsize);
4370 #else
4371       bytesread = PerlIO_read(fp, buffer, recsize);
4372 #endif
4373       SvCUR_set(sv, bytesread);
4374       buffer[bytesread] = '\0';
4375       return(SvCUR(sv) ? SvPVX(sv) : Nullch);
4376     }
4377     else if (RsPARA(PL_rs)) {
4378         rsptr = "\n\n";
4379         rslen = 2;
4380     }
4381     else
4382         rsptr = SvPV(PL_rs, rslen);
4383     rslast = rslen ? rsptr[rslen - 1] : '\0';
4384
4385     if (RsPARA(PL_rs)) {                /* have to do this both before and after */
4386         do {                    /* to make sure file boundaries work right */
4387             if (PerlIO_eof(fp))
4388                 return 0;
4389             i = PerlIO_getc(fp);
4390             if (i != '\n') {
4391                 if (i == -1)
4392                     return 0;
4393                 PerlIO_ungetc(fp,i);
4394                 break;
4395             }
4396         } while (i != EOF);
4397     }
4398
4399     /* See if we know enough about I/O mechanism to cheat it ! */
4400
4401     /* This used to be #ifdef test - it is made run-time test for ease
4402        of abstracting out stdio interface. One call should be cheap 
4403        enough here - and may even be a macro allowing compile
4404        time optimization.
4405      */
4406
4407     if (PerlIO_fast_gets(fp)) {
4408
4409     /*
4410      * We're going to steal some values from the stdio struct
4411      * and put EVERYTHING in the innermost loop into registers.
4412      */
4413     register STDCHAR *ptr;
4414     STRLEN bpx;
4415     I32 shortbuffered;
4416
4417 #if defined(VMS) && defined(PERLIO_IS_STDIO)
4418     /* An ungetc()d char is handled separately from the regular
4419      * buffer, so we getc() it back out and stuff it in the buffer.
4420      */
4421     i = PerlIO_getc(fp);
4422     if (i == EOF) return 0;
4423     *(--((*fp)->_ptr)) = (unsigned char) i;
4424     (*fp)->_cnt++;
4425 #endif
4426
4427     /* Here is some breathtakingly efficient cheating */
4428
4429     cnt = PerlIO_get_cnt(fp);                   /* get count into register */
4430     (void)SvPOK_only(sv);               /* validate pointer */
4431     if (SvLEN(sv) - append <= cnt + 1) { /* make sure we have the room */
4432         if (cnt > 80 && SvLEN(sv) > append) {
4433             shortbuffered = cnt - SvLEN(sv) + append + 1;
4434             cnt -= shortbuffered;
4435         }
4436         else {
4437             shortbuffered = 0;
4438             /* remember that cnt can be negative */
4439             SvGROW(sv, append + (cnt <= 0 ? 2 : (cnt + 1)));
4440         }
4441     }
4442     else
4443         shortbuffered = 0;
4444     bp = (STDCHAR*)SvPVX(sv) + append;  /* move these two too to registers */
4445     ptr = (STDCHAR*)PerlIO_get_ptr(fp);
4446     DEBUG_P(PerlIO_printf(Perl_debug_log,
4447         "Screamer: entering, ptr=%"UVuf", cnt=%ld\n",PTR2UV(ptr),(long)cnt));
4448     DEBUG_P(PerlIO_printf(Perl_debug_log,
4449         "Screamer: entering: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
4450                PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp), 
4451                PTR2UV(PerlIO_has_base(fp) ? PerlIO_get_base(fp) : 0)));
4452     for (;;) {
4453       screamer:
4454         if (cnt > 0) {
4455             if (rslen) {
4456                 while (cnt > 0) {                    /* this     |  eat */
4457                     cnt--;
4458                     if ((*bp++ = *ptr++) == rslast)  /* really   |  dust */
4459                         goto thats_all_folks;        /* screams  |  sed :-) */
4460                 }
4461             }
4462             else {
4463                 Copy(ptr, bp, cnt, char);            /* this     |  eat */    
4464                 bp += cnt;                           /* screams  |  dust */   
4465                 ptr += cnt;                          /* louder   |  sed :-) */
4466                 cnt = 0;
4467             }
4468         }
4469         
4470         if (shortbuffered) {            /* oh well, must extend */
4471             cnt = shortbuffered;
4472             shortbuffered = 0;
4473             bpx = bp - (STDCHAR*)SvPVX(sv); /* box up before relocation */
4474             SvCUR_set(sv, bpx);
4475             SvGROW(sv, SvLEN(sv) + append + cnt + 2);
4476             bp = (STDCHAR*)SvPVX(sv) + bpx; /* unbox after relocation */
4477             continue;
4478         }
4479
4480         DEBUG_P(PerlIO_printf(Perl_debug_log,
4481                               "Screamer: going to getc, ptr=%"UVuf", cnt=%ld\n",
4482                               PTR2UV(ptr),(long)cnt));
4483         PerlIO_set_ptrcnt(fp, ptr, cnt); /* deregisterize cnt and ptr */
4484         DEBUG_P(PerlIO_printf(Perl_debug_log,
4485             "Screamer: pre: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
4486             PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp), 
4487             PTR2UV(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
4488         /* This used to call 'filbuf' in stdio form, but as that behaves like 
4489            getc when cnt <= 0 we use PerlIO_getc here to avoid introducing
4490            another abstraction.  */
4491         i   = PerlIO_getc(fp);          /* get more characters */
4492         DEBUG_P(PerlIO_printf(Perl_debug_log,
4493             "Screamer: post: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
4494             PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp), 
4495             PTR2UV(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
4496         cnt = PerlIO_get_cnt(fp);
4497         ptr = (STDCHAR*)PerlIO_get_ptr(fp);     /* reregisterize cnt and ptr */
4498         DEBUG_P(PerlIO_printf(Perl_debug_log,
4499             "Screamer: after getc, ptr=%"UVuf", cnt=%ld\n",PTR2UV(ptr),(long)cnt));
4500
4501         if (i == EOF)                   /* all done for ever? */
4502             goto thats_really_all_folks;
4503
4504         bpx = bp - (STDCHAR*)SvPVX(sv); /* box up before relocation */
4505         SvCUR_set(sv, bpx);
4506         SvGROW(sv, bpx + cnt + 2);
4507         bp = (STDCHAR*)SvPVX(sv) + bpx; /* unbox after relocation */
4508
4509         *bp++ = i;                      /* store character from PerlIO_getc */
4510
4511         if (rslen && (STDCHAR)i == rslast)  /* all done for now? */
4512             goto thats_all_folks;
4513     }
4514
4515 thats_all_folks:
4516     if ((rslen > 1 && (bp - (STDCHAR*)SvPVX(sv) < rslen)) ||
4517           memNE((char*)bp - rslen, rsptr, rslen))
4518         goto screamer;                          /* go back to the fray */
4519 thats_really_all_folks:
4520     if (shortbuffered)
4521         cnt += shortbuffered;
4522         DEBUG_P(PerlIO_printf(Perl_debug_log,
4523             "Screamer: quitting, ptr=%"UVuf", cnt=%ld\n",PTR2UV(ptr),(long)cnt));
4524     PerlIO_set_ptrcnt(fp, ptr, cnt);    /* put these back or we're in trouble */
4525     DEBUG_P(PerlIO_printf(Perl_debug_log,
4526         "Screamer: end: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
4527         PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp), 
4528         PTR2UV(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
4529     *bp = '\0';
4530     SvCUR_set(sv, bp - (STDCHAR*)SvPVX(sv));    /* set length */
4531     DEBUG_P(PerlIO_printf(Perl_debug_log,
4532         "Screamer: done, len=%ld, string=|%.*s|\n",
4533         (long)SvCUR(sv),(int)SvCUR(sv),SvPVX(sv)));
4534     }
4535    else
4536     {
4537 #ifndef EPOC
4538        /*The big, slow, and stupid way */
4539         STDCHAR buf[8192];
4540 #else
4541         /* Need to work around EPOC SDK features          */
4542         /* On WINS: MS VC5 generates calls to _chkstk,    */
4543         /* if a `large' stack frame is allocated          */
4544         /* gcc on MARM does not generate calls like these */
4545         STDCHAR buf[1024];
4546 #endif
4547
4548 screamer2:
4549         if (rslen) {
4550             register STDCHAR *bpe = buf + sizeof(buf);
4551             bp = buf;
4552             while ((i = PerlIO_getc(fp)) != EOF && (*bp++ = i) != rslast && bp < bpe)
4553                 ; /* keep reading */
4554             cnt = bp - buf;
4555         }
4556         else {
4557             cnt = PerlIO_read(fp,(char*)buf, sizeof(buf));
4558             /* Accomodate broken VAXC compiler, which applies U8 cast to
4559              * both args of ?: operator, causing EOF to change into 255
4560              */
4561             if (cnt) { i = (U8)buf[cnt - 1]; } else { i = EOF; }
4562         }
4563
4564         if (append)
4565             sv_catpvn(sv, (char *) buf, cnt);
4566         else
4567             sv_setpvn(sv, (char *) buf, cnt);
4568
4569         if (i != EOF &&                 /* joy */
4570             (!rslen ||
4571              SvCUR(sv) < rslen ||
4572              memNE(SvPVX(sv) + SvCUR(sv) - rslen, rsptr, rslen)))
4573         {
4574             append = -1;
4575             /*
4576              * If we're reading from a TTY and we get a short read,
4577              * indicating that the user hit his EOF character, we need
4578              * to notice it now, because if we try to read from the TTY
4579              * again, the EOF condition will disappear.
4580              *
4581              * The comparison of cnt to sizeof(buf) is an optimization
4582              * that prevents unnecessary calls to feof().
4583              *
4584              * - jik 9/25/96
4585              */
4586             if (!(cnt < sizeof(buf) && PerlIO_eof(fp)))
4587                 goto screamer2;
4588         }
4589     }
4590
4591     if (RsPARA(PL_rs)) {                /* have to do this both before and after */  
4592         while (i != EOF) {      /* to make sure file boundaries work right */
4593             i = PerlIO_getc(fp);
4594             if (i != '\n') {
4595                 PerlIO_ungetc(fp,i);
4596                 break;
4597             }
4598         }
4599     }
4600
4601     return (SvCUR(sv) - append) ? SvPVX(sv) : Nullch;
4602 }
4603
4604
4605 /*
4606 =for apidoc sv_inc
4607
4608 Auto-increment of the value in the SV.
4609
4610 =cut
4611 */
4612
4613 void
4614 Perl_sv_inc(pTHX_ register SV *sv)
4615 {
4616     register char *d;
4617     int flags;
4618
4619     if (!sv)
4620         return;
4621     if (SvGMAGICAL(sv))
4622         mg_get(sv);
4623     if (SvTHINKFIRST(sv)) {
4624         if (SvREADONLY(sv)) {
4625             dTHR;
4626             if (PL_curcop != &PL_compiling)
4627                 Perl_croak(aTHX_ PL_no_modify);
4628         }
4629         if (SvROK(sv)) {
4630             IV i;
4631             if (SvAMAGIC(sv) && AMG_CALLun(sv,inc))
4632                 return;
4633             i = PTR2IV(SvRV(sv));
4634             sv_unref(sv);
4635             sv_setiv(sv, i);
4636         }
4637     }
4638     flags = SvFLAGS(sv);
4639     if (flags & SVp_NOK) {
4640         (void)SvNOK_only(sv);
4641         SvNVX(sv) += 1.0;
4642         return;
4643     }
4644     if (flags & SVp_IOK) {
4645         if (SvIsUV(sv)) {
4646             if (SvUVX(sv) == UV_MAX)
4647                 sv_setnv(sv, (NV)UV_MAX + 1.0);
4648             else
4649                 (void)SvIOK_only_UV(sv);
4650                 ++SvUVX(sv);
4651         } else {
4652             if (SvIVX(sv) == IV_MAX)
4653                 sv_setnv(sv, (NV)IV_MAX + 1.0);
4654             else {
4655                 (void)SvIOK_only(sv);
4656                 ++SvIVX(sv);
4657             }       
4658         }
4659         return;
4660     }
4661     if (!(flags & SVp_POK) || !*SvPVX(sv)) {
4662         if ((flags & SVTYPEMASK) < SVt_PVNV)
4663             sv_upgrade(sv, SVt_NV);
4664         SvNVX(sv) = 1.0;
4665         (void)SvNOK_only(sv);
4666         return;
4667     }
4668     d = SvPVX(sv);
4669     while (isALPHA(*d)) d++;
4670     while (isDIGIT(*d)) d++;
4671     if (*d) {
4672         sv_setnv(sv,Atof(SvPVX(sv)) + 1.0);  /* punt */
4673         return;
4674     }
4675     d--;
4676     while (d >= SvPVX(sv)) {
4677         if (isDIGIT(*d)) {
4678             if (++*d <= '9')
4679                 return;
4680             *(d--) = '0';
4681         }
4682         else {
4683 #ifdef EBCDIC
4684             /* MKS: The original code here died if letters weren't consecutive.
4685              * at least it didn't have to worry about non-C locales.  The
4686              * new code assumes that ('z'-'a')==('Z'-'A'), letters are
4687              * arranged in order (although not consecutively) and that only 
4688              * [A-Za-z] are accepted by isALPHA in the C locale.
4689              */
4690             if (*d != 'z' && *d != 'Z') {
4691                 do { ++*d; } while (!isALPHA(*d));
4692                 return;
4693             }
4694             *(d--) -= 'z' - 'a';
4695 #else
4696             ++*d;
4697             if (isALPHA(*d))
4698                 return;
4699             *(d--) -= 'z' - 'a' + 1;
4700 #endif
4701         }
4702     }
4703     /* oh,oh, the number grew */
4704     SvGROW(sv, SvCUR(sv) + 2);
4705     SvCUR(sv)++;
4706     for (d = SvPVX(sv) + SvCUR(sv); d > SvPVX(sv); d--)
4707         *d = d[-1];
4708     if (isDIGIT(d[1]))
4709         *d = '1';
4710     else
4711         *d = d[1];
4712 }
4713
4714 /*
4715 =for apidoc sv_dec
4716
4717 Auto-decrement of the value in the SV.
4718
4719 =cut
4720 */
4721
4722 void
4723 Perl_sv_dec(pTHX_ register SV *sv)
4724 {
4725     int flags;
4726
4727     if (!sv)
4728         return;
4729     if (SvGMAGICAL(sv))
4730         mg_get(sv);
4731     if (SvTHINKFIRST(sv)) {
4732         if (SvREADONLY(sv)) {
4733             dTHR;
4734             if (PL_curcop != &PL_compiling)
4735                 Perl_croak(aTHX_ PL_no_modify);
4736         }
4737         if (SvROK(sv)) {
4738             IV i;
4739             if (SvAMAGIC(sv) && AMG_CALLun(sv,dec))
4740                 return;
4741             i = PTR2IV(SvRV(sv));
4742             sv_unref(sv);
4743             sv_setiv(sv, i);
4744         }
4745     }
4746     flags = SvFLAGS(sv);
4747     if (flags & SVp_NOK) {
4748         SvNVX(sv) -= 1.0;
4749         (void)SvNOK_only(sv);
4750         return;
4751     }
4752     if (flags & SVp_IOK) {
4753         if (SvIsUV(sv)) {
4754             if (SvUVX(sv) == 0) {
4755                 (void)SvIOK_only(sv);
4756                 SvIVX(sv) = -1;
4757             }
4758             else {
4759                 (void)SvIOK_only_UV(sv);
4760                 --SvUVX(sv);
4761             }       
4762         } else {
4763             if (SvIVX(sv) == IV_MIN)
4764                 sv_setnv(sv, (NV)IV_MIN - 1.0);
4765             else {
4766                 (void)SvIOK_only(sv);
4767                 --SvIVX(sv);
4768             }       
4769         }
4770         return;
4771     }
4772     if (!(flags & SVp_POK)) {
4773         if ((flags & SVTYPEMASK) < SVt_PVNV)
4774             sv_upgrade(sv, SVt_NV);
4775         SvNVX(sv) = -1.0;
4776         (void)SvNOK_only(sv);
4777         return;
4778     }
4779     sv_setnv(sv,Atof(SvPVX(sv)) - 1.0); /* punt */
4780 }
4781
4782 /*
4783 =for apidoc sv_mortalcopy
4784
4785 Creates a new SV which is a copy of the original SV.  The new SV is marked
4786 as mortal.
4787
4788 =cut
4789 */
4790
4791 /* Make a string that will exist for the duration of the expression
4792  * evaluation.  Actually, it may have to last longer than that, but
4793  * hopefully we won't free it until it has been assigned to a
4794  * permanent location. */
4795
4796 SV *
4797 Perl_sv_mortalcopy(pTHX_ SV *oldstr)
4798 {
4799     dTHR;
4800     register SV *sv;
4801
4802     new_SV(sv);
4803     sv_setsv(sv,oldstr);
4804     EXTEND_MORTAL(1);
4805     PL_tmps_stack[++PL_tmps_ix] = sv;
4806     SvTEMP_on(sv);
4807     return sv;
4808 }
4809
4810 /*
4811 =for apidoc sv_newmortal
4812
4813 Creates a new SV which is mortal.  The reference count of the SV is set to 1.
4814
4815 =cut
4816 */
4817
4818 SV *
4819 Perl_sv_newmortal(pTHX)
4820 {
4821     dTHR;
4822     register SV *sv;
4823
4824     new_SV(sv);
4825     SvFLAGS(sv) = SVs_TEMP;
4826     EXTEND_MORTAL(1);
4827     PL_tmps_stack[++PL_tmps_ix] = sv;
4828     return sv;
4829 }
4830
4831 /*
4832 =for apidoc sv_2mortal
4833
4834 Marks an SV as mortal.  The SV will be destroyed when the current context
4835 ends.
4836
4837 =cut
4838 */
4839
4840 /* same thing without the copying */
4841
4842 SV *
4843 Perl_sv_2mortal(pTHX_ register SV *sv)
4844 {
4845     dTHR;
4846     if (!sv)
4847         return sv;
4848     if (SvREADONLY(sv) && SvIMMORTAL(sv))
4849         return sv;
4850     EXTEND_MORTAL(1);
4851     PL_tmps_stack[++PL_tmps_ix] = sv;
4852     SvTEMP_on(sv);
4853     return sv;
4854 }
4855
4856 /*
4857 =for apidoc newSVpv
4858
4859 Creates a new SV and copies a string into it.  The reference count for the
4860 SV is set to 1.  If C<len> is zero, Perl will compute the length using
4861 strlen().  For efficiency, consider using C<newSVpvn> instead.
4862
4863 =cut
4864 */
4865
4866 SV *
4867 Perl_newSVpv(pTHX_ const char *s, STRLEN len)
4868 {
4869     register SV *sv;
4870
4871     new_SV(sv);
4872     if (!len)
4873         len = strlen(s);
4874     sv_setpvn(sv,s,len);
4875     return sv;
4876 }
4877
4878 /*
4879 =for apidoc newSVpvn
4880
4881 Creates a new SV and copies a string into it.  The reference count for the
4882 SV is set to 1.  Note that if C<len> is zero, Perl will create a zero length 
4883 string.  You are responsible for ensuring that the source string is at least
4884 C<len> bytes long.
4885
4886 =cut
4887 */
4888
4889 SV *
4890 Perl_newSVpvn(pTHX_ const char *s, STRLEN len)
4891 {
4892     register SV *sv;
4893
4894     new_SV(sv);
4895     sv_setpvn(sv,s,len);
4896     return sv;
4897 }
4898
4899 #if defined(PERL_IMPLICIT_CONTEXT)
4900 SV *
4901 Perl_newSVpvf_nocontext(const char* pat, ...)
4902 {
4903     dTHX;
4904     register SV *sv;
4905     va_list args;
4906     va_start(args, pat);
4907     sv = vnewSVpvf(pat, &args);
4908     va_end(args);
4909     return sv;
4910 }
4911 #endif
4912
4913 /*
4914 =for apidoc newSVpvf
4915
4916 Creates a new SV an initialize it with the string formatted like
4917 C<sprintf>.
4918
4919 =cut
4920 */
4921
4922 SV *
4923 Perl_newSVpvf(pTHX_ const char* pat, ...)
4924 {
4925     register SV *sv;
4926     va_list args;
4927     va_start(args, pat);
4928     sv = vnewSVpvf(pat, &args);
4929     va_end(args);
4930     return sv;
4931 }
4932
4933 SV *
4934 Perl_vnewSVpvf(pTHX_ const char* pat, va_list* args)
4935 {
4936     register SV *sv;
4937     new_SV(sv);
4938     sv_vsetpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*));
4939     return sv;
4940 }
4941
4942 /*
4943 =for apidoc newSVnv
4944
4945 Creates a new SV and copies a floating point value into it.
4946 The reference count for the SV is set to 1.
4947
4948 =cut
4949 */
4950
4951 SV *
4952 Perl_newSVnv(pTHX_ NV n)
4953 {
4954     register SV *sv;
4955
4956     new_SV(sv);
4957     sv_setnv(sv,n);
4958     return sv;
4959 }
4960
4961 /*
4962 =for apidoc newSViv
4963
4964 Creates a new SV and copies an integer into it.  The reference count for the
4965 SV is set to 1.
4966
4967 =cut
4968 */
4969
4970 SV *
4971 Perl_newSViv(pTHX_ IV i)
4972 {
4973     register SV *sv;
4974
4975     new_SV(sv);
4976     sv_setiv(sv,i);
4977     return sv;
4978 }
4979
4980 /*
4981 =for apidoc newSVuv
4982
4983 Creates a new SV and copies an unsigned integer into it.
4984 The reference count for the SV is set to 1.
4985
4986 =cut
4987 */
4988
4989 SV *
4990 Perl_newSVuv(pTHX_ UV u)
4991 {
4992     register SV *sv;
4993
4994     new_SV(sv);
4995     sv_setuv(sv,u);
4996     return sv;
4997 }
4998
4999 /*
5000 =for apidoc newRV_noinc
5001
5002 Creates an RV wrapper for an SV.  The reference count for the original
5003 SV is B<not> incremented.
5004
5005 =cut
5006 */
5007
5008 SV *
5009 Perl_newRV_noinc(pTHX_ SV *tmpRef)
5010 {
5011     dTHR;
5012     register SV *sv;
5013
5014     new_SV(sv);
5015     sv_upgrade(sv, SVt_RV);
5016     SvTEMP_off(tmpRef);
5017     SvRV(sv) = tmpRef;
5018     SvROK_on(sv);
5019     return sv;
5020 }
5021
5022 /* newRV_inc is #defined to newRV in sv.h */
5023 SV *
5024 Perl_newRV(pTHX_ SV *tmpRef)
5025 {
5026     return newRV_noinc(SvREFCNT_inc(tmpRef));
5027 }
5028
5029 /*
5030 =for apidoc newSVsv
5031
5032 Creates a new SV which is an exact duplicate of the original SV.
5033
5034 =cut
5035 */
5036
5037 /* make an exact duplicate of old */
5038
5039 SV *
5040 Perl_newSVsv(pTHX_ register SV *old)
5041 {
5042     dTHR;
5043     register SV *sv;
5044
5045     if (!old)
5046         return Nullsv;
5047     if (SvTYPE(old) == SVTYPEMASK) {
5048         if (ckWARN_d(WARN_INTERNAL))
5049             Perl_warner(aTHX_ WARN_INTERNAL, "semi-panic: attempt to dup freed string");
5050         return Nullsv;
5051     }
5052     new_SV(sv);
5053     if (SvTEMP(old)) {
5054         SvTEMP_off(old);
5055         sv_setsv(sv,old);
5056         SvTEMP_on(old);
5057     }
5058     else
5059         sv_setsv(sv,old);
5060     return sv;
5061 }
5062
5063 void
5064 Perl_sv_reset(pTHX_ register char *s, HV *stash)
5065 {
5066     register HE *entry;
5067     register GV *gv;
5068     register SV *sv;
5069     register I32 i;
5070     register PMOP *pm;
5071     register I32 max;
5072     char todo[PERL_UCHAR_MAX+1];
5073
5074     if (!stash)
5075         return;
5076
5077     if (!*s) {          /* reset ?? searches */
5078         for (pm = HvPMROOT(stash); pm; pm = pm->op_pmnext) {
5079             pm->op_pmdynflags &= ~PMdf_USED;
5080         }
5081         return;
5082     }
5083
5084     /* reset variables */
5085
5086     if (!HvARRAY(stash))
5087