3 * Copyright (c) 1991-1997, Larry Wall
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.
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,'
25 gv_AVadd(register GV *gv)
27 if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
28 croak("Bad symbol for array");
35 gv_HVadd(register GV *gv)
37 if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
38 croak("Bad symbol for hash");
45 gv_IOadd(register GV *gv)
47 if (!gv || SvTYPE((SV*)gv) != SVt_PVGV)
48 croak("Bad symbol for filehandle");
55 gv_fetchfile(char *name)
63 tmplen = strlen(name) + 2;
64 if (tmplen < sizeof smallbuf)
67 New(603, tmpbuf, tmplen + 1, char);
70 strcpy(tmpbuf + 2, name);
71 gv = *(GV**)hv_fetch(defstash, tmpbuf, tmplen, TRUE);
73 gv_init(gv, defstash, tmpbuf, tmplen, FALSE);
74 if (tmpbuf != smallbuf)
76 sv_setpv(GvSV(gv), name);
77 if (*name == '/' && (instr(name, "/lib/") || instr(name, ".pm")))
80 hv_magic(GvHVn(gv_AVadd(gv)), gv, 'L');
85 gv_init(GV *gv, HV *stash, char *name, STRLEN len, int multi)
89 bool doproto = SvTYPE(gv) > SVt_NULL;
90 char *proto = (doproto && SvPOK(gv)) ? SvPVX(gv) : NULL;
92 sv_upgrade((SV*)gv, SVt_PVGV);
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;
107 sv_magic((SV*)gv, (SV*)gv, '*', name, len);
108 GvSTASH(gv) = (HV*)SvREFCNT_inc(stash);
109 GvNAME(gv) = savepvn(name, len);
113 if (doproto) { /* Replicate part of newSUB here. */
115 start_subparse(0,0); /* Create CV in compcv. */
121 CvGV(GvCV(gv)) = (GV*)SvREFCNT_inc(gv);
122 CvFILEGV(GvCV(gv)) = curcop->cop_filegv;
123 CvSTASH(GvCV(gv)) = curstash;
125 CvOWNER(GvCV(gv)) = 0;
126 New(666, CvMUTEXP(GvCV(gv)), 1, perl_mutex);
127 MUTEX_INIT(CvMUTEXP(GvCV(gv)));
128 #endif /* USE_THREADS */
130 sv_setpv((SV*)GvCV(gv), proto);
137 gv_init_sv(GV *gv, I32 sv_type)
153 gv_fetchmeth(HV *stash, char *name, STRLEN len, I32 level)
163 if ((level > 100) || (level < -100))
164 croak("Recursive inheritance detected");
166 DEBUG_o( deb("Looking for method %s in package %s\n",name,HvNAME(stash)) );
168 gvp = (GV**)hv_fetch(stash, name, len, (level >= 0));
173 if (SvTYPE(topgv) != SVt_PVGV)
174 gv_init(topgv, stash, name, len, TRUE);
175 if (cv = GvCV(topgv)) {
176 /* If genuine method or valid cache entry, use it */
177 if (!GvCVGEN(topgv) || GvCVGEN(topgv) >= sub_generation)
179 /* Stale cached entry: junk it */
181 GvCV(topgv) = cv = Nullcv;
186 gvp = (GV**)hv_fetch(stash, "ISA", 3, FALSE);
187 av = (gvp && (gv = *gvp) && gv != (GV*)&sv_undef) ? GvAV(gv) : Nullav;
189 /* create and re-create @.*::SUPER::ISA on demand */
190 if (!av || !SvMAGIC(av)) {
191 char* packname = HvNAME(stash);
192 STRLEN packlen = strlen(packname);
194 if (packlen >= 7 && strEQ(packname + packlen - 7, "::SUPER")) {
198 basestash = gv_stashpvn(packname, packlen, TRUE);
199 gvp = (GV**)hv_fetch(basestash, "ISA", 3, FALSE);
200 if (gvp && (gv = *gvp) != (GV*)&sv_undef && (av = GvAV(gv))) {
201 dTHR; /* just for SvREFCNT_dec */
202 gvp = (GV**)hv_fetch(stash, "ISA", 3, TRUE);
203 if (!gvp || !(gv = *gvp))
204 croak("Cannot create %s::ISA", HvNAME(stash));
205 if (SvTYPE(gv) != SVt_PVGV)
206 gv_init(gv, stash, "ISA", 3, TRUE);
207 SvREFCNT_dec(GvAV(gv));
208 GvAV(gv) = (AV*)SvREFCNT_inc(av);
214 SV** svp = AvARRAY(av);
215 /* NOTE: No support for tied ISA */
216 I32 items = AvFILLp(av) + 1;
219 HV* basestash = gv_stashsv(sv, FALSE);
222 warn("Can't locate package %s for @%s::ISA",
223 SvPVX(sv), HvNAME(stash));
226 gv = gv_fetchmeth(basestash, name, len,
227 (level >= 0) ? level + 1 : level - 1);
233 /* if at top level, try UNIVERSAL */
235 if (level == 0 || level == -1) {
238 if (lastchance = gv_stashpvn("UNIVERSAL", 9, FALSE)) {
239 if (gv = gv_fetchmeth(lastchance, name, len,
240 (level >= 0) ? level + 1 : level - 1)) {
243 * Cache method in topgv if:
244 * 1. topgv has no synonyms (else inheritance crosses wires)
245 * 2. method isn't a stub (else AUTOLOAD fails spectacularly)
248 GvREFCNT(topgv) == 1 &&
250 (CvROOT(cv) || CvXSUB(cv)))
252 if (cv = GvCV(topgv))
254 GvCV(topgv) = (CV*)SvREFCNT_inc(GvCV(gv));
255 GvCVGEN(topgv) = sub_generation;
266 gv_fetchmethod(HV *stash, char *name)
268 return gv_fetchmethod_autoload(stash, name, TRUE);
272 gv_fetchmethod_autoload(HV *stash, char *name, I32 autoload)
279 for (nend = name; *nend; nend++) {
282 else if (*nend == ':' && *(nend + 1) == ':')
286 char *origname = name;
290 if ((nsplit - origname) == 5 && strnEQ(origname, "SUPER", 5)) {
291 /* ->SUPER::method should really be looked up in original stash */
292 SV *tmpstr = sv_2mortal(newSVpvf("%s::SUPER",
293 HvNAME(curcop->cop_stash)));
294 stash = gv_stashpvn(SvPVX(tmpstr), SvCUR(tmpstr), TRUE);
295 DEBUG_o( deb("Treating %s as %s::%s\n",
296 origname, HvNAME(stash), name) );
299 stash = gv_stashpvn(origname, nsplit - origname, TRUE);
302 gv = gv_fetchmeth(stash, name, nend - name, 0);
304 if (strEQ(name,"import"))
307 gv = gv_autoload4(stash, name, nend - name, TRUE);
311 if (!CvROOT(cv) && !CvXSUB(cv)) {
319 if (GvCV(stubgv) != cv) /* orphaned import */
322 autogv = gv_autoload4(GvSTASH(stubgv),
323 GvNAME(stubgv), GvNAMELEN(stubgv), TRUE);
333 gv_autoload4(HV *stash, char *name, STRLEN len, I32 method)
335 static char autoload[] = "AUTOLOAD";
336 static STRLEN autolen = 8;
343 if (len == autolen && strnEQ(name, autoload, autolen))
345 if (!(gv = gv_fetchmeth(stash, autoload, autolen, FALSE)))
350 * Inheriting AUTOLOAD for non-methods works ... for now.
352 if (dowarn && !method && (GvCVGEN(gv) || GvSTASH(gv) != stash))
354 "Use of inherited AUTOLOAD for non-method %s::%.*s() is deprecated",
355 HvNAME(stash), (int)len, name);
358 * Given &FOO::AUTOLOAD, set $FOO::AUTOLOAD to desired function name.
359 * The subroutine's original name may not be "AUTOLOAD", so we don't
360 * use that, but for lack of anything better we will use the sub's
361 * original package to look up $AUTOLOAD.
363 varstash = GvSTASH(CvGV(cv));
364 vargv = *(GV**)hv_fetch(varstash, autoload, autolen, TRUE);
366 gv_init(vargv, varstash, autoload, autolen, FALSE);
368 sv_setpv(varsv, HvNAME(stash));
369 sv_catpvn(varsv, "::", 2);
370 sv_catpvn(varsv, name, len);
371 SvTAINTED_off(varsv);
376 gv_stashpv(char *name, I32 create)
378 return gv_stashpvn(name, strlen(name), create);
382 gv_stashpvn(char *name, U32 namelen, I32 create)
389 if (namelen + 3 < sizeof smallbuf)
392 New(606, tmpbuf, namelen + 3, char);
393 Copy(name,tmpbuf,namelen,char);
394 tmpbuf[namelen++] = ':';
395 tmpbuf[namelen++] = ':';
396 tmpbuf[namelen] = '\0';
397 tmpgv = gv_fetchpv(tmpbuf, create, SVt_PVHV);
398 if (tmpbuf != smallbuf)
403 GvHV(tmpgv) = newHV();
406 HvNAME(stash) = savepv(name);
411 gv_stashsv(SV *sv, I32 create)
416 return gv_stashpvn(ptr, len, create);
421 gv_fetchpv(char *nambeg, I32 add, I32 sv_type)
424 register char *name = nambeg;
428 register char *namend;
432 if (*name == '*' && isALPHA(name[1])) /* accidental stringify on a GV? */
435 for (namend = name; *namend; namend++) {
436 if ((*namend == '\'' && namend[1]) ||
437 (*namend == ':' && namend[1] == ':'))
441 if (!stash || !SvREFCNT(stash)) /* symbol table under destruction */
449 if (len + 3 < sizeof smallbuf)
452 New(601, tmpbuf, len+3, char);
453 Copy(name, tmpbuf, len, char);
457 gvp = (GV**)hv_fetch(stash,tmpbuf,len,add);
458 gv = gvp ? *gvp : Nullgv;
459 if (gv && gv != (GV*)&sv_undef) {
460 if (SvTYPE(gv) != SVt_PVGV)
461 gv_init(gv, stash, tmpbuf, len, (add & 2));
465 if (tmpbuf != smallbuf)
467 if (!gv || gv == (GV*)&sv_undef)
470 if (!(stash = GvHV(gv)))
471 stash = GvHV(gv) = newHV();
474 HvNAME(stash) = savepvn(nambeg, namend - nambeg);
482 return gv ? gv : (GV*)*hv_fetch(defstash, "main::", 6, TRUE);
489 /* No stash in name, so see how we can default */
492 if (isIDFIRST(*name)) {
495 if (isUPPER(*name)) {
497 if (*name == 'S' && (
498 strEQ(name, "SIG") ||
499 strEQ(name, "STDIN") ||
500 strEQ(name, "STDOUT") ||
501 strEQ(name, "STDERR") ))
504 else if (*name > 'E') {
505 if (*name == 'I' && strEQ(name, "INC"))
508 else if (*name > 'A') {
509 if (*name == 'E' && strEQ(name, "ENV"))
512 else if (*name == 'A' && (
513 strEQ(name, "ARGV") ||
514 strEQ(name, "ARGVOUT") ))
517 else if (*name == '_' && !name[1])
522 else if ((COP*)curcop == &compiling) {
524 if (add && (hints & HINT_STRICT_VARS) &&
525 sv_type != SVt_PVCV &&
526 sv_type != SVt_PVGV &&
527 sv_type != SVt_PVFM &&
528 sv_type != SVt_PVIO &&
529 !(len == 1 && sv_type == SVt_PV && strchr("ab",*name)) )
531 gvp = (GV**)hv_fetch(stash,name,len,0);
533 *gvp == (GV*)&sv_undef ||
534 SvTYPE(*gvp) != SVt_PVGV)
538 else if (sv_type == SVt_PV && !GvIMPORTED_SV(*gvp) ||
539 sv_type == SVt_PVAV && !GvIMPORTED_AV(*gvp) ||
540 sv_type == SVt_PVHV && !GvIMPORTED_HV(*gvp) )
542 warn("Variable \"%c%s\" is not imported",
543 sv_type == SVt_PVAV ? '@' :
544 sv_type == SVt_PVHV ? '%' : '$',
547 warn("(Did you mean &%s instead?)\n", name);
553 stash = curcop->cop_stash;
559 /* By this point we should have a stash and a name */
565 char sv_type_char = ((sv_type == SVt_PV) ? '$'
566 : (sv_type == SVt_PVAV) ? '@'
567 : (sv_type == SVt_PVHV) ? '%'
570 warn("Global symbol \"%c%s\" requires explicit package name",
573 warn("Global symbol \"%s\" requires explicit package name",
577 stash = curstash ? curstash : defstash; /* avoid core dumps */
578 add_gvflags = ((sv_type == SVt_PV) ? GVf_IMPORTED_SV
579 : (sv_type == SVt_PVAV) ? GVf_IMPORTED_AV
580 : (sv_type == SVt_PVHV) ? GVf_IMPORTED_HV
584 if (!SvREFCNT(stash)) /* symbol table under destruction */
587 gvp = (GV**)hv_fetch(stash,name,len,add);
588 if (!gvp || *gvp == (GV*)&sv_undef)
591 if (SvTYPE(gv) == SVt_PVGV) {
594 gv_init_sv(gv, sv_type);
597 } else if (add & GV_NOINIT) {
601 /* Adding a new symbol */
603 if (add & GV_ADDWARN)
604 warn("Had to create %s unexpectedly", nambeg);
605 gv_init(gv, stash, name, len, add & GV_ADDMULTI);
606 gv_init_sv(gv, sv_type);
607 GvFLAGS(gv) |= add_gvflags;
609 /* set up magic where warranted */
612 if (strEQ(name, "ARGV")) {
613 IoFLAGS(GvIOn(gv)) |= IOf_ARGV|IOf_START;
623 if (strnEQ(name, "EXPORT", 6))
627 if (strEQ(name, "ISA")) {
630 sv_magic((SV*)av, (SV*)gv, 'I', Nullch, 0);
631 /* NOTE: No support for tied ISA */
632 if ((add & GV_ADDMULTI) && strEQ(nambeg,"AnyDBM_File::ISA")
633 && AvFILLp(av) == -1)
636 av_push(av, newSVpv(pname = "NDBM_File",0));
637 gv_stashpvn(pname, 9, TRUE);
638 av_push(av, newSVpv(pname = "DB_File",0));
639 gv_stashpvn(pname, 7, TRUE);
640 av_push(av, newSVpv(pname = "GDBM_File",0));
641 gv_stashpvn(pname, 9, TRUE);
642 av_push(av, newSVpv(pname = "SDBM_File",0));
643 gv_stashpvn(pname, 9, TRUE);
644 av_push(av, newSVpv(pname = "ODBM_File",0));
645 gv_stashpvn(pname, 9, TRUE);
651 if (strEQ(name, "OVERLOAD")) {
654 hv_magic(hv, gv, 'A');
657 #endif /* OVERLOAD */
659 if (strEQ(name, "SIG")) {
665 hv_magic(hv, siggv, 'S');
666 for(i=1;sig_name[i];i++) {
668 init=hv_fetch(hv,sig_name[i],strlen(sig_name[i]),1);
670 sv_setsv(*init,&sv_undef);
701 sv_setpv(GvSV(gv),chopset);
707 #ifdef COMPLEX_STATUS
708 sv_upgrade(GvSV(gv), SVt_PVLV);
715 if(sv_type > SVt_PV) {
716 HV* stash = gv_stashpvn("Errno",5,FALSE);
717 if(!stash || !(gv_fetchmethod(stash, "TIEHASH"))) {
720 perl_require_pv("Errno.pm");
722 stash = gv_stashpvn("Errno",5,FALSE);
723 if (!stash || !(gv_fetchmethod(stash, "TIEHASH")))
724 croak("Can't use %%! because Errno.pm is not avaliable");
730 if (dowarn && len == 1 && sv_type == SVt_PV)
731 warn("Use of $%s is deprecated", name);
774 SvREADONLY_on(GvSV(gv));
776 sv_magic(GvSV(gv), (SV*)gv, 0, name, len);
782 sv_setpv(GvSV(gv),"\f");
788 sv_setpv(GvSV(gv),"\034");
793 sv_upgrade(sv, SVt_PVNV);
794 sv_setpv(sv, patchlevel);
804 gv_fullname3(SV *sv, GV *gv, char *prefix)
806 HV *hv = GvSTASH(gv);
811 sv_setpv(sv, prefix ? prefix : "");
812 sv_catpv(sv,HvNAME(hv));
813 sv_catpvn(sv,"::", 2);
814 sv_catpvn(sv,GvNAME(gv),GvNAMELEN(gv));
818 gv_efullname3(SV *sv, GV *gv, char *prefix)
823 gv_fullname3(sv, egv, prefix);
826 /* XXX compatibility with versions <= 5.003. */
828 gv_fullname(SV *sv, GV *gv)
830 gv_fullname3(sv, gv, sv == (SV*)gv ? "*" : "");
833 /* XXX compatibility with versions <= 5.003. */
835 gv_efullname(SV *sv, GV *gv)
837 gv_efullname3(sv, gv, sv == (SV*)gv ? "*" : "");
847 io = (IO*)NEWSV(0,0);
848 sv_upgrade((SV *)io,SVt_PVIO);
851 iogv = gv_fetchpv("FileHandle::", FALSE, SVt_PVHV);
853 iogv = gv_fetchpv("IO::Handle::", TRUE, SVt_PVHV);
854 SvSTASH(io) = (HV*)SvREFCNT_inc(GvHV(iogv));
870 for (i = 0; i <= (I32) HvMAX(stash); i++) {
871 for (entry = HvARRAY(stash)[i]; entry; entry = HeNEXT(entry)) {
872 if (HeKEY(entry)[HeKLEN(entry)-1] == ':' &&
873 (gv = (GV*)HeVAL(entry)) && (hv = GvHV(gv)) && HvNAME(hv))
876 gv_check(hv); /* nested package */
878 else if (isALPHA(*HeKEY(entry))) {
879 gv = (GV*)HeVAL(entry);
880 if (SvTYPE(gv) != SVt_PVGV || GvMULTI(gv))
882 curcop->cop_line = GvLINE(gv);
883 filegv = GvFILEGV(gv);
884 curcop->cop_filegv = filegv;
885 if (filegv && GvMULTI(filegv)) /* Filename began with slash */
887 warn("Name \"%s::%s\" used only once: possible typo",
888 HvNAME(stash), GvNAME(gv));
897 return gv_fetchpv(form("%s::_GEN_%ld", pack, (long)gensym++),
901 /* hopefully this is only called on local symbol table entries */
909 /* multi-named GPs cannot be used for method cache */
910 SvREFCNT_dec(gp->gp_cv);
915 /* Adding a new name to a subroutine invalidates method cache */
928 if (!gv || !(gp = GvGP(gv)))
930 if (gp->gp_refcnt == 0) {
931 warn("Attempt to free unreferenced glob pointers");
935 /* Deleting the name of a subroutine invalidates method cache */
938 if (--gp->gp_refcnt > 0) {
939 if (gp->gp_egv == gv)
944 SvREFCNT_dec(gp->gp_sv);
945 SvREFCNT_dec(gp->gp_av);
946 SvREFCNT_dec(gp->gp_hv);
947 SvREFCNT_dec(gp->gp_io);
948 SvREFCNT_dec(gp->gp_cv);
949 SvREFCNT_dec(gp->gp_form);
955 #if defined(CRIPPLED_CC) && (defined(iAPX286) || defined(M_I286) || defined(I80286))
959 #ifdef MICROPORT /* Microport 2.4 hack */
964 return GvGP(gv)->gp_av;
966 return GvGP(gv_AVadd(gv))->gp_av;
973 return GvGP(gv)->gp_hv;
975 return GvGP(gv_HVadd(gv))->gp_hv;
977 #endif /* Microport 2.4 hack */
980 /* Updates and caches the CV's */
983 Gv_AMupdate(HV *stash)
990 MAGIC* mg=mg_find((SV*)stash,'c');
991 AMT *amtp = (mg) ? (AMT*)mg->mg_ptr: (AMT *) NULL;
994 if (mg && amtp->was_ok_am == amagic_generation
995 && amtp->was_ok_sub == sub_generation)
996 return AMT_AMAGIC(amtp);
997 if (amtp && AMT_AMAGIC(amtp)) { /* Have table. */
999 for (i=1; i<NofAMmeth; i++) {
1000 if (amtp->table[i]) {
1001 SvREFCNT_dec(amtp->table[i]);
1005 sv_unmagic((SV*)stash, 'c');
1007 DEBUG_o( deb("Recalcing overload magic in package %s\n",HvNAME(stash)) );
1009 amt.was_ok_am = amagic_generation;
1010 amt.was_ok_sub = sub_generation;
1011 amt.fallback = AMGfallNO;
1014 #ifdef OVERLOAD_VIA_HASH
1015 gvp=(GV**)hv_fetch(stash,"OVERLOAD",8,FALSE); /* A shortcut */
1016 if (gvp && ((gv = *gvp) != (GV*)&sv_undef && (hv = GvHV(gv)))) {
1023 /* Work with "fallback" key, which we assume to be first in AMG_names */
1025 if (( cp = (char *)AMG_names[0] ) &&
1026 (svp = (SV**)hv_fetch(hv,cp,strlen(cp),FALSE)) && (sv = *svp)) {
1027 if (SvTRUE(sv)) amt.fallback=AMGfallYES;
1028 else if (SvOK(sv)) amt.fallback=AMGfallNEVER;
1030 for (i = 1; i < NofAMmeth; i++) {
1032 cp = (char *)AMG_names[i];
1034 svp = (SV**)hv_fetch(hv, cp, strlen(cp), FALSE);
1035 if (svp && ((sv = *svp) != &sv_undef)) {
1036 switch (SvTYPE(sv)) {
1039 if (!SvOK(sv)) break;
1040 gv = gv_fetchmethod(stash, SvPV(sv, na));
1041 if (gv) cv = GvCV(gv);
1045 if (SvTYPE(cv) == SVt_PVCV)
1050 croak("Not a subroutine reference in overload table");
1056 if (!(cv = GvCVu((GV*)sv)))
1057 cv = sv_2cv(sv, &stash, &gv, TRUE);
1062 croak("Method for operation %s not found in package %.256s during blessing\n",
1075 /* Work with "fallback" key, which we assume to be first in AMG_names */
1077 if ( cp = AMG_names[0] ) {
1078 /* Try to find via inheritance. */
1079 gv = gv_fetchmeth(stash, "()", 2, -1); /* A cookie: "()". */
1080 if (gv) sv = GvSV(gv);
1082 if (!gv) goto no_table;
1083 else if (SvTRUE(sv)) amt.fallback=AMGfallYES;
1084 else if (SvOK(sv)) amt.fallback=AMGfallNEVER;
1087 for (i = 1; i < NofAMmeth; i++) {
1088 SV *cookie = sv_2mortal(newSVpvf("(%s", cp = AMG_names[i]));
1089 DEBUG_o( deb("Checking overloading of `%s' in package `%.256s'\n",
1090 cp, HvNAME(stash)) );
1091 /* don't fill the cache while looking up! */
1092 gv = gv_fetchmeth(stash, SvPVX(cookie), SvCUR(cookie), -1);
1094 if(gv && (cv = GvCV(gv))) {
1095 if (GvNAMELEN(CvGV(cv)) == 3 && strEQ(GvNAME(CvGV(cv)), "nil")
1096 && strEQ(HvNAME(GvSTASH(CvGV(cv))), "overload")) {
1097 /* GvSV contains the name of the method. */
1100 DEBUG_o( deb("Resolving method `%.256s' for overloaded `%s' in package `%.256s'\n",
1101 SvPV(GvSV(gv), na), cp, HvNAME(stash)) );
1102 if (!SvPOK(GvSV(gv))
1103 || !(ngv = gv_fetchmethod_autoload(stash, SvPVX(GvSV(gv)),
1106 /* Can be an import stub (created by `can'). */
1108 croak("Stub found while resolving method `%.256s' overloading `%s' in package `%.256s'",
1109 (SvPOK(GvSV(gv)) ? SvPVX(GvSV(gv)) : "???" ),
1112 croak("Cannot resolve method `%.256s' overloading `%s' in package `%.256s'",
1113 (SvPOK(GvSV(gv)) ? SvPVX(GvSV(gv)) : "???" ),
1116 cv = GvCV(gv = ngv);
1118 DEBUG_o( deb("Overloading `%s' in package `%.256s' via `%.256s::%.256s' \n",
1119 cp, HvNAME(stash), HvNAME(GvSTASH(CvGV(cv))),
1120 GvNAME(CvGV(cv))) );
1124 amt.table[i]=(CV*)SvREFCNT_inc(cv);
1127 AMT_AMAGIC_on(&amt);
1128 sv_magic((SV*)stash, 0, 'c', (char*)&amt, sizeof(AMT));
1132 /* Here we have no table: */
1134 AMT_AMAGIC_off(&amt);
1135 sv_magic((SV*)stash, 0, 'c', (char*)&amt, sizeof(AMTS));
1140 amagic_call(SV *left, SV *right, int method, int flags)
1145 CV **cvp=NULL, **ocvp=NULL;
1147 int fl=0, off, off1, lr=0, assign=AMGf_assign & flags, notfound=0;
1148 int postpr=0, inc_dec_ass=0, assignshift=assign?1:0;
1150 if (!(AMGf_noleft & flags) && SvAMAGIC(left)
1151 && (mg = mg_find((SV*)(stash=SvSTASH(SvRV(left))),'c'))
1152 && (ocvp = cvp = (AMT_AMAGIC((AMT*)mg->mg_ptr)
1153 ? (oamtp = amtp = (AMT*)mg->mg_ptr)->table
1155 && ((cv = cvp[off=method+assignshift])
1156 || (assign && amtp->fallback > AMGfallNEVER && /* fallback to
1158 (fl = 1, cv = cvp[off=method])))) {
1159 lr = -1; /* Call method for left argument */
1161 if (cvp && amtp->fallback > AMGfallNEVER && flags & AMGf_unary) {
1164 /* look for substituted methods */
1167 if (((cv = cvp[off=add_ass_amg]) && (inc_dec_ass=1))
1168 || ((cv = cvp[off=add_amg]) && (postpr=1))) {
1169 right = &sv_yes; lr = -1; assign = 1;
1173 if (((cv = cvp[off=subtr_ass_amg]) && (inc_dec_ass=1))
1174 || ((cv = cvp[off=subtr_amg]) && (postpr=1))) {
1175 right = &sv_yes; lr = -1; assign = 1;
1179 (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=string_amg]));
1182 (void)((cv = cvp[off=string_amg]) || (cv = cvp[off=bool__amg]));
1185 (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=bool__amg]));
1188 (void)((cv = cvp[off=bool__amg])
1189 || (cv = cvp[off=numer_amg])
1190 || (cv = cvp[off=string_amg]));
1196 if (!SvROK(ref) && SvTYPE(ref) <= SVt_PVMG) {
1198 * Just to be extra cautious. Maybe in some
1199 * additional cases sv_setsv is safe, too.
1201 SV* newref = newSVsv(ref);
1202 SvOBJECT_on(newref);
1203 SvSTASH(newref) = (HV*)SvREFCNT_inc(SvSTASH(ref));
1209 if ((cvp[off1=lt_amg] || cvp[off1=ncmp_amg])
1210 && ((cv = cvp[off=neg_amg]) || (cv = cvp[off=subtr_amg]))) {
1211 SV* nullsv=sv_2mortal(newSViv(0));
1213 SV* lessp = amagic_call(left,nullsv,
1214 lt_amg,AMGf_noright);
1215 logic = SvTRUE(lessp);
1217 SV* lessp = amagic_call(left,nullsv,
1218 ncmp_amg,AMGf_noright);
1219 logic = (SvNV(lessp) < 0);
1222 if (off==subtr_amg) {
1233 if (cv = cvp[off=subtr_amg]) {
1235 left = sv_2mortal(newSViv(0));
1242 if (!cv) goto not_found;
1243 } else if (!(AMGf_noright & flags) && SvAMAGIC(right)
1244 && (mg = mg_find((SV*)(stash=SvSTASH(SvRV(right))),'c'))
1245 && (cvp = (AMT_AMAGIC((AMT*)mg->mg_ptr)
1246 ? (amtp = (AMT*)mg->mg_ptr)->table
1248 && (cv = cvp[off=method])) { /* Method for right
1251 } else if (((ocvp && oamtp->fallback > AMGfallNEVER
1252 && (cvp=ocvp) && (lr = -1))
1253 || (cvp && amtp->fallback > AMGfallNEVER && (lr=1)))
1254 && !(flags & AMGf_unary)) {
1255 /* We look for substitution for
1256 * comparison operations and
1258 if (method==concat_amg || method==concat_ass_amg
1259 || method==repeat_amg || method==repeat_ass_amg) {
1260 return NULL; /* Delegate operation to string conversion */
1270 postpr = 1; off=ncmp_amg; break;
1277 postpr = 1; off=scmp_amg; break;
1279 if (off != -1) cv = cvp[off];
1284 not_found: /* No method found, either report or croak */
1285 if (ocvp && (cv=ocvp[nomethod_amg])) { /* Call report method */
1286 notfound = 1; lr = -1;
1287 } else if (cvp && (cv=cvp[nomethod_amg])) {
1288 notfound = 1; lr = 1;
1291 if (off==-1) off=method;
1292 msg = sv_2mortal(newSVpvf(
1293 "Operation `%s': no method found,%sargument %s%s%s%s",
1294 AMG_names[method + assignshift],
1295 (flags & AMGf_unary ? " " : "\n\tleft "),
1297 "in overloaded package ":
1298 "has no overloaded magic",
1300 HvNAME(SvSTASH(SvRV(left))):
1303 ",\n\tright argument in overloaded package ":
1306 : ",\n\tright argument has no overloaded magic"),
1308 HvNAME(SvSTASH(SvRV(right))):
1310 if (amtp && amtp->fallback >= AMGfallYES) {
1311 DEBUG_o( deb("%s", SvPVX(msg)) );
1321 "Overloaded operator `%s'%s%s%s:\n\tmethod%s found%s in package %s%s\n",
1323 method+assignshift==off? "" :
1325 method+assignshift==off? "" :
1326 AMG_names[method+assignshift],
1327 method+assignshift==off? "" : "')",
1328 flags & AMGf_unary? "" :
1329 lr==1 ? " for right argument": " for left argument",
1330 flags & AMGf_unary? " for argument" : "",
1332 fl? ",\n\tassignment variant used": "") );
1333 /* Since we use shallow copy during assignment, we need
1334 * to dublicate the contents, probably calling user-supplied
1335 * version of copy operator
1337 if ((method + assignshift==off
1338 && (assign || method==inc_amg || method==dec_amg))
1339 || inc_dec_ass) RvDEEPCP(left);
1345 bool oldcatch = CATCH_GET;
1348 Zero(&myop, 1, BINOP);
1349 myop.op_last = (OP *) &myop;
1350 myop.op_next = Nullop;
1351 myop.op_flags = OPf_WANT_SCALAR | OPf_STACKED;
1353 PUSHSTACK(SI_OVERLOAD);
1357 if (PERLDB_SUB && curstash != debstash)
1358 op->op_private |= OPpENTERSUB_DB;
1362 EXTEND(SP, notfound + 5);
1363 PUSHs(lr>0? right: left);
1364 PUSHs(lr>0? left: right);
1365 PUSHs( lr > 0 ? &sv_yes : ( assign ? &sv_undef : &sv_no ));
1367 PUSHs( sv_2mortal(newSVpv((char *)AMG_names[method + assignshift],0)) );
1372 if (op = pp_entersub(ARGS))
1379 CATCH_SET(oldcatch);
1386 ans=SvIV(res)<=0; break;
1389 ans=SvIV(res)<0; break;
1392 ans=SvIV(res)>=0; break;
1395 ans=SvIV(res)>0; break;
1398 ans=SvIV(res)==0; break;
1401 ans=SvIV(res)!=0; break;
1404 SvSetSV(left,res); return left;
1406 ans=!SvOK(res); break;
1409 } else if (method==copy_amg) {
1411 croak("Copy method did not return a reference");
1413 return SvREFCNT_inc(SvRV(res));
1419 #endif /* OVERLOAD */