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