sv.c

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