598e7466ecc3f0ed85b465f62d63945bd564bff9
[p5sagit/p5-mst-13.2.git] / sv.c
1 /*    sv.c
2  *
3  *    Copyright (c) 1991-1997, 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 #include "perl.h"
16
17 #ifdef OVR_DBL_DIG
18 /* Use an overridden DBL_DIG */
19 # ifdef DBL_DIG
20 #  undef DBL_DIG
21 # endif
22 # define DBL_DIG OVR_DBL_DIG
23 #else
24 /* The following is all to get DBL_DIG, in order to pick a nice
25    default value for printing floating point numbers in Gconvert.
26    (see config.h)
27 */
28 #ifdef I_LIMITS
29 #include <limits.h>
30 #endif
31 #ifdef I_FLOAT
32 #include <float.h>
33 #endif
34 #ifndef HAS_DBL_DIG
35 #define DBL_DIG 15   /* A guess that works lots of places */
36 #endif
37 #endif
38
39 #if defined(USE_STDIO_PTR) && defined(STDIO_PTR_LVALUE) && defined(STDIO_CNT_LVALUE) && !defined(__QNX__)
40 #  define FAST_SV_GETS
41 #endif
42
43 static IV asIV _((SV* sv));
44 static UV asUV _((SV* sv));
45 static SV *more_sv _((void));
46 static XPVIV *more_xiv _((void));
47 static XPVNV *more_xnv _((void));
48 static XPV *more_xpv _((void));
49 static XRV *more_xrv _((void));
50 static XPVIV *new_xiv _((void));
51 static XPVNV *new_xnv _((void));
52 static XPV *new_xpv _((void));
53 static XRV *new_xrv _((void));
54 static void del_xiv _((XPVIV* p));
55 static void del_xnv _((XPVNV* p));
56 static void del_xpv _((XPV* p));
57 static void del_xrv _((XRV* p));
58 static void sv_mortalgrow _((void));
59 static void sv_unglob _((SV* sv));
60
61 typedef void (*SVFUNC) _((SV*));
62
63 #ifdef PURIFY
64
65 #define new_SV(p)                       \
66     do {                                \
67         (p) = (SV*)safemalloc(sizeof(SV)); \
68         reg_add(p);                     \
69     } while (0)
70
71 #define del_SV(p)                       \
72     do {                                \
73         reg_remove(p);                  \
74         free((char*)(p));               \
75     } while (0)
76
77 static SV **registry;
78 static I32 regsize;
79
80 #define REGHASH(sv,size)  ((((U32)(sv)) >> 2) % (size))
81
82 #define REG_REPLACE(sv,a,b) \
83     do {                                \
84         void* p = sv->sv_any;           \
85         I32 h = REGHASH(sv, regsize);   \
86         I32 i = h;                      \
87         while (registry[i] != (a)) {    \
88             if (++i >= regsize)         \
89                 i = 0;                  \
90             if (i == h)                 \
91                 die("SV registry bug"); \
92         }                               \
93         registry[i] = (b);              \
94     } while (0)
95
96 #define REG_ADD(sv)     REG_REPLACE(sv,Nullsv,sv)
97 #define REG_REMOVE(sv)  REG_REPLACE(sv,sv,Nullsv)
98
99 static void
100 reg_add(sv)
101 SV* sv;
102 {
103     if (sv_count >= (regsize >> 1))
104     {
105         SV **oldreg = registry;
106         I32 oldsize = regsize;
107
108         regsize = regsize ? ((regsize << 2) + 1) : 2037;
109         registry = (SV**)safemalloc(regsize * sizeof(SV*));
110         memzero(registry, regsize * sizeof(SV*));
111
112         if (oldreg) {
113             I32 i;
114
115             for (i = 0; i < oldsize; ++i) {
116                 SV* oldsv = oldreg[i];
117                 if (oldsv)
118                     REG_ADD(oldsv);
119             }
120             Safefree(oldreg);
121         }
122     }
123
124     REG_ADD(sv);
125     ++sv_count;
126 }
127
128 static void
129 reg_remove(sv)
130 SV* sv;
131 {
132     REG_REMOVE(sv);
133     --sv_count;
134 }
135
136 static void
137 visit(f)
138 SVFUNC f;
139 {
140     I32 i;
141
142     for (i = 0; i < regsize; ++i) {
143         SV* sv = registry[i];
144         if (sv)
145             (*f)(sv);
146     }
147 }
148
149 void
150 sv_add_arena(ptr, size, flags)
151 char* ptr;
152 U32 size;
153 U32 flags;
154 {
155     if (!(flags & SVf_FAKE))
156         free(ptr);
157 }
158
159 #else /* ! PURIFY */
160
161 /*
162  * "A time to plant, and a time to uproot what was planted..."
163  */
164
165 #define plant_SV(p)                     \
166     do {                                \
167         SvANY(p) = (void *)sv_root;     \
168         SvFLAGS(p) = SVTYPEMASK;        \
169         sv_root = (p);                  \
170         --sv_count;                     \
171     } while (0)
172
173 #define uproot_SV(p)            \
174     do {                                \
175         (p) = sv_root;                  \
176         sv_root = (SV*)SvANY(p);        \
177         ++sv_count;                     \
178     } while (0)
179
180 #define new_SV(p)                       \
181     if (sv_root)                        \
182         uproot_SV(p);                   \
183     else                                \
184         (p) = more_sv()
185
186 #ifdef DEBUGGING
187
188 #define del_SV(p)                       \
189     if (debug & 32768)                  \
190         del_sv(p);                      \
191     else                                \
192         plant_SV(p)
193
194 static void
195 del_sv(p)
196 SV* p;
197 {
198     if (debug & 32768) {
199         SV* sva;
200         SV* sv;
201         SV* svend;
202         int ok = 0;
203         for (sva = sv_arenaroot; sva; sva = (SV *) SvANY(sva)) {
204             sv = sva + 1;
205             svend = &sva[SvREFCNT(sva)];
206             if (p >= sv && p < svend)
207                 ok = 1;
208         }
209         if (!ok) {
210             warn("Attempt to free non-arena SV: 0x%lx", (unsigned long)p);
211             return;
212         }
213     }
214     plant_SV(p);
215 }
216
217 #else /* ! DEBUGGING */
218
219 #define del_SV(p)   plant_SV(p)
220
221 #endif /* DEBUGGING */
222
223 void
224 sv_add_arena(ptr, size, flags)
225 char* ptr;
226 U32 size;
227 U32 flags;
228 {
229     SV* sva = (SV*)ptr;
230     register SV* sv;
231     register SV* svend;
232     Zero(sva, size, char);
233
234     /* The first SV in an arena isn't an SV. */
235     SvANY(sva) = (void *) sv_arenaroot;         /* ptr to next arena */
236     SvREFCNT(sva) = size / sizeof(SV);          /* number of SV slots */
237     SvFLAGS(sva) = flags;                       /* FAKE if not to be freed */
238
239     sv_arenaroot = sva;
240     sv_root = sva + 1;
241
242     svend = &sva[SvREFCNT(sva) - 1];
243     sv = sva + 1;
244     while (sv < svend) {
245         SvANY(sv) = (void *)(SV*)(sv + 1);
246         SvFLAGS(sv) = SVTYPEMASK;
247         sv++;
248     }
249     SvANY(sv) = 0;
250     SvFLAGS(sv) = SVTYPEMASK;
251 }
252
253 static SV*
254 more_sv()
255 {
256     register SV* sv;
257
258     if (nice_chunk) {
259         sv_add_arena(nice_chunk, nice_chunk_size, 0);
260         nice_chunk = Nullch;
261     }
262     else {
263         char *chunk;                /* must use New here to match call to */
264         New(704,chunk,1008,char);   /* Safefree() in sv_free_arenas()     */
265         sv_add_arena(chunk, 1008, 0);
266     }
267     uproot_SV(sv);
268     return sv;
269 }
270
271 static void
272 visit(f)
273 SVFUNC f;
274 {
275     SV* sva;
276     SV* sv;
277     register SV* svend;
278
279     for (sva = sv_arenaroot; sva; sva = (SV*)SvANY(sva)) {
280         svend = &sva[SvREFCNT(sva)];
281         for (sv = sva + 1; sv < svend; ++sv) {
282             if (SvTYPE(sv) != SVTYPEMASK)
283                 (*f)(sv);
284         }
285     }
286 }
287
288 #endif /* PURIFY */
289
290 static void
291 do_report_used(sv)
292 SV* sv;
293 {
294     if (SvTYPE(sv) != SVTYPEMASK) {
295         /* XXX Perhaps this ought to go to Perl_debug_log, if DEBUGGING. */
296         PerlIO_printf(PerlIO_stderr(), "****\n");
297         sv_dump(sv);
298     }
299 }
300
301 void
302 sv_report_used()
303 {
304     visit(do_report_used);
305 }
306
307 static void
308 do_clean_objs(sv)
309 SV* sv;
310 {
311     SV* rv;
312
313     if (SvROK(sv) && SvOBJECT(rv = SvRV(sv))) {
314         DEBUG_D((PerlIO_printf(Perl_debug_log, "Cleaning object ref:\n "), sv_dump(sv));)
315         SvROK_off(sv);
316         SvRV(sv) = 0;
317         SvREFCNT_dec(rv);
318     }
319
320     /* XXX Might want to check arrays, etc. */
321 }
322
323 #ifndef DISABLE_DESTRUCTOR_KLUDGE
324 static void
325 do_clean_named_objs(sv)
326 SV* sv;
327 {
328     if (SvTYPE(sv) == SVt_PVGV && GvSV(sv))
329         do_clean_objs(GvSV(sv));
330 }
331 #endif
332
333 static bool in_clean_objs = FALSE;
334
335 void
336 sv_clean_objs()
337 {
338     in_clean_objs = TRUE;
339 #ifndef DISABLE_DESTRUCTOR_KLUDGE
340     visit(do_clean_named_objs);
341 #endif
342     visit(do_clean_objs);
343     in_clean_objs = FALSE;
344 }
345
346 static void
347 do_clean_all(sv)
348 SV* sv;
349 {
350     DEBUG_D((PerlIO_printf(Perl_debug_log, "Cleaning loops:\n "), sv_dump(sv));)
351     SvFLAGS(sv) |= SVf_BREAK;
352     SvREFCNT_dec(sv);
353 }
354
355 static bool in_clean_all = FALSE;
356
357 void
358 sv_clean_all()
359 {
360     in_clean_all = TRUE;
361     visit(do_clean_all);
362     in_clean_all = FALSE;
363 }
364
365 void
366 sv_free_arenas()
367 {
368     SV* sva;
369     SV* svanext;
370
371     /* Free arenas here, but be careful about fake ones.  (We assume
372        contiguity of the fake ones with the corresponding real ones.) */
373
374     for (sva = sv_arenaroot; sva; sva = svanext) {
375         svanext = (SV*) SvANY(sva);
376         while (svanext && SvFAKE(svanext))
377             svanext = (SV*) SvANY(svanext);
378
379         if (!SvFAKE(sva))
380             Safefree((void *)sva);
381     }
382
383     sv_arenaroot = 0;
384     sv_root = 0;
385 }
386
387 static XPVIV*
388 new_xiv()
389 {
390     IV** xiv;
391     if (xiv_root) {
392         xiv = xiv_root;
393         /*
394          * See comment in more_xiv() -- RAM.
395          */
396         xiv_root = (IV**)*xiv;
397         return (XPVIV*)((char*)xiv - sizeof(XPV));
398     }
399     return more_xiv();
400 }
401
402 static void
403 del_xiv(p)
404 XPVIV* p;
405 {
406     IV** xiv = (IV**)((char*)(p) + sizeof(XPV));
407     *xiv = (IV *)xiv_root;
408     xiv_root = xiv;
409 }
410
411 static XPVIV*
412 more_xiv()
413 {
414     register IV** xiv;
415     register IV** xivend;
416     XPV* ptr = (XPV*)safemalloc(1008);
417     ptr->xpv_pv = (char*)xiv_arenaroot;         /* linked list of xiv arenas */
418     xiv_arenaroot = ptr;                        /* to keep Purify happy */
419
420     xiv = (IV**) ptr;
421     xivend = &xiv[1008 / sizeof(IV *) - 1];
422     xiv += (sizeof(XPV) - 1) / sizeof(IV *) + 1;   /* fudge by size of XPV */
423     xiv_root = xiv;
424     while (xiv < xivend) {
425         *xiv = (IV *)(xiv + 1);
426         xiv++;
427     }
428     *xiv = 0;
429     return new_xiv();
430 }
431
432 static XPVNV*
433 new_xnv()
434 {
435     double* xnv;
436     if (xnv_root) {
437         xnv = xnv_root;
438         xnv_root = *(double**)xnv;
439         return (XPVNV*)((char*)xnv - sizeof(XPVIV));
440     }
441     return more_xnv();
442 }
443
444 static void
445 del_xnv(p)
446 XPVNV* p;
447 {
448     double* xnv = (double*)((char*)(p) + sizeof(XPVIV));
449     *(double**)xnv = xnv_root;
450     xnv_root = xnv;
451 }
452
453 static XPVNV*
454 more_xnv()
455 {
456     register double* xnv;
457     register double* xnvend;
458     xnv = (double*)safemalloc(1008);
459     xnvend = &xnv[1008 / sizeof(double) - 1];
460     xnv += (sizeof(XPVIV) - 1) / sizeof(double) + 1; /* fudge by sizeof XPVIV */
461     xnv_root = xnv;
462     while (xnv < xnvend) {
463         *(double**)xnv = (double*)(xnv + 1);
464         xnv++;
465     }
466     *(double**)xnv = 0;
467     return new_xnv();
468 }
469
470 static XRV*
471 new_xrv()
472 {
473     XRV* xrv;
474     if (xrv_root) {
475         xrv = xrv_root;
476         xrv_root = (XRV*)xrv->xrv_rv;
477         return xrv;
478     }
479     return more_xrv();
480 }
481
482 static void
483 del_xrv(p)
484 XRV* p;
485 {
486     p->xrv_rv = (SV*)xrv_root;
487     xrv_root = p;
488 }
489
490 static XRV*
491 more_xrv()
492 {
493     register XRV* xrv;
494     register XRV* xrvend;
495     xrv_root = (XRV*)safemalloc(1008);
496     xrv = xrv_root;
497     xrvend = &xrv[1008 / sizeof(XRV) - 1];
498     while (xrv < xrvend) {
499         xrv->xrv_rv = (SV*)(xrv + 1);
500         xrv++;
501     }
502     xrv->xrv_rv = 0;
503     return new_xrv();
504 }
505
506 static XPV*
507 new_xpv()
508 {
509     XPV* xpv;
510     if (xpv_root) {
511         xpv = xpv_root;
512         xpv_root = (XPV*)xpv->xpv_pv;
513         return xpv;
514     }
515     return more_xpv();
516 }
517
518 static void
519 del_xpv(p)
520 XPV* p;
521 {
522     p->xpv_pv = (char*)xpv_root;
523     xpv_root = p;
524 }
525
526 static XPV*
527 more_xpv()
528 {
529     register XPV* xpv;
530     register XPV* xpvend;
531     xpv_root = (XPV*)safemalloc(1008);
532     xpv = xpv_root;
533     xpvend = &xpv[1008 / sizeof(XPV) - 1];
534     while (xpv < xpvend) {
535         xpv->xpv_pv = (char*)(xpv + 1);
536         xpv++;
537     }
538     xpv->xpv_pv = 0;
539     return new_xpv();
540 }
541
542 #ifdef PURIFY
543 #define new_XIV() (void*)safemalloc(sizeof(XPVIV))
544 #define del_XIV(p) free((char*)p)
545 #else
546 #define new_XIV() (void*)new_xiv()
547 #define del_XIV(p) del_xiv(p)
548 #endif
549
550 #ifdef PURIFY
551 #define new_XNV() (void*)safemalloc(sizeof(XPVNV))
552 #define del_XNV(p) free((char*)p)
553 #else
554 #define new_XNV() (void*)new_xnv()
555 #define del_XNV(p) del_xnv(p)
556 #endif
557
558 #ifdef PURIFY
559 #define new_XRV() (void*)safemalloc(sizeof(XRV))
560 #define del_XRV(p) free((char*)p)
561 #else
562 #define new_XRV() (void*)new_xrv()
563 #define del_XRV(p) del_xrv(p)
564 #endif
565
566 #ifdef PURIFY
567 #define new_XPV() (void*)safemalloc(sizeof(XPV))
568 #define del_XPV(p) free((char*)p)
569 #else
570 #define new_XPV() (void*)new_xpv()
571 #define del_XPV(p) del_xpv(p)
572 #endif
573
574 #define new_XPVIV() (void*)safemalloc(sizeof(XPVIV))
575 #define del_XPVIV(p) free((char*)p)
576
577 #define new_XPVNV() (void*)safemalloc(sizeof(XPVNV))
578 #define del_XPVNV(p) free((char*)p)
579
580 #define new_XPVMG() (void*)safemalloc(sizeof(XPVMG))
581 #define del_XPVMG(p) free((char*)p)
582
583 #define new_XPVLV() (void*)safemalloc(sizeof(XPVLV))
584 #define del_XPVLV(p) free((char*)p)
585
586 #define new_XPVAV() (void*)safemalloc(sizeof(XPVAV))
587 #define del_XPVAV(p) free((char*)p)
588
589 #define new_XPVHV() (void*)safemalloc(sizeof(XPVHV))
590 #define del_XPVHV(p) free((char*)p)
591
592 #define new_XPVCV() (void*)safemalloc(sizeof(XPVCV))
593 #define del_XPVCV(p) free((char*)p)
594
595 #define new_XPVGV() (void*)safemalloc(sizeof(XPVGV))
596 #define del_XPVGV(p) free((char*)p)
597
598 #define new_XPVBM() (void*)safemalloc(sizeof(XPVBM))
599 #define del_XPVBM(p) free((char*)p)
600
601 #define new_XPVFM() (void*)safemalloc(sizeof(XPVFM))
602 #define del_XPVFM(p) free((char*)p)
603
604 #define new_XPVIO() (void*)safemalloc(sizeof(XPVIO))
605 #define del_XPVIO(p) free((char*)p)
606
607 bool
608 sv_upgrade(sv, mt)
609 register SV* sv;
610 U32 mt;
611 {
612     char*       pv;
613     U32         cur;
614     U32         len;
615     IV          iv;
616     double      nv;
617     MAGIC*      magic;
618     HV*         stash;
619
620     if (SvTYPE(sv) == mt)
621         return TRUE;
622
623     if (mt < SVt_PVIV)
624         (void)SvOOK_off(sv);
625
626     switch (SvTYPE(sv)) {
627     case SVt_NULL:
628         pv      = 0;
629         cur     = 0;
630         len     = 0;
631         iv      = 0;
632         nv      = 0.0;
633         magic   = 0;
634         stash   = 0;
635         break;
636     case SVt_IV:
637         pv      = 0;
638         cur     = 0;
639         len     = 0;
640         iv      = SvIVX(sv);
641         nv      = (double)SvIVX(sv);
642         del_XIV(SvANY(sv));
643         magic   = 0;
644         stash   = 0;
645         if (mt == SVt_NV)
646             mt = SVt_PVNV;
647         else if (mt < SVt_PVIV)
648             mt = SVt_PVIV;
649         break;
650     case SVt_NV:
651         pv      = 0;
652         cur     = 0;
653         len     = 0;
654         nv      = SvNVX(sv);
655         iv      = I_32(nv);
656         magic   = 0;
657         stash   = 0;
658         del_XNV(SvANY(sv));
659         SvANY(sv) = 0;
660         if (mt < SVt_PVNV)
661             mt = SVt_PVNV;
662         break;
663     case SVt_RV:
664         pv      = (char*)SvRV(sv);
665         cur     = 0;
666         len     = 0;
667         iv      = (IV)pv;
668         nv      = (double)(unsigned long)pv;
669         del_XRV(SvANY(sv));
670         magic   = 0;
671         stash   = 0;
672         break;
673     case SVt_PV:
674         pv      = SvPVX(sv);
675         cur     = SvCUR(sv);
676         len     = SvLEN(sv);
677         iv      = 0;
678         nv      = 0.0;
679         magic   = 0;
680         stash   = 0;
681         del_XPV(SvANY(sv));
682         if (mt <= SVt_IV)
683             mt = SVt_PVIV;
684         else if (mt == SVt_NV)
685             mt = SVt_PVNV;
686         break;
687     case SVt_PVIV:
688         pv      = SvPVX(sv);
689         cur     = SvCUR(sv);
690         len     = SvLEN(sv);
691         iv      = SvIVX(sv);
692         nv      = 0.0;
693         magic   = 0;
694         stash   = 0;
695         del_XPVIV(SvANY(sv));
696         break;
697     case SVt_PVNV:
698         pv      = SvPVX(sv);
699         cur     = SvCUR(sv);
700         len     = SvLEN(sv);
701         iv      = SvIVX(sv);
702         nv      = SvNVX(sv);
703         magic   = 0;
704         stash   = 0;
705         del_XPVNV(SvANY(sv));
706         break;
707     case SVt_PVMG:
708         pv      = SvPVX(sv);
709         cur     = SvCUR(sv);
710         len     = SvLEN(sv);
711         iv      = SvIVX(sv);
712         nv      = SvNVX(sv);
713         magic   = SvMAGIC(sv);
714         stash   = SvSTASH(sv);
715         del_XPVMG(SvANY(sv));
716         break;
717     default:
718         croak("Can't upgrade that kind of scalar");
719     }
720
721     switch (mt) {
722     case SVt_NULL:
723         croak("Can't upgrade to undef");
724     case SVt_IV:
725         SvANY(sv) = new_XIV();
726         SvIVX(sv)       = iv;
727         break;
728     case SVt_NV:
729         SvANY(sv) = new_XNV();
730         SvNVX(sv)       = nv;
731         break;
732     case SVt_RV:
733         SvANY(sv) = new_XRV();
734         SvRV(sv) = (SV*)pv;
735         break;
736     case SVt_PV:
737         SvANY(sv) = new_XPV();
738         SvPVX(sv)       = pv;
739         SvCUR(sv)       = cur;
740         SvLEN(sv)       = len;
741         break;
742     case SVt_PVIV:
743         SvANY(sv) = new_XPVIV();
744         SvPVX(sv)       = pv;
745         SvCUR(sv)       = cur;
746         SvLEN(sv)       = len;
747         SvIVX(sv)       = iv;
748         if (SvNIOK(sv))
749             (void)SvIOK_on(sv);
750         SvNOK_off(sv);
751         break;
752     case SVt_PVNV:
753         SvANY(sv) = new_XPVNV();
754         SvPVX(sv)       = pv;
755         SvCUR(sv)       = cur;
756         SvLEN(sv)       = len;
757         SvIVX(sv)       = iv;
758         SvNVX(sv)       = nv;
759         break;
760     case SVt_PVMG:
761         SvANY(sv) = new_XPVMG();
762         SvPVX(sv)       = pv;
763         SvCUR(sv)       = cur;
764         SvLEN(sv)       = len;
765         SvIVX(sv)       = iv;
766         SvNVX(sv)       = nv;
767         SvMAGIC(sv)     = magic;
768         SvSTASH(sv)     = stash;
769         break;
770     case SVt_PVLV:
771         SvANY(sv) = new_XPVLV();
772         SvPVX(sv)       = pv;
773         SvCUR(sv)       = cur;
774         SvLEN(sv)       = len;
775         SvIVX(sv)       = iv;
776         SvNVX(sv)       = nv;
777         SvMAGIC(sv)     = magic;
778         SvSTASH(sv)     = stash;
779         LvTARGOFF(sv)   = 0;
780         LvTARGLEN(sv)   = 0;
781         LvTARG(sv)      = 0;
782         LvTYPE(sv)      = 0;
783         break;
784     case SVt_PVAV:
785         SvANY(sv) = new_XPVAV();
786         if (pv)
787             Safefree(pv);
788         SvPVX(sv)       = 0;
789         AvMAX(sv)       = -1;
790         AvFILL(sv)      = -1;
791         SvIVX(sv)       = 0;
792         SvNVX(sv)       = 0.0;
793         SvMAGIC(sv)     = magic;
794         SvSTASH(sv)     = stash;
795         AvALLOC(sv)     = 0;
796         AvARYLEN(sv)    = 0;
797         AvFLAGS(sv)     = 0;
798         break;
799     case SVt_PVHV:
800         SvANY(sv) = new_XPVHV();
801         if (pv)
802             Safefree(pv);
803         SvPVX(sv)       = 0;
804         HvFILL(sv)      = 0;
805         HvMAX(sv)       = 0;
806         HvKEYS(sv)      = 0;
807         SvNVX(sv)       = 0.0;
808         SvMAGIC(sv)     = magic;
809         SvSTASH(sv)     = stash;
810         HvRITER(sv)     = 0;
811         HvEITER(sv)     = 0;
812         HvPMROOT(sv)    = 0;
813         HvNAME(sv)      = 0;
814         break;
815     case SVt_PVCV:
816         SvANY(sv) = new_XPVCV();
817         Zero(SvANY(sv), 1, XPVCV);
818         SvPVX(sv)       = pv;
819         SvCUR(sv)       = cur;
820         SvLEN(sv)       = len;
821         SvIVX(sv)       = iv;
822         SvNVX(sv)       = nv;
823         SvMAGIC(sv)     = magic;
824         SvSTASH(sv)     = stash;
825         break;
826     case SVt_PVGV:
827         SvANY(sv) = new_XPVGV();
828         SvPVX(sv)       = pv;
829         SvCUR(sv)       = cur;
830         SvLEN(sv)       = len;
831         SvIVX(sv)       = iv;
832         SvNVX(sv)       = nv;
833         SvMAGIC(sv)     = magic;
834         SvSTASH(sv)     = stash;
835         GvGP(sv)        = 0;
836         GvNAME(sv)      = 0;
837         GvNAMELEN(sv)   = 0;
838         GvSTASH(sv)     = 0;
839         GvFLAGS(sv)     = 0;
840         break;
841     case SVt_PVBM:
842         SvANY(sv) = new_XPVBM();
843         SvPVX(sv)       = pv;
844         SvCUR(sv)       = cur;
845         SvLEN(sv)       = len;
846         SvIVX(sv)       = iv;
847         SvNVX(sv)       = nv;
848         SvMAGIC(sv)     = magic;
849         SvSTASH(sv)     = stash;
850         BmRARE(sv)      = 0;
851         BmUSEFUL(sv)    = 0;
852         BmPREVIOUS(sv)  = 0;
853         break;
854     case SVt_PVFM:
855         SvANY(sv) = new_XPVFM();
856         Zero(SvANY(sv), 1, XPVFM);
857         SvPVX(sv)       = pv;
858         SvCUR(sv)       = cur;
859         SvLEN(sv)       = len;
860         SvIVX(sv)       = iv;
861         SvNVX(sv)       = nv;
862         SvMAGIC(sv)     = magic;
863         SvSTASH(sv)     = stash;
864         break;
865     case SVt_PVIO:
866         SvANY(sv) = new_XPVIO();
867         Zero(SvANY(sv), 1, XPVIO);
868         SvPVX(sv)       = pv;
869         SvCUR(sv)       = cur;
870         SvLEN(sv)       = len;
871         SvIVX(sv)       = iv;
872         SvNVX(sv)       = nv;
873         SvMAGIC(sv)     = magic;
874         SvSTASH(sv)     = stash;
875         IoPAGE_LEN(sv)  = 60;
876         break;
877     }
878     SvFLAGS(sv) &= ~SVTYPEMASK;
879     SvFLAGS(sv) |= mt;
880     return TRUE;
881 }
882
883 #ifdef DEBUGGING
884 char *
885 sv_peek(sv)
886 register SV *sv;
887 {
888     SV *t = sv_newmortal();
889     STRLEN prevlen;
890     int unref = 0;
891
892   retry:
893     if (!sv) {
894         sv_catpv(t, "VOID");
895         goto finish;
896     }
897     else if (sv == (SV*)0x55555555 || SvTYPE(sv) == 'U') {
898         sv_catpv(t, "WILD");
899         goto finish;
900     }
901     else if (sv == &sv_undef || sv == &sv_no || sv == &sv_yes) {
902         if (sv == &sv_undef) {
903             sv_catpv(t, "SV_UNDEF");
904             if (!(SvFLAGS(sv) & (SVf_OK|SVf_OOK|SVs_OBJECT|
905                                  SVs_GMG|SVs_SMG|SVs_RMG)) &&
906                 SvREADONLY(sv))
907                 goto finish;
908         }
909         else if (sv == &sv_no) {
910             sv_catpv(t, "SV_NO");
911             if (!(SvFLAGS(sv) & (SVf_ROK|SVf_OOK|SVs_OBJECT|
912                                  SVs_GMG|SVs_SMG|SVs_RMG)) &&
913                 !(~SvFLAGS(sv) & (SVf_POK|SVf_NOK|SVf_READONLY|
914                                   SVp_POK|SVp_NOK)) &&
915                 SvCUR(sv) == 0 &&
916                 SvNVX(sv) == 0.0)
917                 goto finish;
918         }
919         else {
920             sv_catpv(t, "SV_YES");
921             if (!(SvFLAGS(sv) & (SVf_ROK|SVf_OOK|SVs_OBJECT|
922                                  SVs_GMG|SVs_SMG|SVs_RMG)) &&
923                 !(~SvFLAGS(sv) & (SVf_POK|SVf_NOK|SVf_READONLY|
924                                   SVp_POK|SVp_NOK)) &&
925                 SvCUR(sv) == 1 &&
926                 SvPVX(sv) && *SvPVX(sv) == '1' &&
927                 SvNVX(sv) == 1.0)
928                 goto finish;
929         }
930         sv_catpv(t, ":");
931     }
932     else if (SvREFCNT(sv) == 0) {
933         sv_catpv(t, "(");
934         unref++;
935     }
936     if (SvROK(sv)) {
937         sv_catpv(t, "\\");
938         if (SvCUR(t) + unref > 10) {
939             SvCUR(t) = unref + 3;
940             *SvEND(t) = '\0';
941             sv_catpv(t, "...");
942             goto finish;
943         }
944         sv = (SV*)SvRV(sv);
945         goto retry;
946     }
947     switch (SvTYPE(sv)) {
948     default:
949         sv_catpv(t, "FREED");
950         goto finish;
951
952     case SVt_NULL:
953         sv_catpv(t, "UNDEF");
954         return tokenbuf;
955     case SVt_IV:
956         sv_catpv(t, "IV");
957         break;
958     case SVt_NV:
959         sv_catpv(t, "NV");
960         break;
961     case SVt_RV:
962         sv_catpv(t, "RV");
963         break;
964     case SVt_PV:
965         sv_catpv(t, "PV");
966         break;
967     case SVt_PVIV:
968         sv_catpv(t, "PVIV");
969         break;
970     case SVt_PVNV:
971         sv_catpv(t, "PVNV");
972         break;
973     case SVt_PVMG:
974         sv_catpv(t, "PVMG");
975         break;
976     case SVt_PVLV:
977         sv_catpv(t, "PVLV");
978         break;
979     case SVt_PVAV:
980         sv_catpv(t, "AV");
981         break;
982     case SVt_PVHV:
983         sv_catpv(t, "HV");
984         break;
985     case SVt_PVCV:
986         if (CvGV(sv))
987             sv_catpvf(t, "CV(%s)", GvNAME(CvGV(sv)));
988         else
989             sv_catpv(t, "CV()");
990         goto finish;
991     case SVt_PVGV:
992         sv_catpv(t, "GV");
993         break;
994     case SVt_PVBM:
995         sv_catpv(t, "BM");
996         break;
997     case SVt_PVFM:
998         sv_catpv(t, "FM");
999         break;
1000     case SVt_PVIO:
1001         sv_catpv(t, "IO");
1002         break;
1003     }
1004
1005     if (SvPOKp(sv)) {
1006         if (!SvPVX(sv))
1007             sv_catpv(t, "(null)");
1008         if (SvOOK(sv))
1009             sv_catpvf(t, "(%ld+\"%.127s\")",(long)SvIVX(sv),SvPVX(sv));
1010         else
1011             sv_catpvf(t, "(\"%.127s\")",SvPVX(sv));
1012     }
1013     else if (SvNOKp(sv)) {
1014         SET_NUMERIC_STANDARD();
1015         sv_catpvf(t, "(%g)",SvNVX(sv));
1016     }
1017     else if (SvIOKp(sv))
1018         sv_catpvf(t, "(%ld)",(long)SvIVX(sv));
1019     else
1020         sv_catpv(t, "()");
1021     
1022   finish:
1023     if (unref) {
1024         while (unref--)
1025             sv_catpv(t, ")");
1026     }
1027     return SvPV(t, na);
1028 }
1029 #endif
1030
1031 int
1032 sv_backoff(sv)
1033 register SV *sv;
1034 {
1035     assert(SvOOK(sv));
1036     if (SvIVX(sv)) {
1037         char *s = SvPVX(sv);
1038         SvLEN(sv) += SvIVX(sv);
1039         SvPVX(sv) -= SvIVX(sv);
1040         SvIV_set(sv, 0);
1041         Move(s, SvPVX(sv), SvCUR(sv)+1, char);
1042     }
1043     SvFLAGS(sv) &= ~SVf_OOK;
1044     return 0;
1045 }
1046
1047 char *
1048 sv_grow(sv,newlen)
1049 register SV *sv;
1050 #ifndef DOSISH
1051 register I32 newlen;
1052 #else
1053 unsigned long newlen;
1054 #endif
1055 {
1056     register char *s;
1057
1058 #ifdef HAS_64K_LIMIT
1059     if (newlen >= 0x10000) {
1060         PerlIO_printf(Perl_debug_log, "Allocation too large: %lx\n", newlen);
1061         my_exit(1);
1062     }
1063 #endif /* HAS_64K_LIMIT */
1064     if (SvROK(sv))
1065         sv_unref(sv);
1066     if (SvTYPE(sv) < SVt_PV) {
1067         sv_upgrade(sv, SVt_PV);
1068         s = SvPVX(sv);
1069     }
1070     else if (SvOOK(sv)) {       /* pv is offset? */
1071         sv_backoff(sv);
1072         s = SvPVX(sv);
1073         if (newlen > SvLEN(sv))
1074             newlen += 10 * (newlen - SvCUR(sv)); /* avoid copy each time */
1075     }
1076     else
1077         s = SvPVX(sv);
1078     if (newlen > SvLEN(sv)) {           /* need more room? */
1079         if (SvLEN(sv) && s)
1080             Renew(s,newlen,char);
1081         else
1082             New(703,s,newlen,char);
1083         SvPV_set(sv, s);
1084         SvLEN_set(sv, newlen);
1085     }
1086     return s;
1087 }
1088
1089 void
1090 sv_setiv(sv,i)
1091 register SV *sv;
1092 IV i;
1093 {
1094     if (SvTHINKFIRST(sv)) {
1095         if (SvREADONLY(sv) && curcop != &compiling)
1096             croak(no_modify);
1097         if (SvROK(sv))
1098             sv_unref(sv);
1099     }
1100     switch (SvTYPE(sv)) {
1101     case SVt_NULL:
1102         sv_upgrade(sv, SVt_IV);
1103         break;
1104     case SVt_NV:
1105         sv_upgrade(sv, SVt_PVNV);
1106         break;
1107     case SVt_RV:
1108     case SVt_PV:
1109         sv_upgrade(sv, SVt_PVIV);
1110         break;
1111
1112     case SVt_PVGV:
1113         if (SvFAKE(sv)) {
1114             sv_unglob(sv);
1115             break;
1116         }
1117         /* FALL THROUGH */
1118     case SVt_PVAV:
1119     case SVt_PVHV:
1120     case SVt_PVCV:
1121     case SVt_PVFM:
1122     case SVt_PVIO:
1123         croak("Can't coerce %s to integer in %s", sv_reftype(sv,0),
1124             op_name[op->op_type]);
1125     }
1126     (void)SvIOK_only(sv);                       /* validate number */
1127     SvIVX(sv) = i;
1128     SvTAINT(sv);
1129 }
1130
1131 void
1132 sv_setuv(sv,u)
1133 register SV *sv;
1134 UV u;
1135 {
1136     if (u <= IV_MAX)
1137         sv_setiv(sv, u);
1138     else
1139         sv_setnv(sv, (double)u);
1140 }
1141
1142 void
1143 sv_setnv(sv,num)
1144 register SV *sv;
1145 double num;
1146 {
1147     if (SvTHINKFIRST(sv)) {
1148         if (SvREADONLY(sv) && curcop != &compiling)
1149             croak(no_modify);
1150         if (SvROK(sv))
1151             sv_unref(sv);
1152     }
1153     switch (SvTYPE(sv)) {
1154     case SVt_NULL:
1155     case SVt_IV:
1156         sv_upgrade(sv, SVt_NV);
1157         break;
1158     case SVt_NV:
1159     case SVt_RV:
1160     case SVt_PV:
1161     case SVt_PVIV:
1162         sv_upgrade(sv, SVt_PVNV);
1163         /* FALL THROUGH */
1164     case SVt_PVNV:
1165     case SVt_PVMG:
1166     case SVt_PVBM:
1167     case SVt_PVLV:
1168         if (SvOOK(sv))
1169             (void)SvOOK_off(sv);
1170         break;
1171     case SVt_PVGV:
1172         if (SvFAKE(sv)) {
1173             sv_unglob(sv);
1174             break;
1175         }
1176         /* FALL THROUGH */
1177     case SVt_PVAV:
1178     case SVt_PVHV:
1179     case SVt_PVCV:
1180     case SVt_PVFM:
1181     case SVt_PVIO:
1182         croak("Can't coerce %s to number in %s", sv_reftype(sv,0),
1183             op_name[op->op_type]);
1184     }
1185     SvNVX(sv) = num;
1186     (void)SvNOK_only(sv);                       /* validate number */
1187     SvTAINT(sv);
1188 }
1189
1190 static void
1191 not_a_number(sv)
1192 SV *sv;
1193 {
1194     char tmpbuf[64];
1195     char *d = tmpbuf;
1196     char *s;
1197     char *limit = tmpbuf + sizeof(tmpbuf) - 8;
1198                   /* each *s can expand to 4 chars + "...\0",
1199                      i.e. need room for 8 chars */
1200
1201     for (s = SvPVX(sv); *s && d < limit; s++) {
1202         int ch = *s & 0xFF;
1203         if (ch & 128 && !isPRINT_LC(ch)) {
1204             *d++ = 'M';
1205             *d++ = '-';
1206             ch &= 127;
1207         }
1208         if (ch == '\n') {
1209             *d++ = '\\';
1210             *d++ = 'n';
1211         }
1212         else if (ch == '\r') {
1213             *d++ = '\\';
1214             *d++ = 'r';
1215         }
1216         else if (ch == '\f') {
1217             *d++ = '\\';
1218             *d++ = 'f';
1219         }
1220         else if (ch == '\\') {
1221             *d++ = '\\';
1222             *d++ = '\\';
1223         }
1224         else if (isPRINT_LC(ch))
1225             *d++ = ch;
1226         else {
1227             *d++ = '^';
1228             *d++ = toCTRL(ch);
1229         }
1230     }
1231     if (*s) {
1232         *d++ = '.';
1233         *d++ = '.';
1234         *d++ = '.';
1235     }
1236     *d = '\0';
1237
1238     if (op)
1239         warn("Argument \"%s\" isn't numeric in %s", tmpbuf,
1240                 op_name[op->op_type]);
1241     else
1242         warn("Argument \"%s\" isn't numeric", tmpbuf);
1243 }
1244
1245 IV
1246 sv_2iv(sv)
1247 register SV *sv;
1248 {
1249     if (!sv)
1250         return 0;
1251     if (SvGMAGICAL(sv)) {
1252         mg_get(sv);
1253         if (SvIOKp(sv))
1254             return SvIVX(sv);
1255         if (SvNOKp(sv)) {
1256             if (SvNVX(sv) < 0.0)
1257                 return I_V(SvNVX(sv));
1258             else
1259                 return (IV) U_V(SvNVX(sv));
1260         }
1261         if (SvPOKp(sv) && SvLEN(sv))
1262             return asIV(sv);
1263         if (!SvROK(sv)) {
1264             if (dowarn && !localizing && !(SvFLAGS(sv) & SVs_PADTMP))
1265                 warn(warn_uninit);
1266             return 0;
1267         }
1268     }
1269     if (SvTHINKFIRST(sv)) {
1270         if (SvROK(sv)) {
1271 #ifdef OVERLOAD
1272           SV* tmpstr;
1273           if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv, numer)))
1274             return SvIV(tmpstr);
1275 #endif /* OVERLOAD */
1276           return (IV)SvRV(sv);
1277         }
1278         if (SvREADONLY(sv)) {
1279             if (SvNOKp(sv)) {
1280                 if (SvNVX(sv) < 0.0)
1281                     return I_V(SvNVX(sv));
1282                 else
1283                     return (IV) U_V(SvNVX(sv));
1284             }
1285             if (SvPOKp(sv) && SvLEN(sv))
1286                 return asIV(sv);
1287             if (dowarn)
1288                 warn(warn_uninit);
1289             return 0;
1290         }
1291     }
1292     switch (SvTYPE(sv)) {
1293     case SVt_NULL:
1294         sv_upgrade(sv, SVt_IV);
1295         break;
1296     case SVt_PV:
1297         sv_upgrade(sv, SVt_PVIV);
1298         break;
1299     case SVt_NV:
1300         sv_upgrade(sv, SVt_PVNV);
1301         break;
1302     }
1303     if (SvNOKp(sv)) {
1304         (void)SvIOK_on(sv);
1305         if (SvNVX(sv) < 0.0)
1306             SvIVX(sv) = I_V(SvNVX(sv));
1307         else
1308             SvUVX(sv) = U_V(SvNVX(sv));
1309     }
1310     else if (SvPOKp(sv) && SvLEN(sv)) {
1311         (void)SvIOK_on(sv);
1312         SvIVX(sv) = asIV(sv);
1313     }
1314     else  {
1315         if (dowarn && !localizing && !(SvFLAGS(sv) & SVs_PADTMP))
1316             warn(warn_uninit);
1317         return 0;
1318     }
1319     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%lx 2iv(%ld)\n",
1320         (unsigned long)sv,(long)SvIVX(sv)));
1321     return SvIVX(sv);
1322 }
1323
1324 UV
1325 sv_2uv(sv)
1326 register SV *sv;
1327 {
1328     if (!sv)
1329         return 0;
1330     if (SvGMAGICAL(sv)) {
1331         mg_get(sv);
1332         if (SvIOKp(sv))
1333             return SvUVX(sv);
1334         if (SvNOKp(sv))
1335             return U_V(SvNVX(sv));
1336         if (SvPOKp(sv) && SvLEN(sv))
1337             return asUV(sv);
1338         if (!SvROK(sv)) {
1339             if (dowarn && !localizing && !(SvFLAGS(sv) & SVs_PADTMP))
1340                 warn(warn_uninit);
1341             return 0;
1342         }
1343     }
1344     if (SvTHINKFIRST(sv)) {
1345         if (SvROK(sv)) {
1346 #ifdef OVERLOAD
1347           SV* tmpstr;
1348           if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv, numer)))
1349             return SvUV(tmpstr);
1350 #endif /* OVERLOAD */
1351           return (UV)SvRV(sv);
1352         }
1353         if (SvREADONLY(sv)) {
1354             if (SvNOKp(sv)) {
1355                 return U_V(SvNVX(sv));
1356             }
1357             if (SvPOKp(sv) && SvLEN(sv))
1358                 return asUV(sv);
1359             if (dowarn)
1360                 warn(warn_uninit);
1361             return 0;
1362         }
1363     }
1364     switch (SvTYPE(sv)) {
1365     case SVt_NULL:
1366         sv_upgrade(sv, SVt_IV);
1367         break;
1368     case SVt_PV:
1369         sv_upgrade(sv, SVt_PVIV);
1370         break;
1371     case SVt_NV:
1372         sv_upgrade(sv, SVt_PVNV);
1373         break;
1374     }
1375     if (SvNOKp(sv)) {
1376         (void)SvIOK_on(sv);
1377         SvUVX(sv) = U_V(SvNVX(sv));
1378     }
1379     else if (SvPOKp(sv) && SvLEN(sv)) {
1380         (void)SvIOK_on(sv);
1381         SvUVX(sv) = asUV(sv);
1382     }
1383     else  {
1384         if (dowarn && !localizing && !(SvFLAGS(sv) & SVs_PADTMP))
1385             warn(warn_uninit);
1386         return 0;
1387     }
1388     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%lx 2uv(%lu)\n",
1389         (unsigned long)sv,SvUVX(sv)));
1390     return SvUVX(sv);
1391 }
1392
1393 double
1394 sv_2nv(sv)
1395 register SV *sv;
1396 {
1397     if (!sv)
1398         return 0.0;
1399     if (SvGMAGICAL(sv)) {
1400         mg_get(sv);
1401         if (SvNOKp(sv))
1402             return SvNVX(sv);
1403         if (SvPOKp(sv) && SvLEN(sv)) {
1404             if (dowarn && !SvIOKp(sv) && !looks_like_number(sv))
1405                 not_a_number(sv);
1406             SET_NUMERIC_STANDARD();
1407             return atof(SvPVX(sv));
1408         }
1409         if (SvIOKp(sv))
1410             return (double)SvIVX(sv);
1411         if (!SvROK(sv)) {
1412             if (dowarn && !localizing && !(SvFLAGS(sv) & SVs_PADTMP))
1413                 warn(warn_uninit);
1414             return 0;
1415         }
1416     }
1417     if (SvTHINKFIRST(sv)) {
1418         if (SvROK(sv)) {
1419 #ifdef OVERLOAD
1420           SV* tmpstr;
1421           if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv,numer)))
1422             return SvNV(tmpstr);
1423 #endif /* OVERLOAD */
1424           return (double)(unsigned long)SvRV(sv);
1425         }
1426         if (SvREADONLY(sv)) {
1427             if (SvPOKp(sv) && SvLEN(sv)) {
1428                 if (dowarn && !SvIOKp(sv) && !looks_like_number(sv))
1429                     not_a_number(sv);
1430                 SET_NUMERIC_STANDARD();
1431                 return atof(SvPVX(sv));
1432             }
1433             if (SvIOKp(sv))
1434                 return (double)SvIVX(sv);
1435             if (dowarn)
1436                 warn(warn_uninit);
1437             return 0.0;
1438         }
1439     }
1440     if (SvTYPE(sv) < SVt_NV) {
1441         if (SvTYPE(sv) == SVt_IV)
1442             sv_upgrade(sv, SVt_PVNV);
1443         else
1444             sv_upgrade(sv, SVt_NV);
1445         DEBUG_c(SET_NUMERIC_STANDARD());
1446         DEBUG_c(PerlIO_printf(Perl_debug_log,
1447                               "0x%lx num(%g)\n",(unsigned long)sv,SvNVX(sv)));
1448     }
1449     else if (SvTYPE(sv) < SVt_PVNV)
1450         sv_upgrade(sv, SVt_PVNV);
1451     if (SvIOKp(sv) &&
1452             (!SvPOKp(sv) || !strchr(SvPVX(sv),'.') || !looks_like_number(sv)))
1453     {
1454         SvNVX(sv) = (double)SvIVX(sv);
1455     }
1456     else if (SvPOKp(sv) && SvLEN(sv)) {
1457         if (dowarn && !SvIOKp(sv) && !looks_like_number(sv))
1458             not_a_number(sv);
1459         SET_NUMERIC_STANDARD();
1460         SvNVX(sv) = atof(SvPVX(sv));
1461     }
1462     else  {
1463         if (dowarn && !localizing && !(SvFLAGS(sv) & SVs_PADTMP))
1464             warn(warn_uninit);
1465         return 0.0;
1466     }
1467     SvNOK_on(sv);
1468     DEBUG_c(SET_NUMERIC_STANDARD());
1469     DEBUG_c(PerlIO_printf(Perl_debug_log,
1470                           "0x%lx 2nv(%g)\n",(unsigned long)sv,SvNVX(sv)));
1471     return SvNVX(sv);
1472 }
1473
1474 static IV
1475 asIV(sv)
1476 SV *sv;
1477 {
1478     I32 numtype = looks_like_number(sv);
1479     double d;
1480
1481     if (numtype == 1)
1482         return atol(SvPVX(sv));
1483     if (!numtype && dowarn)
1484         not_a_number(sv);
1485     SET_NUMERIC_STANDARD();
1486     d = atof(SvPVX(sv));
1487     if (d < 0.0)
1488         return I_V(d);
1489     else
1490         return (IV) U_V(d);
1491 }
1492
1493 static UV
1494 asUV(sv)
1495 SV *sv;
1496 {
1497     I32 numtype = looks_like_number(sv);
1498
1499     if (numtype == 1)
1500         return atol(SvPVX(sv));
1501     if (!numtype && dowarn)
1502         not_a_number(sv);
1503     SET_NUMERIC_STANDARD();
1504     return U_V(atof(SvPVX(sv)));
1505 }
1506
1507 I32
1508 looks_like_number(sv)
1509 SV *sv;
1510 {
1511     register char *s;
1512     register char *send;
1513     register char *sbegin;
1514     I32 numtype;
1515     STRLEN len;
1516
1517     if (SvPOK(sv)) {
1518         sbegin = SvPVX(sv); 
1519         len = SvCUR(sv);
1520     }
1521     else if (SvPOKp(sv))
1522         sbegin = SvPV(sv, len);
1523     else
1524         return 1;
1525     send = sbegin + len;
1526
1527     s = sbegin;
1528     while (isSPACE(*s))
1529         s++;
1530     if (*s == '+' || *s == '-')
1531         s++;
1532
1533     /* next must be digit or '.' */
1534     if (isDIGIT(*s)) {
1535         do {
1536             s++;
1537         } while (isDIGIT(*s));
1538         if (*s == '.') {
1539             s++;
1540             while (isDIGIT(*s))  /* optional digits after "." */
1541                 s++;
1542         }
1543     }
1544     else if (*s == '.') {
1545         s++;
1546         /* no digits before '.' means we need digits after it */
1547         if (isDIGIT(*s)) {
1548             do {
1549                 s++;
1550             } while (isDIGIT(*s));
1551         }
1552         else
1553             return 0;
1554     }
1555     else
1556         return 0;
1557
1558     /*
1559      * we return 1 if the number can be converted to _integer_ with atol()
1560      * and 2 if you need (int)atof().
1561      */
1562     numtype = 1;
1563
1564     /* we can have an optional exponent part */
1565     if (*s == 'e' || *s == 'E') {
1566         numtype = 2;
1567         s++;
1568         if (*s == '+' || *s == '-')
1569             s++;
1570         if (isDIGIT(*s)) {
1571             do {
1572                 s++;
1573             } while (isDIGIT(*s));
1574         }
1575         else
1576             return 0;
1577     }
1578     while (isSPACE(*s))
1579         s++;
1580     if (s >= send)
1581         return numtype;
1582     if (len == 10 && memEQ(sbegin, "0 but true", 10))
1583         return 1;
1584     return 0;
1585 }
1586
1587 char *
1588 sv_2pv(sv, lp)
1589 register SV *sv;
1590 STRLEN *lp;
1591 {
1592     register char *s;
1593     int olderrno;
1594     SV *tsv;
1595
1596     if (!sv) {
1597         *lp = 0;
1598         return "";
1599     }
1600     if (SvGMAGICAL(sv)) {
1601         mg_get(sv);
1602         if (SvPOKp(sv)) {
1603             *lp = SvCUR(sv);
1604             return SvPVX(sv);
1605         }
1606         if (SvIOKp(sv)) {
1607             (void)sprintf(tokenbuf,"%ld",(long)SvIVX(sv));
1608             tsv = Nullsv;
1609             goto tokensave;
1610         }
1611         if (SvNOKp(sv)) {
1612             SET_NUMERIC_STANDARD();
1613             Gconvert(SvNVX(sv), DBL_DIG, 0, tokenbuf);
1614             tsv = Nullsv;
1615             goto tokensave;
1616         }
1617         if (!SvROK(sv)) {
1618             if (dowarn && !localizing && !(SvFLAGS(sv) & SVs_PADTMP))
1619                 warn(warn_uninit);
1620             *lp = 0;
1621             return "";
1622         }
1623     }
1624     if (SvTHINKFIRST(sv)) {
1625         if (SvROK(sv)) {
1626 #ifdef OVERLOAD
1627             SV* tmpstr;
1628             if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv,string)))
1629               return SvPV(tmpstr,*lp);
1630 #endif /* OVERLOAD */
1631             sv = (SV*)SvRV(sv);
1632             if (!sv)
1633                 s = "NULLREF";
1634             else {
1635                 switch (SvTYPE(sv)) {
1636                 case SVt_NULL:
1637                 case SVt_IV:
1638                 case SVt_NV:
1639                 case SVt_RV:
1640                 case SVt_PV:
1641                 case SVt_PVIV:
1642                 case SVt_PVNV:
1643                 case SVt_PVBM:
1644                 case SVt_PVMG:  s = "SCALAR";                   break;
1645                 case SVt_PVLV:  s = "LVALUE";                   break;
1646                 case SVt_PVAV:  s = "ARRAY";                    break;
1647                 case SVt_PVHV:  s = "HASH";                     break;
1648                 case SVt_PVCV:  s = "CODE";                     break;
1649                 case SVt_PVGV:  s = "GLOB";                     break;
1650                 case SVt_PVFM:  s = "FORMATLINE";               break;
1651                 case SVt_PVIO:  s = "IO";                       break;
1652                 default:        s = "UNKNOWN";                  break;
1653                 }
1654                 tsv = NEWSV(0,0);
1655                 if (SvOBJECT(sv))
1656                     sv_setpvf(tsv, "%s=%s", HvNAME(SvSTASH(sv)), s);
1657                 else
1658                     sv_setpv(tsv, s);
1659                 sv_catpvf(tsv, "(0x%lx)", (unsigned long)sv);
1660                 goto tokensaveref;
1661             }
1662             *lp = strlen(s);
1663             return s;
1664         }
1665         if (SvREADONLY(sv)) {
1666             if (SvNOKp(sv)) {
1667                 SET_NUMERIC_STANDARD();
1668                 Gconvert(SvNVX(sv), DBL_DIG, 0, tokenbuf);
1669                 tsv = Nullsv;
1670                 goto tokensave;
1671             }
1672             if (SvIOKp(sv)) {
1673                 (void)sprintf(tokenbuf,"%ld",(long)SvIVX(sv));
1674                 tsv = Nullsv;
1675                 goto tokensave;
1676             }
1677             if (dowarn)
1678                 warn(warn_uninit);
1679             *lp = 0;
1680             return "";
1681         }
1682     }
1683     if (!SvUPGRADE(sv, SVt_PV))
1684         return 0;
1685     if (SvNOKp(sv)) {
1686         if (SvTYPE(sv) < SVt_PVNV)
1687             sv_upgrade(sv, SVt_PVNV);
1688         SvGROW(sv, 28);
1689         s = SvPVX(sv);
1690         olderrno = errno;       /* some Xenix systems wipe out errno here */
1691 #ifdef apollo
1692         if (SvNVX(sv) == 0.0)
1693             (void)strcpy(s,"0");
1694         else
1695 #endif /*apollo*/
1696         {
1697             SET_NUMERIC_STANDARD();
1698             Gconvert(SvNVX(sv), DBL_DIG, 0, s);
1699         }
1700         errno = olderrno;
1701 #ifdef FIXNEGATIVEZERO
1702         if (*s == '-' && s[1] == '0' && !s[2])
1703             strcpy(s,"0");
1704 #endif
1705         while (*s) s++;
1706 #ifdef hcx
1707         if (s[-1] == '.')
1708             *--s = '\0';
1709 #endif
1710     }
1711     else if (SvIOKp(sv)) {
1712         if (SvTYPE(sv) < SVt_PVIV)
1713             sv_upgrade(sv, SVt_PVIV);
1714         olderrno = errno;       /* some Xenix systems wipe out errno here */
1715         sv_setpvf(sv, "%vd", SvIVX(sv));
1716         errno = olderrno;
1717         s = SvEND(sv);
1718     }
1719     else {
1720         if (dowarn && !localizing && !(SvFLAGS(sv) & SVs_PADTMP))
1721             warn(warn_uninit);
1722         *lp = 0;
1723         return "";
1724     }
1725     *lp = s - SvPVX(sv);
1726     SvCUR_set(sv, *lp);
1727     SvPOK_on(sv);
1728     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%lx 2pv(%s)\n",(unsigned long)sv,SvPVX(sv)));
1729     return SvPVX(sv);
1730
1731   tokensave:
1732     if (SvROK(sv)) {    /* XXX Skip this when sv_pvn_force calls */
1733         /* Sneaky stuff here */
1734
1735       tokensaveref:
1736         if (!tsv)
1737             tsv = newSVpv(tokenbuf, 0);
1738         sv_2mortal(tsv);
1739         *lp = SvCUR(tsv);
1740         return SvPVX(tsv);
1741     }
1742     else {
1743         STRLEN len;
1744         char *t;
1745
1746         if (tsv) {
1747             sv_2mortal(tsv);
1748             t = SvPVX(tsv);
1749             len = SvCUR(tsv);
1750         }
1751         else {
1752             t = tokenbuf;
1753             len = strlen(tokenbuf);
1754         }
1755 #ifdef FIXNEGATIVEZERO
1756         if (len == 2 && t[0] == '-' && t[1] == '0') {
1757             t = "0";
1758             len = 1;
1759         }
1760 #endif
1761         (void)SvUPGRADE(sv, SVt_PV);
1762         *lp = len;
1763         s = SvGROW(sv, len + 1);
1764         SvCUR_set(sv, len);
1765         (void)strcpy(s, t);
1766         SvPOKp_on(sv);
1767         return s;
1768     }
1769 }
1770
1771 /* This function is only called on magical items */
1772 bool
1773 sv_2bool(sv)
1774 register SV *sv;
1775 {
1776     if (SvGMAGICAL(sv))
1777         mg_get(sv);
1778
1779     if (!SvOK(sv))
1780         return 0;
1781     if (SvROK(sv)) {
1782 #ifdef OVERLOAD
1783       {
1784         SV* tmpsv;
1785         if (SvAMAGIC(sv) && (tmpsv = AMG_CALLun(sv,bool_)))
1786           return SvTRUE(tmpsv);
1787       }
1788 #endif /* OVERLOAD */
1789       return SvRV(sv) != 0;
1790     }
1791     if (SvPOKp(sv)) {
1792         register XPV* Xpv;
1793         if ((Xpv = (XPV*)SvANY(sv)) &&
1794                 (*Xpv->xpv_pv > '0' ||
1795                 Xpv->xpv_cur > 1 ||
1796                 (Xpv->xpv_cur && *Xpv->xpv_pv != '0')))
1797             return 1;
1798         else
1799             return 0;
1800     }
1801     else {
1802         if (SvIOKp(sv))
1803             return SvIVX(sv) != 0;
1804         else {
1805             if (SvNOKp(sv))
1806                 return SvNVX(sv) != 0.0;
1807             else
1808                 return FALSE;
1809         }
1810     }
1811 }
1812
1813 /* Note: sv_setsv() should not be called with a source string that needs
1814  * to be reused, since it may destroy the source string if it is marked
1815  * as temporary.
1816  */
1817
1818 void
1819 sv_setsv(dstr,sstr)
1820 SV *dstr;
1821 register SV *sstr;
1822 {
1823     register U32 sflags;
1824     register int dtype;
1825     register int stype;
1826
1827     if (sstr == dstr)
1828         return;
1829     if (SvTHINKFIRST(dstr)) {
1830         if (SvREADONLY(dstr) && curcop != &compiling)
1831             croak(no_modify);
1832         if (SvROK(dstr))
1833             sv_unref(dstr);
1834     }
1835     if (!sstr)
1836         sstr = &sv_undef;
1837     stype = SvTYPE(sstr);
1838     dtype = SvTYPE(dstr);
1839
1840     if (dtype == SVt_PVGV && (SvFLAGS(dstr) & SVf_FAKE)) {
1841         sv_unglob(dstr);     /* so fake GLOB won't perpetuate */
1842         sv_setpvn(dstr, "", 0);
1843         (void)SvPOK_only(dstr);
1844         dtype = SvTYPE(dstr);
1845     }
1846
1847 #ifdef OVERLOAD
1848     SvAMAGIC_off(dstr);
1849 #endif /* OVERLOAD */
1850     /* There's a lot of redundancy below but we're going for speed here */
1851
1852     switch (stype) {
1853     case SVt_NULL:
1854         (void)SvOK_off(dstr);
1855         return;
1856     case SVt_IV:
1857         if (dtype != SVt_IV && dtype < SVt_PVIV) {
1858             if (dtype < SVt_IV)
1859                 sv_upgrade(dstr, SVt_IV);
1860             else if (dtype == SVt_NV)
1861                 sv_upgrade(dstr, SVt_PVNV);
1862             else
1863                 sv_upgrade(dstr, SVt_PVIV);
1864         }
1865         break;
1866     case SVt_NV:
1867         if (dtype != SVt_NV && dtype < SVt_PVNV) {
1868             if (dtype < SVt_NV)
1869                 sv_upgrade(dstr, SVt_NV);
1870             else
1871                 sv_upgrade(dstr, SVt_PVNV);
1872         }
1873         break;
1874     case SVt_RV:
1875         if (dtype < SVt_RV)
1876             sv_upgrade(dstr, SVt_RV);
1877         else if (dtype == SVt_PVGV &&
1878                  SvTYPE(SvRV(sstr)) == SVt_PVGV) {
1879             sstr = SvRV(sstr);
1880             if (sstr == dstr) {
1881                 if (curcop->cop_stash != GvSTASH(dstr))
1882                     GvIMPORTED_on(dstr);
1883                 GvMULTI_on(dstr);
1884                 return;
1885             }
1886             goto glob_assign;
1887         }
1888         break;
1889     case SVt_PV:
1890         if (dtype < SVt_PV)
1891             sv_upgrade(dstr, SVt_PV);
1892         break;
1893     case SVt_PVIV:
1894         if (dtype < SVt_PVIV)
1895             sv_upgrade(dstr, SVt_PVIV);
1896         break;
1897     case SVt_PVNV:
1898         if (dtype < SVt_PVNV)
1899             sv_upgrade(dstr, SVt_PVNV);
1900         break;
1901
1902     case SVt_PVLV:
1903         sv_upgrade(dstr, SVt_PVLV);
1904         break;
1905
1906     case SVt_PVAV:
1907     case SVt_PVHV:
1908     case SVt_PVCV:
1909     case SVt_PVIO:
1910         if (op)
1911             croak("Bizarre copy of %s in %s", sv_reftype(sstr, 0),
1912                 op_name[op->op_type]);
1913         else
1914             croak("Bizarre copy of %s", sv_reftype(sstr, 0));
1915         break;
1916
1917     case SVt_PVGV:
1918         if (dtype <= SVt_PVGV) {
1919   glob_assign:
1920             if (dtype != SVt_PVGV) {
1921                 char *name = GvNAME(sstr);
1922                 STRLEN len = GvNAMELEN(sstr);
1923                 sv_upgrade(dstr, SVt_PVGV);
1924                 sv_magic(dstr, dstr, '*', name, len);
1925                 GvSTASH(dstr) = GvSTASH(sstr);
1926                 GvNAME(dstr) = savepvn(name, len);
1927                 GvNAMELEN(dstr) = len;
1928                 SvFAKE_on(dstr);        /* can coerce to non-glob */
1929             }
1930             (void)SvOK_off(dstr);
1931             GvINTRO_off(dstr);          /* one-shot flag */
1932             gp_free((GV*)dstr);
1933             GvGP(dstr) = gp_ref(GvGP(sstr));
1934             SvTAINT(dstr);
1935             if (curcop->cop_stash != GvSTASH(dstr))
1936                 GvIMPORTED_on(dstr);
1937             GvMULTI_on(dstr);
1938             return;
1939         }
1940         /* FALL THROUGH */
1941
1942     default:
1943         if (SvGMAGICAL(sstr)) {
1944             mg_get(sstr);
1945             if (SvTYPE(sstr) != stype) {
1946                 stype = SvTYPE(sstr);
1947                 if (stype == SVt_PVGV && dtype <= SVt_PVGV)
1948                     goto glob_assign;
1949             }
1950         }
1951         if (dtype < stype)
1952             sv_upgrade(dstr, stype);
1953     }
1954
1955     sflags = SvFLAGS(sstr);
1956
1957     if (sflags & SVf_ROK) {
1958         if (dtype >= SVt_PV) {
1959             if (dtype == SVt_PVGV) {
1960                 SV *sref = SvREFCNT_inc(SvRV(sstr));
1961                 SV *dref = 0;
1962                 int intro = GvINTRO(dstr);
1963
1964                 if (intro) {
1965                     GP *gp;
1966                     GvGP(dstr)->gp_refcnt--;
1967                     GvINTRO_off(dstr);  /* one-shot flag */
1968                     Newz(602,gp, 1, GP);
1969                     GvGP(dstr) = gp_ref(gp);
1970                     GvSV(dstr) = NEWSV(72,0);
1971                     GvLINE(dstr) = curcop->cop_line;
1972                     GvEGV(dstr) = (GV*)dstr;
1973                 }
1974                 GvMULTI_on(dstr);
1975                 switch (SvTYPE(sref)) {
1976                 case SVt_PVAV:
1977                     if (intro)
1978                         SAVESPTR(GvAV(dstr));
1979                     else
1980                         dref = (SV*)GvAV(dstr);
1981                     GvAV(dstr) = (AV*)sref;
1982                     if (curcop->cop_stash != GvSTASH(dstr))
1983                         GvIMPORTED_AV_on(dstr);
1984                     break;
1985                 case SVt_PVHV:
1986                     if (intro)
1987                         SAVESPTR(GvHV(dstr));
1988                     else
1989                         dref = (SV*)GvHV(dstr);
1990                     GvHV(dstr) = (HV*)sref;
1991                     if (curcop->cop_stash != GvSTASH(dstr))
1992                         GvIMPORTED_HV_on(dstr);
1993                     break;
1994                 case SVt_PVCV:
1995                     if (intro) {
1996                         if (GvCVGEN(dstr) && GvCV(dstr) != (CV*)sref) {
1997                             SvREFCNT_dec(GvCV(dstr));
1998                             GvCV(dstr) = Nullcv;
1999                             GvCVGEN(dstr) = 0; /* Switch off cacheness. */
2000                             sub_generation++;
2001                         }
2002                         SAVESPTR(GvCV(dstr));
2003                     }
2004                     else
2005                         dref = (SV*)GvCV(dstr);
2006                     if (GvCV(dstr) != (CV*)sref) {
2007                         CV* cv = GvCV(dstr);
2008                         if (cv) {
2009                             if (!GvCVGEN((GV*)dstr) &&
2010                                 (CvROOT(cv) || CvXSUB(cv)))
2011                             {
2012                                 if (cv_const_sv(cv))
2013                                     warn("Constant subroutine %s redefined",
2014                                          GvENAME((GV*)dstr));
2015                                 else if (dowarn)
2016                                     warn("Subroutine %s redefined",
2017                                          GvENAME((GV*)dstr));
2018                             }
2019                             cv_ckproto(cv, (GV*)dstr,
2020                                        SvPOK(sref) ? SvPVX(sref) : Nullch);
2021                         }
2022                         GvCV(dstr) = (CV*)sref;
2023                         GvCVGEN(dstr) = 0; /* Switch off cacheness. */
2024                         GvASSUMECV_on(dstr);
2025                         sub_generation++;
2026                     }
2027                     if (curcop->cop_stash != GvSTASH(dstr))
2028                         GvIMPORTED_CV_on(dstr);
2029                     break;
2030                 case SVt_PVIO:
2031                     if (intro)
2032                         SAVESPTR(GvIOp(dstr));
2033                     else
2034                         dref = (SV*)GvIOp(dstr);
2035                     GvIOp(dstr) = (IO*)sref;
2036                     break;
2037                 default:
2038                     if (intro)
2039                         SAVESPTR(GvSV(dstr));
2040                     else
2041                         dref = (SV*)GvSV(dstr);
2042                     GvSV(dstr) = sref;
2043                     if (curcop->cop_stash != GvSTASH(dstr))
2044                         GvIMPORTED_SV_on(dstr);
2045                     break;
2046                 }
2047                 if (dref)
2048                     SvREFCNT_dec(dref);
2049                 if (intro)
2050                     SAVEFREESV(sref);
2051                 SvTAINT(dstr);
2052                 return;
2053             }
2054             if (SvPVX(dstr)) {
2055                 (void)SvOOK_off(dstr);          /* backoff */
2056                 Safefree(SvPVX(dstr));
2057                 SvLEN(dstr)=SvCUR(dstr)=0;
2058             }
2059         }
2060         (void)SvOK_off(dstr);
2061         SvRV(dstr) = SvREFCNT_inc(SvRV(sstr));
2062         SvROK_on(dstr);
2063         if (sflags & SVp_NOK) {
2064             SvNOK_on(dstr);
2065             SvNVX(dstr) = SvNVX(sstr);
2066         }
2067         if (sflags & SVp_IOK) {
2068             (void)SvIOK_on(dstr);
2069             SvIVX(dstr) = SvIVX(sstr);
2070         }
2071 #ifdef OVERLOAD
2072         if (SvAMAGIC(sstr)) {
2073             SvAMAGIC_on(dstr);
2074         }
2075 #endif /* OVERLOAD */
2076     }
2077     else if (sflags & SVp_POK) {
2078
2079         /*
2080          * Check to see if we can just swipe the string.  If so, it's a
2081          * possible small lose on short strings, but a big win on long ones.
2082          * It might even be a win on short strings if SvPVX(dstr)
2083          * has to be allocated and SvPVX(sstr) has to be freed.
2084          */
2085
2086         if (SvTEMP(sstr) &&             /* slated for free anyway? */
2087             !(sflags & SVf_OOK))        /* and not involved in OOK hack? */
2088         {
2089             if (SvPVX(dstr)) {          /* we know that dtype >= SVt_PV */
2090                 if (SvOOK(dstr)) {
2091                     SvFLAGS(dstr) &= ~SVf_OOK;
2092                     Safefree(SvPVX(dstr) - SvIVX(dstr));
2093                 }
2094                 else
2095                     Safefree(SvPVX(dstr));
2096             }
2097             (void)SvPOK_only(dstr);
2098             SvPV_set(dstr, SvPVX(sstr));
2099             SvLEN_set(dstr, SvLEN(sstr));
2100             SvCUR_set(dstr, SvCUR(sstr));
2101             SvTEMP_off(dstr);
2102             (void)SvOK_off(sstr);
2103             SvPV_set(sstr, Nullch);
2104             SvLEN_set(sstr, 0);
2105             SvCUR_set(sstr, 0);
2106             SvTEMP_off(sstr);
2107         }
2108         else {                                  /* have to copy actual string */
2109             STRLEN len = SvCUR(sstr);
2110
2111             SvGROW(dstr, len + 1);              /* inlined from sv_setpvn */
2112             Move(SvPVX(sstr),SvPVX(dstr),len,char);
2113             SvCUR_set(dstr, len);
2114             *SvEND(dstr) = '\0';
2115             (void)SvPOK_only(dstr);
2116         }
2117         /*SUPPRESS 560*/
2118         if (sflags & SVp_NOK) {
2119             SvNOK_on(dstr);
2120             SvNVX(dstr) = SvNVX(sstr);
2121         }
2122         if (sflags & SVp_IOK) {
2123             (void)SvIOK_on(dstr);
2124             SvIVX(dstr) = SvIVX(sstr);
2125         }
2126     }
2127     else if (sflags & SVp_NOK) {
2128         SvNVX(dstr) = SvNVX(sstr);
2129         (void)SvNOK_only(dstr);
2130         if (SvIOK(sstr)) {
2131             (void)SvIOK_on(dstr);
2132             SvIVX(dstr) = SvIVX(sstr);
2133         }
2134     }
2135     else if (sflags & SVp_IOK) {
2136         (void)SvIOK_only(dstr);
2137         SvIVX(dstr) = SvIVX(sstr);
2138     }
2139     else {
2140         (void)SvOK_off(dstr);
2141     }
2142     SvTAINT(dstr);
2143 }
2144
2145 void
2146 sv_setpvn(sv,ptr,len)
2147 register SV *sv;
2148 register const char *ptr;
2149 register STRLEN len;
2150 {
2151     assert(len >= 0);  /* STRLEN is probably unsigned, so this may
2152                           elicit a warning, but it won't hurt. */
2153     if (SvTHINKFIRST(sv)) {
2154         if (SvREADONLY(sv) && curcop != &compiling)
2155             croak(no_modify);
2156         if (SvROK(sv))
2157             sv_unref(sv);
2158     }
2159     if (!ptr) {
2160         (void)SvOK_off(sv);
2161         return;
2162     }
2163     if (SvTYPE(sv) >= SVt_PV) {
2164         if (SvFAKE(sv) && SvTYPE(sv) == SVt_PVGV)
2165             sv_unglob(sv);
2166     }
2167     else if (!sv_upgrade(sv, SVt_PV))
2168         return;
2169     SvGROW(sv, len + 1);
2170     Move(ptr,SvPVX(sv),len,char);
2171     SvCUR_set(sv, len);
2172     *SvEND(sv) = '\0';
2173     (void)SvPOK_only(sv);               /* validate pointer */
2174     SvTAINT(sv);
2175 }
2176
2177 void
2178 sv_setpv(sv,ptr)
2179 register SV *sv;
2180 register const char *ptr;
2181 {
2182     register STRLEN len;
2183
2184     if (SvTHINKFIRST(sv)) {
2185         if (SvREADONLY(sv) && curcop != &compiling)
2186             croak(no_modify);
2187         if (SvROK(sv))
2188             sv_unref(sv);
2189     }
2190     if (!ptr) {
2191         (void)SvOK_off(sv);
2192         return;
2193     }
2194     len = strlen(ptr);
2195     if (SvTYPE(sv) >= SVt_PV) {
2196         if (SvFAKE(sv) && SvTYPE(sv) == SVt_PVGV)
2197             sv_unglob(sv);
2198     }
2199     else if (!sv_upgrade(sv, SVt_PV))
2200         return;
2201     SvGROW(sv, len + 1);
2202     Move(ptr,SvPVX(sv),len+1,char);
2203     SvCUR_set(sv, len);
2204     (void)SvPOK_only(sv);               /* validate pointer */
2205     SvTAINT(sv);
2206 }
2207
2208 void
2209 sv_usepvn(sv,ptr,len)
2210 register SV *sv;
2211 register char *ptr;
2212 register STRLEN len;
2213 {
2214     if (SvTHINKFIRST(sv)) {
2215         if (SvREADONLY(sv) && curcop != &compiling)
2216             croak(no_modify);
2217         if (SvROK(sv))
2218             sv_unref(sv);
2219     }
2220     if (!SvUPGRADE(sv, SVt_PV))
2221         return;
2222     if (!ptr) {
2223         (void)SvOK_off(sv);
2224         return;
2225     }
2226     if (SvPVX(sv))
2227         Safefree(SvPVX(sv));
2228     Renew(ptr, len+1, char);
2229     SvPVX(sv) = ptr;
2230     SvCUR_set(sv, len);
2231     SvLEN_set(sv, len+1);
2232     *SvEND(sv) = '\0';
2233     (void)SvPOK_only(sv);               /* validate pointer */
2234     SvTAINT(sv);
2235 }
2236
2237 void
2238 sv_chop(sv,ptr) /* like set but assuming ptr is in sv */
2239 register SV *sv;
2240 register char *ptr;
2241 {
2242     register STRLEN delta;
2243
2244     if (!ptr || !SvPOKp(sv))
2245         return;
2246     if (SvTHINKFIRST(sv)) {
2247         if (SvREADONLY(sv) && curcop != &compiling)
2248             croak(no_modify);
2249         if (SvROK(sv))
2250             sv_unref(sv);
2251     }
2252     if (SvTYPE(sv) < SVt_PVIV)
2253         sv_upgrade(sv,SVt_PVIV);
2254
2255     if (!SvOOK(sv)) {
2256         SvIVX(sv) = 0;
2257         SvFLAGS(sv) |= SVf_OOK;
2258     }
2259     SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVp_IOK|SVp_NOK);
2260     delta = ptr - SvPVX(sv);
2261     SvLEN(sv) -= delta;
2262     SvCUR(sv) -= delta;
2263     SvPVX(sv) += delta;
2264     SvIVX(sv) += delta;
2265 }
2266
2267 void
2268 sv_catpvn(sv,ptr,len)
2269 register SV *sv;
2270 register char *ptr;
2271 register STRLEN len;
2272 {
2273     STRLEN tlen;
2274     char *junk;
2275
2276     junk = SvPV_force(sv, tlen);
2277     SvGROW(sv, tlen + len + 1);
2278     if (ptr == junk)
2279         ptr = SvPVX(sv);
2280     Move(ptr,SvPVX(sv)+tlen,len,char);
2281     SvCUR(sv) += len;
2282     *SvEND(sv) = '\0';
2283     (void)SvPOK_only(sv);               /* validate pointer */
2284     SvTAINT(sv);
2285 }
2286
2287 void
2288 sv_catsv(dstr,sstr)
2289 SV *dstr;
2290 register SV *sstr;
2291 {
2292     char *s;
2293     STRLEN len;
2294     if (!sstr)
2295         return;
2296     if (s = SvPV(sstr, len))
2297         sv_catpvn(dstr,s,len);
2298 }
2299
2300 void
2301 sv_catpv(sv,ptr)
2302 register SV *sv;
2303 register char *ptr;
2304 {
2305     register STRLEN len;
2306     STRLEN tlen;
2307     char *junk;
2308
2309     if (!ptr)
2310         return;
2311     junk = SvPV_force(sv, tlen);
2312     len = strlen(ptr);
2313     SvGROW(sv, tlen + len + 1);
2314     if (ptr == junk)
2315         ptr = SvPVX(sv);
2316     Move(ptr,SvPVX(sv)+tlen,len+1,char);
2317     SvCUR(sv) += len;
2318     (void)SvPOK_only(sv);               /* validate pointer */
2319     SvTAINT(sv);
2320 }
2321
2322 SV *
2323 #ifdef LEAKTEST
2324 newSV(x,len)
2325 I32 x;
2326 #else
2327 newSV(len)
2328 #endif
2329 STRLEN len;
2330 {
2331     register SV *sv;
2332     
2333     new_SV(sv);
2334     SvANY(sv) = 0;
2335     SvREFCNT(sv) = 1;
2336     SvFLAGS(sv) = 0;
2337     if (len) {
2338         sv_upgrade(sv, SVt_PV);
2339         SvGROW(sv, len + 1);
2340     }
2341     return sv;
2342 }
2343
2344 /* name is assumed to contain an SV* if (name && namelen == HEf_SVKEY) */
2345
2346 void
2347 sv_magic(sv, obj, how, name, namlen)
2348 register SV *sv;
2349 SV *obj;
2350 int how;
2351 char *name;
2352 I32 namlen;
2353 {
2354     MAGIC* mg;
2355     
2356     if (SvREADONLY(sv) && curcop != &compiling && !strchr("gBf", how))
2357         croak(no_modify);
2358     if (SvMAGICAL(sv) || (how == 't' && SvTYPE(sv) >= SVt_PVMG)) {
2359         if (SvMAGIC(sv) && (mg = mg_find(sv, how))) {
2360             if (how == 't')
2361                 mg->mg_len |= 1;
2362             return;
2363         }
2364     }
2365     else {
2366         if (!SvUPGRADE(sv, SVt_PVMG))
2367             return;
2368     }
2369     Newz(702,mg, 1, MAGIC);
2370     mg->mg_moremagic = SvMAGIC(sv);
2371
2372     SvMAGIC(sv) = mg;
2373     if (!obj || obj == sv || how == '#')
2374         mg->mg_obj = obj;
2375     else {
2376         mg->mg_obj = SvREFCNT_inc(obj);
2377         mg->mg_flags |= MGf_REFCOUNTED;
2378     }
2379     mg->mg_type = how;
2380     mg->mg_len = namlen;
2381     if (name)
2382         if (namlen >= 0)
2383             mg->mg_ptr = savepvn(name, namlen);
2384         else if (namlen == HEf_SVKEY)
2385             mg->mg_ptr = (char*)SvREFCNT_inc((SV*)name);
2386     
2387     switch (how) {
2388     case 0:
2389         mg->mg_virtual = &vtbl_sv;
2390         break;
2391 #ifdef OVERLOAD
2392     case 'A':
2393         mg->mg_virtual = &vtbl_amagic;
2394         break;
2395     case 'a':
2396         mg->mg_virtual = &vtbl_amagicelem;
2397         break;
2398     case 'c':
2399         mg->mg_virtual = 0;
2400         break;
2401 #endif /* OVERLOAD */
2402     case 'B':
2403         mg->mg_virtual = &vtbl_bm;
2404         break;
2405     case 'E':
2406         mg->mg_virtual = &vtbl_env;
2407         break;
2408     case 'f':
2409         mg->mg_virtual = &vtbl_fm;
2410         break;
2411     case 'e':
2412         mg->mg_virtual = &vtbl_envelem;
2413         break;
2414     case 'g':
2415         mg->mg_virtual = &vtbl_mglob;
2416         break;
2417     case 'I':
2418         mg->mg_virtual = &vtbl_isa;
2419         break;
2420     case 'i':
2421         mg->mg_virtual = &vtbl_isaelem;
2422         break;
2423     case 'k':
2424         mg->mg_virtual = &vtbl_nkeys;
2425         break;
2426     case 'L':
2427         SvRMAGICAL_on(sv);
2428         mg->mg_virtual = 0;
2429         break;
2430     case 'l':
2431         mg->mg_virtual = &vtbl_dbline;
2432         break;
2433 #ifdef USE_LOCALE_COLLATE
2434     case 'o':
2435         mg->mg_virtual = &vtbl_collxfrm;
2436         break;
2437 #endif /* USE_LOCALE_COLLATE */
2438     case 'P':
2439         mg->mg_virtual = &vtbl_pack;
2440         break;
2441     case 'p':
2442     case 'q':
2443         mg->mg_virtual = &vtbl_packelem;
2444         break;
2445     case 'S':
2446         mg->mg_virtual = &vtbl_sig;
2447         break;
2448     case 's':
2449         mg->mg_virtual = &vtbl_sigelem;
2450         break;
2451     case 't':
2452         mg->mg_virtual = &vtbl_taint;
2453         mg->mg_len = 1;
2454         break;
2455     case 'U':
2456         mg->mg_virtual = &vtbl_uvar;
2457         break;
2458     case 'v':
2459         mg->mg_virtual = &vtbl_vec;
2460         break;
2461     case 'x':
2462         mg->mg_virtual = &vtbl_substr;
2463         break;
2464     case 'y':
2465         mg->mg_virtual = &vtbl_defelem;
2466         break;
2467     case '*':
2468         mg->mg_virtual = &vtbl_glob;
2469         break;
2470     case '#':
2471         mg->mg_virtual = &vtbl_arylen;
2472         break;
2473     case '.':
2474         mg->mg_virtual = &vtbl_pos;
2475         break;
2476     case '~':   /* Reserved for use by extensions not perl internals.   */
2477         /* Useful for attaching extension internal data to perl vars.   */
2478         /* Note that multiple extensions may clash if magical scalars   */
2479         /* etc holding private data from one are passed to another.     */
2480         SvRMAGICAL_on(sv);
2481         break;
2482     default:
2483         croak("Don't know how to handle magic of type '%c'", how);
2484     }
2485     mg_magical(sv);
2486     if (SvGMAGICAL(sv))
2487         SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVf_POK);
2488 }
2489
2490 int
2491 sv_unmagic(sv, type)
2492 SV* sv;
2493 int type;
2494 {
2495     MAGIC* mg;
2496     MAGIC** mgp;
2497     if (SvTYPE(sv) < SVt_PVMG || !SvMAGIC(sv))
2498         return 0;
2499     mgp = &SvMAGIC(sv);
2500     for (mg = *mgp; mg; mg = *mgp) {
2501         if (mg->mg_type == type) {
2502             MGVTBL* vtbl = mg->mg_virtual;
2503             *mgp = mg->mg_moremagic;
2504             if (vtbl && vtbl->svt_free)
2505                 (*vtbl->svt_free)(sv, mg);
2506             if (mg->mg_ptr && mg->mg_type != 'g')
2507                 if (mg->mg_len >= 0)
2508                     Safefree(mg->mg_ptr);
2509                 else if (mg->mg_len == HEf_SVKEY)
2510                     SvREFCNT_dec((SV*)mg->mg_ptr);
2511             if (mg->mg_flags & MGf_REFCOUNTED)
2512                 SvREFCNT_dec(mg->mg_obj);
2513             Safefree(mg);
2514         }
2515         else
2516             mgp = &mg->mg_moremagic;
2517     }
2518     if (!SvMAGIC(sv)) {
2519         SvMAGICAL_off(sv);
2520         SvFLAGS(sv) |= (SvFLAGS(sv) & (SVp_IOK|SVp_NOK|SVp_POK)) >> PRIVSHIFT;
2521     }
2522
2523     return 0;
2524 }
2525
2526 void
2527 sv_insert(bigstr,offset,len,little,littlelen)
2528 SV *bigstr;
2529 STRLEN offset;
2530 STRLEN len;
2531 char *little;
2532 STRLEN littlelen;
2533 {
2534     register char *big;
2535     register char *mid;
2536     register char *midend;
2537     register char *bigend;
2538     register I32 i;
2539
2540     if (!bigstr)
2541         croak("Can't modify non-existent substring");
2542     SvPV_force(bigstr, na);
2543
2544     i = littlelen - len;
2545     if (i > 0) {                        /* string might grow */
2546         big = SvGROW(bigstr, SvCUR(bigstr) + i + 1);
2547         mid = big + offset + len;
2548         midend = bigend = big + SvCUR(bigstr);
2549         bigend += i;
2550         *bigend = '\0';
2551         while (midend > mid)            /* shove everything down */
2552             *--bigend = *--midend;
2553         Move(little,big+offset,littlelen,char);
2554         SvCUR(bigstr) += i;
2555         SvSETMAGIC(bigstr);
2556         return;
2557     }
2558     else if (i == 0) {
2559         Move(little,SvPVX(bigstr)+offset,len,char);
2560         SvSETMAGIC(bigstr);
2561         return;
2562     }
2563
2564     big = SvPVX(bigstr);
2565     mid = big + offset;
2566     midend = mid + len;
2567     bigend = big + SvCUR(bigstr);
2568
2569     if (midend > bigend)
2570         croak("panic: sv_insert");
2571
2572     if (mid - big > bigend - midend) {  /* faster to shorten from end */
2573         if (littlelen) {
2574             Move(little, mid, littlelen,char);
2575             mid += littlelen;
2576         }
2577         i = bigend - midend;
2578         if (i > 0) {
2579             Move(midend, mid, i,char);
2580             mid += i;
2581         }
2582         *mid = '\0';
2583         SvCUR_set(bigstr, mid - big);
2584     }
2585     /*SUPPRESS 560*/
2586     else if (i = mid - big) {   /* faster from front */
2587         midend -= littlelen;
2588         mid = midend;
2589         sv_chop(bigstr,midend-i);
2590         big += i;
2591         while (i--)
2592             *--midend = *--big;
2593         if (littlelen)
2594             Move(little, mid, littlelen,char);
2595     }
2596     else if (littlelen) {
2597         midend -= littlelen;
2598         sv_chop(bigstr,midend);
2599         Move(little,midend,littlelen,char);
2600     }
2601     else {
2602         sv_chop(bigstr,midend);
2603     }
2604     SvSETMAGIC(bigstr);
2605 }
2606
2607 /* make sv point to what nstr did */
2608
2609 void
2610 sv_replace(sv,nsv)
2611 register SV *sv;
2612 register SV *nsv;
2613 {
2614     U32 refcnt = SvREFCNT(sv);
2615     if (SvTHINKFIRST(sv)) {
2616         if (SvREADONLY(sv) && curcop != &compiling)
2617             croak(no_modify);
2618         if (SvROK(sv))
2619             sv_unref(sv);
2620     }
2621     if (SvREFCNT(nsv) != 1)
2622         warn("Reference miscount in sv_replace()");
2623     if (SvMAGICAL(sv)) {
2624         if (SvMAGICAL(nsv))
2625             mg_free(nsv);
2626         else
2627             sv_upgrade(nsv, SVt_PVMG);
2628         SvMAGIC(nsv) = SvMAGIC(sv);
2629         SvFLAGS(nsv) |= SvMAGICAL(sv);
2630         SvMAGICAL_off(sv);
2631         SvMAGIC(sv) = 0;
2632     }
2633     SvREFCNT(sv) = 0;
2634     sv_clear(sv);
2635     assert(!SvREFCNT(sv));
2636     StructCopy(nsv,sv,SV);
2637     SvREFCNT(sv) = refcnt;
2638     SvFLAGS(nsv) |= SVTYPEMASK;         /* Mark as freed */
2639     del_SV(nsv);
2640 }
2641
2642 void
2643 sv_clear(sv)
2644 register SV *sv;
2645 {
2646     assert(sv);
2647     assert(SvREFCNT(sv) == 0);
2648
2649     if (SvOBJECT(sv)) {
2650         if (defstash) {         /* Still have a symbol table? */
2651             dSP;
2652             GV* destructor;
2653
2654             ENTER;
2655             SAVEFREESV(SvSTASH(sv));
2656
2657             destructor = gv_fetchmethod(SvSTASH(sv), "DESTROY");
2658             if (destructor) {
2659                 SV ref;
2660
2661                 Zero(&ref, 1, SV);
2662                 sv_upgrade(&ref, SVt_RV);
2663                 SvRV(&ref) = SvREFCNT_inc(sv);
2664                 SvROK_on(&ref);
2665                 SvREFCNT(&ref) = 1;     /* Fake, but otherwise
2666                                            creating+destructing a ref
2667                                            leads to disaster. */
2668
2669                 EXTEND(SP, 2);
2670                 PUSHMARK(SP);
2671                 PUSHs(&ref);
2672                 PUTBACK;
2673                 perl_call_sv((SV*)GvCV(destructor),
2674                              G_DISCARD|G_EVAL|G_KEEPERR);
2675                 del_XRV(SvANY(&ref));
2676                 SvREFCNT(sv)--;
2677             }
2678
2679             LEAVE;
2680         }
2681         else
2682             SvREFCNT_dec(SvSTASH(sv));
2683         if (SvOBJECT(sv)) {
2684             SvOBJECT_off(sv);   /* Curse the object. */
2685             if (SvTYPE(sv) != SVt_PVIO)
2686                 --sv_objcount;  /* XXX Might want something more general */
2687         }
2688         if (SvREFCNT(sv)) {
2689             SV *ret;
2690             if ( perldb
2691                  && (ret = perl_get_sv("DB::ret", FALSE))
2692                  && SvROK(ret) && SvRV(ret) == sv && SvREFCNT(sv) == 1) {
2693                 /* Debugger is prone to dangling references. */
2694                 SvRV(ret) = 0;
2695                 SvROK_off(ret);
2696                 SvREFCNT(sv) = 0;
2697             }
2698             else {
2699                 if (in_clean_objs)
2700                     croak("DESTROY created new reference to dead object");
2701                 /* DESTROY gave object new lease on life */
2702                 return;
2703             }
2704         }
2705     }
2706     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv))
2707         mg_free(sv);
2708     switch (SvTYPE(sv)) {
2709     case SVt_PVIO:
2710         if (IoIFP(sv) != PerlIO_stdin() &&
2711             IoIFP(sv) != PerlIO_stdout() &&
2712             IoIFP(sv) != PerlIO_stderr())
2713           io_close((IO*)sv);
2714         Safefree(IoTOP_NAME(sv));
2715         Safefree(IoFMT_NAME(sv));
2716         Safefree(IoBOTTOM_NAME(sv));
2717         /* FALL THROUGH */
2718     case SVt_PVBM:
2719         goto freescalar;
2720     case SVt_PVCV:
2721     case SVt_PVFM:
2722         cv_undef((CV*)sv);
2723         goto freescalar;
2724     case SVt_PVHV:
2725         hv_undef((HV*)sv);
2726         break;
2727     case SVt_PVAV:
2728         av_undef((AV*)sv);
2729         break;
2730     case SVt_PVGV:
2731         gp_free((GV*)sv);
2732         Safefree(GvNAME(sv));
2733         /* FALL THROUGH */
2734     case SVt_PVLV:
2735     case SVt_PVMG:
2736     case SVt_PVNV:
2737     case SVt_PVIV:
2738       freescalar:
2739         (void)SvOOK_off(sv);
2740         /* FALL THROUGH */
2741     case SVt_PV:
2742     case SVt_RV:
2743         if (SvROK(sv))
2744             SvREFCNT_dec(SvRV(sv));
2745         else if (SvPVX(sv) && SvLEN(sv))
2746             Safefree(SvPVX(sv));
2747         break;
2748 /*
2749     case SVt_NV:
2750     case SVt_IV:
2751     case SVt_NULL:
2752         break;
2753 */
2754     }
2755
2756     switch (SvTYPE(sv)) {
2757     case SVt_NULL:
2758         break;
2759     case SVt_IV:
2760         del_XIV(SvANY(sv));
2761         break;
2762     case SVt_NV:
2763         del_XNV(SvANY(sv));
2764         break;
2765     case SVt_RV:
2766         del_XRV(SvANY(sv));
2767         break;
2768     case SVt_PV:
2769         del_XPV(SvANY(sv));
2770         break;
2771     case SVt_PVIV:
2772         del_XPVIV(SvANY(sv));
2773         break;
2774     case SVt_PVNV:
2775         del_XPVNV(SvANY(sv));
2776         break;
2777     case SVt_PVMG:
2778         del_XPVMG(SvANY(sv));
2779         break;
2780     case SVt_PVLV:
2781         del_XPVLV(SvANY(sv));
2782         break;
2783     case SVt_PVAV:
2784         del_XPVAV(SvANY(sv));
2785         break;
2786     case SVt_PVHV:
2787         del_XPVHV(SvANY(sv));
2788         break;
2789     case SVt_PVCV:
2790         del_XPVCV(SvANY(sv));
2791         break;
2792     case SVt_PVGV:
2793         del_XPVGV(SvANY(sv));
2794         break;
2795     case SVt_PVBM:
2796         del_XPVBM(SvANY(sv));
2797         break;
2798     case SVt_PVFM:
2799         del_XPVFM(SvANY(sv));
2800         break;
2801     case SVt_PVIO:
2802         del_XPVIO(SvANY(sv));
2803         break;
2804     }
2805     SvFLAGS(sv) &= SVf_BREAK;
2806     SvFLAGS(sv) |= SVTYPEMASK;
2807 }
2808
2809 SV *
2810 sv_newref(sv)
2811 SV* sv;
2812 {
2813     if (sv)
2814         SvREFCNT(sv)++;
2815     return sv;
2816 }
2817
2818 void
2819 sv_free(sv)
2820 SV *sv;
2821 {
2822     if (!sv)
2823         return;
2824     if (SvREADONLY(sv)) {
2825         if (sv == &sv_undef || sv == &sv_yes || sv == &sv_no)
2826             return;
2827     }
2828     if (SvREFCNT(sv) == 0) {
2829         if (SvFLAGS(sv) & SVf_BREAK)
2830             return;
2831         if (in_clean_all) /* All is fair */
2832             return;
2833         warn("Attempt to free unreferenced scalar");
2834         return;
2835     }
2836     if (--SvREFCNT(sv) > 0)
2837         return;
2838 #ifdef DEBUGGING
2839     if (SvTEMP(sv)) {
2840         warn("Attempt to free temp prematurely");
2841         return;
2842     }
2843 #endif
2844     sv_clear(sv);
2845     if (! SvREFCNT(sv))
2846         del_SV(sv);
2847 }
2848
2849 STRLEN
2850 sv_len(sv)
2851 register SV *sv;
2852 {
2853     char *junk;
2854     STRLEN len;
2855
2856     if (!sv)
2857         return 0;
2858
2859     if (SvGMAGICAL(sv))
2860         len = mg_len(sv);
2861     else
2862         junk = SvPV(sv, len);
2863     return len;
2864 }
2865
2866 I32
2867 sv_eq(str1,str2)
2868 register SV *str1;
2869 register SV *str2;
2870 {
2871     char *pv1;
2872     STRLEN cur1;
2873     char *pv2;
2874     STRLEN cur2;
2875
2876     if (!str1) {
2877         pv1 = "";
2878         cur1 = 0;
2879     }
2880     else
2881         pv1 = SvPV(str1, cur1);
2882
2883     if (!str2)
2884         return !cur1;
2885     else
2886         pv2 = SvPV(str2, cur2);
2887
2888     if (cur1 != cur2)
2889         return 0;
2890
2891     return memEQ(pv1, pv2, cur1);
2892 }
2893
2894 I32
2895 sv_cmp(str1, str2)
2896 register SV *str1;
2897 register SV *str2;
2898 {
2899     STRLEN cur1 = 0;
2900     char *pv1 = str1 ? SvPV(str1, cur1) : NULL;
2901     STRLEN cur2 = 0;
2902     char *pv2 = str2 ? SvPV(str2, cur2) : NULL;
2903     I32 retval;
2904
2905     if (!cur1)
2906         return cur2 ? -1 : 0;
2907
2908     if (!cur2)
2909         return 1;
2910
2911     retval = memcmp((void*)pv1, (void*)pv2, cur1 < cur2 ? cur1 : cur2);
2912
2913     if (retval)
2914         return retval < 0 ? -1 : 1;
2915
2916     if (cur1 == cur2)
2917         return 0;
2918     else
2919         return cur1 < cur2 ? -1 : 1;
2920 }
2921
2922 I32
2923 sv_cmp_locale(sv1, sv2)
2924 register SV *sv1;
2925 register SV *sv2;
2926 {
2927 #ifdef USE_LOCALE_COLLATE
2928
2929     char *pv1, *pv2;
2930     STRLEN len1, len2;
2931     I32 retval;
2932
2933     if (collation_standard)
2934         goto raw_compare;
2935
2936     len1 = 0;
2937     pv1 = sv1 ? sv_collxfrm(sv1, &len1) : NULL;
2938     len2 = 0;
2939     pv2 = sv2 ? sv_collxfrm(sv2, &len2) : NULL;
2940
2941     if (!pv1 || !len1) {
2942         if (pv2 && len2)
2943             return -1;
2944         else
2945             goto raw_compare;
2946     }
2947     else {
2948         if (!pv2 || !len2)
2949             return 1;
2950     }
2951
2952     retval = memcmp((void*)pv1, (void*)pv2, len1 < len2 ? len1 : len2);
2953
2954     if (retval)
2955         return retval < 0 ? -1 : 1;
2956
2957     /*
2958      * When the result of collation is equality, that doesn't mean
2959      * that there are no differences -- some locales exclude some
2960      * characters from consideration.  So to avoid false equalities,
2961      * we use the raw string as a tiebreaker.
2962      */
2963
2964   raw_compare:
2965     /* FALL THROUGH */
2966
2967 #endif /* USE_LOCALE_COLLATE */
2968
2969     return sv_cmp(sv1, sv2);
2970 }
2971
2972 #ifdef USE_LOCALE_COLLATE
2973 /*
2974  * Any scalar variable may carry an 'o' magic that contains the
2975  * scalar data of the variable transformed to such a format that
2976  * a normal memory comparison can be used to compare the data
2977  * according to the locale settings.
2978  */
2979 char *
2980 sv_collxfrm(sv, nxp)
2981      SV *sv;
2982      STRLEN *nxp;
2983 {
2984     MAGIC *mg;
2985
2986     mg = SvMAGICAL(sv) ? mg_find(sv, 'o') : NULL;
2987     if (!mg || !mg->mg_ptr || *(U32*)mg->mg_ptr != collation_ix) {
2988         char *s, *xf;
2989         STRLEN len, xlen;
2990
2991         if (mg)
2992             Safefree(mg->mg_ptr);
2993         s = SvPV(sv, len);
2994         if ((xf = mem_collxfrm(s, len, &xlen))) {
2995             if (SvREADONLY(sv)) {
2996                 SAVEFREEPV(xf);
2997                 *nxp = xlen;
2998                 return xf;
2999             }
3000             if (! mg) {
3001                 sv_magic(sv, 0, 'o', 0, 0);
3002                 mg = mg_find(sv, 'o');
3003                 assert(mg);
3004             }
3005             mg->mg_ptr = xf;
3006             mg->mg_len = xlen;
3007         }
3008         else {
3009             if (mg) {
3010                 mg->mg_ptr = NULL;
3011                 mg->mg_len = -1;
3012             }
3013         }
3014     }
3015     if (mg && mg->mg_ptr) {
3016         *nxp = mg->mg_len;
3017         return mg->mg_ptr + sizeof(collation_ix);
3018     }
3019     else {
3020         *nxp = 0;
3021         return NULL;
3022     }
3023 }
3024
3025 #endif /* USE_LOCALE_COLLATE */
3026
3027 char *
3028 sv_gets(sv,fp,append)
3029 register SV *sv;
3030 register PerlIO *fp;
3031 I32 append;
3032 {
3033     char *rsptr;
3034     STRLEN rslen;
3035     register STDCHAR rslast;
3036     register STDCHAR *bp;
3037     register I32 cnt;
3038     I32 i;
3039
3040     if (SvTHINKFIRST(sv)) {
3041         if (SvREADONLY(sv) && curcop != &compiling)
3042             croak(no_modify);
3043         if (SvROK(sv))
3044             sv_unref(sv);
3045     }
3046     if (!SvUPGRADE(sv, SVt_PV))
3047         return 0;
3048     SvSCREAM_off(sv);
3049
3050     if (RsSNARF(rs)) {
3051         rsptr = NULL;
3052         rslen = 0;
3053     }
3054     else if (RsPARA(rs)) {
3055         rsptr = "\n\n";
3056         rslen = 2;
3057     }
3058     else
3059         rsptr = SvPV(rs, rslen);
3060     rslast = rslen ? rsptr[rslen - 1] : '\0';
3061
3062     if (RsPARA(rs)) {           /* have to do this both before and after */
3063         do {                    /* to make sure file boundaries work right */
3064             if (PerlIO_eof(fp))
3065                 return 0;
3066             i = PerlIO_getc(fp);
3067             if (i != '\n') {
3068                 if (i == -1)
3069                     return 0;
3070                 PerlIO_ungetc(fp,i);
3071                 break;
3072             }
3073         } while (i != EOF);
3074     }
3075
3076     /* See if we know enough about I/O mechanism to cheat it ! */
3077
3078     /* This used to be #ifdef test - it is made run-time test for ease
3079        of abstracting out stdio interface. One call should be cheap 
3080        enough here - and may even be a macro allowing compile
3081        time optimization.
3082      */
3083
3084     if (PerlIO_fast_gets(fp)) {
3085
3086     /*
3087      * We're going to steal some values from the stdio struct
3088      * and put EVERYTHING in the innermost loop into registers.
3089      */
3090     register STDCHAR *ptr;
3091     STRLEN bpx;
3092     I32 shortbuffered;
3093
3094 #if defined(VMS) && defined(PERLIO_IS_STDIO)
3095     /* An ungetc()d char is handled separately from the regular
3096      * buffer, so we getc() it back out and stuff it in the buffer.
3097      */
3098     i = PerlIO_getc(fp);
3099     if (i == EOF) return 0;
3100     *(--((*fp)->_ptr)) = (unsigned char) i;
3101     (*fp)->_cnt++;
3102 #endif
3103
3104     /* Here is some breathtakingly efficient cheating */
3105
3106     cnt = PerlIO_get_cnt(fp);                   /* get count into register */
3107     (void)SvPOK_only(sv);               /* validate pointer */
3108     if (SvLEN(sv) - append <= cnt + 1) { /* make sure we have the room */
3109         if (cnt > 80 && SvLEN(sv) > append) {
3110             shortbuffered = cnt - SvLEN(sv) + append + 1;
3111             cnt -= shortbuffered;
3112         }
3113         else {
3114             shortbuffered = 0;
3115             /* remember that cnt can be negative */
3116             SvGROW(sv, append + (cnt <= 0 ? 2 : (cnt + 1)));
3117         }
3118     }
3119     else
3120         shortbuffered = 0;
3121     bp = (STDCHAR*)SvPVX(sv) + append;  /* move these two too to registers */
3122     ptr = (STDCHAR*)PerlIO_get_ptr(fp);
3123     DEBUG_P(PerlIO_printf(Perl_debug_log,
3124         "Screamer: entering, ptr=%ld, cnt=%ld\n",(long)ptr,(long)cnt));
3125     DEBUG_P(PerlIO_printf(Perl_debug_log,
3126         "Screamer: entering: FILE * thinks ptr=%ld, cnt=%ld, base=%ld\n",
3127                (long)PerlIO_get_ptr(fp), (long)PerlIO_get_cnt(fp), 
3128                (long)(PerlIO_has_base(fp) ? PerlIO_get_base(fp) : 0)));
3129     for (;;) {
3130       screamer:
3131         if (cnt > 0) {
3132             if (rslen) {
3133                 while (cnt > 0) {                    /* this     |  eat */
3134                     cnt--;
3135                     if ((*bp++ = *ptr++) == rslast)  /* really   |  dust */
3136                         goto thats_all_folks;        /* screams  |  sed :-) */
3137                 }
3138             }
3139             else {
3140                 Copy(ptr, bp, cnt, char);            /* this     |  eat */    
3141                 bp += cnt;                           /* screams  |  dust */   
3142                 ptr += cnt;                          /* louder   |  sed :-) */
3143                 cnt = 0;
3144             }
3145         }
3146         
3147         if (shortbuffered) {            /* oh well, must extend */
3148             cnt = shortbuffered;
3149             shortbuffered = 0;
3150             bpx = bp - (STDCHAR*)SvPVX(sv); /* box up before relocation */
3151             SvCUR_set(sv, bpx);
3152             SvGROW(sv, SvLEN(sv) + append + cnt + 2);
3153             bp = (STDCHAR*)SvPVX(sv) + bpx; /* unbox after relocation */
3154             continue;
3155         }
3156
3157         DEBUG_P(PerlIO_printf(Perl_debug_log,
3158             "Screamer: going to getc, ptr=%ld, cnt=%ld\n",(long)ptr,(long)cnt));
3159         PerlIO_set_ptrcnt(fp, ptr, cnt); /* deregisterize cnt and ptr */
3160         DEBUG_P(PerlIO_printf(Perl_debug_log,
3161             "Screamer: pre: FILE * thinks ptr=%ld, cnt=%ld, base=%ld\n",
3162             (long)PerlIO_get_ptr(fp), (long)PerlIO_get_cnt(fp), 
3163             (long)(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
3164         /* This used to call 'filbuf' in stdio form, but as that behaves like 
3165            getc when cnt <= 0 we use PerlIO_getc here to avoid introducing
3166            another abstraction.  */
3167         i   = PerlIO_getc(fp);          /* get more characters */
3168         DEBUG_P(PerlIO_printf(Perl_debug_log,
3169             "Screamer: post: FILE * thinks ptr=%ld, cnt=%ld, base=%ld\n",
3170             (long)PerlIO_get_ptr(fp), (long)PerlIO_get_cnt(fp), 
3171             (long)(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
3172         cnt = PerlIO_get_cnt(fp);
3173         ptr = (STDCHAR*)PerlIO_get_ptr(fp);     /* reregisterize cnt and ptr */
3174         DEBUG_P(PerlIO_printf(Perl_debug_log,
3175             "Screamer: after getc, ptr=%ld, cnt=%ld\n",(long)ptr,(long)cnt));
3176
3177         if (i == EOF)                   /* all done for ever? */
3178             goto thats_really_all_folks;
3179
3180         bpx = bp - (STDCHAR*)SvPVX(sv); /* box up before relocation */
3181         SvCUR_set(sv, bpx);
3182         SvGROW(sv, bpx + cnt + 2);
3183         bp = (STDCHAR*)SvPVX(sv) + bpx; /* unbox after relocation */
3184
3185         *bp++ = i;                      /* store character from PerlIO_getc */
3186
3187         if (rslen && (STDCHAR)i == rslast)  /* all done for now? */
3188             goto thats_all_folks;
3189     }
3190
3191 thats_all_folks:
3192     if ((rslen > 1 && (bp - (STDCHAR*)SvPVX(sv) < rslen)) ||
3193           memNE((char*)bp - rslen, rsptr, rslen))
3194         goto screamer;                          /* go back to the fray */
3195 thats_really_all_folks:
3196     if (shortbuffered)
3197         cnt += shortbuffered;
3198         DEBUG_P(PerlIO_printf(Perl_debug_log,
3199             "Screamer: quitting, ptr=%ld, cnt=%ld\n",(long)ptr,(long)cnt));
3200     PerlIO_set_ptrcnt(fp, ptr, cnt);    /* put these back or we're in trouble */
3201     DEBUG_P(PerlIO_printf(Perl_debug_log,
3202         "Screamer: end: FILE * thinks ptr=%ld, cnt=%ld, base=%ld\n",
3203         (long)PerlIO_get_ptr(fp), (long)PerlIO_get_cnt(fp), 
3204         (long)(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
3205     *bp = '\0';
3206     SvCUR_set(sv, bp - (STDCHAR*)SvPVX(sv));    /* set length */
3207     DEBUG_P(PerlIO_printf(Perl_debug_log,
3208         "Screamer: done, len=%d, string=|%.*s|\n",
3209         SvCUR(sv),(int)SvCUR(sv),SvPVX(sv)));
3210     }
3211    else
3212     {
3213        /*The big, slow, and stupid way */
3214         STDCHAR buf[8192];
3215
3216 screamer2:
3217         if (rslen) {
3218             register STDCHAR *bpe = buf + sizeof(buf);
3219             bp = buf;
3220             while ((i = PerlIO_getc(fp)) != EOF && (*bp++ = i) != rslast && bp < bpe)
3221                 ; /* keep reading */
3222             cnt = bp - buf;
3223         }
3224         else {
3225             cnt = PerlIO_read(fp,(char*)buf, sizeof(buf));
3226             /* Accomodate broken VAXC compiler, which applies U8 cast to
3227              * both args of ?: operator, causing EOF to change into 255
3228              */
3229             if (cnt) { i = (U8)buf[cnt - 1]; } else { i = EOF; }
3230         }
3231
3232         if (append)
3233             sv_catpvn(sv, (char *) buf, cnt);
3234         else
3235             sv_setpvn(sv, (char *) buf, cnt);
3236
3237         if (i != EOF &&                 /* joy */
3238             (!rslen ||
3239              SvCUR(sv) < rslen ||
3240              memNE(SvPVX(sv) + SvCUR(sv) - rslen, rsptr, rslen)))
3241         {
3242             append = -1;
3243             goto screamer2;
3244         }
3245     }
3246
3247     if (RsPARA(rs)) {           /* have to do this both before and after */  
3248         while (i != EOF) {      /* to make sure file boundaries work right */
3249             i = PerlIO_getc(fp);
3250             if (i != '\n') {
3251                 PerlIO_ungetc(fp,i);
3252                 break;
3253             }
3254         }
3255     }
3256
3257     return (SvCUR(sv) - append) ? SvPVX(sv) : Nullch;
3258 }
3259
3260
3261 void
3262 sv_inc(sv)
3263 register SV *sv;
3264 {
3265     register char *d;
3266     int flags;
3267
3268     if (!sv)
3269         return;
3270     if (SvTHINKFIRST(sv)) {
3271         if (SvREADONLY(sv) && curcop != &compiling)
3272             croak(no_modify);
3273         if (SvROK(sv)) {
3274 #ifdef OVERLOAD
3275           if (SvAMAGIC(sv) && AMG_CALLun(sv,inc)) return;
3276 #endif /* OVERLOAD */
3277           sv_unref(sv);
3278         }
3279     }
3280     if (SvGMAGICAL(sv))
3281         mg_get(sv);
3282     flags = SvFLAGS(sv);
3283     if (flags & SVp_NOK) {
3284         (void)SvNOK_only(sv);
3285         SvNVX(sv) += 1.0;
3286         return;
3287     }
3288     if (flags & SVp_IOK) {
3289         if (SvIVX(sv) == IV_MAX)
3290             sv_setnv(sv, (double)IV_MAX + 1.0);
3291         else {
3292             (void)SvIOK_only(sv);
3293             ++SvIVX(sv);
3294         }
3295         return;
3296     }
3297     if (!(flags & SVp_POK) || !*SvPVX(sv)) {
3298         if ((flags & SVTYPEMASK) < SVt_PVNV)
3299             sv_upgrade(sv, SVt_NV);
3300         SvNVX(sv) = 1.0;
3301         (void)SvNOK_only(sv);
3302         return;
3303     }
3304     d = SvPVX(sv);
3305     while (isALPHA(*d)) d++;
3306     while (isDIGIT(*d)) d++;
3307     if (*d) {
3308         SET_NUMERIC_STANDARD();
3309         sv_setnv(sv,atof(SvPVX(sv)) + 1.0);  /* punt */
3310         return;
3311     }
3312     d--;
3313     while (d >= SvPVX(sv)) {
3314         if (isDIGIT(*d)) {
3315             if (++*d <= '9')
3316                 return;
3317             *(d--) = '0';
3318         }
3319         else {
3320             ++*d;
3321             if (isALPHA(*d))
3322                 return;
3323             *(d--) -= 'z' - 'a' + 1;
3324         }
3325     }
3326     /* oh,oh, the number grew */
3327     SvGROW(sv, SvCUR(sv) + 2);
3328     SvCUR(sv)++;
3329     for (d = SvPVX(sv) + SvCUR(sv); d > SvPVX(sv); d--)
3330         *d = d[-1];
3331     if (isDIGIT(d[1]))
3332         *d = '1';
3333     else
3334         *d = d[1];
3335 }
3336
3337 void
3338 sv_dec(sv)
3339 register SV *sv;
3340 {
3341     int flags;
3342
3343     if (!sv)
3344         return;
3345     if (SvTHINKFIRST(sv)) {
3346         if (SvREADONLY(sv) && curcop != &compiling)
3347             croak(no_modify);
3348         if (SvROK(sv)) {
3349 #ifdef OVERLOAD
3350           if (SvAMAGIC(sv) && AMG_CALLun(sv,dec)) return;
3351 #endif /* OVERLOAD */
3352           sv_unref(sv);
3353         }
3354     }
3355     if (SvGMAGICAL(sv))
3356         mg_get(sv);
3357     flags = SvFLAGS(sv);
3358     if (flags & SVp_NOK) {
3359         SvNVX(sv) -= 1.0;
3360         (void)SvNOK_only(sv);
3361         return;
3362     }
3363     if (flags & SVp_IOK) {
3364         if (SvIVX(sv) == IV_MIN)
3365             sv_setnv(sv, (double)IV_MIN - 1.0);
3366         else {
3367             (void)SvIOK_only(sv);
3368             --SvIVX(sv);
3369         }
3370         return;
3371     }
3372     if (!(flags & SVp_POK)) {
3373         if ((flags & SVTYPEMASK) < SVt_PVNV)
3374             sv_upgrade(sv, SVt_NV);
3375         SvNVX(sv) = -1.0;
3376         (void)SvNOK_only(sv);
3377         return;
3378     }
3379     SET_NUMERIC_STANDARD();
3380     sv_setnv(sv,atof(SvPVX(sv)) - 1.0); /* punt */
3381 }
3382
3383 /* Make a string that will exist for the duration of the expression
3384  * evaluation.  Actually, it may have to last longer than that, but
3385  * hopefully we won't free it until it has been assigned to a
3386  * permanent location. */
3387
3388 static void
3389 sv_mortalgrow()
3390 {
3391     tmps_max += (tmps_max < 512) ? 128 : 512;
3392     Renew(tmps_stack, tmps_max, SV*);
3393 }
3394
3395 SV *
3396 sv_mortalcopy(oldstr)
3397 SV *oldstr;
3398 {
3399     register SV *sv;
3400
3401     new_SV(sv);
3402     SvANY(sv) = 0;
3403     SvREFCNT(sv) = 1;
3404     SvFLAGS(sv) = 0;
3405     sv_setsv(sv,oldstr);
3406     if (++tmps_ix >= tmps_max)
3407         sv_mortalgrow();
3408     tmps_stack[tmps_ix] = sv;
3409     SvTEMP_on(sv);
3410     return sv;
3411 }
3412
3413 SV *
3414 sv_newmortal()
3415 {
3416     register SV *sv;
3417
3418     new_SV(sv);
3419     SvANY(sv) = 0;
3420     SvREFCNT(sv) = 1;
3421     SvFLAGS(sv) = SVs_TEMP;
3422     if (++tmps_ix >= tmps_max)
3423         sv_mortalgrow();
3424     tmps_stack[tmps_ix] = sv;
3425     return sv;
3426 }
3427
3428 /* same thing without the copying */
3429
3430 SV *
3431 sv_2mortal(sv)
3432 register SV *sv;
3433 {
3434     if (!sv)
3435         return sv;
3436     if (SvREADONLY(sv) && curcop != &compiling)
3437         croak(no_modify);
3438     if (++tmps_ix >= tmps_max)
3439         sv_mortalgrow();
3440     tmps_stack[tmps_ix] = sv;
3441     SvTEMP_on(sv);
3442     return sv;
3443 }
3444
3445 SV *
3446 newSVpv(s,len)
3447 char *s;
3448 STRLEN len;
3449 {
3450     register SV *sv;
3451
3452     new_SV(sv);
3453     SvANY(sv) = 0;
3454     SvREFCNT(sv) = 1;
3455     SvFLAGS(sv) = 0;
3456     if (!len)
3457         len = strlen(s);
3458     sv_setpvn(sv,s,len);
3459     return sv;
3460 }
3461
3462 #ifdef I_STDARG
3463 SV *
3464 newSVpvf(const char* pat, ...)
3465 #else
3466 /*VARARGS0*/
3467 SV *
3468 newSVpvf(sv, pat, va_alist)
3469 const char *pat;
3470 va_dcl
3471 #endif
3472 {
3473     register SV *sv;
3474     va_list args;
3475
3476     new_SV(sv);
3477     SvANY(sv) = 0;
3478     SvREFCNT(sv) = 1;
3479     SvFLAGS(sv) = 0;
3480 #ifdef I_STDARG
3481     va_start(args, pat);
3482 #else
3483     va_start(args);
3484 #endif
3485     sv_vsetpvfn(sv, pat, strlen(pat), &args, Null(SV**), 0, Null(bool));
3486     va_end(args);
3487     return sv;
3488 }
3489
3490
3491 SV *
3492 newSVnv(n)
3493 double n;
3494 {
3495     register SV *sv;
3496
3497     new_SV(sv);
3498     SvANY(sv) = 0;
3499     SvREFCNT(sv) = 1;
3500     SvFLAGS(sv) = 0;
3501     sv_setnv(sv,n);
3502     return sv;
3503 }
3504
3505 SV *
3506 newSViv(i)
3507 IV i;
3508 {
3509     register SV *sv;
3510
3511     new_SV(sv);
3512     SvANY(sv) = 0;
3513     SvREFCNT(sv) = 1;
3514     SvFLAGS(sv) = 0;
3515     sv_setiv(sv,i);
3516     return sv;
3517 }
3518
3519 SV *
3520 newRV(ref)
3521 SV *ref;
3522 {
3523     register SV *sv;
3524
3525     new_SV(sv);
3526     SvANY(sv) = 0;
3527     SvREFCNT(sv) = 1;
3528     SvFLAGS(sv) = 0;
3529     sv_upgrade(sv, SVt_RV);
3530     SvTEMP_off(ref);
3531     SvRV(sv) = SvREFCNT_inc(ref);
3532     SvROK_on(sv);
3533     return sv;
3534 }
3535
3536 #ifdef CRIPPLED_CC
3537 SV *
3538 newRV_noinc(ref)
3539 SV *ref;
3540 {
3541     register SV *sv;
3542
3543     sv = newRV(ref);
3544     SvREFCNT_dec(ref);
3545     return sv;
3546 }
3547 #endif /* CRIPPLED_CC */
3548
3549 /* make an exact duplicate of old */
3550
3551 SV *
3552 newSVsv(old)
3553 register SV *old;
3554 {
3555     register SV *sv;
3556
3557     if (!old)
3558         return Nullsv;
3559     if (SvTYPE(old) == SVTYPEMASK) {
3560         warn("semi-panic: attempt to dup freed string");
3561         return Nullsv;
3562     }
3563     new_SV(sv);
3564     SvANY(sv) = 0;
3565     SvREFCNT(sv) = 1;
3566     SvFLAGS(sv) = 0;
3567     if (SvTEMP(old)) {
3568         SvTEMP_off(old);
3569         sv_setsv(sv,old);
3570         SvTEMP_on(old);
3571     }
3572     else
3573         sv_setsv(sv,old);
3574     return sv;
3575 }
3576
3577 void
3578 sv_reset(s,stash)
3579 register char *s;
3580 HV *stash;
3581 {
3582     register HE *entry;
3583     register GV *gv;
3584     register SV *sv;
3585     register I32 i;
3586     register PMOP *pm;
3587     register I32 max;
3588     char todo[256];
3589
3590     if (!*s) {          /* reset ?? searches */
3591         for (pm = HvPMROOT(stash); pm; pm = pm->op_pmnext) {
3592             pm->op_pmflags &= ~PMf_USED;
3593         }
3594         return;
3595     }
3596
3597     /* reset variables */
3598
3599     if (!HvARRAY(stash))
3600         return;
3601
3602     Zero(todo, 256, char);
3603     while (*s) {
3604         i = *s;
3605         if (s[1] == '-') {
3606             s += 2;
3607         }
3608         max = *s++;
3609         for ( ; i <= max; i++) {
3610             todo[i] = 1;
3611         }
3612         for (i = 0; i <= (I32) HvMAX(stash); i++) {
3613             for (entry = HvARRAY(stash)[i];
3614               entry;
3615               entry = HeNEXT(entry)) {
3616                 if (!todo[(U8)*HeKEY(entry)])
3617                     continue;
3618                 gv = (GV*)HeVAL(entry);
3619                 sv = GvSV(gv);
3620                 (void)SvOK_off(sv);
3621                 if (SvTYPE(sv) >= SVt_PV) {
3622                     SvCUR_set(sv, 0);
3623                     if (SvPVX(sv) != Nullch)
3624                         *SvPVX(sv) = '\0';
3625                     SvTAINT(sv);
3626                 }
3627                 if (GvAV(gv)) {
3628                     av_clear(GvAV(gv));
3629                 }
3630                 if (GvHV(gv) && !HvNAME(GvHV(gv))) {
3631                     hv_clear(GvHV(gv));
3632 #ifndef VMS  /* VMS has no environ array */
3633                     if (gv == envgv)
3634                         environ[0] = Nullch;
3635 #endif
3636                 }
3637             }
3638         }
3639     }
3640 }
3641
3642 IO*
3643 sv_2io(sv)
3644 SV *sv;
3645 {
3646     IO* io;
3647     GV* gv;
3648
3649     switch (SvTYPE(sv)) {
3650     case SVt_PVIO:
3651         io = (IO*)sv;
3652         break;
3653     case SVt_PVGV:
3654         gv = (GV*)sv;
3655         io = GvIO(gv);
3656         if (!io)
3657             croak("Bad filehandle: %s", GvNAME(gv));
3658         break;
3659     default:
3660         if (!SvOK(sv))
3661             croak(no_usym, "filehandle");
3662         if (SvROK(sv))
3663             return sv_2io(SvRV(sv));
3664         gv = gv_fetchpv(SvPV(sv,na), FALSE, SVt_PVIO);
3665         if (gv)
3666             io = GvIO(gv);
3667         else
3668             io = 0;
3669         if (!io)
3670             croak("Bad filehandle: %s", SvPV(sv,na));
3671         break;
3672     }
3673     return io;
3674 }
3675
3676 CV *
3677 sv_2cv(sv, st, gvp, lref)
3678 SV *sv;
3679 HV **st;
3680 GV **gvp;
3681 I32 lref;
3682 {
3683     GV *gv;
3684     CV *cv;
3685
3686     if (!sv)
3687         return *gvp = Nullgv, Nullcv;
3688     switch (SvTYPE(sv)) {
3689     case SVt_PVCV:
3690         *st = CvSTASH(sv);
3691         *gvp = Nullgv;
3692         return (CV*)sv;
3693     case SVt_PVHV:
3694     case SVt_PVAV:
3695         *gvp = Nullgv;
3696         return Nullcv;
3697     case SVt_PVGV:
3698         gv = (GV*)sv;
3699         *gvp = gv;
3700         *st = GvESTASH(gv);
3701         goto fix_gv;
3702
3703     default:
3704         if (SvGMAGICAL(sv))
3705             mg_get(sv);
3706         if (SvROK(sv)) {
3707             cv = (CV*)SvRV(sv);
3708             if (SvTYPE(cv) != SVt_PVCV)
3709                 croak("Not a subroutine reference");
3710             *gvp = Nullgv;
3711             *st = CvSTASH(cv);
3712             return cv;
3713         }
3714         if (isGV(sv))
3715             gv = (GV*)sv;
3716         else
3717             gv = gv_fetchpv(SvPV(sv, na), lref, SVt_PVCV);
3718         *gvp = gv;
3719         if (!gv)
3720             return Nullcv;
3721         *st = GvESTASH(gv);
3722     fix_gv:
3723         if (lref && !GvCVu(gv)) {
3724             SV *tmpsv;
3725             ENTER;
3726             tmpsv = NEWSV(704,0);
3727             gv_efullname3(tmpsv, gv, Nullch);
3728             newSUB(start_subparse(FALSE, 0),
3729                    newSVOP(OP_CONST, 0, tmpsv),
3730                    Nullop,
3731                    Nullop);
3732             LEAVE;
3733             if (!GvCVu(gv))
3734                 croak("Unable to create sub named \"%s\"", SvPV(sv,na));
3735         }
3736         return GvCVu(gv);
3737     }
3738 }
3739
3740 #ifndef SvTRUE
3741 I32
3742 SvTRUE(sv)
3743 register SV *sv;
3744 {
3745     if (!sv)
3746         return 0;
3747     if (SvGMAGICAL(sv))
3748         mg_get(sv);
3749     if (SvPOK(sv)) {
3750         register XPV* Xpv;
3751         if ((Xpv = (XPV*)SvANY(sv)) &&
3752                 (*Xpv->xpv_pv > '0' ||
3753                 Xpv->xpv_cur > 1 ||
3754                 (Xpv->xpv_cur && *Xpv->xpv_pv != '0')))
3755             return 1;
3756         else
3757             return 0;
3758     }
3759     else {
3760         if (SvIOK(sv))
3761             return SvIVX(sv) != 0;
3762         else {
3763             if (SvNOK(sv))
3764                 return SvNVX(sv) != 0.0;
3765             else
3766                 return sv_2bool(sv);
3767         }
3768     }
3769 }
3770 #endif /* !SvTRUE */
3771
3772 #ifndef SvIV
3773 IV
3774 SvIV(sv)
3775 register SV *sv;
3776 {
3777     if (SvIOK(sv))
3778         return SvIVX(sv);
3779     return sv_2iv(sv);
3780 }
3781 #endif /* !SvIV */
3782
3783 #ifndef SvUV
3784 UV
3785 SvUV(sv)
3786 register SV *sv;
3787 {
3788     if (SvIOK(sv))
3789         return SvUVX(sv);
3790     return sv_2uv(sv);
3791 }
3792 #endif /* !SvUV */
3793
3794 #ifndef SvNV
3795 double
3796 SvNV(sv)
3797 register SV *sv;
3798 {
3799     if (SvNOK(sv))
3800         return SvNVX(sv);
3801     return sv_2nv(sv);
3802 }
3803 #endif /* !SvNV */
3804
3805 #ifdef CRIPPLED_CC
3806 char *
3807 sv_pvn(sv, lp)
3808 SV *sv;
3809 STRLEN *lp;
3810 {
3811     if (SvPOK(sv)) {
3812         *lp = SvCUR(sv);
3813         return SvPVX(sv);
3814     }
3815     return sv_2pv(sv, lp);
3816 }
3817 #endif
3818
3819 char *
3820 sv_pvn_force(sv, lp)
3821 SV *sv;
3822 STRLEN *lp;
3823 {
3824     char *s;
3825
3826     if (SvREADONLY(sv) && curcop != &compiling)
3827         croak(no_modify);
3828     
3829     if (SvPOK(sv)) {
3830         *lp = SvCUR(sv);
3831     }
3832     else {
3833         if (SvTYPE(sv) > SVt_PVLV && SvTYPE(sv) != SVt_PVFM) {
3834             if (SvFAKE(sv) && SvTYPE(sv) == SVt_PVGV) {
3835                 sv_unglob(sv);
3836                 s = SvPVX(sv);
3837                 *lp = SvCUR(sv);
3838             }
3839             else
3840                 croak("Can't coerce %s to string in %s", sv_reftype(sv,0),
3841                     op_name[op->op_type]);
3842         }
3843         else
3844             s = sv_2pv(sv, lp);
3845         if (s != SvPVX(sv)) {   /* Almost, but not quite, sv_setpvn() */
3846             STRLEN len = *lp;
3847             
3848             if (SvROK(sv))
3849                 sv_unref(sv);
3850             (void)SvUPGRADE(sv, SVt_PV);                /* Never FALSE */
3851             SvGROW(sv, len + 1);
3852             Move(s,SvPVX(sv),len,char);
3853             SvCUR_set(sv, len);
3854             *SvEND(sv) = '\0';
3855         }
3856         if (!SvPOK(sv)) {
3857             SvPOK_on(sv);               /* validate pointer */
3858             SvTAINT(sv);
3859             DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%lx 2pv(%s)\n",
3860                 (unsigned long)sv,SvPVX(sv)));
3861         }
3862     }
3863     return SvPVX(sv);
3864 }
3865
3866 char *
3867 sv_reftype(sv, ob)
3868 SV* sv;
3869 int ob;
3870 {
3871     if (ob && SvOBJECT(sv))
3872         return HvNAME(SvSTASH(sv));
3873     else {
3874         switch (SvTYPE(sv)) {
3875         case SVt_NULL:
3876         case SVt_IV:
3877         case SVt_NV:
3878         case SVt_RV:
3879         case SVt_PV:
3880         case SVt_PVIV:
3881         case SVt_PVNV:
3882         case SVt_PVMG:
3883         case SVt_PVBM:
3884                                 if (SvROK(sv))
3885                                     return "REF";
3886                                 else
3887                                     return "SCALAR";
3888         case SVt_PVLV:          return "LVALUE";
3889         case SVt_PVAV:          return "ARRAY";
3890         case SVt_PVHV:          return "HASH";
3891         case SVt_PVCV:          return "CODE";
3892         case SVt_PVGV:          return "GLOB";
3893         case SVt_PVFM:          return "FORMLINE";
3894         default:                return "UNKNOWN";
3895         }
3896     }
3897 }
3898
3899 int
3900 sv_isobject(sv)
3901 SV *sv;
3902 {
3903     if (!sv)
3904         return 0;
3905     if (SvGMAGICAL(sv))
3906         mg_get(sv);
3907     if (!SvROK(sv))
3908         return 0;
3909     sv = (SV*)SvRV(sv);
3910     if (!SvOBJECT(sv))
3911         return 0;
3912     return 1;
3913 }
3914
3915 int
3916 sv_isa(sv, name)
3917 SV *sv;
3918 char *name;
3919 {
3920     if (!sv)
3921         return 0;
3922     if (SvGMAGICAL(sv))
3923         mg_get(sv);
3924     if (!SvROK(sv))
3925         return 0;
3926     sv = (SV*)SvRV(sv);
3927     if (!SvOBJECT(sv))
3928         return 0;
3929
3930     return strEQ(HvNAME(SvSTASH(sv)), name);
3931 }
3932
3933 SV*
3934 newSVrv(rv, classname)
3935 SV *rv;
3936 char *classname;
3937 {
3938     SV *sv;
3939
3940     new_SV(sv);
3941     SvANY(sv) = 0;
3942     SvREFCNT(sv) = 0;
3943     SvFLAGS(sv) = 0;
3944     sv_upgrade(rv, SVt_RV);
3945     SvRV(rv) = SvREFCNT_inc(sv);
3946     SvROK_on(rv);
3947
3948     if (classname) {
3949         HV* stash = gv_stashpv(classname, TRUE);
3950         (void)sv_bless(rv, stash);
3951     }
3952     return sv;
3953 }
3954
3955 SV*
3956 sv_setref_pv(rv, classname, pv)
3957 SV *rv;
3958 char *classname;
3959 void* pv;
3960 {
3961     if (!pv)
3962         sv_setsv(rv, &sv_undef);
3963     else
3964         sv_setiv(newSVrv(rv,classname), (IV)pv);
3965     return rv;
3966 }
3967
3968 SV*
3969 sv_setref_iv(rv, classname, iv)
3970 SV *rv;
3971 char *classname;
3972 IV iv;
3973 {
3974     sv_setiv(newSVrv(rv,classname), iv);
3975     return rv;
3976 }
3977
3978 SV*
3979 sv_setref_nv(rv, classname, nv)
3980 SV *rv;
3981 char *classname;
3982 double nv;
3983 {
3984     sv_setnv(newSVrv(rv,classname), nv);
3985     return rv;
3986 }
3987
3988 SV*
3989 sv_setref_pvn(rv, classname, pv, n)
3990 SV *rv;
3991 char *classname;
3992 char* pv;
3993 I32 n;
3994 {
3995     sv_setpvn(newSVrv(rv,classname), pv, n);
3996     return rv;
3997 }
3998
3999 SV*
4000 sv_bless(sv,stash)
4001 SV* sv;
4002 HV* stash;
4003 {
4004     SV *ref;
4005     if (!SvROK(sv))
4006         croak("Can't bless non-reference value");
4007     ref = SvRV(sv);
4008     if (SvFLAGS(ref) & (SVs_OBJECT|SVf_READONLY)) {
4009         if (SvREADONLY(ref))
4010             croak(no_modify);
4011         if (SvOBJECT(ref)) {
4012             if (SvTYPE(ref) != SVt_PVIO)
4013                 --sv_objcount;
4014             SvREFCNT_dec(SvSTASH(ref));
4015         }
4016     }
4017     SvOBJECT_on(ref);
4018     if (SvTYPE(ref) != SVt_PVIO)
4019         ++sv_objcount;
4020     (void)SvUPGRADE(ref, SVt_PVMG);
4021     SvSTASH(ref) = (HV*)SvREFCNT_inc(stash);
4022
4023 #ifdef OVERLOAD
4024     if (Gv_AMG(stash))
4025         SvAMAGIC_on(sv);
4026     else
4027         SvAMAGIC_off(sv);
4028 #endif /* OVERLOAD */
4029
4030     return sv;
4031 }
4032
4033 static void
4034 sv_unglob(sv)
4035 SV* sv;
4036 {
4037     assert(SvTYPE(sv) == SVt_PVGV);
4038     SvFAKE_off(sv);
4039     if (GvGP(sv))
4040         gp_free((GV*)sv);
4041     sv_unmagic(sv, '*');
4042     Safefree(GvNAME(sv));
4043     GvMULTI_off(sv);
4044     SvFLAGS(sv) &= ~SVTYPEMASK;
4045     SvFLAGS(sv) |= SVt_PVMG;
4046 }
4047
4048 void
4049 sv_unref(sv)
4050 SV* sv;
4051 {
4052     SV* rv = SvRV(sv);
4053     
4054     SvRV(sv) = 0;
4055     SvROK_off(sv);
4056     if (SvREFCNT(rv) != 1 || SvREADONLY(rv))
4057         SvREFCNT_dec(rv);
4058     else
4059         sv_2mortal(rv);         /* Schedule for freeing later */
4060 }
4061
4062 void
4063 sv_taint(sv)
4064 SV *sv;
4065 {
4066     sv_magic((sv), Nullsv, 't', Nullch, 0);
4067 }
4068
4069 void
4070 sv_untaint(sv)
4071 SV *sv;
4072 {
4073     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv)) {
4074         MAGIC *mg = mg_find(sv, 't');
4075         if (mg)
4076             mg->mg_len &= ~1;
4077     }
4078 }
4079
4080 bool
4081 sv_tainted(sv)
4082 SV *sv;
4083 {
4084     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv)) {
4085         MAGIC *mg = mg_find(sv, 't');
4086         if (mg && ((mg->mg_len & 1) || (mg->mg_len & 2) && mg->mg_obj == sv))
4087             return TRUE;
4088     }
4089     return FALSE;
4090 }
4091
4092 #ifdef I_STDARG
4093 void
4094 sv_setpvf(SV *sv, const char* pat, ...)
4095 #else
4096 /*VARARGS0*/
4097 void
4098 sv_setpvf(sv, pat, va_alist)
4099     SV *sv;
4100     const char *pat;
4101     va_dcl
4102 #endif
4103 {
4104     va_list args;
4105 #ifdef I_STDARG
4106     va_start(args, pat);
4107 #else
4108     va_start(args);
4109 #endif
4110     sv_vsetpvfn(sv, pat, strlen(pat), &args, Null(SV**), 0, Null(bool));
4111     va_end(args);
4112 }
4113
4114 #ifdef I_STDARG
4115 void
4116 sv_catpvf(SV *sv, const char* pat, ...)
4117 #else
4118 /*VARARGS0*/
4119 void
4120 sv_catpvf(sv, pat, va_alist)
4121     SV *sv;
4122     const char *pat;
4123     va_dcl
4124 #endif
4125 {
4126     va_list args;
4127 #ifdef I_STDARG
4128     va_start(args, pat);
4129 #else
4130     va_start(args);
4131 #endif
4132     sv_vcatpvfn(sv, pat, strlen(pat), &args, Null(SV**), 0, Null(bool));
4133     va_end(args);
4134 }
4135
4136 void
4137 sv_vsetpvfn(sv, pat, patlen, args, svargs, svmax, used_locale)
4138     SV *sv;
4139     const char *pat;
4140     STRLEN patlen;
4141     va_list *args;
4142     SV **svargs;
4143     I32 svmax;
4144     bool *used_locale;
4145 {
4146     sv_setpvn(sv, "", 0);
4147     sv_vcatpvfn(sv, pat, patlen, args, svargs, svmax, used_locale);
4148 }
4149
4150 void
4151 sv_vcatpvfn(sv, pat, patlen, args, svargs, svmax, used_locale)
4152     SV *sv;
4153     const char *pat;
4154     STRLEN patlen;
4155     va_list *args;
4156     SV **svargs;
4157     I32 svmax;
4158     bool *used_locale;
4159 {
4160     char *p;
4161     char *q;
4162     char *patend;
4163     I32 svix = 0;
4164
4165     /* no matter what, this is a string now */
4166     (void)SvPV_force(sv, na);
4167
4168     /* special-case "" and "%s" */
4169     if (patlen == 0)
4170         return;
4171     if (patlen == 2 && pat[0] == '%' && pat[1] == 's') {
4172         if (args)
4173             sv_catpv(sv, va_arg(*args, char *));
4174         else if (svix < svmax)
4175             sv_catsv(sv, *svargs);
4176         return;
4177     }
4178
4179     patend = (char*)pat + patlen;
4180     for (p = (char*)pat; p < patend; p = q) {
4181         bool alt = FALSE;
4182         bool left = FALSE;
4183         char fill = ' ';
4184         char plus = 0;
4185         char intsize = 0;
4186         STRLEN width = 0;
4187         bool has_precis = FALSE;
4188         STRLEN precis = 0;
4189
4190         char esignbuf[4];
4191         STRLEN esignlen = 0;
4192
4193         char *eptr = Nullch;
4194         STRLEN elen = 0;
4195         char ebuf[(sizeof(UV) * 3) * 2 + 16]; /* large enough for "%#.#f" */
4196
4197         static char *efloatbuf = Nullch;
4198         static STRLEN efloatsize = 0;
4199
4200         char c;
4201         int i;
4202         unsigned base;
4203         IV iv;
4204         UV uv;
4205         double nv;
4206         STRLEN have;
4207         STRLEN need;
4208         STRLEN gap;
4209
4210         for (q = p; q < patend && *q != '%'; ++q) ;
4211         if (q > p) {
4212             sv_catpvn(sv, p, q - p);
4213             p = q;
4214         }
4215         if (q++ >= patend)
4216             break;
4217
4218         while (*q) {
4219             switch (*q) {
4220             case ' ':
4221             case '+':
4222                 plus = *q++;
4223                 continue;
4224
4225             case '-':
4226                 left = TRUE;
4227                 q++;
4228                 continue;
4229
4230             case '0':
4231                 fill = *q++;
4232                 continue;
4233
4234             case '#':
4235                 alt = TRUE;
4236                 q++;
4237                 continue;
4238
4239             case 'l':
4240 #if 0  /* when quads have better support within Perl */
4241                 if (intsize == 'l') {
4242                     intsize = 'q';
4243                     q++;
4244                     continue;
4245                 }
4246 #endif
4247                 /* FALL THROUGH */
4248             case 'h':
4249             case 'v':
4250                 intsize = *q++;
4251                 continue;
4252
4253             case '1': case '2': case '3':
4254             case '4': case '5': case '6':
4255             case '7': case '8': case '9':
4256                 width = 0;
4257                 while (isDIGIT(*q))
4258                     width = width * 10 + (*q++ - '0');
4259                 continue;
4260
4261             case '*':
4262                 if (args)
4263                     i = va_arg(*args, int);
4264                 else
4265                     i = (svix < svmax) ? SvIVx(svargs[svix++]) : 0;
4266                 left ^= (i < 0);
4267                 width = (i < 0) ? -i : i;
4268                 q++;
4269                 continue;
4270
4271             case '.':
4272                 q++;
4273                 if (*q == '*') {
4274                     if (args)
4275                         precis = va_arg(*args, int);
4276                     else
4277                         precis = (svix < svmax) ? SvUVx(svargs[svix++]) : 0;
4278                     q++;
4279                 }
4280                 else {
4281                     precis = 0;
4282                     while (isDIGIT(*q))
4283                         precis = precis * 10 + (*q++ - '0');
4284                 }
4285                 has_precis = TRUE;
4286                 continue;
4287
4288             default:
4289                 break;
4290             }
4291
4292             break;
4293         }
4294
4295         switch (c = *q++) {
4296
4297             /* STRINGS */
4298
4299         case '%':
4300             eptr = q - 1;
4301             elen = 1;
4302             goto string;
4303
4304         case 'c':
4305             if (args)
4306                 c = va_arg(*args, int);
4307             else
4308                 c = (svix < svmax) ? SvIVx(svargs[svix++]) : 0;
4309             eptr = &c;
4310             elen = 1;
4311             goto string;
4312
4313         case 'S':
4314             if (args) {
4315                 eptr = SvPVx(va_arg(*args, SV *), elen);
4316                 goto string;
4317             }
4318             /* FALL THROUGH */
4319
4320         case 's':
4321             if (args) {
4322                 eptr = va_arg(*args, char *);
4323                 elen = strlen(eptr);
4324             }
4325             else if (svix < svmax)
4326                 eptr = SvPVx(svargs[svix++], elen);
4327             goto string;
4328
4329         string:
4330             if (has_precis && elen > precis)
4331                 elen = precis;
4332             break;
4333
4334             /* INTEGERS */
4335
4336         case 'D':
4337             intsize = 'l';
4338             /* FALL THROUGH */
4339         case 'd':
4340         case 'i':
4341             if (args) {
4342                 switch (intsize) {
4343                 case 'h':       iv = (short)va_arg(*args, int); break;
4344                 default:        iv = va_arg(*args, int); break;
4345                 case 'l':       iv = va_arg(*args, long); break;
4346                 case 'v':       iv = va_arg(*args, IV); break;
4347                 }
4348             }
4349             else {
4350                 iv = (svix < svmax) ? SvIVx(svargs[svix++]) : 0;
4351                 switch (intsize) {
4352                 case 'h':       iv = (short)iv; break;
4353                 default:        iv = (int)iv; break;
4354                 case 'l':       iv = (long)iv; break;
4355                 case 'v':       break;
4356                 }
4357             }
4358             if (iv >= 0) {
4359                 uv = iv;
4360                 if (plus)
4361                     esignbuf[esignlen++] = plus;
4362             }
4363             else {
4364                 uv = -iv;
4365                 esignbuf[esignlen++] = '-';
4366             }
4367             base = 10;
4368             goto integer;
4369
4370         case 'O':
4371             intsize = 'l';
4372             /* FALL THROUGH */
4373         case 'o':
4374             base = 8;
4375             goto uns_integer;
4376
4377         case 'X':
4378             intsize = 'l';
4379             /* FALL THROUGH */
4380         case 'x':
4381             base = 16;
4382             goto uns_integer;
4383
4384         case 'u':
4385             base = 10;
4386
4387         uns_integer:
4388             if (args) {
4389                 switch (intsize) {
4390                 case 'h':  uv = (unsigned short)va_arg(*args, unsigned); break;
4391                 default:   uv = va_arg(*args, unsigned); break;
4392                 case 'l':  uv = va_arg(*args, unsigned long); break;
4393                 case 'v':  uv = va_arg(*args, UV); break;
4394                 }
4395             }
4396             else {
4397                 uv = (svix < svmax) ? SvUVx(svargs[svix++]) : 0;
4398                 switch (intsize) {
4399                 case 'h':       uv = (unsigned short)uv; break;
4400                 default:        uv = (unsigned)uv; break;
4401                 case 'l':       uv = (unsigned long)uv; break;
4402                 case 'v':       break;
4403                 }
4404             }
4405
4406         integer:
4407             p = "0123456789abcdef";
4408             eptr = ebuf + sizeof ebuf;
4409             do {
4410                 unsigned dig = uv % base;
4411                 *--eptr = p[dig];
4412             } while (uv /= base);
4413             if (alt) {
4414                 switch (c) {
4415                 case 'o':
4416                     if (*eptr != 0)
4417                         esignbuf[esignlen++] = '0';
4418                     break;
4419                 case 'x':
4420                     esignbuf[esignlen++] = '0';
4421                     esignbuf[esignlen++] = 'x';
4422                     break;
4423                 }
4424             }
4425             elen = (ebuf + sizeof ebuf) - eptr;
4426             if (has_precis) {
4427                 left = FALSE;
4428                 fill = '0';
4429                 width = esignlen + precis;
4430             }
4431             break;
4432
4433             /* FLOATING POINT */
4434
4435         case 'e': case 'E':
4436         case 'f': case 'F':
4437         case 'g': case 'G':
4438
4439             /* This is evil, but floating point is even more evil */
4440
4441             need = width;
4442             if (has_precis && need < precis)
4443                 need = precis;
4444             need += 20; /* fudge factor */
4445             if (efloatsize < need) {
4446                 Safefree(efloatbuf);
4447                 efloatsize = need + 20; /* more fudge */
4448                 New(906, efloatbuf, efloatsize, char);
4449             }
4450
4451             eptr = ebuf + sizeof ebuf;
4452             *--eptr = '\0';
4453             *--eptr = c;
4454             if (has_precis) {
4455                 base = precis;
4456                 do { *--eptr = '0' + (base % 10); } while (base /= 10);
4457                 *--eptr = '.';
4458             }
4459             if (width) {
4460                 base = width;
4461                 do { *--eptr = '0' + (base % 10); } while (base /= 10);
4462             }
4463             if (fill == '0')
4464                 *--eptr = fill;
4465             if (plus)
4466                 *--eptr = plus;
4467             if (alt)
4468                 *--eptr = '#';
4469             *--eptr = '%';
4470
4471             if (args)
4472                 nv = va_arg(*args, double);
4473             else
4474                 nv = (svix < svmax) ? SvNVx(svargs[svix++]) : 0.0;
4475             (void)sprintf(efloatbuf, eptr, nv);
4476
4477             eptr = efloatbuf;
4478             elen = strlen(efloatbuf);
4479
4480 #ifdef LC_NUMERIC
4481             /*
4482              * User-defined locales may include arbitrary characters.
4483              * And, unfortunately, some system may alloc the "C" locale
4484              * to be overridden by a malicious user.
4485              */
4486             if (used_locale)
4487                 *used_locale = TRUE;
4488 #endif /* LC_NUMERIC */
4489
4490             break;
4491
4492         default:
4493             /* output mangled stuff without comment */
4494             eptr = p;
4495             elen = q - p;
4496             break;
4497         }
4498
4499         have = esignlen + elen;
4500         need = (have > width ? have : width);
4501         gap = need - have;
4502
4503         SvGROW(sv, SvLEN(sv) + need);
4504         p = SvEND(sv);
4505         if (esignlen && fill == '0') {
4506             for (i = 0; i < esignlen; i++)
4507                 *p++ = esignbuf[i];
4508         }
4509         if (gap && !left) {
4510             memset(p, fill, gap);
4511             p += gap;
4512         }
4513         if (esignlen && fill != '0') {
4514             for (i = 0; i < esignlen; i++)
4515                 *p++ = esignbuf[i];
4516         }
4517         if (elen) {
4518             memcpy(p, eptr, elen);
4519             p += elen;
4520         }
4521         if (gap && left) {
4522             memset(p, ' ', gap);
4523             p += gap;
4524         }
4525         *p = '\0';
4526         SvCUR(sv) = p - SvPVX(sv);
4527     }
4528 }
4529
4530 #ifdef DEBUGGING
4531 void
4532 sv_dump(sv)
4533 SV* sv;
4534 {
4535     SV *d = sv_newmortal();
4536     char *s;
4537     U32 flags;
4538     U32 type;
4539
4540     if (!sv) {
4541         PerlIO_printf(Perl_debug_log, "SV = 0\n");
4542         return;
4543     }
4544     
4545     flags = SvFLAGS(sv);
4546     type = SvTYPE(sv);
4547
4548     sv_setpvf(d, "(0x%lx)\n  REFCNT = %ld\n  FLAGS = (",
4549               (unsigned long)SvANY(sv), (long)SvREFCNT(sv));
4550     if (flags & SVs_PADBUSY)    sv_catpv(d, "PADBUSY,");
4551     if (flags & SVs_PADTMP)     sv_catpv(d, "PADTMP,");
4552     if (flags & SVs_PADMY)      sv_catpv(d, "PADMY,");
4553     if (flags & SVs_TEMP)       sv_catpv(d, "TEMP,");
4554     if (flags & SVs_OBJECT)     sv_catpv(d, "OBJECT,");
4555     if (flags & SVs_GMG)        sv_catpv(d, "GMG,");
4556     if (flags & SVs_SMG)        sv_catpv(d, "SMG,");
4557     if (flags & SVs_RMG)        sv_catpv(d, "RMG,");
4558
4559     if (flags & SVf_IOK)        sv_catpv(d, "IOK,");
4560     if (flags & SVf_NOK)        sv_catpv(d, "NOK,");
4561     if (flags & SVf_POK)        sv_catpv(d, "POK,");
4562     if (flags & SVf_ROK)        sv_catpv(d, "ROK,");
4563     if (flags & SVf_OOK)        sv_catpv(d, "OOK,");
4564     if (flags & SVf_FAKE)       sv_catpv(d, "FAKE,");
4565     if (flags & SVf_READONLY)   sv_catpv(d, "READONLY,");
4566
4567 #ifdef OVERLOAD
4568     if (flags & SVf_AMAGIC)     sv_catpv(d, "OVERLOAD,");
4569 #endif /* OVERLOAD */
4570     if (flags & SVp_IOK)        sv_catpv(d, "pIOK,");
4571     if (flags & SVp_NOK)        sv_catpv(d, "pNOK,");
4572     if (flags & SVp_POK)        sv_catpv(d, "pPOK,");
4573     if (flags & SVp_SCREAM)     sv_catpv(d, "SCREAM,");
4574
4575     switch (type) {
4576     case SVt_PVCV:
4577     case SVt_PVFM:
4578         if (CvANON(sv))         sv_catpv(d, "ANON,");
4579         if (CvUNIQUE(sv))       sv_catpv(d, "UNIQUE,");
4580         if (CvCLONE(sv))        sv_catpv(d, "CLONE,");
4581         if (CvCLONED(sv))       sv_catpv(d, "CLONED,");
4582         if (CvNODEBUG(sv))      sv_catpv(d, "NODEBUG,");
4583         break;
4584     case SVt_PVHV:
4585         if (HvSHAREKEYS(sv))    sv_catpv(d, "SHAREKEYS,");
4586         if (HvLAZYDEL(sv))      sv_catpv(d, "LAZYDEL,");
4587         break;
4588     case SVt_PVGV:
4589         if (GvINTRO(sv))        sv_catpv(d, "INTRO,");
4590         if (GvMULTI(sv))        sv_catpv(d, "MULTI,");
4591         if (GvASSUMECV(sv))     sv_catpv(d, "ASSUMECV,");
4592         if (GvIMPORTED(sv)) {
4593             sv_catpv(d, "IMPORT");
4594             if (GvIMPORTED(sv) == GVf_IMPORTED)
4595                 sv_catpv(d, "ALL,");
4596             else {
4597                 sv_catpv(d, "(");
4598                 if (GvIMPORTED_SV(sv))  sv_catpv(d, " SV");
4599                 if (GvIMPORTED_AV(sv))  sv_catpv(d, " AV");
4600                 if (GvIMPORTED_HV(sv))  sv_catpv(d, " HV");
4601                 if (GvIMPORTED_CV(sv))  sv_catpv(d, " CV");
4602                 sv_catpv(d, " ),");
4603             }
4604         }
4605     }
4606
4607     if (*(SvEND(d) - 1) == ',')
4608         SvPVX(d)[--SvCUR(d)] = '\0';
4609     sv_catpv(d, ")");
4610     s = SvPVX(d);
4611
4612     PerlIO_printf(Perl_debug_log, "SV = ");
4613     switch (type) {
4614     case SVt_NULL:
4615         PerlIO_printf(Perl_debug_log, "NULL%s\n", s);
4616         return;
4617     case SVt_IV:
4618         PerlIO_printf(Perl_debug_log, "IV%s\n", s);
4619         break;
4620     case SVt_NV:
4621         PerlIO_printf(Perl_debug_log, "NV%s\n", s);
4622         break;
4623     case SVt_RV:
4624         PerlIO_printf(Perl_debug_log, "RV%s\n", s);
4625         break;
4626     case SVt_PV:
4627         PerlIO_printf(Perl_debug_log, "PV%s\n", s);
4628         break;
4629     case SVt_PVIV:
4630         PerlIO_printf(Perl_debug_log, "PVIV%s\n", s);
4631         break;
4632     case SVt_PVNV:
4633         PerlIO_printf(Perl_debug_log, "PVNV%s\n", s);
4634         break;
4635     case SVt_PVBM:
4636         PerlIO_printf(Perl_debug_log, "PVBM%s\n", s);
4637         break;
4638     case SVt_PVMG:
4639         PerlIO_printf(Perl_debug_log, "PVMG%s\n", s);
4640         break;
4641     case SVt_PVLV:
4642         PerlIO_printf(Perl_debug_log, "PVLV%s\n", s);
4643         break;
4644     case SVt_PVAV:
4645         PerlIO_printf(Perl_debug_log, "PVAV%s\n", s);
4646         break;
4647     case SVt_PVHV:
4648         PerlIO_printf(Perl_debug_log, "PVHV%s\n", s);
4649         break;
4650     case SVt_PVCV:
4651         PerlIO_printf(Perl_debug_log, "PVCV%s\n", s);
4652         break;
4653     case SVt_PVGV:
4654         PerlIO_printf(Perl_debug_log, "PVGV%s\n", s);
4655         break;
4656     case SVt_PVFM:
4657         PerlIO_printf(Perl_debug_log, "PVFM%s\n", s);
4658         break;
4659     case SVt_PVIO:
4660         PerlIO_printf(Perl_debug_log, "PVIO%s\n", s);
4661         break;
4662     default:
4663         PerlIO_printf(Perl_debug_log, "UNKNOWN%s\n", s);
4664         return;
4665     }
4666     if (type >= SVt_PVIV || type == SVt_IV)
4667         PerlIO_printf(Perl_debug_log, "  IV = %ld\n", (long)SvIVX(sv));
4668     if (type >= SVt_PVNV || type == SVt_NV) {
4669         SET_NUMERIC_STANDARD();
4670         PerlIO_printf(Perl_debug_log, "  NV = %.*g\n", DBL_DIG, SvNVX(sv));
4671     }
4672     if (SvROK(sv)) {
4673         PerlIO_printf(Perl_debug_log, "  RV = 0x%lx\n", (long)SvRV(sv));
4674         sv_dump(SvRV(sv));
4675         return;
4676     }
4677     if (type < SVt_PV)
4678         return;
4679     if (type <= SVt_PVLV) {
4680         if (SvPVX(sv))
4681             PerlIO_printf(Perl_debug_log, "  PV = 0x%lx \"%s\"\n  CUR = %ld\n  LEN = %ld\n",
4682                 (long)SvPVX(sv), SvPVX(sv), (long)SvCUR(sv), (long)SvLEN(sv));
4683         else
4684             PerlIO_printf(Perl_debug_log, "  PV = 0\n");
4685     }
4686     if (type >= SVt_PVMG) {
4687         if (SvMAGIC(sv)) {
4688             PerlIO_printf(Perl_debug_log, "  MAGIC = 0x%lx\n", (long)SvMAGIC(sv));
4689         }
4690         if (SvSTASH(sv))
4691             PerlIO_printf(Perl_debug_log, "  STASH = \"%s\"\n", HvNAME(SvSTASH(sv)));
4692     }
4693     switch (type) {
4694     case SVt_PVLV:
4695         PerlIO_printf(Perl_debug_log, "  TYPE = %c\n", LvTYPE(sv));
4696         PerlIO_printf(Perl_debug_log, "  TARGOFF = %ld\n", (long)LvTARGOFF(sv));
4697         PerlIO_printf(Perl_debug_log, "  TARGLEN = %ld\n", (long)LvTARGLEN(sv));
4698         PerlIO_printf(Perl_debug_log, "  TARG = 0x%lx\n", (long)LvTARG(sv));
4699         sv_dump(LvTARG(sv));
4700         break;
4701     case SVt_PVAV:
4702         PerlIO_printf(Perl_debug_log, "  ARRAY = 0x%lx\n", (long)AvARRAY(sv));
4703         PerlIO_printf(Perl_debug_log, "  ALLOC = 0x%lx\n", (long)AvALLOC(sv));
4704         PerlIO_printf(Perl_debug_log, "  FILL = %ld\n", (long)AvFILL(sv));
4705         PerlIO_printf(Perl_debug_log, "  MAX = %ld\n", (long)AvMAX(sv));
4706         PerlIO_printf(Perl_debug_log, "  ARYLEN = 0x%lx\n", (long)AvARYLEN(sv));
4707         flags = AvFLAGS(sv);
4708         sv_setpv(d, "");
4709         if (flags & AVf_REAL)   sv_catpv(d, ",REAL");
4710         if (flags & AVf_REIFY)  sv_catpv(d, ",REIFY");
4711         if (flags & AVf_REUSED) sv_catpv(d, ",REUSED");
4712         PerlIO_printf(Perl_debug_log, "  FLAGS = (%s)\n",
4713                       SvCUR(d) ? SvPVX(d) + 1 : "");
4714         break;
4715     case SVt_PVHV:
4716         PerlIO_printf(Perl_debug_log, "  ARRAY = 0x%lx\n",(long)HvARRAY(sv));
4717         PerlIO_printf(Perl_debug_log, "  KEYS = %ld\n", (long)HvKEYS(sv));
4718         PerlIO_printf(Perl_debug_log, "  FILL = %ld\n", (long)HvFILL(sv));
4719         PerlIO_printf(Perl_debug_log, "  MAX = %ld\n", (long)HvMAX(sv));
4720         PerlIO_printf(Perl_debug_log, "  RITER = %ld\n", (long)HvRITER(sv));
4721         PerlIO_printf(Perl_debug_log, "  EITER = 0x%lx\n",(long) HvEITER(sv));
4722         if (HvPMROOT(sv))
4723             PerlIO_printf(Perl_debug_log, "  PMROOT = 0x%lx\n",(long)HvPMROOT(sv));
4724         if (HvNAME(sv))
4725             PerlIO_printf(Perl_debug_log, "  NAME = \"%s\"\n", HvNAME(sv));
4726         break;
4727     case SVt_PVCV:
4728         if (SvPOK(sv))
4729             PerlIO_printf(Perl_debug_log, "  PROTOTYPE = \"%s\"\n", SvPV(sv,na));
4730         /* FALL THROUGH */
4731     case SVt_PVFM:
4732         PerlIO_printf(Perl_debug_log, "  STASH = 0x%lx\n", (long)CvSTASH(sv));
4733         PerlIO_printf(Perl_debug_log, "  START = 0x%lx\n", (long)CvSTART(sv));
4734         PerlIO_printf(Perl_debug_log, "  ROOT = 0x%lx\n", (long)CvROOT(sv));
4735         PerlIO_printf(Perl_debug_log, "  XSUB = 0x%lx\n", (long)CvXSUB(sv));
4736         PerlIO_printf(Perl_debug_log, "  XSUBANY = %ld\n", (long)CvXSUBANY(sv).any_i32);
4737         PerlIO_printf(Perl_debug_log, "  GV = 0x%lx", (long)CvGV(sv));
4738         if (CvGV(sv) && GvNAME(CvGV(sv))) {
4739             PerlIO_printf(Perl_debug_log, "  \"%s\"\n", GvNAME(CvGV(sv)));
4740         } else {
4741             PerlIO_printf(Perl_debug_log, "\n");
4742         }
4743         PerlIO_printf(Perl_debug_log, "  FILEGV = 0x%lx\n", (long)CvFILEGV(sv));
4744         PerlIO_printf(Perl_debug_log, "  DEPTH = %ld\n", (long)CvDEPTH(sv));
4745         PerlIO_printf(Perl_debug_log, "  PADLIST = 0x%lx\n", (long)CvPADLIST(sv));
4746         PerlIO_printf(Perl_debug_log, "  OUTSIDE = 0x%lx\n", (long)CvOUTSIDE(sv));
4747         if (type == SVt_PVFM)
4748             PerlIO_printf(Perl_debug_log, "  LINES = %ld\n", (long)FmLINES(sv));
4749         break;
4750     case SVt_PVGV:
4751         PerlIO_printf(Perl_debug_log, "  NAME = \"%s\"\n", GvNAME(sv));
4752         PerlIO_printf(Perl_debug_log, "  NAMELEN = %ld\n", (long)GvNAMELEN(sv));
4753         PerlIO_printf(Perl_debug_log, "  STASH = \"%s\"\n", HvNAME(GvSTASH(sv)));
4754         PerlIO_printf(Perl_debug_log, "  GP = 0x%lx\n", (long)GvGP(sv));
4755         PerlIO_printf(Perl_debug_log, "    SV = 0x%lx\n", (long)GvSV(sv));
4756         PerlIO_printf(Perl_debug_log, "    REFCNT = %ld\n", (long)GvREFCNT(sv));
4757         PerlIO_printf(Perl_debug_log, "    IO = 0x%lx\n", (long)GvIOp(sv));
4758         PerlIO_printf(Perl_debug_log, "    FORM = 0x%lx\n", (long)GvFORM(sv));
4759         PerlIO_printf(Perl_debug_log, "    AV = 0x%lx\n", (long)GvAV(sv));
4760         PerlIO_printf(Perl_debug_log, "    HV = 0x%lx\n", (long)GvHV(sv));
4761         PerlIO_printf(Perl_debug_log, "    CV = 0x%lx\n", (long)GvCV(sv));
4762         PerlIO_printf(Perl_debug_log, "    CVGEN = 0x%lx\n", (long)GvCVGEN(sv));
4763         PerlIO_printf(Perl_debug_log, "    LASTEXPR = %ld\n", (long)GvLASTEXPR(sv));
4764         PerlIO_printf(Perl_debug_log, "    LINE = %ld\n", (long)GvLINE(sv));
4765         PerlIO_printf(Perl_debug_log, "    FILEGV = 0x%lx\n", (long)GvFILEGV(sv));
4766         PerlIO_printf(Perl_debug_log, "    EGV = 0x%lx\n", (long)GvEGV(sv));
4767         break;
4768     case SVt_PVIO:
4769         PerlIO_printf(Perl_debug_log, "  IFP = 0x%lx\n", (long)IoIFP(sv));
4770         PerlIO_printf(Perl_debug_log, "  OFP = 0x%lx\n", (long)IoOFP(sv));
4771         PerlIO_printf(Perl_debug_log, "  DIRP = 0x%lx\n", (long)IoDIRP(sv));
4772         PerlIO_printf(Perl_debug_log, "  LINES = %ld\n", (long)IoLINES(sv));
4773         PerlIO_printf(Perl_debug_log, "  PAGE = %ld\n", (long)IoPAGE(sv));
4774         PerlIO_printf(Perl_debug_log, "  PAGE_LEN = %ld\n", (long)IoPAGE_LEN(sv));
4775         PerlIO_printf(Perl_debug_log, "  LINES_LEFT = %ld\n", (long)IoLINES_LEFT(sv));
4776         PerlIO_printf(Perl_debug_log, "  TOP_NAME = \"%s\"\n", IoTOP_NAME(sv));
4777         PerlIO_printf(Perl_debug_log, "  TOP_GV = 0x%lx\n", (long)IoTOP_GV(sv));
4778         PerlIO_printf(Perl_debug_log, "  FMT_NAME = \"%s\"\n", IoFMT_NAME(sv));
4779         PerlIO_printf(Perl_debug_log, "  FMT_GV = 0x%lx\n", (long)IoFMT_GV(sv));
4780         PerlIO_printf(Perl_debug_log, "  BOTTOM_NAME = \"%s\"\n", IoBOTTOM_NAME(sv));
4781         PerlIO_printf(Perl_debug_log, "  BOTTOM_GV = 0x%lx\n", (long)IoBOTTOM_GV(sv));
4782         PerlIO_printf(Perl_debug_log, "  SUBPROCESS = %ld\n", (long)IoSUBPROCESS(sv));
4783         PerlIO_printf(Perl_debug_log, "  TYPE = %c\n", IoTYPE(sv));
4784         PerlIO_printf(Perl_debug_log, "  FLAGS = 0x%lx\n", (long)IoFLAGS(sv));
4785         break;
4786     }
4787 }
4788 #else
4789 void
4790 sv_dump(sv)
4791 SV* sv;
4792 {
4793 }
4794 #endif