This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
[Patch] Math::Complex - Ambiguous call resolved as CORE::foo()
[perl5.git] / pp_hot.c
1 /*    pp_hot.c
2  *
3  *    Copyright (c) 1991-1997, Larry Wall
4  *
5  *    You may distribute under the terms of either the GNU General Public
6  *    License or the Artistic License, as specified in the README file.
7  *
8  */
9
10 /*
11  * Then he heard Merry change the note, and up went the Horn-cry of Buckland,
12  * shaking the air.
13  *
14  *            Awake!  Awake!  Fear, Fire, Foes!  Awake!
15  *                     Fire, Foes!  Awake!
16  */
17
18 #include "EXTERN.h"
19 #include "perl.h"
20
21 #ifdef I_UNISTD
22 #include <unistd.h>
23 #endif
24
25 /* Hot code. */
26
27 #ifdef USE_THREADS
28 static void
29 unset_cvowner(void *cvarg)
30 {
31     register CV* cv = (CV *) cvarg;
32 #ifdef DEBUGGING
33     dTHR;
34 #endif /* DEBUGGING */
35
36     DEBUG_L((PerlIO_printf(PerlIO_stderr(), "%p unsetting CvOWNER of %p:%s\n",
37                            thr, cv, SvPEEK((SV*)cv))));
38     MUTEX_LOCK(CvMUTEXP(cv));
39     DEBUG_L(if (CvDEPTH(cv) != 0)
40                 PerlIO_printf(PerlIO_stderr(), "depth %ld != 0\n",
41                               CvDEPTH(cv)););
42     assert(thr == CvOWNER(cv));
43     CvOWNER(cv) = 0;
44     MUTEX_UNLOCK(CvMUTEXP(cv));
45     SvREFCNT_dec(cv);
46 }
47 #endif /* USE_THREADS */
48
49 PP(pp_const)
50 {
51     djSP;
52     XPUSHs(cSVOP->op_sv);
53     RETURN;
54 }
55
56 PP(pp_nextstate)
57 {
58     PL_curcop = (COP*)PL_op;
59     TAINT_NOT;          /* Each statement is presumed innocent */
60     PL_stack_sp = PL_stack_base + cxstack[cxstack_ix].blk_oldsp;
61     FREETMPS;
62     return NORMAL;
63 }
64
65 PP(pp_gvsv)
66 {
67     djSP;
68     EXTEND(SP,1);
69     if (PL_op->op_private & OPpLVAL_INTRO)
70         PUSHs(save_scalar(cGVOP->op_gv));
71     else
72         PUSHs(GvSV(cGVOP->op_gv));
73     RETURN;
74 }
75
76 PP(pp_null)
77 {
78     return NORMAL;
79 }
80
81 PP(pp_pushmark)
82 {
83     PUSHMARK(PL_stack_sp);
84     return NORMAL;
85 }
86
87 PP(pp_stringify)
88 {
89     djSP; dTARGET;
90     STRLEN len;
91     char *s;
92     s = SvPV(TOPs,len);
93     sv_setpvn(TARG,s,len);
94     SETTARG;
95     RETURN;
96 }
97
98 PP(pp_gv)
99 {
100     djSP;
101     XPUSHs((SV*)cGVOP->op_gv);
102     RETURN;
103 }
104
105 PP(pp_and)
106 {
107     djSP;
108     if (!SvTRUE(TOPs))
109         RETURN;
110     else {
111         --SP;
112         RETURNOP(cLOGOP->op_other);
113     }
114 }
115
116 PP(pp_sassign)
117 {
118     djSP; dPOPTOPssrl;
119     MAGIC *mg;
120
121     if (PL_op->op_private & OPpASSIGN_BACKWARDS) {
122         SV *temp;
123         temp = left; left = right; right = temp;
124     }
125     if (PL_tainting && PL_tainted && !SvTAINTED(left))
126         TAINT_NOT;
127     SvSetMagicSV(right, left);
128     SETs(right);
129     RETURN;
130 }
131
132 PP(pp_cond_expr)
133 {
134     djSP;
135     if (SvTRUEx(POPs))
136         RETURNOP(cCONDOP->op_true);
137     else
138         RETURNOP(cCONDOP->op_false);
139 }
140
141 PP(pp_unstack)
142 {
143     I32 oldsave;
144     TAINT_NOT;          /* Each statement is presumed innocent */
145     PL_stack_sp = PL_stack_base + cxstack[cxstack_ix].blk_oldsp;
146     FREETMPS;
147     oldsave = PL_scopestack[PL_scopestack_ix - 1];
148     LEAVE_SCOPE(oldsave);
149     return NORMAL;
150 }
151
152 PP(pp_concat)
153 {
154   djSP; dATARGET; tryAMAGICbin(concat,opASSIGN);
155   {
156     dPOPTOPssrl;
157     STRLEN len;
158     char *s;
159     if (TARG != left) {
160         s = SvPV(left,len);
161         sv_setpvn(TARG,s,len);
162     }
163     else if (SvGMAGICAL(TARG))
164         mg_get(TARG);
165     else if (!SvOK(TARG) && SvTYPE(TARG) <= SVt_PVMG) {
166         sv_setpv(TARG, "");     /* Suppress warning. */
167         s = SvPV_force(TARG, len);
168     }
169     s = SvPV(right,len);
170     if (SvOK(TARG))
171         sv_catpvn(TARG,s,len);
172     else
173         sv_setpvn(TARG,s,len);  /* suppress warning */
174     SETTARG;
175     RETURN;
176   }
177 }
178
179 PP(pp_padsv)
180 {
181     djSP; dTARGET;
182     XPUSHs(TARG);
183     if (PL_op->op_flags & OPf_MOD) {
184         if (PL_op->op_private & OPpLVAL_INTRO)
185             SAVECLEARSV(PL_curpad[PL_op->op_targ]);
186         else if (PL_op->op_private & OPpDEREF) {
187             PUTBACK;
188             vivify_ref(PL_curpad[PL_op->op_targ], PL_op->op_private & OPpDEREF);
189             SPAGAIN;
190         }
191     }
192     RETURN;
193 }
194
195 PP(pp_readline)
196 {
197     PL_last_in_gv = (GV*)(*PL_stack_sp--);
198     return do_readline();
199 }
200
201 PP(pp_eq)
202 {
203     djSP; tryAMAGICbinSET(eq,0); 
204     {
205       dPOPnv;
206       SETs(boolSV(TOPn == value));
207       RETURN;
208     }
209 }
210
211 PP(pp_preinc)
212 {
213     djSP;
214     if (SvREADONLY(TOPs) || SvTYPE(TOPs) > SVt_PVLV)
215         croak(no_modify);
216     if (SvIOK(TOPs) && !SvNOK(TOPs) && !SvPOK(TOPs) &&
217         SvIVX(TOPs) != IV_MAX)
218     {
219         ++SvIVX(TOPs);
220         SvFLAGS(TOPs) &= ~(SVp_NOK|SVp_POK);
221     }
222     else
223         sv_inc(TOPs);
224     SvSETMAGIC(TOPs);
225     return NORMAL;
226 }
227
228 PP(pp_or)
229 {
230     djSP;
231     if (SvTRUE(TOPs))
232         RETURN;
233     else {
234         --SP;
235         RETURNOP(cLOGOP->op_other);
236     }
237 }
238
239 PP(pp_add)
240 {
241     djSP; dATARGET; tryAMAGICbin(add,opASSIGN); 
242     {
243       dPOPTOPnnrl_ul;
244       SETn( left + right );
245       RETURN;
246     }
247 }
248
249 PP(pp_aelemfast)
250 {
251     djSP;
252     AV *av = GvAV((GV*)cSVOP->op_sv);
253     U32 lval = PL_op->op_flags & OPf_MOD;
254     SV** svp = av_fetch(av, PL_op->op_private, lval);
255     SV *sv = (svp ? *svp : &PL_sv_undef);
256     EXTEND(SP, 1);
257     if (!lval && SvGMAGICAL(sv))        /* see note in pp_helem() */
258         sv = sv_mortalcopy(sv);
259     PUSHs(sv);
260     RETURN;
261 }
262
263 PP(pp_join)
264 {
265     djSP; dMARK; dTARGET;
266     MARK++;
267     do_join(TARG, *MARK, MARK, SP);
268     SP = MARK;
269     SETs(TARG);
270     RETURN;
271 }
272
273 PP(pp_pushre)
274 {
275     djSP;
276 #ifdef DEBUGGING
277     /*
278      * We ass_u_me that LvTARGOFF() comes first, and that two STRLENs
279      * will be enough to hold an OP*.
280      */
281     SV* sv = sv_newmortal();
282     sv_upgrade(sv, SVt_PVLV);
283     LvTYPE(sv) = '/';
284     Copy(&PL_op, &LvTARGOFF(sv), 1, OP*);
285     XPUSHs(sv);
286 #else
287     XPUSHs((SV*)PL_op);
288 #endif
289     RETURN;
290 }
291
292 /* Oversized hot code. */
293
294 PP(pp_print)
295 {
296     djSP; dMARK; dORIGMARK;
297     GV *gv;
298     IO *io;
299     register PerlIO *fp;
300     MAGIC *mg;
301
302     if (PL_op->op_flags & OPf_STACKED)
303         gv = (GV*)*++MARK;
304     else
305         gv = PL_defoutgv;
306     if (SvRMAGICAL(gv) && (mg = mg_find((SV*)gv, 'q'))) {
307         if (MARK == ORIGMARK) {
308             /* If using default handle then we need to make space to 
309              * pass object as 1st arg, so move other args up ...
310              */
311             MEXTEND(SP, 1);
312             ++MARK;
313             Move(MARK, MARK + 1, (SP - MARK) + 1, SV*);
314             ++SP;
315         }
316         PUSHMARK(MARK - 1);
317         *MARK = mg->mg_obj;
318         PUTBACK;
319         ENTER;
320         perl_call_method("PRINT", G_SCALAR);
321         LEAVE;
322         SPAGAIN;
323         MARK = ORIGMARK + 1;
324         *MARK = *SP;
325         SP = MARK;
326         RETURN;
327     }
328     if (!(io = GvIO(gv))) {
329         if (PL_dowarn) {
330             SV* sv = sv_newmortal();
331             gv_fullname3(sv, gv, Nullch);
332             warn("Filehandle %s never opened", SvPV(sv,PL_na));
333         }
334
335         SETERRNO(EBADF,RMS$_IFI);
336         goto just_say_no;
337     }
338     else if (!(fp = IoOFP(io))) {
339         if (PL_dowarn)  {
340             SV* sv = sv_newmortal();
341             gv_fullname3(sv, gv, Nullch);
342             if (IoIFP(io))
343                 warn("Filehandle %s opened only for input", SvPV(sv,PL_na));
344             else
345                 warn("print on closed filehandle %s", SvPV(sv,PL_na));
346         }
347         SETERRNO(EBADF,IoIFP(io)?RMS$_FAC:RMS$_IFI);
348         goto just_say_no;
349     }
350     else {
351         MARK++;
352         if (PL_ofslen) {
353             while (MARK <= SP) {
354                 if (!do_print(*MARK, fp))
355                     break;
356                 MARK++;
357                 if (MARK <= SP) {
358                     if (PerlIO_write(fp, PL_ofs, PL_ofslen) == 0 || PerlIO_error(fp)) {
359                         MARK--;
360                         break;
361                     }
362                 }
363             }
364         }
365         else {
366             while (MARK <= SP) {
367                 if (!do_print(*MARK, fp))
368                     break;
369                 MARK++;
370             }
371         }
372         if (MARK <= SP)
373             goto just_say_no;
374         else {
375             if (PL_orslen)
376                 if (PerlIO_write(fp, PL_ors, PL_orslen) == 0 || PerlIO_error(fp))
377                     goto just_say_no;
378
379             if (IoFLAGS(io) & IOf_FLUSH)
380                 if (PerlIO_flush(fp) == EOF)
381                     goto just_say_no;
382         }
383     }
384     SP = ORIGMARK;
385     PUSHs(&PL_sv_yes);
386     RETURN;
387
388   just_say_no:
389     SP = ORIGMARK;
390     PUSHs(&PL_sv_undef);
391     RETURN;
392 }
393
394 PP(pp_rv2av)
395 {
396     djSP; dPOPss;
397     AV *av;
398
399     if (SvROK(sv)) {
400       wasref:
401         av = (AV*)SvRV(sv);
402         if (SvTYPE(av) != SVt_PVAV)
403             DIE("Not an ARRAY reference");
404         if (PL_op->op_flags & OPf_REF) {
405             PUSHs((SV*)av);
406             RETURN;
407         }
408     }
409     else {
410         if (SvTYPE(sv) == SVt_PVAV) {
411             av = (AV*)sv;
412             if (PL_op->op_flags & OPf_REF) {
413                 PUSHs((SV*)av);
414                 RETURN;
415             }
416         }
417         else {
418             GV *gv;
419             
420             if (SvTYPE(sv) != SVt_PVGV) {
421                 char *sym;
422
423                 if (SvGMAGICAL(sv)) {
424                     mg_get(sv);
425                     if (SvROK(sv))
426                         goto wasref;
427                 }
428                 if (!SvOK(sv)) {
429                     if (PL_op->op_flags & OPf_REF ||
430                       PL_op->op_private & HINT_STRICT_REFS)
431                         DIE(no_usym, "an ARRAY");
432                     if (PL_dowarn)
433                         warn(warn_uninit);
434                     if (GIMME == G_ARRAY)
435                         RETURN;
436                     RETPUSHUNDEF;
437                 }
438                 sym = SvPV(sv,PL_na);
439                 if (PL_op->op_private & HINT_STRICT_REFS)
440                     DIE(no_symref, sym, "an ARRAY");
441                 gv = (GV*)gv_fetchpv(sym, TRUE, SVt_PVAV);
442             } else {
443                 gv = (GV*)sv;
444             }
445             av = GvAVn(gv);
446             if (PL_op->op_private & OPpLVAL_INTRO)
447                 av = save_ary(gv);
448             if (PL_op->op_flags & OPf_REF) {
449                 PUSHs((SV*)av);
450                 RETURN;
451             }
452         }
453     }
454
455     if (GIMME == G_ARRAY) {
456         I32 maxarg = AvFILL(av) + 1;
457         EXTEND(SP, maxarg);          
458         if (SvRMAGICAL(av)) {
459             U32 i; 
460             for (i=0; i < maxarg; i++) {
461                 SV **svp = av_fetch(av, i, FALSE);
462                 SP[i+1] = (svp) ? *svp : &PL_sv_undef;
463             }
464         } 
465         else {
466             Copy(AvARRAY(av), SP+1, maxarg, SV*);
467         }
468         SP += maxarg;
469     }
470     else {
471         dTARGET;
472         I32 maxarg = AvFILL(av) + 1;
473         PUSHi(maxarg);
474     }
475     RETURN;
476 }
477
478 PP(pp_rv2hv)
479 {
480     djSP; dTOPss;
481     HV *hv;
482
483     if (SvROK(sv)) {
484       wasref:
485         hv = (HV*)SvRV(sv);
486         if (SvTYPE(hv) != SVt_PVHV && SvTYPE(hv) != SVt_PVAV)
487             DIE("Not a HASH reference");
488         if (PL_op->op_flags & OPf_REF) {
489             SETs((SV*)hv);
490             RETURN;
491         }
492     }
493     else {
494         if (SvTYPE(sv) == SVt_PVHV || SvTYPE(sv) == SVt_PVAV) {
495             hv = (HV*)sv;
496             if (PL_op->op_flags & OPf_REF) {
497                 SETs((SV*)hv);
498                 RETURN;
499             }
500         }
501         else {
502             GV *gv;
503             
504             if (SvTYPE(sv) != SVt_PVGV) {
505                 char *sym;
506
507                 if (SvGMAGICAL(sv)) {
508                     mg_get(sv);
509                     if (SvROK(sv))
510                         goto wasref;
511                 }
512                 if (!SvOK(sv)) {
513                     if (PL_op->op_flags & OPf_REF ||
514                       PL_op->op_private & HINT_STRICT_REFS)
515                         DIE(no_usym, "a HASH");
516                     if (PL_dowarn)
517                         warn(warn_uninit);
518                     if (GIMME == G_ARRAY) {
519                         SP--;
520                         RETURN;
521                     }
522                     RETSETUNDEF;
523                 }
524                 sym = SvPV(sv,PL_na);
525                 if (PL_op->op_private & HINT_STRICT_REFS)
526                     DIE(no_symref, sym, "a HASH");
527                 gv = (GV*)gv_fetchpv(sym, TRUE, SVt_PVHV);
528             } else {
529                 gv = (GV*)sv;
530             }
531             hv = GvHVn(gv);
532             if (PL_op->op_private & OPpLVAL_INTRO)
533                 hv = save_hash(gv);
534             if (PL_op->op_flags & OPf_REF) {
535                 SETs((SV*)hv);
536                 RETURN;
537             }
538         }
539     }
540
541     if (GIMME == G_ARRAY) { /* array wanted */
542         *PL_stack_sp = (SV*)hv;
543         return do_kv(ARGS);
544     }
545     else {
546         dTARGET;
547         if (SvTYPE(hv) == SVt_PVAV)
548             hv = avhv_keys((AV*)hv);
549         if (HvFILL(hv))
550             sv_setpvf(TARG, "%ld/%ld",
551                       (long)HvFILL(hv), (long)HvMAX(hv) + 1);
552         else
553             sv_setiv(TARG, 0);
554         
555         SETTARG;
556         RETURN;
557     }
558 }
559
560 PP(pp_aassign)
561 {
562     djSP;
563     SV **lastlelem = PL_stack_sp;
564     SV **lastrelem = PL_stack_base + POPMARK;
565     SV **firstrelem = PL_stack_base + POPMARK + 1;
566     SV **firstlelem = lastrelem + 1;
567
568     register SV **relem;
569     register SV **lelem;
570
571     register SV *sv;
572     register AV *ary;
573
574     I32 gimme;
575     HV *hash;
576     I32 i;
577     int magic;
578
579     PL_delaymagic = DM_DELAY;           /* catch simultaneous items */
580
581     /* If there's a common identifier on both sides we have to take
582      * special care that assigning the identifier on the left doesn't
583      * clobber a value on the right that's used later in the list.
584      */
585     if (PL_op->op_private & OPpASSIGN_COMMON) {
586         for (relem = firstrelem; relem <= lastrelem; relem++) {
587             /*SUPPRESS 560*/
588             if (sv = *relem) {
589                 TAINT_NOT;      /* Each item is independent */
590                 *relem = sv_mortalcopy(sv);
591             }
592         }
593     }
594
595     relem = firstrelem;
596     lelem = firstlelem;
597     ary = Null(AV*);
598     hash = Null(HV*);
599     while (lelem <= lastlelem) {
600         TAINT_NOT;              /* Each item stands on its own, taintwise. */
601         sv = *lelem++;
602         switch (SvTYPE(sv)) {
603         case SVt_PVAV:
604             ary = (AV*)sv;
605             magic = SvMAGICAL(ary) != 0;
606             
607             av_clear(ary);
608             av_extend(ary, lastrelem - relem);
609             i = 0;
610             while (relem <= lastrelem) {        /* gobble up all the rest */
611                 SV **didstore;
612                 sv = NEWSV(28,0);
613                 assert(*relem);
614                 sv_setsv(sv,*relem);
615                 *(relem++) = sv;
616                 didstore = av_store(ary,i++,sv);
617                 if (magic) {
618                     if (SvSMAGICAL(sv))
619                         mg_set(sv);
620                     if (!didstore)
621                         SvREFCNT_dec(sv);
622                 }
623                 TAINT_NOT;
624             }
625             break;
626         case SVt_PVHV: {
627                 SV *tmpstr;
628
629                 hash = (HV*)sv;
630                 magic = SvMAGICAL(hash) != 0;
631                 hv_clear(hash);
632
633                 while (relem < lastrelem) {     /* gobble up all the rest */
634                     HE *didstore;
635                     if (*relem)
636                         sv = *(relem++);
637                     else
638                         sv = &PL_sv_no, relem++;
639                     tmpstr = NEWSV(29,0);
640                     if (*relem)
641                         sv_setsv(tmpstr,*relem);        /* value */
642                     *(relem++) = tmpstr;
643                     didstore = hv_store_ent(hash,sv,tmpstr,0);
644                     if (magic) {
645                         if (SvSMAGICAL(tmpstr))
646                             mg_set(tmpstr);
647                         if (!didstore)
648                             SvREFCNT_dec(tmpstr);
649                     }
650                     TAINT_NOT;
651                 }
652                 if (relem == lastrelem) {
653                     if (*relem) {
654                         HE *didstore;
655                         if (PL_dowarn) {
656                             if (relem == firstrelem &&
657                                 SvROK(*relem) &&
658                                 ( SvTYPE(SvRV(*relem)) == SVt_PVAV ||
659                                   SvTYPE(SvRV(*relem)) == SVt_PVHV ) )
660                                 warn("Reference found where even-sized list expected");
661                             else
662                                 warn("Odd number of elements in hash assignment");
663                         }
664                         tmpstr = NEWSV(29,0);
665                         didstore = hv_store_ent(hash,*relem,tmpstr,0);
666                         if (magic) {
667                             if (SvSMAGICAL(tmpstr))
668                                 mg_set(tmpstr);
669                             if (!didstore)
670                                 SvREFCNT_dec(tmpstr);
671                         }
672                         TAINT_NOT;
673                     }
674                     relem++;
675                 }
676             }
677             break;
678         default:
679             if (SvTHINKFIRST(sv)) {
680                 if (SvREADONLY(sv) && PL_curcop != &PL_compiling) {
681                     if (!SvIMMORTAL(sv))
682                         DIE(no_modify);
683                     if (relem <= lastrelem)
684                         relem++;
685                     break;
686                 }
687                 if (SvROK(sv))
688                     sv_unref(sv);
689             }
690             if (relem <= lastrelem) {
691                 sv_setsv(sv, *relem);
692                 *(relem++) = sv;
693             }
694             else
695                 sv_setsv(sv, &PL_sv_undef);
696             SvSETMAGIC(sv);
697             break;
698         }
699     }
700     if (PL_delaymagic & ~DM_DELAY) {
701         if (PL_delaymagic & DM_UID) {
702 #ifdef HAS_SETRESUID
703             (void)setresuid(PL_uid,PL_euid,(Uid_t)-1);
704 #else
705 #  ifdef HAS_SETREUID
706             (void)setreuid(PL_uid,PL_euid);
707 #  else
708 #    ifdef HAS_SETRUID
709             if ((PL_delaymagic & DM_UID) == DM_RUID) {
710                 (void)setruid(PL_uid);
711                 PL_delaymagic &= ~DM_RUID;
712             }
713 #    endif /* HAS_SETRUID */
714 #    ifdef HAS_SETEUID
715             if ((PL_delaymagic & DM_UID) == DM_EUID) {
716                 (void)seteuid(PL_uid);
717                 PL_delaymagic &= ~DM_EUID;
718             }
719 #    endif /* HAS_SETEUID */
720             if (PL_delaymagic & DM_UID) {
721                 if (PL_uid != PL_euid)
722                     DIE("No setreuid available");
723                 (void)PerlProc_setuid(PL_uid);
724             }
725 #  endif /* HAS_SETREUID */
726 #endif /* HAS_SETRESUID */
727             PL_uid = (int)PerlProc_getuid();
728             PL_euid = (int)PerlProc_geteuid();
729         }
730         if (PL_delaymagic & DM_GID) {
731 #ifdef HAS_SETRESGID
732             (void)setresgid(PL_gid,PL_egid,(Gid_t)-1);
733 #else
734 #  ifdef HAS_SETREGID
735             (void)setregid(PL_gid,PL_egid);
736 #  else
737 #    ifdef HAS_SETRGID
738             if ((PL_delaymagic & DM_GID) == DM_RGID) {
739                 (void)setrgid(PL_gid);
740                 PL_delaymagic &= ~DM_RGID;
741             }
742 #    endif /* HAS_SETRGID */
743 #    ifdef HAS_SETEGID
744             if ((PL_delaymagic & DM_GID) == DM_EGID) {
745                 (void)setegid(PL_gid);
746                 PL_delaymagic &= ~DM_EGID;
747             }
748 #    endif /* HAS_SETEGID */
749             if (PL_delaymagic & DM_GID) {
750                 if (PL_gid != PL_egid)
751                     DIE("No setregid available");
752                 (void)PerlProc_setgid(PL_gid);
753             }
754 #  endif /* HAS_SETREGID */
755 #endif /* HAS_SETRESGID */
756             PL_gid = (int)PerlProc_getgid();
757             PL_egid = (int)PerlProc_getegid();
758         }
759         PL_tainting |= (PL_uid && (PL_euid != PL_uid || PL_egid != PL_gid));
760     }
761     PL_delaymagic = 0;
762
763     gimme = GIMME_V;
764     if (gimme == G_VOID)
765         SP = firstrelem - 1;
766     else if (gimme == G_SCALAR) {
767         dTARGET;
768         SP = firstrelem;
769         SETi(lastrelem - firstrelem + 1);
770     }
771     else {
772         if (ary || hash)
773             SP = lastrelem;
774         else
775             SP = firstrelem + (lastlelem - firstlelem);
776         lelem = firstlelem + (relem - firstrelem);
777         while (relem <= SP)
778             *relem++ = (lelem <= lastlelem) ? *lelem++ : &PL_sv_undef;
779     }
780     RETURN;
781 }
782
783 PP(pp_qr)
784 {
785     djSP;
786     register PMOP *pm = cPMOP;
787     SV *rv = sv_newmortal();
788     SV *sv = newSVrv(rv, "Regexp");
789     sv_magic(sv,(SV*)ReREFCNT_inc(pm->op_pmregexp),'r',0,0);
790     RETURNX(PUSHs(rv));
791 }
792
793 PP(pp_match)
794 {
795     djSP; dTARG;
796     register PMOP *pm = cPMOP;
797     register char *t;
798     register char *s;
799     char *strend;
800     I32 global;
801     I32 safebase;
802     char *truebase;
803     register REGEXP *rx = pm->op_pmregexp;
804     bool rxtainted;
805     I32 gimme = GIMME;
806     STRLEN len;
807     I32 minmatch = 0;
808     I32 oldsave = PL_savestack_ix;
809     I32 update_minmatch = 1;
810     SV *screamer;
811
812     if (PL_op->op_flags & OPf_STACKED)
813         TARG = POPs;
814     else {
815         TARG = DEFSV;
816         EXTEND(SP,1);
817     }
818     PUTBACK;                            /* EVAL blocks need stack_sp. */
819     s = SvPV(TARG, len);
820     strend = s + len;
821     if (!s)
822         DIE("panic: do_match");
823     rxtainted = ((pm->op_pmdynflags & PMdf_TAINTED) ||
824                  (PL_tainted && (pm->op_pmflags & PMf_RETAINT)));
825     TAINT_NOT;
826
827     if (pm->op_pmdynflags & PMdf_USED) {
828       failure:
829         if (gimme == G_ARRAY)
830             RETURN;
831         RETPUSHNO;
832     }
833
834     if (!rx->prelen && PL_curpm) {
835         pm = PL_curpm;
836         rx = pm->op_pmregexp;
837     }
838     if (rx->minlen > len) goto failure;
839
840     screamer = ( (SvSCREAM(TARG) && rx->check_substr
841                   && SvTYPE(rx->check_substr) == SVt_PVBM
842                   && SvVALID(rx->check_substr)) 
843                 ? TARG : Nullsv);
844     truebase = t = s;
845     if (global = pm->op_pmflags & PMf_GLOBAL) {
846         rx->startp[0] = 0;
847         if (SvTYPE(TARG) >= SVt_PVMG && SvMAGIC(TARG)) {
848             MAGIC* mg = mg_find(TARG, 'g');
849             if (mg && mg->mg_len >= 0) {
850                 rx->endp[0] = rx->startp[0] = s + mg->mg_len; 
851                 minmatch = (mg->mg_flags & MGf_MINMATCH);
852                 update_minmatch = 0;
853             }
854         }
855     }
856     safebase = (((gimme == G_ARRAY) || global || !rx->nparens)
857                 && !PL_sawampersand);
858     safebase = safebase ? 0  : REXEC_COPY_STR ;
859     if (pm->op_pmflags & (PMf_MULTILINE|PMf_SINGLELINE)) {
860         SAVEINT(PL_multiline);
861         PL_multiline = pm->op_pmflags & PMf_MULTILINE;
862     }
863
864 play_it_again:
865     if (global && rx->startp[0]) {
866         t = s = rx->endp[0];
867         if ((s + rx->minlen) > strend)
868             goto nope;
869         if (update_minmatch++)
870             minmatch = (s == rx->startp[0]);
871     }
872     if (rx->check_substr) {
873         if (!(rx->reganch & ROPT_NOSCAN)) { /* Floating checkstring. */
874             if ( screamer ) {
875                 I32 p = -1;
876                 
877                 if (PL_screamfirst[BmRARE(rx->check_substr)] < 0)
878                     goto nope;
879                 else if (!(s = screaminstr(TARG, rx->check_substr, 
880                                            rx->check_offset_min, 0, &p, 0)))
881                     goto nope;
882                 else if ((rx->reganch & ROPT_CHECK_ALL)
883                          && !PL_sawampersand && !SvTAIL(rx->check_substr))
884                     goto yup;
885             }
886             else if (!(s = fbm_instr((unsigned char*)s + rx->check_offset_min,
887                                      (unsigned char*)strend, 
888                                      rx->check_substr, 0)))
889                 goto nope;
890             else if ((rx->reganch & ROPT_CHECK_ALL) && !PL_sawampersand)
891                 goto yup;
892             if (s && rx->check_offset_max < s - t) {
893                 ++BmUSEFUL(rx->check_substr);
894                 s -= rx->check_offset_max;
895             }
896             else
897                 s = t;
898         }
899         /* Now checkstring is fixed, i.e. at fixed offset from the
900            beginning of match, and the match is anchored at s. */
901         else if (!PL_multiline) {       /* Anchored near beginning of string. */
902             I32 slen;
903             if (*SvPVX(rx->check_substr) != s[rx->check_offset_min]
904                 || ((slen = SvCUR(rx->check_substr)) > 1
905                     && memNE(SvPVX(rx->check_substr), 
906                              s + rx->check_offset_min, slen)))
907                 goto nope;
908         }
909         if (!rx->naughty && --BmUSEFUL(rx->check_substr) < 0
910             && rx->check_substr == rx->float_substr) {
911             SvREFCNT_dec(rx->check_substr);
912             rx->check_substr = Nullsv;  /* opt is being useless */
913             rx->float_substr = Nullsv;
914         }
915     }
916     if (CALLREGEXEC(rx, s, strend, truebase, minmatch,
917                       screamer, NULL, safebase))
918     {
919         PL_curpm = pm;
920         if (pm->op_pmflags & PMf_ONCE)
921             pm->op_pmdynflags |= PMdf_USED;
922         goto gotcha;
923     }
924     else
925         goto ret_no;
926     /*NOTREACHED*/
927
928   gotcha:
929     if (rxtainted)
930         RX_MATCH_TAINTED_on(rx);
931     TAINT_IF(RX_MATCH_TAINTED(rx));
932     if (gimme == G_ARRAY) {
933         I32 iters, i, len;
934
935         iters = rx->nparens;
936         if (global && !iters)
937             i = 1;
938         else
939             i = 0;
940         SPAGAIN;                        /* EVAL blocks could move the stack. */
941         EXTEND(SP, iters + i);
942         EXTEND_MORTAL(iters + i);
943         for (i = !i; i <= iters; i++) {
944             PUSHs(sv_newmortal());
945             /*SUPPRESS 560*/
946             if ((s = rx->startp[i]) && rx->endp[i] ) {
947                 len = rx->endp[i] - s;
948                 sv_setpvn(*SP, s, len);
949             }
950         }
951         if (global) {
952             truebase = rx->subbeg;
953             strend = rx->subend;
954             if (rx->startp[0] && rx->startp[0] == rx->endp[0])
955                 ++rx->endp[0];
956             PUTBACK;                    /* EVAL blocks may use stack */
957             goto play_it_again;
958         }
959         else if (!iters)
960             XPUSHs(&PL_sv_yes);
961         LEAVE_SCOPE(oldsave);
962         RETURN;
963     }
964     else {
965         if (global) {
966             MAGIC* mg = 0;
967             if (SvTYPE(TARG) >= SVt_PVMG && SvMAGIC(TARG))
968                 mg = mg_find(TARG, 'g');
969             if (!mg) {
970                 sv_magic(TARG, (SV*)0, 'g', Nullch, 0);
971                 mg = mg_find(TARG, 'g');
972             }
973             if (rx->startp[0]) {
974                 mg->mg_len = rx->endp[0] - rx->subbeg;
975                 if (rx->startp[0] == rx->endp[0])
976                     mg->mg_flags |= MGf_MINMATCH;
977                 else
978                     mg->mg_flags &= ~MGf_MINMATCH;
979             }
980         }
981         LEAVE_SCOPE(oldsave);
982         RETPUSHYES;
983     }
984
985 yup:                                    /* Confirmed by check_substr */
986     if (rxtainted)
987         RX_MATCH_TAINTED_on(rx);
988     TAINT_IF(RX_MATCH_TAINTED(rx));
989     ++BmUSEFUL(rx->check_substr);
990     PL_curpm = pm;
991     if (pm->op_pmflags & PMf_ONCE)
992         pm->op_pmdynflags |= PMdf_USED;
993     Safefree(rx->subbase);
994     rx->subbase = Nullch;
995     if (global) {
996         rx->subbeg = truebase;
997         rx->subend = strend;
998         rx->startp[0] = s;
999         rx->endp[0] = s + SvCUR(rx->check_substr);
1000         goto gotcha;
1001     }
1002     if (PL_sawampersand) {
1003         char *tmps;
1004
1005         tmps = rx->subbase = savepvn(t, strend-t);
1006         rx->subbeg = tmps;
1007         rx->subend = tmps + (strend-t);
1008         tmps = rx->startp[0] = tmps + (s - t);
1009         rx->endp[0] = tmps + SvCUR(rx->check_substr);
1010     }
1011     LEAVE_SCOPE(oldsave);
1012     RETPUSHYES;
1013
1014 nope:
1015     if (rx->check_substr)
1016         ++BmUSEFUL(rx->check_substr);
1017
1018 ret_no:
1019     if (global && !(pm->op_pmflags & PMf_CONTINUE)) {
1020         if (SvTYPE(TARG) >= SVt_PVMG && SvMAGIC(TARG)) {
1021             MAGIC* mg = mg_find(TARG, 'g');
1022             if (mg)
1023                 mg->mg_len = -1;
1024         }
1025     }
1026     LEAVE_SCOPE(oldsave);
1027     if (gimme == G_ARRAY)
1028         RETURN;
1029     RETPUSHNO;
1030 }
1031
1032 OP *
1033 do_readline(void)
1034 {
1035     dSP; dTARGETSTACKED;
1036     register SV *sv;
1037     STRLEN tmplen = 0;
1038     STRLEN offset;
1039     PerlIO *fp;
1040     register IO *io = GvIO(PL_last_in_gv);
1041     register I32 type = PL_op->op_type;
1042     I32 gimme = GIMME_V;
1043     MAGIC *mg;
1044
1045     if (SvRMAGICAL(PL_last_in_gv) && (mg = mg_find((SV*)PL_last_in_gv, 'q'))) {
1046         PUSHMARK(SP);
1047         XPUSHs(mg->mg_obj);
1048         PUTBACK;
1049         ENTER;
1050         perl_call_method("READLINE", gimme);
1051         LEAVE;
1052         SPAGAIN;
1053         if (gimme == G_SCALAR)
1054             SvSetMagicSV_nosteal(TARG, TOPs);
1055         RETURN;
1056     }
1057     fp = Nullfp;
1058     if (io) {
1059         fp = IoIFP(io);
1060         if (!fp) {
1061             if (IoFLAGS(io) & IOf_ARGV) {
1062                 if (IoFLAGS(io) & IOf_START) {
1063                     IoFLAGS(io) &= ~IOf_START;
1064                     IoLINES(io) = 0;
1065                     if (av_len(GvAVn(PL_last_in_gv)) < 0) {
1066                         do_open(PL_last_in_gv,"-",1,FALSE,0,0,Nullfp);
1067                         sv_setpvn(GvSV(PL_last_in_gv), "-", 1);
1068                         SvSETMAGIC(GvSV(PL_last_in_gv));
1069                         fp = IoIFP(io);
1070                         goto have_fp;
1071                     }
1072                 }
1073                 fp = nextargv(PL_last_in_gv);
1074                 if (!fp) { /* Note: fp != IoIFP(io) */
1075                     (void)do_close(PL_last_in_gv, FALSE); /* now it does*/
1076                     IoFLAGS(io) |= IOf_START;
1077                 }
1078             }
1079             else if (type == OP_GLOB) {
1080                 SV *tmpcmd = NEWSV(55, 0);
1081                 SV *tmpglob = POPs;
1082                 ENTER;
1083                 SAVEFREESV(tmpcmd);
1084 #ifdef VMS /* expand the wildcards right here, rather than opening a pipe, */
1085            /* since spawning off a process is a real performance hit */
1086                 {
1087 #include <descrip.h>
1088 #include <lib$routines.h>
1089 #include <nam.h>
1090 #include <rmsdef.h>
1091                     char rslt[NAM$C_MAXRSS+1+sizeof(unsigned short int)] = {'\0','\0'};
1092                     char vmsspec[NAM$C_MAXRSS+1];
1093                     char *rstr = rslt + sizeof(unsigned short int), *begin, *end, *cp;
1094                     char tmpfnam[L_tmpnam] = "SYS$SCRATCH:";
1095                     $DESCRIPTOR(dfltdsc,"SYS$DISK:[]*.*;");
1096                     PerlIO *tmpfp;
1097                     STRLEN i;
1098                     struct dsc$descriptor_s wilddsc
1099                        = {0, DSC$K_DTYPE_T, DSC$K_CLASS_S, 0};
1100                     struct dsc$descriptor_vs rsdsc
1101                        = {sizeof rslt, DSC$K_DTYPE_VT, DSC$K_CLASS_VS, rslt};
1102                     unsigned long int cxt = 0, sts = 0, ok = 1, hasdir = 0, hasver = 0, isunix = 0;
1103
1104                     /* We could find out if there's an explicit dev/dir or version
1105                        by peeking into lib$find_file's internal context at
1106                        ((struct NAM *)((struct FAB *)cxt)->fab$l_nam)->nam$l_fnb
1107                        but that's unsupported, so I don't want to do it now and
1108                        have it bite someone in the future. */
1109                     strcat(tmpfnam,PerlLIO_tmpnam(NULL));
1110                     cp = SvPV(tmpglob,i);
1111                     for (; i; i--) {
1112                        if (cp[i] == ';') hasver = 1;
1113                        if (cp[i] == '.') {
1114                            if (sts) hasver = 1;
1115                            else sts = 1;
1116                        }
1117                        if (cp[i] == '/') {
1118                           hasdir = isunix = 1;
1119                           break;
1120                        }
1121                        if (cp[i] == ']' || cp[i] == '>' || cp[i] == ':') {
1122                            hasdir = 1;
1123                            break;
1124                        }
1125                     }
1126                     if ((tmpfp = PerlIO_open(tmpfnam,"w+","fop=dlt")) != NULL) {
1127                         Stat_t st;
1128                         if (!PerlLIO_stat(SvPVX(tmpglob),&st) && S_ISDIR(st.st_mode))
1129                           ok = ((wilddsc.dsc$a_pointer = tovmspath(SvPVX(tmpglob),vmsspec)) != NULL);
1130                         else ok = ((wilddsc.dsc$a_pointer = tovmsspec(SvPVX(tmpglob),vmsspec)) != NULL);
1131                         if (ok) wilddsc.dsc$w_length = (unsigned short int) strlen(wilddsc.dsc$a_pointer);
1132                         while (ok && ((sts = lib$find_file(&wilddsc,&rsdsc,&cxt,
1133                                                     &dfltdsc,NULL,NULL,NULL))&1)) {
1134                             end = rstr + (unsigned long int) *rslt;
1135                             if (!hasver) while (*end != ';') end--;
1136                             *(end++) = '\n';  *end = '\0';
1137                             for (cp = rstr; *cp; cp++) *cp = _tolower(*cp);
1138                             if (hasdir) {
1139                               if (isunix) trim_unixpath(rstr,SvPVX(tmpglob),1);
1140                               begin = rstr;
1141                             }
1142                             else {
1143                                 begin = end;
1144                                 while (*(--begin) != ']' && *begin != '>') ;
1145                                 ++begin;
1146                             }
1147                             ok = (PerlIO_puts(tmpfp,begin) != EOF);
1148                         }
1149                         if (cxt) (void)lib$find_file_end(&cxt);
1150                         if (ok && sts != RMS$_NMF &&
1151                             sts != RMS$_DNF && sts != RMS$_FNF) ok = 0;
1152                         if (!ok) {
1153                             if (!(sts & 1)) {
1154                               SETERRNO((sts == RMS$_SYN ? EINVAL : EVMSERR),sts);
1155                             }
1156                             PerlIO_close(tmpfp);
1157                             fp = NULL;
1158                         }
1159                         else {
1160                            PerlIO_rewind(tmpfp);
1161                            IoTYPE(io) = '<';
1162                            IoIFP(io) = fp = tmpfp;
1163                            IoFLAGS(io) &= ~IOf_UNTAINT;  /* maybe redundant */
1164                         }
1165                     }
1166                 }
1167 #else /* !VMS */
1168 #ifdef DOSISH
1169 #ifdef OS2
1170                 sv_setpv(tmpcmd, "for a in ");
1171                 sv_catsv(tmpcmd, tmpglob);
1172                 sv_catpv(tmpcmd, "; do echo \"$a\\0\\c\"; done |");
1173 #else
1174 #ifdef DJGPP
1175                 sv_setpv(tmpcmd, "/dev/dosglob/"); /* File System Extension */
1176                 sv_catsv(tmpcmd, tmpglob);
1177 #else
1178                 sv_setpv(tmpcmd, "perlglob ");
1179                 sv_catsv(tmpcmd, tmpglob);
1180                 sv_catpv(tmpcmd, " |");
1181 #endif /* !DJGPP */
1182 #endif /* !OS2 */
1183 #else /* !DOSISH */
1184 #if defined(CSH)
1185                 sv_setpvn(tmpcmd, PL_cshname, PL_cshlen);
1186                 sv_catpv(tmpcmd, " -cf 'set nonomatch; glob ");
1187                 sv_catsv(tmpcmd, tmpglob);
1188                 sv_catpv(tmpcmd, "' 2>/dev/null |");
1189 #else
1190                 sv_setpv(tmpcmd, "echo ");
1191                 sv_catsv(tmpcmd, tmpglob);
1192 #if 'z' - 'a' == 25
1193                 sv_catpv(tmpcmd, "|tr -s ' \t\f\r' '\\012\\012\\012\\012'|");
1194 #else
1195                 sv_catpv(tmpcmd, "|tr -s ' \t\f\r' '\\n\\n\\n\\n'|");
1196 #endif
1197 #endif /* !CSH */
1198 #endif /* !DOSISH */
1199                 (void)do_open(PL_last_in_gv, SvPVX(tmpcmd), SvCUR(tmpcmd),
1200                               FALSE, 0, 0, Nullfp);
1201                 fp = IoIFP(io);
1202 #endif /* !VMS */
1203                 LEAVE;
1204             }
1205         }
1206         else if (type == OP_GLOB)
1207             SP--;
1208     }
1209     if (!fp) {
1210         if (PL_dowarn && io && !(IoFLAGS(io) & IOf_START))
1211             warn("Read on closed filehandle <%s>", GvENAME(PL_last_in_gv));
1212         if (gimme == G_SCALAR) {
1213             (void)SvOK_off(TARG);
1214             PUSHTARG;
1215         }
1216         RETURN;
1217     }
1218   have_fp:
1219     if (gimme == G_SCALAR) {
1220         sv = TARG;
1221         if (SvROK(sv))
1222             sv_unref(sv);
1223         (void)SvUPGRADE(sv, SVt_PV);
1224         tmplen = SvLEN(sv);     /* remember if already alloced */
1225         if (!tmplen)
1226             Sv_Grow(sv, 80);    /* try short-buffering it */
1227         if (type == OP_RCATLINE)
1228             offset = SvCUR(sv);
1229         else
1230             offset = 0;
1231     }
1232     else {
1233         sv = sv_2mortal(NEWSV(57, 80));
1234         offset = 0;
1235     }
1236     for (;;) {
1237         if (!sv_gets(sv, fp, offset)) {
1238             PerlIO_clearerr(fp);
1239             if (IoFLAGS(io) & IOf_ARGV) {
1240                 fp = nextargv(PL_last_in_gv);
1241                 if (fp)
1242                     continue;
1243                 (void)do_close(PL_last_in_gv, FALSE);
1244                 IoFLAGS(io) |= IOf_START;
1245             }
1246             else if (type == OP_GLOB) {
1247                 if (!do_close(PL_last_in_gv, FALSE))
1248                     warn("internal error: glob failed");
1249             }
1250             if (gimme == G_SCALAR) {
1251                 (void)SvOK_off(TARG);
1252                 PUSHTARG;
1253             }
1254             RETURN;
1255         }
1256         /* This should not be marked tainted if the fp is marked clean */
1257         if (!(IoFLAGS(io) & IOf_UNTAINT)) {
1258             TAINT;
1259             SvTAINTED_on(sv);
1260         }
1261         IoLINES(io)++;
1262         SvSETMAGIC(sv);
1263         XPUSHs(sv);
1264         if (type == OP_GLOB) {
1265             char *tmps;
1266
1267             if (SvCUR(sv) > 0 && SvCUR(PL_rs) > 0) {
1268                 tmps = SvEND(sv) - 1;
1269                 if (*tmps == *SvPVX(PL_rs)) {
1270                     *tmps = '\0';
1271                     SvCUR(sv)--;
1272                 }
1273             }
1274             for (tmps = SvPVX(sv); *tmps; tmps++)
1275                 if (!isALPHA(*tmps) && !isDIGIT(*tmps) &&
1276                     strchr("$&*(){}[]'\";\\|?<>~`", *tmps))
1277                         break;
1278             if (*tmps && PerlLIO_stat(SvPVX(sv), &PL_statbuf) < 0) {
1279                 (void)POPs;             /* Unmatched wildcard?  Chuck it... */
1280                 continue;
1281             }
1282         }
1283         if (gimme == G_ARRAY) {
1284             if (SvLEN(sv) - SvCUR(sv) > 20) {
1285                 SvLEN_set(sv, SvCUR(sv)+1);
1286                 Renew(SvPVX(sv), SvLEN(sv), char);
1287             }
1288             sv = sv_2mortal(NEWSV(58, 80));
1289             continue;
1290         }
1291         else if (gimme == G_SCALAR && !tmplen && SvLEN(sv) - SvCUR(sv) > 80) {
1292             /* try to reclaim a bit of scalar space (only on 1st alloc) */
1293             if (SvCUR(sv) < 60)
1294                 SvLEN_set(sv, 80);
1295             else
1296                 SvLEN_set(sv, SvCUR(sv)+40);    /* allow some slop */
1297             Renew(SvPVX(sv), SvLEN(sv), char);
1298         }
1299         RETURN;
1300     }
1301 }
1302
1303 PP(pp_enter)
1304 {
1305     djSP;
1306     register PERL_CONTEXT *cx;
1307     I32 gimme = OP_GIMME(PL_op, -1);
1308
1309     if (gimme == -1) {
1310         if (cxstack_ix >= 0)
1311             gimme = cxstack[cxstack_ix].blk_gimme;
1312         else
1313             gimme = G_SCALAR;
1314     }
1315
1316     ENTER;
1317
1318     SAVETMPS;
1319     PUSHBLOCK(cx, CXt_BLOCK, SP);
1320
1321     RETURN;
1322 }
1323
1324 PP(pp_helem)
1325 {
1326     djSP;
1327     HE* he;
1328     SV **svp;
1329     SV *keysv = POPs;
1330     HV *hv = (HV*)POPs;
1331     U32 lval = PL_op->op_flags & OPf_MOD;
1332     U32 defer = PL_op->op_private & OPpLVAL_DEFER;
1333     SV *sv;
1334
1335     if (SvTYPE(hv) == SVt_PVHV) {
1336         he = hv_fetch_ent(hv, keysv, lval && !defer, 0);
1337         svp = he ? &HeVAL(he) : 0;
1338     }
1339     else if (SvTYPE(hv) == SVt_PVAV) {
1340         if (PL_op->op_private & OPpLVAL_INTRO)
1341             DIE("Can't localize pseudo-hash element");
1342         svp = avhv_fetch_ent((AV*)hv, keysv, lval && !defer, 0);
1343     }
1344     else {
1345         RETPUSHUNDEF;
1346     }
1347     if (lval) {
1348         if (!svp || *svp == &PL_sv_undef) {
1349             SV* lv;
1350             SV* key2;
1351             if (!defer)
1352                 DIE(no_helem, SvPV(keysv, PL_na));
1353             lv = sv_newmortal();
1354             sv_upgrade(lv, SVt_PVLV);
1355             LvTYPE(lv) = 'y';
1356             sv_magic(lv, key2 = newSVsv(keysv), 'y', Nullch, 0);
1357             SvREFCNT_dec(key2); /* sv_magic() increments refcount */
1358             LvTARG(lv) = SvREFCNT_inc(hv);
1359             LvTARGLEN(lv) = 1;
1360             PUSHs(lv);
1361             RETURN;
1362         }
1363         if (PL_op->op_private & OPpLVAL_INTRO) {
1364             if (HvNAME(hv) && isGV(*svp))
1365                 save_gp((GV*)*svp, !(PL_op->op_flags & OPf_SPECIAL));
1366             else
1367                 save_helem(hv, keysv, svp);
1368         }
1369         else if (PL_op->op_private & OPpDEREF)
1370             vivify_ref(*svp, PL_op->op_private & OPpDEREF);
1371     }
1372     sv = (svp ? *svp : &PL_sv_undef);
1373     /* This makes C<local $tied{foo} = $tied{foo}> possible.
1374      * Pushing the magical RHS on to the stack is useless, since
1375      * that magic is soon destined to be misled by the local(),
1376      * and thus the later pp_sassign() will fail to mg_get() the
1377      * old value.  This should also cure problems with delayed
1378      * mg_get()s.  GSAR 98-07-03 */
1379     if (!lval && SvGMAGICAL(sv))
1380         sv = sv_mortalcopy(sv);
1381     PUSHs(sv);
1382     RETURN;
1383 }
1384
1385 PP(pp_leave)
1386 {
1387     djSP;
1388     register PERL_CONTEXT *cx;
1389     register SV **mark;
1390     SV **newsp;
1391     PMOP *newpm;
1392     I32 gimme;
1393
1394     if (PL_op->op_flags & OPf_SPECIAL) {
1395         cx = &cxstack[cxstack_ix];
1396         cx->blk_oldpm = PL_curpm;       /* fake block should preserve $1 et al */
1397     }
1398
1399     POPBLOCK(cx,newpm);
1400
1401     gimme = OP_GIMME(PL_op, -1);
1402     if (gimme == -1) {
1403         if (cxstack_ix >= 0)
1404             gimme = cxstack[cxstack_ix].blk_gimme;
1405         else
1406             gimme = G_SCALAR;
1407     }
1408
1409     TAINT_NOT;
1410     if (gimme == G_VOID)
1411         SP = newsp;
1412     else if (gimme == G_SCALAR) {
1413         MARK = newsp + 1;
1414         if (MARK <= SP)
1415             if (SvFLAGS(TOPs) & (SVs_PADTMP|SVs_TEMP))
1416                 *MARK = TOPs;
1417             else
1418                 *MARK = sv_mortalcopy(TOPs);
1419         else {
1420             MEXTEND(mark,0);
1421             *MARK = &PL_sv_undef;
1422         }
1423         SP = MARK;
1424     }
1425     else if (gimme == G_ARRAY) {
1426         /* in case LEAVE wipes old return values */
1427         for (mark = newsp + 1; mark <= SP; mark++) {
1428             if (!(SvFLAGS(*mark) & (SVs_PADTMP|SVs_TEMP))) {
1429                 *mark = sv_mortalcopy(*mark);
1430                 TAINT_NOT;      /* Each item is independent */
1431             }
1432         }
1433     }
1434     PL_curpm = newpm;   /* Don't pop $1 et al till now */
1435
1436     LEAVE;
1437
1438     RETURN;
1439 }
1440
1441 PP(pp_iter)
1442 {
1443     djSP;
1444     register PERL_CONTEXT *cx;
1445     SV* sv;
1446     AV* av;
1447
1448     EXTEND(SP, 1);
1449     cx = &cxstack[cxstack_ix];
1450     if (cx->cx_type != CXt_LOOP)
1451         DIE("panic: pp_iter");
1452
1453     av = cx->blk_loop.iterary;
1454     if (SvTYPE(av) != SVt_PVAV) {
1455         /* iterate ($min .. $max) */
1456         if (cx->blk_loop.iterlval) {
1457             /* string increment */
1458             register SV* cur = cx->blk_loop.iterlval;
1459             STRLEN maxlen;
1460             char *max = SvPV((SV*)av, maxlen);
1461             if (!SvNIOK(cur) && SvCUR(cur) <= maxlen) {
1462 #ifndef USE_THREADS                       /* don't risk potential race */
1463                 if (SvREFCNT(*cx->blk_loop.itervar) == 1) {
1464                     /* safe to reuse old SV */
1465                     sv_setsv(*cx->blk_loop.itervar, cur);
1466                 }
1467                 else 
1468 #endif
1469                 {
1470                     /* we need a fresh SV every time so that loop body sees a
1471                      * completely new SV for closures/references to work as
1472                      * they used to */
1473                     SvREFCNT_dec(*cx->blk_loop.itervar);
1474                     *cx->blk_loop.itervar = newSVsv(cur);
1475                 }
1476                 if (strEQ(SvPVX(cur), max))
1477                     sv_setiv(cur, 0); /* terminate next time */
1478                 else
1479                     sv_inc(cur);
1480                 RETPUSHYES;
1481             }
1482             RETPUSHNO;
1483         }
1484         /* integer increment */
1485         if (cx->blk_loop.iterix > cx->blk_loop.itermax)
1486             RETPUSHNO;
1487
1488 #ifndef USE_THREADS                       /* don't risk potential race */
1489         if (SvREFCNT(*cx->blk_loop.itervar) == 1) {
1490             /* safe to reuse old SV */
1491             sv_setiv(*cx->blk_loop.itervar, cx->blk_loop.iterix++);
1492         }
1493         else 
1494 #endif
1495         {
1496             /* we need a fresh SV every time so that loop body sees a
1497              * completely new SV for closures/references to work as they
1498              * used to */
1499             SvREFCNT_dec(*cx->blk_loop.itervar);
1500             *cx->blk_loop.itervar = newSViv(cx->blk_loop.iterix++);
1501         }
1502         RETPUSHYES;
1503     }
1504
1505     /* iterate array */
1506     if (cx->blk_loop.iterix >= (av == PL_curstack ? cx->blk_oldsp : AvFILL(av)))
1507         RETPUSHNO;
1508
1509     SvREFCNT_dec(*cx->blk_loop.itervar);
1510
1511     if (sv = (SvMAGICAL(av)) 
1512             ? *av_fetch(av, ++cx->blk_loop.iterix, FALSE) 
1513             : AvARRAY(av)[++cx->blk_loop.iterix])
1514         SvTEMP_off(sv);
1515     else
1516         sv = &PL_sv_undef;
1517     if (av != PL_curstack && SvIMMORTAL(sv)) {
1518         SV *lv = cx->blk_loop.iterlval;
1519         if (lv && SvREFCNT(lv) > 1) {
1520             SvREFCNT_dec(lv);
1521             lv = Nullsv;
1522         }
1523         if (lv)
1524             SvREFCNT_dec(LvTARG(lv));
1525         else {
1526             lv = cx->blk_loop.iterlval = NEWSV(26, 0);
1527             sv_upgrade(lv, SVt_PVLV);
1528             LvTYPE(lv) = 'y';
1529             sv_magic(lv, Nullsv, 'y', Nullch, 0);
1530         }
1531         LvTARG(lv) = SvREFCNT_inc(av);
1532         LvTARGOFF(lv) = cx->blk_loop.iterix;
1533         LvTARGLEN(lv) = (UV) -1;
1534         sv = (SV*)lv;
1535     }
1536
1537     *cx->blk_loop.itervar = SvREFCNT_inc(sv);
1538     RETPUSHYES;
1539 }
1540
1541 PP(pp_subst)
1542 {
1543     djSP; dTARG;
1544     register PMOP *pm = cPMOP;
1545     PMOP *rpm = pm;
1546     register SV *dstr;
1547     register char *s;
1548     char *strend;
1549     register char *m;
1550     char *c;
1551     register char *d;
1552     STRLEN clen;
1553     I32 iters = 0;
1554     I32 maxiters;
1555     register I32 i;
1556     bool once;
1557     bool rxtainted;
1558     char *orig;
1559     I32 safebase;
1560     register REGEXP *rx = pm->op_pmregexp;
1561     STRLEN len;
1562     int force_on_match = 0;
1563     I32 oldsave = PL_savestack_ix;
1564     I32 update_minmatch = 1;
1565     SV *screamer;
1566
1567     /* known replacement string? */
1568     dstr = (pm->op_pmflags & PMf_CONST) ? POPs : Nullsv;
1569     if (PL_op->op_flags & OPf_STACKED)
1570         TARG = POPs;
1571     else {
1572         TARG = DEFSV;
1573         EXTEND(SP,1);
1574     }                  
1575     if (SvREADONLY(TARG)
1576         || (SvTYPE(TARG) > SVt_PVLV
1577             && !(SvTYPE(TARG) == SVt_PVGV && SvFAKE(TARG))))
1578         croak(no_modify);
1579     PUTBACK;
1580
1581     s = SvPV(TARG, len);
1582     if (!SvPOKp(TARG) || SvTYPE(TARG) == SVt_PVGV)
1583         force_on_match = 1;
1584     rxtainted = ((pm->op_pmdynflags & PMdf_TAINTED) ||
1585                  (PL_tainted && (pm->op_pmflags & PMf_RETAINT)));
1586     if (PL_tainted)
1587         rxtainted |= 2;
1588     TAINT_NOT;
1589
1590   force_it:
1591     if (!pm || !s)
1592         DIE("panic: do_subst");
1593
1594     strend = s + len;
1595     maxiters = 2*(strend - s) + 10;     /* We can match twice at each 
1596                                            position, once with zero-length,
1597                                            second time with non-zero. */
1598
1599     if (!rx->prelen && PL_curpm) {
1600         pm = PL_curpm;
1601         rx = pm->op_pmregexp;
1602     }
1603     screamer = ( (SvSCREAM(TARG) && rx->check_substr
1604                   && SvTYPE(rx->check_substr) == SVt_PVBM
1605                   && SvVALID(rx->check_substr)) 
1606                 ? TARG : Nullsv);
1607     safebase = (!rx->nparens && !PL_sawampersand) ? 0 : REXEC_COPY_STR;
1608     if (pm->op_pmflags & (PMf_MULTILINE|PMf_SINGLELINE)) {
1609         SAVEINT(PL_multiline);
1610         PL_multiline = pm->op_pmflags & PMf_MULTILINE;
1611     }
1612     orig = m = s;
1613     if (rx->check_substr) {
1614         if (!(rx->reganch & ROPT_NOSCAN)) { /* It floats. */
1615             if (screamer) {
1616                 I32 p = -1;
1617                 
1618                 if (PL_screamfirst[BmRARE(rx->check_substr)] < 0)
1619                     goto nope;
1620                 else if (!(s = screaminstr(TARG, rx->check_substr, rx->check_offset_min, 0, &p, 0)))
1621                     goto nope;
1622             }
1623             else if (!(s = fbm_instr((unsigned char*)s + rx->check_offset_min, 
1624                                      (unsigned char*)strend,
1625                                      rx->check_substr, 0)))
1626                 goto nope;
1627             if (s && rx->check_offset_max < s - m) {
1628                 ++BmUSEFUL(rx->check_substr);
1629                 s -= rx->check_offset_max;
1630             }
1631             else
1632                 s = m;
1633         }
1634         /* Now checkstring is fixed, i.e. at fixed offset from the
1635            beginning of match, and the match is anchored at s. */
1636         else if (!PL_multiline) { /* Anchored at beginning of string. */
1637             I32 slen;
1638             if (*SvPVX(rx->check_substr) != s[rx->check_offset_min]
1639                 || ((slen = SvCUR(rx->check_substr)) > 1
1640                     && memNE(SvPVX(rx->check_substr), 
1641                              s + rx->check_offset_min, slen)))
1642                 goto nope;
1643         }
1644         if (!rx->naughty && --BmUSEFUL(rx->check_substr) < 0
1645             && rx->check_substr == rx->float_substr) {
1646             SvREFCNT_dec(rx->check_substr);
1647             rx->check_substr = Nullsv;  /* opt is being useless */
1648             rx->float_substr = Nullsv;
1649         }
1650     }
1651
1652     /* only replace once? */
1653     once = !(rpm->op_pmflags & PMf_GLOBAL);
1654
1655     /* known replacement string? */
1656     c = dstr ? SvPV(dstr, clen) : Nullch;
1657
1658     /* can do inplace substitution? */
1659     if (c && clen <= rx->minlen && (once || !(safebase & REXEC_COPY_STR))
1660         && !(rx->reganch & ROPT_LOOKBEHIND_SEEN)) {
1661         if (!CALLREGEXEC(rx, s, strend, orig, 0, screamer, NULL, safebase)) {
1662             SPAGAIN;
1663             PUSHs(&PL_sv_no);
1664             LEAVE_SCOPE(oldsave);
1665             RETURN;
1666         }
1667         if (force_on_match) {
1668             force_on_match = 0;
1669             s = SvPV_force(TARG, len);
1670             goto force_it;
1671         }
1672         d = s;
1673         PL_curpm = pm;
1674         SvSCREAM_off(TARG);     /* disable possible screamer */
1675         if (once) {
1676             rxtainted |= RX_MATCH_TAINTED(rx);
1677             if (rx->subbase) {
1678                 m = orig + (rx->startp[0] - rx->subbase);
1679                 d = orig + (rx->endp[0] - rx->subbase);
1680             } else {
1681                 m = rx->startp[0];
1682                 d = rx->endp[0];
1683             }
1684             s = orig;
1685             if (m - s > strend - d) {  /* faster to shorten from end */
1686                 if (clen) {
1687                     Copy(c, m, clen, char);
1688                     m += clen;
1689                 }
1690                 i = strend - d;
1691                 if (i > 0) {
1692                     Move(d, m, i, char);
1693                     m += i;
1694                 }
1695                 *m = '\0';
1696                 SvCUR_set(TARG, m - s);
1697             }
1698             /*SUPPRESS 560*/
1699             else if (i = m - s) {       /* faster from front */
1700                 d -= clen;
1701                 m = d;
1702                 sv_chop(TARG, d-i);
1703                 s += i;
1704                 while (i--)
1705                     *--d = *--s;
1706                 if (clen)
1707                     Copy(c, m, clen, char);
1708             }
1709             else if (clen) {
1710                 d -= clen;
1711                 sv_chop(TARG, d);
1712                 Copy(c, d, clen, char);
1713             }
1714             else {
1715                 sv_chop(TARG, d);
1716             }
1717             TAINT_IF(rxtainted & 1);
1718             SPAGAIN;
1719             PUSHs(&PL_sv_yes);
1720         }
1721         else {
1722             do {
1723                 if (iters++ > maxiters)
1724                     DIE("Substitution loop");
1725                 rxtainted |= RX_MATCH_TAINTED(rx);
1726                 m = rx->startp[0];
1727                 /*SUPPRESS 560*/
1728                 if (i = m - s) {
1729                     if (s != d)
1730                         Move(s, d, i, char);
1731                     d += i;
1732                 }
1733                 if (clen) {
1734                     Copy(c, d, clen, char);
1735                     d += clen;
1736                 }
1737                 s = rx->endp[0];
1738             } while (CALLREGEXEC(rx, s, strend, orig, s == m,
1739                               Nullsv, NULL, 0)); /* don't match same null twice */
1740             if (s != d) {
1741                 i = strend - s;
1742                 SvCUR_set(TARG, d - SvPVX(TARG) + i);
1743                 Move(s, d, i+1, char);          /* include the NUL */
1744             }
1745             TAINT_IF(rxtainted & 1);
1746             SPAGAIN;
1747             PUSHs(sv_2mortal(newSViv((I32)iters)));
1748         }
1749         (void)SvPOK_only(TARG);
1750         TAINT_IF(rxtainted);
1751         if (SvSMAGICAL(TARG)) {
1752             PUTBACK;
1753             mg_set(TARG);
1754             SPAGAIN;
1755         }
1756         SvTAINT(TARG);
1757         LEAVE_SCOPE(oldsave);
1758         RETURN;
1759     }
1760
1761     if (CALLREGEXEC(rx, s, strend, orig, 0, screamer, NULL, safebase)) {
1762         if (force_on_match) {
1763             force_on_match = 0;
1764             s = SvPV_force(TARG, len);
1765             goto force_it;
1766         }
1767         rxtainted |= RX_MATCH_TAINTED(rx);
1768         dstr = NEWSV(25, len);
1769         sv_setpvn(dstr, m, s-m);
1770         PL_curpm = pm;
1771         if (!c) {
1772             register PERL_CONTEXT *cx;
1773             SPAGAIN;
1774             PUSHSUBST(cx);
1775             RETURNOP(cPMOP->op_pmreplroot);
1776         }
1777         do {
1778             if (iters++ > maxiters)
1779                 DIE("Substitution loop");
1780             rxtainted |= RX_MATCH_TAINTED(rx);
1781             if (rx->subbase && rx->subbase != orig) {
1782                 m = s;
1783                 s = orig;
1784                 orig = rx->subbase;
1785                 s = orig + (m - s);
1786                 strend = s + (strend - m);
1787             }
1788             m = rx->startp[0];
1789             sv_catpvn(dstr, s, m-s);
1790             s = rx->endp[0];
1791             if (clen)
1792                 sv_catpvn(dstr, c, clen);
1793             if (once)
1794                 break;
1795         } while (CALLREGEXEC(rx, s, strend, orig, s == m, Nullsv, NULL, safebase));
1796         sv_catpvn(dstr, s, strend - s);
1797
1798         (void)SvOOK_off(TARG);
1799         Safefree(SvPVX(TARG));
1800         SvPVX(TARG) = SvPVX(dstr);
1801         SvCUR_set(TARG, SvCUR(dstr));
1802         SvLEN_set(TARG, SvLEN(dstr));
1803         SvPVX(dstr) = 0;
1804         sv_free(dstr);
1805
1806         TAINT_IF(rxtainted & 1);
1807         SPAGAIN;
1808         PUSHs(sv_2mortal(newSViv((I32)iters)));
1809
1810         (void)SvPOK_only(TARG);
1811         TAINT_IF(rxtainted);
1812         SvSETMAGIC(TARG);
1813         SvTAINT(TARG);
1814         LEAVE_SCOPE(oldsave);
1815         RETURN;
1816     }
1817     goto ret_no;
1818
1819 nope:
1820     ++BmUSEFUL(rx->check_substr);
1821
1822 ret_no:         
1823     SPAGAIN;
1824     PUSHs(&PL_sv_no);
1825     LEAVE_SCOPE(oldsave);
1826     RETURN;
1827 }
1828
1829 PP(pp_grepwhile)
1830 {
1831     djSP;
1832
1833     if (SvTRUEx(POPs))
1834         PL_stack_base[PL_markstack_ptr[-1]++] = PL_stack_base[*PL_markstack_ptr];
1835     ++*PL_markstack_ptr;
1836     LEAVE;                                      /* exit inner scope */
1837
1838     /* All done yet? */
1839     if (PL_stack_base + *PL_markstack_ptr > SP) {
1840         I32 items;
1841         I32 gimme = GIMME_V;
1842
1843         LEAVE;                                  /* exit outer scope */
1844         (void)POPMARK;                          /* pop src */
1845         items = --*PL_markstack_ptr - PL_markstack_ptr[-1];
1846         (void)POPMARK;                          /* pop dst */
1847         SP = PL_stack_base + POPMARK;           /* pop original mark */
1848         if (gimme == G_SCALAR) {
1849             dTARGET;
1850             XPUSHi(items);
1851         }
1852         else if (gimme == G_ARRAY)
1853             SP += items;
1854         RETURN;
1855     }
1856     else {
1857         SV *src;
1858
1859         ENTER;                                  /* enter inner scope */
1860         SAVESPTR(PL_curpm);
1861
1862         src = PL_stack_base[*PL_markstack_ptr];
1863         SvTEMP_off(src);
1864         DEFSV = src;
1865
1866         RETURNOP(cLOGOP->op_other);
1867     }
1868 }
1869
1870 PP(pp_leavesub)
1871 {
1872     djSP;
1873     SV **mark;
1874     SV **newsp;
1875     PMOP *newpm;
1876     I32 gimme;
1877     register PERL_CONTEXT *cx;
1878     struct block_sub cxsub;
1879
1880     POPBLOCK(cx,newpm);
1881     POPSUB1(cx);        /* Delay POPSUB2 until stack values are safe */
1882  
1883     TAINT_NOT;
1884     if (gimme == G_SCALAR) {
1885         MARK = newsp + 1;
1886         if (MARK <= SP) {
1887             if (cxsub.cv && CvDEPTH(cxsub.cv) > 1) {
1888                 if (SvTEMP(TOPs)) {
1889                     *MARK = SvREFCNT_inc(TOPs);
1890                     FREETMPS;
1891                     sv_2mortal(*MARK);
1892                 } else {
1893                     FREETMPS;
1894                     *MARK = sv_mortalcopy(TOPs);
1895                 }
1896             } else
1897                 *MARK = SvTEMP(TOPs) ? TOPs : sv_mortalcopy(TOPs);
1898         } else {
1899             MEXTEND(MARK, 0);
1900             *MARK = &PL_sv_undef;
1901         }
1902         SP = MARK;
1903     }
1904     else if (gimme == G_ARRAY) {
1905         for (MARK = newsp + 1; MARK <= SP; MARK++) {
1906             if (!SvTEMP(*MARK)) {
1907                 *MARK = sv_mortalcopy(*MARK);
1908                 TAINT_NOT;      /* Each item is independent */
1909             }
1910         }
1911     }
1912     PUTBACK;
1913     
1914     POPSUB2();          /* Stack values are safe: release CV and @_ ... */
1915     PL_curpm = newpm;   /* ... and pop $1 et al */
1916
1917     LEAVE;
1918     return pop_return();
1919 }
1920
1921 STATIC CV *
1922 get_db_sub(SV **svp, CV *cv)
1923 {
1924     dTHR;
1925     SV *dbsv = GvSV(PL_DBsub);
1926
1927     if (!PERLDB_SUB_NN) {
1928         GV *gv = CvGV(cv);
1929
1930         save_item(dbsv);
1931         if ( (CvFLAGS(cv) & (CVf_ANON | CVf_CLONED))
1932              || strEQ(GvNAME(gv), "END") 
1933              || ((GvCV(gv) != cv) && /* Could be imported, and old sub redefined. */
1934                  !( (SvTYPE(*svp) == SVt_PVGV) && (GvCV((GV*)*svp) == cv)
1935                     && (gv = (GV*)*svp) ))) {
1936             /* Use GV from the stack as a fallback. */
1937             /* GV is potentially non-unique, or contain different CV. */
1938             sv_setsv(dbsv, newRV((SV*)cv));
1939         }
1940         else {
1941             gv_efullname3(dbsv, gv, Nullch);
1942         }
1943     }
1944     else {
1945         SvUPGRADE(dbsv, SVt_PVIV);
1946         SvIOK_on(dbsv);
1947         SAVEIV(SvIVX(dbsv));
1948         SvIVX(dbsv) = (IV)cv;           /* Do it the quickest way  */
1949     }
1950
1951     if (CvXSUB(cv))
1952         PL_curcopdb = PL_curcop;
1953     cv = GvCV(PL_DBsub);
1954     return cv;
1955 }
1956
1957 PP(pp_entersub)
1958 {
1959     djSP; dPOPss;
1960     GV *gv;
1961     HV *stash;
1962     register CV *cv;
1963     register PERL_CONTEXT *cx;
1964     I32 gimme;
1965     bool hasargs = (PL_op->op_flags & OPf_STACKED) != 0;
1966
1967     if (!sv)
1968         DIE("Not a CODE reference");
1969     switch (SvTYPE(sv)) {
1970     default:
1971         if (!SvROK(sv)) {
1972             char *sym;
1973
1974             if (sv == &PL_sv_yes) {             /* unfound import, ignore */
1975                 if (hasargs)
1976                     SP = PL_stack_base + POPMARK;
1977                 RETURN;
1978             }
1979             if (SvGMAGICAL(sv)) {
1980                 mg_get(sv);
1981                 sym = SvPOKp(sv) ? SvPVX(sv) : Nullch;
1982             }
1983             else
1984                 sym = SvPV(sv, PL_na);
1985             if (!sym)
1986                 DIE(no_usym, "a subroutine");
1987             if (PL_op->op_private & HINT_STRICT_REFS)
1988                 DIE(no_symref, sym, "a subroutine");
1989             cv = perl_get_cv(sym, TRUE);
1990             break;
1991         }
1992         cv = (CV*)SvRV(sv);
1993         if (SvTYPE(cv) == SVt_PVCV)
1994             break;
1995         /* FALL THROUGH */
1996     case SVt_PVHV:
1997     case SVt_PVAV:
1998         DIE("Not a CODE reference");
1999     case SVt_PVCV:
2000         cv = (CV*)sv;
2001         break;
2002     case SVt_PVGV:
2003         if (!(cv = GvCVu((GV*)sv)))
2004             cv = sv_2cv(sv, &stash, &gv, TRUE);
2005         break;
2006     }
2007
2008     ENTER;
2009     SAVETMPS;
2010
2011   retry:
2012     if (!cv)
2013         DIE("Not a CODE reference");
2014
2015     if (!CvROOT(cv) && !CvXSUB(cv)) {
2016         GV* autogv;
2017         SV* sub_name;
2018
2019         /* anonymous or undef'd function leaves us no recourse */
2020         if (CvANON(cv) || !(gv = CvGV(cv)))
2021             DIE("Undefined subroutine called");
2022         /* autoloaded stub? */
2023         if (cv != GvCV(gv)) {
2024             cv = GvCV(gv);
2025             goto retry;
2026         }
2027         /* should call AUTOLOAD now? */
2028         if ((autogv = gv_autoload4(GvSTASH(gv), GvNAME(gv), GvNAMELEN(gv),
2029                                    FALSE)))
2030         {
2031             cv = GvCV(autogv);
2032             goto retry;
2033         }
2034         /* sorry */
2035         sub_name = sv_newmortal();
2036         gv_efullname3(sub_name, gv, Nullch);
2037         DIE("Undefined subroutine &%s called", SvPVX(sub_name));
2038     }
2039
2040     gimme = GIMME_V;
2041     if ((PL_op->op_private & OPpENTERSUB_DB) && GvCV(PL_DBsub) && !CvNODEBUG(cv))
2042         cv = get_db_sub(&sv, cv);
2043     if (!cv)
2044         DIE("No DBsub routine");
2045
2046 #ifdef USE_THREADS
2047     /*
2048      * First we need to check if the sub or method requires locking.
2049      * If so, we gain a lock on the CV, the first argument or the
2050      * stash (for static methods), as appropriate. This has to be
2051      * inline because for FAKE_THREADS, COND_WAIT inlines code to
2052      * reschedule by returning a new op.
2053      */
2054     MUTEX_LOCK(CvMUTEXP(cv));
2055     if (CvFLAGS(cv) & CVf_LOCKED) {
2056         MAGIC *mg;      
2057         if (CvFLAGS(cv) & CVf_METHOD) {
2058             if (SP > PL_stack_base + TOPMARK)
2059                 sv = *(PL_stack_base + TOPMARK + 1);
2060             else {
2061                 MUTEX_UNLOCK(CvMUTEXP(cv));
2062                 croak("no argument for locked method call");
2063             }
2064             if (SvROK(sv))
2065                 sv = SvRV(sv);
2066             else {              
2067                 STRLEN len;
2068                 char *stashname = SvPV(sv, len);
2069                 sv = (SV*)gv_stashpvn(stashname, len, TRUE);
2070             }
2071         }
2072         else {
2073             sv = (SV*)cv;
2074         }
2075         MUTEX_UNLOCK(CvMUTEXP(cv));
2076         mg = condpair_magic(sv);
2077         MUTEX_LOCK(MgMUTEXP(mg));
2078         if (MgOWNER(mg) == thr)
2079             MUTEX_UNLOCK(MgMUTEXP(mg));
2080         else {
2081             while (MgOWNER(mg))
2082                 COND_WAIT(MgOWNERCONDP(mg), MgMUTEXP(mg));
2083             MgOWNER(mg) = thr;
2084             DEBUG_L(PerlIO_printf(PerlIO_stderr(), "%p: pp_entersub lock %p\n",
2085                                   thr, sv);)
2086             MUTEX_UNLOCK(MgMUTEXP(mg));
2087             SvREFCNT_inc(sv);   /* Keep alive until magic_mutexfree */
2088             save_destructor(unlock_condpair, sv);
2089         }
2090         MUTEX_LOCK(CvMUTEXP(cv));
2091     }
2092     /*
2093      * Now we have permission to enter the sub, we must distinguish
2094      * four cases. (0) It's an XSUB (in which case we don't care
2095      * about ownership); (1) it's ours already (and we're recursing);
2096      * (2) it's free (but we may already be using a cached clone);
2097      * (3) another thread owns it. Case (1) is easy: we just use it.
2098      * Case (2) means we look for a clone--if we have one, use it
2099      * otherwise grab ownership of cv. Case (3) means we look for a
2100      * clone (for non-XSUBs) and have to create one if we don't
2101      * already have one.
2102      * Why look for a clone in case (2) when we could just grab
2103      * ownership of cv straight away? Well, we could be recursing,
2104      * i.e. we originally tried to enter cv while another thread
2105      * owned it (hence we used a clone) but it has been freed up
2106      * and we're now recursing into it. It may or may not be "better"
2107      * to use the clone but at least CvDEPTH can be trusted.
2108      */
2109     if (CvOWNER(cv) == thr || CvXSUB(cv))
2110         MUTEX_UNLOCK(CvMUTEXP(cv));
2111     else {
2112         /* Case (2) or (3) */
2113         SV **svp;
2114         
2115         /*
2116          * XXX Might it be better to release CvMUTEXP(cv) while we
2117          * do the hv_fetch? We might find someone has pinched it
2118          * when we look again, in which case we would be in case
2119          * (3) instead of (2) so we'd have to clone. Would the fact
2120          * that we released the mutex more quickly make up for this?
2121          */
2122         if (PL_threadnum &&
2123             (svp = hv_fetch(thr->cvcache, (char *)cv, sizeof(cv), FALSE)))
2124         {
2125             /* We already have a clone to use */
2126             MUTEX_UNLOCK(CvMUTEXP(cv));
2127             cv = *(CV**)svp;
2128             DEBUG_L(PerlIO_printf(PerlIO_stderr(),
2129                                   "entersub: %p already has clone %p:%s\n",
2130                                   thr, cv, SvPEEK((SV*)cv)));
2131             CvOWNER(cv) = thr;
2132             SvREFCNT_inc(cv);
2133             if (CvDEPTH(cv) == 0)
2134                 SAVEDESTRUCTOR(unset_cvowner, (void*) cv);
2135         }
2136         else {
2137             /* (2) => grab ownership of cv. (3) => make clone */
2138             if (!CvOWNER(cv)) {
2139                 CvOWNER(cv) = thr;
2140                 SvREFCNT_inc(cv);
2141                 MUTEX_UNLOCK(CvMUTEXP(cv));
2142                 DEBUG_L(PerlIO_printf(PerlIO_stderr(),
2143                             "entersub: %p grabbing %p:%s in stash %s\n",
2144                             thr, cv, SvPEEK((SV*)cv), CvSTASH(cv) ?
2145                                 HvNAME(CvSTASH(cv)) : "(none)"));
2146             } else {
2147                 /* Make a new clone. */
2148                 CV *clonecv;
2149                 SvREFCNT_inc(cv); /* don't let it vanish from under us */
2150                 MUTEX_UNLOCK(CvMUTEXP(cv));
2151                 DEBUG_L((PerlIO_printf(PerlIO_stderr(),
2152                                        "entersub: %p cloning %p:%s\n",
2153                                        thr, cv, SvPEEK((SV*)cv))));
2154                 /*
2155                  * We're creating a new clone so there's no race
2156                  * between the original MUTEX_UNLOCK and the
2157                  * SvREFCNT_inc since no one will be trying to undef
2158                  * it out from underneath us. At least, I don't think
2159                  * there's a race...
2160                  */
2161                 clonecv = cv_clone(cv);
2162                 SvREFCNT_dec(cv); /* finished with this */
2163                 hv_store(thr->cvcache, (char*)cv, sizeof(cv), (SV*)clonecv,0);
2164                 CvOWNER(clonecv) = thr;
2165                 cv = clonecv;
2166                 SvREFCNT_inc(cv);
2167             }
2168             DEBUG_L(if (CvDEPTH(cv) != 0)
2169                         PerlIO_printf(PerlIO_stderr(), "depth %ld != 0\n",
2170                                       CvDEPTH(cv)););
2171             SAVEDESTRUCTOR(unset_cvowner, (void*) cv);
2172         }
2173     }
2174 #endif /* USE_THREADS */
2175
2176     if (CvXSUB(cv)) {
2177         if (CvOLDSTYLE(cv)) {
2178             I32 (*fp3)_((int,int,int));
2179             dMARK;
2180             register I32 items = SP - MARK;
2181                                         /* We dont worry to copy from @_. */
2182             while (SP > mark) {
2183                 SP[1] = SP[0];
2184                 SP--;
2185             }
2186             PL_stack_sp = mark + 1;
2187             fp3 = (I32(*)_((int,int,int)))CvXSUB(cv);
2188             items = (*fp3)(CvXSUBANY(cv).any_i32, 
2189                            MARK - PL_stack_base + 1,
2190                            items);
2191             PL_stack_sp = PL_stack_base + items;
2192         }
2193         else {
2194             I32 markix = TOPMARK;
2195
2196             PUTBACK;
2197
2198             if (!hasargs) {
2199                 /* Need to copy @_ to stack. Alternative may be to
2200                  * switch stack to @_, and copy return values
2201                  * back. This would allow popping @_ in XSUB, e.g.. XXXX */
2202                 AV* av;
2203                 I32 items;
2204 #ifdef USE_THREADS
2205                 av = (AV*)PL_curpad[0];
2206 #else
2207                 av = GvAV(PL_defgv);
2208 #endif /* USE_THREADS */                
2209                 items = AvFILLp(av) + 1;   /* @_ is not tieable */
2210
2211                 if (items) {
2212                     /* Mark is at the end of the stack. */
2213                     EXTEND(SP, items);
2214                     Copy(AvARRAY(av), SP + 1, items, SV*);
2215                     SP += items;
2216                     PUTBACK ;               
2217                 }
2218             }
2219             if (PL_curcopdb) {          /* We assume that the first
2220                                            XSUB in &DB::sub is the
2221                                            called one. */
2222                 SAVESPTR(PL_curcop);
2223                 PL_curcop = PL_curcopdb;
2224                 PL_curcopdb = NULL;
2225             }
2226             /* Do we need to open block here? XXXX */
2227             (void)(*CvXSUB(cv))(cv _PERL_OBJECT_THIS);
2228
2229             /* Enforce some sanity in scalar context. */
2230             if (gimme == G_SCALAR && ++markix != PL_stack_sp - PL_stack_base ) {
2231                 if (markix > PL_stack_sp - PL_stack_base)
2232                     *(PL_stack_base + markix) = &PL_sv_undef;
2233                 else
2234                     *(PL_stack_base + markix) = *PL_stack_sp;
2235                 PL_stack_sp = PL_stack_base + markix;
2236             }
2237         }
2238         LEAVE;
2239         return NORMAL;
2240     }
2241     else {
2242         dMARK;
2243         register I32 items = SP - MARK;
2244         AV* padlist = CvPADLIST(cv);
2245         SV** svp = AvARRAY(padlist);
2246         push_return(PL_op->op_next);
2247         PUSHBLOCK(cx, CXt_SUB, MARK);
2248         PUSHSUB(cx);
2249         CvDEPTH(cv)++;
2250         if (CvDEPTH(cv) < 2)
2251             (void)SvREFCNT_inc(cv);
2252         else {  /* save temporaries on recursion? */
2253             if (CvDEPTH(cv) == 100 && PL_dowarn 
2254                   && !(PERLDB_SUB && cv == GvCV(PL_DBsub)))
2255                 sub_crush_depth(cv);
2256             if (CvDEPTH(cv) > AvFILLp(padlist)) {
2257                 AV *av;
2258                 AV *newpad = newAV();
2259                 SV **oldpad = AvARRAY(svp[CvDEPTH(cv)-1]);
2260                 I32 ix = AvFILLp((AV*)svp[1]);
2261                 svp = AvARRAY(svp[0]);
2262                 for ( ;ix > 0; ix--) {
2263                     if (svp[ix] != &PL_sv_undef) {
2264                         char *name = SvPVX(svp[ix]);
2265                         if ((SvFLAGS(svp[ix]) & SVf_FAKE) /* outer lexical? */
2266                             || *name == '&')              /* anonymous code? */
2267                         {
2268                             av_store(newpad, ix, SvREFCNT_inc(oldpad[ix]));
2269                         }
2270                         else {                          /* our own lexical */
2271                             if (*name == '@')
2272                                 av_store(newpad, ix, sv = (SV*)newAV());
2273                             else if (*name == '%')
2274                                 av_store(newpad, ix, sv = (SV*)newHV());
2275                             else
2276                                 av_store(newpad, ix, sv = NEWSV(0,0));
2277                             SvPADMY_on(sv);
2278                         }
2279                     }
2280                     else {
2281                         av_store(newpad, ix, sv = NEWSV(0,0));
2282                         SvPADTMP_on(sv);
2283                     }
2284                 }
2285                 av = newAV();           /* will be @_ */
2286                 av_extend(av, 0);
2287                 av_store(newpad, 0, (SV*)av);
2288                 AvFLAGS(av) = AVf_REIFY;
2289                 av_store(padlist, CvDEPTH(cv), (SV*)newpad);
2290                 AvFILLp(padlist) = CvDEPTH(cv);
2291                 svp = AvARRAY(padlist);
2292             }
2293         }
2294 #ifdef USE_THREADS
2295         if (!hasargs) {
2296             AV* av = (AV*)PL_curpad[0];
2297
2298             items = AvFILLp(av) + 1;
2299             if (items) {
2300                 /* Mark is at the end of the stack. */
2301                 EXTEND(SP, items);
2302                 Copy(AvARRAY(av), SP + 1, items, SV*);
2303                 SP += items;
2304                 PUTBACK ;                   
2305             }
2306         }
2307 #endif /* USE_THREADS */                
2308         SAVESPTR(PL_curpad);
2309         PL_curpad = AvARRAY((AV*)svp[CvDEPTH(cv)]);
2310 #ifndef USE_THREADS
2311         if (hasargs)
2312 #endif /* USE_THREADS */
2313         {
2314             AV* av;
2315             SV** ary;
2316
2317 #if 0
2318             DEBUG_L(PerlIO_printf(PerlIO_stderr(),
2319                                   "%p entersub preparing @_\n", thr));
2320 #endif
2321             av = (AV*)PL_curpad[0];
2322             if (AvREAL(av)) {
2323                 av_clear(av);
2324                 AvREAL_off(av);
2325             }
2326 #ifndef USE_THREADS
2327             cx->blk_sub.savearray = GvAV(PL_defgv);
2328             GvAV(PL_defgv) = (AV*)SvREFCNT_inc(av);
2329 #endif /* USE_THREADS */
2330             cx->blk_sub.argarray = av;
2331             ++MARK;
2332
2333             if (items > AvMAX(av) + 1) {
2334                 ary = AvALLOC(av);
2335                 if (AvARRAY(av) != ary) {
2336                     AvMAX(av) += AvARRAY(av) - AvALLOC(av);
2337                     SvPVX(av) = (char*)ary;
2338                 }
2339                 if (items > AvMAX(av) + 1) {
2340                     AvMAX(av) = items - 1;
2341                     Renew(ary,items,SV*);
2342                     AvALLOC(av) = ary;
2343                     SvPVX(av) = (char*)ary;
2344                 }
2345             }
2346             Copy(MARK,AvARRAY(av),items,SV*);
2347             AvFILLp(av) = items - 1;
2348             
2349             while (items--) {
2350                 if (*MARK)
2351                     SvTEMP_off(*MARK);
2352                 MARK++;
2353             }
2354         }
2355 #if 0
2356         DEBUG_L(PerlIO_printf(PerlIO_stderr(),
2357                               "%p entersub returning %p\n", thr, CvSTART(cv)));
2358 #endif
2359         RETURNOP(CvSTART(cv));
2360     }
2361 }
2362
2363 void
2364 sub_crush_depth(CV *cv)
2365 {
2366     if (CvANON(cv))
2367         warn("Deep recursion on anonymous subroutine");
2368     else {
2369         SV* tmpstr = sv_newmortal();
2370         gv_efullname3(tmpstr, CvGV(cv), Nullch);
2371         warn("Deep recursion on subroutine \"%s\"", SvPVX(tmpstr));
2372     }
2373 }
2374
2375 PP(pp_aelem)
2376 {
2377     djSP;
2378     SV** svp;
2379     I32 elem = POPi;
2380     AV* av = (AV*)POPs;
2381     U32 lval = PL_op->op_flags & OPf_MOD;
2382     U32 defer = (PL_op->op_private & OPpLVAL_DEFER) && (elem > AvFILL(av));
2383     SV *sv;
2384
2385     if (elem > 0)
2386         elem -= PL_curcop->cop_arybase;
2387     if (SvTYPE(av) != SVt_PVAV)
2388         RETPUSHUNDEF;
2389     svp = av_fetch(av, elem, lval && !defer);
2390     if (lval) {
2391         if (!svp || *svp == &PL_sv_undef) {
2392             SV* lv;
2393             if (!defer)
2394                 DIE(no_aelem, elem);
2395             lv = sv_newmortal();
2396             sv_upgrade(lv, SVt_PVLV);
2397             LvTYPE(lv) = 'y';
2398             sv_magic(lv, Nullsv, 'y', Nullch, 0);
2399             LvTARG(lv) = SvREFCNT_inc(av);
2400             LvTARGOFF(lv) = elem;
2401             LvTARGLEN(lv) = 1;
2402             PUSHs(lv);
2403             RETURN;
2404         }
2405         if (PL_op->op_private & OPpLVAL_INTRO)
2406             save_aelem(av, elem, svp);
2407         else if (PL_op->op_private & OPpDEREF)
2408             vivify_ref(*svp, PL_op->op_private & OPpDEREF);
2409     }
2410     sv = (svp ? *svp : &PL_sv_undef);
2411     if (!lval && SvGMAGICAL(sv))        /* see note in pp_helem() */
2412         sv = sv_mortalcopy(sv);
2413     PUSHs(sv);
2414     RETURN;
2415 }
2416
2417 void
2418 vivify_ref(SV *sv, U32 to_what)
2419 {
2420     if (SvGMAGICAL(sv))
2421         mg_get(sv);
2422     if (!SvOK(sv)) {
2423         if (SvREADONLY(sv))
2424             croak(no_modify);
2425         if (SvTYPE(sv) < SVt_RV)
2426             sv_upgrade(sv, SVt_RV);
2427         else if (SvTYPE(sv) >= SVt_PV) {
2428             (void)SvOOK_off(sv);
2429             Safefree(SvPVX(sv));
2430             SvLEN(sv) = SvCUR(sv) = 0;
2431         }
2432         switch (to_what) {
2433         case OPpDEREF_SV:
2434             SvRV(sv) = NEWSV(355,0);
2435             break;
2436         case OPpDEREF_AV:
2437             SvRV(sv) = (SV*)newAV();
2438             break;
2439         case OPpDEREF_HV:
2440             SvRV(sv) = (SV*)newHV();
2441             break;
2442         }
2443         SvROK_on(sv);
2444         SvSETMAGIC(sv);
2445     }
2446 }
2447
2448 PP(pp_method)
2449 {
2450     djSP;
2451     SV* sv;
2452     SV* ob;
2453     GV* gv;
2454     HV* stash;
2455     char* name;
2456     char* packname;
2457     STRLEN packlen;
2458
2459     if (SvROK(TOPs)) {
2460         sv = SvRV(TOPs);
2461         if (SvTYPE(sv) == SVt_PVCV) {
2462             SETs(sv);
2463             RETURN;
2464         }
2465     }
2466
2467     name = SvPV(TOPs, PL_na);
2468     sv = *(PL_stack_base + TOPMARK + 1);
2469     
2470     if (SvGMAGICAL(sv))
2471         mg_get(sv);
2472     if (SvROK(sv))
2473         ob = (SV*)SvRV(sv);
2474     else {
2475         GV* iogv;
2476
2477         packname = Nullch;
2478         if (!SvOK(sv) ||
2479             !(packname = SvPV(sv, packlen)) ||
2480             !(iogv = gv_fetchpv(packname, FALSE, SVt_PVIO)) ||
2481             !(ob=(SV*)GvIO(iogv)))
2482         {
2483             if (!packname || !isIDFIRST(*packname))
2484                 DIE("Can't call method \"%s\" %s", name,
2485                     SvOK(sv)? "without a package or object reference"
2486                             : "on an undefined value");
2487             stash = gv_stashpvn(packname, packlen, TRUE);
2488             goto fetch;
2489         }
2490         *(PL_stack_base + TOPMARK + 1) = sv_2mortal(newRV((SV*)iogv));
2491     }
2492
2493     if (!ob || !SvOBJECT(ob))
2494         DIE("Can't call method \"%s\" on unblessed reference", name);
2495
2496     stash = SvSTASH(ob);
2497
2498   fetch:
2499     gv = gv_fetchmethod(stash, name);
2500     if (!gv) {
2501         char* leaf = name;
2502         char* sep = Nullch;
2503         char* p;
2504
2505         for (p = name; *p; p++) {
2506             if (*p == '\'')
2507                 sep = p, leaf = p + 1;
2508             else if (*p == ':' && *(p + 1) == ':')
2509                 sep = p, leaf = p + 2;
2510         }
2511         if (!sep || ((sep - name) == 5 && strnEQ(name, "SUPER", 5))) {
2512             packname = HvNAME(sep ? PL_curcop->cop_stash : stash);
2513             packlen = strlen(packname);
2514         }
2515         else {
2516             packname = name;
2517             packlen = sep - name;
2518         }
2519         DIE("Can't locate object method \"%s\" via package \"%.*s\"",
2520             leaf, (int)packlen, packname);
2521     }
2522     SETs(isGV(gv) ? (SV*)GvCV(gv) : (SV*)gv);
2523     RETURN;
2524 }
2525