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