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