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