This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
[perl #112272] test link()'s error returns (TODO)
[perl5.git] / mg_vtable.h
1 /* -*- buffer-read-only: t -*-
2  *
3  *    mg_vtable.h
4  * !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
5  * This file is built by regen/mg_vtable.pl.
6  * Any changes made here will be lost!
7  */
8
9 /* These constants should be used in preference to raw characters
10  * when using magic. Note that some perl guts still assume
11  * certain character properties of these constants, namely that
12  * isUPPER() and toLOWER() may do useful mappings.
13  */
14
15 #define PERL_MAGIC_sv             '\0' /* Special scalar variable */
16 #define PERL_MAGIC_arylen         '#' /* Array length ($#ary) */
17 #define PERL_MAGIC_rhash          '%' /* extra data for restricted hashes */
18 #define PERL_MAGIC_pos            '.' /* pos() lvalue */
19 #define PERL_MAGIC_symtab         ':' /* extra data for symbol tables */
20 #define PERL_MAGIC_backref        '<' /* for weak ref data */
21 #define PERL_MAGIC_arylen_p       '@' /* to move arylen out of XPVAV */
22 #define PERL_MAGIC_bm             'B' /* Boyer-Moore (fast string search) */
23 #define PERL_MAGIC_overload_table 'c' /* Holds overload table (AMT) on stash */
24 #define PERL_MAGIC_regdata        'D' /* Regex match position data
25                                          (@+ and @- vars) */
26 #define PERL_MAGIC_regdatum       'd' /* Regex match position data element */
27 #define PERL_MAGIC_env            'E' /* %ENV hash */
28 #define PERL_MAGIC_envelem        'e' /* %ENV hash element */
29 #define PERL_MAGIC_fm             'f' /* Formline ('compiled' format) */
30 #define PERL_MAGIC_study          'G' /* study()ed string */
31 #define PERL_MAGIC_regex_global   'g' /* m//g target */
32 #define PERL_MAGIC_hints          'H' /* %^H hash */
33 #define PERL_MAGIC_hintselem      'h' /* %^H hash element */
34 #define PERL_MAGIC_isa            'I' /* @ISA array */
35 #define PERL_MAGIC_isaelem        'i' /* @ISA array element */
36 #define PERL_MAGIC_nkeys          'k' /* scalar(keys()) lvalue */
37 #define PERL_MAGIC_dbfile         'L' /* Debugger %_<filename */
38 #define PERL_MAGIC_dbline         'l' /* Debugger %_<filename element */
39 #define PERL_MAGIC_shared         'N' /* Shared between threads */
40 #define PERL_MAGIC_shared_scalar  'n' /* Shared between threads */
41 #define PERL_MAGIC_collxfrm       'o' /* Locale transformation */
42 #define PERL_MAGIC_tied           'P' /* Tied array or hash */
43 #define PERL_MAGIC_tiedelem       'p' /* Tied array or hash element */
44 #define PERL_MAGIC_tiedscalar     'q' /* Tied scalar or handle */
45 #define PERL_MAGIC_qr             'r' /* precompiled qr// regex */
46 #define PERL_MAGIC_sig            'S' /* %SIG hash */
47 #define PERL_MAGIC_sigelem        's' /* %SIG hash element */
48 #define PERL_MAGIC_taint          't' /* Taintedness */
49 #define PERL_MAGIC_uvar           'U' /* Available for use by extensions */
50 #define PERL_MAGIC_uvar_elem      'u' /* Reserved for use by extensions */
51 #define PERL_MAGIC_vstring        'V' /* SV was vstring literal */
52 #define PERL_MAGIC_vec            'v' /* vec() lvalue */
53 #define PERL_MAGIC_utf8           'w' /* Cached UTF-8 information */
54 #define PERL_MAGIC_substr         'x' /* substr() lvalue */
55 #define PERL_MAGIC_defelem        'y' /* Shadow "foreach" iterator variable /
56                                          smart parameter vivification */
57 #define PERL_MAGIC_checkcall      ']' /* inlining/mutation of call to this CV */
58 #define PERL_MAGIC_ext            '~' /* Available for use by extensions */
59
60 enum {          /* pass one of these to get_vtbl */
61     want_vtbl_arylen,
62     want_vtbl_arylen_p,
63     want_vtbl_backref,
64     want_vtbl_checkcall,
65     want_vtbl_collxfrm,
66     want_vtbl_dbline,
67     want_vtbl_defelem,
68     want_vtbl_env,
69     want_vtbl_envelem,
70     want_vtbl_hints,
71     want_vtbl_hintselem,
72     want_vtbl_isa,
73     want_vtbl_isaelem,
74     want_vtbl_mglob,
75     want_vtbl_nkeys,
76     want_vtbl_ovrld,
77     want_vtbl_pack,
78     want_vtbl_packelem,
79     want_vtbl_pos,
80     want_vtbl_regdata,
81     want_vtbl_regdatum,
82     want_vtbl_regexp,
83     want_vtbl_sigelem,
84     want_vtbl_substr,
85     want_vtbl_sv,
86     want_vtbl_taint,
87     want_vtbl_utf8,
88     want_vtbl_uvar,
89     want_vtbl_vec,
90     want_vtbl_vstring,
91     magic_vtable_max
92 };
93
94 #ifdef DOINIT
95 EXTCONST char *PL_magic_vtable_names[magic_vtable_max] = {
96     "arylen",
97     "arylen_p",
98     "backref",
99     "checkcall",
100     "collxfrm",
101     "dbline",
102     "defelem",
103     "env",
104     "envelem",
105     "hints",
106     "hintselem",
107     "isa",
108     "isaelem",
109     "mglob",
110     "nkeys",
111     "ovrld",
112     "pack",
113     "packelem",
114     "pos",
115     "regdata",
116     "regdatum",
117     "regexp",
118     "sigelem",
119     "substr",
120     "sv",
121     "taint",
122     "utf8",
123     "uvar",
124     "vec",
125     "vstring"
126 };
127 #else
128 EXTCONST char *PL_magic_vtable_names[magic_vtable_max];
129 #endif
130
131 /* These all need to be 0, not NULL, as NULL can be (void*)0, which is a
132  * pointer to data, whereas we're assigning pointers to functions, which are
133  * not the same beast. ANSI doesn't allow the assignment from one to the other.
134  * (although most, but not all, compilers are prepared to do it)
135  */
136
137 /* order is:
138     get
139     set
140     len
141     clear
142     free
143     copy
144     dup
145     local
146 */
147
148 #ifdef DOINIT
149 EXT_MGVTBL PL_magic_vtables[magic_vtable_max] = {
150   { (int (*)(pTHX_ SV *, MAGIC *))Perl_magic_getarylen, Perl_magic_setarylen, 0, 0, 0, 0, 0, 0 },
151   { 0, 0, 0, 0, Perl_magic_freearylen_p, 0, 0, 0 },
152   { 0, 0, 0, 0, Perl_magic_killbackrefs, 0, 0, 0 },
153   { 0, 0, 0, 0, 0, Perl_magic_copycallchecker, 0, 0 },
154 #ifdef USE_LOCALE_COLLATE
155   { 0, Perl_magic_setcollxfrm, 0, 0, 0, 0, 0, 0 },
156 #else
157   { 0, 0, 0, 0, 0, 0, 0, 0 },
158 #endif
159   { 0, Perl_magic_setdbline, 0, 0, 0, 0, 0, 0 },
160   { Perl_magic_getdefelem, Perl_magic_setdefelem, 0, 0, 0, 0, 0, 0 },
161   { 0, Perl_magic_set_all_env, 0, Perl_magic_clear_all_env, 0, 0, 0, 0 },
162   { 0, Perl_magic_setenv, 0, Perl_magic_clearenv, 0, 0, 0, 0 },
163   { 0, 0, 0, Perl_magic_clearhints, 0, 0, 0, 0 },
164   { 0, Perl_magic_sethint, 0, Perl_magic_clearhint, 0, 0, 0, 0 },
165   { 0, Perl_magic_setisa, 0, Perl_magic_clearisa, 0, 0, 0, 0 },
166   { 0, Perl_magic_setisa, 0, 0, 0, 0, 0, 0 },
167   { 0, Perl_magic_setmglob, 0, 0, 0, 0, 0, 0 },
168   { Perl_magic_getnkeys, Perl_magic_setnkeys, 0, 0, 0, 0, 0, 0 },
169   { 0, 0, 0, 0, Perl_magic_freeovrld, 0, 0, 0 },
170   { 0, 0, Perl_magic_sizepack, Perl_magic_wipepack, 0, 0, 0, 0 },
171   { Perl_magic_getpack, Perl_magic_setpack, 0, Perl_magic_clearpack, 0, 0, 0, 0 },
172   { Perl_magic_getpos, Perl_magic_setpos, 0, 0, 0, 0, 0, 0 },
173   { 0, 0, Perl_magic_regdata_cnt, 0, 0, 0, 0, 0 },
174   { Perl_magic_regdatum_get, Perl_magic_regdatum_set, 0, 0, 0, 0, 0, 0 },
175   { 0, Perl_magic_setregexp, 0, 0, 0, 0, 0, 0 },
176 #ifndef PERL_MICRO
177   { Perl_magic_getsig, Perl_magic_setsig, 0, Perl_magic_clearsig, 0, 0, 0, 0 },
178 #else
179   { 0, 0, 0, 0, 0, 0, 0, 0 },
180 #endif
181   { Perl_magic_getsubstr, Perl_magic_setsubstr, 0, 0, 0, 0, 0, 0 },
182   { Perl_magic_get, Perl_magic_set, Perl_magic_len, 0, 0, 0, 0, 0 },
183   { Perl_magic_gettaint, Perl_magic_settaint, 0, 0, 0, 0, 0, 0 },
184   { 0, Perl_magic_setutf8, 0, 0, 0, 0, 0, 0 },
185   { Perl_magic_getuvar, Perl_magic_setuvar, 0, 0, 0, 0, 0, 0 },
186   { Perl_magic_getvec, Perl_magic_setvec, 0, 0, 0, 0, 0, 0 },
187   { 0, Perl_magic_setvstring, 0, 0, 0, 0, 0, 0 }
188 };
189 #else
190 EXT_MGVTBL PL_magic_vtables[magic_vtable_max];
191 #endif
192
193 #define want_vtbl_bm want_vtbl_regexp
194 #define want_vtbl_fm want_vtbl_regexp
195
196 #define PL_vtbl_arylen PL_magic_vtables[want_vtbl_arylen]
197 #define PL_vtbl_arylen_p PL_magic_vtables[want_vtbl_arylen_p]
198 #define PL_vtbl_backref PL_magic_vtables[want_vtbl_backref]
199 #define PL_vtbl_bm PL_magic_vtables[want_vtbl_bm]
200 #define PL_vtbl_checkcall PL_magic_vtables[want_vtbl_checkcall]
201 #define PL_vtbl_collxfrm PL_magic_vtables[want_vtbl_collxfrm]
202 #define PL_vtbl_dbline PL_magic_vtables[want_vtbl_dbline]
203 #define PL_vtbl_defelem PL_magic_vtables[want_vtbl_defelem]
204 #define PL_vtbl_env PL_magic_vtables[want_vtbl_env]
205 #define PL_vtbl_envelem PL_magic_vtables[want_vtbl_envelem]
206 #define PL_vtbl_fm PL_magic_vtables[want_vtbl_fm]
207 #define PL_vtbl_hints PL_magic_vtables[want_vtbl_hints]
208 #define PL_vtbl_hintselem PL_magic_vtables[want_vtbl_hintselem]
209 #define PL_vtbl_isa PL_magic_vtables[want_vtbl_isa]
210 #define PL_vtbl_isaelem PL_magic_vtables[want_vtbl_isaelem]
211 #define PL_vtbl_mglob PL_magic_vtables[want_vtbl_mglob]
212 #define PL_vtbl_nkeys PL_magic_vtables[want_vtbl_nkeys]
213 #define PL_vtbl_ovrld PL_magic_vtables[want_vtbl_ovrld]
214 #define PL_vtbl_pack PL_magic_vtables[want_vtbl_pack]
215 #define PL_vtbl_packelem PL_magic_vtables[want_vtbl_packelem]
216 #define PL_vtbl_pos PL_magic_vtables[want_vtbl_pos]
217 #define PL_vtbl_regdata PL_magic_vtables[want_vtbl_regdata]
218 #define PL_vtbl_regdatum PL_magic_vtables[want_vtbl_regdatum]
219 #define PL_vtbl_regexp PL_magic_vtables[want_vtbl_regexp]
220 #define PL_vtbl_sigelem PL_magic_vtables[want_vtbl_sigelem]
221 #define PL_vtbl_substr PL_magic_vtables[want_vtbl_substr]
222 #define PL_vtbl_sv PL_magic_vtables[want_vtbl_sv]
223 #define PL_vtbl_taint PL_magic_vtables[want_vtbl_taint]
224 #define PL_vtbl_utf8 PL_magic_vtables[want_vtbl_utf8]
225 #define PL_vtbl_uvar PL_magic_vtables[want_vtbl_uvar]
226 #define PL_vtbl_vec PL_magic_vtables[want_vtbl_vec]
227 #define PL_vtbl_vstring PL_magic_vtables[want_vtbl_vstring]
228
229 /* ex: set ro: */