This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
@& sets PL_sawampersand
[perl5.git] / gv.c
1 /*    gv.c
2  *
3  *    Copyright (c) 1991-2001, Larry Wall
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  *
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.
17  */
18
19 #include "EXTERN.h"
20 #define PERL_IN_GV_C
21 #include "perl.h"
22
23 GV *
24 Perl_gv_AVadd(pTHX_ register GV *gv)
25 {
26     if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
27         Perl_croak(aTHX_ "Bad symbol for array");
28     if (!GvAV(gv))
29         GvAV(gv) = newAV();
30     return gv;
31 }
32
33 GV *
34 Perl_gv_HVadd(pTHX_ register GV *gv)
35 {
36     if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
37         Perl_croak(aTHX_ "Bad symbol for hash");
38     if (!GvHV(gv))
39         GvHV(gv) = newHV();
40     return gv;
41 }
42
43 GV *
44 Perl_gv_IOadd(pTHX_ register GV *gv)
45 {
46     if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
47         Perl_croak(aTHX_ "Bad symbol for filehandle");
48     if (!GvIOp(gv)) {
49 #ifdef GV_UNIQUE_CHECK
50         if (GvUNIQUE(gv)) {
51             Perl_croak(aTHX_ "Bad symbol for filehandle (GV is unique)");
52         }
53 #endif
54         GvIOp(gv) = newIO();
55     }
56     return gv;
57 }
58
59 GV *
60 Perl_gv_fetchfile(pTHX_ const char *name)
61 {
62     char smallbuf[256];
63     char *tmpbuf;
64     STRLEN tmplen;
65     GV *gv;
66
67     if (!PL_defstash)
68         return Nullgv;
69
70     tmplen = strlen(name) + 2;
71     if (tmplen < sizeof smallbuf)
72         tmpbuf = smallbuf;
73     else
74         New(603, tmpbuf, tmplen + 1, char);
75     tmpbuf[0] = '_';
76     tmpbuf[1] = '<';
77     strcpy(tmpbuf + 2, name);
78     gv = *(GV**)hv_fetch(PL_defstash, tmpbuf, tmplen, TRUE);
79     if (!isGV(gv)) {
80         gv_init(gv, PL_defstash, tmpbuf, tmplen, FALSE);
81         sv_setpv(GvSV(gv), name);
82         if (PERLDB_LINE)
83             hv_magic(GvHVn(gv_AVadd(gv)), Nullgv, PERL_MAGIC_dbfile);
84     }
85     if (tmpbuf != smallbuf)
86         Safefree(tmpbuf);
87     return gv;
88 }
89
90 void
91 Perl_gv_init(pTHX_ GV *gv, HV *stash, const char *name, STRLEN len, int multi)
92 {
93     register GP *gp;
94     bool doproto = SvTYPE(gv) > SVt_NULL;
95     char *proto = (doproto && SvPOK(gv)) ? SvPVX(gv) : NULL;
96
97     sv_upgrade((SV*)gv, SVt_PVGV);
98     if (SvLEN(gv)) {
99         if (proto) {
100             SvPVX(gv) = NULL;
101             SvLEN(gv) = 0;
102             SvPOK_off(gv);
103         } else
104             Safefree(SvPVX(gv));
105     }
106     Newz(602, gp, 1, GP);
107     GvGP(gv) = gp_ref(gp);
108     GvSV(gv) = NEWSV(72,0);
109     GvLINE(gv) = CopLINE(PL_curcop);
110     GvFILE(gv) = CopFILE(PL_curcop) ? CopFILE(PL_curcop) : "";
111     GvCVGEN(gv) = 0;
112     GvEGV(gv) = gv;
113     sv_magic((SV*)gv, (SV*)gv, PERL_MAGIC_glob, Nullch, 0);
114     GvSTASH(gv) = (HV*)SvREFCNT_inc(stash);
115     GvNAME(gv) = savepvn(name, len);
116     GvNAMELEN(gv) = len;
117     if (multi || doproto)              /* doproto means it _was_ mentioned */
118         GvMULTI_on(gv);
119     if (doproto) {                      /* Replicate part of newSUB here. */
120         SvIOK_off(gv);
121         ENTER;
122         /* XXX unsafe for threads if eval_owner isn't held */
123         start_subparse(0,0);            /* Create CV in compcv. */
124         GvCV(gv) = PL_compcv;
125         LEAVE;
126
127         PL_sub_generation++;
128         CvGV(GvCV(gv)) = gv;
129         CvFILE_set_from_cop(GvCV(gv), PL_curcop);
130         CvSTASH(GvCV(gv)) = PL_curstash;
131 #ifdef USE_5005THREADS
132         CvOWNER(GvCV(gv)) = 0;
133         if (!CvMUTEXP(GvCV(gv))) {
134             New(666, CvMUTEXP(GvCV(gv)), 1, perl_mutex);
135             MUTEX_INIT(CvMUTEXP(GvCV(gv)));
136         }
137 #endif /* USE_5005THREADS */
138         if (proto) {
139             sv_setpv((SV*)GvCV(gv), proto);
140             Safefree(proto);
141         }
142     }
143 }
144
145 STATIC void
146 S_gv_init_sv(pTHX_ GV *gv, I32 sv_type)
147 {
148     switch (sv_type) {
149     case SVt_PVIO:
150         (void)GvIOn(gv);
151         break;
152     case SVt_PVAV:
153         (void)GvAVn(gv);
154         break;
155     case SVt_PVHV:
156         (void)GvHVn(gv);
157         break;
158     }
159 }
160
161 /*
162 =for apidoc gv_fetchmeth
163
164 Returns the glob with the given C<name> and a defined subroutine or
165 C<NULL>.  The glob lives in the given C<stash>, or in the stashes
166 accessible via @ISA and UNIVERSAL::.
167
168 The argument C<level> should be either 0 or -1.  If C<level==0>, as a
169 side-effect creates a glob with the given C<name> in the given C<stash>
170 which in the case of success contains an alias for the subroutine, and sets
171 up caching info for this glob.  Similarly for all the searched stashes.
172
173 This function grants C<"SUPER"> token as a postfix of the stash name. The
174 GV returned from C<gv_fetchmeth> may be a method cache entry, which is not
175 visible to Perl code.  So when calling C<call_sv>, you should not use
176 the GV directly; instead, you should use the method's CV, which can be
177 obtained from the GV with the C<GvCV> macro.
178
179 =cut
180 */
181
182 GV *
183 Perl_gv_fetchmeth(pTHX_ HV *stash, const char *name, STRLEN len, I32 level)
184 {
185     AV* av;
186     GV* topgv;
187     GV* gv;
188     GV** gvp;
189     CV* cv;
190
191     /* UNIVERSAL methods should be callable without a stash */
192     if (!stash) {
193         level = -1;  /* probably appropriate */
194         if(!(stash = gv_stashpvn("UNIVERSAL", 9, FALSE)))
195             return 0;
196     }
197
198     if ((level > 100) || (level < -100))
199         Perl_croak(aTHX_ "Recursive inheritance detected while looking for method '%s' in package '%s'",
200               name, HvNAME(stash));
201
202     DEBUG_o( Perl_deb(aTHX_ "Looking for method %s in package %s\n",name,HvNAME(stash)) );
203
204     gvp = (GV**)hv_fetch(stash, name, len, (level >= 0));
205     if (!gvp)
206         topgv = Nullgv;
207     else {
208         topgv = *gvp;
209         if (SvTYPE(topgv) != SVt_PVGV)
210             gv_init(topgv, stash, name, len, TRUE);
211         if ((cv = GvCV(topgv))) {
212             /* If genuine method or valid cache entry, use it */
213             if (!GvCVGEN(topgv) || GvCVGEN(topgv) == PL_sub_generation)
214                 return topgv;
215             /* Stale cached entry: junk it */
216             SvREFCNT_dec(cv);
217             GvCV(topgv) = cv = Nullcv;
218             GvCVGEN(topgv) = 0;
219         }
220         else if (GvCVGEN(topgv) == PL_sub_generation)
221             return 0;  /* cache indicates sub doesn't exist */
222     }
223
224     gvp = (GV**)hv_fetch(stash, "ISA", 3, FALSE);
225     av = (gvp && (gv = *gvp) && gv != (GV*)&PL_sv_undef) ? GvAV(gv) : Nullav;
226
227     /* create and re-create @.*::SUPER::ISA on demand */
228     if (!av || !SvMAGIC(av)) {
229         char* packname = HvNAME(stash);
230         STRLEN packlen = strlen(packname);
231
232         if (packlen >= 7 && strEQ(packname + packlen - 7, "::SUPER")) {
233             HV* basestash;
234
235             packlen -= 7;
236             basestash = gv_stashpvn(packname, packlen, TRUE);
237             gvp = (GV**)hv_fetch(basestash, "ISA", 3, FALSE);
238             if (gvp && (gv = *gvp) != (GV*)&PL_sv_undef && (av = GvAV(gv))) {
239                 gvp = (GV**)hv_fetch(stash, "ISA", 3, TRUE);
240                 if (!gvp || !(gv = *gvp))
241                     Perl_croak(aTHX_ "Cannot create %s::ISA", HvNAME(stash));
242                 if (SvTYPE(gv) != SVt_PVGV)
243                     gv_init(gv, stash, "ISA", 3, TRUE);
244                 SvREFCNT_dec(GvAV(gv));
245                 GvAV(gv) = (AV*)SvREFCNT_inc(av);
246             }
247         }
248     }
249
250     if (av) {
251         SV** svp = AvARRAY(av);
252         /* NOTE: No support for tied ISA */
253         I32 items = AvFILLp(av) + 1;
254         while (items--) {
255             SV* sv = *svp++;
256             HV* basestash = gv_stashsv(sv, FALSE);
257             if (!basestash) {
258                 if (ckWARN(WARN_MISC))
259                     Perl_warner(aTHX_ WARN_MISC, "Can't locate package %s for @%s::ISA",
260                         SvPVX(sv), HvNAME(stash));
261                 continue;
262             }
263             gv = gv_fetchmeth(basestash, name, len,
264                               (level >= 0) ? level + 1 : level - 1);
265             if (gv)
266                 goto gotcha;
267         }
268     }
269
270     /* if at top level, try UNIVERSAL */
271
272     if (level == 0 || level == -1) {
273         HV* lastchance;
274
275         if ((lastchance = gv_stashpvn("UNIVERSAL", 9, FALSE))) {
276             if ((gv = gv_fetchmeth(lastchance, name, len,
277                                   (level >= 0) ? level + 1 : level - 1)))
278             {
279           gotcha:
280                 /*
281                  * Cache method in topgv if:
282                  *  1. topgv has no synonyms (else inheritance crosses wires)
283                  *  2. method isn't a stub (else AUTOLOAD fails spectacularly)
284                  */
285                 if (topgv &&
286                     GvREFCNT(topgv) == 1 &&
287                     (cv = GvCV(gv)) &&
288                     (CvROOT(cv) || CvXSUB(cv)))
289                 {
290                     if ((cv = GvCV(topgv)))
291                         SvREFCNT_dec(cv);
292                     GvCV(topgv) = (CV*)SvREFCNT_inc(GvCV(gv));
293                     GvCVGEN(topgv) = PL_sub_generation;
294                 }
295                 return gv;
296             }
297             else if (topgv && GvREFCNT(topgv) == 1) {
298                 /* cache the fact that the method is not defined */
299                 GvCVGEN(topgv) = PL_sub_generation;
300             }
301         }
302     }
303
304     return 0;
305 }
306
307 /*
308 =for apidoc gv_fetchmethod
309
310 See L<gv_fetchmethod_autoload>.
311
312 =cut
313 */
314
315 GV *
316 Perl_gv_fetchmethod(pTHX_ HV *stash, const char *name)
317 {
318     return gv_fetchmethod_autoload(stash, name, TRUE);
319 }
320
321 /*
322 =for apidoc gv_fetchmethod_autoload
323
324 Returns the glob which contains the subroutine to call to invoke the method
325 on the C<stash>.  In fact in the presence of autoloading this may be the
326 glob for "AUTOLOAD".  In this case the corresponding variable $AUTOLOAD is
327 already setup.
328
329 The third parameter of C<gv_fetchmethod_autoload> determines whether
330 AUTOLOAD lookup is performed if the given method is not present: non-zero
331 means yes, look for AUTOLOAD; zero means no, don't look for AUTOLOAD.
332 Calling C<gv_fetchmethod> is equivalent to calling C<gv_fetchmethod_autoload>
333 with a non-zero C<autoload> parameter.
334
335 These functions grant C<"SUPER"> token as a prefix of the method name. Note
336 that if you want to keep the returned glob for a long time, you need to
337 check for it being "AUTOLOAD", since at the later time the call may load a
338 different subroutine due to $AUTOLOAD changing its value. Use the glob
339 created via a side effect to do this.
340
341 These functions have the same side-effects and as C<gv_fetchmeth> with
342 C<level==0>.  C<name> should be writable if contains C<':'> or C<'
343 ''>. The warning against passing the GV returned by C<gv_fetchmeth> to
344 C<call_sv> apply equally to these functions.
345
346 =cut
347 */
348
349 GV *
350 Perl_gv_fetchmethod_autoload(pTHX_ HV *stash, const char *name, I32 autoload)
351 {
352     register const char *nend;
353     const char *nsplit = 0;
354     GV* gv;
355
356     for (nend = name; *nend; nend++) {
357         if (*nend == '\'')
358             nsplit = nend;
359         else if (*nend == ':' && *(nend + 1) == ':')
360             nsplit = ++nend;
361     }
362     if (nsplit) {
363         const char *origname = name;
364         name = nsplit + 1;
365         if (*nsplit == ':')
366             --nsplit;
367         if ((nsplit - origname) == 5 && strnEQ(origname, "SUPER", 5)) {
368             /* ->SUPER::method should really be looked up in original stash */
369             SV *tmpstr = sv_2mortal(Perl_newSVpvf(aTHX_ "%s::SUPER",
370                                                   CopSTASHPV(PL_curcop)));
371             /* __PACKAGE__::SUPER stash should be autovivified */
372             stash = gv_stashpvn(SvPVX(tmpstr), SvCUR(tmpstr), TRUE);
373             DEBUG_o( Perl_deb(aTHX_ "Treating %s as %s::%s\n",
374                          origname, HvNAME(stash), name) );
375         }
376         else
377             /* don't autovifify if ->NoSuchStash::method */
378             stash = gv_stashpvn(origname, nsplit - origname, FALSE);
379     }
380
381     gv = gv_fetchmeth(stash, name, nend - name, 0);
382     if (!gv) {
383         if (strEQ(name,"import") || strEQ(name,"unimport"))
384             gv = (GV*)&PL_sv_yes;
385         else if (autoload)
386             gv = gv_autoload4(stash, name, nend - name, TRUE);
387     }
388     else if (autoload) {
389         CV* cv = GvCV(gv);
390         if (!CvROOT(cv) && !CvXSUB(cv)) {
391             GV* stubgv;
392             GV* autogv;
393
394             if (CvANON(cv))
395                 stubgv = gv;
396             else {
397                 stubgv = CvGV(cv);
398                 if (GvCV(stubgv) != cv)         /* orphaned import */
399                     stubgv = gv;
400             }
401             autogv = gv_autoload4(GvSTASH(stubgv),
402                                   GvNAME(stubgv), GvNAMELEN(stubgv), TRUE);
403             if (autogv)
404                 gv = autogv;
405         }
406     }
407
408     return gv;
409 }
410
411 GV*
412 Perl_gv_autoload4(pTHX_ HV *stash, const char *name, STRLEN len, I32 method)
413 {
414     static char autoload[] = "AUTOLOAD";
415     static STRLEN autolen = 8;
416     GV* gv;
417     CV* cv;
418     HV* varstash;
419     GV* vargv;
420     SV* varsv;
421
422     if (!stash)
423         return Nullgv;  /* UNIVERSAL::AUTOLOAD could cause trouble */
424     if (len == autolen && strnEQ(name, autoload, autolen))
425         return Nullgv;
426     if (!(gv = gv_fetchmeth(stash, autoload, autolen, FALSE)))
427         return Nullgv;
428     cv = GvCV(gv);
429
430     if (!(CvROOT(cv) || CvXSUB(cv)))
431         return Nullgv;
432
433     /*
434      * Inheriting AUTOLOAD for non-methods works ... for now.
435      */
436     if (ckWARN(WARN_DEPRECATED) && !method &&
437         (GvCVGEN(gv) || GvSTASH(gv) != stash))
438         Perl_warner(aTHX_ WARN_DEPRECATED,
439           "Use of inherited AUTOLOAD for non-method %s::%.*s() is deprecated",
440              HvNAME(stash), (int)len, name);
441
442 #ifndef USE_5005THREADS
443     if (CvXSUB(cv)) {
444         /* rather than lookup/init $AUTOLOAD here
445          * only to have the XSUB do another lookup for $AUTOLOAD
446          * and split that value on the last '::',
447          * pass along the same data via some unused fields in the CV
448          */
449         CvSTASH(cv) = stash;
450         SvPVX(cv) = (char *)name; /* cast to lose constness warning */
451         SvCUR(cv) = len;
452         return gv;
453     }
454 #endif
455
456     /*
457      * Given &FOO::AUTOLOAD, set $FOO::AUTOLOAD to desired function name.
458      * The subroutine's original name may not be "AUTOLOAD", so we don't
459      * use that, but for lack of anything better we will use the sub's
460      * original package to look up $AUTOLOAD.
461      */
462     varstash = GvSTASH(CvGV(cv));
463     vargv = *(GV**)hv_fetch(varstash, autoload, autolen, TRUE);
464     ENTER;
465
466 #ifdef USE_5005THREADS
467     sv_lock((SV *)varstash);
468 #endif
469     if (!isGV(vargv))
470         gv_init(vargv, varstash, autoload, autolen, FALSE);
471     LEAVE;
472     varsv = GvSV(vargv);
473 #ifdef USE_5005THREADS
474     sv_lock(varsv);
475 #endif
476     sv_setpv(varsv, HvNAME(stash));
477     sv_catpvn(varsv, "::", 2);
478     sv_catpvn(varsv, name, len);
479     SvTAINTED_off(varsv);
480     return gv;
481 }
482
483 /* The "gv" parameter should be the glob known to Perl code as *!
484  * The scalar must already have been magicalized.
485  */
486 STATIC void
487 S_require_errno(pTHX_ GV *gv)
488 {
489     HV* stash = gv_stashpvn("Errno",5,FALSE);
490
491     if (!stash || !(gv_fetchmethod(stash, "TIEHASH"))) { 
492         dSP;
493         PUTBACK;
494         ENTER;
495         save_scalar(gv); /* keep the value of $! */
496         require_pv("Errno.pm");
497         LEAVE;
498         SPAGAIN;
499         stash = gv_stashpvn("Errno",5,FALSE);
500         if (!stash || !(gv_fetchmethod(stash, "TIEHASH")))
501             Perl_croak(aTHX_ "Can't use %%! because Errno.pm is not available");
502     }
503 }
504
505 /*
506 =for apidoc gv_stashpv
507
508 Returns a pointer to the stash for a specified package.  C<name> should
509 be a valid UTF-8 string.  If C<create> is set then the package will be
510 created if it does not already exist.  If C<create> is not set and the
511 package does not exist then NULL is returned.
512
513 =cut
514 */
515
516 HV*
517 Perl_gv_stashpv(pTHX_ const char *name, I32 create)
518 {
519     return gv_stashpvn(name, strlen(name), create);
520 }
521
522 HV*
523 Perl_gv_stashpvn(pTHX_ const char *name, U32 namelen, I32 create)
524 {
525     char smallbuf[256];
526     char *tmpbuf;
527     HV *stash;
528     GV *tmpgv;
529
530     if (namelen + 3 < sizeof smallbuf)
531         tmpbuf = smallbuf;
532     else
533         New(606, tmpbuf, namelen + 3, char);
534     Copy(name,tmpbuf,namelen,char);
535     tmpbuf[namelen++] = ':';
536     tmpbuf[namelen++] = ':';
537     tmpbuf[namelen] = '\0';
538     tmpgv = gv_fetchpv(tmpbuf, create, SVt_PVHV);
539     if (tmpbuf != smallbuf)
540         Safefree(tmpbuf);
541     if (!tmpgv)
542         return 0;
543     if (!GvHV(tmpgv))
544         GvHV(tmpgv) = newHV();
545     stash = GvHV(tmpgv);
546     if (!HvNAME(stash))
547         HvNAME(stash) = savepv(name);
548     return stash;
549 }
550
551 /*
552 =for apidoc gv_stashsv
553
554 Returns a pointer to the stash for a specified package, which must be a
555 valid UTF-8 string.  See C<gv_stashpv>.
556
557 =cut
558 */
559
560 HV*
561 Perl_gv_stashsv(pTHX_ SV *sv, I32 create)
562 {
563     register char *ptr;
564     STRLEN len;
565     ptr = SvPV(sv,len);
566     return gv_stashpvn(ptr, len, create);
567 }
568
569
570 GV *
571 Perl_gv_fetchpv(pTHX_ const char *nambeg, I32 add, I32 sv_type)
572 {
573     register const char *name = nambeg;
574     register GV *gv = 0;
575     GV**gvp;
576     I32 len;
577     register const char *namend;
578     HV *stash = 0;
579
580     if (*name == '*' && isALPHA(name[1])) /* accidental stringify on a GV? */
581         name++;
582
583     for (namend = name; *namend; namend++) {
584         if ((*namend == ':' && namend[1] == ':')
585             || (*namend == '\'' && namend[1]))
586         {
587             if (!stash)
588                 stash = PL_defstash;
589             if (!stash || !SvREFCNT(stash)) /* symbol table under destruction */
590                 return Nullgv;
591
592             len = namend - name;
593             if (len > 0) {
594                 char smallbuf[256];
595                 char *tmpbuf;
596
597                 if (len + 3 < sizeof smallbuf)
598                     tmpbuf = smallbuf;
599                 else
600                     New(601, tmpbuf, len+3, char);
601                 Copy(name, tmpbuf, len, char);
602                 tmpbuf[len++] = ':';
603                 tmpbuf[len++] = ':';
604                 tmpbuf[len] = '\0';
605                 gvp = (GV**)hv_fetch(stash,tmpbuf,len,add);
606                 gv = gvp ? *gvp : Nullgv;
607                 if (gv && gv != (GV*)&PL_sv_undef) {
608                     if (SvTYPE(gv) != SVt_PVGV)
609                         gv_init(gv, stash, tmpbuf, len, (add & GV_ADDMULTI));
610                     else
611                         GvMULTI_on(gv);
612                 }
613                 if (tmpbuf != smallbuf)
614                     Safefree(tmpbuf);
615                 if (!gv || gv == (GV*)&PL_sv_undef)
616                     return Nullgv;
617
618                 if (!(stash = GvHV(gv)))
619                     stash = GvHV(gv) = newHV();
620
621                 if (!HvNAME(stash))
622                     HvNAME(stash) = savepvn(nambeg, namend - nambeg);
623             }
624
625             if (*namend == ':')
626                 namend++;
627             namend++;
628             name = namend;
629             if (!*name)
630                 return gv ? gv : (GV*)*hv_fetch(PL_defstash, "main::", 6, TRUE);
631         }
632     }
633     len = namend - name;
634     if (!len)
635         len = 1;
636
637     /* No stash in name, so see how we can default */
638
639     if (!stash) {
640         if (isIDFIRST_lazy(name)) {
641             bool global = FALSE;
642
643             if (isUPPER(*name)) {
644                 if (*name == 'S' && (
645                     strEQ(name, "SIG") ||
646                     strEQ(name, "STDIN") ||
647                     strEQ(name, "STDOUT") ||
648                     strEQ(name, "STDERR")))
649                     global = TRUE;
650                 else if (*name == 'I' && strEQ(name, "INC"))
651                     global = TRUE;
652                 else if (*name == 'E' && strEQ(name, "ENV"))
653                     global = TRUE;
654                 else if (*name == 'A' && (
655                   strEQ(name, "ARGV") ||
656                   strEQ(name, "ARGVOUT")))
657                     global = TRUE;
658             }
659             else if (*name == '_' && !name[1])
660                 global = TRUE;
661
662             if (global)
663                 stash = PL_defstash;
664             else if ((COP*)PL_curcop == &PL_compiling) {
665                 stash = PL_curstash;
666                 if (add && (PL_hints & HINT_STRICT_VARS) &&
667                     sv_type != SVt_PVCV &&
668                     sv_type != SVt_PVGV &&
669                     sv_type != SVt_PVFM &&
670                     sv_type != SVt_PVIO &&
671                     !(len == 1 && sv_type == SVt_PV && strchr("ab",*name)) )
672                 {
673                     gvp = (GV**)hv_fetch(stash,name,len,0);
674                     if (!gvp ||
675                         *gvp == (GV*)&PL_sv_undef ||
676                         SvTYPE(*gvp) != SVt_PVGV)
677                     {
678                         stash = 0;
679                     }
680                     else if ((sv_type == SVt_PV   && !GvIMPORTED_SV(*gvp)) ||
681                              (sv_type == SVt_PVAV && !GvIMPORTED_AV(*gvp)) ||
682                              (sv_type == SVt_PVHV && !GvIMPORTED_HV(*gvp)) )
683                     {
684                         Perl_warn(aTHX_ "Variable \"%c%s\" is not imported",
685                             sv_type == SVt_PVAV ? '@' :
686                             sv_type == SVt_PVHV ? '%' : '$',
687                             name);
688                         if (GvCVu(*gvp))
689                             Perl_warn(aTHX_ "\t(Did you mean &%s instead?)\n", name);
690                         stash = 0;
691                     }
692                 }
693             }
694             else
695                 stash = CopSTASH(PL_curcop);
696         }
697         else
698             stash = PL_defstash;
699     }
700
701     /* By this point we should have a stash and a name */
702
703     if (!stash) {
704         if (add) {
705             qerror(Perl_mess(aTHX_
706                  "Global symbol \"%s%s\" requires explicit package name",
707                  (sv_type == SVt_PV ? "$"
708                   : sv_type == SVt_PVAV ? "@"
709                   : sv_type == SVt_PVHV ? "%"
710                   : ""), name));
711             stash = PL_nullstash;
712         }
713         else
714             return Nullgv;
715     }
716
717     if (!SvREFCNT(stash))       /* symbol table under destruction */
718         return Nullgv;
719
720     gvp = (GV**)hv_fetch(stash,name,len,add);
721     if (!gvp || *gvp == (GV*)&PL_sv_undef)
722         return Nullgv;
723     gv = *gvp;
724     if (SvTYPE(gv) == SVt_PVGV) {
725         if (add) {
726             GvMULTI_on(gv);
727             gv_init_sv(gv, sv_type);
728             if (*name=='!' && sv_type == SVt_PVHV && len==1)
729                 require_errno(gv);
730         }
731         return gv;
732     } else if (add & GV_NOINIT) {
733         return gv;
734     }
735
736     /* Adding a new symbol */
737
738     if (add & GV_ADDWARN && ckWARN_d(WARN_INTERNAL))
739         Perl_warner(aTHX_ WARN_INTERNAL, "Had to create %s unexpectedly", nambeg);
740     gv_init(gv, stash, name, len, add & GV_ADDMULTI);
741     gv_init_sv(gv, sv_type);
742
743     if (isALPHA(name[0]) && ! (isLEXWARN_on ? ckWARN(WARN_ONCE) 
744                                             : (PL_dowarn & G_WARN_ON ) ) )
745         GvMULTI_on(gv) ;
746
747     /* set up magic where warranted */
748     switch (*name) {
749     case 'A':
750         if (strEQ(name, "ARGV")) {
751             IoFLAGS(GvIOn(gv)) |= IOf_ARGV|IOf_START;
752         }
753         break;
754     case 'E':
755         if (strnEQ(name, "EXPORT", 6))
756             GvMULTI_on(gv);
757         break;
758     case 'I':
759         if (strEQ(name, "ISA")) {
760             AV* av = GvAVn(gv);
761             GvMULTI_on(gv);
762             sv_magic((SV*)av, (SV*)gv, PERL_MAGIC_isa, Nullch, 0);
763             /* NOTE: No support for tied ISA */
764             if ((add & GV_ADDMULTI) && strEQ(nambeg,"AnyDBM_File::ISA")
765                 && AvFILLp(av) == -1)
766             {
767                 char *pname;
768                 av_push(av, newSVpvn(pname = "NDBM_File",9));
769                 gv_stashpvn(pname, 9, TRUE);
770                 av_push(av, newSVpvn(pname = "DB_File",7));
771                 gv_stashpvn(pname, 7, TRUE);
772                 av_push(av, newSVpvn(pname = "GDBM_File",9));
773                 gv_stashpvn(pname, 9, TRUE);
774                 av_push(av, newSVpvn(pname = "SDBM_File",9));
775                 gv_stashpvn(pname, 9, TRUE);
776                 av_push(av, newSVpvn(pname = "ODBM_File",9));
777                 gv_stashpvn(pname, 9, TRUE);
778             }
779         }
780         break;
781     case 'O':
782         if (strEQ(name, "OVERLOAD")) {
783             HV* hv = GvHVn(gv);
784             GvMULTI_on(gv);
785             hv_magic(hv, Nullgv, PERL_MAGIC_overload);
786         }
787         break;
788     case 'S':
789         if (strEQ(name, "SIG")) {
790             HV *hv;
791             I32 i;
792             if (!PL_psig_ptr) {
793                 Newz(73, PL_psig_ptr,  SIG_SIZE, SV*);
794                 Newz(73, PL_psig_name, SIG_SIZE, SV*);
795                 Newz(73, PL_psig_pend, SIG_SIZE, int);
796             }
797             GvMULTI_on(gv);
798             hv = GvHVn(gv);
799             hv_magic(hv, Nullgv, PERL_MAGIC_sig);
800             for (i = 1; i < SIG_SIZE; i++) {
801                 SV ** init;
802                 init = hv_fetch(hv, PL_sig_name[i], strlen(PL_sig_name[i]), 1);
803                 if (init)
804                     sv_setsv(*init, &PL_sv_undef);
805                 PL_psig_ptr[i] = 0;
806                 PL_psig_name[i] = 0;
807                 PL_psig_pend[i] = 0;
808             }
809         }
810         break;
811     case 'V':
812         if (strEQ(name, "VERSION"))
813             GvMULTI_on(gv);
814         break;
815
816     case '&':
817     case '`':
818     case '\'':
819        if (
820            len > 1 ||
821            sv_type == SVt_PVAV ||
822            sv_type == SVt_PVHV ||
823            sv_type == SVt_PVCV ||
824            sv_type == SVt_PVGV ||
825            sv_type == SVt_PVFM ||
826            sv_type == SVt_PVIO
827        ) { break; }
828         PL_sawampersand = TRUE;
829         goto ro_magicalize;
830
831     case ':':
832         if (len > 1)
833             break;
834         sv_setpv(GvSV(gv),PL_chopset);
835         goto magicalize;
836
837     case '?':
838         if (len > 1)
839             break;
840 #ifdef COMPLEX_STATUS
841         (void)SvUPGRADE(GvSV(gv), SVt_PVLV);
842 #endif
843         goto magicalize;
844
845     case '!':
846         if (len > 1)
847             break;
848
849         /* If %! has been used, automatically load Errno.pm.
850            The require will itself set errno, so in order to
851            preserve its value we have to set up the magic
852            now (rather than going to magicalize)
853         */
854
855         sv_magic(GvSV(gv), (SV*)gv, PERL_MAGIC_sv, name, len);
856
857         if (sv_type == SVt_PVHV)
858             require_errno(gv);
859
860         break;
861     case '-':
862         if (len > 1)
863             break;
864         else {
865             AV* av = GvAVn(gv);
866             sv_magic((SV*)av, Nullsv, PERL_MAGIC_regdata, Nullch, 0);
867             SvREADONLY_on(av);
868         }
869         goto magicalize;
870     case '#':
871     case '*':
872         if (ckWARN(WARN_DEPRECATED) && len == 1 && sv_type == SVt_PV)
873             Perl_warner(aTHX_ WARN_DEPRECATED, "Use of $%s is deprecated", name);
874         /* FALL THROUGH */
875     case '[':
876     case '^':
877     case '~':
878     case '=':
879     case '%':
880     case '.':
881     case '(':
882     case ')':
883     case '<':
884     case '>':
885     case ',':
886     case '\\':
887     case '/':
888     case '\001':        /* $^A */
889     case '\003':        /* $^C */
890     case '\004':        /* $^D */
891     case '\005':        /* $^E */
892     case '\006':        /* $^F */
893     case '\010':        /* $^H */
894     case '\011':        /* $^I, NOT \t in EBCDIC */
895     case '\016':        /* $^N */
896     case '\020':        /* $^P */
897     case '\024':        /* $^T */
898         if (len > 1)
899             break;
900         goto magicalize;
901     case '|':
902         if (len > 1)
903             break;
904         sv_setiv(GvSV(gv), (IV)(IoFLAGS(GvIOp(PL_defoutgv)) & IOf_FLUSH) != 0);
905         goto magicalize;
906     case '\017':        /* $^O & $^OPEN */
907         if (len > 1 && strNE(name, "\017PEN"))
908             break;
909         goto magicalize;
910     case '\023':        /* $^S */
911         if (len > 1)
912             break;
913         goto ro_magicalize;
914     case '\027':        /* $^W & $^WARNING_BITS */
915         if (len > 1 && strNE(name, "\027ARNING_BITS")
916             && strNE(name, "\027IDE_SYSTEM_CALLS"))
917             break;
918         goto magicalize;
919
920     case '+':
921         if (len > 1)
922             break;
923         else {
924             AV* av = GvAVn(gv);
925             sv_magic((SV*)av, (SV*)av, PERL_MAGIC_regdata, Nullch, 0);
926             SvREADONLY_on(av);
927         }
928         /* FALL THROUGH */
929     case '1':
930     case '2':
931     case '3':
932     case '4':
933     case '5':
934     case '6':
935     case '7':
936     case '8':
937     case '9':
938         /* ensures variable is only digits */
939         /* ${"1foo"} fails this test (and is thus writeable) */
940         /* added by japhy, but borrowed from is_gv_magical */
941
942         if (len > 1) {
943             const char *end = name + len;
944             while (--end > name) {
945                 if (!isDIGIT(*end)) return gv;
946             }
947         }
948
949       ro_magicalize:
950         SvREADONLY_on(GvSV(gv));
951       magicalize:
952         sv_magic(GvSV(gv), (SV*)gv, PERL_MAGIC_sv, name, len);
953         break;
954
955     case '\014':        /* $^L */
956         if (len > 1)
957             break;
958         sv_setpv(GvSV(gv),"\f");
959         PL_formfeed = GvSV(gv);
960         break;
961     case ';':
962         if (len > 1)
963             break;
964         sv_setpv(GvSV(gv),"\034");
965         break;
966     case ']':
967         if (len == 1) {
968             SV *sv = GvSV(gv);
969             (void)SvUPGRADE(sv, SVt_PVNV);
970             Perl_sv_setpvf(aTHX_ sv,
971 #if defined(PERL_SUBVERSION) && (PERL_SUBVERSION > 0)
972                             "%8.6"
973 #else
974                             "%5.3"
975 #endif
976                             NVff,
977                             SvNVX(PL_patchlevel));
978             SvNVX(sv) = SvNVX(PL_patchlevel);
979             SvNOK_on(sv);
980             SvREADONLY_on(sv);
981         }
982         break;
983     case '\026':        /* $^V */
984         if (len == 1) {
985             SV *sv = GvSV(gv);
986             GvSV(gv) = SvREFCNT_inc(PL_patchlevel);
987             SvREFCNT_dec(sv);
988         }
989         break;
990     }
991     return gv;
992 }
993
994 void
995 Perl_gv_fullname4(pTHX_ SV *sv, GV *gv, const char *prefix, bool keepmain)
996 {
997     HV *hv = GvSTASH(gv);
998     if (!hv) {
999         (void)SvOK_off(sv);
1000         return;
1001     }
1002     sv_setpv(sv, prefix ? prefix : "");
1003     if (keepmain || strNE(HvNAME(hv), "main")) {
1004         sv_catpv(sv,HvNAME(hv));
1005         sv_catpvn(sv,"::", 2);
1006     }
1007     sv_catpvn(sv,GvNAME(gv),GvNAMELEN(gv));
1008 }
1009
1010 void
1011 Perl_gv_fullname3(pTHX_ SV *sv, GV *gv, const char *prefix)
1012 {
1013     HV *hv = GvSTASH(gv);
1014     if (!hv) {
1015         (void)SvOK_off(sv);
1016         return;
1017     }
1018     sv_setpv(sv, prefix ? prefix : "");
1019     sv_catpv(sv,HvNAME(hv));
1020     sv_catpvn(sv,"::", 2);
1021     sv_catpvn(sv,GvNAME(gv),GvNAMELEN(gv));
1022 }
1023
1024 void
1025 Perl_gv_efullname4(pTHX_ SV *sv, GV *gv, const char *prefix, bool keepmain)
1026 {
1027     GV *egv = GvEGV(gv);
1028     if (!egv)
1029         egv = gv;
1030     gv_fullname4(sv, egv, prefix, keepmain);
1031 }
1032
1033 void
1034 Perl_gv_efullname3(pTHX_ SV *sv, GV *gv, const char *prefix)
1035 {
1036     GV *egv = GvEGV(gv);
1037     if (!egv)
1038         egv = gv;
1039     gv_fullname3(sv, egv, prefix);
1040 }
1041
1042 /* XXX compatibility with versions <= 5.003. */
1043 void
1044 Perl_gv_fullname(pTHX_ SV *sv, GV *gv)
1045 {
1046     gv_fullname3(sv, gv, sv == (SV*)gv ? "*" : "");
1047 }
1048
1049 /* XXX compatibility with versions <= 5.003. */
1050 void
1051 Perl_gv_efullname(pTHX_ SV *sv, GV *gv)
1052 {
1053     gv_efullname3(sv, gv, sv == (SV*)gv ? "*" : "");
1054 }
1055
1056 IO *
1057 Perl_newIO(pTHX)
1058 {
1059     IO *io;
1060     GV *iogv;
1061
1062     io = (IO*)NEWSV(0,0);
1063     sv_upgrade((SV *)io,SVt_PVIO);
1064     SvREFCNT(io) = 1;
1065     SvOBJECT_on(io);
1066     iogv = gv_fetchpv("FileHandle::", FALSE, SVt_PVHV);
1067     /* unless exists($main::{FileHandle}) and defined(%main::FileHandle::) */
1068     if (!(iogv && GvHV(iogv) && HvARRAY(GvHV(iogv))))
1069       iogv = gv_fetchpv("IO::Handle::", TRUE, SVt_PVHV);
1070     SvSTASH(io) = (HV*)SvREFCNT_inc(GvHV(iogv));
1071     return io;
1072 }
1073
1074 void
1075 Perl_gv_check(pTHX_ HV *stash)
1076 {
1077     register HE *entry;
1078     register I32 i;
1079     register GV *gv;
1080     HV *hv;
1081
1082     if (!HvARRAY(stash))
1083         return;
1084     for (i = 0; i <= (I32) HvMAX(stash); i++) {
1085         for (entry = HvARRAY(stash)[i]; entry; entry = HeNEXT(entry)) {
1086             if (HeKEY(entry)[HeKLEN(entry)-1] == ':' &&
1087                 (gv = (GV*)HeVAL(entry)) && (hv = GvHV(gv)))
1088             {
1089                 if (hv != PL_defstash && hv != stash)
1090                      gv_check(hv);              /* nested package */
1091             }
1092             else if (isALPHA(*HeKEY(entry))) {
1093                 char *file;
1094                 gv = (GV*)HeVAL(entry);
1095                 if (SvTYPE(gv) != SVt_PVGV || GvMULTI(gv))
1096                     continue;
1097                 file = GvFILE(gv);
1098                 /* performance hack: if filename is absolute and it's a standard
1099                  * module, don't bother warning */
1100                 if (file
1101                     && PERL_FILE_IS_ABSOLUTE(file)
1102 #ifdef MACOS_TRADITIONAL
1103                     && (instr(file, ":lib:")
1104 #else
1105                     && (instr(file, "/lib/")
1106 #endif
1107                     || instr(file, ".pm")))
1108                 {
1109                     continue;
1110                 }
1111                 CopLINE_set(PL_curcop, GvLINE(gv));
1112 #ifdef USE_ITHREADS
1113                 CopFILE(PL_curcop) = file;      /* set for warning */
1114 #else
1115                 CopFILEGV(PL_curcop) = gv_fetchfile(file);
1116 #endif
1117                 Perl_warner(aTHX_ WARN_ONCE,
1118                         "Name \"%s::%s\" used only once: possible typo",
1119                         HvNAME(stash), GvNAME(gv));
1120             }
1121         }
1122     }
1123 }
1124
1125 GV *
1126 Perl_newGVgen(pTHX_ char *pack)
1127 {
1128     return gv_fetchpv(Perl_form(aTHX_ "%s::_GEN_%ld", pack, (long)PL_gensym++),
1129                       TRUE, SVt_PVGV);
1130 }
1131
1132 /* hopefully this is only called on local symbol table entries */
1133
1134 GP*
1135 Perl_gp_ref(pTHX_ GP *gp)
1136 {
1137     if (!gp)
1138         return (GP*)NULL;
1139     gp->gp_refcnt++;
1140     if (gp->gp_cv) {
1141         if (gp->gp_cvgen) {
1142             /* multi-named GPs cannot be used for method cache */
1143             SvREFCNT_dec(gp->gp_cv);
1144             gp->gp_cv = Nullcv;
1145             gp->gp_cvgen = 0;
1146         }
1147         else {
1148             /* Adding a new name to a subroutine invalidates method cache */
1149             PL_sub_generation++;
1150         }
1151     }
1152     return gp;
1153 }
1154
1155 void
1156 Perl_gp_free(pTHX_ GV *gv)
1157 {
1158     GP* gp;
1159
1160     if (!gv || !(gp = GvGP(gv)))
1161         return;
1162     if (gp->gp_refcnt == 0) {
1163         if (ckWARN_d(WARN_INTERNAL))
1164             Perl_warner(aTHX_ WARN_INTERNAL,
1165                         "Attempt to free unreferenced glob pointers");
1166         return;
1167     }
1168     if (gp->gp_cv) {
1169         /* Deleting the name of a subroutine invalidates method cache */
1170         PL_sub_generation++;
1171     }
1172     if (--gp->gp_refcnt > 0) {
1173         if (gp->gp_egv == gv)
1174             gp->gp_egv = 0;
1175         return;
1176     }
1177
1178     SvREFCNT_dec(gp->gp_sv);
1179     SvREFCNT_dec(gp->gp_av);
1180     SvREFCNT_dec(gp->gp_hv);
1181     SvREFCNT_dec(gp->gp_io);
1182     SvREFCNT_dec(gp->gp_cv);
1183     SvREFCNT_dec(gp->gp_form);
1184
1185     Safefree(gp);
1186     GvGP(gv) = 0;
1187 }
1188
1189 #if defined(CRIPPLED_CC) && (defined(iAPX286) || defined(M_I286) || defined(I80286))
1190 #define MICROPORT
1191 #endif
1192
1193 #ifdef  MICROPORT       /* Microport 2.4 hack */
1194 AV *GvAVn(gv)
1195 register GV *gv;
1196 {
1197     if (GvGP(gv)->gp_av)
1198         return GvGP(gv)->gp_av;
1199     else
1200         return GvGP(gv_AVadd(gv))->gp_av;
1201 }
1202
1203 HV *GvHVn(gv)
1204 register GV *gv;
1205 {
1206     if (GvGP(gv)->gp_hv)
1207         return GvGP(gv)->gp_hv;
1208     else
1209         return GvGP(gv_HVadd(gv))->gp_hv;
1210 }
1211 #endif                  /* Microport 2.4 hack */
1212
1213 int
1214 Perl_magic_freeovrld(pTHX_ SV *sv, MAGIC *mg)
1215 {
1216     AMT *amtp = (AMT*)mg->mg_ptr;
1217     if (amtp && AMT_AMAGIC(amtp)) {
1218         int i;
1219         for (i = 1; i < NofAMmeth; i++) {
1220             CV *cv = amtp->table[i];
1221             if (cv != Nullcv) {
1222                 SvREFCNT_dec((SV *) cv);
1223                 amtp->table[i] = Nullcv;
1224             }
1225         }
1226     }
1227  return 0;
1228 }
1229
1230 /* Updates and caches the CV's */
1231
1232 bool
1233 Perl_Gv_AMupdate(pTHX_ HV *stash)
1234 {
1235   GV* gv;
1236   CV* cv;
1237   MAGIC* mg=mg_find((SV*)stash, PERL_MAGIC_overload_table);
1238   AMT *amtp = (mg) ? (AMT*)mg->mg_ptr: (AMT *) NULL;
1239   AMT amt;
1240
1241   if (mg && amtp->was_ok_am == PL_amagic_generation
1242       && amtp->was_ok_sub == PL_sub_generation)
1243       return AMT_OVERLOADED(amtp);
1244   sv_unmagic((SV*)stash, PERL_MAGIC_overload_table);
1245
1246   DEBUG_o( Perl_deb(aTHX_ "Recalcing overload magic in package %s\n",HvNAME(stash)) );
1247
1248   Zero(&amt,1,AMT);
1249   amt.was_ok_am = PL_amagic_generation;
1250   amt.was_ok_sub = PL_sub_generation;
1251   amt.fallback = AMGfallNO;
1252   amt.flags = 0;
1253
1254   {
1255     int filled = 0, have_ovl = 0;
1256     int i, lim = 1;
1257     SV* sv = NULL;
1258
1259     /* Work with "fallback" key, which we assume to be first in PL_AMG_names */
1260
1261     /* Try to find via inheritance. */
1262     gv = gv_fetchmeth(stash, PL_AMG_names[0], 2, -1);
1263     if (gv)
1264         sv = GvSV(gv);
1265
1266     if (!gv)
1267         lim = DESTROY_amg;              /* Skip overloading entries. */
1268     else if (SvTRUE(sv))
1269         amt.fallback=AMGfallYES;
1270     else if (SvOK(sv))
1271         amt.fallback=AMGfallNEVER;
1272
1273     for (i = 1; i < lim; i++)
1274         amt.table[i] = Nullcv;
1275     for (; i < NofAMmeth; i++) {
1276         char *cooky = (char*)PL_AMG_names[i];
1277         /* Human-readable form, for debugging: */
1278         char *cp = (i >= DESTROY_amg ? cooky : AMG_id2name(i));
1279         STRLEN l = strlen(cooky);
1280
1281         DEBUG_o( Perl_deb(aTHX_ "Checking overloading of `%s' in package `%.256s'\n",
1282                      cp, HvNAME(stash)) );
1283         /* don't fill the cache while looking up! */
1284         gv = gv_fetchmeth(stash, cooky, l, -1);
1285         cv = 0;
1286         if (gv && (cv = GvCV(gv))) {
1287             if (GvNAMELEN(CvGV(cv)) == 3 && strEQ(GvNAME(CvGV(cv)), "nil")
1288                 && strEQ(HvNAME(GvSTASH(CvGV(cv))), "overload")) {
1289                 /* GvSV contains the name of the method. */
1290                 GV *ngv;
1291                 
1292                 DEBUG_o( Perl_deb(aTHX_ "Resolving method `%.256s' for overloaded `%s' in package `%.256s'\n",
1293                              SvPV_nolen(GvSV(gv)), cp, HvNAME(stash)) );
1294                 if (!SvPOK(GvSV(gv))
1295                     || !(ngv = gv_fetchmethod_autoload(stash, SvPVX(GvSV(gv)),
1296                                                        FALSE)))
1297                 {
1298                     /* Can be an import stub (created by `can'). */
1299                     if (GvCVGEN(gv)) {
1300                         Perl_croak(aTHX_ "Stub found while resolving method `%.256s' overloading `%s' in package `%.256s'",
1301                               (SvPOK(GvSV(gv)) ?  SvPVX(GvSV(gv)) : "???" ),
1302                               cp, HvNAME(stash));
1303                     } else
1304                         Perl_croak(aTHX_ "Can't resolve method `%.256s' overloading `%s' in package `%.256s'",
1305                               (SvPOK(GvSV(gv)) ?  SvPVX(GvSV(gv)) : "???" ),
1306                               cp, HvNAME(stash));
1307                 }
1308                 cv = GvCV(gv = ngv);
1309             }
1310             DEBUG_o( Perl_deb(aTHX_ "Overloading `%s' in package `%.256s' via `%.256s::%.256s' \n",
1311                          cp, HvNAME(stash), HvNAME(GvSTASH(CvGV(cv))),
1312                          GvNAME(CvGV(cv))) );
1313             filled = 1;
1314             if (i < DESTROY_amg)
1315                 have_ovl = 1;
1316         }
1317         amt.table[i]=(CV*)SvREFCNT_inc(cv);
1318     }
1319     if (filled) {
1320       AMT_AMAGIC_on(&amt);
1321       if (have_ovl)
1322           AMT_OVERLOADED_on(&amt);
1323       sv_magic((SV*)stash, 0, PERL_MAGIC_overload_table,
1324                                                 (char*)&amt, sizeof(AMT));
1325       return have_ovl;
1326     }
1327   }
1328   /* Here we have no table: */
1329   /* no_table: */
1330   AMT_AMAGIC_off(&amt);
1331   sv_magic((SV*)stash, 0, PERL_MAGIC_overload_table,
1332                                                 (char*)&amt, sizeof(AMTS));
1333   return FALSE;
1334 }
1335
1336
1337 CV*
1338 Perl_gv_handler(pTHX_ HV *stash, I32 id)
1339 {
1340     MAGIC *mg;
1341     AMT *amtp;
1342
1343     if (!stash)
1344         return Nullcv;
1345     mg = mg_find((SV*)stash, PERL_MAGIC_overload_table);
1346     if (!mg) {
1347       do_update:
1348         Gv_AMupdate(stash);
1349         mg = mg_find((SV*)stash, PERL_MAGIC_overload_table);
1350     }
1351     amtp = (AMT*)mg->mg_ptr;
1352     if ( amtp->was_ok_am != PL_amagic_generation
1353          || amtp->was_ok_sub != PL_sub_generation )
1354         goto do_update;
1355     if (AMT_AMAGIC(amtp))
1356         return amtp->table[id];
1357     return Nullcv;
1358 }
1359
1360
1361 SV*
1362 Perl_amagic_call(pTHX_ SV *left, SV *right, int method, int flags)
1363 {
1364   MAGIC *mg;
1365   CV *cv=NULL;
1366   CV **cvp=NULL, **ocvp=NULL;
1367   AMT *amtp=NULL, *oamtp=NULL;
1368   int off=0, off1, lr=0, assign=AMGf_assign & flags, notfound=0;
1369   int postpr = 0, force_cpy = 0, assignshift = assign ? 1 : 0;
1370 #ifdef DEBUGGING
1371   int fl=0;
1372 #endif
1373   HV* stash=NULL;
1374   if (!(AMGf_noleft & flags) && SvAMAGIC(left)
1375       && (stash = SvSTASH(SvRV(left)))
1376       && (mg = mg_find((SV*)stash, PERL_MAGIC_overload_table))
1377       && (ocvp = cvp = (AMT_AMAGIC((AMT*)mg->mg_ptr)
1378                         ? (oamtp = amtp = (AMT*)mg->mg_ptr)->table
1379                         : (CV **) NULL))
1380       && ((cv = cvp[off=method+assignshift])
1381           || (assign && amtp->fallback > AMGfallNEVER && /* fallback to
1382                                                           * usual method */
1383                   (
1384 #ifdef DEBUGGING
1385                    fl = 1,
1386 #endif 
1387                    cv = cvp[off=method])))) {
1388     lr = -1;                    /* Call method for left argument */
1389   } else {
1390     if (cvp && amtp->fallback > AMGfallNEVER && flags & AMGf_unary) {
1391       int logic;
1392
1393       /* look for substituted methods */
1394       /* In all the covered cases we should be called with assign==0. */
1395          switch (method) {
1396          case inc_amg:
1397            force_cpy = 1;
1398            if ((cv = cvp[off=add_ass_amg])
1399                || ((cv = cvp[off = add_amg]) && (force_cpy = 0, postpr = 1))) {
1400              right = &PL_sv_yes; lr = -1; assign = 1;
1401            }
1402            break;
1403          case dec_amg:
1404            force_cpy = 1;
1405            if ((cv = cvp[off = subtr_ass_amg])
1406                || ((cv = cvp[off = subtr_amg]) && (force_cpy = 0, postpr=1))) {
1407              right = &PL_sv_yes; lr = -1; assign = 1;
1408            }
1409            break;
1410          case bool__amg:
1411            (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=string_amg]));
1412            break;
1413          case numer_amg:
1414            (void)((cv = cvp[off=string_amg]) || (cv = cvp[off=bool__amg]));
1415            break;
1416          case string_amg:
1417            (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=bool__amg]));
1418            break;
1419  case not_amg:
1420    (void)((cv = cvp[off=bool__amg])
1421           || (cv = cvp[off=numer_amg])
1422           || (cv = cvp[off=string_amg]));
1423    postpr = 1;
1424    break;
1425          case copy_amg:
1426            {
1427              /*
1428                   * SV* ref causes confusion with the interpreter variable of
1429                   * the same name
1430                   */
1431              SV* tmpRef=SvRV(left);
1432              if (!SvROK(tmpRef) && SvTYPE(tmpRef) <= SVt_PVMG) {
1433                 /*
1434                  * Just to be extra cautious.  Maybe in some
1435                  * additional cases sv_setsv is safe, too.
1436                  */
1437                 SV* newref = newSVsv(tmpRef);
1438                 SvOBJECT_on(newref);
1439                 SvSTASH(newref) = (HV*)SvREFCNT_inc(SvSTASH(tmpRef));
1440                 return newref;
1441              }
1442            }
1443            break;
1444          case abs_amg:
1445            if ((cvp[off1=lt_amg] || cvp[off1=ncmp_amg])
1446                && ((cv = cvp[off=neg_amg]) || (cv = cvp[off=subtr_amg]))) {
1447              SV* nullsv=sv_2mortal(newSViv(0));
1448              if (off1==lt_amg) {
1449                SV* lessp = amagic_call(left,nullsv,
1450                                        lt_amg,AMGf_noright);
1451                logic = SvTRUE(lessp);
1452              } else {
1453                SV* lessp = amagic_call(left,nullsv,
1454                                        ncmp_amg,AMGf_noright);
1455                logic = (SvNV(lessp) < 0);
1456              }
1457              if (logic) {
1458                if (off==subtr_amg) {
1459                  right = left;
1460                  left = nullsv;
1461                  lr = 1;
1462                }
1463              } else {
1464                return left;
1465              }
1466            }
1467            break;
1468          case neg_amg:
1469            if ((cv = cvp[off=subtr_amg])) {
1470              right = left;
1471              left = sv_2mortal(newSViv(0));
1472              lr = 1;
1473            }
1474            break;
1475          case int_amg:
1476          case iter_amg:                 /* XXXX Eventually should do to_gv. */
1477              /* FAIL safe */
1478              return NULL;       /* Delegate operation to standard mechanisms. */
1479              break;
1480          case to_sv_amg:
1481          case to_av_amg:
1482          case to_hv_amg:
1483          case to_gv_amg:
1484          case to_cv_amg:
1485              /* FAIL safe */
1486              return left;       /* Delegate operation to standard mechanisms. */
1487              break;
1488          default:
1489            goto not_found;
1490          }
1491          if (!cv) goto not_found;
1492     } else if (!(AMGf_noright & flags) && SvAMAGIC(right)
1493                && (stash = SvSTASH(SvRV(right)))
1494                && (mg = mg_find((SV*)stash, PERL_MAGIC_overload_table))
1495                && (cvp = (AMT_AMAGIC((AMT*)mg->mg_ptr)
1496                           ? (amtp = (AMT*)mg->mg_ptr)->table
1497                           : (CV **) NULL))
1498                && (cv = cvp[off=method])) { /* Method for right
1499                                              * argument found */
1500       lr=1;
1501     } else if (((ocvp && oamtp->fallback > AMGfallNEVER
1502                  && (cvp=ocvp) && (lr = -1))
1503                 || (cvp && amtp->fallback > AMGfallNEVER && (lr=1)))
1504                && !(flags & AMGf_unary)) {
1505                                 /* We look for substitution for
1506                                  * comparison operations and
1507                                  * concatenation */
1508       if (method==concat_amg || method==concat_ass_amg
1509           || method==repeat_amg || method==repeat_ass_amg) {
1510         return NULL;            /* Delegate operation to string conversion */
1511       }
1512       off = -1;
1513       switch (method) {
1514          case lt_amg:
1515          case le_amg:
1516          case gt_amg:
1517          case ge_amg:
1518          case eq_amg:
1519          case ne_amg:
1520            postpr = 1; off=ncmp_amg; break;
1521          case slt_amg:
1522          case sle_amg:
1523          case sgt_amg:
1524          case sge_amg:
1525          case seq_amg:
1526          case sne_amg:
1527            postpr = 1; off=scmp_amg; break;
1528          }
1529       if (off != -1) cv = cvp[off];
1530       if (!cv) {
1531         goto not_found;
1532       }
1533     } else {
1534     not_found:                  /* No method found, either report or croak */
1535       switch (method) {
1536          case to_sv_amg:
1537          case to_av_amg:
1538          case to_hv_amg:
1539          case to_gv_amg:
1540          case to_cv_amg:
1541              /* FAIL safe */
1542              return left;       /* Delegate operation to standard mechanisms. */
1543              break;
1544       }
1545       if (ocvp && (cv=ocvp[nomethod_amg])) { /* Call report method */
1546         notfound = 1; lr = -1;
1547       } else if (cvp && (cv=cvp[nomethod_amg])) {
1548         notfound = 1; lr = 1;
1549       } else {
1550         SV *msg;
1551         if (off==-1) off=method;
1552         msg = sv_2mortal(Perl_newSVpvf(aTHX_
1553                       "Operation `%s': no method found,%sargument %s%s%s%s",
1554                       AMG_id2name(method + assignshift),
1555                       (flags & AMGf_unary ? " " : "\n\tleft "),
1556                       SvAMAGIC(left)?
1557                         "in overloaded package ":
1558                         "has no overloaded magic",
1559                       SvAMAGIC(left)?
1560                         HvNAME(SvSTASH(SvRV(left))):
1561                         "",
1562                       SvAMAGIC(right)?
1563                         ",\n\tright argument in overloaded package ":
1564                         (flags & AMGf_unary
1565                          ? ""
1566                          : ",\n\tright argument has no overloaded magic"),
1567                       SvAMAGIC(right)?
1568                         HvNAME(SvSTASH(SvRV(right))):
1569                         ""));
1570         if (amtp && amtp->fallback >= AMGfallYES) {
1571           DEBUG_o( Perl_deb(aTHX_ "%s", SvPVX(msg)) );
1572         } else {
1573           Perl_croak(aTHX_ "%"SVf, msg);
1574         }
1575         return NULL;
1576       }
1577       force_cpy = force_cpy || assign;
1578     }
1579   }
1580 #ifdef DEBUGGING
1581   if (!notfound) {
1582     DEBUG_o(Perl_deb(aTHX_
1583                      "Overloaded operator `%s'%s%s%s:\n\tmethod%s found%s in package %s%s\n",
1584                      AMG_id2name(off),
1585                      method+assignshift==off? "" :
1586                      " (initially `",
1587                      method+assignshift==off? "" :
1588                      AMG_id2name(method+assignshift),
1589                      method+assignshift==off? "" : "')",
1590                      flags & AMGf_unary? "" :
1591                      lr==1 ? " for right argument": " for left argument",
1592                      flags & AMGf_unary? " for argument" : "",
1593                      stash ? HvNAME(stash) : "null",
1594                      fl? ",\n\tassignment variant used": "") );
1595   }
1596 #endif
1597     /* Since we use shallow copy during assignment, we need
1598      * to dublicate the contents, probably calling user-supplied
1599      * version of copy operator
1600      */
1601     /* We need to copy in following cases:
1602      * a) Assignment form was called.
1603      *          assignshift==1,  assign==T, method + 1 == off
1604      * b) Increment or decrement, called directly.
1605      *          assignshift==0,  assign==0, method + 0 == off
1606      * c) Increment or decrement, translated to assignment add/subtr.
1607      *          assignshift==0,  assign==T,
1608      *          force_cpy == T
1609      * d) Increment or decrement, translated to nomethod.
1610      *          assignshift==0,  assign==0,
1611      *          force_cpy == T
1612      * e) Assignment form translated to nomethod.
1613      *          assignshift==1,  assign==T, method + 1 != off
1614      *          force_cpy == T
1615      */
1616     /*  off is method, method+assignshift, or a result of opcode substitution.
1617      *  In the latter case assignshift==0, so only notfound case is important.
1618      */
1619   if (( (method + assignshift == off)
1620         && (assign || (method == inc_amg) || (method == dec_amg)))
1621       || force_cpy)
1622     RvDEEPCP(left);
1623   {
1624     dSP;
1625     BINOP myop;
1626     SV* res;
1627     bool oldcatch = CATCH_GET;
1628
1629     CATCH_SET(TRUE);
1630     Zero(&myop, 1, BINOP);
1631     myop.op_last = (OP *) &myop;
1632     myop.op_next = Nullop;
1633     myop.op_flags = OPf_WANT_SCALAR | OPf_STACKED;
1634
1635     PUSHSTACKi(PERLSI_OVERLOAD);
1636     ENTER;
1637     SAVEOP();
1638     PL_op = (OP *) &myop;
1639     if (PERLDB_SUB && PL_curstash != PL_debstash)
1640         PL_op->op_private |= OPpENTERSUB_DB;
1641     PUTBACK;
1642     pp_pushmark();
1643
1644     EXTEND(SP, notfound + 5);
1645     PUSHs(lr>0? right: left);
1646     PUSHs(lr>0? left: right);
1647     PUSHs( lr > 0 ? &PL_sv_yes : ( assign ? &PL_sv_undef : &PL_sv_no ));
1648     if (notfound) {
1649       PUSHs( sv_2mortal(newSVpv(AMG_id2name(method + assignshift),0)));
1650     }
1651     PUSHs((SV*)cv);
1652     PUTBACK;
1653
1654     if ((PL_op = Perl_pp_entersub(aTHX)))
1655       CALLRUNOPS(aTHX);
1656     LEAVE;
1657     SPAGAIN;
1658
1659     res=POPs;
1660     PUTBACK;
1661     POPSTACK;
1662     CATCH_SET(oldcatch);
1663
1664     if (postpr) {
1665       int ans=0;
1666       switch (method) {
1667       case le_amg:
1668       case sle_amg:
1669         ans=SvIV(res)<=0; break;
1670       case lt_amg:
1671       case slt_amg:
1672         ans=SvIV(res)<0; break;
1673       case ge_amg:
1674       case sge_amg:
1675         ans=SvIV(res)>=0; break;
1676       case gt_amg:
1677       case sgt_amg:
1678         ans=SvIV(res)>0; break;
1679       case eq_amg:
1680       case seq_amg:
1681         ans=SvIV(res)==0; break;
1682       case ne_amg:
1683       case sne_amg:
1684         ans=SvIV(res)!=0; break;
1685       case inc_amg:
1686       case dec_amg:
1687         SvSetSV(left,res); return left;
1688       case not_amg:
1689         ans=!SvTRUE(res); break;
1690       }
1691       return boolSV(ans);
1692     } else if (method==copy_amg) {
1693       if (!SvROK(res)) {
1694         Perl_croak(aTHX_ "Copy method did not return a reference");
1695       }
1696       return SvREFCNT_inc(SvRV(res));
1697     } else {
1698       return res;
1699     }
1700   }
1701 }
1702
1703 /*
1704 =for apidoc is_gv_magical
1705
1706 Returns C<TRUE> if given the name of a magical GV.
1707
1708 Currently only useful internally when determining if a GV should be
1709 created even in rvalue contexts.
1710
1711 C<flags> is not used at present but available for future extension to
1712 allow selecting particular classes of magical variable.
1713
1714 =cut
1715 */
1716 bool
1717 Perl_is_gv_magical(pTHX_ char *name, STRLEN len, U32 flags)
1718 {
1719     if (!len)
1720         return FALSE;
1721
1722     switch (*name) {
1723     case 'I':
1724         if (len == 3 && strEQ(name, "ISA"))
1725             goto yes;
1726         break;
1727     case 'O':
1728         if (len == 8 && strEQ(name, "OVERLOAD"))
1729             goto yes;
1730         break;
1731     case 'S':
1732         if (len == 3 && strEQ(name, "SIG"))
1733             goto yes;
1734         break;
1735     case '\017':   /* $^O & $^OPEN */
1736         if (len == 1
1737             || (len == 4 && strEQ(name, "\027PEN")))
1738         {
1739             goto yes;
1740         }
1741         break;
1742     case '\027':   /* $^W & $^WARNING_BITS */
1743         if (len == 1
1744             || (len == 12 && strEQ(name, "\027ARNING_BITS"))
1745             || (len == 17 && strEQ(name, "\027IDE_SYSTEM_CALLS")))
1746         {
1747             goto yes;
1748         }
1749         break;
1750
1751     case '&':
1752     case '`':
1753     case '\'':
1754     case ':':
1755     case '?':
1756     case '!':
1757     case '-':
1758     case '#':
1759     case '*':
1760     case '[':
1761     case '^':
1762     case '~':
1763     case '=':
1764     case '%':
1765     case '.':
1766     case '(':
1767     case ')':
1768     case '<':
1769     case '>':
1770     case ',':
1771     case '\\':
1772     case '/':
1773     case '|':
1774     case '+':
1775     case ';':
1776     case ']':
1777     case '\001':   /* $^A */
1778     case '\003':   /* $^C */
1779     case '\004':   /* $^D */
1780     case '\005':   /* $^E */
1781     case '\006':   /* $^F */
1782     case '\010':   /* $^H */
1783     case '\011':   /* $^I, NOT \t in EBCDIC */
1784     case '\014':   /* $^L */
1785     case '\016':   /* $^N */
1786     case '\020':   /* $^P */
1787     case '\023':   /* $^S */
1788     case '\024':   /* $^T */
1789     case '\026':   /* $^V */
1790         if (len == 1)
1791             goto yes;
1792         break;
1793     case '1':
1794     case '2':
1795     case '3':
1796     case '4':
1797     case '5':
1798     case '6':
1799     case '7':
1800     case '8':
1801     case '9':
1802         if (len > 1) {
1803             char *end = name + len;
1804             while (--end > name) {
1805                 if (!isDIGIT(*end))
1806                     return FALSE;
1807             }
1808         }
1809     yes:
1810         return TRUE;
1811     default:
1812         break;
1813     }
1814     return FALSE;
1815 }