3 * Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006
4 * by Larry Wall and others
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.
12 =head1 Global Variables
15 /***********************************************/
16 /* Global only to current thread */
17 /***********************************************/
19 /* Don't forget to re-run embed.pl to propagate changes! */
21 /* The 'T' prefix is only needed for vars that need appropriate #defines
22 * generated when built with or without USE_5005THREADS. It is also used
23 * to generate the appropriate export list for win32.
25 * When building without USE_5005THREADS, these variables will be truly global.
26 * When building without USE_5005THREADS but with MULTIPLICITY, these variables
27 * will be global per-interpreter. */
29 /* Important ones in the first cache line (if alignment is done right) */
31 PERLVAR(Tstack_sp, SV **) /* top of the stack */
33 PERLVAR(Topsave, OP *)
35 PERLVAR(Top, OP *) /* currently executing op */
37 PERLVAR(Tcurpad, SV **) /* active pad (lexicals+tmps) */
39 PERLVAR(Tstack_base, SV **)
40 PERLVAR(Tstack_max, SV **)
42 PERLVAR(Tscopestack, I32 *) /* scopes we've ENTERed */
43 PERLVAR(Tscopestack_ix, I32)
44 PERLVAR(Tscopestack_max,I32)
46 PERLVAR(Tsavestack, ANY *) /* items that need to be restored
47 when LEAVEing scopes we've ENTERed */
48 PERLVAR(Tsavestack_ix, I32)
49 PERLVAR(Tsavestack_max, I32)
51 PERLVAR(Ttmps_stack, SV **) /* mortals we've made */
52 PERLVARI(Ttmps_ix, I32, -1)
53 PERLVARI(Ttmps_floor, I32, -1)
54 PERLVAR(Ttmps_max, I32)
55 PERLVAR(Tmodcount, I32) /* how much mod()ification in assignment? */
57 PERLVAR(Tmarkstack, I32 *) /* stack_sp locations we're remembering */
58 PERLVAR(Tmarkstack_ptr, I32 *)
59 PERLVAR(Tmarkstack_max, I32 *)
61 PERLVAR(TSv, SV *) /* used to hold temporary values */
62 PERLVAR(TXpv, XPV *) /* used to hold temporary values */
65 =for apidoc Amn|STRLEN|PL_na
67 A convenience variable which is typically used with C<SvPV> when one
68 doesn't care about the length of the string. It is usually more efficient
69 to either declare a local variable and use that instead or to use the
75 PERLVAR(Tna, STRLEN) /* for use in SvPV when length is
79 PERLVAR(Tstatbuf, Stat_t)
80 PERLVAR(Tstatcache, Stat_t) /* _ */
81 PERLVAR(Tstatgv, GV *)
82 PERLVARI(Tstatname, SV *, NULL)
85 PERLVAR(Ttimesbuf, struct tms)
88 /* Fields used by magic variables such as $@, $/ and so on */
89 PERLVAR(Tcurpm, PMOP *) /* what to do \ interps in REs from */
92 =for apidoc mn|SV*|PL_rs
94 The input record separator - C<$/> in Perl space.
96 =for apidoc mn|GV*|PL_last_in_gv
98 The GV which was last used for a filehandle input operation. (C<< <FH> >>)
100 =for apidoc mn|SV*|PL_ofs_sv
102 The output field separator - C<$,> in Perl space.
107 PERLVAR(Trs, SV *) /* input record separator $/ */
108 PERLVAR(Tlast_in_gv, GV *) /* GV used in last <FH> */
109 PERLVAR(Tofs_sv, SV *) /* output field separator $, */
110 PERLVAR(Tdefoutgv, GV *) /* default FH for output */
111 PERLVARI(Tchopset, const char *, " \n-") /* $: */
112 PERLVAR(Tformtarget, SV *)
113 PERLVAR(Tbodytarget, SV *)
114 PERLVAR(Ttoptarget, SV *)
117 PERLVAR(Tdefstash, HV *) /* main symbol table */
118 PERLVAR(Tcurstash, HV *) /* symbol table for current package */
120 PERLVAR(Trestartop, OP *) /* propagating an error from croak? */
121 PERLVARI(Tcurcop, COP * VOL, &PL_compiling)
122 PERLVAR(Tlocalizing, U8) /* are we processing a local() list? */
123 PERLVAR(Tcolorset, bool) /* from regcomp.c */
125 PERLVAR(Tcurstack, AV *) /* THE STACK */
126 PERLVAR(Tcurstackinfo, PERL_SI *) /* current stack + context */
127 PERLVAR(Tmainstack, AV *) /* the stack when nothing funny is happening */
129 PERLVAR(Ttop_env, JMPENV *) /* ptr. to current sigjmp() environment */
130 PERLVAR(Tstart_env, JMPENV) /* empty startup sigjmp() environment */
131 PERLVARI(Terrors, SV *, NULL) /* outstanding queued errors */
133 /* statics "owned" by various functions */
134 PERLVAR(Tav_fetch_sv, SV *) /* unused as of change #19268 */
135 PERLVAR(Thv_fetch_sv, SV *) /* unused as of change #19268 */
136 PERLVAR(Thv_fetch_ent_mh, HE*) /* owned by hv_fetch_ent() */
139 PERLVAR(Tlastgotoprobe, OP*) /* from pp_ctl.c */
140 PERLVARI(Tdumpindent, U16, 4) /* # of blanks per dump indentation level */
143 PERLVAR(Tsortcop, OP *) /* user defined sort routine */
144 PERLVAR(Tsortstash, HV *) /* which is in some package or other */
145 PERLVAR(Tfirstgv, GV *) /* $a */
146 PERLVAR(Tsecondgv, GV *) /* $b */
149 PERLVAR(Tefloatbuf, char*)
150 PERLVAR(Tefloatsize, STRLEN)
154 PERLVAR(Tscreamfirst, I32 *)
155 PERLVAR(Tscreamnext, I32 *)
156 PERLVAR(Tlastscream, SV *)
158 PERLVAR(Treg_state, struct re_save_state)
159 PERLVAR(Tregdummy, regnode) /* from regcomp.c */
160 PERLVARA(Tcolors,6, char *) /* from regcomp.c */
162 PERLVARI(Tpeepp, peep_t, MEMBER_TO_FPTR(Perl_peep))
163 /* Pointer to peephole optimizer */
165 PERLVARI(Tmaxscream, I32, -1)
166 PERLVARI(Treginterp_cnt,I32, 0) /* Whether "Regexp" was interpolated. */
167 PERLVARI(Twatchaddr, char **, 0)
168 PERLVAR(Twatchok, char *)
170 /* Note that the variables below are all explicitly referenced in the code
171 * as thr->whatever and therefore don't need the 'T' prefix. */
173 /* the currently active slab in a chain of slabs of regmatch states,
174 * and the currently active state within that slab */
176 PERLVARI(Tregmatch_slab, regmatch_slab *, NULL)
177 PERLVAR(Tregmatch_state, regmatch_state *)
179 PERLVAR(Tdelaymagic, U16) /* ($<,$>) = ... */
180 PERLVARI(Tdirty, bool, FALSE) /* in the middle of tearing things down? */
181 PERLVAR(Tin_eval, VOL U8) /* trap "fatal" errors? */
182 PERLVAR(Ttainted, bool) /* using variables controlled by $< */