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