3 * Copyright (C) 2005, 2006, 2007, 2008, 2009, 2010,
4 * 2011, 2012 by Larry Wall and others
6 * You may distribute under the terms of either the GNU General Public
7 * License or the Artistic License, as specified in the README file.
12 * Anything that Hobbits had no immediate use for, but were unwilling to
13 * throw away, they called a mathom. Their dwellings were apt to become
14 * rather crowded with mathoms, and many of the presents that passed from
15 * hand to hand were of that sort.
17 * [p.5 of _The Lord of the Rings_: "Prologue"]
23 * This file contains mathoms, various binary artifacts from previous
24 * versions of Perl. For binary or source compatibility reasons, though,
25 * we cannot completely remove them from the core code.
29 * The compilation of this file can be suppressed; see INSTALL
34 #define PERL_IN_MATHOMS_C
38 /* ..." warning: ISO C forbids an empty source file"
39 So make sure we have something in here by processing the headers anyway.
43 /* Not all of these have prototypes elsewhere, so do this to get
48 PERL_CALLCONV OP * Perl_ref(pTHX_ OP *o, I32 type);
49 PERL_CALLCONV void Perl_sv_unref(pTHX_ SV *sv);
50 PERL_CALLCONV void Perl_sv_taint(pTHX_ SV *sv);
51 PERL_CALLCONV IV Perl_sv_2iv(pTHX_ SV *sv);
52 PERL_CALLCONV UV Perl_sv_2uv(pTHX_ SV *sv);
53 PERL_CALLCONV NV Perl_sv_2nv(pTHX_ SV *sv);
54 PERL_CALLCONV char * Perl_sv_2pv(pTHX_ SV *sv, STRLEN *lp);
55 PERL_CALLCONV char * Perl_sv_2pv_nolen(pTHX_ SV *sv);
56 PERL_CALLCONV char * Perl_sv_2pvbyte_nolen(pTHX_ SV *sv);
57 PERL_CALLCONV char * Perl_sv_2pvutf8_nolen(pTHX_ SV *sv);
58 PERL_CALLCONV void Perl_sv_force_normal(pTHX_ SV *sv);
59 PERL_CALLCONV void Perl_sv_setsv(pTHX_ SV *dstr, SV *sstr);
60 PERL_CALLCONV void Perl_sv_catpvn(pTHX_ SV *dsv, const char* sstr, STRLEN slen);
61 PERL_CALLCONV void Perl_sv_catpvn_mg(pTHX_ SV *sv, const char *ptr, STRLEN len);
62 PERL_CALLCONV void Perl_sv_catsv(pTHX_ SV *dstr, SV *sstr);
63 PERL_CALLCONV void Perl_sv_catsv_mg(pTHX_ SV *dsv, SV *ssv);
64 PERL_CALLCONV char * Perl_sv_pv(pTHX_ SV *sv);
65 PERL_CALLCONV char * Perl_sv_pvn_force(pTHX_ SV *sv, STRLEN *lp);
66 PERL_CALLCONV char * Perl_sv_pvbyte(pTHX_ SV *sv);
67 PERL_CALLCONV char * Perl_sv_pvutf8(pTHX_ SV *sv);
68 PERL_CALLCONV STRLEN Perl_sv_utf8_upgrade(pTHX_ SV *sv);
69 PERL_CALLCONV NV Perl_huge(void);
70 PERL_CALLCONV void Perl_gv_fullname3(pTHX_ SV *sv, const GV *gv, const char *prefix);
71 PERL_CALLCONV void Perl_gv_efullname3(pTHX_ SV *sv, const GV *gv, const char *prefix);
72 PERL_CALLCONV GV * Perl_gv_fetchmethod(pTHX_ HV *stash, const char *name);
73 PERL_CALLCONV HE * Perl_hv_iternext(pTHX_ HV *hv);
74 PERL_CALLCONV void Perl_hv_magic(pTHX_ HV *hv, GV *gv, int how);
75 PERL_CALLCONV bool Perl_do_open(pTHX_ GV *gv, const char *name, I32 len, int as_raw, int rawmode, int rawperm, PerlIO *supplied_fp);
76 PERL_CALLCONV bool Perl_do_aexec(pTHX_ SV *really, SV **mark, SV **sp);
77 PERL_CALLCONV U8 * Perl_uvuni_to_utf8(pTHX_ U8 *d, UV uv);
78 PERL_CALLCONV bool Perl_is_utf8_string_loc(pTHX_ const U8 *s, STRLEN len, const U8 **ep);
79 PERL_CALLCONV void Perl_sv_nolocking(pTHX_ SV *sv);
80 PERL_CALLCONV void Perl_sv_usepvn_mg(pTHX_ SV *sv, char *ptr, STRLEN len);
81 PERL_CALLCONV void Perl_sv_usepvn(pTHX_ SV *sv, char *ptr, STRLEN len);
82 PERL_CALLCONV int Perl_fprintf_nocontext(PerlIO *stream, const char *format, ...);
83 PERL_CALLCONV int Perl_printf_nocontext(const char *format, ...);
84 PERL_CALLCONV int Perl_magic_setglob(pTHX_ SV* sv, MAGIC* mg);
85 PERL_CALLCONV AV * Perl_newAV(pTHX);
86 PERL_CALLCONV HV * Perl_newHV(pTHX);
87 PERL_CALLCONV IO * Perl_newIO(pTHX);
88 PERL_CALLCONV I32 Perl_my_stat(pTHX);
89 PERL_CALLCONV I32 Perl_my_lstat(pTHX);
90 PERL_CALLCONV I32 Perl_sv_eq(pTHX_ SV *sv1, SV *sv2);
91 PERL_CALLCONV char * Perl_sv_collxfrm(pTHX_ SV *const sv, STRLEN *const nxp);
92 PERL_CALLCONV bool Perl_sv_2bool(pTHX_ SV *const sv);
93 PERL_CALLCONV CV * Perl_newSUB(pTHX_ I32 floor, OP* o, OP* proto, OP* block);
94 PERL_CALLCONV UV Perl_to_utf8_lower(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp);
95 PERL_CALLCONV UV Perl_to_utf8_title(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp);
96 PERL_CALLCONV UV Perl_to_utf8_upper(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp);
97 PERL_CALLCONV UV Perl_to_utf8_fold(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp);
98 PERL_CALLCONV SV *Perl_sv_mortalcopy(pTHX_ SV *const oldstr);
100 /* ref() is now a macro using Perl_doref;
101 * this version provided for binary compatibility only.
104 Perl_ref(pTHX_ OP *o, I32 type)
106 return doref(o, type, TRUE);
112 Unsets the RV status of the SV, and decrements the reference count of
113 whatever was being referenced by the RV. This can almost be thought of
114 as a reversal of C<newSVrv>. This is C<sv_unref_flags> with the C<flag>
115 being zero. See C<SvROK_off>.
121 Perl_sv_unref(pTHX_ SV *sv)
123 PERL_ARGS_ASSERT_SV_UNREF;
125 sv_unref_flags(sv, 0);
131 Taint an SV. Use C<SvTAINTED_on> instead.
137 Perl_sv_taint(pTHX_ SV *sv)
139 PERL_ARGS_ASSERT_SV_TAINT;
141 sv_magic((sv), NULL, PERL_MAGIC_taint, NULL, 0);
144 /* sv_2iv() is now a macro using Perl_sv_2iv_flags();
145 * this function provided for binary compatibility only
149 Perl_sv_2iv(pTHX_ SV *sv)
151 return sv_2iv_flags(sv, SV_GMAGIC);
154 /* sv_2uv() is now a macro using Perl_sv_2uv_flags();
155 * this function provided for binary compatibility only
159 Perl_sv_2uv(pTHX_ SV *sv)
161 return sv_2uv_flags(sv, SV_GMAGIC);
164 /* sv_2nv() is now a macro using Perl_sv_2nv_flags();
165 * this function provided for binary compatibility only
169 Perl_sv_2nv(pTHX_ SV *sv)
171 return sv_2nv_flags(sv, SV_GMAGIC);
175 /* sv_2pv() is now a macro using Perl_sv_2pv_flags();
176 * this function provided for binary compatibility only
180 Perl_sv_2pv(pTHX_ SV *sv, STRLEN *lp)
182 return sv_2pv_flags(sv, lp, SV_GMAGIC);
186 =for apidoc sv_2pv_nolen
188 Like C<sv_2pv()>, but doesn't return the length too. You should usually
189 use the macro wrapper C<SvPV_nolen(sv)> instead.
195 Perl_sv_2pv_nolen(pTHX_ SV *sv)
197 PERL_ARGS_ASSERT_SV_2PV_NOLEN;
198 return sv_2pv(sv, NULL);
202 =for apidoc sv_2pvbyte_nolen
204 Return a pointer to the byte-encoded representation of the SV.
205 May cause the SV to be downgraded from UTF-8 as a side-effect.
207 Usually accessed via the C<SvPVbyte_nolen> macro.
213 Perl_sv_2pvbyte_nolen(pTHX_ SV *sv)
215 PERL_ARGS_ASSERT_SV_2PVBYTE_NOLEN;
217 return sv_2pvbyte(sv, NULL);
221 =for apidoc sv_2pvutf8_nolen
223 Return a pointer to the UTF-8-encoded representation of the SV.
224 May cause the SV to be upgraded to UTF-8 as a side-effect.
226 Usually accessed via the C<SvPVutf8_nolen> macro.
232 Perl_sv_2pvutf8_nolen(pTHX_ SV *sv)
234 PERL_ARGS_ASSERT_SV_2PVUTF8_NOLEN;
236 return sv_2pvutf8(sv, NULL);
240 =for apidoc sv_force_normal
242 Undo various types of fakery on an SV: if the PV is a shared string, make
243 a private copy; if we're a ref, stop refing; if we're a glob, downgrade to
244 an xpvmg. See also C<sv_force_normal_flags>.
250 Perl_sv_force_normal(pTHX_ SV *sv)
252 PERL_ARGS_ASSERT_SV_FORCE_NORMAL;
254 sv_force_normal_flags(sv, 0);
257 /* sv_setsv() is now a macro using Perl_sv_setsv_flags();
258 * this function provided for binary compatibility only
262 Perl_sv_setsv(pTHX_ SV *dstr, SV *sstr)
264 PERL_ARGS_ASSERT_SV_SETSV;
266 sv_setsv_flags(dstr, sstr, SV_GMAGIC);
269 /* sv_catpvn() is now a macro using Perl_sv_catpvn_flags();
270 * this function provided for binary compatibility only
274 Perl_sv_catpvn(pTHX_ SV *dsv, const char* sstr, STRLEN slen)
276 PERL_ARGS_ASSERT_SV_CATPVN;
278 sv_catpvn_flags(dsv, sstr, slen, SV_GMAGIC);
282 =for apidoc sv_catpvn_mg
284 Like C<sv_catpvn>, but also handles 'set' magic.
290 Perl_sv_catpvn_mg(pTHX_ SV *sv, const char *ptr, STRLEN len)
292 PERL_ARGS_ASSERT_SV_CATPVN_MG;
294 sv_catpvn_flags(sv,ptr,len,SV_GMAGIC|SV_SMAGIC);
297 /* sv_catsv() is now a macro using Perl_sv_catsv_flags();
298 * this function provided for binary compatibility only
302 Perl_sv_catsv(pTHX_ SV *dstr, SV *sstr)
304 PERL_ARGS_ASSERT_SV_CATSV;
306 sv_catsv_flags(dstr, sstr, SV_GMAGIC);
310 =for apidoc sv_catsv_mg
312 Like C<sv_catsv>, but also handles 'set' magic.
318 Perl_sv_catsv_mg(pTHX_ SV *dsv, SV *ssv)
320 PERL_ARGS_ASSERT_SV_CATSV_MG;
322 sv_catsv_flags(dsv,ssv,SV_GMAGIC|SV_SMAGIC);
328 A private implementation of the C<SvIVx> macro for compilers which can't
329 cope with complex macro expressions. Always use the macro instead.
335 Perl_sv_iv(pTHX_ SV *sv)
337 PERL_ARGS_ASSERT_SV_IV;
341 return (IV)SvUVX(sv);
350 A private implementation of the C<SvUVx> macro for compilers which can't
351 cope with complex macro expressions. Always use the macro instead.
357 Perl_sv_uv(pTHX_ SV *sv)
359 PERL_ARGS_ASSERT_SV_UV;
364 return (UV)SvIVX(sv);
372 A private implementation of the C<SvNVx> macro for compilers which can't
373 cope with complex macro expressions. Always use the macro instead.
379 Perl_sv_nv(pTHX_ SV *sv)
381 PERL_ARGS_ASSERT_SV_NV;
391 Use the C<SvPV_nolen> macro instead
395 A private implementation of the C<SvPV> macro for compilers which can't
396 cope with complex macro expressions. Always use the macro instead.
402 Perl_sv_pvn(pTHX_ SV *sv, STRLEN *lp)
404 PERL_ARGS_ASSERT_SV_PVN;
410 return sv_2pv(sv, lp);
415 Perl_sv_pvn_nomg(pTHX_ SV *sv, STRLEN *lp)
417 PERL_ARGS_ASSERT_SV_PVN_NOMG;
423 return sv_2pv_flags(sv, lp, 0);
426 /* sv_pv() is now a macro using SvPV_nolen();
427 * this function provided for binary compatibility only
431 Perl_sv_pv(pTHX_ SV *sv)
433 PERL_ARGS_ASSERT_SV_PV;
438 return sv_2pv(sv, NULL);
441 /* sv_pvn_force() is now a macro using Perl_sv_pvn_force_flags();
442 * this function provided for binary compatibility only
446 Perl_sv_pvn_force(pTHX_ SV *sv, STRLEN *lp)
448 PERL_ARGS_ASSERT_SV_PVN_FORCE;
450 return sv_pvn_force_flags(sv, lp, SV_GMAGIC);
453 /* sv_pvbyte () is now a macro using Perl_sv_2pv_flags();
454 * this function provided for binary compatibility only
458 Perl_sv_pvbyte(pTHX_ SV *sv)
460 PERL_ARGS_ASSERT_SV_PVBYTE;
462 sv_utf8_downgrade(sv, FALSE);
467 =for apidoc sv_pvbyte
469 Use C<SvPVbyte_nolen> instead.
471 =for apidoc sv_pvbyten
473 A private implementation of the C<SvPVbyte> macro for compilers
474 which can't cope with complex macro expressions. Always use the macro
481 Perl_sv_pvbyten(pTHX_ SV *sv, STRLEN *lp)
483 PERL_ARGS_ASSERT_SV_PVBYTEN;
485 sv_utf8_downgrade(sv, FALSE);
486 return sv_pvn(sv,lp);
489 /* sv_pvutf8 () is now a macro using Perl_sv_2pv_flags();
490 * this function provided for binary compatibility only
494 Perl_sv_pvutf8(pTHX_ SV *sv)
496 PERL_ARGS_ASSERT_SV_PVUTF8;
503 =for apidoc sv_pvutf8
505 Use the C<SvPVutf8_nolen> macro instead
507 =for apidoc sv_pvutf8n
509 A private implementation of the C<SvPVutf8> macro for compilers
510 which can't cope with complex macro expressions. Always use the macro
517 Perl_sv_pvutf8n(pTHX_ SV *sv, STRLEN *lp)
519 PERL_ARGS_ASSERT_SV_PVUTF8N;
522 return sv_pvn(sv,lp);
525 /* sv_utf8_upgrade() is now a macro using sv_utf8_upgrade_flags();
526 * this function provided for binary compatibility only
530 Perl_sv_utf8_upgrade(pTHX_ SV *sv)
532 PERL_ARGS_ASSERT_SV_UTF8_UPGRADE;
534 return sv_utf8_upgrade_flags(sv, SV_GMAGIC);
538 Perl_fprintf_nocontext(PerlIO *stream, const char *format, ...)
543 /* Easier to special case this here than in embed.pl. (Look at what it
544 generates for proto.h) */
545 #ifdef PERL_IMPLICIT_CONTEXT
546 PERL_ARGS_ASSERT_FPRINTF_NOCONTEXT;
549 va_start(arglist, format);
550 return PerlIO_vprintf(stream, format, arglist);
554 Perl_printf_nocontext(const char *format, ...)
559 #ifdef PERL_IMPLICIT_CONTEXT
560 PERL_ARGS_ASSERT_PRINTF_NOCONTEXT;
563 va_start(arglist, format);
564 return PerlIO_vprintf(PerlIO_stdout(), format, arglist);
567 #if defined(HUGE_VAL) || (defined(USE_LONG_DOUBLE) && defined(HUGE_VALL))
569 * This hack is to force load of "huge" support from libm.a
570 * So it is in perl for (say) POSIX to use.
571 * Needed for SunOS with Sun's 'acc' for example.
576 # if defined(USE_LONG_DOUBLE) && defined(HUGE_VALL)
584 /* compatibility with versions <= 5.003. */
586 Perl_gv_fullname(pTHX_ SV *sv, const GV *gv)
588 PERL_ARGS_ASSERT_GV_FULLNAME;
590 gv_fullname3(sv, gv, sv == (const SV*)gv ? "*" : "");
593 /* compatibility with versions <= 5.003. */
595 Perl_gv_efullname(pTHX_ SV *sv, const GV *gv)
597 PERL_ARGS_ASSERT_GV_EFULLNAME;
599 gv_efullname3(sv, gv, sv == (const SV*)gv ? "*" : "");
603 Perl_gv_fullname3(pTHX_ SV *sv, const GV *gv, const char *prefix)
605 PERL_ARGS_ASSERT_GV_FULLNAME3;
607 gv_fullname4(sv, gv, prefix, TRUE);
611 Perl_gv_efullname3(pTHX_ SV *sv, const GV *gv, const char *prefix)
613 PERL_ARGS_ASSERT_GV_EFULLNAME3;
615 gv_efullname4(sv, gv, prefix, TRUE);
619 =for apidoc gv_fetchmethod
621 See L</gv_fetchmethod_autoload>.
627 Perl_gv_fetchmethod(pTHX_ HV *stash, const char *name)
629 PERL_ARGS_ASSERT_GV_FETCHMETHOD;
631 return gv_fetchmethod_autoload(stash, name, TRUE);
635 Perl_hv_iternext(pTHX_ HV *hv)
637 PERL_ARGS_ASSERT_HV_ITERNEXT;
639 return hv_iternext_flags(hv, 0);
643 Perl_hv_magic(pTHX_ HV *hv, GV *gv, int how)
645 PERL_ARGS_ASSERT_HV_MAGIC;
647 sv_magic(MUTABLE_SV(hv), MUTABLE_SV(gv), how, NULL, 0);
651 Perl_do_open(pTHX_ GV *gv, const char *name, I32 len, int as_raw,
652 int rawmode, int rawperm, PerlIO *supplied_fp)
654 PERL_ARGS_ASSERT_DO_OPEN;
656 return do_openn(gv, name, len, as_raw, rawmode, rawperm,
657 supplied_fp, (SV **) NULL, 0);
661 Perl_do_open9(pTHX_ GV *gv, const char *name, I32 len, int
663 int rawmode, int rawperm, PerlIO *supplied_fp, SV *svs,
666 PERL_ARGS_ASSERT_DO_OPEN9;
668 PERL_UNUSED_ARG(num_svs);
669 return do_openn(gv, name, len, as_raw, rawmode, rawperm,
670 supplied_fp, &svs, 1);
674 Perl_do_binmode(pTHX_ PerlIO *fp, int iotype, int mode)
676 /* The old body of this is now in non-LAYER part of perlio.c
677 * This is a stub for any XS code which might have been calling it.
679 const char *name = ":raw";
681 PERL_ARGS_ASSERT_DO_BINMODE;
683 #ifdef PERLIO_USING_CRLF
684 if (!(mode & O_BINARY))
687 return PerlIO_binmode(aTHX_ fp, iotype, mode, name);
692 Perl_do_aexec(pTHX_ SV *really, SV **mark, SV **sp)
694 PERL_ARGS_ASSERT_DO_AEXEC;
696 return do_aexec5(really, mark, sp, 0, 0);
700 /* Backwards compatibility. */
702 Perl_init_i18nl14n(pTHX_ int printwarn)
704 return init_i18nl10n(printwarn);
708 Perl_uvuni_to_utf8(pTHX_ U8 *d, UV uv)
710 PERL_ARGS_ASSERT_UVUNI_TO_UTF8;
712 return Perl_uvoffuni_to_utf8_flags(aTHX_ d, uv, 0);
716 Perl_is_utf8_string_loc(pTHX_ const U8 *s, STRLEN len, const U8 **ep)
718 PERL_ARGS_ASSERT_IS_UTF8_STRING_LOC;
720 return is_utf8_string_loclen(s, len, ep, 0);
724 =for apidoc sv_nolocking
726 Dummy routine which "locks" an SV when there is no locking module present.
727 Exists to avoid test for a NULL function pointer and because it could
728 potentially warn under some level of strict-ness.
730 "Superseded" by sv_nosharing().
736 Perl_sv_nolocking(pTHX_ SV *sv)
744 =for apidoc sv_nounlocking
746 Dummy routine which "unlocks" an SV when there is no locking module present.
747 Exists to avoid test for a NULL function pointer and because it could
748 potentially warn under some level of strict-ness.
750 "Superseded" by sv_nosharing().
756 Perl_sv_nounlocking(pTHX_ SV *sv)
763 Perl_save_long(pTHX_ long int *longp)
767 PERL_ARGS_ASSERT_SAVE_LONG;
772 SSPUSHUV(SAVEt_LONG);
776 Perl_save_iv(pTHX_ IV *ivp)
780 PERL_ARGS_ASSERT_SAVE_IV;
789 Perl_save_nogv(pTHX_ GV *gv)
793 PERL_ARGS_ASSERT_SAVE_NOGV;
797 SSPUSHUV(SAVEt_NSTAB);
801 Perl_save_list(pTHX_ SV **sarg, I32 maxsarg)
806 PERL_ARGS_ASSERT_SAVE_LIST;
808 for (i = 1; i <= maxsarg; i++) {
812 sv_setsv_nomg(sv,sarg[i]);
814 SSPUSHPTR(sarg[i]); /* remember the pointer */
815 SSPUSHPTR(sv); /* remember the value */
816 SSPUSHUV(SAVEt_ITEM);
821 =for apidoc sv_usepvn_mg
823 Like C<sv_usepvn>, but also handles 'set' magic.
829 Perl_sv_usepvn_mg(pTHX_ SV *sv, char *ptr, STRLEN len)
831 PERL_ARGS_ASSERT_SV_USEPVN_MG;
833 sv_usepvn_flags(sv,ptr,len, SV_SMAGIC);
837 =for apidoc sv_usepvn
839 Tells an SV to use C<ptr> to find its string value. Implemented by
840 calling C<sv_usepvn_flags> with C<flags> of 0, hence does not handle 'set'
841 magic. See C<sv_usepvn_flags>.
847 Perl_sv_usepvn(pTHX_ SV *sv, char *ptr, STRLEN len)
849 PERL_ARGS_ASSERT_SV_USEPVN;
851 sv_usepvn_flags(sv,ptr,len, 0);
855 =for apidoc unpack_str
857 The engine implementing unpack() Perl function. Note: parameters strbeg, new_s
858 and ocnt are not used. This call should not be used, use unpackstring instead.
863 Perl_unpack_str(pTHX_ const char *pat, const char *patend, const char *s,
864 const char *strbeg, const char *strend, char **new_s, I32 ocnt,
867 PERL_ARGS_ASSERT_UNPACK_STR;
869 PERL_UNUSED_ARG(strbeg);
870 PERL_UNUSED_ARG(new_s);
871 PERL_UNUSED_ARG(ocnt);
873 return unpackstring(pat, patend, s, strend, flags);
879 The engine implementing pack() Perl function. Note: parameters next_in_list and
880 flags are not used. This call should not be used; use packlist instead.
886 Perl_pack_cat(pTHX_ SV *cat, const char *pat, const char *patend, SV **beglist, SV **endlist, SV ***next_in_list, U32 flags)
888 PERL_ARGS_ASSERT_PACK_CAT;
890 PERL_UNUSED_ARG(next_in_list);
891 PERL_UNUSED_ARG(flags);
893 packlist(cat, pat, patend, beglist, endlist);
897 Perl_hv_store_ent(pTHX_ HV *hv, SV *keysv, SV *val, U32 hash)
899 return (HE *)hv_common(hv, keysv, NULL, 0, 0, HV_FETCH_ISSTORE, val, hash);
903 Perl_hv_exists_ent(pTHX_ HV *hv, SV *keysv, U32 hash)
905 PERL_ARGS_ASSERT_HV_EXISTS_ENT;
907 return hv_common(hv, keysv, NULL, 0, 0, HV_FETCH_ISEXISTS, 0, hash)
912 Perl_hv_fetch_ent(pTHX_ HV *hv, SV *keysv, I32 lval, U32 hash)
914 PERL_ARGS_ASSERT_HV_FETCH_ENT;
916 return (HE *)hv_common(hv, keysv, NULL, 0, 0,
917 (lval ? HV_FETCH_LVALUE : 0), NULL, hash);
921 Perl_hv_delete_ent(pTHX_ HV *hv, SV *keysv, I32 flags, U32 hash)
923 PERL_ARGS_ASSERT_HV_DELETE_ENT;
925 return MUTABLE_SV(hv_common(hv, keysv, NULL, 0, 0, flags | HV_DELETE, NULL,
930 Perl_hv_store_flags(pTHX_ HV *hv, const char *key, I32 klen, SV *val, U32 hash,
933 return (SV**) hv_common(hv, NULL, key, klen, flags,
934 (HV_FETCH_ISSTORE|HV_FETCH_JUST_SV), val, hash);
938 Perl_hv_store(pTHX_ HV *hv, const char *key, I32 klen_i32, SV *val, U32 hash)
950 return (SV **) hv_common(hv, NULL, key, klen, flags,
951 (HV_FETCH_ISSTORE|HV_FETCH_JUST_SV), val, hash);
955 Perl_hv_exists(pTHX_ HV *hv, const char *key, I32 klen_i32)
960 PERL_ARGS_ASSERT_HV_EXISTS;
969 return hv_common(hv, NULL, key, klen, flags, HV_FETCH_ISEXISTS, 0, 0)
974 Perl_hv_fetch(pTHX_ HV *hv, const char *key, I32 klen_i32, I32 lval)
979 PERL_ARGS_ASSERT_HV_FETCH;
988 return (SV **) hv_common(hv, NULL, key, klen, flags,
989 lval ? (HV_FETCH_JUST_SV | HV_FETCH_LVALUE)
990 : HV_FETCH_JUST_SV, NULL, 0);
994 Perl_hv_delete(pTHX_ HV *hv, const char *key, I32 klen_i32, I32 flags)
999 PERL_ARGS_ASSERT_HV_DELETE;
1003 k_flags = HVhek_UTF8;
1008 return MUTABLE_SV(hv_common(hv, NULL, key, klen, k_flags, flags | HV_DELETE,
1012 /* Functions after here were made mathoms post 5.10.0 but pre 5.8.9 */
1017 return MUTABLE_AV(newSV_type(SVt_PVAV));
1018 /* sv_upgrade does AvREAL_only():
1021 AvMAX(av) = AvFILLp(av) = -1; */
1027 HV * const hv = MUTABLE_HV(newSV_type(SVt_PVHV));
1034 Perl_sv_insert(pTHX_ SV *const bigstr, const STRLEN offset, const STRLEN len,
1035 const char *const little, const STRLEN littlelen)
1037 PERL_ARGS_ASSERT_SV_INSERT;
1038 sv_insert_flags(bigstr, offset, len, little, littlelen, SV_GMAGIC);
1042 Perl_save_freesv(pTHX_ SV *sv)
1049 Perl_save_mortalizesv(pTHX_ SV *sv)
1053 PERL_ARGS_ASSERT_SAVE_MORTALIZESV;
1055 save_mortalizesv(sv);
1059 Perl_save_freeop(pTHX_ OP *o)
1066 Perl_save_freepv(pTHX_ char *pv)
1079 #ifdef PERL_DONT_CREATE_GVSV
1081 Perl_gv_SVadd(pTHX_ GV *gv)
1083 return gv_SVadd(gv);
1088 Perl_gv_AVadd(pTHX_ GV *gv)
1090 return gv_AVadd(gv);
1094 Perl_gv_HVadd(pTHX_ GV *gv)
1096 return gv_HVadd(gv);
1100 Perl_gv_IOadd(pTHX_ GV *gv)
1102 return gv_IOadd(gv);
1108 return MUTABLE_IO(newSV_type(SVt_PVIO));
1114 return my_stat_flags(SV_GMAGIC);
1120 return my_lstat_flags(SV_GMAGIC);
1124 Perl_sv_eq(pTHX_ SV *sv1, SV *sv2)
1126 return sv_eq_flags(sv1, sv2, SV_GMAGIC);
1129 #ifdef USE_LOCALE_COLLATE
1131 Perl_sv_collxfrm(pTHX_ SV *const sv, STRLEN *const nxp)
1133 return sv_collxfrm_flags(sv, nxp, SV_GMAGIC);
1138 Perl_sv_2bool(pTHX_ SV *const sv)
1140 return sv_2bool_flags(sv, SV_GMAGIC);
1145 =for apidoc custom_op_name
1146 Return the name for a given custom op. This was once used by the OP_NAME
1147 macro, but is no longer: it has only been kept for compatibility, and
1150 =for apidoc custom_op_desc
1151 Return the description of a given custom op. This was once used by the
1152 OP_DESC macro, but is no longer: it has only been kept for
1153 compatibility, and should not be used.
1159 Perl_custom_op_name(pTHX_ const OP* o)
1161 PERL_ARGS_ASSERT_CUSTOM_OP_NAME;
1162 return XopENTRY(Perl_custom_op_xop(aTHX_ o), xop_name);
1166 Perl_custom_op_desc(pTHX_ const OP* o)
1168 PERL_ARGS_ASSERT_CUSTOM_OP_DESC;
1169 return XopENTRY(Perl_custom_op_xop(aTHX_ o), xop_desc);
1173 Perl_newSUB(pTHX_ I32 floor, OP *o, OP *proto, OP *block)
1175 return Perl_newATTRSUB(aTHX_ floor, o, proto, NULL, block);
1179 Perl_to_utf8_fold(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp)
1181 PERL_ARGS_ASSERT_TO_UTF8_FOLD;
1183 return _to_utf8_fold_flags(p, ustrp, lenp, FOLD_FLAGS_FULL, NULL);
1187 Perl_to_utf8_lower(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp)
1189 PERL_ARGS_ASSERT_TO_UTF8_LOWER;
1191 return _to_utf8_lower_flags(p, ustrp, lenp, FALSE, NULL);
1195 Perl_to_utf8_title(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp)
1197 PERL_ARGS_ASSERT_TO_UTF8_TITLE;
1199 return _to_utf8_title_flags(p, ustrp, lenp, FALSE, NULL);
1203 Perl_to_utf8_upper(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp)
1205 PERL_ARGS_ASSERT_TO_UTF8_UPPER;
1207 return _to_utf8_upper_flags(p, ustrp, lenp, FALSE, NULL);
1211 Perl_sv_mortalcopy(pTHX_ SV *const oldstr)
1213 return Perl_sv_mortalcopy_flags(aTHX_ oldstr, SV_GMAGIC);
1216 UV /* Made into a function, so can be deprecated */
1217 NATIVE_TO_NEED(const UV enc, const UV ch)
1219 PERL_UNUSED_ARG(enc);
1223 UV /* Made into a function, so can be deprecated */
1224 ASCII_TO_NEED(const UV enc, const UV ch)
1226 PERL_UNUSED_ARG(enc);
1231 =for apidoc uvuni_to_utf8_flags
1233 Instead you almost certainly want to use L</uvchr_to_utf8> or
1234 L</uvchr_to_utf8_flags>>.
1236 This function is a deprecated synonym for L</uvoffuni_to_utf8_flags>,
1237 which itself, while not deprecated, should be used only in isolated
1238 circumstances. These functions were useful for code that wanted to handle
1239 both EBCDIC and ASCII platforms with Unicode properties, but starting in Perl
1240 v5.20, the distinctions between the platforms have mostly been made invisible
1241 to most code, so this function is quite unlikely to be what you want.
1247 Perl_uvuni_to_utf8_flags(pTHX_ U8 *d, UV uv, UV flags)
1249 PERL_ARGS_ASSERT_UVUNI_TO_UTF8_FLAGS;
1251 return uvoffuni_to_utf8_flags(d, uv, flags);
1255 =for apidoc utf8n_to_uvuni
1257 Instead use L</utf8_to_uvchr_buf>, or rarely, L</utf8n_to_uvchr>.
1259 This function was usefulfor code that wanted to handle both EBCDIC and
1260 ASCII platforms with Unicode properties, but starting in Perl v5.20, the
1261 distinctions between the platforms have mostly been made invisible to most
1262 code, so this function is quite unlikely to be what you want.
1263 C<L<NATIVE_TO_UNI(utf8_to_uvchr_buf(...))|/utf8_to_uvchr_buf>> instead.
1269 Perl_utf8n_to_uvuni(pTHX_ const U8 *s, STRLEN curlen, STRLEN *retlen, U32 flags)
1271 PERL_ARGS_ASSERT_UTF8N_TO_UVUNI;
1273 return NATIVE_TO_UNI(utf8n_to_uvchr(s, curlen, retlen, flags));
1278 #endif /* NO_MATHOMS */
1282 * c-indentation-style: bsd
1284 * indent-tabs-mode: nil
1287 * ex: set ts=8 sts=4 sw=4 et: