sv.c

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