This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
d22a4398fbac6b1d8a6be3b79318a4ba9e34f4ec
[perl5.git] / gv.c
1 /*    gv.c
2  *
3  *    Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
4  *    2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 by Larry Wall and others
5  *
6  *    You may distribute under the terms of either the GNU General Public
7  *    License or the Artistic License, as specified in the README file.
8  *
9  */
10
11 /*
12  *   'Mercy!' cried Gandalf.  'If the giving of information is to be the cure
13  * of your inquisitiveness, I shall spend all the rest of my days in answering
14  * you.  What more do you want to know?'
15  *   'The names of all the stars, and of all living things, and the whole
16  * history of Middle-earth and Over-heaven and of the Sundering Seas,'
17  * laughed Pippin.
18  *
19  *     [p.599 of _The Lord of the Rings_, III/xi: "The Palantír"]
20  */
21
22 /*
23 =head1 GV Functions
24
25 A GV is a structure which corresponds to to a Perl typeglob, ie *foo.
26 It is a structure that holds a pointer to a scalar, an array, a hash etc,
27 corresponding to $foo, @foo, %foo.
28
29 GVs are usually found as values in stashes (symbol table hashes) where
30 Perl stores its global variables.
31
32 =cut
33 */
34
35 #include "EXTERN.h"
36 #define PERL_IN_GV_C
37 #include "perl.h"
38 #include "overload.c"
39
40 static const char S_autoload[] = "AUTOLOAD";
41 static const STRLEN S_autolen = sizeof(S_autoload)-1;
42
43 GV *
44 Perl_gv_add_by_type(pTHX_ GV *gv, svtype type)
45 {
46     SV **where;
47
48     if (
49         !gv
50      || (
51             SvTYPE((const SV *)gv) != SVt_PVGV
52          && SvTYPE((const SV *)gv) != SVt_PVLV
53         )
54     ) {
55         const char *what;
56         if (type == SVt_PVIO) {
57             /*
58              * if it walks like a dirhandle, then let's assume that
59              * this is a dirhandle.
60              */
61             what = PL_op->op_type ==  OP_READDIR ||
62                 PL_op->op_type ==  OP_TELLDIR ||
63                 PL_op->op_type ==  OP_SEEKDIR ||
64                 PL_op->op_type ==  OP_REWINDDIR ||
65                 PL_op->op_type ==  OP_CLOSEDIR ?
66                 "dirhandle" : "filehandle";
67             /* diag_listed_as: Bad symbol for filehandle */
68         } else if (type == SVt_PVHV) {
69             what = "hash";
70         } else {
71             what = type == SVt_PVAV ? "array" : "scalar";
72         }
73         Perl_croak(aTHX_ "Bad symbol for %s", what);
74     }
75
76     if (type == SVt_PVHV) {
77         where = (SV **)&GvHV(gv);
78     } else if (type == SVt_PVAV) {
79         where = (SV **)&GvAV(gv);
80     } else if (type == SVt_PVIO) {
81         where = (SV **)&GvIOp(gv);
82     } else {
83         where = &GvSV(gv);
84     }
85
86     if (!*where)
87         *where = newSV_type(type);
88     return gv;
89 }
90
91 GV *
92 Perl_gv_fetchfile(pTHX_ const char *name)
93 {
94     PERL_ARGS_ASSERT_GV_FETCHFILE;
95     return gv_fetchfile_flags(name, strlen(name), 0);
96 }
97
98 GV *
99 Perl_gv_fetchfile_flags(pTHX_ const char *const name, const STRLEN namelen,
100                         const U32 flags)
101 {
102     dVAR;
103     char smallbuf[128];
104     char *tmpbuf;
105     const STRLEN tmplen = namelen + 2;
106     GV *gv;
107
108     PERL_ARGS_ASSERT_GV_FETCHFILE_FLAGS;
109     PERL_UNUSED_ARG(flags);
110
111     if (!PL_defstash)
112         return NULL;
113
114     if (tmplen <= sizeof smallbuf)
115         tmpbuf = smallbuf;
116     else
117         Newx(tmpbuf, tmplen, char);
118     /* This is where the debugger's %{"::_<$filename"} hash is created */
119     tmpbuf[0] = '_';
120     tmpbuf[1] = '<';
121     memcpy(tmpbuf + 2, name, namelen);
122     gv = *(GV**)hv_fetch(PL_defstash, tmpbuf, tmplen, TRUE);
123     if (!isGV(gv)) {
124         gv_init(gv, PL_defstash, tmpbuf, tmplen, FALSE);
125 #ifdef PERL_DONT_CREATE_GVSV
126         GvSV(gv) = newSVpvn(name, namelen);
127 #else
128         sv_setpvn(GvSV(gv), name, namelen);
129 #endif
130     }
131     if ((PERLDB_LINE || PERLDB_SAVESRC) && !GvAV(gv))
132             hv_magic(GvHVn(gv_AVadd(gv)), NULL, PERL_MAGIC_dbfile);
133     if (tmpbuf != smallbuf)
134         Safefree(tmpbuf);
135     return gv;
136 }
137
138 /*
139 =for apidoc gv_const_sv
140
141 If C<gv> is a typeglob whose subroutine entry is a constant sub eligible for
142 inlining, or C<gv> is a placeholder reference that would be promoted to such
143 a typeglob, then returns the value returned by the sub.  Otherwise, returns
144 NULL.
145
146 =cut
147 */
148
149 SV *
150 Perl_gv_const_sv(pTHX_ GV *gv)
151 {
152     PERL_ARGS_ASSERT_GV_CONST_SV;
153
154     if (SvTYPE(gv) == SVt_PVGV)
155         return cv_const_sv(GvCVu(gv));
156     return SvROK(gv) ? SvRV(gv) : NULL;
157 }
158
159 GP *
160 Perl_newGP(pTHX_ GV *const gv)
161 {
162     GP *gp;
163     U32 hash;
164 #ifdef USE_ITHREADS
165     const char *const file
166         = (PL_curcop && CopFILE(PL_curcop)) ? CopFILE(PL_curcop) : "";
167     const STRLEN len = strlen(file);
168 #else
169     SV *const temp_sv = CopFILESV(PL_curcop);
170     const char *file;
171     STRLEN len;
172
173     PERL_ARGS_ASSERT_NEWGP;
174
175     if (temp_sv) {
176         file = SvPVX(temp_sv);
177         len = SvCUR(temp_sv);
178     } else {
179         file = "";
180         len = 0;
181     }
182 #endif
183
184     PERL_HASH(hash, file, len);
185
186     Newxz(gp, 1, GP);
187
188 #ifndef PERL_DONT_CREATE_GVSV
189     gp->gp_sv = newSV(0);
190 #endif
191
192     gp->gp_line = PL_curcop ? CopLINE(PL_curcop) : 0;
193     /* XXX Ideally this cast would be replaced with a change to const char*
194        in the struct.  */
195     gp->gp_file_hek = share_hek(file, len, hash);
196     gp->gp_egv = gv;
197     gp->gp_refcnt = 1;
198
199     return gp;
200 }
201
202 /* Assign CvGV(cv) = gv, handling weak references.
203  * See also S_anonymise_cv_maybe */
204
205 void
206 Perl_cvgv_set(pTHX_ CV* cv, GV* gv)
207 {
208     GV * const oldgv = CvGV(cv);
209     PERL_ARGS_ASSERT_CVGV_SET;
210
211     if (oldgv == gv)
212         return;
213
214     if (oldgv) {
215         if (CvCVGV_RC(cv)) {
216             SvREFCNT_dec(oldgv);
217             CvCVGV_RC_off(cv);
218         }
219         else {
220             sv_del_backref(MUTABLE_SV(oldgv), MUTABLE_SV(cv));
221         }
222     }
223
224     SvANY(cv)->xcv_gv = gv;
225     assert(!CvCVGV_RC(cv));
226
227     if (!gv)
228         return;
229
230     if (isGV_with_GP(gv) && GvGP(gv) && (GvCV(gv) == cv || GvFORM(gv) == cv))
231         Perl_sv_add_backref(aTHX_ MUTABLE_SV(gv), MUTABLE_SV(cv));
232     else {
233         CvCVGV_RC_on(cv);
234         SvREFCNT_inc_simple_void_NN(gv);
235     }
236 }
237
238 /* Assign CvSTASH(cv) = st, handling weak references. */
239
240 void
241 Perl_cvstash_set(pTHX_ CV *cv, HV *st)
242 {
243     HV *oldst = CvSTASH(cv);
244     PERL_ARGS_ASSERT_CVSTASH_SET;
245     if (oldst == st)
246         return;
247     if (oldst)
248         sv_del_backref(MUTABLE_SV(oldst), MUTABLE_SV(cv));
249     SvANY(cv)->xcv_stash = st;
250     if (st)
251         Perl_sv_add_backref(aTHX_ MUTABLE_SV(st), MUTABLE_SV(cv));
252 }
253
254 void
255 Perl_gv_init(pTHX_ GV *gv, HV *stash, const char *name, STRLEN len, int multi)
256 {
257     dVAR;
258     const U32 old_type = SvTYPE(gv);
259     const bool doproto = old_type > SVt_NULL;
260     char * const proto = (doproto && SvPOK(gv)) ? SvPVX(gv) : NULL;
261     const STRLEN protolen = proto ? SvCUR(gv) : 0;
262     SV *const has_constant = doproto && SvROK(gv) ? SvRV(gv) : NULL;
263     const U32 exported_constant = has_constant ? SvPCS_IMPORTED(gv) : 0;
264
265     PERL_ARGS_ASSERT_GV_INIT;
266     assert (!(proto && has_constant));
267
268     if (has_constant) {
269         /* The constant has to be a simple scalar type.  */
270         switch (SvTYPE(has_constant)) {
271         case SVt_PVAV:
272         case SVt_PVHV:
273         case SVt_PVCV:
274         case SVt_PVFM:
275         case SVt_PVIO:
276             Perl_croak(aTHX_ "Cannot convert a reference to %s to typeglob",
277                        sv_reftype(has_constant, 0));
278         default: NOOP;
279         }
280         SvRV_set(gv, NULL);
281         SvROK_off(gv);
282     }
283
284
285     if (old_type < SVt_PVGV) {
286         if (old_type >= SVt_PV)
287             SvCUR_set(gv, 0);
288         sv_upgrade(MUTABLE_SV(gv), SVt_PVGV);
289     }
290     if (SvLEN(gv)) {
291         if (proto) {
292             SvPV_set(gv, NULL);
293             SvLEN_set(gv, 0);
294             SvPOK_off(gv);
295         } else
296             Safefree(SvPVX_mutable(gv));
297     }
298     SvIOK_off(gv);
299     isGV_with_GP_on(gv);
300
301     GvGP_set(gv, Perl_newGP(aTHX_ gv));
302     GvSTASH(gv) = stash;
303     if (stash)
304         Perl_sv_add_backref(aTHX_ MUTABLE_SV(stash), MUTABLE_SV(gv));
305     gv_name_set(gv, name, len, GV_ADD);
306     if (multi || doproto)              /* doproto means it _was_ mentioned */
307         GvMULTI_on(gv);
308     if (doproto) {                      /* Replicate part of newSUB here. */
309         CV *cv;
310         ENTER;
311         if (has_constant) {
312             char *name0 = NULL;
313             if (name[len])
314                 /* newCONSTSUB doesn't take a len arg, so make sure we
315                  * give it a \0-terminated string */
316                 name0 = savepvn(name,len);
317
318             /* newCONSTSUB takes ownership of the reference from us.  */
319             cv = newCONSTSUB(stash, (name0 ? name0 : name), has_constant);
320             /* In case op.c:S_process_special_blocks stole it: */
321             if (!GvCV(gv))
322                 GvCV_set(gv, (CV *)SvREFCNT_inc_simple_NN(cv));
323             assert(GvCV(gv) == cv); /* newCONSTSUB should have set this */
324             if (name0)
325                 Safefree(name0);
326             /* If this reference was a copy of another, then the subroutine
327                must have been "imported", by a Perl space assignment to a GV
328                from a reference to CV.  */
329             if (exported_constant)
330                 GvIMPORTED_CV_on(gv);
331         } else {
332             (void) start_subparse(0,0); /* Create empty CV in compcv. */
333             cv = PL_compcv;
334             GvCV_set(gv,cv);
335         }
336         LEAVE;
337
338         mro_method_changed_in(GvSTASH(gv)); /* sub Foo::bar($) { (shift) } sub ASDF::baz($); *ASDF::baz = \&Foo::bar */
339         CvGV_set(cv, gv);
340         CvFILE_set_from_cop(cv, PL_curcop);
341         CvSTASH_set(cv, PL_curstash);
342         if (proto) {
343             sv_usepvn_flags(MUTABLE_SV(cv), proto, protolen,
344                             SV_HAS_TRAILING_NUL);
345         }
346     }
347 }
348
349 STATIC void
350 S_gv_init_sv(pTHX_ GV *gv, const svtype sv_type)
351 {
352     PERL_ARGS_ASSERT_GV_INIT_SV;
353
354     switch (sv_type) {
355     case SVt_PVIO:
356         (void)GvIOn(gv);
357         break;
358     case SVt_PVAV:
359         (void)GvAVn(gv);
360         break;
361     case SVt_PVHV:
362         (void)GvHVn(gv);
363         break;
364 #ifdef PERL_DONT_CREATE_GVSV
365     case SVt_NULL:
366     case SVt_PVCV:
367     case SVt_PVFM:
368     case SVt_PVGV:
369         break;
370     default:
371         if(GvSVn(gv)) {
372             /* Work round what appears to be a bug in Sun C++ 5.8 2005/10/13
373                If we just cast GvSVn(gv) to void, it ignores evaluating it for
374                its side effect */
375         }
376 #endif
377     }
378 }
379
380 /*
381 =for apidoc gv_fetchmeth
382
383 Returns the glob with the given C<name> and a defined subroutine or
384 C<NULL>.  The glob lives in the given C<stash>, or in the stashes
385 accessible via @ISA and UNIVERSAL::.
386
387 The argument C<level> should be either 0 or -1.  If C<level==0>, as a
388 side-effect creates a glob with the given C<name> in the given C<stash>
389 which in the case of success contains an alias for the subroutine, and sets
390 up caching info for this glob.
391
392 This function grants C<"SUPER"> token as a postfix of the stash name. The
393 GV returned from C<gv_fetchmeth> may be a method cache entry, which is not
394 visible to Perl code.  So when calling C<call_sv>, you should not use
395 the GV directly; instead, you should use the method's CV, which can be
396 obtained from the GV with the C<GvCV> macro.
397
398 =cut
399 */
400
401 /* NOTE: No support for tied ISA */
402
403 GV *
404 Perl_gv_fetchmeth(pTHX_ HV *stash, const char *name, STRLEN len, I32 level)
405 {
406     dVAR;
407     GV** gvp;
408     AV* linear_av;
409     SV** linear_svp;
410     SV* linear_sv;
411     HV* cstash;
412     GV* candidate = NULL;
413     CV* cand_cv = NULL;
414     CV* old_cv;
415     GV* topgv = NULL;
416     const char *hvname;
417     I32 create = (level >= 0) ? 1 : 0;
418     I32 items;
419     STRLEN packlen;
420     U32 topgen_cmp;
421
422     PERL_ARGS_ASSERT_GV_FETCHMETH;
423
424     /* UNIVERSAL methods should be callable without a stash */
425     if (!stash) {
426         create = 0;  /* probably appropriate */
427         if(!(stash = gv_stashpvs("UNIVERSAL", 0)))
428             return 0;
429     }
430
431     assert(stash);
432
433     hvname = HvNAME_get(stash);
434     if (!hvname)
435       Perl_croak(aTHX_ "Can't use anonymous symbol table for method lookup");
436
437     assert(hvname);
438     assert(name);
439
440     DEBUG_o( Perl_deb(aTHX_ "Looking for method %s in package %s\n",name,hvname) );
441
442     topgen_cmp = HvMROMETA(stash)->cache_gen + PL_sub_generation;
443
444     /* check locally for a real method or a cache entry */
445     gvp = (GV**)hv_fetch(stash, name, len, create);
446     if(gvp) {
447         topgv = *gvp;
448         assert(topgv);
449         if (SvTYPE(topgv) != SVt_PVGV)
450             gv_init(topgv, stash, name, len, TRUE);
451         if ((cand_cv = GvCV(topgv))) {
452             /* If genuine method or valid cache entry, use it */
453             if (!GvCVGEN(topgv) || GvCVGEN(topgv) == topgen_cmp) {
454                 return topgv;
455             }
456             else {
457                 /* stale cache entry, junk it and move on */
458                 SvREFCNT_dec(cand_cv);
459                 GvCV_set(topgv, NULL);
460                 cand_cv = NULL;
461                 GvCVGEN(topgv) = 0;
462             }
463         }
464         else if (GvCVGEN(topgv) == topgen_cmp) {
465             /* cache indicates no such method definitively */
466             return 0;
467         }
468     }
469
470     packlen = HvNAMELEN_get(stash);
471     if (packlen >= 7 && strEQ(hvname + packlen - 7, "::SUPER")) {
472         HV* basestash;
473         packlen -= 7;
474         basestash = gv_stashpvn(hvname, packlen, GV_ADD);
475         linear_av = mro_get_linear_isa(basestash);
476     }
477     else {
478         linear_av = mro_get_linear_isa(stash); /* has ourselves at the top of the list */
479     }
480
481     linear_svp = AvARRAY(linear_av) + 1; /* skip over self */
482     items = AvFILLp(linear_av); /* no +1, to skip over self */
483     while (items--) {
484         linear_sv = *linear_svp++;
485         assert(linear_sv);
486         cstash = gv_stashsv(linear_sv, 0);
487
488         if (!cstash) {
489             Perl_ck_warner(aTHX_ packWARN(WARN_SYNTAX), "Can't locate package %"SVf" for @%s::ISA",
490                            SVfARG(linear_sv), hvname);
491             continue;
492         }
493
494         assert(cstash);
495
496         gvp = (GV**)hv_fetch(cstash, name, len, 0);
497         if (!gvp) continue;
498         candidate = *gvp;
499         assert(candidate);
500         if (SvTYPE(candidate) != SVt_PVGV) gv_init(candidate, cstash, name, len, TRUE);
501         if (SvTYPE(candidate) == SVt_PVGV && (cand_cv = GvCV(candidate)) && !GvCVGEN(candidate)) {
502             /*
503              * Found real method, cache method in topgv if:
504              *  1. topgv has no synonyms (else inheritance crosses wires)
505              *  2. method isn't a stub (else AUTOLOAD fails spectacularly)
506              */
507             if (topgv && (GvREFCNT(topgv) == 1) && (CvROOT(cand_cv) || CvXSUB(cand_cv))) {
508                   if ((old_cv = GvCV(topgv))) SvREFCNT_dec(old_cv);
509                   SvREFCNT_inc_simple_void_NN(cand_cv);
510                   GvCV_set(topgv, cand_cv);
511                   GvCVGEN(topgv) = topgen_cmp;
512             }
513             return candidate;
514         }
515     }
516
517     /* Check UNIVERSAL without caching */
518     if(level == 0 || level == -1) {
519         candidate = gv_fetchmeth(NULL, name, len, 1);
520         if(candidate) {
521             cand_cv = GvCV(candidate);
522             if (topgv && (GvREFCNT(topgv) == 1) && (CvROOT(cand_cv) || CvXSUB(cand_cv))) {
523                   if ((old_cv = GvCV(topgv))) SvREFCNT_dec(old_cv);
524                   SvREFCNT_inc_simple_void_NN(cand_cv);
525                   GvCV_set(topgv, cand_cv);
526                   GvCVGEN(topgv) = topgen_cmp;
527             }
528             return candidate;
529         }
530     }
531
532     if (topgv && GvREFCNT(topgv) == 1) {
533         /* cache the fact that the method is not defined */
534         GvCVGEN(topgv) = topgen_cmp;
535     }
536
537     return 0;
538 }
539
540 /*
541 =for apidoc gv_fetchmeth_autoload
542
543 Same as gv_fetchmeth(), but looks for autoloaded subroutines too.
544 Returns a glob for the subroutine.
545
546 For an autoloaded subroutine without a GV, will create a GV even
547 if C<level < 0>.  For an autoloaded subroutine without a stub, GvCV()
548 of the result may be zero.
549
550 =cut
551 */
552
553 GV *
554 Perl_gv_fetchmeth_autoload(pTHX_ HV *stash, const char *name, STRLEN len, I32 level)
555 {
556     GV *gv = gv_fetchmeth(stash, name, len, level);
557
558     PERL_ARGS_ASSERT_GV_FETCHMETH_AUTOLOAD;
559
560     if (!gv) {
561         CV *cv;
562         GV **gvp;
563
564         if (!stash)
565             return NULL;        /* UNIVERSAL::AUTOLOAD could cause trouble */
566         if (len == S_autolen && memEQ(name, S_autoload, S_autolen))
567             return NULL;
568         if (!(gv = gv_fetchmeth(stash, S_autoload, S_autolen, FALSE)))
569             return NULL;
570         cv = GvCV(gv);
571         if (!(CvROOT(cv) || CvXSUB(cv)))
572             return NULL;
573         /* Have an autoload */
574         if (level < 0)  /* Cannot do without a stub */
575             gv_fetchmeth(stash, name, len, 0);
576         gvp = (GV**)hv_fetch(stash, name, len, (level >= 0));
577         if (!gvp)
578             return NULL;
579         return *gvp;
580     }
581     return gv;
582 }
583
584 /*
585 =for apidoc gv_fetchmethod_autoload
586
587 Returns the glob which contains the subroutine to call to invoke the method
588 on the C<stash>.  In fact in the presence of autoloading this may be the
589 glob for "AUTOLOAD".  In this case the corresponding variable $AUTOLOAD is
590 already setup.
591
592 The third parameter of C<gv_fetchmethod_autoload> determines whether
593 AUTOLOAD lookup is performed if the given method is not present: non-zero
594 means yes, look for AUTOLOAD; zero means no, don't look for AUTOLOAD.
595 Calling C<gv_fetchmethod> is equivalent to calling C<gv_fetchmethod_autoload>
596 with a non-zero C<autoload> parameter.
597
598 These functions grant C<"SUPER"> token as a prefix of the method name. Note
599 that if you want to keep the returned glob for a long time, you need to
600 check for it being "AUTOLOAD", since at the later time the call may load a
601 different subroutine due to $AUTOLOAD changing its value. Use the glob
602 created via a side effect to do this.
603
604 These functions have the same side-effects and as C<gv_fetchmeth> with
605 C<level==0>.  C<name> should be writable if contains C<':'> or C<'
606 ''>. The warning against passing the GV returned by C<gv_fetchmeth> to
607 C<call_sv> apply equally to these functions.
608
609 =cut
610 */
611
612 STATIC HV*
613 S_gv_get_super_pkg(pTHX_ const char* name, I32 namelen)
614 {
615     AV* superisa;
616     GV** gvp;
617     GV* gv;
618     HV* stash;
619
620     PERL_ARGS_ASSERT_GV_GET_SUPER_PKG;
621
622     stash = gv_stashpvn(name, namelen, 0);
623     if(stash) return stash;
624
625     /* If we must create it, give it an @ISA array containing
626        the real package this SUPER is for, so that it's tied
627        into the cache invalidation code correctly */
628     stash = gv_stashpvn(name, namelen, GV_ADD);
629     gvp = (GV**)hv_fetchs(stash, "ISA", TRUE);
630     gv = *gvp;
631     gv_init(gv, stash, "ISA", 3, TRUE);
632     superisa = GvAVn(gv);
633     GvMULTI_on(gv);
634     sv_magic(MUTABLE_SV(superisa), MUTABLE_SV(gv), PERL_MAGIC_isa, NULL, 0);
635 #ifdef USE_ITHREADS
636     av_push(superisa, newSVpv(CopSTASHPV(PL_curcop), 0));
637 #else
638     av_push(superisa, newSVhek(CopSTASH(PL_curcop)
639                                ? HvNAME_HEK(CopSTASH(PL_curcop)) : NULL));
640 #endif
641
642     return stash;
643 }
644
645 GV *
646 Perl_gv_fetchmethod_autoload(pTHX_ HV *stash, const char *name, I32 autoload)
647 {
648     PERL_ARGS_ASSERT_GV_FETCHMETHOD_AUTOLOAD;
649
650     return gv_fetchmethod_flags(stash, name, autoload ? GV_AUTOLOAD : 0);
651 }
652
653 /* Don't merge this yet, as it's likely to get a len parameter, and possibly
654    even a U32 hash */
655 GV *
656 Perl_gv_fetchmethod_flags(pTHX_ HV *stash, const char *name, U32 flags)
657 {
658     dVAR;
659     register const char *nend;
660     const char *nsplit = NULL;
661     GV* gv;
662     HV* ostash = stash;
663     const char * const origname = name;
664     SV *const error_report = MUTABLE_SV(stash);
665     const U32 autoload = flags & GV_AUTOLOAD;
666     const U32 do_croak = flags & GV_CROAK;
667
668     PERL_ARGS_ASSERT_GV_FETCHMETHOD_FLAGS;
669
670     if (SvTYPE(stash) < SVt_PVHV)
671         stash = NULL;
672     else {
673         /* The only way stash can become NULL later on is if nsplit is set,
674            which in turn means that there is no need for a SVt_PVHV case
675            the error reporting code.  */
676     }
677
678     for (nend = name; *nend; nend++) {
679         if (*nend == '\'') {
680             nsplit = nend;
681             name = nend + 1;
682         }
683         else if (*nend == ':' && *(nend + 1) == ':') {
684             nsplit = nend++;
685             name = nend + 1;
686         }
687     }
688     if (nsplit) {
689         if ((nsplit - origname) == 5 && memEQ(origname, "SUPER", 5)) {
690             /* ->SUPER::method should really be looked up in original stash */
691             SV * const tmpstr = sv_2mortal(Perl_newSVpvf(aTHX_ "%s::SUPER",
692                                                   CopSTASHPV(PL_curcop)));
693             /* __PACKAGE__::SUPER stash should be autovivified */
694             stash = gv_get_super_pkg(SvPVX_const(tmpstr), SvCUR(tmpstr));
695             DEBUG_o( Perl_deb(aTHX_ "Treating %s as %s::%s\n",
696                          origname, HvNAME_get(stash), name) );
697         }
698         else {
699             /* don't autovifify if ->NoSuchStash::method */
700             stash = gv_stashpvn(origname, nsplit - origname, 0);
701
702             /* however, explicit calls to Pkg::SUPER::method may
703                happen, and may require autovivification to work */
704             if (!stash && (nsplit - origname) >= 7 &&
705                 strnEQ(nsplit - 7, "::SUPER", 7) &&
706                 gv_stashpvn(origname, nsplit - origname - 7, 0))
707               stash = gv_get_super_pkg(origname, nsplit - origname);
708         }
709         ostash = stash;
710     }
711
712     gv = gv_fetchmeth(stash, name, nend - name, 0);
713     if (!gv) {
714         if (strEQ(name,"import") || strEQ(name,"unimport"))
715             gv = MUTABLE_GV(&PL_sv_yes);
716         else if (autoload)
717             gv = gv_autoload4(ostash, name, nend - name, TRUE);
718         if (!gv && do_croak) {
719             /* Right now this is exclusively for the benefit of S_method_common
720                in pp_hot.c  */
721             if (stash) {
722                 /* If we can't find an IO::File method, it might be a call on
723                  * a filehandle. If IO:File has not been loaded, try to
724                  * require it first instead of croaking */
725                 const char *stash_name = HvNAME_get(stash);
726                 if (stash_name && memEQs(stash_name, HvNAMELEN_get(stash), "IO::File")
727                     && !Perl_hv_common(aTHX_ GvHVn(PL_incgv), NULL,
728                                        STR_WITH_LEN("IO/File.pm"), 0,
729                                        HV_FETCH_ISEXISTS, NULL, 0)
730                 ) {
731                     require_pv("IO/File.pm");
732                     gv = gv_fetchmeth(stash, name, nend - name, 0);
733                     if (gv)
734                         return gv;
735                 }
736                 Perl_croak(aTHX_
737                            "Can't locate object method \"%s\" via package \"%.*s\"",
738                            name, (int)HvNAMELEN_get(stash), HvNAME_get(stash));
739             }
740             else {
741                 STRLEN packlen;
742                 const char *packname;
743
744                 if (nsplit) {
745                     packlen = nsplit - origname;
746                     packname = origname;
747                 } else {
748                     packname = SvPV_const(error_report, packlen);
749                 }
750
751                 Perl_croak(aTHX_
752                            "Can't locate object method \"%s\" via package \"%.*s\""
753                            " (perhaps you forgot to load \"%.*s\"?)",
754                            name, (int)packlen, packname, (int)packlen, packname);
755             }
756         }
757     }
758     else if (autoload) {
759         CV* const cv = GvCV(gv);
760         if (!CvROOT(cv) && !CvXSUB(cv)) {
761             GV* stubgv;
762             GV* autogv;
763
764             if (CvANON(cv))
765                 stubgv = gv;
766             else {
767                 stubgv = CvGV(cv);
768                 if (GvCV(stubgv) != cv)         /* orphaned import */
769                     stubgv = gv;
770             }
771             autogv = gv_autoload4(GvSTASH(stubgv),
772                                   GvNAME(stubgv), GvNAMELEN(stubgv), TRUE);
773             if (autogv)
774                 gv = autogv;
775         }
776     }
777
778     return gv;
779 }
780
781 GV*
782 Perl_gv_autoload4(pTHX_ HV *stash, const char *name, STRLEN len, I32 method)
783 {
784     dVAR;
785     GV* gv;
786     CV* cv;
787     HV* varstash;
788     GV* vargv;
789     SV* varsv;
790     const char *packname = "";
791     STRLEN packname_len = 0;
792
793     PERL_ARGS_ASSERT_GV_AUTOLOAD4;
794
795     if (len == S_autolen && memEQ(name, S_autoload, S_autolen))
796         return NULL;
797     if (stash) {
798         if (SvTYPE(stash) < SVt_PVHV) {
799             packname = SvPV_const(MUTABLE_SV(stash), packname_len);
800             stash = NULL;
801         }
802         else {
803             packname = HvNAME_get(stash);
804             packname_len = HvNAMELEN_get(stash);
805         }
806     }
807     if (!(gv = gv_fetchmeth(stash, S_autoload, S_autolen, FALSE)))
808         return NULL;
809     cv = GvCV(gv);
810
811     if (!(CvROOT(cv) || CvXSUB(cv)))
812         return NULL;
813
814     /*
815      * Inheriting AUTOLOAD for non-methods works ... for now.
816      */
817     if (!method && (GvCVGEN(gv) || GvSTASH(gv) != stash)
818     )
819         Perl_ck_warner_d(aTHX_ packWARN(WARN_DEPRECATED),
820                          "Use of inherited AUTOLOAD for non-method %s::%.*s() is deprecated",
821                          packname, (int)len, name);
822
823     if (CvISXSUB(cv)) {
824         /* rather than lookup/init $AUTOLOAD here
825          * only to have the XSUB do another lookup for $AUTOLOAD
826          * and split that value on the last '::',
827          * pass along the same data via some unused fields in the CV
828          */
829         CvSTASH_set(cv, stash);
830         SvPV_set(cv, (char *)name); /* cast to lose constness warning */
831         SvCUR_set(cv, len);
832         return gv;
833     }
834
835     /*
836      * Given &FOO::AUTOLOAD, set $FOO::AUTOLOAD to desired function name.
837      * The subroutine's original name may not be "AUTOLOAD", so we don't
838      * use that, but for lack of anything better we will use the sub's
839      * original package to look up $AUTOLOAD.
840      */
841     varstash = GvSTASH(CvGV(cv));
842     vargv = *(GV**)hv_fetch(varstash, S_autoload, S_autolen, TRUE);
843     ENTER;
844
845     if (!isGV(vargv)) {
846         gv_init(vargv, varstash, S_autoload, S_autolen, FALSE);
847 #ifdef PERL_DONT_CREATE_GVSV
848         GvSV(vargv) = newSV(0);
849 #endif
850     }
851     LEAVE;
852     varsv = GvSVn(vargv);
853     sv_setpvn(varsv, packname, packname_len);
854     sv_catpvs(varsv, "::");
855     /* Ensure SvSETMAGIC() is called if necessary. In particular, to clear
856        tainting if $FOO::AUTOLOAD was previously tainted, but is not now.  */
857     sv_catpvn_mg(varsv, name, len);
858     return gv;
859 }
860
861
862 /* require_tie_mod() internal routine for requiring a module
863  * that implements the logic of automatic ties like %! and %-
864  *
865  * The "gv" parameter should be the glob.
866  * "varpv" holds the name of the var, used for error messages.
867  * "namesv" holds the module name. Its refcount will be decremented.
868  * "methpv" holds the method name to test for to check that things
869  *   are working reasonably close to as expected.
870  * "flags": if flag & 1 then save the scalar before loading.
871  * For the protection of $! to work (it is set by this routine)
872  * the sv slot must already be magicalized.
873  */
874 STATIC HV*
875 S_require_tie_mod(pTHX_ GV *gv, const char *varpv, SV* namesv, const char *methpv,const U32 flags)
876 {
877     dVAR;
878     HV* stash = gv_stashsv(namesv, 0);
879
880     PERL_ARGS_ASSERT_REQUIRE_TIE_MOD;
881
882     if (!stash || !(gv_fetchmethod(stash, methpv))) {
883         SV *module = newSVsv(namesv);
884         char varname = *varpv; /* varpv might be clobbered by load_module,
885                                   so save it. For the moment it's always
886                                   a single char. */
887         dSP;
888         ENTER;
889         if ( flags & 1 )
890             save_scalar(gv);
891         PUSHSTACKi(PERLSI_MAGIC);
892         Perl_load_module(aTHX_ PERL_LOADMOD_NOIMPORT, module, NULL);
893         POPSTACK;
894         LEAVE;
895         SPAGAIN;
896         stash = gv_stashsv(namesv, 0);
897         if (!stash)
898             Perl_croak(aTHX_ "panic: Can't use %%%c because %"SVf" is not available",
899                     varname, SVfARG(namesv));
900         else if (!gv_fetchmethod(stash, methpv))
901             Perl_croak(aTHX_ "panic: Can't use %%%c because %"SVf" does not support method %s",
902                     varname, SVfARG(namesv), methpv);
903     }
904     SvREFCNT_dec(namesv);
905     return stash;
906 }
907
908 /*
909 =for apidoc gv_stashpv
910
911 Returns a pointer to the stash for a specified package.  Uses C<strlen> to
912 determine the length of C<name>, then calls C<gv_stashpvn()>.
913
914 =cut
915 */
916
917 HV*
918 Perl_gv_stashpv(pTHX_ const char *name, I32 create)
919 {
920     PERL_ARGS_ASSERT_GV_STASHPV;
921     return gv_stashpvn(name, strlen(name), create);
922 }
923
924 /*
925 =for apidoc gv_stashpvn
926
927 Returns a pointer to the stash for a specified package.  The C<namelen>
928 parameter indicates the length of the C<name>, in bytes.  C<flags> is passed
929 to C<gv_fetchpvn_flags()>, so if set to C<GV_ADD> then the package will be
930 created if it does not already exist.  If the package does not exist and
931 C<flags> is 0 (or any other setting that does not create packages) then NULL
932 is returned.
933
934
935 =cut
936 */
937
938 HV*
939 Perl_gv_stashpvn(pTHX_ const char *name, U32 namelen, I32 flags)
940 {
941     char smallbuf[128];
942     char *tmpbuf;
943     HV *stash;
944     GV *tmpgv;
945     U32 tmplen = namelen + 2;
946
947     PERL_ARGS_ASSERT_GV_STASHPVN;
948
949     if (tmplen <= sizeof smallbuf)
950         tmpbuf = smallbuf;
951     else
952         Newx(tmpbuf, tmplen, char);
953     Copy(name, tmpbuf, namelen, char);
954     tmpbuf[namelen]   = ':';
955     tmpbuf[namelen+1] = ':';
956     tmpgv = gv_fetchpvn_flags(tmpbuf, tmplen, flags, SVt_PVHV);
957     if (tmpbuf != smallbuf)
958         Safefree(tmpbuf);
959     if (!tmpgv)
960         return NULL;
961     stash = GvHV(tmpgv);
962     if (!(flags & ~GV_NOADD_MASK) && !stash) return NULL;
963     if (!HvNAME_get(stash)) {
964         hv_name_set(stash, name, namelen, 0);
965         
966         /* FIXME: This is a repeat of logic in gv_fetchpvn_flags */
967         /* If the containing stash has multiple effective
968            names, see that this one gets them, too. */
969         if (HvAUX(GvSTASH(tmpgv))->xhv_name_count)
970             mro_package_moved(stash, NULL, tmpgv, 1);
971     }
972     assert(stash);
973     return stash;
974 }
975
976 /*
977 =for apidoc gv_stashsv
978
979 Returns a pointer to the stash for a specified package.  See C<gv_stashpvn>.
980
981 =cut
982 */
983
984 HV*
985 Perl_gv_stashsv(pTHX_ SV *sv, I32 flags)
986 {
987     STRLEN len;
988     const char * const ptr = SvPV_const(sv,len);
989
990     PERL_ARGS_ASSERT_GV_STASHSV;
991
992     return gv_stashpvn(ptr, len, flags);
993 }
994
995
996 GV *
997 Perl_gv_fetchpv(pTHX_ const char *nambeg, I32 add, const svtype sv_type) {
998     PERL_ARGS_ASSERT_GV_FETCHPV;
999     return gv_fetchpvn_flags(nambeg, strlen(nambeg), add, sv_type);
1000 }
1001
1002 GV *
1003 Perl_gv_fetchsv(pTHX_ SV *name, I32 flags, const svtype sv_type) {
1004     STRLEN len;
1005     const char * const nambeg = SvPV_const(name, len);
1006     PERL_ARGS_ASSERT_GV_FETCHSV;
1007     return gv_fetchpvn_flags(nambeg, len, flags | SvUTF8(name), sv_type);
1008 }
1009
1010 STATIC void
1011 S_gv_magicalize_isa(pTHX_ GV *gv)
1012 {
1013     AV* av;
1014
1015     PERL_ARGS_ASSERT_GV_MAGICALIZE_ISA;
1016
1017     av = GvAVn(gv);
1018     GvMULTI_on(gv);
1019     sv_magic(MUTABLE_SV(av), MUTABLE_SV(gv), PERL_MAGIC_isa,
1020              NULL, 0);
1021 }
1022
1023 STATIC void
1024 S_gv_magicalize_overload(pTHX_ GV *gv)
1025 {
1026     HV* hv;
1027
1028     PERL_ARGS_ASSERT_GV_MAGICALIZE_OVERLOAD;
1029
1030     hv = GvHVn(gv);
1031     GvMULTI_on(gv);
1032     hv_magic(hv, NULL, PERL_MAGIC_overload);
1033 }
1034
1035 GV *
1036 Perl_gv_fetchpvn_flags(pTHX_ const char *nambeg, STRLEN full_len, I32 flags,
1037                        const svtype sv_type)
1038 {
1039     dVAR;
1040     register const char *name = nambeg;
1041     register GV *gv = NULL;
1042     GV**gvp;
1043     I32 len;
1044     register const char *name_cursor;
1045     HV *stash = NULL;
1046     const I32 no_init = flags & (GV_NOADD_NOINIT | GV_NOINIT);
1047     const I32 no_expand = flags & GV_NOEXPAND;
1048     const I32 add = flags & ~GV_NOADD_MASK;
1049     const char *const name_end = nambeg + full_len;
1050     const char *const name_em1 = name_end - 1;
1051     U32 faking_it;
1052
1053     PERL_ARGS_ASSERT_GV_FETCHPVN_FLAGS;
1054
1055     if (flags & GV_NOTQUAL) {
1056         /* Caller promised that there is no stash, so we can skip the check. */
1057         len = full_len;
1058         goto no_stash;
1059     }
1060
1061     if (full_len > 2 && *name == '*' && isALPHA(name[1])) {
1062         /* accidental stringify on a GV? */
1063         name++;
1064     }
1065
1066     for (name_cursor = name; name_cursor < name_end; name_cursor++) {
1067         if ((*name_cursor == ':' && name_cursor < name_em1
1068              && name_cursor[1] == ':')
1069             || (*name_cursor == '\'' && name_cursor[1]))
1070         {
1071             if (!stash)
1072                 stash = PL_defstash;
1073             if (!stash || !SvREFCNT(stash)) /* symbol table under destruction */
1074                 return NULL;
1075
1076             len = name_cursor - name;
1077             if (name_cursor > nambeg) { /* Skip for initial :: or ' */
1078                 const char *key;
1079                 if (*name_cursor == ':') {
1080                     key = name;
1081                     len += 2;
1082                 } else {
1083                     char *tmpbuf;
1084                     Newx(tmpbuf, len+2, char);
1085                     Copy(name, tmpbuf, len, char);
1086                     tmpbuf[len++] = ':';
1087                     tmpbuf[len++] = ':';
1088                     key = tmpbuf;
1089                 }
1090                 gvp = (GV**)hv_fetch(stash, key, len, add);
1091                 gv = gvp ? *gvp : NULL;
1092                 if (gv && gv != (const GV *)&PL_sv_undef) {
1093                     if (SvTYPE(gv) != SVt_PVGV)
1094                         gv_init(gv, stash, key, len, (add & GV_ADDMULTI));
1095                     else
1096                         GvMULTI_on(gv);
1097                 }
1098                 if (key != name)
1099                     Safefree(key);
1100                 if (!gv || gv == (const GV *)&PL_sv_undef)
1101                     return NULL;
1102
1103                 if (!(stash = GvHV(gv)))
1104                 {
1105                     stash = GvHV(gv) = newHV();
1106                     if (!HvNAME_get(stash)) {
1107                         hv_name_set(stash, nambeg, name_cursor-nambeg, 0);
1108                         /* If the containing stash has multiple effective
1109                            names, see that this one gets them, too. */
1110                         if (HvAUX(GvSTASH(gv))->xhv_name_count)
1111                             mro_package_moved(stash, NULL, gv, 1);
1112                     }
1113                 }
1114                 else if (!HvNAME_get(stash))
1115                     hv_name_set(stash, nambeg, name_cursor - nambeg, 0);
1116             }
1117
1118             if (*name_cursor == ':')
1119                 name_cursor++;
1120             name = name_cursor+1;
1121             if (name == name_end)
1122                 return gv
1123                     ? gv : MUTABLE_GV(*hv_fetchs(PL_defstash, "main::", TRUE));
1124         }
1125     }
1126     len = name_cursor - name;
1127
1128     /* No stash in name, so see how we can default */
1129
1130     if (!stash) {
1131     no_stash:
1132         if (len && isIDFIRST_lazy(name)) {
1133             bool global = FALSE;
1134
1135             switch (len) {
1136             case 1:
1137                 if (*name == '_')
1138                     global = TRUE;
1139                 break;
1140             case 3:
1141                 if ((name[0] == 'I' && name[1] == 'N' && name[2] == 'C')
1142                     || (name[0] == 'E' && name[1] == 'N' && name[2] == 'V')
1143                     || (name[0] == 'S' && name[1] == 'I' && name[2] == 'G'))
1144                     global = TRUE;
1145                 break;
1146             case 4:
1147                 if (name[0] == 'A' && name[1] == 'R' && name[2] == 'G'
1148                     && name[3] == 'V')
1149                     global = TRUE;
1150                 break;
1151             case 5:
1152                 if (name[0] == 'S' && name[1] == 'T' && name[2] == 'D'
1153                     && name[3] == 'I' && name[4] == 'N')
1154                     global = TRUE;
1155                 break;
1156             case 6:
1157                 if ((name[0] == 'S' && name[1] == 'T' && name[2] == 'D')
1158                     &&((name[3] == 'O' && name[4] == 'U' && name[5] == 'T')
1159                        ||(name[3] == 'E' && name[4] == 'R' && name[5] == 'R')))
1160                     global = TRUE;
1161                 break;
1162             case 7:
1163                 if (name[0] == 'A' && name[1] == 'R' && name[2] == 'G'
1164                     && name[3] == 'V' && name[4] == 'O' && name[5] == 'U'
1165                     && name[6] == 'T')
1166                     global = TRUE;
1167                 break;
1168             }
1169
1170             if (global)
1171                 stash = PL_defstash;
1172             else if (IN_PERL_COMPILETIME) {
1173                 stash = PL_curstash;
1174                 if (add && (PL_hints & HINT_STRICT_VARS) &&
1175                     sv_type != SVt_PVCV &&
1176                     sv_type != SVt_PVGV &&
1177                     sv_type != SVt_PVFM &&
1178                     sv_type != SVt_PVIO &&
1179                     !(len == 1 && sv_type == SVt_PV &&
1180                       (*name == 'a' || *name == 'b')) )
1181                 {
1182                     gvp = (GV**)hv_fetch(stash,name,len,0);
1183                     if (!gvp ||
1184                         *gvp == (const GV *)&PL_sv_undef ||
1185                         SvTYPE(*gvp) != SVt_PVGV)
1186                     {
1187                         stash = NULL;
1188                     }
1189                     else if ((sv_type == SVt_PV   && !GvIMPORTED_SV(*gvp)) ||
1190                              (sv_type == SVt_PVAV && !GvIMPORTED_AV(*gvp)) ||
1191                              (sv_type == SVt_PVHV && !GvIMPORTED_HV(*gvp)) )
1192                     {
1193                         /* diag_listed_as: Variable "%s" is not imported%s */
1194                         Perl_ck_warner_d(
1195                             aTHX_ packWARN(WARN_MISC),
1196                             "Variable \"%c%s\" is not imported",
1197                             sv_type == SVt_PVAV ? '@' :
1198                             sv_type == SVt_PVHV ? '%' : '$',
1199                             name);
1200                         if (GvCVu(*gvp))
1201                             Perl_ck_warner_d(
1202                                 aTHX_ packWARN(WARN_MISC),
1203                                 "\t(Did you mean &%s instead?)\n", name
1204                             );
1205                         stash = NULL;
1206                     }
1207                 }
1208             }
1209             else
1210                 stash = CopSTASH(PL_curcop);
1211         }
1212         else
1213             stash = PL_defstash;
1214     }
1215
1216     /* By this point we should have a stash and a name */
1217
1218     if (!stash) {
1219         if (add) {
1220             SV * const err = Perl_mess(aTHX_
1221                  "Global symbol \"%s%s\" requires explicit package name",
1222                  (sv_type == SVt_PV ? "$"
1223                   : sv_type == SVt_PVAV ? "@"
1224                   : sv_type == SVt_PVHV ? "%"
1225                   : ""), name);
1226             GV *gv;
1227             if (USE_UTF8_IN_NAMES)
1228                 SvUTF8_on(err);
1229             qerror(err);
1230             gv = gv_fetchpvs("<none>::", GV_ADDMULTI, SVt_PVHV);
1231             if(!gv) {
1232                 /* symbol table under destruction */
1233                 return NULL;
1234             }   
1235             stash = GvHV(gv);
1236         }
1237         else
1238             return NULL;
1239     }
1240
1241     if (!SvREFCNT(stash))       /* symbol table under destruction */
1242         return NULL;
1243
1244     gvp = (GV**)hv_fetch(stash,name,len,add);
1245     if (!gvp || *gvp == (const GV *)&PL_sv_undef)
1246         return NULL;
1247     gv = *gvp;
1248     if (SvTYPE(gv) == SVt_PVGV) {
1249         if (add) {
1250             GvMULTI_on(gv);
1251             gv_init_sv(gv, sv_type);
1252             if (len == 1 && stash == PL_defstash
1253                 && (sv_type == SVt_PVHV || sv_type == SVt_PVGV)) {
1254                 if (*name == '!')
1255                     require_tie_mod(gv, "!", newSVpvs("Errno"), "TIEHASH", 1);
1256                 else if (*name == '-' || *name == '+')
1257                     require_tie_mod(gv, name, newSVpvs("Tie::Hash::NamedCapture"), "TIEHASH", 0);
1258             }
1259             else if (len == 3 && sv_type == SVt_PVAV
1260                   && strnEQ(name, "ISA", 3)
1261                   && (!GvAV(gv) || !SvSMAGICAL(GvAV(gv))))
1262                 gv_magicalize_isa(gv);
1263         }
1264         return gv;
1265     } else if (no_init) {
1266         return gv;
1267     } else if (no_expand && SvROK(gv)) {
1268         return gv;
1269     }
1270
1271     /* Adding a new symbol.
1272        Unless of course there was already something non-GV here, in which case
1273        we want to behave as if there was always a GV here, containing some sort
1274        of subroutine.
1275        Otherwise we run the risk of creating things like GvIO, which can cause
1276        subtle bugs. eg the one that tripped up SQL::Translator  */
1277
1278     faking_it = SvOK(gv);
1279
1280     if (add & GV_ADDWARN)
1281         Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL), "Had to create %s unexpectedly", nambeg);
1282     gv_init(gv, stash, name, len, add & GV_ADDMULTI);
1283     gv_init_sv(gv, faking_it ? SVt_PVCV : sv_type);
1284
1285     if (isALPHA(name[0]) && ! (isLEXWARN_on ? ckWARN(WARN_ONCE)
1286                                             : (PL_dowarn & G_WARN_ON ) ) )
1287         GvMULTI_on(gv) ;
1288
1289     /* set up magic where warranted */
1290     if (stash != PL_defstash) { /* not the main stash */
1291         /* We only have to check for four names here: EXPORT, ISA, OVERLOAD
1292            and VERSION. All the others apply only to the main stash. */
1293         if (len > 1) {
1294             const char * const name2 = name + 1;
1295             switch (*name) {
1296             case 'E':
1297                 if (strnEQ(name2, "XPORT", 5))
1298                     GvMULTI_on(gv);
1299                 break;
1300             case 'I':
1301                 if (strEQ(name2, "SA"))
1302                     gv_magicalize_isa(gv);
1303                 break;
1304             case 'O':
1305                 if (strEQ(name2, "VERLOAD"))
1306                     gv_magicalize_overload(gv);
1307                 break;
1308             case 'V':
1309                 if (strEQ(name2, "ERSION"))
1310                     GvMULTI_on(gv);
1311                 break;
1312             }
1313         }
1314     }
1315     else if (len > 1) {
1316 #ifndef EBCDIC
1317         if (*name > 'V' ) {
1318             NOOP;
1319             /* Nothing else to do.
1320                The compiler will probably turn the switch statement into a
1321                branch table. Make sure we avoid even that small overhead for
1322                the common case of lower case variable names.  */
1323         } else
1324 #endif
1325         {
1326             const char * const name2 = name + 1;
1327             switch (*name) {
1328             case 'A':
1329                 if (strEQ(name2, "RGV")) {
1330                     IoFLAGS(GvIOn(gv)) |= IOf_ARGV|IOf_START;
1331                 }
1332                 else if (strEQ(name2, "RGVOUT")) {
1333                     GvMULTI_on(gv);
1334                 }
1335                 break;
1336             case 'E':
1337                 if (strnEQ(name2, "XPORT", 5))
1338                     GvMULTI_on(gv);
1339                 break;
1340             case 'I':
1341                 if (strEQ(name2, "SA")) {
1342                     gv_magicalize_isa(gv);
1343                 }
1344                 break;
1345             case 'O':
1346                 if (strEQ(name2, "VERLOAD")) {
1347                     gv_magicalize_overload(gv);
1348                 }
1349                 break;
1350             case 'S':
1351                 if (strEQ(name2, "IG")) {
1352                     HV *hv;
1353                     I32 i;
1354                     if (!PL_psig_name) {
1355                         Newxz(PL_psig_name, 2 * SIG_SIZE, SV*);
1356                         Newxz(PL_psig_pend, SIG_SIZE, int);
1357                         PL_psig_ptr = PL_psig_name + SIG_SIZE;
1358                     } else {
1359                         /* I think that the only way to get here is to re-use an
1360                            embedded perl interpreter, where the previous
1361                            use didn't clean up fully because
1362                            PL_perl_destruct_level was 0. I'm not sure that we
1363                            "support" that, in that I suspect in that scenario
1364                            there are sufficient other garbage values left in the
1365                            interpreter structure that something else will crash
1366                            before we get here. I suspect that this is one of
1367                            those "doctor, it hurts when I do this" bugs.  */
1368                         Zero(PL_psig_name, 2 * SIG_SIZE, SV*);
1369                         Zero(PL_psig_pend, SIG_SIZE, int);
1370                     }
1371                     GvMULTI_on(gv);
1372                     hv = GvHVn(gv);
1373                     hv_magic(hv, NULL, PERL_MAGIC_sig);
1374                     for (i = 1; i < SIG_SIZE; i++) {
1375                         SV * const * const init = hv_fetch(hv, PL_sig_name[i], strlen(PL_sig_name[i]), 1);
1376                         if (init)
1377                             sv_setsv(*init, &PL_sv_undef);
1378                     }
1379                 }
1380                 break;
1381             case 'V':
1382                 if (strEQ(name2, "ERSION"))
1383                     GvMULTI_on(gv);
1384                 break;
1385             case '\003':        /* $^CHILD_ERROR_NATIVE */
1386                 if (strEQ(name2, "HILD_ERROR_NATIVE"))
1387                     goto magicalize;
1388                 break;
1389             case '\005':        /* $^ENCODING */
1390                 if (strEQ(name2, "NCODING"))
1391                     goto magicalize;
1392                 break;
1393             case '\007':        /* $^GLOBAL_PHASE */
1394                 if (strEQ(name2, "LOBAL_PHASE"))
1395                     goto ro_magicalize;
1396                 break;
1397             case '\015':        /* $^MATCH */
1398                 if (strEQ(name2, "ATCH"))
1399                     goto magicalize;
1400             case '\017':        /* $^OPEN */
1401                 if (strEQ(name2, "PEN"))
1402                     goto magicalize;
1403                 break;
1404             case '\020':        /* $^PREMATCH  $^POSTMATCH */
1405                 if (strEQ(name2, "REMATCH") || strEQ(name2, "OSTMATCH"))
1406                     goto magicalize;
1407                 break;
1408             case '\024':        /* ${^TAINT} */
1409                 if (strEQ(name2, "AINT"))
1410                     goto ro_magicalize;
1411                 break;
1412             case '\025':        /* ${^UNICODE}, ${^UTF8LOCALE} */
1413                 if (strEQ(name2, "NICODE"))
1414                     goto ro_magicalize;
1415                 if (strEQ(name2, "TF8LOCALE"))
1416                     goto ro_magicalize;
1417                 if (strEQ(name2, "TF8CACHE"))
1418                     goto magicalize;
1419                 break;
1420             case '\027':        /* $^WARNING_BITS */
1421                 if (strEQ(name2, "ARNING_BITS"))
1422                     goto magicalize;
1423                 break;
1424             case '1':
1425             case '2':
1426             case '3':
1427             case '4':
1428             case '5':
1429             case '6':
1430             case '7':
1431             case '8':
1432             case '9':
1433             {
1434                 /* Ensures that we have an all-digit variable, ${"1foo"} fails
1435                    this test  */
1436                 /* This snippet is taken from is_gv_magical */
1437                 const char *end = name + len;
1438                 while (--end > name) {
1439                     if (!isDIGIT(*end)) return gv;
1440                 }
1441                 goto magicalize;
1442             }
1443             }
1444         }
1445     } else {
1446         /* Names of length 1.  (Or 0. But name is NUL terminated, so that will
1447            be case '\0' in this switch statement (ie a default case)  */
1448         switch (*name) {
1449         case '&':               /* $& */
1450         case '`':               /* $` */
1451         case '\'':              /* $' */
1452             if (
1453                 sv_type == SVt_PVAV ||
1454                 sv_type == SVt_PVHV ||
1455                 sv_type == SVt_PVCV ||
1456                 sv_type == SVt_PVFM ||
1457                 sv_type == SVt_PVIO
1458                 ) { break; }
1459             PL_sawampersand = TRUE;
1460             goto magicalize;
1461
1462         case ':':               /* $: */
1463             sv_setpv(GvSVn(gv),PL_chopset);
1464             goto magicalize;
1465
1466         case '?':               /* $? */
1467 #ifdef COMPLEX_STATUS
1468             SvUPGRADE(GvSVn(gv), SVt_PVLV);
1469 #endif
1470             goto magicalize;
1471
1472         case '!':               /* $! */
1473             GvMULTI_on(gv);
1474             /* If %! has been used, automatically load Errno.pm. */
1475
1476             sv_magic(GvSVn(gv), MUTABLE_SV(gv), PERL_MAGIC_sv, name, len);
1477
1478             /* magicalization must be done before require_tie_mod is called */
1479             if (sv_type == SVt_PVHV || sv_type == SVt_PVGV)
1480                 require_tie_mod(gv, "!", newSVpvs("Errno"), "TIEHASH", 1);
1481
1482             break;
1483         case '-':               /* $- */
1484         case '+':               /* $+ */
1485         GvMULTI_on(gv); /* no used once warnings here */
1486         {
1487             AV* const av = GvAVn(gv);
1488             SV* const avc = (*name == '+') ? MUTABLE_SV(av) : NULL;
1489
1490             sv_magic(MUTABLE_SV(av), avc, PERL_MAGIC_regdata, NULL, 0);
1491             sv_magic(GvSVn(gv), MUTABLE_SV(gv), PERL_MAGIC_sv, name, len);
1492             if (avc)
1493                 SvREADONLY_on(GvSVn(gv));
1494             SvREADONLY_on(av);
1495
1496             if (sv_type == SVt_PVHV || sv_type == SVt_PVGV)
1497                 require_tie_mod(gv, name, newSVpvs("Tie::Hash::NamedCapture"), "TIEHASH", 0);
1498
1499             break;
1500         }
1501         case '*':               /* $* */
1502         case '#':               /* $# */
1503             if (sv_type == SVt_PV)
1504                 Perl_ck_warner_d(aTHX_ packWARN2(WARN_DEPRECATED, WARN_SYNTAX),
1505                                  "$%c is no longer supported", *name);
1506             break;
1507         case '|':               /* $| */
1508             sv_setiv(GvSVn(gv), (IV)(IoFLAGS(GvIOp(PL_defoutgv)) & IOf_FLUSH) != 0);
1509             goto magicalize;
1510
1511         case '\010':    /* $^H */
1512             {
1513                 HV *const hv = GvHVn(gv);
1514                 hv_magic(hv, NULL, PERL_MAGIC_hints);
1515             }
1516             goto magicalize;
1517         case '\023':    /* $^S */
1518         ro_magicalize:
1519             SvREADONLY_on(GvSVn(gv));
1520             /* FALL THROUGH */
1521         case '0':               /* $0 */
1522         case '1':               /* $1 */
1523         case '2':               /* $2 */
1524         case '3':               /* $3 */
1525         case '4':               /* $4 */
1526         case '5':               /* $5 */
1527         case '6':               /* $6 */
1528         case '7':               /* $7 */
1529         case '8':               /* $8 */
1530         case '9':               /* $9 */
1531         case '[':               /* $[ */
1532         case '^':               /* $^ */
1533         case '~':               /* $~ */
1534         case '=':               /* $= */
1535         case '%':               /* $% */
1536         case '.':               /* $. */
1537         case '(':               /* $( */
1538         case ')':               /* $) */
1539         case '<':               /* $< */
1540         case '>':               /* $> */
1541         case '\\':              /* $\ */
1542         case '/':               /* $/ */
1543         case '\001':    /* $^A */
1544         case '\003':    /* $^C */
1545         case '\004':    /* $^D */
1546         case '\005':    /* $^E */
1547         case '\006':    /* $^F */
1548         case '\011':    /* $^I, NOT \t in EBCDIC */
1549         case '\016':    /* $^N */
1550         case '\017':    /* $^O */
1551         case '\020':    /* $^P */
1552         case '\024':    /* $^T */
1553         case '\027':    /* $^W */
1554         magicalize:
1555             sv_magic(GvSVn(gv), MUTABLE_SV(gv), PERL_MAGIC_sv, name, len);
1556             break;
1557
1558         case '\014':    /* $^L */
1559             sv_setpvs(GvSVn(gv),"\f");
1560             PL_formfeed = GvSVn(gv);
1561             break;
1562         case ';':               /* $; */
1563             sv_setpvs(GvSVn(gv),"\034");
1564             break;
1565         case ']':               /* $] */
1566         {
1567             SV * const sv = GvSVn(gv);
1568             if (!sv_derived_from(PL_patchlevel, "version"))
1569                 upg_version(PL_patchlevel, TRUE);
1570             GvSV(gv) = vnumify(PL_patchlevel);
1571             SvREADONLY_on(GvSV(gv));
1572             SvREFCNT_dec(sv);
1573         }
1574         break;
1575         case '\026':    /* $^V */
1576         {
1577             SV * const sv = GvSVn(gv);
1578             GvSV(gv) = new_version(PL_patchlevel);
1579             SvREADONLY_on(GvSV(gv));
1580             SvREFCNT_dec(sv);
1581         }
1582         break;
1583         }
1584     }
1585     return gv;
1586 }
1587
1588 void
1589 Perl_gv_fullname4(pTHX_ SV *sv, const GV *gv, const char *prefix, bool keepmain)
1590 {
1591     const char *name;
1592     STRLEN namelen;
1593     const HV * const hv = GvSTASH(gv);
1594
1595     PERL_ARGS_ASSERT_GV_FULLNAME4;
1596
1597     if (!hv) {
1598         SvOK_off(sv);
1599         return;
1600     }
1601     sv_setpv(sv, prefix ? prefix : "");
1602
1603     name = HvNAME_get(hv);
1604     if (name) {
1605         namelen = HvNAMELEN_get(hv);
1606     } else {
1607         name = "__ANON__";
1608         namelen = 8;
1609     }
1610
1611     if (keepmain || strNE(name, "main")) {
1612         sv_catpvn(sv,name,namelen);
1613         sv_catpvs(sv,"::");
1614     }
1615     sv_catpvn(sv,GvNAME(gv),GvNAMELEN(gv));
1616 }
1617
1618 void
1619 Perl_gv_efullname4(pTHX_ SV *sv, const GV *gv, const char *prefix, bool keepmain)
1620 {
1621     const GV * const egv = GvEGVx(gv);
1622
1623     PERL_ARGS_ASSERT_GV_EFULLNAME4;
1624
1625     gv_fullname4(sv, egv ? egv : gv, prefix, keepmain);
1626 }
1627
1628 void
1629 Perl_gv_check(pTHX_ const HV *stash)
1630 {
1631     dVAR;
1632     register I32 i;
1633
1634     PERL_ARGS_ASSERT_GV_CHECK;
1635
1636     if (!HvARRAY(stash))
1637         return;
1638     for (i = 0; i <= (I32) HvMAX(stash); i++) {
1639         const HE *entry;
1640         for (entry = HvARRAY(stash)[i]; entry; entry = HeNEXT(entry)) {
1641             register GV *gv;
1642             HV *hv;
1643             if (HeKEY(entry)[HeKLEN(entry)-1] == ':' &&
1644                 (gv = MUTABLE_GV(HeVAL(entry))) && isGV(gv) && (hv = GvHV(gv)))
1645             {
1646                 if (hv != PL_defstash && hv != stash)
1647                      gv_check(hv);              /* nested package */
1648             }
1649             else if (isALPHA(*HeKEY(entry))) {
1650                 const char *file;
1651                 gv = MUTABLE_GV(HeVAL(entry));
1652                 if (SvTYPE(gv) != SVt_PVGV || GvMULTI(gv))
1653                     continue;
1654                 file = GvFILE(gv);
1655                 CopLINE_set(PL_curcop, GvLINE(gv));
1656 #ifdef USE_ITHREADS
1657                 CopFILE(PL_curcop) = (char *)file;      /* set for warning */
1658 #else
1659                 CopFILEGV(PL_curcop)
1660                     = gv_fetchfile_flags(file, HEK_LEN(GvFILE_HEK(gv)), 0);
1661 #endif
1662                 Perl_warner(aTHX_ packWARN(WARN_ONCE),
1663                         "Name \"%s::%s\" used only once: possible typo",
1664                         HvNAME_get(stash), GvNAME(gv));
1665             }
1666         }
1667     }
1668 }
1669
1670 GV *
1671 Perl_newGVgen(pTHX_ const char *pack)
1672 {
1673     dVAR;
1674
1675     PERL_ARGS_ASSERT_NEWGVGEN;
1676
1677     return gv_fetchpv(Perl_form(aTHX_ "%s::_GEN_%ld", pack, (long)PL_gensym++),
1678                       GV_ADD, SVt_PVGV);
1679 }
1680
1681 /* hopefully this is only called on local symbol table entries */
1682
1683 GP*
1684 Perl_gp_ref(pTHX_ GP *gp)
1685 {
1686     dVAR;
1687     if (!gp)
1688         return NULL;
1689     gp->gp_refcnt++;
1690     if (gp->gp_cv) {
1691         if (gp->gp_cvgen) {
1692             /* If the GP they asked for a reference to contains
1693                a method cache entry, clear it first, so that we
1694                don't infect them with our cached entry */
1695             SvREFCNT_dec(gp->gp_cv);
1696             gp->gp_cv = NULL;
1697             gp->gp_cvgen = 0;
1698         }
1699     }
1700     return gp;
1701 }
1702
1703 void
1704 Perl_gp_free(pTHX_ GV *gv)
1705 {
1706     dVAR;
1707     GP* gp;
1708     int attempts = 100;
1709
1710     if (!gv || !isGV_with_GP(gv) || !(gp = GvGP(gv)))
1711         return;
1712     if (gp->gp_refcnt == 0) {
1713         Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL),
1714                          "Attempt to free unreferenced glob pointers"
1715                          pTHX__FORMAT pTHX__VALUE);
1716         return;
1717     }
1718     if (--gp->gp_refcnt > 0) {
1719         if (gp->gp_egv == gv)
1720             gp->gp_egv = 0;
1721         GvGP_set(gv, NULL);
1722         return;
1723     }
1724
1725     while (1) {
1726       /* Copy and null out all the glob slots, so destructors do not see
1727          freed SVs. */
1728       HEK * const file_hek = gp->gp_file_hek;
1729       SV  * const sv       = gp->gp_sv;
1730       AV  * const av       = gp->gp_av;
1731       HV  * const hv       = gp->gp_hv;
1732       IO  * const io       = gp->gp_io;
1733       CV  * const cv       = gp->gp_cv;
1734       CV  * const form     = gp->gp_form;
1735
1736       gp->gp_file_hek = NULL;
1737       gp->gp_sv       = NULL;
1738       gp->gp_av       = NULL;
1739       gp->gp_hv       = NULL;
1740       gp->gp_io       = NULL;
1741       gp->gp_cv       = NULL;
1742       gp->gp_form     = NULL;
1743
1744       if (file_hek)
1745         unshare_hek(file_hek);
1746
1747       SvREFCNT_dec(sv);
1748       SvREFCNT_dec(av);
1749       /* FIXME - another reference loop GV -> symtab -> GV ?
1750          Somehow gp->gp_hv can end up pointing at freed garbage.  */
1751       if (hv && SvTYPE(hv) == SVt_PVHV) {
1752         const char *hvname = HvNAME_get(hv);
1753         if (PL_stashcache && hvname)
1754             (void)hv_delete(PL_stashcache, hvname, HvNAMELEN_get(hv),
1755                       G_DISCARD);
1756         SvREFCNT_dec(hv);
1757       }
1758       SvREFCNT_dec(io);
1759       SvREFCNT_dec(cv);
1760       SvREFCNT_dec(form);
1761
1762       if (!gp->gp_file_hek
1763        && !gp->gp_sv
1764        && !gp->gp_av
1765        && !gp->gp_hv
1766        && !gp->gp_io
1767        && !gp->gp_cv
1768        && !gp->gp_form) break;
1769
1770       if (--attempts == 0) {
1771         Perl_die(aTHX_
1772           "panic: gp_free failed to free glob pointer - "
1773           "something is repeatedly re-creating entries"
1774         );
1775       }
1776     }
1777
1778     Safefree(gp);
1779     GvGP_set(gv, NULL);
1780 }
1781
1782 int
1783 Perl_magic_freeovrld(pTHX_ SV *sv, MAGIC *mg)
1784 {
1785     AMT * const amtp = (AMT*)mg->mg_ptr;
1786     PERL_UNUSED_ARG(sv);
1787
1788     PERL_ARGS_ASSERT_MAGIC_FREEOVRLD;
1789
1790     if (amtp && AMT_AMAGIC(amtp)) {
1791         int i;
1792         for (i = 1; i < NofAMmeth; i++) {
1793             CV * const cv = amtp->table[i];
1794             if (cv) {
1795                 SvREFCNT_dec(MUTABLE_SV(cv));
1796                 amtp->table[i] = NULL;
1797             }
1798         }
1799     }
1800  return 0;
1801 }
1802
1803 /* Updates and caches the CV's */
1804 /* Returns:
1805  * 1 on success and there is some overload
1806  * 0 if there is no overload
1807  * -1 if some error occurred and it couldn't croak
1808  */
1809
1810 int
1811 Perl_Gv_AMupdate(pTHX_ HV *stash, bool destructing)
1812 {
1813   dVAR;
1814   MAGIC* const mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table);
1815   AMT amt;
1816   const struct mro_meta* stash_meta = HvMROMETA(stash);
1817   U32 newgen;
1818
1819   PERL_ARGS_ASSERT_GV_AMUPDATE;
1820
1821   newgen = PL_sub_generation + stash_meta->pkg_gen + stash_meta->cache_gen;
1822   if (mg) {
1823       const AMT * const amtp = (AMT*)mg->mg_ptr;
1824       if (amtp->was_ok_am == PL_amagic_generation
1825           && amtp->was_ok_sub == newgen) {
1826           return AMT_OVERLOADED(amtp) ? 1 : 0;
1827       }
1828       sv_unmagic(MUTABLE_SV(stash), PERL_MAGIC_overload_table);
1829   }
1830
1831   DEBUG_o( Perl_deb(aTHX_ "Recalcing overload magic in package %s\n",HvNAME_get(stash)) );
1832
1833   Zero(&amt,1,AMT);
1834   amt.was_ok_am = PL_amagic_generation;
1835   amt.was_ok_sub = newgen;
1836   amt.fallback = AMGfallNO;
1837   amt.flags = 0;
1838
1839   {
1840     int filled = 0, have_ovl = 0;
1841     int i, lim = 1;
1842
1843     /* Work with "fallback" key, which we assume to be first in PL_AMG_names */
1844
1845     /* Try to find via inheritance. */
1846     GV *gv = gv_fetchmeth(stash, PL_AMG_names[0], 2, -1);
1847     SV * const sv = gv ? GvSV(gv) : NULL;
1848     CV* cv;
1849
1850     if (!gv)
1851         lim = DESTROY_amg;              /* Skip overloading entries. */
1852 #ifdef PERL_DONT_CREATE_GVSV
1853     else if (!sv) {
1854         NOOP;   /* Equivalent to !SvTRUE and !SvOK  */
1855     }
1856 #endif
1857     else if (SvTRUE(sv))
1858         amt.fallback=AMGfallYES;
1859     else if (SvOK(sv))
1860         amt.fallback=AMGfallNEVER;
1861
1862     for (i = 1; i < lim; i++)
1863         amt.table[i] = NULL;
1864     for (; i < NofAMmeth; i++) {
1865         const char * const cooky = PL_AMG_names[i];
1866         /* Human-readable form, for debugging: */
1867         const char * const cp = (i >= DESTROY_amg ? cooky : AMG_id2name(i));
1868         const STRLEN l = PL_AMG_namelens[i];
1869
1870         DEBUG_o( Perl_deb(aTHX_ "Checking overloading of \"%s\" in package \"%.256s\"\n",
1871                      cp, HvNAME_get(stash)) );
1872         /* don't fill the cache while looking up!
1873            Creation of inheritance stubs in intermediate packages may
1874            conflict with the logic of runtime method substitution.
1875            Indeed, for inheritance A -> B -> C, if C overloads "+0",
1876            then we could have created stubs for "(+0" in A and C too.
1877            But if B overloads "bool", we may want to use it for
1878            numifying instead of C's "+0". */
1879         if (i >= DESTROY_amg)
1880             gv = Perl_gv_fetchmeth_autoload(aTHX_ stash, cooky, l, 0);
1881         else                            /* Autoload taken care of below */
1882             gv = Perl_gv_fetchmeth(aTHX_ stash, cooky, l, -1);
1883         cv = 0;
1884         if (gv && (cv = GvCV(gv))) {
1885             const char *hvname;
1886             if (GvNAMELEN(CvGV(cv)) == 3 && strEQ(GvNAME(CvGV(cv)), "nil")
1887                 && strEQ(hvname = HvNAME_get(GvSTASH(CvGV(cv))), "overload")) {
1888                 /* This is a hack to support autoloading..., while
1889                    knowing *which* methods were declared as overloaded. */
1890                 /* GvSV contains the name of the method. */
1891                 GV *ngv = NULL;
1892                 SV *gvsv = GvSV(gv);
1893
1894                 DEBUG_o( Perl_deb(aTHX_ "Resolving method \"%"SVf256\
1895                         "\" for overloaded \"%s\" in package \"%.256s\"\n",
1896                              (void*)GvSV(gv), cp, hvname) );
1897                 if (!gvsv || !SvPOK(gvsv)
1898                     || !(ngv = gv_fetchmethod_autoload(stash, SvPVX_const(gvsv),
1899                                                        FALSE)))
1900                 {
1901                     /* Can be an import stub (created by "can"). */
1902                     if (destructing) {
1903                         return -1;
1904                     }
1905                     else {
1906                         const char * const name = (gvsv && SvPOK(gvsv)) ?  SvPVX_const(gvsv) : "???";
1907                         Perl_croak(aTHX_ "%s method \"%.256s\" overloading \"%s\" "\
1908                                     "in package \"%.256s\"",
1909                                    (GvCVGEN(gv) ? "Stub found while resolving"
1910                                     : "Can't resolve"),
1911                                    name, cp, hvname);
1912                     }
1913                 }
1914                 cv = GvCV(gv = ngv);
1915             }
1916             DEBUG_o( Perl_deb(aTHX_ "Overloading \"%s\" in package \"%.256s\" via \"%.256s::%.256s\"\n",
1917                          cp, HvNAME_get(stash), HvNAME_get(GvSTASH(CvGV(cv))),
1918                          GvNAME(CvGV(cv))) );
1919             filled = 1;
1920             if (i < DESTROY_amg)
1921                 have_ovl = 1;
1922         } else if (gv) {                /* Autoloaded... */
1923             cv = MUTABLE_CV(gv);
1924             filled = 1;
1925         }
1926         amt.table[i]=MUTABLE_CV(SvREFCNT_inc_simple(cv));
1927     }
1928     if (filled) {
1929       AMT_AMAGIC_on(&amt);
1930       if (have_ovl)
1931           AMT_OVERLOADED_on(&amt);
1932       sv_magic(MUTABLE_SV(stash), 0, PERL_MAGIC_overload_table,
1933                                                 (char*)&amt, sizeof(AMT));
1934       return have_ovl;
1935     }
1936   }
1937   /* Here we have no table: */
1938   /* no_table: */
1939   AMT_AMAGIC_off(&amt);
1940   sv_magic(MUTABLE_SV(stash), 0, PERL_MAGIC_overload_table,
1941                                                 (char*)&amt, sizeof(AMTS));
1942   return 0;
1943 }
1944
1945
1946 CV*
1947 Perl_gv_handler(pTHX_ HV *stash, I32 id)
1948 {
1949     dVAR;
1950     MAGIC *mg;
1951     AMT *amtp;
1952     U32 newgen;
1953     struct mro_meta* stash_meta;
1954
1955     if (!stash || !HvNAME_get(stash))
1956         return NULL;
1957
1958     stash_meta = HvMROMETA(stash);
1959     newgen = PL_sub_generation + stash_meta->pkg_gen + stash_meta->cache_gen;
1960
1961     mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table);
1962     if (!mg) {
1963       do_update:
1964         /* If we're looking up a destructor to invoke, we must avoid
1965          * that Gv_AMupdate croaks, because we might be dying already */
1966         if (Gv_AMupdate(stash, cBOOL(id == DESTROY_amg)) == -1) {
1967             /* and if it didn't found a destructor, we fall back
1968              * to a simpler method that will only look for the
1969              * destructor instead of the whole magic */
1970             if (id == DESTROY_amg) {
1971                 GV * const gv = gv_fetchmethod(stash, "DESTROY");
1972                 if (gv)
1973                     return GvCV(gv);
1974             }
1975             return NULL;
1976         }
1977         mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table);
1978     }
1979     assert(mg);
1980     amtp = (AMT*)mg->mg_ptr;
1981     if ( amtp->was_ok_am != PL_amagic_generation
1982          || amtp->was_ok_sub != newgen )
1983         goto do_update;
1984     if (AMT_AMAGIC(amtp)) {
1985         CV * const ret = amtp->table[id];
1986         if (ret && isGV(ret)) {         /* Autoloading stab */
1987             /* Passing it through may have resulted in a warning
1988                "Inherited AUTOLOAD for a non-method deprecated", since
1989                our caller is going through a function call, not a method call.
1990                So return the CV for AUTOLOAD, setting $AUTOLOAD. */
1991             GV * const gv = gv_fetchmethod(stash, PL_AMG_names[id]);
1992
1993             if (gv && GvCV(gv))
1994                 return GvCV(gv);
1995         }
1996         return ret;
1997     }
1998
1999     return NULL;
2000 }
2001
2002
2003 /* Implement tryAMAGICun_MG macro.
2004    Do get magic, then see if the stack arg is overloaded and if so call it.
2005    Flags:
2006         AMGf_set     return the arg using SETs rather than assigning to
2007                      the targ
2008         AMGf_numeric apply sv_2num to the stack arg.
2009 */
2010
2011 bool
2012 Perl_try_amagic_un(pTHX_ int method, int flags) {
2013     dVAR;
2014     dSP;
2015     SV* tmpsv;
2016     SV* const arg = TOPs;
2017
2018     SvGETMAGIC(arg);
2019
2020     if (SvAMAGIC(arg) && (tmpsv = amagic_call(arg, &PL_sv_undef, method,
2021                                               AMGf_noright | AMGf_unary))) {
2022         if (flags & AMGf_set) {
2023             SETs(tmpsv);
2024         }
2025         else {
2026             dTARGET;
2027             if (SvPADMY(TARG)) {
2028                 sv_setsv(TARG, tmpsv);
2029                 SETTARG;
2030             }
2031             else
2032                 SETs(tmpsv);
2033         }
2034         PUTBACK;
2035         return TRUE;
2036     }
2037
2038     if ((flags & AMGf_numeric) && SvROK(arg))
2039         *sp = sv_2num(arg);
2040     return FALSE;
2041 }
2042
2043
2044 /* Implement tryAMAGICbin_MG macro.
2045    Do get magic, then see if the two stack args are overloaded and if so
2046    call it.
2047    Flags:
2048         AMGf_set     return the arg using SETs rather than assigning to
2049                      the targ
2050         AMGf_assign  op may be called as mutator (eg +=)
2051         AMGf_numeric apply sv_2num to the stack arg.
2052 */
2053
2054 bool
2055 Perl_try_amagic_bin(pTHX_ int method, int flags) {
2056     dVAR;
2057     dSP;
2058     SV* const left = TOPm1s;
2059     SV* const right = TOPs;
2060
2061     SvGETMAGIC(left);
2062     if (left != right)
2063         SvGETMAGIC(right);
2064
2065     if (SvAMAGIC(left) || SvAMAGIC(right)) {
2066         SV * const tmpsv = amagic_call(left, right, method,
2067                     ((flags & AMGf_assign) && opASSIGN ? AMGf_assign: 0));
2068         if (tmpsv) {
2069             if (flags & AMGf_set) {
2070                 (void)POPs;
2071                 SETs(tmpsv);
2072             }
2073             else {
2074                 dATARGET;
2075                 (void)POPs;
2076                 if (opASSIGN || SvPADMY(TARG)) {
2077                     sv_setsv(TARG, tmpsv);
2078                     SETTARG;
2079                 }
2080                 else
2081                     SETs(tmpsv);
2082             }
2083             PUTBACK;
2084             return TRUE;
2085         }
2086     }
2087     if(left==right && SvGMAGICAL(left)) {
2088         SV * const left = sv_newmortal();
2089         *(sp-1) = left;
2090         /* Print the uninitialized warning now, so it includes the vari-
2091            able name. */
2092         if (!SvOK(right)) {
2093             if (ckWARN(WARN_UNINITIALIZED)) report_uninit(right);
2094             sv_setsv_flags(left, &PL_sv_no, 0);
2095         }
2096         else sv_setsv_flags(left, right, 0);
2097         SvGETMAGIC(right);
2098     }
2099     if (flags & AMGf_numeric) {
2100         if (SvROK(TOPm1s))
2101             *(sp-1) = sv_2num(TOPm1s);
2102         if (SvROK(right))
2103             *sp     = sv_2num(right);
2104     }
2105     return FALSE;
2106 }
2107
2108 SV *
2109 Perl_amagic_deref_call(pTHX_ SV *ref, int method) {
2110     SV *tmpsv = NULL;
2111
2112     PERL_ARGS_ASSERT_AMAGIC_DEREF_CALL;
2113
2114     while (SvAMAGIC(ref) && 
2115            (tmpsv = amagic_call(ref, &PL_sv_undef, method,
2116                                 AMGf_noright | AMGf_unary))) { 
2117         if (!SvROK(tmpsv))
2118             Perl_croak(aTHX_ "Overloaded dereference did not return a reference");
2119         if (tmpsv == ref || SvRV(tmpsv) == SvRV(ref)) {
2120             /* Bail out if it returns us the same reference.  */
2121             return tmpsv;
2122         }
2123         ref = tmpsv;
2124     }
2125     return tmpsv ? tmpsv : ref;
2126 }
2127
2128 SV*
2129 Perl_amagic_call(pTHX_ SV *left, SV *right, int method, int flags)
2130 {
2131   dVAR;
2132   MAGIC *mg;
2133   CV *cv=NULL;
2134   CV **cvp=NULL, **ocvp=NULL;
2135   AMT *amtp=NULL, *oamtp=NULL;
2136   int off = 0, off1, lr = 0, notfound = 0;
2137   int postpr = 0, force_cpy = 0;
2138   int assign = AMGf_assign & flags;
2139   const int assignshift = assign ? 1 : 0;
2140   int use_default_op = 0;
2141 #ifdef DEBUGGING
2142   int fl=0;
2143 #endif
2144   HV* stash=NULL;
2145
2146   PERL_ARGS_ASSERT_AMAGIC_CALL;
2147
2148   if ( PL_curcop->cop_hints & HINT_NO_AMAGIC ) {
2149       SV *lex_mask = cop_hints_fetch_pvs(PL_curcop, "overloading", 0);
2150
2151       if ( !lex_mask || !SvOK(lex_mask) )
2152           /* overloading lexically disabled */
2153           return NULL;
2154       else if ( lex_mask && SvPOK(lex_mask) ) {
2155           /* we have an entry in the hints hash, check if method has been
2156            * masked by overloading.pm */
2157           STRLEN len;
2158           const int offset = method / 8;
2159           const int bit    = method % 8;
2160           char *pv = SvPV(lex_mask, len);
2161
2162           /* Bit set, so this overloading operator is disabled */
2163           if ( (STRLEN)offset < len && pv[offset] & ( 1 << bit ) )
2164               return NULL;
2165       }
2166   }
2167
2168   if (!(AMGf_noleft & flags) && SvAMAGIC(left)
2169       && (stash = SvSTASH(SvRV(left)))
2170       && (mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table))
2171       && (ocvp = cvp = (AMT_AMAGIC((AMT*)mg->mg_ptr)
2172                         ? (oamtp = amtp = (AMT*)mg->mg_ptr)->table
2173                         : NULL))
2174       && ((cv = cvp[off=method+assignshift])
2175           || (assign && amtp->fallback > AMGfallNEVER && /* fallback to
2176                                                           * usual method */
2177                   (
2178 #ifdef DEBUGGING
2179                    fl = 1,
2180 #endif
2181                    cv = cvp[off=method])))) {
2182     lr = -1;                    /* Call method for left argument */
2183   } else {
2184     if (cvp && amtp->fallback > AMGfallNEVER && flags & AMGf_unary) {
2185       int logic;
2186
2187       /* look for substituted methods */
2188       /* In all the covered cases we should be called with assign==0. */
2189          switch (method) {
2190          case inc_amg:
2191            force_cpy = 1;
2192            if ((cv = cvp[off=add_ass_amg])
2193                || ((cv = cvp[off = add_amg]) && (force_cpy = 0, postpr = 1))) {
2194              right = &PL_sv_yes; lr = -1; assign = 1;
2195            }
2196            break;
2197          case dec_amg:
2198            force_cpy = 1;
2199            if ((cv = cvp[off = subtr_ass_amg])
2200                || ((cv = cvp[off = subtr_amg]) && (force_cpy = 0, postpr=1))) {
2201              right = &PL_sv_yes; lr = -1; assign = 1;
2202            }
2203            break;
2204          case bool__amg:
2205            (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=string_amg]));
2206            break;
2207          case numer_amg:
2208            (void)((cv = cvp[off=string_amg]) || (cv = cvp[off=bool__amg]));
2209            break;
2210          case string_amg:
2211            (void)((cv = cvp[off=numer_amg]) || (cv = cvp[off=bool__amg]));
2212            break;
2213          case not_amg:
2214            (void)((cv = cvp[off=bool__amg])
2215                   || (cv = cvp[off=numer_amg])
2216                   || (cv = cvp[off=string_amg]));
2217            if (cv)
2218                postpr = 1;
2219            break;
2220          case copy_amg:
2221            {
2222              /*
2223                   * SV* ref causes confusion with the interpreter variable of
2224                   * the same name
2225                   */
2226              SV* const tmpRef=SvRV(left);
2227              if (!SvROK(tmpRef) && SvTYPE(tmpRef) <= SVt_PVMG) {
2228                 /*
2229                  * Just to be extra cautious.  Maybe in some
2230                  * additional cases sv_setsv is safe, too.
2231                  */
2232                 SV* const newref = newSVsv(tmpRef);
2233                 SvOBJECT_on(newref);
2234                 /* As a bit of a source compatibility hack, SvAMAGIC() and
2235                    friends dereference an RV, to behave the same was as when
2236                    overloading was stored on the reference, not the referant.
2237                    Hence we can't use SvAMAGIC_on()
2238                 */
2239                 SvFLAGS(newref) |= SVf_AMAGIC;
2240                 SvSTASH_set(newref, MUTABLE_HV(SvREFCNT_inc(SvSTASH(tmpRef))));
2241                 return newref;
2242              }
2243            }
2244            break;
2245          case abs_amg:
2246            if ((cvp[off1=lt_amg] || cvp[off1=ncmp_amg])
2247                && ((cv = cvp[off=neg_amg]) || (cv = cvp[off=subtr_amg]))) {
2248              SV* const nullsv=sv_2mortal(newSViv(0));
2249              if (off1==lt_amg) {
2250                SV* const lessp = amagic_call(left,nullsv,
2251                                        lt_amg,AMGf_noright);
2252                logic = SvTRUE(lessp);
2253              } else {
2254                SV* const lessp = amagic_call(left,nullsv,
2255                                        ncmp_amg,AMGf_noright);
2256                logic = (SvNV(lessp) < 0);
2257              }
2258              if (logic) {
2259                if (off==subtr_amg) {
2260                  right = left;
2261                  left = nullsv;
2262                  lr = 1;
2263                }
2264              } else {
2265                return left;
2266              }
2267            }
2268            break;
2269          case neg_amg:
2270            if ((cv = cvp[off=subtr_amg])) {
2271              right = left;
2272              left = sv_2mortal(newSViv(0));
2273              lr = 1;
2274            }
2275            break;
2276          case int_amg:
2277          case iter_amg:                 /* XXXX Eventually should do to_gv. */
2278          case ftest_amg:                /* XXXX Eventually should do to_gv. */
2279          case regexp_amg:
2280              /* FAIL safe */
2281              return NULL;       /* Delegate operation to standard mechanisms. */
2282              break;
2283          case to_sv_amg:
2284          case to_av_amg:
2285          case to_hv_amg:
2286          case to_gv_amg:
2287          case to_cv_amg:
2288              /* FAIL safe */
2289              return left;       /* Delegate operation to standard mechanisms. */
2290              break;
2291          default:
2292            goto not_found;
2293          }
2294          if (!cv) goto not_found;
2295     } else if (!(AMGf_noright & flags) && SvAMAGIC(right)
2296                && (stash = SvSTASH(SvRV(right)))
2297                && (mg = mg_find((const SV *)stash, PERL_MAGIC_overload_table))
2298                && (cvp = (AMT_AMAGIC((AMT*)mg->mg_ptr)
2299                           ? (amtp = (AMT*)mg->mg_ptr)->table
2300                           : NULL))
2301                && (cv = cvp[off=method])) { /* Method for right
2302                                              * argument found */
2303       lr=1;
2304     } else if (((cvp && amtp->fallback > AMGfallNEVER)
2305                 || (ocvp && oamtp->fallback > AMGfallNEVER))
2306                && !(flags & AMGf_unary)) {
2307                                 /* We look for substitution for
2308                                  * comparison operations and
2309                                  * concatenation */
2310       if (method==concat_amg || method==concat_ass_amg
2311           || method==repeat_amg || method==repeat_ass_amg) {
2312         return NULL;            /* Delegate operation to string conversion */
2313       }
2314       off = -1;
2315       switch (method) {
2316          case lt_amg:
2317          case le_amg:
2318          case gt_amg:
2319          case ge_amg:
2320          case eq_amg:
2321          case ne_amg:
2322              off = ncmp_amg;
2323              break;
2324          case slt_amg:
2325          case sle_amg:
2326          case sgt_amg:
2327          case sge_amg:
2328          case seq_amg:
2329          case sne_amg:
2330              off = scmp_amg;
2331              break;
2332          }
2333       if (off != -1) {
2334           if (ocvp && (oamtp->fallback > AMGfallNEVER)) {
2335               cv = ocvp[off];
2336               lr = -1;
2337           }
2338           if (!cv && (cvp && amtp->fallback > AMGfallNEVER)) {
2339               cv = cvp[off];
2340               lr = 1;
2341           }
2342       }
2343       if (cv)
2344           postpr = 1;
2345       else
2346           goto not_found;
2347     } else {
2348     not_found:                  /* No method found, either report or croak */
2349       switch (method) {
2350          case to_sv_amg:
2351          case to_av_amg:
2352          case to_hv_amg:
2353          case to_gv_amg:
2354          case to_cv_amg:
2355              /* FAIL safe */
2356              return left;       /* Delegate operation to standard mechanisms. */
2357              break;
2358       }
2359       if (ocvp && (cv=ocvp[nomethod_amg])) { /* Call report method */
2360         notfound = 1; lr = -1;
2361       } else if (cvp && (cv=cvp[nomethod_amg])) {
2362         notfound = 1; lr = 1;
2363       } else if ((use_default_op =
2364                   (!ocvp || oamtp->fallback >= AMGfallYES)
2365                   && (!cvp || amtp->fallback >= AMGfallYES))
2366                  && !DEBUG_o_TEST) {
2367         /* Skip generating the "no method found" message.  */
2368         return NULL;
2369       } else {
2370         SV *msg;
2371         if (off==-1) off=method;
2372         msg = sv_2mortal(Perl_newSVpvf(aTHX_
2373                       "Operation \"%s\": no method found,%sargument %s%s%s%s",
2374                       AMG_id2name(method + assignshift),
2375                       (flags & AMGf_unary ? " " : "\n\tleft "),
2376                       SvAMAGIC(left)?
2377                         "in overloaded package ":
2378                         "has no overloaded magic",
2379                       SvAMAGIC(left)?
2380                         HvNAME_get(SvSTASH(SvRV(left))):
2381                         "",
2382                       SvAMAGIC(right)?
2383                         ",\n\tright argument in overloaded package ":
2384                         (flags & AMGf_unary
2385                          ? ""
2386                          : ",\n\tright argument has no overloaded magic"),
2387                       SvAMAGIC(right)?
2388                         HvNAME_get(SvSTASH(SvRV(right))):
2389                         ""));
2390         if (use_default_op) {
2391           DEBUG_o( Perl_deb(aTHX_ "%s", SvPVX_const(msg)) );
2392         } else {
2393           Perl_croak(aTHX_ "%"SVf, SVfARG(msg));
2394         }
2395         return NULL;
2396       }
2397       force_cpy = force_cpy || assign;
2398     }
2399   }
2400 #ifdef DEBUGGING
2401   if (!notfound) {
2402     DEBUG_o(Perl_deb(aTHX_
2403                      "Overloaded operator \"%s\"%s%s%s:\n\tmethod%s found%s in package %s%s\n",
2404                      AMG_id2name(off),
2405                      method+assignshift==off? "" :
2406                      " (initially \"",
2407                      method+assignshift==off? "" :
2408                      AMG_id2name(method+assignshift),
2409                      method+assignshift==off? "" : "\")",
2410                      flags & AMGf_unary? "" :
2411                      lr==1 ? " for right argument": " for left argument",
2412                      flags & AMGf_unary? " for argument" : "",
2413                      stash ? HvNAME_get(stash) : "null",
2414                      fl? ",\n\tassignment variant used": "") );
2415   }
2416 #endif
2417     /* Since we use shallow copy during assignment, we need
2418      * to dublicate the contents, probably calling user-supplied
2419      * version of copy operator
2420      */
2421     /* We need to copy in following cases:
2422      * a) Assignment form was called.
2423      *          assignshift==1,  assign==T, method + 1 == off
2424      * b) Increment or decrement, called directly.
2425      *          assignshift==0,  assign==0, method + 0 == off
2426      * c) Increment or decrement, translated to assignment add/subtr.
2427      *          assignshift==0,  assign==T,
2428      *          force_cpy == T
2429      * d) Increment or decrement, translated to nomethod.
2430      *          assignshift==0,  assign==0,
2431      *          force_cpy == T
2432      * e) Assignment form translated to nomethod.
2433      *          assignshift==1,  assign==T, method + 1 != off
2434      *          force_cpy == T
2435      */
2436     /*  off is method, method+assignshift, or a result of opcode substitution.
2437      *  In the latter case assignshift==0, so only notfound case is important.
2438      */
2439   if (( (method + assignshift == off)
2440         && (assign || (method == inc_amg) || (method == dec_amg)))
2441       || force_cpy)
2442   {
2443       /* newSVsv does not behave as advertised, so we copy missing
2444        * information by hand */
2445       SV *tmpRef = SvRV(left);
2446       SV *rv_copy;
2447       if (SvREFCNT(tmpRef) > 1 && (rv_copy = AMG_CALLunary(left,copy_amg))) {
2448           SvRV_set(left, rv_copy);
2449           SvSETMAGIC(left);
2450           SvREFCNT_dec(tmpRef);  
2451       }
2452   }
2453
2454   {
2455     dSP;
2456     BINOP myop;
2457     SV* res;
2458     const bool oldcatch = CATCH_GET;
2459
2460     CATCH_SET(TRUE);
2461     Zero(&myop, 1, BINOP);
2462     myop.op_last = (OP *) &myop;
2463     myop.op_next = NULL;
2464     myop.op_flags = OPf_WANT_SCALAR | OPf_STACKED;
2465
2466     PUSHSTACKi(PERLSI_OVERLOAD);
2467     ENTER;
2468     SAVEOP();
2469     PL_op = (OP *) &myop;
2470     if (PERLDB_SUB && PL_curstash != PL_debstash)
2471         PL_op->op_private |= OPpENTERSUB_DB;
2472     PUTBACK;
2473     Perl_pp_pushmark(aTHX);
2474
2475     EXTEND(SP, notfound + 5);
2476     PUSHs(lr>0? right: left);
2477     PUSHs(lr>0? left: right);
2478     PUSHs( lr > 0 ? &PL_sv_yes : ( assign ? &PL_sv_undef : &PL_sv_no ));
2479     if (notfound) {
2480       PUSHs(newSVpvn_flags(AMG_id2name(method + assignshift),
2481                            AMG_id2namelen(method + assignshift), SVs_TEMP));
2482     }
2483     PUSHs(MUTABLE_SV(cv));
2484     PUTBACK;
2485
2486     if ((PL_op = PL_ppaddr[OP_ENTERSUB](aTHX)))
2487       CALLRUNOPS(aTHX);
2488     LEAVE;
2489     SPAGAIN;
2490
2491     res=POPs;
2492     PUTBACK;
2493     POPSTACK;
2494     CATCH_SET(oldcatch);
2495
2496     if (postpr) {
2497       int ans;
2498       switch (method) {
2499       case le_amg:
2500       case sle_amg:
2501         ans=SvIV(res)<=0; break;
2502       case lt_amg:
2503       case slt_amg:
2504         ans=SvIV(res)<0; break;
2505       case ge_amg:
2506       case sge_amg:
2507         ans=SvIV(res)>=0; break;
2508       case gt_amg:
2509       case sgt_amg:
2510         ans=SvIV(res)>0; break;
2511       case eq_amg:
2512       case seq_amg:
2513         ans=SvIV(res)==0; break;
2514       case ne_amg:
2515       case sne_amg:
2516         ans=SvIV(res)!=0; break;
2517       case inc_amg:
2518       case dec_amg:
2519         SvSetSV(left,res); return left;
2520       case not_amg:
2521         ans=!SvTRUE(res); break;
2522       default:
2523         ans=0; break;
2524       }
2525       return boolSV(ans);
2526     } else if (method==copy_amg) {
2527       if (!SvROK(res)) {
2528         Perl_croak(aTHX_ "Copy method did not return a reference");
2529       }
2530       return SvREFCNT_inc(SvRV(res));
2531     } else {
2532       return res;
2533     }
2534   }
2535 }
2536
2537 /*
2538 =for apidoc is_gv_magical_sv
2539
2540 Returns C<TRUE> if given the name of a magical GV.
2541
2542 Currently only useful internally when determining if a GV should be
2543 created even in rvalue contexts.
2544
2545 C<flags> is not used at present but available for future extension to
2546 allow selecting particular classes of magical variable.
2547
2548 Currently assumes that C<name> is NUL terminated (as well as len being valid).
2549 This assumption is met by all callers within the perl core, which all pass
2550 pointers returned by SvPV.
2551
2552 =cut
2553 */
2554
2555 bool
2556 Perl_is_gv_magical_sv(pTHX_ SV *const name_sv, U32 flags)
2557 {
2558     STRLEN len;
2559     const char *const name = SvPV_const(name_sv, len);
2560
2561     PERL_UNUSED_ARG(flags);
2562     PERL_ARGS_ASSERT_IS_GV_MAGICAL_SV;
2563
2564     if (len > 1) {
2565         const char * const name1 = name + 1;
2566         switch (*name) {
2567         case 'I':
2568             if (len == 3 && name[1] == 'S' && name[2] == 'A')
2569                 goto yes;
2570             break;
2571         case 'O':
2572             if (len == 8 && strEQ(name1, "VERLOAD"))
2573                 goto yes;
2574             break;
2575         case 'S':
2576             if (len == 3 && name[1] == 'I' && name[2] == 'G')
2577                 goto yes;
2578             break;
2579             /* Using ${^...} variables is likely to be sufficiently rare that
2580                it seems sensible to avoid the space hit of also checking the
2581                length.  */
2582         case '\017':   /* ${^OPEN} */
2583             if (strEQ(name1, "PEN"))
2584                 goto yes;
2585             break;
2586         case '\024':   /* ${^TAINT} */
2587             if (strEQ(name1, "AINT"))
2588                 goto yes;
2589             break;
2590         case '\025':    /* ${^UNICODE} */
2591             if (strEQ(name1, "NICODE"))
2592                 goto yes;
2593             if (strEQ(name1, "TF8LOCALE"))
2594                 goto yes;
2595             break;
2596         case '\027':   /* ${^WARNING_BITS} */
2597             if (strEQ(name1, "ARNING_BITS"))
2598                 goto yes;
2599             break;
2600         case '1':
2601         case '2':
2602         case '3':
2603         case '4':
2604         case '5':
2605         case '6':
2606         case '7':
2607         case '8':
2608         case '9':
2609         {
2610             const char *end = name + len;
2611             while (--end > name) {
2612                 if (!isDIGIT(*end))
2613                     return FALSE;
2614             }
2615             goto yes;
2616         }
2617         }
2618     } else {
2619         /* Because we're already assuming that name is NUL terminated
2620            below, we can treat an empty name as "\0"  */
2621         switch (*name) {
2622         case '&':
2623         case '`':
2624         case '\'':
2625         case ':':
2626         case '?':
2627         case '!':
2628         case '-':
2629         case '#':
2630         case '[':
2631         case '^':
2632         case '~':
2633         case '=':
2634         case '%':
2635         case '.':
2636         case '(':
2637         case ')':
2638         case '<':
2639         case '>':
2640         case '\\':
2641         case '/':
2642         case '|':
2643         case '+':
2644         case ';':
2645         case ']':
2646         case '\001':   /* $^A */
2647         case '\003':   /* $^C */
2648         case '\004':   /* $^D */
2649         case '\005':   /* $^E */
2650         case '\006':   /* $^F */
2651         case '\010':   /* $^H */
2652         case '\011':   /* $^I, NOT \t in EBCDIC */
2653         case '\014':   /* $^L */
2654         case '\016':   /* $^N */
2655         case '\017':   /* $^O */
2656         case '\020':   /* $^P */
2657         case '\023':   /* $^S */
2658         case '\024':   /* $^T */
2659         case '\026':   /* $^V */
2660         case '\027':   /* $^W */
2661         case '1':
2662         case '2':
2663         case '3':
2664         case '4':
2665         case '5':
2666         case '6':
2667         case '7':
2668         case '8':
2669         case '9':
2670         yes:
2671             return TRUE;
2672         default:
2673             break;
2674         }
2675     }
2676     return FALSE;
2677 }
2678
2679 void
2680 Perl_gv_name_set(pTHX_ GV *gv, const char *name, U32 len, U32 flags)
2681 {
2682     dVAR;
2683     U32 hash;
2684
2685     PERL_ARGS_ASSERT_GV_NAME_SET;
2686     PERL_UNUSED_ARG(flags);
2687
2688     if (len > I32_MAX)
2689         Perl_croak(aTHX_ "panic: gv name too long (%"UVuf")", (UV) len);
2690
2691     if (!(flags & GV_ADD) && GvNAME_HEK(gv)) {
2692         unshare_hek(GvNAME_HEK(gv));
2693     }
2694
2695     PERL_HASH(hash, name, len);
2696     GvNAME_HEK(gv) = share_hek(name, len, hash);
2697 }
2698
2699 /*
2700 =for apidoc gv_try_downgrade
2701
2702 If the typeglob C<gv> can be expressed more succinctly, by having
2703 something other than a real GV in its place in the stash, replace it
2704 with the optimised form.  Basic requirements for this are that C<gv>
2705 is a real typeglob, is sufficiently ordinary, and is only referenced
2706 from its package.  This function is meant to be used when a GV has been
2707 looked up in part to see what was there, causing upgrading, but based
2708 on what was found it turns out that the real GV isn't required after all.
2709
2710 If C<gv> is a completely empty typeglob, it is deleted from the stash.
2711
2712 If C<gv> is a typeglob containing only a sufficiently-ordinary constant
2713 sub, the typeglob is replaced with a scalar-reference placeholder that
2714 more compactly represents the same thing.
2715
2716 =cut
2717 */
2718
2719 void
2720 Perl_gv_try_downgrade(pTHX_ GV *gv)
2721 {
2722     HV *stash;
2723     CV *cv;
2724     HEK *namehek;
2725     SV **gvp;
2726     PERL_ARGS_ASSERT_GV_TRY_DOWNGRADE;
2727
2728     /* XXX Why and where does this leave dangling pointers during global
2729        destruction? */
2730     if (PL_phase == PERL_PHASE_DESTRUCT) return;
2731
2732     if (!(SvREFCNT(gv) == 1 && SvTYPE(gv) == SVt_PVGV && !SvFAKE(gv) &&
2733             !SvOBJECT(gv) && !SvREADONLY(gv) &&
2734             isGV_with_GP(gv) && GvGP(gv) &&
2735             !GvINTRO(gv) && GvREFCNT(gv) == 1 &&
2736             !GvSV(gv) && !GvAV(gv) && !GvHV(gv) && !GvIOp(gv) && !GvFORM(gv) &&
2737             GvEGVx(gv) == gv && (stash = GvSTASH(gv))))
2738         return;
2739     if (SvMAGICAL(gv)) {
2740         MAGIC *mg;
2741         /* only backref magic is allowed */
2742         if (SvGMAGICAL(gv) || SvSMAGICAL(gv))
2743             return;
2744         for (mg = SvMAGIC(gv); mg; mg = mg->mg_moremagic) {
2745             if (mg->mg_type != PERL_MAGIC_backref)
2746                 return;
2747         }
2748     }
2749     cv = GvCV(gv);
2750     if (!cv) {
2751         HEK *gvnhek = GvNAME_HEK(gv);
2752         (void)hv_delete(stash, HEK_KEY(gvnhek),
2753             HEK_UTF8(gvnhek) ? -HEK_LEN(gvnhek) : HEK_LEN(gvnhek), G_DISCARD);
2754     } else if (GvMULTI(gv) && cv &&
2755             !SvOBJECT(cv) && !SvMAGICAL(cv) && !SvREADONLY(cv) &&
2756             CvSTASH(cv) == stash && CvGV(cv) == gv &&
2757             CvCONST(cv) && !CvMETHOD(cv) && !CvLVALUE(cv) && !CvUNIQUE(cv) &&
2758             !CvNODEBUG(cv) && !CvCLONE(cv) && !CvCLONED(cv) && !CvANON(cv) &&
2759             (namehek = GvNAME_HEK(gv)) &&
2760             (gvp = hv_fetch(stash, HEK_KEY(namehek),
2761                         HEK_LEN(namehek)*(HEK_UTF8(namehek) ? -1 : 1), 0)) &&
2762             *gvp == (SV*)gv) {
2763         SV *value = SvREFCNT_inc(CvXSUBANY(cv).any_ptr);
2764         SvREFCNT(gv) = 0;
2765         sv_clear((SV*)gv);
2766         SvREFCNT(gv) = 1;
2767         SvFLAGS(gv) = SVt_IV|SVf_ROK;
2768         SvANY(gv) = (XPVGV*)((char*)&(gv->sv_u.svu_iv) -
2769                                 STRUCT_OFFSET(XPVIV, xiv_iv));
2770         SvRV_set(gv, value);
2771     }
2772 }
2773
2774 /*
2775  * Local variables:
2776  * c-indentation-style: bsd
2777  * c-basic-offset: 4
2778  * indent-tabs-mode: t
2779  * End:
2780  *
2781  * ex: set ts=8 sts=4 sw=4 noet:
2782  */