sv.c

   1 /*    sv.c
   2  *
   3  *    Copyright (c) 1991-2001, 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     /* With these two if statements:
1324        u=1.49  s=0.52  cu=72.49  cs=10.64  scripts=270  tests=20865
1325
1326        without
1327        u=1.35  s=0.47  cu=73.45  cs=11.43  scripts=270  tests=20865
1328
1329        If you wish to remove them, please benchmark to see what the effect is
1330     */
1331     if (u <= (UV)IV_MAX) {
1332        sv_setiv(sv, (IV)u);
1333        return;
1334     }
1335     sv_setiv(sv, 0);
1336     SvIsUV_on(sv);
1337     SvUVX(sv) = u;
1338 }
1339
1340 /*
1341 =for apidoc sv_setuv_mg
1342
1343 Like C<sv_setuv>, but also handles 'set' magic.
1344
1345 =cut
1346 */
1347
1348 void
1349 Perl_sv_setuv_mg(pTHX_ register SV *sv, UV u)
1350 {
1351     /* With these two if statements:
1352        u=1.49  s=0.52  cu=72.49  cs=10.64  scripts=270  tests=20865
1353
1354        without
1355        u=1.35  s=0.47  cu=73.45  cs=11.43  scripts=270  tests=20865
1356
1357        If you wish to remove them, please benchmark to see what the effect is
1358     */
1359     if (u <= (UV)IV_MAX) {
1360        sv_setiv(sv, (IV)u);
1361     } else {
1362        sv_setiv(sv, 0);
1363        SvIsUV_on(sv);
1364        sv_setuv(sv,u);
1365     }
1366     SvSETMAGIC(sv);
1367 }
1368
1369 /*
1370 =for apidoc sv_setnv
1371
1372 Copies a double into the given SV.  Does not handle 'set' magic.  See
1373 C<sv_setnv_mg>.
1374
1375 =cut
1376 */
1377
1378 void
1379 Perl_sv_setnv(pTHX_ register SV *sv, NV num)
1380 {
1381     SV_CHECK_THINKFIRST(sv);
1382     switch (SvTYPE(sv)) {
1383     case SVt_NULL:
1384     case SVt_IV:
1385         sv_upgrade(sv, SVt_NV);
1386         break;
1387     case SVt_RV:
1388     case SVt_PV:
1389     case SVt_PVIV:
1390         sv_upgrade(sv, SVt_PVNV);
1391         break;
1392
1393     case SVt_PVGV:
1394     case SVt_PVAV:
1395     case SVt_PVHV:
1396     case SVt_PVCV:
1397     case SVt_PVFM:
1398     case SVt_PVIO:
1399         Perl_croak(aTHX_ "Can't coerce %s to number in %s", sv_reftype(sv,0),
1400                    PL_op_name[PL_op->op_type]);
1401     }
1402     SvNVX(sv) = num;
1403     (void)SvNOK_only(sv);                       /* validate number */
1404     SvTAINT(sv);
1405 }
1406
1407 /*
1408 =for apidoc sv_setnv_mg
1409
1410 Like C<sv_setnv>, but also handles 'set' magic.
1411
1412 =cut
1413 */
1414
1415 void
1416 Perl_sv_setnv_mg(pTHX_ register SV *sv, NV num)
1417 {
1418     sv_setnv(sv,num);
1419     SvSETMAGIC(sv);
1420 }
1421
1422 STATIC void
1423 S_not_a_number(pTHX_ SV *sv)
1424 {
1425     char tmpbuf[64];
1426     char *d = tmpbuf;
1427     char *s;
1428     char *limit = tmpbuf + sizeof(tmpbuf) - 8;
1429                   /* each *s can expand to 4 chars + "...\0",
1430                      i.e. need room for 8 chars */
1431
1432     for (s = SvPVX(sv); *s && d < limit; s++) {
1433         int ch = *s & 0xFF;
1434         if (ch & 128 && !isPRINT_LC(ch)) {
1435             *d++ = 'M';
1436             *d++ = '-';
1437             ch &= 127;
1438         }
1439         if (ch == '\n') {
1440             *d++ = '\\';
1441             *d++ = 'n';
1442         }
1443         else if (ch == '\r') {
1444             *d++ = '\\';
1445             *d++ = 'r';
1446         }
1447         else if (ch == '\f') {
1448             *d++ = '\\';
1449             *d++ = 'f';
1450         }
1451         else if (ch == '\\') {
1452             *d++ = '\\';
1453             *d++ = '\\';
1454         }
1455         else if (isPRINT_LC(ch))
1456             *d++ = ch;
1457         else {
1458             *d++ = '^';
1459             *d++ = toCTRL(ch);
1460         }
1461     }
1462     if (*s) {
1463         *d++ = '.';
1464         *d++ = '.';
1465         *d++ = '.';
1466     }
1467     *d = '\0';
1468
1469     if (PL_op)
1470         Perl_warner(aTHX_ WARN_NUMERIC,
1471                     "Argument \"%s\" isn't numeric in %s", tmpbuf,
1472                 PL_op_desc[PL_op->op_type]);
1473     else
1474         Perl_warner(aTHX_ WARN_NUMERIC,
1475                     "Argument \"%s\" isn't numeric", tmpbuf);
1476 }
1477
1478 /* the number can be converted to integer with atol() or atoll() although */
1479 #define IS_NUMBER_TO_INT_BY_ATOL     0x01 /* integer (may have decimals) */
1480 #define IS_NUMBER_TO_INT_BY_STRTOL   0x02 /* it may exceed IV_MAX */
1481 #define IS_NUMBER_TO_INT_BY_ATOF     0x04 /* seen something like 123e4 */
1482 #define IS_NUMBER_LONGER_THAN_IV_MAX 0x08 /* more digits than IV_MAX */
1483 #define IS_NUMBER_AS_LONG_AS_IV_MAX  0x10 /* may(be not) larger than IV_MAX */
1484 #define IS_NUMBER_NOT_INT            0x20 /* seen a decimal point or e */
1485 #define IS_NUMBER_NEG                0x40 /* seen a leading - */
1486 #define IS_NUMBER_INFINITY           0x80 /* /^\s*-?Infinity\s*$/i */
1487
1488 /* Actually, ISO C leaves conversion of UV to IV undefined, but
1489    until proven guilty, assume that things are not that bad... */
1490
1491 /* As 64 bit platforms often have an NV that doesn't preserve all bits of
1492    an IV (an assumption perl has been based on to date) it becomes necessary
1493    to remove the assumption that the NV always carries enough precision to
1494    recreate the IV whenever needed, and that the NV is the canonical form.
1495    Instead, IV/UV and NV need to be given equal rights. So as to not lose
1496    precision as an side effect of conversion (which would lead to insanity
1497    and the dragon(s) in t/op/numconvert.t getting very angry) the intent is
1498    1) to distinguish between IV/UV/NV slots that have cached a valid
1499       conversion where precision was lost and IV/UV/NV slots that have a
1500       valid conversion which has lost no precision
1501    2) to ensure that if a numeric conversion to one form is request that
1502       would lose precision, the precise conversion (or differently
1503       imprecise conversion) is also performed and cached, to prevent
1504       requests for different numeric formats on the same SV causing
1505       lossy conversion chains. (lossless conversion chains are perfectly
1506       acceptable (still))
1507
1508
1509    flags are used:
1510    SvIOKp is true if the IV slot contains a valid value
1511    SvIOK  is true only if the IV value is accurate (UV if SvIOK_UV true)
1512    SvNOKp is true if the NV slot contains a valid value
1513    SvNOK  is true only if the NV value is accurate
1514
1515    so
1516    while converting from PV to NV check to see if converting that NV to an
1517    IV(or UV) would lose accuracy over a direct conversion from PV to
1518    IV(or UV). If it would, cache both conversions, return NV, but mark
1519    SV as IOK NOKp (ie not NOK).
1520
1521    while converting from PV to IV check to see if converting that IV to an
1522    NV would lose accuracy over a direct conversion from PV to NV. If it
1523    would, cache both conversions, flag similarly.
1524
1525    Before, the SV value "3.2" could become NV=3.2 IV=3 NOK, IOK quite
1526    correctly because if IV & NV were set NV *always* overruled.
1527    Now, "3.2" will become NV=3.2 IV=3 NOK, IOKp, because the flags meaning
1528    changes - now IV and NV together means that the two are interchangeable
1529    SvIVX == (IV) SvNVX && SvNVX == (NV) SvIVX;
1530
1531    The benefit of this is operations such as pp_add know that if SvIOK is
1532    true for both left and right operands, then integer addition can be
1533    used instead of floating point. (for cases where the result won't
1534    overflow) Before, floating point was always used, which could lead to
1535    loss of precision compared with integer addition.
1536
1537    * making IV and NV equal status should make maths accurate on 64 bit
1538      platforms
1539    * may speed up maths somewhat if pp_add and friends start to use
1540      integers when possible instead of fp. (hopefully the overhead in
1541      looking for SvIOK and checking for overflow will not outweigh the
1542      fp to integer speedup)
1543    * will slow down integer operations (callers of SvIV) on "inaccurate"
1544      values, as the change from SvIOK to SvIOKp will cause a call into
1545      sv_2iv each time rather than a macro access direct to the IV slot
1546    * should speed up number->string conversion on integers as IV is
1547      favoured when IV and NV equally accurate
1548
1549    ####################################################################
1550    You had better be using SvIOK_notUV if you want an IV for arithmetic
1551    SvIOK is true if (IV or UV), so you might be getting (IV)SvUV
1552    SvUOK is true iff UV.
1553    ####################################################################
1554
1555    Your mileage will vary depending your CPUs relative fp to integer
1556    performance ratio.
1557 */
1558
1559 #ifndef NV_PRESERVES_UV
1560 #define IS_NUMBER_UNDERFLOW_IV 1
1561 #define IS_NUMBER_UNDERFLOW_UV 2
1562 #define IS_NUMBER_IV_AND_UV 2
1563 #define IS_NUMBER_OVERFLOW_IV 4
1564 #define IS_NUMBER_OVERFLOW_UV 5
1565 /* Hopefully your optimiser will consider inlining these two functions.  */
1566 STATIC int
1567 S_sv_2inuv_non_preserve (pTHX_ register SV *sv, I32 numtype) {
1568     NV nv = SvNVX(sv);          /* Code simpler and had compiler problems if */
1569     UV nv_as_uv = U_V(nv);      /*  these are not in simple variables.   */
1570     DEBUG_c(PerlIO_printf(Perl_debug_log,"sv_2inuv_non '%s', IV=0x%"UVxf" NV=%g inttype=%"UVXf"\n", SvPVX(sv), SvIVX(sv), nv, (UV)numtype));
1571     if (nv_as_uv <= (UV)IV_MAX) {
1572         (void)SvIOKp_on(sv);
1573         (void)SvNOKp_on(sv);
1574         /* Within suitable range to fit in an IV,  atol won't overflow */
1575         /* XXX quite sure? Is that your final answer? not really, I'm
1576            trusting that nv_as_uv to round down if NV is (IV_MAX + 1) */
1577         SvIVX(sv) = (IV)Atol(SvPVX(sv));
1578         if (numtype & IS_NUMBER_NOT_INT) {
1579             /* I believe that even if the original PV had decimals, they
1580                are lost beyond the limit of the FP precision.
1581                However, neither is canonical, so both only get p flags.
1582                NWC, 2000/11/25 */
1583             /* Both already have p flags, so do nothing */
1584         } else if (SvIVX(sv) == I_V(nv)) {
1585             SvNOK_on(sv);
1586             SvIOK_on(sv);
1587         } else {
1588             SvIOK_on(sv);
1589             /* It had no "." so it must be integer.  assert (get in here from
1590                sv_2iv and sv_2uv only for ndef HAS_STRTOL and
1591                IS_NUMBER_AS_LONG_AS_IV_MAX) or my logic is faulty and all
1592                conversion routines need audit.  */
1593         }
1594         return nv < 0 ? IS_NUMBER_UNDERFLOW_UV : IS_NUMBER_IV_AND_UV;
1595     }
1596     /* between IV_MAX and NV(UV_MAX). Could be slightly> UV_MAX */
1597     (void)SvIOKp_on(sv);
1598     (void)SvNOKp_on(sv);
1599 #ifdef HAS_STRTOUL
1600     {
1601         int save_errno = errno;
1602         errno = 0;
1603         SvUVX(sv) = Strtoul(SvPVX(sv), Null(char**), 10);
1604         if (errno == 0) {
1605             if (numtype & IS_NUMBER_NOT_INT) {
1606                 /* UV and NV both imprecise.  */
1607                 SvIsUV_on(sv);
1608             } else if (SvUVX(sv) == nv_as_uv && SvUVX(sv) != UV_MAX) {
1609                 SvNOK_on(sv);
1610                 SvIOK_on(sv);
1611                 SvIsUV_on(sv);
1612             } else {
1613                 SvIOK_on(sv);
1614                 SvIsUV_on(sv);
1615             }
1616             errno = save_errno;
1617             return IS_NUMBER_OVERFLOW_IV;
1618         }
1619         errno = save_errno;
1620         SvNOK_on(sv);
1621         /* Must have just overflowed UV, but not enough that an NV could spot
1622            this.. */
1623         return IS_NUMBER_OVERFLOW_UV;
1624     }
1625 #else
1626     /* We've just lost integer precision, nothing we could do. */
1627     SvUVX(sv) = nv_as_uv;
1628     DEBUG_c(PerlIO_printf(Perl_debug_log,"sv_2niuv_non UV? '%s', UV=0x%"UVxf" NV=%g U_V(NV)=0x%"UVxf" inttype=%"UVXf"\n", SvPVX(sv), SvIVX(sv), nv, nv_as_uv, (UV)numtype));
1629     /* UV and NV slots equally valid only if we have casting symmetry. */
1630     if (numtype & IS_NUMBER_NOT_INT) {
1631         SvIsUV_on(sv);
1632     } else if (SvUVX(sv) == nv_as_uv && SvUVX(sv) != UV_MAX) {
1633         /* UV_MAX can cast up to NV (UV_MAX+1), that NV casts down to UV_MAX
1634            UV_MAX ought to be 0xFF...FFF which won't preserve (We only
1635            get to this point if NVs don't preserve UVs) */
1636         SvNOK_on(sv);
1637         SvIOK_on(sv);
1638         SvIsUV_on(sv);
1639     } else {
1640         /* As above, I believe UV at least as good as NV */
1641         SvIsUV_on(sv);
1642     }
1643 #endif /* HAS_STRTOUL */
1644     return IS_NUMBER_OVERFLOW_IV;
1645 }
1646
1647 /* For sv_2nv these three cases are "SvNOK and don't bother casting"  */
1648 STATIC int
1649 S_sv_2iuv_non_preserve (pTHX_ register SV *sv, I32 numtype)
1650 {
1651     DEBUG_c(PerlIO_printf(Perl_debug_log,"sv_2iuv_non '%s', IV=0x%"UVxf" NV=%g inttype=%"UVXf"\n", SvPVX(sv), SvIVX(sv), SvNVX(sv), (UV)numtype));
1652     if (SvNVX(sv) < (NV)IV_MIN) {
1653         (void)SvIOKp_on(sv);
1654         (void)SvNOK_on(sv);
1655         SvIVX(sv) = IV_MIN;
1656         return IS_NUMBER_UNDERFLOW_IV;
1657     }
1658     if (SvNVX(sv) > (NV)UV_MAX) {
1659         (void)SvIOKp_on(sv);
1660         (void)SvNOK_on(sv);
1661         SvIsUV_on(sv);
1662         SvUVX(sv) = UV_MAX;
1663         return IS_NUMBER_OVERFLOW_UV;
1664     }
1665     if (!(numtype & (IS_NUMBER_TO_INT_BY_ATOL | IS_NUMBER_TO_INT_BY_STRTOL))) {
1666         (void)SvIOKp_on(sv);
1667         (void)SvNOK_on(sv);
1668         /* Can't use strtol etc to convert this string */
1669         if (SvNVX(sv) <= (UV)IV_MAX) {
1670             SvIVX(sv) = I_V(SvNVX(sv));
1671             if ((NV)(SvIVX(sv)) == SvNVX(sv)) {
1672                 SvIOK_on(sv); /* Integer is precise. NOK, IOK */
1673             } else {
1674                 /* Integer is imprecise. NOK, IOKp */
1675             }
1676             return SvNVX(sv) < 0 ? IS_NUMBER_UNDERFLOW_UV : IS_NUMBER_IV_AND_UV;
1677         }
1678         SvIsUV_on(sv);
1679         SvUVX(sv) = U_V(SvNVX(sv));
1680         if ((NV)(SvUVX(sv)) == SvNVX(sv)) {
1681             if (SvUVX(sv) == UV_MAX) {
1682                 /* As we know that NVs don't preserve UVs, UV_MAX cannot
1683                    possibly be preserved by NV. Hence, it must be overflow.
1684                    NOK, IOKp */
1685                 return IS_NUMBER_OVERFLOW_UV;
1686             }
1687             SvIOK_on(sv); /* Integer is precise. NOK, UOK */
1688         } else {
1689             /* Integer is imprecise. NOK, IOKp */
1690         }
1691         return IS_NUMBER_OVERFLOW_IV;
1692     }
1693     return S_sv_2inuv_non_preserve(aTHX_ sv, numtype);
1694 }
1695 #endif /* NV_PRESERVES_UV*/
1696
1697 IV
1698 Perl_sv_2iv(pTHX_ register SV *sv)
1699 {
1700     if (!sv)
1701         return 0;
1702     if (SvGMAGICAL(sv)) {
1703         mg_get(sv);
1704         if (SvIOKp(sv))
1705             return SvIVX(sv);
1706         if (SvNOKp(sv)) {
1707             return I_V(SvNVX(sv));
1708         }
1709         if (SvPOKp(sv) && SvLEN(sv))
1710             return asIV(sv);
1711         if (!SvROK(sv)) {
1712             if (!(SvFLAGS(sv) & SVs_PADTMP)) {
1713                 if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
1714                     report_uninit();
1715             }
1716             return 0;
1717         }
1718     }
1719     if (SvTHINKFIRST(sv)) {
1720         if (SvROK(sv)) {
1721           SV* tmpstr;
1722           if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv,numer)) &&
1723                   (SvRV(tmpstr) != SvRV(sv)))
1724               return SvIV(tmpstr);
1725           return PTR2IV(SvRV(sv));
1726         }
1727         if (SvREADONLY(sv) && SvFAKE(sv)) {
1728             sv_force_normal(sv);
1729         }
1730         if (SvREADONLY(sv) && !SvOK(sv)) {
1731             if (ckWARN(WARN_UNINITIALIZED))
1732                 report_uninit();
1733             return 0;
1734         }
1735     }
1736     if (SvIOKp(sv)) {
1737         if (SvIsUV(sv)) {
1738             return (IV)(SvUVX(sv));
1739         }
1740         else {
1741             return SvIVX(sv);
1742         }
1743     }
1744     if (SvNOKp(sv)) {
1745         /* erm. not sure. *should* never get NOKp (without NOK) from sv_2nv
1746          * without also getting a cached IV/UV from it at the same time
1747          * (ie PV->NV conversion should detect loss of accuracy and cache
1748          * IV or UV at same time to avoid this.  NWC */
1749
1750         if (SvTYPE(sv) == SVt_NV)
1751             sv_upgrade(sv, SVt_PVNV);
1752
1753         (void)SvIOKp_on(sv);    /* Must do this first, to clear any SvOOK */
1754         /* < not <= as for NV doesn't preserve UV, ((NV)IV_MAX+1) will almost
1755            certainly cast into the IV range at IV_MAX, whereas the correct
1756            answer is the UV IV_MAX +1. Hence < ensures that dodgy boundary
1757            cases go to UV */
1758         if (SvNVX(sv) < (NV)IV_MAX + 0.5) {
1759             SvIVX(sv) = I_V(SvNVX(sv));
1760             if (SvNVX(sv) == (NV) SvIVX(sv)
1761 #ifndef NV_PRESERVES_UV
1762                 && (((UV)1 << NV_PRESERVES_UV_BITS) >
1763                     (UV)(SvIVX(sv) > 0 ? SvIVX(sv) : -SvIVX(sv)))
1764                 /* Don't flag it as "accurately an integer" if the number
1765                    came from a (by definition imprecise) NV operation, and
1766                    we're outside the range of NV integer precision */
1767 #endif
1768                 ) {
1769                 SvIOK_on(sv);  /* Can this go wrong with rounding? NWC */
1770                 DEBUG_c(PerlIO_printf(Perl_debug_log,
1771                                       "0x%"UVxf" iv(%g => %"IVdf") (precise)\n",
1772                                       PTR2UV(sv),
1773                                       SvNVX(sv),
1774                                       SvIVX(sv)));
1775
1776             } else {
1777                 /* IV not precise.  No need to convert from PV, as NV
1778                    conversion would already have cached IV if it detected
1779                    that PV->IV would be better than PV->NV->IV
1780                    flags already correct - don't set public IOK.  */
1781                 DEBUG_c(PerlIO_printf(Perl_debug_log,
1782                                       "0x%"UVxf" iv(%g => %"IVdf") (imprecise)\n",
1783                                       PTR2UV(sv),
1784                                       SvNVX(sv),
1785                                       SvIVX(sv)));
1786             }
1787             /* Can the above go wrong if SvIVX == IV_MIN and SvNVX < IV_MIN,
1788                but the cast (NV)IV_MIN rounds to a the value less (more
1789                negative) than IV_MIN which happens to be equal to SvNVX ??
1790                Analogous to 0xFFFFFFFFFFFFFFFF rounding up to NV (2**64) and
1791                NV rounding back to 0xFFFFFFFFFFFFFFFF, so UVX == UV(NVX) and
1792                (NV)UVX == NVX are both true, but the values differ. :-(
1793                Hopefully for 2s complement IV_MIN is something like
1794                0x8000000000000000 which will be exact. NWC */
1795         }
1796         else {
1797             SvUVX(sv) = U_V(SvNVX(sv));
1798             if (
1799                 (SvNVX(sv) == (NV) SvUVX(sv))
1800 #ifndef  NV_PRESERVES_UV
1801                 /* Make sure it's not 0xFFFFFFFFFFFFFFFF */
1802                 /*&& (SvUVX(sv) != UV_MAX) irrelevant with code below */
1803                 && (((UV)1 << NV_PRESERVES_UV_BITS) > SvUVX(sv))
1804                 /* Don't flag it as "accurately an integer" if the number
1805                    came from a (by definition imprecise) NV operation, and
1806                    we're outside the range of NV integer precision */
1807 #endif
1808                 )
1809                 SvIOK_on(sv);
1810             SvIsUV_on(sv);
1811           ret_iv_max:
1812             DEBUG_c(PerlIO_printf(Perl_debug_log,
1813                                   "0x%"UVxf" 2iv(%"UVuf" => %"IVdf") (as unsigned)\n",
1814                                   PTR2UV(sv),
1815                                   SvUVX(sv),
1816                                   SvUVX(sv)));
1817             return (IV)SvUVX(sv);
1818         }
1819     }
1820     else if (SvPOKp(sv) && SvLEN(sv)) {
1821         I32 numtype = looks_like_number(sv);
1822
1823         /* We want to avoid a possible problem when we cache an IV which
1824            may be later translated to an NV, and the resulting NV is not
1825            the translation of the initial data.
1826
1827            This means that if we cache such an IV, we need to cache the
1828            NV as well.  Moreover, we trade speed for space, and do not
1829            cache the NV if we are sure it's not needed.
1830          */
1831
1832         if ((numtype & ~IS_NUMBER_NEG) == IS_NUMBER_TO_INT_BY_ATOL) {
1833             /* The NV may be reconstructed from IV - safe to cache IV,
1834                 which may be calculated by atol(). */
1835             if (SvTYPE(sv) < SVt_PVIV)
1836                 sv_upgrade(sv, SVt_PVIV);
1837             (void)SvIOK_on(sv);
1838             SvIVX(sv) = Atol(SvPVX(sv));
1839         } else {
1840 #ifdef HAS_STRTOL
1841             IV i;
1842             int save_errno = errno;
1843             /* Is it an integer that we could convert with strtol?
1844                So try it, and if it doesn't set errno then it's pukka.
1845                This should be faster than going atof and then thinking.  */
1846             if (((numtype & (IS_NUMBER_TO_INT_BY_STRTOL | IS_NUMBER_NOT_INT))
1847                   == IS_NUMBER_TO_INT_BY_STRTOL)
1848                 /* && is a sequence point. Without it not sure if I'm trying
1849                    to do too much between sequence points and hence going
1850                    undefined */
1851                 && ((errno = 0), 1) /* , 1 so always true */
1852                 && ((i = Strtol(SvPVX(sv), Null(char**), 10)), 1)
1853                 && (errno == 0)) {
1854                 if (SvTYPE(sv) < SVt_PVIV)
1855                     sv_upgrade(sv, SVt_PVIV);
1856                 (void)SvIOK_on(sv);
1857                 SvIVX(sv) = i;
1858                 errno = save_errno;
1859             } else
1860 #endif
1861             {
1862                 NV d;
1863 #ifdef HAS_STRTOL
1864                 /* Hopefully trace flow will optimise this away where possible
1865                  */
1866                 errno = save_errno;
1867 #endif
1868                 /* It wasn't an integer, or it overflowed, or we don't have
1869                    strtol. Do things the slow way - check if it's a UV etc. */
1870                 d = Atof(SvPVX(sv));
1871
1872                 if (SvTYPE(sv) < SVt_PVNV)
1873                     sv_upgrade(sv, SVt_PVNV);
1874                 SvNVX(sv) = d;
1875
1876                 if (! numtype && ckWARN(WARN_NUMERIC))
1877                     not_a_number(sv);
1878
1879 #if defined(USE_LONG_DOUBLE)
1880                 DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2iv(%" PERL_PRIgldbl ")\n",
1881                                       PTR2UV(sv), SvNVX(sv)));
1882 #else
1883                 DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2iv(%g)\n",
1884                                       PTR2UV(sv), SvNVX(sv)));
1885 #endif
1886
1887
1888 #ifdef NV_PRESERVES_UV
1889                 (void)SvIOKp_on(sv);
1890                 (void)SvNOK_on(sv);
1891                 if (SvNVX(sv) < (NV)IV_MAX + 0.5) {
1892                     SvIVX(sv) = I_V(SvNVX(sv));
1893                     if ((NV)(SvIVX(sv)) == SvNVX(sv)) {
1894                         SvIOK_on(sv);
1895                     } else {
1896                         /* Integer is imprecise. NOK, IOKp */
1897                     }
1898                     /* UV will not work better than IV */
1899                 } else {
1900                     if (SvNVX(sv) > (NV)UV_MAX) {
1901                         SvIsUV_on(sv);
1902                         /* Integer is inaccurate. NOK, IOKp, is UV */
1903                         SvUVX(sv) = UV_MAX;
1904                         SvIsUV_on(sv);
1905                     } else {
1906                         SvUVX(sv) = U_V(SvNVX(sv));
1907                         /* 0xFFFFFFFFFFFFFFFF not an issue in here */
1908                         if ((NV)(SvUVX(sv)) == SvNVX(sv)) {
1909                             SvIOK_on(sv);
1910                             SvIsUV_on(sv);
1911                         } else {
1912                             /* Integer is imprecise. NOK, IOKp, is UV */
1913                             SvIsUV_on(sv);
1914                         }
1915                     }
1916                     goto ret_iv_max;
1917                 }
1918 #else /* NV_PRESERVES_UV */
1919                 if (((UV)1 << NV_PRESERVES_UV_BITS) >
1920                     U_V(SvNVX(sv) > 0 ? SvNVX(sv) : -SvNVX(sv))) {
1921                     /* Small enough to preserve all bits. */
1922                     (void)SvIOKp_on(sv);
1923                     SvNOK_on(sv);
1924                     SvIVX(sv) = I_V(SvNVX(sv));
1925                     if ((NV)(SvIVX(sv)) == SvNVX(sv))
1926                         SvIOK_on(sv);
1927                     /* Assumption: first non-preserved integer is < IV_MAX,
1928                        this NV is in the preserved range, therefore: */
1929                     if (!(U_V(SvNVX(sv) > 0 ? SvNVX(sv) : -SvNVX(sv))
1930                           < (UV)IV_MAX)) {
1931                         Perl_croak(aTHX_ "sv_2iv assumed (U_V(fabs(SvNVX(sv))) < (UV)IV_MAX) but SvNVX(sv)=%g U_V is 0x%"UVxf", IV_MAX is 0x%"UVxf"\n", SvNVX(sv), U_V(SvNVX(sv)), (UV)IV_MAX);
1932                     }
1933                 } else if (sv_2iuv_non_preserve (sv, numtype)
1934                            >= IS_NUMBER_OVERFLOW_IV)
1935                     goto ret_iv_max;
1936 #endif /* NV_PRESERVES_UV */
1937             }
1938         }
1939     } else  {
1940         if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing && !(SvFLAGS(sv) & SVs_PADTMP))
1941             report_uninit();
1942         if (SvTYPE(sv) < SVt_IV)
1943             /* Typically the caller expects that sv_any is not NULL now.  */
1944             sv_upgrade(sv, SVt_IV);
1945         return 0;
1946     }
1947     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2iv(%"IVdf")\n",
1948         PTR2UV(sv),SvIVX(sv)));
1949     return SvIsUV(sv) ? (IV)SvUVX(sv) : SvIVX(sv);
1950 }
1951
1952 UV
1953 Perl_sv_2uv(pTHX_ register SV *sv)
1954 {
1955     if (!sv)
1956         return 0;
1957     if (SvGMAGICAL(sv)) {
1958         mg_get(sv);
1959         if (SvIOKp(sv))
1960             return SvUVX(sv);
1961         if (SvNOKp(sv))
1962             return U_V(SvNVX(sv));
1963         if (SvPOKp(sv) && SvLEN(sv))
1964             return asUV(sv);
1965         if (!SvROK(sv)) {
1966             if (!(SvFLAGS(sv) & SVs_PADTMP)) {
1967                 if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
1968                     report_uninit();
1969             }
1970             return 0;
1971         }
1972     }
1973     if (SvTHINKFIRST(sv)) {
1974         if (SvROK(sv)) {
1975           SV* tmpstr;
1976           if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv,numer)) &&
1977                   (SvRV(tmpstr) != SvRV(sv)))
1978               return SvUV(tmpstr);
1979           return PTR2UV(SvRV(sv));
1980         }
1981         if (SvREADONLY(sv) && SvFAKE(sv)) {
1982             sv_force_normal(sv);
1983         }
1984         if (SvREADONLY(sv) && !SvOK(sv)) {
1985             if (ckWARN(WARN_UNINITIALIZED))
1986                 report_uninit();
1987             return 0;
1988         }
1989     }
1990     if (SvIOKp(sv)) {
1991         if (SvIsUV(sv)) {
1992             return SvUVX(sv);
1993         }
1994         else {
1995             return (UV)SvIVX(sv);
1996         }
1997     }
1998     if (SvNOKp(sv)) {
1999         /* erm. not sure. *should* never get NOKp (without NOK) from sv_2nv
2000          * without also getting a cached IV/UV from it at the same time
2001          * (ie PV->NV conversion should detect loss of accuracy and cache
2002          * IV or UV at same time to avoid this. */
2003         /* IV-over-UV optimisation - choose to cache IV if possible */
2004
2005         if (SvTYPE(sv) == SVt_NV)
2006             sv_upgrade(sv, SVt_PVNV);
2007
2008         (void)SvIOKp_on(sv);    /* Must do this first, to clear any SvOOK */
2009         if (SvNVX(sv) < (NV)IV_MAX + 0.5) {
2010             SvIVX(sv) = I_V(SvNVX(sv));
2011             if (SvNVX(sv) == (NV) SvIVX(sv)
2012 #ifndef NV_PRESERVES_UV
2013                 && (((UV)1 << NV_PRESERVES_UV_BITS) >
2014                     (UV)(SvIVX(sv) > 0 ? SvIVX(sv) : -SvIVX(sv)))
2015                 /* Don't flag it as "accurately an integer" if the number
2016                    came from a (by definition imprecise) NV operation, and
2017                    we're outside the range of NV integer precision */
2018 #endif
2019                 ) {
2020                 SvIOK_on(sv);  /* Can this go wrong with rounding? NWC */
2021                 DEBUG_c(PerlIO_printf(Perl_debug_log,
2022                                       "0x%"UVxf" uv(%g => %"IVdf") (precise)\n",
2023                                       PTR2UV(sv),
2024                                       SvNVX(sv),
2025                                       SvIVX(sv)));
2026
2027             } else {
2028                 /* IV not precise.  No need to convert from PV, as NV
2029                    conversion would already have cached IV if it detected
2030                    that PV->IV would be better than PV->NV->IV
2031                    flags already correct - don't set public IOK.  */
2032                 DEBUG_c(PerlIO_printf(Perl_debug_log,
2033                                       "0x%"UVxf" uv(%g => %"IVdf") (imprecise)\n",
2034                                       PTR2UV(sv),
2035                                       SvNVX(sv),
2036                                       SvIVX(sv)));
2037             }
2038             /* Can the above go wrong if SvIVX == IV_MIN and SvNVX < IV_MIN,
2039                but the cast (NV)IV_MIN rounds to a the value less (more
2040                negative) than IV_MIN which happens to be equal to SvNVX ??
2041                Analogous to 0xFFFFFFFFFFFFFFFF rounding up to NV (2**64) and
2042                NV rounding back to 0xFFFFFFFFFFFFFFFF, so UVX == UV(NVX) and
2043                (NV)UVX == NVX are both true, but the values differ. :-(
2044                Hopefully for 2s complement IV_MIN is something like
2045                0x8000000000000000 which will be exact. NWC */
2046         }
2047         else {
2048             SvUVX(sv) = U_V(SvNVX(sv));
2049             if (
2050                 (SvNVX(sv) == (NV) SvUVX(sv))
2051 #ifndef  NV_PRESERVES_UV
2052                 /* Make sure it's not 0xFFFFFFFFFFFFFFFF */
2053                 /*&& (SvUVX(sv) != UV_MAX) irrelevant with code below */
2054                 && (((UV)1 << NV_PRESERVES_UV_BITS) > SvUVX(sv))
2055                 /* Don't flag it as "accurately an integer" if the number
2056                    came from a (by definition imprecise) NV operation, and
2057                    we're outside the range of NV integer precision */
2058 #endif
2059                 )
2060                 SvIOK_on(sv);
2061             SvIsUV_on(sv);
2062             DEBUG_c(PerlIO_printf(Perl_debug_log,
2063                                   "0x%"UVxf" 2uv(%"UVuf" => %"IVdf") (as unsigned)\n",
2064                                   PTR2UV(sv),
2065                                   SvUVX(sv),
2066                                   SvUVX(sv)));
2067         }
2068     }
2069     else if (SvPOKp(sv) && SvLEN(sv)) {
2070         I32 numtype = looks_like_number(sv);
2071
2072         /* We want to avoid a possible problem when we cache a UV which
2073            may be later translated to an NV, and the resulting NV is not
2074            the translation of the initial data.
2075
2076            This means that if we cache such a UV, we need to cache the
2077            NV as well.  Moreover, we trade speed for space, and do not
2078            cache the NV if not needed.
2079          */
2080
2081         if ((numtype & ~IS_NUMBER_NEG) == IS_NUMBER_TO_INT_BY_ATOL) {
2082             /* The NV may be reconstructed from IV - safe to cache IV,
2083                 which may be calculated by atol(). */
2084             if (SvTYPE(sv) < SVt_PVIV)
2085                 sv_upgrade(sv, SVt_PVIV);
2086             (void)SvIOK_on(sv);
2087             SvIVX(sv) = Atol(SvPVX(sv));
2088         } else {
2089 #ifdef HAS_STRTOUL
2090             UV u;
2091             char *num_begin = SvPVX(sv);
2092             int save_errno = errno;
2093
2094             /* seems that strtoul taking numbers that start with - is
2095                implementation dependant, and can't be relied upon.  */
2096             if (numtype & IS_NUMBER_NEG) {
2097                 /* Not totally defensive. assumine that looks_like_num
2098                    didn't lie about a - sign */
2099                 while (isSPACE(*num_begin))
2100                     num_begin++;
2101                 if (*num_begin == '-')
2102                     num_begin++;
2103             }
2104
2105             /* Is it an integer that we could convert with strtoul?
2106                So try it, and if it doesn't set errno then it's pukka.
2107                This should be faster than going atof and then thinking.  */
2108             if (((numtype & (IS_NUMBER_TO_INT_BY_STRTOL | IS_NUMBER_NOT_INT))
2109                  == IS_NUMBER_TO_INT_BY_STRTOL)
2110                 && ((errno = 0), 1) /* always true */
2111                 && ((u = Strtoul(num_begin, Null(char**), 10)), 1) /* ditto */
2112                 && (errno == 0)
2113                 /* If known to be negative, check it didn't undeflow IV
2114                    XXX possibly we should put more negative values as NVs
2115                    direct rather than go via atof below */
2116                 && ((numtype & IS_NUMBER_NEG) ? (u <= (UV)IV_MIN) : 1)) {
2117                 errno = save_errno;
2118
2119                 if (SvTYPE(sv) < SVt_PVIV)
2120                     sv_upgrade(sv, SVt_PVIV);
2121                 (void)SvIOK_on(sv);
2122
2123                 /* If it's negative must use IV.
2124                    IV-over-UV optimisation */
2125                 if (numtype & IS_NUMBER_NEG) {
2126                     SvIVX(sv) = -(IV)u;
2127                 } else if (u <= (UV) IV_MAX) {
2128                     SvIVX(sv) = (IV)u;
2129                 } else {
2130                     /* it didn't overflow, and it was positive. */
2131                     SvUVX(sv) = u;
2132                     SvIsUV_on(sv);
2133                 }
2134             } else
2135 #endif
2136             {
2137                 NV d;
2138 #ifdef HAS_STRTOUL
2139                 /* Hopefully trace flow will optimise this away where possible
2140                  */
2141                 errno = save_errno;
2142 #endif
2143                 /* It wasn't an integer, or it overflowed, or we don't have
2144                    strtol. Do things the slow way - check if it's a IV etc. */
2145                 d = Atof(SvPVX(sv));
2146
2147                 if (SvTYPE(sv) < SVt_PVNV)
2148                     sv_upgrade(sv, SVt_PVNV);
2149                 SvNVX(sv) = d;
2150
2151                 if (! numtype && ckWARN(WARN_NUMERIC))
2152                     not_a_number(sv);
2153
2154 #if defined(USE_LONG_DOUBLE)
2155                 DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2uv(%" PERL_PRIgldbl ")\n",
2156                                       PTR2UV(sv), SvNVX(sv)));
2157 #else
2158                 DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2uv(%g)\n",
2159                                       PTR2UV(sv), SvNVX(sv)));
2160 #endif
2161
2162 #ifdef NV_PRESERVES_UV
2163                 (void)SvIOKp_on(sv);
2164                 (void)SvNOK_on(sv);
2165                 if (SvNVX(sv) < (NV)IV_MAX + 0.5) {
2166                     SvIVX(sv) = I_V(SvNVX(sv));
2167                     if ((NV)(SvIVX(sv)) == SvNVX(sv)) {
2168                         SvIOK_on(sv);
2169                     } else {
2170                         /* Integer is imprecise. NOK, IOKp */
2171                     }
2172                     /* UV will not work better than IV */
2173                 } else {
2174                     if (SvNVX(sv) > (NV)UV_MAX) {
2175                         SvIsUV_on(sv);
2176                         /* Integer is inaccurate. NOK, IOKp, is UV */
2177                         SvUVX(sv) = UV_MAX;
2178                         SvIsUV_on(sv);
2179                     } else {
2180                         SvUVX(sv) = U_V(SvNVX(sv));
2181                         /* 0xFFFFFFFFFFFFFFFF not an issue in here, NVs
2182                            NV preservse UV so can do correct comparison.  */
2183                         if ((NV)(SvUVX(sv)) == SvNVX(sv)) {
2184                             SvIOK_on(sv);
2185                             SvIsUV_on(sv);
2186                         } else {
2187                             /* Integer is imprecise. NOK, IOKp, is UV */
2188                             SvIsUV_on(sv);
2189                         }
2190                     }
2191                 }
2192 #else /* NV_PRESERVES_UV */
2193                 if (((UV)1 << NV_PRESERVES_UV_BITS) >
2194                     U_V(SvNVX(sv) > 0 ? SvNVX(sv) : -SvNVX(sv))) {
2195                     /* Small enough to preserve all bits. */
2196                     (void)SvIOKp_on(sv);
2197                     SvNOK_on(sv);
2198                     SvIVX(sv) = I_V(SvNVX(sv));
2199                     if ((NV)(SvIVX(sv)) == SvNVX(sv))
2200                         SvIOK_on(sv);
2201                     /* Assumption: first non-preserved integer is < IV_MAX,
2202                        this NV is in the preserved range, therefore: */
2203                     if (!(U_V(SvNVX(sv) > 0 ? SvNVX(sv) : -SvNVX(sv))
2204                           < (UV)IV_MAX)) {
2205                         Perl_croak(aTHX_ "sv_2uv assumed (U_V(fabs(SvNVX(sv))) < (UV)IV_MAX) but SvNVX(sv)=%g U_V is 0x%"UVxf", IV_MAX is 0x%"UVxf"\n", SvNVX(sv), U_V(SvNVX(sv)), (UV)IV_MAX);
2206                     }
2207                 } else
2208                     sv_2iuv_non_preserve (sv, numtype);
2209 #endif /* NV_PRESERVES_UV */
2210             }
2211         }
2212     }
2213     else  {
2214         if (!(SvFLAGS(sv) & SVs_PADTMP)) {
2215             if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
2216                 report_uninit();
2217         }
2218         if (SvTYPE(sv) < SVt_IV)
2219             /* Typically the caller expects that sv_any is not NULL now.  */
2220             sv_upgrade(sv, SVt_IV);
2221         return 0;
2222     }
2223
2224     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2uv(%"UVuf")\n",
2225                           PTR2UV(sv),SvUVX(sv)));
2226     return SvIsUV(sv) ? SvUVX(sv) : (UV)SvIVX(sv);
2227 }
2228
2229 NV
2230 Perl_sv_2nv(pTHX_ register SV *sv)
2231 {
2232     if (!sv)
2233         return 0.0;
2234     if (SvGMAGICAL(sv)) {
2235         mg_get(sv);
2236         if (SvNOKp(sv))
2237             return SvNVX(sv);
2238         if (SvPOKp(sv) && SvLEN(sv)) {
2239             if (ckWARN(WARN_NUMERIC) && !SvIOKp(sv) && !looks_like_number(sv))
2240                 not_a_number(sv);
2241             return Atof(SvPVX(sv));
2242         }
2243         if (SvIOKp(sv)) {
2244             if (SvIsUV(sv))
2245                 return (NV)SvUVX(sv);
2246             else
2247                 return (NV)SvIVX(sv);
2248         }
2249         if (!SvROK(sv)) {
2250             if (!(SvFLAGS(sv) & SVs_PADTMP)) {
2251                 if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
2252                     report_uninit();
2253             }
2254             return 0;
2255         }
2256     }
2257     if (SvTHINKFIRST(sv)) {
2258         if (SvROK(sv)) {
2259           SV* tmpstr;
2260           if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv,numer)) &&
2261                   (SvRV(tmpstr) != SvRV(sv)))
2262               return SvNV(tmpstr);
2263           return PTR2NV(SvRV(sv));
2264         }
2265         if (SvREADONLY(sv) && SvFAKE(sv)) {
2266             sv_force_normal(sv);
2267         }
2268         if (SvREADONLY(sv) && !SvOK(sv)) {
2269             if (ckWARN(WARN_UNINITIALIZED))
2270                 report_uninit();
2271             return 0.0;
2272         }
2273     }
2274     if (SvTYPE(sv) < SVt_NV) {
2275         if (SvTYPE(sv) == SVt_IV)
2276             sv_upgrade(sv, SVt_PVNV);
2277         else
2278             sv_upgrade(sv, SVt_NV);
2279 #if defined(USE_LONG_DOUBLE)
2280         DEBUG_c({
2281             STORE_NUMERIC_LOCAL_SET_STANDARD();
2282             PerlIO_printf(Perl_debug_log,
2283                           "0x%"UVxf" num(%" PERL_PRIgldbl ")\n",
2284                           PTR2UV(sv), SvNVX(sv));
2285             RESTORE_NUMERIC_LOCAL();
2286         });
2287 #else
2288         DEBUG_c({
2289             STORE_NUMERIC_LOCAL_SET_STANDARD();
2290             PerlIO_printf(Perl_debug_log, "0x%"UVxf" num(%g)\n",
2291                           PTR2UV(sv), SvNVX(sv));
2292             RESTORE_NUMERIC_LOCAL();
2293         });
2294 #endif
2295     }
2296     else if (SvTYPE(sv) < SVt_PVNV)
2297         sv_upgrade(sv, SVt_PVNV);
2298     if (SvIOKp(sv) &&
2299             (!SvPOKp(sv) || !strchr(SvPVX(sv),'.') || !looks_like_number(sv)))
2300     {
2301         SvNVX(sv) = SvIsUV(sv) ? (NV)SvUVX(sv) : (NV)SvIVX(sv);
2302 #ifdef NV_PRESERVES_UV
2303         SvNOK_on(sv);
2304 #else
2305         /* Only set the public NV OK flag if this NV preserves the IV  */
2306         /* Check it's not 0xFFFFFFFFFFFFFFFF */
2307         if (SvIsUV(sv) ? ((SvUVX(sv) != UV_MAX)&&(SvUVX(sv) == U_V(SvNVX(sv))))
2308                        : (SvIVX(sv) == I_V(SvNVX(sv))))
2309             SvNOK_on(sv);
2310         else
2311             SvNOKp_on(sv);
2312 #endif
2313     }
2314     else if (SvPOKp(sv) && SvLEN(sv)) {
2315         if (ckWARN(WARN_NUMERIC) && !SvIOKp(sv) && !looks_like_number(sv))
2316             not_a_number(sv);
2317         SvNVX(sv) = Atof(SvPVX(sv));
2318 #ifdef NV_PRESERVES_UV
2319         SvNOK_on(sv);
2320 #else
2321         /* Only set the public NV OK flag if this NV preserves the value in
2322            the PV at least as well as an IV/UV would.
2323            Not sure how to do this 100% reliably. */
2324         /* if that shift count is out of range then Configure's test is
2325            wonky. We shouldn't be in here with NV_PRESERVES_UV_BITS ==
2326            UV_BITS */
2327         if (((UV)1 << NV_PRESERVES_UV_BITS) >
2328             U_V(SvNVX(sv) > 0 ? SvNVX(sv) : -SvNVX(sv)))
2329             SvNOK_on(sv); /* Definitely small enough to preserve all bits */
2330         else if (SvNVX(sv) < (NV)IV_MIN || SvNVX(sv) > (NV)UV_MAX) {
2331                 /* Definitely too large/small to fit in an integer, so no loss
2332                    of precision going to integer in the future via NV */
2333             SvNOK_on(sv);
2334         } else {
2335             /* Is it something we can run through strtol etc (ie no
2336                trailing exponent part)? */
2337             int numtype = looks_like_number(sv);
2338             /* XXX probably should cache this if called above */
2339
2340             if (!(numtype &
2341                   (IS_NUMBER_TO_INT_BY_ATOL | IS_NUMBER_TO_INT_BY_STRTOL))) {
2342                 /* Can't use strtol etc to convert this string, so don't try */
2343                 SvNOK_on(sv);
2344             } else
2345                 sv_2inuv_non_preserve (sv, numtype);
2346         }
2347 #endif /* NV_PRESERVES_UV */
2348     }
2349     else  {
2350         if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing && !(SvFLAGS(sv) & SVs_PADTMP))
2351             report_uninit();
2352         if (SvTYPE(sv) < SVt_NV)
2353             /* Typically the caller expects that sv_any is not NULL now.  */
2354             /* XXX Ilya implies that this is a bug in callers that assume this
2355                and ideally should be fixed.  */
2356             sv_upgrade(sv, SVt_NV);
2357         return 0.0;
2358     }
2359 #if defined(USE_LONG_DOUBLE)
2360     DEBUG_c({
2361         STORE_NUMERIC_LOCAL_SET_STANDARD();
2362         PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2nv(%" PERL_PRIgldbl ")\n",
2363                       PTR2UV(sv), SvNVX(sv));
2364         RESTORE_NUMERIC_LOCAL();
2365     });
2366 #else
2367     DEBUG_c({
2368         STORE_NUMERIC_LOCAL_SET_STANDARD();
2369         PerlIO_printf(Perl_debug_log, "0x%"UVxf" 1nv(%g)\n",
2370                       PTR2UV(sv), SvNVX(sv));
2371         RESTORE_NUMERIC_LOCAL();
2372     });
2373 #endif
2374     return SvNVX(sv);
2375 }
2376
2377 STATIC IV
2378 S_asIV(pTHX_ SV *sv)
2379 {
2380     I32 numtype = looks_like_number(sv);
2381     NV d;
2382
2383     if (numtype & IS_NUMBER_TO_INT_BY_ATOL)
2384         return Atol(SvPVX(sv));
2385     if (!numtype) {
2386         if (ckWARN(WARN_NUMERIC))
2387             not_a_number(sv);
2388     }
2389     d = Atof(SvPVX(sv));
2390     return I_V(d);
2391 }
2392
2393 STATIC UV
2394 S_asUV(pTHX_ SV *sv)
2395 {
2396     I32 numtype = looks_like_number(sv);
2397
2398 #ifdef HAS_STRTOUL
2399     if (numtype & IS_NUMBER_TO_INT_BY_ATOL)
2400         return Strtoul(SvPVX(sv), Null(char**), 10);
2401 #endif
2402     if (!numtype) {
2403         if (ckWARN(WARN_NUMERIC))
2404             not_a_number(sv);
2405     }
2406     return U_V(Atof(SvPVX(sv)));
2407 }
2408
2409 /*
2410  * Returns a combination of (advisory only - can get false negatives)
2411  * IS_NUMBER_TO_INT_BY_ATOL, IS_NUMBER_TO_INT_BY_ATOF
2412  * IS_NUMBER_LONGER_THAN_IV_MAX, IS_NUMBER_AS_LONG_AS_IV_MAX
2413  * IS_NUMBER_NOT_INT, IS_NUMBER_NEG, IS_NUMBER_INFINITY
2414  * 0 if does not look like number.
2415  *
2416  * (atol and strtol stop when they hit a decimal point. strtol will return
2417  * LONG_MAX and LONG_MIN when given out of range values. ANSI says they should
2418  * do this, and vendors have had 11 years to get it right.
2419  * However, will try to make it still work with only atol
2420  *
2421  * IS_NUMBER_TO_INT_BY_ATOL     123456789 or 123456789.3  definitely < IV_MAX
2422  * IS_NUMBER_TO_INT_BY_STRTOL   123456789 or 123456789.3  if digits = IV_MAX
2423  * IS_NUMBER_TO_INT_BY_ATOF     123456789e0               or >> IV_MAX
2424  * IS_NUMBER_LONGER_THAN_IV_MAX   lots of digits, don't bother with atol
2425  * IS_NUMBER_AS_LONG_AS_IV_MAX    atol might hit LONG_MAX, might not.
2426  * IS_NUMBER_NOT_INT            saw "." or "e"
2427  * IS_NUMBER_NEG
2428  * IS_NUMBER_INFINITY
2429  */
2430
2431 /*
2432 =for apidoc looks_like_number
2433
2434 Test if an the content of an SV looks like a number (or is a
2435 number). C<Inf> and C<Infinity> are treated as numbers (so will not
2436 issue a non-numeric warning), even if your atof() doesn't grok them.
2437
2438 =cut
2439 */
2440
2441 I32
2442 Perl_looks_like_number(pTHX_ SV *sv)
2443 {
2444     register char *s;
2445     register char *send;
2446     register char *sbegin;
2447     register char *nbegin;
2448     I32 numtype = 0;
2449     I32 sawinf  = 0;
2450     STRLEN len;
2451 #ifdef USE_LOCALE_NUMERIC
2452     bool specialradix = FALSE;
2453 #endif
2454
2455     if (SvPOK(sv)) {
2456         sbegin = SvPVX(sv);
2457         len = SvCUR(sv);
2458     }
2459     else if (SvPOKp(sv))
2460         sbegin = SvPV(sv, len);
2461     else
2462         return 1;
2463     send = sbegin + len;
2464
2465     s = sbegin;
2466     while (isSPACE(*s))
2467         s++;
2468     if (*s == '-') {
2469         s++;
2470         numtype = IS_NUMBER_NEG;
2471     }
2472     else if (*s == '+')
2473         s++;
2474
2475     nbegin = s;
2476     /*
2477      * we return IS_NUMBER_TO_INT_BY_ATOL if the number can converted to
2478      * integer with atol() without overflow, IS_NUMBER_TO_INT_BY_STRTOL if
2479      * possibly slightly larger than max int, IS_NUMBER_TO_INT_BY_ATOF if you
2480      * will need (int)atof().
2481      */
2482
2483     /* next must be digit or the radix separator or beginning of infinity */
2484     if (isDIGIT(*s)) {
2485         do {
2486             s++;
2487         } while (isDIGIT(*s));
2488
2489         /* Aaargh. long long really is irritating.
2490            In the gospel according to ANSI 1989, it is an axiom that "long"
2491            is the longest integer type, and that if you don't know how long
2492            something is you can cast it to long, and nothing will be lost
2493            (except possibly speed of execution if long is slower than the
2494            type is was).
2495            Now, one can't be sure if the old rules apply, or long long
2496            (or some other newfangled thing) is actually longer than the
2497            (formerly) longest thing.
2498         */
2499         /* This lot will work for 64 bit  *as long as* either
2500            either long is 64 bit
2501            or     we can find both strtol/strtoq and strtoul/strtouq
2502            If not, we really should refuse to let the user use 64 bit IVs
2503            By "64 bit" I really mean IVs that don't get preserved by NVs
2504            It also should work for 128 bit IVs. Can any lend me a machine to
2505            test this?
2506         */
2507         if (s - nbegin > TYPE_DIGITS(UV)) /* Cannot cache ato[ul]() */
2508             numtype |= IS_NUMBER_TO_INT_BY_ATOF | IS_NUMBER_LONGER_THAN_IV_MAX;
2509         else if (s - nbegin < BIT_DIGITS(((sizeof (IV)>sizeof (long))
2510                                           ? sizeof(long) : sizeof (IV))*8-1))
2511             numtype |= IS_NUMBER_TO_INT_BY_ATOL;
2512         else
2513             /* Can't be sure either way. (For 64 bit UV, 63 bit IV is 1 decimal
2514                digit less (IV_MAX=  9223372036854775807,
2515                            UV_MAX= 18446744073709551615) so be cautious  */
2516             numtype |= IS_NUMBER_TO_INT_BY_STRTOL | IS_NUMBER_AS_LONG_AS_IV_MAX;
2517
2518         if (*s == '.'
2519 #ifdef USE_LOCALE_NUMERIC
2520             || (specialradix = IS_NUMERIC_RADIX(s))
2521 #endif
2522             ) {
2523 #ifdef USE_LOCALE_NUMERIC
2524             if (specialradix)
2525                 s += SvCUR(PL_numeric_radix);
2526             else
2527 #endif
2528                 s++;
2529             numtype |= IS_NUMBER_NOT_INT;
2530             while (isDIGIT(*s))  /* optional digits after the radix */
2531                 s++;
2532         }
2533     }
2534     else if (*s == '.'
2535 #ifdef USE_LOCALE_NUMERIC
2536             || (specialradix = IS_NUMERIC_RADIX(s))
2537 #endif
2538             ) {
2539 #ifdef USE_LOCALE_NUMERIC
2540         if (specialradix)
2541             s += SvCUR(PL_numeric_radix);
2542         else
2543 #endif
2544             s++;
2545         numtype |= IS_NUMBER_TO_INT_BY_ATOL | IS_NUMBER_NOT_INT;
2546         /* no digits before the radix means we need digits after it */
2547         if (isDIGIT(*s)) {
2548             do {
2549                 s++;
2550             } while (isDIGIT(*s));
2551         }
2552         else
2553             return 0;
2554     }
2555     else if (*s == 'I' || *s == 'i') {
2556         s++; if (*s != 'N' && *s != 'n') return 0;
2557         s++; if (*s != 'F' && *s != 'f') return 0;
2558         s++; if (*s == 'I' || *s == 'i') {
2559             s++; if (*s != 'N' && *s != 'n') return 0;
2560             s++; if (*s != 'I' && *s != 'i') return 0;
2561             s++; if (*s != 'T' && *s != 't') return 0;
2562             s++; if (*s != 'Y' && *s != 'y') return 0;
2563             s++;
2564         }
2565         sawinf = 1;
2566     }
2567     else
2568         return 0;
2569
2570     if (sawinf)
2571         numtype = (numtype & IS_NUMBER_NEG) /* Keep track of sign  */
2572           | IS_NUMBER_INFINITY | IS_NUMBER_NOT_INT;
2573     else {
2574         /* we can have an optional exponent part */
2575         if (*s == 'e' || *s == 'E') {
2576             numtype &= IS_NUMBER_NEG;
2577             numtype |= IS_NUMBER_TO_INT_BY_ATOF | IS_NUMBER_NOT_INT;
2578             s++;
2579             if (*s == '+' || *s == '-')
2580                 s++;
2581             if (isDIGIT(*s)) {
2582                 do {
2583                     s++;
2584                 } while (isDIGIT(*s));
2585             }
2586             else
2587                 return 0;
2588         }
2589     }
2590     while (isSPACE(*s))
2591         s++;
2592     if (s >= send)
2593         return numtype;
2594     if (len == 10 && memEQ(sbegin, "0 but true", 10))
2595         return IS_NUMBER_TO_INT_BY_ATOL;
2596     return 0;
2597 }
2598
2599 char *
2600 Perl_sv_2pv_nolen(pTHX_ register SV *sv)
2601 {
2602     STRLEN n_a;
2603     return sv_2pv(sv, &n_a);
2604 }
2605
2606 /* We assume that buf is at least TYPE_CHARS(UV) long. */
2607 static char *
2608 uiv_2buf(char *buf, IV iv, UV uv, int is_uv, char **peob)
2609 {
2610     char *ptr = buf + TYPE_CHARS(UV);
2611     char *ebuf = ptr;
2612     int sign;
2613
2614     if (is_uv)
2615         sign = 0;
2616     else if (iv >= 0) {
2617         uv = iv;
2618         sign = 0;
2619     } else {
2620         uv = -iv;
2621         sign = 1;
2622     }
2623     do {
2624         *--ptr = '0' + (uv % 10);
2625     } while (uv /= 10);
2626     if (sign)
2627         *--ptr = '-';
2628     *peob = ebuf;
2629     return ptr;
2630 }
2631
2632 char *
2633 Perl_sv_2pv(pTHX_ register SV *sv, STRLEN *lp)
2634 {
2635     register char *s;
2636     int olderrno;
2637     SV *tsv;
2638     char tbuf[64];      /* Must fit sprintf/Gconvert of longest IV/NV */
2639     char *tmpbuf = tbuf;
2640
2641     if (!sv) {
2642         *lp = 0;
2643         return "";
2644     }
2645     if (SvGMAGICAL(sv)) {
2646         mg_get(sv);
2647         if (SvPOKp(sv)) {
2648             *lp = SvCUR(sv);
2649             return SvPVX(sv);
2650         }
2651         if (SvIOKp(sv)) {
2652             if (SvIsUV(sv))
2653                 (void)sprintf(tmpbuf,"%"UVuf, (UV)SvUVX(sv));
2654             else
2655                 (void)sprintf(tmpbuf,"%"IVdf, (IV)SvIVX(sv));
2656             tsv = Nullsv;
2657             goto tokensave;
2658         }
2659         if (SvNOKp(sv)) {
2660             Gconvert(SvNVX(sv), NV_DIG, 0, tmpbuf);
2661             tsv = Nullsv;
2662             goto tokensave;
2663         }
2664         if (!SvROK(sv)) {
2665             if (!(SvFLAGS(sv) & SVs_PADTMP)) {
2666                 if (ckWARN(WARN_UNINITIALIZED) && !PL_localizing)
2667                     report_uninit();
2668             }
2669             *lp = 0;
2670             return "";
2671         }
2672     }
2673     if (SvTHINKFIRST(sv)) {
2674         if (SvROK(sv)) {
2675             SV* tmpstr;
2676             if (SvAMAGIC(sv) && (tmpstr=AMG_CALLun(sv,string)) &&
2677                     (SvRV(tmpstr) != SvRV(sv)))
2678                 return SvPV(tmpstr,*lp);
2679             sv = (SV*)SvRV(sv);
2680             if (!sv)
2681                 s = "NULLREF";
2682             else {
2683                 MAGIC *mg;
2684
2685                 switch (SvTYPE(sv)) {
2686                 case SVt_PVMG:
2687                     if ( ((SvFLAGS(sv) &
2688                            (SVs_OBJECT|SVf_OK|SVs_GMG|SVs_SMG|SVs_RMG))
2689                           == (SVs_OBJECT|SVs_RMG))
2690                          && strEQ(s=HvNAME(SvSTASH(sv)), "Regexp")
2691                          && (mg = mg_find(sv, 'r'))) {
2692                         regexp *re = (regexp *)mg->mg_obj;
2693
2694                         if (!mg->mg_ptr) {
2695                             char *fptr = "msix";
2696                             char reflags[6];
2697                             char ch;
2698                             int left = 0;
2699                             int right = 4;
2700                             U16 reganch = (re->reganch & PMf_COMPILETIME) >> 12;
2701
2702                             while((ch = *fptr++)) {
2703                                 if(reganch & 1) {
2704                                     reflags[left++] = ch;
2705                                 }
2706                                 else {
2707                                     reflags[right--] = ch;
2708                                 }
2709                                 reganch >>= 1;
2710                             }
2711                             if(left != 4) {
2712                                 reflags[left] = '-';
2713                                 left = 5;
2714                             }
2715
2716                             mg->mg_len = re->prelen + 4 + left;
2717                             New(616, mg->mg_ptr, mg->mg_len + 1 + left, char);
2718                             Copy("(?", mg->mg_ptr, 2, char);
2719                             Copy(reflags, mg->mg_ptr+2, left, char);
2720                             Copy(":", mg->mg_ptr+left+2, 1, char);
2721                             Copy(re->precomp, mg->mg_ptr+3+left, re->prelen, char);
2722                             mg->mg_ptr[mg->mg_len - 1] = ')';
2723                             mg->mg_ptr[mg->mg_len] = 0;
2724                         }
2725                         PL_reginterp_cnt += re->program[0].next_off;
2726                         *lp = mg->mg_len;
2727                         return mg->mg_ptr;
2728                     }
2729                                         /* Fall through */
2730                 case SVt_NULL:
2731                 case SVt_IV:
2732                 case SVt_NV:
2733                 case SVt_RV:
2734                 case SVt_PV:
2735                 case SVt_PVIV:
2736                 case SVt_PVNV:
2737                 case SVt_PVBM:  if (SvROK(sv))
2738                                     s = "REF";
2739                                 else
2740                                     s = "SCALAR";               break;
2741                 case SVt_PVLV:  s = "LVALUE";                   break;
2742                 case SVt_PVAV:  s = "ARRAY";                    break;
2743                 case SVt_PVHV:  s = "HASH";                     break;
2744                 case SVt_PVCV:  s = "CODE";                     break;
2745                 case SVt_PVGV:  s = "GLOB";                     break;
2746                 case SVt_PVFM:  s = "FORMAT";                   break;
2747                 case SVt_PVIO:  s = "IO";                       break;
2748                 default:        s = "UNKNOWN";                  break;
2749                 }
2750                 tsv = NEWSV(0,0);
2751                 if (SvOBJECT(sv))
2752                     Perl_sv_setpvf(aTHX_ tsv, "%s=%s", HvNAME(SvSTASH(sv)), s);
2753                 else
2754                     sv_setpv(tsv, s);
2755                 Perl_sv_catpvf(aTHX_ tsv, "(0x%"UVxf")", PTR2UV(sv));
2756                 goto tokensaveref;
2757             }
2758             *lp = strlen(s);
2759             return s;
2760         }
2761         if (SvREADONLY(sv) && !SvOK(sv)) {
2762             if (ckWARN(WARN_UNINITIALIZED))
2763                 report_uninit();
2764             *lp = 0;
2765             return "";
2766         }
2767     }
2768     if (SvIOK(sv) || ((SvIOKp(sv) && !SvNOKp(sv)))) {
2769         /* I'm assuming that if both IV and NV are equally valid then
2770            converting the IV is going to be more efficient */
2771         U32 isIOK = SvIOK(sv);
2772         U32 isUIOK = SvIsUV(sv);
2773         char buf[TYPE_CHARS(UV)];
2774         char *ebuf, *ptr;
2775
2776         if (SvTYPE(sv) < SVt_PVIV)
2777             sv_upgrade(sv, SVt_PVIV);
2778         if (isUIOK)
2779             ptr = uiv_2buf(buf, 0, SvUVX(sv), 1, &ebuf);
2780         else
2781             ptr = uiv_2buf(buf, SvIVX(sv), 0, 0, &ebuf);
2782         SvGROW(sv, ebuf - ptr + 1);     /* inlined from sv_setpvn */
2783         Move(ptr,SvPVX(sv),ebuf - ptr,char);
2784         SvCUR_set(sv, ebuf - ptr);
2785         s = SvEND(sv);
2786         *s = '\0';
2787         if (isIOK)
2788             SvIOK_on(sv);
2789         else
2790             SvIOKp_on(sv);
2791         if (isUIOK)
2792             SvIsUV_on(sv);
2793     }
2794     else if (SvNOKp(sv)) {
2795         if (SvTYPE(sv) < SVt_PVNV)
2796             sv_upgrade(sv, SVt_PVNV);
2797         /* The +20 is pure guesswork.  Configure test needed. --jhi */
2798         SvGROW(sv, NV_DIG + 20);
2799         s = SvPVX(sv);
2800         olderrno = errno;       /* some Xenix systems wipe out errno here */
2801 #ifdef apollo
2802         if (SvNVX(sv) == 0.0)
2803             (void)strcpy(s,"0");
2804         else
2805 #endif /*apollo*/
2806         {
2807             Gconvert(SvNVX(sv), NV_DIG, 0, s);
2808         }
2809         errno = olderrno;
2810 #ifdef FIXNEGATIVEZERO
2811         if (*s == '-' && s[1] == '0' && !s[2])
2812             strcpy(s,"0");
2813 #endif
2814         while (*s) s++;
2815 #ifdef hcx
2816         if (s[-1] == '.')
2817             *--s = '\0';
2818 #endif
2819     }
2820     else {
2821         if (ckWARN(WARN_UNINITIALIZED)
2822             && !PL_localizing && !(SvFLAGS(sv) & SVs_PADTMP))
2823             report_uninit();
2824         *lp = 0;
2825         if (SvTYPE(sv) < SVt_PV)
2826             /* Typically the caller expects that sv_any is not NULL now.  */
2827             sv_upgrade(sv, SVt_PV);
2828         return "";
2829     }
2830     *lp = s - SvPVX(sv);
2831     SvCUR_set(sv, *lp);
2832     SvPOK_on(sv);
2833     DEBUG_c(PerlIO_printf(Perl_debug_log, "0x%"UVxf" 2pv(%s)\n",
2834                           PTR2UV(sv),SvPVX(sv)));
2835     return SvPVX(sv);
2836
2837   tokensave:
2838     if (SvROK(sv)) {    /* XXX Skip this when sv_pvn_force calls */
2839         /* Sneaky stuff here */
2840
2841       tokensaveref:
2842         if (!tsv)
2843             tsv = newSVpv(tmpbuf, 0);
2844         sv_2mortal(tsv);
2845         *lp = SvCUR(tsv);
2846         return SvPVX(tsv);
2847     }
2848     else {
2849         STRLEN len;
2850         char *t;
2851
2852         if (tsv) {
2853             sv_2mortal(tsv);
2854             t = SvPVX(tsv);
2855             len = SvCUR(tsv);
2856         }
2857         else {
2858             t = tmpbuf;
2859             len = strlen(tmpbuf);
2860         }
2861 #ifdef FIXNEGATIVEZERO
2862         if (len == 2 && t[0] == '-' && t[1] == '0') {
2863             t = "0";
2864             len = 1;
2865         }
2866 #endif
2867         (void)SvUPGRADE(sv, SVt_PV);
2868         *lp = len;
2869         s = SvGROW(sv, len + 1);
2870         SvCUR_set(sv, len);
2871         (void)strcpy(s, t);
2872         SvPOKp_on(sv);
2873         return s;
2874     }
2875 }
2876
2877 char *
2878 Perl_sv_2pvbyte_nolen(pTHX_ register SV *sv)
2879 {
2880     STRLEN n_a;
2881     return sv_2pvbyte(sv, &n_a);
2882 }
2883
2884 char *
2885 Perl_sv_2pvbyte(pTHX_ register SV *sv, STRLEN *lp)
2886 {
2887     return sv_2pv(sv,lp);
2888 }
2889
2890 char *
2891 Perl_sv_2pvutf8_nolen(pTHX_ register SV *sv)
2892 {
2893     STRLEN n_a;
2894     return sv_2pvutf8(sv, &n_a);
2895 }
2896
2897 char *
2898 Perl_sv_2pvutf8(pTHX_ register SV *sv, STRLEN *lp)
2899 {
2900     sv_utf8_upgrade(sv);
2901     return SvPV(sv,*lp);
2902 }
2903
2904 /* This function is only called on magical items */
2905 bool
2906 Perl_sv_2bool(pTHX_ register SV *sv)
2907 {
2908     if (SvGMAGICAL(sv))
2909         mg_get(sv);
2910
2911     if (!SvOK(sv))
2912         return 0;
2913     if (SvROK(sv)) {
2914         SV* tmpsv;
2915         if (SvAMAGIC(sv) && (tmpsv=AMG_CALLun(sv,bool_)) &&
2916                 (SvRV(tmpsv) != SvRV(sv)))
2917             return SvTRUE(tmpsv);
2918       return SvRV(sv) != 0;
2919     }
2920     if (SvPOKp(sv)) {
2921         register XPV* Xpvtmp;
2922         if ((Xpvtmp = (XPV*)SvANY(sv)) &&
2923                 (*Xpvtmp->xpv_pv > '0' ||
2924                 Xpvtmp->xpv_cur > 1 ||
2925                 (Xpvtmp->xpv_cur && *Xpvtmp->xpv_pv != '0')))
2926             return 1;
2927         else
2928             return 0;
2929     }
2930     else {
2931         if (SvIOKp(sv))
2932             return SvIVX(sv) != 0;
2933         else {
2934             if (SvNOKp(sv))
2935                 return SvNVX(sv) != 0.0;
2936             else
2937                 return FALSE;
2938         }
2939     }
2940 }
2941
2942 /*
2943 =for apidoc sv_utf8_upgrade
2944
2945 Convert the PV of an SV to its UTF8-encoded form.
2946 Forces the SV to string form it it is not already.
2947 Always sets the SvUTF8 flag to avoid future validity checks even
2948 if all the bytes have hibit clear.
2949
2950 =cut
2951 */
2952
2953 STRLEN
2954 Perl_sv_utf8_upgrade(pTHX_ register SV *sv)
2955 {
2956     char *s, *t, *e;
2957     int  hibit = 0;
2958
2959     if (!sv)
2960         return 0;
2961
2962     if (!SvPOK(sv))
2963         (void) SvPV_nolen(sv);
2964
2965     if (SvUTF8(sv))
2966         return SvCUR(sv);
2967
2968     /* This function could be much more efficient if we had a FLAG in SVs
2969      * to signal if there are any hibit chars in the PV.
2970      * Given that there isn't make loop fast as possible
2971      */
2972     s = SvPVX(sv);
2973     e = SvEND(sv);
2974     t = s;
2975     while (t < e) {
2976         if ((hibit = UTF8_IS_CONTINUED(*t++)))
2977             break;
2978     }
2979
2980     if (hibit) {
2981         STRLEN len;
2982
2983         if (SvREADONLY(sv) && SvFAKE(sv)) {
2984             sv_force_normal(sv);
2985             s = SvPVX(sv);
2986         }
2987         len = SvCUR(sv) + 1; /* Plus the \0 */
2988         SvPVX(sv) = (char*)bytes_to_utf8((U8*)s, &len);
2989         SvCUR(sv) = len - 1;
2990         if (SvLEN(sv) != 0)
2991             Safefree(s); /* No longer using what was there before. */
2992         SvLEN(sv) = len; /* No longer know the real size. */
2993     }
2994     /* Mark as UTF-8 even if no hibit - saves scanning loop */
2995     SvUTF8_on(sv);
2996     return SvCUR(sv);
2997 }
2998
2999 /*
3000 =for apidoc sv_utf8_downgrade
3001
3002 Attempt to convert the PV of an SV from UTF8-encoded to byte encoding.
3003 This may not be possible if the PV contains non-byte encoding characters;
3004 if this is the case, either returns false or, if C<fail_ok> is not
3005 true, croaks.
3006
3007 =cut
3008 */
3009
3010 bool
3011 Perl_sv_utf8_downgrade(pTHX_ register SV* sv, bool fail_ok)
3012 {
3013     if (SvPOK(sv) && SvUTF8(sv)) {
3014         if (SvCUR(sv)) {
3015             char *s;
3016             STRLEN len;
3017
3018             if (SvREADONLY(sv) && SvFAKE(sv))
3019                 sv_force_normal(sv);
3020             s = SvPV(sv, len);
3021             if (!utf8_to_bytes((U8*)s, &len)) {
3022                 if (fail_ok)
3023                     return FALSE;
3024                 else {
3025                     if (PL_op)
3026                         Perl_croak(aTHX_ "Wide character in %s",
3027                                    PL_op_desc[PL_op->op_type]);
3028                     else
3029                         Perl_croak(aTHX_ "Wide character");
3030                 }
3031             }
3032             SvCUR(sv) = len;
3033         }
3034         SvUTF8_off(sv);
3035     }
3036
3037     return TRUE;
3038 }
3039
3040 /*
3041 =for apidoc sv_utf8_encode
3042
3043 Convert the PV of an SV to UTF8-encoded, but then turn off the C<SvUTF8>
3044 flag so that it looks like octets again. Used as a building block
3045 for encode_utf8 in Encode.xs
3046
3047 =cut
3048 */
3049
3050 void
3051 Perl_sv_utf8_encode(pTHX_ register SV *sv)
3052 {
3053     (void) sv_utf8_upgrade(sv);
3054     SvUTF8_off(sv);
3055 }
3056
3057 /*
3058 =for apidoc sv_utf8_decode
3059
3060 Convert the octets in the PV from UTF-8 to chars. Scan for validity and then
3061 turn of SvUTF8 if needed so that we see characters. Used as a building block
3062 for decode_utf8 in Encode.xs
3063
3064 =cut
3065 */
3066
3067
3068
3069 bool
3070 Perl_sv_utf8_decode(pTHX_ register SV *sv)
3071 {
3072     if (SvPOK(sv)) {
3073         char *c;
3074         char *e;
3075
3076         /* The octets may have got themselves encoded - get them back as bytes */
3077         if (!sv_utf8_downgrade(sv, TRUE))
3078             return FALSE;
3079
3080         /* it is actually just a matter of turning the utf8 flag on, but
3081          * we want to make sure everything inside is valid utf8 first.
3082          */
3083         c = SvPVX(sv);
3084         if (!is_utf8_string((U8*)c, SvCUR(sv)+1))
3085             return FALSE;
3086         e = SvEND(sv);
3087         while (c < e) {
3088             if (UTF8_IS_CONTINUED(*c++)) {
3089                 SvUTF8_on(sv);
3090                 break;
3091             }
3092         }
3093     }
3094     return TRUE;
3095 }
3096
3097
3098 /* Note: sv_setsv() should not be called with a source string that needs
3099  * to be reused, since it may destroy the source string if it is marked
3100  * as temporary.
3101  */
3102
3103 /*
3104 =for apidoc sv_setsv
3105
3106 Copies the contents of the source SV C<ssv> into the destination SV C<dsv>.
3107 The source SV may be destroyed if it is mortal.  Does not handle 'set'
3108 magic.  See the macro forms C<SvSetSV>, C<SvSetSV_nosteal> and
3109 C<sv_setsv_mg>.
3110
3111 =cut
3112 */
3113
3114 void
3115 Perl_sv_setsv(pTHX_ SV *dstr, register SV *sstr)
3116 {
3117     register U32 sflags;
3118     register int dtype;
3119     register int stype;
3120
3121     if (sstr == dstr)
3122         return;
3123     SV_CHECK_THINKFIRST(dstr);
3124     if (!sstr)
3125         sstr = &PL_sv_undef;
3126     stype = SvTYPE(sstr);
3127     dtype = SvTYPE(dstr);
3128
3129     SvAMAGIC_off(dstr);
3130
3131     /* There's a lot of redundancy below but we're going for speed here */
3132
3133     switch (stype) {
3134     case SVt_NULL:
3135       undef_sstr:
3136         if (dtype != SVt_PVGV) {
3137             (void)SvOK_off(dstr);
3138             return;
3139         }
3140         break;
3141     case SVt_IV:
3142         if (SvIOK(sstr)) {
3143             switch (dtype) {
3144             case SVt_NULL:
3145                 sv_upgrade(dstr, SVt_IV);
3146                 break;
3147             case SVt_NV:
3148                 sv_upgrade(dstr, SVt_PVNV);
3149                 break;
3150             case SVt_RV:
3151             case SVt_PV:
3152                 sv_upgrade(dstr, SVt_PVIV);
3153                 break;
3154             }
3155             (void)SvIOK_only(dstr);
3156             SvIVX(dstr) = SvIVX(sstr);
3157             if (SvIsUV(sstr))
3158                 SvIsUV_on(dstr);
3159             if (SvTAINTED(sstr))
3160                 SvTAINT(dstr);
3161             return;
3162         }
3163         goto undef_sstr;
3164
3165     case SVt_NV:
3166         if (SvNOK(sstr)) {
3167             switch (dtype) {
3168             case SVt_NULL:
3169             case SVt_IV:
3170                 sv_upgrade(dstr, SVt_NV);
3171                 break;
3172             case SVt_RV:
3173             case SVt_PV:
3174             case SVt_PVIV:
3175                 sv_upgrade(dstr, SVt_PVNV);
3176                 break;
3177             }
3178             SvNVX(dstr) = SvNVX(sstr);
3179             (void)SvNOK_only(dstr);
3180             if (SvTAINTED(sstr))
3181                 SvTAINT(dstr);
3182             return;
3183         }
3184         goto undef_sstr;
3185
3186     case SVt_RV:
3187         if (dtype < SVt_RV)
3188             sv_upgrade(dstr, SVt_RV);
3189         else if (dtype == SVt_PVGV &&
3190                  SvTYPE(SvRV(sstr)) == SVt_PVGV) {
3191             sstr = SvRV(sstr);
3192             if (sstr == dstr) {
3193                 if (GvIMPORTED(dstr) != GVf_IMPORTED
3194                     && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
3195                 {
3196                     GvIMPORTED_on(dstr);
3197                 }
3198                 GvMULTI_on(dstr);
3199                 return;
3200             }
3201             goto glob_assign;
3202         }
3203         break;
3204     case SVt_PV:
3205     case SVt_PVFM:
3206         if (dtype < SVt_PV)
3207             sv_upgrade(dstr, SVt_PV);
3208         break;
3209     case SVt_PVIV:
3210         if (dtype < SVt_PVIV)
3211             sv_upgrade(dstr, SVt_PVIV);
3212         break;
3213     case SVt_PVNV:
3214         if (dtype < SVt_PVNV)
3215             sv_upgrade(dstr, SVt_PVNV);
3216         break;
3217     case SVt_PVAV:
3218     case SVt_PVHV:
3219     case SVt_PVCV:
3220     case SVt_PVIO:
3221         if (PL_op)
3222             Perl_croak(aTHX_ "Bizarre copy of %s in %s", sv_reftype(sstr, 0),
3223                 PL_op_name[PL_op->op_type]);
3224         else
3225             Perl_croak(aTHX_ "Bizarre copy of %s", sv_reftype(sstr, 0));
3226         break;
3227
3228     case SVt_PVGV:
3229         if (dtype <= SVt_PVGV) {
3230   glob_assign:
3231             if (dtype != SVt_PVGV) {
3232                 char *name = GvNAME(sstr);
3233                 STRLEN len = GvNAMELEN(sstr);
3234                 sv_upgrade(dstr, SVt_PVGV);
3235                 sv_magic(dstr, dstr, '*', Nullch, 0);
3236                 GvSTASH(dstr) = (HV*)SvREFCNT_inc(GvSTASH(sstr));
3237                 GvNAME(dstr) = savepvn(name, len);
3238                 GvNAMELEN(dstr) = len;
3239                 SvFAKE_on(dstr);        /* can coerce to non-glob */
3240             }
3241             /* ahem, death to those who redefine active sort subs */
3242             else if (PL_curstackinfo->si_type == PERLSI_SORT
3243                      && GvCV(dstr) && PL_sortcop == CvSTART(GvCV(dstr)))
3244                 Perl_croak(aTHX_ "Can't redefine active sort subroutine %s",
3245                       GvNAME(dstr));
3246
3247 #ifdef GV_SHARED_CHECK
3248                 if (GvSHARED((GV*)dstr)) {
3249                     Perl_croak(aTHX_ PL_no_modify);
3250                 }
3251 #endif
3252
3253             (void)SvOK_off(dstr);
3254             GvINTRO_off(dstr);          /* one-shot flag */
3255             gp_free((GV*)dstr);
3256             GvGP(dstr) = gp_ref(GvGP(sstr));
3257             if (SvTAINTED(sstr))
3258                 SvTAINT(dstr);
3259             if (GvIMPORTED(dstr) != GVf_IMPORTED
3260                 && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
3261             {
3262                 GvIMPORTED_on(dstr);
3263             }
3264             GvMULTI_on(dstr);
3265             return;
3266         }
3267         /* FALL THROUGH */
3268
3269     default:
3270         if (SvGMAGICAL(sstr)) {
3271             mg_get(sstr);
3272             if (SvTYPE(sstr) != stype) {
3273                 stype = SvTYPE(sstr);
3274                 if (stype == SVt_PVGV && dtype <= SVt_PVGV)
3275                     goto glob_assign;
3276             }
3277         }
3278         if (stype == SVt_PVLV)
3279             (void)SvUPGRADE(dstr, SVt_PVNV);
3280         else
3281             (void)SvUPGRADE(dstr, stype);
3282     }
3283
3284     sflags = SvFLAGS(sstr);
3285
3286     if (sflags & SVf_ROK) {
3287         if (dtype >= SVt_PV) {
3288             if (dtype == SVt_PVGV) {
3289                 SV *sref = SvREFCNT_inc(SvRV(sstr));
3290                 SV *dref = 0;
3291                 int intro = GvINTRO(dstr);
3292
3293 #ifdef GV_SHARED_CHECK
3294                 if (GvSHARED((GV*)dstr)) {
3295                     Perl_croak(aTHX_ PL_no_modify);
3296                 }
3297 #endif
3298
3299                 if (intro) {
3300                     GP *gp;
3301                     gp_free((GV*)dstr);
3302                     GvINTRO_off(dstr);  /* one-shot flag */
3303                     Newz(602,gp, 1, GP);
3304                     GvGP(dstr) = gp_ref(gp);
3305                     GvSV(dstr) = NEWSV(72,0);
3306                     GvLINE(dstr) = CopLINE(PL_curcop);
3307                     GvEGV(dstr) = (GV*)dstr;
3308                 }
3309                 GvMULTI_on(dstr);
3310                 switch (SvTYPE(sref)) {
3311                 case SVt_PVAV:
3312                     if (intro)
3313                         SAVESPTR(GvAV(dstr));
3314                     else
3315                         dref = (SV*)GvAV(dstr);
3316                     GvAV(dstr) = (AV*)sref;
3317                     if (!GvIMPORTED_AV(dstr)
3318                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
3319                     {
3320                         GvIMPORTED_AV_on(dstr);
3321                     }
3322                     break;
3323                 case SVt_PVHV:
3324                     if (intro)
3325                         SAVESPTR(GvHV(dstr));
3326                     else
3327                         dref = (SV*)GvHV(dstr);
3328                     GvHV(dstr) = (HV*)sref;
3329                     if (!GvIMPORTED_HV(dstr)
3330                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
3331                     {
3332                         GvIMPORTED_HV_on(dstr);
3333                     }
3334                     break;
3335                 case SVt_PVCV:
3336                     if (intro) {
3337                         if (GvCVGEN(dstr) && GvCV(dstr) != (CV*)sref) {
3338                             SvREFCNT_dec(GvCV(dstr));
3339                             GvCV(dstr) = Nullcv;
3340                             GvCVGEN(dstr) = 0; /* Switch off cacheness. */
3341                             PL_sub_generation++;
3342                         }
3343                         SAVESPTR(GvCV(dstr));
3344                     }
3345                     else
3346                         dref = (SV*)GvCV(dstr);
3347                     if (GvCV(dstr) != (CV*)sref) {
3348                         CV* cv = GvCV(dstr);
3349                         if (cv) {
3350                             if (!GvCVGEN((GV*)dstr) &&
3351                                 (CvROOT(cv) || CvXSUB(cv)))
3352                             {
3353                                 /* ahem, death to those who redefine
3354                                  * active sort subs */
3355                                 if (PL_curstackinfo->si_type == PERLSI_SORT &&
3356                                       PL_sortcop == CvSTART(cv))
3357                                     Perl_croak(aTHX_
3358                                     "Can't redefine active sort subroutine %s",
3359                                           GvENAME((GV*)dstr));
3360                                 /* Redefining a sub - warning is mandatory if
3361                                    it was a const and its value changed. */
3362                                 if (ckWARN(WARN_REDEFINE)
3363                                     || (CvCONST(cv)
3364                                         && (!CvCONST((CV*)sref)
3365                                             || sv_cmp(cv_const_sv(cv),
3366                                                       cv_const_sv((CV*)sref)))))
3367                                 {
3368                                     Perl_warner(aTHX_ WARN_REDEFINE,
3369                                         CvCONST(cv)
3370                                         ? "Constant subroutine %s redefined"
3371                                         : "Subroutine %s redefined",
3372                                         GvENAME((GV*)dstr));
3373                                 }
3374                             }
3375                             cv_ckproto(cv, (GV*)dstr,
3376                                        SvPOK(sref) ? SvPVX(sref) : Nullch);
3377                         }
3378                         GvCV(dstr) = (CV*)sref;
3379                         GvCVGEN(dstr) = 0; /* Switch off cacheness. */
3380                         GvASSUMECV_on(dstr);
3381                         PL_sub_generation++;
3382                     }
3383                     if (!GvIMPORTED_CV(dstr)
3384                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
3385                     {
3386                         GvIMPORTED_CV_on(dstr);
3387                     }
3388                     break;
3389                 case SVt_PVIO:
3390                     if (intro)
3391                         SAVESPTR(GvIOp(dstr));
3392                     else
3393                         dref = (SV*)GvIOp(dstr);
3394                     GvIOp(dstr) = (IO*)sref;
3395                     break;
3396                 case SVt_PVFM:
3397                     if (intro)
3398                         SAVESPTR(GvFORM(dstr));
3399                     else
3400                         dref = (SV*)GvFORM(dstr);
3401                     GvFORM(dstr) = (CV*)sref;
3402                     break;
3403                 default:
3404                     if (intro)
3405                         SAVESPTR(GvSV(dstr));
3406                     else
3407                         dref = (SV*)GvSV(dstr);
3408                     GvSV(dstr) = sref;
3409                     if (!GvIMPORTED_SV(dstr)
3410                         && CopSTASH_ne(PL_curcop, GvSTASH(dstr)))
3411                     {
3412                         GvIMPORTED_SV_on(dstr);
3413                     }
3414                     break;
3415                 }
3416                 if (dref)
3417                     SvREFCNT_dec(dref);
3418                 if (intro)
3419                     SAVEFREESV(sref);
3420                 if (SvTAINTED(sstr))
3421                     SvTAINT(dstr);
3422                 return;
3423             }
3424             if (SvPVX(dstr)) {
3425                 (void)SvOOK_off(dstr);          /* backoff */
3426                 if (SvLEN(dstr))
3427                     Safefree(SvPVX(dstr));
3428                 SvLEN(dstr)=SvCUR(dstr)=0;
3429             }
3430         }
3431         (void)SvOK_off(dstr);
3432         SvRV(dstr) = SvREFCNT_inc(SvRV(sstr));
3433         SvROK_on(dstr);
3434         if (sflags & SVp_NOK) {
3435             SvNOKp_on(dstr);
3436             /* Only set the public OK flag if the source has public OK.  */
3437             if (sflags & SVf_NOK)
3438                 SvFLAGS(dstr) |= SVf_NOK;
3439             SvNVX(dstr) = SvNVX(sstr);
3440         }
3441         if (sflags & SVp_IOK) {
3442             (void)SvIOKp_on(dstr);
3443             if (sflags & SVf_IOK)
3444                 SvFLAGS(dstr) |= SVf_IOK;
3445             if (sflags & SVf_IVisUV)
3446                 SvIsUV_on(dstr);
3447             SvIVX(dstr) = SvIVX(sstr);
3448         }
3449         if (SvAMAGIC(sstr)) {
3450             SvAMAGIC_on(dstr);
3451         }
3452     }
3453     else if (sflags & SVp_POK) {
3454
3455         /*
3456          * Check to see if we can just swipe the string.  If so, it's a
3457          * possible small lose on short strings, but a big win on long ones.
3458          * It might even be a win on short strings if SvPVX(dstr)
3459          * has to be allocated and SvPVX(sstr) has to be freed.
3460          */
3461
3462         if (SvTEMP(sstr) &&             /* slated for free anyway? */
3463             SvREFCNT(sstr) == 1 &&      /* and no other references to it? */
3464             !(sflags & SVf_OOK) &&      /* and not involved in OOK hack? */
3465             SvLEN(sstr)         &&      /* and really is a string */
3466             !(PL_op && PL_op->op_type == OP_AASSIGN)) /* and won't be needed again, potentially */
3467         {
3468             if (SvPVX(dstr)) {          /* we know that dtype >= SVt_PV */
3469                 if (SvOOK(dstr)) {
3470                     SvFLAGS(dstr) &= ~SVf_OOK;
3471                     Safefree(SvPVX(dstr) - SvIVX(dstr));
3472                 }
3473                 else if (SvLEN(dstr))
3474                     Safefree(SvPVX(dstr));
3475             }
3476             (void)SvPOK_only(dstr);
3477             SvPV_set(dstr, SvPVX(sstr));
3478             SvLEN_set(dstr, SvLEN(sstr));
3479             SvCUR_set(dstr, SvCUR(sstr));
3480
3481             SvTEMP_off(dstr);
3482             (void)SvOK_off(sstr);               /* NOTE: nukes most SvFLAGS on sstr */
3483             SvPV_set(sstr, Nullch);
3484             SvLEN_set(sstr, 0);
3485             SvCUR_set(sstr, 0);
3486             SvTEMP_off(sstr);
3487         }
3488         else {                                  /* have to copy actual string */
3489             STRLEN len = SvCUR(sstr);
3490
3491             SvGROW(dstr, len + 1);              /* inlined from sv_setpvn */
3492             Move(SvPVX(sstr),SvPVX(dstr),len,char);
3493             SvCUR_set(dstr, len);
3494             *SvEND(dstr) = '\0';
3495             (void)SvPOK_only(dstr);
3496         }
3497         if (sflags & SVf_UTF8)
3498             SvUTF8_on(dstr);
3499         /*SUPPRESS 560*/
3500         if (sflags & SVp_NOK) {
3501             SvNOKp_on(dstr);
3502             if (sflags & SVf_NOK)
3503                 SvFLAGS(dstr) |= SVf_NOK;
3504             SvNVX(dstr) = SvNVX(sstr);
3505         }
3506         if (sflags & SVp_IOK) {
3507             (void)SvIOKp_on(dstr);
3508             if (sflags & SVf_IOK)
3509                 SvFLAGS(dstr) |= SVf_IOK;
3510             if (sflags & SVf_IVisUV)
3511                 SvIsUV_on(dstr);
3512             SvIVX(dstr) = SvIVX(sstr);
3513         }
3514     }
3515     else if (sflags & SVp_IOK) {
3516         if (sflags & SVf_IOK)
3517             (void)SvIOK_only(dstr);
3518         else {
3519             (void)SvOK_off(dstr);
3520             (void)SvIOKp_on(dstr);
3521         }
3522         /* XXXX Do we want to set IsUV for IV(ROK)?  Be extra safe... */
3523         if (sflags & SVf_IVisUV)
3524             SvIsUV_on(dstr);
3525         SvIVX(dstr) = SvIVX(sstr);
3526         if (sflags & SVp_NOK) {
3527             if (sflags & SVf_NOK)
3528                 (void)SvNOK_on(dstr);
3529             else
3530                 (void)SvNOKp_on(dstr);
3531             SvNVX(dstr) = SvNVX(sstr);
3532         }
3533     }
3534     else if (sflags & SVp_NOK) {
3535         if (sflags & SVf_NOK)
3536             (void)SvNOK_only(dstr);
3537         else {
3538             (void)SvOK_off(dstr);
3539             SvNOKp_on(dstr);
3540         }
3541         SvNVX(dstr) = SvNVX(sstr);
3542     }
3543     else {
3544         if (dtype == SVt_PVGV) {
3545             if (ckWARN(WARN_MISC))
3546                 Perl_warner(aTHX_ WARN_MISC, "Undefined value assigned to typeglob");
3547         }
3548         else
3549             (void)SvOK_off(dstr);
3550     }
3551     if (SvTAINTED(sstr))
3552         SvTAINT(dstr);
3553 }
3554
3555 /*
3556 =for apidoc sv_setsv_mg
3557
3558 Like C<sv_setsv>, but also handles 'set' magic.
3559
3560 =cut
3561 */
3562
3563 void
3564 Perl_sv_setsv_mg(pTHX_ SV *dstr, register SV *sstr)
3565 {
3566     sv_setsv(dstr,sstr);
3567     SvSETMAGIC(dstr);
3568 }
3569
3570 /*
3571 =for apidoc sv_setpvn
3572
3573 Copies a string into an SV.  The C<len> parameter indicates the number of
3574 bytes to be copied.  Does not handle 'set' magic.  See C<sv_setpvn_mg>.
3575
3576 =cut
3577 */
3578
3579 void
3580 Perl_sv_setpvn(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3581 {
3582     register char *dptr;
3583
3584     SV_CHECK_THINKFIRST(sv);
3585     if (!ptr) {
3586         (void)SvOK_off(sv);
3587         return;
3588     }
3589     else {
3590         /* len is STRLEN which is unsigned, need to copy to signed */
3591         IV iv = len;
3592         assert(iv >= 0);
3593     }
3594     (void)SvUPGRADE(sv, SVt_PV);
3595
3596     SvGROW(sv, len + 1);
3597     dptr = SvPVX(sv);
3598     Move(ptr,dptr,len,char);
3599     dptr[len] = '\0';
3600     SvCUR_set(sv, len);
3601     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3602     SvTAINT(sv);
3603 }
3604
3605 /*
3606 =for apidoc sv_setpvn_mg
3607
3608 Like C<sv_setpvn>, but also handles 'set' magic.
3609
3610 =cut
3611 */
3612
3613 void
3614 Perl_sv_setpvn_mg(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3615 {
3616     sv_setpvn(sv,ptr,len);
3617     SvSETMAGIC(sv);
3618 }
3619
3620 /*
3621 =for apidoc sv_setpv
3622
3623 Copies a string into an SV.  The string must be null-terminated.  Does not
3624 handle 'set' magic.  See C<sv_setpv_mg>.
3625
3626 =cut
3627 */
3628
3629 void
3630 Perl_sv_setpv(pTHX_ register SV *sv, register const char *ptr)
3631 {
3632     register STRLEN len;
3633
3634     SV_CHECK_THINKFIRST(sv);
3635     if (!ptr) {
3636         (void)SvOK_off(sv);
3637         return;
3638     }
3639     len = strlen(ptr);
3640     (void)SvUPGRADE(sv, SVt_PV);
3641
3642     SvGROW(sv, len + 1);
3643     Move(ptr,SvPVX(sv),len+1,char);
3644     SvCUR_set(sv, len);
3645     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3646     SvTAINT(sv);
3647 }
3648
3649 /*
3650 =for apidoc sv_setpv_mg
3651
3652 Like C<sv_setpv>, but also handles 'set' magic.
3653
3654 =cut
3655 */
3656
3657 void
3658 Perl_sv_setpv_mg(pTHX_ register SV *sv, register const char *ptr)
3659 {
3660     sv_setpv(sv,ptr);
3661     SvSETMAGIC(sv);
3662 }
3663
3664 /*
3665 =for apidoc sv_usepvn
3666
3667 Tells an SV to use C<ptr> to find its string value.  Normally the string is
3668 stored inside the SV but sv_usepvn allows the SV to use an outside string.
3669 The C<ptr> should point to memory that was allocated by C<malloc>.  The
3670 string length, C<len>, must be supplied.  This function will realloc the
3671 memory pointed to by C<ptr>, so that pointer should not be freed or used by
3672 the programmer after giving it to sv_usepvn.  Does not handle 'set' magic.
3673 See C<sv_usepvn_mg>.
3674
3675 =cut
3676 */
3677
3678 void
3679 Perl_sv_usepvn(pTHX_ register SV *sv, register char *ptr, register STRLEN len)
3680 {
3681     SV_CHECK_THINKFIRST(sv);
3682     (void)SvUPGRADE(sv, SVt_PV);
3683     if (!ptr) {
3684         (void)SvOK_off(sv);
3685         return;
3686     }
3687     (void)SvOOK_off(sv);
3688     if (SvPVX(sv) && SvLEN(sv))
3689         Safefree(SvPVX(sv));
3690     Renew(ptr, len+1, char);
3691     SvPVX(sv) = ptr;
3692     SvCUR_set(sv, len);
3693     SvLEN_set(sv, len+1);
3694     *SvEND(sv) = '\0';
3695     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3696     SvTAINT(sv);
3697 }
3698
3699 /*
3700 =for apidoc sv_usepvn_mg
3701
3702 Like C<sv_usepvn>, but also handles 'set' magic.
3703
3704 =cut
3705 */
3706
3707 void
3708 Perl_sv_usepvn_mg(pTHX_ register SV *sv, register char *ptr, register STRLEN len)
3709 {
3710     sv_usepvn(sv,ptr,len);
3711     SvSETMAGIC(sv);
3712 }
3713
3714 void
3715 Perl_sv_force_normal_flags(pTHX_ register SV *sv, U32 flags)
3716 {
3717     if (SvREADONLY(sv)) {
3718         if (SvFAKE(sv)) {
3719             char *pvx = SvPVX(sv);
3720             STRLEN len = SvCUR(sv);
3721             U32 hash   = SvUVX(sv);
3722             SvGROW(sv, len + 1);
3723             Move(pvx,SvPVX(sv),len,char);
3724             *SvEND(sv) = '\0';
3725             SvFAKE_off(sv);
3726             SvREADONLY_off(sv);
3727             unsharepvn(pvx,SvUTF8(sv)?-len:len,hash);
3728         }
3729         else if (PL_curcop != &PL_compiling)
3730             Perl_croak(aTHX_ PL_no_modify);
3731     }
3732     if (SvROK(sv))
3733         sv_unref_flags(sv, flags);
3734     else if (SvFAKE(sv) && SvTYPE(sv) == SVt_PVGV)
3735         sv_unglob(sv);
3736 }
3737
3738 void
3739 Perl_sv_force_normal(pTHX_ register SV *sv)
3740 {
3741     sv_force_normal_flags(sv, 0);
3742 }
3743
3744 /*
3745 =for apidoc sv_chop
3746
3747 Efficient removal of characters from the beginning of the string buffer.
3748 SvPOK(sv) must be true and the C<ptr> must be a pointer to somewhere inside
3749 the string buffer.  The C<ptr> becomes the first character of the adjusted
3750 string.
3751
3752 =cut
3753 */
3754
3755 void
3756 Perl_sv_chop(pTHX_ register SV *sv, register char *ptr) /* like set but assuming ptr is in sv */
3757
3758
3759 {
3760     register STRLEN delta;
3761
3762     if (!ptr || !SvPOKp(sv))
3763         return;
3764     SV_CHECK_THINKFIRST(sv);
3765     if (SvTYPE(sv) < SVt_PVIV)
3766         sv_upgrade(sv,SVt_PVIV);
3767
3768     if (!SvOOK(sv)) {
3769         if (!SvLEN(sv)) { /* make copy of shared string */
3770             char *pvx = SvPVX(sv);
3771             STRLEN len = SvCUR(sv);
3772             SvGROW(sv, len + 1);
3773             Move(pvx,SvPVX(sv),len,char);
3774             *SvEND(sv) = '\0';
3775         }
3776         SvIVX(sv) = 0;
3777         SvFLAGS(sv) |= SVf_OOK;
3778     }
3779     SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVp_IOK|SVp_NOK|SVf_IVisUV);
3780     delta = ptr - SvPVX(sv);
3781     SvLEN(sv) -= delta;
3782     SvCUR(sv) -= delta;
3783     SvPVX(sv) += delta;
3784     SvIVX(sv) += delta;
3785 }
3786
3787 /*
3788 =for apidoc sv_catpvn
3789
3790 Concatenates the string onto the end of the string which is in the SV.  The
3791 C<len> indicates number of bytes to copy.  Handles 'get' magic, but not
3792 'set' magic.  See C<sv_catpvn_mg>.
3793
3794 =cut
3795 */
3796
3797 void
3798 Perl_sv_catpvn(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3799 {
3800     STRLEN tlen;
3801     char *junk;
3802
3803     junk = SvPV_force(sv, tlen);
3804     SvGROW(sv, tlen + len + 1);
3805     if (ptr == junk)
3806         ptr = SvPVX(sv);
3807     Move(ptr,SvPVX(sv)+tlen,len,char);
3808     SvCUR(sv) += len;
3809     *SvEND(sv) = '\0';
3810     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3811     SvTAINT(sv);
3812 }
3813
3814 /*
3815 =for apidoc sv_catpvn_mg
3816
3817 Like C<sv_catpvn>, but also handles 'set' magic.
3818
3819 =cut
3820 */
3821
3822 void
3823 Perl_sv_catpvn_mg(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
3824 {
3825     sv_catpvn(sv,ptr,len);
3826     SvSETMAGIC(sv);
3827 }
3828
3829 /*
3830 =for apidoc sv_catsv
3831
3832 Concatenates the string from SV C<ssv> onto the end of the string in
3833 SV C<dsv>.  Modifies C<dsv> but not C<ssv>.  Handles 'get' magic, but
3834 not 'set' magic.  See C<sv_catsv_mg>.
3835
3836 =cut */
3837
3838 void
3839 Perl_sv_catsv(pTHX_ SV *dsv, register SV *ssv)
3840 {
3841     char *spv;
3842     STRLEN slen;
3843     if (!ssv)
3844         return;
3845     if ((spv = SvPV(ssv, slen))) {
3846         bool dutf8 = DO_UTF8(dsv);
3847         bool sutf8 = DO_UTF8(ssv);
3848
3849         if (dutf8 == sutf8)
3850             sv_catpvn(dsv,spv,slen);
3851         else {
3852             if (dutf8) {
3853                 /* Not modifying source SV, so taking a temporary copy. */
3854                 SV* csv = sv_2mortal(newSVsv(ssv));
3855                 char *cpv;
3856                 STRLEN clen;
3857
3858                 sv_utf8_upgrade(csv);
3859                 cpv = SvPV(csv,clen);
3860                 sv_catpvn(dsv,cpv,clen);
3861             }
3862             else {
3863                 sv_utf8_upgrade(dsv);
3864                 sv_catpvn(dsv,spv,slen);
3865                 SvUTF8_on(dsv); /* If dsv has no wide characters. */
3866             }
3867         }
3868     }
3869 }
3870
3871 /*
3872 =for apidoc sv_catsv_mg
3873
3874 Like C<sv_catsv>, but also handles 'set' magic.
3875
3876 =cut
3877 */
3878
3879 void
3880 Perl_sv_catsv_mg(pTHX_ SV *dsv, register SV *ssv)
3881 {
3882     sv_catsv(dsv,ssv);
3883     SvSETMAGIC(dsv);
3884 }
3885
3886 /*
3887 =for apidoc sv_catpv
3888
3889 Concatenates the string onto the end of the string which is in the SV.
3890 Handles 'get' magic, but not 'set' magic.  See C<sv_catpv_mg>.
3891
3892 =cut
3893 */
3894
3895 void
3896 Perl_sv_catpv(pTHX_ register SV *sv, register const char *ptr)
3897 {
3898     register STRLEN len;
3899     STRLEN tlen;
3900     char *junk;
3901
3902     if (!ptr)
3903         return;
3904     junk = SvPV_force(sv, tlen);
3905     len = strlen(ptr);
3906     SvGROW(sv, tlen + len + 1);
3907     if (ptr == junk)
3908         ptr = SvPVX(sv);
3909     Move(ptr,SvPVX(sv)+tlen,len+1,char);
3910     SvCUR(sv) += len;
3911     (void)SvPOK_only_UTF8(sv);          /* validate pointer */
3912     SvTAINT(sv);
3913 }
3914
3915 /*
3916 =for apidoc sv_catpv_mg
3917
3918 Like C<sv_catpv>, but also handles 'set' magic.
3919
3920 =cut
3921 */
3922
3923 void
3924 Perl_sv_catpv_mg(pTHX_ register SV *sv, register const char *ptr)
3925 {
3926     sv_catpv(sv,ptr);
3927     SvSETMAGIC(sv);
3928 }
3929
3930 SV *
3931 Perl_newSV(pTHX_ STRLEN len)
3932 {
3933     register SV *sv;
3934
3935     new_SV(sv);
3936     if (len) {
3937         sv_upgrade(sv, SVt_PV);
3938         SvGROW(sv, len + 1);
3939     }
3940     return sv;
3941 }
3942
3943 /* name is assumed to contain an SV* if (name && namelen == HEf_SVKEY) */
3944
3945 /*
3946 =for apidoc sv_magic
3947
3948 Adds magic to an SV.
3949
3950 =cut
3951 */
3952
3953 void
3954 Perl_sv_magic(pTHX_ register SV *sv, SV *obj, int how, const char *name, I32 namlen)
3955 {
3956     MAGIC* mg;
3957
3958     if (SvREADONLY(sv)) {
3959         if (PL_curcop != &PL_compiling && !strchr("gBf", how))
3960             Perl_croak(aTHX_ PL_no_modify);
3961     }
3962     if (SvMAGICAL(sv) || (how == 't' && SvTYPE(sv) >= SVt_PVMG)) {
3963         if (SvMAGIC(sv) && (mg = mg_find(sv, how))) {
3964             if (how == 't')
3965                 mg->mg_len |= 1;
3966             return;
3967         }
3968     }
3969     else {
3970         (void)SvUPGRADE(sv, SVt_PVMG);
3971     }
3972     Newz(702,mg, 1, MAGIC);
3973     mg->mg_moremagic = SvMAGIC(sv);
3974     SvMAGIC(sv) = mg;
3975
3976     /* Some magic sontains a reference loop, where the sv and object refer to
3977        each other.  To prevent a avoid a reference loop that would prevent such
3978        objects being freed, we look for such loops and if we find one we avoid
3979        incrementing the object refcount. */
3980     if (!obj || obj == sv || how == '#' || how == 'r' ||
3981         (SvTYPE(obj) == SVt_PVGV &&
3982             (GvSV(obj) == sv || GvHV(obj) == (HV*)sv || GvAV(obj) == (AV*)sv ||
3983             GvCV(obj) == (CV*)sv || GvIOp(obj) == (IO*)sv ||
3984             GvFORM(obj) == (CV*)sv)))
3985     {
3986         mg->mg_obj = obj;
3987     }
3988     else {
3989         mg->mg_obj = SvREFCNT_inc(obj);
3990         mg->mg_flags |= MGf_REFCOUNTED;
3991     }
3992     mg->mg_type = how;
3993     mg->mg_len = namlen;
3994     if (name) {
3995         if (namlen >= 0)
3996             mg->mg_ptr = savepvn(name, namlen);
3997         else if (namlen == HEf_SVKEY)
3998             mg->mg_ptr = (char*)SvREFCNT_inc((SV*)name);
3999     }
4000
4001     switch (how) {
4002     case 0:
4003         mg->mg_virtual = &PL_vtbl_sv;
4004         break;
4005     case 'A':
4006         mg->mg_virtual = &PL_vtbl_amagic;
4007         break;
4008     case 'a':
4009         mg->mg_virtual = &PL_vtbl_amagicelem;
4010         break;
4011     case 'c':
4012         mg->mg_virtual = &PL_vtbl_ovrld;
4013         break;
4014     case 'B':
4015         mg->mg_virtual = &PL_vtbl_bm;
4016         break;
4017     case 'D':
4018         mg->mg_virtual = &PL_vtbl_regdata;
4019         break;
4020     case 'd':
4021         mg->mg_virtual = &PL_vtbl_regdatum;
4022         break;
4023     case 'E':
4024         mg->mg_virtual = &PL_vtbl_env;
4025         break;
4026     case 'f':
4027         mg->mg_virtual = &PL_vtbl_fm;
4028         break;
4029     case 'e':
4030         mg->mg_virtual = &PL_vtbl_envelem;
4031         break;
4032     case 'g':
4033         mg->mg_virtual = &PL_vtbl_mglob;
4034         break;
4035     case 'I':
4036         mg->mg_virtual = &PL_vtbl_isa;
4037         break;
4038     case 'i':
4039         mg->mg_virtual = &PL_vtbl_isaelem;
4040         break;
4041     case 'k':
4042         mg->mg_virtual = &PL_vtbl_nkeys;
4043         break;
4044     case 'L':
4045         SvRMAGICAL_on(sv);
4046         mg->mg_virtual = 0;
4047         break;
4048     case 'l':
4049         mg->mg_virtual = &PL_vtbl_dbline;
4050         break;
4051 #ifdef USE_THREADS
4052     case 'm':
4053         mg->mg_virtual = &PL_vtbl_mutex;
4054         break;
4055 #endif /* USE_THREADS */
4056 #ifdef USE_LOCALE_COLLATE
4057     case 'o':
4058         mg->mg_virtual = &PL_vtbl_collxfrm;
4059         break;
4060 #endif /* USE_LOCALE_COLLATE */
4061     case 'P':
4062         mg->mg_virtual = &PL_vtbl_pack;
4063         break;
4064     case 'p':
4065     case 'q':
4066         mg->mg_virtual = &PL_vtbl_packelem;
4067         break;
4068     case 'r':
4069         mg->mg_virtual = &PL_vtbl_regexp;
4070         break;
4071     case 'S':
4072         mg->mg_virtual = &PL_vtbl_sig;
4073         break;
4074     case 's':
4075         mg->mg_virtual = &PL_vtbl_sigelem;
4076         break;
4077     case 't':
4078         mg->mg_virtual = &PL_vtbl_taint;
4079         mg->mg_len = 1;
4080         break;
4081     case 'U':
4082         mg->mg_virtual = &PL_vtbl_uvar;
4083         break;
4084     case 'v':
4085         mg->mg_virtual = &PL_vtbl_vec;
4086         break;
4087     case 'x':
4088         mg->mg_virtual = &PL_vtbl_substr;
4089         break;
4090     case 'y':
4091         mg->mg_virtual = &PL_vtbl_defelem;
4092         break;
4093     case '*':
4094         mg->mg_virtual = &PL_vtbl_glob;
4095         break;
4096     case '#':
4097         mg->mg_virtual = &PL_vtbl_arylen;
4098         break;
4099     case '.':
4100         mg->mg_virtual = &PL_vtbl_pos;
4101         break;
4102     case '<':
4103         mg->mg_virtual = &PL_vtbl_backref;
4104         break;
4105     case '~':   /* Reserved for use by extensions not perl internals.   */
4106         /* Useful for attaching extension internal data to perl vars.   */
4107         /* Note that multiple extensions may clash if magical scalars   */
4108         /* etc holding private data from one are passed to another.     */
4109         SvRMAGICAL_on(sv);
4110         break;
4111     default:
4112         Perl_croak(aTHX_ "Don't know how to handle magic of type '%c'", how);
4113     }
4114     mg_magical(sv);
4115     if (SvGMAGICAL(sv))
4116         SvFLAGS(sv) &= ~(SVf_IOK|SVf_NOK|SVf_POK);
4117 }
4118
4119 /*
4120 =for apidoc sv_unmagic
4121
4122 Removes magic from an SV.
4123
4124 =cut
4125 */
4126
4127 int
4128 Perl_sv_unmagic(pTHX_ SV *sv, int type)
4129 {
4130     MAGIC* mg;
4131     MAGIC** mgp;
4132     if (SvTYPE(sv) < SVt_PVMG || !SvMAGIC(sv))
4133         return 0;
4134     mgp = &SvMAGIC(sv);
4135     for (mg = *mgp; mg; mg = *mgp) {
4136         if (mg->mg_type == type) {
4137             MGVTBL* vtbl = mg->mg_virtual;
4138             *mgp = mg->mg_moremagic;
4139             if (vtbl && vtbl->svt_free)
4140                 CALL_FPTR(vtbl->svt_free)(aTHX_ sv, mg);
4141             if (mg->mg_ptr && mg->mg_type != 'g') {
4142                 if (mg->mg_len >= 0)
4143                     Safefree(mg->mg_ptr);
4144                 else if (mg->mg_len == HEf_SVKEY)
4145                     SvREFCNT_dec((SV*)mg->mg_ptr);
4146             }
4147             if (mg->mg_flags & MGf_REFCOUNTED)
4148                 SvREFCNT_dec(mg->mg_obj);
4149             Safefree(mg);
4150         }
4151         else
4152             mgp = &mg->mg_moremagic;
4153     }
4154     if (!SvMAGIC(sv)) {
4155         SvMAGICAL_off(sv);
4156         SvFLAGS(sv) |= (SvFLAGS(sv) & (SVp_IOK|SVp_NOK|SVp_POK)) >> PRIVSHIFT;
4157     }
4158
4159     return 0;
4160 }
4161
4162 /*
4163 =for apidoc sv_rvweaken
4164
4165 Weaken a reference.
4166
4167 =cut
4168 */
4169
4170 SV *
4171 Perl_sv_rvweaken(pTHX_ SV *sv)
4172 {
4173     SV *tsv;
4174     if (!SvOK(sv))  /* let undefs pass */
4175         return sv;
4176     if (!SvROK(sv))
4177         Perl_croak(aTHX_ "Can't weaken a nonreference");
4178     else if (SvWEAKREF(sv)) {
4179         if (ckWARN(WARN_MISC))
4180             Perl_warner(aTHX_ WARN_MISC, "Reference is already weak");
4181         return sv;
4182     }
4183     tsv = SvRV(sv);
4184     sv_add_backref(tsv, sv);
4185     SvWEAKREF_on(sv);
4186     SvREFCNT_dec(tsv);
4187     return sv;
4188 }
4189
4190 STATIC void
4191 S_sv_add_backref(pTHX_ SV *tsv, SV *sv)
4192 {
4193     AV *av;
4194     MAGIC *mg;
4195     if (SvMAGICAL(tsv) && (mg = mg_find(tsv, '<')))
4196         av = (AV*)mg->mg_obj;
4197     else {
4198         av = newAV();
4199         sv_magic(tsv, (SV*)av, '<', NULL, 0);
4200         SvREFCNT_dec(av);           /* for sv_magic */
4201     }
4202     av_push(av,sv);
4203 }
4204
4205 STATIC void
4206 S_sv_del_backref(pTHX_ SV *sv)
4207 {
4208     AV *av;
4209     SV **svp;
4210     I32 i;
4211     SV *tsv = SvRV(sv);
4212     MAGIC *mg;
4213     if (!SvMAGICAL(tsv) || !(mg = mg_find(tsv, '<')))
4214         Perl_croak(aTHX_ "panic: del_backref");
4215     av = (AV *)mg->mg_obj;
4216     svp = AvARRAY(av);
4217     i = AvFILLp(av);
4218     while (i >= 0) {
4219         if (svp[i] == sv) {
4220             svp[i] = &PL_sv_undef; /* XXX */
4221         }
4222         i--;
4223     }
4224 }
4225
4226 /*
4227 =for apidoc sv_insert
4228
4229 Inserts a string at the specified offset/length within the SV. Similar to
4230 the Perl substr() function.
4231
4232 =cut
4233 */
4234
4235 void
4236 Perl_sv_insert(pTHX_ SV *bigstr, STRLEN offset, STRLEN len, char *little, STRLEN littlelen)
4237 {
4238     register char *big;
4239     register char *mid;
4240     register char *midend;
4241     register char *bigend;
4242     register I32 i;
4243     STRLEN curlen;
4244
4245
4246     if (!bigstr)
4247         Perl_croak(aTHX_ "Can't modify non-existent substring");
4248     SvPV_force(bigstr, curlen);
4249     (void)SvPOK_only_UTF8(bigstr);
4250     if (offset + len > curlen) {
4251         SvGROW(bigstr, offset+len+1);
4252         Zero(SvPVX(bigstr)+curlen, offset+len-curlen, char);
4253         SvCUR_set(bigstr, offset+len);
4254     }
4255
4256     SvTAINT(bigstr);
4257     i = littlelen - len;
4258     if (i > 0) {                        /* string might grow */
4259         big = SvGROW(bigstr, SvCUR(bigstr) + i + 1);
4260         mid = big + offset + len;
4261         midend = bigend = big + SvCUR(bigstr);
4262         bigend += i;
4263         *bigend = '\0';
4264         while (midend > mid)            /* shove everything down */
4265             *--bigend = *--midend;
4266         Move(little,big+offset,littlelen,char);
4267         SvCUR(bigstr) += i;
4268         SvSETMAGIC(bigstr);
4269         return;
4270     }
4271     else if (i == 0) {
4272         Move(little,SvPVX(bigstr)+offset,len,char);
4273         SvSETMAGIC(bigstr);
4274         return;
4275     }
4276
4277     big = SvPVX(bigstr);
4278     mid = big + offset;
4279     midend = mid + len;
4280     bigend = big + SvCUR(bigstr);
4281
4282     if (midend > bigend)
4283         Perl_croak(aTHX_ "panic: sv_insert");
4284
4285     if (mid - big > bigend - midend) {  /* faster to shorten from end */
4286         if (littlelen) {
4287             Move(little, mid, littlelen,char);
4288             mid += littlelen;
4289         }
4290         i = bigend - midend;
4291         if (i > 0) {
4292             Move(midend, mid, i,char);
4293             mid += i;
4294         }
4295         *mid = '\0';
4296         SvCUR_set(bigstr, mid - big);
4297     }
4298     /*SUPPRESS 560*/
4299     else if ((i = mid - big)) { /* faster from front */
4300         midend -= littlelen;
4301         mid = midend;
4302         sv_chop(bigstr,midend-i);
4303         big += i;
4304         while (i--)
4305             *--midend = *--big;
4306         if (littlelen)
4307             Move(little, mid, littlelen,char);
4308     }
4309     else if (littlelen) {
4310         midend -= littlelen;
4311         sv_chop(bigstr,midend);
4312         Move(little,midend,littlelen,char);
4313     }
4314     else {
4315         sv_chop(bigstr,midend);
4316     }
4317     SvSETMAGIC(bigstr);
4318 }
4319
4320 /*
4321 =for apidoc sv_replace
4322
4323 Make the first argument a copy of the second, then delete the original.
4324
4325 =cut
4326 */
4327
4328 void
4329 Perl_sv_replace(pTHX_ register SV *sv, register SV *nsv)
4330 {
4331     U32 refcnt = SvREFCNT(sv);
4332     SV_CHECK_THINKFIRST(sv);
4333     if (SvREFCNT(nsv) != 1 && ckWARN_d(WARN_INTERNAL))
4334         Perl_warner(aTHX_ WARN_INTERNAL, "Reference miscount in sv_replace()");
4335     if (SvMAGICAL(sv)) {
4336         if (SvMAGICAL(nsv))
4337             mg_free(nsv);
4338         else
4339             sv_upgrade(nsv, SVt_PVMG);
4340         SvMAGIC(nsv) = SvMAGIC(sv);
4341         SvFLAGS(nsv) |= SvMAGICAL(sv);
4342         SvMAGICAL_off(sv);
4343         SvMAGIC(sv) = 0;
4344     }
4345     SvREFCNT(sv) = 0;
4346     sv_clear(sv);
4347     assert(!SvREFCNT(sv));
4348     StructCopy(nsv,sv,SV);
4349     SvREFCNT(sv) = refcnt;
4350     SvFLAGS(nsv) |= SVTYPEMASK;         /* Mark as freed */
4351     del_SV(nsv);
4352 }
4353
4354 /*
4355 =for apidoc sv_clear
4356
4357 Clear an SV, making it empty. Does not free the memory used by the SV
4358 itself.
4359
4360 =cut
4361 */
4362
4363 void
4364 Perl_sv_clear(pTHX_ register SV *sv)
4365 {
4366     HV* stash;
4367     assert(sv);
4368     assert(SvREFCNT(sv) == 0);
4369
4370     if (SvOBJECT(sv)) {
4371         if (PL_defstash) {              /* Still have a symbol table? */
4372             djSP;
4373             CV* destructor;
4374             SV tmpref;
4375
4376             Zero(&tmpref, 1, SV);
4377             sv_upgrade(&tmpref, SVt_RV);
4378             SvROK_on(&tmpref);
4379             SvREADONLY_on(&tmpref);     /* DESTROY() could be naughty */
4380             SvREFCNT(&tmpref) = 1;
4381
4382             do {
4383                 stash = SvSTASH(sv);
4384                 destructor = StashHANDLER(stash,DESTROY);
4385                 if (destructor) {
4386                     ENTER;
4387                     PUSHSTACKi(PERLSI_DESTROY);
4388                     SvRV(&tmpref) = SvREFCNT_inc(sv);
4389                     EXTEND(SP, 2);
4390                     PUSHMARK(SP);
4391                     PUSHs(&tmpref);
4392                     PUTBACK;
4393                     call_sv((SV*)destructor, G_DISCARD|G_EVAL|G_KEEPERR);
4394                     SvREFCNT(sv)--;
4395                     POPSTACK;
4396                     SPAGAIN;
4397                     LEAVE;
4398                 }
4399             } while (SvOBJECT(sv) && SvSTASH(sv) != stash);
4400
4401             del_XRV(SvANY(&tmpref));
4402
4403             if (SvREFCNT(sv)) {
4404                 if (PL_in_clean_objs)
4405                     Perl_croak(aTHX_ "DESTROY created new reference to dead object '%s'",
4406                           HvNAME(stash));
4407                 /* DESTROY gave object new lease on life */
4408                 return;
4409             }
4410         }
4411
4412         if (SvOBJECT(sv)) {
4413             SvREFCNT_dec(SvSTASH(sv));  /* possibly of changed persuasion */
4414             SvOBJECT_off(sv);   /* Curse the object. */
4415             if (SvTYPE(sv) != SVt_PVIO)
4416                 --PL_sv_objcount;       /* XXX Might want something more general */
4417         }
4418     }
4419     if (SvTYPE(sv) >= SVt_PVMG && SvMAGIC(sv))
4420         mg_free(sv);
4421     stash = NULL;
4422     switch (SvTYPE(sv)) {
4423     case SVt_PVIO:
4424         if (IoIFP(sv) &&
4425             IoIFP(sv) != PerlIO_stdin() &&
4426             IoIFP(sv) != PerlIO_stdout() &&
4427             IoIFP(sv) != PerlIO_stderr())
4428         {
4429             io_close((IO*)sv, FALSE);
4430         }
4431         if (IoDIRP(sv) && !(IoFLAGS(sv) & IOf_FAKE_DIRP))
4432             PerlDir_close(IoDIRP(sv));
4433         IoDIRP(sv) = (DIR*)NULL;
4434         Safefree(IoTOP_NAME(sv));
4435         Safefree(IoFMT_NAME(sv));
4436         Safefree(IoBOTTOM_NAME(sv));
4437         /* FALL THROUGH */
4438     case SVt_PVBM:
4439         goto freescalar;
4440     case SVt_PVCV:
4441     case SVt_PVFM:
4442         cv_undef((CV*)sv);
4443         goto freescalar;
4444     case SVt_PVHV:
4445         hv_undef((HV*)sv);
4446         break;
4447     case SVt_PVAV:
4448         av_undef((AV*)sv);
4449         break;
4450     case SVt_PVLV:
4451         SvREFCNT_dec(LvTARG(sv));
4452         goto freescalar;
4453     case SVt_PVGV:
4454         gp_free((GV*)sv);
4455         Safefree(GvNAME(sv));
4456         /* cannot decrease stash refcount yet, as we might recursively delete
4457            ourselves when the refcnt drops to zero. Delay SvREFCNT_dec
4458            of stash until current sv is completely gone.
4459            -- JohnPC, 27 Mar 1998 */
4460         stash = GvSTASH(sv);
4461         /* FALL THROUGH */
4462     case SVt_PVMG:
4463     case SVt_PVNV:
4464     case SVt_PVIV:
4465       freescalar:
4466         (void)SvOOK_off(sv);
4467         /* FALL THROUGH */
4468     case SVt_PV:
4469     case SVt_RV:
4470         if (SvROK(sv)) {
4471             if (SvWEAKREF(sv))
4472                 sv_del_backref(sv);
4473             else
4474                 SvREFCNT_dec(SvRV(sv));
4475         }
4476         else if (SvPVX(sv) && SvLEN(sv))
4477             Safefree(SvPVX(sv));
4478         else if (SvPVX(sv) && SvREADONLY(sv) && SvFAKE(sv)) {
4479             unsharepvn(SvPVX(sv),SvUTF8(sv)?-SvCUR(sv):SvCUR(sv),SvUVX(sv));
4480             SvFAKE_off(sv);
4481         }
4482         break;
4483 /*
4484     case SVt_NV:
4485     case SVt_IV:
4486     case SVt_NULL:
4487         break;
4488 */
4489     }
4490
4491     switch (SvTYPE(sv)) {
4492     case SVt_NULL:
4493         break;
4494     case SVt_IV:
4495         del_XIV(SvANY(sv));
4496         break;
4497     case SVt_NV:
4498         del_XNV(SvANY(sv));
4499         break;
4500     case SVt_RV:
4501         del_XRV(SvANY(sv));
4502         break;
4503     case SVt_PV:
4504         del_XPV(SvANY(sv));
4505         break;
4506     case SVt_PVIV:
4507         del_XPVIV(SvANY(sv));
4508         break;
4509     case SVt_PVNV:
4510         del_XPVNV(SvANY(sv));
4511         break;
4512     case SVt_PVMG:
4513         del_XPVMG(SvANY(sv));
4514         break;
4515     case SVt_PVLV:
4516         del_XPVLV(SvANY(sv));
4517         break;
4518     case SVt_PVAV:
4519         del_XPVAV(SvANY(sv));
4520         break;
4521     case SVt_PVHV:
4522         del_XPVHV(SvANY(sv));
4523         break;
4524     case SVt_PVCV:
4525         del_XPVCV(SvANY(sv));
4526         break;
4527     case SVt_PVGV:
4528         del_XPVGV(SvANY(sv));
4529         /* code duplication for increased performance. */
4530         SvFLAGS(sv) &= SVf_BREAK;
4531         SvFLAGS(sv) |= SVTYPEMASK;
4532         /* decrease refcount of the stash that owns this GV, if any */
4533         if (stash)
4534             SvREFCNT_dec(stash);
4535         return; /* not break, SvFLAGS reset already happened */
4536     case SVt_PVBM:
4537         del_XPVBM(SvANY(sv));
4538         break;
4539     case SVt_PVFM:
4540         del_XPVFM(SvANY(sv));
4541         break;
4542     case SVt_PVIO:
4543         del_XPVIO(SvANY(sv));
4544         break;
4545     }
4546     SvFLAGS(sv) &= SVf_BREAK;
4547     SvFLAGS(sv) |= SVTYPEMASK;
4548 }
4549
4550 SV *
4551 Perl_sv_newref(pTHX_ SV *sv)
4552 {
4553     if (sv)
4554         ATOMIC_INC(SvREFCNT(sv));
4555     return sv;
4556 }
4557
4558 /*
4559 =for apidoc sv_free
4560
4561 Free the memory used by an SV.
4562
4563 =cut
4564 */
4565
4566 void
4567 Perl_sv_free(pTHX_ SV *sv)
4568 {
4569     int refcount_is_zero;
4570
4571     if (!sv)
4572         return;
4573     if (SvREFCNT(sv) == 0) {
4574         if (SvFLAGS(sv) & SVf_BREAK)
4575             return;
4576         if (PL_in_clean_all) /* All is fair */
4577             return;
4578         if (SvREADONLY(sv) && SvIMMORTAL(sv)) {
4579             /* make sure SvREFCNT(sv)==0 happens very seldom */
4580             SvREFCNT(sv) = (~(U32)0)/2;
4581             return;
4582         }
4583         if (ckWARN_d(WARN_INTERNAL))
4584             Perl_warner(aTHX_ WARN_INTERNAL, "Attempt to free unreferenced scalar");
4585         return;
4586     }
4587     ATOMIC_DEC_AND_TEST(refcount_is_zero, SvREFCNT(sv));
4588     if (!refcount_is_zero)
4589         return;
4590 #ifdef DEBUGGING
4591     if (SvTEMP(sv)) {
4592         if (ckWARN_d(WARN_DEBUGGING))
4593             Perl_warner(aTHX_ WARN_DEBUGGING,
4594                         "Attempt to free temp prematurely: SV 0x%"UVxf,
4595                         PTR2UV(sv));
4596         return;
4597     }
4598 #endif
4599     if (SvREADONLY(sv) && SvIMMORTAL(sv)) {
4600         /* make sure SvREFCNT(sv)==0 happens very seldom */
4601         SvREFCNT(sv) = (~(U32)0)/2;
4602         return;
4603     }
4604     sv_clear(sv);
4605     if (! SvREFCNT(sv))
4606         del_SV(sv);
4607 }
4608
4609 /*
4610 =for apidoc sv_len
4611
4612 Returns the length of the string in the SV.  See also C<SvCUR>.
4613
4614 =cut
4615 */
4616
4617 STRLEN
4618 Perl_sv_len(pTHX_ register SV *sv)
4619 {
4620     char *junk;
4621     STRLEN len;
4622
4623     if (!sv)
4624         return 0;
4625
4626     if (SvGMAGICAL(sv))
4627         len = mg_length(sv);
4628     else
4629         junk = SvPV(sv, len);
4630     return len;
4631 }
4632
4633 /*
4634 =for apidoc sv_len_utf8
4635
4636 Returns the number of characters in the string in an SV, counting wide
4637 UTF8 bytes as a single character.
4638
4639 =cut
4640 */
4641
4642 STRLEN
4643 Perl_sv_len_utf8(pTHX_ register SV *sv)
4644 {
4645     if (!sv)
4646         return 0;
4647
4648     if (SvGMAGICAL(sv))
4649         return mg_length(sv);
4650     else
4651     {
4652         STRLEN len;
4653         U8 *s = (U8*)SvPV(sv, len);
4654
4655         return Perl_utf8_length(aTHX_ s, s + len);
4656     }
4657 }
4658
4659 void
4660 Perl_sv_pos_u2b(pTHX_ register SV *sv, I32* offsetp, I32* lenp)
4661 {
4662     U8 *start;
4663     U8 *s;
4664     U8 *send;
4665     I32 uoffset = *offsetp;
4666     STRLEN len;
4667
4668     if (!sv)
4669         return;
4670
4671     start = s = (U8*)SvPV(sv, len);
4672     send = s + len;
4673     while (s < send && uoffset--)
4674         s += UTF8SKIP(s);
4675     if (s >= send)
4676         s = send;
4677     *offsetp = s - start;
4678     if (lenp) {
4679         I32 ulen = *lenp;
4680         start = s;
4681         while (s < send && ulen--)
4682             s += UTF8SKIP(s);
4683         if (s >= send)
4684             s = send;
4685         *lenp = s - start;
4686     }
4687     return;
4688 }
4689
4690 void
4691 Perl_sv_pos_b2u(pTHX_ register SV *sv, I32* offsetp)
4692 {
4693     U8 *s;
4694     U8 *send;
4695     STRLEN len;
4696
4697     if (!sv)
4698         return;
4699
4700     s = (U8*)SvPV(sv, len);
4701     if (len < *offsetp)
4702         Perl_croak(aTHX_ "panic: sv_pos_b2u: bad byte offset");
4703     send = s + *offsetp;
4704     len = 0;
4705     while (s < send) {
4706         STRLEN n;
4707
4708         if (utf8_to_uv(s, UTF8SKIP(s), &n, 0)) {
4709             s += n;
4710             len++;
4711         }
4712         else
4713             break;
4714     }
4715     *offsetp = len;
4716     return;
4717 }
4718
4719 /*
4720 =for apidoc sv_eq
4721
4722 Returns a boolean indicating whether the strings in the two SVs are
4723 identical.
4724
4725 =cut
4726 */
4727
4728 I32
4729 Perl_sv_eq(pTHX_ register SV *sv1, register SV *sv2)
4730 {
4731     char *pv1;
4732     STRLEN cur1;
4733     char *pv2;
4734     STRLEN cur2;
4735     I32  eq     = 0;
4736     bool pv1tmp = FALSE;
4737     bool pv2tmp = FALSE;
4738
4739     if (!sv1) {
4740         pv1 = "";
4741         cur1 = 0;
4742     }
4743     else
4744         pv1 = SvPV(sv1, cur1);
4745
4746     if (!sv2){
4747         pv2 = "";
4748         cur2 = 0;
4749     }
4750     else
4751         pv2 = SvPV(sv2, cur2);
4752
4753     /* do not utf8ize the comparands as a side-effect */
4754     if (cur1 && cur2 && SvUTF8(sv1) != SvUTF8(sv2) && !IN_BYTE) {
4755         bool is_utf8 = TRUE;
4756
4757         if (PL_hints & HINT_UTF8_DISTINCT)
4758             return FALSE;
4759
4760         if (SvUTF8(sv1)) {
4761             char *pv = (char*)bytes_from_utf8((U8*)pv1, &cur1, &is_utf8);
4762
4763             if ((pv1tmp = (pv != pv1)))
4764                 pv1 = pv;
4765         }
4766         else {
4767             char *pv = (char *)bytes_from_utf8((U8*)pv2, &cur2, &is_utf8);
4768
4769             if ((pv2tmp = (pv != pv2)))
4770                 pv2 = pv;
4771         }
4772     }
4773
4774     if (cur1 == cur2)
4775         eq = memEQ(pv1, pv2, cur1);
4776
4777     if (pv1tmp)
4778         Safefree(pv1);
4779     if (pv2tmp)
4780         Safefree(pv2);
4781
4782     return eq;
4783 }
4784
4785 /*
4786 =for apidoc sv_cmp
4787
4788 Compares the strings in two SVs.  Returns -1, 0, or 1 indicating whether the
4789 string in C<sv1> is less than, equal to, or greater than the string in
4790 C<sv2>.
4791
4792 =cut
4793 */
4794
4795 I32
4796 Perl_sv_cmp(pTHX_ register SV *sv1, register SV *sv2)
4797 {
4798     STRLEN cur1, cur2;
4799     char *pv1, *pv2;
4800     I32  cmp;
4801     bool pv1tmp = FALSE;
4802     bool pv2tmp = FALSE;
4803
4804     if (!sv1) {
4805         pv1 = "";
4806         cur1 = 0;
4807     }
4808     else
4809         pv1 = SvPV(sv1, cur1);
4810
4811     if (!sv2){
4812         pv2 = "";
4813         cur2 = 0;
4814     }
4815     else
4816         pv2 = SvPV(sv2, cur2);
4817
4818     /* do not utf8ize the comparands as a side-effect */
4819     if (cur1 && cur2 && SvUTF8(sv1) != SvUTF8(sv2) && !IN_BYTE) {
4820         if (PL_hints & HINT_UTF8_DISTINCT)
4821             return SvUTF8(sv1) ? 1 : -1;
4822
4823         if (SvUTF8(sv1)) {
4824             pv2 = (char*)bytes_to_utf8((U8*)pv2, &cur2);
4825             pv2tmp = TRUE;
4826         }
4827         else {
4828             pv1 = (char*)bytes_to_utf8((U8*)pv1, &cur1);
4829             pv1tmp = TRUE;
4830         }
4831     }
4832
4833     if (!cur1) {
4834         cmp = cur2 ? -1 : 0;
4835     } else if (!cur2) {
4836         cmp = 1;
4837     } else {
4838         I32 retval = memcmp((void*)pv1, (void*)pv2, cur1 < cur2 ? cur1 : cur2);
4839
4840         if (retval) {
4841             cmp = retval < 0 ? -1 : 1;
4842         } else if (cur1 == cur2) {
4843             cmp = 0;
4844         } else {
4845             cmp = cur1 < cur2 ? -1 : 1;
4846         }
4847     }
4848
4849     if (pv1tmp)
4850         Safefree(pv1);
4851     if (pv2tmp)
4852         Safefree(pv2);
4853
4854     return cmp;
4855 }
4856
4857 /*
4858 =for apidoc sv_cmp_locale
4859
4860 Compares the strings in two SVs in a locale-aware manner. See
4861 L</sv_cmp_locale>
4862
4863 =cut
4864 */
4865
4866 I32
4867 Perl_sv_cmp_locale(pTHX_ register SV *sv1, register SV *sv2)
4868 {
4869 #ifdef USE_LOCALE_COLLATE
4870
4871     char *pv1, *pv2;
4872     STRLEN len1, len2;
4873     I32 retval;
4874
4875     if (PL_collation_standard)
4876         goto raw_compare;
4877
4878     len1 = 0;
4879     pv1 = sv1 ? sv_collxfrm(sv1, &len1) : (char *) NULL;
4880     len2 = 0;
4881     pv2 = sv2 ? sv_collxfrm(sv2, &len2) : (char *) NULL;
4882
4883     if (!pv1 || !len1) {
4884         if (pv2 && len2)
4885             return -1;
4886         else
4887             goto raw_compare;
4888     }
4889     else {
4890         if (!pv2 || !len2)
4891             return 1;
4892     }
4893
4894     retval = memcmp((void*)pv1, (void*)pv2, len1 < len2 ? len1 : len2);
4895
4896     if (retval)
4897         return retval < 0 ? -1 : 1;
4898