mathoms.c

   1 /*    mathoms.c
   2  *
   3  *    Copyright (C) 2005, 2006, 2007, 2008 by Larry Wall and others
   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  *  Anything that Hobbits had no immediate use for, but were unwilling to
  12  *  throw away, they called a mathom.  Their dwellings were apt to become
  13  *  rather crowded with mathoms, and many of the presents that passed from
  14  *  hand to hand were of that sort.
  15  *
  16  *     [p.5 of _The Lord of the Rings_: "Prologue"]
  17  */
  18
  19
  20
  21 /*
  22  * This file contains mathoms, various binary artifacts from previous
  23  * versions of Perl.  For binary or source compatibility reasons, though,
  24  * we cannot completely remove them from the core code.
  25  *
  26  * SMP - Oct. 24, 2005
  27  *
  28  */
  29
  30 #include "EXTERN.h"
  31 #define PERL_IN_MATHOMS_C
  32 #include "perl.h"
  33
  34 #ifdef NO_MATHOMS
  35 /* ..." warning: ISO C forbids an empty source file"
  36    So make sure we have something in here by processing the headers anyway.
  37  */
  38 #else
  39
  40 PERL_CALLCONV OP * Perl_ref(pTHX_ OP *o, I32 type);
  41 PERL_CALLCONV void Perl_sv_unref(pTHX_ SV *sv);
  42 PERL_CALLCONV void Perl_sv_taint(pTHX_ SV *sv);
  43 PERL_CALLCONV IV Perl_sv_2iv(pTHX_ register SV *sv);
  44 PERL_CALLCONV UV Perl_sv_2uv(pTHX_ register SV *sv);
  45 PERL_CALLCONV NV Perl_sv_2nv(pTHX_ register SV *sv);
  46 PERL_CALLCONV char * Perl_sv_2pv(pTHX_ register SV *sv, STRLEN *lp);
  47 PERL_CALLCONV char * Perl_sv_2pv_nolen(pTHX_ register SV *sv);
  48 PERL_CALLCONV char * Perl_sv_2pvbyte_nolen(pTHX_ register SV *sv);
  49 PERL_CALLCONV char * Perl_sv_2pvutf8_nolen(pTHX_ register SV *sv);
  50 PERL_CALLCONV void Perl_sv_force_normal(pTHX_ register SV *sv);
  51 PERL_CALLCONV void Perl_sv_setsv(pTHX_ SV *dstr, register SV *sstr);
  52 PERL_CALLCONV void Perl_sv_catpvn(pTHX_ SV *dsv, const char* sstr, STRLEN slen);
  53 PERL_CALLCONV void Perl_sv_catpvn_mg(pTHX_ register SV *sv, register const char *ptr, register STRLEN len);
  54 PERL_CALLCONV void Perl_sv_catsv(pTHX_ SV *dstr, register SV *sstr);
  55 PERL_CALLCONV void Perl_sv_catsv_mg(pTHX_ SV *dsv, register SV *ssv);
  56 PERL_CALLCONV char * Perl_sv_pv(pTHX_ SV *sv);
  57 PERL_CALLCONV char * Perl_sv_pvn_force(pTHX_ SV *sv, STRLEN *lp);
  58 PERL_CALLCONV char * Perl_sv_pvbyte(pTHX_ SV *sv);
  59 PERL_CALLCONV char * Perl_sv_pvutf8(pTHX_ SV *sv);
  60 PERL_CALLCONV STRLEN Perl_sv_utf8_upgrade(pTHX_ register SV *sv);
  61 PERL_CALLCONV NV Perl_huge(void);
  62 PERL_CALLCONV void Perl_gv_fullname3(pTHX_ SV *sv, const GV *gv, const char *prefix);
  63 PERL_CALLCONV void Perl_gv_efullname3(pTHX_ SV *sv, const GV *gv, const char *prefix);
  64 PERL_CALLCONV GV * Perl_gv_fetchmethod(pTHX_ HV *stash, const char *name);
  65 PERL_CALLCONV HE * Perl_hv_iternext(pTHX_ HV *hv);
  66 PERL_CALLCONV void Perl_hv_magic(pTHX_ HV *hv, GV *gv, int how);
  67 PERL_CALLCONV bool Perl_do_open(pTHX_ GV *gv, register const char *name, I32 len, int as_raw, int rawmode, int rawperm, PerlIO *supplied_fp);
  68 PERL_CALLCONV bool Perl_do_aexec(pTHX_ SV *really, register SV **mark, register SV **sp);
  69 PERL_CALLCONV bool Perl_do_exec(pTHX_ const char *cmd);
  70 PERL_CALLCONV U8 * Perl_uvuni_to_utf8(pTHX_ U8 *d, UV uv);
  71 PERL_CALLCONV bool Perl_is_utf8_string_loc(pTHX_ const U8 *s, STRLEN len, const U8 **ep);
  72 PERL_CALLCONV void Perl_sv_nolocking(pTHX_ SV *sv);
  73 PERL_CALLCONV void Perl_sv_usepvn_mg(pTHX_ SV *sv, char *ptr, STRLEN len);
  74 PERL_CALLCONV void Perl_sv_usepvn(pTHX_ SV *sv, char *ptr, STRLEN len);
  75 PERL_CALLCONV int Perl_fprintf_nocontext(PerlIO *stream, const char *format, ...);
  76 PERL_CALLCONV int Perl_printf_nocontext(const char *format, ...);
  77 PERL_CALLCONV int Perl_magic_setglob(pTHX_ SV* sv, MAGIC* mg);
  78 PERL_CALLCONV AV * Perl_newAV(pTHX);
  79 PERL_CALLCONV HV * Perl_newHV(pTHX);
  80 PERL_CALLCONV IO * Perl_newIO(pTHX);
  81 PERL_CALLCONV I32 Perl_my_stat(pTHX);
  82 PERL_CALLCONV I32 Perl_my_lstat(pTHX);
  83 PERL_CALLCONV I32 Perl_sv_eq(pTHX_ register SV *sv1, register SV *sv2);
  84 PERL_CALLCONV char * Perl_sv_collxfrm(pTHX_ SV *const sv, STRLEN *const nxp);
  85 PERL_CALLCONV bool Perl_sv_2bool(pTHX_ register SV *const sv);
  86 PERL_CALLCONV CV * Perl_newSUB(pTHX_ I32 floor, OP* o, OP* proto, OP* block);
  87
  88 /* ref() is now a macro using Perl_doref;
  89  * this version provided for binary compatibility only.
  90  */
  91 OP *
  92 Perl_ref(pTHX_ OP *o, I32 type)
  93 {
  94     return doref(o, type, TRUE);
  95 }
  96
  97 /*
  98 =for apidoc sv_unref
  99
 100 Unsets the RV status of the SV, and decrements the reference count of
 101 whatever was being referenced by the RV.  This can almost be thought of
 102 as a reversal of C<newSVrv>.  This is C<sv_unref_flags> with the C<flag>
 103 being zero.  See C<SvROK_off>.
 104
 105 =cut
 106 */
 107
 108 void
 109 Perl_sv_unref(pTHX_ SV *sv)
 110 {
 111     PERL_ARGS_ASSERT_SV_UNREF;
 112
 113     sv_unref_flags(sv, 0);
 114 }
 115
 116 /*
 117 =for apidoc sv_taint
 118
 119 Taint an SV. Use C<SvTAINTED_on> instead.
 120 =cut
 121 */
 122
 123 void
 124 Perl_sv_taint(pTHX_ SV *sv)
 125 {
 126     PERL_ARGS_ASSERT_SV_TAINT;
 127
 128     sv_magic((sv), NULL, PERL_MAGIC_taint, NULL, 0);
 129 }
 130
 131 /* sv_2iv() is now a macro using Perl_sv_2iv_flags();
 132  * this function provided for binary compatibility only
 133  */
 134
 135 IV
 136 Perl_sv_2iv(pTHX_ register SV *sv)
 137 {
 138     return sv_2iv_flags(sv, SV_GMAGIC);
 139 }
 140
 141 /* sv_2uv() is now a macro using Perl_sv_2uv_flags();
 142  * this function provided for binary compatibility only
 143  */
 144
 145 UV
 146 Perl_sv_2uv(pTHX_ register SV *sv)
 147 {
 148     return sv_2uv_flags(sv, SV_GMAGIC);
 149 }
 150
 151 /* sv_2nv() is now a macro using Perl_sv_2nv_flags();
 152  * this function provided for binary compatibility only
 153  */
 154
 155 NV
 156 Perl_sv_2nv(pTHX_ register SV *sv)
 157 {
 158     return sv_2nv_flags(sv, SV_GMAGIC);
 159 }
 160
 161
 162 /* sv_2pv() is now a macro using Perl_sv_2pv_flags();
 163  * this function provided for binary compatibility only
 164  */
 165
 166 char *
 167 Perl_sv_2pv(pTHX_ register SV *sv, STRLEN *lp)
 168 {
 169     return sv_2pv_flags(sv, lp, SV_GMAGIC);
 170 }
 171
 172 /*
 173 =for apidoc sv_2pv_nolen
 174
 175 Like C<sv_2pv()>, but doesn't return the length too. You should usually
 176 use the macro wrapper C<SvPV_nolen(sv)> instead.
 177 =cut
 178 */
 179
 180 char *
 181 Perl_sv_2pv_nolen(pTHX_ register SV *sv)
 182 {
 183     PERL_ARGS_ASSERT_SV_2PV_NOLEN;
 184     return sv_2pv(sv, NULL);
 185 }
 186
 187 /*
 188 =for apidoc sv_2pvbyte_nolen
 189
 190 Return a pointer to the byte-encoded representation of the SV.
 191 May cause the SV to be downgraded from UTF-8 as a side-effect.
 192
 193 Usually accessed via the C<SvPVbyte_nolen> macro.
 194
 195 =cut
 196 */
 197
 198 char *
 199 Perl_sv_2pvbyte_nolen(pTHX_ register SV *sv)
 200 {
 201     PERL_ARGS_ASSERT_SV_2PVBYTE_NOLEN;
 202
 203     return sv_2pvbyte(sv, NULL);
 204 }
 205
 206 /*
 207 =for apidoc sv_2pvutf8_nolen
 208
 209 Return a pointer to the UTF-8-encoded representation of the SV.
 210 May cause the SV to be upgraded to UTF-8 as a side-effect.
 211
 212 Usually accessed via the C<SvPVutf8_nolen> macro.
 213
 214 =cut
 215 */
 216
 217 char *
 218 Perl_sv_2pvutf8_nolen(pTHX_ register SV *sv)
 219 {
 220     PERL_ARGS_ASSERT_SV_2PVUTF8_NOLEN;
 221
 222     return sv_2pvutf8(sv, NULL);
 223 }
 224
 225 /*
 226 =for apidoc sv_force_normal
 227
 228 Undo various types of fakery on an SV: if the PV is a shared string, make
 229 a private copy; if we're a ref, stop refing; if we're a glob, downgrade to
 230 an xpvmg. See also C<sv_force_normal_flags>.
 231
 232 =cut
 233 */
 234
 235 void
 236 Perl_sv_force_normal(pTHX_ register SV *sv)
 237 {
 238     PERL_ARGS_ASSERT_SV_FORCE_NORMAL;
 239
 240     sv_force_normal_flags(sv, 0);
 241 }
 242
 243 /* sv_setsv() is now a macro using Perl_sv_setsv_flags();
 244  * this function provided for binary compatibility only
 245  */
 246
 247 void
 248 Perl_sv_setsv(pTHX_ SV *dstr, register SV *sstr)
 249 {
 250     PERL_ARGS_ASSERT_SV_SETSV;
 251
 252     sv_setsv_flags(dstr, sstr, SV_GMAGIC);
 253 }
 254
 255 /* sv_catpvn() is now a macro using Perl_sv_catpvn_flags();
 256  * this function provided for binary compatibility only
 257  */
 258
 259 void
 260 Perl_sv_catpvn(pTHX_ SV *dsv, const char* sstr, STRLEN slen)
 261 {
 262     PERL_ARGS_ASSERT_SV_CATPVN;
 263
 264     sv_catpvn_flags(dsv, sstr, slen, SV_GMAGIC);
 265 }
 266
 267 /*
 268 =for apidoc sv_catpvn_mg
 269
 270 Like C<sv_catpvn>, but also handles 'set' magic.
 271
 272 =cut
 273 */
 274
 275 void
 276 Perl_sv_catpvn_mg(pTHX_ register SV *sv, register const char *ptr, register STRLEN len)
 277 {
 278     PERL_ARGS_ASSERT_SV_CATPVN_MG;
 279
 280     sv_catpvn_flags(sv,ptr,len,SV_GMAGIC|SV_SMAGIC);
 281 }
 282
 283 /* sv_catsv() is now a macro using Perl_sv_catsv_flags();
 284  * this function provided for binary compatibility only
 285  */
 286
 287 void
 288 Perl_sv_catsv(pTHX_ SV *dstr, register SV *sstr)
 289 {
 290     PERL_ARGS_ASSERT_SV_CATSV;
 291
 292     sv_catsv_flags(dstr, sstr, SV_GMAGIC);
 293 }
 294
 295 /*
 296 =for apidoc sv_catsv_mg
 297
 298 Like C<sv_catsv>, but also handles 'set' magic.
 299
 300 =cut
 301 */
 302
 303 void
 304 Perl_sv_catsv_mg(pTHX_ SV *dsv, register SV *ssv)
 305 {
 306     PERL_ARGS_ASSERT_SV_CATSV_MG;
 307
 308     sv_catsv_flags(dsv,ssv,SV_GMAGIC|SV_SMAGIC);
 309 }
 310
 311 /*
 312 =for apidoc sv_iv
 313
 314 A private implementation of the C<SvIVx> macro for compilers which can't
 315 cope with complex macro expressions. Always use the macro instead.
 316
 317 =cut
 318 */
 319
 320 IV
 321 Perl_sv_iv(pTHX_ register SV *sv)
 322 {
 323     PERL_ARGS_ASSERT_SV_IV;
 324
 325     if (SvIOK(sv)) {
 326         if (SvIsUV(sv))
 327             return (IV)SvUVX(sv);
 328         return SvIVX(sv);
 329     }
 330     return sv_2iv(sv);
 331 }
 332
 333 /*
 334 =for apidoc sv_uv
 335
 336 A private implementation of the C<SvUVx> macro for compilers which can't
 337 cope with complex macro expressions. Always use the macro instead.
 338
 339 =cut
 340 */
 341
 342 UV
 343 Perl_sv_uv(pTHX_ register SV *sv)
 344 {
 345     PERL_ARGS_ASSERT_SV_UV;
 346
 347     if (SvIOK(sv)) {
 348         if (SvIsUV(sv))
 349             return SvUVX(sv);
 350         return (UV)SvIVX(sv);
 351     }
 352     return sv_2uv(sv);
 353 }
 354
 355 /*
 356 =for apidoc sv_nv
 357
 358 A private implementation of the C<SvNVx> macro for compilers which can't
 359 cope with complex macro expressions. Always use the macro instead.
 360
 361 =cut
 362 */
 363
 364 NV
 365 Perl_sv_nv(pTHX_ register SV *sv)
 366 {
 367     PERL_ARGS_ASSERT_SV_NV;
 368
 369     if (SvNOK(sv))
 370         return SvNVX(sv);
 371     return sv_2nv(sv);
 372 }
 373
 374 /*
 375 =for apidoc sv_pv
 376
 377 Use the C<SvPV_nolen> macro instead
 378
 379 =for apidoc sv_pvn
 380
 381 A private implementation of the C<SvPV> macro for compilers which can't
 382 cope with complex macro expressions. Always use the macro instead.
 383
 384 =cut
 385 */
 386
 387 char *
 388 Perl_sv_pvn(pTHX_ SV *sv, STRLEN *lp)
 389 {
 390     PERL_ARGS_ASSERT_SV_PVN;
 391
 392     if (SvPOK(sv)) {
 393         *lp = SvCUR(sv);
 394         return SvPVX(sv);
 395     }
 396     return sv_2pv(sv, lp);
 397 }
 398
 399
 400 char *
 401 Perl_sv_pvn_nomg(pTHX_ register SV *sv, STRLEN *lp)
 402 {
 403     PERL_ARGS_ASSERT_SV_PVN_NOMG;
 404
 405     if (SvPOK(sv)) {
 406         *lp = SvCUR(sv);
 407         return SvPVX(sv);
 408     }
 409     return sv_2pv_flags(sv, lp, 0);
 410 }
 411
 412 /* sv_pv() is now a macro using SvPV_nolen();
 413  * this function provided for binary compatibility only
 414  */
 415
 416 char *
 417 Perl_sv_pv(pTHX_ SV *sv)
 418 {
 419     PERL_ARGS_ASSERT_SV_PV;
 420
 421     if (SvPOK(sv))
 422         return SvPVX(sv);
 423
 424     return sv_2pv(sv, NULL);
 425 }
 426
 427 /* sv_pvn_force() is now a macro using Perl_sv_pvn_force_flags();
 428  * this function provided for binary compatibility only
 429  */
 430
 431 char *
 432 Perl_sv_pvn_force(pTHX_ SV *sv, STRLEN *lp)
 433 {
 434     PERL_ARGS_ASSERT_SV_PVN_FORCE;
 435
 436     return sv_pvn_force_flags(sv, lp, SV_GMAGIC);
 437 }
 438
 439 /* sv_pvbyte () is now a macro using Perl_sv_2pv_flags();
 440  * this function provided for binary compatibility only
 441  */
 442
 443 char *
 444 Perl_sv_pvbyte(pTHX_ SV *sv)
 445 {
 446     PERL_ARGS_ASSERT_SV_PVBYTE;
 447
 448     sv_utf8_downgrade(sv, FALSE);
 449     return sv_pv(sv);
 450 }
 451
 452 /*
 453 =for apidoc sv_pvbyte
 454
 455 Use C<SvPVbyte_nolen> instead.
 456
 457 =for apidoc sv_pvbyten
 458
 459 A private implementation of the C<SvPVbyte> macro for compilers
 460 which can't cope with complex macro expressions. Always use the macro
 461 instead.
 462
 463 =cut
 464 */
 465
 466 char *
 467 Perl_sv_pvbyten(pTHX_ SV *sv, STRLEN *lp)
 468 {
 469     PERL_ARGS_ASSERT_SV_PVBYTEN;
 470
 471     sv_utf8_downgrade(sv, FALSE);
 472     return sv_pvn(sv,lp);
 473 }
 474
 475 /* sv_pvutf8 () is now a macro using Perl_sv_2pv_flags();
 476  * this function provided for binary compatibility only
 477  */
 478
 479 char *
 480 Perl_sv_pvutf8(pTHX_ SV *sv)
 481 {
 482     PERL_ARGS_ASSERT_SV_PVUTF8;
 483
 484     sv_utf8_upgrade(sv);
 485     return sv_pv(sv);
 486 }
 487
 488 /*
 489 =for apidoc sv_pvutf8
 490
 491 Use the C<SvPVutf8_nolen> macro instead
 492
 493 =for apidoc sv_pvutf8n
 494
 495 A private implementation of the C<SvPVutf8> macro for compilers
 496 which can't cope with complex macro expressions. Always use the macro
 497 instead.
 498
 499 =cut
 500 */
 501
 502 char *
 503 Perl_sv_pvutf8n(pTHX_ SV *sv, STRLEN *lp)
 504 {
 505     PERL_ARGS_ASSERT_SV_PVUTF8N;
 506
 507     sv_utf8_upgrade(sv);
 508     return sv_pvn(sv,lp);
 509 }
 510
 511 /* sv_utf8_upgrade() is now a macro using sv_utf8_upgrade_flags();
 512  * this function provided for binary compatibility only
 513  */
 514
 515 STRLEN
 516 Perl_sv_utf8_upgrade(pTHX_ register SV *sv)
 517 {
 518     PERL_ARGS_ASSERT_SV_UTF8_UPGRADE;
 519
 520     return sv_utf8_upgrade_flags(sv, SV_GMAGIC);
 521 }
 522
 523 int
 524 Perl_fprintf_nocontext(PerlIO *stream, const char *format, ...)
 525 {
 526     dTHXs;
 527     va_list(arglist);
 528
 529     /* Easier to special case this here than in embed.pl. (Look at what it
 530        generates for proto.h) */
 531 #ifdef PERL_IMPLICIT_CONTEXT
 532     PERL_ARGS_ASSERT_FPRINTF_NOCONTEXT;
 533 #endif
 534
 535     va_start(arglist, format);
 536     return PerlIO_vprintf(stream, format, arglist);
 537 }
 538
 539 int
 540 Perl_printf_nocontext(const char *format, ...)
 541 {
 542     dTHX;
 543     va_list(arglist);
 544
 545 #ifdef PERL_IMPLICIT_CONTEXT
 546     PERL_ARGS_ASSERT_PRINTF_NOCONTEXT;
 547 #endif
 548
 549     va_start(arglist, format);
 550     return PerlIO_vprintf(PerlIO_stdout(), format, arglist);
 551 }
 552
 553 #if defined(HUGE_VAL) || (defined(USE_LONG_DOUBLE) && defined(HUGE_VALL))
 554 /*
 555  * This hack is to force load of "huge" support from libm.a
 556  * So it is in perl for (say) POSIX to use.
 557  * Needed for SunOS with Sun's 'acc' for example.
 558  */
 559 NV
 560 Perl_huge(void)
 561 {
 562 #  if defined(USE_LONG_DOUBLE) && defined(HUGE_VALL)
 563     return HUGE_VALL;
 564 #  else
 565     return HUGE_VAL;
 566 #  endif
 567 }
 568 #endif
 569
 570 /* compatibility with versions <= 5.003. */
 571 void
 572 Perl_gv_fullname(pTHX_ SV *sv, const GV *gv)
 573 {
 574     PERL_ARGS_ASSERT_GV_FULLNAME;
 575
 576     gv_fullname3(sv, gv, sv == (const SV*)gv ? "*" : "");
 577 }
 578
 579 /* compatibility with versions <= 5.003. */
 580 void
 581 Perl_gv_efullname(pTHX_ SV *sv, const GV *gv)
 582 {
 583     PERL_ARGS_ASSERT_GV_EFULLNAME;
 584
 585     gv_efullname3(sv, gv, sv == (const SV*)gv ? "*" : "");
 586 }
 587
 588 void
 589 Perl_gv_fullname3(pTHX_ SV *sv, const GV *gv, const char *prefix)
 590 {
 591     PERL_ARGS_ASSERT_GV_FULLNAME3;
 592
 593     gv_fullname4(sv, gv, prefix, TRUE);
 594 }
 595
 596 void
 597 Perl_gv_efullname3(pTHX_ SV *sv, const GV *gv, const char *prefix)
 598 {
 599     PERL_ARGS_ASSERT_GV_EFULLNAME3;
 600
 601     gv_efullname4(sv, gv, prefix, TRUE);
 602 }
 603
 604 /*
 605 =for apidoc gv_fetchmethod
 606
 607 See L</gv_fetchmethod_autoload>.
 608
 609 =cut
 610 */
 611
 612 GV *
 613 Perl_gv_fetchmethod(pTHX_ HV *stash, const char *name)
 614 {
 615     PERL_ARGS_ASSERT_GV_FETCHMETHOD;
 616
 617     return gv_fetchmethod_autoload(stash, name, TRUE);
 618 }
 619
 620 HE *
 621 Perl_hv_iternext(pTHX_ HV *hv)
 622 {
 623     PERL_ARGS_ASSERT_HV_ITERNEXT;
 624
 625     return hv_iternext_flags(hv, 0);
 626 }
 627
 628 void
 629 Perl_hv_magic(pTHX_ HV *hv, GV *gv, int how)
 630 {
 631     PERL_ARGS_ASSERT_HV_MAGIC;
 632
 633     sv_magic(MUTABLE_SV(hv), MUTABLE_SV(gv), how, NULL, 0);
 634 }
 635
 636 bool
 637 Perl_do_open(pTHX_ GV *gv, register const char *name, I32 len, int as_raw,
 638              int rawmode, int rawperm, PerlIO *supplied_fp)
 639 {
 640     PERL_ARGS_ASSERT_DO_OPEN;
 641
 642     return do_openn(gv, name, len, as_raw, rawmode, rawperm,
 643                     supplied_fp, (SV **) NULL, 0);
 644 }
 645
 646 bool
 647 Perl_do_open9(pTHX_ GV *gv, register const char *name, I32 len, int
 648 as_raw,
 649               int rawmode, int rawperm, PerlIO *supplied_fp, SV *svs,
 650               I32 num_svs)
 651 {
 652     PERL_ARGS_ASSERT_DO_OPEN9;
 653
 654     PERL_UNUSED_ARG(num_svs);
 655     return do_openn(gv, name, len, as_raw, rawmode, rawperm,
 656                     supplied_fp, &svs, 1);
 657 }
 658
 659 int
 660 Perl_do_binmode(pTHX_ PerlIO *fp, int iotype, int mode)
 661 {
 662  /* The old body of this is now in non-LAYER part of perlio.c
 663   * This is a stub for any XS code which might have been calling it.
 664   */
 665  const char *name = ":raw";
 666
 667  PERL_ARGS_ASSERT_DO_BINMODE;
 668
 669 #ifdef PERLIO_USING_CRLF
 670  if (!(mode & O_BINARY))
 671      name = ":crlf";
 672 #endif
 673  return PerlIO_binmode(aTHX_ fp, iotype, mode, name);
 674 }
 675
 676 #ifndef OS2
 677 bool
 678 Perl_do_aexec(pTHX_ SV *really, register SV **mark, register SV **sp)
 679 {
 680     PERL_ARGS_ASSERT_DO_AEXEC;
 681
 682     return do_aexec5(really, mark, sp, 0, 0);
 683 }
 684 #endif
 685
 686 #ifdef PERL_DEFAULT_DO_EXEC3_IMPLEMENTATION
 687 bool
 688 Perl_do_exec(pTHX_ const char *cmd)
 689 {
 690     PERL_ARGS_ASSERT_DO_EXEC;
 691
 692     return do_exec3(cmd,0,0);
 693 }
 694 #endif
 695
 696 /* Backwards compatibility. */
 697 int
 698 Perl_init_i18nl14n(pTHX_ int printwarn)
 699 {
 700     return init_i18nl10n(printwarn);
 701 }
 702
 703 U8 *
 704 Perl_uvuni_to_utf8(pTHX_ U8 *d, UV uv)
 705 {
 706     PERL_ARGS_ASSERT_UVUNI_TO_UTF8;
 707
 708     return Perl_uvuni_to_utf8_flags(aTHX_ d, uv, 0);
 709 }
 710
 711 bool
 712 Perl_is_utf8_string_loc(pTHX_ const U8 *s, STRLEN len, const U8 **ep)
 713 {
 714     PERL_ARGS_ASSERT_IS_UTF8_STRING_LOC;
 715
 716     return is_utf8_string_loclen(s, len, ep, 0);
 717 }
 718
 719 /*
 720 =for apidoc sv_nolocking
 721
 722 Dummy routine which "locks" an SV when there is no locking module present.
 723 Exists to avoid test for a NULL function pointer and because it could
 724 potentially warn under some level of strict-ness.
 725
 726 "Superseded" by sv_nosharing().
 727
 728 =cut
 729 */
 730
 731 void
 732 Perl_sv_nolocking(pTHX_ SV *sv)
 733 {
 734     PERL_UNUSED_CONTEXT;
 735     PERL_UNUSED_ARG(sv);
 736 }
 737
 738
 739 /*
 740 =for apidoc sv_nounlocking
 741
 742 Dummy routine which "unlocks" an SV when there is no locking module present.
 743 Exists to avoid test for a NULL function pointer and because it could
 744 potentially warn under some level of strict-ness.
 745
 746 "Superseded" by sv_nosharing().
 747
 748 =cut
 749 */
 750
 751 void
 752 Perl_sv_nounlocking(pTHX_ SV *sv)
 753 {
 754     PERL_UNUSED_CONTEXT;
 755     PERL_UNUSED_ARG(sv);
 756 }
 757
 758 void
 759 Perl_save_long(pTHX_ long int *longp)
 760 {
 761     dVAR;
 762
 763     PERL_ARGS_ASSERT_SAVE_LONG;
 764
 765     SSCHECK(3);
 766     SSPUSHLONG(*longp);
 767     SSPUSHPTR(longp);
 768     SSPUSHUV(SAVEt_LONG);
 769 }
 770
 771 void
 772 Perl_save_iv(pTHX_ IV *ivp)
 773 {
 774     dVAR;
 775
 776     PERL_ARGS_ASSERT_SAVE_IV;
 777
 778     SSCHECK(3);
 779     SSPUSHIV(*ivp);
 780     SSPUSHPTR(ivp);
 781     SSPUSHUV(SAVEt_IV);
 782 }
 783
 784 void
 785 Perl_save_nogv(pTHX_ GV *gv)
 786 {
 787     dVAR;
 788
 789     PERL_ARGS_ASSERT_SAVE_NOGV;
 790
 791     SSCHECK(2);
 792     SSPUSHPTR(gv);
 793     SSPUSHUV(SAVEt_NSTAB);
 794 }
 795
 796 void
 797 Perl_save_list(pTHX_ register SV **sarg, I32 maxsarg)
 798 {
 799     dVAR;
 800     register I32 i;
 801
 802     PERL_ARGS_ASSERT_SAVE_LIST;
 803
 804     for (i = 1; i <= maxsarg; i++) {
 805         register SV * const sv = newSV(0);
 806         sv_setsv(sv,sarg[i]);
 807         SSCHECK(3);
 808         SSPUSHPTR(sarg[i]);             /* remember the pointer */
 809         SSPUSHPTR(sv);                  /* remember the value */
 810         SSPUSHUV(SAVEt_ITEM);
 811     }
 812 }
 813
 814 /*
 815 =for apidoc sv_usepvn_mg
 816
 817 Like C<sv_usepvn>, but also handles 'set' magic.
 818
 819 =cut
 820 */
 821
 822 void
 823 Perl_sv_usepvn_mg(pTHX_ SV *sv, char *ptr, STRLEN len)
 824 {
 825     PERL_ARGS_ASSERT_SV_USEPVN_MG;
 826
 827     sv_usepvn_flags(sv,ptr,len, SV_SMAGIC);
 828 }
 829
 830 /*
 831 =for apidoc sv_usepvn
 832
 833 Tells an SV to use C<ptr> to find its string value. Implemented by
 834 calling C<sv_usepvn_flags> with C<flags> of 0, hence does not handle 'set'
 835 magic. See C<sv_usepvn_flags>.
 836
 837 =cut
 838 */
 839
 840 void
 841 Perl_sv_usepvn(pTHX_ SV *sv, char *ptr, STRLEN len)
 842 {
 843     PERL_ARGS_ASSERT_SV_USEPVN;
 844
 845     sv_usepvn_flags(sv,ptr,len, 0);
 846 }
 847
 848 /*
 849 =for apidoc unpack_str
 850
 851 The engine implementing unpack() Perl function. Note: parameters strbeg, new_s
 852 and ocnt are not used. This call should not be used, use unpackstring instead.
 853
 854 =cut */
 855
 856 I32
 857 Perl_unpack_str(pTHX_ const char *pat, const char *patend, const char *s,
 858                 const char *strbeg, const char *strend, char **new_s, I32 ocnt,
 859                 U32 flags)
 860 {
 861     PERL_ARGS_ASSERT_UNPACK_STR;
 862
 863     PERL_UNUSED_ARG(strbeg);
 864     PERL_UNUSED_ARG(new_s);
 865     PERL_UNUSED_ARG(ocnt);
 866
 867     return unpackstring(pat, patend, s, strend, flags);
 868 }
 869
 870 /*
 871 =for apidoc pack_cat
 872
 873 The engine implementing pack() Perl function. Note: parameters next_in_list and
 874 flags are not used. This call should not be used; use packlist instead.
 875
 876 =cut
 877 */
 878
 879 void
 880 Perl_pack_cat(pTHX_ SV *cat, const char *pat, const char *patend, register SV **beglist, SV **endlist, SV ***next_in_list, U32 flags)
 881 {
 882     PERL_ARGS_ASSERT_PACK_CAT;
 883
 884     PERL_UNUSED_ARG(next_in_list);
 885     PERL_UNUSED_ARG(flags);
 886
 887     packlist(cat, pat, patend, beglist, endlist);
 888 }
 889
 890 HE *
 891 Perl_hv_store_ent(pTHX_ HV *hv, SV *keysv, SV *val, U32 hash)
 892 {
 893   return (HE *)hv_common(hv, keysv, NULL, 0, 0, HV_FETCH_ISSTORE, val, hash);
 894 }
 895
 896 bool
 897 Perl_hv_exists_ent(pTHX_ HV *hv, SV *keysv, U32 hash)
 898 {
 899     PERL_ARGS_ASSERT_HV_EXISTS_ENT;
 900
 901     return hv_common(hv, keysv, NULL, 0, 0, HV_FETCH_ISEXISTS, 0, hash)
 902         ? TRUE : FALSE;
 903 }
 904
 905 HE *
 906 Perl_hv_fetch_ent(pTHX_ HV *hv, SV *keysv, I32 lval, U32 hash)
 907 {
 908     PERL_ARGS_ASSERT_HV_FETCH_ENT;
 909
 910     return (HE *)hv_common(hv, keysv, NULL, 0, 0,
 911                      (lval ? HV_FETCH_LVALUE : 0), NULL, hash);
 912 }
 913
 914 SV *
 915 Perl_hv_delete_ent(pTHX_ HV *hv, SV *keysv, I32 flags, U32 hash)
 916 {
 917     PERL_ARGS_ASSERT_HV_DELETE_ENT;
 918
 919     return MUTABLE_SV(hv_common(hv, keysv, NULL, 0, 0, flags | HV_DELETE, NULL,
 920                                 hash));
 921 }
 922
 923 SV**
 924 Perl_hv_store_flags(pTHX_ HV *hv, const char *key, I32 klen, SV *val, U32 hash,
 925                     int flags)
 926 {
 927     return (SV**) hv_common(hv, NULL, key, klen, flags,
 928                             (HV_FETCH_ISSTORE|HV_FETCH_JUST_SV), val, hash);
 929 }
 930
 931 SV**
 932 Perl_hv_store(pTHX_ HV *hv, const char *key, I32 klen_i32, SV *val, U32 hash)
 933 {
 934     STRLEN klen;
 935     int flags;
 936
 937     if (klen_i32 < 0) {
 938         klen = -klen_i32;
 939         flags = HVhek_UTF8;
 940     } else {
 941         klen = klen_i32;
 942         flags = 0;
 943     }
 944     return (SV **) hv_common(hv, NULL, key, klen, flags,
 945                              (HV_FETCH_ISSTORE|HV_FETCH_JUST_SV), val, hash);
 946 }
 947
 948 bool
 949 Perl_hv_exists(pTHX_ HV *hv, const char *key, I32 klen_i32)
 950 {
 951     STRLEN klen;
 952     int flags;
 953
 954     PERL_ARGS_ASSERT_HV_EXISTS;
 955
 956     if (klen_i32 < 0) {
 957         klen = -klen_i32;
 958         flags = HVhek_UTF8;
 959     } else {
 960         klen = klen_i32;
 961         flags = 0;
 962     }
 963     return hv_common(hv, NULL, key, klen, flags, HV_FETCH_ISEXISTS, 0, 0)
 964         ? TRUE : FALSE;
 965 }
 966
 967 SV**
 968 Perl_hv_fetch(pTHX_ HV *hv, const char *key, I32 klen_i32, I32 lval)
 969 {
 970     STRLEN klen;
 971     int flags;
 972
 973     PERL_ARGS_ASSERT_HV_FETCH;
 974
 975     if (klen_i32 < 0) {
 976         klen = -klen_i32;
 977         flags = HVhek_UTF8;
 978     } else {
 979         klen = klen_i32;
 980         flags = 0;
 981     }
 982     return (SV **) hv_common(hv, NULL, key, klen, flags,
 983                              lval ? (HV_FETCH_JUST_SV | HV_FETCH_LVALUE)
 984                              : HV_FETCH_JUST_SV, NULL, 0);
 985 }
 986
 987 SV *
 988 Perl_hv_delete(pTHX_ HV *hv, const char *key, I32 klen_i32, I32 flags)
 989 {
 990     STRLEN klen;
 991     int k_flags;
 992
 993     PERL_ARGS_ASSERT_HV_DELETE;
 994
 995     if (klen_i32 < 0) {
 996         klen = -klen_i32;
 997         k_flags = HVhek_UTF8;
 998     } else {
 999         klen = klen_i32;
1000         k_flags = 0;
1001     }
1002     return MUTABLE_SV(hv_common(hv, NULL, key, klen, k_flags, flags | HV_DELETE,
1003                                 NULL, 0));
1004 }
1005
1006 /* Functions after here were made mathoms post 5.10.0 but pre 5.8.9 */
1007
1008 AV *
1009 Perl_newAV(pTHX)
1010 {
1011     return MUTABLE_AV(newSV_type(SVt_PVAV));
1012     /* sv_upgrade does AvREAL_only():
1013     AvALLOC(av) = 0;
1014     AvARRAY(av) = NULL;
1015     AvMAX(av) = AvFILLp(av) = -1; */
1016 }
1017
1018 HV *
1019 Perl_newHV(pTHX)
1020 {
1021     HV * const hv = MUTABLE_HV(newSV_type(SVt_PVHV));
1022     assert(!SvOK(hv));
1023
1024     return hv;
1025 }
1026
1027 void
1028 Perl_sv_insert(pTHX_ SV *const bigstr, const STRLEN offset, const STRLEN len,
1029               const char *const little, const STRLEN littlelen)
1030 {
1031     PERL_ARGS_ASSERT_SV_INSERT;
1032     sv_insert_flags(bigstr, offset, len, little, littlelen, SV_GMAGIC);
1033 }
1034
1035 void
1036 Perl_save_freesv(pTHX_ SV *sv)
1037 {
1038     dVAR;
1039     save_freesv(sv);
1040 }
1041
1042 void
1043 Perl_save_mortalizesv(pTHX_ SV *sv)
1044 {
1045     dVAR;
1046
1047     PERL_ARGS_ASSERT_SAVE_MORTALIZESV;
1048
1049     save_mortalizesv(sv);
1050 }
1051
1052 void
1053 Perl_save_freeop(pTHX_ OP *o)
1054 {
1055     dVAR;
1056     save_freeop(o);
1057 }
1058
1059 void
1060 Perl_save_freepv(pTHX_ char *pv)
1061 {
1062     dVAR;
1063     save_freepv(pv);
1064 }
1065
1066 void
1067 Perl_save_op(pTHX)
1068 {
1069     dVAR;
1070     save_op();
1071 }
1072
1073 #ifdef PERL_DONT_CREATE_GVSV
1074 GV *
1075 Perl_gv_SVadd(pTHX_ GV *gv)
1076 {
1077     return gv_SVadd(gv);
1078 }
1079 #endif
1080
1081 GV *
1082 Perl_gv_AVadd(pTHX_ GV *gv)
1083 {
1084     return gv_AVadd(gv);
1085 }
1086
1087 GV *
1088 Perl_gv_HVadd(pTHX_ register GV *gv)
1089 {
1090     return gv_HVadd(gv);
1091 }
1092
1093 GV *
1094 Perl_gv_IOadd(pTHX_ register GV *gv)
1095 {
1096     return gv_IOadd(gv);
1097 }
1098
1099 IO *
1100 Perl_newIO(pTHX)
1101 {
1102     return MUTABLE_IO(newSV_type(SVt_PVIO));
1103 }
1104
1105 I32
1106 Perl_my_stat(pTHX)
1107 {
1108     return my_stat_flags(SV_GMAGIC);
1109 }
1110
1111 I32
1112 Perl_my_lstat(pTHX)
1113 {
1114     return my_lstat_flags(SV_GMAGIC);
1115 }
1116
1117 I32
1118 Perl_sv_eq(pTHX_ register SV *sv1, register SV *sv2)
1119 {
1120     return sv_eq_flags(sv1, sv2, SV_GMAGIC);
1121 }
1122
1123 #ifdef USE_LOCALE_COLLATE
1124 char *
1125 Perl_sv_collxfrm(pTHX_ SV *const sv, STRLEN *const nxp)
1126 {
1127     return sv_collxfrm_flags(sv, nxp, SV_GMAGIC);
1128 }
1129 #endif
1130
1131 bool
1132 Perl_sv_2bool(pTHX_ register SV *const sv)
1133 {
1134     return sv_2bool_flags(sv, SV_GMAGIC);
1135 }
1136
1137
1138 /*
1139 =for apidoc custom_op_name
1140 Return the name for a given custom op. This was once used by the OP_NAME
1141 macro, but is no longer: it has only been kept for compatibility, and
1142 should not be used.
1143
1144 =for apidoc custom_op_desc
1145 Return the description of a given custom op. This was once used by the
1146 OP_DESC macro, but is no longer: it has only been kept for
1147 compatibility, and should not be used.
1148
1149 =cut
1150 */
1151
1152 const char*
1153 Perl_custom_op_name(pTHX_ const OP* o)
1154 {
1155     PERL_ARGS_ASSERT_CUSTOM_OP_NAME;
1156     return XopENTRY(Perl_custom_op_xop(aTHX_ o), xop_name);
1157 }
1158
1159 const char*
1160 Perl_custom_op_desc(pTHX_ const OP* o)
1161 {
1162     PERL_ARGS_ASSERT_CUSTOM_OP_DESC;
1163     return XopENTRY(Perl_custom_op_xop(aTHX_ o), xop_desc);
1164 }
1165
1166 CV *
1167 Perl_newSUB(pTHX_ I32 floor, OP *o, OP *proto, OP *block)
1168 {
1169     return Perl_newATTRSUB(aTHX_ floor, o, proto, NULL, block);
1170 }
1171 #endif /* NO_MATHOMS */
1172
1173 /*
1174  * Local variables:
1175  * c-indentation-style: bsd
1176  * c-basic-offset: 4
1177  * indent-tabs-mode: t
1178  * End:
1179  *
1180  * ex: set ts=8 sts=4 sw=4 noet:
1181  */