home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / perl-5.003-src.tgz / tar.out / fsf / perl / gv.c < prev    next >
C/C++ Source or Header  |  1996-09-28  |  27KB  |  1,198 lines
  1. /*    gv.c
  2.  *
  3.  *    Copyright (c) 1991-1994, 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. extern char rcsid[];
  23.  
  24. GV *
  25. gv_AVadd(gv)
  26. register GV *gv;
  27. {
  28.     if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
  29.     croak("Bad symbol for array");
  30.     if (!GvAV(gv))
  31.     GvAV(gv) = newAV();
  32.     return gv;
  33. }
  34.  
  35. GV *
  36. gv_HVadd(gv)
  37. register GV *gv;
  38. {
  39.     if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
  40.     croak("Bad symbol for hash");
  41.     if (!GvHV(gv))
  42.     GvHV(gv) = newHV();
  43.     return gv;
  44. }
  45.  
  46. GV *
  47. gv_IOadd(gv)
  48. register GV *gv;
  49. {
  50.     if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
  51.     croak("Bad symbol for filehandle");
  52.     if (!GvIOp(gv))
  53.     GvIOp(gv) = newIO();
  54.     return gv;
  55. }
  56.  
  57. GV *
  58. gv_fetchfile(name)
  59. char *name;
  60. {
  61.     char tmpbuf[1200];
  62.     GV *gv;
  63.  
  64.     sprintf(tmpbuf,"::_<%s", name);
  65.     gv = gv_fetchpv(tmpbuf, TRUE, SVt_PVGV);
  66.     sv_setpv(GvSV(gv), name);
  67.     if (*name == '/' && (instr(name,"/lib/") || instr(name,".pm")))
  68.     GvMULTI_on(gv);
  69.     if (perldb)
  70.     hv_magic(GvHVn(gv_AVadd(gv)), gv, 'L');
  71.     return gv;
  72. }
  73.  
  74. void
  75. gv_init(gv, stash, name, len, multi)
  76. GV *gv;
  77. HV *stash;
  78. char *name;
  79. STRLEN len;
  80. int multi;
  81. {
  82.     register GP *gp;
  83.  
  84.     sv_upgrade(gv, SVt_PVGV);
  85.     if (SvLEN(gv))
  86.     Safefree(SvPVX(gv));
  87.     Newz(602,gp, 1, GP);
  88.     GvGP(gv) = gp_ref(gp);
  89.     GvREFCNT(gv) = 1;
  90.     GvSV(gv) = NEWSV(72,0);
  91.     GvLINE(gv) = curcop->cop_line;
  92.     GvFILEGV(gv) = curcop->cop_filegv;
  93.     GvEGV(gv) = gv;
  94.     sv_magic((SV*)gv, (SV*)gv, '*', name, len);
  95.     GvSTASH(gv) = stash;
  96.     GvNAME(gv) = savepvn(name, len);
  97.     GvNAMELEN(gv) = len;
  98.     if (multi)
  99.     GvMULTI_on(gv);
  100. }
  101.  
  102. static void
  103. gv_init_sv(gv, sv_type)
  104. GV* gv;
  105. I32 sv_type;
  106. {
  107.     switch (sv_type) {
  108.     case SVt_PVIO:
  109.     (void)GvIOn(gv);
  110.     break;
  111.     case SVt_PVAV:
  112.     (void)GvAVn(gv);
  113.     break;
  114.     case SVt_PVHV:
  115.     (void)GvHVn(gv);
  116.     break;
  117.     }
  118. }
  119.  
  120. GV *
  121. gv_fetchmeth(stash, name, len, level)
  122. HV* stash;
  123. char* name;
  124. STRLEN len;
  125. I32 level;
  126. {
  127.     AV* av;
  128.     GV* topgv;
  129.     GV* gv;
  130.     GV** gvp;
  131.     HV* lastchance;
  132.     CV* cv;
  133.  
  134.     if (!stash)
  135.     return 0;
  136.     if (level > 100)
  137.     croak("Recursive inheritance detected");
  138.  
  139.     gvp = (GV**)hv_fetch(stash, name, len, TRUE);
  140.  
  141.     DEBUG_o( deb("Looking for method %s in package %s\n",name,HvNAME(stash)) );
  142.     topgv = *gvp;
  143.     if (SvTYPE(topgv) != SVt_PVGV)
  144.     gv_init(topgv, stash, name, len, TRUE);
  145.  
  146.     if (cv=GvCV(topgv)) {
  147.     if (GvCVGEN(topgv) >= sub_generation)
  148.         return topgv;    /* valid cached inheritance */
  149.     if (!GvCVGEN(topgv)) {    /* not an inheritance cache */
  150.         return topgv;
  151.     }
  152.     else {
  153.         /* stale cached entry, just junk it */
  154.         GvCV(topgv) = cv = 0;
  155.         GvCVGEN(topgv) = 0;
  156.     }
  157.     }
  158.     /* if cv is still set, we have to free it if we find something to cache */
  159.  
  160.     gvp = (GV**)hv_fetch(stash,"ISA",3,FALSE);
  161.     if (gvp && (gv = *gvp) != (GV*)&sv_undef && (av = GvAV(gv))) {
  162.     SV** svp = AvARRAY(av);
  163.     I32 items = AvFILL(av) + 1;
  164.     while (items--) {
  165.         SV* sv = *svp++;
  166.         HV* basestash = gv_stashsv(sv, FALSE);
  167.         if (!basestash) {
  168.         if (dowarn)
  169.             warn("Can't locate package %s for @%s::ISA",
  170.             SvPVX(sv), HvNAME(stash));
  171.         continue;
  172.         }
  173.         gv = gv_fetchmeth(basestash, name, len, level + 1);
  174.         if (gv) {
  175.         if (cv) {                /* junk old undef */
  176.             assert(SvREFCNT(topgv) > 1);
  177.             SvREFCNT_dec(topgv);
  178.             SvREFCNT_dec(cv);
  179.         }
  180.         GvCV(topgv) = GvCV(gv);            /* cache the CV */
  181.         GvCVGEN(topgv) = sub_generation;    /* valid for now */
  182.         return gv;
  183.         }
  184.     }
  185.     }
  186.  
  187.     if (!level) {
  188.     if (lastchance = gv_stashpv("UNIVERSAL", FALSE)) {
  189.         if (gv = gv_fetchmeth(lastchance, name, len, level + 1)) {
  190.         if (cv) {                /* junk old undef */
  191.             assert(SvREFCNT(topgv) > 1);
  192.             SvREFCNT_dec(topgv);
  193.             SvREFCNT_dec(cv);
  194.         }
  195.         GvCV(topgv) = GvCV(gv);            /* cache the CV */
  196.         GvCVGEN(topgv) = sub_generation;    /* valid for now */
  197.         return gv;
  198.         }
  199.     }
  200.     }
  201.  
  202.     return 0;
  203. }
  204.  
  205. GV *
  206. gv_fetchmethod(stash, name)
  207. HV* stash;
  208. char* name;
  209. {
  210.     register char *nend;
  211.     char *nsplit = 0;
  212.     GV* gv;
  213.     
  214.     for (nend = name; *nend; nend++) {
  215.     if (*nend == ':' || *nend == '\'')
  216.         nsplit = nend;
  217.     }
  218.     if (nsplit) {
  219.     char ch;
  220.     char *origname = name;
  221.     name = nsplit + 1;
  222.     ch = *nsplit;
  223.     if (*nsplit == ':')
  224.         --nsplit;
  225.     *nsplit = '\0';
  226.     if (strEQ(origname,"SUPER")) {
  227.         /* Degenerate case ->SUPER::method should really lookup in original stash */
  228.         SV *tmpstr = sv_2mortal(newSVpv(HvNAME(curcop->cop_stash),0));
  229.         sv_catpvn(tmpstr, "::SUPER", 7);
  230.         stash = gv_stashpv(SvPV(tmpstr,na),TRUE);
  231.         *nsplit = ch;
  232.         DEBUG_o( deb("Treating %s as %s::%s\n",origname,HvNAME(stash),name) );
  233.     } else {
  234.         stash = gv_stashpv(origname,TRUE);
  235.         *nsplit = ch;
  236.     }
  237.     }
  238.     gv = gv_fetchmeth(stash, name, nend - name, 0);
  239.  
  240.     if (!gv) {
  241.     /* Failed obvious case - look for SUPER as last element of stash's name */
  242.     char *packname = HvNAME(stash);
  243.     STRLEN len     = strlen(packname);
  244.     if (len >= 7 && strEQ(packname+len-7,"::SUPER")) {
  245.         /* Now look for @.*::SUPER::ISA */
  246.         GV** gvp = (GV**)hv_fetch(stash,"ISA",3,FALSE);
  247.         if (!gvp || (gv = *gvp) == (GV*)&sv_undef || !GvAV(gv)) {
  248.         /* No @ISA in package ending in ::SUPER - drop suffix
  249.            and see if there is an @ISA there
  250.          */
  251.         HV *basestash;
  252.         char ch = packname[len-7];
  253.         AV *av;
  254.         packname[len-7] = '\0';
  255.         basestash = gv_stashpv(packname, TRUE);
  256.         packname[len-7] = ch;
  257.         gvp = (GV**)hv_fetch(basestash,"ISA",3,FALSE);
  258.         if (gvp && (gv = *gvp) != (GV*)&sv_undef && (av = GvAV(gv))) {
  259.              /* Okay found @ISA after dropping the SUPER, alias it */
  260.                  SV *tmpstr = sv_2mortal(newSVpv(HvNAME(stash),0));
  261.                  sv_catpvn(tmpstr, "::ISA", 5);
  262.              gv  = gv_fetchpv(SvPV(tmpstr,na),TRUE,SVt_PVGV);
  263.                      if (gv) {
  264.             GvAV(gv) = (AV*)SvREFCNT_inc(av);
  265.             /* ... and re-try lookup */
  266.             gv = gv_fetchmeth(stash, name, nend - name, 0);
  267.              } else {
  268.             croak("Cannot create %s::ISA",HvNAME(stash));
  269.              }
  270.         }
  271.         }
  272.     }     
  273.     }
  274.  
  275.     if (!gv) {
  276.     CV* cv;
  277.  
  278.     if (strEQ(name,"import") || strEQ(name,"unimport"))
  279.         gv = &sv_yes;
  280.     else if (strNE(name, "AUTOLOAD")) {
  281.         gv = gv_fetchmeth(stash, "AUTOLOAD", 8, 0);
  282.         if (gv && (cv = GvCV(gv))) { /* One more chance... */
  283.         SV *tmpstr = sv_2mortal(newSVpv(HvNAME(stash),0));
  284.         sv_catpvn(tmpstr,"::", 2);
  285.         sv_catpvn(tmpstr, name, nend - name);
  286.         sv_setsv(GvSV(CvGV(cv)), tmpstr);
  287.         if (tainting)
  288.             sv_unmagic(GvSV(CvGV(cv)), 't');
  289.         }
  290.     }
  291.     }
  292.     return gv;
  293. }
  294.  
  295. HV*
  296. gv_stashpv(name,create)
  297. char *name;
  298. I32 create;
  299. {
  300.     char tmpbuf[1234];
  301.     HV *stash;
  302.     GV *tmpgv;
  303.     /* Use strncpy to avoid bug in VMS sprintf */
  304.     /* sprintf(tmpbuf,"%.*s::",1200,name); */
  305.     strncpy(tmpbuf, name, 1200);
  306.     tmpbuf[1200] = '\0';  /* just in case . . . */
  307.     strcat(tmpbuf, "::");
  308.     tmpgv = gv_fetchpv(tmpbuf,create, SVt_PVHV);
  309.     if (!tmpgv)
  310.     return 0;
  311.     if (!GvHV(tmpgv))
  312.     GvHV(tmpgv) = newHV();
  313.     stash = GvHV(tmpgv);
  314.     if (!HvNAME(stash))
  315.     HvNAME(stash) = savepv(name);
  316.     return stash;
  317. }
  318.  
  319. HV*
  320. gv_stashsv(sv,create)
  321. SV *sv;
  322. I32 create;
  323. {
  324.     return gv_stashpv(SvPV(sv,na), create);
  325. }
  326.  
  327.  
  328. GV *
  329. gv_fetchpv(nambeg,add,sv_type)
  330. char *nambeg;
  331. I32 add;
  332. I32 sv_type;
  333. {
  334.     register char *name = nambeg;
  335.     register GV *gv = 0;
  336.     GV**gvp;
  337.     I32 len;
  338.     register char *namend;
  339.     HV *stash = 0;
  340.     bool global = FALSE;
  341.     char *tmpbuf;
  342.  
  343.     if (*name == '*' && isALPHA(name[1])) /* accidental stringify on a GV? */
  344.     name++;
  345.  
  346.     for (namend = name; *namend; namend++) {
  347.     if ((*namend == '\'' && namend[1]) ||
  348.         (*namend == ':' && namend[1] == ':'))
  349.     {
  350.         if (!stash)
  351.         stash = defstash;
  352.         if (!SvREFCNT(stash))    /* symbol table under destruction */
  353.         return Nullgv;
  354.  
  355.         len = namend - name;
  356.         if (len > 0) {
  357.         New(601, tmpbuf, len+3, char);
  358.         Copy(name, tmpbuf, len, char);
  359.         tmpbuf[len++] = ':';
  360.         tmpbuf[len++] = ':';
  361.         tmpbuf[len] = '\0';
  362.         gvp = (GV**)hv_fetch(stash,tmpbuf,len,add);
  363.         Safefree(tmpbuf);
  364.         if (!gvp || *gvp == (GV*)&sv_undef)
  365.             return Nullgv;
  366.         gv = *gvp;
  367.  
  368.         if (SvTYPE(gv) == SVt_PVGV)
  369.             GvMULTI_on(gv);
  370.         else if (!add)
  371.             return Nullgv;
  372.         else
  373.             gv_init(gv, stash, nambeg, namend - nambeg, (add & 2));
  374.  
  375.         if (!(stash = GvHV(gv)))
  376.             stash = GvHV(gv) = newHV();
  377.  
  378.         if (!HvNAME(stash))
  379.             HvNAME(stash) = savepvn(nambeg, namend - nambeg);
  380.         }
  381.  
  382.         if (*namend == ':')
  383.         namend++;
  384.         namend++;
  385.         name = namend;
  386.         if (!*name)
  387.         return gv ? gv : *hv_fetch(defstash, "main::", 6, TRUE);
  388.     }
  389.     }
  390.     len = namend - name;
  391.     if (!len)
  392.     len = 1;
  393.  
  394.     /* No stash in name, so see how we can default */
  395.  
  396.     if (!stash) {
  397.     if (isIDFIRST(*name)) {
  398.         if (isUPPER(*name)) {
  399.         if (*name > 'I') {
  400.             if (*name == 'S' && (
  401.               strEQ(name, "SIG") ||
  402.               strEQ(name, "STDIN") ||
  403.               strEQ(name, "STDOUT") ||
  404.               strEQ(name, "STDERR") ))
  405.             global = TRUE;
  406.         }
  407.         else if (*name > 'E') {
  408.             if (*name == 'I' && strEQ(name, "INC"))
  409.             global = TRUE;
  410.         }
  411.         else if (*name > 'A') {
  412.             if (*name == 'E' && strEQ(name, "ENV"))
  413.             global = TRUE;
  414.         }
  415.         else if (*name == 'A' && (
  416.           strEQ(name, "ARGV") ||
  417.           strEQ(name, "ARGVOUT") ))
  418.             global = TRUE;
  419.         }
  420.         else if (*name == '_' && !name[1])
  421.         global = TRUE;
  422.         if (global)
  423.         stash = defstash;
  424.         else if ((COP*)curcop == &compiling) {
  425.         stash = curstash;
  426.         if (add && (hints & HINT_STRICT_VARS) &&
  427.             sv_type != SVt_PVCV &&
  428.             sv_type != SVt_PVGV &&
  429.             sv_type != SVt_PVFM &&
  430.             sv_type != SVt_PVIO &&
  431.             !(len == 1 && sv_type == SVt_PV && strchr("ab",*name)) )
  432.         {
  433.             gvp = (GV**)hv_fetch(stash,name,len,0);
  434.             if (!gvp ||
  435.             *gvp == (GV*)&sv_undef ||
  436.             SvTYPE(*gvp) != SVt_PVGV)
  437.             {
  438.             stash = 0;
  439.             }
  440.             else if (sv_type == SVt_PV   && !GvIMPORTED_SV(*gvp) ||
  441.                  sv_type == SVt_PVAV && !GvIMPORTED_AV(*gvp) ||
  442.                  sv_type == SVt_PVHV && !GvIMPORTED_HV(*gvp) )
  443.             {
  444.             warn("Variable \"%c%s\" is not imported",
  445.                 sv_type == SVt_PVAV ? '@' :
  446.                 sv_type == SVt_PVHV ? '%' : '$',
  447.                 name);
  448.             if (GvCV(*gvp))
  449.                 warn("(Did you mean &%s instead?)\n", name);
  450.             stash = 0;
  451.             }
  452.         }
  453.         }
  454.         else
  455.         stash = curcop->cop_stash;
  456.     }
  457.     else
  458.         stash = defstash;
  459.     }
  460.  
  461.     /* By this point we should have a stash and a name */
  462.  
  463.     if (!stash) {
  464.     if (add) {
  465.         warn("Global symbol \"%s\" requires explicit package name", name);
  466.         ++error_count;
  467.         stash = curstash ? curstash : defstash;    /* avoid core dumps */
  468.     }
  469.     else
  470.         return Nullgv;
  471.     }
  472.  
  473.     if (!SvREFCNT(stash))    /* symbol table under destruction */
  474.     return Nullgv;
  475.  
  476.     gvp = (GV**)hv_fetch(stash,name,len,add);
  477.     if (!gvp || *gvp == (GV*)&sv_undef)
  478.     return Nullgv;
  479.     gv = *gvp;
  480.     if (SvTYPE(gv) == SVt_PVGV) {
  481.     if (add) {
  482.         GvMULTI_on(gv);
  483.         gv_init_sv(gv, sv_type);
  484.     }
  485.     return gv;
  486.     }
  487.  
  488.     /* Adding a new symbol */
  489.  
  490.     if (add & 4)
  491.     warn("Had to create %s unexpectedly", nambeg);
  492.     gv_init(gv, stash, name, len, add & 2);
  493.     gv_init_sv(gv, sv_type);
  494.  
  495.     /* set up magic where warranted */
  496.     switch (*name) {
  497.     case 'A':
  498.     if (strEQ(name, "ARGV")) {
  499.         IoFLAGS(GvIOn(gv)) |= IOf_ARGV|IOf_START;
  500.     }
  501.     break;
  502.  
  503.     case 'a':
  504.     case 'b':
  505.     if (len == 1)
  506.         GvMULTI_on(gv);
  507.     break;
  508.     case 'E':
  509.     if (strnEQ(name, "EXPORT", 6))
  510.         GvMULTI_on(gv);
  511.     break;
  512.     case 'I':
  513.     if (strEQ(name, "ISA")) {
  514.         AV* av = GvAVn(gv);
  515.         GvMULTI_on(gv);
  516.         sv_magic((SV*)av, (SV*)gv, 'I', Nullch, 0);
  517.         if (add & 2 && strEQ(nambeg,"AnyDBM_File::ISA") && AvFILL(av) == -1)
  518.         {
  519.         char *pname;
  520.         av_push(av, newSVpv(pname = "NDBM_File",0));
  521.         gv_stashpv(pname, TRUE);
  522.         av_push(av, newSVpv(pname = "DB_File",0));
  523.         gv_stashpv(pname, TRUE);
  524.         av_push(av, newSVpv(pname = "GDBM_File",0));
  525.         gv_stashpv(pname, TRUE);
  526.         av_push(av, newSVpv(pname = "SDBM_File",0));
  527.         gv_stashpv(pname, TRUE);
  528.         av_push(av, newSVpv(pname = "ODBM_File",0));
  529.         gv_stashpv(pname, TRUE);
  530.         }
  531.     }
  532.     break;
  533. #ifdef OVERLOAD
  534.     case 'O':
  535.         if (strEQ(name, "OVERLOAD")) {
  536.             HV* hv = GvHVn(gv);
  537.             GvMULTI_on(gv);
  538.             sv_magic((SV*)hv, (SV*)gv, 'A', 0, 0);
  539.         }
  540.         break;
  541. #endif /* OVERLOAD */
  542.     case 'S':
  543.     if (strEQ(name, "SIG")) {
  544.         HV *hv;
  545.         siggv = gv;
  546.         GvMULTI_on(siggv);
  547.         hv = GvHVn(siggv);
  548.         hv_magic(hv, siggv, 'S');
  549.  
  550.         /* initialize signal stack */
  551.         signalstack = newAV();
  552.         AvREAL_off(signalstack);
  553.         av_extend(signalstack, 30);
  554.         av_fill(signalstack, 0);
  555.     }
  556.     break;
  557.  
  558.     case '&':
  559.     if (len > 1)
  560.         break;
  561.     ampergv = gv;
  562.     sawampersand = TRUE;
  563.     goto ro_magicalize;
  564.  
  565.     case '`':
  566.     if (len > 1)
  567.         break;
  568.     leftgv = gv;
  569.     sawampersand = TRUE;
  570.     goto ro_magicalize;
  571.  
  572.     case '\'':
  573.     if (len > 1)
  574.         break;
  575.     rightgv = gv;
  576.     sawampersand = TRUE;
  577.     goto ro_magicalize;
  578.  
  579.     case ':':
  580.     if (len > 1)
  581.         break;
  582.     sv_setpv(GvSV(gv),chopset);
  583.     goto magicalize;
  584.  
  585.     case '#':
  586.     case '*':
  587.     if (dowarn && len == 1 && sv_type == SVt_PV)
  588.         warn("Use of $%s is deprecated", name);
  589.     /* FALL THROUGH */
  590.     case '[':
  591.     case '!':
  592.     case '?':
  593.     case '^':
  594.     case '~':
  595.     case '=':
  596.     case '-':
  597.     case '%':
  598.     case '.':
  599.     case '(':
  600.     case ')':
  601.     case '<':
  602.     case '>':
  603.     case ',':
  604.     case '\\':
  605.     case '/':
  606.     case '|':
  607.     case '\001':
  608.     case '\004':
  609.     case '\005':
  610.     case '\006':
  611.     case '\010':
  612.     case '\017':
  613.     case '\t':
  614.     case '\020':
  615.     case '\024':
  616.     case '\027':
  617.     if (len > 1)
  618.         break;
  619.     goto magicalize;
  620.  
  621.     case '+':
  622.     case '1':
  623.     case '2':
  624.     case '3':
  625.     case '4':
  626.     case '5':
  627.     case '6':
  628.     case '7':
  629.     case '8':
  630.     case '9':
  631.       ro_magicalize:
  632.     SvREADONLY_on(GvSV(gv));
  633.       magicalize:
  634.     sv_magic(GvSV(gv), (SV*)gv, 0, name, len);
  635.     break;
  636.  
  637.     case '\014':
  638.     if (len > 1)
  639.         break;
  640.     sv_setpv(GvSV(gv),"\f");
  641.     formfeed = GvSV(gv);
  642.     break;
  643.     case ';':
  644.     if (len > 1)
  645.         break;
  646.     sv_setpv(GvSV(gv),"\034");
  647.     break;
  648.     case ']':
  649.     if (len == 1) {
  650.         SV *sv;
  651.         sv = GvSV(gv);
  652.         sv_upgrade(sv, SVt_PVNV);
  653.         sv_setpv(sv, patchlevel);
  654.     }
  655.     break;
  656.     }
  657.     return gv;
  658. }
  659.  
  660. void
  661. gv_fullname(sv,gv)
  662. SV *sv;
  663. GV *gv;
  664. {
  665.     HV *hv = GvSTASH(gv);
  666.  
  667.     if (!hv)
  668.     return;
  669.     sv_setpv(sv, sv == (SV*)gv ? "*" : "");
  670.     sv_catpv(sv,HvNAME(hv));
  671.     sv_catpvn(sv,"::", 2);
  672.     sv_catpvn(sv,GvNAME(gv),GvNAMELEN(gv));
  673. }
  674.  
  675. void
  676. gv_efullname(sv,gv)
  677. SV *sv;
  678. GV *gv;
  679. {
  680.     GV* egv = GvEGV(gv);
  681.     HV *hv;
  682.     
  683.     if (!egv)
  684.     egv = gv;
  685.     hv = GvSTASH(egv);
  686.     if (!hv)
  687.     return;
  688.  
  689.     sv_setpv(sv, sv == (SV*)gv ? "*" : "");
  690.     sv_catpv(sv,HvNAME(hv));
  691.     sv_catpvn(sv,"::", 2);
  692.     sv_catpvn(sv,GvNAME(egv),GvNAMELEN(egv));
  693. }
  694.  
  695. IO *
  696. newIO()
  697. {
  698.     IO *io;
  699.     GV *iogv;
  700.  
  701.     io = (IO*)NEWSV(0,0);
  702.     sv_upgrade((SV *)io,SVt_PVIO);
  703.     SvREFCNT(io) = 1;
  704.     SvOBJECT_on(io);
  705.     iogv = gv_fetchpv("FileHandle::", TRUE, SVt_PVHV);
  706.     SvSTASH(io) = (HV*)SvREFCNT_inc(GvHV(iogv));
  707.     return io;
  708. }
  709.  
  710. void
  711. gv_check(stash)
  712. HV* stash;
  713. {
  714.     register HE *entry;
  715.     register I32 i;
  716.     register GV *gv;
  717.     HV *hv;
  718.     GV *filegv;
  719.  
  720.     if (!HvARRAY(stash))
  721.     return;
  722.     for (i = 0; i <= (I32) HvMAX(stash); i++) {
  723.     for (entry = HvARRAY(stash)[i]; entry; entry = entry->hent_next) {
  724.         if (entry->hent_key[entry->hent_klen-1] == ':' &&
  725.         (gv = (GV*)entry->hent_val) && (hv = GvHV(gv)) && HvNAME(hv))
  726.         {
  727.         if (hv != defstash)
  728.              gv_check(hv);              /* nested package */
  729.         }
  730.         else if (isALPHA(*entry->hent_key)) {
  731.         gv = (GV*)entry->hent_val;
  732.         if (GvMULTI(gv))
  733.             continue;
  734.         curcop->cop_line = GvLINE(gv);
  735.         filegv = GvFILEGV(gv);
  736.         curcop->cop_filegv = filegv;
  737.         if (filegv && GvMULTI(filegv))    /* Filename began with slash */
  738.             continue;
  739.         warn("Identifier \"%s::%s\" used only once: possible typo",
  740.             HvNAME(stash), GvNAME(gv));
  741.         }
  742.     }
  743.     }
  744. }
  745.  
  746. GV *
  747. newGVgen(pack)
  748. char *pack;
  749. {
  750.     (void)sprintf(tokenbuf,"%s::_GEN_%ld",pack,(long)gensym++);
  751.     return gv_fetchpv(tokenbuf,TRUE, SVt_PVGV);
  752. }
  753.  
  754. /* hopefully this is only called on local symbol table entries */
  755.  
  756. GP*
  757. gp_ref(gp)
  758. GP* gp;
  759. {
  760.     gp->gp_refcnt++;
  761.     return gp;
  762.  
  763. }
  764.  
  765. void
  766. gp_free(gv)
  767. GV* gv;
  768. {
  769.     GP* gp;
  770.     CV* cv;
  771.  
  772.     if (!gv || !(gp = GvGP(gv)))
  773.     return;
  774.     if (gp->gp_refcnt == 0) {
  775.         warn("Attempt to free unreferenced glob pointers");
  776.         return;
  777.     }
  778.     if (--gp->gp_refcnt > 0) {
  779.     if (gp->gp_egv == gv)
  780.         gp->gp_egv = 0;
  781.         return;
  782.     }
  783.  
  784.     SvREFCNT_dec(gp->gp_sv);
  785.     SvREFCNT_dec(gp->gp_av);
  786.     SvREFCNT_dec(gp->gp_hv);
  787.     SvREFCNT_dec(gp->gp_io);
  788.     if ((cv = gp->gp_cv) && !GvCVGEN(gv))
  789.     SvREFCNT_dec(cv);
  790.     SvREFCNT_dec(gp->gp_form);
  791.  
  792.     Safefree(gp);
  793.     GvGP(gv) = 0;
  794. }
  795.  
  796. #if defined(CRIPPLED_CC) && (defined(iAPX286) || defined(M_I286) || defined(I80286))
  797. #define MICROPORT
  798. #endif
  799.  
  800. #ifdef    MICROPORT    /* Microport 2.4 hack */
  801. AV *GvAVn(gv)
  802. register GV *gv;
  803. {
  804.     if (GvGP(gv)->gp_av) 
  805.     return GvGP(gv)->gp_av;
  806.     else
  807.     return GvGP(gv_AVadd(gv))->gp_av;
  808. }
  809.  
  810. HV *GvHVn(gv)
  811. register GV *gv;
  812. {
  813.     if (GvGP(gv)->gp_hv)
  814.     return GvGP(gv)->gp_hv;
  815.     else
  816.     return GvGP(gv_HVadd(gv))->gp_hv;
  817. }
  818. #endif            /* Microport 2.4 hack */
  819.  
  820. #ifdef OVERLOAD
  821. /* Updates and caches the CV's */
  822.  
  823. bool
  824. Gv_AMupdate(stash)
  825. HV* stash;
  826. {
  827.   GV** gvp;
  828.   HV* hv;
  829.   GV* gv;
  830.   CV* cv;
  831.   MAGIC* mg=mg_find((SV*)stash,'c');
  832.   AMT *amtp=mg ? (AMT*)mg->mg_ptr: NULL;
  833.  
  834.   if (mg && (amtp=((AMT*)(mg->mg_ptr)))->was_ok_am == amagic_generation &&
  835.              amtp->was_ok_sub == sub_generation)
  836.       return HV_AMAGIC(stash)? TRUE: FALSE;
  837.   gvp=(GV**)hv_fetch(stash,"OVERLOAD",8,FALSE);
  838.   if (amtp && amtp->table) {
  839.     int i;
  840.     for (i=1;i<NofAMmeth*2;i++) {
  841.       if (amtp->table[i]) {
  842.     SvREFCNT_dec(amtp->table[i]);
  843.       }
  844.     }
  845.   }
  846.   sv_unmagic((SV*)stash, 'c');
  847.  
  848.   DEBUG_o( deb("Recalcing overload magic in package %s\n",HvNAME(stash)) );
  849.  
  850.   if (gvp && ((gv = *gvp) != (GV*)&sv_undef && (hv = GvHV(gv)))) {
  851.     int filled=0;
  852.     int i;
  853.     char *cp;
  854.     AMT amt;
  855.     SV* sv;
  856.     SV** svp;
  857.  
  858. /*  if (*(svp)==(SV*)amagic_generation && *(svp+1)==(SV*)sub_generation) {
  859.       DEBUG_o( deb("Overload magic in package %s up-to-date\n",HvNAME(stash))
  860. );
  861.       return HV_AMAGIC(stash)? TRUE: FALSE;
  862.     }*/
  863.  
  864.     amt.was_ok_am=amagic_generation;
  865.     amt.was_ok_sub=sub_generation;
  866.     amt.fallback=AMGfallNO;
  867.  
  868.     /* Work with "fallback" key, which we assume to be first in AMG_names */
  869.  
  870.     if ((cp=((char**)(*AMG_names))[0]) &&
  871.     (svp=(SV**)hv_fetch(hv,cp,strlen(cp),FALSE)) && (sv = *svp)) {
  872.       if (SvTRUE(sv)) amt.fallback=AMGfallYES;
  873.       else if (SvOK(sv)) amt.fallback=AMGfallNEVER;
  874.     }
  875.  
  876.     for (i=1;i<NofAMmeth*2;i++) {
  877.       cv=0;
  878.  
  879.       if ( (cp=((char**)(*AMG_names))[i]) ) {
  880.         svp=(SV**)hv_fetch(hv,cp,strlen(cp),FALSE);
  881.         if (svp && ((sv = *svp) != (GV*)&sv_undef)) {
  882.           switch (SvTYPE(sv)) {
  883.             default:
  884.               if (!SvROK(sv)) {
  885.                 if (!SvOK(sv)) break;
  886.         gv = gv_fetchmethod(stash, SvPV(sv, na));
  887.                 if (gv) cv = GvCV(gv);
  888.                 break;
  889.               }
  890.               cv = (CV*)SvRV(sv);
  891.               if (SvTYPE(cv) == SVt_PVCV)
  892.                   break;
  893.                 /* FALL THROUGH */
  894.             case SVt_PVHV:
  895.             case SVt_PVAV:
  896.           die("Not a subroutine reference in %%OVERLOAD");
  897.           return FALSE;
  898.             case SVt_PVCV:
  899.                 cv = (CV*)sv;
  900.                 break;
  901.             case SVt_PVGV:
  902.                 if (!(cv = GvCV((GV*)sv)))
  903.                     cv = sv_2cv(sv, &stash, &gv, TRUE);
  904.                 break;
  905.           }
  906.           if (cv) filled=1;
  907.       else {
  908.         die("Method for operation %s not found in package %.256s during blessing\n",
  909.         cp,HvNAME(stash));
  910.         return FALSE;
  911.       }
  912.         }
  913.       }
  914.       amt.table[i]=(CV*)SvREFCNT_inc(cv);
  915.     }
  916.     sv_magic((SV*)stash, 0, 'c', (char*)&amt, sizeof(amt));
  917.     if (filled) {
  918. /*    HV_badAMAGIC_off(stash);*/
  919.       HV_AMAGIC_on(stash);
  920.       return TRUE;
  921.     }
  922.   }
  923. /*HV_badAMAGIC_off(stash);*/
  924.   HV_AMAGIC_off(stash);
  925.   return FALSE;
  926. }
  927.  
  928. /* During call to this subroutine stack can be reallocated. It is
  929.  * advised to call SPAGAIN macro in your code after call */
  930.  
  931. SV*
  932. amagic_call(left,right,method,flags)
  933. SV* left;
  934. SV* right;
  935. int method;
  936. int flags; 
  937. {
  938.   MAGIC *mg; 
  939.   CV *cv; 
  940.   CV **cvp=NULL, **ocvp=NULL;
  941.   AMT *amtp, *oamtp;
  942.   int fl=0, off, off1, lr=0, assign=AMGf_assign & flags, notfound=0;
  943.   int postpr=0, inc_dec_ass=0, assignshift=assign?1:0;
  944.   HV* stash;
  945.   if (!(AMGf_noleft & flags) && SvAMAGIC(left)
  946.       && (mg = mg_find((SV*)(stash=SvSTASH(SvRV(left))),'c'))
  947.       && (ocvp = cvp = ((oamtp=amtp=(AMT*)mg->mg_ptr)->table))
  948.       && ((cv = cvp[off=method+assignshift]) 
  949.       || (assign && amtp->fallback > AMGfallNEVER && /* fallback to
  950.                                   * usual method */
  951.           (fl = 1, cv = cvp[off=method])))) {
  952.     lr = -1;            /* Call method for left argument */
  953.   } else {
  954.     if (cvp && amtp->fallback > AMGfallNEVER && flags & AMGf_unary) {
  955.       int logic;
  956.  
  957.       /* look for substituted methods */
  958.      switch (method) {
  959.      case inc_amg:
  960.        if (((cv = cvp[off=add_ass_amg]) && (inc_dec_ass=1))
  961.            || ((cv = cvp[off=add_amg]) && (postpr=1))) {
  962.          right = &sv_yes; lr = -1; assign = 1;
  963.        }
  964.        break;
  965.      case dec_amg:
  966.        if (((cv = cvp[off=subtr_ass_amg])  && (inc_dec_ass=1))
  967.            || ((cv = cvp[off=subtr_amg]) && (postpr=1))) {
  968.          right = &sv_yes; lr = -1; assign = 1;
  969.        }
  970.        break;
  971.      case bool__amg:
  972.        (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=string_amg]));
  973.        break;
  974.      case numer_amg:
  975.        (void)((cv = cvp[off=string_amg]) || (cv = cvp[off=bool__amg]));
  976.        break;
  977.      case string_amg:
  978.        (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=bool__amg]));
  979.        break;
  980.      case copy_amg:
  981.        {
  982.          SV* ref=SvRV(left);
  983.          if (!SvROK(ref) && SvTYPE(ref) <= SVt_PVMG) { /* Just to be
  984.                               * extra
  985.                               * causious,
  986.                               * maybe in some
  987.                               * additional
  988.                               * cases sv_setsv
  989.                               * is safe too */
  990.         SV* newref = newSVsv(ref);
  991.         SvOBJECT_on(newref);
  992.         SvSTASH(newref) = (HV*)SvREFCNT_inc(SvSTASH(ref));
  993.         return newref;
  994.          }
  995.        }
  996.        break;
  997.      case abs_amg:
  998.        if ((cvp[off1=lt_amg] || cvp[off1=ncmp_amg]) 
  999.            && ((cv = cvp[off=neg_amg]) || (cv = cvp[off=subtr_amg]))) {
  1000.          SV* nullsv=sv_2mortal(newSViv(0));
  1001.          if (off1==lt_amg) {
  1002.            SV* lessp = amagic_call(left,nullsv,
  1003.                        lt_amg,AMGf_noright);
  1004.            logic = SvTRUE(lessp);
  1005.          } else {
  1006.            SV* lessp = amagic_call(left,nullsv,
  1007.                        ncmp_amg,AMGf_noright);
  1008.            logic = (SvNV(lessp) < 0);
  1009.          }
  1010.          if (logic) {
  1011.            if (off==subtr_amg) {
  1012.          right = left;
  1013.          left = nullsv;
  1014.          lr = 1;
  1015.            }
  1016.          } else {
  1017.            return left;
  1018.          }
  1019.        }
  1020.        break;
  1021.      case neg_amg:
  1022.        if (cv = cvp[off=subtr_amg]) {
  1023.          right = left;
  1024.          left = sv_2mortal(newSViv(0));
  1025.          lr = 1;
  1026.        }
  1027.        break;
  1028.      default:
  1029.        goto not_found;
  1030.      }
  1031.      if (!cv) goto not_found;
  1032.     } else if (!(AMGf_noright & flags) && SvAMAGIC(right)
  1033.            && (mg = mg_find((SV*)(stash=SvSTASH(SvRV(right))),'c'))
  1034.            && (cvp = ((amtp=(AMT*)mg->mg_ptr)->table))
  1035.            && (cv = cvp[off=method])) { /* Method for right
  1036.                          * argument found */
  1037.       lr=1;
  1038.     } else if (((ocvp && oamtp->fallback > AMGfallNEVER 
  1039.          && (cvp=ocvp) && (lr = -1)) 
  1040.         || (cvp && amtp->fallback > AMGfallNEVER && (lr=1)))
  1041.            && !(flags & AMGf_unary)) {
  1042.                 /* We look for substitution for
  1043.                  * comparison operations and
  1044.                  * concatendation */
  1045.       if (method==concat_amg || method==concat_ass_amg
  1046.       || method==repeat_amg || method==repeat_ass_amg) {
  1047.     return NULL;        /* Delegate operation to string conversion */
  1048.       }
  1049.       off = -1;
  1050.       switch (method) {
  1051.      case lt_amg:
  1052.      case le_amg:
  1053.      case gt_amg:
  1054.      case ge_amg:
  1055.      case eq_amg:
  1056.      case ne_amg:
  1057.        postpr = 1; off=ncmp_amg; break;
  1058.      case slt_amg:
  1059.      case sle_amg:
  1060.      case sgt_amg:
  1061.      case sge_amg:
  1062.      case seq_amg:
  1063.      case sne_amg:
  1064.        postpr = 1; off=scmp_amg; break;
  1065.      }
  1066.       if (off != -1) cv = cvp[off];
  1067.       if (!cv) {
  1068.     goto not_found;
  1069.       }
  1070.     } else {
  1071.     not_found:            /* No method found, either report or die */
  1072.       if (ocvp && (cv=ocvp[nomethod_amg])) { /* Call report method */
  1073.     notfound = 1; lr = -1;
  1074.       } else if (cvp && (cv=cvp[nomethod_amg])) {
  1075.     notfound = 1; lr = 1;
  1076.       } else {
  1077.         if (off==-1) off=method;
  1078.     sprintf(buf, "Operation `%s': no method found,\n\tleft argument %s%.256s,\n\tright argument %s%.256s",
  1079.               ((char**)AMG_names)[method + assignshift],
  1080.               SvAMAGIC(left)? 
  1081.                 "in overloaded package ":
  1082.                 "has no overloaded magic",
  1083.               SvAMAGIC(left)? 
  1084.                 HvNAME(SvSTASH(SvRV(left))):
  1085.                 "",
  1086.               SvAMAGIC(right)? 
  1087.                 "in overloaded package ":
  1088.                 "has no overloaded magic",
  1089.               SvAMAGIC(right)? 
  1090.                 HvNAME(SvSTASH(SvRV(right))):
  1091.                 "");
  1092.     if (amtp && amtp->fallback >= AMGfallYES) {
  1093.       DEBUG_o( deb(buf) );
  1094.     } else {
  1095.       die(buf);
  1096.     }
  1097.     return NULL;
  1098.       }
  1099.     }
  1100.   }
  1101.   if (!notfound) {
  1102.     DEBUG_o( deb("Overloaded operator `%s'%s%s%s:\n\tmethod%s found%s in package %.256s%s\n",
  1103.          ((char**)AMG_names)[off],
  1104.          method+assignshift==off? "" :
  1105.                      " (initially `",
  1106.          method+assignshift==off? "" :
  1107.                      ((char**)AMG_names)[method+assignshift],
  1108.          method+assignshift==off? "" : "')",
  1109.          flags & AMGf_unary? "" :
  1110.            lr==1 ? " for right argument": " for left argument",
  1111.          flags & AMGf_unary? " for argument" : "",
  1112.          HvNAME(stash), 
  1113.          fl? ",\n\tassignment variant used": "") );
  1114.     /* Since we use shallow copy during assignment, we need
  1115.      * to dublicate the contents, probably calling user-supplied
  1116.      * version of copy operator
  1117.      */
  1118.     if ((method + assignshift==off 
  1119.      && (assign || method==inc_amg || method==dec_amg))
  1120.     || inc_dec_ass) RvDEEPCP(left);
  1121.   }
  1122.   {
  1123.     dSP;
  1124.     BINOP myop;
  1125.     SV* res;
  1126.  
  1127.     Zero(&myop, 1, BINOP);
  1128.     myop.op_last = (OP *) &myop;
  1129.     myop.op_next = Nullop;
  1130.     myop.op_flags = OPf_KNOW|OPf_STACKED;
  1131.  
  1132.     ENTER;
  1133.     SAVESPTR(op);
  1134.     op = (OP *) &myop;
  1135.     PUTBACK;
  1136.     pp_pushmark();
  1137.  
  1138.     EXTEND(sp, notfound + 5);
  1139.     PUSHs(lr>0? right: left);
  1140.     PUSHs(lr>0? left: right);
  1141.     PUSHs( assign ? &sv_undef : (lr>0? &sv_yes: &sv_no));
  1142.     if (notfound) {
  1143.       PUSHs( sv_2mortal(newSVpv(((char**)AMG_names)[method + assignshift],0)) );
  1144.     }
  1145.     PUSHs((SV*)cv);
  1146.     PUTBACK;
  1147.  
  1148.     if (op = pp_entersub())
  1149.       runops();
  1150.     LEAVE;
  1151.     SPAGAIN;
  1152.  
  1153.     res=POPs;
  1154.     PUTBACK;
  1155.  
  1156.     if (notfound) {
  1157.       /* sv_2mortal(res); */
  1158.       return NULL;
  1159.     }
  1160.  
  1161.     if (postpr) {
  1162.       int ans;
  1163.       switch (method) {
  1164.       case le_amg:
  1165.       case sle_amg:
  1166.     ans=SvIV(res)<=0; break;
  1167.       case lt_amg:
  1168.       case slt_amg:
  1169.     ans=SvIV(res)<0; break;
  1170.       case ge_amg:
  1171.       case sge_amg:
  1172.     ans=SvIV(res)>=0; break;
  1173.       case gt_amg:
  1174.       case sgt_amg:
  1175.     ans=SvIV(res)>0; break;
  1176.       case eq_amg:
  1177.       case seq_amg:
  1178.     ans=SvIV(res)==0; break;
  1179.       case ne_amg:
  1180.       case sne_amg:
  1181.     ans=SvIV(res)!=0; break;
  1182.       case inc_amg:
  1183.       case dec_amg:
  1184.     SvSetSV(left,res); return res; break;
  1185.       }
  1186.       return ans? &sv_yes: &sv_no;
  1187.     } else if (method==copy_amg) {
  1188.       if (!SvROK(res)) {
  1189.     die("Copy method did not return a reference");
  1190.       }
  1191.       return SvREFCNT_inc(SvRV(res));
  1192.     } else {
  1193.       return res;
  1194.     }
  1195.   }
  1196. }
  1197. #endif /* OVERLOAD */
  1198.