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 (SvNOKp(sv)) {                   /* See note in sv_2uv() */
2196         /* XXXX 64-bit?  IV may have better precision... */
2197         /* I tried changing this to be 64-bit-aware and
2198          * the t/op/numconvert.t became very, very, angry.
2199          * --jhi Sep 1999 */
2200         if (SvTYPE(sv) < SVt_PVNV)
2201             sv_upgrade(sv, SVt_PVNV);
2202         /* The +20 is pure guesswork.  Configure test needed. --jhi */
2203         SvGROW(sv, NV_DIG + 20);
2204         s = SvPVX(sv);
2205         olderrno = errno;       /* some Xenix systems wipe out errno here */
2206 #ifdef apollo
2207         if (SvNVX(sv) == 0.0)
2208             (void)strcpy(s,"0");
2209         else
2210 #endif /*apollo*/
2211         {
2212             Gconvert(SvNVX(sv), NV_DIG, 0, s);
2213         }
2214         errno = olderrno;
2215 #ifdef FIXNEGATIVEZERO
2216         if (*s == '-' && s[1] == '0' && !s[2])
2217             strcpy(s,"0");
2218 #endif
2219         while (*s) s++;
2220 #ifdef hcx
2221         if (s[-1] == '.')
2222             *--s = '\0';
2223 #endif
2224     }
2225     else if (SvIOKp(sv)) {
2226         U32 isIOK = SvIOK(sv);
2227         U32 isUIOK = SvIsUV(sv);
2228         char buf[TYPE_CHARS(UV)];
2229         char *ebuf, *ptr;
2230
2231         if (SvTYPE(sv) < SVt_PVIV)
2232             sv_upgrade(sv, SVt_PVIV);
2233         if (isUIOK)
2234             ptr = uiv_2buf(buf, 0, SvUVX(sv), 1, &ebuf);
2235         else
2236             ptr = uiv_2buf(buf, SvIVX(sv), 0, 0, &ebuf);
2237         SvGROW(sv, ebuf - ptr + 1);     /* inlined from sv_setpvn */
2238         Move(ptr,SvPVX(sv),ebuf - ptr,char);
2239         SvCUR_set(sv, ebuf - ptr);
2240         s = SvEND(sv);
2241         *s = '\0';
2242         if (isIOK)
2243             SvIOK_on(sv);
2244         else
2245             SvIOKp_on(sv);
2246         if (isUIOK)
2247             SvIsUV_on(sv);
2248         SvPOK_on(sv);
2249     }
2250     else {
2251         if (ckWARN(WARN_UNINITIALIZED)
2252             && !PL_localizing && !(SvFLAGS(sv) & SVs_PADTMP))
2253             report_uninit();
2254         *lp = 0;
2255         if (SvTYPE(sv) < SVt_PV)
2256             /* Typically the caller expects that sv_any is not NULL now.  */
2257             sv_upgrade(sv, SVt_PV);
2258         return "";
2259     }
2260     *lp = s - SvPVX(sv);
2261     SvCUR_set(sv, *lp);
2262     SvPOK_on(sv);
2263     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2pv(%s)\n",
2264                           PTR2UV(sv),SvPVX(sv)));
2265     return SvPVX(sv);
2266
2267   tokensave:
2268     if (SvROK(sv)) {    /* XXX Skip this when sv_pvn_force calls */
2269         /* Sneaky stuff here */
2270
2271       tokensaveref:
2272         if (!tsv)
2273             tsv = newSVpv(tmpbuf, 0);
2274         sv_2mortal(tsv);
2275         *lp = SvCUR(tsv);
2276         return SvPVX(tsv);
2277     }
2278     else {
2279         STRLEN len;
2280         char *t;
2281
2282         if (tsv) {
2283             sv_2mortal(tsv);
2284             t = SvPVX(tsv);
2285             len = SvCUR(tsv);
2286         }
2287         else {
2288             t = tmpbuf;
2289             len = strlen(tmpbuf);
2290         }
2291 #ifdef FIXNEGATIVEZERO
2292         if (len == 2 && t[0] == '-' && t[1] == '0') {
2293             t = "0";
2294             len = 1;
2295         }
2296 #endif
2297         (void)SvUPGRADE(sv, SVt_PV);
2298         *lp = len;
2299         s = SvGROW(sv, len + 1);
2300         SvCUR_set(sv, len);
2301         (void)strcpy(s, t);
2302         SvPOKp_on(sv);
2303         return s;
2304     }
2305 }
2306
2307 char *
2308 Perl_sv_2pvbyte_nolen(pTHX_ register SV *sv)
2309 {
2310     STRLEN n_a;
2311     return sv_2pvbyte(sv, &n_a);
2312 }
2313
2314 char *
2315 Perl_sv_2pvbyte(pTHX_ register SV *sv, STRLEN *lp)
2316 {
2317     return sv_2pv(sv,lp);
2318 }
2319
2320 char *
2321 Perl_sv_2pvutf8_nolen(pTHX_ register SV *sv)
2322 {
2323     STRLEN n_a;
2324     return sv_2pvutf8(sv, &n_a);
2325 }
2326
2327 char *
2328 Perl_sv_2pvutf8(pTHX_ register SV *sv, STRLEN *lp)
2329 {
2330     sv_utf8_upgrade(sv);
2331     return sv_2pv(sv,lp);
2332 }
2333
2334 /* This function is only called on magical items */
2335 bool
2336 Perl_sv_2bool(pTHX_ register SV *sv)
2337 {
2338     if (SvGMAGICAL(sv))
2339         mg_get(sv);
2340
2341     if (!SvOK(sv))
2342         return 0;
2343     if (SvROK(sv)) {
2344         SV* tmpsv;
2345         if (SvAMAGIC(sv) && (tmpsv=AMG_CALLun(sv,bool_)) &&
2346                 (SvRV(tmpsv) != SvRV(sv)))
2347             return SvTRUE(tmpsv);
2348       return SvRV(sv) != 0;
2349     }
2350     if (SvPOKp(sv)) {
2351         register XPV* Xpvtmp;
2352         if ((Xpvtmp = (XPV*)SvANY(sv)) &&
2353                 (*Xpvtmp->xpv_pv > '0' ||
2354                 Xpvtmp->xpv_cur > 1 ||
2355                 (Xpvtmp->xpv_cur && *Xpvtmp->xpv_pv != '0')))
2356             return 1;
2357         else
2358             return 0;
2359     }
2360     else {
2361         if (SvIOKp(sv))
2362             return SvIVX(sv) != 0;
2363         else {
2364             if (SvNOKp(sv))
2365                 return SvNVX(sv) != 0.0;
2366             else
2367                 return FALSE;
2368         }
2369     }
2370 }
2371
2372 /*
2373 =for apidoc sv_utf8_upgrade
2374
2375 Convert the PV of an SV to its UTF8-encoded form.
2376
2377 =cut
2378 */
2379
2380 void
2381 Perl_sv_utf8_upgrade(pTHX_ register SV *sv)
2382 {
2383     char *s, *t;
2384     bool hibit;
2385
2386     if (!sv || !SvPOK(sv) || SvUTF8(sv))
2387         return;
2388
2389     /* This function could be much more efficient if we had a FLAG in SVs
2390      * to signal if there are any hibit chars in the PV.
2391      */
2392     for (s = t = SvPVX(sv), hibit = FALSE; t < SvEND(sv) && !hibit; t++)
2393         if (*t & 0x80)
2394             hibit = TRUE;
2395
2396     if (hibit) {
2397         STRLEN len = SvCUR(sv) + 1; /* Plus the \0 */
2398         SvPVX(sv) = (char*)bytes_to_utf8((U8*)s, &len);
2399         SvCUR(sv) = len - 1;
2400         SvLEN(sv) = len; /* No longer know the real size. */
2401         SvUTF8_on(sv);
2402         Safefree(s); /* No longer using what was there before. */
2403     }
2404 }
2405
2406 /*
2407 =for apidoc sv_utf8_downgrade
2408
2409 Attempt to convert the PV of an SV from UTF8-encoded to byte encoding.
2410 This may not be possible if the PV contains non-byte encoding characters;
2411 if this is the case, either returns false or, if C<fail_ok> is not
2412 true, croaks.
2413
2414 =cut
2415 */
2416
2417 bool
2418 Perl_sv_utf8_downgrade(pTHX_ register SV* sv, bool fail_ok)
2419 {
2420     if (SvPOK(sv) && SvUTF8(sv)) {
2421         if (SvCUR(sv)) {
2422             char *c = SvPVX(sv);
2423             STRLEN len = SvCUR(sv);
2424
2425             if (!utf8_to_bytes((U8*)c, &len)) {
2426                 if (fail_ok)
2427                     return FALSE;
2428                 else {
2429                     if (PL_op)
2430                         Perl_croak(aTHX_ "Wide character in %s",
2431                                    PL_op_desc[PL_op->op_type]);
2432                     else
2433                         Perl_croak(aTHX_ "Wide character");
2434                 }
2435             }
2436             SvCUR(sv) = len;
2437         }
2438         SvUTF8_off(sv);
2439     }
2440
2441     return TRUE;
2442 }
2443
2444 /*
2445 =for apidoc sv_utf8_encode
2446
2447 Convert the PV of an SV to UTF8-encoded, but then turn off the C<SvUTF8>
2448 flag so that it looks like bytes again. Nothing calls this.
2449
2450 =cut
2451 */
2452
2453 void
2454 Perl_sv_utf8_encode(pTHX_ register SV *sv)
2455 {
2456     sv_utf8_upgrade(sv);
2457     SvUTF8_off(sv);
2458 }
2459
2460 bool
2461 Perl_sv_utf8_decode(pTHX_ register SV *sv)
2462 {
2463     if (SvPOK(sv)) {
2464         char *c;
2465         bool has_utf = FALSE;
2466         if (!sv_utf8_downgrade(sv, TRUE))
2467             return FALSE;
2468
2469         /* it is actually just a matter of turning the utf8 flag on, but
2470          * we want to make sure everything inside is valid utf8 first.
2471          */
2472         c = SvPVX(sv);
2473         if (!is_utf8_string((U8*)c, SvCUR(sv)+1))
2474             return FALSE;
2475
2476         while (c < SvEND(sv)) {
2477             if (*c++ & 0x80) {
2478                 SvUTF8_on(sv);
2479                 break;
2480             }
2481         }
2482     }
2483     return TRUE;
2484 }
2485
2486
2487 /* Note: sv_setsv() should not be called with a source string that needs
2488  * to be reused, since it may destroy the source string if it is marked
2489  * as temporary.
2490  */
2491
2492 /*
2493 =for apidoc sv_setsv
2494
2495 Copies the contents of the source SV C<ssv> into the destination SV C<dsv>.
2496 The source SV may be destroyed if it is mortal.  Does not handle 'set'
2497 magic.  See the macro forms C<SvSetSV>, C<SvSetSV_nosteal> and
2498 C<sv_setsv_mg>.
2499
2500 =cut
2501 */
2502
2503 void
2504 Perl_sv_setsv(pTHX_ SV *dstr, register SV *sstr)
2505 {
2506     register U32 sflags;
2507     register int dtype;
2508     register int stype;
2509
2510     if (sstr == dstr)
2511         return;
2512     SV_CHECK_THINKFIRST(dstr);
2513     if (!sstr)
2514         sstr = &PL_sv_undef;
2515     stype = SvTYPE(sstr);
2516     dtype = SvTYPE(dstr);
2517
2518     SvAMAGIC_off(dstr);
2519
2520     /* There's a lot of redundancy below but we're going for speed here */
2521
2522     switch (stype) {
2523     case SVt_NULL:
2524       undef_sstr:
2525         if (dtype != SVt_PVGV) {
2526             (void)SvOK_off(dstr);
2527             return;
2528         }
2529         break;
2530     case SVt_IV:
2531         if (SvIOK(sstr)) {
2532             switch (dtype) {
2533             case SVt_NULL:
2534                 sv_upgrade(dstr, SVt_IV);
2535                 break;
2536             case SVt_NV:
2537                 sv_upgrade(dstr, SVt_PVNV);
2538                 break;
2539             case SVt_RV:
2540             case SVt_PV:
2541                 sv_upgrade(dstr, SVt_PVIV);
2542                 break;
2543             }
2544             (void)SvIOK_only(dstr);
2545             SvIVX(dstr) = SvIVX(sstr);
2546             if (SvIsUV(sstr))
2547                 SvIsUV_on(dstr);
2548             if (SvTAINTED(sstr))
2549                 SvTAINT(dstr);
2550             return;
2551         }
2552         goto undef_sstr;
2553
2554     case SVt_NV:
2555         if (SvNOK(sstr)) {
2556             switch (dtype) {
2557             case SVt_NULL:
2558             case SVt_IV:
2559                 sv_upgrade(dstr, SVt_NV);
2560                 break;
2561             case SVt_RV:
2562             case SVt_PV:
2563             case SVt_PVIV:
2564                 sv_upgrade(dstr, SVt_PVNV);
2565                 break;
2566             }
2567             SvNVX(dstr) = SvNVX(sstr);
2568             (void)SvNOK_only(dstr);
2569             if (SvTAINTED(sstr))
2570                 SvTAINT(dstr);
2571             return;
2572         }
2573         goto undef_sstr;
2574
2575     case SVt_RV:
2576         if (dtype < SVt_RV)
2577             sv_upgrade(dstr, SVt_RV);
2578         else if (dtype == SVt_PVGV &&
2579                  SvTYPE(SvRV(sstr)) == SVt_PVGV) {
2580             sstr = SvRV(sstr);
2581             if (sstr == dstr) {
2582                 if (GvIMPORTED(dstr) != GVf_IMPORTED
2583                     && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
2584                 {
2585                     GvIMPORTED_on(dstr);
2586                 }
2587                 GvMULTI_on(dstr);
2588                 return;
2589             }
2590             goto glob_assign;
2591         }
2592         break;
2593     case SVt_PV:
2594     case SVt_PVFM:
2595         if (dtype < SVt_PV)
2596             sv_upgrade(dstr, SVt_PV);
2597         break;
2598     case SVt_PVIV:
2599         if (dtype < SVt_PVIV)
2600             sv_upgrade(dstr, SVt_PVIV);
2601         break;
2602     case SVt_PVNV:
2603         if (dtype < SVt_PVNV)
2604             sv_upgrade(dstr, SVt_PVNV);
2605         break;
2606     case SVt_PVAV:
2607     case SVt_PVHV:
2608     case SVt_PVCV:
2609     case SVt_PVIO:
2610         if (PL_op)
2611             Perl_croak(aTHX_ "Bizarre copy of %s in %s", sv_reftype(sstr, 0),
2612                 PL_op_name[PL_op->op_type]);
2613         else
2614             Perl_croak(aTHX_ "Bizarre copy of %s", sv_reftype(sstr, 0));
2615         break;
2616
2617     case SVt_PVGV:
2618         if (dtype <= SVt_PVGV) {
2619   glob_assign:
2620             if (dtype != SVt_PVGV) {
2621                 char *name = GvNAME(sstr);
2622                 STRLEN len = GvNAMELEN(sstr);
2623                 sv_upgrade(dstr, SVt_PVGV);
2624                 sv_magic(dstr, dstr, '*', Nullch, 0);
2625                 GvSTASH(dstr) = (HV*)SvREFCNT_inc(GvSTASH(sstr));
2626                 GvNAME(dstr) = savepvn(name, len);
2627                 GvNAMELEN(dstr) = len;
2628                 SvFAKE_on(dstr);        /* can coerce to non-glob */
2629             }
2630             /* ahem, death to those who redefine active sort subs */
2631             else if (PL_curstackinfo->si_type == PERLSI_SORT
2632                      && GvCV(dstr) && PL_sortcop == CvSTART(GvCV(dstr)))
2633                 Perl_croak(aTHX_ "Can't redefine active sort subroutine %s",
2634                       GvNAME(dstr));
2635             (void)SvOK_off(dstr);
2636             GvINTRO_off(dstr);          /* one-shot flag */
2637             gp_free((GV*)dstr);
2638             GvGP(dstr) = gp_ref(GvGP(sstr));
2639             if (SvTAINTED(sstr))
2640                 SvTAINT(dstr);
2641             if (GvIMPORTED(dstr) != GVf_IMPORTED
2642                 && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
2643             {
2644                 GvIMPORTED_on(dstr);
2645             }
2646             GvMULTI_on(dstr);
2647             return;
2648         }
2649         /* FALL THROUGH */
2650
2651     default:
2652         if (SvGMAGICAL(sstr)) {
2653             mg_get(sstr);
2654             if (SvTYPE(sstr) != stype) {
2655                 stype = SvTYPE(sstr);
2656                 if (stype == SVt_PVGV && dtype <= SVt_PVGV)
2657                     goto glob_assign;
2658             }
2659         }
2660         if (stype == SVt_PVLV)
2661             (void)SvUPGRADE(dstr, SVt_PVNV);
2662         else
2663             (void)SvUPGRADE(dstr, stype);
2664     }
2665
2666     sflags = SvFLAGS(sstr);
2667
2668     if (sflags & SVf_ROK) {
2669         if (dtype >= SVt_PV) {
2670             if (dtype == SVt_PVGV) {
2671                 SV *sref = SvREFCNT_inc(SvRV(sstr));
2672                 SV *dref = 0;
2673                 int intro = GvINTRO(dstr);
2674
2675                 if (intro) {
2676                     GP *gp;
2677                     gp_free((GV*)dstr);
2678                     GvINTRO_off(dstr);  /* one-shot flag */
2679                     Newz(602,gp, 1, GP);
2680                     GvGP(dstr) = gp_ref(gp);
2681                     GvSV(dstr) = NEWSV(72,0);
2682                     GvLINE(dstr) = CopLINE(PL_curcop);
2683                     GvEGV(dstr) = (GV*)dstr;
2684                 }
2685                 GvMULTI_on(dstr);
2686                 switch (SvTYPE(sref)) {
2687                 case SVt_PVAV:
2688                     if (intro)
2689                         SAVESPTR(GvAV(dstr));
2690                     else
2691                         dref = (SV*)GvAV(dstr);
2692                     GvAV(dstr) = (AV*)sref;
2693                     if (!GvIMPORTED_AV(dstr)
2694                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
2695                     {
2696                         GvIMPORTED_AV_on(dstr);
2697                     }
2698                     break;
2699                 case SVt_PVHV:
2700                     if (intro)
2701                         SAVESPTR(GvHV(dstr));
2702                     else
2703                         dref = (SV*)GvHV(dstr);
2704                     GvHV(dstr) = (HV*)sref;
2705                     if (!GvIMPORTED_HV(dstr)
2706                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
2707                     {
2708                         GvIMPORTED_HV_on(dstr);
2709                     }
2710                     break;
2711                 case SVt_PVCV:
2712                     if (intro) {
2713                         if (GvCVGEN(dstr) && GvCV(dstr) != (CV*)sref) {
2714                             SvREFCNT_dec(GvCV(dstr));
2715                             GvCV(dstr) = Nullcv;
2716                             GvCVGEN(dstr) = 0; /* Switch off cacheness. */
2717                             PL_sub_generation++;
2718                         }
2719                         SAVESPTR(GvCV(dstr));
2720                     }
2721                     else
2722                         dref = (SV*)GvCV(dstr);
2723                     if (GvCV(dstr) != (CV*)sref) {
2724                         CV* cv = GvCV(dstr);
2725                         if (cv) {
2726                             if (!GvCVGEN((GV*)dstr) &&
2727                                 (CvROOT(cv) || CvXSUB(cv)))
2728                             {
2729                                 SV *const_sv;
2730                                 /* ahem, death to those who redefine
2731                                  * active sort subs */
2732                                 if (PL_curstackinfo->si_type == PERLSI_SORT &&
2733                                       PL_sortcop == CvSTART(cv))
2734                                     Perl_croak(aTHX_
2735                                     "Can't redefine active sort subroutine %s",
2736                                           GvENAME((GV*)dstr));
2737                                 /* Redefining a sub - warning is mandatory if
2738                                    it was a const and its value changed. */
2739                                 if (ckWARN(WARN_REDEFINE)
2740                                     || (CvCONST(cv)
2741                                         && (!CvCONST((CV*)sref)
2742                                             || sv_cmp(cv_const_sv(cv),
2743                                                       cv_const_sv((CV*)sref)))))
2744                                 {
2745                                     Perl_warner(aTHX_ WARN_REDEFINE,
2746                                         CvCONST(cv)
2747                                         ? "Constant subroutine %s redefined"
2748                                         : "Subroutine %s redefined",
2749                                         GvENAME((GV*)dstr));
2750                                 }
2751                             }
2752                             cv_ckproto(cv, (GV*)dstr,
2753                                        SvPOK(sref) ? SvPVX(sref) : Nullch);
2754                         }
2755                         GvCV(dstr) = (CV*)sref;
2756                         GvCVGEN(dstr) = 0; /* Switch off cacheness. */
2757                         GvASSUMECV_on(dstr);
2758                         PL_sub_generation++;
2759                     }
2760                     if (!GvIMPORTED_CV(dstr)
2761                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
2762                     {
2763                         GvIMPORTED_CV_on(dstr);
2764                     }
2765                     break;
2766                 case SVt_PVIO:
2767                     if (intro)
2768                         SAVESPTR(GvIOp(dstr));
2769                     else
2770                         dref = (SV*)GvIOp(dstr);
2771                     GvIOp(dstr) = (IO*)sref;
2772                     break;
2773                 case SVt_PVFM:
2774                     if (intro)
2775                         SAVESPTR(GvFORM(dstr));
2776                     else
2777                         dref = (SV*)GvFORM(dstr);
2778                     GvFORM(dstr) = (CV*)sref;
2779                     break;
2780                 default:
2781                     if (intro)
2782                         SAVESPTR(GvSV(dstr));
2783                     else
2784                         dref = (SV*)GvSV(dstr);
2785                     GvSV(dstr) = sref;
2786                     if (!GvIMPORTED_SV(dstr)
2787                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
2788                     {
2789                         GvIMPORTED_SV_on(dstr);
2790                     }
2791                     break;
2792                 }
2793                 if (dref)
2794                     SvREFCNT_dec(dref);
2795                 if (intro)
2796                     SAVEFREESV(sref);
2797                 if (SvTAINTED(sstr))
2798                     SvTAINT(dstr);
2799                 return;
2800             }
2801             if (SvPVX(dstr)) {
2802                 (void)SvOOK_off(dstr);          /* backoff */
2803                 if (SvLEN(dstr))
2804                     Safefree(SvPVX(dstr));
2805                 SvLEN(dstr)=SvCUR(dstr)=0;
2806             }
2807         }
2808         (void)SvOK_off(dstr);
2809         SvRV(dstr) = SvREFCNT_inc(SvRV(sstr));
2810         SvROK_on(dstr);
2811         if (sflags & SVp_NOK) {
2812             SvNOK_on(dstr);
2813             SvNVX(dstr) = SvNVX(sstr);
2814         }
2815         if (sflags & SVp_IOK) {
2816             (void)SvIOK_on(dstr);
2817             SvIVX(dstr) = SvIVX(sstr);
2818             if (sflags & SVf_IVisUV)
2819                 SvIsUV_on(dstr);
2820         }
2821         if (SvAMAGIC(sstr)) {
2822             SvAMAGIC_on(dstr);
2823         }
2824     }
2825     else if (sflags & SVp_POK) {
2826
2827         /*
2828          * Check to see if we can just swipe the string.  If so, it's a
2829          * possible small lose on short strings, but a big win on long ones.
2830          * It might even be a win on short strings if SvPVX(dstr)
2831          * has to be allocated and SvPVX(sstr) has to be freed.
2832          */
2833
2834         if (SvTEMP(sstr) &&             /* slated for free anyway? */
2835             SvREFCNT(sstr) == 1 &&      /* and no other references to it? */
2836             !(sflags & SVf_OOK) &&      /* and not involved in OOK hack? */
2837             SvLEN(sstr)         &&      /* and really is a string */
2838             !(PL_op && PL_op->op_type == OP_AASSIGN)) /* and won't be needed again, potentially */
2839         {
2840             if (SvPVX(dstr)) {          /* we know that dtype >= SVt_PV */
2841                 if (SvOOK(dstr)) {
2842                     SvFLAGS(dstr) &= ~SVf_OOK;
2843                     Safefree(SvPVX(dstr) - SvIVX(dstr));
2844                 }
2845                 else if (SvLEN(dstr))
2846                     Safefree(SvPVX(dstr));
2847             }
2848             (void)SvPOK_only(dstr);
2849             SvPV_set(dstr, SvPVX(sstr));
2850             SvLEN_set(dstr, SvLEN(sstr));
2851             SvCUR_set(dstr, SvCUR(sstr));
2852
2853             SvTEMP_off(dstr);
2854             (void)SvOK_off(sstr);               /* NOTE: nukes most SvFLAGS on sstr */
2855             SvPV_set(sstr, Nullch);
2856             SvLEN_set(sstr, 0);
2857             SvCUR_set(sstr, 0);
2858             SvTEMP_off(sstr);
2859         }
2860         else {                                  /* have to copy actual string */
2861             STRLEN len = SvCUR(sstr);
2862
2863             SvGROW(dstr, len + 1);              /* inlined from sv_setpvn */
2864             Move(SvPVX(sstr),SvPVX(dstr),len,char);
2865             SvCUR_set(dstr, len);
2866             *SvEND(dstr) = '\0';
2867             (void)SvPOK_only(dstr);
2868         }
2869         if ((sflags & SVf_UTF8) && !IN_BYTE)
2870             SvUTF8_on(dstr);
2871         /*SUPPRESS 560*/
2872         if (sflags & SVp_NOK) {
2873             SvNOK_on(dstr);
2874             SvNVX(dstr) = SvNVX(sstr);
2875         }
2876         if (sflags & SVp_IOK) {
2877             (void)SvIOK_on(dstr);
2878             SvIVX(dstr) = SvIVX(sstr);
2879             if (sflags & SVf_IVisUV)
2880                 SvIsUV_on(dstr);
2881         }
2882     }
2883     else if (sflags & SVp_NOK) {
2884         SvNVX(dstr) = SvNVX(sstr);
2885         (void)SvNOK_only(dstr);
2886         if (sflags & SVf_IOK) {
2887             (void)SvIOK_on(dstr);
2888             SvIVX(dstr) = SvIVX(sstr);
2889             /* XXXX Do we want to set IsUV for IV(ROK)?  Be extra safe... */
2890             if (sflags & SVf_IVisUV)
2891                 SvIsUV_on(dstr);
2892         }
2893     }
2894     else if (sflags & SVp_IOK) {
2895         (void)SvIOK_only(dstr);
2896         SvIVX(dstr) = SvIVX(sstr);
2897         if (sflags & SVf_IVisUV)
2898             SvIsUV_on(dstr);
2899     }
2900     else {
2901         if (dtype == SVt_PVGV) {
2902             if (ckWARN(WARN_MISC))
2903                 Perl_warner(aTHX_ WARN_MISC, "Undefined value assigned to typeglob");
2904         }
2905         else
2906             (void)SvOK_off(dstr);
2907     }
2908     if (SvTAINTED(sstr))
2909         SvTAINT(dstr);
2910 }
2911
2912 /*
2913 =for apidoc sv_setsv_mg
2914
2915 Like C<sv_setsv>, but also handles 'set' magic.
2916
2917 =cut
2918 */
2919
2920 void
2921 Perl_sv_setsv_mg(pTHX_ SV *dstr, register SV *sstr)
2922 {
2923     sv_setsv(dstr,sstr);
2924     SvSETMAGIC(dstr);
2925 }
2926
2927 /*
2928 =for apidoc sv_setpvn
2929
2930 Copies a string into an SV.  The C<len> parameter indicates the number of
2931 bytes to be copied.  Does not handle 'set' magic.  See C<sv_setpvn_mg>.
2932
2933 =cut
2934 */
2935
2936 void
2937 Perl_sv_setpvn(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
2938 {
2939     register char *dptr;
2940     {
2941         /* len is STRLEN which is unsigned, need to copy to signed */
2942         IV iv = len;
2943         assert(iv >= 0);
2944     }
2945     SV_CHECK_THINKFIRST(sv);
2946     if (!ptr) {
2947         (void)SvOK_off(sv);
2948         return;
2949     }
2950     (void)SvUPGRADE(sv, SVt_PV);
2951
2952     SvGROW(sv, len + 1);
2953     dptr = SvPVX(sv);
2954     Move(ptr,dptr,len,char);
2955     dptr[len] = '\0';
2956     SvCUR_set(sv, len);
2957     (void)SvPOK_only(sv);               /* validate pointer */
2958     SvTAINT(sv);
2959 }
2960
2961 /*
2962 =for apidoc sv_setpvn_mg
2963
2964 Like C<sv_setpvn>, but also handles 'set' magic.
2965
2966 =cut
2967 */
2968
2969 void
2970 Perl_sv_setpvn_mg(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
2971 {
2972     sv_setpvn(sv,ptr,len);
2973     SvSETMAGIC(sv);
2974 }
2975
2976 /*
2977 =for apidoc sv_setpv
2978
2979 Copies a string into an SV.  The string must be null-terminated.  Does not
2980 handle 'set' magic.  See C<sv_setpv_mg>.
2981
2982 =cut
2983 */
2984
2985 void
2986 Perl_sv_setpv(pTHX_ register SV *sv, register const char *ptr)
2987 {
2988     register STRLEN len;
2989
2990     SV_CHECK_THINKFIRST(sv);
2991     if (!ptr) {
2992         (void)SvOK_off(sv);
2993         return;
2994     }
2995     len = strlen(ptr);
2996     (void)SvUPGRADE(sv, SVt_PV);
2997
2998     SvGROW(sv, len + 1);
2999     Move(ptr,SvPVX(sv),len+1,char);
3000     SvCUR_set(sv, len);
3001     (void)SvPOK_only(sv);               /* validate pointer */
3002     SvTAINT(sv);
3003 }
3004
3005 /*
3006 =for apidoc sv_setpv_mg
3007
3008 Like C<sv_setpv>, but also handles 'set' magic.
3009
3010 =cut
3011 */
3012
3013 void
3014 Perl_sv_setpv_mg(pTHX_ register SV *sv, register const char *ptr)
3015 {
3016     sv_setpv(sv,ptr);
3017     SvSETMAGIC(sv);
3018 }
3019
3020 /*
3021 =for apidoc sv_usepvn
3022
3023 Tells an SV to use C<ptr> to find its string value.  Normally the string is
3024 stored inside the SV but sv_usepvn allows the SV to use an outside string.
3025 The C<ptr> should point to memory that was allocated by C<malloc>.  The
3026 string length, C<len>, must be supplied.  This function will realloc the
3027 memory pointed to by C<ptr>, so that pointer should not be freed or used by
3028 the programmer after giving it to sv_usepvn.  Does not handle 'set' magic.
3029 See C<sv_usepvn_mg>.
3030
3031 =cut
3032 */
3033
3034 void
3035 Perl_sv_usepvn(pTHX_ register SV *sv, register char *ptr, register STRLEN len)
3036 {
3037     SV_CHECK_THINKFIRST(sv);
3038     (void)SvUPGRADE(sv, SVt_PV);
3039     if (!ptr) {
3040         (void)SvOK_off(sv);
3041         return;
3042     }
3043     (void)SvOOK_off(sv);
3044     if (SvPVX(sv) && SvLEN(sv))
3045         Safefree(SvPVX(sv));
3046     Renew(ptr, len+1, char);
3047     SvPVX(sv) = ptr;
3048     SvCUR_set(sv, len);
3049     SvLEN_set(sv, len+1);
3050     *SvEND(sv) = '\0';
3051     (void)SvPOK_only(sv);               /* validate pointer */
3052     SvTAINT(sv);
3053 }
3054
3055 /*
3056 =for apidoc sv_usepvn_mg
3057
3058 Like C<sv_usepvn>, but also handles 'set' magic.
3059
3060 =cut
3061 */
3062
3063 void
3064 Perl_sv_usepvn_mg(pTHX_ register SV *sv, register char *ptr, register STRLEN len)
3065 {
3066     sv_usepvn(sv,ptr,len);
3067     SvSETMAGIC(sv);
3068 }
3069
3070 void
3071 Perl_sv_force_normal_flags(pTHX_ register SV *sv, U32 flags)
3072 {
3073     if (SvREADONLY(sv)) {
3074         if (SvFAKE(sv)) {
3075             char *pvx = SvPVX(sv);
3076             STRLEN len = SvCUR(sv);
3077             U32 hash   = SvUVX(sv);
3078             SvGROW(sv, len + 1);
3079             Move(pvx,SvPVX(sv),len,char);
3080             *SvEND(sv) = '\0';
3081             SvFAKE_off(sv);
3082             SvREADONLY_off(sv);
3083             unsharepvn(pvx,len,hash);
3084         }
3085         else if (PL_curcop != &PL_compiling)
3086             Perl_croak(aTHX_ PL_no_modify);
3087     }
3088     if (SvROK(sv))
3089         sv_unref_flags(sv, flags);
3090     else if (SvFAKE(sv) && SvTYPE(sv) == SVt_PVGV)
3091         sv_unglob(sv);
3092 }
3093
3094 void
3095 Perl_sv_force_normal(pTHX_ register SV *sv)
3096 {
3097     sv_force_normal_flags(sv, 0);
3098 }
3099
3100 /*
3101 =for apidoc sv_chop
3102
3103 Efficient removal of characters from the beginning of the string buffer.
3104 SvPOK(sv) must be true and the C<ptr> must be a pointer to somewhere inside
3105 the string buffer.  The C<ptr> becomes the first character of the adjusted
3106 string.
3107
3108 =cut
3109 */
3110
3111 void
3112 Perl_sv_chop(pTHX_ register SV *sv, register char *ptr) /* like set but assuming ptr is in sv */
3113
3114
3115 {
3116     register STRLEN delta;
3117
3118     if (!ptr || !SvPOKp(sv))
3119         return;
3120     SV_CHECK_THINKFIRST(sv);
3121     if (SvTYPE(sv) < SVt_PVIV)
3122         sv_upgrade(sv,SVt_PVIV);
3123
3124     if (!SvOOK(sv)) {
3125         if (!SvLEN(sv)) { /* make copy of shared string */
3126             char *pvx = SvPVX(sv);
3127             STRLEN len = SvCUR(sv);
3128             SvGROW(sv, len + 1);
3129             Move(pvx,SvPVX(sv),len,char);
3130             *SvEND(sv) = '\0';
3131         }
3132         SvIVX(sv) = 0;
3133         SvFLAGS(sv) |= SVf_OOK;
3134     }
3135     SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVp_IOK|SVp_NOK|SVf_IVisUV);
3136     delta = ptr - SvPVX(sv);
3137     SvLEN(sv) -= delta;
3138     SvCUR(sv) -= delta;
3139     SvPVX(sv) += delta;
3140     SvIVX(sv) += delta;
3141 }
3142
3143 /*
3144 =for apidoc sv_catpvn
3145
3146 Concatenates the string onto the end of the string which is in the SV.  The
3147 C<len> indicates number of bytes to copy.  Handles 'get' magic, but not
3148 'set' magic.  See C<sv_catpvn_mg>.
3149
3150 =cut
3151 */
3152
3153 void
3154 Perl_sv_catpvn(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3155 {
3156     STRLEN tlen;
3157     char *junk;
3158
3159     junk = SvPV_force(sv, tlen);
3160     SvGROW(sv, tlen + len + 1);
3161     if (ptr == junk)
3162         ptr = SvPVX(sv);
3163     Move(ptr,SvPVX(sv)+tlen,len,char);
3164     SvCUR(sv) += len;
3165     *SvEND(sv) = '\0';
3166     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3167     SvTAINT(sv);
3168 }
3169
3170 /*
3171 =for apidoc sv_catpvn_mg
3172
3173 Like C<sv_catpvn>, but also handles 'set' magic.
3174
3175 =cut
3176 */
3177
3178 void
3179 Perl_sv_catpvn_mg(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3180 {
3181     sv_catpvn(sv,ptr,len);
3182     SvSETMAGIC(sv);
3183 }
3184
3185 /*
3186 =for apidoc sv_catsv
3187
3188 Concatenates the string from SV C<ssv> onto the end of the string in SV
3189 C<dsv>.  Handles 'get' magic, but not 'set' magic.  See C<sv_catsv_mg>.
3190
3191 =cut
3192 */
3193
3194 void
3195 Perl_sv_catsv(pTHX_ SV *dstr, register SV *sstr)
3196 {
3197     char *s;
3198     STRLEN len;
3199     if (!sstr)
3200         return;
3201     if ((s = SvPV(sstr, len))) {
3202         if (DO_UTF8(sstr)) {
3203             sv_utf8_upgrade(dstr);
3204             sv_catpvn(dstr,s,len);
3205             SvUTF8_on(dstr);
3206         }
3207         else
3208             sv_catpvn(dstr,s,len);
3209     }
3210 }
3211
3212 /*
3213 =for apidoc sv_catsv_mg
3214
3215 Like C<sv_catsv>, but also handles 'set' magic.
3216
3217 =cut
3218 */
3219
3220 void
3221 Perl_sv_catsv_mg(pTHX_ SV *dstr, register SV *sstr)
3222 {
3223     sv_catsv(dstr,sstr);
3224     SvSETMAGIC(dstr);
3225 }
3226
3227 /*
3228 =for apidoc sv_catpv
3229
3230 Concatenates the string onto the end of the string which is in the SV.
3231 Handles 'get' magic, but not 'set' magic.  See C<sv_catpv_mg>.
3232
3233 =cut
3234 */
3235
3236 void
3237 Perl_sv_catpv(pTHX_ register SV *sv, register const char *ptr)
3238 {
3239     register STRLEN len;
3240     STRLEN tlen;
3241     char *junk;
3242
3243     if (!ptr)
3244         return;
3245     junk = SvPV_force(sv, tlen);
3246     len = strlen(ptr);
3247     SvGROW(sv, tlen + len + 1);
3248     if (ptr == junk)
3249         ptr = SvPVX(sv);
3250     Move(ptr,SvPVX(sv)+tlen,len+1,char);
3251     SvCUR(sv) += len;
3252     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3253     SvTAINT(sv);
3254 }
3255
3256 /*
3257 =for apidoc sv_catpv_mg
3258
3259 Like C<sv_catpv>, but also handles 'set' magic.
3260
3261 =cut
3262 */
3263
3264 void
3265 Perl_sv_catpv_mg(pTHX_ register SV *sv, register const char *ptr)
3266 {
3267     sv_catpv(sv,ptr);
3268     SvSETMAGIC(sv);
3269 }
3270
3271 SV *
3272 Perl_newSV(pTHX_ STRLEN len)
3273 {
3274     register SV *sv;
3275
3276     new_SV(sv);
3277     if (len) {
3278         sv_upgrade(sv, SVt_PV);
3279         SvGROW(sv, len + 1);
3280     }
3281     return sv;
3282 }
3283
3284 /* name is assumed to contain an SV* if (name && namelen == HEf_SVKEY) */
3285
3286 /*
3287 =for apidoc sv_magic
3288
3289 Adds magic to an SV.
3290
3291 =cut
3292 */
3293
3294 void
3295 Perl_sv_magic(pTHX_ register SV *sv, SV *obj, int how, const char *name, I32 namlen)
3296 {
3297     MAGIC* mg;
3298
3299     if (SvREADONLY(sv)) {
3300         if (PL_curcop != &PL_compiling && !strchr("gBf", how))
3301             Perl_croak(aTHX_ PL_no_modify);
3302     }
3303     if (SvMAGICAL(sv) || (how == 't' && SvTYPE(sv) >= SVt_PVMG)) {
3304         if (SvMAGIC(sv) && (mg = mg_find(sv, how))) {
3305             if (how == 't')
3306                 mg->mg_len |= 1;
3307             return;
3308         }
3309     }
3310     else {
3311         (void)SvUPGRADE(sv, SVt_PVMG);
3312     }
3313     Newz(702,mg, 1, MAGIC);
3314     mg->mg_moremagic = SvMAGIC(sv);
3315
3316     SvMAGIC(sv) = mg;
3317     if (!obj || obj == sv || how == '#' || how == 'r')
3318         mg->mg_obj = obj;
3319     else {
3320         mg->mg_obj = SvREFCNT_inc(obj);
3321         mg->mg_flags |= MGf_REFCOUNTED;
3322     }
3323     mg->mg_type = how;
3324     mg->mg_len = namlen;
3325     if (name)
3326         if (namlen >= 0)
3327             mg->mg_ptr = savepvn(name, namlen);
3328         else if (namlen == HEf_SVKEY)
3329             mg->mg_ptr = (char*)SvREFCNT_inc((SV*)name);
3330
3331     switch (how) {
3332     case 0:
3333         mg->mg_virtual = &PL_vtbl_sv;
3334         break;
3335     case 'A':
3336         mg->mg_virtual = &PL_vtbl_amagic;
3337         break;
3338     case 'a':
3339         mg->mg_virtual = &PL_vtbl_amagicelem;
3340         break;
3341     case 'c':
3342         mg->mg_virtual = 0;
3343         break;
3344     case 'B':
3345         mg->mg_virtual = &PL_vtbl_bm;
3346         break;
3347     case 'D':
3348         mg->mg_virtual = &PL_vtbl_regdata;
3349         break;
3350     case 'd':
3351         mg->mg_virtual = &PL_vtbl_regdatum;
3352         break;
3353     case 'E':
3354         mg->mg_virtual = &PL_vtbl_env;
3355         break;
3356     case 'f':
3357         mg->mg_virtual = &PL_vtbl_fm;
3358         break;
3359     case 'e':
3360         mg->mg_virtual = &PL_vtbl_envelem;
3361         break;
3362     case 'g':
3363         mg->mg_virtual = &PL_vtbl_mglob;
3364         break;
3365     case 'I':
3366         mg->mg_virtual = &PL_vtbl_isa;
3367         break;
3368     case 'i':
3369         mg->mg_virtual = &PL_vtbl_isaelem;
3370         break;
3371     case 'k':
3372         mg->mg_virtual = &PL_vtbl_nkeys;
3373         break;
3374     case 'L':
3375         SvRMAGICAL_on(sv);
3376         mg->mg_virtual = 0;
3377         break;
3378     case 'l':
3379         mg->mg_virtual = &PL_vtbl_dbline;
3380         break;
3381 #ifdef USE_THREADS
3382     case 'm':
3383         mg->mg_virtual = &PL_vtbl_mutex;
3384         break;
3385 #endif /* USE_THREADS */
3386 #ifdef USE_LOCALE_COLLATE
3387     case 'o':
3388         mg->mg_virtual = &PL_vtbl_collxfrm;
3389         break;
3390 #endif /* USE_LOCALE_COLLATE */
3391     case 'P':
3392         mg->mg_virtual = &PL_vtbl_pack;
3393         break;
3394     case 'p':
3395     case 'q':
3396         mg->mg_virtual = &PL_vtbl_packelem;
3397         break;
3398     case 'r':
3399         mg->mg_virtual = &PL_vtbl_regexp;
3400         break;
3401     case 'S':
3402         mg->mg_virtual = &PL_vtbl_sig;
3403         break;
3404     case 's':
3405         mg->mg_virtual = &PL_vtbl_sigelem;
3406         break;
3407     case 't':
3408         mg->mg_virtual = &PL_vtbl_taint;
3409         mg->mg_len = 1;
3410         break;
3411     case 'U':
3412         mg->mg_virtual = &PL_vtbl_uvar;
3413         break;
3414     case 'v':
3415         mg->mg_virtual = &PL_vtbl_vec;
3416         break;
3417     case 'x':
3418         mg->mg_virtual = &PL_vtbl_substr;
3419         break;
3420     case 'y':
3421         mg->mg_virtual = &PL_vtbl_defelem;
3422         break;
3423     case '*':
3424         mg->mg_virtual = &PL_vtbl_glob;
3425         break;
3426     case '#':
3427         mg->mg_virtual = &PL_vtbl_arylen;
3428         break;
3429     case '.':
3430         mg->mg_virtual = &PL_vtbl_pos;
3431         break;
3432     case '<':
3433         mg->mg_virtual = &PL_vtbl_backref;
3434         break;
3435     case '~':   /* Reserved for use by extensions not perl internals.   */
3436         /* Useful for attaching extension internal data to perl vars.   */
3437         /* Note that multiple extensions may clash if magical scalars   */
3438         /* etc holding private data from one are passed to another.     */
3439         SvRMAGICAL_on(sv);
3440         break;
3441     default:
3442         Perl_croak(aTHX_ "Don't know how to handle magic of type '%c'", how);
3443     }
3444     mg_magical(sv);
3445     if (SvGMAGICAL(sv))
3446         SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVf_POK);
3447 }
3448
3449 /*
3450 =for apidoc sv_unmagic
3451
3452 Removes magic from an SV.
3453
3454 =cut
3455 */
3456
3457 int
3458 Perl_sv_unmagic(pTHX_ SV *sv, int type)
3459 {
3460     MAGIC* mg;
3461     MAGIC** mgp;
3462     if (SvTYPE(sv) < SVt_PVMG || !SvMAGIC(sv))
3463         return 0;
3464     mgp = &SvMAGIC(sv);
3465     for (mg = *mgp; mg; mg = *mgp) {
3466         if (mg->mg_type == type) {
3467             MGVTBL* vtbl = mg->mg_virtual;
3468             *mgp = mg->mg_moremagic;
3469             if (vtbl && vtbl->svt_free)
3470                 CALL_FPTR(vtbl->svt_free)(aTHX_ sv, mg);
3471             if (mg->mg_ptr && mg->mg_type != 'g')
3472                 if (mg->mg_len >= 0)
3473                     Safefree(mg->mg_ptr);
3474                 else if (mg->mg_len == HEf_SVKEY)
3475                     SvREFCNT_dec((SV*)mg->mg_ptr);
3476             if (mg->mg_flags & MGf_REFCOUNTED)
3477                 SvREFCNT_dec(mg->mg_obj);
3478             Safefree(mg);
3479         }
3480         else
3481             mgp = &mg->mg_moremagic;
3482     }
3483     if (!SvMAGIC(sv)) {
3484         SvMAGICAL_off(sv);
3485         SvFLAGS(sv) |= (SvFLAGS(sv) & (SVp_IOK|SVp_NOK|SVp_POK)) >> PRIVSHIFT;
3486     }
3487
3488     return 0;
3489 }
3490
3491 /*
3492 =for apidoc sv_rvweaken
3493
3494 Weaken a reference.
3495
3496 =cut
3497 */
3498
3499 SV *
3500 Perl_sv_rvweaken(pTHX_ SV *sv)
3501 {
3502     SV *tsv;
3503     if (!SvOK(sv))  /* let undefs pass */
3504         return sv;
3505     if (!SvROK(sv))
3506         Perl_croak(aTHX_ "Can't weaken a nonreference");
3507     else if (SvWEAKREF(sv)) {
3508         if (ckWARN(WARN_MISC))
3509             Perl_warner(aTHX_ WARN_MISC, "Reference is already weak");
3510         return sv;
3511     }
3512     tsv = SvRV(sv);
3513     sv_add_backref(tsv, sv);
3514     SvWEAKREF_on(sv);
3515     SvREFCNT_dec(tsv);
3516     return sv;
3517 }
3518
3519 STATIC void
3520 S_sv_add_backref(pTHX_ SV *tsv, SV *sv)
3521 {
3522     AV *av;
3523     MAGIC *mg;
3524     if (SvMAGICAL(tsv) && (mg = mg_find(tsv, '<')))
3525         av = (AV*)mg->mg_obj;
3526     else {
3527         av = newAV();
3528         sv_magic(tsv, (SV*)av, '<', NULL, 0);
3529         SvREFCNT_dec(av);           /* for sv_magic */
3530     }
3531     av_push(av,sv);
3532 }
3533
3534 STATIC void
3535 S_sv_del_backref(pTHX_ SV *sv)
3536 {
3537     AV *av;
3538     SV **svp;
3539     I32 i;
3540     SV *tsv = SvRV(sv);
3541     MAGIC *mg;
3542     if (!SvMAGICAL(tsv) || !(mg = mg_find(tsv, '<')))
3543         Perl_croak(aTHX_ "panic: del_backref");
3544     av = (AV *)mg->mg_obj;
3545     svp = AvARRAY(av);
3546     i = AvFILLp(av);
3547     while (i >= 0) {
3548         if (svp[i] == sv) {
3549             svp[i] = &PL_sv_undef; /* XXX */
3550         }
3551         i--;
3552     }
3553 }
3554
3555 /*
3556 =for apidoc sv_insert
3557
3558 Inserts a string at the specified offset/length within the SV. Similar to
3559 the Perl substr() function.
3560
3561 =cut
3562 */
3563
3564 void
3565 Perl_sv_insert(pTHX_ SV *bigstr, STRLEN offset, STRLEN len, char *little, STRLEN littlelen)
3566 {
3567     register char *big;
3568     register char *mid;
3569     register char *midend;
3570     register char *bigend;
3571     register I32 i;
3572     STRLEN curlen;
3573
3574
3575     if (!bigstr)
3576         Perl_croak(aTHX_ "Can't modify non-existent substring");
3577     SvPV_force(bigstr, curlen);
3578     (void)SvPOK_only_UTF8(bigstr);
3579     if (offset + len > curlen) {
3580         SvGROW(bigstr, offset+len+1);
3581         Zero(SvPVX(bigstr)+curlen, offset+len-curlen, char);
3582         SvCUR_set(bigstr, offset+len);
3583     }
3584
3585     SvTAINT(bigstr);
3586     i = littlelen - len;
3587     if (i > 0) {                        /* string might grow */
3588         big = SvGROW(bigstr, SvCUR(bigstr) + i + 1);
3589         mid = big + offset + len;
3590         midend = bigend = big + SvCUR(bigstr);
3591         bigend += i;
3592         *bigend = '\0';
3593         while (midend > mid)            /* shove everything down */
3594             *--bigend = *--midend;
3595         Move(little,big+offset,littlelen,char);
3596         SvCUR(bigstr) += i;
3597         SvSETMAGIC(bigstr);
3598         return;
3599     }
3600     else if (i == 0) {
3601         Move(little,SvPVX(bigstr)+offset,len,char);
3602         SvSETMAGIC(bigstr);
3603         return;
3604     }
3605
3606     big = SvPVX(bigstr);
3607     mid = big + offset;
3608     midend = mid + len;
3609     bigend = big + SvCUR(bigstr);
3610
3611     if (midend > bigend)
3612         Perl_croak(aTHX_ "panic: sv_insert");
3613
3614     if (mid - big > bigend - midend) {  /* faster to shorten from end */
3615         if (littlelen) {
3616             Move(little, mid, littlelen,char);
3617             mid += littlelen;
3618         }
3619         i = bigend - midend;
3620         if (i > 0) {
3621             Move(midend, mid, i,char);
3622             mid += i;
3623         }
3624         *mid = '\0';
3625         SvCUR_set(bigstr, mid - big);
3626     }
3627     /*SUPPRESS 560*/
3628     else if ((i = mid - big)) { /* faster from front */
3629         midend -= littlelen;
3630         mid = midend;
3631         sv_chop(bigstr,midend-i);
3632         big += i;
3633         while (i--)
3634             *--midend = *--big;
3635         if (littlelen)
3636             Move(little, mid, littlelen,char);
3637     }
3638     else if (littlelen) {
3639         midend -= littlelen;
3640         sv_chop(bigstr,midend);
3641         Move(little,midend,littlelen,char);
3642     }
3643     else {
3644         sv_chop(bigstr,midend);
3645     }
3646     SvSETMAGIC(bigstr);
3647 }
3648
3649 /*
3650 =for apidoc sv_replace
3651
3652 Make the first argument a copy of the second, then delete the original.
3653
3654 =cut
3655 */
3656
3657 void
3658 Perl_sv_replace(pTHX_ register SV *sv, register SV *nsv)
3659 {
3660     U32 refcnt = SvREFCNT(sv);
3661     SV_CHECK_THINKFIRST(sv);
3662     if (SvREFCNT(nsv) != 1 && ckWARN_d(WARN_INTERNAL))
3663         Perl_warner(aTHX_ WARN_INTERNAL, "Reference miscount in sv_replace()");
3664     if (SvMAGICAL(sv)) {
3665         if (SvMAGICAL(nsv))
3666             mg_free(nsv);
3667         else
3668             sv_upgrade(nsv, SVt_PVMG);
3669         SvMAGIC(nsv) = SvMAGIC(sv);
3670         SvFLAGS(nsv) |= SvMAGICAL(sv);
3671         SvMAGICAL_off(sv);
3672         SvMAGIC(sv) = 0;
3673     }
3674     SvREFCNT(sv) = 0;
3675     sv_clear(sv);
3676     assert(!SvREFCNT(sv));
3677     StructCopy(nsv,sv,SV);
3678     SvREFCNT(sv) = refcnt;
3679     SvFLAGS(nsv) |= SVTYPEMASK;         /* Mark as freed */
3680     del_SV(nsv);
3681 }
3682
3683 /*
3684 =for apidoc sv_clear
3685
3686 Clear an SV, making it empty. Does not free the memory used by the SV
3687 itself.
3688
3689 =cut
3690 */
3691
3692 void
3693 Perl_sv_clear(pTHX_ register SV *sv)
3694 {
3695     HV* stash;
3696     assert(sv);
3697     assert(SvREFCNT(sv) == 0);
3698
3699     if (SvOBJECT(sv)) {
3700         if (PL_defstash) {              /* Still have a symbol table? */
3701             djSP;
3702             GV* destructor;
3703             SV tmpref;
3704
3705             Zero(&tmpref, 1, SV);
3706             sv_upgrade(&tmpref, SVt_RV);
3707             SvROK_on(&tmpref);
3708             SvREADONLY_on(&tmpref);     /* DESTROY() could be naughty */
3709             SvREFCNT(&tmpref) = 1;
3710
3711             do {
3712                 stash = SvSTASH(sv);
3713                 destructor = gv_fetchmethod(SvSTASH(sv), "DESTROY");
3714                 if (destructor) {
3715                     ENTER;
3716                     PUSHSTACKi(PERLSI_DESTROY);
3717                     SvRV(&tmpref) = SvREFCNT_inc(sv);
3718                     EXTEND(SP, 2);
3719                     PUSHMARK(SP);
3720                     PUSHs(&tmpref);
3721                     PUTBACK;
3722                     call_sv((SV*)GvCV(destructor),
3723                             G_DISCARD|G_EVAL|G_KEEPERR);
3724                     SvREFCNT(sv)--;
3725                     POPSTACK;
3726                     SPAGAIN;
3727                     LEAVE;
3728                 }
3729             } while (SvOBJECT(sv) && SvSTASH(sv) != stash);
3730
3731             del_XRV(SvANY(&tmpref));
3732
3733             if (SvREFCNT(sv)) {
3734                 if (PL_in_clean_objs)
3735                     Perl_croak(aTHX_ "DESTROY created new reference to dead object '%s'",
3736                           HvNAME(stash));
3737                 /* DESTROY gave object new lease on life */
3738                 return;
3739             }
3740         }
3741
3742         if (SvOBJECT(sv)) {
3743             SvREFCNT_dec(SvSTASH(sv));  /* possibly of changed persuasion */
3744             SvOBJECT_off(sv);   /* Curse the object. */
3745             if (SvTYPE(sv) != SVt_PVIO)
3746                 --PL_sv_objcount;       /* XXX Might want something more general */
3747         }
3748     }
3749     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv))
3750         mg_free(sv);
3751     stash = NULL;
3752     switch (SvTYPE(sv)) {
3753     case SVt_PVIO:
3754         if (IoIFP(sv) &&
3755             IoIFP(sv) != PerlIO_stdin() &&
3756             IoIFP(sv) != PerlIO_stdout() &&
3757             IoIFP(sv) != PerlIO_stderr())
3758         {
3759             io_close((IO*)sv, FALSE);
3760         }
3761         if (IoDIRP(sv) && !(IoFLAGS(sv) & IOf_FAKE_DIRP))
3762             PerlDir_close(IoDIRP(sv));
3763         IoDIRP(sv) = (DIR*)NULL;
3764         Safefree(IoTOP_NAME(sv));
3765         Safefree(IoFMT_NAME(sv));
3766         Safefree(IoBOTTOM_NAME(sv));
3767         /* FALL THROUGH */
3768     case SVt_PVBM:
3769         goto freescalar;
3770     case SVt_PVCV:
3771     case SVt_PVFM:
3772         cv_undef((CV*)sv);
3773         goto freescalar;
3774     case SVt_PVHV:
3775         hv_undef((HV*)sv);
3776         break;
3777     case SVt_PVAV:
3778         av_undef((AV*)sv);
3779         break;
3780     case SVt_PVLV:
3781         SvREFCNT_dec(LvTARG(sv));
3782         goto freescalar;
3783     case SVt_PVGV:
3784         gp_free((GV*)sv);
3785         Safefree(GvNAME(sv));
3786         /* cannot decrease stash refcount yet, as we might recursively delete
3787            ourselves when the refcnt drops to zero. Delay SvREFCNT_dec
3788            of stash until current sv is completely gone.
3789            -- JohnPC, 27 Mar 1998 */
3790         stash = GvSTASH(sv);
3791         /* FALL THROUGH */
3792     case SVt_PVMG:
3793     case SVt_PVNV:
3794     case SVt_PVIV:
3795       freescalar:
3796         (void)SvOOK_off(sv);
3797         /* FALL THROUGH */
3798     case SVt_PV:
3799     case SVt_RV:
3800         if (SvROK(sv)) {
3801             if (SvWEAKREF(sv))
3802                 sv_del_backref(sv);
3803             else
3804                 SvREFCNT_dec(SvRV(sv));
3805         }
3806         else if (SvPVX(sv) && SvLEN(sv))
3807             Safefree(SvPVX(sv));
3808         else if (SvPVX(sv) && SvREADONLY(sv) && SvFAKE(sv)) {
3809             unsharepvn(SvPVX(sv),SvCUR(sv),SvUVX(sv));
3810             SvFAKE_off(sv);
3811         }
3812         break;
3813 /*
3814     case SVt_NV:
3815     case SVt_IV:
3816     case SVt_NULL:
3817         break;
3818 */
3819     }
3820
3821     switch (SvTYPE(sv)) {
3822     case SVt_NULL:
3823         break;
3824     case SVt_IV:
3825         del_XIV(SvANY(sv));
3826         break;
3827     case SVt_NV:
3828         del_XNV(SvANY(sv));
3829         break;
3830     case SVt_RV:
3831         del_XRV(SvANY(sv));
3832         break;
3833     case SVt_PV:
3834         del_XPV(SvANY(sv));
3835         break;
3836     case SVt_PVIV:
3837         del_XPVIV(SvANY(sv));
3838         break;
3839     case SVt_PVNV:
3840         del_XPVNV(SvANY(sv));
3841         break;
3842     case SVt_PVMG:
3843         del_XPVMG(SvANY(sv));
3844         break;
3845     case SVt_PVLV:
3846         del_XPVLV(SvANY(sv));
3847         break;
3848     case SVt_PVAV:
3849         del_XPVAV(SvANY(sv));
3850         break;
3851     case SVt_PVHV:
3852         del_XPVHV(SvANY(sv));
3853         break;
3854     case SVt_PVCV:
3855         del_XPVCV(SvANY(sv));
3856         break;
3857     case SVt_PVGV:
3858         del_XPVGV(SvANY(sv));
3859         /* code duplication for increased performance. */
3860         SvFLAGS(sv) &= SVf_BREAK;
3861         SvFLAGS(sv) |= SVTYPEMASK;
3862         /* decrease refcount of the stash that owns this GV, if any */
3863         if (stash)
3864             SvREFCNT_dec(stash);
3865         return; /* not break, SvFLAGS reset already happened */
3866     case SVt_PVBM:
3867         del_XPVBM(SvANY(sv));
3868         break;
3869     case SVt_PVFM:
3870         del_XPVFM(SvANY(sv));
3871         break;
3872     case SVt_PVIO:
3873         del_XPVIO(SvANY(sv));
3874         break;
3875     }
3876     SvFLAGS(sv) &= SVf_BREAK;
3877     SvFLAGS(sv) |= SVTYPEMASK;
3878 }
3879
3880 SV *
3881 Perl_sv_newref(pTHX_ SV *sv)
3882 {
3883     if (sv)
3884         ATOMIC_INC(SvREFCNT(sv));
3885     return sv;
3886 }
3887
3888 /*
3889 =for apidoc sv_free
3890
3891 Free the memory used by an SV.
3892
3893 =cut
3894 */
3895
3896 void
3897 Perl_sv_free(pTHX_ SV *sv)
3898 {
3899     int refcount_is_zero;
3900
3901     if (!sv)
3902         return;
3903     if (SvREFCNT(sv) == 0) {
3904         if (SvFLAGS(sv) & SVf_BREAK)
3905             return;
3906         if (PL_in_clean_all) /* All is fair */
3907             return;
3908         if (SvREADONLY(sv) && SvIMMORTAL(sv)) {
3909             /* make sure SvREFCNT(sv)==0 happens very seldom */
3910             SvREFCNT(sv) = (~(U32)0)/2;
3911             return;
3912         }
3913         if (ckWARN_d(WARN_INTERNAL))
3914             Perl_warner(aTHX_ WARN_INTERNAL, "Attempt to free unreferenced scalar");
3915         return;
3916     }
3917     ATOMIC_DEC_AND_TEST(refcount_is_zero, SvREFCNT(sv));
3918     if (!refcount_is_zero)
3919         return;
3920 #ifdef DEBUGGING
3921     if (SvTEMP(sv)) {
3922         if (ckWARN_d(WARN_DEBUGGING))
3923             Perl_warner(aTHX_ WARN_DEBUGGING,
3924                         "Attempt to free temp prematurely: SV 0x%"UVxf,
3925                         PTR2UV(sv));
3926         return;
3927     }
3928 #endif
3929     if (SvREADONLY(sv) && SvIMMORTAL(sv)) {
3930         /* make sure SvREFCNT(sv)==0 happens very seldom */
3931         SvREFCNT(sv) = (~(U32)0)/2;
3932         return;
3933     }
3934     sv_clear(sv);
3935     if (! SvREFCNT(sv))
3936         del_SV(sv);
3937 }
3938
3939 /*
3940 =for apidoc sv_len
3941
3942 Returns the length of the string in the SV.  See also C<SvCUR>.
3943
3944 =cut
3945 */
3946
3947 STRLEN
3948 Perl_sv_len(pTHX_ register SV *sv)
3949 {
3950     char *junk;
3951     STRLEN len;
3952
3953     if (!sv)
3954         return 0;
3955
3956     if (SvGMAGICAL(sv))
3957         len = mg_length(sv);
3958     else
3959         junk = SvPV(sv, len);
3960     return len;
3961 }
3962
3963 /*
3964 =for apidoc sv_len_utf8
3965
3966 Returns the number of characters in the string in an SV, counting wide
3967 UTF8 bytes as a single character.
3968
3969 =cut
3970 */
3971
3972 STRLEN
3973 Perl_sv_len_utf8(pTHX_ register SV *sv)
3974 {
3975     if (!sv)
3976         return 0;
3977
3978 #ifdef NOTYET
3979     if (SvGMAGICAL(sv))
3980         return mg_length(sv);
3981     else
3982 #endif
3983     {
3984         STRLEN len;
3985         U8 *s = (U8*)SvPV(sv, len);
3986
3987         return Perl_utf8_length(aTHX_ s, s + len);
3988     }
3989 }
3990
3991 void
3992 Perl_sv_pos_u2b(pTHX_ register SV *sv, I32* offsetp, I32* lenp)
3993 {
3994     U8 *start;
3995     U8 *s;
3996     U8 *send;
3997     I32 uoffset = *offsetp;
3998     STRLEN len;
3999
4000     if (!sv)
4001         return;
4002
4003     start = s = (U8*)SvPV(sv, len);
4004     send = s + len;
4005     while (s < send && uoffset--)
4006         s += UTF8SKIP(s);
4007     if (s >= send)
4008         s = send;
4009     *offsetp = s - start;
4010     if (lenp) {
4011         I32 ulen = *lenp;
4012         start = s;
4013         while (s < send && ulen--)
4014             s += UTF8SKIP(s);
4015         if (s >= send)
4016             s = send;
4017         *lenp = s - start;
4018     }
4019     return;
4020 }
4021
4022 void
4023 Perl_sv_pos_b2u(pTHX_ register SV *sv, I32* offsetp)
4024 {
4025     U8 *s;
4026     U8 *send;
4027     STRLEN len;
4028
4029     if (!sv)
4030         return;
4031
4032     s = (U8*)SvPV(sv, len);
4033     if (len < *offsetp)
4034         Perl_croak(aTHX_ "panic: bad byte offset");
4035     send = s + *offsetp;
4036     len = 0;
4037     while (s < send) {
4038         s += UTF8SKIP(s);
4039         ++len;
4040     }
4041     if (s != send) {
4042         if (ckWARN_d(WARN_UTF8))
4043             Perl_warner(aTHX_ WARN_UTF8, "Malformed UTF-8 character");
4044         --len;
4045     }
4046     *offsetp = len;
4047     return;
4048 }
4049
4050 /*
4051 =for apidoc sv_eq
4052
4053 Returns a boolean indicating whether the strings in the two SVs are
4054 identical.
4055
4056 =cut
4057 */
4058
4059 I32
4060 Perl_sv_eq(pTHX_ register SV *sv1, register SV *sv2)
4061 {
4062     char *pv1;
4063     STRLEN cur1;
4064     char *pv2;
4065     STRLEN cur2;
4066     I32  eq     = 0;
4067     bool pv1tmp = FALSE;
4068     bool pv2tmp = FALSE;
4069
4070     if (!sv1) {
4071         pv1 = "";
4072         cur1 = 0;
4073     }
4074     else
4075         pv1 = SvPV(sv1, cur1);
4076
4077     if (!sv2){
4078         pv2 = "";
4079         cur2 = 0;
4080     }
4081     else
4082         pv2 = SvPV(sv2, cur2);
4083
4084     /* do not utf8ize the comparands as a side-effect */
4085     if (cur1 && cur2 && SvUTF8(sv1) != SvUTF8(sv2) && !IN_BYTE) {
4086         if (SvUTF8(sv1)) {
4087             pv2 = (char*)bytes_to_utf8((U8*)pv2, &cur2);
4088             pv2tmp = TRUE;
4089         }
4090         else {
4091             pv1 = (char*)bytes_to_utf8((U8*)pv1, &cur1);
4092             pv1tmp = TRUE;
4093         }
4094     }
4095
4096     if (cur1 == cur2)
4097         eq = memEQ(pv1, pv2, cur1);
4098
4099     if (pv1tmp)
4100         Safefree(pv1);
4101     if (pv2tmp)
4102         Safefree(pv2);
4103
4104     return eq;
4105 }
4106
4107 /*
4108 =for apidoc sv_cmp
4109
4110 Compares the strings in two SVs.  Returns -1, 0, or 1 indicating whether the
4111 string in C<sv1> is less than, equal to, or greater than the string in
4112 C<sv2>.
4113
4114 =cut
4115 */
4116
4117 I32
4118 Perl_sv_cmp(pTHX_ register SV *sv1, register SV *sv2)
4119 {
4120     STRLEN cur1, cur2;
4121     char *pv1, *pv2;
4122     I32  cmp;
4123     bool pv1tmp = FALSE;
4124     bool pv2tmp = FALSE;
4125
4126     if (!sv1) {
4127         pv1 = "";
4128         cur1 = 0;
4129     }
4130     else
4131         pv1 = SvPV(sv1, cur1);
4132
4133     if (!sv2){
4134         pv2 = "";
4135         cur2 = 0;
4136     }
4137     else
4138         pv2 = SvPV(sv2, cur2);
4139
4140     /* do not utf8ize the comparands as a side-effect */
4141     if (cur1 && cur2 && SvUTF8(sv1) != SvUTF8(sv2) && !IN_BYTE) {
4142         if (SvUTF8(sv1)) {
4143             pv2 = (char*)bytes_to_utf8((U8*)pv2, &cur2);
4144             pv2tmp = TRUE;
4145         }
4146         else {
4147             pv1 = (char*)bytes_to_utf8((U8*)pv1, &cur1);
4148             pv1tmp = TRUE;
4149         }
4150     }
4151
4152     if (!cur1) {
4153         cmp = cur2 ? -1 : 0;
4154     } else if (!cur2) {
4155         cmp = 1;
4156     } else {
4157         I32 retval = memcmp((void*)pv1, (void*)pv2, cur1 < cur2 ? cur1 : cur2);
4158
4159         if (retval) {
4160             cmp = retval < 0 ? -1 : 1;
4161         } else if (cur1 == cur2) {
4162             cmp = 0;
4163         } else {
4164             cmp = cur1 < cur2 ? -1 : 1;
4165         }
4166     }
4167
4168     if (pv1tmp)
4169         Safefree(pv1);
4170     if (pv2tmp)
4171         Safefree(pv2);
4172
4173     return cmp;
4174 }
4175
4176 /*
4177 =for apidoc sv_cmp_locale
4178
4179 Compares the strings in two SVs in a locale-aware manner. See
4180 L</sv_cmp_locale>
4181
4182 =cut
4183 */
4184
4185 I32
4186 Perl_sv_cmp_locale(pTHX_ register SV *sv1, register SV *sv2)
4187 {
4188 #ifdef USE_LOCALE_COLLATE
4189
4190     char *pv1, *pv2;
4191     STRLEN len1, len2;
4192     I32 retval;
4193
4194     if (PL_collation_standard)
4195         goto raw_compare;
4196
4197     len1 = 0;
4198     pv1 = sv1 ? sv_collxfrm(sv1, &len1) : (char *) NULL;
4199     len2 = 0;
4200     pv2 = sv2 ? sv_collxfrm(sv2, &len2) : (char *) NULL;
4201
4202     if (!pv1 || !len1) {
4203         if (pv2 && len2)
4204             return -1;
4205         else
4206             goto raw_compare;
4207     }
4208     else {
4209         if (!pv2 || !len2)
4210             return 1;
4211     }
4212
4213     retval = memcmp((void*)pv1, (void*)pv2, len1 < len2 ? len1 : len2);
4214
4215     if (retval)
4216         return retval < 0 ? -1 : 1;
4217
4218     /*
4219      * When the result of collation is equality, that doesn't mean
4220      * that there are no differences -- some locales exclude some
4221      * characters from consideration.  So to avoid false equalities,
4222      * we use the raw string as a tiebreaker.
4223      */
4224
4225   raw_compare:
4226     /* FALL THROUGH */
4227
4228 #endif /* USE_LOCALE_COLLATE */
4229
4230     return sv_cmp(sv1, sv2);
4231 }
4232
4233 #ifdef USE_LOCALE_COLLATE
4234 /*
4235  * Any scalar variable may carry an 'o' magic that contains the
4236  * scalar data of the variable transformed to such a format that
4237  * a normal memory comparison can be used to compare the data
4238  * according to the locale settings.
4239  */
4240 char *
4241 Perl_sv_collxfrm(pTHX_ SV *sv, STRLEN *nxp)
4242 {
4243     MAGIC *mg;
4244
4245     mg = SvMAGICAL(sv) ? mg_find(sv, 'o') : (MAGIC *) NULL;
4246     if (!mg || !mg->mg_ptr || *(U32*)mg->mg_ptr != PL_collation_ix) {
4247         char *s, *xf;
4248         STRLEN len, xlen;
4249
4250         if (mg)
4251             Safefree(mg->mg_ptr);
4252         s = SvPV(sv, len);
4253         if ((xf = mem_collxfrm(s, len, &xlen))) {
4254             if (SvREADONLY(sv)) {
4255                 SAVEFREEPV(xf);
4256                 *nxp = xlen;
4257                 return xf + sizeof(PL_collation_ix);
4258             }
4259             if (! mg) {
4260                 sv_magic(sv, 0, 'o', 0, 0);
4261                 mg = mg_find(sv, 'o');
4262                 assert(mg);
4263             }
4264             mg->mg_ptr = xf;
4265             mg->mg_len = xlen;
4266         }
4267         else {
4268             if (mg) {
4269                 mg->mg_ptr = NULL;
4270                 mg->mg_len = -1;
4271             }
4272         }
4273     }
4274     if (mg && mg->mg_ptr) {
4275         *nxp = mg->mg_len;
4276         return mg->mg_ptr + sizeof(PL_collation_ix);
4277     }
4278     else {
4279         *nxp = 0;
4280         return NULL;
4281     }
4282 }
4283
4284 #endif /* USE_LOCALE_COLLATE */
4285
4286 /*
4287 =for apidoc sv_gets
4288
4289 Get a line from the filehandle and store it into the SV, optionally
4290 appending to the currently-stored string.
4291
4292 =cut
4293 */
4294
4295 char *
4296 Perl_sv_gets(pTHX_ register SV *sv, register PerlIO *fp, I32 append)
4297 {
4298     char *rsptr;
4299     STRLEN rslen;
4300     register STDCHAR rslast;
4301     register STDCHAR *bp;
4302     register I32 cnt;
4303     I32 i;
4304
4305     SV_CHECK_THINKFIRST(sv);
4306     (void)SvUPGRADE(sv, SVt_PV);
4307
4308     SvSCREAM_off(sv);
4309
4310     if (RsSNARF(PL_rs)) {
4311         rsptr = NULL;
4312         rslen = 0;
4313     }
4314     else if (RsRECORD(PL_rs)) {
4315       I32 recsize, bytesread;
4316       char *buffer;
4317
4318       /* Grab the size of the record we're getting */
4319       recsize = SvIV(SvRV(PL_rs));
4320       (void)SvPOK_only(sv);    /* Validate pointer */
4321       buffer = SvGROW(sv, recsize + 1);
4322       /* Go yank in */
4323 #ifdef VMS
4324       /* VMS wants read instead of fread, because fread doesn't respect */
4325       /* RMS record boundaries. This is not necessarily a good thing to be */
4326       /* doing, but we've got no other real choice */
4327       bytesread = PerlLIO_read(PerlIO_fileno(fp), buffer, recsize);
4328 #else
4329       bytesread = PerlIO_read(fp, buffer, recsize);
4330 #endif
4331       SvCUR_set(sv, bytesread);
4332       buffer[bytesread] = '\0';
4333       return(SvCUR(sv) ? SvPVX(sv) : Nullch);
4334     }
4335     else if (RsPARA(PL_rs)) {
4336         rsptr = "\n\n";
4337         rslen = 2;
4338     }
4339     else
4340         rsptr = SvPV(PL_rs, rslen);
4341     rslast = rslen ? rsptr[rslen - 1] : '\0';
4342
4343     if (RsPARA(PL_rs)) {                /* have to do this both before and after */
4344         do {                    /* to make sure file boundaries work right */
4345             if (PerlIO_eof(fp))
4346                 return 0;
4347             i = PerlIO_getc(fp);
4348             if (i != '\n') {
4349                 if (i == -1)
4350                     return 0;
4351                 PerlIO_ungetc(fp,i);
4352                 break;
4353             }
4354         } while (i != EOF);
4355     }
4356
4357     /* See if we know enough about I/O mechanism to cheat it ! */
4358
4359     /* This used to be #ifdef test - it is made run-time test for ease
4360        of abstracting out stdio interface. One call should be cheap
4361        enough here - and may even be a macro allowing compile
4362        time optimization.
4363      */
4364
4365     if (PerlIO_fast_gets(fp)) {
4366
4367     /*
4368      * We're going to steal some values from the stdio struct
4369      * and put EVERYTHING in the innermost loop into registers.
4370      */
4371     register STDCHAR *ptr;
4372     STRLEN bpx;
4373     I32 shortbuffered;
4374
4375 #if defined(VMS) && defined(PERLIO_IS_STDIO)
4376     /* An ungetc()d char is handled separately from the regular
4377      * buffer, so we getc() it back out and stuff it in the buffer.
4378      */
4379     i = PerlIO_getc(fp);
4380     if (i == EOF) return 0;
4381     *(--((*fp)->_ptr)) = (unsigned char) i;
4382     (*fp)->_cnt++;
4383 #endif
4384
4385     /* Here is some breathtakingly efficient cheating */
4386
4387     cnt = PerlIO_get_cnt(fp);                   /* get count into register */
4388     (void)SvPOK_only(sv);               /* validate pointer */
4389     if (SvLEN(sv) - append <= cnt + 1) { /* make sure we have the room */
4390         if (cnt > 80 && SvLEN(sv) > append) {
4391             shortbuffered = cnt - SvLEN(sv) + append + 1;
4392             cnt -= shortbuffered;
4393         }
4394         else {
4395             shortbuffered = 0;
4396             /* remember that cnt can be negative */
4397             SvGROW(sv, append + (cnt <= 0 ? 2 : (cnt + 1)));
4398         }
4399     }
4400     else
4401         shortbuffered = 0;
4402     bp = (STDCHAR*)SvPVX(sv) + append;  /* move these two too to registers */
4403     ptr = (STDCHAR*)PerlIO_get_ptr(fp);
4404     DEBUG_P(PerlIO_printf(Perl_debug_log,
4405         "Screamer: entering, ptr=%"UVuf", cnt=%ld\n",PTR2UV(ptr),(long)cnt));
4406     DEBUG_P(PerlIO_printf(Perl_debug_log,
4407         "Screamer: entering: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
4408                PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp),
4409                PTR2UV(PerlIO_has_base(fp) ? PerlIO_get_base(fp) : 0)));
4410     for (;;) {
4411       screamer:
4412         if (cnt > 0) {
4413             if (rslen) {
4414                 while (cnt > 0) {                    /* this     |  eat */
4415                     cnt--;
4416                     if ((*bp++ = *ptr++) == rslast)  /* really   |  dust */
4417                         goto thats_all_folks;        /* screams  |  sed :-) */
4418                 }
4419             }
4420             else {
4421                 Copy(ptr, bp, cnt, char);            /* this     |  eat */
4422                 bp += cnt;                           /* screams  |  dust */
4423                 ptr += cnt;                          /* louder   |  sed :-) */
4424                 cnt = 0;
4425             }
4426         }
4427
4428         if (shortbuffered) {            /* oh well, must extend */
4429             cnt = shortbuffered;
4430             shortbuffered = 0;
4431             bpx = bp - (STDCHAR*)SvPVX(sv); /* box up before relocation */
4432             SvCUR_set(sv, bpx);
4433             SvGROW(sv, SvLEN(sv) + append + cnt + 2);
4434             bp = (STDCHAR*)SvPVX(sv) + bpx; /* unbox after relocation */
4435             continue;
4436         }
4437
4438         DEBUG_P(PerlIO_printf(Perl_debug_log,
4439                               "Screamer: going to getc, ptr=%"UVuf", cnt=%ld\n",
4440                               PTR2UV(ptr),(long)cnt));
4441         PerlIO_set_ptrcnt(fp, ptr, cnt); /* deregisterize cnt and ptr */
4442         DEBUG_P(PerlIO_printf(Perl_debug_log,
4443             "Screamer: pre: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
4444             PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp),
4445             PTR2UV(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
4446         /* This used to call 'filbuf' in stdio form, but as that behaves like
4447            getc when cnt <= 0 we use PerlIO_getc here to avoid introducing
4448            another abstraction.  */
4449         i   = PerlIO_getc(fp);          /* get more characters */
4450         DEBUG_P(PerlIO_printf(Perl_debug_log,
4451             "Screamer: post: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
4452             PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp),
4453             PTR2UV(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
4454         cnt = PerlIO_get_cnt(fp);
4455         ptr = (STDCHAR*)PerlIO_get_ptr(fp);     /* reregisterize cnt and ptr */
4456         DEBUG_P(PerlIO_printf(Perl_debug_log,
4457             "Screamer: after getc, ptr=%"UVuf", cnt=%ld\n",PTR2UV(ptr),(long)cnt));
4458
4459         if (i == EOF)                   /* all done for ever? */
4460             goto thats_really_all_folks;
4461
4462         bpx = bp - (STDCHAR*)SvPVX(sv); /* box up before relocation */
4463         SvCUR_set(sv, bpx);
4464         SvGROW(sv, bpx + cnt + 2);
4465         bp = (STDCHAR*)SvPVX(sv) + bpx; /* unbox after relocation */
4466
4467         *bp++ = i;                      /* store character from PerlIO_getc */
4468
4469         if (rslen && (STDCHAR)i == rslast)  /* all done for now? */
4470             goto thats_all_folks;
4471     }
4472
4473 thats_all_folks:
4474     if ((rslen > 1 && (bp - (STDCHAR*)SvPVX(sv) < rslen)) ||
4475           memNE((char*)bp - rslen, rsptr, rslen))
4476         goto screamer;                          /* go back to the fray */
4477 thats_really_all_folks:
4478     if (shortbuffered)
4479         cnt += shortbuffered;
4480         DEBUG_P(PerlIO_printf(Perl_debug_log,
4481             "Screamer: quitting, ptr=%"UVuf", cnt=%ld\n",PTR2UV(ptr),(long)cnt));
4482     PerlIO_set_ptrcnt(fp, ptr, cnt);    /* put these back or we're in trouble */
4483     DEBUG_P(PerlIO_printf(Perl_debug_log,
4484         "Screamer: end: FILE * thinks ptr=%"UVuf", cnt=%ld, base=%"UVuf"\n",
4485         PTR2UV(PerlIO_get_ptr(fp)), (long)PerlIO_get_cnt(fp),
4486         PTR2UV(PerlIO_has_base (fp) ? PerlIO_get_base(fp) : 0)));
4487     *bp = '\0';
4488     SvCUR_set(sv, bp - (STDCHAR*)SvPVX(sv));    /* set length */
4489     DEBUG_P(PerlIO_printf(Perl_debug_log,
4490         "Screamer: done, len=%ld, string=|%.*s|\n",
4491         (long)SvCUR(sv),(int)SvCUR(sv),SvPVX(sv)));
4492     }
4493    else
4494     {
4495 #ifndef EPOC
4496        /*The big, slow, and stupid way */
4497         STDCHAR buf[8192];
4498 #else
4499         /* Need to work around EPOC SDK features          */
4500         /* On WINS: MS VC5 generates calls to _chkstk,    */
4501         /* if a `large' stack frame is allocated          */
4502         /* gcc on MARM does not generate calls like these */
4503         STDCHAR buf[1024];
4504 #endif
4505
4506 screamer2:
4507         if (rslen) {
4508             register STDCHAR *bpe = buf + sizeof(buf);
4509             bp = buf;
4510             while ((i = PerlIO_getc(fp)) != EOF && (*bp++ = i) != rslast && bp < bpe)
4511                 ; /* keep reading */
4512             cnt = bp - buf;
4513         }
4514         else {
4515             cnt = PerlIO_read(fp,(char*)buf, sizeof(buf));
4516             /* Accomodate broken VAXC compiler, which applies U8 cast to
4517              * both args of ?: operator, causing EOF to change into 255
4518              */
4519             if (cnt) { i = (U8)buf[cnt - 1]; } else { i = EOF; }
4520         }
4521
4522         if (append)
4523             sv_catpvn(sv, (char *) buf, cnt);
4524         else
4525             sv_setpvn(sv, (char *) buf, cnt);
4526
4527         if (i != EOF &&                 /* joy */
4528             (!rslen ||
4529              SvCUR(sv) < rslen ||
4530              memNE(SvPVX(sv) + SvCUR(sv) - rslen, rsptr, rslen)))
4531         {
4532             append = -1;
4533             /*
4534              * If we're reading from a TTY and we get a short read,
4535              * indicating that the user hit his EOF character, we need
4536              * to notice it now, because if we try to read from the TTY
4537              * again, the EOF condition will disappear.
4538              *
4539              * The comparison of cnt to sizeof(buf) is an optimization
4540              * that prevents unnecessary calls to feof().
4541              *
4542              * - jik 9/25/96
4543              */
4544             if (!(cnt < sizeof(buf) && PerlIO_eof(fp)))
4545                 goto screamer2;
4546         }
4547     }
4548
4549     if (RsPARA(PL_rs)) {                /* have to do this both before and after */
4550         while (i != EOF) {      /* to make sure file boundaries work right */
4551             i = PerlIO_getc(fp);
4552             if (i != '\n') {
4553                 PerlIO_ungetc(fp,i);
4554                 break;
4555             }
4556         }
4557     }
4558
4559     return (SvCUR(sv) - append) ? SvPVX(sv) : Nullch;
4560 }
4561
4562
4563 /*
4564 =for apidoc sv_inc
4565
4566 Auto-increment of the value in the SV.
4567
4568 =cut
4569 */
4570
4571 void
4572 Perl_sv_inc(pTHX_ register SV *sv)
4573 {
4574     register char *d;
4575     int flags;
4576
4577     if (!sv)
4578         return;
4579     if (SvGMAGICAL(sv))
4580         mg_get(sv);
4581     if (SvTHINKFIRST(sv)) {
4582         if (SvREADONLY(sv)) {
4583             if (PL_curcop != &PL_compiling)
4584                 Perl_croak(aTHX_ PL_no_modify);
4585         }
4586         if (SvROK(sv)) {
4587             IV i;
4588             if (SvAMAGIC(sv) && AMG_CALLun(sv,inc))
4589                 return;
4590             i = PTR2IV(SvRV(sv));
4591             sv_unref(sv);
4592             sv_setiv(sv, i);
4593         }
4594     }
4595     flags = SvFLAGS(sv);
4596     if (flags & SVp_NOK) {
4597         (void)SvNOK_only(sv);
4598         SvNVX(sv) += 1.0;
4599         return;
4600     }
4601     if (flags & SVp_IOK) {
4602         if (SvIsUV(sv)) {
4603             if (SvUVX(sv) == UV_MAX)
4604                 sv_setnv(sv, (NV)UV_MAX + 1.0);
4605             else
4606                 (void)SvIOK_only_UV(sv);
4607                 ++SvUVX(sv);
4608         } else {
4609             if (SvIVX(sv) == IV_MAX)
4610                 sv_setnv(sv, (NV)IV_MAX + 1.0);
4611             else {
4612                 (void)SvIOK_only(sv);
4613                 ++SvIVX(sv);
4614             }
4615         }
4616         return;
4617     }
4618     if (!(flags & SVp_POK) || !*SvPVX(sv)) {
4619         if ((flags & SVTYPEMASK) < SVt_PVNV)
4620            sv_upgrade(sv, SVt_IV);
4621        (void)SvIOK_only(sv);
4622        SvIVX(sv) = 1;
4623         return;
4624     }
4625     d = SvPVX(sv);
4626     while (isALPHA(*d)) d++;
4627     while (isDIGIT(*d)) d++;
4628     if (*d) {
4629         sv_setnv(sv,Atof(SvPVX(sv)) + 1.0);  /* punt */
4630         return;
4631     }
4632     d--;
4633     while (d >= SvPVX(sv)) {
4634         if (isDIGIT(*d)) {
4635             if (++*d <= '9')
4636                 return;
4637             *(d--) = '0';
4638         }
4639         else {
4640 #ifdef EBCDIC
4641             /* MKS: The original code here died if letters weren't consecutive.
4642              * at least it didn't have to worry about non-C locales.  The
4643              * new code assumes that ('z'-'a')==('Z'-'A'), letters are
4644              * arranged in order (although not consecutively) and that only
4645              * [A-Za-z] are accepted by isALPHA in the C locale.
4646              */
4647             if (*d != 'z' && *d != 'Z') {
4648                 do { ++*d; } while (!isALPHA(*d));
4649                 return;
4650             }
4651             *(d--) -= 'z' - 'a';
4652 #else
4653             ++*d;
4654             if (isALPHA(*d))
4655                 return;
4656             *(d--) -= 'z' - 'a' + 1;
4657 #endif
4658         }
4659     }
4660     /* oh,oh, the number grew */
4661     SvGROW(sv, SvCUR(sv) + 2);
4662     SvCUR(sv)++;
4663     for (d = SvPVX(sv) + SvCUR(sv); d > SvPVX(sv); d--)
4664         *d = d[-1];
4665     if (isDIGIT(d[1]))
4666         *d = '1';
4667     else
4668         *d = d[1];
4669 }
4670
4671 /*
4672 =for apidoc sv_dec
4673
4674 Auto-decrement of the value in the SV.
4675
4676 =cut
4677 */
4678
4679 void
4680 Perl_sv_dec(pTHX_ register SV *sv)
4681 {
4682     int flags;
4683
4684     if (!sv)
4685         return;
4686     if (SvGMAGICAL(sv))
4687         mg_get(sv);
4688     if (SvTHINKFIRST(sv)) {
4689         if (SvREADONLY(sv)) {
4690             if (PL_curcop != &PL_compiling)
4691                 Perl_croak(aTHX_ PL_no_modify);
4692         }
4693         if (SvROK(sv)) {
4694             IV i;
4695             if (SvAMAGIC(sv) && AMG_CALLun(sv,dec))
4696                 return;
4697             i = PTR2IV(SvRV(sv));
4698             sv_unref(sv);
4699             sv_setiv(sv, i);
4700         }
4701     }
4702     flags = SvFLAGS(sv);
4703     if (flags & SVp_NOK) {
4704         SvNVX(sv) -= 1.0;
4705         (void)SvNOK_only(sv);
4706         return;
4707     }
4708     if (flags & SVp_IOK) {
4709         if (SvIsUV(sv)) {
4710             if (SvUVX(sv) == 0) {
4711                 (void)SvIOK_only(sv);
4712                 SvIVX(sv) = -1;
4713             }
4714             else {
4715                 (void)SvIOK_only_UV(sv);
4716                 --SvUVX(sv);
4717             }
4718         } else {
4719             if (SvIVX(sv) == IV_MIN)
4720                 sv_setnv(sv, (NV)IV_MIN - 1.0);
4721             else {
4722                 (void)SvIOK_only(sv);
4723                 --SvIVX(sv);
4724             }
4725         }
4726         return;
4727     }
4728     if (!(flags & SVp_POK)) {
4729         if ((flags & SVTYPEMASK) < SVt_PVNV)
4730             sv_upgrade(sv, SVt_NV);
4731         SvNVX(sv) = -1.0;
4732         (void)SvNOK_only(sv);
4733         return;
4734     }
4735     sv_setnv(sv,Atof(SvPVX(sv)) - 1.0); /* punt */
4736 }
4737
4738 /*
4739 =for apidoc sv_mortalcopy
4740
4741 Creates a new SV which is a copy of the original SV.  The new SV is marked
4742 as mortal.
4743
4744 =cut
4745 */
4746
4747 /* Make a string that will exist for the duration of the expression
4748  * evaluation.  Actually, it may have to last longer than that, but
4749  * hopefully we won't free it until it has been assigned to a
4750  * permanent location. */
4751
4752 SV *
4753 Perl_sv_mortalcopy(pTHX_ SV *oldstr)
4754 {
4755     register SV *sv;
4756
4757     new_SV(sv);
4758     sv_setsv(sv,oldstr);
4759     EXTEND_MORTAL(1);
4760     PL_tmps_stack[++PL_tmps_ix] = sv;
4761     SvTEMP_on(sv);
4762     return sv;
4763 }
4764
4765 /*
4766 =for apidoc sv_newmortal
4767
4768 Creates a new SV which is mortal.  The reference count of the SV is set to 1.
4769
4770 =cut
4771 */
4772
4773 SV *
4774 Perl_sv_newmortal(pTHX)
4775 {
4776     register SV *sv;
4777
4778     new_SV(sv);
4779     SvFLAGS(sv) = SVs_TEMP;
4780     EXTEND_MORTAL(1);
4781     PL_tmps_stack[++PL_tmps_ix] = sv;
4782     return sv;
4783 }
4784
4785 /*
4786 =for apidoc sv_2mortal
4787
4788 Marks an SV as mortal.  The SV will be destroyed when the current context
4789 ends.
4790
4791 =cut
4792 */
4793
4794 /* same thing without the copying */
4795
4796 SV *
4797 Perl_sv_2mortal(pTHX_ register SV *sv)
4798 {
4799     if (!sv)
4800         return sv;
4801     if (SvREADONLY(sv) && SvIMMORTAL(sv))
4802         return sv;
4803     EXTEND_MORTAL(1);
4804     PL_tmps_stack[++PL_tmps_ix] = sv;
4805     SvTEMP_on(sv);
4806     return sv;
4807 }
4808
4809 /*
4810 =for apidoc newSVpv
4811
4812 Creates a new SV and copies a string into it.  The reference count for the
4813 SV is set to 1.  If C<len> is zero, Perl will compute the length using
4814 strlen().  For efficiency, consider using C<newSVpvn> instead.
4815
4816 =cut
4817 */
4818
4819 SV *
4820 Perl_newSVpv(pTHX_ const char *s, STRLEN len)
4821 {
4822     register SV *sv;
4823
4824     new_SV(sv);
4825     if (!len)
4826         len = strlen(s);
4827     sv_setpvn(sv,s,len);
4828     return sv;
4829 }
4830
4831 /*
4832 =for apidoc newSVpvn
4833
4834 Creates a new SV and copies a string into it.  The reference count for the
4835 SV is set to 1.  Note that if C<len> is zero, Perl will create a zero length
4836 string.  You are responsible for ensuring that the source string is at least
4837 C<len> bytes long.
4838
4839 =cut
4840 */
4841
4842 SV *
4843 Perl_newSVpvn(pTHX_ const char *s, STRLEN len)
4844 {
4845     register SV *sv;
4846
4847     new_SV(sv);
4848     sv_setpvn(sv,s,len);
4849     return sv;
4850 }
4851
4852 /*
4853 =for apidoc newSVpvn_share
4854
4855 Creates a new SV and populates it with a string from
4856 the string table. Turns on READONLY and FAKE.
4857 The idea here is that as string table is used for shared hash
4858 keys these strings will have SvPVX == HeKEY and hash lookup
4859 will avoid string compare.
4860
4861 =cut
4862 */
4863
4864 SV *
4865 Perl_newSVpvn_share(pTHX_ const char *src, STRLEN len, U32 hash)
4866 {
4867     register SV *sv;
4868     if (!hash)
4869         PERL_HASH(hash, src, len);
4870     new_SV(sv);
4871     sv_upgrade(sv, SVt_PVIV);
4872     SvPVX(sv) = sharepvn(src, len, hash);
4873     SvCUR(sv) = len;
4874     SvUVX(sv) = hash;
4875     SvLEN(sv) = 0;
4876     SvREADONLY_on(sv);
4877     SvFAKE_on(sv);
4878     SvPOK_on(sv);
4879     return sv;
4880 }
4881
4882 #if defined(PERL_IMPLICIT_CONTEXT)
4883 SV *
4884 Perl_newSVpvf_nocontext(const char* pat, ...)
4885 {
4886     dTHX;
4887     register SV *sv;
4888     va_list args;
4889     va_start(args, pat);
4890     sv = vnewSVpvf(pat, &args);
4891     va_end(args);
4892     return sv;
4893 }
4894 #endif
4895
4896 /*
4897 =for apidoc newSVpvf
4898
4899 Creates a new SV an initialize it with the string formatted like
4900 C<sprintf>.
4901
4902 =cut
4903 */
4904
4905 SV *
4906 Perl_newSVpvf(pTHX_ const char* pat, ...)
4907 {
4908     register SV *sv;
4909     va_list args;
4910     va_start(args, pat);
4911     sv = vnewSVpvf(pat, &args);
4912     va_end(args);
4913     return sv;
4914 }
4915
4916 SV *
4917 Perl_vnewSVpvf(pTHX_ const char* pat, va_list* args)
4918 {
4919     register SV *sv;
4920     new_SV(sv);
4921     sv_vsetpvfn(sv, pat, strlen(pat), args, Null(SV**), 0, Null(bool*));
4922     return sv;
4923 }
4924
4925 /*
4926 =for apidoc newSVnv
4927
4928 Creates a new SV and copies a floating point value into it.
4929 The reference count for the SV is set to 1.
4930
4931 =cut
4932 */
4933
4934 SV *
4935 Perl_newSVnv(pTHX_ NV n)
4936 {
4937     register SV *sv;
4938
4939     new_SV(sv);
4940     sv_setnv(sv,n);
4941     return sv;
4942 }
4943
4944 /*
4945 =for apidoc newSViv
4946
4947 Creates a new SV and copies an integer into it.  The reference count for the
4948 SV is set to 1.
4949
4950 =cut
4951 */
4952
4953 SV *
4954 Perl_newSViv(pTHX_ IV i)
4955 {
4956     register SV *sv;
4957
4958     new_SV(sv);
4959     sv_setiv(sv,i);
4960     return sv;
4961 }
4962
4963 /*
4964 =for apidoc newSVuv
4965
4966 Creates a new SV and copies an unsigned integer into it.
4967 The reference count for the SV is set to 1.
4968
4969 =cut
4970 */
4971
4972 SV *
4973 Perl_newSVuv(pTHX_ UV u)
4974 {
4975     register SV *sv;
4976
4977     new_SV(sv);
4978     sv_setuv(sv,u);
4979     return sv;
4980 }
4981
4982 /*
4983 =for apidoc newRV_noinc
4984
4985 Creates an RV wrapper for an SV.  The reference count for the original
4986 SV is B<not> incremented.
4987
4988 =cut
4989 */
4990
4991 SV *
4992 Perl_newRV_noinc(pTHX_ SV *tmpRef)
4993 {
4994     register SV *sv;
4995
4996     new_SV(sv);
4997     sv_upgrade(sv, SVt_RV);
4998     SvTEMP_off(tmpRef);
4999     SvRV(sv) = tmpRef;
5000     SvROK_on(sv);
5001     return sv;
5002 }
5003
5004 /* newRV_inc is #defined to newRV in sv.h */
5005 SV *
5006 Perl_newRV(pTHX_ SV *tmpRef)
5007 {
5008     return newRV_noinc(SvREFCNT_inc(tmpRef));
5009 }
5010
5011 /*
5012 =for apidoc newSVsv
5013
5014 Creates a new SV which is an exact duplicate of the original SV.
5015
5016 =cut
5017 */
5018
5019 /* make an exact duplicate of old */
5020
5021 SV *
5022 Perl_newSVsv(pTHX_ register SV *old)
5023 {
5024     register SV *sv;
5025
5026     if (!old)
5027         return Nullsv;
5028     if (SvTYPE(old) == SVTYPEMASK) {
5029         if (ckWARN_d(WARN_INTERNAL))
5030             Perl_warner(aTHX_ WARN_INTERNAL, "semi-panic: attempt to dup freed string");
5031         return Nullsv;
5032     }
5033     new_SV(sv);
5034     if (SvTEMP(old)) {
5035         SvTEMP_off(old);
5036         sv_setsv(sv,old);
5037         SvTEMP_on(old);
5038     }
5039     else
5040         sv_setsv(sv,old);
5041     return sv;
5042 }
5043
5044 void
5045 Perl_sv_reset(pTHX_ register char *s, HV *stash)
5046 {
5047     register HE *entry;
5048     register GV *gv;
5049     register SV *sv;
5050     register I32 i;
5051     register PMOP *pm;
5052     register I32 max;
5053     char todo[PERL_UCHAR_MAX+1];
5054
5055     if (!stash)
5056         return;
5057
5058     if (!*s) {          /* reset ?? searches */
5059         for (pm = HvPMROOT(stash); pm; pm = pm->op_pmnext) {
5060             pm->op_pmdynflags &= ~PMdf_USED;
5061         }
5062         return;
5063     }
5064
5065     /* reset variables */
5066
5067     if (!HvARRAY(stash))
5068         return;
5069
5070     Zero(todo, 256, char);
5071     while (*s) {
5072         i = (unsigned char)*s;
5073         if (s[1] == '-') {
5074             s += 2;
5075         }
5076         max = (unsigned char)*s++;
5077         for ( ; i <= max; i++) {
5078             todo[i] = 1;
5079         }
5080         for (i = 0; i <= (I32) HvMAX(stash); i++) {
5081             for (entry = HvARRAY(stash)[i];
5082                  entry;
5083                  entry = HeNEXT(entry))
5084             {
5085                 if (!todo[(U8)*HeKEY(entry)])
5086                     continue;
5087                 gv = (GV*)HeVAL(entry);