1 /* This file is part of the Scope::Upper Perl module.
2 * See http://search.cpan.org/dist/Scope-Upper/ */
4 #define PERL_NO_GET_CONTEXT
9 #define __PACKAGE__ "Scope::Upper"
15 /* --- Compatibility ------------------------------------------------------- */
17 #ifndef PERL_UNUSED_VAR
18 # define PERL_UNUSED_VAR(V)
22 # define STMT_START do
26 # define STMT_END while (0)
30 # define SU_D(X) STMT_START X STMT_END
36 # define Newx(v, n, c) New(0, v, n, c)
40 # define SvPV_const(S, L) SvPV(S, L)
43 #ifndef SvPV_nolen_const
44 # define SvPV_nolen_const(S) SvPV_nolen(S)
48 # define HvNAME_get(H) HvNAME(H)
51 #ifndef ENTER_with_name
52 # define ENTER_with_name(N) ENTER
55 #ifndef LEAVE_with_name
56 # define LEAVE_with_name(N) LEAVE
59 #ifndef gv_fetchpvn_flags
60 # define gv_fetchpvn_flags(A, B, C, D) gv_fetchpv((A), (C), (D))
63 #ifndef PERL_MAGIC_tied
64 # define PERL_MAGIC_tied 'P'
67 #ifndef PERL_MAGIC_env
68 # define PERL_MAGIC_env 'E'
71 #ifndef NEGATIVE_INDICES_VAR
72 # define NEGATIVE_INDICES_VAR "NEGATIVE_INDICES"
75 #define SU_HAS_PERL(R, V, S) (PERL_REVISION > (R) || (PERL_REVISION == (R) && (PERL_VERSION > (V) || (PERL_VERSION == (V) && (PERL_SUBVERSION >= (S))))))
77 /* --- Threads and multiplicity -------------------------------------------- */
87 #ifndef SU_MULTIPLICITY
88 # if defined(MULTIPLICITY) || defined(PERL_IMPLICIT_CONTEXT)
89 # define SU_MULTIPLICITY 1
91 # define SU_MULTIPLICITY 0
94 #if SU_MULTIPLICITY && !defined(tTHX)
95 # define tTHX PerlInterpreter*
98 #if SU_MULTIPLICITY && defined(USE_ITHREADS) && defined(dMY_CXT) && defined(MY_CXT) && defined(START_MY_CXT) && defined(MY_CXT_INIT) && (defined(MY_CXT_CLONE) || defined(dMY_CXT_SV))
99 # define SU_THREADSAFE 1
100 # ifndef MY_CXT_CLONE
101 # define MY_CXT_CLONE \
103 my_cxt_t *my_cxtp = (my_cxt_t*)SvPVX(newSV(sizeof(my_cxt_t)-1)); \
104 Copy(INT2PTR(my_cxt_t*, SvUV(my_cxt_sv)), my_cxtp, 1, my_cxt_t); \
105 sv_setuv(my_cxt_sv, PTR2UV(my_cxtp))
108 # define SU_THREADSAFE 0
110 # define dMY_CXT dNOOP
112 # define MY_CXT su_globaldata
114 # define START_MY_CXT STATIC my_cxt_t MY_CXT;
116 # define MY_CXT_INIT NOOP
118 # define MY_CXT_CLONE NOOP
121 /* --- Stack manipulations ------------------------------------------------- */
123 #ifndef SvCANEXISTDELETE
124 # define SvCANEXISTDELETE(sv) \
126 || ((mg = mg_find((SV *) sv, PERL_MAGIC_tied)) \
127 && (stash = SvSTASH(SvRV(SvTIED_obj((SV *) sv, mg)))) \
128 && gv_fetchmethod_autoload(stash, "EXISTS", TRUE) \
129 && gv_fetchmethod_autoload(stash, "DELETE", TRUE) \
134 /* ... Saving array elements ............................................... */
136 STATIC I32 su_av_key2idx(pTHX_ AV *av, I32 key) {
137 #define su_av_key2idx(A, K) su_av_key2idx(aTHX_ (A), (K))
143 /* Added by MJD in perl-5.8.1 with 6f12eb6d2a1dfaf441504d869b27d2e40ef4966a */
144 #if SU_HAS_PERL(5, 8, 1)
145 if (SvRMAGICAL(av)) {
146 const MAGIC * const tied_magic = mg_find((SV *) av, PERL_MAGIC_tied);
148 SV * const * const negative_indices_glob =
149 hv_fetch(SvSTASH(SvRV(SvTIED_obj((SV *) (av), tied_magic))),
150 NEGATIVE_INDICES_VAR, 16, 0);
151 if (negative_indices_glob && SvTRUE(GvSV(*negative_indices_glob)))
157 idx = key + av_len(av) + 1;
171 STATIC void su_adelete(pTHX_ void *ud_) {
172 su_ud_adelete *ud = (su_ud_adelete *) ud_;
174 av_delete(ud->av, ud->idx, G_DISCARD);
175 SvREFCNT_dec(ud->av);
180 STATIC void su_save_adelete(pTHX_ AV *av, I32 idx) {
181 #define su_save_adelete(A, K) su_save_adelete(aTHX_ (A), (K))
184 Newx(ud, 1, su_ud_adelete);
189 SAVEDESTRUCTOR_X(su_adelete, ud);
192 #define SAVEADELETE(A, K) su_save_adelete((A), (K))
194 #endif /* SAVEADELETE */
196 STATIC void su_save_aelem(pTHX_ AV *av, SV *key, SV *val) {
197 #define su_save_aelem(A, K, V) su_save_aelem(aTHX_ (A), (K), (V))
204 idx = su_av_key2idx(av, SvIV(key));
206 if (SvCANEXISTDELETE(av))
207 preeminent = av_exists(av, idx);
209 svp = av_fetch(av, idx, 1);
210 if (!svp || *svp == &PL_sv_undef) croak(PL_no_aelem, idx);
213 save_aelem(av, idx, svp);
215 SAVEADELETE(av, idx);
217 if (val) { /* local $x[$idx] = $val; */
218 SvSetMagicSV(*svp, val);
219 } else { /* local $x[$idx]; delete $x[$idx]; */
220 av_delete(av, idx, G_DISCARD);
224 /* ... Saving hash elements ................................................ */
226 STATIC void su_save_helem(pTHX_ HV *hv, SV *keysv, SV *val) {
227 #define su_save_helem(H, K, V) su_save_helem(aTHX_ (H), (K), (V))
234 if (SvCANEXISTDELETE(hv) || mg_find((SV *) hv, PERL_MAGIC_env))
235 preeminent = hv_exists_ent(hv, keysv, 0);
237 he = hv_fetch_ent(hv, keysv, 1, 0);
238 svp = he ? &HeVAL(he) : NULL;
239 if (!svp || *svp == &PL_sv_undef) croak("Modification of non-creatable hash value attempted, subscript \"%s\"", SvPV_nolen_const(*svp));
241 if (HvNAME_get(hv) && isGV(*svp)) {
242 save_gp((GV *) *svp, 0);
247 save_helem(hv, keysv, svp);
250 const char * const key = SvPV_const(keysv, keylen);
251 SAVEDELETE(hv, savepvn(key, keylen),
252 SvUTF8(keysv) ? -(I32)keylen : (I32)keylen);
255 if (val) { /* local $x{$keysv} = $val; */
256 SvSetMagicSV(*svp, val);
257 } else { /* local $x{$keysv}; delete $x{$keysv}; */
258 (void)hv_delete_ent(hv, keysv, G_DISCARD, HeHASH(he));
262 /* --- Actions ------------------------------------------------------------- */
267 void (*handler)(pTHX_ void *);
270 #define SU_UD_DEPTH(U) (((su_ud_common *) (U))->depth)
271 #define SU_UD_ORIGIN(U) (((su_ud_common *) (U))->origin)
272 #define SU_UD_HANDLER(U) (((su_ud_common *) (U))->handler)
274 #define SU_UD_FREE(U) STMT_START { \
275 if (SU_UD_ORIGIN(U)) Safefree(SU_UD_ORIGIN(U)); \
279 /* ... Reap ................................................................ */
286 STATIC void su_call(pTHX_ void *ud_) {
287 su_ud_reap *ud = (su_ud_reap *) ud_;
288 #if SU_HAS_PERL(5, 9, 5)
289 PERL_CONTEXT saved_cx;
290 I32 dieing = PL_op->op_type == OP_DIE;
297 PerlIO_printf(Perl_debug_log,
298 "%p: @@@ call\n%p: depth=%2d scope_ix=%2d save_ix=%2d\n",
299 ud, ud, SU_UD_DEPTH(ud), PL_scopestack_ix, PL_savestack_ix);
308 /* If the recently popped context isn't saved there, it will be overwritten by
309 * the sub scope from call_sv, although it's still needed in our caller. */
311 #if SU_HAS_PERL(5, 9, 5)
313 if (cxstack_ix < cxstack_max)
314 cxix = cxstack_ix + 1;
316 cxix = Perl_cxinc(aTHX);
317 saved_cx = cxstack[cxix];
321 call_sv(ud->cb, G_VOID);
323 #if SU_HAS_PERL(5, 9, 5)
325 cxstack[cxix] = saved_cx;
333 SvREFCNT_dec(ud->cb);
337 STATIC void su_reap(pTHX_ void *ud) {
338 #define su_reap(U) su_reap(aTHX_ (U))
340 PerlIO_printf(Perl_debug_log,
341 "%p: === reap\n%p: depth=%2d scope_ix=%2d save_ix=%2d\n",
342 ud, ud, SU_UD_DEPTH(ud), PL_scopestack_ix, PL_savestack_ix);
345 SAVEDESTRUCTOR_X(su_call, ud);
348 /* ... Localize & localize array/hash element .............................. */
358 STATIC void su_ud_localize_init(pTHX_ su_ud_localize *ud, SV *sv, SV *val, SV *elem) {
359 #define su_ud_localize_init(UD, S, V, E) su_ud_localize_init(aTHX_ (UD), (S), (V), (E))
365 if (SvTYPE(sv) >= SVt_PVGV) {
366 if (!val || !SvROK(val)) { /* local *x; or local *x = $val; */
368 } else { /* local *x = \$val; */
369 t = SvTYPE(SvRV(val));
374 const char *p = SvPV_const(sv, len), *s;
375 for (s = p, l = len; l > 0 && isSPACE(*s); ++s, --l) { }
381 case '$': t = SVt_PV; break;
382 case '@': t = SVt_PVAV; break;
383 case '%': t = SVt_PVHV; break;
384 case '&': t = SVt_PVCV; break;
385 case '*': t = SVt_PVGV; break;
390 } else if (val) { /* t == SVt_NULL, type can't be inferred from the sigil */
391 if (SvROK(val) && !sv_isobject(val)) {
392 t = SvTYPE(SvRV(val));
410 /* When deref is set, val isn't NULL */
413 ud->val = val ? newSVsv(deref ? SvRV(val) : val) : NULL;
414 ud->elem = SvREFCNT_inc(elem);
418 STATIC void su_localize(pTHX_ void *ud_) {
419 #define su_localize(U) su_localize(aTHX_ (U))
420 su_ud_localize *ud = (su_ud_localize *) ud_;
427 if (SvTYPE(sv) >= SVt_PVGV) {
431 gv = gv_fetchsv(sv, GV_ADDMULTI, SVt_PVGV);
434 const char *name = SvPV_const(sv, len);
435 gv = gv_fetchpvn_flags(name, len, GV_ADDMULTI, SVt_PVGV);
442 PerlIO_printf(Perl_debug_log, "%p: === localize a %s\n",ud, sv_reftype(z, 0));
443 PerlIO_printf(Perl_debug_log,
444 "%p: depth=%2d scope_ix=%2d save_ix=%2d\n",
445 ud, SU_UD_DEPTH(ud), PL_scopestack_ix, PL_savestack_ix);
449 /* Inspired from Alias.pm */
453 su_save_aelem(GvAV(gv), elem, val);
460 su_save_helem(GvHV(gv), elem, val);
466 save_gp(gv, 1); /* hide previous entry in symtab */
473 gv = (GV *) save_scalar(gv);
478 SvSetMagicSV((SV *) gv, val);
481 SvREFCNT_dec(ud->elem);
482 SvREFCNT_dec(ud->val);
483 SvREFCNT_dec(ud->sv);
487 /* --- Pop a context back -------------------------------------------------- */
491 # define SU_CXNAME PL_block_type[CxTYPE(&cxstack[cxstack_ix])]
493 # define SU_CXNAME "XXX"
497 STATIC void su_pop(pTHX_ void *ud) {
498 #define su_pop(U) su_pop(aTHX_ (U))
499 I32 depth, base, mark, *origin;
500 depth = SU_UD_DEPTH(ud);
503 PerlIO_printf(Perl_debug_log,
505 "%p: leave scope at depth=%2d scope_ix=%2d cur_top=%2d cur_base=%2d\n",
507 ud, depth, PL_scopestack_ix,PL_savestack_ix,PL_scopestack[PL_scopestack_ix])
510 origin = SU_UD_ORIGIN(ud);
511 mark = origin[depth];
512 base = origin[depth - 1];
514 SU_D(PerlIO_printf(Perl_debug_log,
515 "%p: original scope was %*c top=%2d base=%2d\n",
516 ud, 24, ' ', mark, base));
519 SU_D(PerlIO_printf(Perl_debug_log, "%p: clear leftovers\n", ud));
520 PL_savestack_ix = mark;
523 PL_savestack_ix = base;
525 SU_UD_DEPTH(ud) = --depth;
528 SU_D(PerlIO_printf(Perl_debug_log,
529 "%p: set new destructor at depth=%2d scope_ix=%2d save_ix=%2d\n",
530 ud, depth, PL_scopestack_ix, PL_savestack_ix));
532 SAVEDESTRUCTOR_X(su_pop, ud);
534 SU_UD_HANDLER(ud)(aTHX_ ud);
537 SU_D(PerlIO_printf(Perl_debug_log,
538 "%p: --- end pop: cur_top=%2d == cur_base=%2d\n",
539 ud, PL_savestack_ix, PL_scopestack[PL_scopestack_ix]));
542 /* --- Initialize the stack and the action userdata ------------------------ */
544 STATIC I32 su_init(pTHX_ I32 cxix, void *ud, I32 size) {
545 #define su_init(L, U, S) su_init(aTHX_ (L), (U), (S))
546 I32 i, depth = 0, *origin;
548 LEAVE_with_name("sub");
550 if (cxix >= cxstack_ix) {
551 SU_UD_HANDLER(ud)(aTHX_ ud);
555 SU_D(PerlIO_printf(Perl_debug_log, "%p: ### init for cx %d\n", ud, cxix));
557 for (i = cxstack_ix; i > cxix; --i) {
558 PERL_CONTEXT *cx = cxstack + i;
559 switch (CxTYPE(cx)) {
560 #if SU_HAS_PERL(5, 10, 0)
562 SU_D(PerlIO_printf(Perl_debug_log, "%p: cx %d is block\n", ud, i));
563 /* Given and when blocks are actually followed by a simple block, so skip
565 if (cxix > 0) { /* Implies i > 0 */
566 PERL_CONTEXT *next = cx - 1;
567 if (CxTYPE(next) == CXt_GIVEN || CxTYPE(next) == CXt_WHEN)
573 #if SU_HAS_PERL(5, 11, 0)
576 case CXt_LOOP_LAZYSV:
577 case CXt_LOOP_LAZYIV:
581 SU_D(PerlIO_printf(Perl_debug_log, "%p: cx %d is loop\n", ud, i));
585 SU_D(PerlIO_printf(Perl_debug_log, "%p: cx %d is other\n", ud, i));
590 SU_D(PerlIO_printf(Perl_debug_log, "%p: depth is %d\n", ud, depth));
592 Newx(origin, depth + 1, I32);
593 origin[0] = PL_scopestack[PL_scopestack_ix - depth];
594 PL_scopestack[PL_scopestack_ix - depth] += size;
595 for (i = depth - 1; i >= 1; --i) {
596 I32 j = PL_scopestack_ix - i;
597 origin[depth - i] = PL_scopestack[j];
598 PL_scopestack[j] += 3;
600 origin[depth] = PL_savestack_ix;
602 SU_UD_ORIGIN(ud) = origin;
603 SU_UD_DEPTH(ud) = depth;
605 SU_D(PerlIO_printf(Perl_debug_log,
606 "%p: set original destructor at depth=%2d scope_ix=%2d save_ix=%2d\n",
607 ud, depth, PL_scopestack_ix - 1, PL_savestack_ix));
609 SAVEDESTRUCTOR_X(su_pop, ud);
612 for (i = 0; i <= depth; ++i) {
613 I32 j = PL_scopestack_ix - i;
614 PerlIO_printf(Perl_debug_log,
615 "%p: depth=%2d scope_ix=%2d saved_floor=%2d new_floor=%2d\n",
616 ud, i, j, origin[depth - i],
617 i == 0 ? PL_savestack_ix : PL_scopestack[j]);
622 ENTER_with_name("sub");
627 /* --- Global data --------------------------------------------------------- */
629 #define MY_CXT_KEY __PACKAGE__ "::_guts" XS_VERSION
640 /* --- Unwind stack -------------------------------------------------------- */
642 STATIC void su_unwind(pTHX_ void *ud_) {
644 I32 cxix = MY_CXT.cxix;
645 I32 items = MY_CXT.items - 1;
646 SV **savesp = MY_CXT.savesp;
649 PERL_UNUSED_VAR(ud_);
652 PL_stack_sp = savesp;
654 if (cxstack_ix > cxix)
661 mark = PL_markstack[cxstack[cxix].blk_oldmarksp];
662 *PL_markstack_ptr = PL_stack_sp - PL_stack_base - items;
666 PerlIO_printf(Perl_debug_log,
667 "%p: cx=%d gimme=%s items=%d sp=%d oldmark=%d mark=%d\n",
669 gimme == G_VOID ? "void" : gimme == G_ARRAY ? "list" : "scalar",
670 items, PL_stack_sp - PL_stack_base, *PL_markstack_ptr, mark);
673 PL_op = PL_ppaddr[OP_RETURN](aTHX);
674 *PL_markstack_ptr = mark;
676 MY_CXT.fakeop.op_next = PL_op;
677 PL_op = &(MY_CXT.fakeop);
680 /* --- XS ------------------------------------------------------------------ */
682 #if SU_HAS_PERL(5, 8, 9)
683 # define SU_SKIP_DB_MAX 2
685 # define SU_SKIP_DB_MAX 3
688 /* Skip context sequences of 1 to SU_SKIP_DB_MAX (included) block contexts
689 * followed by a DB sub */
691 #define SU_SKIP_DB(C) \
694 PERL_CONTEXT *cx = cxstack + (C); \
696 if (CxTYPE(cx) == CXt_BLOCK && (C) >= i) { \
698 if (CxTYPE(cx) == CXt_SUB && cx->blk_sub.cv == GvCV(PL_DBsub)) { \
704 } while (++i <= SU_SKIP_DB_MAX); \
707 #define SU_GET_CONTEXT(A, B) \
716 else if (cxix > cxstack_ix) \
726 #define SU_GET_LEVEL(A, B) \
739 XS(XS_Scope__Upper_unwind); /* prototype to pass -Wmissing-prototypes */
741 XS(XS_Scope__Upper_unwind) {
750 PERL_UNUSED_VAR(cv); /* -W */
751 PERL_UNUSED_VAR(ax); /* -Wall */
753 SU_GET_CONTEXT(0, items - 1);
755 PERL_CONTEXT *cx = cxstack + cxix;
756 switch (CxTYPE(cx)) {
758 if (PL_DBsub && cx->blk_sub.cv == GvCV(PL_DBsub))
763 MY_CXT.items = items;
764 /* pp_entersub will want to sanitize the stack after returning from there
765 * Screw that, we're insane */
766 if (GIMME_V == G_SCALAR) {
767 MY_CXT.savesp = PL_stack_sp;
768 /* dXSARGS calls POPMARK, so we need to match PL_markstack_ptr[1] */
769 PL_stack_sp = PL_stack_base + PL_markstack_ptr[1] + 1;
771 MY_CXT.savesp = NULL;
773 SAVEDESTRUCTOR_X(su_unwind, NULL);
778 } while (--cxix >= 0);
779 croak("Can't return outside a subroutine");
782 MODULE = Scope::Upper PACKAGE = Scope::Upper
790 stash = gv_stashpv(__PACKAGE__, 1);
791 newCONSTSUB(stash, "TOP", newSViv(0));
792 newCONSTSUB(stash, "SU_THREADSAFE", newSVuv(SU_THREADSAFE));
793 newXSproto("Scope::Upper::unwind", XS_Scope__Upper_unwind, file, NULL);
802 PERL_UNUSED_VAR(items);
807 #endif /* SU_THREADSAFE */
813 I32 cxix = cxstack_ix;
817 RETVAL = newSViv(cxix);
827 SU_GET_CONTEXT(0, 0);
832 RETVAL = newSViv(cxix);
842 SU_GET_CONTEXT(0, 0);
843 for (; cxix >= 0; --cxix) {
844 PERL_CONTEXT *cx = cxstack + cxix;
845 switch (CxTYPE(cx)) {
849 if (PL_DBsub && cx->blk_sub.cv == GvCV(PL_DBsub))
851 ST(0) = sv_2mortal(newSViv(cxix));
863 SU_GET_CONTEXT(0, 0);
864 for (; cxix >= 0; --cxix) {
865 PERL_CONTEXT *cx = cxstack + cxix;
866 switch (CxTYPE(cx)) {
870 ST(0) = sv_2mortal(newSViv(cxix));
897 ST(0) = sv_2mortal(newSViv(cxix));
907 for (cxix = cxstack_ix; cxix > 0; --cxix) {
908 PERL_CONTEXT *cx = cxstack + cxix;
909 switch (CxTYPE(cx)) {
911 if (PL_DBsub && cx->blk_sub.cv == GvCV(PL_DBsub))
921 ST(0) = sv_2mortal(newSViv(cxix));
930 SU_GET_CONTEXT(0, 0);
932 PERL_CONTEXT *cx = cxstack + cxix--;
933 switch (CxTYPE(cx)) {
937 I32 gimme = cx->blk_gimme;
939 case G_VOID: XSRETURN_UNDEF; break;
940 case G_SCALAR: XSRETURN_NO; break;
941 case G_ARRAY: XSRETURN_YES; break;
956 SU_GET_CONTEXT(1, 1);
957 Newx(ud, 1, su_ud_reap);
958 SU_UD_ORIGIN(ud) = NULL;
959 SU_UD_HANDLER(ud) = su_reap;
960 ud->cb = newSVsv(hook);
961 su_init(cxix, ud, 3);
964 localize(SV *sv, SV *val, ...)
971 SU_GET_CONTEXT(2, 2);
972 Newx(ud, 1, su_ud_localize);
973 SU_UD_ORIGIN(ud) = NULL;
974 SU_UD_HANDLER(ud) = su_localize;
975 su_ud_localize_init(ud, sv, val, NULL);
976 #if !SU_HAS_PERL(5, 8, 9)
977 if (ud->type >= SVt_PVGV)
980 su_init(cxix, ud, size);
983 localize_elem(SV *sv, SV *elem, SV *val, ...)
989 SU_GET_CONTEXT(3, 3);
990 Newx(ud, 1, su_ud_localize);
991 SU_UD_ORIGIN(ud) = NULL;
992 SU_UD_HANDLER(ud) = su_localize;
993 su_ud_localize_init(ud, sv, val, elem);
994 su_init(cxix, ud, 4);
997 localize_delete(SV *sv, SV *elem, ...)
1004 SU_GET_CONTEXT(2, 2);
1005 Newx(ud, 1, su_ud_localize);
1006 SU_UD_ORIGIN(ud) = NULL;
1007 SU_UD_HANDLER(ud) = su_localize;
1008 su_ud_localize_init(ud, sv, NULL, elem);
1009 #if !SU_HAS_PERL(5, 8, 9)
1010 if (ud->type >= SVt_PVGV)
1013 su_init(cxix, ud, size);