This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Eliminate Alpha warnings
[perl5.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     case SVt_PVFM:
1891         if (dtype < SVt_PV)
1892             sv_upgrade(dstr, SVt_PV);
1893         break;
1894     case SVt_PVIV:
1895         if (dtype < SVt_PVIV)
1896             sv_upgrade(dstr, SVt_PVIV);
1897         break;
1898     case SVt_PVNV:
1899         if (dtype < SVt_PVNV)
1900             sv_upgrade(dstr, SVt_PVNV);
1901         break;
1902
1903     case SVt_PVLV:
1904         sv_upgrade(dstr, SVt_PVLV);
1905         break;
1906
1907     case SVt_PVAV:
1908     case SVt_PVHV:
1909     case SVt_PVCV:
1910     case SVt_PVIO:
1911         if (op)
1912             croak("Bizarre copy of %s in %s", sv_reftype(sstr, 0),
1913                 op_name[op->op_type]);
1914         else
1915             croak("Bizarre copy of %s", sv_reftype(sstr, 0));
1916         break;
1917
1918     case SVt_PVGV:
1919         if (dtype <= SVt_PVGV) {
1920   glob_assign:
1921             if (dtype != SVt_PVGV) {
1922                 char *name = GvNAME(sstr);
1923                 STRLEN len = GvNAMELEN(sstr);
1924                 sv_upgrade(dstr, SVt_PVGV);
1925                 sv_magic(dstr, dstr, '*', name, len);
1926                 GvSTASH(dstr) = GvSTASH(sstr);
1927                 GvNAME(dstr) = savepvn(name, len);
1928                 GvNAMELEN(dstr) = len;
1929                 SvFAKE_on(dstr);        /* can coerce to non-glob */
1930             }
1931             (void)SvOK_off(dstr);
1932             GvINTRO_off(dstr);          /* one-shot flag */
1933             gp_free((GV*)dstr);
1934             GvGP(dstr) = gp_ref(GvGP(sstr));
1935             SvTAINT(dstr);
1936             if (curcop->cop_stash != GvSTASH(dstr))
1937                 GvIMPORTED_on(dstr);
1938             GvMULTI_on(dstr);
1939             return;
1940         }
1941         /* FALL THROUGH */
1942
1943     default:
1944         if (SvGMAGICAL(sstr)) {
1945             mg_get(sstr);
1946             if (SvTYPE(sstr) != stype) {
1947                 stype = SvTYPE(sstr);
1948                 if (stype == SVt_PVGV && dtype <= SVt_PVGV)
1949                     goto glob_assign;
1950             }
1951         }
1952         if (dtype < stype)
1953             sv_upgrade(dstr, stype);
1954     }
1955
1956     sflags = SvFLAGS(sstr);
1957
1958     if (sflags & SVf_ROK) {
1959         if (dtype >= SVt_PV) {
1960             if (dtype == SVt_PVGV) {
1961                 SV *sref = SvREFCNT_inc(SvRV(sstr));
1962                 SV *dref = 0;
1963                 int intro = GvINTRO(dstr);
1964
1965                 if (intro) {
1966                     GP *gp;
1967                     GvGP(dstr)->gp_refcnt--;
1968                     GvINTRO_off(dstr);  /* one-shot flag */
1969                     Newz(602,gp, 1, GP);
1970                     GvGP(dstr) = gp_ref(gp);
1971                     GvSV(dstr) = NEWSV(72,0);
1972                     GvLINE(dstr) = curcop->cop_line;
1973                     GvEGV(dstr) = (GV*)dstr;
1974                 }
1975                 GvMULTI_on(dstr);
1976                 switch (SvTYPE(sref)) {
1977                 case SVt_PVAV:
1978                     if (intro)
1979                         SAVESPTR(GvAV(dstr));
1980                     else
1981                         dref = (SV*)GvAV(dstr);
1982                     GvAV(dstr) = (AV*)sref;
1983                     if (curcop->cop_stash != GvSTASH(dstr))
1984                         GvIMPORTED_AV_on(dstr);
1985                     break;
1986                 case SVt_PVHV:
1987                     if (intro)
1988                         SAVESPTR(GvHV(dstr));
1989                     else
1990                         dref = (SV*)GvHV(dstr);
1991                     GvHV(dstr) = (HV*)sref;
1992                     if (curcop->cop_stash != GvSTASH(dstr))
1993                         GvIMPORTED_HV_on(dstr);
1994                     break;
1995                 case SVt_PVCV:
1996                     if (intro) {
1997                         if (GvCVGEN(dstr) && GvCV(dstr) != (CV*)sref) {
1998                             SvREFCNT_dec(GvCV(dstr));
1999                             GvCV(dstr) = Nullcv;
2000                             GvCVGEN(dstr) = 0; /* Switch off cacheness. */
2001                             sub_generation++;
2002                         }
2003                         SAVESPTR(GvCV(dstr));
2004                     }
2005                     else
2006                         dref = (SV*)GvCV(dstr);
2007                     if (GvCV(dstr) != (CV*)sref) {
2008                         CV* cv = GvCV(dstr);
2009                         if (cv) {
2010                             if (!GvCVGEN((GV*)dstr) &&
2011                                 (CvROOT(cv) || CvXSUB(cv)))
2012                             {
2013                                 if (cv_const_sv(cv))
2014                                     warn("Constant subroutine %s redefined",
2015                                          GvENAME((GV*)dstr));
2016                                 else if (dowarn)
2017                                     warn("Subroutine %s redefined",
2018                                          GvENAME((GV*)dstr));
2019                             }
2020                             cv_ckproto(cv, (GV*)dstr,
2021                                        SvPOK(sref) ? SvPVX(sref) : Nullch);
2022                         }
2023                         GvCV(dstr) = (CV*)sref;
2024                         GvCVGEN(dstr) = 0; /* Switch off cacheness. */
2025                         GvASSUMECV_on(dstr);
2026                         sub_generation++;
2027                     }
2028                     if (curcop->cop_stash != GvSTASH(dstr))
2029                         GvIMPORTED_CV_on(dstr);
2030                     break;
2031                 case SVt_PVIO:
2032                     if (intro)
2033                         SAVESPTR(GvIOp(dstr));
2034                     else
2035                         dref = (SV*)GvIOp(dstr);
2036                     GvIOp(dstr) = (IO*)sref;
2037                     break;
2038                 default:
2039                     if (intro)
2040                         SAVESPTR(GvSV(dstr));
2041                     else
2042                         dref = (SV*)GvSV(dstr);
2043                     GvSV(dstr) = sref;
2044                     if (curcop->cop_stash != GvSTASH(dstr))
2045                         GvIMPORTED_SV_on(dstr);
2046                     break;
2047                 }
2048                 if (dref)
2049                     SvREFCNT_dec(dref);
2050                 if (intro)
2051                     SAVEFREESV(sref);
2052                 SvTAINT(dstr);
2053                 return;
2054             }
2055             if (SvPVX(dstr)) {
2056                 (void)SvOOK_off(dstr);          /* backoff */
2057                 Safefree(SvPVX(dstr));
2058                 SvLEN(dstr)=SvCUR(dstr)=0;
2059             }
2060         }
2061         (void)SvOK_off(dstr);
2062         SvRV(dstr) = SvREFCNT_inc(SvRV(sstr));
2063         SvROK_on(dstr);
2064         if (sflags & SVp_NOK) {
2065             SvNOK_on(dstr);
2066             SvNVX(dstr) = SvNVX(sstr);
2067         }
2068         if (sflags & SVp_IOK) {
2069             (void)SvIOK_on(dstr);
2070             SvIVX(dstr) = SvIVX(sstr);
2071         }
2072 #ifdef OVERLOAD
2073         if (SvAMAGIC(sstr)) {
2074             SvAMAGIC_on(dstr);
2075         }
2076 #endif /* OVERLOAD */
2077     }
2078     else if (sflags & SVp_POK) {
2079
2080         /*
2081          * Check to see if we can just swipe the string.  If so, it's a
2082          * possible small lose on short strings, but a big win on long ones.
2083          * It might even be a win on short strings if SvPVX(dstr)
2084          * has to be allocated and SvPVX(sstr) has to be freed.
2085          */
2086
2087         if (SvTEMP(sstr) &&             /* slated for free anyway? */
2088             !(sflags & SVf_OOK))        /* and not involved in OOK hack? */
2089         {
2090             if (SvPVX(dstr)) {          /* we know that dtype >= SVt_PV */
2091                 if (SvOOK(dstr)) {
2092                     SvFLAGS(dstr) &= ~SVf_OOK;
2093                     Safefree(SvPVX(dstr) - SvIVX(dstr));
2094                 }
2095                 else
2096                     Safefree(SvPVX(dstr));
2097             }
2098             (void)SvPOK_only(dstr);
2099             SvPV_set(dstr, SvPVX(sstr));
2100             SvLEN_set(dstr, SvLEN(sstr));
2101             SvCUR_set(dstr, SvCUR(sstr));
2102             SvTEMP_off(dstr);
2103             (void)SvOK_off(sstr);
2104             SvPV_set(sstr, Nullch);
2105             SvLEN_set(sstr, 0);
2106             SvCUR_set(sstr, 0);
2107             SvTEMP_off(sstr);
2108         }
2109         else {                                  /* have to copy actual string */
2110             STRLEN len = SvCUR(sstr);
2111
2112             SvGROW(dstr, len + 1);              /* inlined from sv_setpvn */
2113             Move(SvPVX(sstr),SvPVX(dstr),len,char);
2114             SvCUR_set(dstr, len);
2115             *SvEND(dstr) = '\0';
2116             (void)SvPOK_only(dstr);
2117         }
2118         /*SUPPRESS 560*/
2119         if (sflags & SVp_NOK) {
2120             SvNOK_on(dstr);
2121             SvNVX(dstr) = SvNVX(sstr);
2122         }
2123         if (sflags & SVp_IOK) {
2124             (void)SvIOK_on(dstr);
2125             SvIVX(dstr) = SvIVX(sstr);
2126         }
2127     }
2128     else if (sflags & SVp_NOK) {
2129         SvNVX(dstr) = SvNVX(sstr);
2130         (void)SvNOK_only(dstr);
2131         if (SvIOK(sstr)) {
2132             (void)SvIOK_on(dstr);
2133             SvIVX(dstr) = SvIVX(sstr);
2134         }
2135     }
2136     else if (sflags & SVp_IOK) {
2137         (void)SvIOK_only(dstr);
2138         SvIVX(dstr) = SvIVX(sstr);
2139     }
2140     else {
2141         (void)SvOK_off(dstr);
2142     }
2143     SvTAINT(dstr);
2144 }
2145
2146 void
2147 sv_setpvn(sv,ptr,len)
2148 register SV *sv;
2149 register const char *ptr;
2150 register STRLEN len;
2151 {
2152     assert(len >= 0);  /* STRLEN is probably unsigned, so this may
2153                           elicit a warning, but it won't hurt. */
2154     if (SvTHINKFIRST(sv)) {
2155         if (SvREADONLY(sv) && curcop != &compiling)
2156             croak(no_modify);
2157         if (SvROK(sv))
2158             sv_unref(sv);
2159     }
2160     if (!ptr) {
2161         (void)SvOK_off(sv);
2162         return;
2163     }
2164     if (SvTYPE(sv) >= SVt_PV) {
2165         if (SvFAKE(sv) && SvTYPE(sv) == SVt_PVGV)
2166             sv_unglob(sv);
2167     }
2168     else if (!sv_upgrade(sv, SVt_PV))
2169         return;
2170     SvGROW(sv, len + 1);
2171     Move(ptr,SvPVX(sv),len,char);
2172     SvCUR_set(sv, len);
2173     *SvEND(sv) = '\0';
2174     (void)SvPOK_only(sv);               /* validate pointer */
2175     SvTAINT(sv);
2176 }
2177
2178 void
2179 sv_setpv(sv,ptr)
2180 register SV *sv;
2181 register const char *ptr;
2182 {
2183     register STRLEN len;
2184
2185     if (SvTHINKFIRST(sv)) {
2186         if (SvREADONLY(sv) && curcop != &compiling)
2187             croak(no_modify);
2188         if (SvROK(sv))
2189             sv_unref(sv);
2190     }
2191     if (!ptr) {
2192         (void)SvOK_off(sv);
2193         return;
2194     }
2195     len = strlen(ptr);
2196     if (SvTYPE(sv) >= SVt_PV) {
2197         if (SvFAKE(sv) && SvTYPE(sv) == SVt_PVGV)
2198             sv_unglob(sv);
2199     }
2200     else if (!sv_upgrade(sv, SVt_PV))
2201         return;
2202     SvGROW(sv, len + 1);
2203     Move(ptr,SvPVX(sv),len+1,char);
2204     SvCUR_set(sv, len);
2205     (void)SvPOK_only(sv);               /* validate pointer */
2206     SvTAINT(sv);
2207 }
2208
2209 void
2210 sv_usepvn(sv,ptr,len)
2211 register SV *sv;
2212 register char *ptr;
2213 register STRLEN len;
2214 {
2215     if (SvTHINKFIRST(sv)) {
2216         if (SvREADONLY(sv) && curcop != &compiling)
2217             croak(no_modify);
2218         if (SvROK(sv))
2219             sv_unref(sv);
2220     }
2221     if (!SvUPGRADE(sv, SVt_PV))
2222         return;
2223     if (!ptr) {
2224         (void)SvOK_off(sv);
2225         return;
2226     }
2227     if (SvPVX(sv))
2228         Safefree(SvPVX(sv));
2229     Renew(ptr, len+1, char);
2230     SvPVX(sv) = ptr;
2231     SvCUR_set(sv, len);
2232     SvLEN_set(sv, len+1);
2233     *SvEND(sv) = '\0';
2234     (void)SvPOK_only(sv);               /* validate pointer */
2235     SvTAINT(sv);
2236 }
2237
2238 void
2239 sv_chop(sv,ptr) /* like set but assuming ptr is in sv */
2240 register SV *sv;
2241 register char *ptr;
2242 {
2243     register STRLEN delta;
2244
2245     if (!ptr || !SvPOKp(sv))
2246         return;
2247     if (SvTHINKFIRST(sv)) {
2248         if (SvREADONLY(sv) && curcop != &compiling)
2249             croak(no_modify);
2250         if (SvROK(sv))
2251             sv_unref(sv);
2252     }
2253     if (SvTYPE(sv) < SVt_PVIV)
2254         sv_upgrade(sv,SVt_PVIV);
2255
2256     if (!SvOOK(sv)) {
2257         SvIVX(sv) = 0;
2258         SvFLAGS(sv) |= SVf_OOK;
2259     }
2260     SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVp_IOK|SVp_NOK);
2261     delta = ptr - SvPVX(sv);
2262     SvLEN(sv) -= delta;
2263     SvCUR(sv) -= delta;
2264     SvPVX(sv) += delta;
2265     SvIVX(sv) += delta;
2266 }
2267
2268 void
2269 sv_catpvn(sv,ptr,len)
2270 register SV *sv;
2271 register char *ptr;
2272 register STRLEN len;
2273 {
2274     STRLEN tlen;
2275     char *junk;
2276
2277     junk = SvPV_force(sv, tlen);
2278     SvGROW(sv, tlen + len + 1);
2279     if (ptr == junk)
2280         ptr = SvPVX(sv);
2281     Move(ptr,SvPVX(sv)+tlen,len,char);
2282     SvCUR(sv) += len;
2283     *SvEND(sv) = '\0';
2284     (void)SvPOK_only(sv);               /* validate pointer */
2285     SvTAINT(sv);
2286 }
2287
2288 void
2289 sv_catsv(dstr,sstr)
2290 SV *dstr;
2291 register SV *sstr;
2292 {
2293     char *s;
2294     STRLEN len;
2295     if (!sstr)
2296         return;
2297     if (s = SvPV(sstr, len))
2298         sv_catpvn(dstr,s,len);
2299 }
2300
2301 void
2302 sv_catpv(sv,ptr)
2303 register SV *sv;
2304 register char *ptr;
2305 {
2306     register STRLEN len;
2307     STRLEN tlen;
2308     char *junk;
2309
2310     if (!ptr)
2311         return;
2312     junk = SvPV_force(sv, tlen);
2313     len = strlen(ptr);
2314     SvGROW(sv, tlen + len + 1);
2315     if (ptr == junk)
2316         ptr = SvPVX(sv);
2317     Move(ptr,SvPVX(sv)+tlen,len+1,char);
2318     SvCUR(sv) += len;
2319     (void)SvPOK_only(sv);               /* validate pointer */
2320     SvTAINT(sv);
2321 }
2322
2323 SV *
2324 #ifdef LEAKTEST
2325 newSV(x,len)
2326 I32 x;
2327 #else
2328 newSV(len)
2329 #endif
2330 STRLEN len;
2331 {
2332     register SV *sv;
2333     
2334     new_SV(sv);
2335     SvANY(sv) = 0;
2336     SvREFCNT(sv) = 1;
2337     SvFLAGS(sv) = 0;
2338     if (len) {
2339         sv_upgrade(sv, SVt_PV);
2340         SvGROW(sv, len + 1);
2341     }
2342     return sv;
2343 }
2344
2345 /* name is assumed to contain an SV* if (name && namelen == HEf_SVKEY) */
2346
2347 void
2348 sv_magic(sv, obj, how, name, namlen)
2349 register SV *sv;
2350 SV *obj;
2351 int how;
2352 char *name;
2353 I32 namlen;
2354 {
2355     MAGIC* mg;
2356     
2357     if (SvREADONLY(sv) && curcop != &compiling && !strchr("gBf", how))
2358         croak(no_modify);
2359     if (SvMAGICAL(sv) || (how == 't' && SvTYPE(sv) >= SVt_PVMG)) {
2360         if (SvMAGIC(sv) && (mg = mg_find(sv, how))) {
2361             if (how == 't')
2362                 mg->mg_len |= 1;
2363             return;
2364         }
2365     }
2366     else {
2367         if (!SvUPGRADE(sv, SVt_PVMG))
2368             return;
2369     }
2370     Newz(702,mg, 1, MAGIC);
2371     mg->mg_moremagic = SvMAGIC(sv);
2372
2373     SvMAGIC(sv) = mg;
2374     if (!obj || obj == sv || how == '#')
2375         mg->mg_obj = obj;
2376     else {
2377         mg->mg_obj = SvREFCNT_inc(obj);
2378         mg->mg_flags |= MGf_REFCOUNTED;
2379     }
2380     mg->mg_type = how;
2381     mg->mg_len = namlen;
2382     if (name)
2383         if (namlen >= 0)
2384             mg->mg_ptr = savepvn(name, namlen);
2385         else if (namlen == HEf_SVKEY)
2386             mg->mg_ptr = (char*)SvREFCNT_inc((SV*)name);
2387     
2388     switch (how) {
2389     case 0:
2390         mg->mg_virtual = &vtbl_sv;
2391         break;
2392 #ifdef OVERLOAD
2393     case 'A':
2394         mg->mg_virtual = &vtbl_amagic;
2395         break;
2396     case 'a':
2397         mg->mg_virtual = &vtbl_amagicelem;
2398         break;
2399     case 'c':
2400         mg->mg_virtual = 0;
2401         break;
2402 #endif /* OVERLOAD */
2403     case 'B':
2404         mg->mg_virtual = &vtbl_bm;
2405         break;
2406     case 'E':
2407         mg->mg_virtual = &vtbl_env;
2408         break;
2409     case 'f':
2410         mg->mg_virtual = &vtbl_fm;
2411         break;
2412     case 'e':
2413         mg->mg_virtual = &vtbl_envelem;
2414         break;
2415     case 'g':
2416         mg->mg_virtual = &vtbl_mglob;
2417         break;
2418     case 'I':
2419         mg->mg_virtual = &vtbl_isa;
2420         break;
2421     case 'i':
2422         mg->mg_virtual = &vtbl_isaelem;
2423         break;
2424     case 'k':
2425         mg->mg_virtual = &vtbl_nkeys;
2426         break;
2427     case 'L':
2428         SvRMAGICAL_on(sv);
2429         mg->mg_virtual = 0;
2430         break;
2431     case 'l':
2432         mg->mg_virtual = &vtbl_dbline;
2433         break;
2434 #ifdef USE_LOCALE_COLLATE
2435     case 'o':
2436         mg->mg_virtual = &vtbl_collxfrm;
2437         break;
2438 #endif /* USE_LOCALE_COLLATE */
2439     case 'P':
2440         mg->mg_virtual = &vtbl_pack;
2441         break;
2442     case 'p':
2443     case 'q':
2444         mg->mg_virtual = &vtbl_packelem;
2445         break;
2446     case 'S':
2447         mg->mg_virtual = &vtbl_sig;
2448         break;
2449     case 's':
2450         mg->mg_virtual = &vtbl_sigelem;
2451         break;
2452     case 't':
2453         mg->mg_virtual = &vtbl_taint;
2454         mg->mg_len = 1;
2455         break;
2456     case 'U':
2457         mg->mg_virtual = &vtbl_uvar;
2458         break;
2459     case 'v':
2460         mg->mg_virtual = &vtbl_vec;
2461         break;
2462     case 'x':
2463         mg->mg_virtual = &vtbl_substr;
2464         break;
2465     case 'y':
2466         mg->mg_virtual = &vtbl_defelem;
2467         break;
2468     case '*':
2469         mg->mg_virtual = &vtbl_glob;
2470         break;
2471     case '#':
2472         mg->mg_virtual = &vtbl_arylen;
2473         break;
2474     case '.':
2475         mg->mg_virtual = &vtbl_pos;
2476         break;
2477     case '~':   /* Reserved for use by extensions not perl internals.   */
2478         /* Useful for attaching extension internal data to perl vars.   */
2479         /* Note that multiple extensions may clash if magical scalars   */
2480         /* etc holding private data from one are passed to another.     */
2481         SvRMAGICAL_on(sv);
2482         break;
2483     default:
2484         croak("Don't know how to handle magic of type '%c'", how);
2485     }
2486     mg_magical(sv);
2487     if (SvGMAGICAL(sv))
2488         SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVf_POK);
2489 }
2490
2491 int
2492 sv_unmagic(sv, type)
2493 SV* sv;
2494 int type;
2495 {
2496     MAGIC* mg;
2497     MAGIC** mgp;
2498     if (SvTYPE(sv) < SVt_PVMG || !SvMAGIC(sv))
2499         return 0;
2500     mgp = &SvMAGIC(sv);
2501     for (mg = *mgp; mg; mg = *mgp) {
2502         if (mg->mg_type == type) {
2503             MGVTBL* vtbl = mg->mg_virtual;
2504             *mgp = mg->mg_moremagic;
2505             if (vtbl && vtbl->svt_free)
2506                 (*vtbl->svt_free)(sv, mg);
2507             if (mg->mg_ptr && mg->mg_type != 'g')
2508                 if (mg->mg_len >= 0)
2509                     Safefree(mg->mg_ptr);
2510                 else if (mg->mg_len == HEf_SVKEY)
2511                     SvREFCNT_dec((SV*)mg->mg_ptr);
2512             if (mg->mg_flags & MGf_REFCOUNTED)
2513                 SvREFCNT_dec(mg->mg_obj);
2514             Safefree(mg);
2515         }
2516         else
2517             mgp = &mg->mg_moremagic;
2518     }
2519     if (!SvMAGIC(sv)) {
2520         SvMAGICAL_off(sv);
2521         SvFLAGS(sv) |= (SvFLAGS(sv) & (SVp_IOK|SVp_NOK|SVp_POK)) >> PRIVSHIFT;
2522     }
2523
2524     return 0;
2525 }
2526
2527 void
2528 sv_insert(bigstr,offset,len,little,littlelen)
2529 SV *bigstr;
2530 STRLEN offset;
2531 STRLEN len;
2532 char *little;
2533 STRLEN littlelen;
2534 {
2535     register char *big;
2536     register char *mid;
2537     register char *midend;
2538     register char *bigend;
2539     register I32 i;
2540
2541     if (!bigstr)
2542         croak("Can't modify non-existent substring");
2543     SvPV_force(bigstr, na);
2544
2545     i = littlelen - len;
2546     if (i > 0) {                        /* string might grow */
2547         big = SvGROW(bigstr, SvCUR(bigstr) + i + 1);
2548         mid = big + offset + len;
2549         midend = bigend = big + SvCUR(bigstr);
2550         bigend += i;
2551         *bigend = '\0';
2552         while (midend > mid)            /* shove everything down */
2553             *--bigend = *--midend;
2554         Move(little,big+offset,littlelen,char);
2555         SvCUR(bigstr) += i;
2556         SvSETMAGIC(bigstr);
2557         return;
2558     }
2559     else if (i == 0) {
2560         Move(little,SvPVX(bigstr)+offset,len,char);
2561         SvSETMAGIC(bigstr);
2562         return;
2563     }
2564
2565     big = SvPVX(bigstr);
2566     mid = big + offset;
2567     midend = mid + len;
2568     bigend = big + SvCUR(bigstr);
2569
2570     if (midend > bigend)
2571         croak("panic: sv_insert");
2572
2573     if (mid - big > bigend - midend) {  /* faster to shorten from end */
2574         if (littlelen) {
2575             Move(little, mid, littlelen,char);
2576             mid += littlelen;
2577         }
2578         i = bigend - midend;
2579         if (i > 0) {
2580             Move(midend, mid, i,char);
2581             mid += i;
2582         }
2583         *mid = '\0';
2584         SvCUR_set(bigstr, mid - big);
2585     }
2586     /*SUPPRESS 560*/
2587     else if (i = mid - big) {   /* faster from front */
2588         midend -= littlelen;
2589         mid = midend;
2590         sv_chop(bigstr,midend-i);
2591         big += i;
2592         while (i--)
2593             *--midend = *--big;
2594         if (littlelen)
2595             Move(little, mid, littlelen,char);
2596     }
2597     else if (littlelen) {
2598         midend -= littlelen;
2599         sv_chop(bigstr,midend);
2600         Move(little,midend,littlelen,char);
2601     }
2602     else {
2603         sv_chop(bigstr,midend);
2604     }
2605     SvSETMAGIC(bigstr);
2606 }
2607
2608 /* make sv point to what nstr did */
2609
2610 void
2611 sv_replace(sv,nsv)
2612 register SV *sv;
2613 register SV *nsv;
2614 {
2615     U32 refcnt = SvREFCNT(sv);
2616     if (SvTHINKFIRST(sv)) {
2617         if (SvREADONLY(sv) && curcop != &compiling)
2618             croak(no_modify);
2619         if (SvROK(sv))
2620             sv_unref(sv);
2621     }
2622     if (SvREFCNT(nsv) != 1)
2623         warn("Reference miscount in sv_replace()");
2624     if (SvMAGICAL(sv)) {
2625         if (SvMAGICAL(nsv))
2626             mg_free(nsv);
2627         else
2628             sv_upgrade(nsv, SVt_PVMG);
2629         SvMAGIC(nsv) = SvMAGIC(sv);
2630         SvFLAGS(nsv) |= SvMAGICAL(sv);
2631         SvMAGICAL_off(sv);
2632         SvMAGIC(sv) = 0;
2633     }
2634     SvREFCNT(sv) = 0;
2635     sv_clear(sv);
2636     assert(!SvREFCNT(sv));
2637     StructCopy(nsv,sv,SV);
2638     SvREFCNT(sv) = refcnt;
2639     SvFLAGS(nsv) |= SVTYPEMASK;         /* Mark as freed */
2640     del_SV(nsv);
2641 }
2642
2643 void
2644 sv_clear(sv)
2645 register SV *sv;
2646 {
2647     assert(sv);
2648     assert(SvREFCNT(sv) == 0);
2649
2650     if (SvOBJECT(sv)) {
2651         if (defstash) {         /* Still have a symbol table? */
2652             dSP;
2653             GV* destructor;
2654
2655             ENTER;
2656             SAVEFREESV(SvSTASH(sv));
2657
2658             destructor = gv_fetchmethod(SvSTASH(sv), "DESTROY");
2659             if (destructor) {
2660                 SV ref;
2661
2662                 Zero(&ref, 1, SV);
2663                 sv_upgrade(&ref, SVt_RV);
2664                 SvRV(&ref) = SvREFCNT_inc(sv);
2665                 SvROK_on(&ref);
2666                 SvREFCNT(&ref) = 1;     /* Fake, but otherwise
2667                                            creating+destructing a ref
2668                                            leads to disaster. */
2669
2670                 EXTEND(SP, 2);
2671                 PUSHMARK(SP);
2672                 PUSHs(&ref);
2673                 PUTBACK;
2674                 perl_call_sv((SV*)GvCV(destructor),
2675                              G_DISCARD|G_EVAL|G_KEEPERR);
2676                 del_XRV(SvANY(&ref));
2677                 SvREFCNT(sv)--;
2678             }
2679
2680             LEAVE;
2681         }
2682         else
2683             SvREFCNT_dec(SvSTASH(sv));
2684         if (SvOBJECT(sv)) {
2685             SvOBJECT_off(sv);   /* Curse the object. */
2686             if (SvTYPE(sv) != SVt_PVIO)
2687                 --sv_objcount;  /* XXX Might want something more general */
2688         }
2689         if (SvREFCNT(sv)) {
2690             SV *ret;
2691             if ( perldb
2692                  && (ret = perl_get_sv("DB::ret", FALSE))
2693                  && SvROK(ret) && SvRV(ret) == sv && SvREFCNT(sv) == 1) {
2694                 /* Debugger is prone to dangling references. */
2695                 SvRV(ret) = 0;
2696                 SvROK_off(ret);
2697                 SvREFCNT(sv) = 0;
2698             }
2699             else {
2700                 if (in_clean_objs)
2701                     croak("DESTROY created new reference to dead object");
2702                 /* DESTROY gave object new lease on life */
2703                 return;
2704             }
2705         }
2706     }
2707     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv))
2708         mg_free(sv);
2709     switch (SvTYPE(sv)) {
2710     case SVt_PVIO:
2711         if (IoIFP(sv) != PerlIO_stdin() &&
2712             IoIFP(sv) != PerlIO_stdout() &&
2713             IoIFP(sv) != PerlIO_stderr())
2714           io_close((IO*)sv);
2715         Safefree(IoTOP_NAME(sv));
2716         Safefree(IoFMT_NAME(sv));
2717         Safefree(IoBOTTOM_NAME(sv));
2718         /* FALL THROUGH */
2719     case SVt_PVBM:
2720         goto freescalar;
2721     case SVt_PVCV:
2722     case SVt_PVFM:
2723         cv_undef((CV*)sv);
2724         goto freescalar;
2725     case SVt_PVHV:
2726         hv_undef((HV*)sv);
2727         break;
2728     case SVt_PVAV:
2729         av_undef((AV*)sv);
2730         break;
2731     case SVt_PVGV:
2732         gp_free((GV*)sv);
2733         Safefree(GvNAME(sv));
2734         /* FALL THROUGH */
2735     case SVt_PVLV:
2736     case SVt_PVMG:
2737     case SVt_PVNV:
2738     case SVt_PVIV:
2739       freescalar:
2740         (void)SvOOK_off(sv);
2741         /* FALL THROUGH */
2742     case SVt_PV:
2743     case SVt_RV:
2744         if (SvROK(sv))
2745             SvREFCNT_dec(SvRV(sv));
2746         else if (SvPVX(sv) && SvLEN(sv))
2747             Safefree(SvPVX(sv));
2748         break;
2749 /*
2750     case SVt_NV:
2751     case SVt_IV:
2752     case SVt_NULL:
2753         break;
2754 */
2755     }
2756
2757     switch (SvTYPE(sv)) {
2758     case SVt_NULL:
2759         break;
2760     case SVt_IV:
2761         del_XIV(SvANY(sv));
2762         break;
2763     case SVt_NV:
2764         del_XNV(SvANY(sv));
2765         break;
2766     case SVt_RV:
2767         del_XRV(SvANY(sv));
2768         break;
2769     case SVt_PV:
2770         del_XPV(SvANY(sv));
2771         break;
2772     case SVt_PVIV:
2773         del_XPVIV(SvANY(sv));
2774         break;
2775     case SVt_PVNV:
2776         del_XPVNV(SvANY(sv));
2777         break;
2778     case SVt_PVMG:
2779         del_XPVMG(SvANY(sv));
2780         break;
2781     case SVt_PVLV:
2782         del_XPVLV(SvANY(sv));
2783         break;
2784     case SVt_PVAV:
2785         del_XPVAV(SvANY(sv));
2786         break;
2787     case SVt_PVHV:
2788         del_XPVHV(SvANY(sv));
2789         break;
2790     case SVt_PVCV:
2791         del_XPVCV(SvANY(sv));
2792         break;
2793     case SVt_PVGV:
2794         del_XPVGV(SvANY(sv));
2795         break;
2796     case SVt_PVBM:
2797         del_XPVBM(SvANY(sv));
2798         break;
2799     case SVt_PVFM:
2800         del_XPVFM(SvANY(sv));
2801         break;
2802     case SVt_PVIO:
2803         del_XPVIO(SvANY(sv));
2804         break;
2805     }
2806     SvFLAGS(sv) &= SVf_BREAK;
2807     SvFLAGS(sv) |= SVTYPEMASK;
2808 }
2809
2810 SV *
2811 sv_newref(sv)
2812 SV* sv;
2813 {
2814     if (sv)
2815         SvREFCNT(sv)++;
2816     return sv;
2817 }
2818
2819 void
2820 sv_free(sv)
2821 SV *sv;
2822 {
2823     if (!sv)
2824         return;
2825     if (SvREADONLY(sv)) {
2826         if (sv == &sv_undef || sv == &sv_yes || sv == &sv_no)
2827             return;
2828     }
2829     if (SvREFCNT(sv) == 0) {
2830         if (SvFLAGS(sv) & SVf_BREAK)
2831             return;
2832         if (in_clean_all) /* All is fair */
2833             return;
2834         warn("Attempt to free unreferenced scalar");
2835         return;
2836     }
2837     if (--SvREFCNT(sv) > 0)
2838         return;
2839 #ifdef DEBUGGING
2840     if (SvTEMP(sv)) {
2841         warn("Attempt to free temp prematurely");
2842         return;
2843     }
2844 #endif
2845     sv_clear(sv);
2846     if (! SvREFCNT(sv))
2847         del_SV(sv);
2848 }
2849
2850 STRLEN
2851 sv_len(sv)
2852 register SV *sv;
2853 {
2854     char *junk;
2855     STRLEN len;
2856
2857     if (!sv)
2858         return 0;
2859
2860     if (SvGMAGICAL(sv))
2861         len = mg_len(sv);
2862     else
2863         junk = SvPV(sv, len);
2864     return len;
2865 }
2866
2867 I32
2868 sv_eq(str1,str2)
2869 register SV *str1;
2870 register SV *str2;
2871 {
2872     char *pv1;
2873     STRLEN cur1;
2874     char *pv2;
2875     STRLEN cur2;
2876
2877     if (!str1) {
2878         pv1 = "";
2879         cur1 = 0;
2880     }
2881     else
2882         pv1 = SvPV(str1, cur1);
2883
2884     if (!str2)
2885         return !cur1;
2886     else
2887         pv2 = SvPV(str2, cur2);
2888
2889     if (cur1 != cur2)
2890         return 0;
2891
2892     return memEQ(pv1, pv2, cur1);
2893 }
2894
2895 I32
2896 sv_cmp(str1, str2)
2897 register SV *str1;
2898 register SV *str2;
2899 {
2900     STRLEN cur1 = 0;
2901     char *pv1 = str1 ? SvPV(str1, cur1) : NULL;
2902     STRLEN cur2 = 0;
2903     char *pv2 = str2 ? SvPV(str2, cur2) : NULL;
2904     I32 retval;
2905
2906     if (!cur1)
2907         return cur2 ? -1 : 0;
2908
2909     if (!cur2)
2910         return 1;
2911
2912     retval = memcmp((void*)pv1, (void*)pv2, cur1 < cur2 ? cur1 : cur2);
2913
2914     if (retval)
2915         return retval < 0 ? -1 : 1;
2916
2917     if (cur1 == cur2)
2918         return 0;
2919     else
2920         return cur1 < cur2 ? -1 : 1;
2921 }
2922
2923 I32
2924 sv_cmp_locale(sv1, sv2)
2925 register SV *sv1;
2926 register SV *sv2;
2927 {
2928 #ifdef USE_LOCALE_COLLATE
2929
2930     char *pv1, *pv2;
2931     STRLEN len1, len2;
2932     I32 retval;
2933
2934     if (collation_standard)
2935         goto raw_compare;
2936
2937     len1 = 0;
2938     pv1 = sv1 ? sv_collxfrm(sv1, &len1) : NULL;
2939     len2 = 0;
2940     pv2 = sv2 ? sv_collxfrm(sv2, &len2) : NULL;
2941
2942     if (!pv1 || !len1) {
2943         if (pv2 && len2)
2944             return -1;
2945         else
2946             goto raw_compare;
2947     }
2948     else {
2949         if (!pv2 || !len2)
2950             return 1;
2951     }
2952
2953     retval = memcmp((void*)pv1, (void*)pv2, len1 < len2 ? len1 : len2);
2954
2955     if (retval)
2956         return retval < 0 ? -1 : 1;
2957
2958     /*
2959      * When the result of collation is equality, that doesn't mean
2960      * that there are no differences -- some locales exclude some
2961      * characters from consideration.  So to avoid false equalities,
2962      * we use the raw string as a tiebreaker.
2963      */
2964
2965   raw_compare:
2966     /* FALL THROUGH */
2967
2968 #endif /* USE_LOCALE_COLLATE */
2969
2970     return sv_cmp(sv1, sv2);
2971 }
2972
2973 #ifdef USE_LOCALE_COLLATE
2974 /*
2975  * Any scalar variable may carry an 'o' magic that contains the
2976  * scalar data of the variable transformed to such a format that
2977  * a normal memory comparison can be used to compare the data
2978  * according to the locale settings.
2979  */
2980 char *
2981 sv_collxfrm(sv, nxp)
2982      SV *sv;
2983      STRLEN *nxp;
2984 {
2985     MAGIC *mg;
2986
2987     mg = SvMAGICAL(sv) ? mg_find(sv, 'o') : NULL;
2988     if (!mg || !mg->mg_ptr || *(U32*)mg->mg_ptr != collation_ix) {
2989         char *s, *xf;
2990         STRLEN len, xlen;
2991
2992         if (mg)
2993             Safefree(mg->mg_ptr);
2994         s = SvPV(sv, len);
2995         if ((xf = mem_collxfrm(s, len, &xlen))) {
2996             if (SvREADONLY(sv)) {
2997                 SAVEFREEPV(xf);
2998                 *nxp = xlen;
2999                 return xf;
3000             }
3001             if (! mg) {
3002                 sv_magic(sv, 0, 'o', 0, 0);
3003                 mg = mg_find(sv, 'o');
3004                 assert(mg);
3005             }
3006             mg->mg_ptr = xf;
3007             mg->mg_len = xlen;
3008         }
3009         else {
3010             if (mg) {
3011                 mg->mg_ptr = NULL;
3012                 mg->mg_len = -1;
3013             }
3014         }
3015     }
3016     if (mg && mg->mg_ptr) {
3017         *nxp = mg->mg_len;
3018         return mg->mg_ptr + sizeof(collation_ix);
3019     }
3020     else {
3021         *nxp = 0;
3022         return NULL;
3023     }
3024 }
3025
3026 #endif /* USE_LOCALE_COLLATE */
3027
3028 char *
3029 sv_gets(sv,fp,append)
3030 register SV *sv;
3031 register PerlIO *fp;
3032 I32 append;
3033 {
3034     char *rsptr;
3035     STRLEN rslen;
3036     register STDCHAR rslast;
3037     register STDCHAR *bp;
3038     register I32 cnt;
3039     I32 i;
3040
3041     if (SvTHINKFIRST(sv)) {
3042         if (SvREADONLY(sv) && curcop != &compiling)
3043             croak(no_modify);
3044         if (SvROK(sv))
3045             sv_unref(sv);
3046     }
3047     if (!SvUPGRADE(sv, SVt_PV))
3048         return 0;
3049     SvSCREAM_off(sv);
3050
3051     if (RsSNARF(rs)) {
3052         rsptr = NULL;
3053         rslen = 0;
3054     }
3055     else if (RsPARA(rs)) {
3056         rsptr = "\n\n";
3057         rslen = 2;
3058     }
3059     else
3060         rsptr = SvPV(rs, rslen);
3061     rslast = rslen ? rsptr[rslen - 1] : '\0';
3062
3063     if (RsPARA(rs)) {           /* have to do this both before and after */
3064         do {                    /* to make sure file boundaries work right */
3065             if (PerlIO_eof(fp))
3066                 return 0;
3067             i = PerlIO_getc(fp);
3068             if (i != '\n') {
3069                 if (i == -1)
3070                     return 0;
3071                 PerlIO_ungetc(fp,i);
3072                 break;
3073             }
3074         } while (i != EOF);
3075     }
3076
3077     /* See if we know enough about I/O mechanism to cheat it ! */
3078
3079     /* This used to be #ifdef test - it is made run-time test for ease
3080        of abstracting out stdio interface. One call should be cheap 
3081        enough here - and may even be a macro allowing compile
3082        time optimization.
3083      */
3084
3085     if (PerlIO_fast_gets(fp)) {
3086
3087     /*
3088      * We're going to steal some values from the stdio struct
3089      * and put EVERYTHING in the innermost loop into registers.
3090      */
3091     register STDCHAR *ptr;
3092     STRLEN bpx;
3093     I32 shortbuffered;
3094
3095 #if defined(VMS) && defined(PERLIO_IS_STDIO)
3096     /* An ungetc()d char is handled separately from the regular
3097      * buffer, so we getc() it back out and stuff it in the buffer.
3098      */
3099     i = PerlIO_getc(fp);
3100     if (i == EOF) return 0;
3101     *(--((*fp)->_ptr)) = (unsigned char) i;
3102     (*fp)->_cnt++;
3103 #endif
3104
3105     /* Here is some breathtakingly efficient cheating */
3106
3107     cnt = PerlIO_get_cnt(fp);                   /* get count into register */
3108     (void)SvPOK_only(sv);               /* validate pointer */
3109     if (SvLEN(sv) - append <= cnt + 1) { /* make sure we have the room */
3110         if (cnt > 80 && SvLEN(sv) > append) {
3111             shortbuffered = cnt - SvLEN(sv) + append + 1;
3112             cnt -= shortbuffered;
3113         }
3114         else {
3115             shortbuffered = 0;
3116             /* remember that cnt can be negative */
3117             SvGROW(sv, append + (cnt <= 0 ? 2 : (cnt + 1)));
3118         }
3119     }
3120     else
3121         shortbuffered = 0;
3122     bp = (STDCHAR*)SvPVX(sv) + append;  /* move these two too to registers */
3123     ptr = (STDCHAR*)PerlIO_get_ptr(fp);
3124     DEBUG_P(PerlIO_printf(Perl_debug_log,
3125         "Screamer: entering, ptr=%ld, cnt=%ld\n",(long)ptr,(long)cnt));
3126     DEBUG_P(PerlIO_printf(Perl_debug_log,
3127         "Screamer: entering: FILE * thinks ptr=%ld, cnt=%ld, base=%ld\n",
3128                (long)PerlIO_get_ptr(fp), (long)PerlIO_get_cnt(fp), 
3129                (long)(PerlIO_has_base(fp) ? PerlIO_get_base(fp) : 0)));
3130     for (;;) {
3131       screamer:
3132         if (cnt > 0) {
3133             if (rslen) {
3134                 while (cnt > 0) {                    /* this     |  eat */
3135                     cnt--;
3136                     if ((*bp++ = *ptr++) == rslast)  /* really   |  dust */
3137                         goto thats_all_folks;        /* screams  |  sed :-) */
3138                 }
3139             }
3140             else {
3141                 Copy(ptr, bp, cnt, char);            /* this     |  eat */    
3142                 bp += cnt;                           /* screams  |  dust */   
3143                 ptr += cnt;                          /* louder   |  sed :-) */
3144                 cnt = 0;
3145             }
3146         }
3147         
3148         if (shortbuffered) {            /* oh well, must extend */
3149             cnt = shortbuffered;
3150             shortbuffered = 0;
3151             bpx = bp - (STDCHAR*)SvPVX(sv); /* box up before relocation */
3152             SvCUR_set(sv, bpx);
3153             SvGROW(sv, SvLEN(sv) + append + cnt + 2);
3154             bp = (STDCHAR*)SvPVX(sv) + bpx; /* unbox after relocation */
3155             continue;
3156         }
3157
3158         DEBUG_P(PerlIO_printf(Perl_debug_log,
3159             "Screamer: going to getc, ptr=%ld, cnt=%ld\n",(long)ptr,(long)cnt));
3160         PerlIO_set_ptrcnt(fp, ptr, cnt); /* deregisterize cnt and ptr */
3161         DEBUG_P(PerlIO_printf(Perl_debug_log,
3162             "Screamer: pre: FILE * thinks ptr=%ld, cnt=%ld, base=%ld\n",
3163             (long)PerlIO_get_ptr(fp), (long)PerlIO_get_cnt(fp), 
3164             (long)(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
3165         /* This used to call 'filbuf' in stdio form, but as that behaves like 
3166            getc when cnt <= 0 we use PerlIO_getc here to avoid introducing
3167            another abstraction.  */
3168         i   = PerlIO_getc(fp);          /* get more characters */
3169         DEBUG_P(PerlIO_printf(Perl_debug_log,
3170             "Screamer: post: FILE * thinks ptr=%ld, cnt=%ld, base=%ld\n",
3171             (long)PerlIO_get_ptr(fp), (long)PerlIO_get_cnt(fp), 
3172             (long)(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
3173         cnt = PerlIO_get_cnt(fp);
3174         ptr = (STDCHAR*)PerlIO_get_ptr(fp);     /* reregisterize cnt and ptr */
3175         DEBUG_P(PerlIO_printf(Perl_debug_log,
3176             "Screamer: after getc, ptr=%ld, cnt=%ld\n",(long)ptr,(long)cnt));
3177
3178         if (i == EOF)                   /* all done for ever? */
3179             goto thats_really_all_folks;
3180
3181         bpx = bp - (STDCHAR*)SvPVX(sv); /* box up before relocation */
3182         SvCUR_set(sv, bpx);
3183         SvGROW(sv, bpx + cnt + 2);
3184         bp = (STDCHAR*)SvPVX(sv) + bpx; /* unbox after relocation */
3185
3186         *bp++ = i;                      /* store character from PerlIO_getc */
3187
3188         if (rslen && (STDCHAR)i == rslast)  /* all done for now? */
3189             goto thats_all_folks;
3190     }
3191
3192 thats_all_folks:
3193     if ((rslen > 1 && (bp - (STDCHAR*)SvPVX(sv) < rslen)) ||
3194           memNE((char*)bp - rslen, rsptr, rslen))
3195         goto screamer;                          /* go back to the fray */
3196 thats_really_all_folks:
3197     if (shortbuffered)
3198         cnt += shortbuffered;
3199         DEBUG_P(PerlIO_printf(Perl_debug_log,
3200             "Screamer: quitting, ptr=%ld, cnt=%ld\n",(long)ptr,(long)cnt));
3201     PerlIO_set_ptrcnt(fp, ptr, cnt);    /* put these back or we're in trouble */
3202     DEBUG_P(PerlIO_printf(Perl_debug_log,
3203         "Screamer: end: FILE * thinks ptr=%ld, cnt=%ld, base=%ld\n",
3204         (long)PerlIO_get_ptr(fp), (long)PerlIO_get_cnt(fp), 
3205         (long)(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
3206     *bp = '\0';
3207     SvCUR_set(sv, bp - (STDCHAR*)SvPVX(sv));    /* set length */
3208     DEBUG_P(PerlIO_printf(Perl_debug_log,
3209         "Screamer: done, len=%d, string=|%.*s|\n",
3210         SvCUR(sv),(int)SvCUR(sv),SvPVX(sv)));
3211     }
3212    else
3213     {
3214        /*The big, slow, and stupid way */
3215         STDCHAR buf[8192];
3216
3217 screamer2:
3218         if (rslen) {
3219             register STDCHAR *bpe = buf + sizeof(buf);
3220             bp = buf;
3221             while ((i = PerlIO_getc(fp)) != EOF && (*bp++ = i) != rslast && bp < bpe)
3222                 ; /* keep reading */
3223             cnt = bp - buf;
3224         }
3225         else {
3226             cnt = PerlIO_read(fp,(char*)buf, sizeof(buf));
3227             /* Accomodate broken VAXC compiler, which applies U8 cast to
3228              * both args of ?: operator, causing EOF to change into 255
3229              */
3230             if (cnt) { i = (U8)buf[cnt - 1]; } else { i = EOF; }
3231         }
3232
3233         if (append)
3234             sv_catpvn(sv, (char *) buf, cnt);
3235         else
3236             sv_setpvn(sv, (char *) buf, cnt);
3237
3238         if (i != EOF &&                 /* joy */
3239             (!rslen ||
3240              SvCUR(sv) < rslen ||
3241              memNE(SvPVX(sv) + SvCUR(sv) - rslen, rsptr, rslen)))
3242         {
3243             append = -1;
3244             goto screamer2;
3245         }
3246     }
3247
3248     if (RsPARA(rs)) {           /* have to do this both before and after */  
3249         while (i != EOF) {      /* to make sure file boundaries work right */
3250             i = PerlIO_getc(fp);
3251             if (i != '\n') {
3252                 PerlIO_ungetc(fp,i);
3253                 break;
3254             }
3255         }
3256     }
3257
3258     return (SvCUR(sv) - append) ? SvPVX(sv) : Nullch;
3259 }
3260
3261
3262 void
3263 sv_inc(sv)
3264 register SV *sv;
3265 {
3266     register char *d;
3267     int flags;
3268
3269     if (!sv)
3270         return;
3271     if (SvTHINKFIRST(sv)) {
3272         if (SvREADONLY(sv) && curcop != &compiling)
3273             croak(no_modify);
3274         if (SvROK(sv)) {
3275 #ifdef OVERLOAD
3276           if (SvAMAGIC(sv) && AMG_CALLun(sv,inc)) return;
3277 #endif /* OVERLOAD */
3278           sv_unref(sv);
3279         }
3280     }
3281     if (SvGMAGICAL(sv))
3282         mg_get(sv);
3283     flags = SvFLAGS(sv);
3284     if (flags & SVp_NOK) {
3285         (void)SvNOK_only(sv);
3286         SvNVX(sv) += 1.0;
3287         return;
3288     }
3289     if (flags & SVp_IOK) {
3290         if (SvIVX(sv) == IV_MAX)
3291             sv_setnv(sv, (double)IV_MAX + 1.0);
3292         else {
3293             (void)SvIOK_only(sv);
3294             ++SvIVX(sv);
3295         }
3296         return;
3297     }
3298     if (!(flags & SVp_POK) || !*SvPVX(sv)) {
3299         if ((flags & SVTYPEMASK) < SVt_PVNV)
3300             sv_upgrade(sv, SVt_NV);
3301         SvNVX(sv) = 1.0;
3302         (void)SvNOK_only(sv);
3303         return;
3304     }
3305     d = SvPVX(sv);
3306     while (isALPHA(*d)) d++;
3307     while (isDIGIT(*d)) d++;
3308     if (*d) {
3309         SET_NUMERIC_STANDARD();
3310         sv_setnv(sv,atof(SvPVX(sv)) + 1.0);  /* punt */
3311         return;
3312     }
3313     d--;
3314     while (d >= SvPVX(sv)) {
3315         if (isDIGIT(*d)) {
3316             if (++*d <= '9')
3317                 return;
3318             *(d--) = '0';
3319         }
3320         else {
3321             ++*d;
3322             if (isALPHA(*d))
3323                 return;
3324             *(d--) -= 'z' - 'a' + 1;
3325         }
3326     }
3327     /* oh,oh, the number grew */
3328     SvGROW(sv, SvCUR(sv) + 2);
3329     SvCUR(sv)++;
3330     for (d = SvPVX(sv) + SvCUR(sv); d > SvPVX(sv); d--)
3331         *d = d[-1];
3332     if (isDIGIT(d[1]))
3333         *d = '1';
3334     else
3335         *d = d[1];
3336 }
3337
3338 void
3339 sv_dec(sv)
3340 register SV *sv;
3341 {
3342     int flags;
3343
3344     if (!sv)
3345         return;
3346     if (SvTHINKFIRST(sv)) {
3347         if (SvREADONLY(sv) && curcop != &compiling)
3348             croak(no_modify);
3349         if (SvROK(sv)) {
3350 #ifdef OVERLOAD
3351           if (SvAMAGIC(sv) && AMG_CALLun(sv,dec)) return;
3352 #endif /* OVERLOAD */
3353           sv_unref(sv);
3354         }
3355     }
3356     if (SvGMAGICAL(sv))
3357         mg_get(sv);
3358     flags = SvFLAGS(sv);
3359     if (flags & SVp_NOK) {
3360         SvNVX(sv) -= 1.0;
3361         (void)SvNOK_only(sv);
3362         return;
3363     }
3364     if (flags & SVp_IOK) {
3365         if (SvIVX(sv) == IV_MIN)
3366             sv_setnv(sv, (double)IV_MIN - 1.0);
3367         else {
3368             (void)SvIOK_only(sv);
3369             --SvIVX(sv);
3370         }
3371         return;
3372     }
3373     if (!(flags & SVp_POK)) {
3374         if ((flags & SVTYPEMASK) < SVt_PVNV)
3375             sv_upgrade(sv, SVt_NV);
3376         SvNVX(sv) = -1.0;
3377         (void)SvNOK_only(sv);
3378         return;
3379     }
3380     SET_NUMERIC_STANDARD();
3381     sv_setnv(sv,atof(SvPVX(sv)) - 1.0); /* punt */
3382 }
3383
3384 /* Make a string that will exist for the duration of the expression
3385  * evaluation.  Actually, it may have to last longer than that, but
3386  * hopefully we won't free it until it has been assigned to a
3387  * permanent location. */
3388
3389 static void
3390 sv_mortalgrow()
3391 {
3392     tmps_max += (tmps_max < 512) ? 128 : 512;
3393     Renew(tmps_stack, tmps_max, SV*);
3394 }
3395
3396 SV *
3397 sv_mortalcopy(oldstr)
3398 SV *oldstr;
3399 {
3400     register SV *sv;
3401
3402     new_SV(sv);
3403     SvANY(sv) = 0;
3404     SvREFCNT(sv) = 1;
3405     SvFLAGS(sv) = 0;
3406     sv_setsv(sv,oldstr);
3407     if (++tmps_ix >= tmps_max)
3408         sv_mortalgrow();
3409     tmps_stack[tmps_ix] = sv;
3410     SvTEMP_on(sv);
3411     return sv;
3412 }
3413
3414 SV *
3415 sv_newmortal()
3416 {
3417     register SV *sv;
3418
3419     new_SV(sv);
3420     SvANY(sv) = 0;
3421     SvREFCNT(sv) = 1;
3422     SvFLAGS(sv) = SVs_TEMP;
3423     if (++tmps_ix >= tmps_max)
3424         sv_mortalgrow();
3425     tmps_stack[tmps_ix] = sv;
3426     return sv;
3427 }
3428
3429 /* same thing without the copying */
3430
3431 SV *
3432 sv_2mortal(sv)
3433 register SV *sv;
3434 {
3435     if (!sv)
3436         return sv;
3437     if (SvREADONLY(sv) && curcop != &compiling)
3438         croak(no_modify);
3439     if (++tmps_ix >= tmps_max)
3440         sv_mortalgrow();
3441     tmps_stack[tmps_ix] = sv;
3442     SvTEMP_on(sv);
3443     return sv;
3444 }
3445
3446 SV *
3447 newSVpv(s,len)
3448 char *s;
3449 STRLEN len;
3450 {
3451     register SV *sv;
3452
3453     new_SV(sv);
3454     SvANY(sv) = 0;
3455     SvREFCNT(sv) = 1;
3456     SvFLAGS(sv) = 0;
3457     if (!len)
3458         len = strlen(s);
3459     sv_setpvn(sv,s,len);
3460     return sv;
3461 }
3462
3463 #ifdef I_STDARG
3464 SV *
3465 newSVpvf(const char* pat, ...)
3466 #else
3467 /*VARARGS0*/
3468 SV *
3469 newSVpvf(pat, va_alist)
3470 const char *pat;
3471 va_dcl
3472 #endif
3473 {
3474     register SV *sv;
3475     va_list args;
3476
3477     new_SV(sv);
3478     SvANY(sv) = 0;
3479     SvREFCNT(sv) = 1;
3480     SvFLAGS(sv) = 0;
3481 #ifdef I_STDARG
3482     va_start(args, pat);
3483 #else
3484     va_start(args);
3485 #endif
3486     sv_vsetpvfn(sv, pat, strlen(pat), &args, Null(SV**), 0, Null(bool*));
3487     va_end(args);
3488     return sv;
3489 }
3490
3491
3492 SV *
3493 newSVnv(n)
3494 double n;
3495 {
3496     register SV *sv;
3497
3498     new_SV(sv);
3499     SvANY(sv) = 0;
3500     SvREFCNT(sv) = 1;
3501     SvFLAGS(sv) = 0;
3502     sv_setnv(sv,n);
3503     return sv;
3504 }
3505
3506 SV *
3507 newSViv(i)
3508 IV i;
3509 {
3510     register SV *sv;
3511
3512     new_SV(sv);
3513     SvANY(sv) = 0;
3514     SvREFCNT(sv) = 1;
3515     SvFLAGS(sv) = 0;
3516     sv_setiv(sv,i);
3517     return sv;
3518 }
3519
3520 SV *
3521 newRV(ref)
3522 SV *ref;
3523 {
3524     register SV *sv;
3525
3526     new_SV(sv);
3527     SvANY(sv) = 0;
3528     SvREFCNT(sv) = 1;
3529     SvFLAGS(sv) = 0;
3530     sv_upgrade(sv, SVt_RV);
3531     SvTEMP_off(ref);
3532     SvRV(sv) = SvREFCNT_inc(ref);
3533     SvROK_on(sv);
3534     return sv;
3535 }
3536
3537 #ifdef CRIPPLED_CC
3538 SV *
3539 newRV_noinc(ref)
3540 SV *ref;
3541 {
3542     register SV *sv;
3543
3544     sv = newRV(ref);
3545     SvREFCNT_dec(ref);
3546     return sv;
3547 }
3548 #endif /* CRIPPLED_CC */
3549
3550 /* make an exact duplicate of old */
3551
3552 SV *
3553 newSVsv(old)
3554 register SV *old;
3555 {
3556     register SV *sv;
3557
3558     if (!old)
3559         return Nullsv;
3560     if (SvTYPE(old) == SVTYPEMASK) {
3561         warn("semi-panic: attempt to dup freed string");
3562         return Nullsv;
3563     }
3564     new_SV(sv);
3565     SvANY(sv) = 0;
3566     SvREFCNT(sv) = 1;
3567     SvFLAGS(sv) = 0;
3568     if (SvTEMP(old)) {
3569         SvTEMP_off(old);
3570         sv_setsv(sv,old);
3571         SvTEMP_on(old);
3572     }
3573     else
3574         sv_setsv(sv,old);
3575     return sv;
3576 }
3577
3578 void
3579 sv_reset(s,stash)
3580 register char *s;
3581 HV *stash;
3582 {
3583     register HE *entry;
3584     register GV *gv;
3585     register SV *sv;
3586     register I32 i;
3587     register PMOP *pm;
3588     register I32 max;
3589     char todo[256];
3590
3591     if (!*s) {          /* reset ?? searches */
3592         for (pm = HvPMROOT(stash); pm; pm = pm->op_pmnext) {
3593             pm->op_pmflags &= ~PMf_USED;
3594         }
3595         return;
3596     }
3597
3598     /* reset variables */
3599
3600     if (!HvARRAY(stash))
3601         return;
3602
3603     Zero(todo, 256, char);
3604     while (*s) {
3605         i = *s;
3606         if (s[1] == '-') {
3607             s += 2;
3608         }
3609         max = *s++;
3610         for ( ; i <= max; i++) {
3611             todo[i] = 1;
3612         }
3613         for (i = 0; i <= (I32) HvMAX(stash); i++) {
3614             for (entry = HvARRAY(stash)[i];
3615               entry;
3616               entry = HeNEXT(entry)) {
3617                 if (!todo[(U8)*HeKEY(entry)])
3618                     continue;
3619                 gv = (GV*)HeVAL(entry);
3620                 sv = GvSV(gv);
3621                 (void)SvOK_off(sv);
3622                 if (SvTYPE(sv) >= SVt_PV) {
3623                     SvCUR_set(sv, 0);
3624                     if (SvPVX(sv) != Nullch)
3625                         *SvPVX(sv) = '\0';
3626                     SvTAINT(sv);
3627                 }
3628                 if (GvAV(gv)) {
3629                     av_clear(GvAV(gv));
3630                 }
3631                 if (GvHV(gv) && !HvNAME(GvHV(gv))) {
3632                     hv_clear(GvHV(gv));
3633 #ifndef VMS  /* VMS has no environ array */
3634                     if (gv == envgv)
3635                         environ[0] = Nullch;
3636 #endif
3637                 }
3638             }
3639         }
3640     }
3641 }
3642
3643 IO*
3644 sv_2io(sv)
3645 SV *sv;
3646 {
3647     IO* io;
3648     GV* gv;
3649
3650     switch (SvTYPE(sv)) {
3651     case SVt_PVIO:
3652         io = (IO*)sv;
3653         break;
3654     case SVt_PVGV:
3655         gv = (GV*)sv;
3656         io = GvIO(gv);
3657         if (!io)
3658             croak("Bad filehandle: %s", GvNAME(gv));
3659         break;
3660     default:
3661         if (!SvOK(sv))
3662             croak(no_usym, "filehandle");
3663         if (SvROK(sv))
3664             return sv_2io(SvRV(sv));
3665         gv = gv_fetchpv(SvPV(sv,na), FALSE, SVt_PVIO);
3666         if (gv)
3667             io = GvIO(gv);
3668         else
3669             io = 0;
3670         if (!io)
3671             croak("Bad filehandle: %s", SvPV(sv,na));
3672         break;
3673     }
3674     return io;
3675 }
3676
3677 CV *
3678 sv_2cv(sv, st, gvp, lref)
3679 SV *sv;
3680 HV **st;
3681 GV **gvp;
3682 I32 lref;
3683 {
3684     GV *gv;
3685     CV *cv;
3686
3687     if (!sv)
3688         return *gvp = Nullgv, Nullcv;
3689     switch (SvTYPE(sv)) {
3690     case SVt_PVCV:
3691         *st = CvSTASH(sv);
3692         *gvp = Nullgv;
3693         return (CV*)sv;
3694     case SVt_PVHV:
3695     case SVt_PVAV:
3696         *gvp = Nullgv;
3697         return Nullcv;
3698     case SVt_PVGV:
3699         gv = (GV*)sv;
3700         *gvp = gv;
3701         *st = GvESTASH(gv);
3702         goto fix_gv;
3703
3704     default:
3705         if (SvGMAGICAL(sv))
3706             mg_get(sv);
3707         if (SvROK(sv)) {
3708             cv = (CV*)SvRV(sv);
3709             if (SvTYPE(cv) != SVt_PVCV)
3710                 croak("Not a subroutine reference");
3711             *gvp = Nullgv;
3712             *st = CvSTASH(cv);
3713             return cv;
3714         }
3715         if (isGV(sv))
3716             gv = (GV*)sv;
3717         else
3718             gv = gv_fetchpv(SvPV(sv, na), lref, SVt_PVCV);
3719         *gvp = gv;
3720         if (!gv)
3721             return Nullcv;
3722         *st = GvESTASH(gv);
3723     fix_gv:
3724         if (lref && !GvCVu(gv)) {
3725             SV *tmpsv;
3726             ENTER;
3727             tmpsv = NEWSV(704,0);
3728             gv_efullname3(tmpsv, gv, Nullch);
3729             newSUB(start_subparse(FALSE, 0),
3730                    newSVOP(OP_CONST, 0, tmpsv),
3731                    Nullop,
3732                    Nullop);
3733             LEAVE;
3734             if (!GvCVu(gv))
3735                 croak("Unable to create sub named \"%s\"", SvPV(sv,na));
3736         }
3737         return GvCVu(gv);
3738     }
3739 }
3740
3741 #ifndef SvTRUE
3742 I32
3743 SvTRUE(sv)
3744 register SV *sv;
3745 {
3746     if (!sv)
3747         return 0;
3748     if (SvGMAGICAL(sv))
3749         mg_get(sv);
3750     if (SvPOK(sv)) {
3751         register XPV* Xpv;
3752         if ((Xpv = (XPV*)SvANY(sv)) &&
3753                 (*Xpv->xpv_pv > '0' ||
3754                 Xpv->xpv_cur > 1 ||
3755                 (Xpv->xpv_cur && *Xpv->xpv_pv != '0')))
3756             return 1;
3757         else
3758             return 0;
3759     }
3760     else {
3761         if (SvIOK(sv))
3762             return SvIVX(sv) != 0;
3763         else {
3764             if (SvNOK(sv))
3765                 return SvNVX(sv) != 0.0;
3766             else
3767                 return sv_2bool(sv);
3768         }
3769     }
3770 }
3771 #endif /* !SvTRUE */
3772
3773 #ifndef SvIV
3774 IV
3775 SvIV(sv)
3776 register SV *sv;
3777 {
3778     if (SvIOK(sv))
3779         return SvIVX(sv);
3780     return sv_2iv(sv);
3781 }
3782 #endif /* !SvIV */
3783
3784 #ifndef SvUV
3785 UV
3786 SvUV(sv)
3787 register SV *sv;
3788 {
3789     if (SvIOK(sv))
3790         return SvUVX(sv);
3791     return sv_2uv(sv);
3792 }
3793 #endif /* !SvUV */
3794
3795 #ifndef SvNV
3796 double
3797 SvNV(sv)
3798 register SV *sv;
3799 {
3800     if (SvNOK(sv))
3801         return SvNVX(sv);
3802     return sv_2nv(sv);
3803 }
3804 #endif /* !SvNV */
3805
3806 #ifdef CRIPPLED_CC
3807 char *
3808 sv_pvn(sv, lp)
3809 SV *sv;
3810 STRLEN *lp;
3811 {
3812     if (SvPOK(sv)) {
3813         *lp = SvCUR(sv);
3814         return SvPVX(sv);
3815     }
3816     return sv_2pv(sv, lp);
3817 }
3818 #endif
3819
3820 char *
3821 sv_pvn_force(sv, lp)
3822 SV *sv;
3823 STRLEN *lp;
3824 {
3825     char *s;
3826
3827     if (SvREADONLY(sv) && curcop != &compiling)
3828         croak(no_modify);
3829     
3830     if (SvPOK(sv)) {
3831         *lp = SvCUR(sv);
3832     }
3833     else {
3834         if (SvTYPE(sv) > SVt_PVLV && SvTYPE(sv) != SVt_PVFM) {
3835             if (SvFAKE(sv) && SvTYPE(sv) == SVt_PVGV) {
3836                 sv_unglob(sv);
3837                 s = SvPVX(sv);
3838                 *lp = SvCUR(sv);
3839             }
3840             else
3841                 croak("Can't coerce %s to string in %s", sv_reftype(sv,0),
3842                     op_name[op->op_type]);
3843         }
3844         else
3845             s = sv_2pv(sv, lp);
3846         if (s != SvPVX(sv)) {   /* Almost, but not quite, sv_setpvn() */
3847             STRLEN len = *lp;
3848             
3849             if (SvROK(sv))
3850                 sv_unref(sv);
3851             (void)SvUPGRADE(sv, SVt_PV);                /* Never FALSE */
3852             SvGROW(sv, len + 1);
3853             Move(s,SvPVX(sv),len,char);
3854             SvCUR_set(sv, len);
3855             *SvEND(sv) = '\0';
3856         }
3857         if (!SvPOK(sv)) {
3858             SvPOK_on(sv);               /* validate pointer */
3859             SvTAINT(sv);
3860             DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%lx 2pv(%s)\n",
3861                 (unsigned long)sv,SvPVX(sv)));
3862         }
3863     }
3864     return SvPVX(sv);
3865 }
3866
3867 char *
3868 sv_reftype(sv, ob)
3869 SV* sv;
3870 int ob;
3871 {
3872     if (ob && SvOBJECT(sv))
3873         return HvNAME(SvSTASH(sv));
3874     else {
3875         switch (SvTYPE(sv)) {
3876         case SVt_NULL:
3877         case SVt_IV:
3878         case SVt_NV:
3879         case SVt_RV:
3880         case SVt_PV:
3881         case SVt_PVIV:
3882         case SVt_PVNV:
3883         case SVt_PVMG:
3884         case SVt_PVBM:
3885                                 if (SvROK(sv))
3886                                     return "REF";
3887                                 else
3888                                     return "SCALAR";
3889         case SVt_PVLV:          return "LVALUE";
3890         case SVt_PVAV:          return "ARRAY";
3891         case SVt_PVHV:          return "HASH";
3892         case SVt_PVCV:          return "CODE";
3893         case SVt_PVGV:          return "GLOB";
3894         case SVt_PVFM:          return "FORMLINE";
3895         default:                return "UNKNOWN";
3896         }
3897     }
3898 }
3899
3900 int
3901 sv_isobject(sv)
3902 SV *sv;
3903 {
3904     if (!sv)
3905         return 0;
3906     if (SvGMAGICAL(sv))
3907         mg_get(sv);
3908     if (!SvROK(sv))
3909         return 0;
3910     sv = (SV*)SvRV(sv);
3911     if (!SvOBJECT(sv))
3912         return 0;
3913     return 1;
3914 }
3915
3916 int
3917 sv_isa(sv, name)
3918 SV *sv;
3919 char *name;
3920 {
3921     if (!sv)
3922         return 0;
3923     if (SvGMAGICAL(sv))
3924         mg_get(sv);
3925     if (!SvROK(sv))
3926         return 0;
3927     sv = (SV*)SvRV(sv);
3928     if (!SvOBJECT(sv))
3929         return 0;
3930
3931     return strEQ(HvNAME(SvSTASH(sv)), name);
3932 }
3933
3934 SV*
3935 newSVrv(rv, classname)
3936 SV *rv;
3937 char *classname;
3938 {
3939     SV *sv;
3940
3941     new_SV(sv);
3942     SvANY(sv) = 0;
3943     SvREFCNT(sv) = 0;
3944     SvFLAGS(sv) = 0;
3945     sv_upgrade(rv, SVt_RV);
3946     SvRV(rv) = SvREFCNT_inc(sv);
3947     SvROK_on(rv);
3948
3949     if (classname) {
3950         HV* stash = gv_stashpv(classname, TRUE);
3951         (void)sv_bless(rv, stash);
3952     }
3953     return sv;
3954 }
3955
3956 SV*
3957 sv_setref_pv(rv, classname, pv)
3958 SV *rv;
3959 char *classname;
3960 void* pv;
3961 {
3962     if (!pv)
3963         sv_setsv(rv, &sv_undef);
3964     else
3965         sv_setiv(newSVrv(rv,classname), (IV)pv);
3966     return rv;
3967 }
3968
3969 SV*
3970 sv_setref_iv(rv, classname, iv)
3971 SV *rv;
3972 char *classname;
3973 IV iv;
3974 {
3975     sv_setiv(newSVrv(rv,classname), iv);
3976     return rv;
3977 }
3978
3979 SV*
3980 sv_setref_nv(rv, classname, nv)
3981 SV *rv;
3982 char *classname;
3983 double nv;
3984 {
3985     sv_setnv(newSVrv(rv,classname), nv);
3986     return rv;
3987 }
3988
3989 SV*
3990 sv_setref_pvn(rv, classname, pv, n)
3991 SV *rv;
3992 char *classname;
3993 char* pv;
3994 I32 n;
3995 {
3996     sv_setpvn(newSVrv(rv,classname), pv, n);
3997     return rv;
3998 }
3999
4000 SV*
4001 sv_bless(sv,stash)
4002 SV* sv;
4003 HV* stash;
4004 {
4005     SV *ref;
4006     if (!SvROK(sv))
4007         croak("Can't bless non-reference value");
4008     ref = SvRV(sv);
4009     if (SvFLAGS(ref) & (SVs_OBJECT|SVf_READONLY)) {
4010         if (SvREADONLY(ref))
4011             croak(no_modify);
4012         if (SvOBJECT(ref)) {
4013             if (SvTYPE(ref) != SVt_PVIO)
4014                 --sv_objcount;
4015             SvREFCNT_dec(SvSTASH(ref));
4016         }
4017     }
4018     SvOBJECT_on(ref);
4019     if (SvTYPE(ref) != SVt_PVIO)
4020         ++sv_objcount;
4021     (void)SvUPGRADE(ref, SVt_PVMG);
4022     SvSTASH(ref) = (HV*)SvREFCNT_inc(stash);
4023
4024 #ifdef OVERLOAD
4025     if (Gv_AMG(stash))
4026         SvAMAGIC_on(sv);
4027     else
4028         SvAMAGIC_off(sv);
4029 #endif /* OVERLOAD */
4030
4031     return sv;
4032 }
4033
4034 static void
4035 sv_unglob(sv)
4036 SV* sv;
4037 {
4038     assert(SvTYPE(sv) == SVt_PVGV);
4039     SvFAKE_off(sv);
4040     if (GvGP(sv))
4041         gp_free((GV*)sv);
4042     sv_unmagic(sv, '*');
4043     Safefree(GvNAME(sv));
4044     GvMULTI_off(sv);
4045     SvFLAGS(sv) &= ~SVTYPEMASK;
4046     SvFLAGS(sv) |= SVt_PVMG;
4047 }
4048
4049 void
4050 sv_unref(sv)
4051 SV* sv;
4052 {
4053     SV* rv = SvRV(sv);
4054     
4055     SvRV(sv) = 0;
4056     SvROK_off(sv);
4057     if (SvREFCNT(rv) != 1 || SvREADONLY(rv))
4058         SvREFCNT_dec(rv);
4059     else
4060         sv_2mortal(rv);         /* Schedule for freeing later */
4061 }
4062
4063 void
4064 sv_taint(sv)
4065 SV *sv;
4066 {
4067     sv_magic((sv), Nullsv, 't', Nullch, 0);
4068 }
4069
4070 void
4071 sv_untaint(sv)
4072 SV *sv;
4073 {
4074     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv)) {
4075         MAGIC *mg = mg_find(sv, 't');
4076         if (mg)
4077             mg->mg_len &= ~1;
4078     }
4079 }
4080
4081 bool
4082 sv_tainted(sv)
4083 SV *sv;
4084 {
4085     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv)) {
4086         MAGIC *mg = mg_find(sv, 't');
4087         if (mg && ((mg->mg_len & 1) || (mg->mg_len & 2) && mg->mg_obj == sv))
4088             return TRUE;
4089     }
4090     return FALSE;
4091 }
4092
4093 #ifdef I_STDARG
4094 void
4095 sv_setpvf(SV *sv, const char* pat, ...)
4096 #else
4097 /*VARARGS0*/
4098 void
4099 sv_setpvf(sv, pat, va_alist)
4100     SV *sv;
4101     const char *pat;
4102     va_dcl
4103 #endif
4104 {
4105     va_list args;
4106 #ifdef I_STDARG
4107     va_start(args, pat);
4108 #else
4109     va_start(args);
4110 #endif
4111     sv_vsetpvfn(sv, pat, strlen(pat), &args, Null(SV**), 0, Null(bool*));
4112     va_end(args);
4113 }
4114
4115 #ifdef I_STDARG
4116 void
4117 sv_catpvf(SV *sv, const char* pat, ...)
4118 #else
4119 /*VARARGS0*/
4120 void
4121 sv_catpvf(sv, pat, va_alist)
4122     SV *sv;
4123     const char *pat;
4124     va_dcl
4125 #endif
4126 {
4127     va_list args;
4128 #ifdef I_STDARG
4129     va_start(args, pat);
4130 #else
4131     va_start(args);
4132 #endif
4133     sv_vcatpvfn(sv, pat, strlen(pat), &args, Null(SV**), 0, Null(bool*));
4134     va_end(args);
4135 }
4136
4137 void
4138 sv_vsetpvfn(sv, pat, patlen, args, svargs, svmax, used_locale)
4139     SV *sv;
4140     const char *pat;
4141     STRLEN patlen;
4142     va_list *args;
4143     SV **svargs;
4144     I32 svmax;
4145     bool *used_locale;
4146 {
4147     sv_setpvn(sv, "", 0);
4148     sv_vcatpvfn(sv, pat, patlen, args, svargs, svmax, used_locale);
4149 }
4150
4151 void
4152 sv_vcatpvfn(sv, pat, patlen, args, svargs, svmax, used_locale)
4153     SV *sv;
4154     const char *pat;
4155     STRLEN patlen;
4156     va_list *args;
4157     SV **svargs;
4158     I32 svmax;
4159     bool *used_locale;
4160 {
4161     char *p;
4162     char *q;
4163     char *patend;
4164     STRLEN origlen;
4165     I32 svix = 0;
4166
4167     /* no matter what, this is a string now */
4168     (void)SvPV_force(sv, origlen);
4169
4170     /* special-case "", "%s", and "%_" */
4171     if (patlen == 0)
4172         return;
4173     if (patlen == 2 && pat[0] == '%') {
4174         switch (pat[1]) {
4175         case 's':
4176             if (args)
4177                 sv_catpv(sv, va_arg(*args, char*));
4178             else if (svix < svmax)
4179                 sv_catsv(sv, *svargs);
4180             return;
4181         case '_':
4182             if (args) {
4183                 sv_catsv(sv, va_arg(*args, SV*));
4184                 return;
4185             }
4186             /* See comment on '_' below */
4187             break;
4188         }
4189     }
4190
4191     patend = (char*)pat + patlen;
4192     for (p = (char*)pat; p < patend; p = q) {
4193         bool alt = FALSE;
4194         bool left = FALSE;
4195         char fill = ' ';
4196         char plus = 0;
4197         char intsize = 0;
4198         STRLEN width = 0;
4199         STRLEN zeros = 0;
4200         bool has_precis = FALSE;
4201         STRLEN precis = 0;
4202
4203         char esignbuf[4];
4204         STRLEN esignlen = 0;
4205
4206         char *eptr = Nullch;
4207         STRLEN elen = 0;
4208         char ebuf[TYPE_DIGITS(int) * 2 + 16]; /* large enough for "%#.#f" */
4209
4210         static char *efloatbuf = Nullch;
4211         static STRLEN efloatsize = 0;
4212
4213         char c;
4214         int i;
4215         unsigned base;
4216         IV iv;
4217         UV uv;
4218         double nv;
4219         STRLEN have;
4220         STRLEN need;
4221         STRLEN gap;
4222
4223         for (q = p; q < patend && *q != '%'; ++q) ;
4224         if (q > p) {
4225             sv_catpvn(sv, p, q - p);
4226             p = q;
4227         }
4228         if (q++ >= patend)
4229             break;
4230
4231         /* FLAGS */
4232
4233         while (*q) {
4234             switch (*q) {
4235             case ' ':
4236             case '+':
4237                 plus = *q++;
4238                 continue;
4239
4240             case '-':
4241                 left = TRUE;
4242                 q++;
4243                 continue;
4244
4245             case '0':
4246                 fill = *q++;
4247                 continue;
4248
4249             case '#':
4250                 alt = TRUE;
4251                 q++;
4252                 continue;
4253
4254             default:
4255                 break;
4256             }
4257             break;
4258         }
4259
4260         /* WIDTH */
4261
4262         switch (*q) {
4263         case '1': case '2': case '3':
4264         case '4': case '5': case '6':
4265         case '7': case '8': case '9':
4266             width = 0;
4267             while (isDIGIT(*q))
4268                 width = width * 10 + (*q++ - '0');
4269             break;
4270
4271         case '*':
4272             if (args)
4273                 i = va_arg(*args, int);
4274             else
4275                 i = (svix < svmax) ? SvIVx(svargs[svix++]) : 0;
4276             left |= (i < 0);
4277             width = (i < 0) ? -i : i;
4278             q++;
4279             break;
4280         }
4281
4282         /* PRECISION */
4283
4284         if (*q == '.') {
4285             q++;
4286             if (*q == '*') {
4287                 if (args)
4288                     i = va_arg(*args, int);
4289                 else
4290                     i = (svix < svmax) ? SvIVx(svargs[svix++]) : 0;
4291                 precis = (i < 0) ? 0 : i;
4292                 q++;
4293             }
4294             else {
4295                 precis = 0;
4296                 while (isDIGIT(*q))
4297                     precis = precis * 10 + (*q++ - '0');
4298             }
4299             has_precis = TRUE;
4300         }
4301
4302         /* SIZE */
4303
4304         switch (*q) {
4305         case 'l':
4306 #if 0  /* when quads have better support within Perl */
4307             if (*(q + 1) == 'l') {
4308                 intsize = 'q';
4309                 q += 2;
4310                 break;
4311             }
4312 #endif
4313             /* FALL THROUGH */
4314         case 'h':
4315         case 'V':
4316             intsize = *q++;
4317             break;
4318         }
4319
4320         /* CONVERSION */
4321
4322         switch (c = *q++) {
4323
4324             /* STRINGS */
4325
4326         case '%':
4327             eptr = q - 1;
4328             elen = 1;
4329             goto string;
4330
4331         case 'c':
4332             if (args)
4333                 c = va_arg(*args, int);
4334             else
4335                 c = (svix < svmax) ? SvIVx(svargs[svix++]) : 0;
4336             eptr = &c;
4337             elen = 1;
4338             goto string;
4339
4340         case 's':
4341             if (args) {
4342                 eptr = va_arg(*args, char*);
4343                 elen = strlen(eptr);
4344             }
4345             else if (svix < svmax)
4346                 eptr = SvPVx(svargs[svix++], elen);
4347             goto string;
4348
4349         case '_':
4350             /*
4351              * The "%_" hack might have to be changed someday,
4352              * if ISO or ANSI decide to use '_' for something.
4353              * So we keep it hidden from users' code.
4354              */
4355             if (!args)
4356                 goto unknown;
4357             eptr = SvPVx(va_arg(*args, SV*), elen);
4358
4359         string:
4360             if (has_precis && elen > precis)
4361                 elen = precis;
4362             break;
4363
4364             /* INTEGERS */
4365
4366         case 'p':
4367             if (args)
4368                 uv = (UV)va_arg(*args, void*);
4369             else
4370                 uv = (svix < svmax) ? (UV)svargs[svix++] : 0;
4371             base = 16;
4372             goto integer;
4373
4374         case 'D':
4375             intsize = 'l';
4376             /* FALL THROUGH */
4377         case 'd':
4378         case 'i':
4379             if (args) {
4380                 switch (intsize) {
4381                 case 'h':       iv = (short)va_arg(*args, int); break;
4382                 default:        iv = va_arg(*args, int); break;
4383                 case 'l':       iv = va_arg(*args, long); break;
4384                 case 'V':       iv = va_arg(*args, IV); break;
4385                 }
4386             }
4387             else {
4388                 iv = (svix < svmax) ? SvIVx(svargs[svix++]) : 0;
4389                 switch (intsize) {
4390                 case 'h':       iv = (short)iv; break;
4391                 default:        iv = (int)iv; break;
4392                 case 'l':       iv = (long)iv; break;
4393                 case 'V':       break;
4394                 }
4395             }
4396             if (iv >= 0) {
4397                 uv = iv;
4398                 if (plus)
4399                     esignbuf[esignlen++] = plus;
4400             }
4401             else {
4402                 uv = -iv;
4403                 esignbuf[esignlen++] = '-';
4404             }
4405             base = 10;
4406             goto integer;
4407
4408         case 'U':
4409             intsize = 'l';
4410             /* FALL THROUGH */
4411         case 'u':
4412             base = 10;
4413             goto uns_integer;
4414
4415         case 'O':
4416             intsize = 'l';
4417             /* FALL THROUGH */
4418         case 'o':
4419             base = 8;
4420             goto uns_integer;
4421
4422         case 'X':
4423         case 'x':
4424             base = 16;
4425
4426         uns_integer:
4427             if (args) {
4428                 switch (intsize) {
4429                 case 'h':  uv = (unsigned short)va_arg(*args, unsigned); break;
4430                 default:   uv = va_arg(*args, unsigned); break;
4431                 case 'l':  uv = va_arg(*args, unsigned long); break;
4432                 case 'V':  uv = va_arg(*args, UV); break;
4433                 }
4434             }
4435             else {
4436                 uv = (svix < svmax) ? SvUVx(svargs[svix++]) : 0;
4437                 switch (intsize) {
4438                 case 'h':       uv = (unsigned short)uv; break;
4439                 default:        uv = (unsigned)uv; break;
4440                 case 'l':       uv = (unsigned long)uv; break;
4441                 case 'V':       break;
4442                 }
4443             }
4444
4445         integer:
4446             eptr = ebuf + sizeof ebuf;
4447             switch (base) {
4448                 unsigned dig;
4449             case 16:
4450                 p = (c == 'X') ? "0123456789ABCDEF" : "0123456789abcdef";
4451                 do {
4452                     dig = uv & 15;
4453                     *--eptr = p[dig];
4454                 } while (uv >>= 4);
4455                 if (alt) {
4456                     esignbuf[esignlen++] = '0';
4457                     esignbuf[esignlen++] = c;  /* 'x' or 'X' */
4458                 }
4459                 break;
4460             case 8:
4461                 do {
4462                     dig = uv & 7;
4463                     *--eptr = '0' + dig;
4464                 } while (uv >>= 3);
4465                 if (alt && *eptr != '0')
4466                     *--eptr = '0';
4467                 break;
4468             default:            /* it had better be ten or less */
4469                 do {
4470                     dig = uv % base;
4471                     *--eptr = '0' + dig;
4472                 } while (uv /= base);
4473                 break;
4474             }
4475             elen = (ebuf + sizeof ebuf) - eptr;
4476             if (has_precis && precis > elen)
4477                 zeros = precis - elen;
4478             break;
4479
4480             /* FLOATING POINT */
4481
4482         case 'F':
4483             c = 'f';            /* maybe %F isn't supported here */
4484             /* FALL THROUGH */
4485         case 'e': case 'E':
4486         case 'f':
4487         case 'g': case 'G':
4488
4489             /* This is evil, but floating point is even more evil */
4490
4491             if (args)
4492                 nv = va_arg(*args, double);
4493             else
4494                 nv = (svix < svmax) ? SvNVx(svargs[svix++]) : 0.0;
4495
4496             need = 0;
4497             if (c != 'e' && c != 'E') {
4498                 i = PERL_INT_MIN;
4499                 (void)frexp(nv, &i);
4500                 if (i == PERL_INT_MIN)
4501                     need = 400; /* busted -- be safe */
4502                 else if (i > 0)
4503                     need = BIT_DIGITS(i);
4504             }
4505             need += has_precis ? precis : 6; /* known default */
4506             if (need < width)
4507                 need = width;
4508
4509             need += 20; /* fudge factor */
4510             if (efloatsize < need) {
4511                 Safefree(efloatbuf);
4512                 efloatsize = need + 20; /* more fudge */
4513                 New(906, efloatbuf, efloatsize, char);
4514             }
4515
4516             eptr = ebuf + sizeof ebuf;
4517             *--eptr = '\0';
4518             *--eptr = c;
4519             if (has_precis) {
4520                 base = precis;
4521                 do { *--eptr = '0' + (base % 10); } while (base /= 10);
4522                 *--eptr = '.';
4523             }
4524             if (width) {
4525                 base = width;
4526                 do { *--eptr = '0' + (base % 10); } while (base /= 10);
4527             }
4528             if (fill == '0')
4529                 *--eptr = fill;
4530             if (plus)
4531                 *--eptr = plus;
4532             if (alt)
4533                 *--eptr = '#';
4534             *--eptr = '%';
4535
4536             (void)sprintf(efloatbuf, eptr, nv);
4537
4538             eptr = efloatbuf;
4539             elen = strlen(efloatbuf);
4540
4541 #ifdef LC_NUMERIC
4542             /*
4543              * User-defined locales may include arbitrary characters.
4544              * And, unfortunately, some system may alloc the "C" locale
4545              * to be overridden by a malicious user.
4546              */
4547             if (used_locale)
4548                 *used_locale = TRUE;
4549 #endif /* LC_NUMERIC */
4550
4551             break;
4552
4553             /* SPECIAL */
4554
4555         case 'n':
4556             i = SvCUR(sv) - origlen;
4557             if (args) {
4558                 int *ip = va_arg(*args, int*);
4559                 *ip = i;
4560             }
4561             else if (svix < svmax)
4562                 sv_setuv(svargs[svix++], (UV)i);
4563             continue;   /* not "break" */
4564
4565             /* UNKNOWN */
4566
4567         default:
4568       unknown:
4569             /* output mangled stuff without comment */
4570             eptr = p;
4571             elen = q - p;
4572             break;
4573         }
4574
4575         have = esignlen + zeros + elen;
4576         need = (have > width ? have : width);
4577         gap = need - have;
4578
4579         SvGROW(sv, SvLEN(sv) + need);
4580         p = SvEND(sv);
4581         if (esignlen && fill == '0') {
4582             for (i = 0; i < esignlen; i++)
4583                 *p++ = esignbuf[i];
4584         }
4585         if (gap && !left) {
4586             memset(p, fill, gap);
4587             p += gap;
4588         }
4589         if (esignlen && fill != '0') {
4590             for (i = 0; i < esignlen; i++)
4591                 *p++ = esignbuf[i];
4592         }
4593         if (zeros) {
4594             for (i = zeros; i; i--)
4595                 *p++ = '0';
4596         }
4597         if (elen) {
4598             memcpy(p, eptr, elen);
4599             p += elen;
4600         }
4601         if (gap && left) {
4602             memset(p, ' ', gap);
4603             p += gap;
4604         }
4605         *p = '\0';
4606         SvCUR(sv) = p - SvPVX(sv);
4607     }
4608 }
4609
4610 #ifdef DEBUGGING
4611 void
4612 sv_dump(sv)
4613 SV* sv;
4614 {
4615     SV *d = sv_newmortal();
4616     char *s;
4617     U32 flags;
4618     U32 type;
4619
4620     if (!sv) {
4621         PerlIO_printf(Perl_debug_log, "SV = 0\n");
4622         return;
4623     }
4624     
4625     flags = SvFLAGS(sv);
4626     type = SvTYPE(sv);
4627
4628     sv_setpvf(d, "(0x%lx)\n  REFCNT = %ld\n  FLAGS = (",
4629               (unsigned long)SvANY(sv), (long)SvREFCNT(sv));
4630     if (flags & SVs_PADBUSY)    sv_catpv(d, "PADBUSY,");
4631     if (flags & SVs_PADTMP)     sv_catpv(d, "PADTMP,");
4632     if (flags & SVs_PADMY)      sv_catpv(d, "PADMY,");
4633     if (flags & SVs_TEMP)       sv_catpv(d, "TEMP,");
4634     if (flags & SVs_OBJECT)     sv_catpv(d, "OBJECT,");
4635     if (flags & SVs_GMG)        sv_catpv(d, "GMG,");
4636     if (flags & SVs_SMG)        sv_catpv(d, "SMG,");
4637     if (flags & SVs_RMG)        sv_catpv(d, "RMG,");
4638
4639     if (flags & SVf_IOK)        sv_catpv(d, "IOK,");
4640     if (flags & SVf_NOK)        sv_catpv(d, "NOK,");
4641     if (flags & SVf_POK)        sv_catpv(d, "POK,");
4642     if (flags & SVf_ROK)        sv_catpv(d, "ROK,");
4643     if (flags & SVf_OOK)        sv_catpv(d, "OOK,");
4644     if (flags & SVf_FAKE)       sv_catpv(d, "FAKE,");
4645     if (flags & SVf_READONLY)   sv_catpv(d, "READONLY,");
4646
4647 #ifdef OVERLOAD
4648     if (flags & SVf_AMAGIC)     sv_catpv(d, "OVERLOAD,");
4649 #endif /* OVERLOAD */
4650     if (flags & SVp_IOK)        sv_catpv(d, "pIOK,");
4651     if (flags & SVp_NOK)        sv_catpv(d, "pNOK,");
4652     if (flags & SVp_POK)        sv_catpv(d, "pPOK,");
4653     if (flags & SVp_SCREAM)     sv_catpv(d, "SCREAM,");
4654
4655     switch (type) {
4656     case SVt_PVCV:
4657     case SVt_PVFM:
4658         if (CvANON(sv))         sv_catpv(d, "ANON,");
4659         if (CvUNIQUE(sv))       sv_catpv(d, "UNIQUE,");
4660         if (CvCLONE(sv))        sv_catpv(d, "CLONE,");
4661         if (CvCLONED(sv))       sv_catpv(d, "CLONED,");
4662         if (CvNODEBUG(sv))      sv_catpv(d, "NODEBUG,");
4663         break;
4664     case SVt_PVHV:
4665         if (HvSHAREKEYS(sv))    sv_catpv(d, "SHAREKEYS,");
4666         if (HvLAZYDEL(sv))      sv_catpv(d, "LAZYDEL,");
4667         break;
4668     case SVt_PVGV:
4669         if (GvINTRO(sv))        sv_catpv(d, "INTRO,");
4670         if (GvMULTI(sv))        sv_catpv(d, "MULTI,");
4671         if (GvASSUMECV(sv))     sv_catpv(d, "ASSUMECV,");
4672         if (GvIMPORTED(sv)) {
4673             sv_catpv(d, "IMPORT");
4674             if (GvIMPORTED(sv) == GVf_IMPORTED)
4675                 sv_catpv(d, "ALL,");
4676             else {
4677                 sv_catpv(d, "(");
4678                 if (GvIMPORTED_SV(sv))  sv_catpv(d, " SV");
4679                 if (GvIMPORTED_AV(sv))  sv_catpv(d, " AV");
4680                 if (GvIMPORTED_HV(sv))  sv_catpv(d, " HV");
4681                 if (GvIMPORTED_CV(sv))  sv_catpv(d, " CV");
4682                 sv_catpv(d, " ),");
4683             }
4684         }
4685     }
4686
4687     if (*(SvEND(d) - 1) == ',')
4688         SvPVX(d)[--SvCUR(d)] = '\0';
4689     sv_catpv(d, ")");
4690     s = SvPVX(d);
4691
4692     PerlIO_printf(Perl_debug_log, "SV = ");
4693     switch (type) {
4694     case SVt_NULL:
4695         PerlIO_printf(Perl_debug_log, "NULL%s\n", s);
4696         return;
4697     case SVt_IV:
4698         PerlIO_printf(Perl_debug_log, "IV%s\n", s);
4699         break;
4700     case SVt_NV:
4701         PerlIO_printf(Perl_debug_log, "NV%s\n", s);
4702         break;
4703     case SVt_RV:
4704         PerlIO_printf(Perl_debug_log, "RV%s\n", s);
4705         break;
4706     case SVt_PV:
4707         PerlIO_printf(Perl_debug_log, "PV%s\n", s);
4708         break;
4709     case SVt_PVIV:
4710         PerlIO_printf(Perl_debug_log, "PVIV%s\n", s);
4711         break;
4712     case SVt_PVNV:
4713         PerlIO_printf(Perl_debug_log, "PVNV%s\n", s);
4714         break;
4715     case SVt_PVBM:
4716         PerlIO_printf(Perl_debug_log, "PVBM%s\n", s);
4717         break;
4718     case SVt_PVMG:
4719         PerlIO_printf(Perl_debug_log, "PVMG%s\n", s);
4720         break;
4721     case SVt_PVLV:
4722         PerlIO_printf(Perl_debug_log, "PVLV%s\n", s);
4723         break;
4724     case SVt_PVAV:
4725         PerlIO_printf(Perl_debug_log, "PVAV%s\n", s);
4726         break;
4727     case SVt_PVHV:
4728         PerlIO_printf(Perl_debug_log, "PVHV%s\n", s);
4729         break;
4730     case SVt_PVCV:
4731         PerlIO_printf(Perl_debug_log, "PVCV%s\n", s);
4732         break;
4733     case SVt_PVGV:
4734         PerlIO_printf(Perl_debug_log, "PVGV%s\n", s);
4735         break;
4736     case SVt_PVFM:
4737         PerlIO_printf(Perl_debug_log, "PVFM%s\n", s);
4738         break;
4739     case SVt_PVIO:
4740         PerlIO_printf(Perl_debug_log, "PVIO%s\n", s);
4741         break;
4742     default:
4743         PerlIO_printf(Perl_debug_log, "UNKNOWN%s\n", s);
4744         return;
4745     }
4746     if (type >= SVt_PVIV || type == SVt_IV)
4747         PerlIO_printf(Perl_debug_log, "  IV = %ld\n", (long)SvIVX(sv));
4748     if (type >= SVt_PVNV || type == SVt_NV) {
4749         SET_NUMERIC_STANDARD();
4750         PerlIO_printf(Perl_debug_log, "  NV = %.*g\n", DBL_DIG, SvNVX(sv));
4751     }
4752     if (SvROK(sv)) {
4753         PerlIO_printf(Perl_debug_log, "  RV = 0x%lx\n", (long)SvRV(sv));
4754         sv_dump(SvRV(sv));
4755         return;
4756     }
4757     if (type < SVt_PV)
4758         return;
4759     if (type <= SVt_PVLV) {
4760         if (SvPVX(sv))
4761             PerlIO_printf(Perl_debug_log, "  PV = 0x%lx \"%s\"\n  CUR = %ld\n  LEN = %ld\n",
4762                 (long)SvPVX(sv), SvPVX(sv), (long)SvCUR(sv), (long)SvLEN(sv));
4763         else
4764             PerlIO_printf(Perl_debug_log, "  PV = 0\n");
4765     }
4766     if (type >= SVt_PVMG) {
4767         if (SvMAGIC(sv)) {
4768             PerlIO_printf(Perl_debug_log, "  MAGIC = 0x%lx\n", (long)SvMAGIC(sv));
4769         }
4770         if (SvSTASH(sv))
4771             PerlIO_printf(Perl_debug_log, "  STASH = \"%s\"\n", HvNAME(SvSTASH(sv)));
4772     }
4773     switch (type) {
4774     case SVt_PVLV:
4775         PerlIO_printf(Perl_debug_log, "  TYPE = %c\n", LvTYPE(sv));
4776         PerlIO_printf(Perl_debug_log, "  TARGOFF = %ld\n", (long)LvTARGOFF(sv));
4777         PerlIO_printf(Perl_debug_log, "  TARGLEN = %ld\n", (long)LvTARGLEN(sv));
4778         PerlIO_printf(Perl_debug_log, "  TARG = 0x%lx\n", (long)LvTARG(sv));
4779         sv_dump(LvTARG(sv));
4780         break;
4781     case SVt_PVAV:
4782         PerlIO_printf(Perl_debug_log, "  ARRAY = 0x%lx\n", (long)AvARRAY(sv));
4783         PerlIO_printf(Perl_debug_log, "  ALLOC = 0x%lx\n", (long)AvALLOC(sv));
4784         PerlIO_printf(Perl_debug_log, "  FILL = %ld\n", (long)AvFILL(sv));
4785         PerlIO_printf(Perl_debug_log, "  MAX = %ld\n", (long)AvMAX(sv));
4786         PerlIO_printf(Perl_debug_log, "  ARYLEN = 0x%lx\n", (long)AvARYLEN(sv));
4787         flags = AvFLAGS(sv);
4788         sv_setpv(d, "");
4789         if (flags & AVf_REAL)   sv_catpv(d, ",REAL");
4790         if (flags & AVf_REIFY)  sv_catpv(d, ",REIFY");
4791         if (flags & AVf_REUSED) sv_catpv(d, ",REUSED");
4792         PerlIO_printf(Perl_debug_log, "  FLAGS = (%s)\n",
4793                       SvCUR(d) ? SvPVX(d) + 1 : "");
4794         break;
4795     case SVt_PVHV:
4796         PerlIO_printf(Perl_debug_log, "  ARRAY = 0x%lx\n",(long)HvARRAY(sv));
4797         PerlIO_printf(Perl_debug_log, "  KEYS = %ld\n", (long)HvKEYS(sv));
4798         PerlIO_printf(Perl_debug_log, "  FILL = %ld\n", (long)HvFILL(sv));
4799         PerlIO_printf(Perl_debug_log, "  MAX = %ld\n", (long)HvMAX(sv));
4800         PerlIO_printf(Perl_debug_log, "  RITER = %ld\n", (long)HvRITER(sv));
4801         PerlIO_printf(Perl_debug_log, "  EITER = 0x%lx\n",(long) HvEITER(sv));
4802         if (HvPMROOT(sv))
4803             PerlIO_printf(Perl_debug_log, "  PMROOT = 0x%lx\n",(long)HvPMROOT(sv));
4804         if (HvNAME(sv))
4805             PerlIO_printf(Perl_debug_log, "  NAME = \"%s\"\n", HvNAME(sv));
4806         break;
4807     case SVt_PVCV:
4808         if (SvPOK(sv))
4809             PerlIO_printf(Perl_debug_log, "  PROTOTYPE = \"%s\"\n", SvPV(sv,na));
4810         /* FALL THROUGH */
4811     case SVt_PVFM:
4812         PerlIO_printf(Perl_debug_log, "  STASH = 0x%lx\n", (long)CvSTASH(sv));
4813         PerlIO_printf(Perl_debug_log, "  START = 0x%lx\n", (long)CvSTART(sv));
4814         PerlIO_printf(Perl_debug_log, "  ROOT = 0x%lx\n", (long)CvROOT(sv));
4815         PerlIO_printf(Perl_debug_log, "  XSUB = 0x%lx\n", (long)CvXSUB(sv));
4816         PerlIO_printf(Perl_debug_log, "  XSUBANY = %ld\n", (long)CvXSUBANY(sv).any_i32);
4817         PerlIO_printf(Perl_debug_log, "  GV = 0x%lx", (long)CvGV(sv));
4818         if (CvGV(sv) && GvNAME(CvGV(sv))) {
4819             PerlIO_printf(Perl_debug_log, "  \"%s\"\n", GvNAME(CvGV(sv)));
4820         } else {
4821             PerlIO_printf(Perl_debug_log, "\n");
4822         }
4823         PerlIO_printf(Perl_debug_log, "  FILEGV = 0x%lx\n", (long)CvFILEGV(sv));
4824         PerlIO_printf(Perl_debug_log, "  DEPTH = %ld\n", (long)CvDEPTH(sv));
4825         PerlIO_printf(Perl_debug_log, "  PADLIST = 0x%lx\n", (long)CvPADLIST(sv));
4826         PerlIO_printf(Perl_debug_log, "  OUTSIDE = 0x%lx\n", (long)CvOUTSIDE(sv));
4827         if (type == SVt_PVFM)
4828             PerlIO_printf(Perl_debug_log, "  LINES = %ld\n", (long)FmLINES(sv));
4829         break;
4830     case SVt_PVGV:
4831         PerlIO_printf(Perl_debug_log, "  NAME = \"%s\"\n", GvNAME(sv));
4832         PerlIO_printf(Perl_debug_log, "  NAMELEN = %ld\n", (long)GvNAMELEN(sv));
4833         PerlIO_printf(Perl_debug_log, "  STASH = \"%s\"\n", HvNAME(GvSTASH(sv)));
4834         PerlIO_printf(Perl_debug_log, "  GP = 0x%lx\n", (long)GvGP(sv));
4835         PerlIO_printf(Perl_debug_log, "    SV = 0x%lx\n", (long)GvSV(sv));
4836         PerlIO_printf(Perl_debug_log, "    REFCNT = %ld\n", (long)GvREFCNT(sv));
4837         PerlIO_printf(Perl_debug_log, "    IO = 0x%lx\n", (long)GvIOp(sv));
4838         PerlIO_printf(Perl_debug_log, "    FORM = 0x%lx\n", (long)GvFORM(sv));
4839         PerlIO_printf(Perl_debug_log, "    AV = 0x%lx\n", (long)GvAV(sv));
4840         PerlIO_printf(Perl_debug_log, "    HV = 0x%lx\n", (long)GvHV(sv));
4841         PerlIO_printf(Perl_debug_log, "    CV = 0x%lx\n", (long)GvCV(sv));
4842         PerlIO_printf(Perl_debug_log, "    CVGEN = 0x%lx\n", (long)GvCVGEN(sv));
4843         PerlIO_printf(Perl_debug_log, "    LASTEXPR = %ld\n", (long)GvLASTEXPR(sv));
4844         PerlIO_printf(Perl_debug_log, "    LINE = %ld\n", (long)GvLINE(sv));
4845         PerlIO_printf(Perl_debug_log, "    FILEGV = 0x%lx\n", (long)GvFILEGV(sv));
4846         PerlIO_printf(Perl_debug_log, "    EGV = 0x%lx\n", (long)GvEGV(sv));
4847         break;
4848     case SVt_PVIO:
4849         PerlIO_printf(Perl_debug_log, "  IFP = 0x%lx\n", (long)IoIFP(sv));
4850         PerlIO_printf(Perl_debug_log, "  OFP = 0x%lx\n", (long)IoOFP(sv));
4851         PerlIO_printf(Perl_debug_log, "  DIRP = 0x%lx\n", (long)IoDIRP(sv));
4852         PerlIO_printf(Perl_debug_log, "  LINES = %ld\n", (long)IoLINES(sv));
4853         PerlIO_printf(Perl_debug_log, "  PAGE = %ld\n", (long)IoPAGE(sv));
4854         PerlIO_printf(Perl_debug_log, "  PAGE_LEN = %ld\n", (long)IoPAGE_LEN(sv));
4855         PerlIO_printf(Perl_debug_log, "  LINES_LEFT = %ld\n", (long)IoLINES_LEFT(sv));
4856         PerlIO_printf(Perl_debug_log, "  TOP_NAME = \"%s\"\n", IoTOP_NAME(sv));
4857         PerlIO_printf(Perl_debug_log, "  TOP_GV = 0x%lx\n", (long)IoTOP_GV(sv));
4858         PerlIO_printf(Perl_debug_log, "  FMT_NAME = \"%s\"\n", IoFMT_NAME(sv));
4859         PerlIO_printf(Perl_debug_log, "  FMT_GV = 0x%lx\n", (long)IoFMT_GV(sv));
4860         PerlIO_printf(Perl_debug_log, "  BOTTOM_NAME = \"%s\"\n", IoBOTTOM_NAME(sv));
4861         PerlIO_printf(Perl_debug_log, "  BOTTOM_GV = 0x%lx\n", (long)IoBOTTOM_GV(sv));
4862         PerlIO_printf(Perl_debug_log, "  SUBPROCESS = %ld\n", (long)IoSUBPROCESS(sv));
4863         PerlIO_printf(Perl_debug_log, "  TYPE = %c\n", IoTYPE(sv));
4864         PerlIO_printf(Perl_debug_log, "  FLAGS = 0x%lx\n", (long)IoFLAGS(sv));
4865         break;
4866     }
4867 }
4868 #else
4869 void
4870 sv_dump(sv)
4871 SV* sv;
4872 {
4873 }
4874 #endif