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