This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
https://perl5.git.perl.org / perl5.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
D:P: parts/inc/misc: Silence Wide char warnings
[perl5.git] / gv.c
CommitLineData
a0d0e21e 1/* gv.c
79072805 2 *
1129b882 3 * Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
67fbe0e1 4 * 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 by Larry Wall and others
79072805
LW		 5 *
6 * You may distribute under the terms of either the GNU General Public
7 * License or the Artistic License, as specified in the README file.
8 *
a0d0e21e
LW		 9 */
10
11/*
12 * 'Mercy!' cried Gandalf. 'If the giving of information is to be the cure
4ac71550 13 * of your inquisitiveness, I shall spend all the rest of my days in answering
a0d0e21e
LW		 14 * you. What more do you want to know?'
15 * 'The names of all the stars, and of all living things, and the whole
16 * history of Middle-earth and Over-heaven and of the Sundering Seas,'
17 * laughed Pippin.
4ac71550 18 *
cdad3b53 19 * [p.599 of _The Lord of the Rings_, III/xi: "The Palantír"]
79072805
LW		 20 */
21
ccfc67b7
JH		 22/*
23=head1 GV Functions
166f8a29
DM		 24A GV is a structure which corresponds to to a Perl typeglob, ie *foo.
25It is a structure that holds a pointer to a scalar, an array, a hash etc,
26corresponding to $foo, @foo, %foo.
27
28GVs are usually found as values in stashes (symbol table hashes) where
29Perl stores its global variables.
30
31=cut
ccfc67b7
JH		 32*/
33
79072805 34#include "EXTERN.h"
864dbfa3 35#define PERL_IN_GV_C
79072805 36#include "perl.h"
6ffcffbd 37#include "overload.inc"
4aaa4757 38#include "keywords.h"
2846acbf 39#include "feature.h"
79072805 40
f54cb97a 41static const char S_autoload[] = "AUTOLOAD";
3c81f0b3 42#define S_autolen (sizeof("AUTOLOAD")-1)
5c7983e5 43
13c59d41
MH		 44GV *
45Perl_gv_add_by_type(pTHX_ GV *gv, svtype type)
c69033f2 46{
d5713896 47 SV **where;
7918f24d 48
13c59d41
MH		 49 if (
50 !gv
51 || (
52 SvTYPE((const SV *)gv) != SVt_PVGV
13be902c 53 && SvTYPE((const SV *)gv) != SVt_PVLV
13c59d41 54 )
13be902c 55 ) {
bb85b28a 56 const char *what;
13c59d41 57 if (type == SVt_PVIO) {
bb85b28a
NC		 58 /*
59 * if it walks like a dirhandle, then let's assume that
60 * this is a dirhandle.
61 */
332c2eac 62 what = OP_IS_DIRHOP(PL_op->op_type) ?
bb85b28a 63 "dirhandle" : "filehandle";
13c59d41 64 } else if (type == SVt_PVHV) {
bb85b28a
NC		 65 what = "hash";
66 } else {
13c59d41 67 what = type == SVt_PVAV ? "array" : "scalar";
bb85b28a 68 }
de6f7947 69 /* diag_listed_as: Bad symbol for filehandle */
bb85b28a
NC		 70 Perl_croak(aTHX_ "Bad symbol for %s", what);
71 }
d5713896 72
13c59d41
MH		 73 if (type == SVt_PVHV) {
74 where = (SV **)&GvHV(gv);
75 } else if (type == SVt_PVAV) {
76 where = (SV **)&GvAV(gv);
77 } else if (type == SVt_PVIO) {
78 where = (SV **)&GvIOp(gv);
79 } else {
80 where = &GvSV(gv);
81 }
7918f24d 82
13c59d41
MH		 83 if (!*where)
84 {
85 *where = newSV_type(type);
b59bf0b2
KW		 86 if (type == SVt_PVAV
87 && memEQs(GvNAME(gv), GvNAMELEN(gv), "ISA"))
13c59d41 88 sv_magic(*where, (SV *)gv, PERL_MAGIC_isa, NULL, 0);
e17aed30 89 }
13c59d41 90 return gv;
79072805
LW		 91}
92
93GV *
864dbfa3 94Perl_gv_fetchfile(pTHX_ const char *name)
79072805 95{
7918f24d 96 PERL_ARGS_ASSERT_GV_FETCHFILE;
d9095cec
NC		 97 return gv_fetchfile_flags(name, strlen(name), 0);
98}
99
100GV *
101Perl_gv_fetchfile_flags(pTHX_ const char *const name, const STRLEN namelen,
102 const U32 flags)
103{
4116122e 104 char smallbuf[128];
53d95988 105 char *tmpbuf;
d9095cec 106 const STRLEN tmplen = namelen + 2;
79072805
LW		 107 GV *gv;
108
7918f24d 109 PERL_ARGS_ASSERT_GV_FETCHFILE_FLAGS;
d9095cec
NC		 110 PERL_UNUSED_ARG(flags);
111
1d7c1841 112 if (!PL_defstash)
a0714e2c 113 return NULL;
1d7c1841 114
d9095cec 115 if (tmplen <= sizeof smallbuf)
53d95988
CS		 116 tmpbuf = smallbuf;
117 else
798b63bc 118 Newx(tmpbuf, tmplen, char);
0ac0412a 119 /* This is where the debugger's %{"::_<$filename"} hash is created */
53d95988
CS		 120 tmpbuf[0] = '_';
121 tmpbuf[1] = '<';
d9095cec
NC		 122 memcpy(tmpbuf + 2, name, namelen);
123 gv = *(GV**)hv_fetch(PL_defstash, tmpbuf, tmplen, TRUE);
1d7c1841 124 if (!isGV(gv)) {
d9095cec 125 gv_init(gv, PL_defstash, tmpbuf, tmplen, FALSE);
c69033f2 126#ifdef PERL_DONT_CREATE_GVSV
d9095cec 127 GvSV(gv) = newSVpvn(name, namelen);
c69033f2 128#else
d9095cec 129 sv_setpvn(GvSV(gv), name, namelen);
c69033f2 130#endif
1d7c1841 131 }
c7a622b3 132 if (PERLDB_LINE_OR_SAVESRC && !GvAV(gv))
43e4250a 133 hv_magic(GvHVn(gv), GvAVn(gv), PERL_MAGIC_dbfile);
53d95988
CS		 134 if (tmpbuf != smallbuf)
135 Safefree(tmpbuf);
79072805
LW		 136 return gv;
137}
138
62d55b22
NC		 139/*
140=for apidoc gv_const_sv
141
142If C<gv> is a typeglob whose subroutine entry is a constant sub eligible for
143inlining, or C<gv> is a placeholder reference that would be promoted to such
144a typeglob, then returns the value returned by the sub. Otherwise, returns
796b6530 145C<NULL>.
62d55b22
NC		 146
147=cut
148*/
149
150SV *
151Perl_gv_const_sv(pTHX_ GV *gv)
152{
7918f24d 153 PERL_ARGS_ASSERT_GV_CONST_SV;
23491f1d 154 PERL_UNUSED_CONTEXT;
7918f24d 155
62d55b22
NC		 156 if (SvTYPE(gv) == SVt_PVGV)
157 return cv_const_sv(GvCVu(gv));
16a6e5a4 158 return SvROK(gv) && SvTYPE(SvRV(gv)) != SVt_PVAV && SvTYPE(SvRV(gv)) != SVt_PVCV ? SvRV(gv) : NULL;
62d55b22
NC		 159}
160
12816592
NC		 161GP *
162Perl_newGP(pTHX_ GV *const gv)
163{
164 GP *gp;
19bad673 165 U32 hash;
19bad673
NC		 166 const char *file;
167 STRLEN len;
2639089b 168#ifndef USE_ITHREADS
6b352265 169 GV *filegv;
2639089b 170#endif
c2587955 171 dVAR;
19bad673 172
7918f24d 173 PERL_ARGS_ASSERT_NEWGP;
2639089b
DD		 174 Newxz(gp, 1, GP);
175 gp->gp_egv = gv; /* allow compiler to reuse gv after this */
176#ifndef PERL_DONT_CREATE_GVSV
177 gp->gp_sv = newSV(0);
178#endif
7918f24d 179
c947bc1d
FC		 180 /* PL_curcop may be null here. E.g.,
181 INIT { bless {} and exit }
182 frees INIT before looking up DESTROY (and creating *DESTROY)
183 */
2639089b
DD		 184 if (PL_curcop) {
185 gp->gp_line = CopLINE(PL_curcop); /* 0 otherwise Newxz */
6e314d4f 186#ifdef USE_ITHREADS
2639089b
DD		 187 if (CopFILE(PL_curcop)) {
188 file = CopFILE(PL_curcop);
189 len = strlen(file);
190 }
2639089b 191#else
cb0d3385
FC		 192 filegv = CopFILEGV(PL_curcop);
193 if (filegv) {
194 file = GvNAME(filegv)+2;
195 len = GvNAMELEN(filegv)-2;
196 }
6e314d4f 197#endif
cb0d3385
FC		 198 else goto no_file;
199 }
200 else {
201 no_file:
19bad673
NC		 202 file = "";
203 len = 0;
204 }
f4890806
NC		 205
206 PERL_HASH(hash, file, len);
f4890806 207 gp->gp_file_hek = share_hek(file, len, hash);
12816592
NC		 208 gp->gp_refcnt = 1;
209
210 return gp;
211}
212
803f2748
DM		 213/* Assign CvGV(cv) = gv, handling weak references.
214 * See also S_anonymise_cv_maybe */
215
216void
217Perl_cvgv_set(pTHX_ CV* cv, GV* gv)
218{
ae77754a 219 GV * const oldgv = CvNAMED(cv) ? NULL : SvANY(cv)->xcv_gv_u.xcv_gv;
b290562e 220 HEK *hek;
803f2748
DM		 221 PERL_ARGS_ASSERT_CVGV_SET;
222
223 if (oldgv == gv)
224 return;
225
226 if (oldgv) {
cfc1e951 227 if (CvCVGV_RC(cv)) {
e7881358 228 SvREFCNT_dec_NN(oldgv);
cfc1e951
DM		 229 CvCVGV_RC_off(cv);
230 }
803f2748 231 else {
803f2748
DM		 232 sv_del_backref(MUTABLE_SV(oldgv), MUTABLE_SV(cv));
233 }
234 }
db5cc3ee
FC		 235 else if ((hek = CvNAME_HEK(cv))) {
236 unshare_hek(hek);
f3feca7a 237 CvLEXICAL_off(cv);
db5cc3ee 238 }
803f2748 239
5988f306 240 CvNAMED_off(cv);
b290562e 241 SvANY(cv)->xcv_gv_u.xcv_gv = gv;
c794ca97 242 assert(!CvCVGV_RC(cv));
803f2748
DM		 243
244 if (!gv)
245 return;
246
c794ca97
DM		 247 if (isGV_with_GP(gv) && GvGP(gv) && (GvCV(gv) == cv || GvFORM(gv) == cv))
248 Perl_sv_add_backref(aTHX_ MUTABLE_SV(gv), MUTABLE_SV(cv));
249 else {
cfc1e951 250 CvCVGV_RC_on(cv);
803f2748
DM		 251 SvREFCNT_inc_simple_void_NN(gv);
252 }
803f2748
DM		 253}
254
ae77754a
FC		 255/* Convert CvSTASH + CvNAME_HEK into a GV. Conceptually, all subs have a
256 GV, but for efficiency that GV may not in fact exist. This function,
257 called by CvGV, reifies it. */
258
259GV *
260Perl_cvgv_from_hek(pTHX_ CV *cv)
261{
262 GV *gv;
2eaf799e 263 SV **svp;
ae77754a
FC		 264 PERL_ARGS_ASSERT_CVGV_FROM_HEK;
265 assert(SvTYPE(cv) == SVt_PVCV);
266 if (!CvSTASH(cv)) return NULL;
267 ASSUME(CvNAME_HEK(cv));
2eaf799e
FC		 268 svp = hv_fetchhek(CvSTASH(cv), CvNAME_HEK(cv), 0);
269 gv = MUTABLE_GV(svp && *svp ? *svp : newSV(0));
270 if (!isGV(gv))
271 gv_init_pvn(gv, CvSTASH(cv), HEK_KEY(CvNAME_HEK(cv)),
ae77754a
FC		 272 HEK_LEN(CvNAME_HEK(cv)),
273 SVf_UTF8 * !!HEK_UTF8(CvNAME_HEK(cv)));
2eaf799e
FC		 274 if (!CvNAMED(cv)) { /* gv_init took care of it */
275 assert (SvANY(cv)->xcv_gv_u.xcv_gv == gv);
276 return gv;
277 }
ae77754a
FC		 278 unshare_hek(CvNAME_HEK(cv));
279 CvNAMED_off(cv);
280 SvANY(cv)->xcv_gv_u.xcv_gv = gv;
2eaf799e 281 if (svp && *svp) SvREFCNT_inc_simple_void_NN(gv);
ae77754a
FC		 282 CvCVGV_RC_on(cv);
283 return gv;
284}
285
c68d9564
Z		 286/* Assign CvSTASH(cv) = st, handling weak references. */
287
288void
289Perl_cvstash_set(pTHX_ CV *cv, HV *st)
290{
291 HV *oldst = CvSTASH(cv);
292 PERL_ARGS_ASSERT_CVSTASH_SET;
293 if (oldst == st)
294 return;
295 if (oldst)
296 sv_del_backref(MUTABLE_SV(oldst), MUTABLE_SV(cv));
297 SvANY(cv)->xcv_stash = st;
298 if (st)
299 Perl_sv_add_backref(aTHX_ MUTABLE_SV(st), MUTABLE_SV(cv));
300}
803f2748 301
e1104062
FC		 302/*
303=for apidoc gv_init_pvn
304
305Converts a scalar into a typeglob. This is an incoercible typeglob;
306assigning a reference to it will assign to one of its slots, instead of
796b6530
KW		 307overwriting it as happens with typeglobs created by C<SvSetSV>. Converting
308any scalar that is C<SvOK()> may produce unpredictable results and is reserved
e1104062
FC		 309for perl's internal use.
310
311C<gv> is the scalar to be converted.
312
313C<stash> is the parent stash/package, if any.
314
04ec7e59
FC		 315C<name> and C<len> give the name. The name must be unqualified;
316that is, it must not include the package name. If C<gv> is a
e1104062
FC		 317stash element, it is the caller's responsibility to ensure that the name
318passed to this function matches the name of the element. If it does not
319match, perl's internal bookkeeping will get out of sync.
320
4a4088c4 321C<flags> can be set to C<SVf_UTF8> if C<name> is a UTF-8 string, or
04ec7e59 322the return value of SvUTF8(sv). It can also take the
796b6530 323C<GV_ADDMULTI> flag, which means to pretend that the GV has been
e1104062
FC		 324seen before (i.e., suppress "Used once" warnings).
325
326=for apidoc gv_init
327
4a4088c4 328The old form of C<gv_init_pvn()>. It does not work with UTF-8 strings, as it
04ec7e59 329has no flags parameter. If the C<multi> parameter is set, the
796b6530 330C<GV_ADDMULTI> flag will be passed to C<gv_init_pvn()>.
e1104062
FC		 331
332=for apidoc gv_init_pv
333
796b6530 334Same as C<gv_init_pvn()>, but takes a nul-terminated string for the name
e1104062
FC		 335instead of separate char * and length parameters.
336
337=for apidoc gv_init_sv
338
796b6530 339Same as C<gv_init_pvn()>, but takes an SV * for the name instead of separate
e1104062
FC		 340char * and length parameters. C<flags> is currently unused.
341
342=cut
343*/
344
463ee0b2 345void
04ec7e59 346Perl_gv_init_sv(pTHX_ GV *gv, HV *stash, SV* namesv, U32 flags)
e6066781
BF		 347{
348 char *namepv;
349 STRLEN namelen;
350 PERL_ARGS_ASSERT_GV_INIT_SV;
351 namepv = SvPV(namesv, namelen);
352 if (SvUTF8(namesv))
353 flags |= SVf_UTF8;
04ec7e59 354 gv_init_pvn(gv, stash, namepv, namelen, flags);
e6066781
BF		 355}
356
357void
04ec7e59 358Perl_gv_init_pv(pTHX_ GV *gv, HV *stash, const char *name, U32 flags)
e6066781
BF		 359{
360 PERL_ARGS_ASSERT_GV_INIT_PV;
04ec7e59 361 gv_init_pvn(gv, stash, name, strlen(name), flags);
e6066781
BF		 362}
363
364void
04ec7e59 365Perl_gv_init_pvn(pTHX_ GV *gv, HV *stash, const char *name, STRLEN len, U32 flags)
463ee0b2 366{
3b6733bf
NC		 367 const U32 old_type = SvTYPE(gv);
368 const bool doproto = old_type > SVt_NULL;
f9509170 369 char * const proto = (doproto && SvPOK(gv))
dad95a0a 370 ? ((void)(SvIsCOW(gv) && (sv_force_normal((SV *)gv), 0)), SvPVX(gv))
f9509170 371 : NULL;
49a54bbe 372 const STRLEN protolen = proto ? SvCUR(gv) : 0;
e0260a5b 373 const U32 proto_utf8 = proto ? SvUTF8(gv) : 0;
756cb477 374 SV *const has_constant = doproto && SvROK(gv) ? SvRV(gv) : NULL;
1ccdb730 375 const U32 exported_constant = has_constant ? SvPCS_IMPORTED(gv) : 0;
6881372e
FC		 376 const bool really_sub =
377 has_constant && SvTYPE(has_constant) == SVt_PVCV;
378 COP * const old = PL_curcop;
756cb477 379
e6066781 380 PERL_ARGS_ASSERT_GV_INIT_PVN;
756cb477
NC		 381 assert (!(proto && has_constant));
382
383 if (has_constant) {
2eaf799e 384 /* The constant has to be a scalar, array or subroutine. */
5c1f4d79 385 switch (SvTYPE(has_constant)) {
5c1f4d79 386 case SVt_PVHV:
5c1f4d79
NC		 387 case SVt_PVFM:
388 case SVt_PVIO:
389 Perl_croak(aTHX_ "Cannot convert a reference to %s to typeglob",
390 sv_reftype(has_constant, 0));
c9a0dcdc 391 NOT_REACHED; /* NOTREACHED */
4bbde2f7 392 break;
81d52ecd 393
42d0e0b7 394 default: NOOP;
5c1f4d79 395 }
756cb477
NC		 396 SvRV_set(gv, NULL);
397 SvROK_off(gv);
398 }
463ee0b2 399
3b6733bf
NC		 400
401 if (old_type < SVt_PVGV) {
402 if (old_type >= SVt_PV)
403 SvCUR_set(gv, 0);
ad64d0ec 404 sv_upgrade(MUTABLE_SV(gv), SVt_PVGV);
3b6733bf 405 }
55d729e4
GS		 406 if (SvLEN(gv)) {
407 if (proto) {
f880fe2f 408 SvPV_set(gv, NULL);
b162af07 409 SvLEN_set(gv, 0);
55d729e4
GS		 410 SvPOK_off(gv);
411 } else
94010e71 412 Safefree(SvPVX_mutable(gv));
55d729e4 413 }
2e5b91de
NC		 414 SvIOK_off(gv);
415 isGV_with_GP_on(gv);
12816592 416
6881372e
FC		 417 if (really_sub && !CvISXSUB(has_constant) && CvSTART(has_constant)
418 && ( CvSTART(has_constant)->op_type == OP_NEXTSTATE
419 || CvSTART(has_constant)->op_type == OP_DBSTATE))
420 PL_curcop = (COP *)CvSTART(has_constant);
c43ae56f 421 GvGP_set(gv, Perl_newGP(aTHX_ gv));
6881372e 422 PL_curcop = old;
e15faf7d
NC		 423 GvSTASH(gv) = stash;
424 if (stash)
ad64d0ec 425 Perl_sv_add_backref(aTHX_ MUTABLE_SV(stash), MUTABLE_SV(gv));
04f3bf56 426 gv_name_set(gv, name, len, GV_ADD | ( flags & SVf_UTF8 ? SVf_UTF8 : 0 ));
04ec7e59
FC		 427 if (flags & GV_ADDMULTI || doproto) /* doproto means it */
428 GvMULTI_on(gv); /* _was_ mentioned */
6881372e 429 if (really_sub) {
2eaf799e
FC		 430 /* Not actually a constant. Just a regular sub. */
431 CV * const cv = (CV *)has_constant;
432 GvCV_set(gv,cv);
790acdde 433 if (CvNAMED(cv) && CvSTASH(cv) == stash && (
2eaf799e
FC		 434 CvNAME_HEK(cv) == GvNAME_HEK(gv)
435 || ( HEK_LEN(CvNAME_HEK(cv)) == HEK_LEN(GvNAME_HEK(gv))
436 && HEK_FLAGS(CvNAME_HEK(cv)) != HEK_FLAGS(GvNAME_HEK(gv))
437 && HEK_UTF8(CvNAME_HEK(cv)) == HEK_UTF8(GvNAME_HEK(gv))
438 && memEQ(HEK_KEY(CvNAME_HEK(cv)), GvNAME(gv), GvNAMELEN(gv))
439 )
440 ))
441 CvGV_set(cv,gv);
442 }
443 else if (doproto) {
e3d2b9e7 444 CV *cv;
756cb477
NC		 445 if (has_constant) {
446 /* newCONSTSUB takes ownership of the reference from us. */
e38acfd7 447 cv = newCONSTSUB_flags(stash, name, len, flags, has_constant);
75bd28cf
FC		 448 /* In case op.c:S_process_special_blocks stole it: */
449 if (!GvCV(gv))
c43ae56f 450 GvCV_set(gv, (CV *)SvREFCNT_inc_simple_NN(cv));
439cdf38 451 assert(GvCV(gv) == cv); /* newCONSTSUB should have set this */
1ccdb730
NC		 452 /* If this reference was a copy of another, then the subroutine
453 must have been "imported", by a Perl space assignment to a GV
454 from a reference to CV. */
455 if (exported_constant)
456 GvIMPORTED_CV_on(gv);
186a5ba8 457 CvSTASH_set(cv, PL_curstash); /* XXX Why is this needed? */
756cb477 458 } else {
186a5ba8 459 cv = newSTUB(gv,1);
756cb477 460 }
55d729e4 461 if (proto) {
e3d2b9e7 462 sv_usepvn_flags(MUTABLE_SV(cv), proto, protolen,
49a54bbe 463 SV_HAS_TRAILING_NUL);
e0260a5b 464 if ( proto_utf8 ) SvUTF8_on(MUTABLE_SV(cv));
55d729e4
GS		 465 }
466 }
463ee0b2
LW		 467}
468
76e3520e 469STATIC void
e6066781 470S_gv_init_svtype(pTHX_ GV *gv, const svtype sv_type)
a0d0e21e 471{
13c59d41
MH		 472 PERL_ARGS_ASSERT_GV_INIT_SVTYPE;
473
474 switch (sv_type) {
475 case SVt_PVIO:
476 (void)GvIOn(gv);
477 break;
478 case SVt_PVAV:
479 (void)GvAVn(gv);
480 break;
481 case SVt_PVHV:
482 (void)GvHVn(gv);
483 break;
c69033f2 484#ifdef PERL_DONT_CREATE_GVSV
13c59d41
MH		 485 case SVt_NULL:
486 case SVt_PVCV:
487 case SVt_PVFM:
488 case SVt_PVGV:
489 break;
490 default:
491 if(GvSVn(gv)) {
492 /* Work round what appears to be a bug in Sun C++ 5.8 2005/10/13
493 If we just cast GvSVn(gv) to void, it ignores evaluating it for
494 its side effect */
495 }
c69033f2 496#endif
a0d0e21e
LW		 497 }
498}
499
0f8d4b5e
FC		 500static void core_xsub(pTHX_ CV* cv);
501
502static GV *
503S_maybe_add_coresub(pTHX_ HV * const stash, GV *gv,
87566176 504 const char * const name, const STRLEN len)
0f8d4b5e
FC		 505{
506 const int code = keyword(name, len, 1);
507 static const char file[] = __FILE__;
97021f77 508 CV *cv, *oldcompcv = NULL;
0f8d4b5e 509 int opnum = 0;
0f8d4b5e 510 bool ampable = TRUE; /* &{}-able */
97021f77
FC		 511 COP *oldcurcop = NULL;
512 yy_parser *oldparser = NULL;
513 I32 oldsavestack_ix = 0;
0f8d4b5e
FC		 514
515 assert(gv || stash);
516 assert(name);
0f8d4b5e 517
88b892d8
FC		 518 if (!code) return NULL; /* Not a keyword */
519 switch (code < 0 ? -code : code) {
0f8d4b5e 520 /* no support for \&CORE::infix;
d885f758 521 no support for funcs that do not parse like funcs */
88b892d8 522 case KEY___DATA__: case KEY___END__: case KEY_and: case KEY_AUTOLOAD:
a96df643 523 case KEY_BEGIN : case KEY_CHECK : case KEY_cmp:
7896dde7 524 case KEY_default : case KEY_DESTROY:
88b892d8 525 case KEY_do : case KEY_dump : case KEY_else : case KEY_elsif :
d51f8b19 526 case KEY_END : case KEY_eq : case KEY_eval :
88b892d8 527 case KEY_for : case KEY_foreach: case KEY_format: case KEY_ge :
498a02d8 528 case KEY_given : case KEY_goto : case KEY_grep :
88b892d8
FC		 529 case KEY_gt : case KEY_if: case KEY_INIT: case KEY_last: case KEY_le:
530 case KEY_local: case KEY_lt: case KEY_m : case KEY_map : case KEY_my:
531 case KEY_ne : case KEY_next : case KEY_no: case KEY_or: case KEY_our:
1efec5ed 532 case KEY_package: case KEY_print: case KEY_printf:
919ad5f7 533 case KEY_q : case KEY_qq : case KEY_qr : case KEY_qw :
88b892d8 534 case KEY_qx : case KEY_redo : case KEY_require: case KEY_return:
d33bb3da 535 case KEY_s : case KEY_say : case KEY_sort :
d80ed303 536 case KEY_state: case KEY_sub :
46bef06f 537 case KEY_tr : case KEY_UNITCHECK: case KEY_unless:
7896dde7 538 case KEY_until: case KEY_use : case KEY_when : case KEY_while :
88b892d8 539 case KEY_x : case KEY_xor : case KEY_y :
0f8d4b5e
FC		 540 return NULL;
541 case KEY_chdir:
eb31eb35 542 case KEY_chomp: case KEY_chop: case KEY_defined: case KEY_delete:
73665bc4 543 case KEY_eof : case KEY_exec: case KEY_exists :
0f8d4b5e 544 case KEY_lstat:
bea284c8 545 case KEY_split:
0f8d4b5e
FC		 546 case KEY_stat:
547 case KEY_system:
548 case KEY_truncate: case KEY_unlink:
0f8d4b5e
FC		 549 ampable = FALSE;
550 }
551 if (!gv) {
552 gv = (GV *)newSV(0);
553 gv_init(gv, stash, name, len, TRUE);
554 }
7e68c38b 555 GvMULTI_on(gv);
0f8d4b5e
FC		 556 if (ampable) {
557 ENTER;
558 oldcurcop = PL_curcop;
559 oldparser = PL_parser;
560 lex_start(NULL, NULL, 0);
561 oldcompcv = PL_compcv;
562 PL_compcv = NULL; /* Prevent start_subparse from setting
563 CvOUTSIDE. */
564 oldsavestack_ix = start_subparse(FALSE,0);
565 cv = PL_compcv;
566 }
567 else {
568 /* Avoid calling newXS, as it calls us, and things start to
569 get hairy. */
570 cv = MUTABLE_CV(newSV_type(SVt_PVCV));
571 GvCV_set(gv,cv);
572 GvCVGEN(gv) = 0;
0f8d4b5e
FC		 573 CvISXSUB_on(cv);
574 CvXSUB(cv) = core_xsub;
eacbb379 575 PoisonPADLIST(cv);
0f8d4b5e
FC		 576 }
577 CvGV_set(cv, gv); /* This stops new ATTRSUB from setting CvFILE
578 from PL_curcop. */
9b669ea1
DD		 579 /* XSUBs can't be perl lang/perl5db.pl debugged
580 if (PERLDB_LINE_OR_SAVESRC)
581 (void)gv_fetchfile(file); */
0f8d4b5e
FC		 582 CvFILE(cv) = (char *)file;
583 /* XXX This is inefficient, as doing things this order causes
584 a prototype check in newATTRSUB. But we have to do
585 it this order as we need an op number before calling
586 new ATTRSUB. */
587 (void)core_prototype((SV *)cv, name, code, &opnum);
87566176 588 if (stash)
73c02f15 589 (void)hv_store(stash,name,len,(SV *)gv,0);
0f8d4b5e 590 if (ampable) {
4428fb0e
TC		 591#ifdef DEBUGGING
592 CV *orig_cv = cv;
593#endif
0f8d4b5e 594 CvLVALUE_on(cv);
4428fb0e
TC		 595 /* newATTRSUB will free the CV and return NULL if we're still
596 compiling after a syntax error */
e8f91c91 597 if ((cv = newATTRSUB_x(
7e68c38b 598 oldsavestack_ix, (OP *)gv,
0f8d4b5e
FC		 599 NULL,NULL,
600 coresub_op(
601 opnum
602 ? newSVuv((UV)opnum)
603 : newSVpvn(name,len),
604 code, opnum
7e68c38b 605 ),
e8f91c91 606 TRUE
4428fb0e
TC		 607 )) != NULL) {
608 assert(GvCV(gv) == orig_cv);
609 if (opnum != OP_VEC && opnum != OP_SUBSTR && opnum != OP_POS
cd642408 610 && opnum != OP_UNDEF && opnum != OP_KEYS)
4428fb0e
TC		 611 CvLVALUE_off(cv); /* Now *that* was a neat trick. */
612 }
0f8d4b5e
FC		 613 LEAVE;
614 PL_parser = oldparser;
615 PL_curcop = oldcurcop;
616 PL_compcv = oldcompcv;
617 }
4428fb0e 618 if (cv) {
a83b92fa
Z		 619 SV *opnumsv = newSViv(
620 (opnum == OP_ENTEREVAL && len == 9 && memEQ(name, "evalbytes", 9)) ?
621 (OP_ENTEREVAL | (1<<16))
622 : opnum ? opnum : (((I32)name[2]) << 16));
623 cv_set_call_checker_flags(cv, Perl_ck_entersub_args_core, opnumsv, 0);
624 SvREFCNT_dec_NN(opnumsv);
4428fb0e
TC		 625 }
626
0f8d4b5e
FC		 627 return gv;
628}
629
954c1994 630/*
6c53d59b
FC		 631=for apidoc gv_fetchmeth
632
633Like L</gv_fetchmeth_pvn>, but lacks a flags parameter.
634
e6919483
BF		 635=for apidoc gv_fetchmeth_sv
636
637Exactly like L</gv_fetchmeth_pvn>, but takes the name string in the form
638of an SV instead of a string/length pair.
639
640=cut
641*/
642
643GV *
644Perl_gv_fetchmeth_sv(pTHX_ HV *stash, SV *namesv, I32 level, U32 flags)
645{
c290e187 646 char *namepv;
647 STRLEN namelen;
648 PERL_ARGS_ASSERT_GV_FETCHMETH_SV;
649 if (LIKELY(SvPOK_nog(namesv))) /* common case */
14062320
FC		 650 return gv_fetchmeth_internal(stash, namesv, NULL, 0, level,
651 flags | SvUTF8(namesv));
c290e187 652 namepv = SvPV(namesv, namelen);
653 if (SvUTF8(namesv)) flags |= SVf_UTF8;
654 return gv_fetchmeth_pvn(stash, namepv, namelen, level, flags);
e6919483
BF		 655}
656
657/*
658=for apidoc gv_fetchmeth_pv
659
660Exactly like L</gv_fetchmeth_pvn>, but takes a nul-terminated string
661instead of a string/length pair.
662
663=cut
664*/
665
666GV *
667Perl_gv_fetchmeth_pv(pTHX_ HV *stash, const char *name, I32 level, U32 flags)
668{
669 PERL_ARGS_ASSERT_GV_FETCHMETH_PV;
c6afe666 670 return gv_fetchmeth_internal(stash, NULL, name, strlen(name), level, flags);
e6919483
BF		 671}
672
673/*
674=for apidoc gv_fetchmeth_pvn
954c1994
GS		 675
676Returns the glob with the given C<name> and a defined subroutine or
677C<NULL>. The glob lives in the given C<stash>, or in the stashes
796b6530 678accessible via C<@ISA> and C<UNIVERSAL::>.
954c1994
GS		 679
680The argument C<level> should be either 0 or -1. If C<level==0>, as a
681side-effect creates a glob with the given C<name> in the given C<stash>
682which in the case of success contains an alias for the subroutine, and sets
e1a479c5 683up caching info for this glob.
954c1994 684
796b6530 685The only significant values for C<flags> are C<GV_SUPER> and C<SVf_UTF8>.
aae43805 686
796b6530 687C<GV_SUPER> indicates that we want to look up the method in the superclasses
aae43805 688of the C<stash>.
e6919483 689
aae43805 690The
954c1994 691GV returned from C<gv_fetchmeth> may be a method cache entry, which is not
4929bf7b 692visible to Perl code. So when calling C<call_sv>, you should not use
954c1994 693the GV directly; instead, you should use the method's CV, which can be
b267980d 694obtained from the GV with the C<GvCV> macro.
954c1994 695
4f8d487a
KW		 696=for apidoc Amnh||GV_SUPER
697
954c1994
GS		 698=cut
699*/
700
e1a479c5
BB		 701/* NOTE: No support for tied ISA */
702
c6afe666 703PERL_STATIC_INLINE GV*
704S_gv_fetchmeth_internal(pTHX_ HV* stash, SV* meth, const char* name, STRLEN len, I32 level, U32 flags)
79072805 705{
463ee0b2 706 GV** gvp;
c6afe666 707 HE* he;
e1a479c5
BB		 708 AV* linear_av;
709 SV** linear_svp;
710 SV* linear_sv;
aae43805 711 HV* cstash, *cachestash;
e1a479c5
BB		 712 GV* candidate = NULL;
713 CV* cand_cv = NULL;
e1a479c5 714 GV* topgv = NULL;
bfcb3514 715 const char *hvname;
448aac91 716 STRLEN hvnamelen;
c6afe666 717 I32 create = (level >= 0) ? HV_FETCH_LVALUE : 0;
e1a479c5 718 I32 items;
e1a479c5 719 U32 topgen_cmp;
04f3bf56 720 U32 is_utf8 = flags & SVf_UTF8;
a0d0e21e 721
af09ea45
IK		 722 /* UNIVERSAL methods should be callable without a stash */
723 if (!stash) {
e1a479c5 724 create = 0; /* probably appropriate */
da51bb9b 725 if(!(stash = gv_stashpvs("UNIVERSAL", 0)))
af09ea45
IK		 726 return 0;
727 }
728
e1a479c5
BB		 729 assert(stash);
730
bfcb3514 731 hvname = HvNAME_get(stash);
448aac91 732 hvnamelen = HvNAMELEN_get(stash);
bfcb3514 733 if (!hvname)
e1a479c5 734 Perl_croak(aTHX_ "Can't use anonymous symbol table for method lookup");
e27ad1f2 735
e1a479c5 736 assert(hvname);
55df6700 737 assert(name || meth);
463ee0b2 738
aae43805 739 DEBUG_o( Perl_deb(aTHX_ "Looking for %smethod %s in package %s\n",
55df6700
FC		 740 flags & GV_SUPER ? "SUPER " : "",
741 name ? name : SvPV_nolen(meth), hvname) );
44a8e56a 742
dd69841b 743 topgen_cmp = HvMROMETA(stash)->cache_gen + PL_sub_generation;
e1a479c5 744
aae43805 745 if (flags & GV_SUPER) {
1a33a059
FC		 746 if (!HvAUX(stash)->xhv_mro_meta->super)
747 HvAUX(stash)->xhv_mro_meta->super = newHV();
748 cachestash = HvAUX(stash)->xhv_mro_meta->super;
aae43805
FC		 749 }
750 else cachestash = stash;
751
e1a479c5 752 /* check locally for a real method or a cache entry */
c6afe666 753 he = (HE*)hv_common(
1cde3371 754 cachestash, meth, name, len, is_utf8 ? HVhek_UTF8 : 0, create, NULL, 0
c6afe666 755 );
756 if (he) gvp = (GV**)&HeVAL(he);
757 else gvp = NULL;
758
e1a479c5
BB		 759 if(gvp) {
760 topgv = *gvp;
0f8d4b5e 761 have_gv:
e1a479c5
BB		 762 assert(topgv);
763 if (SvTYPE(topgv) != SVt_PVGV)
55df6700
FC		 764 {
765 if (!name)
766 name = SvPV_nomg(meth, len);
04ec7e59 767 gv_init_pvn(topgv, stash, name, len, GV_ADDMULTI|is_utf8);
55df6700 768 }
e1a479c5
BB		 769 if ((cand_cv = GvCV(topgv))) {
770 /* If genuine method or valid cache entry, use it */
771 if (!GvCVGEN(topgv) || GvCVGEN(topgv) == topgen_cmp) {
772 return topgv;
773 }
774 else {
775 /* stale cache entry, junk it and move on */
e7881358 776 SvREFCNT_dec_NN(cand_cv);
c43ae56f
DM		 777 GvCV_set(topgv, NULL);
778 cand_cv = NULL;
e1a479c5
BB		 779 GvCVGEN(topgv) = 0;
780 }
781 }
782 else if (GvCVGEN(topgv) == topgen_cmp) {
783 /* cache indicates no such method definitively */
784 return 0;
785 }
aae43805 786 else if (stash == cachestash
b59bf0b2
KW		 787 && len > 1 /* shortest is uc */
788 && memEQs(hvname, HvNAMELEN_get(stash), "CORE")
87566176 789 && S_maybe_add_coresub(aTHX_ NULL,topgv,name,len))
0f8d4b5e 790 goto have_gv;
463ee0b2 791 }
79072805 792
aae43805 793 linear_av = mro_get_linear_isa(stash); /* has ourselves at the top of the list */
e1a479c5
BB		 794 linear_svp = AvARRAY(linear_av) + 1; /* skip over self */
795 items = AvFILLp(linear_av); /* no +1, to skip over self */
796 while (items--) {
797 linear_sv = *linear_svp++;
798 assert(linear_sv);
799 cstash = gv_stashsv(linear_sv, 0);
800
dd69841b 801 if (!cstash) {
448aac91
MM		 802 if ( ckWARN(WARN_SYNTAX)) {
803 if( /* these are loaded from Perl_Gv_AMupdate() one way or another */
804 ( len && name[0] == '(' ) /* overload.pm related, in particular "()" */
805 || ( memEQs( name, len, "DESTROY") )
806 ) {
807 Perl_ck_warner(aTHX_ packWARN(WARN_SYNTAX),
808 "Can't locate package %" SVf " for @%" HEKf "::ISA",
809 SVfARG(linear_sv),
810 HEKfARG(HvNAME_HEK(stash)));
811
812 } else if( memEQs( name, len, "AUTOLOAD") ) {
813 /* gobble this warning */
814 } else {
815 Perl_ck_warner(aTHX_ packWARN(WARN_SYNTAX),
816 "While trying to resolve method call %.*s->%.*s()"
320be181
KW		 817 " can not locate package \"%" SVf "\" yet it is mentioned in @%.*s::ISA"
818 " (perhaps you forgot to load \"%" SVf "\"?)",
29a3370f
N		 819 (int) hvnamelen, hvname,
820 (int) len, name,
448aac91 821 SVfARG(linear_sv),
29a3370f 822 (int) hvnamelen, hvname,
448aac91
MM		 823 SVfARG(linear_sv));
824 }
825 }
e1a479c5
BB		 826 continue;
827 }
9607fc9c 828
e1a479c5
BB		 829 assert(cstash);
830
202cd98a
SA		 831 gvp = (GV**)hv_common(
832 cstash, meth, name, len, is_utf8 ? HVhek_UTF8 : 0, HV_FETCH_JUST_SV, NULL, 0
833 );
0f8d4b5e
FC		 834 if (!gvp) {
835 if (len > 1 && HvNAMELEN_get(cstash) == 4) {
836 const char *hvname = HvNAME(cstash); assert(hvname);
c8b388b0 837 if (strBEGINs(hvname, "CORE")
0f8d4b5e 838 && (candidate =
87566176 839 S_maybe_add_coresub(aTHX_ cstash,NULL,name,len)
0f8d4b5e
FC		 840 ))
841 goto have_candidate;
842 }
843 continue;
844 }
845 else candidate = *gvp;
846 have_candidate:
e1a479c5 847 assert(candidate);
04f3bf56 848 if (SvTYPE(candidate) != SVt_PVGV)
04ec7e59 849 gv_init_pvn(candidate, cstash, name, len, GV_ADDMULTI|is_utf8);
e1a479c5
BB		 850 if (SvTYPE(candidate) == SVt_PVGV && (cand_cv = GvCV(candidate)) && !GvCVGEN(candidate)) {
851 /*
852 * Found real method, cache method in topgv if:
853 * 1. topgv has no synonyms (else inheritance crosses wires)
854 * 2. method isn't a stub (else AUTOLOAD fails spectacularly)
855 */
856 if (topgv && (GvREFCNT(topgv) == 1) && (CvROOT(cand_cv) || CvXSUB(cand_cv))) {
9bfbb681
VP		 857 CV *old_cv = GvCV(topgv);
858 SvREFCNT_dec(old_cv);
e1a479c5 859 SvREFCNT_inc_simple_void_NN(cand_cv);
c43ae56f 860 GvCV_set(topgv, cand_cv);
e1a479c5
BB		 861 GvCVGEN(topgv) = topgen_cmp;
862 }
863 return candidate;
864 }
865 }
9607fc9c 866
e1a479c5
BB		 867 /* Check UNIVERSAL without caching */
868 if(level == 0 || level == -1) {
55df6700
FC		 869 candidate = gv_fetchmeth_internal(NULL, meth, name, len, 1,
870 flags &~GV_SUPER);
e1a479c5
BB		 871 if(candidate) {
872 cand_cv = GvCV(candidate);
873 if (topgv && (GvREFCNT(topgv) == 1) && (CvROOT(cand_cv) || CvXSUB(cand_cv))) {
9bfbb681
VP		 874 CV *old_cv = GvCV(topgv);
875 SvREFCNT_dec(old_cv);
e1a479c5 876 SvREFCNT_inc_simple_void_NN(cand_cv);
c43ae56f 877 GvCV_set(topgv, cand_cv);
e1a479c5
BB		 878 GvCVGEN(topgv) = topgen_cmp;
879 }
880 return candidate;
881 }
882 }
883
884 if (topgv && GvREFCNT(topgv) == 1) {
885 /* cache the fact that the method is not defined */
886 GvCVGEN(topgv) = topgen_cmp;
a0d0e21e
LW		 887 }
888
79072805
LW		 889 return 0;
890}
891
c6afe666 892GV *
893Perl_gv_fetchmeth_pvn(pTHX_ HV *stash, const char *name, STRLEN len, I32 level, U32 flags)
894{
895 PERL_ARGS_ASSERT_GV_FETCHMETH_PVN;
896 return gv_fetchmeth_internal(stash, NULL, name, len, level, flags);
897}
898
954c1994 899/*
460e5730
FC		 900=for apidoc gv_fetchmeth_autoload
901
902This is the old form of L</gv_fetchmeth_pvn_autoload>, which has no flags
903parameter.
904
d21989ed 905=for apidoc gv_fetchmeth_sv_autoload
611c1e95 906
d21989ed
BF		 907Exactly like L</gv_fetchmeth_pvn_autoload>, but takes the name string in the form
908of an SV instead of a string/length pair.
909
910=cut
911*/
912
913GV *
914Perl_gv_fetchmeth_sv_autoload(pTHX_ HV *stash, SV *namesv, I32 level, U32 flags)
915{
916 char *namepv;
917 STRLEN namelen;
918 PERL_ARGS_ASSERT_GV_FETCHMETH_SV_AUTOLOAD;
919 namepv = SvPV(namesv, namelen);
920 if (SvUTF8(namesv))
921 flags |= SVf_UTF8;
922 return gv_fetchmeth_pvn_autoload(stash, namepv, namelen, level, flags);
923}
924
925/*
926=for apidoc gv_fetchmeth_pv_autoload
927
928Exactly like L</gv_fetchmeth_pvn_autoload>, but takes a nul-terminated string
929instead of a string/length pair.
930
931=cut
932*/
933
934GV *
935Perl_gv_fetchmeth_pv_autoload(pTHX_ HV *stash, const char *name, I32 level, U32 flags)
936{
937 PERL_ARGS_ASSERT_GV_FETCHMETH_PV_AUTOLOAD;
938 return gv_fetchmeth_pvn_autoload(stash, name, strlen(name), level, flags);
939}
940
941/*
942=for apidoc gv_fetchmeth_pvn_autoload
943
796b6530 944Same as C<gv_fetchmeth_pvn()>, but looks for autoloaded subroutines too.
611c1e95
IZ		 945Returns a glob for the subroutine.
946
947For an autoloaded subroutine without a GV, will create a GV even
796b6530 948if C<level < 0>. For an autoloaded subroutine without a stub, C<GvCV()>
611c1e95
IZ		 949of the result may be zero.
950
796b6530 951Currently, the only significant value for C<flags> is C<SVf_UTF8>.
d21989ed 952
611c1e95
IZ		 953=cut
954*/
955
956GV *
d21989ed 957Perl_gv_fetchmeth_pvn_autoload(pTHX_ HV *stash, const char *name, STRLEN len, I32 level, U32 flags)
611c1e95 958{
499321d3 959 GV *gv = gv_fetchmeth_pvn(stash, name, len, level, flags);
611c1e95 960
d21989ed 961 PERL_ARGS_ASSERT_GV_FETCHMETH_PVN_AUTOLOAD;
7918f24d 962
611c1e95 963 if (!gv) {
611c1e95
IZ		 964 CV *cv;
965 GV **gvp;
966
967 if (!stash)
6136c704 968 return NULL; /* UNIVERSAL::AUTOLOAD could cause trouble */
7edbdc6b 969 if (len == S_autolen && memEQ(name, S_autoload, S_autolen))
6136c704 970 return NULL;
d21989ed 971 if (!(gv = gv_fetchmeth_pvn(stash, S_autoload, S_autolen, FALSE, flags)))
6136c704 972 return NULL;
611c1e95
IZ		 973 cv = GvCV(gv);
974 if (!(CvROOT(cv) || CvXSUB(cv)))
6136c704 975 return NULL;
611c1e95
IZ		 976 /* Have an autoload */
977 if (level < 0) /* Cannot do without a stub */
d21989ed 978 gv_fetchmeth_pvn(stash, name, len, 0, flags);
c60dbbc3
BF		 979 gvp = (GV**)hv_fetch(stash, name,
980 (flags & SVf_UTF8) ? -(I32)len : (I32)len, (level >= 0));
611c1e95 981 if (!gvp)
6136c704 982 return NULL;
611c1e95
IZ		 983 return *gvp;
984 }
985 return gv;
986}
987
988/*
954c1994
GS		 989=for apidoc gv_fetchmethod_autoload
990
991Returns the glob which contains the subroutine to call to invoke the method
992on the C<stash>. In fact in the presence of autoloading this may be the
796b6530 993glob for "AUTOLOAD". In this case the corresponding variable C<$AUTOLOAD> is
b267980d 994already setup.
954c1994
GS		 995
996The third parameter of C<gv_fetchmethod_autoload> determines whether
997AUTOLOAD lookup is performed if the given method is not present: non-zero
b267980d 998means yes, look for AUTOLOAD; zero means no, don't look for AUTOLOAD.
954c1994 999Calling C<gv_fetchmethod> is equivalent to calling C<gv_fetchmethod_autoload>
b267980d 1000with a non-zero C<autoload> parameter.
954c1994 1001
cec2d7b1
FC		 1002These functions grant C<"SUPER"> token
1003as a prefix of the method name. Note
954c1994
GS		 1004that if you want to keep the returned glob for a long time, you need to
1005check for it being "AUTOLOAD", since at the later time the call may load a
796b6530 1006different subroutine due to C<$AUTOLOAD> changing its value. Use the glob
cec2d7b1 1007created as a side effect to do this.
954c1994 1008
cec2d7b1
FC		 1009These functions have the same side-effects as C<gv_fetchmeth> with
1010C<level==0>. The warning against passing the GV returned by
1011C<gv_fetchmeth> to C<call_sv> applies equally to these functions.
954c1994
GS		 1012
1013=cut
1014*/
1015
dc848c6f 1016GV *
864dbfa3 1017Perl_gv_fetchmethod_autoload(pTHX_ HV *stash, const char *name, I32 autoload)
dc848c6f 1018{
547bb267
NC		 1019 PERL_ARGS_ASSERT_GV_FETCHMETHOD_AUTOLOAD;
1020
256d1bb2
NC		 1021 return gv_fetchmethod_flags(stash, name, autoload ? GV_AUTOLOAD : 0);
1022}
1023
44130a26
BF		 1024GV *
1025Perl_gv_fetchmethod_sv_flags(pTHX_ HV *stash, SV *namesv, U32 flags)
1026{
1027 char *namepv;
1028 STRLEN namelen;
1029 PERL_ARGS_ASSERT_GV_FETCHMETHOD_SV_FLAGS;
1030 namepv = SvPV(namesv, namelen);
1031 if (SvUTF8(namesv))
1032 flags |= SVf_UTF8;
1033 return gv_fetchmethod_pvn_flags(stash, namepv, namelen, flags);
1034}
1035
1036GV *
1037Perl_gv_fetchmethod_pv_flags(pTHX_ HV *stash, const char *name, U32 flags)
1038{
1039 PERL_ARGS_ASSERT_GV_FETCHMETHOD_PV_FLAGS;
1040 return gv_fetchmethod_pvn_flags(stash, name, strlen(name), flags);
1041}
1042
256d1bb2 1043GV *
44130a26 1044Perl_gv_fetchmethod_pvn_flags(pTHX_ HV *stash, const char *name, const STRLEN len, U32 flags)
256d1bb2 1045{
65308f87
YO		 1046 const char * const origname = name;
1047 const char * const name_end = name + len;
e2cace1e 1048 const char *last_separator = NULL;
a0d0e21e 1049 GV* gv;
0dae17bd 1050 HV* ostash = stash;
ad64d0ec 1051 SV *const error_report = MUTABLE_SV(stash);
256d1bb2
NC		 1052 const U32 autoload = flags & GV_AUTOLOAD;
1053 const U32 do_croak = flags & GV_CROAK;
14d1dfbd 1054 const U32 is_utf8 = flags & SVf_UTF8;
0dae17bd 1055
44130a26 1056 PERL_ARGS_ASSERT_GV_FETCHMETHOD_PVN_FLAGS;
7918f24d 1057
eff494dd 1058 if (SvTYPE(stash) < SVt_PVHV)
5c284bb0 1059 stash = NULL;
c9bf4021 1060 else {
e2cace1e 1061 /* The only way stash can become NULL later on is if last_separator is set,
c9bf4021
NC		 1062 which in turn means that there is no need for a SVt_PVHV case
1063 the error reporting code. */
1064 }
b267980d 1065
cfb73676
YO		 1066 {
1067 /* check if the method name is fully qualified or
1068 * not, and separate the package name from the actual
1069 * method name.
1070 *
1071 * leaves last_separator pointing to the beginning of the
1072 * last package separator (either ' or ::) or 0
1073 * if none was found.
1074 *
1075 * leaves name pointing at the beginning of the
1076 * method name.
1077 */
1078 const char *name_cursor = name;
1079 const char * const name_em1 = name_end - 1; /* name_end minus 1 */
1080 for (name_cursor = name; name_cursor < name_end ; name_cursor++) {
1081 if (*name_cursor == '\'') {
1082 last_separator = name_cursor;
1083 name = name_cursor + 1;
1084 }
1085 else if (name_cursor < name_em1 && *name_cursor == ':' && name_cursor[1] == ':') {
1086 last_separator = name_cursor++;
1087 name = name_cursor + 1;
1088 }
1089 }
a0d0e21e 1090 }
cfb73676
YO		 1091
1092 /* did we find a separator? */
e2cace1e 1093 if (last_separator) {
9b7f107c
YO		 1094 STRLEN sep_len= last_separator - origname;
1095 if ( memEQs(origname, sep_len, "SUPER")) {
9607fc9c 1096 /* ->SUPER::method should really be looked up in original stash */
aae43805
FC		 1097 stash = CopSTASH(PL_curcop);
1098 flags |= GV_SUPER;
cea2e8a9 1099 DEBUG_o( Perl_deb(aTHX_ "Treating %s as %s::%s\n",
0308a534 1100 origname, HvENAME_get(stash), name) );
4633a7c4 1101 }
47324b4e
KW		 1102 else if ( sep_len >= 7 &&
1103 strBEGINs(last_separator - 7, "::SUPER")) {
aae43805 1104 /* don't autovifify if ->NoSuchStash::SUPER::method */
9b7f107c 1105 stash = gv_stashpvn(origname, sep_len - 7, is_utf8);
aae43805
FC		 1106 if (stash) flags |= GV_SUPER;
1107 }
e189a56d 1108 else {
af09ea45 1109 /* don't autovifify if ->NoSuchStash::method */
9b7f107c 1110 stash = gv_stashpvn(origname, sep_len, is_utf8);
e189a56d 1111 }
0dae17bd 1112 ostash = stash;
4633a7c4
LW		 1113 }
1114
65308f87 1115 gv = gv_fetchmeth_pvn(stash, name, name_end - name, 0, flags);
a0d0e21e 1116 if (!gv) {
7da9d78d
AB		 1117 /* This is the special case that exempts Foo->import and
1118 Foo->unimport from being an error even if there's no
1119 import/unimport subroutine */
0740a29d
Z		 1120 if (strEQ(name,"import") || strEQ(name,"unimport")) {
1121 gv = (GV*)sv_2mortal((SV*)newCONSTSUB_flags(NULL,
1122 NULL, 0, 0, NULL));
1123 } else if (autoload)
c8416c26 1124 gv = gv_autoload_pvn(
65308f87 1125 ostash, name, name_end - name, GV_AUTOLOAD_ISMETHOD|flags
c8416c26 1126 );
256d1bb2
NC		 1127 if (!gv && do_croak) {
1128 /* Right now this is exclusively for the benefit of S_method_common
1129 in pp_hot.c */
1130 if (stash) {
15e6cdd9
DG		 1131 /* If we can't find an IO::File method, it might be a call on
1132 * a filehandle. If IO:File has not been loaded, try to
1133 * require it first instead of croaking */
1134 const char *stash_name = HvNAME_get(stash);
31b05a0f
FR		 1135 if (stash_name && memEQs(stash_name, HvNAMELEN_get(stash), "IO::File")
1136 && !Perl_hv_common(aTHX_ GvHVn(PL_incgv), NULL,
1137 STR_WITH_LEN("IO/File.pm"), 0,
1138 HV_FETCH_ISEXISTS, NULL, 0)
15e6cdd9 1139 ) {
31b05a0f 1140 require_pv("IO/File.pm");
65308f87 1141 gv = gv_fetchmeth_pvn(stash, name, name_end - name, 0, flags);
15e6cdd9
DG		 1142 if (gv)
1143 return gv;
1144 }
256d1bb2 1145 Perl_croak(aTHX_
147e3846
KW		 1146 "Can't locate object method \"%" UTF8f
1147 "\" via package \"%" HEKf "\"",
65308f87 1148 UTF8fARG(is_utf8, name_end - name, name),
d0c0e7dd 1149 HEKfARG(HvNAME_HEK(stash)));
256d1bb2
NC		 1150 }
1151 else {
ecad31f0 1152 SV* packnamesv;
256d1bb2 1153
e2cace1e
YO		 1154 if (last_separator) {
1155 packnamesv = newSVpvn_flags(origname, last_separator - origname,
ecad31f0 1156 SVs_TEMP | is_utf8);
256d1bb2 1157 } else {
017c5e4e 1158 packnamesv = error_report;
256d1bb2
NC		 1159 }
1160
1161 Perl_croak(aTHX_
147e3846
KW		 1162 "Can't locate object method \"%" UTF8f
1163 "\" via package \"%" SVf "\""
1164 " (perhaps you forgot to load \"%" SVf "\"?)",
65308f87 1165 UTF8fARG(is_utf8, name_end - name, name),
ecad31f0 1166 SVfARG(packnamesv), SVfARG(packnamesv));
256d1bb2
NC		 1167 }
1168 }
463ee0b2 1169 }
dc848c6f 1170 else if (autoload) {
9d4ba2ae 1171 CV* const cv = GvCV(gv);
09280a33
CS		 1172 if (!CvROOT(cv) && !CvXSUB(cv)) {
1173 GV* stubgv;
1174 GV* autogv;
1175
0c028dca 1176 if (CvANON(cv) || CvLEXICAL(cv))
09280a33
CS		 1177 stubgv = gv;
1178 else {
1179 stubgv = CvGV(cv);
1180 if (GvCV(stubgv) != cv) /* orphaned import */
1181 stubgv = gv;
1182 }
c8416c26
BF		 1183 autogv = gv_autoload_pvn(GvSTASH(stubgv),
1184 GvNAME(stubgv), GvNAMELEN(stubgv),
1185 GV_AUTOLOAD_ISMETHOD
1186 | (GvNAMEUTF8(stubgv) ? SVf_UTF8 : 0));
dc848c6f 1187 if (autogv)
1188 gv = autogv;
1189 }
1190 }
44a8e56a 1191
1192 return gv;
1193}
1194
1195GV*
0eeb01b9 1196Perl_gv_autoload_sv(pTHX_ HV *stash, SV* namesv, U32 flags)
5fba3c91
BF		 1197{
1198 char *namepv;
1199 STRLEN namelen;
0fe84f7c 1200 PERL_ARGS_ASSERT_GV_AUTOLOAD_SV;
5fba3c91
BF		 1201 namepv = SvPV(namesv, namelen);
1202 if (SvUTF8(namesv))
1203 flags |= SVf_UTF8;
0eeb01b9 1204 return gv_autoload_pvn(stash, namepv, namelen, flags);
5fba3c91
BF		 1205}
1206
1207GV*
0eeb01b9 1208Perl_gv_autoload_pv(pTHX_ HV *stash, const char *namepv, U32 flags)
5fba3c91 1209{
0fe84f7c 1210 PERL_ARGS_ASSERT_GV_AUTOLOAD_PV;
0eeb01b9 1211 return gv_autoload_pvn(stash, namepv, strlen(namepv), flags);
5fba3c91
BF		 1212}
1213
1214GV*
0eeb01b9 1215Perl_gv_autoload_pvn(pTHX_ HV *stash, const char *name, STRLEN len, U32 flags)
44a8e56a 1216{
44a8e56a 1217 GV* gv;
1218 CV* cv;
1219 HV* varstash;
1220 GV* vargv;
1221 SV* varsv;
c8416c26
BF		 1222 SV *packname = NULL;
1223 U32 is_utf8 = flags & SVf_UTF8 ? SVf_UTF8 : 0;
44a8e56a 1224
0fe84f7c 1225 PERL_ARGS_ASSERT_GV_AUTOLOAD_PVN;
7918f24d 1226
7edbdc6b 1227 if (len == S_autolen && memEQ(name, S_autoload, S_autolen))
a0714e2c 1228 return NULL;
0dae17bd
GS		 1229 if (stash) {
1230 if (SvTYPE(stash) < SVt_PVHV) {
c8416c26
BF		 1231 STRLEN packname_len = 0;
1232 const char * const packname_ptr = SvPV_const(MUTABLE_SV(stash), packname_len);
1233 packname = newSVpvn_flags(packname_ptr, packname_len,
1234 SVs_TEMP | SvUTF8(stash));
5c284bb0 1235 stash = NULL;
0dae17bd 1236 }
c8416c26
BF		 1237 else
1238 packname = sv_2mortal(newSVhek(HvNAME_HEK(stash)));
aae43805 1239 if (flags & GV_SUPER) sv_catpvs(packname, "::SUPER");
0dae17bd 1240 }
257dc59d
FC		 1241 if (!(gv = gv_fetchmeth_pvn(stash, S_autoload, S_autolen, FALSE,
1242 is_utf8 | (flags & GV_SUPER))))
a0714e2c 1243 return NULL;
dc848c6f 1244 cv = GvCV(gv);
1245
adb5a9ae 1246 if (!(CvROOT(cv) || CvXSUB(cv)))
a0714e2c 1247 return NULL;
ed850460 1248
dc848c6f 1249 /*
64278e8c 1250 * Inheriting AUTOLOAD for non-methods no longer works
dc848c6f 1251 */
0eeb01b9
FC		 1252 if (
1253 !(flags & GV_AUTOLOAD_ISMETHOD)
1254 && (GvCVGEN(gv) || GvSTASH(gv) != stash)
041457d9 1255 )
64278e8c
A		 1256 Perl_croak(aTHX_ "Use of inherited AUTOLOAD for non-method %" SVf
1257 "::%" UTF8f "() is no longer allowed",
ecad31f0 1258 SVfARG(packname),
b17a0679 1259 UTF8fARG(is_utf8, len, name));
44a8e56a 1260
aed2304a 1261 if (CvISXSUB(cv)) {
bb619f37
FC		 1262 /* Instead of forcing the XSUB do another lookup for $AUTOLOAD
1263 * and split that value on the last '::', pass along the same data
1264 * via the SvPVX field in the CV, and the stash in CvSTASH.
8fa6a409
FC		 1265 *
1266 * Due to an unfortunate accident of history, the SvPVX field
e1fa07e3 1267 * serves two purposes. It is also used for the subroutine's pro-
8fa6a409
FC		 1268 * type. Since SvPVX has been documented as returning the sub name
1269 * for a long time, but not as returning the prototype, we have
1270 * to preserve the SvPVX AUTOLOAD behaviour and put the prototype
1271 * elsewhere.
1272 *
1273 * We put the prototype in the same allocated buffer, but after
1274 * the sub name. The SvPOK flag indicates the presence of a proto-
1275 * type. The CvAUTOLOAD flag indicates the presence of a sub name.
1276 * If both flags are on, then SvLEN is used to indicate the end of
1277 * the prototype (artificially lower than what is actually allo-
1278 * cated), at the risk of having to reallocate a few bytes unneces-
1279 * sarily--but that should happen very rarely, if ever.
1280 *
1281 * We use SvUTF8 for both prototypes and sub names, so if one is
1282 * UTF8, the other must be upgraded.
adb5a9ae 1283 */
c68d9564 1284 CvSTASH_set(cv, stash);
8fa6a409 1285 if (SvPOK(cv)) { /* Ouch! */
e7881358 1286 SV * const tmpsv = newSVpvn_flags(name, len, is_utf8);
8fa6a409
FC		 1287 STRLEN ulen;
1288 const char *proto = CvPROTO(cv);
1289 assert(proto);
1290 if (SvUTF8(cv))
1291 sv_utf8_upgrade_flags_grow(tmpsv, 0, CvPROTOLEN(cv) + 2);
1292 ulen = SvCUR(tmpsv);
2324bdb9 1293 SvCUR_set(tmpsv, SvCUR(tmpsv) + 1); /* include null in string */
8fa6a409
FC		 1294 sv_catpvn_flags(
1295 tmpsv, proto, CvPROTOLEN(cv), SV_CATBYTES*!SvUTF8(cv)
1296 );
1297 SvTEMP_on(tmpsv); /* Allow theft */
1298 sv_setsv_nomg((SV *)cv, tmpsv);
05b525f4 1299 SvTEMP_off(tmpsv);
e7881358 1300 SvREFCNT_dec_NN(tmpsv);
59c3c222 1301 SvLEN_set(cv, SvCUR(cv) + 1);
2324bdb9 1302 SvCUR_set(cv, ulen);
8fa6a409
FC		 1303 }
1304 else {
1305 sv_setpvn((SV *)cv, name, len);
1306 SvPOK_off(cv);
1307 if (is_utf8)
c8416c26 1308 SvUTF8_on(cv);
8fa6a409
FC		 1309 else SvUTF8_off(cv);
1310 }
1311 CvAUTOLOAD_on(cv);
adb5a9ae 1312 }
adb5a9ae 1313
44a8e56a 1314 /*
1315 * Given &FOO::AUTOLOAD, set $FOO::AUTOLOAD to desired function name.
1316 * The subroutine's original name may not be "AUTOLOAD", so we don't
1317 * use that, but for lack of anything better we will use the sub's
1318 * original package to look up $AUTOLOAD.
1319 */
18691622 1320 varstash = CvNAMED(cv) ? CvSTASH(cv) : GvSTASH(CvGV(cv));
5c7983e5 1321 vargv = *(GV**)hv_fetch(varstash, S_autoload, S_autolen, TRUE);
3d35f11b
GS		 1322 ENTER;
1323
c69033f2 1324 if (!isGV(vargv)) {
04ec7e59 1325 gv_init_pvn(vargv, varstash, S_autoload, S_autolen, 0);
c69033f2 1326#ifdef PERL_DONT_CREATE_GVSV
561b68a9 1327 GvSV(vargv) = newSV(0);
c69033f2
NC		 1328#endif
1329 }
3d35f11b 1330 LEAVE;
e203899d 1331 varsv = GvSVn(vargv);
4bac9ae4
CS		 1332 SvTAINTED_off(varsv); /* previous $AUTOLOAD taint is obsolete */
1333 /* XXX: this process is not careful to avoid extra magic gets and sets; tied $AUTOLOAD will get noise */
c8416c26 1334 sv_setsv(varsv, packname);
396482e1 1335 sv_catpvs(varsv, "::");
d40bf27b
NC		 1336 /* Ensure SvSETMAGIC() is called if necessary. In particular, to clear
1337 tainting if $FOO::AUTOLOAD was previously tainted, but is not now. */
61a9130e
FC		 1338 sv_catpvn_flags(
1339 varsv, name, len,
5bcd1ef4 1340 SV_SMAGIC|(is_utf8 ? SV_CATUTF8 : SV_CATBYTES)
61a9130e 1341 );
c8416c26
BF		 1342 if (is_utf8)
1343 SvUTF8_on(varsv);
a0d0e21e
LW		 1344 return gv;
1345}
1346
44a2ac75
YO		 1347
1348/* require_tie_mod() internal routine for requiring a module
486ec47a 1349 * that implements the logic of automatic ties like %! and %-
e94ea821
FC		 1350 * It loads the module and then calls the _tie_it subroutine
1351 * with the passed gv as an argument.
44a2ac75
YO		 1352 *
1353 * The "gv" parameter should be the glob.
ee33cc1a 1354 * "varname" holds the 1-char name of the var, used for error messages.
45cbc99a 1355 * "namesv" holds the module name. Its refcount will be decremented.
45cbc99a 1356 * "flags": if flag & 1 then save the scalar before loading.
44a2ac75
YO		 1357 * For the protection of $! to work (it is set by this routine)
1358 * the sv slot must already be magicalized.
d2c93421 1359 */
e94ea821 1360STATIC void
ee33cc1a 1361S_require_tie_mod(pTHX_ GV *gv, const char varname, const char * name,
a1683482 1362 STRLEN len, const U32 flags)
d2c93421 1363{
e94ea821 1364 const SV * const target = varname == '[' ? GvSV(gv) : (SV *)GvHV(gv);
45cbc99a 1365
7918f24d
NC		 1366 PERL_ARGS_ASSERT_REQUIRE_TIE_MOD;
1367
e94ea821
FC		 1368 /* If it is not tied */
1369 if (!target || !SvRMAGICAL(target)
1370 || !mg_find(target,
1371 varname == '[' ? PERL_MAGIC_tiedscalar : PERL_MAGIC_tied))
1372 {
1373 HV *stash;
1374 GV **gvp;
1375 dSP;
1376
655f5b26 1377 PUSHSTACKi(PERLSI_MAGIC);
e94ea821 1378 ENTER;
e94ea821 1379
6881372e
FC		 1380#define GET_HV_FETCH_TIE_FUNC \
1381 ( (gvp = (GV **)hv_fetchs(stash, "_tie_it", 0)) \
1382 && *gvp \
1383 && ( (isGV(*gvp) && GvCV(*gvp)) \
1384 || (SvROK(*gvp) && SvTYPE(SvRV(*gvp)) == SVt_PVCV) ) \
1385 )
e94ea821
FC		 1386
1387 /* Load the module if it is not loaded. */
360cebfd 1388 if (!(stash = gv_stashpvn(name, len, 0))
6881372e 1389 || ! GET_HV_FETCH_TIE_FUNC)
e94ea821 1390 {
360cebfd 1391 SV * const module = newSVpvn(name, len);
b82b06b8 1392 const char type = varname == '[' ? '$' : '%';
44a2ac75 1393 if ( flags & 1 )
45cbc99a 1394 save_scalar(gv);
5b2ef88e 1395 Perl_load_module(aTHX_ PERL_LOADMOD_NOIMPORT, module, NULL);
61bac25c 1396 assert(sp == PL_stack_sp);
360cebfd 1397 stash = gv_stashpvn(name, len, 0);
44a2ac75 1398 if (!stash)
360cebfd
FC		 1399 Perl_croak(aTHX_ "panic: Can't use %c%c because %s is not available",
1400 type, varname, name);
6881372e 1401 else if (! GET_HV_FETCH_TIE_FUNC)
360cebfd
FC		 1402 Perl_croak(aTHX_ "panic: Can't use %c%c because %s does not define _tie_it",
1403 type, varname, name);
e94ea821
FC		 1404 }
1405 /* Now call the tie function. It should be in *gvp. */
6881372e 1406 assert(gvp); assert(*gvp);
e94ea821
FC		 1407 PUSHMARK(SP);
1408 XPUSHs((SV *)gv);
1409 PUTBACK;
1410 call_sv((SV *)*gvp, G_VOID|G_DISCARD);
1411 LEAVE;
655f5b26 1412 POPSTACK;
d2c93421
RH		 1413 }
1414}
1415
7c719134
YO		 1416/* add a require_tie_mod_s - the _s suffix is similar to pvs type suffixes,
1417 * IOW it means we do STR_WITH_LEN() ourselves and the user should pass in
1418 * a true string WITHOUT a len.
1419 */
1420#define require_tie_mod_s(gv, varname, name, flags) \
1421 S_require_tie_mod(aTHX_ gv, varname, STR_WITH_LEN(name), flags)
1422
954c1994
GS		 1423/*
1424=for apidoc gv_stashpv
1425
da51bb9b 1426Returns a pointer to the stash for a specified package. Uses C<strlen> to
75c442e4 1427determine the length of C<name>, then calls C<gv_stashpvn()>.
954c1994
GS		 1428
1429=cut
1430*/
1431
a0d0e21e 1432HV*
864dbfa3 1433Perl_gv_stashpv(pTHX_ const char *name, I32 create)
a0d0e21e 1434{
7918f24d 1435 PERL_ARGS_ASSERT_GV_STASHPV;
dc437b57 1436 return gv_stashpvn(name, strlen(name), create);
1437}
1438
bc96cb06
SH		 1439/*
1440=for apidoc gv_stashpvn
1441
da51bb9b
NC		 1442Returns a pointer to the stash for a specified package. The C<namelen>
1443parameter indicates the length of the C<name>, in bytes. C<flags> is passed
1444to C<gv_fetchpvn_flags()>, so if set to C<GV_ADD> then the package will be
1445created if it does not already exist. If the package does not exist and
796b6530 1446C<flags> is 0 (or any other setting that does not create packages) then C<NULL>
da51bb9b
NC		 1447is returned.
1448
566a4718
YO		 1449Flags may be one of:
1450
1451 GV_ADD
1452 SVf_UTF8
1453 GV_NOADD_NOINIT
1454 GV_NOINIT
1455 GV_NOEXPAND
1456 GV_ADDMG
1457
796b6530 1458The most important of which are probably C<GV_ADD> and C<SVf_UTF8>.
bc96cb06 1459
808724c8 1460Note, use of C<gv_stashsv> instead of C<gv_stashpvn> where possible is strongly
1461recommended for performance reasons.
1462
4f8d487a
KW		 1463=for apidoc Amnh||GV_ADD
1464
bc96cb06
SH		 1465=cut
1466*/
1467
0eadbdad
YO		 1468/*
1469gv_stashpvn_internal
1470
1471Perform the internal bits of gv_stashsvpvn_cached. You could think of this
1472as being one half of the logic. Not to be called except from gv_stashsvpvn_cached().
1473
1474*/
1475
4e7ebec5 1476PERL_STATIC_INLINE HV*
0eadbdad 1477S_gv_stashpvn_internal(pTHX_ const char *name, U32 namelen, I32 flags)
dc437b57 1478{
0cea0058 1479 char smallbuf[128];
46fc3d4c 1480 char *tmpbuf;
a0d0e21e
LW		 1481 HV *stash;
1482 GV *tmpgv;
add0ecde 1483 U32 tmplen = namelen + 2;
dc437b57 1484
0eadbdad 1485 PERL_ARGS_ASSERT_GV_STASHPVN_INTERNAL;
7918f24d 1486
add0ecde 1487 if (tmplen <= sizeof smallbuf)
46fc3d4c 1488 tmpbuf = smallbuf;
1489 else
add0ecde
VP		 1490 Newx(tmpbuf, tmplen, char);
1491 Copy(name, tmpbuf, namelen, char);
1492 tmpbuf[namelen] = ':';
1493 tmpbuf[namelen+1] = ':';
1494 tmpgv = gv_fetchpvn_flags(tmpbuf, tmplen, flags, SVt_PVHV);
46fc3d4c 1495 if (tmpbuf != smallbuf)
1496 Safefree(tmpbuf);
d2fcb1d6 1497 if (!tmpgv || !isGV_with_GP(tmpgv))
da51bb9b 1498 return NULL;
a0d0e21e 1499 stash = GvHV(tmpgv);
1f656fcf 1500 if (!(flags & ~GV_NOADD_MASK) && !stash) return NULL;
9efb5c72 1501 assert(stash);
1f656fcf 1502 if (!HvNAME_get(stash)) {
0be4d16f 1503 hv_name_set(stash, name, namelen, flags & SVf_UTF8 ? SVf_UTF8 : 0 );
1f656fcf
FC		 1504
1505 /* FIXME: This is a repeat of logic in gv_fetchpvn_flags */
1506 /* If the containing stash has multiple effective
1507 names, see that this one gets them, too. */
1508 if (HvAUX(GvSTASH(tmpgv))->xhv_name_count)
1509 mro_package_moved(stash, NULL, tmpgv, 1);
1510 }
a0d0e21e 1511 return stash;
463ee0b2
LW		 1512}
1513
808724c8 1514/*
1515gv_stashsvpvn_cached
1516
1517Returns a pointer to the stash for a specified package, possibly
48a81373 1518cached. Implements both C<gv_stashpvn> and C<gv_stashsv>.
808724c8 1519
1520Requires one of either namesv or namepv to be non-null.
1521
fbe13c60 1522See C<L</gv_stashpvn>> for details on "flags".
808724c8 1523
1524Note the sv interface is strongly preferred for performance reasons.
1525
1526*/
1527
1528#define PERL_ARGS_ASSERT_GV_STASHSVPVN_CACHED \
1529 assert(namesv || name)
1530
c4b6b96d
SA		 1531HV*
1532Perl_gv_stashsvpvn_cached(pTHX_ SV *namesv, const char *name, U32 namelen, I32 flags)
4e7ebec5 1533{
1534 HV* stash;
808724c8 1535 HE* he;
1536
1537 PERL_ARGS_ASSERT_GV_STASHSVPVN_CACHED;
1538
1539 he = (HE *)hv_common(
1540 PL_stashcache, namesv, name, namelen,
4e7ebec5 1541 (flags & SVf_UTF8) ? HVhek_UTF8 : 0, 0, NULL, 0
1542 );
808724c8 1543
78e4f28f
DM		 1544 if (he) {
1545 SV *sv = HeVAL(he);
1546 HV *hv;
1547 assert(SvIOK(sv));
1548 hv = INT2PTR(HV*, SvIVX(sv));
1549 assert(SvTYPE(hv) == SVt_PVHV);
1550 return hv;
1551 }
d283e876 1552 else if (flags & GV_CACHE_ONLY) return NULL;
4e7ebec5 1553
808724c8 1554 if (namesv) {
1555 if (SvOK(namesv)) { /* prevent double uninit warning */
1556 STRLEN len;
1557 name = SvPV_const(namesv, len);
1558 namelen = len;
1559 flags |= SvUTF8(namesv);
1560 } else {
1561 name = ""; namelen = 0;
1562 }
1563 }
0eadbdad
YO		 1564 stash = gv_stashpvn_internal(name, namelen, flags);
1565
4e7ebec5 1566 if (stash && namelen) {
1567 SV* const ref = newSViv(PTR2IV(stash));
0eadbdad 1568 (void)hv_store(PL_stashcache, name,
4e7ebec5 1569 (flags & SVf_UTF8) ? -(I32)namelen : (I32)namelen, ref, 0);
1570 }
808724c8 1571
4e7ebec5 1572 return stash;
1573}
1574
808724c8 1575HV*
1576Perl_gv_stashpvn(pTHX_ const char *name, U32 namelen, I32 flags)
1577{
1578 PERL_ARGS_ASSERT_GV_STASHPVN;
1579 return gv_stashsvpvn_cached(NULL, name, namelen, flags);
1580}
1581
954c1994
GS		 1582/*
1583=for apidoc gv_stashsv
1584
fbe13c60
KW		 1585Returns a pointer to the stash for a specified package. See
1586C<L</gv_stashpvn>>.
954c1994 1587
fbe13c60
KW		 1588Note this interface is strongly preferred over C<gv_stashpvn> for performance
1589reasons.
808724c8 1590
954c1994
GS		 1591=cut
1592*/
1593
a0d0e21e 1594HV*
da51bb9b 1595Perl_gv_stashsv(pTHX_ SV *sv, I32 flags)
a0d0e21e 1596{
7918f24d 1597 PERL_ARGS_ASSERT_GV_STASHSV;
808724c8 1598 return gv_stashsvpvn_cached(sv, NULL, 0, flags);
a0d0e21e
LW		 1599}
1600
1601
463ee0b2 1602GV *
fe9845cc 1603Perl_gv_fetchpv(pTHX_ const char *nambeg, I32 add, const svtype sv_type) {
7918f24d 1604 PERL_ARGS_ASSERT_GV_FETCHPV;
b7787f18 1605 return gv_fetchpvn_flags(nambeg, strlen(nambeg), add, sv_type);
7a5fd60d
NC		 1606}
1607
1608GV *
fe9845cc 1609Perl_gv_fetchsv(pTHX_ SV *name, I32 flags, const svtype sv_type) {
7a5fd60d 1610 STRLEN len;
77cb3b01
FC		 1611 const char * const nambeg =
1612 SvPV_flags_const(name, len, flags & GV_NO_SVGMAGIC ? 0 : SV_GMAGIC);
7918f24d 1613 PERL_ARGS_ASSERT_GV_FETCHSV;
7a5fd60d
NC		 1614 return gv_fetchpvn_flags(nambeg, len, flags | SvUTF8(name), sv_type);
1615}
1616
90aeefb4 1617PERL_STATIC_INLINE void
290a1700 1618S_gv_magicalize_isa(pTHX_ GV *gv)
ad7cce9f
FR		 1619{
1620 AV* av;
1621
1622 PERL_ARGS_ASSERT_GV_MAGICALIZE_ISA;
1623
1624 av = GvAVn(gv);
1625 GvMULTI_on(gv);
1626 sv_magic(MUTABLE_SV(av), MUTABLE_SV(gv), PERL_MAGIC_isa,
1627 NULL, 0);
ad7cce9f
FR		 1628}
1629
90aeefb4
BF		 1630/* This function grabs name and tries to split a stash and glob
1631 * from its contents. TODO better description, comments
1632 *
1633 * If the function returns TRUE and 'name == name_end', then
1634 * 'gv' can be directly returned to the caller of gv_fetchpvn_flags
1635 */
1636PERL_STATIC_INLINE bool
1637S_parse_gv_stash_name(pTHX_ HV **stash, GV **gv, const char **name,
1638 STRLEN *len, const char *nambeg, STRLEN full_len,
1639 const U32 is_utf8, const I32 add)
1640{
8c573bee 1641 char *tmpfullbuf = NULL; /* only malloc one big chunk of memory when the smallbuff is not large enough */
90aeefb4
BF		 1642 const char *name_cursor;
1643 const char *const name_end = nambeg + full_len;
1644 const char *const name_em1 = name_end - 1;
8c573bee 1645 char smallbuf[64]; /* small buffer to avoid a malloc when possible */
90aeefb4
BF		 1646
1647 PERL_ARGS_ASSERT_PARSE_GV_STASH_NAME;
1648
7a207065
KW		 1649 if ( full_len > 2
1650 && **name == '*'
1651 && isIDFIRST_lazy_if_safe(*name + 1, name_end, is_utf8))
1652 {
90aeefb4
BF		 1653 /* accidental stringify on a GV? */
1654 (*name)++;
1655 }
1656
1657 for (name_cursor = *name; name_cursor < name_end; name_cursor++) {
1658 if (name_cursor < name_em1 &&
1659 ((*name_cursor == ':' && name_cursor[1] == ':')
1660 || *name_cursor == '\''))
1661 {
1662 if (!*stash)
1663 *stash = PL_defstash;
1664 if (!*stash || !SvREFCNT(*stash)) /* symbol table under destruction */
657ed7c1 1665 goto notok;
90aeefb4
BF		 1666
1667 *len = name_cursor - *name;
1668 if (name_cursor > nambeg) { /* Skip for initial :: or ' */
1669 const char *key;
1670 GV**gvp;
1671 if (*name_cursor == ':') {
1672 key = *name;
1673 *len += 2;
1674 }
f8ac814f 1675 else { /* using ' for package separator */
8c573bee
N		 1676 /* use our pre-allocated buffer when possible to save a malloc */
1677 char *tmpbuf;
1678 if ( *len+2 <= sizeof smallbuf)
1679 tmpbuf = smallbuf;
1680 else {
1681 /* only malloc once if needed */
1682 if (tmpfullbuf == NULL) /* only malloc&free once, a little more than needed */
1683 Newx(tmpfullbuf, full_len+2, char);
1684 tmpbuf = tmpfullbuf;
1685 }
90aeefb4
BF		 1686 Copy(*name, tmpbuf, *len, char);
1687 tmpbuf[(*len)++] = ':';
1688 tmpbuf[(*len)++] = ':';
1689 key = tmpbuf;
1690 }
c161da64 1691 gvp = (GV**)hv_fetch(*stash, key, is_utf8 ? -((I32)*len) : (I32)*len, add);
90aeefb4 1692 *gv = gvp ? *gvp : NULL;
f8ac814f 1693 if (!*gv || *gv == (const GV *)&PL_sv_undef) {
657ed7c1 1694 goto notok;
f8ac814f
N		 1695 }
1696 /* here we know that *gv && *gv != &PL_sv_undef */
1697 if (SvTYPE(*gv) != SVt_PVGV)
1698 gv_init_pvn(*gv, *stash, key, *len, (add & GV_ADDMULTI)|is_utf8);
1699 else
1700 GvMULTI_on(*gv);
90aeefb4
BF		 1701
1702 if (!(*stash = GvHV(*gv))) {
1703 *stash = GvHV(*gv) = newHV();
1704 if (!HvNAME_get(*stash)) {
1705 if (GvSTASH(*gv) == PL_defstash && *len == 6
c8b388b0 1706 && strBEGINs(*name, "CORE"))
4c4f3c46 1707 hv_name_sets(*stash, "CORE", 0);
90aeefb4
BF		 1708 else
1709 hv_name_set(
1710 *stash, nambeg, name_cursor-nambeg, is_utf8
1711 );
1712 /* If the containing stash has multiple effective
1713 names, see that this one gets them, too. */
1714 if (HvAUX(GvSTASH(*gv))->xhv_name_count)
1715 mro_package_moved(*stash, NULL, *gv, 1);
1716 }
1717 }
1718 else if (!HvNAME_get(*stash))
1719 hv_name_set(*stash, nambeg, name_cursor - nambeg, is_utf8);
1720 }
1721
1722 if (*name_cursor == ':')
1723 name_cursor++;
1724 *name = name_cursor+1;
1725 if (*name == name_end) {
120921ac
Z		 1726 if (!*gv) {
1727 *gv = MUTABLE_GV(*hv_fetchs(PL_defstash, "main::", TRUE));
1728 if (SvTYPE(*gv) != SVt_PVGV) {
1729 gv_init_pvn(*gv, PL_defstash, "main::", 6,
1730 GV_ADDMULTI);
1731 GvHV(*gv) =
1732 MUTABLE_HV(SvREFCNT_inc_simple(PL_defstash));
1733 }
1734 }
657ed7c1 1735 goto ok;
90aeefb4
BF		 1736 }
1737 }
1738 }
1739 *len = name_cursor - *name;
657ed7c1
DM		 1740 ok:
1741 Safefree(tmpfullbuf); /* free our tmpfullbuf if it was used */
90aeefb4 1742 return TRUE;
657ed7c1
DM		 1743 notok:
1744 Safefree(tmpfullbuf); /* free our tmpfullbuf if it was used */
1745 return FALSE;
90aeefb4
BF		 1746}
1747
657ed7c1 1748
536d1a88 1749/* Checks if an unqualified name is in the main stash */
90aeefb4 1750PERL_STATIC_INLINE bool
536d1a88 1751S_gv_is_in_main(pTHX_ const char *name, STRLEN len, const U32 is_utf8)
90aeefb4 1752{
536d1a88 1753 PERL_ARGS_ASSERT_GV_IS_IN_MAIN;
90aeefb4 1754
90aeefb4 1755 /* If it's an alphanumeric variable */
7a207065 1756 if ( len && isIDFIRST_lazy_if_safe(name, name + len, is_utf8) ) {
90aeefb4
BF		 1757 /* Some "normal" variables are always in main::,
1758 * like INC or STDOUT.
1759 */
1760 switch (len) {
1761 case 1:
1762 if (*name == '_')
536d1a88 1763 return TRUE;
90aeefb4
BF		 1764 break;
1765 case 3:
1766 if ((name[0] == 'I' && name[1] == 'N' && name[2] == 'C')
1767 || (name[0] == 'E' && name[1] == 'N' && name[2] == 'V')
1768 || (name[0] == 'S' && name[1] == 'I' && name[2] == 'G'))
536d1a88 1769 return TRUE;
90aeefb4
BF		 1770 break;
1771 case 4:
1772 if (name[0] == 'A' && name[1] == 'R' && name[2] == 'G'
1773 && name[3] == 'V')
536d1a88 1774 return TRUE;
90aeefb4
BF		 1775 break;
1776 case 5:
1777 if (name[0] == 'S' && name[1] == 'T' && name[2] == 'D'
1778 && name[3] == 'I' && name[4] == 'N')
536d1a88 1779 return TRUE;
90aeefb4
BF		 1780 break;
1781 case 6:
1782 if ((name[0] == 'S' && name[1] == 'T' && name[2] == 'D')
1783 &&((name[3] == 'O' && name[4] == 'U' && name[5] == 'T')
1784 ||(name[3] == 'E' && name[4] == 'R' && name[5] == 'R')))
536d1a88 1785 return TRUE;
90aeefb4
BF		 1786 break;
1787 case 7:
1788 if (name[0] == 'A' && name[1] == 'R' && name[2] == 'G'
1789 && name[3] == 'V' && name[4] == 'O' && name[5] == 'U'
1790 && name[6] == 'T')
536d1a88 1791 return TRUE;
90aeefb4
BF		 1792 break;
1793 }
536d1a88
BF		 1794 }
1795 /* *{""}, or a special variable like $@ */
1796 else
1797 return TRUE;
1798
1799 return FALSE;
1800}
1801
1802
1803/* This function is called if parse_gv_stash_name() failed to
1804 * find a stash, or if GV_NOTQUAL or an empty name was passed
1805 * to gv_fetchpvn_flags.
1806 *
1807 * It returns FALSE if the default stash can't be found nor created,
1808 * which might happen during global destruction.
1809 */
1810PERL_STATIC_INLINE bool
1811S_find_default_stash(pTHX_ HV **stash, const char *name, STRLEN len,
1812 const U32 is_utf8, const I32 add,
1813 const svtype sv_type)
1814{
1815 PERL_ARGS_ASSERT_FIND_DEFAULT_STASH;
1816
1817 /* No stash in name, so see how we can default */
90aeefb4 1818
536d1a88
BF		 1819 if ( gv_is_in_main(name, len, is_utf8) ) {
1820 *stash = PL_defstash;
1821 }
1822 else {
1823 if (IN_PERL_COMPILETIME) {
90aeefb4
BF		 1824 *stash = PL_curstash;
1825 if (add && (PL_hints & HINT_STRICT_VARS) &&
1826 sv_type != SVt_PVCV &&
1827 sv_type != SVt_PVGV &&
1828 sv_type != SVt_PVFM &&
1829 sv_type != SVt_PVIO &&
1830 !(len == 1 && sv_type == SVt_PV &&
1831 (*name == 'a' || *name == 'b')) )
1832 {
c161da64 1833 GV**gvp = (GV**)hv_fetch(*stash,name,is_utf8 ? -(I32)len : (I32)len,0);
90aeefb4
BF		 1834 if (!gvp || *gvp == (const GV *)&PL_sv_undef ||
1835 SvTYPE(*gvp) != SVt_PVGV)
1836 {
1837 *stash = NULL;
1838 }
1839 else if ((sv_type == SVt_PV && !GvIMPORTED_SV(*gvp)) ||
1840 (sv_type == SVt_PVAV && !GvIMPORTED_AV(*gvp)) ||
1841 (sv_type == SVt_PVHV && !GvIMPORTED_HV(*gvp)) )
1842 {
1843 /* diag_listed_as: Variable "%s" is not imported%s */
1844 Perl_ck_warner_d(
1845 aTHX_ packWARN(WARN_MISC),
147e3846 1846 "Variable \"%c%" UTF8f "\" is not imported",
90aeefb4
BF		 1847 sv_type == SVt_PVAV ? '@' :
1848 sv_type == SVt_PVHV ? '%' : '$',
1849 UTF8fARG(is_utf8, len, name));
1850 if (GvCVu(*gvp))
1851 Perl_ck_warner_d(
1852 aTHX_ packWARN(WARN_MISC),
147e3846 1853 "\t(Did you mean &%" UTF8f " instead?)\n",
90aeefb4
BF		 1854 UTF8fARG(is_utf8, len, name)
1855 );
1856 *stash = NULL;
1857 }
1858 }
1859 }
1860 else {
1861 /* Use the current op's stash */
1862 *stash = CopSTASH(PL_curcop);
1863 }
1864 }
90aeefb4
BF		 1865
1866 if (!*stash) {
1867 if (add && !PL_in_clean_all) {
10860bf4
FC		 1868 GV *gv;
1869 qerror(Perl_mess(aTHX_
147e3846 1870 "Global symbol \"%s%" UTF8f
d8c6310a 1871 "\" requires explicit package name (did you forget to "
147e3846 1872 "declare \"my %s%" UTF8f "\"?)",
d8c6310a
FC		 1873 (sv_type == SVt_PV ? "$"
1874 : sv_type == SVt_PVAV ? "@"
1875 : sv_type == SVt_PVHV ? "%"
1876 : ""), UTF8fARG(is_utf8, len, name),
90aeefb4
BF		 1877 (sv_type == SVt_PV ? "$"
1878 : sv_type == SVt_PVAV ? "@"
1879 : sv_type == SVt_PVHV ? "%"
10860bf4 1880 : ""), UTF8fARG(is_utf8, len, name)));
cd164bf8
BF		 1881 /* To maintain the output of errors after the strict exception
1882 * above, and to keep compat with older releases, rather than
1883 * placing the variables in the pad, we place
1884 * them in the <none>:: stash.
1885 */
90aeefb4
BF		 1886 gv = gv_fetchpvs("<none>::", GV_ADDMULTI, SVt_PVHV);
1887 if (!gv) {
1888 /* symbol table under destruction */
1889 return FALSE;
1890 }
1891 *stash = GvHV(gv);
1892 }
1893 else
1894 return FALSE;
1895 }
1896
1897 if (!SvREFCNT(*stash)) /* symbol table under destruction */
1898 return FALSE;
1899
1900 return TRUE;
1901}
1902
8c995aba
FC		 1903/* gv_magicalize only turns on the SVf_READONLY flag, not SVf_PROTECT. So
1904 redefine SvREADONLY_on for that purpose. We don’t use it later on in
1905 this file. */
1906#undef SvREADONLY_on
1907#define SvREADONLY_on(sv) (SvFLAGS(sv) |= SVf_READONLY)
1908
930867a8
BF		 1909/* gv_magicalize() is called by gv_fetchpvn_flags when creating
1910 * a new GV.
1911 * Note that it does not insert the GV into the stash prior to
1912 * magicalization, which some variables require need in order
c22e17d0 1913 * to work (like %+, %-, %!), so callers must take care of
1321bbe3 1914 * that.
930867a8 1915 *
1321bbe3
FC		 1916 * It returns true if the gv did turn out to be magical one; i.e.,
1917 * if gv_magicalize actually did something.
930867a8
BF		 1918 */
1919PERL_STATIC_INLINE bool
1920S_gv_magicalize(pTHX_ GV *gv, HV *stash, const char *name, STRLEN len,
1321bbe3 1921 const svtype sv_type)
79072805 1922{
960b831f 1923 SSize_t paren;
79072805 1924
930867a8 1925 PERL_ARGS_ASSERT_GV_MAGICALIZE;
90aeefb4 1926
44428a46 1927 if (stash != PL_defstash) { /* not the main stash */
ea238638 1928 /* We only have to check for a few names here: a, b, EXPORT, ISA
4aaa4757
FC		 1929 and VERSION. All the others apply only to the main stash or to
1930 CORE (which is checked right after this). */
ea238638 1931 if (len) {
cc4c2da6 1932 switch (*name) {
cc4c2da6 1933 case 'E':
3092ee0c
YO		 1934 if (
1935 len >= 6 && name[1] == 'X' &&
1936 (memEQs(name, len, "EXPORT")
eafd371c
YO		 1937 ||memEQs(name, len, "EXPORT_OK")
1938 ||memEQs(name, len, "EXPORT_FAIL")
3092ee0c 1939 ||memEQs(name, len, "EXPORT_TAGS"))
eafd371c 1940 )
cc4c2da6
NC		 1941 GvMULTI_on(gv);
1942 break;
1943 case 'I':
eafd371c 1944 if (memEQs(name, len, "ISA"))
290a1700 1945 gv_magicalize_isa(gv);
cc4c2da6 1946 break;
44428a46 1947 case 'V':
eafd371c 1948 if (memEQs(name, len, "VERSION"))
44428a46
FC		 1949 GvMULTI_on(gv);
1950 break;
ea238638 1951 case 'a':
eafd371c 1952 if (stash == PL_debstash && memEQs(name, len, "args")) {
7bb33634
FC		 1953 GvMULTI_on(gv_AVadd(gv));
1954 break;
eafd371c
YO		 1955 }
1956 /* FALLTHROUGH */
ea238638
FC		 1957 case 'b':
1958 if (len == 1 && sv_type == SVt_PV)
1959 GvMULTI_on(gv);
924ba076 1960 /* FALLTHROUGH */
4aaa4757
FC		 1961 default:
1962 goto try_core;
1963 }
1321bbe3 1964 goto ret;
4aaa4757
FC		 1965 }
1966 try_core:
1967 if (len > 1 /* shortest is uc */ && HvNAMELEN_get(stash) == 4) {
1968 /* Avoid null warning: */
1969 const char * const stashname = HvNAME(stash); assert(stashname);
c8b388b0 1970 if (strBEGINs(stashname, "CORE"))
87566176 1971 S_maybe_add_coresub(aTHX_ 0, gv, name, len);
44428a46
FC		 1972 }
1973 }
1974 else if (len > 1) {
1975#ifndef EBCDIC
1976 if (*name > 'V' ) {
1977 NOOP;
1978 /* Nothing else to do.
1979 The compiler will probably turn the switch statement into a
1980 branch table. Make sure we avoid even that small overhead for
2ae25f5c
KW		 1981 the common case of lower case variable names. (On EBCDIC
1982 platforms, we can't just do:
1983 if (NATIVE_TO_ASCII(*name) > NATIVE_TO_ASCII('V') ) {
1984 because cases like '\027' in the switch statement below are
1985 C1 (non-ASCII) controls on those platforms, so the remapping
1986 would make them larger than 'V')
1987 */
44428a46
FC		 1988 } else
1989#endif
1990 {
44428a46
FC		 1991 switch (*name) {
1992 case 'A':
eafd371c 1993 if (memEQs(name, len, "ARGV")) {
44428a46
FC		 1994 IoFLAGS(GvIOn(gv)) |= IOf_ARGV|IOf_START;
1995 }
eafd371c 1996 else if (memEQs(name, len, "ARGVOUT")) {
44428a46
FC		 1997 GvMULTI_on(gv);
1998 }
1999 break;
2000 case 'E':
3092ee0c
YO		 2001 if (
2002 len >= 6 && name[1] == 'X' &&
2003 (memEQs(name, len, "EXPORT")
055ae706
YO		 2004 ||memEQs(name, len, "EXPORT_OK")
2005 ||memEQs(name, len, "EXPORT_FAIL")
3092ee0c 2006 ||memEQs(name, len, "EXPORT_TAGS"))
055ae706 2007 )
44428a46
FC		 2008 GvMULTI_on(gv);
2009 break;
2010 case 'I':
eafd371c 2011 if (memEQs(name, len, "ISA")) {
290a1700 2012 gv_magicalize_isa(gv);
44428a46
FC		 2013 }
2014 break;
cc4c2da6 2015 case 'S':
eafd371c 2016 if (memEQs(name, len, "SIG")) {
cc4c2da6
NC		 2017 HV *hv;
2018 I32 i;
d525a7b2
NC		 2019 if (!PL_psig_name) {
2020 Newxz(PL_psig_name, 2 * SIG_SIZE, SV*);
a02a5408 2021 Newxz(PL_psig_pend, SIG_SIZE, int);
d525a7b2 2022 PL_psig_ptr = PL_psig_name + SIG_SIZE;
0bdedcb3
NC		 2023 } else {
2024 /* I think that the only way to get here is to re-use an
2025 embedded perl interpreter, where the previous
2026 use didn't clean up fully because
2027 PL_perl_destruct_level was 0. I'm not sure that we
2028 "support" that, in that I suspect in that scenario
2029 there are sufficient other garbage values left in the
2030 interpreter structure that something else will crash
2031 before we get here. I suspect that this is one of
2032 those "doctor, it hurts when I do this" bugs. */
d525a7b2 2033 Zero(PL_psig_name, 2 * SIG_SIZE, SV*);
0bdedcb3 2034 Zero(PL_psig_pend, SIG_SIZE, int);
cc4c2da6
NC		 2035 }
2036 GvMULTI_on(gv);
2037 hv = GvHVn(gv);
a0714e2c 2038 hv_magic(hv, NULL, PERL_MAGIC_sig);
cc4c2da6 2039 for (i = 1; i < SIG_SIZE; i++) {
551405c4 2040 SV * const * const init = hv_fetch(hv, PL_sig_name[i], strlen(PL_sig_name[i]), 1);
cc4c2da6
NC		 2041 if (init)
2042 sv_setsv(*init, &PL_sv_undef);
cc4c2da6
NC		 2043 }
2044 }
2045 break;
2046 case 'V':
eafd371c 2047 if (memEQs(name, len, "VERSION"))
cc4c2da6
NC		 2048 GvMULTI_on(gv);
2049 break;
e5218da5 2050 case '\003': /* $^CHILD_ERROR_NATIVE */
eafd371c 2051 if (memEQs(name, len, "\003HILD_ERROR_NATIVE"))
e5218da5 2052 goto magicalize;
27deb0cf
YO		 2053 /* @{^CAPTURE} %{^CAPTURE} */
2054 if (memEQs(name, len, "\003APTURE")) {
2055 AV* const av = GvAVn(gv);
fa531f32 2056 const Size_t n = *name;
27deb0cf 2057
fa531f32 2058 sv_magic(MUTABLE_SV(av), (SV*)n, PERL_MAGIC_regdata, NULL, 0);
27deb0cf
YO		 2059 SvREADONLY_on(av);
2060
d8422270 2061 require_tie_mod_s(gv, '+', "Tie::Hash::NamedCapture",0);
27deb0cf
YO		 2062
2063 } else /* %{^CAPTURE_ALL} */
2064 if (memEQs(name, len, "\003APTURE_ALL")) {
d8422270 2065 require_tie_mod_s(gv, '-', "Tie::Hash::NamedCapture",0);
27deb0cf 2066 }
e5218da5 2067 break;
cc4c2da6 2068 case '\005': /* $^ENCODING */
eafd371c 2069 if (memEQs(name, len, "\005NCODING"))
cc4c2da6
NC		 2070 goto magicalize;
2071 break;
9f601cf3
TC		 2072 case '\006':
2073 if (memEQs(name, len, "\006EATURE_BITS"))
2074 goto magicalize;
2075 break;
9ebf26ad 2076 case '\007': /* $^GLOBAL_PHASE */
eafd371c 2077 if (memEQs(name, len, "\007LOBAL_PHASE"))
9ebf26ad
FR		 2078 goto ro_magicalize;
2079 break;
8561ea1d 2080 case '\014': /* $^LAST_FH */
eafd371c 2081 if (memEQs(name, len, "\014AST_FH"))
8561ea1d
FC		 2082 goto ro_magicalize;
2083 break;
cde0cee5 2084 case '\015': /* $^MATCH */
eafd371c 2085 if (memEQs(name, len, "\015ATCH")) {
960b831f
NC		 2086 paren = RX_BUFF_IDX_CARET_FULLMATCH;
2087 goto storeparen;
2088 }
66230c86 2089 break;
cc4c2da6 2090 case '\017': /* $^OPEN */
eafd371c 2091 if (memEQs(name, len, "\017PEN"))
cc4c2da6
NC		 2092 goto magicalize;
2093 break;
cde0cee5 2094 case '\020': /* $^PREMATCH $^POSTMATCH */
eafd371c 2095 if (memEQs(name, len, "\020REMATCH")) {
960b831f
NC		 2096 paren = RX_BUFF_IDX_CARET_PREMATCH;
2097 goto storeparen;
2098 }
eafd371c 2099 if (memEQs(name, len, "\020OSTMATCH")) {
960b831f
NC		 2100 paren = RX_BUFF_IDX_CARET_POSTMATCH;
2101 goto storeparen;
2102 }
9ebf26ad 2103 break;
f512d242
KW		 2104 case '\023':
2105 if (memEQs(name, len, "\023AFE_LOCALES"))
2106 goto ro_magicalize;
2107 break;
cc4c2da6 2108 case '\024': /* ${^TAINT} */
eafd371c 2109 if (memEQs(name, len, "\024AINT"))
cc4c2da6
NC		 2110 goto ro_magicalize;
2111 break;
7cebcbc0 2112 case '\025': /* ${^UNICODE}, ${^UTF8LOCALE} */
eafd371c 2113 if (memEQs(name, len, "\025NICODE"))
cc4c2da6 2114 goto ro_magicalize;
eafd371c 2115 if (memEQs(name, len, "\025TF8LOCALE"))
7cebcbc0 2116 goto ro_magicalize;
eafd371c 2117 if (memEQs(name, len, "\025TF8CACHE"))
e07ea26a 2118 goto magicalize;
cc4c2da6
NC		 2119 break;
2120 case '\027': /* $^WARNING_BITS */
eafd371c 2121 if (memEQs(name, len, "\027ARNING_BITS"))
cc4c2da6 2122 goto magicalize;
8ca2a5d6 2123#ifdef WIN32
eafd371c 2124 else if (memEQs(name, len, "\027IN32_SLOPPY_STAT"))
8ca2a5d6
DD		 2125 goto magicalize;
2126#endif
cc4c2da6
NC		 2127 break;
2128 case '1':
2129 case '2':
2130 case '3':
2131 case '4':
2132 case '5':
2133 case '6':
2134 case '7':
2135 case '8':
2136 case '9':
85e6fe83 2137 {
2fdbfb4d
AB		 2138 /* Ensures that we have an all-digit variable, ${"1foo"} fails
2139 this test */
22ff3130
HS		 2140 UV uv;
2141 if (!grok_atoUV(name, &uv, NULL) || uv > I32_MAX)
1321bbe3 2142 goto ret;
22ff3130
HS		 2143 /* XXX why are we using a SSize_t? */
2144 paren = (SSize_t)(I32)uv;
960b831f 2145 goto storeparen;
1d7c1841 2146 }
dc437b57 2147 }
93a17b20 2148 }
392db708
NC		 2149 } else {
2150 /* Names of length 1. (Or 0. But name is NUL terminated, so that will
2151 be case '\0' in this switch statement (ie a default case) */
cc4c2da6 2152 switch (*name) {
6361f656 2153 case '&': /* $& */
960b831f
NC		 2154 paren = RX_BUFF_IDX_FULLMATCH;
2155 goto sawampersand;
6361f656 2156 case '`': /* $` */
960b831f
NC		 2157 paren = RX_BUFF_IDX_PREMATCH;
2158 goto sawampersand;
6361f656 2159 case '\'': /* $' */
960b831f
NC		 2160 paren = RX_BUFF_IDX_POSTMATCH;
2161 sawampersand:
1a904fc8 2162#ifdef PERL_SAWAMPERSAND
a289ef89 2163 if (!(
cc4c2da6
NC		 2164 sv_type == SVt_PVAV ||
2165 sv_type == SVt_PVHV ||
2166 sv_type == SVt_PVCV ||
2167 sv_type == SVt_PVFM ||
2168 sv_type == SVt_PVIO
d3b97530
DM		 2169 )) { PL_sawampersand |=
2170 (*name == '`')
2171 ? SAWAMPERSAND_LEFT
2172 : (*name == '&')
2173 ? SAWAMPERSAND_MIDDLE
2174 : SAWAMPERSAND_RIGHT;
2175 }
1a904fc8 2176#endif
960b831f 2177 goto storeparen;
e91d8259
NC		 2178 case '1': /* $1 */
2179 case '2': /* $2 */
2180 case '3': /* $3 */
2181 case '4': /* $4 */
2182 case '5': /* $5 */
2183 case '6': /* $6 */
2184 case '7': /* $7 */
2185 case '8': /* $8 */
2186 case '9': /* $9 */
960b831f
NC		 2187 paren = *name - '0';
2188
2189 storeparen:
e91d8259
NC		 2190 /* Flag the capture variables with a NULL mg_ptr
2191 Use mg_len for the array index to lookup. */
960b831f 2192 sv_magic(GvSVn(gv), MUTABLE_SV(gv), PERL_MAGIC_sv, NULL, paren);
e91d8259 2193 break;
cc4c2da6 2194
6361f656 2195 case ':': /* $: */
c69033f2 2196 sv_setpv(GvSVn(gv),PL_chopset);
cc4c2da6
NC		 2197 goto magicalize;
2198
6361f656 2199 case '?': /* $? */
ff0cee69 2200#ifdef COMPLEX_STATUS
c69033f2 2201 SvUPGRADE(GvSVn(gv), SVt_PVLV);
ff0cee69 2202#endif
cc4c2da6 2203 goto magicalize;
ff0cee69 2204
6361f656 2205 case '!': /* $! */
67261566 2206 GvMULTI_on(gv);
44a2ac75 2207 /* If %! has been used, automatically load Errno.pm. */
d2c93421 2208
ad64d0ec 2209 sv_magic(GvSVn(gv), MUTABLE_SV(gv), PERL_MAGIC_sv, name, len);
d2c93421 2210
7c719134 2211 /* magicalization must be done before require_tie_mod_s is called */
67261566 2212 if (sv_type == SVt_PVHV || sv_type == SVt_PVGV)
7c719134 2213 require_tie_mod_s(gv, '!', "Errno", 1);
d2c93421 2214
6cef1e77 2215 break;
754f85ad
YO		 2216 case '-': /* $-, %-, @- */
2217 case '+': /* $+, %+, @+ */
27deb0cf
YO		 2218 GvMULTI_on(gv); /* no used once warnings here */
2219 { /* $- $+ */
2220 sv_magic(GvSVn(gv), MUTABLE_SV(gv), PERL_MAGIC_sv, name, len);
2221 if (*name == '+')
2222 SvREADONLY_on(GvSVn(gv));
2223 }
2224 { /* %- %+ */
2225 if (sv_type == SVt_PVHV || sv_type == SVt_PVGV)
2226 require_tie_mod_s(gv, *name, "Tie::Hash::NamedCapture",0);
2227 }
2228 { /* @- @+ */
2229 AV* const av = GvAVn(gv);
fa531f32 2230 const Size_t n = *name;
67261566 2231
fa531f32 2232 sv_magic(MUTABLE_SV(av), (SV*)n, PERL_MAGIC_regdata, NULL, 0);
27deb0cf
YO		 2233 SvREADONLY_on(av);
2234 }
80305961 2235 break;
a678626e
A		 2236 case '*': /* $* */
2237 case '#': /* $# */
dcb414ac
JK		 2238 if (sv_type == SVt_PV)
2239 /* diag_listed_as: $* is no longer supported as of Perl 5.30 */
2240 Perl_croak(aTHX_ "$%c is no longer supported as of Perl 5.30", *name);
2241 break;
b3ca2e83
NC		 2242 case '\010': /* $^H */
2243 {
2244 HV *const hv = GvHVn(gv);
2245 hv_magic(hv, NULL, PERL_MAGIC_hints);
2246 }
2247 goto magicalize;
cc4c2da6 2248 case '\023': /* $^S */
2fdbfb4d
AB		 2249 ro_magicalize:
2250 SvREADONLY_on(GvSVn(gv));
924ba076 2251 /* FALLTHROUGH */
6361f656 2252 case '0': /* $0 */
6361f656
AB		 2253 case '^': /* $^ */
2254 case '~': /* $~ */
2255 case '=': /* $= */
2256 case '%': /* $% */
2257 case '.': /* $. */
2258 case '(': /* $( */
2259 case ')': /* $) */
2260 case '<': /* $< */
2261 case '>': /* $> */
2262 case '\\': /* $\ */
2263 case '/': /* $/ */
4505a31f 2264 case '|': /* $| */
9cdac2a2 2265 case '$': /* $$ */
c22e17d0 2266 case '[': /* $[ */
cc4c2da6
NC		 2267 case '\001': /* $^A */
2268 case '\003': /* $^C */
2269 case '\004': /* $^D */
2270 case '\005': /* $^E */
2271 case '\006': /* $^F */
cc4c2da6
NC		 2272 case '\011': /* $^I, NOT \t in EBCDIC */
2273 case '\016': /* $^N */
2274 case '\017': /* $^O */
2275 case '\020': /* $^P */
2276 case '\024': /* $^T */
2277 case '\027': /* $^W */
2278 magicalize:
ad64d0ec 2279 sv_magic(GvSVn(gv), MUTABLE_SV(gv), PERL_MAGIC_sv, name, len);
cc4c2da6 2280 break;
e521374c 2281
cc4c2da6 2282 case '\014': /* $^L */
76f68e9b 2283 sv_setpvs(GvSVn(gv),"\f");
463ee0b2 2284 break;
6361f656 2285 case ';': /* $; */
76f68e9b 2286 sv_setpvs(GvSVn(gv),"\034");
463ee0b2 2287 break;
6361f656 2288 case ']': /* $] */
cc4c2da6 2289 {
3638bf15 2290 SV * const sv = GvSV(gv);
d7aa5382 2291 if (!sv_derived_from(PL_patchlevel, "version"))
ac0e6a2f 2292 upg_version(PL_patchlevel, TRUE);
7d54d38e
SH		 2293 GvSV(gv) = vnumify(PL_patchlevel);
2294 SvREADONLY_on(GvSV(gv));
2295 SvREFCNT_dec(sv);
93a17b20
LW		 2296 }
2297 break;
cc4c2da6
NC		 2298 case '\026': /* $^V */
2299 {
3638bf15 2300 SV * const sv = GvSV(gv);
f9be5ac8
DM		 2301 GvSV(gv) = new_version(PL_patchlevel);
2302 SvREADONLY_on(GvSV(gv));
2303 SvREFCNT_dec(sv);
16070b82
GS		 2304 }
2305 break;
ea238638
FC		 2306 case 'a':
2307 case 'b':
dc3e91f6 2308 if (sv_type == SVt_PV)
ea238638 2309 GvMULTI_on(gv);
cc4c2da6 2310 }
79072805 2311 }
930867a8 2312
1321bbe3
FC		 2313 ret:
2314 /* Return true if we actually did something. */
2315 return GvAV(gv) || GvHV(gv) || GvIO(gv) || GvCV(gv)
2316 || ( GvSV(gv) && (
2317 SvOK(GvSV(gv)) || SvMAGICAL(GvSV(gv))
2318 )
2319 );
71c35c05
BF		 2320}
2321
8c995aba
FC		 2322/* If we do ever start using this later on in the file, we need to make
2323 sure we don’t accidentally use the wrong definition. */
2324#undef SvREADONLY_on
2325
070dc475
BF		 2326/* This function is called when the stash already holds the GV of the magic
2327 * variable we're looking for, but we need to check that it has the correct
2328 * kind of magic. For example, if someone first uses $! and then %!, the
2329 * latter would end up here, and we add the Errno tie to the HASH slot of
2330 * the *! glob.
2331 */
2332PERL_STATIC_INLINE void
2333S_maybe_multimagic_gv(pTHX_ GV *gv, const char *name, const svtype sv_type)
2334{
2335 PERL_ARGS_ASSERT_MAYBE_MULTIMAGIC_GV;
2336
2337 if (sv_type == SVt_PVHV || sv_type == SVt_PVGV) {
2338 if (*name == '!')
7c719134 2339 require_tie_mod_s(gv, '!', "Errno", 1);
070dc475 2340 else if (*name == '-' || *name == '+')
7c719134 2341 require_tie_mod_s(gv, *name, "Tie::Hash::NamedCapture", 0);
a678626e
A		 2342 } else if (sv_type == SVt_PV) {
2343 if (*name == '*' || *name == '#') {
dcb414ac
JK		 2344 /* diag_listed_as: $* is no longer supported as of Perl 5.30 */
2345 Perl_croak(aTHX_ "$%c is no longer supported as of Perl 5.30", *name);
a678626e 2346 }
070dc475
BF		 2347 }
2348 if (sv_type==SVt_PV || sv_type==SVt_PVGV) {
2349 switch (*name) {
070dc475
BF		 2350#ifdef PERL_SAWAMPERSAND
2351 case '`':
2352 PL_sawampersand |= SAWAMPERSAND_LEFT;
2353 (void)GvSVn(gv);
2354 break;
2355 case '&':
2356 PL_sawampersand |= SAWAMPERSAND_MIDDLE;
2357 (void)GvSVn(gv);
2358 break;
2359 case '\'':
2360 PL_sawampersand |= SAWAMPERSAND_RIGHT;
2361 (void)GvSVn(gv);
2362 break;
2363#endif
2364 }
2365 }
2366}
2367
71c35c05
BF		 2368GV *
2369Perl_gv_fetchpvn_flags(pTHX_ const char *nambeg, STRLEN full_len, I32 flags,
2370 const svtype sv_type)
2371{
71c35c05
BF		 2372 const char *name = nambeg;
2373 GV *gv = NULL;
2374 GV**gvp;
2375 STRLEN len;
2376 HV *stash = NULL;
2377 const I32 no_init = flags & (GV_NOADD_NOINIT | GV_NOINIT);
2378 const I32 no_expand = flags & GV_NOEXPAND;
2379 const I32 add = flags & ~GV_NOADD_MASK;
2380 const U32 is_utf8 = flags & SVf_UTF8;
930867a8 2381 bool addmg = cBOOL(flags & GV_ADDMG);
71c35c05
BF		 2382 const char *const name_end = nambeg + full_len;
2383 U32 faking_it;
2384
2385 PERL_ARGS_ASSERT_GV_FETCHPVN_FLAGS;
2386
2387 /* If we have GV_NOTQUAL, the caller promised that
2388 * there is no stash, so we can skip the check.
2389 * Similarly if full_len is 0, since then we're
2390 * dealing with something like *{""} or ""->foo()
2391 */
2392 if ((flags & GV_NOTQUAL) || !full_len) {
2393 len = full_len;
2394 }
2395 else if (parse_gv_stash_name(&stash, &gv, &name, &len, nambeg, full_len, is_utf8, add)) {
2396 if (name == name_end) return gv;
2397 }
2398 else {
2399 return NULL;
2400 }
2401
2402 if (!stash && !find_default_stash(&stash, name, len, is_utf8, add, sv_type)) {
2403 return NULL;
2404 }
2405
2406 /* By this point we should have a stash and a name */
c161da64 2407 gvp = (GV**)hv_fetch(stash,name,is_utf8 ? -(I32)len : (I32)len,add);
71c35c05
BF		 2408 if (!gvp || *gvp == (const GV *)&PL_sv_undef) {
2409 if (addmg) gv = (GV *)newSV(0);
2410 else return NULL;
2411 }
2412 else gv = *gvp, addmg = 0;
2413 /* From this point on, addmg means gv has not been inserted in the
2414 symtab yet. */
2415
2416 if (SvTYPE(gv) == SVt_PVGV) {
c002ae9a
BF		 2417 /* The GV already exists, so return it, but check if we need to do
2418 * anything else with it before that.
2419 */
71c35c05 2420 if (add) {
c002ae9a
BF		 2421 /* This is the heuristic that handles if a variable triggers the
2422 * 'used only once' warning. If there's already a GV in the stash
2423 * with this name, then we assume that the variable has been used
2424 * before and turn its MULTI flag on.
2425 * It's a heuristic because it can easily be "tricked", like with
2426 * BEGIN { $a = 1; $::{foo} = *a }; () = $foo
2427 * not warning about $main::foo being used just once
2428 */
71c35c05
BF		 2429 GvMULTI_on(gv);
2430 gv_init_svtype(gv, sv_type);
2431 /* You reach this path once the typeglob has already been created,
2432 either by the same or a different sigil. If this path didn't
2433 exist, then (say) referencing $! first, and %! second would
2434 mean that %! was not handled correctly. */
2435 if (len == 1 && stash == PL_defstash) {
070dc475 2436 maybe_multimagic_gv(gv, name, sv_type);
71c35c05 2437 }
b59bf0b2
KW		 2438 else if (sv_type == SVt_PVAV
2439 && memEQs(name, len, "ISA")
71c35c05
BF		 2440 && (!GvAV(gv) || !SvSMAGICAL(GvAV(gv))))
2441 gv_magicalize_isa(gv);
2442 }
2443 return gv;
2444 } else if (no_init) {
2445 assert(!addmg);
2446 return gv;
c002ae9a
BF		 2447 }
2448 /* If GV_NOEXPAND is true and what we got off the stash is a ref,
2449 * don't expand it to a glob. This is an optimization so that things
2450 * copying constants over, like Exporter, don't have to be rewritten
2451 * to take into account that you can store more than just globs in
2452 * stashes.
2453 */
2454 else if (no_expand && SvROK(gv)) {
71c35c05
BF		 2455 assert(!addmg);
2456 return gv;
2457 }
2458
2459 /* Adding a new symbol.
2460 Unless of course there was already something non-GV here, in which case
2461 we want to behave as if there was always a GV here, containing some sort
2462 of subroutine.
2463 Otherwise we run the risk of creating things like GvIO, which can cause
2464 subtle bugs. eg the one that tripped up SQL::Translator */
2465
2466 faking_it = SvOK(gv);
2467
2468 if (add & GV_ADDWARN)
2469 Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL),
147e3846 2470 "Had to create %" UTF8f " unexpectedly",
71c35c05
BF		 2471 UTF8fARG(is_utf8, name_end-nambeg, nambeg));
2472 gv_init_pvn(gv, stash, name, len, (add & GV_ADDMULTI)|is_utf8);
2473
7a207065
KW		 2474 if ( full_len != 0
2475 && isIDFIRST_lazy_if_safe(name, name + full_len, is_utf8)
2476 && !ckWARN(WARN_ONCE) )
2477 {
71c35c05 2478 GvMULTI_on(gv) ;
7a207065 2479 }
71c35c05
BF		 2480
2481 /* set up magic where warranted */
1321bbe3 2482 if ( gv_magicalize(gv, stash, name, len, sv_type) ) {
930867a8 2483 /* See 23496c6 */
1321bbe3
FC		 2484 if (addmg) {
2485 /* gv_magicalize magicalised this gv, so we want it
930867a8 2486 * stored in the symtab.
1321bbe3
FC		 2487 * Effectively the caller is asking, ‘Does this gv exist?’
2488 * And we respond, ‘Er, *now* it does!’
930867a8
BF		 2489 */
2490 (void)hv_store(stash,name,len,(SV *)gv,0);
1321bbe3
FC		 2491 }
2492 }
2493 else if (addmg) {
2494 /* The temporary GV created above */
930867a8
BF		 2495 SvREFCNT_dec_NN(gv);
2496 gv = NULL;
930867a8 2497 }
71c35c05 2498
e6066781 2499 if (gv) gv_init_svtype(gv, faking_it ? SVt_PVCV : sv_type);
93a17b20 2500 return gv;
79072805
LW		 2501}
2502
2503void
35a4481c 2504Perl_gv_fullname4(pTHX_ SV *sv, const GV *gv, const char *prefix, bool keepmain)
43693395 2505{
ed60a868 2506 const char *name;
35a4481c 2507 const HV * const hv = GvSTASH(gv);
7918f24d
NC		 2508
2509 PERL_ARGS_ASSERT_GV_FULLNAME4;
2510
666ea192 2511 sv_setpv(sv, prefix ? prefix : "");
a0288114 2512
52a6327b 2513 if (hv && (name = HvNAME(hv))) {
ed60a868 2514 const STRLEN len = HvNAMELEN(hv);
61e2287f 2515 if (keepmain || ! memBEGINs(name, len, "main")) {
ed60a868 2516 sv_catpvn_flags(sv,name,len,HvNAMEUTF8(hv)?SV_CATUTF8:SV_CATBYTES);
396482e1 2517 sv_catpvs(sv,"::");
ed60a868 2518 }
43693395 2519 }
ed60a868 2520 else sv_catpvs(sv,"__ANON__::");
04f3bf56 2521 sv_catsv(sv,sv_2mortal(newSVhek(GvNAME_HEK(gv))));
43693395
GS		 2522}
2523
2524void
35a4481c 2525Perl_gv_efullname4(pTHX_ SV *sv, const GV *gv, const char *prefix, bool keepmain)
43693395 2526{
099be4f1 2527 const GV * const egv = GvEGVx(gv);
7918f24d
NC		 2528
2529 PERL_ARGS_ASSERT_GV_EFULLNAME4;
2530
46c461b5 2531 gv_fullname4(sv, egv ? egv : gv, prefix, keepmain);
43693395
GS		 2532}
2533
39a65960
DM		 2534
2535/* recursively scan a stash and any nested stashes looking for entries
2536 * that need the "only used once" warning raised
2537 */
2538
79072805 2539void
51da40ed 2540Perl_gv_check(pTHX_ HV *stash)
79072805 2541{
eb578fdb 2542 I32 i;
463ee0b2 2543
7918f24d
NC		 2544 PERL_ARGS_ASSERT_GV_CHECK;
2545
9e5cda6b 2546 if (!SvOOK(stash))
8990e307 2547 return;
90754377 2548
9e5cda6b 2549 assert(HvARRAY(stash));
90754377 2550
a0d0e21e 2551 for (i = 0; i <= (I32) HvMAX(stash); i++) {
e1ec3a88 2552 const HE *entry;
90754377 2553 /* mark stash is being scanned, to avoid recursing */
339441ef 2554 HvAUX(stash)->xhv_aux_flags |= HvAUXf_SCAN_STASH;
dc437b57 2555 for (entry = HvARRAY(stash)[i]; entry; entry = HeNEXT(entry)) {
eb578fdb 2556 GV *gv;
b7787f18 2557 HV *hv;
e7acdfe9
DM		 2558 STRLEN keylen = HeKLEN(entry);
2559 const char * const key = HeKEY(entry);
2560
2561 if (keylen >= 2 && key[keylen-2] == ':' && key[keylen-1] == ':' &&
159b6efe 2562 (gv = MUTABLE_GV(HeVAL(entry))) && isGV(gv) && (hv = GvHV(gv)))
a0d0e21e 2563 {
90754377
DM		 2564 if (hv != PL_defstash && hv != stash
2565 && !(SvOOK(hv)
2566 && (HvAUX(hv)->xhv_aux_flags & HvAUXf_SCAN_STASH))
2567 )
a0d0e21e
LW		 2568 gv_check(hv); /* nested package */
2569 }
7a207065
KW		 2570 else if ( HeKLEN(entry) != 0
2571 && *HeKEY(entry) != '_'
2572 && isIDFIRST_lazy_if_safe(HeKEY(entry),
2573 HeKEY(entry) + HeKLEN(entry),
2574 HeUTF8(entry)) )
2575 {
e1ec3a88 2576 const char *file;
159b6efe 2577 gv = MUTABLE_GV(HeVAL(entry));
55d729e4 2578 if (SvTYPE(gv) != SVt_PVGV || GvMULTI(gv))
463ee0b2 2579 continue;
1d7c1841 2580 file = GvFILE(gv);
1d7c1841 2581 CopLINE_set(PL_curcop, GvLINE(gv));
1dc74fdb
FC		 2582#ifdef USE_ITHREADS
2583 CopFILE(PL_curcop) = (char *)file; /* set for warning */
2584#else
2585 CopFILEGV(PL_curcop)
2586 = gv_fetchfile_flags(file, HEK_LEN(GvFILE_HEK(gv)), 0);
2587#endif
9014280d 2588 Perl_warner(aTHX_ packWARN(WARN_ONCE),
147e3846 2589 "Name \"%" HEKf "::%" HEKf
d0c0e7dd
FC		 2590 "\" used only once: possible typo",
2591 HEKfARG(HvNAME_HEK(stash)),
2592 HEKfARG(GvNAME_HEK(gv)));
463ee0b2 2593 }
79072805 2594 }
339441ef 2595 HvAUX(stash)->xhv_aux_flags &= ~HvAUXf_SCAN_STASH;
79072805
LW		 2596 }
2597}
2598
2599GV *
9cc50d5b 2600Perl_newGVgen_flags(pTHX_ const char *pack, U32 flags)
79072805 2601{
9cc50d5b 2602 PERL_ARGS_ASSERT_NEWGVGEN_FLAGS;
b17a0679 2603 assert(!(flags & ~SVf_UTF8));
7918f24d 2604
147e3846 2605 return gv_fetchpv(Perl_form(aTHX_ "%" UTF8f "::_GEN_%ld",
b17a0679 2606 UTF8fARG(flags, strlen(pack), pack),
9cc50d5b
BF		 2607 (long)PL_gensym++),
2608 GV_ADD, SVt_PVGV);
79072805
LW		 2609}
2610
2611/* hopefully this is only called on local symbol table entries */
2612
2613GP*
864dbfa3 2614Perl_gp_ref(pTHX_ GP *gp)
79072805 2615{
1d7c1841 2616 if (!gp)
d4c19fe8 2617 return NULL;
79072805 2618 gp->gp_refcnt++;
44a8e56a 2619 if (gp->gp_cv) {
2620 if (gp->gp_cvgen) {
e1a479c5
BB		 2621 /* If the GP they asked for a reference to contains
2622 a method cache entry, clear it first, so that we
2623 don't infect them with our cached entry */
e7881358 2624 SvREFCNT_dec_NN(gp->gp_cv);
601f1833 2625 gp->gp_cv = NULL;
44a8e56a 2626 gp->gp_cvgen = 0;
2627 }
44a8e56a 2628 }
79072805 2629 return gp;
79072805
LW		 2630}
2631
2632void
864dbfa3 2633Perl_gp_free(pTHX_ GV *gv)
79072805 2634{
79072805 2635 GP* gp;
b0d55c99 2636 int attempts = 100;
79072805 2637
f7877b28 2638 if (!gv || !isGV_with_GP(gv) || !(gp = GvGP(gv)))
79072805 2639 return;
f248d071 2640 if (gp->gp_refcnt == 0) {
9b387841
NC		 2641 Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL),
2642 "Attempt to free unreferenced glob pointers"
2643 pTHX__FORMAT pTHX__VALUE);
79072805
LW		 2644 return;
2645 }
4571f4a7 2646 if (gp->gp_refcnt > 1) {
bc81b34d 2647 borrowed:
748a9306
LW		 2648 if (gp->gp_egv == gv)
2649 gp->gp_egv = 0;
4571f4a7 2650 gp->gp_refcnt--;
c43ae56f 2651 GvGP_set(gv, NULL);
79072805 2652 return;
748a9306 2653 }
79072805 2654
b0d55c99
FC		 2655 while (1) {
2656 /* Copy and null out all the glob slots, so destructors do not see
2657 freed SVs. */
2658 HEK * const file_hek = gp->gp_file_hek;
2659 SV * const sv = gp->gp_sv;
2660 AV * const av = gp->gp_av;
2661 HV * const hv = gp->gp_hv;
2662 IO * const io = gp->gp_io;
2663 CV * const cv = gp->gp_cv;
2664 CV * const form = gp->gp_form;
2665
2666 gp->gp_file_hek = NULL;
2667 gp->gp_sv = NULL;
2668 gp->gp_av = NULL;
2669 gp->gp_hv = NULL;
2670 gp->gp_io = NULL;
2671 gp->gp_cv = NULL;
2672 gp->gp_form = NULL;
2673
2674 if (file_hek)
2675 unshare_hek(file_hek);
2676
2677 SvREFCNT_dec(sv);
2678 SvREFCNT_dec(av);
2679 /* FIXME - another reference loop GV -> symtab -> GV ?
2680 Somehow gp->gp_hv can end up pointing at freed garbage. */
2681 if (hv && SvTYPE(hv) == SVt_PVHV) {
c2242065 2682 const HEK *hvname_hek = HvNAME_HEK(hv);
923ed580
FC		 2683 if (PL_stashcache && hvname_hek) {
2684 DEBUG_o(Perl_deb(aTHX_
147e3846 2685 "gp_free clearing PL_stashcache for '%" HEKf "'\n",
923ed580 2686 HEKfARG(hvname_hek)));
0ca9877d 2687 (void)hv_deletehek(PL_stashcache, hvname_hek, G_DISCARD);
923ed580 2688 }
b0d55c99
FC		 2689 SvREFCNT_dec(hv);
2690 }
96d7c888
FC		 2691 if (io && SvREFCNT(io) == 1 && IoIFP(io)
2692 && (IoTYPE(io) == IoTYPE_WRONLY ||
2693 IoTYPE(io) == IoTYPE_RDWR ||
2694 IoTYPE(io) == IoTYPE_APPEND)
2695 && ckWARN_d(WARN_IO)
2696 && IoIFP(io) != PerlIO_stdin()
2697 && IoIFP(io) != PerlIO_stdout()
2698 && IoIFP(io) != PerlIO_stderr()
2699 && !(IoFLAGS(io) & IOf_FAKE_DIRP))
2700 io_close(io, gv, FALSE, TRUE);
b0d55c99
FC		 2701 SvREFCNT_dec(io);
2702 SvREFCNT_dec(cv);
2703 SvREFCNT_dec(form);
2704
bc81b34d
FC		 2705 /* Possibly reallocated by a destructor */
2706 gp = GvGP(gv);
2707
b0d55c99
FC		 2708 if (!gp->gp_file_hek
2709 && !gp->gp_sv
2710 && !gp->gp_av
2711 && !gp->gp_hv
2712 && !gp->gp_io
2713 && !gp->gp_cv
2714 && !gp->gp_form) break;
2715
2716 if (--attempts == 0) {
2717 Perl_die(aTHX_
2718 "panic: gp_free failed to free glob pointer - "
2719 "something is repeatedly re-creating entries"
2720 );
2721 }
13207a71 2722 }
748a9306 2723
bc81b34d
FC		 2724 /* Possibly incremented by a destructor doing glob assignment */
2725 if (gp->gp_refcnt > 1) goto borrowed;
79072805 2726 Safefree(gp);
c43ae56f 2727 GvGP_set(gv, NULL);
79072805
LW		 2728}
2729
d460ef45
NIS		 2730int
2731Perl_magic_freeovrld(pTHX_ SV *sv, MAGIC *mg)
2732{
53c1dcc0
AL		 2733 AMT * const amtp = (AMT*)mg->mg_ptr;
2734 PERL_UNUSED_ARG(sv);
dd374669 2735
7918f24d
NC		 2736 PERL_ARGS_ASSERT_MAGIC_FREEOVRLD;
2737
d460ef45
NIS		 2738 if (amtp && AMT_AMAGIC(amtp)) {
2739 int i;
2740 for (i = 1; i < NofAMmeth; i++) {
53c1dcc0 2741 CV * const cv = amtp->table[i];
b37c2d43 2742 if (cv) {
e7881358 2743 SvREFCNT_dec_NN(MUTABLE_SV(cv));
601f1833 2744 amtp->table[i] = NULL;
d460ef45
NIS		 2745 }
2746 }
2747 }
2748 return 0;
2749}
2750
a0d0e21e 2751/* Updates and caches the CV's */
c3a9a790
RGS		 2752/* Returns:
2753 * 1 on success and there is some overload
2754 * 0 if there is no overload
2755 * -1 if some error occurred and it couldn't croak
2756 */
a0d0e21e 2757
c3a9a790 2758int
242f8760 2759Perl_Gv_AMupdate(pTHX_ HV *stash, bool destructing)
a0d0e21e 2760{
ad64d0ec 2761 MAGIC* const mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table);
a6006777 2762 AMT amt;
9b439311 2763 const struct mro_meta* stash_meta = HvMROMETA(stash);
e1a479c5 2764 U32 newgen;
a0d0e21e 2765
7918f24d
NC		 2766 PERL_ARGS_ASSERT_GV_AMUPDATE;
2767
9b439311 2768 newgen = PL_sub_generation + stash_meta->pkg_gen + stash_meta->cache_gen;
14899595
NC		 2769 if (mg) {
2770 const AMT * const amtp = (AMT*)mg->mg_ptr;
66978156 2771 if (amtp->was_ok_sub == newgen) {
8c34e50d 2772 return AMT_AMAGIC(amtp) ? 1 : 0;
14899595 2773 }
ad64d0ec 2774 sv_unmagic(MUTABLE_SV(stash), PERL_MAGIC_overload_table);
14899595 2775 }
a0d0e21e 2776
bfcb3514 2777 DEBUG_o( Perl_deb(aTHX_ "Recalcing overload magic in package %s\n",HvNAME_get(stash)) );
a0d0e21e 2778
d460ef45 2779 Zero(&amt,1,AMT);
e1a479c5 2780 amt.was_ok_sub = newgen;
a6006777 2781 amt.fallback = AMGfallNO;
2782 amt.flags = 0;
2783
a6006777 2784 {
8c34e50d
FC		 2785 int filled = 0;
2786 int i;
3d147ac2
DM		 2787 bool deref_seen = 0;
2788
a6006777 2789
3866ea3b 2790 /* Work with "fallback" key, which we assume to be first in PL_AMG_names */
a6006777 2791
89ffc314 2792 /* Try to find via inheritance. */
e6919483 2793 GV *gv = gv_fetchmeth_pvn(stash, PL_AMG_names[0], 2, -1, 0);
3866ea3b 2794 SV * const sv = gv ? GvSV(gv) : NULL;
53c1dcc0 2795 CV* cv;
89ffc314
IZ		 2796
2797 if (!gv)
3866ea3b
FC		 2798 {
2799 if (!gv_fetchmeth_pvn(stash, "((", 2, -1, 0))
8c34e50d 2800 goto no_table;
3866ea3b
FC		 2801 }
2802#ifdef PERL_DONT_CREATE_GVSV
2803 else if (!sv) {
6f207bd3 2804 NOOP; /* Equivalent to !SvTRUE and !SvOK */
3866ea3b
FC		 2805 }
2806#endif
79c9643d
JL		 2807 else if (SvTRUE(sv))
2808 /* don't need to set overloading here because fallback => 1
2809 * is the default setting for classes without overloading */
89ffc314 2810 amt.fallback=AMGfallYES;
79c9643d
JL		 2811 else if (SvOK(sv)) {
2812 amt.fallback=AMGfallNEVER;
386a5489 2813 filled = 1;
386a5489 2814 }
79c9643d 2815 else {
386a5489 2816 filled = 1;
386a5489 2817 }
a6006777 2818
3d147ac2 2819 assert(SvOOK(stash));
3d147ac2 2820 /* initially assume the worst */
339441ef 2821 HvAUX(stash)->xhv_aux_flags &= ~HvAUXf_NO_DEREF;
3d147ac2 2822
8c34e50d 2823 for (i = 1; i < NofAMmeth; i++) {
6136c704 2824 const char * const cooky = PL_AMG_names[i];
32251b26 2825 /* Human-readable form, for debugging: */
8c34e50d 2826 const char * const cp = AMG_id2name(i);
d279ab82 2827 const STRLEN l = PL_AMG_namelens[i];
89ffc314 2828
a0288114 2829 DEBUG_o( Perl_deb(aTHX_ "Checking overloading of \"%s\" in package \"%.256s\"\n",
bfcb3514 2830 cp, HvNAME_get(stash)) );
611c1e95
IZ		 2831 /* don't fill the cache while looking up!
2832 Creation of inheritance stubs in intermediate packages may
2833 conflict with the logic of runtime method substitution.
2834 Indeed, for inheritance A -> B -> C, if C overloads "+0",
2835 then we could have created stubs for "(+0" in A and C too.
2836 But if B overloads "bool", we may want to use it for
2837 numifying instead of C's "+0". */
8c34e50d 2838 gv = Perl_gv_fetchmeth_pvn(aTHX_ stash, cooky, l, -1, 0);
46fc3d4c 2839 cv = 0;
c3ad4e54 2840 if (gv && (cv = GvCV(gv)) && CvHASGV(cv)) {
79656330 2841 const HEK * const gvhek = CvGvNAME_HEK(cv);
c3ad4e54
FC		 2842 const HEK * const stashek =
2843 HvNAME_HEK(CvNAMED(cv) ? CvSTASH(cv) : GvSTASH(CvGV(cv)));
b59bf0b2
KW		 2844 if (memEQs(HEK_KEY(gvhek), HEK_LEN(gvhek), "nil")
2845 && stashek
2846 && memEQs(HEK_KEY(stashek), HEK_LEN(stashek), "overload")) {
611c1e95
IZ		 2847 /* This is a hack to support autoloading..., while
2848 knowing *which* methods were declared as overloaded. */
44a8e56a 2849 /* GvSV contains the name of the method. */
6136c704 2850 GV *ngv = NULL;
c69033f2 2851 SV *gvsv = GvSV(gv);
a0288114 2852
147e3846 2853 DEBUG_o( Perl_deb(aTHX_ "Resolving method \"%" SVf256\
a0288114 2854 "\" for overloaded \"%s\" in package \"%.256s\"\n",
f0e9f182 2855 (void*)GvSV(gv), cp, HvNAME(stash)) );
c69033f2 2856 if (!gvsv || !SvPOK(gvsv)
7f415459 2857 || !(ngv = gv_fetchmethod_sv_flags(stash, gvsv, 0)))
dc848c6f 2858 {
a0288114 2859 /* Can be an import stub (created by "can"). */
242f8760 2860 if (destructing) {
c3a9a790 2861 return -1;
242f8760
RGS		 2862 }
2863 else {
d66cca07
BF		 2864 const SV * const name = (gvsv && SvPOK(gvsv))
2865 ? gvsv
2866 : newSVpvs_flags("???", SVs_TEMP);
dcbac5bb 2867 /* diag_listed_as: Can't resolve method "%s" overloading "%s" in package "%s" */
147e3846 2868 Perl_croak(aTHX_ "%s method \"%" SVf256
d66cca07 2869 "\" overloading \"%s\" "\
147e3846 2870 "in package \"%" HEKf256 "\"",
242f8760
RGS		 2871 (GvCVGEN(gv) ? "Stub found while resolving"
2872 : "Can't resolve"),
d66cca07 2873 SVfARG(name), cp,
d0c0e7dd 2874 HEKfARG(
d66cca07 2875 HvNAME_HEK(stash)
d0c0e7dd 2876 ));
242f8760 2877 }
44a8e56a 2878 }
dc848c6f 2879 cv = GvCV(gv = ngv);
44a8e56a 2880 }
b464bac0 2881 DEBUG_o( Perl_deb(aTHX_ "Overloading \"%s\" in package \"%.256s\" via \"%.256s::%.256s\"\n",
bfcb3514 2882 cp, HvNAME_get(stash), HvNAME_get(GvSTASH(CvGV(cv))),
44a8e56a 2883 GvNAME(CvGV(cv))) );
2884 filled = 1;
611c1e95 2885 } else if (gv) { /* Autoloaded... */
ea726b52 2886 cv = MUTABLE_CV(gv);
611c1e95 2887 filled = 1;
44a8e56a 2888 }
ea726b52 2889 amt.table[i]=MUTABLE_CV(SvREFCNT_inc_simple(cv));
3d147ac2
DM		 2890
2891 if (gv) {
2892 switch (i) {
2893 case to_sv_amg:
2894 case to_av_amg:
2895 case to_hv_amg:
2896 case to_gv_amg:
2897 case to_cv_amg:
2898 case nomethod_amg:
2899 deref_seen = 1;
2900 break;
2901 }
2902 }
a0d0e21e 2903 }
3d147ac2 2904 if (!deref_seen)
45479970
DM		 2905 /* none of @{} etc overloaded; we can do $obj->[N] quicker.
2906 * NB - aux var invalid here, HvARRAY() could have been
2907 * reallocated since it was assigned to */
2908 HvAUX(stash)->xhv_aux_flags |= HvAUXf_NO_DEREF;
3d147ac2 2909
a0d0e21e 2910 if (filled) {
a6006777 2911 AMT_AMAGIC_on(&amt);
ad64d0ec 2912 sv_magic(MUTABLE_SV(stash), 0, PERL_MAGIC_overload_table,
14befaf4 2913 (char*)&amt, sizeof(AMT));
8c34e50d 2914 return TRUE;
a0d0e21e
LW		 2915 }
2916 }
a6006777 2917 /* Here we have no table: */
8c34e50d 2918 no_table:
a6006777 2919 AMT_AMAGIC_off(&amt);
ad64d0ec 2920 sv_magic(MUTABLE_SV(stash), 0, PERL_MAGIC_overload_table,
14befaf4 2921 (char*)&amt, sizeof(AMTS));
c3a9a790 2922 return 0;
a0d0e21e
LW		 2923}
2924
32251b26
IZ		 2925
2926CV*
2927Perl_gv_handler(pTHX_ HV *stash, I32 id)
2928{
3f8f4626 2929 MAGIC *mg;
32251b26 2930 AMT *amtp;
e1a479c5 2931 U32 newgen;
9b439311 2932 struct mro_meta* stash_meta;
32251b26 2933
bfcb3514 2934 if (!stash || !HvNAME_get(stash))
601f1833 2935 return NULL;
e1a479c5 2936
9b439311
BB		 2937 stash_meta = HvMROMETA(stash);
2938 newgen = PL_sub_generation + stash_meta->pkg_gen + stash_meta->cache_gen;
e1a479c5 2939
ad64d0ec 2940 mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table);
32251b26
IZ		 2941 if (!mg) {
2942 do_update:
8c34e50d 2943 if (Gv_AMupdate(stash, 0) == -1)
242f8760 2944 return NULL;
ad64d0ec 2945 mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table);
32251b26 2946 }
a9fd4e40 2947 assert(mg);
32251b26 2948 amtp = (AMT*)mg->mg_ptr;
66978156 2949 if ( amtp->was_ok_sub != newgen )
32251b26 2950 goto do_update;
3ad83ce7 2951 if (AMT_AMAGIC(amtp)) {
b7787f18 2952 CV * const ret = amtp->table[id];
3ad83ce7
AMS		 2953 if (ret && isGV(ret)) { /* Autoloading stab */
2954 /* Passing it through may have resulted in a warning
2955 "Inherited AUTOLOAD for a non-method deprecated", since
2956 our caller is going through a function call, not a method call.
2957 So return the CV for AUTOLOAD, setting $AUTOLOAD. */
890ce7af 2958 GV * const gv = gv_fetchmethod(stash, PL_AMG_names[id]);
3ad83ce7
AMS		 2959
2960 if (gv && GvCV(gv))
2961 return GvCV(gv);
2962 }
2963 return ret;
2964 }
a0288114 2965
601f1833 2966 return NULL;
32251b26
IZ		 2967}
2968
2969
6f1401dc
DM		 2970/* Implement tryAMAGICun_MG macro.
2971 Do get magic, then see if the stack arg is overloaded and if so call it.
2972 Flags:
6f1401dc
DM		 2973 AMGf_numeric apply sv_2num to the stack arg.
2974*/
2975
2976bool
2977Perl_try_amagic_un(pTHX_ int method, int flags) {
6f1401dc
DM		 2978 dSP;
2979 SV* tmpsv;
2980 SV* const arg = TOPs;
2981
2982 SvGETMAGIC(arg);
2983
9f8bf298 2984 if (SvAMAGIC(arg) && (tmpsv = amagic_call(arg, &PL_sv_undef, method,
636ac8fc
FC		 2985 AMGf_noright | AMGf_unary
2986 | (flags & AMGf_numarg))))
2987 {
13874762
DM		 2988 /* where the op is of the form:
2989 * $lex = $x op $y (where the assign is optimised away)
2990 * then assign the returned value to targ and return that;
2991 * otherwise return the value directly
2992 */
2993 if ( (PL_opargs[PL_op->op_type] & OA_TARGLEX)
2994 && (PL_op->op_private & OPpTARGET_MY))
2995 {
2996 dTARGET;
2997 sv_setsv(TARG, tmpsv);
2998 SETTARG;
2999 }
3000 else
3001 SETs(tmpsv);
3002
6f1401dc
DM		 3003 PUTBACK;
3004 return TRUE;
3005 }
3006
3007 if ((flags & AMGf_numeric) && SvROK(arg))
3008 *sp = sv_2num(arg);
3009 return FALSE;
3010}
3011
3012
3013/* Implement tryAMAGICbin_MG macro.
3014 Do get magic, then see if the two stack args are overloaded and if so
3015 call it.
3016 Flags:
6f1401dc
DM		 3017 AMGf_assign op may be called as mutator (eg +=)
3018 AMGf_numeric apply sv_2num to the stack arg.
3019*/
3020
3021bool
3022Perl_try_amagic_bin(pTHX_ int method, int flags) {
6f1401dc
DM		 3023 dSP;
3024 SV* const left = TOPm1s;
3025 SV* const right = TOPs;
3026
3027 SvGETMAGIC(left);
3028 if (left != right)
3029 SvGETMAGIC(right);
3030
3031 if (SvAMAGIC(left) || SvAMAGIC(right)) {
72876cce
DM		 3032 SV * tmpsv;
3033 /* STACKED implies mutator variant, e.g. $x += 1 */
3034 bool mutator = (flags & AMGf_assign) && (PL_op->op_flags & OPf_STACKED);
3035
3036 tmpsv = amagic_call(left, right, method,
3037 (mutator ? AMGf_assign: 0)
636ac8fc 3038 | (flags & AMGf_numarg));
6f1401dc 3039 if (tmpsv) {
13874762
DM		 3040 (void)POPs;
3041 /* where the op is one of the two forms:
3042 * $x op= $y
3043 * $lex = $x op $y (where the assign is optimised away)
3044 * then assign the returned value to targ and return that;
3045 * otherwise return the value directly
3046 */
3047 if ( mutator
3048 || ( (PL_opargs[PL_op->op_type] & OA_TARGLEX)
3049 && (PL_op->op_private & OPpTARGET_MY)))
3050 {
3051 dTARG;
3052 TARG = mutator ? *SP : PAD_SV(PL_op->op_targ);
3053 sv_setsv(TARG, tmpsv);
3054 SETTARG;
3055 }
3056 else
3057 SETs(tmpsv);
3058
6f1401dc
DM		 3059 PUTBACK;
3060 return TRUE;
3061 }
3062 }
13874762 3063
75ea7a12
FC		 3064 if(left==right && SvGMAGICAL(left)) {
3065 SV * const left = sv_newmortal();
3066 *(sp-1) = left;
3067 /* Print the uninitialized warning now, so it includes the vari-
3068 able name. */
3069 if (!SvOK(right)) {
3070 if (ckWARN(WARN_UNINITIALIZED)) report_uninit(right);
3071 sv_setsv_flags(left, &PL_sv_no, 0);
3072 }
3073 else sv_setsv_flags(left, right, 0);
3074 SvGETMAGIC(right);
3075 }
6f1401dc 3076 if (flags & AMGf_numeric) {
75ea7a12
FC		 3077 if (SvROK(TOPm1s))
3078 *(sp-1) = sv_2num(TOPm1s);
6f1401dc
DM		 3079 if (SvROK(right))
3080 *sp = sv_2num(right);
3081 }
3082 return FALSE;
3083}
3084
25a9ffce
NC		 3085SV *
3086Perl_amagic_deref_call(pTHX_ SV *ref, int method) {
3087 SV *tmpsv = NULL;
3d147ac2 3088 HV *stash;
25a9ffce
NC		 3089
3090 PERL_ARGS_ASSERT_AMAGIC_DEREF_CALL;
3091
3d147ac2
DM		 3092 if (!SvAMAGIC(ref))
3093 return ref;
3094 /* return quickly if none of the deref ops are overloaded */
3095 stash = SvSTASH(SvRV(ref));
3096 assert(SvOOK(stash));
3097 if (HvAUX(stash)->xhv_aux_flags & HvAUXf_NO_DEREF)
3098 return ref;
3099
3100 while ((tmpsv = amagic_call(ref, &PL_sv_undef, method,
25a9ffce
NC		 3101 AMGf_noright | AMGf_unary))) {
3102 if (!SvROK(tmpsv))
3103 Perl_croak(aTHX_ "Overloaded dereference did not return a reference");
3104 if (tmpsv == ref || SvRV(tmpsv) == SvRV(ref)) {
3105 /* Bail out if it returns us the same reference. */
3106 return tmpsv;
3107 }
3108 ref = tmpsv;
3d147ac2
DM		 3109 if (!SvAMAGIC(ref))
3110 break;
25a9ffce
NC		 3111 }
3112 return tmpsv ? tmpsv : ref;
3113}
6f1401dc 3114
8d569291
FC		 3115bool
3116Perl_amagic_is_enabled(pTHX_ int method)
3117{
3118 SV *lex_mask = cop_hints_fetch_pvs(PL_curcop, "overloading", 0);
3119
3120 assert(PL_curcop->cop_hints & HINT_NO_AMAGIC);
3121
3122 if ( !lex_mask || !SvOK(lex_mask) )
3123 /* overloading lexically disabled */
3124 return FALSE;
3125 else if ( lex_mask && SvPOK(lex_mask) ) {
3126 /* we have an entry in the hints hash, check if method has been
3127 * masked by overloading.pm */
3128 STRLEN len;
3129 const int offset = method / 8;
3130 const int bit = method % 8;
3131 char *pv = SvPV(lex_mask, len);
3132
3133 /* Bit set, so this overloading operator is disabled */
3134 if ( (STRLEN)offset < len && pv[offset] & ( 1 << bit ) )
3135 return FALSE;
3136 }
3137 return TRUE;
3138}
3139
a0d0e21e 3140SV*
864dbfa3 3141Perl_amagic_call(pTHX_ SV *left, SV *right, int method, int flags)
a0d0e21e 3142{
27da23d5 3143 dVAR;
b267980d 3144 MAGIC *mg;
9c5ffd7c 3145 CV *cv=NULL;
a0d0e21e 3146 CV **cvp=NULL, **ocvp=NULL;
9c5ffd7c 3147 AMT *amtp=NULL, *oamtp=NULL;
b464bac0
AL		 3148 int off = 0, off1, lr = 0, notfound = 0;
3149 int postpr = 0, force_cpy = 0;
3150 int assign = AMGf_assign & flags;
3151 const int assignshift = assign ? 1 : 0;
bf5522a1 3152 int use_default_op = 0;
67288365 3153 int force_scalar = 0;
497b47a8
JH		 3154#ifdef DEBUGGING
3155 int fl=0;
497b47a8 3156#endif
25716404 3157 HV* stash=NULL;
7918f24d
NC		 3158
3159 PERL_ARGS_ASSERT_AMAGIC_CALL;
3160
e46c382e 3161 if ( PL_curcop->cop_hints & HINT_NO_AMAGIC ) {
8d569291 3162 if (!amagic_is_enabled(method)) return NULL;
e46c382e
YK		 3163 }
3164
a0d0e21e 3165 if (!(AMGf_noleft & flags) && SvAMAGIC(left)
0a2c84ab 3166 && (stash = SvSTASH(SvRV(left))) && Gv_AMG(stash)
ad64d0ec 3167 && (mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table))
b267980d 3168 && (ocvp = cvp = (AMT_AMAGIC((AMT*)mg->mg_ptr)
a6006777 3169 ? (oamtp = amtp = (AMT*)mg->mg_ptr)->table
d4c19fe8 3170 : NULL))
b267980d 3171 && ((cv = cvp[off=method+assignshift])
748a9306
LW		 3172 || (assign && amtp->fallback > AMGfallNEVER && /* fallback to
3173 * usual method */
497b47a8
JH		 3174 (
3175#ifdef DEBUGGING
3176 fl = 1,
a0288114 3177#endif
497b47a8 3178 cv = cvp[off=method])))) {
a0d0e21e
LW		 3179 lr = -1; /* Call method for left argument */
3180 } else {
3181 if (cvp && amtp->fallback > AMGfallNEVER && flags & AMGf_unary) {
3182 int logic;
3183
3184 /* look for substituted methods */
ee239bfe 3185 /* In all the covered cases we should be called with assign==0. */
a0d0e21e
LW		 3186 switch (method) {
3187 case inc_amg:
ee239bfe
IZ		 3188 force_cpy = 1;
3189 if ((cv = cvp[off=add_ass_amg])
3190 || ((cv = cvp[off = add_amg]) && (force_cpy = 0, postpr = 1))) {
3280af22 3191 right = &PL_sv_yes; lr = -1; assign = 1;
a0d0e21e
LW		 3192 }
3193 break;
3194 case dec_amg:
ee239bfe
IZ		 3195 force_cpy = 1;
3196 if ((cv = cvp[off = subtr_ass_amg])
3197 || ((cv = cvp[off = subtr_amg]) && (force_cpy = 0, postpr=1))) {
3280af22 3198 right = &PL_sv_yes; lr = -1; assign = 1;
a0d0e21e
LW		 3199 }
3200 break;
3201 case bool__amg:
3202 (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=string_amg]));
3203 break;
3204 case numer_amg:
3205 (void)((cv = cvp[off=string_amg]) || (cv = cvp[off=bool__amg]));
3206 break;
3207 case string_amg:
3208 (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=bool__amg]));
3209 break;
b7787f18
AL		 3210 case not_amg:
3211 (void)((cv = cvp[off=bool__amg])
3212 || (cv = cvp[off=numer_amg])
3213 || (cv = cvp[off=string_amg]));
2ab54efd
MB		 3214 if (cv)
3215 postpr = 1;
b7787f18 3216 break;
748a9306
LW		 3217 case copy_amg:
3218 {
76e3520e
GS		 3219 /*
3220 * SV* ref causes confusion with the interpreter variable of
3221 * the same name
3222 */
890ce7af 3223 SV* const tmpRef=SvRV(left);
76e3520e 3224 if (!SvROK(tmpRef) && SvTYPE(tmpRef) <= SVt_PVMG) {
fc36a67e 3225 /*
3226 * Just to be extra cautious. Maybe in some
3227 * additional cases sv_setsv is safe, too.
3228 */
890ce7af 3229 SV* const newref = newSVsv(tmpRef);
748a9306 3230 SvOBJECT_on(newref);
a1cd65be
FC		 3231 /* No need to do SvAMAGIC_on here, as SvAMAGIC macros
3232 delegate to the stash. */
85fbaab2 3233 SvSTASH_set(newref, MUTABLE_HV(SvREFCNT_inc(SvSTASH(tmpRef))));
748a9306
LW		 3234 return newref;
3235 }
3236 }
3237 break;
a0d0e21e 3238 case abs_amg:
b267980d 3239 if ((cvp[off1=lt_amg] || cvp[off1=ncmp_amg])
a0d0e21e 3240 && ((cv = cvp[off=neg_amg]) || (cv = cvp[off=subtr_amg]))) {
725c44f9 3241 SV* const nullsv=&PL_sv_zero;
a0d0e21e 3242 if (off1==lt_amg) {
890ce7af 3243 SV* const lessp = amagic_call(left,nullsv,
a0d0e21e 3244 lt_amg,AMGf_noright);
f4c975aa 3245 logic = SvTRUE_NN(lessp);
a0d0e21e 3246 } else {
890ce7af 3247 SV* const lessp = amagic_call(left,nullsv,
a0d0e21e
LW		 3248 ncmp_amg,AMGf_noright);
3249 logic = (SvNV(lessp) < 0);
3250 }
3251 if (logic) {
3252 if (off==subtr_amg) {
3253 right = left;
748a9306 3254 left = nullsv;
a0d0e21e
LW		 3255 lr = 1;
3256 }
3257 } else {
3258 return left;
3259 }
3260 }
3261 break;
3262 case neg_amg:
155aba94 3263 if ((cv = cvp[off=subtr_amg])) {
a0d0e21e 3264 right = left;
725c44f9 3265 left = &PL_sv_zero;
a0d0e21e
LW		 3266 lr = 1;
3267 }
3268 break;
f216259d 3269 case int_amg:
f5284f61 3270 case iter_amg: /* XXXX Eventually should do to_gv. */
c4c7412c 3271 case ftest_amg: /* XXXX Eventually should do to_gv. */
d4b87e75 3272 case regexp_amg:
b267980d
NIS		 3273 /* FAIL safe */
3274 return NULL; /* Delegate operation to standard mechanisms. */
81d52ecd 3275
f5284f61
IZ		 3276 case to_sv_amg:
3277 case to_av_amg:
3278 case to_hv_amg:
3279 case to_gv_amg:
3280 case to_cv_amg:
3281 /* FAIL safe */
b267980d 3282 return left; /* Delegate operation to standard mechanisms. */
81d52ecd 3283
a0d0e21e
LW		 3284 default:
3285 goto not_found;
3286 }
3287 if (!cv) goto not_found;
3288 } else if (!(AMGf_noright & flags) && SvAMAGIC(right)
0a2c84ab 3289 && (stash = SvSTASH(SvRV(right))) && Gv_AMG(stash)
ad64d0ec 3290 && (mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table))
b267980d 3291 && (cvp = (AMT_AMAGIC((AMT*)mg->mg_ptr)
a6006777 3292 ? (amtp = (AMT*)mg->mg_ptr)->table
d4c19fe8 3293 : NULL))
69815d08
RS		 3294 && (cv = cvp[off=method])) { /* Method for right
3295 * argument found */
3296 lr=1;
bf5522a1
MB		 3297 } else if (((cvp && amtp->fallback > AMGfallNEVER)
3298 || (ocvp && oamtp->fallback > AMGfallNEVER))
a0d0e21e
LW		 3299 && !(flags & AMGf_unary)) {
3300 /* We look for substitution for
3301 * comparison operations and
fc36a67e 3302 * concatenation */
a0d0e21e
LW		 3303 if (method==concat_amg || method==concat_ass_amg
3304 || method==repeat_amg || method==repeat_ass_amg) {
3305 return NULL; /* Delegate operation to string conversion */
3306 }
3307 off = -1;
3308 switch (method) {
3309 case lt_amg:
3310 case le_amg:
3311 case gt_amg:
3312 case ge_amg:
3313 case eq_amg:
3314 case ne_amg:
2ab54efd
MB		 3315 off = ncmp_amg;
3316 break;
a0d0e21e
LW		 3317 case slt_amg:
3318 case sle_amg:
3319 case sgt_amg:
3320 case sge_amg:
3321 case seq_amg:
3322 case sne_amg:
2ab54efd
MB		 3323 off = scmp_amg;
3324 break;
a0d0e21e 3325 }
bf5522a1
MB		 3326 if (off != -1) {
3327 if (ocvp && (oamtp->fallback > AMGfallNEVER)) {
3328 cv = ocvp[off];
3329 lr = -1;
3330 }
3331 if (!cv && (cvp && amtp->fallback > AMGfallNEVER)) {
3332 cv = cvp[off];
3333 lr = 1;
3334 }
3335 }
3336 if (cv)
2ab54efd
MB		 3337 postpr = 1;
3338 else
3339 goto not_found;
a0d0e21e 3340 } else {
a6006777 3341 not_found: /* No method found, either report or croak */
b267980d
NIS		 3342 switch (method) {
3343 case to_sv_amg:
3344 case to_av_amg:
3345 case to_hv_amg:
3346 case to_gv_amg:
3347 case to_cv_amg:
3348 /* FAIL safe */
3349 return left; /* Delegate operation to standard mechanisms. */
b267980d 3350 }
a0d0e21e
LW		 3351 if (ocvp && (cv=ocvp[nomethod_amg])) { /* Call report method */
3352 notfound = 1; lr = -1;
3353 } else if (cvp && (cv=cvp[nomethod_amg])) {
3354 notfound = 1; lr = 1;
bf5522a1
MB		 3355 } else if ((use_default_op =
3356 (!ocvp || oamtp->fallback >= AMGfallYES)
3357 && (!cvp || amtp->fallback >= AMGfallYES))
3358 && !DEBUG_o_TEST) {
4cc0ca18
NC		 3359 /* Skip generating the "no method found" message. */
3360 return NULL;
a0d0e21e 3361 } else {
46fc3d4c 3362 SV *msg;
774d564b 3363 if (off==-1) off=method;
b267980d 3364 msg = sv_2mortal(Perl_newSVpvf(aTHX_
147e3846 3365 "Operation \"%s\": no method found,%sargument %s%" SVf "%s%" SVf,
d66cca07
BF		 3366 AMG_id2name(method + assignshift),
3367 (flags & AMGf_unary ? " " : "\n\tleft "),
3368 SvAMAGIC(left)?
3369 "in overloaded package ":
3370 "has no overloaded magic",
3371 SvAMAGIC(left)?
3372 SVfARG(sv_2mortal(newSVhek(HvNAME_HEK(SvSTASH(SvRV(left)))))):
3373 SVfARG(&PL_sv_no),
3374 SvAMAGIC(right)?
3375 ",\n\tright argument in overloaded package ":
3376 (flags & AMGf_unary
3377 ? ""
3378 : ",\n\tright argument has no overloaded magic"),
3379 SvAMAGIC(right)?
3380 SVfARG(sv_2mortal(newSVhek(HvNAME_HEK(SvSTASH(SvRV(right)))))):
3381 SVfARG(&PL_sv_no)));
bf5522a1 3382 if (use_default_op) {
147e3846 3383 DEBUG_o( Perl_deb(aTHX_ "%" SVf, SVfARG(msg)) );
a0d0e21e 3384 } else {
147e3846 3385 Perl_croak(aTHX_ "%" SVf, SVfARG(msg));
a0d0e21e
LW		 3386 }
3387 return NULL;
3388 }
ee239bfe 3389 force_cpy = force_cpy || assign;
a0d0e21e
LW		 3390 }
3391 }
67288365
JL		 3392
3393 switch (method) {
3394 /* in these cases, we're calling '+' or '-' as a fallback for a ++ or --
3395 * operation. we need this to return a value, so that it can be assigned
3396 * later on, in the postpr block (case inc_amg/dec_amg), even if the
3397 * increment or decrement was itself called in void context */
3398 case inc_amg:
3399 if (off == add_amg)
3400 force_scalar = 1;
3401 break;
3402 case dec_amg:
3403 if (off == subtr_amg)
3404 force_scalar = 1;
3405 break;
3406 /* in these cases, we're calling an assignment variant of an operator
3407 * (+= rather than +, for instance). regardless of whether it's a
3408 * fallback or not, it always has to return a value, which will be
3409 * assigned to the proper variable later */
3410 case add_amg:
3411 case subtr_amg:
3412 case mult_amg:
3413 case div_amg:
3414 case modulo_amg:
3415 case pow_amg:
3416 case lshift_amg:
3417 case rshift_amg:
3418 case repeat_amg:
3419 case concat_amg:
3420 case band_amg:
3421 case bor_amg:
3422 case bxor_amg:
6d06ecce
FC		 3423 case sband_amg:
3424 case sbor_amg:
3425 case sbxor_amg:
67288365
JL		 3426 if (assign)
3427 force_scalar = 1;
3428 break;
3429 /* the copy constructor always needs to return a value */
3430 case copy_amg:
3431 force_scalar = 1;
3432 break;
3433 /* because of the way these are implemented (they don't perform the
3434 * dereferencing themselves, they return a reference that perl then
3435 * dereferences later), they always have to be in scalar context */
3436 case to_sv_amg:
3437 case to_av_amg:
3438 case to_hv_amg:
3439 case to_gv_amg:
3440 case to_cv_amg:
3441 force_scalar = 1;
3442 break;
3443 /* these don't have an op of their own; they're triggered by their parent
3444 * op, so the context there isn't meaningful ('$a and foo()' in void
3445 * context still needs to pass scalar context on to $a's bool overload) */
3446 case bool__amg:
3447 case numer_amg:
3448 case string_amg:
3449 force_scalar = 1;
3450 break;
3451 }
3452
497b47a8 3453#ifdef DEBUGGING
a0d0e21e 3454 if (!notfound) {
497b47a8 3455 DEBUG_o(Perl_deb(aTHX_
147e3846 3456 "Overloaded operator \"%s\"%s%s%s:\n\tmethod%s found%s in package %" SVf "%s\n",
497b47a8
JH		 3457 AMG_id2name(off),
3458 method+assignshift==off? "" :
a0288114 3459 " (initially \"",
497b47a8
JH		 3460 method+assignshift==off? "" :
3461 AMG_id2name(method+assignshift),
a0288114 3462 method+assignshift==off? "" : "\")",
497b47a8
JH		 3463 flags & AMGf_unary? "" :
3464 lr==1 ? " for right argument": " for left argument",
3465 flags & AMGf_unary? " for argument" : "",
d66cca07 3466 stash ? SVfARG(sv_2mortal(newSVhek(HvNAME_HEK(stash)))) : SVfARG(newSVpvs_flags("null", SVs_TEMP)),
497b47a8 3467 fl? ",\n\tassignment variant used": "") );
ee239bfe 3468 }
497b47a8 3469#endif
748a9306
LW		 3470 /* Since we use shallow copy during assignment, we need
3471 * to dublicate the contents, probably calling user-supplied
3472 * version of copy operator
3473 */
ee239bfe
IZ		 3474 /* We need to copy in following cases:
3475 * a) Assignment form was called.
3476 * assignshift==1, assign==T, method + 1 == off
3477 * b) Increment or decrement, called directly.
3478 * assignshift==0, assign==0, method + 0 == off
3479 * c) Increment or decrement, translated to assignment add/subtr.
b267980d 3480 * assignshift==0, assign==T,
ee239bfe
IZ		 3481 * force_cpy == T
3482 * d) Increment or decrement, translated to nomethod.
b267980d 3483 * assignshift==0, assign==0,
ee239bfe
IZ		 3484 * force_cpy == T
3485 * e) Assignment form translated to nomethod.
3486 * assignshift==1, assign==T, method + 1 != off
3487 * force_cpy == T
3488 */
3489 /* off is method, method+assignshift, or a result of opcode substitution.
3490 * In the latter case assignshift==0, so only notfound case is important.
3491 */
73512201 3492 if ( (lr == -1) && ( ( (method + assignshift == off)
ee239bfe 3493 && (assign || (method == inc_amg) || (method == dec_amg)))
73512201 3494 || force_cpy) )
6f1401dc 3495 {
1b38c28e
NC		 3496 /* newSVsv does not behave as advertised, so we copy missing
3497 * information by hand */
3498 SV *tmpRef = SvRV(left);
3499 SV *rv_copy;
31d632c3 3500 if (SvREFCNT(tmpRef) > 1 && (rv_copy = AMG_CALLunary(left,copy_amg))) {
1b38c28e
NC		 3501 SvRV_set(left, rv_copy);
3502 SvSETMAGIC(left);
e7881358 3503 SvREFCNT_dec_NN(tmpRef);
1b38c28e 3504 }
6f1401dc
DM		 3505 }
3506
a0d0e21e
LW		 3507 {
3508 dSP;
3509 BINOP myop;
3510 SV* res;
b7787f18 3511 const bool oldcatch = CATCH_GET;
67288365 3512 I32 oldmark, nret;
e839e6ed
DM		 3513 /* for multiconcat, we may call overload several times,
3514 * with the context of individual concats being scalar,
3515 * regardless of the overall context of the multiconcat op
3516 */
3517 U8 gimme = (force_scalar || PL_op->op_type == OP_MULTICONCAT)
3518 ? G_SCALAR : GIMME_V;
a0d0e21e 3519
54310121 3520 CATCH_SET(TRUE);
a0d0e21e
LW		 3521 Zero(&myop, 1, BINOP);
3522 myop.op_last = (OP *) &myop;
b37c2d43 3523 myop.op_next = NULL;
67288365
JL		 3524 myop.op_flags = OPf_STACKED;
3525
3526 switch (gimme) {
3527 case G_VOID:
3528 myop.op_flags |= OPf_WANT_VOID;
3529 break;
3530 case G_ARRAY:
3531 if (flags & AMGf_want_list) {
3532 myop.op_flags |= OPf_WANT_LIST;
3533 break;
3534 }
3535 /* FALLTHROUGH */
3536 default:
3537 myop.op_flags |= OPf_WANT_SCALAR;
3538 break;
3539 }
a0d0e21e 3540
e788e7d3 3541 PUSHSTACKi(PERLSI_OVERLOAD);
a0d0e21e 3542 ENTER;
462e5cf6 3543 SAVEOP();
533c011a 3544 PL_op = (OP *) &myop;
3280af22 3545 if (PERLDB_SUB && PL_curstash != PL_debstash)
533c011a 3546 PL_op->op_private |= OPpENTERSUB_DB;
897d3989 3547 Perl_pp_pushmark(aTHX);
a0d0e21e 3548
924508f0 3549 EXTEND(SP, notfound + 5);
a0d0e21e
LW		 3550 PUSHs(lr>0? right: left);
3551 PUSHs(lr>0? left: right);
3280af22 3552 PUSHs( lr > 0 ? &PL_sv_yes : ( assign ? &PL_sv_undef : &PL_sv_no ));
a0d0e21e 3553 if (notfound) {
59cd0e26
NC		 3554 PUSHs(newSVpvn_flags(AMG_id2name(method + assignshift),
3555 AMG_id2namelen(method + assignshift), SVs_TEMP));
a0d0e21e 3556 }
636ac8fc
FC		 3557 else if (flags & AMGf_numarg)
3558 PUSHs(&PL_sv_undef);
3559 if (flags & AMGf_numarg)
3560 PUSHs(&PL_sv_yes);
ad64d0ec 3561 PUSHs(MUTABLE_SV(cv));
a0d0e21e 3562 PUTBACK;
67288365 3563 oldmark = TOPMARK;
a0d0e21e 3564
139d0ce6 3565 if ((PL_op = PL_ppaddr[OP_ENTERSUB](aTHX)))
cea2e8a9 3566 CALLRUNOPS(aTHX);
a0d0e21e
LW		 3567 LEAVE;
3568 SPAGAIN;
67288365
JL		 3569 nret = SP - (PL_stack_base + oldmark);
3570
3571 switch (gimme) {
3572 case G_VOID:
3573 /* returning NULL has another meaning, and we check the context
3574 * at the call site too, so this can be differentiated from the
3575 * scalar case */
3576 res = &PL_sv_undef;
3577 SP = PL_stack_base + oldmark;
3578 break;
2165bd23 3579 case G_ARRAY:
67288365
JL		 3580 if (flags & AMGf_want_list) {
3581 res = sv_2mortal((SV *)newAV());
3582 av_extend((AV *)res, nret);
3583 while (nret--)
3584 av_store((AV *)res, nret, POPs);
3585 break;
3586 }
3587 /* FALLTHROUGH */
67288365
JL		 3588 default:
3589 res = POPs;
3590 break;
3591 }
a0d0e21e 3592
ebafeae7 3593 PUTBACK;
d3acc0f7 3594 POPSTACK;
54310121 3595 CATCH_SET(oldcatch);
a0d0e21e 3596
a0d0e21e 3597 if (postpr) {
b7787f18 3598 int ans;
a0d0e21e
LW		 3599 switch (method) {
3600 case le_amg:
3601 case sle_amg:
3602 ans=SvIV(res)<=0; break;
3603 case lt_amg:
3604 case slt_amg:
3605 ans=SvIV(res)<0; break;
3606 case ge_amg:
3607 case sge_amg:
3608 ans=SvIV(res)>=0; break;
3609 case gt_amg:
3610 case sgt_amg:
3611 ans=SvIV(res)>0; break;
3612 case eq_amg:
3613 case seq_amg:
3614 ans=SvIV(res)==0; break;
3615 case ne_amg:
3616 case sne_amg:
3617 ans=SvIV(res)!=0; break;
3618 case inc_amg:
3619 case dec_amg:
bbce6d69 3620 SvSetSV(left,res); return left;
dc437b57 3621 case not_amg:
f4c975aa 3622 ans=!SvTRUE_NN(res); break;
b7787f18
AL		 3623 default:
3624 ans=0; break;
a0d0e21e 3625 }
54310121 3626 return boolSV(ans);
748a9306
LW		 3627 } else if (method==copy_amg) {
3628 if (!SvROK(res)) {
cea2e8a9 3629 Perl_croak(aTHX_ "Copy method did not return a reference");
748a9306
LW		 3630 }
3631 return SvREFCNT_inc(SvRV(res));
a0d0e21e
LW		 3632 } else {
3633 return res;
3634 }
3635 }
3636}
c9d5ac95 3637
f5c1e807
NC		 3638void
3639Perl_gv_name_set(pTHX_ GV *gv, const char *name, U32 len, U32 flags)
3640{
3641 dVAR;
acda4c6a 3642 U32 hash;
f5c1e807 3643
7918f24d 3644 PERL_ARGS_ASSERT_GV_NAME_SET;
f5c1e807 3645
acda4c6a 3646 if (len > I32_MAX)
147e3846 3647 Perl_croak(aTHX_ "panic: gv name too long (%" UVuf ")", (UV) len);
acda4c6a 3648
ae8cc45f
NC		 3649 if (!(flags & GV_ADD) && GvNAME_HEK(gv)) {
3650 unshare_hek(GvNAME_HEK(gv));
3651 }
3652
acda4c6a 3653 PERL_HASH(hash, name, len);
c60dbbc3 3654 GvNAME_HEK(gv) = share_hek(name, (flags & SVf_UTF8 ? -(I32)len : (I32)len), hash);
f5c1e807
NC		 3655}
3656
66610fdd 3657/*
f7461760
Z		 3658=for apidoc gv_try_downgrade
3659
2867cdbc
Z		 3660If the typeglob C<gv> can be expressed more succinctly, by having
3661something other than a real GV in its place in the stash, replace it
3662with the optimised form. Basic requirements for this are that C<gv>
3663is a real typeglob, is sufficiently ordinary, and is only referenced
3664from its package. This function is meant to be used when a GV has been
3665looked up in part to see what was there, causing upgrading, but based
3666on what was found it turns out that the real GV isn't required after all.
3667
3668If C<gv> is a completely empty typeglob, it is deleted from the stash.
3669
3670If C<gv> is a typeglob containing only a sufficiently-ordinary constant
3671sub, the typeglob is replaced with a scalar-reference placeholder that
3672more compactly represents the same thing.
f7461760
Z		 3673
3674=cut
3675*/
3676
3677void
3678Perl_gv_try_downgrade(pTHX_ GV *gv)
3679{
3680 HV *stash;
3681 CV *cv;
3682 HEK *namehek;
3683 SV **gvp;
3684 PERL_ARGS_ASSERT_GV_TRY_DOWNGRADE;
95f56751
FC		 3685
3686 /* XXX Why and where does this leave dangling pointers during global
3687 destruction? */
627364f1 3688 if (PL_phase == PERL_PHASE_DESTRUCT) return;
95f56751 3689
2867cdbc 3690 if (!(SvREFCNT(gv) == 1 && SvTYPE(gv) == SVt_PVGV && !SvFAKE(gv) &&
803f2748 3691 !SvOBJECT(gv) && !SvREADONLY(gv) &&
f7461760 3692 isGV_with_GP(gv) && GvGP(gv) &&
2867cdbc 3693 !GvINTRO(gv) && GvREFCNT(gv) == 1 &&
f7461760 3694 !GvSV(gv) && !GvAV(gv) && !GvHV(gv) && !GvIOp(gv) && !GvFORM(gv) &&
099be4f1 3695 GvEGVx(gv) == gv && (stash = GvSTASH(gv))))
2867cdbc 3696 return;
2be08ad1
FC		 3697 if (gv == PL_statgv || gv == PL_last_in_gv || gv == PL_stderrgv)
3698 return;
803f2748
DM		 3699 if (SvMAGICAL(gv)) {
3700 MAGIC *mg;
3701 /* only backref magic is allowed */
3702 if (SvGMAGICAL(gv) || SvSMAGICAL(gv))
3703 return;
3704 for (mg = SvMAGIC(gv); mg; mg = mg->mg_moremagic) {
3705 if (mg->mg_type != PERL_MAGIC_backref)
3706 return;
3707 }
3708 }
2867cdbc
Z		 3709 cv = GvCV(gv);
3710 if (!cv) {
3711 HEK *gvnhek = GvNAME_HEK(gv);
0ca9877d 3712 (void)hv_deletehek(stash, gvnhek, G_DISCARD);
8941bf97 3713 } else if (GvMULTI(gv) && cv && SvREFCNT(cv) == 1 &&
f7461760 3714 !SvOBJECT(cv) && !SvMAGICAL(cv) && !SvREADONLY(cv) &&
34d81fc4 3715 CvSTASH(cv) == stash && !CvNAMED(cv) && CvGV(cv) == gv &&
f7461760
Z		 3716 CvCONST(cv) && !CvMETHOD(cv) && !CvLVALUE(cv) && !CvUNIQUE(cv) &&
3717 !CvNODEBUG(cv) && !CvCLONE(cv) && !CvCLONED(cv) && !CvANON(cv) &&
3718 (namehek = GvNAME_HEK(gv)) &&
48c2c411 3719 (gvp = hv_fetchhek(stash, namehek, 0)) &&
f7461760
Z		 3720 *gvp == (SV*)gv) {
3721 SV *value = SvREFCNT_inc(CvXSUBANY(cv).any_ptr);
70e5f2b5 3722 const bool imported = !!GvIMPORTED_CV(gv);
f7461760
Z		 3723 SvREFCNT(gv) = 0;
3724 sv_clear((SV*)gv);
3725 SvREFCNT(gv) = 1;
70e5f2b5 3726 SvFLAGS(gv) = SVt_IV|SVf_ROK|SVprv_PCS_IMPORTED * imported;
dc6369ef
EH		 3727
3728 /* See also: 'SET_SVANY_FOR_BODYLESS_IV' in sv.c */
f7461760
Z		 3729 SvANY(gv) = (XPVGV*)((char*)&(gv->sv_u.svu_iv) -
3730 STRUCT_OFFSET(XPVIV, xiv_iv));
3731 SvRV_set(gv, value);
3732 }
3733}
3734
9e3fb20c
FC		 3735GV *
3736Perl_gv_override(pTHX_ const char * const name, const STRLEN len)
3737{
3738 GV *gv = gv_fetchpvn(name, len, GV_NOTQUAL, SVt_PVCV);
3739 GV * const *gvp;
3740 PERL_ARGS_ASSERT_GV_OVERRIDE;
3741 if (gv && GvCVu(gv) && GvIMPORTED_CV(gv)) return gv;
3742 gvp = (GV**)hv_fetch(PL_globalstash, name, len, FALSE);
3743 gv = gvp ? *gvp : NULL;
3744 if (gv && !isGV(gv)) {
3745 if (!SvPCS_IMPORTED(gv)) return NULL;
3746 gv_init(gv, PL_globalstash, name, len, 0);
3747 return gv;
3748 }
3749 return gv && GvCVu(gv) && GvIMPORTED_CV(gv) ? gv : NULL;
3750}
3751
4aaa4757
FC		 3752#include "XSUB.h"
3753
3754static void
3755core_xsub(pTHX_ CV* cv)
3756{
3757 Perl_croak(aTHX_
3758 "&CORE::%s cannot be called directly", GvNAME(CvGV(cv))
3759 );
3760}
3761
f7461760 3762/*
14d04a33 3763 * ex: set ts=8 sts=4 sw=4 et:
37442d52 3764 */
Unnamed repository; edit this file 'description' to name the repository.