X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/663f364bd429de50c8f5478879b1285d1270c1b3..1d1f77a4a3d406b218c3066fcecead9a27cb2e11:/mathoms.c diff --git a/mathoms.c b/mathoms.c index cccaa92..fa60621 100644 --- a/mathoms.c +++ b/mathoms.c @@ -1,6 +1,7 @@ /* mathoms.c * - * Copyright (C) 2005, 2006, 2007, 2007, by Larry Wall and others + * Copyright (C) 2005, 2006, 2007, 2008, 2009, 2010, + * 2011, 2012 by Larry Wall and others * * You may distribute under the terms of either the GNU General Public * License or the Artistic License, as specified in the README file. @@ -8,13 +9,15 @@ */ /* - * "Anything that Hobbits had no immediate use for, but were unwilling to - * throw away, they called a mathom. Their dwellings were apt to become - * rather crowded with mathoms, and many of the presents that passed from - * hand to hand were of that sort." + * Anything that Hobbits had no immediate use for, but were unwilling to + * throw away, they called a mathom. Their dwellings were apt to become + * rather crowded with mathoms, and many of the presents that passed from + * hand to hand were of that sort. + * + * [p.5 of _The Lord of the Rings_: "Prologue"] */ -#ifndef NO_MATHOMS + /* * This file contains mathoms, various binary artifacts from previous @@ -23,41 +26,62 @@ * * SMP - Oct. 24, 2005 * + * The compilation of this file can be suppressed; see INSTALL + * +=head1 Obsolete backwards compatibility functions +Some of these are also deprecated. You can exclude these from +your compiled Perl by adding this option to Configure: +C<-Accflags='-DNO_MATHOMS'> + +=cut + */ + #include "EXTERN.h" #define PERL_IN_MATHOMS_C #include "perl.h" +#ifdef NO_MATHOMS +/* ..." warning: ISO C forbids an empty source file" + So make sure we have something in here by processing the headers anyway. + */ +#else + +/* Not all of these have prototypes elsewhere, so do this to get + * non-mangled names. + */ +START_EXTERN_C + PERL_CALLCONV OP * Perl_ref(pTHX_ OP *o, I32 type); PERL_CALLCONV void Perl_sv_unref(pTHX_ SV *sv); PERL_CALLCONV void Perl_sv_taint(pTHX_ SV *sv); -PERL_CALLCONV IV Perl_sv_2iv(pTHX_ register SV *sv); -PERL_CALLCONV UV Perl_sv_2uv(pTHX_ register SV *sv); -PERL_CALLCONV char * Perl_sv_2pv(pTHX_ register SV *sv, STRLEN *lp); -PERL_CALLCONV char * Perl_sv_2pv_nolen(pTHX_ register SV *sv); -PERL_CALLCONV char * Perl_sv_2pvbyte_nolen(pTHX_ register SV *sv); -PERL_CALLCONV char * Perl_sv_2pvutf8_nolen(pTHX_ register SV *sv); -PERL_CALLCONV void Perl_sv_force_normal(pTHX_ register SV *sv); -PERL_CALLCONV void Perl_sv_setsv(pTHX_ SV *dstr, register SV *sstr); +PERL_CALLCONV IV Perl_sv_2iv(pTHX_ SV *sv); +PERL_CALLCONV UV Perl_sv_2uv(pTHX_ SV *sv); +PERL_CALLCONV NV Perl_sv_2nv(pTHX_ SV *sv); +PERL_CALLCONV char * Perl_sv_2pv(pTHX_ SV *sv, STRLEN *lp); +PERL_CALLCONV char * Perl_sv_2pv_nolen(pTHX_ SV *sv); +PERL_CALLCONV char * Perl_sv_2pvbyte_nolen(pTHX_ SV *sv); +PERL_CALLCONV char * Perl_sv_2pvutf8_nolen(pTHX_ SV *sv); +PERL_CALLCONV void Perl_sv_force_normal(pTHX_ SV *sv); +PERL_CALLCONV void Perl_sv_setsv(pTHX_ SV *dstr, SV *sstr); PERL_CALLCONV void Perl_sv_catpvn(pTHX_ SV *dsv, const char* sstr, STRLEN slen); -PERL_CALLCONV void Perl_sv_catpvn_mg(pTHX_ register SV *sv, register const char *ptr, register STRLEN len); -PERL_CALLCONV void Perl_sv_catsv(pTHX_ SV *dstr, register SV *sstr); -PERL_CALLCONV void Perl_sv_catsv_mg(pTHX_ SV *dsv, register SV *ssv); +PERL_CALLCONV void Perl_sv_catpvn_mg(pTHX_ SV *sv, const char *ptr, STRLEN len); +PERL_CALLCONV void Perl_sv_catsv(pTHX_ SV *dstr, SV *sstr); +PERL_CALLCONV void Perl_sv_catsv_mg(pTHX_ SV *dsv, SV *ssv); PERL_CALLCONV char * Perl_sv_pv(pTHX_ SV *sv); PERL_CALLCONV char * Perl_sv_pvn_force(pTHX_ SV *sv, STRLEN *lp); PERL_CALLCONV char * Perl_sv_pvbyte(pTHX_ SV *sv); PERL_CALLCONV char * Perl_sv_pvutf8(pTHX_ SV *sv); -PERL_CALLCONV STRLEN Perl_sv_utf8_upgrade(pTHX_ register SV *sv); +PERL_CALLCONV STRLEN Perl_sv_utf8_upgrade(pTHX_ SV *sv); PERL_CALLCONV NV Perl_huge(void); PERL_CALLCONV void Perl_gv_fullname3(pTHX_ SV *sv, const GV *gv, const char *prefix); PERL_CALLCONV void Perl_gv_efullname3(pTHX_ SV *sv, const GV *gv, const char *prefix); PERL_CALLCONV GV * Perl_gv_fetchmethod(pTHX_ HV *stash, const char *name); PERL_CALLCONV HE * Perl_hv_iternext(pTHX_ HV *hv); PERL_CALLCONV void Perl_hv_magic(pTHX_ HV *hv, GV *gv, int how); -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); -PERL_CALLCONV bool Perl_do_aexec(pTHX_ SV *really, register SV **mark, register SV **sp); -PERL_CALLCONV bool Perl_do_exec(pTHX_ const char *cmd); +PERL_CALLCONV bool Perl_do_open(pTHX_ GV *gv, const char *name, I32 len, int as_raw, int rawmode, int rawperm, PerlIO *supplied_fp); +PERL_CALLCONV bool Perl_do_aexec(pTHX_ SV *really, SV **mark, SV **sp); PERL_CALLCONV U8 * Perl_uvuni_to_utf8(pTHX_ U8 *d, UV uv); PERL_CALLCONV bool Perl_is_utf8_string_loc(pTHX_ const U8 *s, STRLEN len, const U8 **ep); PERL_CALLCONV void Perl_sv_nolocking(pTHX_ SV *sv); @@ -65,7 +89,21 @@ PERL_CALLCONV void Perl_sv_usepvn_mg(pTHX_ SV *sv, char *ptr, STRLEN len); PERL_CALLCONV void Perl_sv_usepvn(pTHX_ SV *sv, char *ptr, STRLEN len); PERL_CALLCONV int Perl_fprintf_nocontext(PerlIO *stream, const char *format, ...); PERL_CALLCONV int Perl_printf_nocontext(const char *format, ...); - +PERL_CALLCONV int Perl_magic_setglob(pTHX_ SV* sv, MAGIC* mg); +PERL_CALLCONV AV * Perl_newAV(pTHX); +PERL_CALLCONV HV * Perl_newHV(pTHX); +PERL_CALLCONV IO * Perl_newIO(pTHX); +PERL_CALLCONV I32 Perl_my_stat(pTHX); +PERL_CALLCONV I32 Perl_my_lstat(pTHX); +PERL_CALLCONV I32 Perl_sv_eq(pTHX_ SV *sv1, SV *sv2); +PERL_CALLCONV char * Perl_sv_collxfrm(pTHX_ SV *const sv, STRLEN *const nxp); +PERL_CALLCONV bool Perl_sv_2bool(pTHX_ SV *const sv); +PERL_CALLCONV CV * Perl_newSUB(pTHX_ I32 floor, OP* o, OP* proto, OP* block); +PERL_CALLCONV UV Perl_to_utf8_lower(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp); +PERL_CALLCONV UV Perl_to_utf8_title(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp); +PERL_CALLCONV UV Perl_to_utf8_upper(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp); +PERL_CALLCONV UV Perl_to_utf8_fold(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp); +PERL_CALLCONV SV *Perl_sv_mortalcopy(pTHX_ SV *const oldstr); /* ref() is now a macro using Perl_doref; * this version provided for binary compatibility only. @@ -90,19 +128,24 @@ being zero. See C. void Perl_sv_unref(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_UNREF; + sv_unref_flags(sv, 0); } /* =for apidoc sv_taint -Taint an SV. Use C instead. +Taint an SV. Use C instead. + =cut */ void Perl_sv_taint(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_TAINT; + sv_magic((sv), NULL, PERL_MAGIC_taint, NULL, 0); } @@ -111,8 +154,10 @@ Perl_sv_taint(pTHX_ SV *sv) */ IV -Perl_sv_2iv(pTHX_ register SV *sv) +Perl_sv_2iv(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_2IV; + return sv_2iv_flags(sv, SV_GMAGIC); } @@ -121,32 +166,49 @@ Perl_sv_2iv(pTHX_ register SV *sv) */ UV -Perl_sv_2uv(pTHX_ register SV *sv) +Perl_sv_2uv(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_2UV; + return sv_2uv_flags(sv, SV_GMAGIC); } +/* sv_2nv() is now a macro using Perl_sv_2nv_flags(); + * this function provided for binary compatibility only + */ + +NV +Perl_sv_2nv(pTHX_ SV *sv) +{ + return sv_2nv_flags(sv, SV_GMAGIC); +} + + /* sv_2pv() is now a macro using Perl_sv_2pv_flags(); * this function provided for binary compatibility only */ char * -Perl_sv_2pv(pTHX_ register SV *sv, STRLEN *lp) +Perl_sv_2pv(pTHX_ SV *sv, STRLEN *lp) { + PERL_ARGS_ASSERT_SV_2PV; + return sv_2pv_flags(sv, lp, SV_GMAGIC); } /* =for apidoc sv_2pv_nolen -Like C, but doesn't return the length too. You should usually +Like C, but doesn't return the length too. You should usually use the macro wrapper C instead. + =cut */ char * -Perl_sv_2pv_nolen(pTHX_ register SV *sv) +Perl_sv_2pv_nolen(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_2PV_NOLEN; return sv_2pv(sv, NULL); } @@ -162,8 +224,10 @@ Usually accessed via the C macro. */ char * -Perl_sv_2pvbyte_nolen(pTHX_ register SV *sv) +Perl_sv_2pvbyte_nolen(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_2PVBYTE_NOLEN; + return sv_2pvbyte(sv, NULL); } @@ -179,8 +243,10 @@ Usually accessed via the C macro. */ char * -Perl_sv_2pvutf8_nolen(pTHX_ register SV *sv) +Perl_sv_2pvutf8_nolen(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_2PVUTF8_NOLEN; + return sv_2pvutf8(sv, NULL); } @@ -189,14 +255,16 @@ Perl_sv_2pvutf8_nolen(pTHX_ register SV *sv) Undo various types of fakery on an SV: if the PV is a shared string, make a private copy; if we're a ref, stop refing; if we're a glob, downgrade to -an xpvmg. See also C. +an xpvmg. See also C. =cut */ void -Perl_sv_force_normal(pTHX_ register SV *sv) +Perl_sv_force_normal(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_FORCE_NORMAL; + sv_force_normal_flags(sv, 0); } @@ -205,8 +273,10 @@ Perl_sv_force_normal(pTHX_ register SV *sv) */ void -Perl_sv_setsv(pTHX_ SV *dstr, register SV *sstr) +Perl_sv_setsv(pTHX_ SV *dstr, SV *sstr) { + PERL_ARGS_ASSERT_SV_SETSV; + sv_setsv_flags(dstr, sstr, SV_GMAGIC); } @@ -217,6 +287,8 @@ Perl_sv_setsv(pTHX_ SV *dstr, register SV *sstr) void Perl_sv_catpvn(pTHX_ SV *dsv, const char* sstr, STRLEN slen) { + PERL_ARGS_ASSERT_SV_CATPVN; + sv_catpvn_flags(dsv, sstr, slen, SV_GMAGIC); } @@ -229,8 +301,10 @@ Like C, but also handles 'set' magic. */ void -Perl_sv_catpvn_mg(pTHX_ register SV *sv, register const char *ptr, register STRLEN len) +Perl_sv_catpvn_mg(pTHX_ SV *sv, const char *ptr, STRLEN len) { + PERL_ARGS_ASSERT_SV_CATPVN_MG; + sv_catpvn_flags(sv,ptr,len,SV_GMAGIC|SV_SMAGIC); } @@ -239,8 +313,10 @@ Perl_sv_catpvn_mg(pTHX_ register SV *sv, register const char *ptr, register STRL */ void -Perl_sv_catsv(pTHX_ SV *dstr, register SV *sstr) +Perl_sv_catsv(pTHX_ SV *dstr, SV *sstr) { + PERL_ARGS_ASSERT_SV_CATSV; + sv_catsv_flags(dstr, sstr, SV_GMAGIC); } @@ -253,8 +329,10 @@ Like C, but also handles 'set' magic. */ void -Perl_sv_catsv_mg(pTHX_ SV *dsv, register SV *ssv) +Perl_sv_catsv_mg(pTHX_ SV *dsv, SV *ssv) { + PERL_ARGS_ASSERT_SV_CATSV_MG; + sv_catsv_flags(dsv,ssv,SV_GMAGIC|SV_SMAGIC); } @@ -262,14 +340,16 @@ Perl_sv_catsv_mg(pTHX_ SV *dsv, register SV *ssv) =for apidoc sv_iv A private implementation of the C macro for compilers which can't -cope with complex macro expressions. Always use the macro instead. +cope with complex macro expressions. Always use the macro instead. =cut */ IV -Perl_sv_iv(pTHX_ register SV *sv) +Perl_sv_iv(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_IV; + if (SvIOK(sv)) { if (SvIsUV(sv)) return (IV)SvUVX(sv); @@ -282,14 +362,16 @@ Perl_sv_iv(pTHX_ register SV *sv) =for apidoc sv_uv A private implementation of the C macro for compilers which can't -cope with complex macro expressions. Always use the macro instead. +cope with complex macro expressions. Always use the macro instead. =cut */ UV -Perl_sv_uv(pTHX_ register SV *sv) +Perl_sv_uv(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_UV; + if (SvIOK(sv)) { if (SvIsUV(sv)) return SvUVX(sv); @@ -302,14 +384,16 @@ Perl_sv_uv(pTHX_ register SV *sv) =for apidoc sv_nv A private implementation of the C macro for compilers which can't -cope with complex macro expressions. Always use the macro instead. +cope with complex macro expressions. Always use the macro instead. =cut */ NV -Perl_sv_nv(pTHX_ register SV *sv) +Perl_sv_nv(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_NV; + if (SvNOK(sv)) return SvNVX(sv); return sv_2nv(sv); @@ -323,7 +407,7 @@ Use the C macro instead =for apidoc sv_pvn A private implementation of the C macro for compilers which can't -cope with complex macro expressions. Always use the macro instead. +cope with complex macro expressions. Always use the macro instead. =cut */ @@ -331,6 +415,8 @@ cope with complex macro expressions. Always use the macro instead. char * Perl_sv_pvn(pTHX_ SV *sv, STRLEN *lp) { + PERL_ARGS_ASSERT_SV_PVN; + if (SvPOK(sv)) { *lp = SvCUR(sv); return SvPVX(sv); @@ -340,8 +426,10 @@ Perl_sv_pvn(pTHX_ SV *sv, STRLEN *lp) char * -Perl_sv_pvn_nomg(pTHX_ register SV *sv, STRLEN *lp) +Perl_sv_pvn_nomg(pTHX_ SV *sv, STRLEN *lp) { + PERL_ARGS_ASSERT_SV_PVN_NOMG; + if (SvPOK(sv)) { *lp = SvCUR(sv); return SvPVX(sv); @@ -356,6 +444,8 @@ Perl_sv_pvn_nomg(pTHX_ register SV *sv, STRLEN *lp) char * Perl_sv_pv(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_PV; + if (SvPOK(sv)) return SvPVX(sv); @@ -369,6 +459,8 @@ Perl_sv_pv(pTHX_ SV *sv) char * Perl_sv_pvn_force(pTHX_ SV *sv, STRLEN *lp) { + PERL_ARGS_ASSERT_SV_PVN_FORCE; + return sv_pvn_force_flags(sv, lp, SV_GMAGIC); } @@ -379,6 +471,8 @@ Perl_sv_pvn_force(pTHX_ SV *sv, STRLEN *lp) char * Perl_sv_pvbyte(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_PVBYTE; + sv_utf8_downgrade(sv, FALSE); return sv_pv(sv); } @@ -391,7 +485,7 @@ Use C instead. =for apidoc sv_pvbyten A private implementation of the C macro for compilers -which can't cope with complex macro expressions. Always use the macro +which can't cope with complex macro expressions. Always use the macro instead. =cut @@ -400,6 +494,8 @@ instead. char * Perl_sv_pvbyten(pTHX_ SV *sv, STRLEN *lp) { + PERL_ARGS_ASSERT_SV_PVBYTEN; + sv_utf8_downgrade(sv, FALSE); return sv_pvn(sv,lp); } @@ -411,6 +507,8 @@ Perl_sv_pvbyten(pTHX_ SV *sv, STRLEN *lp) char * Perl_sv_pvutf8(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_PVUTF8; + sv_utf8_upgrade(sv); return sv_pv(sv); } @@ -423,7 +521,7 @@ Use the C macro instead =for apidoc sv_pvutf8n A private implementation of the C macro for compilers -which can't cope with complex macro expressions. Always use the macro +which can't cope with complex macro expressions. Always use the macro instead. =cut @@ -432,6 +530,8 @@ instead. char * Perl_sv_pvutf8n(pTHX_ SV *sv, STRLEN *lp) { + PERL_ARGS_ASSERT_SV_PVUTF8N; + sv_utf8_upgrade(sv); return sv_pvn(sv,lp); } @@ -441,18 +541,29 @@ Perl_sv_pvutf8n(pTHX_ SV *sv, STRLEN *lp) */ STRLEN -Perl_sv_utf8_upgrade(pTHX_ register SV *sv) +Perl_sv_utf8_upgrade(pTHX_ SV *sv) { + PERL_ARGS_ASSERT_SV_UTF8_UPGRADE; + return sv_utf8_upgrade_flags(sv, SV_GMAGIC); } int Perl_fprintf_nocontext(PerlIO *stream, const char *format, ...) { - dTHXs; + int ret = 0; va_list(arglist); + + /* Easier to special case this here than in embed.pl. (Look at what it + generates for proto.h) */ +#ifdef PERL_IMPLICIT_CONTEXT + PERL_ARGS_ASSERT_FPRINTF_NOCONTEXT; +#endif + va_start(arglist, format); - return PerlIO_vprintf(stream, format, arglist); + ret = PerlIO_vprintf(stream, format, arglist); + va_end(arglist); + return ret; } int @@ -460,8 +571,16 @@ Perl_printf_nocontext(const char *format, ...) { dTHX; va_list(arglist); + int ret = 0; + +#ifdef PERL_IMPLICIT_CONTEXT + PERL_ARGS_ASSERT_PRINTF_NOCONTEXT; +#endif + va_start(arglist, format); - return PerlIO_vprintf(PerlIO_stdout(), format, arglist); + ret = PerlIO_vprintf(PerlIO_stdout(), format, arglist); + va_end(arglist); + return ret; } #if defined(HUGE_VAL) || (defined(USE_LONG_DOUBLE) && defined(HUGE_VALL)) @@ -485,6 +604,8 @@ Perl_huge(void) void Perl_gv_fullname(pTHX_ SV *sv, const GV *gv) { + PERL_ARGS_ASSERT_GV_FULLNAME; + gv_fullname3(sv, gv, sv == (const SV*)gv ? "*" : ""); } @@ -492,25 +613,31 @@ Perl_gv_fullname(pTHX_ SV *sv, const GV *gv) void Perl_gv_efullname(pTHX_ SV *sv, const GV *gv) { + PERL_ARGS_ASSERT_GV_EFULLNAME; + gv_efullname3(sv, gv, sv == (const SV*)gv ? "*" : ""); } void Perl_gv_fullname3(pTHX_ SV *sv, const GV *gv, const char *prefix) { + PERL_ARGS_ASSERT_GV_FULLNAME3; + gv_fullname4(sv, gv, prefix, TRUE); } void Perl_gv_efullname3(pTHX_ SV *sv, const GV *gv, const char *prefix) { + PERL_ARGS_ASSERT_GV_EFULLNAME3; + gv_efullname4(sv, gv, prefix, TRUE); } /* =for apidoc gv_fetchmethod -See L. +See L. =cut */ @@ -518,55 +645,45 @@ See L. GV * Perl_gv_fetchmethod(pTHX_ HV *stash, const char *name) { + PERL_ARGS_ASSERT_GV_FETCHMETHOD; + return gv_fetchmethod_autoload(stash, name, TRUE); } HE * Perl_hv_iternext(pTHX_ HV *hv) { + PERL_ARGS_ASSERT_HV_ITERNEXT; + return hv_iternext_flags(hv, 0); } void Perl_hv_magic(pTHX_ HV *hv, GV *gv, int how) { - sv_magic((SV*)hv, (SV*)gv, how, NULL, 0); -} + PERL_ARGS_ASSERT_HV_MAGIC; -AV * -Perl_av_fake(pTHX_ register I32 size, register SV **strp) -{ - register SV** ary; - register AV * const av = (AV*)newSV_type(SVt_PVAV); - Newx(ary,size+1,SV*); - AvALLOC(av) = ary; - Copy(strp,ary,size,SV*); - AvREIFY_only(av); - AvARRAY(av) = ary; - AvFILLp(av) = size - 1; - AvMAX(av) = size - 1; - while (size--) { - assert (*strp); - SvTEMP_off(*strp); - strp++; - } - return av; + sv_magic(MUTABLE_SV(hv), MUTABLE_SV(gv), how, NULL, 0); } bool -Perl_do_open(pTHX_ GV *gv, register const char *name, I32 len, int as_raw, +Perl_do_open(pTHX_ GV *gv, const char *name, I32 len, int as_raw, int rawmode, int rawperm, PerlIO *supplied_fp) { + PERL_ARGS_ASSERT_DO_OPEN; + return do_openn(gv, name, len, as_raw, rawmode, rawperm, supplied_fp, (SV **) NULL, 0); } bool -Perl_do_open9(pTHX_ GV *gv, register const char *name, I32 len, int +Perl_do_open9(pTHX_ GV *gv, const char *name, I32 len, int as_raw, int rawmode, int rawperm, PerlIO *supplied_fp, SV *svs, I32 num_svs) { + PERL_ARGS_ASSERT_DO_OPEN9; + PERL_UNUSED_ARG(num_svs); return do_openn(gv, name, len, as_raw, rawmode, rawperm, supplied_fp, &svs, 1); @@ -579,6 +696,9 @@ Perl_do_binmode(pTHX_ PerlIO *fp, int iotype, int mode) * This is a stub for any XS code which might have been calling it. */ const char *name = ":raw"; + + PERL_ARGS_ASSERT_DO_BINMODE; + #ifdef PERLIO_USING_CRLF if (!(mode & O_BINARY)) name = ":crlf"; @@ -588,17 +708,11 @@ Perl_do_binmode(pTHX_ PerlIO *fp, int iotype, int mode) #ifndef OS2 bool -Perl_do_aexec(pTHX_ SV *really, register SV **mark, register SV **sp) +Perl_do_aexec(pTHX_ SV *really, SV **mark, SV **sp) { - return do_aexec5(really, mark, sp, 0, 0); -} -#endif + PERL_ARGS_ASSERT_DO_AEXEC; -#ifdef PERL_DEFAULT_DO_EXEC3_IMPLEMENTATION -bool -Perl_do_exec(pTHX_ const char *cmd) -{ - return do_exec3(cmd,0,0); + return do_aexec5(really, mark, sp, 0, 0); } #endif @@ -609,720 +723,1067 @@ Perl_init_i18nl14n(pTHX_ int printwarn) return init_i18nl10n(printwarn); } -OP * -Perl_oopsCV(pTHX_ OP *o) -{ - Perl_croak(aTHX_ "NOT IMPL LINE %d",__LINE__); - /* STUB */ - PERL_UNUSED_ARG(o); - NORETURN_FUNCTION_END; -} - -PP(pp_padany) +bool +Perl_is_utf8_string_loc(pTHX_ const U8 *s, STRLEN len, const U8 **ep) { - DIE(aTHX_ "NOT IMPL LINE %d",__LINE__); -} + PERL_ARGS_ASSERT_IS_UTF8_STRING_LOC; + PERL_UNUSED_CONTEXT; -PP(pp_mapstart) -{ - DIE(aTHX_ "panic: mapstart"); /* uses grepstart */ + return is_utf8_string_loclen(s, len, ep, 0); } -/* These ops all have the same body as pp_null. */ -PP(pp_scalar) -{ - dVAR; - return NORMAL; -} +/* +=for apidoc sv_nolocking -PP(pp_regcmaybe) -{ - dVAR; - return NORMAL; -} +Dummy routine which "locks" an SV when there is no locking module present. +Exists to avoid test for a NULL function pointer and because it could +potentially warn under some level of strict-ness. -PP(pp_lineseq) -{ - dVAR; - return NORMAL; -} +"Superseded" by sv_nosharing(). -PP(pp_scope) -{ - dVAR; - return NORMAL; -} +=cut +*/ -/* Ops that are calls to do_kv. */ -PP(pp_values) +void +Perl_sv_nolocking(pTHX_ SV *sv) { - return do_kv(); + PERL_UNUSED_CONTEXT; + PERL_UNUSED_ARG(sv); } -PP(pp_keys) -{ - return do_kv(); -} -/* Ops that are simply calls to other ops. */ -PP(pp_dump) -{ - return pp_goto(); - /*NOTREACHED*/ -} +/* +=for apidoc sv_nounlocking -PP(pp_dofile) -{ - return pp_require(); -} +Dummy routine which "unlocks" an SV when there is no locking module present. +Exists to avoid test for a NULL function pointer and because it could +potentially warn under some level of strict-ness. -PP(pp_dbmclose) -{ - return pp_untie(); -} +"Superseded" by sv_nosharing(). -PP(pp_read) -{ - return pp_sysread(); -} +=cut +*/ -PP(pp_recv) +void +Perl_sv_nounlocking(pTHX_ SV *sv) { - return pp_sysread(); + PERL_UNUSED_CONTEXT; + PERL_UNUSED_ARG(sv); } -PP(pp_seek) +void +Perl_save_long(pTHX_ long int *longp) { - return pp_sysseek(); -} + PERL_ARGS_ASSERT_SAVE_LONG; -PP(pp_fcntl) -{ - return pp_ioctl(); + SSCHECK(3); + SSPUSHLONG(*longp); + SSPUSHPTR(longp); + SSPUSHUV(SAVEt_LONG); } -PP(pp_gsockopt) +void +Perl_save_iv(pTHX_ IV *ivp) { - return pp_ssockopt(); -} + PERL_ARGS_ASSERT_SAVE_IV; -PP(pp_getsockname) -{ - return pp_getpeername(); + SSCHECK(3); + SSPUSHIV(*ivp); + SSPUSHPTR(ivp); + SSPUSHUV(SAVEt_IV); } -PP(pp_lstat) +void +Perl_save_nogv(pTHX_ GV *gv) { - return pp_stat(); -} + PERL_ARGS_ASSERT_SAVE_NOGV; -PP(pp_fteowned) -{ - return pp_ftrowned(); + SSCHECK(2); + SSPUSHPTR(gv); + SSPUSHUV(SAVEt_NSTAB); } -PP(pp_ftbinary) +void +Perl_save_list(pTHX_ SV **sarg, I32 maxsarg) { - return pp_fttext(); -} + I32 i; -PP(pp_localtime) -{ - return pp_gmtime(); -} + PERL_ARGS_ASSERT_SAVE_LIST; -PP(pp_shmget) -{ - return pp_semget(); + for (i = 1; i <= maxsarg; i++) { + SV *sv; + SvGETMAGIC(sarg[i]); + sv = newSV(0); + sv_setsv_nomg(sv,sarg[i]); + SSCHECK(3); + SSPUSHPTR(sarg[i]); /* remember the pointer */ + SSPUSHPTR(sv); /* remember the value */ + SSPUSHUV(SAVEt_ITEM); + } } -PP(pp_shmctl) -{ - return pp_semctl(); -} +/* +=for apidoc sv_usepvn_mg -PP(pp_shmread) -{ - return pp_shmwrite(); -} +Like C, but also handles 'set' magic. -PP(pp_msgget) -{ - return pp_semget(); -} +=cut +*/ -PP(pp_msgctl) +void +Perl_sv_usepvn_mg(pTHX_ SV *sv, char *ptr, STRLEN len) { - return pp_semctl(); -} + PERL_ARGS_ASSERT_SV_USEPVN_MG; -PP(pp_ghbyname) -{ - return pp_ghostent(); + sv_usepvn_flags(sv,ptr,len, SV_SMAGIC); } -PP(pp_ghbyaddr) -{ - return pp_ghostent(); -} +/* +=for apidoc sv_usepvn -PP(pp_gnbyname) -{ - return pp_gnetent(); -} +Tells an SV to use C to find its string value. Implemented by +calling C with C of 0, hence does not handle 'set' +magic. See C. -PP(pp_gnbyaddr) -{ - return pp_gnetent(); -} +=cut +*/ -PP(pp_gpbyname) +void +Perl_sv_usepvn(pTHX_ SV *sv, char *ptr, STRLEN len) { - return pp_gprotoent(); -} + PERL_ARGS_ASSERT_SV_USEPVN; -PP(pp_gpbynumber) -{ - return pp_gprotoent(); + sv_usepvn_flags(sv,ptr,len, 0); } -PP(pp_gsbyname) -{ - return pp_gservent(); -} +/* +=for apidoc unpack_str -PP(pp_gsbyport) -{ - return pp_gservent(); -} +The engine implementing unpack() Perl function. Note: parameters strbeg, +new_s and ocnt are not used. This call should not be used, use +unpackstring instead. -PP(pp_gpwnam) -{ - return pp_gpwent(); -} +=cut */ -PP(pp_gpwuid) +I32 +Perl_unpack_str(pTHX_ const char *pat, const char *patend, const char *s, + const char *strbeg, const char *strend, char **new_s, I32 ocnt, + U32 flags) { - return pp_gpwent(); -} + PERL_ARGS_ASSERT_UNPACK_STR; -PP(pp_ggrnam) -{ - return pp_ggrent(); -} + PERL_UNUSED_ARG(strbeg); + PERL_UNUSED_ARG(new_s); + PERL_UNUSED_ARG(ocnt); -PP(pp_ggrgid) -{ - return pp_ggrent(); + return unpackstring(pat, patend, s, strend, flags); } -PP(pp_ftsize) -{ - return pp_ftis(); -} +/* +=for apidoc pack_cat -PP(pp_ftmtime) -{ - return pp_ftis(); -} +The engine implementing pack() Perl function. Note: parameters +next_in_list and flags are not used. This call should not be used; use +packlist instead. -PP(pp_ftatime) -{ - return pp_ftis(); -} +=cut +*/ -PP(pp_ftctime) +void +Perl_pack_cat(pTHX_ SV *cat, const char *pat, const char *patend, SV **beglist, SV **endlist, SV ***next_in_list, U32 flags) { - return pp_ftis(); -} + PERL_ARGS_ASSERT_PACK_CAT; -PP(pp_ftzero) -{ - return pp_ftrowned(); -} + PERL_UNUSED_ARG(next_in_list); + PERL_UNUSED_ARG(flags); -PP(pp_ftsock) -{ - return pp_ftrowned(); + packlist(cat, pat, patend, beglist, endlist); } -PP(pp_ftchr) +HE * +Perl_hv_store_ent(pTHX_ HV *hv, SV *keysv, SV *val, U32 hash) { - return pp_ftrowned(); + return (HE *)hv_common(hv, keysv, NULL, 0, 0, HV_FETCH_ISSTORE, val, hash); } -PP(pp_ftblk) +bool +Perl_hv_exists_ent(pTHX_ HV *hv, SV *keysv, U32 hash) { - return pp_ftrowned(); -} + PERL_ARGS_ASSERT_HV_EXISTS_ENT; -PP(pp_ftfile) -{ - return pp_ftrowned(); + return hv_common(hv, keysv, NULL, 0, 0, HV_FETCH_ISEXISTS, 0, hash) + ? TRUE : FALSE; } -PP(pp_ftdir) +HE * +Perl_hv_fetch_ent(pTHX_ HV *hv, SV *keysv, I32 lval, U32 hash) { - return pp_ftrowned(); -} + PERL_ARGS_ASSERT_HV_FETCH_ENT; -PP(pp_ftpipe) -{ - return pp_ftrowned(); + return (HE *)hv_common(hv, keysv, NULL, 0, 0, + (lval ? HV_FETCH_LVALUE : 0), NULL, hash); } -PP(pp_ftsuid) +SV * +Perl_hv_delete_ent(pTHX_ HV *hv, SV *keysv, I32 flags, U32 hash) { - return pp_ftrowned(); -} + PERL_ARGS_ASSERT_HV_DELETE_ENT; -PP(pp_ftsgid) -{ - return pp_ftrowned(); + return MUTABLE_SV(hv_common(hv, keysv, NULL, 0, 0, flags | HV_DELETE, NULL, + hash)); } -PP(pp_ftsvtx) +SV** +Perl_hv_store_flags(pTHX_ HV *hv, const char *key, I32 klen, SV *val, U32 hash, + int flags) { - return pp_ftrowned(); + return (SV**) hv_common(hv, NULL, key, klen, flags, + (HV_FETCH_ISSTORE|HV_FETCH_JUST_SV), val, hash); } -PP(pp_unlink) +SV** +Perl_hv_store(pTHX_ HV *hv, const char *key, I32 klen_i32, SV *val, U32 hash) { - return pp_chown(); -} + STRLEN klen; + int flags; -PP(pp_chmod) -{ - return pp_chown(); -} + if (klen_i32 < 0) { + klen = -klen_i32; + flags = HVhek_UTF8; + } else { + klen = klen_i32; + flags = 0; + } + return (SV **) hv_common(hv, NULL, key, klen, flags, + (HV_FETCH_ISSTORE|HV_FETCH_JUST_SV), val, hash); +} -PP(pp_utime) +bool +Perl_hv_exists(pTHX_ HV *hv, const char *key, I32 klen_i32) { - return pp_chown(); + STRLEN klen; + int flags; + + PERL_ARGS_ASSERT_HV_EXISTS; + + if (klen_i32 < 0) { + klen = -klen_i32; + flags = HVhek_UTF8; + } else { + klen = klen_i32; + flags = 0; + } + return hv_common(hv, NULL, key, klen, flags, HV_FETCH_ISEXISTS, 0, 0) + ? TRUE : FALSE; } -PP(pp_kill) +SV** +Perl_hv_fetch(pTHX_ HV *hv, const char *key, I32 klen_i32, I32 lval) { - return pp_chown(); + STRLEN klen; + int flags; + + PERL_ARGS_ASSERT_HV_FETCH; + + if (klen_i32 < 0) { + klen = -klen_i32; + flags = HVhek_UTF8; + } else { + klen = klen_i32; + flags = 0; + } + return (SV **) hv_common(hv, NULL, key, klen, flags, + lval ? (HV_FETCH_JUST_SV | HV_FETCH_LVALUE) + : HV_FETCH_JUST_SV, NULL, 0); } -PP(pp_symlink) +SV * +Perl_hv_delete(pTHX_ HV *hv, const char *key, I32 klen_i32, I32 flags) { - return pp_link(); + STRLEN klen; + int k_flags; + + PERL_ARGS_ASSERT_HV_DELETE; + + if (klen_i32 < 0) { + klen = -klen_i32; + k_flags = HVhek_UTF8; + } else { + klen = klen_i32; + k_flags = 0; + } + return MUTABLE_SV(hv_common(hv, NULL, key, klen, k_flags, flags | HV_DELETE, + NULL, 0)); } -PP(pp_ftrwrite) +/* Functions after here were made mathoms post 5.10.0 but pre 5.8.9 */ + +AV * +Perl_newAV(pTHX) { - return pp_ftrread(); + return MUTABLE_AV(newSV_type(SVt_PVAV)); + /* sv_upgrade does AvREAL_only(): + AvALLOC(av) = 0; + AvARRAY(av) = NULL; + AvMAX(av) = AvFILLp(av) = -1; */ } -PP(pp_ftrexec) +HV * +Perl_newHV(pTHX) { - return pp_ftrread(); + HV * const hv = MUTABLE_HV(newSV_type(SVt_PVHV)); + assert(!SvOK(hv)); + + return hv; } -PP(pp_fteread) +void +Perl_sv_insert(pTHX_ SV *const bigstr, const STRLEN offset, const STRLEN len, + const char *const little, const STRLEN littlelen) { - return pp_ftrread(); + PERL_ARGS_ASSERT_SV_INSERT; + sv_insert_flags(bigstr, offset, len, little, littlelen, SV_GMAGIC); } -PP(pp_ftewrite) +void +Perl_save_freesv(pTHX_ SV *sv) { - return pp_ftrread(); + save_freesv(sv); } -PP(pp_fteexec) +void +Perl_save_mortalizesv(pTHX_ SV *sv) { - return pp_ftrread(); + PERL_ARGS_ASSERT_SAVE_MORTALIZESV; + + save_mortalizesv(sv); } -PP(pp_msgsnd) +void +Perl_save_freeop(pTHX_ OP *o) { - return pp_shmwrite(); + save_freeop(o); } -PP(pp_msgrcv) +void +Perl_save_freepv(pTHX_ char *pv) { - return pp_shmwrite(); + save_freepv(pv); } -PP(pp_syswrite) +void +Perl_save_op(pTHX) { - return pp_send(); + save_op(); } -PP(pp_semop) +#ifdef PERL_DONT_CREATE_GVSV +GV * +Perl_gv_SVadd(pTHX_ GV *gv) { - return pp_shmwrite(); + return gv_SVadd(gv); } +#endif -PP(pp_dor) +GV * +Perl_gv_AVadd(pTHX_ GV *gv) { - return pp_defined(); + return gv_AVadd(gv); } -PP(pp_andassign) +GV * +Perl_gv_HVadd(pTHX_ GV *gv) { - return pp_and(); + return gv_HVadd(gv); } -PP(pp_orassign) +GV * +Perl_gv_IOadd(pTHX_ GV *gv) { - return pp_or(); + return gv_IOadd(gv); } -PP(pp_dorassign) +IO * +Perl_newIO(pTHX) { - return pp_defined(); -} + return MUTABLE_IO(newSV_type(SVt_PVIO)); +} -PP(pp_lcfirst) +I32 +Perl_my_stat(pTHX) { - return pp_ucfirst(); + return my_stat_flags(SV_GMAGIC); } -PP(pp_slt) +I32 +Perl_my_lstat(pTHX) { - return pp_sle(); + return my_lstat_flags(SV_GMAGIC); } -PP(pp_sgt) +I32 +Perl_sv_eq(pTHX_ SV *sv1, SV *sv2) +{ + return sv_eq_flags(sv1, sv2, SV_GMAGIC); +} + +#ifdef USE_LOCALE_COLLATE +char * +Perl_sv_collxfrm(pTHX_ SV *const sv, STRLEN *const nxp) +{ + return sv_collxfrm_flags(sv, nxp, SV_GMAGIC); +} +#endif + +bool +Perl_sv_2bool(pTHX_ SV *const sv) +{ + return sv_2bool_flags(sv, SV_GMAGIC); +} + + +/* +=for apidoc custom_op_name +Return the name for a given custom op. This was once used by the OP_NAME +macro, but is no longer: it has only been kept for compatibility, and +should not be used. + +=for apidoc custom_op_desc +Return the description of a given custom op. This was once used by the +OP_DESC macro, but is no longer: it has only been kept for +compatibility, and should not be used. + +=cut +*/ + +const char* +Perl_custom_op_name(pTHX_ const OP* o) { - return pp_sle(); + PERL_ARGS_ASSERT_CUSTOM_OP_NAME; + return XopENTRYCUSTOM(o, xop_name); } -PP(pp_sge) +const char* +Perl_custom_op_desc(pTHX_ const OP* o) { - return pp_sle(); + PERL_ARGS_ASSERT_CUSTOM_OP_DESC; + return XopENTRYCUSTOM(o, xop_desc); } -PP(pp_rindex) +CV * +Perl_newSUB(pTHX_ I32 floor, OP *o, OP *proto, OP *block) { - return pp_index(); + return newATTRSUB(floor, o, proto, NULL, block); } -PP(pp_hex) +UV +Perl_to_utf8_fold(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp) { - return pp_oct(); + PERL_ARGS_ASSERT_TO_UTF8_FOLD; + + return _to_utf8_fold_flags(p, ustrp, lenp, FOLD_FLAGS_FULL); } -PP(pp_pop) +UV +Perl_to_utf8_lower(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp) { - return pp_shift(); + PERL_ARGS_ASSERT_TO_UTF8_LOWER; + + return _to_utf8_lower_flags(p, ustrp, lenp, FALSE); } -PP(pp_cos) +UV +Perl_to_utf8_title(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp) { - return pp_sin(); + PERL_ARGS_ASSERT_TO_UTF8_TITLE; + + return _to_utf8_title_flags(p, ustrp, lenp, FALSE); } -PP(pp_exp) +UV +Perl_to_utf8_upper(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp) { - return pp_sin(); + PERL_ARGS_ASSERT_TO_UTF8_UPPER; + + return _to_utf8_upper_flags(p, ustrp, lenp, FALSE); } -PP(pp_log) +SV * +Perl_sv_mortalcopy(pTHX_ SV *const oldstr) { - return pp_sin(); + return Perl_sv_mortalcopy_flags(aTHX_ oldstr, SV_GMAGIC); } -PP(pp_sqrt) +UV /* Made into a function, so can be deprecated */ +NATIVE_TO_NEED(const UV enc, const UV ch) { - return pp_sin(); + PERL_UNUSED_ARG(enc); + return ch; } -PP(pp_bit_xor) +UV /* Made into a function, so can be deprecated */ +ASCII_TO_NEED(const UV enc, const UV ch) { - return pp_bit_or(); + PERL_UNUSED_ARG(enc); + return ch; } -PP(pp_rv2hv) +bool /* Made into a function, so can be deprecated */ +Perl_isIDFIRST_lazy(pTHX_ const char* p) { - return Perl_pp_rv2av(aTHX); + PERL_ARGS_ASSERT_ISIDFIRST_LAZY; + + return isIDFIRST_lazy_if(p,1); } -U8 * -Perl_uvuni_to_utf8(pTHX_ U8 *d, UV uv) +bool /* Made into a function, so can be deprecated */ +Perl_isALNUM_lazy(pTHX_ const char* p) { - return Perl_uvuni_to_utf8_flags(aTHX_ d, uv, 0); + PERL_ARGS_ASSERT_ISALNUM_LAZY; + + return isALNUM_lazy_if(p,1); } bool -Perl_is_utf8_string_loc(pTHX_ const U8 *s, STRLEN len, const U8 **ep) +Perl_is_uni_alnum(pTHX_ UV c) { - return is_utf8_string_loclen(s, len, ep, 0); + return isWORDCHAR_uni(c); } -/* -=for apidoc sv_nolocking +bool +Perl_is_uni_alnumc(pTHX_ UV c) +{ + return isALNUM_uni(c); +} -Dummy routine which "locks" an SV when there is no locking module present. -Exists to avoid test for a NULL function pointer and because it could -potentially warn under some level of strict-ness. +bool +Perl_is_uni_alpha(pTHX_ UV c) +{ + return isALPHA_uni(c); +} -"Superseded" by sv_nosharing(). +bool +Perl_is_uni_ascii(pTHX_ UV c) +{ + PERL_UNUSED_CONTEXT; + return isASCII_uni(c); +} -=cut -*/ +bool +Perl_is_uni_blank(pTHX_ UV c) +{ + PERL_UNUSED_CONTEXT; + return isBLANK_uni(c); +} -void -Perl_sv_nolocking(pTHX_ SV *sv) +bool +Perl_is_uni_space(pTHX_ UV c) { PERL_UNUSED_CONTEXT; - PERL_UNUSED_ARG(sv); + return isSPACE_uni(c); } +bool +Perl_is_uni_digit(pTHX_ UV c) +{ + PERL_UNUSED_CONTEXT; + return isDIGIT_uni(c); +} -/* -=for apidoc sv_nounlocking +bool +Perl_is_uni_upper(pTHX_ UV c) +{ + PERL_UNUSED_CONTEXT; + return isUPPER_uni(c); +} -Dummy routine which "unlocks" an SV when there is no locking module present. -Exists to avoid test for a NULL function pointer and because it could -potentially warn under some level of strict-ness. +bool +Perl_is_uni_lower(pTHX_ UV c) +{ + PERL_UNUSED_CONTEXT; + return isLOWER_uni(c); +} -"Superseded" by sv_nosharing(). +bool +Perl_is_uni_cntrl(pTHX_ UV c) +{ + PERL_UNUSED_CONTEXT; + return isCNTRL_L1(c); +} -=cut -*/ +bool +Perl_is_uni_graph(pTHX_ UV c) +{ + PERL_UNUSED_CONTEXT; + return isGRAPH_uni(c); +} -void -Perl_sv_nounlocking(pTHX_ SV *sv) +bool +Perl_is_uni_print(pTHX_ UV c) { PERL_UNUSED_CONTEXT; - PERL_UNUSED_ARG(sv); + return isPRINT_uni(c); } -void -Perl_save_long(pTHX_ long int *longp) +bool +Perl_is_uni_punct(pTHX_ UV c) { - dVAR; - SSCHECK(3); - SSPUSHLONG(*longp); - SSPUSHPTR(longp); - SSPUSHINT(SAVEt_LONG); + PERL_UNUSED_CONTEXT; + return isPUNCT_uni(c); } -void -Perl_save_iv(pTHX_ IV *ivp) +bool +Perl_is_uni_xdigit(pTHX_ UV c) { - dVAR; - SSCHECK(3); - SSPUSHIV(*ivp); - SSPUSHPTR(ivp); - SSPUSHINT(SAVEt_IV); + PERL_UNUSED_CONTEXT; + return isXDIGIT_uni(c); } -void -Perl_save_nogv(pTHX_ GV *gv) +bool +Perl_is_uni_alnum_lc(pTHX_ UV c) { - dVAR; - SSCHECK(2); - SSPUSHPTR(gv); - SSPUSHINT(SAVEt_NSTAB); + PERL_UNUSED_CONTEXT; + return isWORDCHAR_LC_uvchr(c); } -void -Perl_save_list(pTHX_ register SV **sarg, I32 maxsarg) +bool +Perl_is_uni_alnumc_lc(pTHX_ UV c) { - dVAR; - register I32 i; + PERL_UNUSED_CONTEXT; + return isALPHANUMERIC_LC_uvchr(c); +} - for (i = 1; i <= maxsarg; i++) { - register SV * const sv = newSV(0); - sv_setsv(sv,sarg[i]); - SSCHECK(3); - SSPUSHPTR(sarg[i]); /* remember the pointer */ - SSPUSHPTR(sv); /* remember the value */ - SSPUSHINT(SAVEt_ITEM); - } +bool +Perl_is_uni_idfirst_lc(pTHX_ UV c) +{ + PERL_UNUSED_CONTEXT; + /* XXX Should probably be something that resolves to the old IDFIRST, but + * this function is deprecated, so not bothering */ + return isIDFIRST_LC_uvchr(c); } -/* -=for apidoc sv_usepvn_mg +bool +Perl_is_uni_alpha_lc(pTHX_ UV c) +{ + PERL_UNUSED_CONTEXT; + return isALPHA_LC_uvchr(c); +} -Like C, but also handles 'set' magic. +bool +Perl_is_uni_ascii_lc(pTHX_ UV c) +{ + PERL_UNUSED_CONTEXT; + return isASCII_LC_uvchr(c); +} -=cut -*/ +bool +Perl_is_uni_blank_lc(pTHX_ UV c) +{ + PERL_UNUSED_CONTEXT; + return isBLANK_LC_uvchr(c); +} -void -Perl_sv_usepvn_mg(pTHX_ SV *sv, char *ptr, STRLEN len) +bool +Perl_is_uni_space_lc(pTHX_ UV c) { - sv_usepvn_flags(sv,ptr,len, SV_SMAGIC); + PERL_UNUSED_CONTEXT; + return isSPACE_LC_uvchr(c); } -/* -=for apidoc sv_usepvn +bool +Perl_is_uni_digit_lc(pTHX_ UV c) +{ + return isDIGIT_LC_uvchr(c); +} -Tells an SV to use C to find its string value. Implemented by -calling C with C of 0, hence does not handle 'set' -magic. See C. +bool +Perl_is_uni_idfirst(pTHX_ UV c) +{ + U8 tmpbuf[UTF8_MAXBYTES+1]; + uvchr_to_utf8(tmpbuf, c); + return _is_utf8_idstart(tmpbuf); +} -=cut -*/ +bool +Perl_is_utf8_idfirst(pTHX_ const U8 *p) /* The naming is historical. */ +{ + PERL_ARGS_ASSERT_IS_UTF8_IDFIRST; -void -Perl_sv_usepvn(pTHX_ SV *sv, char *ptr, STRLEN len) + return _is_utf8_idstart(p); +} + +bool +Perl_is_utf8_xidfirst(pTHX_ const U8 *p) /* The naming is historical. */ { - sv_usepvn_flags(sv,ptr,len, 0); + PERL_ARGS_ASSERT_IS_UTF8_XIDFIRST; + + return _is_utf8_xidstart(p); } -void -Perl_cv_ckproto(pTHX_ const CV *cv, const GV *gv, const char *p) +bool +Perl_is_utf8_idcont(pTHX_ const U8 *p) { - cv_ckproto_len(cv, gv, p, p ? strlen(p) : 0); + PERL_ARGS_ASSERT_IS_UTF8_IDCONT; + + return _is_utf8_idcont(p); } -/* -=for apidoc unpack_str +bool +Perl_is_utf8_xidcont(pTHX_ const U8 *p) +{ + PERL_ARGS_ASSERT_IS_UTF8_XIDCONT; -The engine implementing unpack() Perl function. Note: parameters strbeg, new_s -and ocnt are not used. This call should not be used, use unpackstring instead. + return _is_utf8_xidcont(p); +} -=cut */ +bool +Perl_is_uni_upper_lc(pTHX_ UV c) +{ + return isUPPER_LC_uvchr(c); +} -I32 -Perl_unpack_str(pTHX_ const char *pat, const char *patend, const char *s, - const char *strbeg, const char *strend, char **new_s, I32 ocnt, - U32 flags) +bool +Perl_is_uni_lower_lc(pTHX_ UV c) { - PERL_UNUSED_ARG(strbeg); - PERL_UNUSED_ARG(new_s); - PERL_UNUSED_ARG(ocnt); + return isLOWER_LC_uvchr(c); +} - return unpackstring(pat, patend, s, strend, flags); +bool +Perl_is_uni_cntrl_lc(pTHX_ UV c) +{ + return isCNTRL_LC_uvchr(c); } -/* -=for apidoc pack_cat +bool +Perl_is_uni_graph_lc(pTHX_ UV c) +{ + return isGRAPH_LC_uvchr(c); +} -The engine implementing pack() Perl function. Note: parameters next_in_list and -flags are not used. This call should not be used; use packlist instead. +bool +Perl_is_uni_print_lc(pTHX_ UV c) +{ + return isPRINT_LC_uvchr(c); +} -=cut -*/ +bool +Perl_is_uni_punct_lc(pTHX_ UV c) +{ + return isPUNCT_LC_uvchr(c); +} -void -Perl_pack_cat(pTHX_ SV *cat, const char *pat, const char *patend, register SV **beglist, SV **endlist, SV ***next_in_list, U32 flags) +bool +Perl_is_uni_xdigit_lc(pTHX_ UV c) { - PERL_UNUSED_ARG(next_in_list); - PERL_UNUSED_ARG(flags); + return isXDIGIT_LC_uvchr(c); +} - packlist(cat, pat, patend, beglist, endlist); +U32 +Perl_to_uni_upper_lc(pTHX_ U32 c) +{ + /* XXX returns only the first character -- do not use XXX */ + /* XXX no locale support yet */ + STRLEN len; + U8 tmpbuf[UTF8_MAXBYTES_CASE+1]; + return (U32)to_uni_upper(c, tmpbuf, &len); } -HE * -Perl_hv_store_ent(pTHX_ HV *hv, SV *keysv, SV *val, U32 hash) +U32 +Perl_to_uni_title_lc(pTHX_ U32 c) { - return (HE *)hv_common(hv, keysv, NULL, 0, 0, HV_FETCH_ISSTORE, val, hash); + /* XXX returns only the first character XXX -- do not use XXX */ + /* XXX no locale support yet */ + STRLEN len; + U8 tmpbuf[UTF8_MAXBYTES_CASE+1]; + return (U32)to_uni_title(c, tmpbuf, &len); +} + +U32 +Perl_to_uni_lower_lc(pTHX_ U32 c) +{ + /* XXX returns only the first character -- do not use XXX */ + /* XXX no locale support yet */ + STRLEN len; + U8 tmpbuf[UTF8_MAXBYTES_CASE+1]; + return (U32)to_uni_lower(c, tmpbuf, &len); } bool -Perl_hv_exists_ent(pTHX_ HV *hv, SV *keysv, U32 hash) +Perl_is_utf8_alnum(pTHX_ const U8 *p) { - return hv_common(hv, keysv, NULL, 0, 0, HV_FETCH_ISEXISTS, 0, hash) - ? TRUE : FALSE; + PERL_ARGS_ASSERT_IS_UTF8_ALNUM; + + /* NOTE: "IsWord", not "IsAlnum", since Alnum is a true + * descendant of isalnum(3), in other words, it doesn't + * contain the '_'. --jhi */ + return isWORDCHAR_utf8(p); } -HE * -Perl_hv_fetch_ent(pTHX_ HV *hv, SV *keysv, I32 lval, U32 hash) +bool +Perl_is_utf8_alnumc(pTHX_ const U8 *p) { - return (HE *)hv_common(hv, keysv, NULL, 0, 0, - (lval ? HV_FETCH_LVALUE : 0), NULL, hash); + PERL_ARGS_ASSERT_IS_UTF8_ALNUMC; + + return isALPHANUMERIC_utf8(p); } -SV * -Perl_hv_delete_ent(pTHX_ HV *hv, SV *keysv, I32 flags, U32 hash) +bool +Perl_is_utf8_alpha(pTHX_ const U8 *p) { - return (SV *) hv_common(hv, keysv, NULL, 0, 0, flags | HV_DELETE, NULL, - hash); + PERL_ARGS_ASSERT_IS_UTF8_ALPHA; + + return isALPHA_utf8(p); } -SV** -Perl_hv_store_flags(pTHX_ HV *hv, const char *key, I32 klen, SV *val, U32 hash, - int flags) +bool +Perl_is_utf8_ascii(pTHX_ const U8 *p) { - return (SV**) hv_common(hv, NULL, key, klen, flags, - (HV_FETCH_ISSTORE|HV_FETCH_JUST_SV), val, hash); + PERL_ARGS_ASSERT_IS_UTF8_ASCII; + PERL_UNUSED_CONTEXT; + + return isASCII_utf8(p); } -SV** -Perl_hv_store(pTHX_ HV *hv, const char *key, I32 klen_i32, SV *val, U32 hash) +bool +Perl_is_utf8_blank(pTHX_ const U8 *p) { - STRLEN klen; - int flags; + PERL_ARGS_ASSERT_IS_UTF8_BLANK; + PERL_UNUSED_CONTEXT; - if (klen_i32 < 0) { - klen = -klen_i32; - flags = HVhek_UTF8; - } else { - klen = klen_i32; - flags = 0; - } - return (SV **) hv_common(hv, NULL, key, klen, flags, - (HV_FETCH_ISSTORE|HV_FETCH_JUST_SV), val, hash); + return isBLANK_utf8(p); } bool -Perl_hv_exists(pTHX_ HV *hv, const char *key, I32 klen_i32) +Perl_is_utf8_space(pTHX_ const U8 *p) { - STRLEN klen; - int flags; + PERL_ARGS_ASSERT_IS_UTF8_SPACE; + PERL_UNUSED_CONTEXT; - if (klen_i32 < 0) { - klen = -klen_i32; - flags = HVhek_UTF8; - } else { - klen = klen_i32; - flags = 0; - } - return hv_common(hv, NULL, key, klen, flags, HV_FETCH_ISEXISTS, 0, 0) - ? TRUE : FALSE; + return isSPACE_utf8(p); } -SV** -Perl_hv_fetch(pTHX_ HV *hv, const char *key, I32 klen_i32, I32 lval) +bool +Perl_is_utf8_perl_space(pTHX_ const U8 *p) { - STRLEN klen; - int flags; + PERL_ARGS_ASSERT_IS_UTF8_PERL_SPACE; + PERL_UNUSED_CONTEXT; - if (klen_i32 < 0) { - klen = -klen_i32; - flags = HVhek_UTF8; - } else { - klen = klen_i32; - flags = 0; - } - return (SV **) hv_common(hv, NULL, key, klen, flags, - lval ? (HV_FETCH_JUST_SV | HV_FETCH_LVALUE) - : HV_FETCH_JUST_SV, NULL, 0); + /* Only true if is an ASCII space-like character, and ASCII is invariant + * under utf8, so can just use the macro */ + return isSPACE_A(*p); } -SV * -Perl_hv_delete(pTHX_ HV *hv, const char *key, I32 klen_i32, I32 flags) +bool +Perl_is_utf8_perl_word(pTHX_ const U8 *p) { - STRLEN klen; - int k_flags; + PERL_ARGS_ASSERT_IS_UTF8_PERL_WORD; + PERL_UNUSED_CONTEXT; - if (klen_i32 < 0) { - klen = -klen_i32; - k_flags = HVhek_UTF8; - } else { - klen = klen_i32; - k_flags = 0; - } - return (SV *) hv_common(hv, NULL, key, klen, k_flags, flags | HV_DELETE, - NULL, 0); + /* Only true if is an ASCII word character, and ASCII is invariant + * under utf8, so can just use the macro */ + return isWORDCHAR_A(*p); +} + +bool +Perl_is_utf8_digit(pTHX_ const U8 *p) +{ + PERL_ARGS_ASSERT_IS_UTF8_DIGIT; + + return isDIGIT_utf8(p); +} + +bool +Perl_is_utf8_posix_digit(pTHX_ const U8 *p) +{ + PERL_ARGS_ASSERT_IS_UTF8_POSIX_DIGIT; + PERL_UNUSED_CONTEXT; + + /* Only true if is an ASCII digit character, and ASCII is invariant + * under utf8, so can just use the macro */ + return isDIGIT_A(*p); +} + +bool +Perl_is_utf8_upper(pTHX_ const U8 *p) +{ + PERL_ARGS_ASSERT_IS_UTF8_UPPER; + + return isUPPER_utf8(p); +} + +bool +Perl_is_utf8_lower(pTHX_ const U8 *p) +{ + PERL_ARGS_ASSERT_IS_UTF8_LOWER; + + return isLOWER_utf8(p); +} + +bool +Perl_is_utf8_cntrl(pTHX_ const U8 *p) +{ + PERL_ARGS_ASSERT_IS_UTF8_CNTRL; + PERL_UNUSED_CONTEXT; + + return isCNTRL_utf8(p); +} + +bool +Perl_is_utf8_graph(pTHX_ const U8 *p) +{ + PERL_ARGS_ASSERT_IS_UTF8_GRAPH; + + return isGRAPH_utf8(p); +} + +bool +Perl_is_utf8_print(pTHX_ const U8 *p) +{ + PERL_ARGS_ASSERT_IS_UTF8_PRINT; + + return isPRINT_utf8(p); +} + +bool +Perl_is_utf8_punct(pTHX_ const U8 *p) +{ + PERL_ARGS_ASSERT_IS_UTF8_PUNCT; + + return isPUNCT_utf8(p); +} + +bool +Perl_is_utf8_xdigit(pTHX_ const U8 *p) +{ + PERL_ARGS_ASSERT_IS_UTF8_XDIGIT; + PERL_UNUSED_CONTEXT; + + return isXDIGIT_utf8(p); +} + +bool +Perl_is_utf8_mark(pTHX_ const U8 *p) +{ + PERL_ARGS_ASSERT_IS_UTF8_MARK; + + return _is_utf8_mark(p); +} + +/* +=for apidoc is_utf8_char + +Tests if some arbitrary number of bytes begins in a valid UTF-8 +character. Note that an INVARIANT (i.e. ASCII on non-EBCDIC machines) +character is a valid UTF-8 character. The actual number of bytes in the UTF-8 +character will be returned if it is valid, otherwise 0. + +This function is deprecated due to the possibility that malformed input could +cause reading beyond the end of the input buffer. Use L +instead. + +=cut */ + +STRLEN +Perl_is_utf8_char(const U8 *s) +{ + PERL_ARGS_ASSERT_IS_UTF8_CHAR; + + /* Assumes we have enough space, which is why this is deprecated */ + return isUTF8_CHAR(s, s + UTF8SKIP(s)); +} + +/* DEPRECATED! + * Like L(), but should only be called when it is known that + * there are no malformations in the input UTF-8 string C. Surrogates, + * non-character code points, and non-Unicode code points are allowed */ + +UV +Perl_valid_utf8_to_uvuni(pTHX_ const U8 *s, STRLEN *retlen) +{ + PERL_ARGS_ASSERT_VALID_UTF8_TO_UVUNI; + + return NATIVE_TO_UNI(valid_utf8_to_uvchr(s, retlen)); +} + +/* +=for apidoc utf8_to_uvchr + +Returns the native code point of the first character in the string C +which is assumed to be in UTF-8 encoding; C will be set to the +length, in bytes, of that character. + +Some, but not all, UTF-8 malformations are detected, and in fact, some +malformed input could cause reading beyond the end of the input buffer, which +is why this function is deprecated. Use L instead. + +If C points to one of the detected malformations, and UTF8 warnings are +enabled, zero is returned and C<*retlen> is set (if C isn't +NULL) to -1. If those warnings are off, the computed value if well-defined (or +the Unicode REPLACEMENT CHARACTER, if not) is silently returned, and C<*retlen> +is set (if C isn't NULL) so that (S + C<*retlen>>) is the +next possible position in C that could begin a non-malformed character. +See L for details on when the REPLACEMENT CHARACTER is returned. + +=cut +*/ + +UV +Perl_utf8_to_uvchr(pTHX_ const U8 *s, STRLEN *retlen) +{ + PERL_ARGS_ASSERT_UTF8_TO_UVCHR; + + return utf8_to_uvchr_buf(s, s + UTF8_MAXBYTES, retlen); } +/* +=for apidoc utf8_to_uvuni + +Returns the Unicode code point of the first character in the string C +which is assumed to be in UTF-8 encoding; C will be set to the +length, in bytes, of that character. + +Some, but not all, UTF-8 malformations are detected, and in fact, some +malformed input could cause reading beyond the end of the input buffer, which +is one reason why this function is deprecated. The other is that only in +extremely limited circumstances should the Unicode versus native code point be +of any interest to you. See L for alternatives. + +If C points to one of the detected malformations, and UTF8 warnings are +enabled, zero is returned and C<*retlen> is set (if C doesn't point to +NULL) to -1. If those warnings are off, the computed value if well-defined (or +the Unicode REPLACEMENT CHARACTER, if not) is silently returned, and C<*retlen> +is set (if C isn't NULL) so that (S + C<*retlen>>) is the +next possible position in C that could begin a non-malformed character. +See L for details on when the REPLACEMENT CHARACTER is returned. + +=cut +*/ + +UV +Perl_utf8_to_uvuni(pTHX_ const U8 *s, STRLEN *retlen) +{ + PERL_ARGS_ASSERT_UTF8_TO_UVUNI; + + return NATIVE_TO_UNI(valid_utf8_to_uvchr(s, retlen)); +} + +void +Perl_save_re_context(pTHX) +{ + PERL_UNUSED_CONTEXT; +} + + +END_EXTERN_C + #endif /* NO_MATHOMS */ /* * Local variables: * c-indentation-style: bsd * c-basic-offset: 4 - * indent-tabs-mode: t + * indent-tabs-mode: nil * End: * - * ex: set ts=8 sts=4 sw=4 noet: + * ex: set ts=8 sts=4 sw=4 et: */