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