This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
this will be 5.005_60
[perl5.git] / gv.c
CommitLineData
a0d0e21e 1/* gv.c
79072805 2 *
4eb8286e 3 * Copyright (c) 1991-1999, Larry Wall
79072805
LW
4 *
5 * You may distribute under the terms of either the GNU General Public
6 * License or the Artistic License, as specified in the README file.
7 *
a0d0e21e
LW
8 */
9
10/*
11 * 'Mercy!' cried Gandalf. 'If the giving of information is to be the cure
12 * of your inquisitiveness, I shall spend all the rest of my days answering
13 * you. What more do you want to know?'
14 * 'The names of all the stars, and of all living things, and the whole
15 * history of Middle-earth and Over-heaven and of the Sundering Seas,'
16 * laughed Pippin.
79072805
LW
17 */
18
19#include "EXTERN.h"
864dbfa3 20#define PERL_IN_GV_C
79072805
LW
21#include "perl.h"
22
23GV *
864dbfa3 24Perl_gv_AVadd(pTHX_ register GV *gv)
79072805 25{
a0d0e21e 26 if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
cea2e8a9 27 Perl_croak(aTHX_ "Bad symbol for array");
79072805
LW
28 if (!GvAV(gv))
29 GvAV(gv) = newAV();
30 return gv;
31}
32
33GV *
864dbfa3 34Perl_gv_HVadd(pTHX_ register GV *gv)
79072805 35{
a0d0e21e 36 if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
cea2e8a9 37 Perl_croak(aTHX_ "Bad symbol for hash");
79072805 38 if (!GvHV(gv))
463ee0b2 39 GvHV(gv) = newHV();
79072805
LW
40 return gv;
41}
42
43GV *
864dbfa3 44Perl_gv_IOadd(pTHX_ register GV *gv)
a0d0e21e
LW
45{
46 if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
cea2e8a9 47 Perl_croak(aTHX_ "Bad symbol for filehandle");
a0d0e21e
LW
48 if (!GvIOp(gv))
49 GvIOp(gv) = newIO();
50 return gv;
51}
52
53GV *
864dbfa3 54Perl_gv_fetchfile(pTHX_ const char *name)
79072805 55{
e858de61 56 dTHR;
53d95988
CS
57 char smallbuf[256];
58 char *tmpbuf;
8ebc5c01 59 STRLEN tmplen;
79072805
LW
60 GV *gv;
61
53d95988
CS
62 tmplen = strlen(name) + 2;
63 if (tmplen < sizeof smallbuf)
64 tmpbuf = smallbuf;
65 else
66 New(603, tmpbuf, tmplen + 1, char);
67 tmpbuf[0] = '_';
68 tmpbuf[1] = '<';
69 strcpy(tmpbuf + 2, name);
3280af22 70 gv = *(GV**)hv_fetch(PL_defstash, tmpbuf, tmplen, TRUE);
8ebc5c01 71 if (!isGV(gv))
3280af22 72 gv_init(gv, PL_defstash, tmpbuf, tmplen, FALSE);
53d95988
CS
73 if (tmpbuf != smallbuf)
74 Safefree(tmpbuf);
79072805 75 sv_setpv(GvSV(gv), name);
8ebc5c01 76 if (*name == '/' && (instr(name, "/lib/") || instr(name, ".pm")))
a5f75d66 77 GvMULTI_on(gv);
84902520 78 if (PERLDB_LINE)
93a17b20 79 hv_magic(GvHVn(gv_AVadd(gv)), gv, 'L');
79072805
LW
80 return gv;
81}
82
463ee0b2 83void
864dbfa3 84Perl_gv_init(pTHX_ GV *gv, HV *stash, const char *name, STRLEN len, int multi)
463ee0b2 85{
0f15f207 86 dTHR;
463ee0b2 87 register GP *gp;
55d729e4
GS
88 bool doproto = SvTYPE(gv) > SVt_NULL;
89 char *proto = (doproto && SvPOK(gv)) ? SvPVX(gv) : NULL;
463ee0b2 90
dc437b57 91 sv_upgrade((SV*)gv, SVt_PVGV);
55d729e4
GS
92 if (SvLEN(gv)) {
93 if (proto) {
94 SvPVX(gv) = NULL;
95 SvLEN(gv) = 0;
96 SvPOK_off(gv);
97 } else
98 Safefree(SvPVX(gv));
99 }
44a8e56a 100 Newz(602, gp, 1, GP);
8990e307 101 GvGP(gv) = gp_ref(gp);
463ee0b2 102 GvSV(gv) = NEWSV(72,0);
3280af22
NIS
103 GvLINE(gv) = PL_curcop->cop_line;
104 GvFILEGV(gv) = PL_curcop->cop_filegv;
005a453c 105 GvCVGEN(gv) = 0;
463ee0b2
LW
106 GvEGV(gv) = gv;
107 sv_magic((SV*)gv, (SV*)gv, '*', name, len);
85aff577 108 GvSTASH(gv) = (HV*)SvREFCNT_inc(stash);
a0d0e21e 109 GvNAME(gv) = savepvn(name, len);
463ee0b2 110 GvNAMELEN(gv) = len;
23ad5bf5 111 if (multi || doproto) /* doproto means it _was_ mentioned */
a5f75d66 112 GvMULTI_on(gv);
55d729e4 113 if (doproto) { /* Replicate part of newSUB here. */
57ff9a15 114 SvIOK_off(gv);
55d729e4 115 ENTER;
b099ddc0 116 /* XXX unsafe for threads if eval_owner isn't held */
55d729e4 117 start_subparse(0,0); /* Create CV in compcv. */
3280af22 118 GvCV(gv) = PL_compcv;
55d729e4
GS
119 LEAVE;
120
3280af22 121 PL_sub_generation++;
55d729e4 122 CvGV(GvCV(gv)) = (GV*)SvREFCNT_inc(gv);
3280af22
NIS
123 CvFILEGV(GvCV(gv)) = PL_curcop->cop_filegv;
124 CvSTASH(GvCV(gv)) = PL_curstash;
55d729e4
GS
125#ifdef USE_THREADS
126 CvOWNER(GvCV(gv)) = 0;
1cfa4ec7 127 if (!CvMUTEXP(GvCV(gv))) {
b0a484d2 128 New(666, CvMUTEXP(GvCV(gv)), 1, perl_mutex);
1cfa4ec7
GS
129 MUTEX_INIT(CvMUTEXP(GvCV(gv)));
130 }
55d729e4
GS
131#endif /* USE_THREADS */
132 if (proto) {
133 sv_setpv((SV*)GvCV(gv), proto);
134 Safefree(proto);
135 }
136 }
463ee0b2
LW
137}
138
76e3520e 139STATIC void
cea2e8a9 140S_gv_init_sv(pTHX_ GV *gv, I32 sv_type)
a0d0e21e
LW
141{
142 switch (sv_type) {
143 case SVt_PVIO:
144 (void)GvIOn(gv);
145 break;
146 case SVt_PVAV:
147 (void)GvAVn(gv);
148 break;
149 case SVt_PVHV:
150 (void)GvHVn(gv);
151 break;
152 }
153}
154
79072805 155GV *
864dbfa3 156Perl_gv_fetchmeth(pTHX_ HV *stash, const char *name, STRLEN len, I32 level)
79072805
LW
157{
158 AV* av;
463ee0b2 159 GV* topgv;
79072805 160 GV* gv;
463ee0b2 161 GV** gvp;
748a9306 162 CV* cv;
a0d0e21e
LW
163
164 if (!stash)
165 return 0;
44a8e56a 166 if ((level > 100) || (level < -100))
cea2e8a9 167 Perl_croak(aTHX_ "Recursive inheritance detected while looking for method '%s' in package '%s'",
3e0ccd42 168 name, HvNAME(stash));
463ee0b2 169
cea2e8a9 170 DEBUG_o( Perl_deb(aTHX_ "Looking for method %s in package %s\n",name,HvNAME(stash)) );
44a8e56a 171
172 gvp = (GV**)hv_fetch(stash, name, len, (level >= 0));
173 if (!gvp)
174 topgv = Nullgv;
175 else {
176 topgv = *gvp;
177 if (SvTYPE(topgv) != SVt_PVGV)
178 gv_init(topgv, stash, name, len, TRUE);
179 if (cv = GvCV(topgv)) {
180 /* If genuine method or valid cache entry, use it */
3280af22 181 if (!GvCVGEN(topgv) || GvCVGEN(topgv) == PL_sub_generation)
7a4c00b4 182 return topgv;
44a8e56a 183 /* Stale cached entry: junk it */
184 SvREFCNT_dec(cv);
185 GvCV(topgv) = cv = Nullcv;
186 GvCVGEN(topgv) = 0;
748a9306 187 }
3280af22 188 else if (GvCVGEN(topgv) == PL_sub_generation)
005a453c 189 return 0; /* cache indicates sub doesn't exist */
463ee0b2 190 }
79072805 191
9607fc9c 192 gvp = (GV**)hv_fetch(stash, "ISA", 3, FALSE);
3280af22 193 av = (gvp && (gv = *gvp) && gv != (GV*)&PL_sv_undef) ? GvAV(gv) : Nullav;
9607fc9c 194
fb73857a 195 /* create and re-create @.*::SUPER::ISA on demand */
196 if (!av || !SvMAGIC(av)) {
9607fc9c 197 char* packname = HvNAME(stash);
198 STRLEN packlen = strlen(packname);
199
200 if (packlen >= 7 && strEQ(packname + packlen - 7, "::SUPER")) {
201 HV* basestash;
202
203 packlen -= 7;
204 basestash = gv_stashpvn(packname, packlen, TRUE);
205 gvp = (GV**)hv_fetch(basestash, "ISA", 3, FALSE);
3280af22 206 if (gvp && (gv = *gvp) != (GV*)&PL_sv_undef && (av = GvAV(gv))) {
e858de61 207 dTHR; /* just for SvREFCNT_dec */
9607fc9c 208 gvp = (GV**)hv_fetch(stash, "ISA", 3, TRUE);
209 if (!gvp || !(gv = *gvp))
cea2e8a9 210 Perl_croak(aTHX_ "Cannot create %s::ISA", HvNAME(stash));
9607fc9c 211 if (SvTYPE(gv) != SVt_PVGV)
212 gv_init(gv, stash, "ISA", 3, TRUE);
213 SvREFCNT_dec(GvAV(gv));
214 GvAV(gv) = (AV*)SvREFCNT_inc(av);
215 }
216 }
217 }
218
219 if (av) {
79072805 220 SV** svp = AvARRAY(av);
93965878
NIS
221 /* NOTE: No support for tied ISA */
222 I32 items = AvFILLp(av) + 1;
79072805 223 while (items--) {
79072805 224 SV* sv = *svp++;
a0d0e21e 225 HV* basestash = gv_stashsv(sv, FALSE);
9bbf4081 226 if (!basestash) {
d008e5eb 227 dTHR; /* just for ckWARN */
599cee73 228 if (ckWARN(WARN_MISC))
cea2e8a9 229 Perl_warner(aTHX_ WARN_MISC, "Can't locate package %s for @%s::ISA",
463ee0b2 230 SvPVX(sv), HvNAME(stash));
79072805
LW
231 continue;
232 }
44a8e56a 233 gv = gv_fetchmeth(basestash, name, len,
234 (level >= 0) ? level + 1 : level - 1);
235 if (gv)
236 goto gotcha;
79072805
LW
237 }
238 }
a0d0e21e 239
9607fc9c 240 /* if at top level, try UNIVERSAL */
241
44a8e56a 242 if (level == 0 || level == -1) {
9607fc9c 243 HV* lastchance;
244
dc437b57 245 if (lastchance = gv_stashpvn("UNIVERSAL", 9, FALSE)) {
44a8e56a 246 if (gv = gv_fetchmeth(lastchance, name, len,
247 (level >= 0) ? level + 1 : level - 1)) {
248 gotcha:
dc848c6f 249 /*
250 * Cache method in topgv if:
251 * 1. topgv has no synonyms (else inheritance crosses wires)
252 * 2. method isn't a stub (else AUTOLOAD fails spectacularly)
253 */
254 if (topgv &&
255 GvREFCNT(topgv) == 1 &&
256 (cv = GvCV(gv)) &&
257 (CvROOT(cv) || CvXSUB(cv)))
258 {
44a8e56a 259 if (cv = GvCV(topgv))
260 SvREFCNT_dec(cv);
261 GvCV(topgv) = (CV*)SvREFCNT_inc(GvCV(gv));
3280af22 262 GvCVGEN(topgv) = PL_sub_generation;
44a8e56a 263 }
a0d0e21e
LW
264 return gv;
265 }
005a453c
JP
266 else if (topgv && GvREFCNT(topgv) == 1) {
267 /* cache the fact that the method is not defined */
3280af22 268 GvCVGEN(topgv) = PL_sub_generation;
005a453c 269 }
a0d0e21e
LW
270 }
271 }
272
79072805
LW
273 return 0;
274}
275
276GV *
864dbfa3 277Perl_gv_fetchmethod(pTHX_ HV *stash, const char *name)
463ee0b2 278{
dc848c6f 279 return gv_fetchmethod_autoload(stash, name, TRUE);
280}
281
282GV *
864dbfa3 283Perl_gv_fetchmethod_autoload(pTHX_ HV *stash, const char *name, I32 autoload)
dc848c6f 284{
0f15f207 285 dTHR;
08105a92
GS
286 register const char *nend;
287 const char *nsplit = 0;
a0d0e21e 288 GV* gv;
463ee0b2
LW
289
290 for (nend = name; *nend; nend++) {
9607fc9c 291 if (*nend == '\'')
a0d0e21e 292 nsplit = nend;
9607fc9c 293 else if (*nend == ':' && *(nend + 1) == ':')
294 nsplit = ++nend;
a0d0e21e
LW
295 }
296 if (nsplit) {
08105a92 297 const char *origname = name;
a0d0e21e 298 name = nsplit + 1;
a0d0e21e
LW
299 if (*nsplit == ':')
300 --nsplit;
9607fc9c 301 if ((nsplit - origname) == 5 && strnEQ(origname, "SUPER", 5)) {
302 /* ->SUPER::method should really be looked up in original stash */
cea2e8a9 303 SV *tmpstr = sv_2mortal(Perl_newSVpvf(aTHX_ "%s::SUPER",
3280af22 304 HvNAME(PL_curcop->cop_stash)));
9607fc9c 305 stash = gv_stashpvn(SvPVX(tmpstr), SvCUR(tmpstr), TRUE);
cea2e8a9 306 DEBUG_o( Perl_deb(aTHX_ "Treating %s as %s::%s\n",
9607fc9c 307 origname, HvNAME(stash), name) );
4633a7c4 308 }
9607fc9c 309 else
310 stash = gv_stashpvn(origname, nsplit - origname, TRUE);
4633a7c4
LW
311 }
312
9607fc9c 313 gv = gv_fetchmeth(stash, name, nend - name, 0);
a0d0e21e 314 if (!gv) {
702887b4 315 if (strEQ(name,"import"))
3280af22 316 gv = (GV*)&PL_sv_yes;
dc848c6f 317 else if (autoload)
54310121 318 gv = gv_autoload4(stash, name, nend - name, TRUE);
463ee0b2 319 }
dc848c6f 320 else if (autoload) {
321 CV* cv = GvCV(gv);
09280a33
CS
322 if (!CvROOT(cv) && !CvXSUB(cv)) {
323 GV* stubgv;
324 GV* autogv;
325
326 if (CvANON(cv))
327 stubgv = gv;
328 else {
329 stubgv = CvGV(cv);
330 if (GvCV(stubgv) != cv) /* orphaned import */
331 stubgv = gv;
332 }
333 autogv = gv_autoload4(GvSTASH(stubgv),
334 GvNAME(stubgv), GvNAMELEN(stubgv), TRUE);
dc848c6f 335 if (autogv)
336 gv = autogv;
337 }
338 }
44a8e56a 339
340 return gv;
341}
342
343GV*
864dbfa3 344Perl_gv_autoload4(pTHX_ HV *stash, const char *name, STRLEN len, I32 method)
44a8e56a 345{
d008e5eb 346 dTHR;
44a8e56a 347 static char autoload[] = "AUTOLOAD";
348 static STRLEN autolen = 8;
349 GV* gv;
350 CV* cv;
351 HV* varstash;
352 GV* vargv;
353 SV* varsv;
354
355 if (len == autolen && strnEQ(name, autoload, autolen))
356 return Nullgv;
dc848c6f 357 if (!(gv = gv_fetchmeth(stash, autoload, autolen, FALSE)))
358 return Nullgv;
359 cv = GvCV(gv);
360
361 /*
362 * Inheriting AUTOLOAD for non-methods works ... for now.
363 */
599cee73
PM
364 if (ckWARN(WARN_DEPRECATED) && !method &&
365 (GvCVGEN(gv) || GvSTASH(gv) != stash))
cea2e8a9 366 Perl_warner(aTHX_ WARN_DEPRECATED,
dc848c6f 367 "Use of inherited AUTOLOAD for non-method %s::%.*s() is deprecated",
368 HvNAME(stash), (int)len, name);
44a8e56a 369
370 /*
371 * Given &FOO::AUTOLOAD, set $FOO::AUTOLOAD to desired function name.
372 * The subroutine's original name may not be "AUTOLOAD", so we don't
373 * use that, but for lack of anything better we will use the sub's
374 * original package to look up $AUTOLOAD.
375 */
376 varstash = GvSTASH(CvGV(cv));
377 vargv = *(GV**)hv_fetch(varstash, autoload, autolen, TRUE);
378 if (!isGV(vargv))
379 gv_init(vargv, varstash, autoload, autolen, FALSE);
380 varsv = GvSV(vargv);
381 sv_setpv(varsv, HvNAME(stash));
382 sv_catpvn(varsv, "::", 2);
383 sv_catpvn(varsv, name, len);
384 SvTAINTED_off(varsv);
a0d0e21e
LW
385 return gv;
386}
387
388HV*
864dbfa3 389Perl_gv_stashpv(pTHX_ const char *name, I32 create)
a0d0e21e 390{
dc437b57 391 return gv_stashpvn(name, strlen(name), create);
392}
393
394HV*
864dbfa3 395Perl_gv_stashpvn(pTHX_ const char *name, U32 namelen, I32 create)
dc437b57 396{
46fc3d4c 397 char smallbuf[256];
398 char *tmpbuf;
a0d0e21e
LW
399 HV *stash;
400 GV *tmpgv;
dc437b57 401
46fc3d4c 402 if (namelen + 3 < sizeof smallbuf)
403 tmpbuf = smallbuf;
404 else
405 New(606, tmpbuf, namelen + 3, char);
dc437b57 406 Copy(name,tmpbuf,namelen,char);
407 tmpbuf[namelen++] = ':';
408 tmpbuf[namelen++] = ':';
409 tmpbuf[namelen] = '\0';
46fc3d4c 410 tmpgv = gv_fetchpv(tmpbuf, create, SVt_PVHV);
411 if (tmpbuf != smallbuf)
412 Safefree(tmpbuf);
a0d0e21e
LW
413 if (!tmpgv)
414 return 0;
415 if (!GvHV(tmpgv))
416 GvHV(tmpgv) = newHV();
417 stash = GvHV(tmpgv);
418 if (!HvNAME(stash))
419 HvNAME(stash) = savepv(name);
420 return stash;
463ee0b2
LW
421}
422
a0d0e21e 423HV*
864dbfa3 424Perl_gv_stashsv(pTHX_ SV *sv, I32 create)
a0d0e21e 425{
dc437b57 426 register char *ptr;
427 STRLEN len;
428 ptr = SvPV(sv,len);
429 return gv_stashpvn(ptr, len, create);
a0d0e21e
LW
430}
431
432
463ee0b2 433GV *
864dbfa3 434Perl_gv_fetchpv(pTHX_ const char *nambeg, I32 add, I32 sv_type)
79072805 435{
11343788 436 dTHR;
08105a92 437 register const char *name = nambeg;
463ee0b2 438 register GV *gv = 0;
79072805 439 GV**gvp;
79072805 440 I32 len;
08105a92 441 register const char *namend;
463ee0b2 442 HV *stash = 0;
9607fc9c 443 U32 add_gvflags = 0;
79072805 444
c07a80fd 445 if (*name == '*' && isALPHA(name[1])) /* accidental stringify on a GV? */
446 name++;
447
79072805 448 for (namend = name; *namend; namend++) {
463ee0b2
LW
449 if ((*namend == '\'' && namend[1]) ||
450 (*namend == ':' && namend[1] == ':'))
451 {
463ee0b2 452 if (!stash)
3280af22 453 stash = PL_defstash;
dc437b57 454 if (!stash || !SvREFCNT(stash)) /* symbol table under destruction */
a0d0e21e 455 return Nullgv;
463ee0b2 456
85e6fe83
LW
457 len = namend - name;
458 if (len > 0) {
3c78fafa 459 char smallbuf[256];
62b57502 460 char *tmpbuf;
62b57502 461
3c78fafa
GS
462 if (len + 3 < sizeof smallbuf)
463 tmpbuf = smallbuf;
62b57502
MB
464 else
465 New(601, tmpbuf, len+3, char);
a0d0e21e
LW
466 Copy(name, tmpbuf, len, char);
467 tmpbuf[len++] = ':';
468 tmpbuf[len++] = ':';
469 tmpbuf[len] = '\0';
463ee0b2 470 gvp = (GV**)hv_fetch(stash,tmpbuf,len,add);
6fa846a0 471 gv = gvp ? *gvp : Nullgv;
3280af22 472 if (gv && gv != (GV*)&PL_sv_undef) {
6fa846a0 473 if (SvTYPE(gv) != SVt_PVGV)
0f303493 474 gv_init(gv, stash, tmpbuf, len, (add & GV_ADDMULTI));
6fa846a0
GS
475 else
476 GvMULTI_on(gv);
477 }
3c78fafa 478 if (tmpbuf != smallbuf)
62b57502 479 Safefree(tmpbuf);
3280af22 480 if (!gv || gv == (GV*)&PL_sv_undef)
a0d0e21e 481 return Nullgv;
85e6fe83 482
463ee0b2
LW
483 if (!(stash = GvHV(gv)))
484 stash = GvHV(gv) = newHV();
85e6fe83 485
463ee0b2 486 if (!HvNAME(stash))
a0d0e21e 487 HvNAME(stash) = savepvn(nambeg, namend - nambeg);
463ee0b2
LW
488 }
489
490 if (*namend == ':')
491 namend++;
492 namend++;
493 name = namend;
494 if (!*name)
3280af22 495 return gv ? gv : (GV*)*hv_fetch(PL_defstash, "main::", 6, TRUE);
79072805 496 }
79072805 497 }
a0d0e21e
LW
498 len = namend - name;
499 if (!len)
500 len = 1;
463ee0b2
LW
501
502 /* No stash in name, so see how we can default */
503
504 if (!stash) {
b86a2fa7
GS
505 if (isIDFIRST(*name)
506 || (IN_UTF8 && ((*name & 0xc0) == 0xc0) && isIDFIRST_utf8((U8*)name)))
507 {
9607fc9c 508 bool global = FALSE;
509
463ee0b2 510 if (isUPPER(*name)) {
9d116dd7
JH
511 if (*name == 'S' && (
512 strEQ(name, "SIG") ||
513 strEQ(name, "STDIN") ||
514 strEQ(name, "STDOUT") ||
515 strEQ(name, "STDERR")))
516 global = TRUE;
517 else if (*name == 'I' && strEQ(name, "INC"))
518 global = TRUE;
519 else if (*name == 'E' && strEQ(name, "ENV"))
520 global = TRUE;
463ee0b2
LW
521 else if (*name == 'A' && (
522 strEQ(name, "ARGV") ||
9d116dd7 523 strEQ(name, "ARGVOUT")))
463ee0b2
LW
524 global = TRUE;
525 }
526 else if (*name == '_' && !name[1])
527 global = TRUE;
9607fc9c 528
463ee0b2 529 if (global)
3280af22
NIS
530 stash = PL_defstash;
531 else if ((COP*)PL_curcop == &PL_compiling) {
532 stash = PL_curstash;
533 if (add && (PL_hints & HINT_STRICT_VARS) &&
748a9306
LW
534 sv_type != SVt_PVCV &&
535 sv_type != SVt_PVGV &&
4633a7c4 536 sv_type != SVt_PVFM &&
c07a80fd 537 sv_type != SVt_PVIO &&
377b8fbc 538 !(len == 1 && sv_type == SVt_PV && strchr("ab",*name)) )
748a9306 539 {
4633a7c4
LW
540 gvp = (GV**)hv_fetch(stash,name,len,0);
541 if (!gvp ||
3280af22 542 *gvp == (GV*)&PL_sv_undef ||
a5f75d66
AD
543 SvTYPE(*gvp) != SVt_PVGV)
544 {
4633a7c4 545 stash = 0;
a5f75d66
AD
546 }
547 else if (sv_type == SVt_PV && !GvIMPORTED_SV(*gvp) ||
548 sv_type == SVt_PVAV && !GvIMPORTED_AV(*gvp) ||
549 sv_type == SVt_PVHV && !GvIMPORTED_HV(*gvp) )
4633a7c4 550 {
cea2e8a9 551 Perl_warn(aTHX_ "Variable \"%c%s\" is not imported",
4633a7c4
LW
552 sv_type == SVt_PVAV ? '@' :
553 sv_type == SVt_PVHV ? '%' : '$',
554 name);
8ebc5c01 555 if (GvCVu(*gvp))
cea2e8a9 556 Perl_warn(aTHX_ "(Did you mean &%s instead?)\n", name);
a0d0e21e 557 stash = 0;
4633a7c4 558 }
a0d0e21e 559 }
85e6fe83 560 }
463ee0b2 561 else
3280af22 562 stash = PL_curcop->cop_stash;
463ee0b2
LW
563 }
564 else
3280af22 565 stash = PL_defstash;
463ee0b2
LW
566 }
567
568 /* By this point we should have a stash and a name */
569
a0d0e21e 570 if (!stash) {
93233ece 571 if (!add)
a0d0e21e 572 return Nullgv;
462551cc 573 {
2c4aebbd
T
574 char sv_type_char = ((sv_type == SVt_PV) ? '$'
575 : (sv_type == SVt_PVAV) ? '@'
576 : (sv_type == SVt_PVHV) ? '%'
577 : 0);
578 if (sv_type_char)
cea2e8a9 579 Perl_warn(aTHX_ "Global symbol \"%c%s\" requires explicit package name",
2c4aebbd
T
580 sv_type_char, name);
581 else
cea2e8a9 582 Perl_warn(aTHX_ "Global symbol \"%s\" requires explicit package name",
93233ece 583 name);
a0d0e21e 584 }
3280af22
NIS
585 ++PL_error_count;
586 stash = PL_curstash ? PL_curstash : PL_defstash; /* avoid core dumps */
93233ece
CS
587 add_gvflags = ((sv_type == SVt_PV) ? GVf_IMPORTED_SV
588 : (sv_type == SVt_PVAV) ? GVf_IMPORTED_AV
589 : (sv_type == SVt_PVHV) ? GVf_IMPORTED_HV
590 : 0);
a0d0e21e
LW
591 }
592
593 if (!SvREFCNT(stash)) /* symbol table under destruction */
594 return Nullgv;
595
79072805 596 gvp = (GV**)hv_fetch(stash,name,len,add);
3280af22 597 if (!gvp || *gvp == (GV*)&PL_sv_undef)
79072805
LW
598 return Nullgv;
599 gv = *gvp;
600 if (SvTYPE(gv) == SVt_PVGV) {
a0d0e21e 601 if (add) {
a5f75d66 602 GvMULTI_on(gv);
a0d0e21e
LW
603 gv_init_sv(gv, sv_type);
604 }
79072805 605 return gv;
55d729e4
GS
606 } else if (add & GV_NOINIT) {
607 return gv;
79072805 608 }
93a17b20
LW
609
610 /* Adding a new symbol */
611
0453d815
PM
612 if (add & GV_ADDWARN && ckWARN_d(WARN_INTERNAL))
613 Perl_warner(aTHX_ WARN_INTERNAL, "Had to create %s unexpectedly", nambeg);
55d729e4 614 gv_init(gv, stash, name, len, add & GV_ADDMULTI);
a0d0e21e 615 gv_init_sv(gv, sv_type);
9607fc9c 616 GvFLAGS(gv) |= add_gvflags;
93a17b20 617
0453d815
PM
618 if (isLEXWARN_on && isALPHA(name[0]) && ! ckWARN(WARN_ONCE))
619 GvMULTI_on(gv) ;
620
93a17b20
LW
621 /* set up magic where warranted */
622 switch (*name) {
a0d0e21e
LW
623 case 'A':
624 if (strEQ(name, "ARGV")) {
625 IoFLAGS(GvIOn(gv)) |= IOf_ARGV|IOf_START;
626 }
627 break;
a0d0e21e
LW
628 case 'E':
629 if (strnEQ(name, "EXPORT", 6))
a5f75d66 630 GvMULTI_on(gv);
a0d0e21e 631 break;
463ee0b2
LW
632 case 'I':
633 if (strEQ(name, "ISA")) {
634 AV* av = GvAVn(gv);
a5f75d66 635 GvMULTI_on(gv);
a0d0e21e 636 sv_magic((SV*)av, (SV*)gv, 'I', Nullch, 0);
93965878 637 /* NOTE: No support for tied ISA */
55d729e4
GS
638 if ((add & GV_ADDMULTI) && strEQ(nambeg,"AnyDBM_File::ISA")
639 && AvFILLp(av) == -1)
85e6fe83 640 {
a0d0e21e 641 char *pname;
79cb57f6 642 av_push(av, newSVpvn(pname = "NDBM_File",9));
dc437b57 643 gv_stashpvn(pname, 9, TRUE);
79cb57f6 644 av_push(av, newSVpvn(pname = "DB_File",7));
dc437b57 645 gv_stashpvn(pname, 7, TRUE);
79cb57f6 646 av_push(av, newSVpvn(pname = "GDBM_File",9));
dc437b57 647 gv_stashpvn(pname, 9, TRUE);
79cb57f6 648 av_push(av, newSVpvn(pname = "SDBM_File",9));
dc437b57 649 gv_stashpvn(pname, 9, TRUE);
79cb57f6 650 av_push(av, newSVpvn(pname = "ODBM_File",9));
dc437b57 651 gv_stashpvn(pname, 9, TRUE);
85e6fe83 652 }
463ee0b2
LW
653 }
654 break;
a0d0e21e
LW
655 case 'O':
656 if (strEQ(name, "OVERLOAD")) {
657 HV* hv = GvHVn(gv);
a5f75d66 658 GvMULTI_on(gv);
ea0efc06 659 hv_magic(hv, gv, 'A');
a0d0e21e
LW
660 }
661 break;
93a17b20
LW
662 case 'S':
663 if (strEQ(name, "SIG")) {
664 HV *hv;
dc437b57 665 I32 i;
3280af22
NIS
666 PL_siggv = gv;
667 GvMULTI_on(PL_siggv);
668 hv = GvHVn(PL_siggv);
669 hv_magic(hv, PL_siggv, 'S');
22c35a8c 670 for(i=1;PL_sig_name[i];i++) {
dc437b57 671 SV ** init;
22c35a8c 672 init=hv_fetch(hv,PL_sig_name[i],strlen(PL_sig_name[i]),1);
dc437b57 673 if(init)
3280af22 674 sv_setsv(*init,&PL_sv_undef);
22c35a8c
GS
675 PL_psig_ptr[i] = 0;
676 PL_psig_name[i] = 0;
dc437b57 677 }
93a17b20
LW
678 }
679 break;
680
681 case '&':
463ee0b2
LW
682 if (len > 1)
683 break;
3280af22
NIS
684 PL_ampergv = gv;
685 PL_sawampersand = TRUE;
a0d0e21e 686 goto ro_magicalize;
93a17b20
LW
687
688 case '`':
463ee0b2
LW
689 if (len > 1)
690 break;
3280af22
NIS
691 PL_leftgv = gv;
692 PL_sawampersand = TRUE;
a0d0e21e 693 goto ro_magicalize;
93a17b20
LW
694
695 case '\'':
463ee0b2
LW
696 if (len > 1)
697 break;
3280af22
NIS
698 PL_rightgv = gv;
699 PL_sawampersand = TRUE;
a0d0e21e 700 goto ro_magicalize;
93a17b20
LW
701
702 case ':':
463ee0b2
LW
703 if (len > 1)
704 break;
3280af22 705 sv_setpv(GvSV(gv),PL_chopset);
93a17b20
LW
706 goto magicalize;
707
ff0cee69 708 case '?':
709 if (len > 1)
710 break;
711#ifdef COMPLEX_STATUS
07f14f54 712 (void)SvUPGRADE(GvSV(gv), SVt_PVLV);
ff0cee69 713#endif
714 goto magicalize;
715
067391ea 716 case '!':
4318d5a0 717 if (len > 1)
067391ea 718 break;
3280af22 719 if (sv_type > SVt_PV && PL_curcop != &PL_compiling) {
067391ea 720 HV* stash = gv_stashpvn("Errno",5,FALSE);
265f5c4a 721 if (!stash || !(gv_fetchmethod(stash, "TIEHASH"))) {
067391ea
GS
722 dSP;
723 PUTBACK;
cea2e8a9 724 require_pv("Errno.pm");
067391ea
GS
725 SPAGAIN;
726 stash = gv_stashpvn("Errno",5,FALSE);
727 if (!stash || !(gv_fetchmethod(stash, "TIEHASH")))
cea2e8a9 728 Perl_croak(aTHX_ "Can't use %%! because Errno.pm is not available");
067391ea
GS
729 }
730 }
731 goto magicalize;
6cef1e77
IZ
732 case '-':
733 if (len > 1)
734 break;
735 else {
736 AV* av = GvAVn(gv);
737 sv_magic((SV*)av, Nullsv, 'D', Nullch, 0);
738 }
739 goto magicalize;
93a17b20 740 case '#':
a0d0e21e 741 case '*':
599cee73 742 if (ckWARN(WARN_DEPRECATED) && len == 1 && sv_type == SVt_PV)
cea2e8a9 743 Perl_warner(aTHX_ WARN_DEPRECATED, "Use of $%s is deprecated", name);
a0d0e21e
LW
744 /* FALL THROUGH */
745 case '[':
93a17b20
LW
746 case '^':
747 case '~':
748 case '=':
93a17b20
LW
749 case '%':
750 case '.':
93a17b20
LW
751 case '(':
752 case ')':
753 case '<':
754 case '>':
755 case ',':
756 case '\\':
757 case '/':
93a17b20 758 case '|':
748a9306 759 case '\001':
599cee73 760 case '\002':
49460fe6 761 case '\003':
93a17b20 762 case '\004':
ad8898e0 763 case '\005':
748a9306 764 case '\006':
a0d0e21e 765 case '\010':
9d116dd7 766 case '\011': /* NOT \t in EBCDIC */
ad8898e0 767 case '\017':
93a17b20
LW
768 case '\020':
769 case '\024':
770 case '\027':
463ee0b2
LW
771 if (len > 1)
772 break;
773 goto magicalize;
6cef1e77
IZ
774 case '\023':
775 if (len > 1)
776 break;
777 goto ro_magicalize;
463ee0b2 778
a0d0e21e 779 case '+':
6cef1e77
IZ
780 if (len > 1)
781 break;
782 else {
783 AV* av = GvAVn(gv);
784 sv_magic((SV*)av, (SV*)av, 'D', Nullch, 0);
785 }
786 /* FALL THROUGH */
463ee0b2
LW
787 case '1':
788 case '2':
789 case '3':
790 case '4':
791 case '5':
792 case '6':
793 case '7':
794 case '8':
795 case '9':
a0d0e21e
LW
796 ro_magicalize:
797 SvREADONLY_on(GvSV(gv));
93a17b20 798 magicalize:
463ee0b2 799 sv_magic(GvSV(gv), (SV*)gv, 0, name, len);
93a17b20
LW
800 break;
801
802 case '\014':
463ee0b2
LW
803 if (len > 1)
804 break;
93a17b20 805 sv_setpv(GvSV(gv),"\f");
3280af22 806 PL_formfeed = GvSV(gv);
93a17b20
LW
807 break;
808 case ';':
463ee0b2
LW
809 if (len > 1)
810 break;
93a17b20
LW
811 sv_setpv(GvSV(gv),"\034");
812 break;
463ee0b2
LW
813 case ']':
814 if (len == 1) {
f86702cc 815 SV *sv = GvSV(gv);
07f14f54 816 (void)SvUPGRADE(sv, SVt_PVNV);
3280af22 817 sv_setpv(sv, PL_patchlevel);
f86702cc 818 (void)sv_2nv(sv);
819 SvREADONLY_on(sv);
93a17b20
LW
820 }
821 break;
79072805 822 }
93a17b20 823 return gv;
79072805
LW
824}
825
826void
864dbfa3 827Perl_gv_fullname3(pTHX_ SV *sv, GV *gv, const char *prefix)
79072805
LW
828{
829 HV *hv = GvSTASH(gv);
f967eb5f 830 if (!hv) {
831 SvOK_off(sv);
79072805 832 return;
f967eb5f 833 }
834 sv_setpv(sv, prefix ? prefix : "");
79072805 835 sv_catpv(sv,HvNAME(hv));
463ee0b2 836 sv_catpvn(sv,"::", 2);
79072805
LW
837 sv_catpvn(sv,GvNAME(gv),GvNAMELEN(gv));
838}
839
840void
864dbfa3 841Perl_gv_efullname3(pTHX_ SV *sv, GV *gv, const char *prefix)
79072805 842{
f967eb5f 843 GV *egv = GvEGV(gv);
748a9306
LW
844 if (!egv)
845 egv = gv;
f6aff53a 846 gv_fullname3(sv, egv, prefix);
847}
848
849/* XXX compatibility with versions <= 5.003. */
850void
864dbfa3 851Perl_gv_fullname(pTHX_ SV *sv, GV *gv)
f6aff53a 852{
853 gv_fullname3(sv, gv, sv == (SV*)gv ? "*" : "");
854}
855
856/* XXX compatibility with versions <= 5.003. */
857void
864dbfa3 858Perl_gv_efullname(pTHX_ SV *sv, GV *gv)
f6aff53a 859{
860 gv_efullname3(sv, gv, sv == (SV*)gv ? "*" : "");
79072805
LW
861}
862
863IO *
864dbfa3 864Perl_newIO(pTHX)
79072805 865{
11343788 866 dTHR;
79072805 867 IO *io;
8990e307
LW
868 GV *iogv;
869
870 io = (IO*)NEWSV(0,0);
a0d0e21e 871 sv_upgrade((SV *)io,SVt_PVIO);
8990e307
LW
872 SvREFCNT(io) = 1;
873 SvOBJECT_on(io);
c9de509e 874 iogv = gv_fetchpv("FileHandle::", FALSE, SVt_PVHV);
5f2d631d
GS
875 /* unless exists($main::{FileHandle}) and defined(%main::FileHandle::) */
876 if (!(iogv && GvHV(iogv) && HvARRAY(GvHV(iogv))))
c9de509e 877 iogv = gv_fetchpv("IO::Handle::", TRUE, SVt_PVHV);
8990e307 878 SvSTASH(io) = (HV*)SvREFCNT_inc(GvHV(iogv));
79072805
LW
879 return io;
880}
881
882void
864dbfa3 883Perl_gv_check(pTHX_ HV *stash)
79072805 884{
11343788 885 dTHR;
79072805
LW
886 register HE *entry;
887 register I32 i;
888 register GV *gv;
463ee0b2 889 HV *hv;
a0d0e21e 890 GV *filegv;
463ee0b2 891
8990e307
LW
892 if (!HvARRAY(stash))
893 return;
a0d0e21e 894 for (i = 0; i <= (I32) HvMAX(stash); i++) {
dc437b57 895 for (entry = HvARRAY(stash)[i]; entry; entry = HeNEXT(entry)) {
896 if (HeKEY(entry)[HeKLEN(entry)-1] == ':' &&
897 (gv = (GV*)HeVAL(entry)) && (hv = GvHV(gv)) && HvNAME(hv))
a0d0e21e 898 {
19b6c847 899 if (hv != PL_defstash && hv != stash)
a0d0e21e
LW
900 gv_check(hv); /* nested package */
901 }
dc437b57 902 else if (isALPHA(*HeKEY(entry))) {
903 gv = (GV*)HeVAL(entry);
55d729e4 904 if (SvTYPE(gv) != SVt_PVGV || GvMULTI(gv))
463ee0b2 905 continue;
3280af22 906 PL_curcop->cop_line = GvLINE(gv);
a0d0e21e 907 filegv = GvFILEGV(gv);
3280af22 908 PL_curcop->cop_filegv = filegv;
a5f75d66 909 if (filegv && GvMULTI(filegv)) /* Filename began with slash */
8990e307 910 continue;
cea2e8a9 911 Perl_warner(aTHX_ WARN_ONCE,
599cee73 912 "Name \"%s::%s\" used only once: possible typo",
a0d0e21e 913 HvNAME(stash), GvNAME(gv));
463ee0b2 914 }
79072805
LW
915 }
916 }
917}
918
919GV *
864dbfa3 920Perl_newGVgen(pTHX_ char *pack)
79072805 921{
cea2e8a9 922 return gv_fetchpv(Perl_form(aTHX_ "%s::_GEN_%ld", pack, (long)PL_gensym++),
46fc3d4c 923 TRUE, SVt_PVGV);
79072805
LW
924}
925
926/* hopefully this is only called on local symbol table entries */
927
928GP*
864dbfa3 929Perl_gp_ref(pTHX_ GP *gp)
79072805
LW
930{
931 gp->gp_refcnt++;
44a8e56a 932 if (gp->gp_cv) {
933 if (gp->gp_cvgen) {
934 /* multi-named GPs cannot be used for method cache */
935 SvREFCNT_dec(gp->gp_cv);
936 gp->gp_cv = Nullcv;
937 gp->gp_cvgen = 0;
938 }
939 else {
940 /* Adding a new name to a subroutine invalidates method cache */
3280af22 941 PL_sub_generation++;
44a8e56a 942 }
943 }
79072805 944 return gp;
79072805
LW
945}
946
947void
864dbfa3 948Perl_gp_free(pTHX_ GV *gv)
79072805 949{
f248d071 950 dTHR;
79072805 951 GP* gp;
377b8fbc 952 CV* cv;
79072805
LW
953
954 if (!gv || !(gp = GvGP(gv)))
955 return;
f248d071
GS
956 if (gp->gp_refcnt == 0) {
957 if (ckWARN_d(WARN_INTERNAL))
958 Perl_warner(aTHX_ WARN_INTERNAL,
959 "Attempt to free unreferenced glob pointers");
79072805
LW
960 return;
961 }
44a8e56a 962 if (gp->gp_cv) {
963 /* Deleting the name of a subroutine invalidates method cache */
3280af22 964 PL_sub_generation++;
44a8e56a 965 }
748a9306
LW
966 if (--gp->gp_refcnt > 0) {
967 if (gp->gp_egv == gv)
968 gp->gp_egv = 0;
79072805 969 return;
748a9306 970 }
79072805 971
8990e307
LW
972 SvREFCNT_dec(gp->gp_sv);
973 SvREFCNT_dec(gp->gp_av);
974 SvREFCNT_dec(gp->gp_hv);
377b8fbc 975 SvREFCNT_dec(gp->gp_io);
a6006777 976 SvREFCNT_dec(gp->gp_cv);
748a9306
LW
977 SvREFCNT_dec(gp->gp_form);
978
79072805
LW
979 Safefree(gp);
980 GvGP(gv) = 0;
981}
982
983#if defined(CRIPPLED_CC) && (defined(iAPX286) || defined(M_I286) || defined(I80286))
984#define MICROPORT
985#endif
986
987#ifdef MICROPORT /* Microport 2.4 hack */
988AV *GvAVn(gv)
989register GV *gv;
990{
991 if (GvGP(gv)->gp_av)
992 return GvGP(gv)->gp_av;
993 else
994 return GvGP(gv_AVadd(gv))->gp_av;
995}
996
997HV *GvHVn(gv)
998register GV *gv;
999{
1000 if (GvGP(gv)->gp_hv)
1001 return GvGP(gv)->gp_hv;
1002 else
1003 return GvGP(gv_HVadd(gv))->gp_hv;
1004}
1005#endif /* Microport 2.4 hack */
a0d0e21e 1006
a0d0e21e
LW
1007/* Updates and caches the CV's */
1008
1009bool
864dbfa3 1010Perl_Gv_AMupdate(pTHX_ HV *stash)
a0d0e21e 1011{
11343788 1012 dTHR;
a0d0e21e
LW
1013 GV** gvp;
1014 HV* hv;
1015 GV* gv;
1016 CV* cv;
1017 MAGIC* mg=mg_find((SV*)stash,'c');
8ac85365 1018 AMT *amtp = (mg) ? (AMT*)mg->mg_ptr: (AMT *) NULL;
a6006777 1019 AMT amt;
2d8e6c8d 1020 STRLEN n_a;
a0d0e21e 1021
3280af22
NIS
1022 if (mg && amtp->was_ok_am == PL_amagic_generation
1023 && amtp->was_ok_sub == PL_sub_generation)
a6006777 1024 return AMT_AMAGIC(amtp);
1025 if (amtp && AMT_AMAGIC(amtp)) { /* Have table. */
748a9306 1026 int i;
a6006777 1027 for (i=1; i<NofAMmeth; i++) {
748a9306
LW
1028 if (amtp->table[i]) {
1029 SvREFCNT_dec(amtp->table[i]);
1030 }
1031 }
1032 }
a0d0e21e
LW
1033 sv_unmagic((SV*)stash, 'c');
1034
cea2e8a9 1035 DEBUG_o( Perl_deb(aTHX_ "Recalcing overload magic in package %s\n",HvNAME(stash)) );
a0d0e21e 1036
3280af22
NIS
1037 amt.was_ok_am = PL_amagic_generation;
1038 amt.was_ok_sub = PL_sub_generation;
a6006777 1039 amt.fallback = AMGfallNO;
1040 amt.flags = 0;
1041
1042#ifdef OVERLOAD_VIA_HASH
1043 gvp=(GV**)hv_fetch(stash,"OVERLOAD",8,FALSE); /* A shortcut */
3280af22 1044 if (gvp && ((gv = *gvp) != (GV*)&PL_sv_undef && (hv = GvHV(gv)))) {
a0d0e21e
LW
1045 int filled=0;
1046 int i;
1047 char *cp;
a0d0e21e
LW
1048 SV* sv;
1049 SV** svp;
a0d0e21e 1050
22c35a8c 1051 /* Work with "fallback" key, which we assume to be first in PL_AMG_names */
a0d0e21e 1052
22c35a8c 1053 if (( cp = (char *)PL_AMG_names[0] ) &&
a6006777 1054 (svp = (SV**)hv_fetch(hv,cp,strlen(cp),FALSE)) && (sv = *svp)) {
a0d0e21e
LW
1055 if (SvTRUE(sv)) amt.fallback=AMGfallYES;
1056 else if (SvOK(sv)) amt.fallback=AMGfallNEVER;
1057 }
a6006777 1058 for (i = 1; i < NofAMmeth; i++) {
1059 cv = 0;
22c35a8c 1060 cp = (char *)PL_AMG_names[i];
a6006777 1061
1062 svp = (SV**)hv_fetch(hv, cp, strlen(cp), FALSE);
3280af22 1063 if (svp && ((sv = *svp) != &PL_sv_undef)) {
a0d0e21e
LW
1064 switch (SvTYPE(sv)) {
1065 default:
1066 if (!SvROK(sv)) {
1067 if (!SvOK(sv)) break;
2d8e6c8d 1068 gv = gv_fetchmethod(stash, SvPV(sv, n_a));
a0d0e21e
LW
1069 if (gv) cv = GvCV(gv);
1070 break;
1071 }
1072 cv = (CV*)SvRV(sv);
1073 if (SvTYPE(cv) == SVt_PVCV)
1074 break;
1075 /* FALL THROUGH */
1076 case SVt_PVHV:
1077 case SVt_PVAV:
cea2e8a9 1078 Perl_croak(aTHX_ "Not a subroutine reference in overload table");
a0d0e21e
LW
1079 return FALSE;
1080 case SVt_PVCV:
8ebc5c01 1081 cv = (CV*)sv;
1082 break;
a0d0e21e 1083 case SVt_PVGV:
8ebc5c01 1084 if (!(cv = GvCVu((GV*)sv)))
f6ec51f7 1085 cv = sv_2cv(sv, &stash, &gv, FALSE);
8ebc5c01 1086 break;
a0d0e21e
LW
1087 }
1088 if (cv) filled=1;
1089 else {
cea2e8a9 1090 Perl_croak(aTHX_ "Method for operation %s not found in package %.256s during blessing\n",
a0d0e21e
LW
1091 cp,HvNAME(stash));
1092 return FALSE;
1093 }
1094 }
a6006777 1095#else
1096 {
1097 int filled = 0;
1098 int i;
9607fc9c 1099 const char *cp;
a6006777 1100 SV* sv = NULL;
1101 SV** svp;
1102
22c35a8c 1103 /* Work with "fallback" key, which we assume to be first in PL_AMG_names */
a6006777 1104
22c35a8c 1105 if ( cp = PL_AMG_names[0] ) {
a6006777 1106 /* Try to find via inheritance. */
774d564b 1107 gv = gv_fetchmeth(stash, "()", 2, -1); /* A cookie: "()". */
a6006777 1108 if (gv) sv = GvSV(gv);
1109
774d564b 1110 if (!gv) goto no_table;
a6006777 1111 else if (SvTRUE(sv)) amt.fallback=AMGfallYES;
1112 else if (SvOK(sv)) amt.fallback=AMGfallNEVER;
1113 }
1114
1115 for (i = 1; i < NofAMmeth; i++) {
cea2e8a9
GS
1116 SV *cookie = sv_2mortal(Perl_newSVpvf(aTHX_ "(%s", cp = PL_AMG_names[i]));
1117 DEBUG_o( Perl_deb(aTHX_ "Checking overloading of `%s' in package `%.256s'\n",
44a8e56a 1118 cp, HvNAME(stash)) );
46fc3d4c 1119 /* don't fill the cache while looking up! */
1120 gv = gv_fetchmeth(stash, SvPVX(cookie), SvCUR(cookie), -1);
1121 cv = 0;
44a8e56a 1122 if(gv && (cv = GvCV(gv))) {
44a8e56a 1123 if (GvNAMELEN(CvGV(cv)) == 3 && strEQ(GvNAME(CvGV(cv)), "nil")
1124 && strEQ(HvNAME(GvSTASH(CvGV(cv))), "overload")) {
1125 /* GvSV contains the name of the method. */
1126 GV *ngv;
1127
cea2e8a9 1128 DEBUG_o( Perl_deb(aTHX_ "Resolving method `%.256s' for overloaded `%s' in package `%.256s'\n",
2d8e6c8d 1129 SvPV(GvSV(gv), n_a), cp, HvNAME(stash)) );
dc848c6f 1130 if (!SvPOK(GvSV(gv))
1131 || !(ngv = gv_fetchmethod_autoload(stash, SvPVX(GvSV(gv)),
1132 FALSE)))
1133 {
44a8e56a 1134 /* Can be an import stub (created by `can'). */
1135 if (GvCVGEN(gv)) {
cea2e8a9 1136 Perl_croak(aTHX_ "Stub found while resolving method `%.256s' overloading `%s' in package `%.256s'",
44a8e56a 1137 (SvPOK(GvSV(gv)) ? SvPVX(GvSV(gv)) : "???" ),
1138 cp, HvNAME(stash));
1139 } else
cea2e8a9 1140 Perl_croak(aTHX_ "Can't resolve method `%.256s' overloading `%s' in package `%.256s'",
44a8e56a 1141 (SvPOK(GvSV(gv)) ? SvPVX(GvSV(gv)) : "???" ),
1142 cp, HvNAME(stash));
1143 }
dc848c6f 1144 cv = GvCV(gv = ngv);
44a8e56a 1145 }
cea2e8a9 1146 DEBUG_o( Perl_deb(aTHX_ "Overloading `%s' in package `%.256s' via `%.256s::%.256s' \n",
44a8e56a 1147 cp, HvNAME(stash), HvNAME(GvSTASH(CvGV(cv))),
1148 GvNAME(CvGV(cv))) );
1149 filled = 1;
1150 }
a6006777 1151#endif
1152 amt.table[i]=(CV*)SvREFCNT_inc(cv);
a0d0e21e 1153 }
a0d0e21e 1154 if (filled) {
a6006777 1155 AMT_AMAGIC_on(&amt);
1156 sv_magic((SV*)stash, 0, 'c', (char*)&amt, sizeof(AMT));
a0d0e21e
LW
1157 return TRUE;
1158 }
1159 }
a6006777 1160 /* Here we have no table: */
774d564b 1161 no_table:
a6006777 1162 AMT_AMAGIC_off(&amt);
1163 sv_magic((SV*)stash, 0, 'c', (char*)&amt, sizeof(AMTS));
a0d0e21e
LW
1164 return FALSE;
1165}
1166
a0d0e21e 1167SV*
864dbfa3 1168Perl_amagic_call(pTHX_ SV *left, SV *right, int method, int flags)
a0d0e21e 1169{
11343788 1170 dTHR;
a0d0e21e
LW
1171 MAGIC *mg;
1172 CV *cv;
1173 CV **cvp=NULL, **ocvp=NULL;
1174 AMT *amtp, *oamtp;
1175 int fl=0, off, off1, lr=0, assign=AMGf_assign & flags, notfound=0;
ee239bfe 1176 int postpr = 0, force_cpy = 0, assignshift = assign ? 1 : 0;
a0d0e21e
LW
1177 HV* stash;
1178 if (!(AMGf_noleft & flags) && SvAMAGIC(left)
1179 && (mg = mg_find((SV*)(stash=SvSTASH(SvRV(left))),'c'))
a6006777 1180 && (ocvp = cvp = (AMT_AMAGIC((AMT*)mg->mg_ptr)
1181 ? (oamtp = amtp = (AMT*)mg->mg_ptr)->table
8ac85365 1182 : (CV **) NULL))
748a9306
LW
1183 && ((cv = cvp[off=method+assignshift])
1184 || (assign && amtp->fallback > AMGfallNEVER && /* fallback to
1185 * usual method */
1186 (fl = 1, cv = cvp[off=method])))) {
a0d0e21e
LW
1187 lr = -1; /* Call method for left argument */
1188 } else {
1189 if (cvp && amtp->fallback > AMGfallNEVER && flags & AMGf_unary) {
1190 int logic;
1191
1192 /* look for substituted methods */
ee239bfe 1193 /* In all the covered cases we should be called with assign==0. */
a0d0e21e
LW
1194 switch (method) {
1195 case inc_amg:
ee239bfe
IZ
1196 force_cpy = 1;
1197 if ((cv = cvp[off=add_ass_amg])
1198 || ((cv = cvp[off = add_amg]) && (force_cpy = 0, postpr = 1))) {
3280af22 1199 right = &PL_sv_yes; lr = -1; assign = 1;
a0d0e21e
LW
1200 }
1201 break;
1202 case dec_amg:
ee239bfe
IZ
1203 force_cpy = 1;
1204 if ((cv = cvp[off = subtr_ass_amg])
1205 || ((cv = cvp[off = subtr_amg]) && (force_cpy = 0, postpr=1))) {
3280af22 1206 right = &PL_sv_yes; lr = -1; assign = 1;
a0d0e21e
LW
1207 }
1208 break;
1209 case bool__amg:
1210 (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=string_amg]));
1211 break;
1212 case numer_amg:
1213 (void)((cv = cvp[off=string_amg]) || (cv = cvp[off=bool__amg]));
1214 break;
1215 case string_amg:
1216 (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=bool__amg]));
1217 break;
dc437b57 1218 case not_amg:
1219 (void)((cv = cvp[off=bool__amg])
1220 || (cv = cvp[off=numer_amg])
1221 || (cv = cvp[off=string_amg]));
1222 postpr = 1;
1223 break;
748a9306
LW
1224 case copy_amg:
1225 {
76e3520e
GS
1226 /*
1227 * SV* ref causes confusion with the interpreter variable of
1228 * the same name
1229 */
1230 SV* tmpRef=SvRV(left);
1231 if (!SvROK(tmpRef) && SvTYPE(tmpRef) <= SVt_PVMG) {
fc36a67e 1232 /*
1233 * Just to be extra cautious. Maybe in some
1234 * additional cases sv_setsv is safe, too.
1235 */
76e3520e 1236 SV* newref = newSVsv(tmpRef);
748a9306 1237 SvOBJECT_on(newref);
76e3520e 1238 SvSTASH(newref) = (HV*)SvREFCNT_inc(SvSTASH(tmpRef));
748a9306
LW
1239 return newref;
1240 }
1241 }
1242 break;
a0d0e21e 1243 case abs_amg:
748a9306 1244 if ((cvp[off1=lt_amg] || cvp[off1=ncmp_amg])
a0d0e21e 1245 && ((cv = cvp[off=neg_amg]) || (cv = cvp[off=subtr_amg]))) {
748a9306 1246 SV* nullsv=sv_2mortal(newSViv(0));
a0d0e21e 1247 if (off1==lt_amg) {
748a9306 1248 SV* lessp = amagic_call(left,nullsv,
a0d0e21e
LW
1249 lt_amg,AMGf_noright);
1250 logic = SvTRUE(lessp);
1251 } else {
748a9306 1252 SV* lessp = amagic_call(left,nullsv,
a0d0e21e
LW
1253 ncmp_amg,AMGf_noright);
1254 logic = (SvNV(lessp) < 0);
1255 }
1256 if (logic) {
1257 if (off==subtr_amg) {
1258 right = left;
748a9306 1259 left = nullsv;
a0d0e21e
LW
1260 lr = 1;
1261 }
1262 } else {
1263 return left;
1264 }
1265 }
1266 break;
1267 case neg_amg:
1268 if (cv = cvp[off=subtr_amg]) {
1269 right = left;
1270 left = sv_2mortal(newSViv(0));
1271 lr = 1;
1272 }
1273 break;
f5284f61
IZ
1274 case iter_amg: /* XXXX Eventually should do to_gv. */
1275 case to_sv_amg:
1276 case to_av_amg:
1277 case to_hv_amg:
1278 case to_gv_amg:
1279 case to_cv_amg:
1280 /* FAIL safe */
1281 return NULL; /* Delegate operation to standard mechanisms. */
1282 break;
a0d0e21e
LW
1283 default:
1284 goto not_found;
1285 }
1286 if (!cv) goto not_found;
1287 } else if (!(AMGf_noright & flags) && SvAMAGIC(right)
1288 && (mg = mg_find((SV*)(stash=SvSTASH(SvRV(right))),'c'))
a6006777 1289 && (cvp = (AMT_AMAGIC((AMT*)mg->mg_ptr)
1290 ? (amtp = (AMT*)mg->mg_ptr)->table
8ac85365 1291 : (CV **) NULL))
a0d0e21e
LW
1292 && (cv = cvp[off=method])) { /* Method for right
1293 * argument found */
1294 lr=1;
748a9306 1295 } else if (((ocvp && oamtp->fallback > AMGfallNEVER
4633a7c4 1296 && (cvp=ocvp) && (lr = -1))
a0d0e21e
LW
1297 || (cvp && amtp->fallback > AMGfallNEVER && (lr=1)))
1298 && !(flags & AMGf_unary)) {
1299 /* We look for substitution for
1300 * comparison operations and
fc36a67e 1301 * concatenation */
a0d0e21e
LW
1302 if (method==concat_amg || method==concat_ass_amg
1303 || method==repeat_amg || method==repeat_ass_amg) {
1304 return NULL; /* Delegate operation to string conversion */
1305 }
1306 off = -1;
1307 switch (method) {
1308 case lt_amg:
1309 case le_amg:
1310 case gt_amg:
1311 case ge_amg:
1312 case eq_amg:
1313 case ne_amg:
1314 postpr = 1; off=ncmp_amg; break;
1315 case slt_amg:
1316 case sle_amg:
1317 case sgt_amg:
1318 case sge_amg:
1319 case seq_amg:
1320 case sne_amg:
1321 postpr = 1; off=scmp_amg; break;
1322 }
1323 if (off != -1) cv = cvp[off];
1324 if (!cv) {
1325 goto not_found;
1326 }
1327 } else {
a6006777 1328 not_found: /* No method found, either report or croak */
a0d0e21e
LW
1329 if (ocvp && (cv=ocvp[nomethod_amg])) { /* Call report method */
1330 notfound = 1; lr = -1;
1331 } else if (cvp && (cv=cvp[nomethod_amg])) {
1332 notfound = 1; lr = 1;
1333 } else {
46fc3d4c 1334 SV *msg;
774d564b 1335 if (off==-1) off=method;
cea2e8a9 1336 msg = sv_2mortal(Perl_newSVpvf(aTHX_
46fc3d4c 1337 "Operation `%s': no method found,%sargument %s%s%s%s",
22c35a8c 1338 PL_AMG_names[method + assignshift],
e7ea3e70 1339 (flags & AMGf_unary ? " " : "\n\tleft "),
a0d0e21e
LW
1340 SvAMAGIC(left)?
1341 "in overloaded package ":
1342 "has no overloaded magic",
1343 SvAMAGIC(left)?
1344 HvNAME(SvSTASH(SvRV(left))):
1345 "",
1346 SvAMAGIC(right)?
e7ea3e70
IZ
1347 ",\n\tright argument in overloaded package ":
1348 (flags & AMGf_unary
1349 ? ""
1350 : ",\n\tright argument has no overloaded magic"),
a0d0e21e
LW
1351 SvAMAGIC(right)?
1352 HvNAME(SvSTASH(SvRV(right))):
46fc3d4c 1353 ""));
a0d0e21e 1354 if (amtp && amtp->fallback >= AMGfallYES) {
cea2e8a9 1355 DEBUG_o( Perl_deb(aTHX_ "%s", SvPVX(msg)) );
a0d0e21e 1356 } else {
cea2e8a9 1357 Perl_croak(aTHX_ "%_", msg);
a0d0e21e
LW
1358 }
1359 return NULL;
1360 }
ee239bfe 1361 force_cpy = force_cpy || assign;
a0d0e21e
LW
1362 }
1363 }
1364 if (!notfound) {
cea2e8a9 1365 DEBUG_o( Perl_deb(aTHX_
46fc3d4c 1366 "Overloaded operator `%s'%s%s%s:\n\tmethod%s found%s in package %s%s\n",
22c35a8c 1367 PL_AMG_names[off],
748a9306
LW
1368 method+assignshift==off? "" :
1369 " (initially `",
1370 method+assignshift==off? "" :
22c35a8c 1371 PL_AMG_names[method+assignshift],
748a9306
LW
1372 method+assignshift==off? "" : "')",
1373 flags & AMGf_unary? "" :
1374 lr==1 ? " for right argument": " for left argument",
1375 flags & AMGf_unary? " for argument" : "",
a0d0e21e
LW
1376 HvNAME(stash),
1377 fl? ",\n\tassignment variant used": "") );
ee239bfe 1378 }
748a9306
LW
1379 /* Since we use shallow copy during assignment, we need
1380 * to dublicate the contents, probably calling user-supplied
1381 * version of copy operator
1382 */
ee239bfe
IZ
1383 /* We need to copy in following cases:
1384 * a) Assignment form was called.
1385 * assignshift==1, assign==T, method + 1 == off
1386 * b) Increment or decrement, called directly.
1387 * assignshift==0, assign==0, method + 0 == off
1388 * c) Increment or decrement, translated to assignment add/subtr.
1389 * assignshift==0, assign==T,
1390 * force_cpy == T
1391 * d) Increment or decrement, translated to nomethod.
1392 * assignshift==0, assign==0,
1393 * force_cpy == T
1394 * e) Assignment form translated to nomethod.
1395 * assignshift==1, assign==T, method + 1 != off
1396 * force_cpy == T
1397 */
1398 /* off is method, method+assignshift, or a result of opcode substitution.
1399 * In the latter case assignshift==0, so only notfound case is important.
1400 */
1401 if (( (method + assignshift == off)
1402 && (assign || (method == inc_amg) || (method == dec_amg)))
1403 || force_cpy)
1404 RvDEEPCP(left);
a0d0e21e
LW
1405 {
1406 dSP;
1407 BINOP myop;
1408 SV* res;
54310121 1409 bool oldcatch = CATCH_GET;
a0d0e21e 1410
54310121 1411 CATCH_SET(TRUE);
a0d0e21e
LW
1412 Zero(&myop, 1, BINOP);
1413 myop.op_last = (OP *) &myop;
1414 myop.op_next = Nullop;
54310121 1415 myop.op_flags = OPf_WANT_SCALAR | OPf_STACKED;
a0d0e21e 1416
e788e7d3 1417 PUSHSTACKi(PERLSI_OVERLOAD);
a0d0e21e 1418 ENTER;
462e5cf6 1419 SAVEOP();
533c011a 1420 PL_op = (OP *) &myop;
3280af22 1421 if (PERLDB_SUB && PL_curstash != PL_debstash)
533c011a 1422 PL_op->op_private |= OPpENTERSUB_DB;
a0d0e21e 1423 PUTBACK;
cea2e8a9 1424 pp_pushmark();
a0d0e21e 1425
924508f0 1426 EXTEND(SP, notfound + 5);
a0d0e21e
LW
1427 PUSHs(lr>0? right: left);
1428 PUSHs(lr>0? left: right);
3280af22 1429 PUSHs( lr > 0 ? &PL_sv_yes : ( assign ? &PL_sv_undef : &PL_sv_no ));
a0d0e21e 1430 if (notfound) {
22c35a8c 1431 PUSHs( sv_2mortal(newSVpv((char *)PL_AMG_names[method + assignshift],0)));
a0d0e21e
LW
1432 }
1433 PUSHs((SV*)cv);
1434 PUTBACK;
1435
cea2e8a9
GS
1436 if (PL_op = Perl_pp_entersub(aTHX))
1437 CALLRUNOPS(aTHX);
a0d0e21e
LW
1438 LEAVE;
1439 SPAGAIN;
1440
1441 res=POPs;
ebafeae7 1442 PUTBACK;
d3acc0f7 1443 POPSTACK;
54310121 1444 CATCH_SET(oldcatch);
a0d0e21e 1445
a0d0e21e
LW
1446 if (postpr) {
1447 int ans;
1448 switch (method) {
1449 case le_amg:
1450 case sle_amg:
1451 ans=SvIV(res)<=0; break;
1452 case lt_amg:
1453 case slt_amg:
1454 ans=SvIV(res)<0; break;
1455 case ge_amg:
1456 case sge_amg:
1457 ans=SvIV(res)>=0; break;
1458 case gt_amg:
1459 case sgt_amg:
1460 ans=SvIV(res)>0; break;
1461 case eq_amg:
1462 case seq_amg:
1463 ans=SvIV(res)==0; break;
1464 case ne_amg:
1465 case sne_amg:
1466 ans=SvIV(res)!=0; break;
1467 case inc_amg:
1468 case dec_amg:
bbce6d69 1469 SvSetSV(left,res); return left;
dc437b57 1470 case not_amg:
fe7ac86a 1471 ans=!SvTRUE(res); break;
a0d0e21e 1472 }
54310121 1473 return boolSV(ans);
748a9306
LW
1474 } else if (method==copy_amg) {
1475 if (!SvROK(res)) {
cea2e8a9 1476 Perl_croak(aTHX_ "Copy method did not return a reference");
748a9306
LW
1477 }
1478 return SvREFCNT_inc(SvRV(res));
a0d0e21e
LW
1479 } else {
1480 return res;
1481 }
1482 }
1483}