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 TC |
18 | * |
19 | * [p.599 of _The Lord of the Rings_, III/xi: "The PalantÃr"] | |
79072805 LW |
20 | */ |
21 | ||
ccfc67b7 JH |
22 | /* |
23 | =head1 GV Functions | |
166f8a29 DM |
24 | |
25 | A GV is a structure which corresponds to to a Perl typeglob, ie *foo. | |
26 | It is a structure that holds a pointer to a scalar, an array, a hash etc, | |
27 | corresponding to $foo, @foo, %foo. | |
28 | ||
29 | GVs are usually found as values in stashes (symbol table hashes) where | |
30 | Perl stores its global variables. | |
31 | ||
32 | =cut | |
ccfc67b7 JH |
33 | */ |
34 | ||
79072805 | 35 | #include "EXTERN.h" |
864dbfa3 | 36 | #define PERL_IN_GV_C |
79072805 | 37 | #include "perl.h" |
8261f8eb | 38 | #include "overload.c" |
79072805 | 39 | |
f54cb97a AL |
40 | static const char S_autoload[] = "AUTOLOAD"; |
41 | static const STRLEN S_autolen = sizeof(S_autoload)-1; | |
5c7983e5 | 42 | |
c69033f2 | 43 | GV * |
d5713896 | 44 | Perl_gv_add_by_type(pTHX_ GV *gv, svtype type) |
c69033f2 | 45 | { |
d5713896 | 46 | SV **where; |
7918f24d | 47 | |
13be902c FC |
48 | if ( |
49 | !gv | |
50 | || ( | |
51 | SvTYPE((const SV *)gv) != SVt_PVGV | |
52 | && SvTYPE((const SV *)gv) != SVt_PVLV | |
53 | ) | |
54 | ) { | |
bb85b28a NC |
55 | const char *what; |
56 | if (type == SVt_PVIO) { | |
57 | /* | |
58 | * if it walks like a dirhandle, then let's assume that | |
59 | * this is a dirhandle. | |
60 | */ | |
61 | what = PL_op->op_type == OP_READDIR || | |
62 | PL_op->op_type == OP_TELLDIR || | |
63 | PL_op->op_type == OP_SEEKDIR || | |
64 | PL_op->op_type == OP_REWINDDIR || | |
65 | PL_op->op_type == OP_CLOSEDIR ? | |
66 | "dirhandle" : "filehandle"; | |
67 | /* diag_listed_as: Bad symbol for filehandle */ | |
68 | } else if (type == SVt_PVHV) { | |
69 | what = "hash"; | |
70 | } else { | |
71 | what = type == SVt_PVAV ? "array" : "scalar"; | |
72 | } | |
73 | Perl_croak(aTHX_ "Bad symbol for %s", what); | |
74 | } | |
d5713896 NC |
75 | |
76 | if (type == SVt_PVHV) { | |
77 | where = (SV **)&GvHV(gv); | |
78 | } else if (type == SVt_PVAV) { | |
79 | where = (SV **)&GvAV(gv); | |
bb85b28a NC |
80 | } else if (type == SVt_PVIO) { |
81 | where = (SV **)&GvIOp(gv); | |
d5713896 NC |
82 | } else { |
83 | where = &GvSV(gv); | |
84 | } | |
7918f24d | 85 | |
d5713896 NC |
86 | if (!*where) |
87 | *where = newSV_type(type); | |
79072805 LW |
88 | return gv; |
89 | } | |
90 | ||
91 | GV * | |
864dbfa3 | 92 | Perl_gv_fetchfile(pTHX_ const char *name) |
79072805 | 93 | { |
7918f24d | 94 | PERL_ARGS_ASSERT_GV_FETCHFILE; |
d9095cec NC |
95 | return gv_fetchfile_flags(name, strlen(name), 0); |
96 | } | |
97 | ||
98 | GV * | |
99 | Perl_gv_fetchfile_flags(pTHX_ const char *const name, const STRLEN namelen, | |
100 | const U32 flags) | |
101 | { | |
97aff369 | 102 | dVAR; |
4116122e | 103 | char smallbuf[128]; |
53d95988 | 104 | char *tmpbuf; |
d9095cec | 105 | const STRLEN tmplen = namelen + 2; |
79072805 LW |
106 | GV *gv; |
107 | ||
7918f24d | 108 | PERL_ARGS_ASSERT_GV_FETCHFILE_FLAGS; |
d9095cec NC |
109 | PERL_UNUSED_ARG(flags); |
110 | ||
1d7c1841 | 111 | if (!PL_defstash) |
a0714e2c | 112 | return NULL; |
1d7c1841 | 113 | |
d9095cec | 114 | if (tmplen <= sizeof smallbuf) |
53d95988 CS |
115 | tmpbuf = smallbuf; |
116 | else | |
798b63bc | 117 | Newx(tmpbuf, tmplen, char); |
0ac0412a | 118 | /* This is where the debugger's %{"::_<$filename"} hash is created */ |
53d95988 CS |
119 | tmpbuf[0] = '_'; |
120 | tmpbuf[1] = '<'; | |
d9095cec NC |
121 | memcpy(tmpbuf + 2, name, namelen); |
122 | gv = *(GV**)hv_fetch(PL_defstash, tmpbuf, tmplen, TRUE); | |
1d7c1841 | 123 | if (!isGV(gv)) { |
d9095cec | 124 | gv_init(gv, PL_defstash, tmpbuf, tmplen, FALSE); |
c69033f2 | 125 | #ifdef PERL_DONT_CREATE_GVSV |
d9095cec | 126 | GvSV(gv) = newSVpvn(name, namelen); |
c69033f2 | 127 | #else |
d9095cec | 128 | sv_setpvn(GvSV(gv), name, namelen); |
c69033f2 | 129 | #endif |
1d7c1841 | 130 | } |
5a9a79a4 FC |
131 | if ((PERLDB_LINE || PERLDB_SAVESRC) && !GvAV(gv)) |
132 | hv_magic(GvHVn(gv_AVadd(gv)), NULL, PERL_MAGIC_dbfile); | |
53d95988 CS |
133 | if (tmpbuf != smallbuf) |
134 | Safefree(tmpbuf); | |
79072805 LW |
135 | return gv; |
136 | } | |
137 | ||
62d55b22 NC |
138 | /* |
139 | =for apidoc gv_const_sv | |
140 | ||
141 | If C<gv> is a typeglob whose subroutine entry is a constant sub eligible for | |
142 | inlining, or C<gv> is a placeholder reference that would be promoted to such | |
143 | a typeglob, then returns the value returned by the sub. Otherwise, returns | |
144 | NULL. | |
145 | ||
146 | =cut | |
147 | */ | |
148 | ||
149 | SV * | |
150 | Perl_gv_const_sv(pTHX_ GV *gv) | |
151 | { | |
7918f24d NC |
152 | PERL_ARGS_ASSERT_GV_CONST_SV; |
153 | ||
62d55b22 NC |
154 | if (SvTYPE(gv) == SVt_PVGV) |
155 | return cv_const_sv(GvCVu(gv)); | |
156 | return SvROK(gv) ? SvRV(gv) : NULL; | |
157 | } | |
158 | ||
12816592 NC |
159 | GP * |
160 | Perl_newGP(pTHX_ GV *const gv) | |
161 | { | |
162 | GP *gp; | |
19bad673 NC |
163 | U32 hash; |
164 | #ifdef USE_ITHREADS | |
1df5f7c1 NC |
165 | const char *const file |
166 | = (PL_curcop && CopFILE(PL_curcop)) ? CopFILE(PL_curcop) : ""; | |
19bad673 NC |
167 | const STRLEN len = strlen(file); |
168 | #else | |
169 | SV *const temp_sv = CopFILESV(PL_curcop); | |
170 | const char *file; | |
171 | STRLEN len; | |
172 | ||
7918f24d NC |
173 | PERL_ARGS_ASSERT_NEWGP; |
174 | ||
19bad673 NC |
175 | if (temp_sv) { |
176 | file = SvPVX(temp_sv); | |
177 | len = SvCUR(temp_sv); | |
178 | } else { | |
179 | file = ""; | |
180 | len = 0; | |
181 | } | |
182 | #endif | |
f4890806 NC |
183 | |
184 | PERL_HASH(hash, file, len); | |
185 | ||
12816592 NC |
186 | Newxz(gp, 1, GP); |
187 | ||
188 | #ifndef PERL_DONT_CREATE_GVSV | |
b5c2dcb8 | 189 | gp->gp_sv = newSV(0); |
12816592 NC |
190 | #endif |
191 | ||
1df5f7c1 | 192 | gp->gp_line = PL_curcop ? CopLINE(PL_curcop) : 0; |
12816592 NC |
193 | /* XXX Ideally this cast would be replaced with a change to const char* |
194 | in the struct. */ | |
f4890806 | 195 | gp->gp_file_hek = share_hek(file, len, hash); |
12816592 NC |
196 | gp->gp_egv = gv; |
197 | gp->gp_refcnt = 1; | |
198 | ||
199 | return gp; | |
200 | } | |
201 | ||
803f2748 DM |
202 | /* Assign CvGV(cv) = gv, handling weak references. |
203 | * See also S_anonymise_cv_maybe */ | |
204 | ||
205 | void | |
206 | Perl_cvgv_set(pTHX_ CV* cv, GV* gv) | |
207 | { | |
208 | GV * const oldgv = CvGV(cv); | |
209 | PERL_ARGS_ASSERT_CVGV_SET; | |
210 | ||
211 | if (oldgv == gv) | |
212 | return; | |
213 | ||
214 | if (oldgv) { | |
cfc1e951 | 215 | if (CvCVGV_RC(cv)) { |
803f2748 | 216 | SvREFCNT_dec(oldgv); |
cfc1e951 DM |
217 | CvCVGV_RC_off(cv); |
218 | } | |
803f2748 | 219 | else { |
803f2748 DM |
220 | sv_del_backref(MUTABLE_SV(oldgv), MUTABLE_SV(cv)); |
221 | } | |
222 | } | |
223 | ||
b3f91e91 | 224 | SvANY(cv)->xcv_gv = gv; |
c794ca97 | 225 | assert(!CvCVGV_RC(cv)); |
803f2748 DM |
226 | |
227 | if (!gv) | |
228 | return; | |
229 | ||
c794ca97 DM |
230 | if (isGV_with_GP(gv) && GvGP(gv) && (GvCV(gv) == cv || GvFORM(gv) == cv)) |
231 | Perl_sv_add_backref(aTHX_ MUTABLE_SV(gv), MUTABLE_SV(cv)); | |
232 | else { | |
cfc1e951 | 233 | CvCVGV_RC_on(cv); |
803f2748 DM |
234 | SvREFCNT_inc_simple_void_NN(gv); |
235 | } | |
803f2748 DM |
236 | } |
237 | ||
c68d9564 Z |
238 | /* Assign CvSTASH(cv) = st, handling weak references. */ |
239 | ||
240 | void | |
241 | Perl_cvstash_set(pTHX_ CV *cv, HV *st) | |
242 | { | |
243 | HV *oldst = CvSTASH(cv); | |
244 | PERL_ARGS_ASSERT_CVSTASH_SET; | |
245 | if (oldst == st) | |
246 | return; | |
247 | if (oldst) | |
248 | sv_del_backref(MUTABLE_SV(oldst), MUTABLE_SV(cv)); | |
249 | SvANY(cv)->xcv_stash = st; | |
250 | if (st) | |
251 | Perl_sv_add_backref(aTHX_ MUTABLE_SV(st), MUTABLE_SV(cv)); | |
252 | } | |
803f2748 | 253 | |
463ee0b2 | 254 | void |
864dbfa3 | 255 | Perl_gv_init(pTHX_ GV *gv, HV *stash, const char *name, STRLEN len, int multi) |
463ee0b2 | 256 | { |
27da23d5 | 257 | dVAR; |
3b6733bf NC |
258 | const U32 old_type = SvTYPE(gv); |
259 | const bool doproto = old_type > SVt_NULL; | |
024963f8 | 260 | char * const proto = (doproto && SvPOK(gv)) ? SvPVX(gv) : NULL; |
49a54bbe | 261 | const STRLEN protolen = proto ? SvCUR(gv) : 0; |
756cb477 | 262 | SV *const has_constant = doproto && SvROK(gv) ? SvRV(gv) : NULL; |
1ccdb730 | 263 | const U32 exported_constant = has_constant ? SvPCS_IMPORTED(gv) : 0; |
756cb477 | 264 | |
7918f24d | 265 | PERL_ARGS_ASSERT_GV_INIT; |
756cb477 NC |
266 | assert (!(proto && has_constant)); |
267 | ||
268 | if (has_constant) { | |
5c1f4d79 NC |
269 | /* The constant has to be a simple scalar type. */ |
270 | switch (SvTYPE(has_constant)) { | |
271 | case SVt_PVAV: | |
272 | case SVt_PVHV: | |
273 | case SVt_PVCV: | |
274 | case SVt_PVFM: | |
275 | case SVt_PVIO: | |
276 | Perl_croak(aTHX_ "Cannot convert a reference to %s to typeglob", | |
277 | sv_reftype(has_constant, 0)); | |
42d0e0b7 | 278 | default: NOOP; |
5c1f4d79 | 279 | } |
756cb477 NC |
280 | SvRV_set(gv, NULL); |
281 | SvROK_off(gv); | |
282 | } | |
463ee0b2 | 283 | |
3b6733bf NC |
284 | |
285 | if (old_type < SVt_PVGV) { | |
286 | if (old_type >= SVt_PV) | |
287 | SvCUR_set(gv, 0); | |
ad64d0ec | 288 | sv_upgrade(MUTABLE_SV(gv), SVt_PVGV); |
3b6733bf | 289 | } |
55d729e4 GS |
290 | if (SvLEN(gv)) { |
291 | if (proto) { | |
f880fe2f | 292 | SvPV_set(gv, NULL); |
b162af07 | 293 | SvLEN_set(gv, 0); |
55d729e4 GS |
294 | SvPOK_off(gv); |
295 | } else | |
94010e71 | 296 | Safefree(SvPVX_mutable(gv)); |
55d729e4 | 297 | } |
2e5b91de NC |
298 | SvIOK_off(gv); |
299 | isGV_with_GP_on(gv); | |
12816592 NC |
300 | |
301 | GvGP(gv) = Perl_newGP(aTHX_ gv); | |
e15faf7d NC |
302 | GvSTASH(gv) = stash; |
303 | if (stash) | |
ad64d0ec | 304 | Perl_sv_add_backref(aTHX_ MUTABLE_SV(stash), MUTABLE_SV(gv)); |
ae8cc45f | 305 | gv_name_set(gv, name, len, GV_ADD); |
23ad5bf5 | 306 | if (multi || doproto) /* doproto means it _was_ mentioned */ |
a5f75d66 | 307 | GvMULTI_on(gv); |
55d729e4 | 308 | if (doproto) { /* Replicate part of newSUB here. */ |
e3d2b9e7 | 309 | CV *cv; |
55d729e4 | 310 | ENTER; |
756cb477 | 311 | if (has_constant) { |
e5c69c9b DM |
312 | char *name0 = NULL; |
313 | if (name[len]) | |
314 | /* newCONSTSUB doesn't take a len arg, so make sure we | |
315 | * give it a \0-terminated string */ | |
316 | name0 = savepvn(name,len); | |
317 | ||
756cb477 | 318 | /* newCONSTSUB takes ownership of the reference from us. */ |
e5c69c9b | 319 | cv = newCONSTSUB(stash, (name0 ? name0 : name), has_constant); |
75bd28cf FC |
320 | /* In case op.c:S_process_special_blocks stole it: */ |
321 | if (!GvCV(gv)) | |
55a80fa0 | 322 | GvCV(gv) = (CV *)SvREFCNT_inc_simple_NN(cv); |
439cdf38 | 323 | assert(GvCV(gv) == cv); /* newCONSTSUB should have set this */ |
e5c69c9b DM |
324 | if (name0) |
325 | Safefree(name0); | |
1ccdb730 NC |
326 | /* If this reference was a copy of another, then the subroutine |
327 | must have been "imported", by a Perl space assignment to a GV | |
328 | from a reference to CV. */ | |
329 | if (exported_constant) | |
330 | GvIMPORTED_CV_on(gv); | |
756cb477 | 331 | } else { |
756cb477 | 332 | (void) start_subparse(0,0); /* Create empty CV in compcv. */ |
e3d2b9e7 | 333 | cv = PL_compcv; |
439cdf38 | 334 | GvCV(gv) = cv; |
756cb477 | 335 | } |
55d729e4 GS |
336 | LEAVE; |
337 | ||
e1a479c5 | 338 | mro_method_changed_in(GvSTASH(gv)); /* sub Foo::bar($) { (shift) } sub ASDF::baz($); *ASDF::baz = \&Foo::bar */ |
b3f91e91 | 339 | CvGV_set(cv, gv); |
e3d2b9e7 | 340 | CvFILE_set_from_cop(cv, PL_curcop); |
c68d9564 | 341 | CvSTASH_set(cv, PL_curstash); |
55d729e4 | 342 | if (proto) { |
e3d2b9e7 | 343 | sv_usepvn_flags(MUTABLE_SV(cv), proto, protolen, |
49a54bbe | 344 | SV_HAS_TRAILING_NUL); |
55d729e4 GS |
345 | } |
346 | } | |
463ee0b2 LW |
347 | } |
348 | ||
76e3520e | 349 | STATIC void |
fe9845cc | 350 | S_gv_init_sv(pTHX_ GV *gv, const svtype sv_type) |
a0d0e21e | 351 | { |
7918f24d NC |
352 | PERL_ARGS_ASSERT_GV_INIT_SV; |
353 | ||
a0d0e21e LW |
354 | switch (sv_type) { |
355 | case SVt_PVIO: | |
356 | (void)GvIOn(gv); | |
357 | break; | |
358 | case SVt_PVAV: | |
359 | (void)GvAVn(gv); | |
360 | break; | |
361 | case SVt_PVHV: | |
362 | (void)GvHVn(gv); | |
363 | break; | |
c69033f2 NC |
364 | #ifdef PERL_DONT_CREATE_GVSV |
365 | case SVt_NULL: | |
366 | case SVt_PVCV: | |
367 | case SVt_PVFM: | |
e654831b | 368 | case SVt_PVGV: |
c69033f2 NC |
369 | break; |
370 | default: | |
dbdce04c NC |
371 | if(GvSVn(gv)) { |
372 | /* Work round what appears to be a bug in Sun C++ 5.8 2005/10/13 | |
373 | If we just cast GvSVn(gv) to void, it ignores evaluating it for | |
374 | its side effect */ | |
375 | } | |
c69033f2 | 376 | #endif |
a0d0e21e LW |
377 | } |
378 | } | |
379 | ||
954c1994 GS |
380 | /* |
381 | =for apidoc gv_fetchmeth | |
382 | ||
383 | Returns the glob with the given C<name> and a defined subroutine or | |
384 | C<NULL>. The glob lives in the given C<stash>, or in the stashes | |
07766739 | 385 | accessible via @ISA and UNIVERSAL::. |
954c1994 GS |
386 | |
387 | The argument C<level> should be either 0 or -1. If C<level==0>, as a | |
388 | side-effect creates a glob with the given C<name> in the given C<stash> | |
389 | which in the case of success contains an alias for the subroutine, and sets | |
e1a479c5 | 390 | up caching info for this glob. |
954c1994 GS |
391 | |
392 | This function grants C<"SUPER"> token as a postfix of the stash name. The | |
393 | GV returned from C<gv_fetchmeth> may be a method cache entry, which is not | |
4929bf7b | 394 | visible to Perl code. So when calling C<call_sv>, you should not use |
954c1994 | 395 | the GV directly; instead, you should use the method's CV, which can be |
b267980d | 396 | obtained from the GV with the C<GvCV> macro. |
954c1994 GS |
397 | |
398 | =cut | |
399 | */ | |
400 | ||
e1a479c5 BB |
401 | /* NOTE: No support for tied ISA */ |
402 | ||
79072805 | 403 | GV * |
864dbfa3 | 404 | Perl_gv_fetchmeth(pTHX_ HV *stash, const char *name, STRLEN len, I32 level) |
79072805 | 405 | { |
97aff369 | 406 | dVAR; |
463ee0b2 | 407 | GV** gvp; |
e1a479c5 BB |
408 | AV* linear_av; |
409 | SV** linear_svp; | |
410 | SV* linear_sv; | |
411 | HV* cstash; | |
412 | GV* candidate = NULL; | |
413 | CV* cand_cv = NULL; | |
414 | CV* old_cv; | |
415 | GV* topgv = NULL; | |
bfcb3514 | 416 | const char *hvname; |
e1a479c5 BB |
417 | I32 create = (level >= 0) ? 1 : 0; |
418 | I32 items; | |
419 | STRLEN packlen; | |
420 | U32 topgen_cmp; | |
a0d0e21e | 421 | |
7918f24d NC |
422 | PERL_ARGS_ASSERT_GV_FETCHMETH; |
423 | ||
af09ea45 IK |
424 | /* UNIVERSAL methods should be callable without a stash */ |
425 | if (!stash) { | |
e1a479c5 | 426 | create = 0; /* probably appropriate */ |
da51bb9b | 427 | if(!(stash = gv_stashpvs("UNIVERSAL", 0))) |
af09ea45 IK |
428 | return 0; |
429 | } | |
430 | ||
e1a479c5 BB |
431 | assert(stash); |
432 | ||
bfcb3514 NC |
433 | hvname = HvNAME_get(stash); |
434 | if (!hvname) | |
e1a479c5 | 435 | Perl_croak(aTHX_ "Can't use anonymous symbol table for method lookup"); |
e27ad1f2 | 436 | |
e1a479c5 BB |
437 | assert(hvname); |
438 | assert(name); | |
463ee0b2 | 439 | |
bfcb3514 | 440 | DEBUG_o( Perl_deb(aTHX_ "Looking for method %s in package %s\n",name,hvname) ); |
44a8e56a | 441 | |
dd69841b | 442 | topgen_cmp = HvMROMETA(stash)->cache_gen + PL_sub_generation; |
e1a479c5 BB |
443 | |
444 | /* check locally for a real method or a cache entry */ | |
445 | gvp = (GV**)hv_fetch(stash, name, len, create); | |
446 | if(gvp) { | |
447 | topgv = *gvp; | |
448 | assert(topgv); | |
449 | if (SvTYPE(topgv) != SVt_PVGV) | |
450 | gv_init(topgv, stash, name, len, TRUE); | |
451 | if ((cand_cv = GvCV(topgv))) { | |
452 | /* If genuine method or valid cache entry, use it */ | |
453 | if (!GvCVGEN(topgv) || GvCVGEN(topgv) == topgen_cmp) { | |
454 | return topgv; | |
455 | } | |
456 | else { | |
457 | /* stale cache entry, junk it and move on */ | |
458 | SvREFCNT_dec(cand_cv); | |
459 | GvCV(topgv) = cand_cv = NULL; | |
460 | GvCVGEN(topgv) = 0; | |
461 | } | |
462 | } | |
463 | else if (GvCVGEN(topgv) == topgen_cmp) { | |
464 | /* cache indicates no such method definitively */ | |
465 | return 0; | |
466 | } | |
463ee0b2 | 467 | } |
79072805 | 468 | |
e1a479c5 BB |
469 | packlen = HvNAMELEN_get(stash); |
470 | if (packlen >= 7 && strEQ(hvname + packlen - 7, "::SUPER")) { | |
471 | HV* basestash; | |
472 | packlen -= 7; | |
473 | basestash = gv_stashpvn(hvname, packlen, GV_ADD); | |
474 | linear_av = mro_get_linear_isa(basestash); | |
9607fc9c | 475 | } |
e1a479c5 BB |
476 | else { |
477 | linear_av = mro_get_linear_isa(stash); /* has ourselves at the top of the list */ | |
79072805 | 478 | } |
a0d0e21e | 479 | |
e1a479c5 BB |
480 | linear_svp = AvARRAY(linear_av) + 1; /* skip over self */ |
481 | items = AvFILLp(linear_av); /* no +1, to skip over self */ | |
482 | while (items--) { | |
483 | linear_sv = *linear_svp++; | |
484 | assert(linear_sv); | |
485 | cstash = gv_stashsv(linear_sv, 0); | |
486 | ||
dd69841b | 487 | if (!cstash) { |
a2a5de95 NC |
488 | Perl_ck_warner(aTHX_ packWARN(WARN_SYNTAX), "Can't locate package %"SVf" for @%s::ISA", |
489 | SVfARG(linear_sv), hvname); | |
e1a479c5 BB |
490 | continue; |
491 | } | |
9607fc9c | 492 | |
e1a479c5 BB |
493 | assert(cstash); |
494 | ||
495 | gvp = (GV**)hv_fetch(cstash, name, len, 0); | |
496 | if (!gvp) continue; | |
497 | candidate = *gvp; | |
498 | assert(candidate); | |
499 | if (SvTYPE(candidate) != SVt_PVGV) gv_init(candidate, cstash, name, len, TRUE); | |
500 | if (SvTYPE(candidate) == SVt_PVGV && (cand_cv = GvCV(candidate)) && !GvCVGEN(candidate)) { | |
501 | /* | |
502 | * Found real method, cache method in topgv if: | |
503 | * 1. topgv has no synonyms (else inheritance crosses wires) | |
504 | * 2. method isn't a stub (else AUTOLOAD fails spectacularly) | |
505 | */ | |
506 | if (topgv && (GvREFCNT(topgv) == 1) && (CvROOT(cand_cv) || CvXSUB(cand_cv))) { | |
507 | if ((old_cv = GvCV(topgv))) SvREFCNT_dec(old_cv); | |
508 | SvREFCNT_inc_simple_void_NN(cand_cv); | |
509 | GvCV(topgv) = cand_cv; | |
510 | GvCVGEN(topgv) = topgen_cmp; | |
511 | } | |
512 | return candidate; | |
513 | } | |
514 | } | |
9607fc9c | 515 | |
e1a479c5 BB |
516 | /* Check UNIVERSAL without caching */ |
517 | if(level == 0 || level == -1) { | |
518 | candidate = gv_fetchmeth(NULL, name, len, 1); | |
519 | if(candidate) { | |
520 | cand_cv = GvCV(candidate); | |
521 | if (topgv && (GvREFCNT(topgv) == 1) && (CvROOT(cand_cv) || CvXSUB(cand_cv))) { | |
522 | if ((old_cv = GvCV(topgv))) SvREFCNT_dec(old_cv); | |
523 | SvREFCNT_inc_simple_void_NN(cand_cv); | |
524 | GvCV(topgv) = cand_cv; | |
525 | GvCVGEN(topgv) = topgen_cmp; | |
526 | } | |
527 | return candidate; | |
528 | } | |
529 | } | |
530 | ||
531 | if (topgv && GvREFCNT(topgv) == 1) { | |
532 | /* cache the fact that the method is not defined */ | |
533 | GvCVGEN(topgv) = topgen_cmp; | |
a0d0e21e LW |
534 | } |
535 | ||
79072805 LW |
536 | return 0; |
537 | } | |
538 | ||
954c1994 | 539 | /* |
611c1e95 IZ |
540 | =for apidoc gv_fetchmeth_autoload |
541 | ||
542 | Same as gv_fetchmeth(), but looks for autoloaded subroutines too. | |
543 | Returns a glob for the subroutine. | |
544 | ||
545 | For an autoloaded subroutine without a GV, will create a GV even | |
546 | if C<level < 0>. For an autoloaded subroutine without a stub, GvCV() | |
547 | of the result may be zero. | |
548 | ||
549 | =cut | |
550 | */ | |
551 | ||
552 | GV * | |
553 | Perl_gv_fetchmeth_autoload(pTHX_ HV *stash, const char *name, STRLEN len, I32 level) | |
554 | { | |
555 | GV *gv = gv_fetchmeth(stash, name, len, level); | |
556 | ||
7918f24d NC |
557 | PERL_ARGS_ASSERT_GV_FETCHMETH_AUTOLOAD; |
558 | ||
611c1e95 | 559 | if (!gv) { |
611c1e95 IZ |
560 | CV *cv; |
561 | GV **gvp; | |
562 | ||
563 | if (!stash) | |
6136c704 | 564 | return NULL; /* UNIVERSAL::AUTOLOAD could cause trouble */ |
7edbdc6b | 565 | if (len == S_autolen && memEQ(name, S_autoload, S_autolen)) |
6136c704 | 566 | return NULL; |
5c7983e5 | 567 | if (!(gv = gv_fetchmeth(stash, S_autoload, S_autolen, FALSE))) |
6136c704 | 568 | return NULL; |
611c1e95 IZ |
569 | cv = GvCV(gv); |
570 | if (!(CvROOT(cv) || CvXSUB(cv))) | |
6136c704 | 571 | return NULL; |
611c1e95 IZ |
572 | /* Have an autoload */ |
573 | if (level < 0) /* Cannot do without a stub */ | |
574 | gv_fetchmeth(stash, name, len, 0); | |
575 | gvp = (GV**)hv_fetch(stash, name, len, (level >= 0)); | |
576 | if (!gvp) | |
6136c704 | 577 | return NULL; |
611c1e95 IZ |
578 | return *gvp; |
579 | } | |
580 | return gv; | |
581 | } | |
582 | ||
583 | /* | |
954c1994 GS |
584 | =for apidoc gv_fetchmethod_autoload |
585 | ||
586 | Returns the glob which contains the subroutine to call to invoke the method | |
587 | on the C<stash>. In fact in the presence of autoloading this may be the | |
588 | glob for "AUTOLOAD". In this case the corresponding variable $AUTOLOAD is | |
b267980d | 589 | already setup. |
954c1994 GS |
590 | |
591 | The third parameter of C<gv_fetchmethod_autoload> determines whether | |
592 | AUTOLOAD lookup is performed if the given method is not present: non-zero | |
b267980d | 593 | means yes, look for AUTOLOAD; zero means no, don't look for AUTOLOAD. |
954c1994 | 594 | Calling C<gv_fetchmethod> is equivalent to calling C<gv_fetchmethod_autoload> |
b267980d | 595 | with a non-zero C<autoload> parameter. |
954c1994 GS |
596 | |
597 | These functions grant C<"SUPER"> token as a prefix of the method name. Note | |
598 | that if you want to keep the returned glob for a long time, you need to | |
599 | check for it being "AUTOLOAD", since at the later time the call may load a | |
600 | different subroutine due to $AUTOLOAD changing its value. Use the glob | |
b267980d | 601 | created via a side effect to do this. |
954c1994 GS |
602 | |
603 | These functions have the same side-effects and as C<gv_fetchmeth> with | |
604 | C<level==0>. C<name> should be writable if contains C<':'> or C<' | |
605 | ''>. The warning against passing the GV returned by C<gv_fetchmeth> to | |
b267980d | 606 | C<call_sv> apply equally to these functions. |
954c1994 GS |
607 | |
608 | =cut | |
609 | */ | |
610 | ||
7d3b1f61 BB |
611 | STATIC HV* |
612 | S_gv_get_super_pkg(pTHX_ const char* name, I32 namelen) | |
613 | { | |
614 | AV* superisa; | |
615 | GV** gvp; | |
616 | GV* gv; | |
617 | HV* stash; | |
618 | ||
7918f24d NC |
619 | PERL_ARGS_ASSERT_GV_GET_SUPER_PKG; |
620 | ||
7d3b1f61 BB |
621 | stash = gv_stashpvn(name, namelen, 0); |
622 | if(stash) return stash; | |
623 | ||
624 | /* If we must create it, give it an @ISA array containing | |
625 | the real package this SUPER is for, so that it's tied | |
626 | into the cache invalidation code correctly */ | |
627 | stash = gv_stashpvn(name, namelen, GV_ADD); | |
628 | gvp = (GV**)hv_fetchs(stash, "ISA", TRUE); | |
629 | gv = *gvp; | |
630 | gv_init(gv, stash, "ISA", 3, TRUE); | |
631 | superisa = GvAVn(gv); | |
632 | GvMULTI_on(gv); | |
ad64d0ec | 633 | sv_magic(MUTABLE_SV(superisa), MUTABLE_SV(gv), PERL_MAGIC_isa, NULL, 0); |
8e3a4a30 | 634 | #ifdef USE_ITHREADS |
7d3b1f61 | 635 | av_push(superisa, newSVpv(CopSTASHPV(PL_curcop), 0)); |
8e3a4a30 NC |
636 | #else |
637 | av_push(superisa, newSVhek(CopSTASH(PL_curcop) | |
638 | ? HvNAME_HEK(CopSTASH(PL_curcop)) : NULL)); | |
639 | #endif | |
7d3b1f61 BB |
640 | |
641 | return stash; | |
642 | } | |
643 | ||
dc848c6f | 644 | GV * |
864dbfa3 | 645 | Perl_gv_fetchmethod_autoload(pTHX_ HV *stash, const char *name, I32 autoload) |
dc848c6f | 646 | { |
547bb267 NC |
647 | PERL_ARGS_ASSERT_GV_FETCHMETHOD_AUTOLOAD; |
648 | ||
256d1bb2 NC |
649 | return gv_fetchmethod_flags(stash, name, autoload ? GV_AUTOLOAD : 0); |
650 | } | |
651 | ||
652 | /* Don't merge this yet, as it's likely to get a len parameter, and possibly | |
653 | even a U32 hash */ | |
654 | GV * | |
655 | Perl_gv_fetchmethod_flags(pTHX_ HV *stash, const char *name, U32 flags) | |
656 | { | |
97aff369 | 657 | dVAR; |
08105a92 | 658 | register const char *nend; |
c445ea15 | 659 | const char *nsplit = NULL; |
a0d0e21e | 660 | GV* gv; |
0dae17bd | 661 | HV* ostash = stash; |
c94593d0 | 662 | const char * const origname = name; |
ad64d0ec | 663 | SV *const error_report = MUTABLE_SV(stash); |
256d1bb2 NC |
664 | const U32 autoload = flags & GV_AUTOLOAD; |
665 | const U32 do_croak = flags & GV_CROAK; | |
0dae17bd | 666 | |
547bb267 | 667 | PERL_ARGS_ASSERT_GV_FETCHMETHOD_FLAGS; |
7918f24d | 668 | |
eff494dd | 669 | if (SvTYPE(stash) < SVt_PVHV) |
5c284bb0 | 670 | stash = NULL; |
c9bf4021 NC |
671 | else { |
672 | /* The only way stash can become NULL later on is if nsplit is set, | |
673 | which in turn means that there is no need for a SVt_PVHV case | |
674 | the error reporting code. */ | |
675 | } | |
b267980d | 676 | |
463ee0b2 | 677 | for (nend = name; *nend; nend++) { |
c94593d0 | 678 | if (*nend == '\'') { |
a0d0e21e | 679 | nsplit = nend; |
c94593d0 NC |
680 | name = nend + 1; |
681 | } | |
682 | else if (*nend == ':' && *(nend + 1) == ':') { | |
683 | nsplit = nend++; | |
684 | name = nend + 1; | |
685 | } | |
a0d0e21e LW |
686 | } |
687 | if (nsplit) { | |
7edbdc6b | 688 | if ((nsplit - origname) == 5 && memEQ(origname, "SUPER", 5)) { |
9607fc9c | 689 | /* ->SUPER::method should really be looked up in original stash */ |
b37c2d43 | 690 | SV * const tmpstr = sv_2mortal(Perl_newSVpvf(aTHX_ "%s::SUPER", |
1d7c1841 | 691 | CopSTASHPV(PL_curcop))); |
af09ea45 | 692 | /* __PACKAGE__::SUPER stash should be autovivified */ |
7d3b1f61 | 693 | stash = gv_get_super_pkg(SvPVX_const(tmpstr), SvCUR(tmpstr)); |
cea2e8a9 | 694 | DEBUG_o( Perl_deb(aTHX_ "Treating %s as %s::%s\n", |
bfcb3514 | 695 | origname, HvNAME_get(stash), name) ); |
4633a7c4 | 696 | } |
e189a56d | 697 | else { |
af09ea45 | 698 | /* don't autovifify if ->NoSuchStash::method */ |
da51bb9b | 699 | stash = gv_stashpvn(origname, nsplit - origname, 0); |
e189a56d IK |
700 | |
701 | /* however, explicit calls to Pkg::SUPER::method may | |
702 | happen, and may require autovivification to work */ | |
703 | if (!stash && (nsplit - origname) >= 7 && | |
704 | strnEQ(nsplit - 7, "::SUPER", 7) && | |
da51bb9b | 705 | gv_stashpvn(origname, nsplit - origname - 7, 0)) |
7d3b1f61 | 706 | stash = gv_get_super_pkg(origname, nsplit - origname); |
e189a56d | 707 | } |
0dae17bd | 708 | ostash = stash; |
4633a7c4 LW |
709 | } |
710 | ||
9607fc9c | 711 | gv = gv_fetchmeth(stash, name, nend - name, 0); |
a0d0e21e | 712 | if (!gv) { |
2f6e0fe7 | 713 | if (strEQ(name,"import") || strEQ(name,"unimport")) |
159b6efe | 714 | gv = MUTABLE_GV(&PL_sv_yes); |
dc848c6f | 715 | else if (autoload) |
0dae17bd | 716 | gv = gv_autoload4(ostash, name, nend - name, TRUE); |
256d1bb2 NC |
717 | if (!gv && do_croak) { |
718 | /* Right now this is exclusively for the benefit of S_method_common | |
719 | in pp_hot.c */ | |
720 | if (stash) { | |
15e6cdd9 DG |
721 | /* If we can't find an IO::File method, it might be a call on |
722 | * a filehandle. If IO:File has not been loaded, try to | |
723 | * require it first instead of croaking */ | |
724 | const char *stash_name = HvNAME_get(stash); | |
31b05a0f FR |
725 | if (stash_name && memEQs(stash_name, HvNAMELEN_get(stash), "IO::File") |
726 | && !Perl_hv_common(aTHX_ GvHVn(PL_incgv), NULL, | |
727 | STR_WITH_LEN("IO/File.pm"), 0, | |
728 | HV_FETCH_ISEXISTS, NULL, 0) | |
15e6cdd9 | 729 | ) { |
31b05a0f | 730 | require_pv("IO/File.pm"); |
15e6cdd9 DG |
731 | gv = gv_fetchmeth(stash, name, nend - name, 0); |
732 | if (gv) | |
733 | return gv; | |
734 | } | |
256d1bb2 NC |
735 | Perl_croak(aTHX_ |
736 | "Can't locate object method \"%s\" via package \"%.*s\"", | |
c49b597d | 737 | name, (int)HvNAMELEN_get(stash), HvNAME_get(stash)); |
256d1bb2 NC |
738 | } |
739 | else { | |
740 | STRLEN packlen; | |
741 | const char *packname; | |
742 | ||
256d1bb2 NC |
743 | if (nsplit) { |
744 | packlen = nsplit - origname; | |
745 | packname = origname; | |
256d1bb2 NC |
746 | } else { |
747 | packname = SvPV_const(error_report, packlen); | |
748 | } | |
749 | ||
750 | Perl_croak(aTHX_ | |
751 | "Can't locate object method \"%s\" via package \"%.*s\"" | |
752 | " (perhaps you forgot to load \"%.*s\"?)", | |
753 | name, (int)packlen, packname, (int)packlen, packname); | |
754 | } | |
755 | } | |
463ee0b2 | 756 | } |
dc848c6f | 757 | else if (autoload) { |
9d4ba2ae | 758 | CV* const cv = GvCV(gv); |
09280a33 CS |
759 | if (!CvROOT(cv) && !CvXSUB(cv)) { |
760 | GV* stubgv; | |
761 | GV* autogv; | |
762 | ||
763 | if (CvANON(cv)) | |
764 | stubgv = gv; | |
765 | else { | |
766 | stubgv = CvGV(cv); | |
767 | if (GvCV(stubgv) != cv) /* orphaned import */ | |
768 | stubgv = gv; | |
769 | } | |
770 | autogv = gv_autoload4(GvSTASH(stubgv), | |
771 | GvNAME(stubgv), GvNAMELEN(stubgv), TRUE); | |
dc848c6f | 772 | if (autogv) |
773 | gv = autogv; | |
774 | } | |
775 | } | |
44a8e56a | 776 | |
777 | return gv; | |
778 | } | |
779 | ||
780 | GV* | |
864dbfa3 | 781 | Perl_gv_autoload4(pTHX_ HV *stash, const char *name, STRLEN len, I32 method) |
44a8e56a | 782 | { |
27da23d5 | 783 | dVAR; |
44a8e56a | 784 | GV* gv; |
785 | CV* cv; | |
786 | HV* varstash; | |
787 | GV* vargv; | |
788 | SV* varsv; | |
e1ec3a88 | 789 | const char *packname = ""; |
eae70eaa | 790 | STRLEN packname_len = 0; |
44a8e56a | 791 | |
7918f24d NC |
792 | PERL_ARGS_ASSERT_GV_AUTOLOAD4; |
793 | ||
7edbdc6b | 794 | if (len == S_autolen && memEQ(name, S_autoload, S_autolen)) |
a0714e2c | 795 | return NULL; |
0dae17bd GS |
796 | if (stash) { |
797 | if (SvTYPE(stash) < SVt_PVHV) { | |
ad64d0ec | 798 | packname = SvPV_const(MUTABLE_SV(stash), packname_len); |
5c284bb0 | 799 | stash = NULL; |
0dae17bd GS |
800 | } |
801 | else { | |
bfcb3514 | 802 | packname = HvNAME_get(stash); |
7423f6db | 803 | packname_len = HvNAMELEN_get(stash); |
0dae17bd GS |
804 | } |
805 | } | |
5c7983e5 | 806 | if (!(gv = gv_fetchmeth(stash, S_autoload, S_autolen, FALSE))) |
a0714e2c | 807 | return NULL; |
dc848c6f | 808 | cv = GvCV(gv); |
809 | ||
adb5a9ae | 810 | if (!(CvROOT(cv) || CvXSUB(cv))) |
a0714e2c | 811 | return NULL; |
ed850460 | 812 | |
dc848c6f | 813 | /* |
814 | * Inheriting AUTOLOAD for non-methods works ... for now. | |
815 | */ | |
041457d9 | 816 | if (!method && (GvCVGEN(gv) || GvSTASH(gv) != stash) |
041457d9 | 817 | ) |
d1d15184 NC |
818 | Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED), |
819 | "Use of inherited AUTOLOAD for non-method %s::%.*s() is deprecated", | |
820 | packname, (int)len, name); | |
44a8e56a | 821 | |
aed2304a | 822 | if (CvISXSUB(cv)) { |
adb5a9ae DM |
823 | /* rather than lookup/init $AUTOLOAD here |
824 | * only to have the XSUB do another lookup for $AUTOLOAD | |
825 | * and split that value on the last '::', | |
826 | * pass along the same data via some unused fields in the CV | |
827 | */ | |
c68d9564 | 828 | CvSTASH_set(cv, stash); |
f880fe2f | 829 | SvPV_set(cv, (char *)name); /* cast to lose constness warning */ |
b162af07 | 830 | SvCUR_set(cv, len); |
adb5a9ae DM |
831 | return gv; |
832 | } | |
adb5a9ae | 833 | |
44a8e56a | 834 | /* |
835 | * Given &FOO::AUTOLOAD, set $FOO::AUTOLOAD to desired function name. | |
836 | * The subroutine's original name may not be "AUTOLOAD", so we don't | |
837 | * use that, but for lack of anything better we will use the sub's | |
838 | * original package to look up $AUTOLOAD. | |
839 | */ | |
840 | varstash = GvSTASH(CvGV(cv)); | |
5c7983e5 | 841 | vargv = *(GV**)hv_fetch(varstash, S_autoload, S_autolen, TRUE); |
3d35f11b GS |
842 | ENTER; |
843 | ||
c69033f2 | 844 | if (!isGV(vargv)) { |
5c7983e5 | 845 | gv_init(vargv, varstash, S_autoload, S_autolen, FALSE); |
c69033f2 | 846 | #ifdef PERL_DONT_CREATE_GVSV |
561b68a9 | 847 | GvSV(vargv) = newSV(0); |
c69033f2 NC |
848 | #endif |
849 | } | |
3d35f11b | 850 | LEAVE; |
e203899d | 851 | varsv = GvSVn(vargv); |
7423f6db | 852 | sv_setpvn(varsv, packname, packname_len); |
396482e1 | 853 | sv_catpvs(varsv, "::"); |
44a8e56a | 854 | sv_catpvn(varsv, name, len); |
a0d0e21e LW |
855 | return gv; |
856 | } | |
857 | ||
44a2ac75 YO |
858 | |
859 | /* require_tie_mod() internal routine for requiring a module | |
860 | * that implements the logic of automatical ties like %! and %- | |
861 | * | |
862 | * The "gv" parameter should be the glob. | |
45cbc99a RGS |
863 | * "varpv" holds the name of the var, used for error messages. |
864 | * "namesv" holds the module name. Its refcount will be decremented. | |
44a2ac75 | 865 | * "methpv" holds the method name to test for to check that things |
45cbc99a RGS |
866 | * are working reasonably close to as expected. |
867 | * "flags": if flag & 1 then save the scalar before loading. | |
44a2ac75 YO |
868 | * For the protection of $! to work (it is set by this routine) |
869 | * the sv slot must already be magicalized. | |
d2c93421 | 870 | */ |
44a2ac75 YO |
871 | STATIC HV* |
872 | S_require_tie_mod(pTHX_ GV *gv, const char *varpv, SV* namesv, const char *methpv,const U32 flags) | |
d2c93421 | 873 | { |
27da23d5 | 874 | dVAR; |
da51bb9b | 875 | HV* stash = gv_stashsv(namesv, 0); |
45cbc99a | 876 | |
7918f24d NC |
877 | PERL_ARGS_ASSERT_REQUIRE_TIE_MOD; |
878 | ||
44a2ac75 | 879 | if (!stash || !(gv_fetchmethod(stash, methpv))) { |
45cbc99a RGS |
880 | SV *module = newSVsv(namesv); |
881 | char varname = *varpv; /* varpv might be clobbered by load_module, | |
882 | so save it. For the moment it's always | |
883 | a single char. */ | |
d2c93421 | 884 | dSP; |
d2c93421 | 885 | ENTER; |
44a2ac75 | 886 | if ( flags & 1 ) |
45cbc99a | 887 | save_scalar(gv); |
cac54379 | 888 | PUSHSTACKi(PERLSI_MAGIC); |
45cbc99a | 889 | Perl_load_module(aTHX_ PERL_LOADMOD_NOIMPORT, module, NULL); |
cac54379 | 890 | POPSTACK; |
d2c93421 RH |
891 | LEAVE; |
892 | SPAGAIN; | |
da51bb9b | 893 | stash = gv_stashsv(namesv, 0); |
44a2ac75 | 894 | if (!stash) |
45cbc99a RGS |
895 | Perl_croak(aTHX_ "panic: Can't use %%%c because %"SVf" is not available", |
896 | varname, SVfARG(namesv)); | |
897 | else if (!gv_fetchmethod(stash, methpv)) | |
898 | Perl_croak(aTHX_ "panic: Can't use %%%c because %"SVf" does not support method %s", | |
899 | varname, SVfARG(namesv), methpv); | |
d2c93421 | 900 | } |
45cbc99a | 901 | SvREFCNT_dec(namesv); |
44a2ac75 | 902 | return stash; |
d2c93421 RH |
903 | } |
904 | ||
954c1994 GS |
905 | /* |
906 | =for apidoc gv_stashpv | |
907 | ||
da51bb9b | 908 | Returns a pointer to the stash for a specified package. Uses C<strlen> to |
75c442e4 | 909 | determine the length of C<name>, then calls C<gv_stashpvn()>. |
954c1994 GS |
910 | |
911 | =cut | |
912 | */ | |
913 | ||
a0d0e21e | 914 | HV* |
864dbfa3 | 915 | Perl_gv_stashpv(pTHX_ const char *name, I32 create) |
a0d0e21e | 916 | { |
7918f24d | 917 | PERL_ARGS_ASSERT_GV_STASHPV; |
dc437b57 | 918 | return gv_stashpvn(name, strlen(name), create); |
919 | } | |
920 | ||
bc96cb06 SH |
921 | /* |
922 | =for apidoc gv_stashpvn | |
923 | ||
da51bb9b NC |
924 | Returns a pointer to the stash for a specified package. The C<namelen> |
925 | parameter indicates the length of the C<name>, in bytes. C<flags> is passed | |
926 | to C<gv_fetchpvn_flags()>, so if set to C<GV_ADD> then the package will be | |
927 | created if it does not already exist. If the package does not exist and | |
928 | C<flags> is 0 (or any other setting that does not create packages) then NULL | |
929 | is returned. | |
930 | ||
bc96cb06 SH |
931 | |
932 | =cut | |
933 | */ | |
934 | ||
dc437b57 | 935 | HV* |
da51bb9b | 936 | Perl_gv_stashpvn(pTHX_ const char *name, U32 namelen, I32 flags) |
dc437b57 | 937 | { |
0cea0058 | 938 | char smallbuf[128]; |
46fc3d4c | 939 | char *tmpbuf; |
a0d0e21e LW |
940 | HV *stash; |
941 | GV *tmpgv; | |
add0ecde | 942 | U32 tmplen = namelen + 2; |
dc437b57 | 943 | |
7918f24d NC |
944 | PERL_ARGS_ASSERT_GV_STASHPVN; |
945 | ||
add0ecde | 946 | if (tmplen <= sizeof smallbuf) |
46fc3d4c | 947 | tmpbuf = smallbuf; |
948 | else | |
add0ecde VP |
949 | Newx(tmpbuf, tmplen, char); |
950 | Copy(name, tmpbuf, namelen, char); | |
951 | tmpbuf[namelen] = ':'; | |
952 | tmpbuf[namelen+1] = ':'; | |
953 | tmpgv = gv_fetchpvn_flags(tmpbuf, tmplen, flags, SVt_PVHV); | |
46fc3d4c | 954 | if (tmpbuf != smallbuf) |
955 | Safefree(tmpbuf); | |
a0d0e21e | 956 | if (!tmpgv) |
da51bb9b | 957 | return NULL; |
a0d0e21e | 958 | stash = GvHV(tmpgv); |
b4dd6623 NC |
959 | assert(stash); |
960 | assert(HvNAME_get(stash)); | |
a0d0e21e | 961 | return stash; |
463ee0b2 LW |
962 | } |
963 | ||
954c1994 GS |
964 | /* |
965 | =for apidoc gv_stashsv | |
966 | ||
da51bb9b | 967 | Returns a pointer to the stash for a specified package. See C<gv_stashpvn>. |
954c1994 GS |
968 | |
969 | =cut | |
970 | */ | |
971 | ||
a0d0e21e | 972 | HV* |
da51bb9b | 973 | Perl_gv_stashsv(pTHX_ SV *sv, I32 flags) |
a0d0e21e | 974 | { |
dc437b57 | 975 | STRLEN len; |
9d4ba2ae | 976 | const char * const ptr = SvPV_const(sv,len); |
7918f24d NC |
977 | |
978 | PERL_ARGS_ASSERT_GV_STASHSV; | |
979 | ||
da51bb9b | 980 | return gv_stashpvn(ptr, len, flags); |
a0d0e21e LW |
981 | } |
982 | ||
983 | ||
463ee0b2 | 984 | GV * |
fe9845cc | 985 | Perl_gv_fetchpv(pTHX_ const char *nambeg, I32 add, const svtype sv_type) { |
7918f24d | 986 | PERL_ARGS_ASSERT_GV_FETCHPV; |
b7787f18 | 987 | return gv_fetchpvn_flags(nambeg, strlen(nambeg), add, sv_type); |
7a5fd60d NC |
988 | } |
989 | ||
990 | GV * | |
fe9845cc | 991 | Perl_gv_fetchsv(pTHX_ SV *name, I32 flags, const svtype sv_type) { |
7a5fd60d | 992 | STRLEN len; |
9d4ba2ae | 993 | const char * const nambeg = SvPV_const(name, len); |
7918f24d | 994 | PERL_ARGS_ASSERT_GV_FETCHSV; |
7a5fd60d NC |
995 | return gv_fetchpvn_flags(nambeg, len, flags | SvUTF8(name), sv_type); |
996 | } | |
997 | ||
ad7cce9f | 998 | STATIC void |
290a1700 | 999 | S_gv_magicalize_isa(pTHX_ GV *gv) |
ad7cce9f FR |
1000 | { |
1001 | AV* av; | |
1002 | ||
1003 | PERL_ARGS_ASSERT_GV_MAGICALIZE_ISA; | |
1004 | ||
1005 | av = GvAVn(gv); | |
1006 | GvMULTI_on(gv); | |
1007 | sv_magic(MUTABLE_SV(av), MUTABLE_SV(gv), PERL_MAGIC_isa, | |
1008 | NULL, 0); | |
ad7cce9f FR |
1009 | } |
1010 | ||
1011 | STATIC void | |
26469672 | 1012 | S_gv_magicalize_overload(pTHX_ GV *gv) |
ad7cce9f FR |
1013 | { |
1014 | HV* hv; | |
1015 | ||
1016 | PERL_ARGS_ASSERT_GV_MAGICALIZE_OVERLOAD; | |
1017 | ||
1018 | hv = GvHVn(gv); | |
1019 | GvMULTI_on(gv); | |
1020 | hv_magic(hv, NULL, PERL_MAGIC_overload); | |
1021 | } | |
1022 | ||
7a5fd60d NC |
1023 | GV * |
1024 | Perl_gv_fetchpvn_flags(pTHX_ const char *nambeg, STRLEN full_len, I32 flags, | |
fe9845cc | 1025 | const svtype sv_type) |
79072805 | 1026 | { |
97aff369 | 1027 | dVAR; |
08105a92 | 1028 | register const char *name = nambeg; |
c445ea15 | 1029 | register GV *gv = NULL; |
79072805 | 1030 | GV**gvp; |
79072805 | 1031 | I32 len; |
b3d904f3 | 1032 | register const char *name_cursor; |
c445ea15 | 1033 | HV *stash = NULL; |
add2581e | 1034 | const I32 no_init = flags & (GV_NOADD_NOINIT | GV_NOINIT); |
e26df76a | 1035 | const I32 no_expand = flags & GV_NOEXPAND; |
780a5241 | 1036 | const I32 add = flags & ~GV_NOADD_MASK; |
b3d904f3 NC |
1037 | const char *const name_end = nambeg + full_len; |
1038 | const char *const name_em1 = name_end - 1; | |
5e0caaeb | 1039 | U32 faking_it; |
79072805 | 1040 | |
7918f24d NC |
1041 | PERL_ARGS_ASSERT_GV_FETCHPVN_FLAGS; |
1042 | ||
fafc274c NC |
1043 | if (flags & GV_NOTQUAL) { |
1044 | /* Caller promised that there is no stash, so we can skip the check. */ | |
1045 | len = full_len; | |
1046 | goto no_stash; | |
1047 | } | |
1048 | ||
b208e10c NC |
1049 | if (full_len > 2 && *name == '*' && isALPHA(name[1])) { |
1050 | /* accidental stringify on a GV? */ | |
c07a80fd | 1051 | name++; |
b208e10c | 1052 | } |
c07a80fd | 1053 | |
b3d904f3 NC |
1054 | for (name_cursor = name; name_cursor < name_end; name_cursor++) { |
1055 | if ((*name_cursor == ':' && name_cursor < name_em1 | |
1056 | && name_cursor[1] == ':') | |
1057 | || (*name_cursor == '\'' && name_cursor[1])) | |
463ee0b2 | 1058 | { |
463ee0b2 | 1059 | if (!stash) |
3280af22 | 1060 | stash = PL_defstash; |
dc437b57 | 1061 | if (!stash || !SvREFCNT(stash)) /* symbol table under destruction */ |
a0714e2c | 1062 | return NULL; |
463ee0b2 | 1063 | |
b3d904f3 | 1064 | len = name_cursor - name; |
85e6fe83 | 1065 | if (len > 0) { |
3a5b580c NC |
1066 | const char *key; |
1067 | if (*name_cursor == ':') { | |
1068 | key = name; | |
e771aaa9 NC |
1069 | len += 2; |
1070 | } else { | |
3a5b580c | 1071 | char *tmpbuf; |
2ae0db35 | 1072 | Newx(tmpbuf, len+2, char); |
e771aaa9 NC |
1073 | Copy(name, tmpbuf, len, char); |
1074 | tmpbuf[len++] = ':'; | |
1075 | tmpbuf[len++] = ':'; | |
3a5b580c | 1076 | key = tmpbuf; |
e771aaa9 | 1077 | } |
3a5b580c | 1078 | gvp = (GV**)hv_fetch(stash, key, len, add); |
a0714e2c | 1079 | gv = gvp ? *gvp : NULL; |
159b6efe | 1080 | if (gv && gv != (const GV *)&PL_sv_undef) { |
6fa846a0 | 1081 | if (SvTYPE(gv) != SVt_PVGV) |
3a5b580c | 1082 | gv_init(gv, stash, key, len, (add & GV_ADDMULTI)); |
6fa846a0 GS |
1083 | else |
1084 | GvMULTI_on(gv); | |
1085 | } | |
3a5b580c NC |
1086 | if (key != name) |
1087 | Safefree((char *)key); | |
159b6efe | 1088 | if (!gv || gv == (const GV *)&PL_sv_undef) |
a0714e2c | 1089 | return NULL; |
85e6fe83 | 1090 | |
463ee0b2 | 1091 | if (!(stash = GvHV(gv))) |
298d6511 | 1092 | { |
99ee9762 FC |
1093 | stash = GvHV(gv) = newHV(); |
1094 | if (!HvNAME_get(stash)) { | |
1095 | hv_name_set(stash, nambeg, name_cursor-nambeg, 0); | |
1096 | /* If the containing stash has multiple effective | |
1097 | names, see that this one gets them, too. */ | |
1098 | if (HvAUX(GvSTASH(gv))->xhv_name_count) | |
1099 | mro_package_moved(stash, NULL, gv, 1); | |
1100 | } | |
298d6511 | 1101 | } |
99ee9762 FC |
1102 | else if (!HvNAME_get(stash)) |
1103 | hv_name_set(stash, nambeg, name_cursor - nambeg, 0); | |
463ee0b2 LW |
1104 | } |
1105 | ||
b3d904f3 NC |
1106 | if (*name_cursor == ':') |
1107 | name_cursor++; | |
1108 | name_cursor++; | |
1109 | name = name_cursor; | |
ad6bfa9d | 1110 | if (name == name_end) |
159b6efe NC |
1111 | return gv |
1112 | ? gv : MUTABLE_GV(*hv_fetchs(PL_defstash, "main::", TRUE)); | |
79072805 | 1113 | } |
79072805 | 1114 | } |
b3d904f3 | 1115 | len = name_cursor - name; |
463ee0b2 LW |
1116 | |
1117 | /* No stash in name, so see how we can default */ | |
1118 | ||
1119 | if (!stash) { | |
fafc274c | 1120 | no_stash: |
8ccce9ae | 1121 | if (len && isIDFIRST_lazy(name)) { |
9607fc9c | 1122 | bool global = FALSE; |
1123 | ||
8ccce9ae NC |
1124 | switch (len) { |
1125 | case 1: | |
18ea00d7 | 1126 | if (*name == '_') |
9d116dd7 | 1127 | global = TRUE; |
18ea00d7 | 1128 | break; |
8ccce9ae NC |
1129 | case 3: |
1130 | if ((name[0] == 'I' && name[1] == 'N' && name[2] == 'C') | |
1131 | || (name[0] == 'E' && name[1] == 'N' && name[2] == 'V') | |
1132 | || (name[0] == 'S' && name[1] == 'I' && name[2] == 'G')) | |
9d116dd7 | 1133 | global = TRUE; |
18ea00d7 | 1134 | break; |
8ccce9ae NC |
1135 | case 4: |
1136 | if (name[0] == 'A' && name[1] == 'R' && name[2] == 'G' | |
1137 | && name[3] == 'V') | |
9d116dd7 | 1138 | global = TRUE; |
18ea00d7 | 1139 | break; |
8ccce9ae NC |
1140 | case 5: |
1141 | if (name[0] == 'S' && name[1] == 'T' && name[2] == 'D' | |
1142 | && name[3] == 'I' && name[4] == 'N') | |
463ee0b2 | 1143 | global = TRUE; |
18ea00d7 | 1144 | break; |
8ccce9ae NC |
1145 | case 6: |
1146 | if ((name[0] == 'S' && name[1] == 'T' && name[2] == 'D') | |
1147 | &&((name[3] == 'O' && name[4] == 'U' && name[5] == 'T') | |
1148 | ||(name[3] == 'E' && name[4] == 'R' && name[5] == 'R'))) | |
1149 | global = TRUE; | |
1150 | break; | |
1151 | case 7: | |
1152 | if (name[0] == 'A' && name[1] == 'R' && name[2] == 'G' | |
1153 | && name[3] == 'V' && name[4] == 'O' && name[5] == 'U' | |
1154 | && name[6] == 'T') | |
18ea00d7 NC |
1155 | global = TRUE; |
1156 | break; | |
463ee0b2 | 1157 | } |
9607fc9c | 1158 | |
463ee0b2 | 1159 | if (global) |
3280af22 | 1160 | stash = PL_defstash; |
923e4eb5 | 1161 | else if (IN_PERL_COMPILETIME) { |
3280af22 NIS |
1162 | stash = PL_curstash; |
1163 | if (add && (PL_hints & HINT_STRICT_VARS) && | |
748a9306 LW |
1164 | sv_type != SVt_PVCV && |
1165 | sv_type != SVt_PVGV && | |
4633a7c4 | 1166 | sv_type != SVt_PVFM && |
c07a80fd | 1167 | sv_type != SVt_PVIO && |
70ec6265 NC |
1168 | !(len == 1 && sv_type == SVt_PV && |
1169 | (*name == 'a' || *name == 'b')) ) | |
748a9306 | 1170 | { |
4633a7c4 LW |
1171 | gvp = (GV**)hv_fetch(stash,name,len,0); |
1172 | if (!gvp || | |
159b6efe | 1173 | *gvp == (const GV *)&PL_sv_undef || |
a5f75d66 AD |
1174 | SvTYPE(*gvp) != SVt_PVGV) |
1175 | { | |
d4c19fe8 | 1176 | stash = NULL; |
a5f75d66 | 1177 | } |
155aba94 GS |
1178 | else if ((sv_type == SVt_PV && !GvIMPORTED_SV(*gvp)) || |
1179 | (sv_type == SVt_PVAV && !GvIMPORTED_AV(*gvp)) || | |
1180 | (sv_type == SVt_PVHV && !GvIMPORTED_HV(*gvp)) ) | |
4633a7c4 | 1181 | { |
fe13d51d | 1182 | /* diag_listed_as: Variable "%s" is not imported%s */ |
413ff9f6 FC |
1183 | Perl_ck_warner_d( |
1184 | aTHX_ packWARN(WARN_MISC), | |
1185 | "Variable \"%c%s\" is not imported", | |
4633a7c4 LW |
1186 | sv_type == SVt_PVAV ? '@' : |
1187 | sv_type == SVt_PVHV ? '%' : '$', | |
1188 | name); | |
8ebc5c01 | 1189 | if (GvCVu(*gvp)) |
413ff9f6 FC |
1190 | Perl_ck_warner_d( |
1191 | aTHX_ packWARN(WARN_MISC), | |
1192 | "\t(Did you mean &%s instead?)\n", name | |
1193 | ); | |
d4c19fe8 | 1194 | stash = NULL; |
4633a7c4 | 1195 | } |
a0d0e21e | 1196 | } |
85e6fe83 | 1197 | } |
463ee0b2 | 1198 | else |
1d7c1841 | 1199 | stash = CopSTASH(PL_curcop); |
463ee0b2 LW |
1200 | } |
1201 | else | |
3280af22 | 1202 | stash = PL_defstash; |
463ee0b2 LW |
1203 | } |
1204 | ||
1205 | /* By this point we should have a stash and a name */ | |
1206 | ||
a0d0e21e | 1207 | if (!stash) { |
5a844595 | 1208 | if (add) { |
9d4ba2ae | 1209 | SV * const err = Perl_mess(aTHX_ |
5a844595 GS |
1210 | "Global symbol \"%s%s\" requires explicit package name", |
1211 | (sv_type == SVt_PV ? "$" | |
1212 | : sv_type == SVt_PVAV ? "@" | |
1213 | : sv_type == SVt_PVHV ? "%" | |
608b3986 | 1214 | : ""), name); |
e7f343b6 | 1215 | GV *gv; |
608b3986 AE |
1216 | if (USE_UTF8_IN_NAMES) |
1217 | SvUTF8_on(err); | |
1218 | qerror(err); | |
76f68e9b | 1219 | gv = gv_fetchpvs("<none>::", GV_ADDMULTI, SVt_PVHV); |
e7f343b6 NC |
1220 | if(!gv) { |
1221 | /* symbol table under destruction */ | |
1222 | return NULL; | |
1223 | } | |
1224 | stash = GvHV(gv); | |
a0d0e21e | 1225 | } |
d7aacf4e | 1226 | else |
a0714e2c | 1227 | return NULL; |
a0d0e21e LW |
1228 | } |
1229 | ||
1230 | if (!SvREFCNT(stash)) /* symbol table under destruction */ | |
a0714e2c | 1231 | return NULL; |
a0d0e21e | 1232 | |
79072805 | 1233 | gvp = (GV**)hv_fetch(stash,name,len,add); |
159b6efe | 1234 | if (!gvp || *gvp == (const GV *)&PL_sv_undef) |
a0714e2c | 1235 | return NULL; |
79072805 LW |
1236 | gv = *gvp; |
1237 | if (SvTYPE(gv) == SVt_PVGV) { | |
a0d0e21e | 1238 | if (add) { |
a5f75d66 | 1239 | GvMULTI_on(gv); |
a0d0e21e | 1240 | gv_init_sv(gv, sv_type); |
45cbc99a | 1241 | if (len == 1 && (sv_type == SVt_PVHV || sv_type == SVt_PVGV)) { |
44a2ac75 YO |
1242 | if (*name == '!') |
1243 | require_tie_mod(gv, "!", newSVpvs("Errno"), "TIEHASH", 1); | |
45cbc99a | 1244 | else if (*name == '-' || *name == '+') |
192b9cd1 | 1245 | require_tie_mod(gv, name, newSVpvs("Tie::Hash::NamedCapture"), "TIEHASH", 0); |
45cbc99a | 1246 | } |
af16de9f FC |
1247 | else if (len == 3 && sv_type == SVt_PVAV |
1248 | && strnEQ(name, "ISA", 3) | |
1249 | && (!GvAV(gv) || !SvSMAGICAL(GvAV(gv)))) | |
1250 | gv_magicalize_isa(gv); | |
a0d0e21e | 1251 | } |
79072805 | 1252 | return gv; |
add2581e | 1253 | } else if (no_init) { |
55d729e4 | 1254 | return gv; |
e26df76a NC |
1255 | } else if (no_expand && SvROK(gv)) { |
1256 | return gv; | |
79072805 | 1257 | } |
93a17b20 | 1258 | |
5e0caaeb NC |
1259 | /* Adding a new symbol. |
1260 | Unless of course there was already something non-GV here, in which case | |
1261 | we want to behave as if there was always a GV here, containing some sort | |
1262 | of subroutine. | |
1263 | Otherwise we run the risk of creating things like GvIO, which can cause | |
1264 | subtle bugs. eg the one that tripped up SQL::Translator */ | |
1265 | ||
1266 | faking_it = SvOK(gv); | |
93a17b20 | 1267 | |
9b387841 NC |
1268 | if (add & GV_ADDWARN) |
1269 | Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL), "Had to create %s unexpectedly", nambeg); | |
55d729e4 | 1270 | gv_init(gv, stash, name, len, add & GV_ADDMULTI); |
5e0caaeb | 1271 | gv_init_sv(gv, faking_it ? SVt_PVCV : sv_type); |
93a17b20 | 1272 | |
a0288114 | 1273 | if (isALPHA(name[0]) && ! (isLEXWARN_on ? ckWARN(WARN_ONCE) |
7272584d | 1274 | : (PL_dowarn & G_WARN_ON ) ) ) |
0453d815 PM |
1275 | GvMULTI_on(gv) ; |
1276 | ||
93a17b20 | 1277 | /* set up magic where warranted */ |
44428a46 FC |
1278 | if (stash != PL_defstash) { /* not the main stash */ |
1279 | /* We only have to check for four names here: EXPORT, ISA, OVERLOAD | |
1280 | and VERSION. All the others apply only to the main stash. */ | |
1281 | if (len > 1) { | |
b464bac0 | 1282 | const char * const name2 = name + 1; |
cc4c2da6 | 1283 | switch (*name) { |
cc4c2da6 NC |
1284 | case 'E': |
1285 | if (strnEQ(name2, "XPORT", 5)) | |
1286 | GvMULTI_on(gv); | |
1287 | break; | |
1288 | case 'I': | |
44428a46 | 1289 | if (strEQ(name2, "SA")) |
290a1700 | 1290 | gv_magicalize_isa(gv); |
cc4c2da6 NC |
1291 | break; |
1292 | case 'O': | |
44428a46 | 1293 | if (strEQ(name2, "VERLOAD")) |
ad7cce9f | 1294 | gv_magicalize_overload(gv); |
cc4c2da6 | 1295 | break; |
44428a46 FC |
1296 | case 'V': |
1297 | if (strEQ(name2, "ERSION")) | |
1298 | GvMULTI_on(gv); | |
1299 | break; | |
1300 | } | |
1301 | } | |
1302 | } | |
1303 | else if (len > 1) { | |
1304 | #ifndef EBCDIC | |
1305 | if (*name > 'V' ) { | |
1306 | NOOP; | |
1307 | /* Nothing else to do. | |
1308 | The compiler will probably turn the switch statement into a | |
1309 | branch table. Make sure we avoid even that small overhead for | |
1310 | the common case of lower case variable names. */ | |
1311 | } else | |
1312 | #endif | |
1313 | { | |
1314 | const char * const name2 = name + 1; | |
1315 | switch (*name) { | |
1316 | case 'A': | |
1317 | if (strEQ(name2, "RGV")) { | |
1318 | IoFLAGS(GvIOn(gv)) |= IOf_ARGV|IOf_START; | |
1319 | } | |
1320 | else if (strEQ(name2, "RGVOUT")) { | |
1321 | GvMULTI_on(gv); | |
1322 | } | |
1323 | break; | |
1324 | case 'E': | |
1325 | if (strnEQ(name2, "XPORT", 5)) | |
1326 | GvMULTI_on(gv); | |
1327 | break; | |
1328 | case 'I': | |
1329 | if (strEQ(name2, "SA")) { | |
290a1700 | 1330 | gv_magicalize_isa(gv); |
44428a46 FC |
1331 | } |
1332 | break; | |
1333 | case 'O': | |
1334 | if (strEQ(name2, "VERLOAD")) { | |
ad7cce9f | 1335 | gv_magicalize_overload(gv); |
44428a46 FC |
1336 | } |
1337 | break; | |
cc4c2da6 NC |
1338 | case 'S': |
1339 | if (strEQ(name2, "IG")) { | |
1340 | HV *hv; | |
1341 | I32 i; | |
d525a7b2 NC |
1342 | if (!PL_psig_name) { |
1343 | Newxz(PL_psig_name, 2 * SIG_SIZE, SV*); | |
a02a5408 | 1344 | Newxz(PL_psig_pend, SIG_SIZE, int); |
d525a7b2 | 1345 | PL_psig_ptr = PL_psig_name + SIG_SIZE; |
0bdedcb3 NC |
1346 | } else { |
1347 | /* I think that the only way to get here is to re-use an | |
1348 | embedded perl interpreter, where the previous | |
1349 | use didn't clean up fully because | |
1350 | PL_perl_destruct_level was 0. I'm not sure that we | |
1351 | "support" that, in that I suspect in that scenario | |
1352 | there are sufficient other garbage values left in the | |
1353 | interpreter structure that something else will crash | |
1354 | before we get here. I suspect that this is one of | |
1355 | those "doctor, it hurts when I do this" bugs. */ | |
d525a7b2 | 1356 | Zero(PL_psig_name, 2 * SIG_SIZE, SV*); |
0bdedcb3 | 1357 | Zero(PL_psig_pend, SIG_SIZE, int); |
cc4c2da6 NC |
1358 | } |
1359 | GvMULTI_on(gv); | |
1360 | hv = GvHVn(gv); | |
a0714e2c | 1361 | hv_magic(hv, NULL, PERL_MAGIC_sig); |
cc4c2da6 | 1362 | for (i = 1; i < SIG_SIZE; i++) { |
551405c4 | 1363 | SV * const * const init = hv_fetch(hv, PL_sig_name[i], strlen(PL_sig_name[i]), 1); |
cc4c2da6 NC |
1364 | if (init) |
1365 | sv_setsv(*init, &PL_sv_undef); | |
cc4c2da6 NC |
1366 | } |
1367 | } | |
1368 | break; | |
1369 | case 'V': | |
1370 | if (strEQ(name2, "ERSION")) | |
1371 | GvMULTI_on(gv); | |
1372 | break; | |
e5218da5 GA |
1373 | case '\003': /* $^CHILD_ERROR_NATIVE */ |
1374 | if (strEQ(name2, "HILD_ERROR_NATIVE")) | |
1375 | goto magicalize; | |
1376 | break; | |
cc4c2da6 NC |
1377 | case '\005': /* $^ENCODING */ |
1378 | if (strEQ(name2, "NCODING")) | |
1379 | goto magicalize; | |
1380 | break; | |
9ebf26ad FR |
1381 | case '\007': /* $^GLOBAL_PHASE */ |
1382 | if (strEQ(name2, "LOBAL_PHASE")) | |
1383 | goto ro_magicalize; | |
1384 | break; | |
cde0cee5 YO |
1385 | case '\015': /* $^MATCH */ |
1386 | if (strEQ(name2, "ATCH")) | |
2fdbfb4d | 1387 | goto magicalize; |
cc4c2da6 NC |
1388 | case '\017': /* $^OPEN */ |
1389 | if (strEQ(name2, "PEN")) | |
1390 | goto magicalize; | |
1391 | break; | |
cde0cee5 YO |
1392 | case '\020': /* $^PREMATCH $^POSTMATCH */ |
1393 | if (strEQ(name2, "REMATCH") || strEQ(name2, "OSTMATCH")) | |
9ebf26ad FR |
1394 | goto magicalize; |
1395 | break; | |
cc4c2da6 NC |
1396 | case '\024': /* ${^TAINT} */ |
1397 | if (strEQ(name2, "AINT")) | |
1398 | goto ro_magicalize; | |
1399 | break; | |
7cebcbc0 | 1400 | case '\025': /* ${^UNICODE}, ${^UTF8LOCALE} */ |
a0288114 | 1401 | if (strEQ(name2, "NICODE")) |
cc4c2da6 | 1402 | goto ro_magicalize; |
a0288114 | 1403 | if (strEQ(name2, "TF8LOCALE")) |
7cebcbc0 | 1404 | goto ro_magicalize; |
e07ea26a NC |
1405 | if (strEQ(name2, "TF8CACHE")) |
1406 | goto magicalize; | |
cc4c2da6 NC |
1407 | break; |
1408 | case '\027': /* $^WARNING_BITS */ | |
1409 | if (strEQ(name2, "ARNING_BITS")) | |
1410 | goto magicalize; | |
1411 | break; | |
1412 | case '1': | |
1413 | case '2': | |
1414 | case '3': | |
1415 | case '4': | |
1416 | case '5': | |
1417 | case '6': | |
1418 | case '7': | |
1419 | case '8': | |
1420 | case '9': | |
85e6fe83 | 1421 | { |
2fdbfb4d AB |
1422 | /* Ensures that we have an all-digit variable, ${"1foo"} fails |
1423 | this test */ | |
1424 | /* This snippet is taken from is_gv_magical */ | |
cc4c2da6 NC |
1425 | const char *end = name + len; |
1426 | while (--end > name) { | |
2fdbfb4d | 1427 | if (!isDIGIT(*end)) return gv; |
cc4c2da6 | 1428 | } |
2fdbfb4d | 1429 | goto magicalize; |
1d7c1841 | 1430 | } |
dc437b57 | 1431 | } |
93a17b20 | 1432 | } |
392db708 NC |
1433 | } else { |
1434 | /* Names of length 1. (Or 0. But name is NUL terminated, so that will | |
1435 | be case '\0' in this switch statement (ie a default case) */ | |
cc4c2da6 | 1436 | switch (*name) { |
6361f656 AB |
1437 | case '&': /* $& */ |
1438 | case '`': /* $` */ | |
1439 | case '\'': /* $' */ | |
cc4c2da6 NC |
1440 | if ( |
1441 | sv_type == SVt_PVAV || | |
1442 | sv_type == SVt_PVHV || | |
1443 | sv_type == SVt_PVCV || | |
1444 | sv_type == SVt_PVFM || | |
1445 | sv_type == SVt_PVIO | |
1446 | ) { break; } | |
1447 | PL_sawampersand = TRUE; | |
2fdbfb4d | 1448 | goto magicalize; |
cc4c2da6 | 1449 | |
6361f656 | 1450 | case ':': /* $: */ |
c69033f2 | 1451 | sv_setpv(GvSVn(gv),PL_chopset); |
cc4c2da6 NC |
1452 | goto magicalize; |
1453 | ||
6361f656 | 1454 | case '?': /* $? */ |
ff0cee69 | 1455 | #ifdef COMPLEX_STATUS |
c69033f2 | 1456 | SvUPGRADE(GvSVn(gv), SVt_PVLV); |
ff0cee69 | 1457 | #endif |
cc4c2da6 | 1458 | goto magicalize; |
ff0cee69 | 1459 | |
6361f656 | 1460 | case '!': /* $! */ |
67261566 | 1461 | GvMULTI_on(gv); |
44a2ac75 | 1462 | /* If %! has been used, automatically load Errno.pm. */ |
d2c93421 | 1463 | |
ad64d0ec | 1464 | sv_magic(GvSVn(gv), MUTABLE_SV(gv), PERL_MAGIC_sv, name, len); |
d2c93421 | 1465 | |
44a2ac75 | 1466 | /* magicalization must be done before require_tie_mod is called */ |
67261566 | 1467 | if (sv_type == SVt_PVHV || sv_type == SVt_PVGV) |
44a2ac75 | 1468 | require_tie_mod(gv, "!", newSVpvs("Errno"), "TIEHASH", 1); |
d2c93421 | 1469 | |
6cef1e77 | 1470 | break; |
6361f656 AB |
1471 | case '-': /* $- */ |
1472 | case '+': /* $+ */ | |
44a2ac75 YO |
1473 | GvMULTI_on(gv); /* no used once warnings here */ |
1474 | { | |
44a2ac75 | 1475 | AV* const av = GvAVn(gv); |
ad64d0ec | 1476 | SV* const avc = (*name == '+') ? MUTABLE_SV(av) : NULL; |
44a2ac75 | 1477 | |
ad64d0ec NC |
1478 | sv_magic(MUTABLE_SV(av), avc, PERL_MAGIC_regdata, NULL, 0); |
1479 | sv_magic(GvSVn(gv), MUTABLE_SV(gv), PERL_MAGIC_sv, name, len); | |
67261566 | 1480 | if (avc) |
44a2ac75 | 1481 | SvREADONLY_on(GvSVn(gv)); |
44a2ac75 | 1482 | SvREADONLY_on(av); |
67261566 YO |
1483 | |
1484 | if (sv_type == SVt_PVHV || sv_type == SVt_PVGV) | |
192b9cd1 | 1485 | require_tie_mod(gv, name, newSVpvs("Tie::Hash::NamedCapture"), "TIEHASH", 0); |
67261566 | 1486 | |
80305961 | 1487 | break; |
cc4c2da6 | 1488 | } |
6361f656 AB |
1489 | case '*': /* $* */ |
1490 | case '#': /* $# */ | |
9b387841 NC |
1491 | if (sv_type == SVt_PV) |
1492 | Perl_ck_warner_d(aTHX_ packWARN2(WARN_DEPRECATED, WARN_SYNTAX), | |
1493 | "$%c is no longer supported", *name); | |
8ae1fe26 | 1494 | break; |
6361f656 | 1495 | case '|': /* $| */ |
c69033f2 | 1496 | sv_setiv(GvSVn(gv), (IV)(IoFLAGS(GvIOp(PL_defoutgv)) & IOf_FLUSH) != 0); |
cc4c2da6 NC |
1497 | goto magicalize; |
1498 | ||
b3ca2e83 NC |
1499 | case '\010': /* $^H */ |
1500 | { | |
1501 | HV *const hv = GvHVn(gv); | |
1502 | hv_magic(hv, NULL, PERL_MAGIC_hints); | |
1503 | } | |
1504 | goto magicalize; | |
cc4c2da6 | 1505 | case '\023': /* $^S */ |
2fdbfb4d AB |
1506 | ro_magicalize: |
1507 | SvREADONLY_on(GvSVn(gv)); | |
1508 | /* FALL THROUGH */ | |
6361f656 AB |
1509 | case '0': /* $0 */ |
1510 | case '1': /* $1 */ | |
1511 | case '2': /* $2 */ | |
1512 | case '3': /* $3 */ | |
1513 | case '4': /* $4 */ | |
1514 | case '5': /* $5 */ | |
1515 | case '6': /* $6 */ | |
1516 | case '7': /* $7 */ | |
1517 | case '8': /* $8 */ | |
1518 | case '9': /* $9 */ | |
1519 | case '[': /* $[ */ | |
1520 | case '^': /* $^ */ | |
1521 | case '~': /* $~ */ | |
1522 | case '=': /* $= */ | |
1523 | case '%': /* $% */ | |
1524 | case '.': /* $. */ | |
1525 | case '(': /* $( */ | |
1526 | case ')': /* $) */ | |
1527 | case '<': /* $< */ | |
1528 | case '>': /* $> */ | |
1529 | case '\\': /* $\ */ | |
1530 | case '/': /* $/ */ | |
cc4c2da6 NC |
1531 | case '\001': /* $^A */ |
1532 | case '\003': /* $^C */ | |
1533 | case '\004': /* $^D */ | |
1534 | case '\005': /* $^E */ | |
1535 | case '\006': /* $^F */ | |
cc4c2da6 NC |
1536 | case '\011': /* $^I, NOT \t in EBCDIC */ |
1537 | case '\016': /* $^N */ | |
1538 | case '\017': /* $^O */ | |
1539 | case '\020': /* $^P */ | |
1540 | case '\024': /* $^T */ | |
1541 | case '\027': /* $^W */ | |
1542 | magicalize: | |
ad64d0ec | 1543 | sv_magic(GvSVn(gv), MUTABLE_SV(gv), PERL_MAGIC_sv, name, len); |
cc4c2da6 | 1544 | break; |
e521374c | 1545 | |
cc4c2da6 | 1546 | case '\014': /* $^L */ |
76f68e9b | 1547 | sv_setpvs(GvSVn(gv),"\f"); |
c69033f2 | 1548 | PL_formfeed = GvSVn(gv); |
463ee0b2 | 1549 | break; |
6361f656 | 1550 | case ';': /* $; */ |
76f68e9b | 1551 | sv_setpvs(GvSVn(gv),"\034"); |
463ee0b2 | 1552 | break; |
6361f656 | 1553 | case ']': /* $] */ |
cc4c2da6 | 1554 | { |
c69033f2 | 1555 | SV * const sv = GvSVn(gv); |
d7aa5382 | 1556 | if (!sv_derived_from(PL_patchlevel, "version")) |
ac0e6a2f | 1557 | upg_version(PL_patchlevel, TRUE); |
7d54d38e SH |
1558 | GvSV(gv) = vnumify(PL_patchlevel); |
1559 | SvREADONLY_on(GvSV(gv)); | |
1560 | SvREFCNT_dec(sv); | |
93a17b20 LW |
1561 | } |
1562 | break; | |
cc4c2da6 NC |
1563 | case '\026': /* $^V */ |
1564 | { | |
c69033f2 | 1565 | SV * const sv = GvSVn(gv); |
f9be5ac8 DM |
1566 | GvSV(gv) = new_version(PL_patchlevel); |
1567 | SvREADONLY_on(GvSV(gv)); | |
1568 | SvREFCNT_dec(sv); | |
16070b82 GS |
1569 | } |
1570 | break; | |
cc4c2da6 | 1571 | } |
79072805 | 1572 | } |
93a17b20 | 1573 | return gv; |
79072805 LW |
1574 | } |
1575 | ||
1576 | void | |
35a4481c | 1577 | Perl_gv_fullname4(pTHX_ SV *sv, const GV *gv, const char *prefix, bool keepmain) |
43693395 | 1578 | { |
35a4481c | 1579 | const char *name; |
7423f6db | 1580 | STRLEN namelen; |
35a4481c | 1581 | const HV * const hv = GvSTASH(gv); |
7918f24d NC |
1582 | |
1583 | PERL_ARGS_ASSERT_GV_FULLNAME4; | |
1584 | ||
43693395 | 1585 | if (!hv) { |
0c34ef67 | 1586 | SvOK_off(sv); |
43693395 GS |
1587 | return; |
1588 | } | |
666ea192 | 1589 | sv_setpv(sv, prefix ? prefix : ""); |
a0288114 | 1590 | |
bfcb3514 | 1591 | name = HvNAME_get(hv); |
7423f6db NC |
1592 | if (name) { |
1593 | namelen = HvNAMELEN_get(hv); | |
1594 | } else { | |
e27ad1f2 | 1595 | name = "__ANON__"; |
7423f6db NC |
1596 | namelen = 8; |
1597 | } | |
a0288114 | 1598 | |
e27ad1f2 | 1599 | if (keepmain || strNE(name, "main")) { |
7423f6db | 1600 | sv_catpvn(sv,name,namelen); |
396482e1 | 1601 | sv_catpvs(sv,"::"); |
43693395 | 1602 | } |
257984c0 | 1603 | sv_catpvn(sv,GvNAME(gv),GvNAMELEN(gv)); |
43693395 GS |
1604 | } |
1605 | ||
1606 | void | |
35a4481c | 1607 | Perl_gv_efullname4(pTHX_ SV *sv, const GV *gv, const char *prefix, bool keepmain) |
43693395 | 1608 | { |
099be4f1 | 1609 | const GV * const egv = GvEGVx(gv); |
7918f24d NC |
1610 | |
1611 | PERL_ARGS_ASSERT_GV_EFULLNAME4; | |
1612 | ||
46c461b5 | 1613 | gv_fullname4(sv, egv ? egv : gv, prefix, keepmain); |
43693395 GS |
1614 | } |
1615 | ||
79072805 | 1616 | void |
1146e912 | 1617 | Perl_gv_check(pTHX_ const HV *stash) |
79072805 | 1618 | { |
97aff369 | 1619 | dVAR; |
79072805 | 1620 | register I32 i; |
463ee0b2 | 1621 | |
7918f24d NC |
1622 | PERL_ARGS_ASSERT_GV_CHECK; |
1623 | ||
8990e307 LW |
1624 | if (!HvARRAY(stash)) |
1625 | return; | |
a0d0e21e | 1626 | for (i = 0; i <= (I32) HvMAX(stash); i++) { |
e1ec3a88 | 1627 | const HE *entry; |
dc437b57 | 1628 | for (entry = HvARRAY(stash)[i]; entry; entry = HeNEXT(entry)) { |
b7787f18 AL |
1629 | register GV *gv; |
1630 | HV *hv; | |
dc437b57 | 1631 | if (HeKEY(entry)[HeKLEN(entry)-1] == ':' && |
159b6efe | 1632 | (gv = MUTABLE_GV(HeVAL(entry))) && isGV(gv) && (hv = GvHV(gv))) |
a0d0e21e | 1633 | { |
19b6c847 | 1634 | if (hv != PL_defstash && hv != stash) |
a0d0e21e LW |
1635 | gv_check(hv); /* nested package */ |
1636 | } | |
dc437b57 | 1637 | else if (isALPHA(*HeKEY(entry))) { |
e1ec3a88 | 1638 | const char *file; |
159b6efe | 1639 | gv = MUTABLE_GV(HeVAL(entry)); |
55d729e4 | 1640 | if (SvTYPE(gv) != SVt_PVGV || GvMULTI(gv)) |
463ee0b2 | 1641 | continue; |
1d7c1841 | 1642 | file = GvFILE(gv); |
1d7c1841 GS |
1643 | CopLINE_set(PL_curcop, GvLINE(gv)); |
1644 | #ifdef USE_ITHREADS | |
dd374669 | 1645 | CopFILE(PL_curcop) = (char *)file; /* set for warning */ |
1d7c1841 | 1646 | #else |
9bde8eb0 NC |
1647 | CopFILEGV(PL_curcop) |
1648 | = gv_fetchfile_flags(file, HEK_LEN(GvFILE_HEK(gv)), 0); | |
1d7c1841 | 1649 | #endif |
9014280d | 1650 | Perl_warner(aTHX_ packWARN(WARN_ONCE), |
599cee73 | 1651 | "Name \"%s::%s\" used only once: possible typo", |
bfcb3514 | 1652 | HvNAME_get(stash), GvNAME(gv)); |
463ee0b2 | 1653 | } |
79072805 LW |
1654 | } |
1655 | } | |
1656 | } | |
1657 | ||
1658 | GV * | |
e1ec3a88 | 1659 | Perl_newGVgen(pTHX_ const char *pack) |
79072805 | 1660 | { |
97aff369 | 1661 | dVAR; |
7918f24d NC |
1662 | |
1663 | PERL_ARGS_ASSERT_NEWGVGEN; | |
1664 | ||
cea2e8a9 | 1665 | return gv_fetchpv(Perl_form(aTHX_ "%s::_GEN_%ld", pack, (long)PL_gensym++), |
6fd99bb3 | 1666 | GV_ADD, SVt_PVGV); |
79072805 LW |
1667 | } |
1668 | ||
1669 | /* hopefully this is only called on local symbol table entries */ | |
1670 | ||
1671 | GP* | |
864dbfa3 | 1672 | Perl_gp_ref(pTHX_ GP *gp) |
79072805 | 1673 | { |
97aff369 | 1674 | dVAR; |
1d7c1841 | 1675 | if (!gp) |
d4c19fe8 | 1676 | return NULL; |
79072805 | 1677 | gp->gp_refcnt++; |
44a8e56a | 1678 | if (gp->gp_cv) { |
1679 | if (gp->gp_cvgen) { | |
e1a479c5 BB |
1680 | /* If the GP they asked for a reference to contains |
1681 | a method cache entry, clear it first, so that we | |
1682 | don't infect them with our cached entry */ | |
44a8e56a | 1683 | SvREFCNT_dec(gp->gp_cv); |
601f1833 | 1684 | gp->gp_cv = NULL; |
44a8e56a | 1685 | gp->gp_cvgen = 0; |
1686 | } | |
44a8e56a | 1687 | } |
79072805 | 1688 | return gp; |
79072805 LW |
1689 | } |
1690 | ||
1691 | void | |
864dbfa3 | 1692 | Perl_gp_free(pTHX_ GV *gv) |
79072805 | 1693 | { |
97aff369 | 1694 | dVAR; |
79072805 LW |
1695 | GP* gp; |
1696 | ||
f7877b28 | 1697 | if (!gv || !isGV_with_GP(gv) || !(gp = GvGP(gv))) |
79072805 | 1698 | return; |
f248d071 | 1699 | if (gp->gp_refcnt == 0) { |
9b387841 NC |
1700 | Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL), |
1701 | "Attempt to free unreferenced glob pointers" | |
1702 | pTHX__FORMAT pTHX__VALUE); | |
79072805 LW |
1703 | return; |
1704 | } | |
748a9306 LW |
1705 | if (--gp->gp_refcnt > 0) { |
1706 | if (gp->gp_egv == gv) | |
1707 | gp->gp_egv = 0; | |
dd38834b | 1708 | GvGP(gv) = 0; |
79072805 | 1709 | return; |
748a9306 | 1710 | } |
79072805 | 1711 | |
c9ce39a9 RGS |
1712 | if (gp->gp_file_hek) |
1713 | unshare_hek(gp->gp_file_hek); | |
c9da69fb AL |
1714 | SvREFCNT_dec(gp->gp_sv); |
1715 | SvREFCNT_dec(gp->gp_av); | |
bfcb3514 NC |
1716 | /* FIXME - another reference loop GV -> symtab -> GV ? |
1717 | Somehow gp->gp_hv can end up pointing at freed garbage. */ | |
1718 | if (gp->gp_hv && SvTYPE(gp->gp_hv) == SVt_PVHV) { | |
bfcb3514 NC |
1719 | const char *hvname = HvNAME_get(gp->gp_hv); |
1720 | if (PL_stashcache && hvname) | |
04fe65b0 | 1721 | (void)hv_delete(PL_stashcache, hvname, HvNAMELEN_get(gp->gp_hv), |
7423f6db | 1722 | G_DISCARD); |
bfcb3514 | 1723 | SvREFCNT_dec(gp->gp_hv); |
13207a71 | 1724 | } |
c9da69fb AL |
1725 | SvREFCNT_dec(gp->gp_io); |
1726 | SvREFCNT_dec(gp->gp_cv); | |
1727 | SvREFCNT_dec(gp->gp_form); | |
748a9306 | 1728 | |
79072805 LW |
1729 | Safefree(gp); |
1730 | GvGP(gv) = 0; | |
1731 | } | |
1732 | ||
d460ef45 NIS |
1733 | int |
1734 | Perl_magic_freeovrld(pTHX_ SV *sv, MAGIC *mg) | |
1735 | { | |
53c1dcc0 AL |
1736 | AMT * const amtp = (AMT*)mg->mg_ptr; |
1737 | PERL_UNUSED_ARG(sv); | |
dd374669 | 1738 | |
7918f24d NC |
1739 | PERL_ARGS_ASSERT_MAGIC_FREEOVRLD; |
1740 | ||
d460ef45 NIS |
1741 | if (amtp && AMT_AMAGIC(amtp)) { |
1742 | int i; | |
1743 | for (i = 1; i < NofAMmeth; i++) { | |
53c1dcc0 | 1744 | CV * const cv = amtp->table[i]; |
b37c2d43 | 1745 | if (cv) { |
ad64d0ec | 1746 | SvREFCNT_dec(MUTABLE_SV(cv)); |
601f1833 | 1747 | amtp->table[i] = NULL; |
d460ef45 NIS |
1748 | } |
1749 | } | |
1750 | } | |
1751 | return 0; | |
1752 | } | |
1753 | ||
a0d0e21e | 1754 | /* Updates and caches the CV's */ |
c3a9a790 RGS |
1755 | /* Returns: |
1756 | * 1 on success and there is some overload | |
1757 | * 0 if there is no overload | |
1758 | * -1 if some error occurred and it couldn't croak | |
1759 | */ | |
a0d0e21e | 1760 | |
c3a9a790 | 1761 | int |
242f8760 | 1762 | Perl_Gv_AMupdate(pTHX_ HV *stash, bool destructing) |
a0d0e21e | 1763 | { |
97aff369 | 1764 | dVAR; |
ad64d0ec | 1765 | MAGIC* const mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table); |
a6006777 | 1766 | AMT amt; |
9b439311 | 1767 | const struct mro_meta* stash_meta = HvMROMETA(stash); |
e1a479c5 | 1768 | U32 newgen; |
a0d0e21e | 1769 | |
7918f24d NC |
1770 | PERL_ARGS_ASSERT_GV_AMUPDATE; |
1771 | ||
9b439311 | 1772 | newgen = PL_sub_generation + stash_meta->pkg_gen + stash_meta->cache_gen; |
14899595 NC |
1773 | if (mg) { |
1774 | const AMT * const amtp = (AMT*)mg->mg_ptr; | |
1775 | if (amtp->was_ok_am == PL_amagic_generation | |
e1a479c5 | 1776 | && amtp->was_ok_sub == newgen) { |
c3a9a790 | 1777 | return AMT_OVERLOADED(amtp) ? 1 : 0; |
14899595 | 1778 | } |
ad64d0ec | 1779 | sv_unmagic(MUTABLE_SV(stash), PERL_MAGIC_overload_table); |
14899595 | 1780 | } |
a0d0e21e | 1781 | |
bfcb3514 | 1782 | DEBUG_o( Perl_deb(aTHX_ "Recalcing overload magic in package %s\n",HvNAME_get(stash)) ); |
a0d0e21e | 1783 | |
d460ef45 | 1784 | Zero(&amt,1,AMT); |
3280af22 | 1785 | amt.was_ok_am = PL_amagic_generation; |
e1a479c5 | 1786 | amt.was_ok_sub = newgen; |
a6006777 | 1787 | amt.fallback = AMGfallNO; |
1788 | amt.flags = 0; | |
1789 | ||
a6006777 | 1790 | { |
32251b26 IZ |
1791 | int filled = 0, have_ovl = 0; |
1792 | int i, lim = 1; | |
a6006777 | 1793 | |
22c35a8c | 1794 | /* Work with "fallback" key, which we assume to be first in PL_AMG_names */ |
a6006777 | 1795 | |
89ffc314 | 1796 | /* Try to find via inheritance. */ |
53c1dcc0 AL |
1797 | GV *gv = gv_fetchmeth(stash, PL_AMG_names[0], 2, -1); |
1798 | SV * const sv = gv ? GvSV(gv) : NULL; | |
1799 | CV* cv; | |
89ffc314 IZ |
1800 | |
1801 | if (!gv) | |
32251b26 | 1802 | lim = DESTROY_amg; /* Skip overloading entries. */ |
c69033f2 NC |
1803 | #ifdef PERL_DONT_CREATE_GVSV |
1804 | else if (!sv) { | |
6f207bd3 | 1805 | NOOP; /* Equivalent to !SvTRUE and !SvOK */ |
c69033f2 NC |
1806 | } |
1807 | #endif | |
89ffc314 IZ |
1808 | else if (SvTRUE(sv)) |
1809 | amt.fallback=AMGfallYES; | |
1810 | else if (SvOK(sv)) | |
1811 | amt.fallback=AMGfallNEVER; | |
a6006777 | 1812 | |
32251b26 | 1813 | for (i = 1; i < lim; i++) |
601f1833 | 1814 | amt.table[i] = NULL; |
32251b26 | 1815 | for (; i < NofAMmeth; i++) { |
6136c704 | 1816 | const char * const cooky = PL_AMG_names[i]; |
32251b26 | 1817 | /* Human-readable form, for debugging: */ |
6136c704 | 1818 | const char * const cp = (i >= DESTROY_amg ? cooky : AMG_id2name(i)); |
d279ab82 | 1819 | const STRLEN l = PL_AMG_namelens[i]; |
89ffc314 | 1820 | |
a0288114 | 1821 | DEBUG_o( Perl_deb(aTHX_ "Checking overloading of \"%s\" in package \"%.256s\"\n", |
bfcb3514 | 1822 | cp, HvNAME_get(stash)) ); |
611c1e95 IZ |
1823 | /* don't fill the cache while looking up! |
1824 | Creation of inheritance stubs in intermediate packages may | |
1825 | conflict with the logic of runtime method substitution. | |
1826 | Indeed, for inheritance A -> B -> C, if C overloads "+0", | |
1827 | then we could have created stubs for "(+0" in A and C too. | |
1828 | But if B overloads "bool", we may want to use it for | |
1829 | numifying instead of C's "+0". */ | |
1830 | if (i >= DESTROY_amg) | |
1831 | gv = Perl_gv_fetchmeth_autoload(aTHX_ stash, cooky, l, 0); | |
1832 | else /* Autoload taken care of below */ | |
1833 | gv = Perl_gv_fetchmeth(aTHX_ stash, cooky, l, -1); | |
46fc3d4c | 1834 | cv = 0; |
89ffc314 | 1835 | if (gv && (cv = GvCV(gv))) { |
bfcb3514 | 1836 | const char *hvname; |
44a8e56a | 1837 | if (GvNAMELEN(CvGV(cv)) == 3 && strEQ(GvNAME(CvGV(cv)), "nil") |
bfcb3514 | 1838 | && strEQ(hvname = HvNAME_get(GvSTASH(CvGV(cv))), "overload")) { |
611c1e95 IZ |
1839 | /* This is a hack to support autoloading..., while |
1840 | knowing *which* methods were declared as overloaded. */ | |
44a8e56a | 1841 | /* GvSV contains the name of the method. */ |
6136c704 | 1842 | GV *ngv = NULL; |
c69033f2 | 1843 | SV *gvsv = GvSV(gv); |
a0288114 AL |
1844 | |
1845 | DEBUG_o( Perl_deb(aTHX_ "Resolving method \"%"SVf256\ | |
1846 | "\" for overloaded \"%s\" in package \"%.256s\"\n", | |
ca0270c4 | 1847 | (void*)GvSV(gv), cp, hvname) ); |
c69033f2 NC |
1848 | if (!gvsv || !SvPOK(gvsv) |
1849 | || !(ngv = gv_fetchmethod_autoload(stash, SvPVX_const(gvsv), | |
dc848c6f | 1850 | FALSE))) |
1851 | { | |
a0288114 | 1852 | /* Can be an import stub (created by "can"). */ |
242f8760 | 1853 | if (destructing) { |
c3a9a790 | 1854 | return -1; |
242f8760 RGS |
1855 | } |
1856 | else { | |
1857 | const char * const name = (gvsv && SvPOK(gvsv)) ? SvPVX_const(gvsv) : "???"; | |
1858 | Perl_croak(aTHX_ "%s method \"%.256s\" overloading \"%s\" "\ | |
1859 | "in package \"%.256s\"", | |
1860 | (GvCVGEN(gv) ? "Stub found while resolving" | |
1861 | : "Can't resolve"), | |
1862 | name, cp, hvname); | |
1863 | } | |
44a8e56a | 1864 | } |
dc848c6f | 1865 | cv = GvCV(gv = ngv); |
44a8e56a | 1866 | } |
b464bac0 | 1867 | DEBUG_o( Perl_deb(aTHX_ "Overloading \"%s\" in package \"%.256s\" via \"%.256s::%.256s\"\n", |
bfcb3514 | 1868 | cp, HvNAME_get(stash), HvNAME_get(GvSTASH(CvGV(cv))), |
44a8e56a | 1869 | GvNAME(CvGV(cv))) ); |
1870 | filled = 1; | |
32251b26 IZ |
1871 | if (i < DESTROY_amg) |
1872 | have_ovl = 1; | |
611c1e95 | 1873 | } else if (gv) { /* Autoloaded... */ |
ea726b52 | 1874 | cv = MUTABLE_CV(gv); |
611c1e95 | 1875 | filled = 1; |
44a8e56a | 1876 | } |
ea726b52 | 1877 | amt.table[i]=MUTABLE_CV(SvREFCNT_inc_simple(cv)); |
a0d0e21e | 1878 | } |
a0d0e21e | 1879 | if (filled) { |
a6006777 | 1880 | AMT_AMAGIC_on(&amt); |
32251b26 IZ |
1881 | if (have_ovl) |
1882 | AMT_OVERLOADED_on(&amt); | |
ad64d0ec | 1883 | sv_magic(MUTABLE_SV(stash), 0, PERL_MAGIC_overload_table, |
14befaf4 | 1884 | (char*)&amt, sizeof(AMT)); |
32251b26 | 1885 | return have_ovl; |
a0d0e21e LW |
1886 | } |
1887 | } | |
a6006777 | 1888 | /* Here we have no table: */ |
9cbac4c7 | 1889 | /* no_table: */ |
a6006777 | 1890 | AMT_AMAGIC_off(&amt); |
ad64d0ec | 1891 | sv_magic(MUTABLE_SV(stash), 0, PERL_MAGIC_overload_table, |
14befaf4 | 1892 | (char*)&amt, sizeof(AMTS)); |
c3a9a790 | 1893 | return 0; |
a0d0e21e LW |
1894 | } |
1895 | ||
32251b26 IZ |
1896 | |
1897 | CV* | |
1898 | Perl_gv_handler(pTHX_ HV *stash, I32 id) | |
1899 | { | |
97aff369 | 1900 | dVAR; |
3f8f4626 | 1901 | MAGIC *mg; |
32251b26 | 1902 | AMT *amtp; |
e1a479c5 | 1903 | U32 newgen; |
9b439311 | 1904 | struct mro_meta* stash_meta; |
32251b26 | 1905 | |
bfcb3514 | 1906 | if (!stash || !HvNAME_get(stash)) |
601f1833 | 1907 | return NULL; |
e1a479c5 | 1908 | |
9b439311 BB |
1909 | stash_meta = HvMROMETA(stash); |
1910 | newgen = PL_sub_generation + stash_meta->pkg_gen + stash_meta->cache_gen; | |
e1a479c5 | 1911 | |
ad64d0ec | 1912 | mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table); |
32251b26 IZ |
1913 | if (!mg) { |
1914 | do_update: | |
242f8760 RGS |
1915 | /* If we're looking up a destructor to invoke, we must avoid |
1916 | * that Gv_AMupdate croaks, because we might be dying already */ | |
2dcac756 | 1917 | if (Gv_AMupdate(stash, cBOOL(id == DESTROY_amg)) == -1) { |
242f8760 RGS |
1918 | /* and if it didn't found a destructor, we fall back |
1919 | * to a simpler method that will only look for the | |
1920 | * destructor instead of the whole magic */ | |
1921 | if (id == DESTROY_amg) { | |
1922 | GV * const gv = gv_fetchmethod(stash, "DESTROY"); | |
1923 | if (gv) | |
1924 | return GvCV(gv); | |
1925 | } | |
1926 | return NULL; | |
1927 | } | |
ad64d0ec | 1928 | mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table); |
32251b26 | 1929 | } |
a9fd4e40 | 1930 | assert(mg); |
32251b26 IZ |
1931 | amtp = (AMT*)mg->mg_ptr; |
1932 | if ( amtp->was_ok_am != PL_amagic_generation | |
e1a479c5 | 1933 | || amtp->was_ok_sub != newgen ) |
32251b26 | 1934 | goto do_update; |
3ad83ce7 | 1935 | if (AMT_AMAGIC(amtp)) { |
b7787f18 | 1936 | CV * const ret = amtp->table[id]; |
3ad83ce7 AMS |
1937 | if (ret && isGV(ret)) { /* Autoloading stab */ |
1938 | /* Passing it through may have resulted in a warning | |
1939 | "Inherited AUTOLOAD for a non-method deprecated", since | |
1940 | our caller is going through a function call, not a method call. | |
1941 | So return the CV for AUTOLOAD, setting $AUTOLOAD. */ | |
890ce7af | 1942 | GV * const gv = gv_fetchmethod(stash, PL_AMG_names[id]); |
3ad83ce7 AMS |
1943 | |
1944 | if (gv && GvCV(gv)) | |
1945 | return GvCV(gv); | |
1946 | } | |
1947 | return ret; | |
1948 | } | |
a0288114 | 1949 | |
601f1833 | 1950 | return NULL; |
32251b26 IZ |
1951 | } |
1952 | ||
1953 | ||
6f1401dc DM |
1954 | /* Implement tryAMAGICun_MG macro. |
1955 | Do get magic, then see if the stack arg is overloaded and if so call it. | |
1956 | Flags: | |
1957 | AMGf_set return the arg using SETs rather than assigning to | |
1958 | the targ | |
1959 | AMGf_numeric apply sv_2num to the stack arg. | |
1960 | */ | |
1961 | ||
1962 | bool | |
1963 | Perl_try_amagic_un(pTHX_ int method, int flags) { | |
1964 | dVAR; | |
1965 | dSP; | |
1966 | SV* tmpsv; | |
1967 | SV* const arg = TOPs; | |
1968 | ||
1969 | SvGETMAGIC(arg); | |
1970 | ||
9f8bf298 NC |
1971 | if (SvAMAGIC(arg) && (tmpsv = amagic_call(arg, &PL_sv_undef, method, |
1972 | AMGf_noright | AMGf_unary))) { | |
6f1401dc DM |
1973 | if (flags & AMGf_set) { |
1974 | SETs(tmpsv); | |
1975 | } | |
1976 | else { | |
1977 | dTARGET; | |
1978 | if (SvPADMY(TARG)) { | |
1979 | sv_setsv(TARG, tmpsv); | |
1980 | SETTARG; | |
1981 | } | |
1982 | else | |
1983 | SETs(tmpsv); | |
1984 | } | |
1985 | PUTBACK; | |
1986 | return TRUE; | |
1987 | } | |
1988 | ||
1989 | if ((flags & AMGf_numeric) && SvROK(arg)) | |
1990 | *sp = sv_2num(arg); | |
1991 | return FALSE; | |
1992 | } | |
1993 | ||
1994 | ||
1995 | /* Implement tryAMAGICbin_MG macro. | |
1996 | Do get magic, then see if the two stack args are overloaded and if so | |
1997 | call it. | |
1998 | Flags: | |
1999 | AMGf_set return the arg using SETs rather than assigning to | |
2000 | the targ | |
2001 | AMGf_assign op may be called as mutator (eg +=) | |
2002 | AMGf_numeric apply sv_2num to the stack arg. | |
2003 | */ | |
2004 | ||
2005 | bool | |
2006 | Perl_try_amagic_bin(pTHX_ int method, int flags) { | |
2007 | dVAR; | |
2008 | dSP; | |
2009 | SV* const left = TOPm1s; | |
2010 | SV* const right = TOPs; | |
2011 | ||
2012 | SvGETMAGIC(left); | |
2013 | if (left != right) | |
2014 | SvGETMAGIC(right); | |
2015 | ||
2016 | if (SvAMAGIC(left) || SvAMAGIC(right)) { | |
2017 | SV * const tmpsv = amagic_call(left, right, method, | |
2018 | ((flags & AMGf_assign) && opASSIGN ? AMGf_assign: 0)); | |
2019 | if (tmpsv) { | |
2020 | if (flags & AMGf_set) { | |
2021 | (void)POPs; | |
2022 | SETs(tmpsv); | |
2023 | } | |
2024 | else { | |
2025 | dATARGET; | |
2026 | (void)POPs; | |
2027 | if (opASSIGN || SvPADMY(TARG)) { | |
2028 | sv_setsv(TARG, tmpsv); | |
2029 | SETTARG; | |
2030 | } | |
2031 | else | |
2032 | SETs(tmpsv); | |
2033 | } | |
2034 | PUTBACK; | |
2035 | return TRUE; | |
2036 | } | |
2037 | } | |
2038 | if (flags & AMGf_numeric) { | |
2039 | if (SvROK(left)) | |
2040 | *(sp-1) = sv_2num(left); | |
2041 | if (SvROK(right)) | |
2042 | *sp = sv_2num(right); | |
2043 | } | |
2044 | return FALSE; | |
2045 | } | |
2046 | ||
25a9ffce NC |
2047 | SV * |
2048 | Perl_amagic_deref_call(pTHX_ SV *ref, int method) { | |
2049 | SV *tmpsv = NULL; | |
2050 | ||
2051 | PERL_ARGS_ASSERT_AMAGIC_DEREF_CALL; | |
2052 | ||
2053 | while (SvAMAGIC(ref) && | |
2054 | (tmpsv = amagic_call(ref, &PL_sv_undef, method, | |
2055 | AMGf_noright | AMGf_unary))) { | |
2056 | if (!SvROK(tmpsv)) | |
2057 | Perl_croak(aTHX_ "Overloaded dereference did not return a reference"); | |
2058 | if (tmpsv == ref || SvRV(tmpsv) == SvRV(ref)) { | |
2059 | /* Bail out if it returns us the same reference. */ | |
2060 | return tmpsv; | |
2061 | } | |
2062 | ref = tmpsv; | |
2063 | } | |
2064 | return tmpsv ? tmpsv : ref; | |
2065 | } | |
6f1401dc | 2066 | |
a0d0e21e | 2067 | SV* |
864dbfa3 | 2068 | Perl_amagic_call(pTHX_ SV *left, SV *right, int method, int flags) |
a0d0e21e | 2069 | { |
27da23d5 | 2070 | dVAR; |
b267980d | 2071 | MAGIC *mg; |
9c5ffd7c | 2072 | CV *cv=NULL; |
a0d0e21e | 2073 | CV **cvp=NULL, **ocvp=NULL; |
9c5ffd7c | 2074 | AMT *amtp=NULL, *oamtp=NULL; |
b464bac0 AL |
2075 | int off = 0, off1, lr = 0, notfound = 0; |
2076 | int postpr = 0, force_cpy = 0; | |
2077 | int assign = AMGf_assign & flags; | |
2078 | const int assignshift = assign ? 1 : 0; | |
bf5522a1 | 2079 | int use_default_op = 0; |
497b47a8 JH |
2080 | #ifdef DEBUGGING |
2081 | int fl=0; | |
497b47a8 | 2082 | #endif |
25716404 | 2083 | HV* stash=NULL; |
7918f24d NC |
2084 | |
2085 | PERL_ARGS_ASSERT_AMAGIC_CALL; | |
2086 | ||
e46c382e | 2087 | if ( PL_curcop->cop_hints & HINT_NO_AMAGIC ) { |
20439bc7 | 2088 | SV *lex_mask = cop_hints_fetch_pvs(PL_curcop, "overloading", 0); |
e46c382e YK |
2089 | |
2090 | if ( !lex_mask || !SvOK(lex_mask) ) | |
2091 | /* overloading lexically disabled */ | |
2092 | return NULL; | |
2093 | else if ( lex_mask && SvPOK(lex_mask) ) { | |
2094 | /* we have an entry in the hints hash, check if method has been | |
2095 | * masked by overloading.pm */ | |
d15cd831 | 2096 | STRLEN len; |
e46c382e | 2097 | const int offset = method / 8; |
d87d3eed | 2098 | const int bit = method % 8; |
e46c382e YK |
2099 | char *pv = SvPV(lex_mask, len); |
2100 | ||
d15cd831 | 2101 | /* Bit set, so this overloading operator is disabled */ |
ed15e576 | 2102 | if ( (STRLEN)offset < len && pv[offset] & ( 1 << bit ) ) |
e46c382e YK |
2103 | return NULL; |
2104 | } | |
2105 | } | |
2106 | ||
a0d0e21e | 2107 | if (!(AMGf_noleft & flags) && SvAMAGIC(left) |
25716404 | 2108 | && (stash = SvSTASH(SvRV(left))) |
ad64d0ec | 2109 | && (mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table)) |
b267980d | 2110 | && (ocvp = cvp = (AMT_AMAGIC((AMT*)mg->mg_ptr) |
a6006777 | 2111 | ? (oamtp = amtp = (AMT*)mg->mg_ptr)->table |
d4c19fe8 | 2112 | : NULL)) |
b267980d | 2113 | && ((cv = cvp[off=method+assignshift]) |
748a9306 LW |
2114 | || (assign && amtp->fallback > AMGfallNEVER && /* fallback to |
2115 | * usual method */ | |
497b47a8 JH |
2116 | ( |
2117 | #ifdef DEBUGGING | |
2118 | fl = 1, | |
a0288114 | 2119 | #endif |
497b47a8 | 2120 | cv = cvp[off=method])))) { |
a0d0e21e LW |
2121 | lr = -1; /* Call method for left argument */ |
2122 | } else { | |
2123 | if (cvp && amtp->fallback > AMGfallNEVER && flags & AMGf_unary) { | |
2124 | int logic; | |
2125 | ||
2126 | /* look for substituted methods */ | |
ee239bfe | 2127 | /* In all the covered cases we should be called with assign==0. */ |
a0d0e21e LW |
2128 | switch (method) { |
2129 | case inc_amg: | |
ee239bfe IZ |
2130 | force_cpy = 1; |
2131 | if ((cv = cvp[off=add_ass_amg]) | |
2132 | || ((cv = cvp[off = add_amg]) && (force_cpy = 0, postpr = 1))) { | |
3280af22 | 2133 | right = &PL_sv_yes; lr = -1; assign = 1; |
a0d0e21e LW |
2134 | } |
2135 | break; | |
2136 | case dec_amg: | |
ee239bfe IZ |
2137 | force_cpy = 1; |
2138 | if ((cv = cvp[off = subtr_ass_amg]) | |
2139 | || ((cv = cvp[off = subtr_amg]) && (force_cpy = 0, postpr=1))) { | |
3280af22 | 2140 | right = &PL_sv_yes; lr = -1; assign = 1; |
a0d0e21e LW |
2141 | } |
2142 | break; | |
2143 | case bool__amg: | |
2144 | (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=string_amg])); | |
2145 | break; | |
2146 | case numer_amg: | |
2147 | (void)((cv = cvp[off=string_amg]) || (cv = cvp[off=bool__amg])); | |
2148 | break; | |
2149 | case string_amg: | |
2150 | (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=bool__amg])); | |
2151 | break; | |
b7787f18 AL |
2152 | case not_amg: |
2153 | (void)((cv = cvp[off=bool__amg]) | |
2154 | || (cv = cvp[off=numer_amg]) | |
2155 | || (cv = cvp[off=string_amg])); | |
2ab54efd MB |
2156 | if (cv) |
2157 | postpr = 1; | |
b7787f18 | 2158 | break; |
748a9306 LW |
2159 | case copy_amg: |
2160 | { | |
76e3520e GS |
2161 | /* |
2162 | * SV* ref causes confusion with the interpreter variable of | |
2163 | * the same name | |
2164 | */ | |
890ce7af | 2165 | SV* const tmpRef=SvRV(left); |
76e3520e | 2166 | if (!SvROK(tmpRef) && SvTYPE(tmpRef) <= SVt_PVMG) { |
fc36a67e | 2167 | /* |
2168 | * Just to be extra cautious. Maybe in some | |
2169 | * additional cases sv_setsv is safe, too. | |
2170 | */ | |
890ce7af | 2171 | SV* const newref = newSVsv(tmpRef); |
748a9306 | 2172 | SvOBJECT_on(newref); |
96d4b0ee NC |
2173 | /* As a bit of a source compatibility hack, SvAMAGIC() and |
2174 | friends dereference an RV, to behave the same was as when | |
2175 | overloading was stored on the reference, not the referant. | |
2176 | Hence we can't use SvAMAGIC_on() | |
2177 | */ | |
2178 | SvFLAGS(newref) |= SVf_AMAGIC; | |
85fbaab2 | 2179 | SvSTASH_set(newref, MUTABLE_HV(SvREFCNT_inc(SvSTASH(tmpRef)))); |
748a9306 LW |
2180 | return newref; |
2181 | } | |
2182 | } | |
2183 | break; | |
a0d0e21e | 2184 | case abs_amg: |
b267980d | 2185 | if ((cvp[off1=lt_amg] || cvp[off1=ncmp_amg]) |
a0d0e21e | 2186 | && ((cv = cvp[off=neg_amg]) || (cv = cvp[off=subtr_amg]))) { |
890ce7af | 2187 | SV* const nullsv=sv_2mortal(newSViv(0)); |
a0d0e21e | 2188 | if (off1==lt_amg) { |
890ce7af | 2189 | SV* const lessp = amagic_call(left,nullsv, |
a0d0e21e LW |
2190 | lt_amg,AMGf_noright); |
2191 | logic = SvTRUE(lessp); | |
2192 | } else { | |
890ce7af | 2193 | SV* const lessp = amagic_call(left,nullsv, |
a0d0e21e LW |
2194 | ncmp_amg,AMGf_noright); |
2195 | logic = (SvNV(lessp) < 0); | |
2196 | } | |
2197 | if (logic) { | |
2198 | if (off==subtr_amg) { | |
2199 | right = left; | |
748a9306 | 2200 | left = nullsv; |
a0d0e21e LW |
2201 | lr = 1; |
2202 | } | |
2203 | } else { | |
2204 | return left; | |
2205 | } | |
2206 | } | |
2207 | break; | |
2208 | case neg_amg: | |
155aba94 | 2209 | if ((cv = cvp[off=subtr_amg])) { |
a0d0e21e LW |
2210 | right = left; |
2211 | left = sv_2mortal(newSViv(0)); | |
2212 | lr = 1; | |
2213 | } | |
2214 | break; | |
f216259d | 2215 | case int_amg: |
f5284f61 | 2216 | case iter_amg: /* XXXX Eventually should do to_gv. */ |
c4c7412c | 2217 | case ftest_amg: /* XXXX Eventually should do to_gv. */ |
d4b87e75 | 2218 | case regexp_amg: |
b267980d NIS |
2219 | /* FAIL safe */ |
2220 | return NULL; /* Delegate operation to standard mechanisms. */ | |
2221 | break; | |
f5284f61 IZ |
2222 | case to_sv_amg: |
2223 | case to_av_amg: | |
2224 | case to_hv_amg: | |
2225 | case to_gv_amg: | |
2226 | case to_cv_amg: | |
2227 | /* FAIL safe */ | |
b267980d | 2228 | return left; /* Delegate operation to standard mechanisms. */ |
f5284f61 | 2229 | break; |
a0d0e21e LW |
2230 | default: |
2231 | goto not_found; | |
2232 | } | |
2233 | if (!cv) goto not_found; | |
2234 | } else if (!(AMGf_noright & flags) && SvAMAGIC(right) | |
25716404 | 2235 | && (stash = SvSTASH(SvRV(right))) |
ad64d0ec | 2236 | && (mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table)) |
b267980d | 2237 | && (cvp = (AMT_AMAGIC((AMT*)mg->mg_ptr) |
a6006777 | 2238 | ? (amtp = (AMT*)mg->mg_ptr)->table |
d4c19fe8 | 2239 | : NULL)) |
a0d0e21e LW |
2240 | && (cv = cvp[off=method])) { /* Method for right |
2241 | * argument found */ | |
2242 | lr=1; | |
bf5522a1 MB |
2243 | } else if (((cvp && amtp->fallback > AMGfallNEVER) |
2244 | || (ocvp && oamtp->fallback > AMGfallNEVER)) | |
a0d0e21e LW |
2245 | && !(flags & AMGf_unary)) { |
2246 | /* We look for substitution for | |
2247 | * comparison operations and | |
fc36a67e | 2248 | * concatenation */ |
a0d0e21e LW |
2249 | if (method==concat_amg || method==concat_ass_amg |
2250 | || method==repeat_amg || method==repeat_ass_amg) { | |
2251 | return NULL; /* Delegate operation to string conversion */ | |
2252 | } | |
2253 | off = -1; | |
2254 | switch (method) { | |
2255 | case lt_amg: | |
2256 | case le_amg: | |
2257 | case gt_amg: | |
2258 | case ge_amg: | |
2259 | case eq_amg: | |
2260 | case ne_amg: | |
2ab54efd MB |
2261 | off = ncmp_amg; |
2262 | break; | |
a0d0e21e LW |
2263 | case slt_amg: |
2264 | case sle_amg: | |
2265 | case sgt_amg: | |
2266 | case sge_amg: | |
2267 | case seq_amg: | |
2268 | case sne_amg: | |
2ab54efd MB |
2269 | off = scmp_amg; |
2270 | break; | |
a0d0e21e | 2271 | } |
bf5522a1 MB |
2272 | if (off != -1) { |
2273 | if (ocvp && (oamtp->fallback > AMGfallNEVER)) { | |
2274 | cv = ocvp[off]; | |
2275 | lr = -1; | |
2276 | } | |
2277 | if (!cv && (cvp && amtp->fallback > AMGfallNEVER)) { | |
2278 | cv = cvp[off]; | |
2279 | lr = 1; | |
2280 | } | |
2281 | } | |
2282 | if (cv) | |
2ab54efd MB |
2283 | postpr = 1; |
2284 | else | |
2285 | goto not_found; | |
a0d0e21e | 2286 | } else { |
a6006777 | 2287 | not_found: /* No method found, either report or croak */ |
b267980d NIS |
2288 | switch (method) { |
2289 | case to_sv_amg: | |
2290 | case to_av_amg: | |
2291 | case to_hv_amg: | |
2292 | case to_gv_amg: | |
2293 | case to_cv_amg: | |
2294 | /* FAIL safe */ | |
2295 | return left; /* Delegate operation to standard mechanisms. */ | |
2296 | break; | |
2297 | } | |
a0d0e21e LW |
2298 | if (ocvp && (cv=ocvp[nomethod_amg])) { /* Call report method */ |
2299 | notfound = 1; lr = -1; | |
2300 | } else if (cvp && (cv=cvp[nomethod_amg])) { | |
2301 | notfound = 1; lr = 1; | |
bf5522a1 MB |
2302 | } else if ((use_default_op = |
2303 | (!ocvp || oamtp->fallback >= AMGfallYES) | |
2304 | && (!cvp || amtp->fallback >= AMGfallYES)) | |
2305 | && !DEBUG_o_TEST) { | |
4cc0ca18 NC |
2306 | /* Skip generating the "no method found" message. */ |
2307 | return NULL; | |
a0d0e21e | 2308 | } else { |
46fc3d4c | 2309 | SV *msg; |
774d564b | 2310 | if (off==-1) off=method; |
b267980d | 2311 | msg = sv_2mortal(Perl_newSVpvf(aTHX_ |
a0288114 | 2312 | "Operation \"%s\": no method found,%sargument %s%s%s%s", |
89ffc314 | 2313 | AMG_id2name(method + assignshift), |
e7ea3e70 | 2314 | (flags & AMGf_unary ? " " : "\n\tleft "), |
b267980d | 2315 | SvAMAGIC(left)? |
a0d0e21e LW |
2316 | "in overloaded package ": |
2317 | "has no overloaded magic", | |
b267980d | 2318 | SvAMAGIC(left)? |
bfcb3514 | 2319 | HvNAME_get(SvSTASH(SvRV(left))): |
a0d0e21e | 2320 | "", |
b267980d | 2321 | SvAMAGIC(right)? |
e7ea3e70 | 2322 | ",\n\tright argument in overloaded package ": |
b267980d | 2323 | (flags & AMGf_unary |
e7ea3e70 IZ |
2324 | ? "" |
2325 | : ",\n\tright argument has no overloaded magic"), | |
b267980d | 2326 | SvAMAGIC(right)? |
bfcb3514 | 2327 | HvNAME_get(SvSTASH(SvRV(right))): |
46fc3d4c | 2328 | "")); |
bf5522a1 | 2329 | if (use_default_op) { |
b15aece3 | 2330 | DEBUG_o( Perl_deb(aTHX_ "%s", SvPVX_const(msg)) ); |
a0d0e21e | 2331 | } else { |
be2597df | 2332 | Perl_croak(aTHX_ "%"SVf, SVfARG(msg)); |
a0d0e21e LW |
2333 | } |
2334 | return NULL; | |
2335 | } | |
ee239bfe | 2336 | force_cpy = force_cpy || assign; |
a0d0e21e LW |
2337 | } |
2338 | } | |
497b47a8 | 2339 | #ifdef DEBUGGING |
a0d0e21e | 2340 | if (!notfound) { |
497b47a8 | 2341 | DEBUG_o(Perl_deb(aTHX_ |
a0288114 | 2342 | "Overloaded operator \"%s\"%s%s%s:\n\tmethod%s found%s in package %s%s\n", |
497b47a8 JH |
2343 | AMG_id2name(off), |
2344 | method+assignshift==off? "" : | |
a0288114 | 2345 | " (initially \"", |
497b47a8 JH |
2346 | method+assignshift==off? "" : |
2347 | AMG_id2name(method+assignshift), | |
a0288114 | 2348 | method+assignshift==off? "" : "\")", |
497b47a8 JH |
2349 | flags & AMGf_unary? "" : |
2350 | lr==1 ? " for right argument": " for left argument", | |
2351 | flags & AMGf_unary? " for argument" : "", | |
bfcb3514 | 2352 | stash ? HvNAME_get(stash) : "null", |
497b47a8 | 2353 | fl? ",\n\tassignment variant used": "") ); |
ee239bfe | 2354 | } |
497b47a8 | 2355 | #endif |
748a9306 LW |
2356 | /* Since we use shallow copy during assignment, we need |
2357 | * to dublicate the contents, probably calling user-supplied | |
2358 | * version of copy operator | |
2359 | */ | |
ee239bfe IZ |
2360 | /* We need to copy in following cases: |
2361 | * a) Assignment form was called. | |
2362 | * assignshift==1, assign==T, method + 1 == off | |
2363 | * b) Increment or decrement, called directly. | |
2364 | * assignshift==0, assign==0, method + 0 == off | |
2365 | * c) Increment or decrement, translated to assignment add/subtr. | |
b267980d | 2366 | * assignshift==0, assign==T, |
ee239bfe IZ |
2367 | * force_cpy == T |
2368 | * d) Increment or decrement, translated to nomethod. | |
b267980d | 2369 | * assignshift==0, assign==0, |
ee239bfe IZ |
2370 | * force_cpy == T |
2371 | * e) Assignment form translated to nomethod. | |
2372 | * assignshift==1, assign==T, method + 1 != off | |
2373 | * force_cpy == T | |
2374 | */ | |
2375 | /* off is method, method+assignshift, or a result of opcode substitution. | |
2376 | * In the latter case assignshift==0, so only notfound case is important. | |
2377 | */ | |
2378 | if (( (method + assignshift == off) | |
2379 | && (assign || (method == inc_amg) || (method == dec_amg))) | |
2380 | || force_cpy) | |
6f1401dc | 2381 | { |
1b38c28e NC |
2382 | /* newSVsv does not behave as advertised, so we copy missing |
2383 | * information by hand */ | |
2384 | SV *tmpRef = SvRV(left); | |
2385 | SV *rv_copy; | |
2386 | if (SvREFCNT(tmpRef) > 1 && (rv_copy = AMG_CALLun(left,copy))) { | |
2387 | SvRV_set(left, rv_copy); | |
2388 | SvSETMAGIC(left); | |
2389 | SvREFCNT_dec(tmpRef); | |
2390 | } | |
6f1401dc DM |
2391 | } |
2392 | ||
a0d0e21e LW |
2393 | { |
2394 | dSP; | |
2395 | BINOP myop; | |
2396 | SV* res; | |
b7787f18 | 2397 | const bool oldcatch = CATCH_GET; |
a0d0e21e | 2398 | |
54310121 | 2399 | CATCH_SET(TRUE); |
a0d0e21e LW |
2400 | Zero(&myop, 1, BINOP); |
2401 | myop.op_last = (OP *) &myop; | |
b37c2d43 | 2402 | myop.op_next = NULL; |
54310121 | 2403 | myop.op_flags = OPf_WANT_SCALAR | OPf_STACKED; |
a0d0e21e | 2404 | |
e788e7d3 | 2405 | PUSHSTACKi(PERLSI_OVERLOAD); |
a0d0e21e | 2406 | ENTER; |
462e5cf6 | 2407 | SAVEOP(); |
533c011a | 2408 | PL_op = (OP *) &myop; |
3280af22 | 2409 | if (PERLDB_SUB && PL_curstash != PL_debstash) |
533c011a | 2410 | PL_op->op_private |= OPpENTERSUB_DB; |
a0d0e21e | 2411 | PUTBACK; |
cea2e8a9 | 2412 | pp_pushmark(); |
a0d0e21e | 2413 | |
924508f0 | 2414 | EXTEND(SP, notfound + 5); |
a0d0e21e LW |
2415 | PUSHs(lr>0? right: left); |
2416 | PUSHs(lr>0? left: right); | |
3280af22 | 2417 | PUSHs( lr > 0 ? &PL_sv_yes : ( assign ? &PL_sv_undef : &PL_sv_no )); |
a0d0e21e | 2418 | if (notfound) { |
59cd0e26 NC |
2419 | PUSHs(newSVpvn_flags(AMG_id2name(method + assignshift), |
2420 | AMG_id2namelen(method + assignshift), SVs_TEMP)); | |
a0d0e21e | 2421 | } |
ad64d0ec | 2422 | PUSHs(MUTABLE_SV(cv)); |
a0d0e21e LW |
2423 | PUTBACK; |
2424 | ||
139d0ce6 | 2425 | if ((PL_op = PL_ppaddr[OP_ENTERSUB](aTHX))) |
cea2e8a9 | 2426 | CALLRUNOPS(aTHX); |
a0d0e21e LW |
2427 | LEAVE; |
2428 | SPAGAIN; | |
2429 | ||
2430 | res=POPs; | |
ebafeae7 | 2431 | PUTBACK; |
d3acc0f7 | 2432 | POPSTACK; |
54310121 | 2433 | CATCH_SET(oldcatch); |
a0d0e21e | 2434 | |
a0d0e21e | 2435 | if (postpr) { |
b7787f18 | 2436 | int ans; |
a0d0e21e LW |
2437 | switch (method) { |
2438 | case le_amg: | |
2439 | case sle_amg: | |
2440 | ans=SvIV(res)<=0; break; | |
2441 | case lt_amg: | |
2442 | case slt_amg: | |
2443 | ans=SvIV(res)<0; break; | |
2444 | case ge_amg: | |
2445 | case sge_amg: | |
2446 | ans=SvIV(res)>=0; break; | |
2447 | case gt_amg: | |
2448 | case sgt_amg: | |
2449 | ans=SvIV(res)>0; break; | |
2450 | case eq_amg: | |
2451 | case seq_amg: | |
2452 | ans=SvIV(res)==0; break; | |
2453 | case ne_amg: | |
2454 | case sne_amg: | |
2455 | ans=SvIV(res)!=0; break; | |
2456 | case inc_amg: | |
2457 | case dec_amg: | |
bbce6d69 | 2458 | SvSetSV(left,res); return left; |
dc437b57 | 2459 | case not_amg: |
fe7ac86a | 2460 | ans=!SvTRUE(res); break; |
b7787f18 AL |
2461 | default: |
2462 | ans=0; break; | |
a0d0e21e | 2463 | } |
54310121 | 2464 | return boolSV(ans); |
748a9306 LW |
2465 | } else if (method==copy_amg) { |
2466 | if (!SvROK(res)) { | |
cea2e8a9 | 2467 | Perl_croak(aTHX_ "Copy method did not return a reference"); |
748a9306 LW |
2468 | } |
2469 | return SvREFCNT_inc(SvRV(res)); | |
a0d0e21e LW |
2470 | } else { |
2471 | return res; | |
2472 | } | |
2473 | } | |
2474 | } | |
c9d5ac95 GS |
2475 | |
2476 | /* | |
7fc63493 | 2477 | =for apidoc is_gv_magical_sv |
c9d5ac95 GS |
2478 | |
2479 | Returns C<TRUE> if given the name of a magical GV. | |
2480 | ||
2481 | Currently only useful internally when determining if a GV should be | |
2482 | created even in rvalue contexts. | |
2483 | ||
2484 | C<flags> is not used at present but available for future extension to | |
2485 | allow selecting particular classes of magical variable. | |
2486 | ||
b9b0e72c NC |
2487 | Currently assumes that C<name> is NUL terminated (as well as len being valid). |
2488 | This assumption is met by all callers within the perl core, which all pass | |
2489 | pointers returned by SvPV. | |
2490 | ||
c9d5ac95 GS |
2491 | =cut |
2492 | */ | |
9d8f40c4 | 2493 | |
c9d5ac95 | 2494 | bool |
9d8f40c4 | 2495 | Perl_is_gv_magical_sv(pTHX_ SV *const name_sv, U32 flags) |
c9d5ac95 | 2496 | { |
9d8f40c4 NC |
2497 | STRLEN len; |
2498 | const char *const name = SvPV_const(name_sv, len); | |
9d4ba2ae | 2499 | |
9d8f40c4 NC |
2500 | PERL_UNUSED_ARG(flags); |
2501 | PERL_ARGS_ASSERT_IS_GV_MAGICAL_SV; | |
7918f24d | 2502 | |
b9b0e72c | 2503 | if (len > 1) { |
b464bac0 | 2504 | const char * const name1 = name + 1; |
b9b0e72c NC |
2505 | switch (*name) { |
2506 | case 'I': | |
f2df7081 | 2507 | if (len == 3 && name[1] == 'S' && name[2] == 'A') |
b9b0e72c NC |
2508 | goto yes; |
2509 | break; | |
2510 | case 'O': | |
9431620d | 2511 | if (len == 8 && strEQ(name1, "VERLOAD")) |
b9b0e72c NC |
2512 | goto yes; |
2513 | break; | |
2514 | case 'S': | |
9431620d | 2515 | if (len == 3 && name[1] == 'I' && name[2] == 'G') |
b9b0e72c NC |
2516 | goto yes; |
2517 | break; | |
2518 | /* Using ${^...} variables is likely to be sufficiently rare that | |
2519 | it seems sensible to avoid the space hit of also checking the | |
2520 | length. */ | |
2521 | case '\017': /* ${^OPEN} */ | |
9431620d | 2522 | if (strEQ(name1, "PEN")) |
b9b0e72c NC |
2523 | goto yes; |
2524 | break; | |
2525 | case '\024': /* ${^TAINT} */ | |
9431620d | 2526 | if (strEQ(name1, "AINT")) |
b9b0e72c NC |
2527 | goto yes; |
2528 | break; | |
2529 | case '\025': /* ${^UNICODE} */ | |
9431620d | 2530 | if (strEQ(name1, "NICODE")) |
b9b0e72c | 2531 | goto yes; |
a0288114 | 2532 | if (strEQ(name1, "TF8LOCALE")) |
7cebcbc0 | 2533 | goto yes; |
b9b0e72c NC |
2534 | break; |
2535 | case '\027': /* ${^WARNING_BITS} */ | |
9431620d | 2536 | if (strEQ(name1, "ARNING_BITS")) |
b9b0e72c NC |
2537 | goto yes; |
2538 | break; | |
2539 | case '1': | |
2540 | case '2': | |
2541 | case '3': | |
2542 | case '4': | |
2543 | case '5': | |
2544 | case '6': | |
2545 | case '7': | |
2546 | case '8': | |
2547 | case '9': | |
c9d5ac95 | 2548 | { |
7fc63493 | 2549 | const char *end = name + len; |
c9d5ac95 GS |
2550 | while (--end > name) { |
2551 | if (!isDIGIT(*end)) | |
2552 | return FALSE; | |
2553 | } | |
b9b0e72c NC |
2554 | goto yes; |
2555 | } | |
2556 | } | |
2557 | } else { | |
2558 | /* Because we're already assuming that name is NUL terminated | |
2559 | below, we can treat an empty name as "\0" */ | |
2560 | switch (*name) { | |
2561 | case '&': | |
2562 | case '`': | |
2563 | case '\'': | |
2564 | case ':': | |
2565 | case '?': | |
2566 | case '!': | |
2567 | case '-': | |
2568 | case '#': | |
2569 | case '[': | |
2570 | case '^': | |
2571 | case '~': | |
2572 | case '=': | |
2573 | case '%': | |
2574 | case '.': | |
2575 | case '(': | |
2576 | case ')': | |
2577 | case '<': | |
2578 | case '>': | |
b9b0e72c NC |
2579 | case '\\': |
2580 | case '/': | |
2581 | case '|': | |
2582 | case '+': | |
2583 | case ';': | |
2584 | case ']': | |
2585 | case '\001': /* $^A */ | |
2586 | case '\003': /* $^C */ | |
2587 | case '\004': /* $^D */ | |
2588 | case '\005': /* $^E */ | |
2589 | case '\006': /* $^F */ | |
2590 | case '\010': /* $^H */ | |
2591 | case '\011': /* $^I, NOT \t in EBCDIC */ | |
2592 | case '\014': /* $^L */ | |
2593 | case '\016': /* $^N */ | |
2594 | case '\017': /* $^O */ | |
2595 | case '\020': /* $^P */ | |
2596 | case '\023': /* $^S */ | |
2597 | case '\024': /* $^T */ | |
2598 | case '\026': /* $^V */ | |
2599 | case '\027': /* $^W */ | |
2600 | case '1': | |
2601 | case '2': | |
2602 | case '3': | |
2603 | case '4': | |
2604 | case '5': | |
2605 | case '6': | |
2606 | case '7': | |
2607 | case '8': | |
2608 | case '9': | |
2609 | yes: | |
2610 | return TRUE; | |
2611 | default: | |
2612 | break; | |
c9d5ac95 | 2613 | } |
c9d5ac95 GS |
2614 | } |
2615 | return FALSE; | |
2616 | } | |
66610fdd | 2617 | |
f5c1e807 NC |
2618 | void |
2619 | Perl_gv_name_set(pTHX_ GV *gv, const char *name, U32 len, U32 flags) | |
2620 | { | |
2621 | dVAR; | |
acda4c6a | 2622 | U32 hash; |
f5c1e807 | 2623 | |
7918f24d | 2624 | PERL_ARGS_ASSERT_GV_NAME_SET; |
f5c1e807 NC |
2625 | PERL_UNUSED_ARG(flags); |
2626 | ||
acda4c6a NC |
2627 | if (len > I32_MAX) |
2628 | Perl_croak(aTHX_ "panic: gv name too long (%"UVuf")", (UV) len); | |
2629 | ||
ae8cc45f NC |
2630 | if (!(flags & GV_ADD) && GvNAME_HEK(gv)) { |
2631 | unshare_hek(GvNAME_HEK(gv)); | |
2632 | } | |
2633 | ||
acda4c6a | 2634 | PERL_HASH(hash, name, len); |
9f616d01 | 2635 | GvNAME_HEK(gv) = share_hek(name, len, hash); |
f5c1e807 NC |
2636 | } |
2637 | ||
66610fdd | 2638 | /* |
f7461760 Z |
2639 | =for apidoc gv_try_downgrade |
2640 | ||
2867cdbc Z |
2641 | If the typeglob C<gv> can be expressed more succinctly, by having |
2642 | something other than a real GV in its place in the stash, replace it | |
2643 | with the optimised form. Basic requirements for this are that C<gv> | |
2644 | is a real typeglob, is sufficiently ordinary, and is only referenced | |
2645 | from its package. This function is meant to be used when a GV has been | |
2646 | looked up in part to see what was there, causing upgrading, but based | |
2647 | on what was found it turns out that the real GV isn't required after all. | |
2648 | ||
2649 | If C<gv> is a completely empty typeglob, it is deleted from the stash. | |
2650 | ||
2651 | If C<gv> is a typeglob containing only a sufficiently-ordinary constant | |
2652 | sub, the typeglob is replaced with a scalar-reference placeholder that | |
2653 | more compactly represents the same thing. | |
f7461760 Z |
2654 | |
2655 | =cut | |
2656 | */ | |
2657 | ||
2658 | void | |
2659 | Perl_gv_try_downgrade(pTHX_ GV *gv) | |
2660 | { | |
2661 | HV *stash; | |
2662 | CV *cv; | |
2663 | HEK *namehek; | |
2664 | SV **gvp; | |
2665 | PERL_ARGS_ASSERT_GV_TRY_DOWNGRADE; | |
95f56751 FC |
2666 | |
2667 | /* XXX Why and where does this leave dangling pointers during global | |
2668 | destruction? */ | |
627364f1 | 2669 | if (PL_phase == PERL_PHASE_DESTRUCT) return; |
95f56751 | 2670 | |
2867cdbc | 2671 | if (!(SvREFCNT(gv) == 1 && SvTYPE(gv) == SVt_PVGV && !SvFAKE(gv) && |
803f2748 | 2672 | !SvOBJECT(gv) && !SvREADONLY(gv) && |
f7461760 | 2673 | isGV_with_GP(gv) && GvGP(gv) && |
2867cdbc | 2674 | !GvINTRO(gv) && GvREFCNT(gv) == 1 && |
f7461760 | 2675 | !GvSV(gv) && !GvAV(gv) && !GvHV(gv) && !GvIOp(gv) && !GvFORM(gv) && |
099be4f1 | 2676 | GvEGVx(gv) == gv && (stash = GvSTASH(gv)))) |
2867cdbc | 2677 | return; |
803f2748 DM |
2678 | if (SvMAGICAL(gv)) { |
2679 | MAGIC *mg; | |
2680 | /* only backref magic is allowed */ | |
2681 | if (SvGMAGICAL(gv) || SvSMAGICAL(gv)) | |
2682 | return; | |
2683 | for (mg = SvMAGIC(gv); mg; mg = mg->mg_moremagic) { | |
2684 | if (mg->mg_type != PERL_MAGIC_backref) | |
2685 | return; | |
2686 | } | |
2687 | } | |
2867cdbc Z |
2688 | cv = GvCV(gv); |
2689 | if (!cv) { | |
2690 | HEK *gvnhek = GvNAME_HEK(gv); | |
2691 | (void)hv_delete(stash, HEK_KEY(gvnhek), | |
2692 | HEK_UTF8(gvnhek) ? -HEK_LEN(gvnhek) : HEK_LEN(gvnhek), G_DISCARD); | |
2693 | } else if (GvMULTI(gv) && cv && | |
f7461760 Z |
2694 | !SvOBJECT(cv) && !SvMAGICAL(cv) && !SvREADONLY(cv) && |
2695 | CvSTASH(cv) == stash && CvGV(cv) == gv && | |
2696 | CvCONST(cv) && !CvMETHOD(cv) && !CvLVALUE(cv) && !CvUNIQUE(cv) && | |
2697 | !CvNODEBUG(cv) && !CvCLONE(cv) && !CvCLONED(cv) && !CvANON(cv) && | |
2698 | (namehek = GvNAME_HEK(gv)) && | |
2699 | (gvp = hv_fetch(stash, HEK_KEY(namehek), | |
2700 | HEK_LEN(namehek)*(HEK_UTF8(namehek) ? -1 : 1), 0)) && | |
2701 | *gvp == (SV*)gv) { | |
2702 | SV *value = SvREFCNT_inc(CvXSUBANY(cv).any_ptr); | |
2703 | SvREFCNT(gv) = 0; | |
2704 | sv_clear((SV*)gv); | |
2705 | SvREFCNT(gv) = 1; | |
2706 | SvFLAGS(gv) = SVt_IV|SVf_ROK; | |
2707 | SvANY(gv) = (XPVGV*)((char*)&(gv->sv_u.svu_iv) - | |
2708 | STRUCT_OFFSET(XPVIV, xiv_iv)); | |
2709 | SvRV_set(gv, value); | |
2710 | } | |
2711 | } | |
2712 | ||
2713 | /* | |
66610fdd RGS |
2714 | * Local variables: |
2715 | * c-indentation-style: bsd | |
2716 | * c-basic-offset: 4 | |
2717 | * indent-tabs-mode: t | |
2718 | * End: | |
2719 | * | |
37442d52 RGS |
2720 | * ex: set ts=8 sts=4 sw=4 noet: |
2721 | */ |