This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
https://perl5.git.perl.org / perl5.git / blame_incremental
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (non-incremental) | history | HEAD
Bump Data::Dumper version
[perl5.git] / warnings.h
... / ...
CommitLineData
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!
5 */
6
7
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))
11
12
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)
19
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' */
23
24#define specialWARN(x) ((x) == pWARN_STD || (x) == pWARN_ALL || \
25 (x) == pWARN_NONE)
26
27/* if PL_warnhook is set to this value, then warnings die */
28#define PERL_WARNHOOK_FATAL (&PL_sv_placeholder)
29
30/* Warnings Categories added in Perl 5.008 */
31
32#define WARN_ALL 0
33#define WARN_CLOSURE 1
34#define WARN_DEPRECATED 2
35#define WARN_EXITING 3
36#define WARN_GLOB 4
37#define WARN_IO 5
38#define WARN_CLOSED 6
39#define WARN_EXEC 7
40#define WARN_LAYER 8
41#define WARN_NEWLINE 9
42#define WARN_PIPE 10
43#define WARN_UNOPENED 11
44#define WARN_MISC 12
45#define WARN_NUMERIC 13
46#define WARN_ONCE 14
47#define WARN_OVERFLOW 15
48#define WARN_PACK 16
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
63#define WARN_DIGIT 31
64#define WARN_PARENTHESIS 32
65#define WARN_PRECEDENCE 33
66#define WARN_PRINTF 34
67#define WARN_PROTOTYPE 35
68#define WARN_QW 36
69#define WARN_RESERVED 37
70#define WARN_SEMICOLON 38
71#define WARN_TAINT 39
72#define WARN_THREADS 40
73#define WARN_UNINITIALIZED 41
74#define WARN_UNPACK 42
75#define WARN_UNTIE 43
76#define WARN_UTF8 44
77#define WARN_VOID 45
78
79/* Warnings Categories added in Perl 5.011 */
80
81#define WARN_IMPRECISION 46
82#define WARN_ILLEGALPROTO 47
83
84/* Warnings Categories added in Perl 5.013 */
85
86#define WARN_NON_UNICODE 48
87#define WARN_NONCHAR 49
88#define WARN_SURROGATE 50
89
90/* Warnings Categories added in Perl 5.017 */
91
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
96
97/* Warnings Categories added in Perl 5.019 */
98
99#define WARN_EXPERIMENTAL__POSTDEREF 55
100#define WARN_EXPERIMENTAL__SIGNATURES 56
101#define WARN_SYSCALLS 57
102
103/* Warnings Categories added in Perl 5.021 */
104
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_EXPERIMENTAL__WIN32_PERLIO 62
110#define WARN_LOCALE 63
111#define WARN_MISSING 64
112#define WARN_REDUNDANT 65
113
114/* Warnings Categories added in Perl 5.025 */
115
116#define WARN_EXPERIMENTAL__DECLARED_REFS 66
117
118/* Warnings Categories added in Perl 5.027 */
119
120#define WARN_EXPERIMENTAL__ALPHA_ASSERTIONS 67
121#define WARN_EXPERIMENTAL__SCRIPT_RUN 68
122#define WARN_SHADOW 69
123
124/* Warnings Categories added in Perl 5.029 */
125
126#define WARN_EXPERIMENTAL__PRIVATE_USE 70
127#define WARN_EXPERIMENTAL__UNIPROP_WILDCARDS 71
128#define WARN_EXPERIMENTAL__VLB 72
129
130/* Warnings Categories added in Perl 5.031 */
131
132#define WARN_EXPERIMENTAL__ISA 73
133
134/* Warnings Categories added in Perl 5.033 */
135
136#define WARN_EXPERIMENTAL__TRY 74
137#define WARNsize 19
138#define WARN_ALLstring "\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125\125"
139#define WARN_NONEstring "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0"
140
141#define isLEXWARN_on \
142 cBOOL(PL_curcop && PL_curcop->cop_warnings != pWARN_STD)
143#define isLEXWARN_off \
144 cBOOL(!PL_curcop || PL_curcop->cop_warnings == pWARN_STD)
145#define isWARN_ONCE (PL_dowarn & (G_WARN_ON|G_WARN_ONCE))
146#define isWARN_on(c,x) (PerlWarnIsSet_((U8 *)(c + 1), 2*(x)))
147#define isWARNf_on(c,x) (PerlWarnIsSet_((U8 *)(c + 1), 2*(x)+1))
148
149#define DUP_WARNINGS(p) Perl_dup_warnings(aTHX_ p)
150
151#define free_and_set_cop_warnings(cmp,w) STMT_START { \
152 if (!specialWARN((cmp)->cop_warnings)) PerlMemShared_free((cmp)->cop_warnings); \
153 (cmp)->cop_warnings = w; \
154} STMT_END
155
156/*
157
158=head1 Warning and Dieing
159
160In all these calls, the C<U32 wI<n>> parameters are warning category
161constants. You can see the ones currently available in
162L<warnings/Category Hierarchy>, just capitalize all letters in the names
163and prefix them by C<WARN_>. So, for example, the category C<void> used in a
164perl program becomes C<WARN_VOID> when used in XS code and passed to one of
165the calls below.
166
167=for apidoc Am|bool|ckWARN|U32 w
168=for apidoc_item ||ckWARN2|U32 w1|U32 w2
169=for apidoc_item ||ckWARN3|U32 w1|U32 w2|U32 w3
170=for apidoc_item ||ckWARN4|U32 w1|U32 w2|U32 w3|U32 w4
171These return a boolean as to whether or not warnings are enabled for any of
172the warning category(ies) parameters: C<w>, C<w1>, ....
173
174Should any of the categories by default be enabled even if not within the
175scope of S<C<use warnings>>, instead use the C<L</ckWARN_d>> macros.
176
177The categories must be completely independent, one may not be subclassed from
178the other.
179
180=for apidoc Am|bool|ckWARN_d|U32 w
181=for apidoc_item ||ckWARN2_d|U32 w1|U32 w2
182=for apidoc_item ||ckWARN3_d|U32 w1|U32 w2|U32 w3
183=for apidoc_item ||ckWARN4_d|U32 w1|U32 w2|U32 w3|U32 w4
184
185Like C<L</ckWARN>>, but for use if and only if the warning category(ies) is by
186default enabled even if not within the scope of S<C<use warnings>>.
187
188=for apidoc Am|U32|packWARN|U32 w1
189=for apidoc_item ||packWARN2|U32 w1|U32 w2
190=for apidoc_item ||packWARN3|U32 w1|U32 w2|U32 w3
191=for apidoc_item ||packWARN4|U32 w1|U32 w2|U32 w3|U32 w4
192
193These macros are used to pack warning categories into a single U32 to pass to
194macros and functions that take a warning category parameter. The number of
195categories to pack is given by the name, with a corresponding number of
196category parameters passed.
197
198=cut
199
200*/
201
202#define ckWARN(w) Perl_ckwarn(aTHX_ packWARN(w))
203
204/* The w1, w2 ... should be independent warnings categories; one shouldn't be
205 * a subcategory of any other */
206
207#define ckWARN2(w1,w2) Perl_ckwarn(aTHX_ packWARN2(w1,w2))
208#define ckWARN3(w1,w2,w3) Perl_ckwarn(aTHX_ packWARN3(w1,w2,w3))
209#define ckWARN4(w1,w2,w3,w4) Perl_ckwarn(aTHX_ packWARN4(w1,w2,w3,w4))
210
211#define ckWARN_d(w) Perl_ckwarn_d(aTHX_ packWARN(w))
212#define ckWARN2_d(w1,w2) Perl_ckwarn_d(aTHX_ packWARN2(w1,w2))
213#define ckWARN3_d(w1,w2,w3) Perl_ckwarn_d(aTHX_ packWARN3(w1,w2,w3))
214#define ckWARN4_d(w1,w2,w3,w4) Perl_ckwarn_d(aTHX_ packWARN4(w1,w2,w3,w4))
215
216#define WARNshift 8
217
218#define packWARN(a) (a )
219
220/* The a, b, ... should be independent warnings categories; one shouldn't be
221 * a subcategory of any other */
222
223#define packWARN2(a,b) ((a) | ((b)<<8) )
224#define packWARN3(a,b,c) ((a) | ((b)<<8) | ((c)<<16) )
225#define packWARN4(a,b,c,d) ((a) | ((b)<<8) | ((c)<<16) | ((d) <<24))
226
227#define unpackWARN1(x) ((x) & 0xFF)
228#define unpackWARN2(x) (((x) >>8) & 0xFF)
229#define unpackWARN3(x) (((x) >>16) & 0xFF)
230#define unpackWARN4(x) (((x) >>24) & 0xFF)
231
232#define ckDEAD(x) \
233 (PL_curcop && \
234 !specialWARN(PL_curcop->cop_warnings) && \
235 (isWARNf_on(PL_curcop->cop_warnings, unpackWARN1(x)) || \
236 (unpackWARN2(x) && \
237 (isWARNf_on(PL_curcop->cop_warnings, unpackWARN2(x)) || \
238 (unpackWARN3(x) && \
239 (isWARNf_on(PL_curcop->cop_warnings, unpackWARN3(x)) || \
240 (unpackWARN4(x) && \
241 isWARNf_on(PL_curcop->cop_warnings, unpackWARN4(x)))))))))
242
243
244
245/*
246=for apidoc Amnh||WARN_ALL
247=for apidoc Amnh||WARN_CLOSURE
248=for apidoc Amnh||WARN_DEPRECATED
249=for apidoc Amnh||WARN_EXITING
250=for apidoc Amnh||WARN_GLOB
251=for apidoc Amnh||WARN_IO
252=for apidoc Amnh||WARN_CLOSED
253=for apidoc Amnh||WARN_EXEC
254=for apidoc Amnh||WARN_LAYER
255=for apidoc Amnh||WARN_NEWLINE
256=for apidoc Amnh||WARN_PIPE
257=for apidoc Amnh||WARN_UNOPENED
258=for apidoc Amnh||WARN_MISC
259=for apidoc Amnh||WARN_NUMERIC
260=for apidoc Amnh||WARN_ONCE
261=for apidoc Amnh||WARN_OVERFLOW
262=for apidoc Amnh||WARN_PACK
263=for apidoc Amnh||WARN_PORTABLE
264=for apidoc Amnh||WARN_RECURSION
265=for apidoc Amnh||WARN_REDEFINE
266=for apidoc Amnh||WARN_REGEXP
267=for apidoc Amnh||WARN_SEVERE
268=for apidoc Amnh||WARN_DEBUGGING
269=for apidoc Amnh||WARN_INPLACE
270=for apidoc Amnh||WARN_INTERNAL
271=for apidoc Amnh||WARN_MALLOC
272=for apidoc Amnh||WARN_SIGNAL
273=for apidoc Amnh||WARN_SUBSTR
274=for apidoc Amnh||WARN_SYNTAX
275=for apidoc Amnh||WARN_AMBIGUOUS
276=for apidoc Amnh||WARN_BAREWORD
277=for apidoc Amnh||WARN_DIGIT
278=for apidoc Amnh||WARN_PARENTHESIS
279=for apidoc Amnh||WARN_PRECEDENCE
280=for apidoc Amnh||WARN_PRINTF
281=for apidoc Amnh||WARN_PROTOTYPE
282=for apidoc Amnh||WARN_QW
283=for apidoc Amnh||WARN_RESERVED
284=for apidoc Amnh||WARN_SEMICOLON
285=for apidoc Amnh||WARN_TAINT
286=for apidoc Amnh||WARN_THREADS
287=for apidoc Amnh||WARN_UNINITIALIZED
288=for apidoc Amnh||WARN_UNPACK
289=for apidoc Amnh||WARN_UNTIE
290=for apidoc Amnh||WARN_UTF8
291=for apidoc Amnh||WARN_VOID
292=for apidoc Amnh||WARN_IMPRECISION
293=for apidoc Amnh||WARN_ILLEGALPROTO
294=for apidoc Amnh||WARN_NON_UNICODE
295=for apidoc Amnh||WARN_NONCHAR
296=for apidoc Amnh||WARN_SURROGATE
297=for apidoc Amnh||WARN_EXPERIMENTAL
298=for apidoc Amnh||WARN_EXPERIMENTAL__LEXICAL_SUBS
299=for apidoc Amnh||WARN_EXPERIMENTAL__REGEX_SETS
300=for apidoc Amnh||WARN_EXPERIMENTAL__SMARTMATCH
301=for apidoc Amnh||WARN_EXPERIMENTAL__POSTDEREF
302=for apidoc Amnh||WARN_EXPERIMENTAL__SIGNATURES
303=for apidoc Amnh||WARN_SYSCALLS
304=for apidoc Amnh||WARN_EXPERIMENTAL__BITWISE
305=for apidoc Amnh||WARN_EXPERIMENTAL__CONST_ATTR
306=for apidoc Amnh||WARN_EXPERIMENTAL__RE_STRICT
307=for apidoc Amnh||WARN_EXPERIMENTAL__REFALIASING
308=for apidoc Amnh||WARN_EXPERIMENTAL__WIN32_PERLIO
309=for apidoc Amnh||WARN_LOCALE
310=for apidoc Amnh||WARN_MISSING
311=for apidoc Amnh||WARN_REDUNDANT
312=for apidoc Amnh||WARN_EXPERIMENTAL__DECLARED_REFS
313=for apidoc Amnh||WARN_EXPERIMENTAL__ALPHA_ASSERTIONS
314=for apidoc Amnh||WARN_EXPERIMENTAL__SCRIPT_RUN
315=for apidoc Amnh||WARN_SHADOW
316=for apidoc Amnh||WARN_EXPERIMENTAL__PRIVATE_USE
317=for apidoc Amnh||WARN_EXPERIMENTAL__UNIPROP_WILDCARDS
318=for apidoc Amnh||WARN_EXPERIMENTAL__VLB
319=for apidoc Amnh||WARN_EXPERIMENTAL__ISA
320=for apidoc Amnh||WARN_EXPERIMENTAL__TRY
321
322=cut
323*/
324
325/* end of file warnings.h */
326
327/* ex: set ro: */
Unnamed repository; edit this file 'description' to name the repository.