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