1 /* -*- buffer-read-only: t -*-
2 !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
3 This file is built by regen/warnings.pl.
4 Any changes made here will be lost!
8 #define Perl_Warn_Off_(x) ((x) / 8)
9 #define Perl_Warn_Bit_(x) (1 << ((x) % 8))
10 #define PerlWarnIsSet_(a, x) ((a)[Perl_Warn_Off_(x)] & Perl_Warn_Bit_(x))
13 #define G_WARN_OFF 0 /* $^W == 0 */
14 #define G_WARN_ON 1 /* -w flag and $^W != 0 */
15 #define G_WARN_ALL_ON 2 /* -W flag */
16 #define G_WARN_ALL_OFF 4 /* -X flag */
17 #define G_WARN_ONCE 8 /* set if 'once' ever enabled */
18 #define G_WARN_ALL_MASK (G_WARN_ALL_ON|G_WARN_ALL_OFF)
20 #define pWARN_STD NULL
21 #define pWARN_ALL (STRLEN *) &PL_WARN_ALL /* use warnings 'all' */
22 #define pWARN_NONE (STRLEN *) &PL_WARN_NONE /* no warnings 'all' */
24 #define specialWARN(x) ((x) == pWARN_STD || (x) == pWARN_ALL || \
27 /* if PL_warnhook is set to this value, then warnings die */
28 #define PERL_WARNHOOK_FATAL (&PL_sv_placeholder)
30 /* Warnings Categories added in Perl 5.008 */
33 #define WARN_CLOSURE 1
34 #define WARN_DEPRECATED 2
35 #define WARN_EXITING 3
41 #define WARN_NEWLINE 9
43 #define WARN_UNOPENED 11
45 #define WARN_NUMERIC 13
47 #define WARN_OVERFLOW 15
49 #define WARN_PORTABLE 17
50 #define WARN_RECURSION 18
51 #define WARN_REDEFINE 19
52 #define WARN_REGEXP 20
53 #define WARN_SEVERE 21
54 #define WARN_DEBUGGING 22
55 #define WARN_INPLACE 23
56 #define WARN_INTERNAL 24
57 #define WARN_MALLOC 25
58 #define WARN_SIGNAL 26
59 #define WARN_SUBSTR 27
60 #define WARN_SYNTAX 28
61 #define WARN_AMBIGUOUS 29
62 #define WARN_BAREWORD 30
64 #define WARN_PARENTHESIS 32
65 #define WARN_PRECEDENCE 33
66 #define WARN_PRINTF 34
67 #define WARN_PROTOTYPE 35
69 #define WARN_RESERVED 37
70 #define WARN_SEMICOLON 38
72 #define WARN_THREADS 40
73 #define WARN_UNINITIALIZED 41
74 #define WARN_UNPACK 42
79 /* Warnings Categories added in Perl 5.011 */
81 #define WARN_IMPRECISION 46
82 #define WARN_ILLEGALPROTO 47
84 /* Warnings Categories added in Perl 5.013 */
86 #define WARN_NON_UNICODE 48
87 #define WARN_NONCHAR 49
88 #define WARN_SURROGATE 50
90 /* Warnings Categories added in Perl 5.017 */
92 #define WARN_EXPERIMENTAL 51
93 #define WARN_EXPERIMENTAL__LEXICAL_SUBS 52
94 #define WARN_EXPERIMENTAL__REGEX_SETS 53
95 #define WARN_EXPERIMENTAL__SMARTMATCH 54
97 /* Warnings Categories added in Perl 5.019 */
99 #define WARN_EXPERIMENTAL__POSTDEREF 55
100 #define WARN_EXPERIMENTAL__SIGNATURES 56
101 #define WARN_SYSCALLS 57
103 /* Warnings Categories added in Perl 5.021 */
105 #define WARN_EXPERIMENTAL__BITWISE 58
106 #define WARN_EXPERIMENTAL__CONST_ATTR 59
107 #define WARN_EXPERIMENTAL__RE_STRICT 60
108 #define WARN_EXPERIMENTAL__REFALIASING 61
109 #define WARN_LOCALE 62
110 #define WARN_MISSING 63
111 #define WARN_REDUNDANT 64
113 /* Warnings Categories added in Perl 5.025 */
115 #define WARN_EXPERIMENTAL__DECLARED_REFS 65
117 /* Warnings Categories added in Perl 5.027 */
119 #define WARN_EXPERIMENTAL__ALPHA_ASSERTIONS 66
120 #define WARN_EXPERIMENTAL__SCRIPT_RUN 67
121 #define WARN_SHADOW 68
123 /* Warnings Categories added in Perl 5.029 */
125 #define WARN_EXPERIMENTAL__PRIVATE_USE 69
126 #define WARN_EXPERIMENTAL__UNIPROP_WILDCARDS 70
127 #define WARN_EXPERIMENTAL__VLB 71
129 /* Warnings Categories added in Perl 5.031 */
131 #define WARN_EXPERIMENTAL__ISA 72
133 /* Warnings Categories added in Perl 5.033 */
135 #define WARN_EXPERIMENTAL__TRY 73
137 /* Warnings Categories added in Perl 5.035 */
139 #define WARN_EXPERIMENTAL__ARGS_ARRAY_WITH_SIGNATURES 74
140 #define WARN_EXPERIMENTAL__BUILTIN 75
141 #define WARN_EXPERIMENTAL__DEFER 76
142 #define WARN_EXPERIMENTAL__EXTRA_PAIRED_DELIMITERS 77
143 #define WARN_EXPERIMENTAL__FOR_LIST 78
144 #define WARN_SCALAR 79
146 #define WARN_ALLstring "\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125"
147 #define WARN_NONEstring "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0"
149 #define isLEXWARN_on \
150 cBOOL(PL_curcop && PL_curcop->cop_warnings != pWARN_STD)
151 #define isLEXWARN_off \
152 cBOOL(!PL_curcop || PL_curcop->cop_warnings == pWARN_STD)
153 #define isWARN_ONCE (PL_dowarn & (G_WARN_ON|G_WARN_ONCE))
154 #define isWARN_on(c,x) (PerlWarnIsSet_((U8 *)(c + 1), 2*(x)))
155 #define isWARNf_on(c,x) (PerlWarnIsSet_((U8 *)(c + 1), 2*(x)+1))
157 #define DUP_WARNINGS(p) Perl_dup_warnings(aTHX_ p)
159 #define free_and_set_cop_warnings(cmp,w) STMT_START { \
160 if (!specialWARN((cmp)->cop_warnings)) PerlMemShared_free((cmp)->cop_warnings); \
161 (cmp)->cop_warnings = w; \
166 =head1 Warning and Dieing
168 In all these calls, the C<U32 wI<n>> parameters are warning category
169 constants. You can see the ones currently available in
170 L<warnings/Category Hierarchy>, just capitalize all letters in the names
171 and prefix them by C<WARN_>. So, for example, the category C<void> used in a
172 perl program becomes C<WARN_VOID> when used in XS code and passed to one of
175 =for apidoc Am|bool|ckWARN|U32 w
176 =for apidoc_item ||ckWARN2|U32 w1|U32 w2
177 =for apidoc_item ||ckWARN3|U32 w1|U32 w2|U32 w3
178 =for apidoc_item ||ckWARN4|U32 w1|U32 w2|U32 w3|U32 w4
179 These return a boolean as to whether or not warnings are enabled for any of
180 the warning category(ies) parameters: C<w>, C<w1>, ....
182 Should any of the categories by default be enabled even if not within the
183 scope of S<C<use warnings>>, instead use the C<L</ckWARN_d>> macros.
185 The categories must be completely independent, one may not be subclassed from
188 =for apidoc Am|bool|ckWARN_d|U32 w
189 =for apidoc_item ||ckWARN2_d|U32 w1|U32 w2
190 =for apidoc_item ||ckWARN3_d|U32 w1|U32 w2|U32 w3
191 =for apidoc_item ||ckWARN4_d|U32 w1|U32 w2|U32 w3|U32 w4
193 Like C<L</ckWARN>>, but for use if and only if the warning category(ies) is by
194 default enabled even if not within the scope of S<C<use warnings>>.
196 =for apidoc Am|U32|packWARN|U32 w1
197 =for apidoc_item ||packWARN2|U32 w1|U32 w2
198 =for apidoc_item ||packWARN3|U32 w1|U32 w2|U32 w3
199 =for apidoc_item ||packWARN4|U32 w1|U32 w2|U32 w3|U32 w4
201 These macros are used to pack warning categories into a single U32 to pass to
202 macros and functions that take a warning category parameter. The number of
203 categories to pack is given by the name, with a corresponding number of
204 category parameters passed.
210 #define ckWARN(w) Perl_ckwarn(aTHX_ packWARN(w))
212 /* The w1, w2 ... should be independent warnings categories; one shouldn't be
213 * a subcategory of any other */
215 #define ckWARN2(w1,w2) Perl_ckwarn(aTHX_ packWARN2(w1,w2))
216 #define ckWARN3(w1,w2,w3) Perl_ckwarn(aTHX_ packWARN3(w1,w2,w3))
217 #define ckWARN4(w1,w2,w3,w4) Perl_ckwarn(aTHX_ packWARN4(w1,w2,w3,w4))
219 #define ckWARN_d(w) Perl_ckwarn_d(aTHX_ packWARN(w))
220 #define ckWARN2_d(w1,w2) Perl_ckwarn_d(aTHX_ packWARN2(w1,w2))
221 #define ckWARN3_d(w1,w2,w3) Perl_ckwarn_d(aTHX_ packWARN3(w1,w2,w3))
222 #define ckWARN4_d(w1,w2,w3,w4) Perl_ckwarn_d(aTHX_ packWARN4(w1,w2,w3,w4))
226 #define packWARN(a) (a )
228 /* The a, b, ... should be independent warnings categories; one shouldn't be
229 * a subcategory of any other */
231 #define packWARN2(a,b) ((a) | ((b)<<8) )
232 #define packWARN3(a,b,c) ((a) | ((b)<<8) | ((c)<<16) )
233 #define packWARN4(a,b,c,d) ((a) | ((b)<<8) | ((c)<<16) | ((d) <<24))
235 #define unpackWARN1(x) ((U8) (x) )
236 #define unpackWARN2(x) ((U8) ((x) >> 8))
237 #define unpackWARN3(x) ((U8) ((x) >> 16))
238 #define unpackWARN4(x) ((U8) ((x) >> 24))
242 !specialWARN(PL_curcop->cop_warnings) && \
243 (isWARNf_on(PL_curcop->cop_warnings, unpackWARN1(x)) || \
245 (isWARNf_on(PL_curcop->cop_warnings, unpackWARN2(x)) || \
247 (isWARNf_on(PL_curcop->cop_warnings, unpackWARN3(x)) || \
249 isWARNf_on(PL_curcop->cop_warnings, unpackWARN4(x)))))))))
254 =for apidoc Amnh||WARN_ALL
255 =for apidoc Amnh||WARN_CLOSURE
256 =for apidoc Amnh||WARN_DEPRECATED
257 =for apidoc Amnh||WARN_EXITING
258 =for apidoc Amnh||WARN_GLOB
259 =for apidoc Amnh||WARN_IO
260 =for apidoc Amnh||WARN_CLOSED
261 =for apidoc Amnh||WARN_EXEC
262 =for apidoc Amnh||WARN_LAYER
263 =for apidoc Amnh||WARN_NEWLINE
264 =for apidoc Amnh||WARN_PIPE
265 =for apidoc Amnh||WARN_UNOPENED
266 =for apidoc Amnh||WARN_MISC
267 =for apidoc Amnh||WARN_NUMERIC
268 =for apidoc Amnh||WARN_ONCE
269 =for apidoc Amnh||WARN_OVERFLOW
270 =for apidoc Amnh||WARN_PACK
271 =for apidoc Amnh||WARN_PORTABLE
272 =for apidoc Amnh||WARN_RECURSION
273 =for apidoc Amnh||WARN_REDEFINE
274 =for apidoc Amnh||WARN_REGEXP
275 =for apidoc Amnh||WARN_SEVERE
276 =for apidoc Amnh||WARN_DEBUGGING
277 =for apidoc Amnh||WARN_INPLACE
278 =for apidoc Amnh||WARN_INTERNAL
279 =for apidoc Amnh||WARN_MALLOC
280 =for apidoc Amnh||WARN_SIGNAL
281 =for apidoc Amnh||WARN_SUBSTR
282 =for apidoc Amnh||WARN_SYNTAX
283 =for apidoc Amnh||WARN_AMBIGUOUS
284 =for apidoc Amnh||WARN_BAREWORD
285 =for apidoc Amnh||WARN_DIGIT
286 =for apidoc Amnh||WARN_PARENTHESIS
287 =for apidoc Amnh||WARN_PRECEDENCE
288 =for apidoc Amnh||WARN_PRINTF
289 =for apidoc Amnh||WARN_PROTOTYPE
290 =for apidoc Amnh||WARN_QW
291 =for apidoc Amnh||WARN_RESERVED
292 =for apidoc Amnh||WARN_SEMICOLON
293 =for apidoc Amnh||WARN_TAINT
294 =for apidoc Amnh||WARN_THREADS
295 =for apidoc Amnh||WARN_UNINITIALIZED
296 =for apidoc Amnh||WARN_UNPACK
297 =for apidoc Amnh||WARN_UNTIE
298 =for apidoc Amnh||WARN_UTF8
299 =for apidoc Amnh||WARN_VOID
300 =for apidoc Amnh||WARN_IMPRECISION
301 =for apidoc Amnh||WARN_ILLEGALPROTO
302 =for apidoc Amnh||WARN_NON_UNICODE
303 =for apidoc Amnh||WARN_NONCHAR
304 =for apidoc Amnh||WARN_SURROGATE
305 =for apidoc Amnh||WARN_EXPERIMENTAL
306 =for apidoc Amnh||WARN_EXPERIMENTAL__LEXICAL_SUBS
307 =for apidoc Amnh||WARN_EXPERIMENTAL__REGEX_SETS
308 =for apidoc Amnh||WARN_EXPERIMENTAL__SMARTMATCH
309 =for apidoc Amnh||WARN_EXPERIMENTAL__POSTDEREF
310 =for apidoc Amnh||WARN_EXPERIMENTAL__SIGNATURES
311 =for apidoc Amnh||WARN_SYSCALLS
312 =for apidoc Amnh||WARN_EXPERIMENTAL__BITWISE
313 =for apidoc Amnh||WARN_EXPERIMENTAL__CONST_ATTR
314 =for apidoc Amnh||WARN_EXPERIMENTAL__RE_STRICT
315 =for apidoc Amnh||WARN_EXPERIMENTAL__REFALIASING
316 =for apidoc Amnh||WARN_LOCALE
317 =for apidoc Amnh||WARN_MISSING
318 =for apidoc Amnh||WARN_REDUNDANT
319 =for apidoc Amnh||WARN_EXPERIMENTAL__DECLARED_REFS
320 =for apidoc Amnh||WARN_EXPERIMENTAL__ALPHA_ASSERTIONS
321 =for apidoc Amnh||WARN_EXPERIMENTAL__SCRIPT_RUN
322 =for apidoc Amnh||WARN_SHADOW
323 =for apidoc Amnh||WARN_EXPERIMENTAL__PRIVATE_USE
324 =for apidoc Amnh||WARN_EXPERIMENTAL__UNIPROP_WILDCARDS
325 =for apidoc Amnh||WARN_EXPERIMENTAL__VLB
326 =for apidoc Amnh||WARN_EXPERIMENTAL__ISA
327 =for apidoc Amnh||WARN_EXPERIMENTAL__TRY
328 =for apidoc Amnh||WARN_EXPERIMENTAL__ARGS_ARRAY_WITH_SIGNATURES
329 =for apidoc Amnh||WARN_EXPERIMENTAL__BUILTIN
330 =for apidoc Amnh||WARN_EXPERIMENTAL__DEFER
331 =for apidoc Amnh||WARN_EXPERIMENTAL__EXTRA_PAIRED_DELIMITERS
332 =for apidoc Amnh||WARN_EXPERIMENTAL__FOR_LIST
333 =for apidoc Amnh||WARN_SCALAR
338 /* end of file warnings.h */