diff options
author | Karl Williamson <khw@cpan.org> | 2022-05-28 15:30:19 -0600 |
---|---|---|
committer | Karl Williamson <khw@cpan.org> | 2022-06-05 09:17:19 -0600 |
commit | 7008caa915ad99e650acf2aea40612b5e48b7ba2 (patch) | |
tree | 1eb682571428a4b70d777fd266e0adb98048e562 /mathoms.c | |
parent | c33e00009fe574949363732c1a4f78e238618755 (diff) | |
download | perl-7008caa915ad99e650acf2aea40612b5e48b7ba2.tar.gz |
Remove deprecated functions
Most of these have been deprecated for a long time; and we've never
bothered to follow through in removing them. This commit does that.
Diffstat (limited to 'mathoms.c')
-rw-r--r-- | mathoms.c | 532 |
1 files changed, 0 insertions, 532 deletions
@@ -301,110 +301,13 @@ Perl_sv_catsv_mg(pTHX_ SV *dsv, SV *sstr) /* =for apidoc_section $SV -=for apidoc sv_iv - -A private implementation of the C<SvIVx> macro for compilers which can't -cope with complex macro expressions. Always use the macro instead. - -=cut -*/ - -IV -Perl_sv_iv(pTHX_ SV *sv) -{ - PERL_ARGS_ASSERT_SV_IV; - - if (SvIOK(sv)) { - if (SvIsUV(sv)) - return (IV)SvUVX(sv); - return SvIVX(sv); - } - return sv_2iv(sv); -} - -/* -=for apidoc_section $SV -=for apidoc sv_uv - -A private implementation of the C<SvUVx> macro for compilers which can't -cope with complex macro expressions. Always use the macro instead. - -=cut -*/ - -UV -Perl_sv_uv(pTHX_ SV *sv) -{ - PERL_ARGS_ASSERT_SV_UV; - - if (SvIOK(sv)) { - if (SvIsUV(sv)) - return SvUVX(sv); - return (UV)SvIVX(sv); - } - return sv_2uv(sv); -} - -/* -=for apidoc_section $SV -=for apidoc sv_nv - -A private implementation of the C<SvNVx> macro for compilers which can't -cope with complex macro expressions. Always use the macro instead. - -=cut -*/ - -NV -Perl_sv_nv(pTHX_ SV *sv) -{ - PERL_ARGS_ASSERT_SV_NV; - - if (SvNOK(sv)) - return SvNVX(sv); - return sv_2nv(sv); -} - -/* -=for apidoc_section $SV =for apidoc sv_pv Use the C<SvPV_nolen> macro instead -=for apidoc_section $SV -=for apidoc sv_pvn - -A private implementation of the C<SvPV> macro for compilers which can't -cope with complex macro expressions. Always use the macro instead. - =cut */ -char * -Perl_sv_pvn(pTHX_ SV *sv, STRLEN *lp) -{ - PERL_ARGS_ASSERT_SV_PVN; - - if (SvPOK(sv)) { - *lp = SvCUR(sv); - return SvPVX(sv); - } - return sv_2pv(sv, lp); -} - - -char * -Perl_sv_pvn_nomg(pTHX_ SV *sv, STRLEN *lp) -{ - PERL_ARGS_ASSERT_SV_PVN_NOMG; - - if (SvPOK(sv)) { - *lp = SvCUR(sv); - return SvPVX(sv); - } - return sv_2pv_flags(sv, lp, 0); -} - /* sv_pv() is now a macro using SvPV_nolen(); * this function provided for binary compatibility only */ @@ -451,24 +354,9 @@ Perl_sv_pvbyte(pTHX_ SV *sv) Use C<SvPVbyte_nolen> instead. -=for apidoc sv_pvbyten - -A private implementation of the C<SvPVbyte> macro for compilers -which can't cope with complex macro expressions. Always use the macro -instead. - =cut */ -char * -Perl_sv_pvbyten(pTHX_ SV *sv, STRLEN *lp) -{ - PERL_ARGS_ASSERT_SV_PVBYTEN; - - sv_utf8_downgrade(sv, FALSE); - return sv_pvn(sv,lp); -} - /* sv_pvutf8 () is now a macro using Perl_sv_2pv_flags(); * this function provided for binary compatibility only */ @@ -482,30 +370,6 @@ Perl_sv_pvutf8(pTHX_ SV *sv) return sv_pv(sv); } -/* -=for apidoc_section $SV -=for apidoc sv_pvutf8 - -Use the C<SvPVutf8_nolen> macro instead - -=for apidoc sv_pvutf8n - -A private implementation of the C<SvPVutf8> macro for compilers -which can't cope with complex macro expressions. Always use the macro -instead. - -=cut -*/ - -char * -Perl_sv_pvutf8n(pTHX_ SV *sv, STRLEN *lp) -{ - PERL_ARGS_ASSERT_SV_PVUTF8N; - - sv_utf8_upgrade(sv); - return sv_pvn(sv,lp); -} - /* sv_utf8_upgrade() is now a macro using sv_utf8_upgrade_flags(); * this function provided for binary compatibility only */ @@ -518,41 +382,6 @@ Perl_sv_utf8_upgrade(pTHX_ SV *sv) return sv_utf8_upgrade_flags(sv, SV_GMAGIC); } -int -Perl_fprintf_nocontext(PerlIO *stream, const char *format, ...) -{ - 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 MULTIPLICITY - PERL_ARGS_ASSERT_FPRINTF_NOCONTEXT; -#endif - - va_start(arglist, format); - ret = PerlIO_vprintf(stream, format, arglist); - va_end(arglist); - return ret; -} - -int -Perl_printf_nocontext(const char *format, ...) -{ - dTHX; - va_list arglist; - int ret = 0; - -#ifdef MULTIPLICITY - PERL_ARGS_ASSERT_PRINTF_NOCONTEXT; -#endif - - va_start(arglist, format); - ret = PerlIO_vprintf(PerlIO_stdout(), format, arglist); - va_end(arglist); - return ret; -} - #if defined(HUGE_VAL) || (defined(USE_LONG_DOUBLE) && defined(HUGE_VALL)) /* * This hack is to force load of "huge" support from libm.a @@ -570,24 +399,6 @@ Perl_huge(void) } #endif -/* compatibility with versions <= 5.003. */ -void -Perl_gv_fullname(pTHX_ SV *sv, const GV *gv) -{ - PERL_ARGS_ASSERT_GV_FULLNAME; - - gv_fullname3(sv, gv, sv == (const SV*)gv ? "*" : ""); -} - -/* compatibility with versions <= 5.003. */ -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) { @@ -647,36 +458,6 @@ Perl_do_open(pTHX_ GV *gv, const char *name, I32 len, int as_raw, supplied_fp, (SV **) NULL, 0); } -bool -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); -} - -int -Perl_do_binmode(pTHX_ PerlIO *fp, int iotype, int mode) -{ - /* The old body of this is now in non-LAYER part of perlio.c - * 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"; -#endif - return PerlIO_binmode(aTHX_ fp, iotype, mode, name); -} - #ifndef OS2 bool Perl_do_aexec(pTHX_ SV *really, SV **mark, SV **sp) @@ -687,13 +468,6 @@ Perl_do_aexec(pTHX_ SV *really, SV **mark, SV **sp) } #endif -/* Backwards compatibility. */ -int -Perl_init_i18nl14n(pTHX_ int printwarn) -{ - return init_i18nl10n(printwarn); -} - bool Perl_is_utf8_string_loc(const U8 *s, const STRLEN len, const U8 **ep) { @@ -748,46 +522,6 @@ Perl_sv_nounlocking(pTHX_ SV *sv) } void -Perl_save_long(pTHX_ long int *longp) -{ - PERL_ARGS_ASSERT_SAVE_LONG; - - SSCHECK(3); - SSPUSHLONG(*longp); - SSPUSHPTR(longp); - SSPUSHUV(SAVEt_LONG); -} - -void -Perl_save_nogv(pTHX_ GV *gv) -{ - PERL_ARGS_ASSERT_SAVE_NOGV; - - SSCHECK(2); - SSPUSHPTR(gv); - SSPUSHUV(SAVEt_NSTAB); -} - -void -Perl_save_list(pTHX_ SV **sarg, I32 maxsarg) -{ - I32 i; - - PERL_ARGS_ASSERT_SAVE_LIST; - - 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); - } -} - -void Perl_sv_usepvn_mg(pTHX_ SV *sv, char *ptr, STRLEN len) { PERL_ARGS_ASSERT_SV_USEPVN_MG; @@ -804,52 +538,6 @@ Perl_sv_usepvn(pTHX_ SV *sv, char *ptr, STRLEN len) sv_usepvn_flags(sv,ptr,len, 0); } -/* -=for apidoc_section $pack -=for apidoc unpack_str - -The engine implementing C<unpack()> Perl function. Note: parameters C<strbeg>, -C<new_s> and C<ocnt> are not used. This call should not be used, use -C<unpackstring> instead. - -=cut */ - -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) -{ - PERL_ARGS_ASSERT_UNPACK_STR; - - PERL_UNUSED_ARG(strbeg); - PERL_UNUSED_ARG(new_s); - PERL_UNUSED_ARG(ocnt); - - return unpackstring(pat, patend, s, strend, flags); -} - -/* -=for apidoc_section $pack -=for apidoc pack_cat - -The engine implementing C<pack()> Perl function. Note: parameters -C<next_in_list> and C<flags> are not used. This call should not be used; use -C<L</packlist>> instead. - -=cut -*/ - -void -Perl_pack_cat(pTHX_ SV *cat, const char *pat, const char *patend, SV **beglist, SV **endlist, SV ***next_in_list, U32 flags) -{ - PERL_ARGS_ASSERT_PACK_CAT; - - PERL_UNUSED_ARG(next_in_list); - PERL_UNUSED_ARG(flags); - - packlist(cat, pat, patend, beglist, endlist); -} - HE * Perl_hv_store_ent(pTHX_ HV *hv, SV *keysv, SV *val, U32 hash) { @@ -1081,17 +769,6 @@ Perl_sv_collxfrm(pTHX_ SV *const sv, STRLEN *const nxp) return sv_collxfrm_flags(sv, nxp, SV_GMAGIC); } -char * -Perl_mem_collxfrm(pTHX_ const char *input_string, STRLEN len, STRLEN *xlen) -{ - /* 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); -} - #endif bool @@ -1101,36 +778,6 @@ Perl_sv_2bool(pTHX_ SV *const sv) return sv_2bool_flags(sv, SV_GMAGIC); } - -/* -=for apidoc_section $custom -=for apidoc custom_op_name -Return the name for a given custom op. This was once used by the C<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 -C<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) -{ - PERL_ARGS_ASSERT_CUSTOM_OP_NAME; - return XopENTRYCUSTOM(o, xop_name); -} - -const char* -Perl_custom_op_desc(pTHX_ const OP* o) -{ - PERL_ARGS_ASSERT_CUSTOM_OP_DESC; - return XopENTRYCUSTOM(o, xop_desc); -} - CV * Perl_newSUB(pTHX_ I32 floor, OP *o, OP *proto, OP *block) { @@ -1151,46 +798,6 @@ Perl_sv_copypv(pTHX_ SV *const dsv, SV *const ssv) 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; -} - -/* -=for apidoc_section $unicode -=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</isUTF8_CHAR> -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. But the - * UTF8_CHK_SKIP(s)) makes it safe for the common case of NUL-terminated - * strings */ - return isUTF8_CHAR(s, s + UTF8_CHK_SKIP(s)); -} - /* =for apidoc_section $unicode =for apidoc is_utf8_char_buf @@ -1208,54 +815,6 @@ Perl_is_utf8_char_buf(const U8 *buf, const U8* buf_end) return isUTF8_CHAR(buf, buf_end); } -/* DEPRECATED! - * Like L</utf8_to_uvuni_buf>(), but should only be called when it is known that - * there are no malformations in the input UTF-8 string C<s>. 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_section $unicode -=for apidoc utf8_to_uvuni - -Returns the Unicode code point of the first character in the string C<s> -which is assumed to be in UTF-8 encoding; C<retlen> 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</utf8_to_uvuni_buf> for alternatives. - -If C<s> points to one of the detected malformations, and UTF8 warnings are -enabled, zero is returned and C<*retlen> is set (if C<retlen> 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<retlen> isn't NULL) so that (S<C<s> + C<*retlen>>) is the -next possible position in C<s> that could begin a non-malformed character. -See L<perlapi/utf8n_to_uvchr> 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_section $pad =for apidoc pad_compname_type @@ -1324,97 +883,6 @@ Perl_uvuni_to_utf8(pTHX_ U8 *d, UV uv) return uvoffuni_to_utf8_flags(d, uv, 0); } -/* -=for apidoc_section $unicode -=for apidoc utf8n_to_uvuni - -Instead use L<perlapi/utf8_to_uvchr_buf>, or rarely, L<perlapi/utf8n_to_uvchr>. - -This function was useful for code that wanted to handle both EBCDIC and -ASCII platforms with Unicode properties, but starting in Perl v5.20, the -distinctions between the platforms have mostly been made invisible to most -code, so this function is quite unlikely to be what you want. If you do need -this precise functionality, use instead -C<L<NATIVE_TO_UNI(utf8_to_uvchr_buf(...))|perlapi/utf8_to_uvchr_buf>> -or C<L<NATIVE_TO_UNI(utf8n_to_uvchr(...))|perlapi/utf8n_to_uvchr>>. - -=cut -*/ - -UV -Perl_utf8n_to_uvuni(pTHX_ const U8 *s, STRLEN curlen, STRLEN *retlen, U32 flags) -{ - PERL_ARGS_ASSERT_UTF8N_TO_UVUNI; - - return NATIVE_TO_UNI(utf8n_to_uvchr(s, curlen, retlen, flags)); -} - -/* -=for apidoc_section $unicode -=for apidoc uvuni_to_utf8_flags - -Instead you almost certainly want to use L<perlapi/uvchr_to_utf8> or -L<perlapi/uvchr_to_utf8_flags>. - -This function is a deprecated synonym for L</uvoffuni_to_utf8_flags>, -which itself, while not deprecated, should be used only in isolated -circumstances. These functions were useful for code that wanted to handle -both EBCDIC and ASCII platforms with Unicode properties, but starting in Perl -v5.20, the distinctions between the platforms have mostly been made invisible -to most code, so this function is quite unlikely to be what you want. - -=cut -*/ - -U8 * -Perl_uvuni_to_utf8_flags(pTHX_ U8 *d, UV uv, UV flags) -{ - PERL_ARGS_ASSERT_UVUNI_TO_UTF8_FLAGS; - - return uvoffuni_to_utf8_flags(d, uv, flags); -} - -/* -=for apidoc_section $unicode -=for apidoc utf8_to_uvchr - -Returns the native code point of the first character in the string C<s> -which is assumed to be in UTF-8 encoding; C<retlen> 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</utf8_to_uvchr_buf> instead. - -If C<s> points to one of the detected malformations, and UTF8 warnings are -enabled, zero is returned and C<*retlen> is set (if C<retlen> isn't -C<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<retlen> isn't NULL) so that (S<C<s> + C<*retlen>>) is the -next possible position in C<s> that could begin a non-malformed character. -See L</utf8n_to_uvchr> 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; - - /* This function is unsafe if malformed UTF-8 input is given it, which is - * why the function is deprecated. If the first byte of the input - * indicates that there are more bytes remaining in the sequence that forms - * the character than there are in the input buffer, it can read past the - * end. But we can make it safe if the input string happens to be - * NUL-terminated, as many strings in Perl are, by refusing to read past a - * NUL, which is what UTF8_CHK_SKIP() does. A NUL indicates the start of - * the next character anyway. If the input isn't NUL-terminated, the - * function remains unsafe, as it always has been. */ - - return utf8_to_uvchr_buf(s, s + UTF8_CHK_SKIP(s), retlen); -} - GCC_DIAG_RESTORE #endif /* NO_MATHOMS */ |