Commit | Line | Data |
---|---|---|
d6376244 JH |
1 | /* scope.h |
2 | * | |
1129b882 NC |
3 | * Copyright (C) 1993, 1994, 1996, 1997, 1998, 1999, 2000, 2001, |
4 | * 2002, 2004, 2005, 2006, 2007, 2008 by Larry Wall and others | |
d6376244 JH |
5 | * |
6 | * You may distribute under the terms of either the GNU General Public | |
7 | * License or the Artistic License, as specified in the README file. | |
8 | * | |
9 | */ | |
10 | ||
b9d12d37 GS |
11 | #define SAVEt_ITEM 0 |
12 | #define SAVEt_SV 1 | |
13 | #define SAVEt_AV 2 | |
14 | #define SAVEt_HV 3 | |
15 | #define SAVEt_INT 4 | |
16 | #define SAVEt_LONG 5 | |
17 | #define SAVEt_I32 6 | |
18 | #define SAVEt_IV 7 | |
19 | #define SAVEt_SPTR 8 | |
20 | #define SAVEt_APTR 9 | |
21 | #define SAVEt_HPTR 10 | |
22 | #define SAVEt_PPTR 11 | |
23 | #define SAVEt_NSTAB 12 | |
24 | #define SAVEt_SVREF 13 | |
25 | #define SAVEt_GP 14 | |
26 | #define SAVEt_FREESV 15 | |
27 | #define SAVEt_FREEOP 16 | |
28 | #define SAVEt_FREEPV 17 | |
29 | #define SAVEt_CLEARSV 18 | |
30 | #define SAVEt_DELETE 19 | |
31 | #define SAVEt_DESTRUCTOR 20 | |
32 | #define SAVEt_REGCONTEXT 21 | |
33 | #define SAVEt_STACK_POS 22 | |
34 | #define SAVEt_I16 23 | |
35 | #define SAVEt_AELEM 24 | |
36 | #define SAVEt_HELEM 25 | |
37 | #define SAVEt_OP 26 | |
38 | #define SAVEt_HINTS 27 | |
39 | #define SAVEt_ALLOC 28 | |
40 | #define SAVEt_GENERIC_SVREF 29 | |
c76ac1ee | 41 | #define SAVEt_DESTRUCTOR_X 30 |
7766f137 | 42 | #define SAVEt_VPTR 31 |
e8347627 | 43 | #define SAVEt_I8 32 |
354992b1 | 44 | #define SAVEt_COMPPAD 33 |
f4dd75d9 | 45 | #define SAVEt_GENERIC_PVREF 34 |
09edbca0 | 46 | #define SAVEt_PADSV_AND_MORTALIZE 35 |
26d9b02f | 47 | #define SAVEt_MORTALIZESV 36 |
05ec9bb3 | 48 | #define SAVEt_SHARED_PVREF 37 |
9febdf04 | 49 | #define SAVEt_BOOL 38 |
14f338dc | 50 | #define SAVEt_SET_SVFLAGS 39 |
8b7059b1 | 51 | #define SAVEt_SAVESWITCHSTACK 40 |
fc15ae8f | 52 | #define SAVEt_COP_ARYBASE 41 |
1ade1aa1 | 53 | #define SAVEt_RE_STATE 42 |
68da3b2f | 54 | #define SAVEt_COMPILE_WARNINGS 43 |
ea8d6ae1 | 55 | #define SAVEt_STACK_CXPOS 44 |
7c197c94 | 56 | #define SAVEt_PARSER 45 |
c68ec7a9 | 57 | #define SAVEt_ADELETE 46 |
89abef21 | 58 | #define SAVEt_I32_SMALL 47 |
994d373a | 59 | #define SAVEt_INT_SMALL 48 |
f83b46a0 | 60 | #define SAVEt_GVSV 49 |
3987a177 | 61 | #define SAVEt_FREECOPHH 50 |
79072805 | 62 | |
af7df257 | 63 | #define SAVEf_SETMAGIC 1 |
75d34a09 | 64 | #define SAVEf_KEEPOLDELEM 2 |
af7df257 | 65 | |
c6bf6a65 NC |
66 | #define SAVE_TIGHT_SHIFT 6 |
67 | #define SAVE_MASK 0x3F | |
68 | ||
91d1c79f | 69 | #define save_aelem(av,idx,sptr) save_aelem_flags(av,idx,sptr,SAVEf_SETMAGIC) |
af7df257 CS |
70 | #define save_helem(hv,key,sptr) save_helem_flags(hv,key,sptr,SAVEf_SETMAGIC) |
71 | ||
b03c0a3a | 72 | #ifndef SCOPE_SAVES_SIGNAL_MASK |
1b266415 | 73 | #define SCOPE_SAVES_SIGNAL_MASK 0 |
b03c0a3a NIS |
74 | #endif |
75 | ||
bb7a0f54 MHM |
76 | #define SSCHECK(need) if (PL_savestack_ix + (I32)(need) > PL_savestack_max) savestack_grow() |
77 | #define SSGROW(need) if (PL_savestack_ix + (I32)(need) > PL_savestack_max) savestack_grow_cnt(need) | |
3280af22 NIS |
78 | #define SSPUSHINT(i) (PL_savestack[PL_savestack_ix++].any_i32 = (I32)(i)) |
79 | #define SSPUSHLONG(i) (PL_savestack[PL_savestack_ix++].any_long = (long)(i)) | |
9febdf04 | 80 | #define SSPUSHBOOL(p) (PL_savestack[PL_savestack_ix++].any_bool = (p)) |
3280af22 | 81 | #define SSPUSHIV(i) (PL_savestack[PL_savestack_ix++].any_iv = (IV)(i)) |
c6bf6a65 | 82 | #define SSPUSHUV(u) (PL_savestack[PL_savestack_ix++].any_uv = (UV)(u)) |
3280af22 NIS |
83 | #define SSPUSHPTR(p) (PL_savestack[PL_savestack_ix++].any_ptr = (void*)(p)) |
84 | #define SSPUSHDPTR(p) (PL_savestack[PL_savestack_ix++].any_dptr = (p)) | |
c76ac1ee | 85 | #define SSPUSHDXPTR(p) (PL_savestack[PL_savestack_ix++].any_dxptr = (p)) |
3280af22 NIS |
86 | #define SSPOPINT (PL_savestack[--PL_savestack_ix].any_i32) |
87 | #define SSPOPLONG (PL_savestack[--PL_savestack_ix].any_long) | |
9febdf04 | 88 | #define SSPOPBOOL (PL_savestack[--PL_savestack_ix].any_bool) |
3280af22 | 89 | #define SSPOPIV (PL_savestack[--PL_savestack_ix].any_iv) |
c6bf6a65 | 90 | #define SSPOPUV (PL_savestack[--PL_savestack_ix].any_uv) |
3280af22 NIS |
91 | #define SSPOPPTR (PL_savestack[--PL_savestack_ix].any_ptr) |
92 | #define SSPOPDPTR (PL_savestack[--PL_savestack_ix].any_dptr) | |
c76ac1ee | 93 | #define SSPOPDXPTR (PL_savestack[--PL_savestack_ix].any_dxptr) |
8990e307 | 94 | |
954c1994 | 95 | /* |
ccfc67b7 JH |
96 | =head1 Callback Functions |
97 | ||
954c1994 GS |
98 | =for apidoc Ams||SAVETMPS |
99 | Opening bracket for temporaries on a callback. See C<FREETMPS> and | |
100 | L<perlcall>. | |
101 | ||
102 | =for apidoc Ams||FREETMPS | |
103 | Closing bracket for temporaries on a callback. See C<SAVETMPS> and | |
104 | L<perlcall>. | |
105 | ||
106 | =for apidoc Ams||ENTER | |
107 | Opening bracket on a callback. See C<LEAVE> and L<perlcall>. | |
108 | ||
109 | =for apidoc Ams||LEAVE | |
110 | Closing bracket on a callback. See C<ENTER> and L<perlcall>. | |
111 | ||
d343c3ef GG |
112 | =over |
113 | ||
114 | =item ENTER_with_name(name) | |
115 | ||
116 | Same as C<ENTER>, but when debugging is enabled it also associates the | |
117 | given literal string with the new scope. | |
118 | ||
119 | =item LEAVE_with_name(name) | |
120 | ||
121 | Same as C<LEAVE>, but when debugging is enabled it first checks that the | |
122 | scope has the given name. Name must be a literal string. | |
123 | ||
124 | =back | |
125 | ||
954c1994 GS |
126 | =cut |
127 | */ | |
128 | ||
3280af22 NIS |
129 | #define SAVETMPS save_int((int*)&PL_tmps_floor), PL_tmps_floor = PL_tmps_ix |
130 | #define FREETMPS if (PL_tmps_ix > PL_tmps_floor) free_tmps() | |
a0d0e21e | 131 | |
f46d017c GS |
132 | #ifdef DEBUGGING |
133 | #define ENTER \ | |
134 | STMT_START { \ | |
135 | push_scope(); \ | |
b4ab917c | 136 | DEBUG_SCOPE("ENTER") \ |
f46d017c GS |
137 | } STMT_END |
138 | #define LEAVE \ | |
139 | STMT_START { \ | |
b4ab917c | 140 | DEBUG_SCOPE("LEAVE") \ |
f46d017c GS |
141 | pop_scope(); \ |
142 | } STMT_END | |
d343c3ef GG |
143 | #define ENTER_with_name(name) \ |
144 | STMT_START { \ | |
145 | push_scope(); \ | |
a09dc31d NC |
146 | if (PL_scopestack_name) \ |
147 | PL_scopestack_name[PL_scopestack_ix-1] = name; \ | |
d343c3ef GG |
148 | DEBUG_SCOPE("ENTER \"" name "\"") \ |
149 | } STMT_END | |
150 | #define LEAVE_with_name(name) \ | |
151 | STMT_START { \ | |
152 | DEBUG_SCOPE("LEAVE \"" name "\"") \ | |
a09dc31d NC |
153 | if (PL_scopestack_name) { \ |
154 | assert(((char*)PL_scopestack_name[PL_scopestack_ix-1] \ | |
155 | == (char*)name) \ | |
156 | || strEQ(PL_scopestack_name[PL_scopestack_ix-1], name)); \ | |
157 | } \ | |
d343c3ef GG |
158 | pop_scope(); \ |
159 | } STMT_END | |
f46d017c | 160 | #else |
a0d0e21e LW |
161 | #define ENTER push_scope() |
162 | #define LEAVE pop_scope() | |
d343c3ef GG |
163 | #define ENTER_with_name(name) ENTER |
164 | #define LEAVE_with_name(name) LEAVE | |
f46d017c | 165 | #endif |
3280af22 | 166 | #define LEAVE_SCOPE(old) if (PL_savestack_ix > old) leave_scope(old) |
a0d0e21e | 167 | |
3f26ef39 NC |
168 | #define SAVEI8(i) save_I8((I8*)&(i)) |
169 | #define SAVEI16(i) save_I16((I16*)&(i)) | |
170 | #define SAVEI32(i) save_I32((I32*)&(i)) | |
171 | #define SAVEINT(i) save_int((int*)&(i)) | |
172 | #define SAVEIV(i) save_iv((IV*)&(i)) | |
173 | #define SAVELONG(l) save_long((long*)&(l)) | |
02644217 | 174 | #define SAVEBOOL(b) save_bool(&(b)) |
55497cff | 175 | #define SAVESPTR(s) save_sptr((SV**)&(s)) |
3f26ef39 | 176 | #define SAVEPPTR(s) save_pptr((char**)&(s)) |
57b2e452 | 177 | #define SAVEVPTR(s) save_vptr((void*)&(s)) |
09edbca0 | 178 | #define SAVEPADSVANDMORTALIZE(s) save_padsv_and_mortalize(s) |
b1bc3f34 NC |
179 | #define SAVEFREESV(s) save_freesv(MUTABLE_SV(s)) |
180 | #define SAVEMORTALIZESV(s) save_mortalizesv(MUTABLE_SV(s)) | |
3f26ef39 NC |
181 | #define SAVEFREEOP(o) save_freeop((OP*)(o)) |
182 | #define SAVEFREEPV(p) save_freepv((char*)(p)) | |
183 | #define SAVECLEARSV(sv) save_clearsv((SV**)&(sv)) | |
b9d12d37 | 184 | #define SAVEGENERICSV(s) save_generic_svref((SV**)&(s)) |
f4dd75d9 | 185 | #define SAVEGENERICPV(s) save_generic_pvref((char**)&(s)) |
05ec9bb3 | 186 | #define SAVESHAREDPV(s) save_shared_pvref((char**)&(s)) |
14f338dc | 187 | #define SAVESETSVFLAGS(sv,mask,val) save_set_svflags(sv,mask,val) |
3987a177 | 188 | #define SAVEFREECOPHH(h) save_pushptr((void *)(h), SAVEt_FREECOPHH) |
55497cff | 189 | #define SAVEDELETE(h,k,l) \ |
dbebbdb4 | 190 | save_delete(MUTABLE_HV(h), (char*)(k), (I32)(l)) |
af097752 VP |
191 | #define SAVEHDELETE(h,s) \ |
192 | save_hdelete(MUTABLE_HV(h), (s)) | |
c68ec7a9 VP |
193 | #define SAVEADELETE(a,k) \ |
194 | save_adelete(MUTABLE_AV(a), (I32)(k)) | |
55497cff | 195 | #define SAVEDESTRUCTOR(f,p) \ |
3f26ef39 | 196 | save_destructor((DESTRUCTORFUNC_NOCONTEXT_t)(f), (void*)(p)) |
c76ac1ee GS |
197 | |
198 | #define SAVEDESTRUCTOR_X(f,p) \ | |
3f26ef39 | 199 | save_destructor_x((DESTRUCTORFUNC_t)(f), (void*)(p)) |
25eaa213 GS |
200 | |
201 | #define SAVESTACK_POS() \ | |
202 | STMT_START { \ | |
203 | SSCHECK(2); \ | |
3280af22 | 204 | SSPUSHINT(PL_stack_sp - PL_stack_base); \ |
c6bf6a65 | 205 | SSPUSHUV(SAVEt_STACK_POS); \ |
25eaa213 GS |
206 | } STMT_END |
207 | ||
462e5cf6 | 208 | #define SAVEOP() save_op() |
25eaa213 | 209 | |
da8315f8 | 210 | #define SAVEHINTS() save_hints() |
354992b1 | 211 | |
747e2fae | 212 | #define SAVECOMPPAD() save_pushptr(MUTABLE_SV(PL_comppad), SAVEt_COMPPAD) |
a9332b4a | 213 | |
8b7059b1 DM |
214 | #define SAVESWITCHSTACK(f,t) \ |
215 | STMT_START { \ | |
dfcd3de5 | 216 | save_pushptrptr(MUTABLE_SV(f), MUTABLE_SV(t), SAVEt_SAVESWITCHSTACK); \ |
8b7059b1 DM |
217 | SWITCHSTACK((f),(t)); \ |
218 | PL_curstackinfo->si_stack = (t); \ | |
219 | } STMT_END | |
220 | ||
7623d426 | 221 | #define SAVECOPARYBASE(c) save_pushi32ptr(CopARYBASE_get(c), c, SAVEt_COP_ARYBASE); |
fc15ae8f | 222 | |
c88c823b | 223 | /* Need to do the cop warnings like this, rather than a "SAVEFREESHAREDPV", |
72dc9ed5 NC |
224 | because realloc() means that the value can actually change. Possibly |
225 | could have done savefreesharedpvREF, but this way actually seems cleaner, | |
226 | as it simplifies the code that does the saves, and reduces the load on the | |
227 | save stack. */ | |
747e2fae | 228 | #define SAVECOMPILEWARNINGS() save_pushptr(PL_compiling.cop_warnings, SAVEt_COMPILE_WARNINGS) |
fc15ae8f | 229 | |
ea8d6ae1 DB |
230 | #define SAVESTACK_CXPOS() \ |
231 | STMT_START { \ | |
232 | SSCHECK(3); \ | |
233 | SSPUSHINT(cxstack[cxstack_ix].blk_oldsp); \ | |
234 | SSPUSHINT(cxstack_ix); \ | |
c6bf6a65 | 235 | SSPUSHUV(SAVEt_STACK_CXPOS); \ |
ea8d6ae1 DB |
236 | } STMT_END |
237 | ||
747e2fae | 238 | #define SAVEPARSER(p) save_pushptr((p), SAVEt_PARSER) |
7c197c94 | 239 | |
57843af0 | 240 | #ifdef USE_ITHREADS |
f4dd75d9 | 241 | # define SAVECOPSTASH(c) SAVEPPTR(CopSTASHPV(c)) |
05ec9bb3 | 242 | # define SAVECOPSTASH_FREE(c) SAVESHAREDPV(CopSTASHPV(c)) |
f4dd75d9 | 243 | # define SAVECOPFILE(c) SAVEPPTR(CopFILE(c)) |
05ec9bb3 | 244 | # define SAVECOPFILE_FREE(c) SAVESHAREDPV(CopFILE(c)) |
57843af0 | 245 | #else |
f4dd75d9 GS |
246 | # define SAVECOPSTASH(c) SAVESPTR(CopSTASH(c)) |
247 | # define SAVECOPSTASH_FREE(c) SAVECOPSTASH(c) /* XXX not refcounted */ | |
248 | # define SAVECOPFILE(c) SAVESPTR(CopFILEGV(c)) | |
249 | # define SAVECOPFILE_FREE(c) SAVEGENERICSV(CopFILEGV(c)) | |
57843af0 GS |
250 | #endif |
251 | ||
dea28490 | 252 | #define SAVECOPLINE(c) SAVEI32(CopLINE(c)) |
57843af0 | 253 | |
455ece5e AD |
254 | /* SSNEW() temporarily allocates a specified number of bytes of data on the |
255 | * savestack. It returns an integer index into the savestack, because a | |
256 | * pointer would get broken if the savestack is moved on reallocation. | |
257 | * SSNEWa() works like SSNEW(), but also aligns the data to the specified | |
258 | * number of bytes. MEM_ALIGNBYTES is perhaps the most useful. The | |
486ec47a | 259 | * alignment will be preserved through savestack reallocation *only* if |
a0288114 | 260 | * realloc returns data aligned to a size divisible by "align"! |
455ece5e AD |
261 | * |
262 | * SSPTR() converts the index returned by SSNEW/SSNEWa() into a pointer. | |
263 | */ | |
264 | ||
f2b2c1a7 | 265 | #define SSNEW(size) Perl_save_alloc(aTHX_ (size), 0) |
02db2b7b | 266 | #define SSNEWt(n,t) SSNEW((n)*sizeof(t)) |
f2b2c1a7 | 267 | #define SSNEWa(size,align) Perl_save_alloc(aTHX_ (size), \ |
6b99f28a | 268 | (I32)(align - ((size_t)((caddr_t)&PL_savestack[PL_savestack_ix]) % align)) % align) |
02db2b7b | 269 | #define SSNEWat(n,t,align) SSNEWa((n)*sizeof(t), align) |
455ece5e | 270 | |
02db2b7b IZ |
271 | #define SSPTR(off,type) ((type) ((char*)PL_savestack + off)) |
272 | #define SSPTRt(off,type) ((type*) ((char*)PL_savestack + off)) | |
455ece5e | 273 | |
2fd8beea NC |
274 | #define save_freesv(op) save_pushptr((void *)(op), SAVEt_FREESV) |
275 | #define save_mortalizesv(op) save_pushptr((void *)(op), SAVEt_MORTALIZESV) | |
276 | #define save_freeop(op) save_pushptr((void *)(op), SAVEt_FREEOP) | |
277 | #define save_freepv(pv) save_pushptr((void *)(pv), SAVEt_FREEPV) | |
278 | #define save_op() save_pushptr((void *)(PL_op), SAVEt_OP) | |
279 | ||
e9a8c099 MHM |
280 | /* |
281 | * Local variables: | |
282 | * c-indentation-style: bsd | |
283 | * c-basic-offset: 4 | |
284 | * indent-tabs-mode: t | |
285 | * End: | |
286 | * | |
287 | * ex: set ts=8 sts=4 sw=4 noet: | |
288 | */ |