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