X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/78ac7dd9596fbc525d458adec628f7d991dfe43a..5fb16bc2f629b3605aa692906fc9f1f897b97acc:/mathoms.c diff --git a/mathoms.c b/mathoms.c index 1ea9f34..295d8c4 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,66 +9,67 @@ */ /* - * "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 - * versions of Perl. For binary or source compatibility reasons, though, - * we cannot completely remove them from the core code. + * versions of Perl which we cannot completely remove from the core + * code. There are two reasons functions should be here: + * + * 1) A function has been been replaced by a macro within a minor release, + * so XS modules compiled against an older release will expect to + * still be able to link against the function + * 2) A function Perl_foo(...) with #define foo Perl_foo(aTHX_ ...) + * has been replaced by a macro, e.g. #define foo(...) foo_flags(...,0) + * but XS code may still explicitly use the long form, i.e. + * Perl_foo(aTHX_ ...) + * + * NOTE: ALL FUNCTIONS IN THIS FILE should have an entry with the 'b' flag in + * embed.fnc. + * + * To move a function to this file, simply cut and paste it here, and change + * its embed.fnc entry to additionally have the 'b' flag. If, for some reason + * a function you'd like to be treated as mathoms can't be moved from its + * current place, simply enclose it between + * + * #ifndef NO_MATHOMS + * ... + * #endif + * + * and add the 'b' flag in embed.fnc. * - * SMP - Oct. 24, 2005 + * The compilation of this file can be suppressed; see INSTALL * + * Some blurb for perlapi.pod: + +=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" -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 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 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 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 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); -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); +#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 /* ref() is now a macro using Perl_doref; * this version provided for binary compatibility only. @@ -84,7 +86,7 @@ Perl_ref(pTHX_ OP *o, I32 type) Unsets the RV status of the SV, and decrements the reference count of whatever was being referenced by the RV. This can almost be thought of as a reversal of C. This is C with the C -being zero. See C. +being zero. See C>. =cut */ @@ -92,19 +94,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); } @@ -113,8 +120,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); } @@ -123,32 +132,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); } @@ -164,8 +190,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); } @@ -181,8 +209,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); } @@ -191,14 +221,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 C. 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); } @@ -207,8 +239,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); } @@ -219,6 +253,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); } @@ -231,8 +267,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); } @@ -241,8 +279,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); } @@ -255,8 +295,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); } @@ -264,14 +306,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); @@ -284,14 +328,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); @@ -304,14 +350,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); @@ -325,7 +373,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 */ @@ -333,6 +381,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); @@ -342,8 +392,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); @@ -358,6 +410,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); @@ -371,6 +425,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); } @@ -381,6 +437,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); } @@ -393,7 +451,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 @@ -402,6 +460,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); } @@ -413,6 +473,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); } @@ -425,7 +487,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 @@ -434,6 +496,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); } @@ -443,18 +507,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 @@ -462,8 +537,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)) @@ -487,6 +570,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 ? "*" : ""); } @@ -494,25 +579,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 */ @@ -520,55 +611,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); @@ -581,6 +662,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"; @@ -590,17 +674,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 @@ -611,751 +689,1101 @@ Perl_init_i18nl14n(pTHX_ int printwarn) return init_i18nl10n(printwarn); } -OP * -Perl_oopsCV(pTHX_ OP *o) +bool +Perl_is_utf8_string_loc(const U8 *s, const STRLEN len, const U8 **ep) { - Perl_croak(aTHX_ "NOT IMPL LINE %d",__LINE__); - /* STUB */ - PERL_UNUSED_ARG(o); - NORETURN_FUNCTION_END; -} + PERL_ARGS_ASSERT_IS_UTF8_STRING_LOC; -PP(pp_padany) -{ - DIE(aTHX_ "NOT IMPL LINE %d",__LINE__); + return is_utf8_string_loclen(s, len, ep, 0); } -PP(pp_mapstart) -{ - DIE(aTHX_ "panic: mapstart"); /* uses grepstart */ -} +/* +=for apidoc sv_nolocking -/* These ops all have the same body as pp_null. */ -PP(pp_scalar) -{ - dVAR; - return NORMAL; -} +Dummy routine which "locks" an SV when there is no locking module present. +Exists to avoid test for a C function pointer and because it could +potentially warn under some level of strict-ness. -PP(pp_regcmaybe) -{ - dVAR; - return NORMAL; -} +"Superseded" by C. -PP(pp_lineseq) -{ - dVAR; - return NORMAL; -} +=cut +*/ -PP(pp_scope) +void +Perl_sv_nolocking(pTHX_ SV *sv) { - dVAR; - return NORMAL; + PERL_UNUSED_CONTEXT; + PERL_UNUSED_ARG(sv); } -/* Ops that are calls to do_kv. */ -PP(pp_values) -{ - return do_kv(); -} -PP(pp_keys) -{ - return do_kv(); -} +/* +=for apidoc sv_nounlocking -/* Ops that are simply calls to other ops. */ -PP(pp_dump) -{ - return pp_goto(); - /*NOTREACHED*/ -} +Dummy routine which "unlocks" an SV when there is no locking module present. +Exists to avoid test for a C function pointer and because it could +potentially warn under some level of strict-ness. -PP(pp_dofile) -{ - return pp_require(); -} +"Superseded" by C. -PP(pp_dbmclose) -{ - return pp_untie(); -} +=cut +*/ -PP(pp_read) +void +Perl_sv_nounlocking(pTHX_ SV *sv) { - return pp_sysread(); + PERL_UNUSED_CONTEXT; + PERL_UNUSED_ARG(sv); } -PP(pp_recv) +void +Perl_save_long(pTHX_ long int *longp) { - return pp_sysread(); -} + PERL_ARGS_ASSERT_SAVE_LONG; -PP(pp_seek) -{ - return pp_sysseek(); + SSCHECK(3); + SSPUSHLONG(*longp); + SSPUSHPTR(longp); + SSPUSHUV(SAVEt_LONG); } -PP(pp_fcntl) +void +Perl_save_nogv(pTHX_ GV *gv) { - return pp_ioctl(); -} + PERL_ARGS_ASSERT_SAVE_NOGV; -PP(pp_gsockopt) -{ - return pp_ssockopt(); + SSCHECK(2); + SSPUSHPTR(gv); + SSPUSHUV(SAVEt_NSTAB); } -PP(pp_getsockname) +void +Perl_save_list(pTHX_ SV **sarg, I32 maxsarg) { - return pp_getpeername(); -} + I32 i; -PP(pp_lstat) -{ - return pp_stat(); -} + PERL_ARGS_ASSERT_SAVE_LIST; -PP(pp_fteowned) -{ - return pp_ftrowned(); + 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_ftbinary) -{ - return pp_fttext(); -} +/* +=for apidoc sv_usepvn_mg -PP(pp_localtime) -{ - return pp_gmtime(); -} +Like C, but also handles 'set' magic. -PP(pp_shmget) -{ - return pp_semget(); -} +=cut +*/ -PP(pp_shmctl) +void +Perl_sv_usepvn_mg(pTHX_ SV *sv, char *ptr, STRLEN len) { - return pp_semctl(); -} + PERL_ARGS_ASSERT_SV_USEPVN_MG; -PP(pp_shmread) -{ - return pp_shmwrite(); + sv_usepvn_flags(sv,ptr,len, SV_SMAGIC); } -PP(pp_msgget) -{ - return pp_semget(); -} +/* +=for apidoc sv_usepvn -PP(pp_msgctl) -{ - return pp_semctl(); -} +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_ghbyname) -{ - return pp_ghostent(); -} +=cut +*/ -PP(pp_ghbyaddr) +void +Perl_sv_usepvn(pTHX_ SV *sv, char *ptr, STRLEN len) { - return pp_ghostent(); -} + PERL_ARGS_ASSERT_SV_USEPVN; -PP(pp_gnbyname) -{ - return pp_gnetent(); + sv_usepvn_flags(sv,ptr,len, 0); } -PP(pp_gnbyaddr) -{ - return pp_gnetent(); -} +/* +=for apidoc unpack_str -PP(pp_gpbyname) -{ - return pp_gprotoent(); -} +The engine implementing C Perl function. Note: parameters C, +C and C are not used. This call should not be used, use +C instead. -PP(pp_gpbynumber) -{ - return pp_gprotoent(); -} +=cut */ -PP(pp_gsbyname) +SSize_t +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_gservent(); -} + PERL_ARGS_ASSERT_UNPACK_STR; -PP(pp_gsbyport) -{ - return pp_gservent(); -} + PERL_UNUSED_ARG(strbeg); + PERL_UNUSED_ARG(new_s); + PERL_UNUSED_ARG(ocnt); -PP(pp_gpwnam) -{ - return pp_gpwent(); + return unpackstring(pat, patend, s, strend, flags); } -PP(pp_gpwuid) -{ - return pp_gpwent(); -} +/* +=for apidoc pack_cat -PP(pp_ggrnam) -{ - return pp_ggrent(); -} +The engine implementing C Perl function. Note: parameters +C and C are not used. This call should not be used; use +C instead. -PP(pp_ggrgid) -{ - return pp_ggrent(); -} +=cut +*/ -PP(pp_ftsize) +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_ftmtime) -{ - return pp_ftis(); -} + PERL_UNUSED_ARG(next_in_list); + PERL_UNUSED_ARG(flags); -PP(pp_ftatime) -{ - return pp_ftis(); + packlist(cat, pat, patend, beglist, endlist); } -PP(pp_ftctime) +HE * +Perl_hv_store_ent(pTHX_ HV *hv, SV *keysv, SV *val, U32 hash) { - return pp_ftis(); + return (HE *)hv_common(hv, keysv, NULL, 0, 0, HV_FETCH_ISSTORE, val, hash); } -PP(pp_ftzero) +bool +Perl_hv_exists_ent(pTHX_ HV *hv, SV *keysv, U32 hash) { - return pp_ftrowned(); -} + PERL_ARGS_ASSERT_HV_EXISTS_ENT; -PP(pp_ftsock) -{ - return pp_ftrowned(); + return cBOOL(hv_common(hv, keysv, NULL, 0, 0, HV_FETCH_ISEXISTS, 0, hash)); } -PP(pp_ftchr) +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_ftblk) -{ - return pp_ftrowned(); + return (HE *)hv_common(hv, keysv, NULL, 0, 0, + (lval ? HV_FETCH_LVALUE : 0), NULL, hash); } -PP(pp_ftfile) +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_ftdir) -{ - return pp_ftrowned(); + return MUTABLE_SV(hv_common(hv, keysv, NULL, 0, 0, flags | HV_DELETE, NULL, + hash)); } -PP(pp_ftpipe) +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_ftsuid) +SV** +Perl_hv_store(pTHX_ HV *hv, const char *key, I32 klen_i32, SV *val, U32 hash) { - return pp_ftrowned(); -} + STRLEN klen; + int flags; -PP(pp_ftsgid) -{ - return pp_ftrowned(); + 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_ftsvtx) +bool +Perl_hv_exists(pTHX_ HV *hv, const char *key, I32 klen_i32) { - return pp_ftrowned(); -} + STRLEN klen; + int flags; -PP(pp_unlink) -{ - return pp_chown(); -} + PERL_ARGS_ASSERT_HV_EXISTS; -PP(pp_chmod) -{ - return pp_chown(); + if (klen_i32 < 0) { + klen = -klen_i32; + flags = HVhek_UTF8; + } else { + klen = klen_i32; + flags = 0; + } + return cBOOL(hv_common(hv, NULL, key, klen, flags, HV_FETCH_ISEXISTS, 0, 0)); } -PP(pp_utime) +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_kill) +SV * +Perl_hv_delete(pTHX_ HV *hv, const char *key, I32 klen_i32, I32 flags) { - return pp_chown(); + 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_symlink) +AV * +Perl_newAV(pTHX) { - return pp_link(); + 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_ftrwrite) +HV * +Perl_newHV(pTHX) { - return pp_ftrread(); + HV * const hv = MUTABLE_HV(newSV_type(SVt_PVHV)); + assert(!SvOK(hv)); + + return hv; } -PP(pp_ftrexec) +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_fteread) +void +Perl_save_freesv(pTHX_ SV *sv) { - return pp_ftrread(); + save_freesv(sv); } -PP(pp_ftewrite) +void +Perl_save_mortalizesv(pTHX_ SV *sv) { - return pp_ftrread(); + PERL_ARGS_ASSERT_SAVE_MORTALIZESV; + + save_mortalizesv(sv); } -PP(pp_fteexec) +void +Perl_save_freeop(pTHX_ OP *o) { - return pp_ftrread(); + save_freeop(o); } -PP(pp_msgsnd) +void +Perl_save_freepv(pTHX_ char *pv) { - return pp_shmwrite(); + save_freepv(pv); } -PP(pp_msgrcv) +void +Perl_save_op(pTHX) { - return pp_shmwrite(); + save_op(); } -PP(pp_syswrite) +#ifdef PERL_DONT_CREATE_GVSV +GV * +Perl_gv_SVadd(pTHX_ GV *gv) { - return pp_send(); + return gv_SVadd(gv); } +#endif -PP(pp_semop) +GV * +Perl_gv_AVadd(pTHX_ GV *gv) { - return pp_shmwrite(); + return gv_AVadd(gv); } -PP(pp_dor) +GV * +Perl_gv_HVadd(pTHX_ GV *gv) { - return pp_defined(); + return gv_HVadd(gv); } -PP(pp_andassign) +GV * +Perl_gv_IOadd(pTHX_ GV *gv) { - return pp_and(); + return gv_IOadd(gv); } -PP(pp_orassign) +IO * +Perl_newIO(pTHX) { - return pp_or(); + return MUTABLE_IO(newSV_type(SVt_PVIO)); } -PP(pp_dorassign) +I32 +Perl_my_stat(pTHX) { - return pp_defined(); -} + return my_stat_flags(SV_GMAGIC); +} -PP(pp_lcfirst) +I32 +Perl_my_lstat(pTHX) { - return pp_ucfirst(); + return my_lstat_flags(SV_GMAGIC); } -PP(pp_slt) +I32 +Perl_sv_eq(pTHX_ SV *sv1, SV *sv2) { - return pp_sle(); + return sv_eq_flags(sv1, sv2, SV_GMAGIC); } -PP(pp_sgt) +#ifdef USE_LOCALE_COLLATE +char * +Perl_sv_collxfrm(pTHX_ SV *const sv, STRLEN *const nxp) { - return pp_sle(); + return sv_collxfrm_flags(sv, nxp, SV_GMAGIC); } -PP(pp_sge) +char * +Perl_mem_collxfrm(pTHX_ const char *input_string, STRLEN len, STRLEN *xlen) { - return pp_sle(); + /* This function is retained for compatibility in case someone outside core + * is using this (but it is undocumented) */ + + PERL_ARGS_ASSERT_MEM_COLLXFRM; + + return _mem_collxfrm(input_string, len, xlen, FALSE); } -PP(pp_rindex) +#endif + +bool +Perl_sv_2bool(pTHX_ SV *const sv) { - return pp_index(); + return sv_2bool_flags(sv, SV_GMAGIC); } -PP(pp_hex) + +/* +=for apidoc custom_op_name +Return the name for a given custom op. This was once used by the C +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 +C 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_oct(); + PERL_ARGS_ASSERT_CUSTOM_OP_NAME; + return XopENTRYCUSTOM(o, xop_name); } -PP(pp_pop) +const char* +Perl_custom_op_desc(pTHX_ const OP* o) { - return pp_shift(); + PERL_ARGS_ASSERT_CUSTOM_OP_DESC; + return XopENTRYCUSTOM(o, xop_desc); } -PP(pp_cos) +CV * +Perl_newSUB(pTHX_ I32 floor, OP *o, OP *proto, OP *block) { - return pp_sin(); + return newATTRSUB(floor, o, proto, NULL, block); } -PP(pp_exp) +UV +Perl_to_utf8_fold(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp) { - return pp_sin(); + PERL_ARGS_ASSERT_TO_UTF8_FOLD; + + return toFOLD_utf8(p, ustrp, lenp); } -PP(pp_log) +UV +Perl_to_utf8_lower(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp) { - return pp_sin(); + PERL_ARGS_ASSERT_TO_UTF8_LOWER; + + return toLOWER_utf8(p, ustrp, lenp); } -PP(pp_sqrt) +UV +Perl_to_utf8_title(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp) { - return pp_sin(); + PERL_ARGS_ASSERT_TO_UTF8_TITLE; + + return toTITLE_utf8(p, ustrp, lenp); } -PP(pp_bit_xor) +UV +Perl_to_utf8_upper(pTHX_ const U8 *p, U8* ustrp, STRLEN *lenp) { - return pp_bit_or(); + PERL_ARGS_ASSERT_TO_UTF8_UPPER; + + return toUPPER_utf8(p, ustrp, lenp); } -PP(pp_rv2hv) +SV * +Perl_sv_mortalcopy(pTHX_ SV *const oldstr) { - return Perl_pp_rv2av(aTHX); + return Perl_sv_mortalcopy_flags(aTHX_ oldstr, SV_GMAGIC); } -U8 * -Perl_uvuni_to_utf8(pTHX_ U8 *d, UV uv) +void +Perl_sv_copypv(pTHX_ SV *const dsv, SV *const ssv) { - return Perl_uvuni_to_utf8_flags(aTHX_ d, uv, 0); + PERL_ARGS_ASSERT_SV_COPYPV; + + sv_copypv_flags(dsv, ssv, SV_GMAGIC); +} + +UV /* Made into a function, so can be deprecated */ +NATIVE_TO_NEED(const UV enc, const UV ch) +{ + PERL_UNUSED_ARG(enc); + return ch; +} + +UV /* Made into a function, so can be deprecated */ +ASCII_TO_NEED(const UV enc, const UV ch) +{ + PERL_UNUSED_ARG(enc); + return ch; +} + +bool /* Made into a function, so can be deprecated */ +Perl_isIDFIRST_lazy(pTHX_ const char* p) +{ + PERL_ARGS_ASSERT_ISIDFIRST_LAZY; + + return isIDFIRST_lazy_if(p,1); +} + +bool /* Made into a function, so can be deprecated */ +Perl_isALNUM_lazy(pTHX_ const char* p) +{ + 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); } -/* Functions after here were made mathoms post 5.10.0 but pre 5.8.9 */ -int -Perl_magic_setglob(pTHX_ SV *sv, MAGIC *mg) +bool +Perl_is_utf8_digit(pTHX_ const U8 *p) { - PERL_UNUSED_ARG(mg); - PERL_UNUSED_ARG(sv); + PERL_ARGS_ASSERT_IS_UTF8_DIGIT; - Perl_croak(aTHX_ "Perl_magic_setglob is dead code?"); + return isDIGIT_utf8(p); +} - return 0; +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); } -AV * -Perl_newAV(pTHX) +bool +Perl_is_utf8_upper(pTHX_ const U8 *p) { - return (AV*)newSV_type(SVt_PVAV); - /* sv_upgrade does AvREAL_only(): - AvALLOC(av) = 0; - AvARRAY(av) = NULL; - AvMAX(av) = AvFILLp(av) = -1; */ + 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)); +} + +/* +=for apidoc is_utf8_char_buf + +This is identical to the macro L. + +=cut */ + +STRLEN +Perl_is_utf8_char_buf(const U8 *buf, const U8* buf_end) +{ + + PERL_ARGS_ASSERT_IS_UTF8_CHAR_BUF; + + return isUTF8_CHAR(buf, buf_end); +} + +/* 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_UNUSED_CONTEXT; + 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 +C) 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_UNUSED_CONTEXT; + PERL_ARGS_ASSERT_UTF8_TO_UVUNI; + + return NATIVE_TO_UNI(valid_utf8_to_uvchr(s, retlen)); +} + +/* +=for apidoc Am|HV *|pad_compname_type|PADOFFSET po + +Looks up the type of the lexical variable at position C in the +currently-compiling pad. If the variable is typed, the stash of the +class to which it is typed is returned. If not, C is returned. + +=cut +*/ + HV * -Perl_newHV(pTHX) +Perl_pad_compname_type(pTHX_ const PADOFFSET po) { - HV * const hv = (HV*)newSV_type(SVt_PVHV); - assert(!SvOK(hv)); + return PAD_COMPNAME_TYPE(po); +} - return hv; +/* return ptr to little string in big string, NULL if not found */ +/* The original version of this routine was donated by Corey Satten. */ + +char * +Perl_instr(const char *big, const char *little) +{ + PERL_ARGS_ASSERT_INSTR; + + return instr((char *) big, (char *) little); } #endif /* NO_MATHOMS */ /* - * Local variables: - * c-indentation-style: bsd - * c-basic-offset: 4 - * indent-tabs-mode: t - * End: - * - * ex: set ts=8 sts=4 sw=4 noet: + * ex: set ts=8 sts=4 sw=4 et: */