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
Local variable 'last' hides a parameter of the same name
[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;
9ebf26ad 2072 case '\007': /* $^GLOBAL_PHASE */
eafd371c 2073 if (memEQs(name, len, "\007LOBAL_PHASE"))
9ebf26ad
FR		 2074 goto ro_magicalize;
2075 break;
8561ea1d 2076 case '\014': /* $^LAST_FH */
eafd371c 2077 if (memEQs(name, len, "\014AST_FH"))
8561ea1d
FC		 2078 goto ro_magicalize;
2079 break;
cde0cee5 2080 case '\015': /* $^MATCH */
eafd371c 2081 if (memEQs(name, len, "\015ATCH")) {
960b831f
NC		 2082 paren = RX_BUFF_IDX_CARET_FULLMATCH;
2083 goto storeparen;
2084 }
66230c86 2085 break;
cc4c2da6 2086 case '\017': /* $^OPEN */
eafd371c 2087 if (memEQs(name, len, "\017PEN"))
cc4c2da6
NC		 2088 goto magicalize;
2089 break;
cde0cee5 2090 case '\020': /* $^PREMATCH $^POSTMATCH */
eafd371c 2091 if (memEQs(name, len, "\020REMATCH")) {
960b831f
NC		 2092 paren = RX_BUFF_IDX_CARET_PREMATCH;
2093 goto storeparen;
2094 }
eafd371c 2095 if (memEQs(name, len, "\020OSTMATCH")) {
960b831f
NC		 2096 paren = RX_BUFF_IDX_CARET_POSTMATCH;
2097 goto storeparen;
2098 }
9ebf26ad 2099 break;
f512d242
KW		 2100 case '\023':
2101 if (memEQs(name, len, "\023AFE_LOCALES"))
2102 goto ro_magicalize;
2103 break;
cc4c2da6 2104 case '\024': /* ${^TAINT} */
eafd371c 2105 if (memEQs(name, len, "\024AINT"))
cc4c2da6
NC		 2106 goto ro_magicalize;
2107 break;
7cebcbc0 2108 case '\025': /* ${^UNICODE}, ${^UTF8LOCALE} */
eafd371c 2109 if (memEQs(name, len, "\025NICODE"))
cc4c2da6 2110 goto ro_magicalize;
eafd371c 2111 if (memEQs(name, len, "\025TF8LOCALE"))
7cebcbc0 2112 goto ro_magicalize;
eafd371c 2113 if (memEQs(name, len, "\025TF8CACHE"))
e07ea26a 2114 goto magicalize;
cc4c2da6
NC		 2115 break;
2116 case '\027': /* $^WARNING_BITS */
eafd371c 2117 if (memEQs(name, len, "\027ARNING_BITS"))
cc4c2da6 2118 goto magicalize;
8ca2a5d6 2119#ifdef WIN32
eafd371c 2120 else if (memEQs(name, len, "\027IN32_SLOPPY_STAT"))
8ca2a5d6
DD		 2121 goto magicalize;
2122#endif
cc4c2da6
NC		 2123 break;
2124 case '1':
2125 case '2':
2126 case '3':
2127 case '4':
2128 case '5':
2129 case '6':
2130 case '7':
2131 case '8':
2132 case '9':
85e6fe83 2133 {
2fdbfb4d
AB		 2134 /* Ensures that we have an all-digit variable, ${"1foo"} fails
2135 this test */
22ff3130
HS		 2136 UV uv;
2137 if (!grok_atoUV(name, &uv, NULL) || uv > I32_MAX)
1321bbe3 2138 goto ret;
22ff3130
HS		 2139 /* XXX why are we using a SSize_t? */
2140 paren = (SSize_t)(I32)uv;
960b831f 2141 goto storeparen;
1d7c1841 2142 }
dc437b57 2143 }
93a17b20 2144 }
392db708
NC		 2145 } else {
2146 /* Names of length 1. (Or 0. But name is NUL terminated, so that will
2147 be case '\0' in this switch statement (ie a default case) */
cc4c2da6 2148 switch (*name) {
6361f656 2149 case '&': /* $& */
960b831f
NC		 2150 paren = RX_BUFF_IDX_FULLMATCH;
2151 goto sawampersand;
6361f656 2152 case '`': /* $` */
960b831f
NC		 2153 paren = RX_BUFF_IDX_PREMATCH;
2154 goto sawampersand;
6361f656 2155 case '\'': /* $' */
960b831f
NC		 2156 paren = RX_BUFF_IDX_POSTMATCH;
2157 sawampersand:
1a904fc8 2158#ifdef PERL_SAWAMPERSAND
a289ef89 2159 if (!(
cc4c2da6
NC		 2160 sv_type == SVt_PVAV ||
2161 sv_type == SVt_PVHV ||
2162 sv_type == SVt_PVCV ||
2163 sv_type == SVt_PVFM ||
2164 sv_type == SVt_PVIO
d3b97530
DM		 2165 )) { PL_sawampersand |=
2166 (*name == '`')
2167 ? SAWAMPERSAND_LEFT
2168 : (*name == '&')
2169 ? SAWAMPERSAND_MIDDLE
2170 : SAWAMPERSAND_RIGHT;
2171 }
1a904fc8 2172#endif
960b831f 2173 goto storeparen;
e91d8259
NC		 2174 case '1': /* $1 */
2175 case '2': /* $2 */
2176 case '3': /* $3 */
2177 case '4': /* $4 */
2178 case '5': /* $5 */
2179 case '6': /* $6 */
2180 case '7': /* $7 */
2181 case '8': /* $8 */
2182 case '9': /* $9 */
960b831f
NC		 2183 paren = *name - '0';
2184
2185 storeparen:
e91d8259
NC		 2186 /* Flag the capture variables with a NULL mg_ptr
2187 Use mg_len for the array index to lookup. */
960b831f 2188 sv_magic(GvSVn(gv), MUTABLE_SV(gv), PERL_MAGIC_sv, NULL, paren);
e91d8259 2189 break;
cc4c2da6 2190
6361f656 2191 case ':': /* $: */
c69033f2 2192 sv_setpv(GvSVn(gv),PL_chopset);
cc4c2da6
NC		 2193 goto magicalize;
2194
6361f656 2195 case '?': /* $? */
ff0cee69 2196#ifdef COMPLEX_STATUS
c69033f2 2197 SvUPGRADE(GvSVn(gv), SVt_PVLV);
ff0cee69 2198#endif
cc4c2da6 2199 goto magicalize;
ff0cee69 2200
6361f656 2201 case '!': /* $! */
67261566 2202 GvMULTI_on(gv);
44a2ac75 2203 /* If %! has been used, automatically load Errno.pm. */
d2c93421 2204
ad64d0ec 2205 sv_magic(GvSVn(gv), MUTABLE_SV(gv), PERL_MAGIC_sv, name, len);
d2c93421 2206
7c719134 2207 /* magicalization must be done before require_tie_mod_s is called */
67261566 2208 if (sv_type == SVt_PVHV || sv_type == SVt_PVGV)
7c719134 2209 require_tie_mod_s(gv, '!', "Errno", 1);
d2c93421 2210
6cef1e77 2211 break;
754f85ad
YO		 2212 case '-': /* $-, %-, @- */
2213 case '+': /* $+, %+, @+ */
27deb0cf
YO		 2214 GvMULTI_on(gv); /* no used once warnings here */
2215 { /* $- $+ */
2216 sv_magic(GvSVn(gv), MUTABLE_SV(gv), PERL_MAGIC_sv, name, len);
2217 if (*name == '+')
2218 SvREADONLY_on(GvSVn(gv));
2219 }
2220 { /* %- %+ */
2221 if (sv_type == SVt_PVHV || sv_type == SVt_PVGV)
2222 require_tie_mod_s(gv, *name, "Tie::Hash::NamedCapture",0);
2223 }
2224 { /* @- @+ */
2225 AV* const av = GvAVn(gv);
fa531f32 2226 const Size_t n = *name;
67261566 2227
fa531f32 2228 sv_magic(MUTABLE_SV(av), (SV*)n, PERL_MAGIC_regdata, NULL, 0);
27deb0cf
YO		 2229 SvREADONLY_on(av);
2230 }
80305961 2231 break;
a678626e
A		 2232 case '*': /* $* */
2233 case '#': /* $# */
dcb414ac
JK		 2234 if (sv_type == SVt_PV)
2235 /* diag_listed_as: $* is no longer supported as of Perl 5.30 */
2236 Perl_croak(aTHX_ "$%c is no longer supported as of Perl 5.30", *name);
2237 break;
b3ca2e83
NC		 2238 case '\010': /* $^H */
2239 {
2240 HV *const hv = GvHVn(gv);
2241 hv_magic(hv, NULL, PERL_MAGIC_hints);
2242 }
2243 goto magicalize;
cc4c2da6 2244 case '\023': /* $^S */
2fdbfb4d
AB		 2245 ro_magicalize:
2246 SvREADONLY_on(GvSVn(gv));
924ba076 2247 /* FALLTHROUGH */
6361f656 2248 case '0': /* $0 */
6361f656
AB		 2249 case '^': /* $^ */
2250 case '~': /* $~ */
2251 case '=': /* $= */
2252 case '%': /* $% */
2253 case '.': /* $. */
2254 case '(': /* $( */
2255 case ')': /* $) */
2256 case '<': /* $< */
2257 case '>': /* $> */
2258 case '\\': /* $\ */
2259 case '/': /* $/ */
4505a31f 2260 case '|': /* $| */
9cdac2a2 2261 case '$': /* $$ */
c22e17d0 2262 case '[': /* $[ */
cc4c2da6
NC		 2263 case '\001': /* $^A */
2264 case '\003': /* $^C */
2265 case '\004': /* $^D */
2266 case '\005': /* $^E */
2267 case '\006': /* $^F */
cc4c2da6
NC		 2268 case '\011': /* $^I, NOT \t in EBCDIC */
2269 case '\016': /* $^N */
2270 case '\017': /* $^O */
2271 case '\020': /* $^P */
2272 case '\024': /* $^T */
2273 case '\027': /* $^W */
2274 magicalize:
ad64d0ec 2275 sv_magic(GvSVn(gv), MUTABLE_SV(gv), PERL_MAGIC_sv, name, len);
cc4c2da6 2276 break;
e521374c 2277
cc4c2da6 2278 case '\014': /* $^L */
76f68e9b 2279 sv_setpvs(GvSVn(gv),"\f");
463ee0b2 2280 break;
6361f656 2281 case ';': /* $; */
76f68e9b 2282 sv_setpvs(GvSVn(gv),"\034");
463ee0b2 2283 break;
6361f656 2284 case ']': /* $] */
cc4c2da6 2285 {
3638bf15 2286 SV * const sv = GvSV(gv);
d7aa5382 2287 if (!sv_derived_from(PL_patchlevel, "version"))
ac0e6a2f 2288 upg_version(PL_patchlevel, TRUE);
7d54d38e
SH		 2289 GvSV(gv) = vnumify(PL_patchlevel);
2290 SvREADONLY_on(GvSV(gv));
2291 SvREFCNT_dec(sv);
93a17b20
LW		 2292 }
2293 break;
cc4c2da6
NC		 2294 case '\026': /* $^V */
2295 {
3638bf15 2296 SV * const sv = GvSV(gv);
f9be5ac8
DM		 2297 GvSV(gv) = new_version(PL_patchlevel);
2298 SvREADONLY_on(GvSV(gv));
2299 SvREFCNT_dec(sv);
16070b82
GS		 2300 }
2301 break;
ea238638
FC		 2302 case 'a':
2303 case 'b':
dc3e91f6 2304 if (sv_type == SVt_PV)
ea238638 2305 GvMULTI_on(gv);
cc4c2da6 2306 }
79072805 2307 }
930867a8 2308
1321bbe3
FC		 2309 ret:
2310 /* Return true if we actually did something. */
2311 return GvAV(gv) || GvHV(gv) || GvIO(gv) || GvCV(gv)
2312 || ( GvSV(gv) && (
2313 SvOK(GvSV(gv)) || SvMAGICAL(GvSV(gv))
2314 )
2315 );
71c35c05
BF		 2316}
2317
8c995aba
FC		 2318/* If we do ever start using this later on in the file, we need to make
2319 sure we don’t accidentally use the wrong definition. */
2320#undef SvREADONLY_on
2321
070dc475
BF		 2322/* This function is called when the stash already holds the GV of the magic
2323 * variable we're looking for, but we need to check that it has the correct
2324 * kind of magic. For example, if someone first uses $! and then %!, the
2325 * latter would end up here, and we add the Errno tie to the HASH slot of
2326 * the *! glob.
2327 */
2328PERL_STATIC_INLINE void
2329S_maybe_multimagic_gv(pTHX_ GV *gv, const char *name, const svtype sv_type)
2330{
2331 PERL_ARGS_ASSERT_MAYBE_MULTIMAGIC_GV;
2332
2333 if (sv_type == SVt_PVHV || sv_type == SVt_PVGV) {
2334 if (*name == '!')
7c719134 2335 require_tie_mod_s(gv, '!', "Errno", 1);
070dc475 2336 else if (*name == '-' || *name == '+')
7c719134 2337 require_tie_mod_s(gv, *name, "Tie::Hash::NamedCapture", 0);
a678626e
A		 2338 } else if (sv_type == SVt_PV) {
2339 if (*name == '*' || *name == '#') {
dcb414ac
JK		 2340 /* diag_listed_as: $* is no longer supported as of Perl 5.30 */
2341 Perl_croak(aTHX_ "$%c is no longer supported as of Perl 5.30", *name);
a678626e 2342 }
070dc475
BF		 2343 }
2344 if (sv_type==SVt_PV || sv_type==SVt_PVGV) {
2345 switch (*name) {
070dc475
BF		 2346#ifdef PERL_SAWAMPERSAND
2347 case '`':
2348 PL_sawampersand |= SAWAMPERSAND_LEFT;
2349 (void)GvSVn(gv);
2350 break;
2351 case '&':
2352 PL_sawampersand |= SAWAMPERSAND_MIDDLE;
2353 (void)GvSVn(gv);
2354 break;
2355 case '\'':
2356 PL_sawampersand |= SAWAMPERSAND_RIGHT;
2357 (void)GvSVn(gv);
2358 break;
2359#endif
2360 }
2361 }
2362}
2363
71c35c05
BF		 2364GV *
2365Perl_gv_fetchpvn_flags(pTHX_ const char *nambeg, STRLEN full_len, I32 flags,
2366 const svtype sv_type)
2367{
71c35c05
BF		 2368 const char *name = nambeg;
2369 GV *gv = NULL;
2370 GV**gvp;
2371 STRLEN len;
2372 HV *stash = NULL;
2373 const I32 no_init = flags & (GV_NOADD_NOINIT | GV_NOINIT);
2374 const I32 no_expand = flags & GV_NOEXPAND;
2375 const I32 add = flags & ~GV_NOADD_MASK;
2376 const U32 is_utf8 = flags & SVf_UTF8;
930867a8 2377 bool addmg = cBOOL(flags & GV_ADDMG);
71c35c05
BF		 2378 const char *const name_end = nambeg + full_len;
2379 U32 faking_it;
2380
2381 PERL_ARGS_ASSERT_GV_FETCHPVN_FLAGS;
2382
2383 /* If we have GV_NOTQUAL, the caller promised that
2384 * there is no stash, so we can skip the check.
2385 * Similarly if full_len is 0, since then we're
2386 * dealing with something like *{""} or ""->foo()
2387 */
2388 if ((flags & GV_NOTQUAL) || !full_len) {
2389 len = full_len;
2390 }
2391 else if (parse_gv_stash_name(&stash, &gv, &name, &len, nambeg, full_len, is_utf8, add)) {
2392 if (name == name_end) return gv;
2393 }
2394 else {
2395 return NULL;
2396 }
2397
2398 if (!stash && !find_default_stash(&stash, name, len, is_utf8, add, sv_type)) {
2399 return NULL;
2400 }
2401
2402 /* By this point we should have a stash and a name */
c161da64 2403 gvp = (GV**)hv_fetch(stash,name,is_utf8 ? -(I32)len : (I32)len,add);
71c35c05
BF		 2404 if (!gvp || *gvp == (const GV *)&PL_sv_undef) {
2405 if (addmg) gv = (GV *)newSV(0);
2406 else return NULL;
2407 }
2408 else gv = *gvp, addmg = 0;
2409 /* From this point on, addmg means gv has not been inserted in the
2410 symtab yet. */
2411
2412 if (SvTYPE(gv) == SVt_PVGV) {
c002ae9a
BF		 2413 /* The GV already exists, so return it, but check if we need to do
2414 * anything else with it before that.
2415 */
71c35c05 2416 if (add) {
c002ae9a
BF		 2417 /* This is the heuristic that handles if a variable triggers the
2418 * 'used only once' warning. If there's already a GV in the stash
2419 * with this name, then we assume that the variable has been used
2420 * before and turn its MULTI flag on.
2421 * It's a heuristic because it can easily be "tricked", like with
2422 * BEGIN { $a = 1; $::{foo} = *a }; () = $foo
2423 * not warning about $main::foo being used just once
2424 */
71c35c05
BF		 2425 GvMULTI_on(gv);
2426 gv_init_svtype(gv, sv_type);
2427 /* You reach this path once the typeglob has already been created,
2428 either by the same or a different sigil. If this path didn't
2429 exist, then (say) referencing $! first, and %! second would
2430 mean that %! was not handled correctly. */
2431 if (len == 1 && stash == PL_defstash) {
070dc475 2432 maybe_multimagic_gv(gv, name, sv_type);
71c35c05 2433 }
b59bf0b2
KW		 2434 else if (sv_type == SVt_PVAV
2435 && memEQs(name, len, "ISA")
71c35c05
BF		 2436 && (!GvAV(gv) || !SvSMAGICAL(GvAV(gv))))
2437 gv_magicalize_isa(gv);
2438 }
2439 return gv;
2440 } else if (no_init) {
2441 assert(!addmg);
2442 return gv;
c002ae9a
BF		 2443 }
2444 /* If GV_NOEXPAND is true and what we got off the stash is a ref,
2445 * don't expand it to a glob. This is an optimization so that things
2446 * copying constants over, like Exporter, don't have to be rewritten
2447 * to take into account that you can store more than just globs in
2448 * stashes.
2449 */
2450 else if (no_expand && SvROK(gv)) {
71c35c05
BF		 2451 assert(!addmg);
2452 return gv;
2453 }
2454
2455 /* Adding a new symbol.
2456 Unless of course there was already something non-GV here, in which case
2457 we want to behave as if there was always a GV here, containing some sort
2458 of subroutine.
2459 Otherwise we run the risk of creating things like GvIO, which can cause
2460 subtle bugs. eg the one that tripped up SQL::Translator */
2461
2462 faking_it = SvOK(gv);
2463
2464 if (add & GV_ADDWARN)
2465 Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL),
147e3846 2466 "Had to create %" UTF8f " unexpectedly",
71c35c05
BF		 2467 UTF8fARG(is_utf8, name_end-nambeg, nambeg));
2468 gv_init_pvn(gv, stash, name, len, (add & GV_ADDMULTI)|is_utf8);
2469
7a207065
KW		 2470 if ( full_len != 0
2471 && isIDFIRST_lazy_if_safe(name, name + full_len, is_utf8)
2472 && !ckWARN(WARN_ONCE) )
2473 {
71c35c05 2474 GvMULTI_on(gv) ;
7a207065 2475 }
71c35c05
BF		 2476
2477 /* set up magic where warranted */
1321bbe3 2478 if ( gv_magicalize(gv, stash, name, len, sv_type) ) {
930867a8 2479 /* See 23496c6 */
1321bbe3
FC		 2480 if (addmg) {
2481 /* gv_magicalize magicalised this gv, so we want it
930867a8 2482 * stored in the symtab.
1321bbe3
FC		 2483 * Effectively the caller is asking, ‘Does this gv exist?’
2484 * And we respond, ‘Er, *now* it does!’
930867a8
BF		 2485 */
2486 (void)hv_store(stash,name,len,(SV *)gv,0);
1321bbe3
FC		 2487 }
2488 }
2489 else if (addmg) {
2490 /* The temporary GV created above */
930867a8
BF		 2491 SvREFCNT_dec_NN(gv);
2492 gv = NULL;
930867a8 2493 }
71c35c05 2494
e6066781 2495 if (gv) gv_init_svtype(gv, faking_it ? SVt_PVCV : sv_type);
93a17b20 2496 return gv;
79072805
LW		 2497}
2498
2499void
35a4481c 2500Perl_gv_fullname4(pTHX_ SV *sv, const GV *gv, const char *prefix, bool keepmain)
43693395 2501{
ed60a868 2502 const char *name;
35a4481c 2503 const HV * const hv = GvSTASH(gv);
7918f24d
NC		 2504
2505 PERL_ARGS_ASSERT_GV_FULLNAME4;
2506
666ea192 2507 sv_setpv(sv, prefix ? prefix : "");
a0288114 2508
52a6327b 2509 if (hv && (name = HvNAME(hv))) {
ed60a868 2510 const STRLEN len = HvNAMELEN(hv);
61e2287f 2511 if (keepmain || ! memBEGINs(name, len, "main")) {
ed60a868 2512 sv_catpvn_flags(sv,name,len,HvNAMEUTF8(hv)?SV_CATUTF8:SV_CATBYTES);
396482e1 2513 sv_catpvs(sv,"::");
ed60a868 2514 }
43693395 2515 }
ed60a868 2516 else sv_catpvs(sv,"__ANON__::");
04f3bf56 2517 sv_catsv(sv,sv_2mortal(newSVhek(GvNAME_HEK(gv))));
43693395
GS		 2518}
2519
2520void
35a4481c 2521Perl_gv_efullname4(pTHX_ SV *sv, const GV *gv, const char *prefix, bool keepmain)
43693395 2522{
099be4f1 2523 const GV * const egv = GvEGVx(gv);
7918f24d
NC		 2524
2525 PERL_ARGS_ASSERT_GV_EFULLNAME4;
2526
46c461b5 2527 gv_fullname4(sv, egv ? egv : gv, prefix, keepmain);
43693395
GS		 2528}
2529
39a65960
DM		 2530
2531/* recursively scan a stash and any nested stashes looking for entries
2532 * that need the "only used once" warning raised
2533 */
2534
79072805 2535void
51da40ed 2536Perl_gv_check(pTHX_ HV *stash)
79072805 2537{
eb578fdb 2538 I32 i;
463ee0b2 2539
7918f24d
NC		 2540 PERL_ARGS_ASSERT_GV_CHECK;
2541
9e5cda6b 2542 if (!SvOOK(stash))
8990e307 2543 return;
90754377 2544
9e5cda6b 2545 assert(HvARRAY(stash));
90754377 2546
a0d0e21e 2547 for (i = 0; i <= (I32) HvMAX(stash); i++) {
e1ec3a88 2548 const HE *entry;
90754377 2549 /* mark stash is being scanned, to avoid recursing */
339441ef 2550 HvAUX(stash)->xhv_aux_flags |= HvAUXf_SCAN_STASH;
dc437b57 2551 for (entry = HvARRAY(stash)[i]; entry; entry = HeNEXT(entry)) {
eb578fdb 2552 GV *gv;
b7787f18 2553 HV *hv;
e7acdfe9
DM		 2554 STRLEN keylen = HeKLEN(entry);
2555 const char * const key = HeKEY(entry);
2556
2557 if (keylen >= 2 && key[keylen-2] == ':' && key[keylen-1] == ':' &&
159b6efe 2558 (gv = MUTABLE_GV(HeVAL(entry))) && isGV(gv) && (hv = GvHV(gv)))
a0d0e21e 2559 {
90754377
DM		 2560 if (hv != PL_defstash && hv != stash
2561 && !(SvOOK(hv)
2562 && (HvAUX(hv)->xhv_aux_flags & HvAUXf_SCAN_STASH))
2563 )
a0d0e21e
LW		 2564 gv_check(hv); /* nested package */
2565 }
7a207065
KW		 2566 else if ( HeKLEN(entry) != 0
2567 && *HeKEY(entry) != '_'
2568 && isIDFIRST_lazy_if_safe(HeKEY(entry),
2569 HeKEY(entry) + HeKLEN(entry),
2570 HeUTF8(entry)) )
2571 {
e1ec3a88 2572 const char *file;
159b6efe 2573 gv = MUTABLE_GV(HeVAL(entry));
55d729e4 2574 if (SvTYPE(gv) != SVt_PVGV || GvMULTI(gv))
463ee0b2 2575 continue;
1d7c1841 2576 file = GvFILE(gv);
1d7c1841 2577 CopLINE_set(PL_curcop, GvLINE(gv));
1dc74fdb
FC		 2578#ifdef USE_ITHREADS
2579 CopFILE(PL_curcop) = (char *)file; /* set for warning */
2580#else
2581 CopFILEGV(PL_curcop)
2582 = gv_fetchfile_flags(file, HEK_LEN(GvFILE_HEK(gv)), 0);
2583#endif
9014280d 2584 Perl_warner(aTHX_ packWARN(WARN_ONCE),
147e3846 2585 "Name \"%" HEKf "::%" HEKf
d0c0e7dd
FC		 2586 "\" used only once: possible typo",
2587 HEKfARG(HvNAME_HEK(stash)),
2588 HEKfARG(GvNAME_HEK(gv)));
463ee0b2 2589 }
79072805 2590 }
339441ef 2591 HvAUX(stash)->xhv_aux_flags &= ~HvAUXf_SCAN_STASH;
79072805
LW		 2592 }
2593}
2594
2595GV *
9cc50d5b 2596Perl_newGVgen_flags(pTHX_ const char *pack, U32 flags)
79072805 2597{
9cc50d5b 2598 PERL_ARGS_ASSERT_NEWGVGEN_FLAGS;
b17a0679 2599 assert(!(flags & ~SVf_UTF8));
7918f24d 2600
147e3846 2601 return gv_fetchpv(Perl_form(aTHX_ "%" UTF8f "::_GEN_%ld",
b17a0679 2602 UTF8fARG(flags, strlen(pack), pack),
9cc50d5b
BF		 2603 (long)PL_gensym++),
2604 GV_ADD, SVt_PVGV);
79072805
LW		 2605}
2606
2607/* hopefully this is only called on local symbol table entries */
2608
2609GP*
864dbfa3 2610Perl_gp_ref(pTHX_ GP *gp)
79072805 2611{
1d7c1841 2612 if (!gp)
d4c19fe8 2613 return NULL;
79072805 2614 gp->gp_refcnt++;
44a8e56a 2615 if (gp->gp_cv) {
2616 if (gp->gp_cvgen) {
e1a479c5
BB		 2617 /* If the GP they asked for a reference to contains
2618 a method cache entry, clear it first, so that we
2619 don't infect them with our cached entry */
e7881358 2620 SvREFCNT_dec_NN(gp->gp_cv);
601f1833 2621 gp->gp_cv = NULL;
44a8e56a 2622 gp->gp_cvgen = 0;
2623 }
44a8e56a 2624 }
79072805 2625 return gp;
79072805
LW		 2626}
2627
2628void
864dbfa3 2629Perl_gp_free(pTHX_ GV *gv)
79072805 2630{
79072805 2631 GP* gp;
b0d55c99 2632 int attempts = 100;
79072805 2633
f7877b28 2634 if (!gv || !isGV_with_GP(gv) || !(gp = GvGP(gv)))
79072805 2635 return;
f248d071 2636 if (gp->gp_refcnt == 0) {
9b387841
NC		 2637 Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL),
2638 "Attempt to free unreferenced glob pointers"
2639 pTHX__FORMAT pTHX__VALUE);
79072805
LW		 2640 return;
2641 }
4571f4a7 2642 if (gp->gp_refcnt > 1) {
bc81b34d 2643 borrowed:
748a9306
LW		 2644 if (gp->gp_egv == gv)
2645 gp->gp_egv = 0;
4571f4a7 2646 gp->gp_refcnt--;
c43ae56f 2647 GvGP_set(gv, NULL);
79072805 2648 return;
748a9306 2649 }
79072805 2650
b0d55c99
FC		 2651 while (1) {
2652 /* Copy and null out all the glob slots, so destructors do not see
2653 freed SVs. */
2654 HEK * const file_hek = gp->gp_file_hek;
2655 SV * const sv = gp->gp_sv;
2656 AV * const av = gp->gp_av;
2657 HV * const hv = gp->gp_hv;
2658 IO * const io = gp->gp_io;
2659 CV * const cv = gp->gp_cv;
2660 CV * const form = gp->gp_form;
2661
2662 gp->gp_file_hek = NULL;
2663 gp->gp_sv = NULL;
2664 gp->gp_av = NULL;
2665 gp->gp_hv = NULL;
2666 gp->gp_io = NULL;
2667 gp->gp_cv = NULL;
2668 gp->gp_form = NULL;
2669
2670 if (file_hek)
2671 unshare_hek(file_hek);
2672
2673 SvREFCNT_dec(sv);
2674 SvREFCNT_dec(av);
2675 /* FIXME - another reference loop GV -> symtab -> GV ?
2676 Somehow gp->gp_hv can end up pointing at freed garbage. */
2677 if (hv && SvTYPE(hv) == SVt_PVHV) {
c2242065 2678 const HEK *hvname_hek = HvNAME_HEK(hv);
923ed580
FC		 2679 if (PL_stashcache && hvname_hek) {
2680 DEBUG_o(Perl_deb(aTHX_
147e3846 2681 "gp_free clearing PL_stashcache for '%" HEKf "'\n",
923ed580 2682 HEKfARG(hvname_hek)));
0ca9877d 2683 (void)hv_deletehek(PL_stashcache, hvname_hek, G_DISCARD);
923ed580 2684 }
b0d55c99
FC		 2685 SvREFCNT_dec(hv);
2686 }
96d7c888
FC		 2687 if (io && SvREFCNT(io) == 1 && IoIFP(io)
2688 && (IoTYPE(io) == IoTYPE_WRONLY ||
2689 IoTYPE(io) == IoTYPE_RDWR ||
2690 IoTYPE(io) == IoTYPE_APPEND)
2691 && ckWARN_d(WARN_IO)
2692 && IoIFP(io) != PerlIO_stdin()
2693 && IoIFP(io) != PerlIO_stdout()
2694 && IoIFP(io) != PerlIO_stderr()
2695 && !(IoFLAGS(io) & IOf_FAKE_DIRP))
2696 io_close(io, gv, FALSE, TRUE);
b0d55c99
FC		 2697 SvREFCNT_dec(io);
2698 SvREFCNT_dec(cv);
2699 SvREFCNT_dec(form);
2700
bc81b34d
FC		 2701 /* Possibly reallocated by a destructor */
2702 gp = GvGP(gv);
2703
b0d55c99
FC		 2704 if (!gp->gp_file_hek
2705 && !gp->gp_sv
2706 && !gp->gp_av
2707 && !gp->gp_hv
2708 && !gp->gp_io
2709 && !gp->gp_cv
2710 && !gp->gp_form) break;
2711
2712 if (--attempts == 0) {
2713 Perl_die(aTHX_
2714 "panic: gp_free failed to free glob pointer - "
2715 "something is repeatedly re-creating entries"
2716 );
2717 }
13207a71 2718 }
748a9306 2719
bc81b34d
FC		 2720 /* Possibly incremented by a destructor doing glob assignment */
2721 if (gp->gp_refcnt > 1) goto borrowed;
79072805 2722 Safefree(gp);
c43ae56f 2723 GvGP_set(gv, NULL);
79072805
LW		 2724}
2725
d460ef45
NIS		 2726int
2727Perl_magic_freeovrld(pTHX_ SV *sv, MAGIC *mg)
2728{
53c1dcc0
AL		 2729 AMT * const amtp = (AMT*)mg->mg_ptr;
2730 PERL_UNUSED_ARG(sv);
dd374669 2731
7918f24d
NC		 2732 PERL_ARGS_ASSERT_MAGIC_FREEOVRLD;
2733
d460ef45
NIS		 2734 if (amtp && AMT_AMAGIC(amtp)) {
2735 int i;
2736 for (i = 1; i < NofAMmeth; i++) {
53c1dcc0 2737 CV * const cv = amtp->table[i];
b37c2d43 2738 if (cv) {
e7881358 2739 SvREFCNT_dec_NN(MUTABLE_SV(cv));
601f1833 2740 amtp->table[i] = NULL;
d460ef45
NIS		 2741 }
2742 }
2743 }
2744 return 0;
2745}
2746
a0d0e21e 2747/* Updates and caches the CV's */
c3a9a790
RGS		 2748/* Returns:
2749 * 1 on success and there is some overload
2750 * 0 if there is no overload
2751 * -1 if some error occurred and it couldn't croak
2752 */
a0d0e21e 2753
c3a9a790 2754int
242f8760 2755Perl_Gv_AMupdate(pTHX_ HV *stash, bool destructing)
a0d0e21e 2756{
ad64d0ec 2757 MAGIC* const mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table);
a6006777 2758 AMT amt;
9b439311 2759 const struct mro_meta* stash_meta = HvMROMETA(stash);
e1a479c5 2760 U32 newgen;
a0d0e21e 2761
7918f24d
NC		 2762 PERL_ARGS_ASSERT_GV_AMUPDATE;
2763
9b439311 2764 newgen = PL_sub_generation + stash_meta->pkg_gen + stash_meta->cache_gen;
14899595
NC		 2765 if (mg) {
2766 const AMT * const amtp = (AMT*)mg->mg_ptr;
66978156 2767 if (amtp->was_ok_sub == newgen) {
8c34e50d 2768 return AMT_AMAGIC(amtp) ? 1 : 0;
14899595 2769 }
ad64d0ec 2770 sv_unmagic(MUTABLE_SV(stash), PERL_MAGIC_overload_table);
14899595 2771 }
a0d0e21e 2772
bfcb3514 2773 DEBUG_o( Perl_deb(aTHX_ "Recalcing overload magic in package %s\n",HvNAME_get(stash)) );
a0d0e21e 2774
d460ef45 2775 Zero(&amt,1,AMT);
e1a479c5 2776 amt.was_ok_sub = newgen;
a6006777 2777 amt.fallback = AMGfallNO;
2778 amt.flags = 0;
2779
a6006777 2780 {
8c34e50d
FC		 2781 int filled = 0;
2782 int i;
3d147ac2
DM		 2783 bool deref_seen = 0;
2784
a6006777 2785
3866ea3b 2786 /* Work with "fallback" key, which we assume to be first in PL_AMG_names */
a6006777 2787
89ffc314 2788 /* Try to find via inheritance. */
e6919483 2789 GV *gv = gv_fetchmeth_pvn(stash, PL_AMG_names[0], 2, -1, 0);
3866ea3b 2790 SV * const sv = gv ? GvSV(gv) : NULL;
53c1dcc0 2791 CV* cv;
89ffc314
IZ		 2792
2793 if (!gv)
3866ea3b
FC		 2794 {
2795 if (!gv_fetchmeth_pvn(stash, "((", 2, -1, 0))
8c34e50d 2796 goto no_table;
3866ea3b
FC		 2797 }
2798#ifdef PERL_DONT_CREATE_GVSV
2799 else if (!sv) {
6f207bd3 2800 NOOP; /* Equivalent to !SvTRUE and !SvOK */
3866ea3b
FC		 2801 }
2802#endif
79c9643d
JL		 2803 else if (SvTRUE(sv))
2804 /* don't need to set overloading here because fallback => 1
2805 * is the default setting for classes without overloading */
89ffc314 2806 amt.fallback=AMGfallYES;
79c9643d
JL		 2807 else if (SvOK(sv)) {
2808 amt.fallback=AMGfallNEVER;
386a5489 2809 filled = 1;
386a5489 2810 }
79c9643d 2811 else {
386a5489 2812 filled = 1;
386a5489 2813 }
a6006777 2814
3d147ac2 2815 assert(SvOOK(stash));
3d147ac2 2816 /* initially assume the worst */
339441ef 2817 HvAUX(stash)->xhv_aux_flags &= ~HvAUXf_NO_DEREF;
3d147ac2 2818
8c34e50d 2819 for (i = 1; i < NofAMmeth; i++) {
6136c704 2820 const char * const cooky = PL_AMG_names[i];
32251b26 2821 /* Human-readable form, for debugging: */
8c34e50d 2822 const char * const cp = AMG_id2name(i);
d279ab82 2823 const STRLEN l = PL_AMG_namelens[i];
89ffc314 2824
a0288114 2825 DEBUG_o( Perl_deb(aTHX_ "Checking overloading of \"%s\" in package \"%.256s\"\n",
bfcb3514 2826 cp, HvNAME_get(stash)) );
611c1e95
IZ		 2827 /* don't fill the cache while looking up!
2828 Creation of inheritance stubs in intermediate packages may
2829 conflict with the logic of runtime method substitution.
2830 Indeed, for inheritance A -> B -> C, if C overloads "+0",
2831 then we could have created stubs for "(+0" in A and C too.
2832 But if B overloads "bool", we may want to use it for
2833 numifying instead of C's "+0". */
8c34e50d 2834 gv = Perl_gv_fetchmeth_pvn(aTHX_ stash, cooky, l, -1, 0);
46fc3d4c 2835 cv = 0;
c3ad4e54 2836 if (gv && (cv = GvCV(gv)) && CvHASGV(cv)) {
79656330 2837 const HEK * const gvhek = CvGvNAME_HEK(cv);
c3ad4e54
FC		 2838 const HEK * const stashek =
2839 HvNAME_HEK(CvNAMED(cv) ? CvSTASH(cv) : GvSTASH(CvGV(cv)));
b59bf0b2
KW		 2840 if (memEQs(HEK_KEY(gvhek), HEK_LEN(gvhek), "nil")
2841 && stashek
2842 && memEQs(HEK_KEY(stashek), HEK_LEN(stashek), "overload")) {
611c1e95
IZ		 2843 /* This is a hack to support autoloading..., while
2844 knowing *which* methods were declared as overloaded. */
44a8e56a 2845 /* GvSV contains the name of the method. */
6136c704 2846 GV *ngv = NULL;
c69033f2 2847 SV *gvsv = GvSV(gv);
a0288114 2848
147e3846 2849 DEBUG_o( Perl_deb(aTHX_ "Resolving method \"%" SVf256\
a0288114 2850 "\" for overloaded \"%s\" in package \"%.256s\"\n",
f0e9f182 2851 (void*)GvSV(gv), cp, HvNAME(stash)) );
c69033f2 2852 if (!gvsv || !SvPOK(gvsv)
7f415459 2853 || !(ngv = gv_fetchmethod_sv_flags(stash, gvsv, 0)))
dc848c6f 2854 {
a0288114 2855 /* Can be an import stub (created by "can"). */
242f8760 2856 if (destructing) {
c3a9a790 2857 return -1;
242f8760
RGS		 2858 }
2859 else {
d66cca07
BF		 2860 const SV * const name = (gvsv && SvPOK(gvsv))
2861 ? gvsv
2862 : newSVpvs_flags("???", SVs_TEMP);
dcbac5bb 2863 /* diag_listed_as: Can't resolve method "%s" overloading "%s" in package "%s" */
147e3846 2864 Perl_croak(aTHX_ "%s method \"%" SVf256
d66cca07 2865 "\" overloading \"%s\" "\
147e3846 2866 "in package \"%" HEKf256 "\"",
242f8760
RGS		 2867 (GvCVGEN(gv) ? "Stub found while resolving"
2868 : "Can't resolve"),
d66cca07 2869 SVfARG(name), cp,
d0c0e7dd 2870 HEKfARG(
d66cca07 2871 HvNAME_HEK(stash)
d0c0e7dd 2872 ));
242f8760 2873 }
44a8e56a 2874 }
dc848c6f 2875 cv = GvCV(gv = ngv);
44a8e56a 2876 }
b464bac0 2877 DEBUG_o( Perl_deb(aTHX_ "Overloading \"%s\" in package \"%.256s\" via \"%.256s::%.256s\"\n",
bfcb3514 2878 cp, HvNAME_get(stash), HvNAME_get(GvSTASH(CvGV(cv))),
44a8e56a 2879 GvNAME(CvGV(cv))) );
2880 filled = 1;
611c1e95 2881 } else if (gv) { /* Autoloaded... */
ea726b52 2882 cv = MUTABLE_CV(gv);
611c1e95 2883 filled = 1;
44a8e56a 2884 }
ea726b52 2885 amt.table[i]=MUTABLE_CV(SvREFCNT_inc_simple(cv));
3d147ac2
DM		 2886
2887 if (gv) {
2888 switch (i) {
2889 case to_sv_amg:
2890 case to_av_amg:
2891 case to_hv_amg:
2892 case to_gv_amg:
2893 case to_cv_amg:
2894 case nomethod_amg:
2895 deref_seen = 1;
2896 break;
2897 }
2898 }
a0d0e21e 2899 }
3d147ac2 2900 if (!deref_seen)
45479970
DM		 2901 /* none of @{} etc overloaded; we can do $obj->[N] quicker.
2902 * NB - aux var invalid here, HvARRAY() could have been
2903 * reallocated since it was assigned to */
2904 HvAUX(stash)->xhv_aux_flags |= HvAUXf_NO_DEREF;
3d147ac2 2905
a0d0e21e 2906 if (filled) {
a6006777 2907 AMT_AMAGIC_on(&amt);
ad64d0ec 2908 sv_magic(MUTABLE_SV(stash), 0, PERL_MAGIC_overload_table,
14befaf4 2909 (char*)&amt, sizeof(AMT));
8c34e50d 2910 return TRUE;
a0d0e21e
LW		 2911 }
2912 }
a6006777 2913 /* Here we have no table: */
8c34e50d 2914 no_table:
a6006777 2915 AMT_AMAGIC_off(&amt);
ad64d0ec 2916 sv_magic(MUTABLE_SV(stash), 0, PERL_MAGIC_overload_table,
14befaf4 2917 (char*)&amt, sizeof(AMTS));
c3a9a790 2918 return 0;
a0d0e21e
LW		 2919}
2920
32251b26
IZ		 2921
2922CV*
2923Perl_gv_handler(pTHX_ HV *stash, I32 id)
2924{
3f8f4626 2925 MAGIC *mg;
32251b26 2926 AMT *amtp;
e1a479c5 2927 U32 newgen;
9b439311 2928 struct mro_meta* stash_meta;
32251b26 2929
bfcb3514 2930 if (!stash || !HvNAME_get(stash))
601f1833 2931 return NULL;
e1a479c5 2932
9b439311
BB		 2933 stash_meta = HvMROMETA(stash);
2934 newgen = PL_sub_generation + stash_meta->pkg_gen + stash_meta->cache_gen;
e1a479c5 2935
ad64d0ec 2936 mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table);
32251b26
IZ		 2937 if (!mg) {
2938 do_update:
8c34e50d 2939 if (Gv_AMupdate(stash, 0) == -1)
242f8760 2940 return NULL;
ad64d0ec 2941 mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table);
32251b26 2942 }
a9fd4e40 2943 assert(mg);
32251b26 2944 amtp = (AMT*)mg->mg_ptr;
66978156 2945 if ( amtp->was_ok_sub != newgen )
32251b26 2946 goto do_update;
3ad83ce7 2947 if (AMT_AMAGIC(amtp)) {
b7787f18 2948 CV * const ret = amtp->table[id];
3ad83ce7
AMS		 2949 if (ret && isGV(ret)) { /* Autoloading stab */
2950 /* Passing it through may have resulted in a warning
2951 "Inherited AUTOLOAD for a non-method deprecated", since
2952 our caller is going through a function call, not a method call.
2953 So return the CV for AUTOLOAD, setting $AUTOLOAD. */
890ce7af 2954 GV * const gv = gv_fetchmethod(stash, PL_AMG_names[id]);
3ad83ce7
AMS		 2955
2956 if (gv && GvCV(gv))
2957 return GvCV(gv);
2958 }
2959 return ret;
2960 }
a0288114 2961
601f1833 2962 return NULL;
32251b26
IZ		 2963}
2964
2965
6f1401dc
DM		 2966/* Implement tryAMAGICun_MG macro.
2967 Do get magic, then see if the stack arg is overloaded and if so call it.
2968 Flags:
6f1401dc
DM		 2969 AMGf_numeric apply sv_2num to the stack arg.
2970*/
2971
2972bool
2973Perl_try_amagic_un(pTHX_ int method, int flags) {
6f1401dc
DM		 2974 dSP;
2975 SV* tmpsv;
2976 SV* const arg = TOPs;
2977
2978 SvGETMAGIC(arg);
2979
9f8bf298 2980 if (SvAMAGIC(arg) && (tmpsv = amagic_call(arg, &PL_sv_undef, method,
636ac8fc
FC		 2981 AMGf_noright | AMGf_unary
2982 | (flags & AMGf_numarg))))
2983 {
13874762
DM		 2984 /* where the op is of the form:
2985 * $lex = $x op $y (where the assign is optimised away)
2986 * then assign the returned value to targ and return that;
2987 * otherwise return the value directly
2988 */
2989 if ( (PL_opargs[PL_op->op_type] & OA_TARGLEX)
2990 && (PL_op->op_private & OPpTARGET_MY))
2991 {
2992 dTARGET;
2993 sv_setsv(TARG, tmpsv);
2994 SETTARG;
2995 }
2996 else
2997 SETs(tmpsv);
2998
6f1401dc
DM		 2999 PUTBACK;
3000 return TRUE;
3001 }
3002
3003 if ((flags & AMGf_numeric) && SvROK(arg))
3004 *sp = sv_2num(arg);
3005 return FALSE;
3006}
3007
3008
3009/* Implement tryAMAGICbin_MG macro.
3010 Do get magic, then see if the two stack args are overloaded and if so
3011 call it.
3012 Flags:
6f1401dc
DM		 3013 AMGf_assign op may be called as mutator (eg +=)
3014 AMGf_numeric apply sv_2num to the stack arg.
3015*/
3016
3017bool
3018Perl_try_amagic_bin(pTHX_ int method, int flags) {
6f1401dc
DM		 3019 dSP;
3020 SV* const left = TOPm1s;
3021 SV* const right = TOPs;
3022
3023 SvGETMAGIC(left);
3024 if (left != right)
3025 SvGETMAGIC(right);
3026
3027 if (SvAMAGIC(left) || SvAMAGIC(right)) {
72876cce
DM		 3028 SV * tmpsv;
3029 /* STACKED implies mutator variant, e.g. $x += 1 */
3030 bool mutator = (flags & AMGf_assign) && (PL_op->op_flags & OPf_STACKED);
3031
3032 tmpsv = amagic_call(left, right, method,
3033 (mutator ? AMGf_assign: 0)
636ac8fc 3034 | (flags & AMGf_numarg));
6f1401dc 3035 if (tmpsv) {
13874762
DM		 3036 (void)POPs;
3037 /* where the op is one of the two forms:
3038 * $x op= $y
3039 * $lex = $x op $y (where the assign is optimised away)
3040 * then assign the returned value to targ and return that;
3041 * otherwise return the value directly
3042 */
3043 if ( mutator
3044 || ( (PL_opargs[PL_op->op_type] & OA_TARGLEX)
3045 && (PL_op->op_private & OPpTARGET_MY)))
3046 {
3047 dTARG;
3048 TARG = mutator ? *SP : PAD_SV(PL_op->op_targ);
3049 sv_setsv(TARG, tmpsv);
3050 SETTARG;
3051 }
3052 else
3053 SETs(tmpsv);
3054
6f1401dc
DM		 3055 PUTBACK;
3056 return TRUE;
3057 }
3058 }
13874762 3059
75ea7a12
FC		 3060 if(left==right && SvGMAGICAL(left)) {
3061 SV * const left = sv_newmortal();
3062 *(sp-1) = left;
3063 /* Print the uninitialized warning now, so it includes the vari-
3064 able name. */
3065 if (!SvOK(right)) {
3066 if (ckWARN(WARN_UNINITIALIZED)) report_uninit(right);
3067 sv_setsv_flags(left, &PL_sv_no, 0);
3068 }
3069 else sv_setsv_flags(left, right, 0);
3070 SvGETMAGIC(right);
3071 }
6f1401dc 3072 if (flags & AMGf_numeric) {
75ea7a12
FC		 3073 if (SvROK(TOPm1s))
3074 *(sp-1) = sv_2num(TOPm1s);
6f1401dc
DM		 3075 if (SvROK(right))
3076 *sp = sv_2num(right);
3077 }
3078 return FALSE;
3079}
3080
25a9ffce
NC		 3081SV *
3082Perl_amagic_deref_call(pTHX_ SV *ref, int method) {
3083 SV *tmpsv = NULL;
3d147ac2 3084 HV *stash;
25a9ffce
NC		 3085
3086 PERL_ARGS_ASSERT_AMAGIC_DEREF_CALL;
3087
3d147ac2
DM		 3088 if (!SvAMAGIC(ref))
3089 return ref;
3090 /* return quickly if none of the deref ops are overloaded */
3091 stash = SvSTASH(SvRV(ref));
3092 assert(SvOOK(stash));
3093 if (HvAUX(stash)->xhv_aux_flags & HvAUXf_NO_DEREF)
3094 return ref;
3095
3096 while ((tmpsv = amagic_call(ref, &PL_sv_undef, method,
25a9ffce
NC		 3097 AMGf_noright | AMGf_unary))) {
3098 if (!SvROK(tmpsv))
3099 Perl_croak(aTHX_ "Overloaded dereference did not return a reference");
3100 if (tmpsv == ref || SvRV(tmpsv) == SvRV(ref)) {
3101 /* Bail out if it returns us the same reference. */
3102 return tmpsv;
3103 }
3104 ref = tmpsv;
3d147ac2
DM		 3105 if (!SvAMAGIC(ref))
3106 break;
25a9ffce
NC		 3107 }
3108 return tmpsv ? tmpsv : ref;
3109}
6f1401dc 3110
8d569291
FC		 3111bool
3112Perl_amagic_is_enabled(pTHX_ int method)
3113{
3114 SV *lex_mask = cop_hints_fetch_pvs(PL_curcop, "overloading", 0);
3115
3116 assert(PL_curcop->cop_hints & HINT_NO_AMAGIC);
3117
3118 if ( !lex_mask || !SvOK(lex_mask) )
3119 /* overloading lexically disabled */
3120 return FALSE;
3121 else if ( lex_mask && SvPOK(lex_mask) ) {
3122 /* we have an entry in the hints hash, check if method has been
3123 * masked by overloading.pm */
3124 STRLEN len;
3125 const int offset = method / 8;
3126 const int bit = method % 8;
3127 char *pv = SvPV(lex_mask, len);
3128
3129 /* Bit set, so this overloading operator is disabled */
3130 if ( (STRLEN)offset < len && pv[offset] & ( 1 << bit ) )
3131 return FALSE;
3132 }
3133 return TRUE;
3134}
3135
a0d0e21e 3136SV*
864dbfa3 3137Perl_amagic_call(pTHX_ SV *left, SV *right, int method, int flags)
a0d0e21e 3138{
27da23d5 3139 dVAR;
b267980d 3140 MAGIC *mg;
9c5ffd7c 3141 CV *cv=NULL;
a0d0e21e 3142 CV **cvp=NULL, **ocvp=NULL;
9c5ffd7c 3143 AMT *amtp=NULL, *oamtp=NULL;
b464bac0
AL		 3144 int off = 0, off1, lr = 0, notfound = 0;
3145 int postpr = 0, force_cpy = 0;
3146 int assign = AMGf_assign & flags;
3147 const int assignshift = assign ? 1 : 0;
bf5522a1 3148 int use_default_op = 0;
67288365 3149 int force_scalar = 0;
497b47a8
JH		 3150#ifdef DEBUGGING
3151 int fl=0;
497b47a8 3152#endif
25716404 3153 HV* stash=NULL;
7918f24d
NC		 3154
3155 PERL_ARGS_ASSERT_AMAGIC_CALL;
3156
e46c382e 3157 if ( PL_curcop->cop_hints & HINT_NO_AMAGIC ) {
8d569291 3158 if (!amagic_is_enabled(method)) return NULL;
e46c382e
YK		 3159 }
3160
a0d0e21e 3161 if (!(AMGf_noleft & flags) && SvAMAGIC(left)
0a2c84ab 3162 && (stash = SvSTASH(SvRV(left))) && Gv_AMG(stash)
ad64d0ec 3163 && (mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table))
b267980d 3164 && (ocvp = cvp = (AMT_AMAGIC((AMT*)mg->mg_ptr)
a6006777 3165 ? (oamtp = amtp = (AMT*)mg->mg_ptr)->table
d4c19fe8 3166 : NULL))
b267980d 3167 && ((cv = cvp[off=method+assignshift])
748a9306
LW		 3168 || (assign && amtp->fallback > AMGfallNEVER && /* fallback to
3169 * usual method */
497b47a8
JH		 3170 (
3171#ifdef DEBUGGING
3172 fl = 1,
a0288114 3173#endif
497b47a8 3174 cv = cvp[off=method])))) {
a0d0e21e
LW		 3175 lr = -1; /* Call method for left argument */
3176 } else {
3177 if (cvp && amtp->fallback > AMGfallNEVER && flags & AMGf_unary) {
3178 int logic;
3179
3180 /* look for substituted methods */
ee239bfe 3181 /* In all the covered cases we should be called with assign==0. */
a0d0e21e
LW		 3182 switch (method) {
3183 case inc_amg:
ee239bfe
IZ		 3184 force_cpy = 1;
3185 if ((cv = cvp[off=add_ass_amg])
3186 || ((cv = cvp[off = add_amg]) && (force_cpy = 0, postpr = 1))) {
3280af22 3187 right = &PL_sv_yes; lr = -1; assign = 1;
a0d0e21e
LW		 3188 }
3189 break;
3190 case dec_amg:
ee239bfe
IZ		 3191 force_cpy = 1;
3192 if ((cv = cvp[off = subtr_ass_amg])
3193 || ((cv = cvp[off = subtr_amg]) && (force_cpy = 0, postpr=1))) {
3280af22 3194 right = &PL_sv_yes; lr = -1; assign = 1;
a0d0e21e
LW		 3195 }
3196 break;
3197 case bool__amg:
3198 (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=string_amg]));
3199 break;
3200 case numer_amg:
3201 (void)((cv = cvp[off=string_amg]) || (cv = cvp[off=bool__amg]));
3202 break;
3203 case string_amg:
3204 (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=bool__amg]));
3205 break;
b7787f18
AL		 3206 case not_amg:
3207 (void)((cv = cvp[off=bool__amg])
3208 || (cv = cvp[off=numer_amg])
3209 || (cv = cvp[off=string_amg]));
2ab54efd
MB		 3210 if (cv)
3211 postpr = 1;
b7787f18 3212 break;
748a9306
LW		 3213 case copy_amg:
3214 {
76e3520e
GS		 3215 /*
3216 * SV* ref causes confusion with the interpreter variable of
3217 * the same name
3218 */
890ce7af 3219 SV* const tmpRef=SvRV(left);
76e3520e 3220 if (!SvROK(tmpRef) && SvTYPE(tmpRef) <= SVt_PVMG) {
fc36a67e 3221 /*
3222 * Just to be extra cautious. Maybe in some
3223 * additional cases sv_setsv is safe, too.
3224 */
890ce7af 3225 SV* const newref = newSVsv(tmpRef);
748a9306 3226 SvOBJECT_on(newref);
a1cd65be
FC		 3227 /* No need to do SvAMAGIC_on here, as SvAMAGIC macros
3228 delegate to the stash. */
85fbaab2 3229 SvSTASH_set(newref, MUTABLE_HV(SvREFCNT_inc(SvSTASH(tmpRef))));
748a9306
LW		 3230 return newref;
3231 }
3232 }
3233 break;
a0d0e21e 3234 case abs_amg:
b267980d 3235 if ((cvp[off1=lt_amg] || cvp[off1=ncmp_amg])
a0d0e21e 3236 && ((cv = cvp[off=neg_amg]) || (cv = cvp[off=subtr_amg]))) {
725c44f9 3237 SV* const nullsv=&PL_sv_zero;
a0d0e21e 3238 if (off1==lt_amg) {
890ce7af 3239 SV* const lessp = amagic_call(left,nullsv,
a0d0e21e 3240 lt_amg,AMGf_noright);
f4c975aa 3241 logic = SvTRUE_NN(lessp);
a0d0e21e 3242 } else {
890ce7af 3243 SV* const lessp = amagic_call(left,nullsv,
a0d0e21e
LW		 3244 ncmp_amg,AMGf_noright);
3245 logic = (SvNV(lessp) < 0);
3246 }
3247 if (logic) {
3248 if (off==subtr_amg) {
3249 right = left;
748a9306 3250 left = nullsv;
a0d0e21e
LW		 3251 lr = 1;
3252 }
3253 } else {
3254 return left;
3255 }
3256 }
3257 break;
3258 case neg_amg:
155aba94 3259 if ((cv = cvp[off=subtr_amg])) {
a0d0e21e 3260 right = left;
725c44f9 3261 left = &PL_sv_zero;
a0d0e21e
LW		 3262 lr = 1;
3263 }
3264 break;
f216259d 3265 case int_amg:
f5284f61 3266 case iter_amg: /* XXXX Eventually should do to_gv. */
c4c7412c 3267 case ftest_amg: /* XXXX Eventually should do to_gv. */
d4b87e75 3268 case regexp_amg:
b267980d
NIS		 3269 /* FAIL safe */
3270 return NULL; /* Delegate operation to standard mechanisms. */
81d52ecd 3271
f5284f61
IZ		 3272 case to_sv_amg:
3273 case to_av_amg:
3274 case to_hv_amg:
3275 case to_gv_amg:
3276 case to_cv_amg:
3277 /* FAIL safe */
b267980d 3278 return left; /* Delegate operation to standard mechanisms. */
81d52ecd 3279
a0d0e21e
LW		 3280 default:
3281 goto not_found;
3282 }
3283 if (!cv) goto not_found;
3284 } else if (!(AMGf_noright & flags) && SvAMAGIC(right)
0a2c84ab 3285 && (stash = SvSTASH(SvRV(right))) && Gv_AMG(stash)
ad64d0ec 3286 && (mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table))
b267980d 3287 && (cvp = (AMT_AMAGIC((AMT*)mg->mg_ptr)
a6006777 3288 ? (amtp = (AMT*)mg->mg_ptr)->table
d4c19fe8 3289 : NULL))
69815d08
RS		 3290 && (cv = cvp[off=method])) { /* Method for right
3291 * argument found */
3292 lr=1;
bf5522a1
MB		 3293 } else if (((cvp && amtp->fallback > AMGfallNEVER)
3294 || (ocvp && oamtp->fallback > AMGfallNEVER))
a0d0e21e
LW		 3295 && !(flags & AMGf_unary)) {
3296 /* We look for substitution for
3297 * comparison operations and
fc36a67e 3298 * concatenation */
a0d0e21e
LW		 3299 if (method==concat_amg || method==concat_ass_amg
3300 || method==repeat_amg || method==repeat_ass_amg) {
3301 return NULL; /* Delegate operation to string conversion */
3302 }
3303 off = -1;
3304 switch (method) {
3305 case lt_amg:
3306 case le_amg:
3307 case gt_amg:
3308 case ge_amg:
3309 case eq_amg:
3310 case ne_amg:
2ab54efd
MB		 3311 off = ncmp_amg;
3312 break;
a0d0e21e
LW		 3313 case slt_amg:
3314 case sle_amg:
3315 case sgt_amg:
3316 case sge_amg:
3317 case seq_amg:
3318 case sne_amg:
2ab54efd
MB		 3319 off = scmp_amg;
3320 break;
a0d0e21e 3321 }
bf5522a1
MB		 3322 if (off != -1) {
3323 if (ocvp && (oamtp->fallback > AMGfallNEVER)) {
3324 cv = ocvp[off];
3325 lr = -1;
3326 }
3327 if (!cv && (cvp && amtp->fallback > AMGfallNEVER)) {
3328 cv = cvp[off];
3329 lr = 1;
3330 }
3331 }
3332 if (cv)
2ab54efd
MB		 3333 postpr = 1;
3334 else
3335 goto not_found;
a0d0e21e 3336 } else {
a6006777 3337 not_found: /* No method found, either report or croak */
b267980d
NIS		 3338 switch (method) {
3339 case to_sv_amg:
3340 case to_av_amg:
3341 case to_hv_amg:
3342 case to_gv_amg:
3343 case to_cv_amg:
3344 /* FAIL safe */
3345 return left; /* Delegate operation to standard mechanisms. */
b267980d 3346 }
a0d0e21e
LW		 3347 if (ocvp && (cv=ocvp[nomethod_amg])) { /* Call report method */
3348 notfound = 1; lr = -1;
3349 } else if (cvp && (cv=cvp[nomethod_amg])) {
3350 notfound = 1; lr = 1;
bf5522a1
MB		 3351 } else if ((use_default_op =
3352 (!ocvp || oamtp->fallback >= AMGfallYES)
3353 && (!cvp || amtp->fallback >= AMGfallYES))
3354 && !DEBUG_o_TEST) {
4cc0ca18
NC		 3355 /* Skip generating the "no method found" message. */
3356 return NULL;
a0d0e21e 3357 } else {
46fc3d4c 3358 SV *msg;
774d564b 3359 if (off==-1) off=method;
b267980d 3360 msg = sv_2mortal(Perl_newSVpvf(aTHX_
147e3846 3361 "Operation \"%s\": no method found,%sargument %s%" SVf "%s%" SVf,
d66cca07
BF		 3362 AMG_id2name(method + assignshift),
3363 (flags & AMGf_unary ? " " : "\n\tleft "),
3364 SvAMAGIC(left)?
3365 "in overloaded package ":
3366 "has no overloaded magic",
3367 SvAMAGIC(left)?
3368 SVfARG(sv_2mortal(newSVhek(HvNAME_HEK(SvSTASH(SvRV(left)))))):
3369 SVfARG(&PL_sv_no),
3370 SvAMAGIC(right)?
3371 ",\n\tright argument in overloaded package ":
3372 (flags & AMGf_unary
3373 ? ""
3374 : ",\n\tright argument has no overloaded magic"),
3375 SvAMAGIC(right)?
3376 SVfARG(sv_2mortal(newSVhek(HvNAME_HEK(SvSTASH(SvRV(right)))))):
3377 SVfARG(&PL_sv_no)));
bf5522a1 3378 if (use_default_op) {
147e3846 3379 DEBUG_o( Perl_deb(aTHX_ "%" SVf, SVfARG(msg)) );
a0d0e21e 3380 } else {
147e3846 3381 Perl_croak(aTHX_ "%" SVf, SVfARG(msg));
a0d0e21e
LW		 3382 }
3383 return NULL;
3384 }
ee239bfe 3385 force_cpy = force_cpy || assign;
a0d0e21e
LW		 3386 }
3387 }
67288365
JL		 3388
3389 switch (method) {
3390 /* in these cases, we're calling '+' or '-' as a fallback for a ++ or --
3391 * operation. we need this to return a value, so that it can be assigned
3392 * later on, in the postpr block (case inc_amg/dec_amg), even if the
3393 * increment or decrement was itself called in void context */
3394 case inc_amg:
3395 if (off == add_amg)
3396 force_scalar = 1;
3397 break;
3398 case dec_amg:
3399 if (off == subtr_amg)
3400 force_scalar = 1;
3401 break;
3402 /* in these cases, we're calling an assignment variant of an operator
3403 * (+= rather than +, for instance). regardless of whether it's a
3404 * fallback or not, it always has to return a value, which will be
3405 * assigned to the proper variable later */
3406 case add_amg:
3407 case subtr_amg:
3408 case mult_amg:
3409 case div_amg:
3410 case modulo_amg:
3411 case pow_amg:
3412 case lshift_amg:
3413 case rshift_amg:
3414 case repeat_amg:
3415 case concat_amg:
3416 case band_amg:
3417 case bor_amg:
3418 case bxor_amg:
6d06ecce
FC		 3419 case sband_amg:
3420 case sbor_amg:
3421 case sbxor_amg:
67288365
JL		 3422 if (assign)
3423 force_scalar = 1;
3424 break;
3425 /* the copy constructor always needs to return a value */
3426 case copy_amg:
3427 force_scalar = 1;
3428 break;
3429 /* because of the way these are implemented (they don't perform the
3430 * dereferencing themselves, they return a reference that perl then
3431 * dereferences later), they always have to be in scalar context */
3432 case to_sv_amg:
3433 case to_av_amg:
3434 case to_hv_amg:
3435 case to_gv_amg:
3436 case to_cv_amg:
3437 force_scalar = 1;
3438 break;
3439 /* these don't have an op of their own; they're triggered by their parent
3440 * op, so the context there isn't meaningful ('$a and foo()' in void
3441 * context still needs to pass scalar context on to $a's bool overload) */
3442 case bool__amg:
3443 case numer_amg:
3444 case string_amg:
3445 force_scalar = 1;
3446 break;
3447 }
3448
497b47a8 3449#ifdef DEBUGGING
a0d0e21e 3450 if (!notfound) {
497b47a8 3451 DEBUG_o(Perl_deb(aTHX_
147e3846 3452 "Overloaded operator \"%s\"%s%s%s:\n\tmethod%s found%s in package %" SVf "%s\n",
497b47a8
JH		 3453 AMG_id2name(off),
3454 method+assignshift==off? "" :
a0288114 3455 " (initially \"",
497b47a8
JH		 3456 method+assignshift==off? "" :
3457 AMG_id2name(method+assignshift),
a0288114 3458 method+assignshift==off? "" : "\")",
497b47a8
JH		 3459 flags & AMGf_unary? "" :
3460 lr==1 ? " for right argument": " for left argument",
3461 flags & AMGf_unary? " for argument" : "",
d66cca07 3462 stash ? SVfARG(sv_2mortal(newSVhek(HvNAME_HEK(stash)))) : SVfARG(newSVpvs_flags("null", SVs_TEMP)),
497b47a8 3463 fl? ",\n\tassignment variant used": "") );
ee239bfe 3464 }
497b47a8 3465#endif
748a9306
LW		 3466 /* Since we use shallow copy during assignment, we need
3467 * to dublicate the contents, probably calling user-supplied
3468 * version of copy operator
3469 */
ee239bfe
IZ		 3470 /* We need to copy in following cases:
3471 * a) Assignment form was called.
3472 * assignshift==1, assign==T, method + 1 == off
3473 * b) Increment or decrement, called directly.
3474 * assignshift==0, assign==0, method + 0 == off
3475 * c) Increment or decrement, translated to assignment add/subtr.
b267980d 3476 * assignshift==0, assign==T,
ee239bfe
IZ		 3477 * force_cpy == T
3478 * d) Increment or decrement, translated to nomethod.
b267980d 3479 * assignshift==0, assign==0,
ee239bfe
IZ		 3480 * force_cpy == T
3481 * e) Assignment form translated to nomethod.
3482 * assignshift==1, assign==T, method + 1 != off
3483 * force_cpy == T
3484 */
3485 /* off is method, method+assignshift, or a result of opcode substitution.
3486 * In the latter case assignshift==0, so only notfound case is important.
3487 */
73512201 3488 if ( (lr == -1) && ( ( (method + assignshift == off)
ee239bfe 3489 && (assign || (method == inc_amg) || (method == dec_amg)))
73512201 3490 || force_cpy) )
6f1401dc 3491 {
1b38c28e
NC		 3492 /* newSVsv does not behave as advertised, so we copy missing
3493 * information by hand */
3494 SV *tmpRef = SvRV(left);
3495 SV *rv_copy;
31d632c3 3496 if (SvREFCNT(tmpRef) > 1 && (rv_copy = AMG_CALLunary(left,copy_amg))) {
1b38c28e
NC		 3497 SvRV_set(left, rv_copy);
3498 SvSETMAGIC(left);
e7881358 3499 SvREFCNT_dec_NN(tmpRef);
1b38c28e 3500 }
6f1401dc
DM		 3501 }
3502
a0d0e21e
LW		 3503 {
3504 dSP;
3505 BINOP myop;
3506 SV* res;
b7787f18 3507 const bool oldcatch = CATCH_GET;
67288365 3508 I32 oldmark, nret;
e839e6ed
DM		 3509 /* for multiconcat, we may call overload several times,
3510 * with the context of individual concats being scalar,
3511 * regardless of the overall context of the multiconcat op
3512 */
3513 U8 gimme = (force_scalar || PL_op->op_type == OP_MULTICONCAT)
3514 ? G_SCALAR : GIMME_V;
a0d0e21e 3515
54310121 3516 CATCH_SET(TRUE);
a0d0e21e
LW		 3517 Zero(&myop, 1, BINOP);
3518 myop.op_last = (OP *) &myop;
b37c2d43 3519 myop.op_next = NULL;
67288365
JL		 3520 myop.op_flags = OPf_STACKED;
3521
3522 switch (gimme) {
3523 case G_VOID:
3524 myop.op_flags |= OPf_WANT_VOID;
3525 break;
3526 case G_ARRAY:
3527 if (flags & AMGf_want_list) {
3528 myop.op_flags |= OPf_WANT_LIST;
3529 break;
3530 }
3531 /* FALLTHROUGH */
3532 default:
3533 myop.op_flags |= OPf_WANT_SCALAR;
3534 break;
3535 }
a0d0e21e 3536
e788e7d3 3537 PUSHSTACKi(PERLSI_OVERLOAD);
a0d0e21e 3538 ENTER;
462e5cf6 3539 SAVEOP();
533c011a 3540 PL_op = (OP *) &myop;
3280af22 3541 if (PERLDB_SUB && PL_curstash != PL_debstash)
533c011a 3542 PL_op->op_private |= OPpENTERSUB_DB;
897d3989 3543 Perl_pp_pushmark(aTHX);
a0d0e21e 3544
924508f0 3545 EXTEND(SP, notfound + 5);
a0d0e21e
LW		 3546 PUSHs(lr>0? right: left);
3547 PUSHs(lr>0? left: right);
3280af22 3548 PUSHs( lr > 0 ? &PL_sv_yes : ( assign ? &PL_sv_undef : &PL_sv_no ));
a0d0e21e 3549 if (notfound) {
59cd0e26
NC		 3550 PUSHs(newSVpvn_flags(AMG_id2name(method + assignshift),
3551 AMG_id2namelen(method + assignshift), SVs_TEMP));
a0d0e21e 3552 }
636ac8fc
FC		 3553 else if (flags & AMGf_numarg)
3554 PUSHs(&PL_sv_undef);
3555 if (flags & AMGf_numarg)
3556 PUSHs(&PL_sv_yes);
ad64d0ec 3557 PUSHs(MUTABLE_SV(cv));
a0d0e21e 3558 PUTBACK;
67288365 3559 oldmark = TOPMARK;
a0d0e21e 3560
139d0ce6 3561 if ((PL_op = PL_ppaddr[OP_ENTERSUB](aTHX)))
cea2e8a9 3562 CALLRUNOPS(aTHX);
a0d0e21e
LW		 3563 LEAVE;
3564 SPAGAIN;
67288365
JL		 3565 nret = SP - (PL_stack_base + oldmark);
3566
3567 switch (gimme) {
3568 case G_VOID:
3569 /* returning NULL has another meaning, and we check the context
3570 * at the call site too, so this can be differentiated from the
3571 * scalar case */
3572 res = &PL_sv_undef;
3573 SP = PL_stack_base + oldmark;
3574 break;
2165bd23 3575 case G_ARRAY:
67288365
JL		 3576 if (flags & AMGf_want_list) {
3577 res = sv_2mortal((SV *)newAV());
3578 av_extend((AV *)res, nret);
3579 while (nret--)
3580 av_store((AV *)res, nret, POPs);
3581 break;
3582 }
3583 /* FALLTHROUGH */
67288365
JL		 3584 default:
3585 res = POPs;
3586 break;
3587 }
a0d0e21e 3588
ebafeae7 3589 PUTBACK;
d3acc0f7 3590 POPSTACK;
54310121 3591 CATCH_SET(oldcatch);
a0d0e21e 3592
a0d0e21e 3593 if (postpr) {
b7787f18 3594 int ans;
a0d0e21e
LW		 3595 switch (method) {
3596 case le_amg:
3597 case sle_amg:
3598 ans=SvIV(res)<=0; break;
3599 case lt_amg:
3600 case slt_amg:
3601 ans=SvIV(res)<0; break;
3602 case ge_amg:
3603 case sge_amg:
3604 ans=SvIV(res)>=0; break;
3605 case gt_amg:
3606 case sgt_amg:
3607 ans=SvIV(res)>0; break;
3608 case eq_amg:
3609 case seq_amg:
3610 ans=SvIV(res)==0; break;
3611 case ne_amg:
3612 case sne_amg:
3613 ans=SvIV(res)!=0; break;
3614 case inc_amg:
3615 case dec_amg:
bbce6d69 3616 SvSetSV(left,res); return left;
dc437b57 3617 case not_amg:
f4c975aa 3618 ans=!SvTRUE_NN(res); break;
b7787f18
AL		 3619 default:
3620 ans=0; break;
a0d0e21e 3621 }
54310121 3622 return boolSV(ans);
748a9306
LW		 3623 } else if (method==copy_amg) {
3624 if (!SvROK(res)) {
cea2e8a9 3625 Perl_croak(aTHX_ "Copy method did not return a reference");
748a9306
LW		 3626 }
3627 return SvREFCNT_inc(SvRV(res));
a0d0e21e
LW		 3628 } else {
3629 return res;
3630 }
3631 }
3632}
c9d5ac95 3633
f5c1e807
NC		 3634void
3635Perl_gv_name_set(pTHX_ GV *gv, const char *name, U32 len, U32 flags)
3636{
3637 dVAR;
acda4c6a 3638 U32 hash;
f5c1e807 3639
7918f24d 3640 PERL_ARGS_ASSERT_GV_NAME_SET;
f5c1e807 3641
acda4c6a 3642 if (len > I32_MAX)
147e3846 3643 Perl_croak(aTHX_ "panic: gv name too long (%" UVuf ")", (UV) len);
acda4c6a 3644
ae8cc45f
NC		 3645 if (!(flags & GV_ADD) && GvNAME_HEK(gv)) {
3646 unshare_hek(GvNAME_HEK(gv));
3647 }
3648
acda4c6a 3649 PERL_HASH(hash, name, len);
c60dbbc3 3650 GvNAME_HEK(gv) = share_hek(name, (flags & SVf_UTF8 ? -(I32)len : (I32)len), hash);
f5c1e807
NC		 3651}
3652
66610fdd 3653/*
f7461760
Z		 3654=for apidoc gv_try_downgrade
3655
2867cdbc
Z		 3656If the typeglob C<gv> can be expressed more succinctly, by having
3657something other than a real GV in its place in the stash, replace it
3658with the optimised form. Basic requirements for this are that C<gv>
3659is a real typeglob, is sufficiently ordinary, and is only referenced
3660from its package. This function is meant to be used when a GV has been
3661looked up in part to see what was there, causing upgrading, but based
3662on what was found it turns out that the real GV isn't required after all.
3663
3664If C<gv> is a completely empty typeglob, it is deleted from the stash.
3665
3666If C<gv> is a typeglob containing only a sufficiently-ordinary constant
3667sub, the typeglob is replaced with a scalar-reference placeholder that
3668more compactly represents the same thing.
f7461760
Z		 3669
3670=cut
3671*/
3672
3673void
3674Perl_gv_try_downgrade(pTHX_ GV *gv)
3675{
3676 HV *stash;
3677 CV *cv;
3678 HEK *namehek;
3679 SV **gvp;
3680 PERL_ARGS_ASSERT_GV_TRY_DOWNGRADE;
95f56751
FC		 3681
3682 /* XXX Why and where does this leave dangling pointers during global
3683 destruction? */
627364f1 3684 if (PL_phase == PERL_PHASE_DESTRUCT) return;
95f56751 3685
2867cdbc 3686 if (!(SvREFCNT(gv) == 1 && SvTYPE(gv) == SVt_PVGV && !SvFAKE(gv) &&
803f2748 3687 !SvOBJECT(gv) && !SvREADONLY(gv) &&
f7461760 3688 isGV_with_GP(gv) && GvGP(gv) &&
2867cdbc 3689 !GvINTRO(gv) && GvREFCNT(gv) == 1 &&
f7461760 3690 !GvSV(gv) && !GvAV(gv) && !GvHV(gv) && !GvIOp(gv) && !GvFORM(gv) &&
099be4f1 3691 GvEGVx(gv) == gv && (stash = GvSTASH(gv))))
2867cdbc 3692 return;
2be08ad1
FC		 3693 if (gv == PL_statgv || gv == PL_last_in_gv || gv == PL_stderrgv)
3694 return;
803f2748
DM		 3695 if (SvMAGICAL(gv)) {
3696 MAGIC *mg;
3697 /* only backref magic is allowed */
3698 if (SvGMAGICAL(gv) || SvSMAGICAL(gv))
3699 return;
3700 for (mg = SvMAGIC(gv); mg; mg = mg->mg_moremagic) {
3701 if (mg->mg_type != PERL_MAGIC_backref)
3702 return;
3703 }
3704 }
2867cdbc
Z		 3705 cv = GvCV(gv);
3706 if (!cv) {
3707 HEK *gvnhek = GvNAME_HEK(gv);
0ca9877d 3708 (void)hv_deletehek(stash, gvnhek, G_DISCARD);
8941bf97 3709 } else if (GvMULTI(gv) && cv && SvREFCNT(cv) == 1 &&
f7461760 3710 !SvOBJECT(cv) && !SvMAGICAL(cv) && !SvREADONLY(cv) &&
34d81fc4 3711 CvSTASH(cv) == stash && !CvNAMED(cv) && CvGV(cv) == gv &&
f7461760
Z		 3712 CvCONST(cv) && !CvMETHOD(cv) && !CvLVALUE(cv) && !CvUNIQUE(cv) &&
3713 !CvNODEBUG(cv) && !CvCLONE(cv) && !CvCLONED(cv) && !CvANON(cv) &&
3714 (namehek = GvNAME_HEK(gv)) &&
48c2c411 3715 (gvp = hv_fetchhek(stash, namehek, 0)) &&
f7461760
Z		 3716 *gvp == (SV*)gv) {
3717 SV *value = SvREFCNT_inc(CvXSUBANY(cv).any_ptr);
70e5f2b5 3718 const bool imported = !!GvIMPORTED_CV(gv);
f7461760
Z		 3719 SvREFCNT(gv) = 0;
3720 sv_clear((SV*)gv);
3721 SvREFCNT(gv) = 1;
70e5f2b5 3722 SvFLAGS(gv) = SVt_IV|SVf_ROK|SVprv_PCS_IMPORTED * imported;
dc6369ef
EH		 3723
3724 /* See also: 'SET_SVANY_FOR_BODYLESS_IV' in sv.c */
f7461760
Z		 3725 SvANY(gv) = (XPVGV*)((char*)&(gv->sv_u.svu_iv) -
3726 STRUCT_OFFSET(XPVIV, xiv_iv));
3727 SvRV_set(gv, value);
3728 }
3729}
3730
9e3fb20c
FC		 3731GV *
3732Perl_gv_override(pTHX_ const char * const name, const STRLEN len)
3733{
3734 GV *gv = gv_fetchpvn(name, len, GV_NOTQUAL, SVt_PVCV);
3735 GV * const *gvp;
3736 PERL_ARGS_ASSERT_GV_OVERRIDE;
3737 if (gv && GvCVu(gv) && GvIMPORTED_CV(gv)) return gv;
3738 gvp = (GV**)hv_fetch(PL_globalstash, name, len, FALSE);
3739 gv = gvp ? *gvp : NULL;
3740 if (gv && !isGV(gv)) {
3741 if (!SvPCS_IMPORTED(gv)) return NULL;
3742 gv_init(gv, PL_globalstash, name, len, 0);
3743 return gv;
3744 }
3745 return gv && GvCVu(gv) && GvIMPORTED_CV(gv) ? gv : NULL;
3746}
3747
4aaa4757
FC		 3748#include "XSUB.h"
3749
3750static void
3751core_xsub(pTHX_ CV* cv)
3752{
3753 Perl_croak(aTHX_
3754 "&CORE::%s cannot be called directly", GvNAME(CvGV(cv))
3755 );
3756}
3757
f7461760 3758/*
14d04a33 3759 * ex: set ts=8 sts=4 sw=4 et:
37442d52 3760 */
Unnamed repository; edit this file 'description' to name the repository.