c-family: Support format checking C2X %b, %B formats
[official-gcc.git] / gcc / c-family / c-common.h
blob078730f1e6479a19cb0cc67ecc6412e11434e5c0
1 /* Definitions for c-common.c.
2 Copyright (C) 1987-2021 Free Software Foundation, Inc.
4 This file is part of GCC.
6 GCC is free software; you can redistribute it and/or modify it under
7 the terms of the GNU General Public License as published by the Free
8 Software Foundation; either version 3, or (at your option) any later
9 version.
11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 for more details.
16 You should have received a copy of the GNU General Public License
17 along with GCC; see the file COPYING3. If not see
18 <http://www.gnu.org/licenses/>. */
20 #ifndef GCC_C_COMMON_H
21 #define GCC_C_COMMON_H
23 #include "splay-tree.h"
24 #include "cpplib.h"
25 #include "alias.h"
26 #include "tree.h"
27 #include "fold-const.h"
28 #include "wide-int-bitmask.h"
30 /* In order for the format checking to accept the C frontend
31 diagnostic framework extensions, you must include this file before
32 diagnostic-core.h, not after. The C front end formats are a subset of those
33 for C++, so they are the appropriate set to use in common code;
34 cp-tree.h overrides this for C++. */
35 #if defined(GCC_DIAGNOSTIC_CORE_H)
36 #error \
37 In order for the format checking to accept the C front end diagnostic \
38 framework extensions, you must include this file before diagnostic-core.h \
39 never after.
40 #endif
41 #ifndef GCC_DIAG_STYLE
42 #define GCC_DIAG_STYLE __gcc_cdiag__
43 #endif
44 #include "diagnostic-core.h"
46 /* Usage of TREE_LANG_FLAG_?:
47 0: IDENTIFIER_MARKED (used by search routines).
48 C_MAYBE_CONST_EXPR_INT_OPERANDS (in C_MAYBE_CONST_EXPR, for C)
49 1: C_DECLARED_LABEL_FLAG (in LABEL_DECL)
50 STATEMENT_LIST_STMT_EXPR (in STATEMENT_LIST)
51 C_MAYBE_CONST_EXPR_NON_CONST (in C_MAYBE_CONST_EXPR, for C)
52 2: unused
53 3: STATEMENT_LIST_HAS_LABEL (in STATEMENT_LIST)
54 4: unused
57 /* Reserved identifiers. This is the union of all the keywords for C,
58 C++, and Objective-C. All the type modifiers have to be in one
59 block at the beginning, because they are used as mask bits. There
60 are 28 type modifiers; if we add many more we will have to redesign
61 the mask mechanism. */
63 enum rid
65 /* Modifiers: */
66 /* C, in empirical order of frequency. */
67 RID_STATIC = 0,
68 RID_UNSIGNED, RID_LONG, RID_CONST, RID_EXTERN,
69 RID_REGISTER, RID_TYPEDEF, RID_SHORT, RID_INLINE,
70 RID_VOLATILE, RID_SIGNED, RID_AUTO, RID_RESTRICT,
71 RID_NORETURN, RID_ATOMIC,
73 /* C extensions */
74 RID_COMPLEX, RID_THREAD, RID_SAT,
76 /* C++ */
77 RID_FRIEND, RID_VIRTUAL, RID_EXPLICIT, RID_EXPORT, RID_MUTABLE,
79 /* ObjC ("PQ" reserved words - they do not appear after a '@' and
80 are keywords only in specific contexts) */
81 RID_IN, RID_OUT, RID_INOUT, RID_BYCOPY, RID_BYREF, RID_ONEWAY,
83 /* ObjC ("PATTR" reserved words - they do not appear after a '@'
84 and are keywords only as property attributes) */
85 RID_GETTER, RID_SETTER,
86 RID_READONLY, RID_READWRITE,
87 RID_ASSIGN, RID_RETAIN, RID_COPY,
88 RID_PROPATOMIC, RID_NONATOMIC,
90 /* ObjC nullability support keywords that also can appear in the
91 property attribute context. These values should remain contiguous
92 with the other property attributes. */
93 RID_NULL_UNSPECIFIED, RID_NULLABLE, RID_NONNULL, RID_NULL_RESETTABLE,
95 /* C (reserved and imaginary types not implemented, so any use is a
96 syntax error) */
97 RID_IMAGINARY,
99 /* C */
100 RID_INT, RID_CHAR, RID_FLOAT, RID_DOUBLE, RID_VOID,
101 RID_ENUM, RID_STRUCT, RID_UNION, RID_IF, RID_ELSE,
102 RID_WHILE, RID_DO, RID_FOR, RID_SWITCH, RID_CASE,
103 RID_DEFAULT, RID_BREAK, RID_CONTINUE, RID_RETURN, RID_GOTO,
104 RID_SIZEOF,
106 /* C extensions */
107 RID_ASM, RID_TYPEOF, RID_ALIGNOF, RID_ATTRIBUTE, RID_VA_ARG,
108 RID_EXTENSION, RID_IMAGPART, RID_REALPART, RID_LABEL, RID_CHOOSE_EXPR,
109 RID_TYPES_COMPATIBLE_P, RID_BUILTIN_COMPLEX, RID_BUILTIN_SHUFFLE,
110 RID_BUILTIN_SHUFFLEVECTOR, RID_BUILTIN_CONVERTVECTOR, RID_BUILTIN_TGMATH,
111 RID_BUILTIN_HAS_ATTRIBUTE,
112 RID_DFLOAT32, RID_DFLOAT64, RID_DFLOAT128,
114 /* TS 18661-3 keywords, in the same sequence as the TI_* values. */
115 RID_FLOAT16,
116 RID_FLOATN_NX_FIRST = RID_FLOAT16,
117 RID_FLOAT32,
118 RID_FLOAT64,
119 RID_FLOAT128,
120 RID_FLOAT32X,
121 RID_FLOAT64X,
122 RID_FLOAT128X,
123 #define CASE_RID_FLOATN_NX \
124 case RID_FLOAT16: case RID_FLOAT32: case RID_FLOAT64: case RID_FLOAT128: \
125 case RID_FLOAT32X: case RID_FLOAT64X: case RID_FLOAT128X
127 RID_FRACT, RID_ACCUM, RID_AUTO_TYPE, RID_BUILTIN_CALL_WITH_STATIC_CHAIN,
129 /* "__GIMPLE", for the GIMPLE-parsing extension to the C frontend. */
130 RID_GIMPLE,
132 /* "__PHI", for parsing PHI function in GIMPLE FE. */
133 RID_PHI,
135 /* "__RTL", for the RTL-parsing extension to the C frontend. */
136 RID_RTL,
138 /* C11 */
139 RID_ALIGNAS, RID_GENERIC,
141 /* This means to warn that this is a C++ keyword, and then treat it
142 as a normal identifier. */
143 RID_CXX_COMPAT_WARN,
145 /* GNU transactional memory extension */
146 RID_TRANSACTION_ATOMIC, RID_TRANSACTION_RELAXED, RID_TRANSACTION_CANCEL,
148 /* Too many ways of getting the name of a function as a string */
149 RID_FUNCTION_NAME, RID_PRETTY_FUNCTION_NAME, RID_C99_FUNCTION_NAME,
151 /* C++ (some of these are keywords in Objective-C as well, but only
152 if they appear after a '@') */
153 RID_BOOL, RID_WCHAR, RID_CLASS,
154 RID_PUBLIC, RID_PRIVATE, RID_PROTECTED,
155 RID_TEMPLATE, RID_NULL, RID_CATCH,
156 RID_DELETE, RID_FALSE, RID_NAMESPACE,
157 RID_NEW, RID_OFFSETOF, RID_OPERATOR,
158 RID_THIS, RID_THROW, RID_TRUE,
159 RID_TRY, RID_TYPENAME, RID_TYPEID,
160 RID_USING, RID_CHAR16, RID_CHAR32,
162 /* casts */
163 RID_CONSTCAST, RID_DYNCAST, RID_REINTCAST, RID_STATCAST,
165 /* C++ extensions */
166 RID_ADDRESSOF, RID_BASES,
167 RID_BUILTIN_LAUNDER, RID_DIRECT_BASES,
168 RID_HAS_NOTHROW_ASSIGN, RID_HAS_NOTHROW_CONSTRUCTOR,
169 RID_HAS_NOTHROW_COPY, RID_HAS_TRIVIAL_ASSIGN,
170 RID_HAS_TRIVIAL_CONSTRUCTOR, RID_HAS_TRIVIAL_COPY,
171 RID_HAS_TRIVIAL_DESTRUCTOR, RID_HAS_UNIQUE_OBJ_REPRESENTATIONS,
172 RID_HAS_VIRTUAL_DESTRUCTOR, RID_BUILTIN_BIT_CAST,
173 RID_IS_ABSTRACT, RID_IS_AGGREGATE,
174 RID_IS_BASE_OF, RID_IS_CLASS,
175 RID_IS_EMPTY, RID_IS_ENUM,
176 RID_IS_FINAL, RID_IS_LAYOUT_COMPATIBLE,
177 RID_IS_LITERAL_TYPE,
178 RID_IS_POINTER_INTERCONVERTIBLE_BASE_OF,
179 RID_IS_POD, RID_IS_POLYMORPHIC,
180 RID_IS_SAME_AS,
181 RID_IS_STD_LAYOUT, RID_IS_TRIVIAL,
182 RID_IS_TRIVIALLY_ASSIGNABLE, RID_IS_TRIVIALLY_CONSTRUCTIBLE,
183 RID_IS_TRIVIALLY_COPYABLE,
184 RID_IS_UNION, RID_UNDERLYING_TYPE,
185 RID_IS_ASSIGNABLE, RID_IS_CONSTRUCTIBLE,
186 RID_IS_NOTHROW_ASSIGNABLE, RID_IS_NOTHROW_CONSTRUCTIBLE,
188 /* C++11 */
189 RID_CONSTEXPR, RID_DECLTYPE, RID_NOEXCEPT, RID_NULLPTR, RID_STATIC_ASSERT,
191 /* C++20 */
192 RID_CONSTINIT, RID_CONSTEVAL,
194 /* char8_t */
195 RID_CHAR8,
197 /* C++ concepts */
198 RID_CONCEPT, RID_REQUIRES,
200 /* C++ modules. */
201 RID__MODULE, RID__IMPORT, RID__EXPORT, /* Internal tokens. */
203 /* C++ coroutines */
204 RID_CO_AWAIT, RID_CO_YIELD, RID_CO_RETURN,
206 /* C++ transactional memory. */
207 RID_ATOMIC_NOEXCEPT, RID_ATOMIC_CANCEL, RID_SYNCHRONIZED,
209 /* Objective-C ("AT" reserved words - they are only keywords when
210 they follow '@') */
211 RID_AT_ENCODE, RID_AT_END,
212 RID_AT_CLASS, RID_AT_ALIAS, RID_AT_DEFS,
213 RID_AT_PRIVATE, RID_AT_PROTECTED, RID_AT_PUBLIC, RID_AT_PACKAGE,
214 RID_AT_PROTOCOL, RID_AT_SELECTOR,
215 RID_AT_THROW, RID_AT_TRY, RID_AT_CATCH,
216 RID_AT_FINALLY, RID_AT_SYNCHRONIZED,
217 RID_AT_OPTIONAL, RID_AT_REQUIRED, RID_AT_PROPERTY,
218 RID_AT_SYNTHESIZE, RID_AT_DYNAMIC,
219 RID_AT_INTERFACE,
220 RID_AT_IMPLEMENTATION,
222 /* Named address support, mapping the keyword to a particular named address
223 number. Named address space 0 is reserved for the generic address. If
224 there are more than 254 named addresses, the addr_space_t type will need
225 to be grown from an unsigned char to unsigned short. */
226 RID_ADDR_SPACE_0, /* generic address */
227 RID_ADDR_SPACE_1,
228 RID_ADDR_SPACE_2,
229 RID_ADDR_SPACE_3,
230 RID_ADDR_SPACE_4,
231 RID_ADDR_SPACE_5,
232 RID_ADDR_SPACE_6,
233 RID_ADDR_SPACE_7,
234 RID_ADDR_SPACE_8,
235 RID_ADDR_SPACE_9,
236 RID_ADDR_SPACE_10,
237 RID_ADDR_SPACE_11,
238 RID_ADDR_SPACE_12,
239 RID_ADDR_SPACE_13,
240 RID_ADDR_SPACE_14,
241 RID_ADDR_SPACE_15,
243 RID_FIRST_ADDR_SPACE = RID_ADDR_SPACE_0,
244 RID_LAST_ADDR_SPACE = RID_ADDR_SPACE_15,
246 /* __intN keywords. The _N_M here doesn't correspond to the intN
247 in the keyword; use the bitsize in int_n_t_data_t[M] for that.
248 For example, if int_n_t_data_t[0].bitsize is 13, then RID_INT_N_0
249 is for __int13. */
251 /* Note that the range to use is RID_FIRST_INT_N through
252 RID_FIRST_INT_N + NUM_INT_N_ENTS - 1 and c-parser.c has a list of
253 all RID_INT_N_* in a case statement. */
255 RID_INT_N_0,
256 RID_INT_N_1,
257 RID_INT_N_2,
258 RID_INT_N_3,
260 RID_FIRST_INT_N = RID_INT_N_0,
261 RID_LAST_INT_N = RID_INT_N_3,
263 RID_MAX,
265 RID_FIRST_MODIFIER = RID_STATIC,
266 RID_LAST_MODIFIER = RID_ONEWAY,
268 RID_FIRST_CXX11 = RID_CONSTEXPR,
269 RID_LAST_CXX11 = RID_STATIC_ASSERT,
270 RID_FIRST_CXX20 = RID_CONSTINIT,
271 RID_LAST_CXX20 = RID_CONSTINIT,
272 RID_FIRST_AT = RID_AT_ENCODE,
273 RID_LAST_AT = RID_AT_IMPLEMENTATION,
274 RID_FIRST_PQ = RID_IN,
275 RID_LAST_PQ = RID_ONEWAY,
276 RID_FIRST_PATTR = RID_GETTER,
277 RID_LAST_PATTR = RID_NULL_RESETTABLE
280 #define OBJC_IS_AT_KEYWORD(rid) \
281 ((unsigned int) (rid) >= (unsigned int) RID_FIRST_AT && \
282 (unsigned int) (rid) <= (unsigned int) RID_LAST_AT)
284 #define OBJC_IS_PQ_KEYWORD(rid) \
285 ((unsigned int) (rid) >= (unsigned int) RID_FIRST_PQ && \
286 (unsigned int) (rid) <= (unsigned int) RID_LAST_PQ)
288 /* Keywords permitted in an @property attribute context. */
289 #define OBJC_IS_PATTR_KEYWORD(rid) \
290 ((((unsigned int) (rid) >= (unsigned int) RID_FIRST_PATTR && \
291 (unsigned int) (rid) <= (unsigned int) RID_LAST_PATTR)) \
292 || rid == RID_CLASS)
294 /* OBJC_IS_CXX_KEYWORD recognizes the 'CXX_OBJC' keywords (such as
295 'class') which are shared in a subtle way between Objective-C and
296 C++. When the lexer is lexing in Objective-C/Objective-C++, if it
297 finds '@' followed by one of these identifiers (eg, '@class'), it
298 recognizes the whole as an Objective-C keyword. If the identifier
299 is found elsewhere, it follows the rules of the C/C++ language.
301 #define OBJC_IS_CXX_KEYWORD(rid) \
302 (rid == RID_CLASS || rid == RID_SYNCHRONIZED \
303 || rid == RID_PUBLIC || rid == RID_PROTECTED || rid == RID_PRIVATE \
304 || rid == RID_TRY || rid == RID_THROW || rid == RID_CATCH)
306 /* The elements of `ridpointers' are identifier nodes for the reserved
307 type names and storage classes. It is indexed by a RID_... value. */
308 extern GTY ((length ("(int) RID_MAX"))) tree *ridpointers;
310 /* Standard named or nameless data types of the C compiler. */
312 enum c_tree_index
314 CTI_CHAR8_TYPE,
315 CTI_CHAR16_TYPE,
316 CTI_CHAR32_TYPE,
317 CTI_WCHAR_TYPE,
318 CTI_UNDERLYING_WCHAR_TYPE,
319 CTI_WINT_TYPE,
320 CTI_SIGNED_SIZE_TYPE, /* For format checking only. */
321 CTI_UNSIGNED_PTRDIFF_TYPE, /* For format checking only. */
322 CTI_INTMAX_TYPE,
323 CTI_UINTMAX_TYPE,
324 CTI_WIDEST_INT_LIT_TYPE,
325 CTI_WIDEST_UINT_LIT_TYPE,
327 /* Types for <stdint.h>, that may not be defined on all
328 targets. */
329 CTI_SIG_ATOMIC_TYPE,
330 CTI_INT8_TYPE,
331 CTI_INT16_TYPE,
332 CTI_INT32_TYPE,
333 CTI_INT64_TYPE,
334 CTI_UINT8_TYPE,
335 CTI_UINT16_TYPE,
336 CTI_UINT32_TYPE,
337 CTI_UINT64_TYPE,
338 CTI_INT_LEAST8_TYPE,
339 CTI_INT_LEAST16_TYPE,
340 CTI_INT_LEAST32_TYPE,
341 CTI_INT_LEAST64_TYPE,
342 CTI_UINT_LEAST8_TYPE,
343 CTI_UINT_LEAST16_TYPE,
344 CTI_UINT_LEAST32_TYPE,
345 CTI_UINT_LEAST64_TYPE,
346 CTI_INT_FAST8_TYPE,
347 CTI_INT_FAST16_TYPE,
348 CTI_INT_FAST32_TYPE,
349 CTI_INT_FAST64_TYPE,
350 CTI_UINT_FAST8_TYPE,
351 CTI_UINT_FAST16_TYPE,
352 CTI_UINT_FAST32_TYPE,
353 CTI_UINT_FAST64_TYPE,
354 CTI_INTPTR_TYPE,
355 CTI_UINTPTR_TYPE,
357 CTI_CHAR_ARRAY_TYPE,
358 CTI_CHAR8_ARRAY_TYPE,
359 CTI_CHAR16_ARRAY_TYPE,
360 CTI_CHAR32_ARRAY_TYPE,
361 CTI_WCHAR_ARRAY_TYPE,
362 CTI_STRING_TYPE,
363 CTI_CONST_STRING_TYPE,
365 /* Type for boolean expressions (bool in C++, int in C). */
366 CTI_TRUTHVALUE_TYPE,
367 CTI_TRUTHVALUE_TRUE,
368 CTI_TRUTHVALUE_FALSE,
370 CTI_DEFAULT_FUNCTION_TYPE,
372 CTI_NULL,
374 /* These are not types, but we have to look them up all the time. */
375 CTI_FUNCTION_NAME_DECL,
376 CTI_PRETTY_FUNCTION_NAME_DECL,
377 CTI_C99_FUNCTION_NAME_DECL,
379 CTI_MODULE_HWM,
380 /* Below here entities change during compilation. */
382 CTI_SAVED_FUNCTION_NAME_DECLS,
384 CTI_MAX
387 #define C_CPP_HASHNODE(id) \
388 (&(((struct c_common_identifier *) (id))->node))
389 #define C_RID_CODE(id) \
390 ((enum rid) (((struct c_common_identifier *) (id))->node.rid_code))
391 #define C_SET_RID_CODE(id, code) \
392 (((struct c_common_identifier *) (id))->node.rid_code = (unsigned char) code)
394 /* Identifier part common to the C front ends. Inherits from
395 tree_identifier, despite appearances. */
396 struct GTY(()) c_common_identifier {
397 struct tree_common common;
398 struct cpp_hashnode node;
401 /* An entry in the reserved keyword table. */
403 struct c_common_resword
405 const char *const word;
406 ENUM_BITFIELD(rid) const rid : 16;
407 const unsigned int disable : 16;
410 /* Mode used to build pointers (VOIDmode means ptr_mode). */
412 extern machine_mode c_default_pointer_mode;
414 /* Extra cpp_ttype values for C++. */
416 /* A token type for template-ids. If a template-id is processed while
417 parsing tentatively, it is replaced with a CPP_TEMPLATE_ID token;
418 the value of the CPP_TEMPLATE_ID is whatever was returned by
419 cp_parser_template_id. */
420 #define CPP_TEMPLATE_ID ((enum cpp_ttype) (CPP_KEYWORD + 1))
422 /* A token type for nested-name-specifiers. If a
423 nested-name-specifier is processed while parsing tentatively, it is
424 replaced with a CPP_NESTED_NAME_SPECIFIER token; the value of the
425 CPP_NESTED_NAME_SPECIFIER is whatever was returned by
426 cp_parser_nested_name_specifier_opt. */
427 #define CPP_NESTED_NAME_SPECIFIER ((enum cpp_ttype) (CPP_TEMPLATE_ID + 1))
429 /* A token type for pre-parsed C++0x decltype. */
430 #define CPP_DECLTYPE ((enum cpp_ttype) (CPP_NESTED_NAME_SPECIFIER + 1))
432 /* A token type for pre-parsed primary-expression (lambda- or statement-). */
433 #define CPP_PREPARSED_EXPR ((enum cpp_ttype) (CPP_DECLTYPE + 1))
435 /* The number of token types, including C++-specific ones. */
436 #define N_CP_TTYPES ((int) (CPP_PREPARSED_EXPR + 1))
438 /* Disable mask. Keywords are disabled if (reswords[i].disable &
439 mask) is _true_. Thus for keywords which are present in all
440 languages the disable field is zero. */
442 #define D_CONLY 0x0001 /* C only (not in C++). */
443 #define D_CXXONLY 0x0002 /* C++ only (not in C). */
444 #define D_C99 0x0004 /* In C, C99 only. */
445 #define D_CXX11 0x0008 /* In C++, C++11 only. */
446 #define D_EXT 0x0010 /* GCC extension. */
447 #define D_EXT89 0x0020 /* GCC extension incorporated in C99. */
448 #define D_ASM 0x0040 /* Disabled by -fno-asm. */
449 #define D_OBJC 0x0080 /* In Objective C and neither C nor C++. */
450 #define D_CXX_OBJC 0x0100 /* In Objective C, and C++, but not C. */
451 #define D_CXXWARN 0x0200 /* In C warn with -Wcxx-compat. */
452 #define D_CXX_CONCEPTS 0x0400 /* In C++, only with concepts. */
453 #define D_TRANSMEM 0X0800 /* C++ transactional memory TS. */
454 #define D_CXX_CHAR8_T 0X1000 /* In C++, only with -fchar8_t. */
455 #define D_CXX20 0x2000 /* In C++, C++20 only. */
456 #define D_CXX_COROUTINES 0x4000 /* In C++, only with coroutines. */
457 #define D_CXX_MODULES 0x8000 /* In C++, only with modules. */
459 #define D_CXX_CONCEPTS_FLAGS D_CXXONLY | D_CXX_CONCEPTS
460 #define D_CXX_CHAR8_T_FLAGS D_CXXONLY | D_CXX_CHAR8_T
461 #define D_CXX_MODULES_FLAGS (D_CXXONLY | D_CXX_MODULES)
462 #define D_CXX_COROUTINES_FLAGS (D_CXXONLY | D_CXX_COROUTINES)
464 /* The reserved keyword table. */
465 extern const struct c_common_resword c_common_reswords[];
467 /* The number of items in the reserved keyword table. */
468 extern const unsigned int num_c_common_reswords;
470 #define char8_type_node c_global_trees[CTI_CHAR8_TYPE]
471 #define char16_type_node c_global_trees[CTI_CHAR16_TYPE]
472 #define char32_type_node c_global_trees[CTI_CHAR32_TYPE]
473 #define wchar_type_node c_global_trees[CTI_WCHAR_TYPE]
474 #define underlying_wchar_type_node c_global_trees[CTI_UNDERLYING_WCHAR_TYPE]
475 #define wint_type_node c_global_trees[CTI_WINT_TYPE]
476 #define signed_size_type_node c_global_trees[CTI_SIGNED_SIZE_TYPE]
477 #define unsigned_ptrdiff_type_node c_global_trees[CTI_UNSIGNED_PTRDIFF_TYPE]
478 #define intmax_type_node c_global_trees[CTI_INTMAX_TYPE]
479 #define uintmax_type_node c_global_trees[CTI_UINTMAX_TYPE]
480 #define widest_integer_literal_type_node c_global_trees[CTI_WIDEST_INT_LIT_TYPE]
481 #define widest_unsigned_literal_type_node c_global_trees[CTI_WIDEST_UINT_LIT_TYPE]
483 #define sig_atomic_type_node c_global_trees[CTI_SIG_ATOMIC_TYPE]
484 #define int8_type_node c_global_trees[CTI_INT8_TYPE]
485 #define int16_type_node c_global_trees[CTI_INT16_TYPE]
486 #define int32_type_node c_global_trees[CTI_INT32_TYPE]
487 #define int64_type_node c_global_trees[CTI_INT64_TYPE]
488 #define uint8_type_node c_global_trees[CTI_UINT8_TYPE]
489 #define c_uint16_type_node c_global_trees[CTI_UINT16_TYPE]
490 #define c_uint32_type_node c_global_trees[CTI_UINT32_TYPE]
491 #define c_uint64_type_node c_global_trees[CTI_UINT64_TYPE]
492 #define int_least8_type_node c_global_trees[CTI_INT_LEAST8_TYPE]
493 #define int_least16_type_node c_global_trees[CTI_INT_LEAST16_TYPE]
494 #define int_least32_type_node c_global_trees[CTI_INT_LEAST32_TYPE]
495 #define int_least64_type_node c_global_trees[CTI_INT_LEAST64_TYPE]
496 #define uint_least8_type_node c_global_trees[CTI_UINT_LEAST8_TYPE]
497 #define uint_least16_type_node c_global_trees[CTI_UINT_LEAST16_TYPE]
498 #define uint_least32_type_node c_global_trees[CTI_UINT_LEAST32_TYPE]
499 #define uint_least64_type_node c_global_trees[CTI_UINT_LEAST64_TYPE]
500 #define int_fast8_type_node c_global_trees[CTI_INT_FAST8_TYPE]
501 #define int_fast16_type_node c_global_trees[CTI_INT_FAST16_TYPE]
502 #define int_fast32_type_node c_global_trees[CTI_INT_FAST32_TYPE]
503 #define int_fast64_type_node c_global_trees[CTI_INT_FAST64_TYPE]
504 #define uint_fast8_type_node c_global_trees[CTI_UINT_FAST8_TYPE]
505 #define uint_fast16_type_node c_global_trees[CTI_UINT_FAST16_TYPE]
506 #define uint_fast32_type_node c_global_trees[CTI_UINT_FAST32_TYPE]
507 #define uint_fast64_type_node c_global_trees[CTI_UINT_FAST64_TYPE]
508 #define intptr_type_node c_global_trees[CTI_INTPTR_TYPE]
509 #define uintptr_type_node c_global_trees[CTI_UINTPTR_TYPE]
511 #define truthvalue_type_node c_global_trees[CTI_TRUTHVALUE_TYPE]
512 #define truthvalue_true_node c_global_trees[CTI_TRUTHVALUE_TRUE]
513 #define truthvalue_false_node c_global_trees[CTI_TRUTHVALUE_FALSE]
515 #define char_array_type_node c_global_trees[CTI_CHAR_ARRAY_TYPE]
516 #define char8_array_type_node c_global_trees[CTI_CHAR8_ARRAY_TYPE]
517 #define char16_array_type_node c_global_trees[CTI_CHAR16_ARRAY_TYPE]
518 #define char32_array_type_node c_global_trees[CTI_CHAR32_ARRAY_TYPE]
519 #define wchar_array_type_node c_global_trees[CTI_WCHAR_ARRAY_TYPE]
520 #define string_type_node c_global_trees[CTI_STRING_TYPE]
521 #define const_string_type_node c_global_trees[CTI_CONST_STRING_TYPE]
523 #define default_function_type c_global_trees[CTI_DEFAULT_FUNCTION_TYPE]
525 #define function_name_decl_node c_global_trees[CTI_FUNCTION_NAME_DECL]
526 #define pretty_function_name_decl_node c_global_trees[CTI_PRETTY_FUNCTION_NAME_DECL]
527 #define c99_function_name_decl_node c_global_trees[CTI_C99_FUNCTION_NAME_DECL]
528 #define saved_function_name_decls c_global_trees[CTI_SAVED_FUNCTION_NAME_DECLS]
530 /* The node for C++ `__null'. */
531 #define null_node c_global_trees[CTI_NULL]
533 extern GTY(()) tree c_global_trees[CTI_MAX];
535 /* Mark which labels are explicitly declared.
536 These may be shadowed, and may be referenced from nested functions. */
537 #define C_DECLARED_LABEL_FLAG(label) TREE_LANG_FLAG_1 (label)
539 enum c_language_kind
541 clk_c = 0, /* C90, C94, C99, C11 or C2X */
542 clk_objc = 1, /* clk_c with ObjC features. */
543 clk_cxx = 2, /* ANSI/ISO C++ */
544 clk_objcxx = 3 /* clk_cxx with ObjC features. */
547 /* To test for a specific language use c_language, defined by each
548 front end. For "ObjC features" or "not C++" use the macros. */
549 extern c_language_kind c_language;
551 #define c_dialect_cxx() ((c_language & clk_cxx) != 0)
552 #define c_dialect_objc() ((c_language & clk_objc) != 0)
554 /* The various name of operator that appears in error messages. */
555 enum ref_operator {
556 /* NULL */
557 RO_NULL,
558 /* array indexing */
559 RO_ARRAY_INDEXING,
560 /* unary * */
561 RO_UNARY_STAR,
562 /* -> */
563 RO_ARROW,
564 /* implicit conversion */
565 RO_IMPLICIT_CONVERSION,
566 /* ->* */
567 RO_ARROW_STAR
570 /* Information about a statement tree. */
572 struct GTY(()) stmt_tree_s {
573 /* A stack of statement lists being collected. */
574 vec<tree, va_gc> *x_cur_stmt_list;
576 /* In C++, Nonzero if we should treat statements as full
577 expressions. In particular, this variable is non-zero if at the
578 end of a statement we should destroy any temporaries created
579 during that statement. Similarly, if, at the end of a block, we
580 should destroy any local variables in this block. Normally, this
581 variable is nonzero, since those are the normal semantics of
582 C++.
584 This flag has no effect in C. */
585 int stmts_are_full_exprs_p;
588 typedef struct stmt_tree_s *stmt_tree;
590 /* Global state pertinent to the current function. Some C dialects
591 extend this structure with additional fields. */
593 struct GTY(()) c_language_function {
594 /* While we are parsing the function, this contains information
595 about the statement-tree that we are building. */
596 struct stmt_tree_s x_stmt_tree;
598 /* Vector of locally defined typedefs, for
599 -Wunused-local-typedefs. */
600 vec<tree, va_gc> *local_typedefs;
603 #define stmt_list_stack (current_stmt_tree ()->x_cur_stmt_list)
605 /* When building a statement-tree, this is the current statement list
606 being collected. */
607 #define cur_stmt_list (stmt_list_stack->last ())
609 #define building_stmt_list_p() (stmt_list_stack && !stmt_list_stack->is_empty())
611 /* Language-specific hooks. */
613 /* If non-NULL, this function is called after a precompile header file
614 is loaded. */
615 extern void (*lang_post_pch_load) (void);
617 extern void push_file_scope (void);
618 extern void pop_file_scope (void);
619 extern stmt_tree current_stmt_tree (void);
620 extern tree push_stmt_list (void);
621 extern tree pop_stmt_list (tree);
622 extern tree add_stmt (tree);
623 extern void push_cleanup (tree, tree, bool);
625 extern tree build_modify_expr (location_t, tree, tree, enum tree_code,
626 location_t, tree, tree);
627 extern tree build_indirect_ref (location_t, tree, ref_operator);
629 extern bool has_c_linkage (const_tree decl);
630 extern bool c_decl_implicit (const_tree);
632 /* Switches common to the C front ends. */
634 /* Nonzero means don't output line number information. */
636 extern char flag_no_line_commands;
638 /* Nonzero causes -E output not to be done, but directives such as
639 #define that have side effects are still obeyed. */
641 extern char flag_no_output;
643 /* Nonzero means dump macros in some fashion; contains the 'D', 'M',
644 'N' or 'U' of the command line switch. */
646 extern char flag_dump_macros;
648 /* Nonzero means pass #include lines through to the output. */
650 extern char flag_dump_includes;
652 /* Nonzero means process PCH files while preprocessing. */
654 extern bool flag_pch_preprocess;
656 /* The file name to which we should write a precompiled header, or
657 NULL if no header will be written in this compile. */
659 extern const char *pch_file;
661 /* Nonzero if an ISO standard was selected. It rejects macros in the
662 user's namespace. */
664 extern int flag_iso;
666 /* C/ObjC language option variables. */
669 /* Nonzero means allow type mismatches in conditional expressions;
670 just make their values `void'. */
672 extern int flag_cond_mismatch;
674 /* Nonzero means enable C89 Amendment 1 features. */
676 extern int flag_isoc94;
678 /* Nonzero means use the ISO C99 (or later) dialect of C. */
680 extern int flag_isoc99;
682 /* Nonzero means use the ISO C11 (or later) dialect of C. */
684 extern int flag_isoc11;
686 /* Nonzero means use the ISO C2X dialect of C. */
688 extern int flag_isoc2x;
690 /* Nonzero means that we have builtin functions, and main is an int. */
692 extern int flag_hosted;
694 /* ObjC language option variables. */
697 /* Tells the compiler that this is a special run. Do not perform any
698 compiling, instead we are to test some platform dependent features
699 and output a C header file with appropriate definitions. */
701 extern int print_struct_values;
703 /* Tells the compiler what is the constant string class for ObjC. */
705 extern const char *constant_string_class_name;
708 /* C++ language option variables. */
710 /* The reference version of the ABI for -Wabi. */
712 extern int warn_abi_version;
714 /* Return TRUE if one of {flag_abi_version,flag_abi_compat_version} is
715 less than N and the other is at least N. */
716 #define abi_compat_version_crosses(N) \
717 (abi_version_at_least(N) \
718 != (flag_abi_compat_version == 0 \
719 || flag_abi_compat_version >= (N)))
721 /* Return TRUE if one of {flag_abi_version,warn_abi_version} is
722 less than N and the other is at least N, for use by -Wabi. */
723 #define abi_version_crosses(N) \
724 (abi_version_at_least(N) \
725 != (warn_abi_version == 0 \
726 || warn_abi_version >= (N)))
728 /* The supported C++ dialects. */
730 enum cxx_dialect {
731 cxx_unset,
732 /* C++98 with TC1 */
733 cxx98,
734 cxx03 = cxx98,
735 /* C++11 */
736 cxx0x,
737 cxx11 = cxx0x,
738 /* C++14 */
739 cxx14,
740 /* C++17 */
741 cxx17,
742 /* C++20 */
743 cxx20,
744 /* C++23 */
745 cxx23
748 /* The C++ dialect being used. C++98 is the default. */
749 extern enum cxx_dialect cxx_dialect;
751 /* Maximum template instantiation depth. This limit is rather
752 arbitrary, but it exists to limit the time it takes to notice
753 excessively recursive template instantiations. */
755 extern int max_tinst_depth;
757 /* Nonzero means that we should not issue warnings about problems that
758 occur when the code is executed, because the code being processed
759 is not expected to be executed. This is set during parsing. This
760 is used for cases like sizeof() and "0 ? a : b". This is a count,
761 not a bool, because unexecuted expressions can nest. */
763 extern int c_inhibit_evaluation_warnings;
765 /* Whether lexing has been completed, so subsequent preprocessor
766 errors should use the compiler's input_location. */
768 extern bool done_lexing;
770 /* C types are partitioned into three subsets: object, function, and
771 incomplete types. */
772 #define C_TYPE_OBJECT_P(type) \
773 (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
775 #define C_TYPE_INCOMPLETE_P(type) \
776 (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
778 #define C_TYPE_FUNCTION_P(type) \
779 (TREE_CODE (type) == FUNCTION_TYPE)
781 /* For convenience we define a single macro to identify the class of
782 object or incomplete types. */
783 #define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
784 (!C_TYPE_FUNCTION_P (type))
786 /* Return true if TYPE is a vector type that should be subject to the GNU
787 vector extensions (as opposed to a vector type that is used only for
788 the purposes of defining target-specific built-in functions). */
790 inline bool
791 gnu_vector_type_p (const_tree type)
793 return TREE_CODE (type) == VECTOR_TYPE && !TYPE_INDIVISIBLE_P (type);
796 struct visibility_flags
798 unsigned inpragma : 1; /* True when in #pragma GCC visibility. */
799 unsigned inlines_hidden : 1; /* True when -finlineshidden in effect. */
802 /* These enumerators are possible types of unsafe conversions. */
803 enum conversion_safety {
804 /* The conversion is safe. */
805 SAFE_CONVERSION = 0,
806 /* Another type of conversion with problems. */
807 UNSAFE_OTHER,
808 /* Conversion between signed and unsigned integers. */
809 UNSAFE_SIGN,
810 /* Conversions that reduce the precision of reals including conversions
811 from reals to integers. */
812 UNSAFE_REAL,
813 /* Conversions from complex to reals or integers, that discard imaginary
814 component. */
815 UNSAFE_IMAGINARY
818 /* Global visibility options. */
819 extern struct visibility_flags visibility_options;
821 /* Attribute table common to the C front ends. */
822 extern const struct attribute_spec c_common_attribute_table[];
823 extern const struct attribute_spec c_common_format_attribute_table[];
825 /* Pointer to function to lazily generate the VAR_DECL for __FUNCTION__ etc.
826 ID is the identifier to use, NAME is the string.
827 TYPE_DEP indicates whether it depends on type of the function or not
828 (i.e. __PRETTY_FUNCTION__). */
830 extern tree (*make_fname_decl) (location_t, tree, int);
832 /* In c-decl.c and cp/tree.c. FIXME. */
833 extern void c_register_addr_space (const char *str, addr_space_t as);
835 /* In c-common.c. */
836 extern bool in_late_binary_op;
837 extern const char *c_addr_space_name (addr_space_t as);
838 extern tree identifier_global_value (tree);
839 extern tree identifier_global_tag (tree);
840 extern bool names_builtin_p (const char *);
841 extern tree c_linkage_bindings (tree);
842 extern void record_builtin_type (enum rid, const char *, tree);
843 extern tree build_void_list_node (void);
844 extern void start_fname_decls (void);
845 extern void finish_fname_decls (void);
846 extern const char *fname_as_string (int);
847 extern tree fname_decl (location_t, unsigned, tree);
849 extern int check_user_alignment (const_tree, bool, bool);
850 extern bool check_function_arguments (location_t loc, const_tree, const_tree,
851 int, tree *, vec<location_t> *);
852 extern void check_function_arguments_recurse (void (*)
853 (void *, tree,
854 unsigned HOST_WIDE_INT),
855 void *, tree,
856 unsigned HOST_WIDE_INT);
857 extern bool check_builtin_function_arguments (location_t, vec<location_t>,
858 tree, tree, int, tree *);
859 extern void check_function_format (const_tree, tree, int, tree *,
860 vec<location_t> *);
861 extern bool attribute_fallthrough_p (tree);
862 extern tree handle_format_attribute (tree *, tree, tree, int, bool *);
863 extern tree handle_format_arg_attribute (tree *, tree, tree, int, bool *);
864 extern bool c_common_handle_option (size_t, const char *, HOST_WIDE_INT, int,
865 location_t,
866 const struct cl_option_handlers *);
867 extern bool default_handle_c_option (size_t, const char *, int);
868 extern tree c_common_type_for_mode (machine_mode, int);
869 extern tree c_common_type_for_size (unsigned int, int);
870 extern tree c_common_fixed_point_type_for_size (unsigned int, unsigned int,
871 int, int);
872 extern tree c_common_unsigned_type (tree);
873 extern tree c_common_signed_type (tree);
874 extern tree c_common_signed_or_unsigned_type (int, tree);
875 extern void c_common_init_ts (void);
876 extern tree c_build_bitfield_integer_type (unsigned HOST_WIDE_INT, int);
877 extern enum conversion_safety unsafe_conversion_p (tree, tree, tree, bool);
878 extern bool decl_with_nonnull_addr_p (const_tree);
879 extern tree c_fully_fold (tree, bool, bool *, bool = false);
880 extern tree c_wrap_maybe_const (tree, bool);
881 extern tree c_common_truthvalue_conversion (location_t, tree);
882 extern void c_apply_type_quals_to_decl (int, tree);
883 extern tree c_sizeof_or_alignof_type (location_t, tree, bool, bool, int);
884 extern tree c_alignof_expr (location_t, tree);
885 /* Print an error message for invalid operands to arith operation CODE.
886 NOP_EXPR is used as a special case (see truthvalue_conversion). */
887 extern void binary_op_error (rich_location *, enum tree_code, tree, tree);
888 extern tree fix_string_type (tree);
889 extern tree convert_and_check (location_t, tree, tree);
890 extern bool c_determine_visibility (tree);
891 extern bool vector_types_compatible_elements_p (tree, tree);
892 extern void mark_valid_location_for_stdc_pragma (bool);
893 extern bool valid_location_for_stdc_pragma_p (void);
894 extern void set_float_const_decimal64 (void);
895 extern void clear_float_const_decimal64 (void);
896 extern bool float_const_decimal64_p (void);
898 extern bool keyword_begins_type_specifier (enum rid);
899 extern bool keyword_is_storage_class_specifier (enum rid);
900 extern bool keyword_is_type_qualifier (enum rid);
901 extern bool keyword_is_decl_specifier (enum rid);
902 extern unsigned max_align_t_align (void);
903 extern bool cxx_fundamental_alignment_p (unsigned);
904 extern bool pointer_to_zero_sized_aggr_p (tree);
905 extern bool bool_promoted_to_int_p (tree);
906 extern tree fold_for_warn (tree);
907 extern tree c_common_get_narrower (tree, int *);
908 extern bool get_attribute_operand (tree, unsigned HOST_WIDE_INT *);
909 extern void c_common_finalize_early_debug (void);
912 #define c_sizeof(LOC, T) c_sizeof_or_alignof_type (LOC, T, true, false, 1)
913 #define c_alignof(LOC, T) c_sizeof_or_alignof_type (LOC, T, false, false, 1)
915 /* Subroutine of build_binary_op, used for certain operations. */
916 extern tree shorten_binary_op (tree result_type, tree op0, tree op1, bool bitwise);
918 /* Subroutine of build_binary_op, used for comparison operations.
919 See if the operands have both been converted from subword integer types
920 and, if so, perhaps change them both back to their original type. */
921 extern tree shorten_compare (location_t, tree *, tree *, tree *,
922 enum tree_code *);
924 extern tree pointer_int_sum (location_t, enum tree_code, tree, tree,
925 bool = true);
927 /* Add qualifiers to a type, in the fashion for C. */
928 extern tree c_build_qualified_type (tree, int, tree = NULL_TREE, size_t = 0);
930 /* Build tree nodes and builtin functions common to both C and C++ language
931 frontends. */
932 extern void c_common_nodes_and_builtins (void);
934 extern void disable_builtin_function (const char *);
936 extern void set_compound_literal_name (tree decl);
938 extern tree build_va_arg (location_t, tree, tree);
940 extern const unsigned int c_family_lang_mask;
941 extern unsigned int c_common_option_lang_mask (void);
942 extern void c_common_diagnostics_set_defaults (diagnostic_context *);
943 extern bool c_common_complain_wrong_lang_p (const struct cl_option *);
944 extern void c_common_init_options_struct (struct gcc_options *);
945 extern void c_common_init_options (unsigned int, struct cl_decoded_option *);
946 extern bool c_common_post_options (const char **);
947 extern bool c_common_init (void);
948 extern void c_common_finish (void);
949 extern void c_common_parse_file (void);
950 extern FILE *get_dump_info (int, dump_flags_t *);
951 extern alias_set_type c_common_get_alias_set (tree);
952 extern void c_register_builtin_type (tree, const char*);
953 extern bool c_promoting_integer_type_p (const_tree);
954 extern bool self_promoting_args_p (const_tree);
955 extern tree strip_pointer_operator (tree);
956 extern tree strip_pointer_or_array_types (tree);
957 extern HOST_WIDE_INT c_common_to_target_charset (HOST_WIDE_INT);
959 /* This is the basic parsing function. */
960 extern void c_parse_file (void);
962 extern void c_parse_final_cleanups (void);
964 /* These macros provide convenient access to the various _STMT nodes. */
966 /* Nonzero if a given STATEMENT_LIST represents the outermost binding
967 if a statement expression. */
968 #define STATEMENT_LIST_STMT_EXPR(NODE) \
969 TREE_LANG_FLAG_1 (STATEMENT_LIST_CHECK (NODE))
971 /* Nonzero if a label has been added to the statement list. */
972 #define STATEMENT_LIST_HAS_LABEL(NODE) \
973 TREE_LANG_FLAG_3 (STATEMENT_LIST_CHECK (NODE))
975 /* C_MAYBE_CONST_EXPR accessors. */
976 #define C_MAYBE_CONST_EXPR_PRE(NODE) \
977 TREE_OPERAND (C_MAYBE_CONST_EXPR_CHECK (NODE), 0)
978 #define C_MAYBE_CONST_EXPR_EXPR(NODE) \
979 TREE_OPERAND (C_MAYBE_CONST_EXPR_CHECK (NODE), 1)
980 #define C_MAYBE_CONST_EXPR_INT_OPERANDS(NODE) \
981 TREE_LANG_FLAG_0 (C_MAYBE_CONST_EXPR_CHECK (NODE))
982 #define C_MAYBE_CONST_EXPR_NON_CONST(NODE) \
983 TREE_LANG_FLAG_1 (C_MAYBE_CONST_EXPR_CHECK (NODE))
984 #define EXPR_INT_CONST_OPERANDS(EXPR) \
985 (INTEGRAL_TYPE_P (TREE_TYPE (EXPR)) \
986 && (TREE_CODE (EXPR) == INTEGER_CST \
987 || (TREE_CODE (EXPR) == C_MAYBE_CONST_EXPR \
988 && C_MAYBE_CONST_EXPR_INT_OPERANDS (EXPR))))
990 /* In a FIELD_DECL, nonzero if the decl was originally a bitfield. */
991 #define DECL_C_BIT_FIELD(NODE) \
992 (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) == 1)
993 #define SET_DECL_C_BIT_FIELD(NODE) \
994 (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 1)
995 #define CLEAR_DECL_C_BIT_FIELD(NODE) \
996 (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 0)
998 /* True if the decl was an unnamed bitfield. */
999 #define DECL_UNNAMED_BIT_FIELD(NODE) \
1000 (DECL_C_BIT_FIELD (NODE) && !DECL_NAME (NODE))
1002 extern tree do_case (location_t, tree, tree);
1003 extern tree build_stmt (location_t, enum tree_code, ...);
1004 extern tree build_real_imag_expr (location_t, enum tree_code, tree);
1006 /* These functions must be defined by each front-end which implements
1007 a variant of the C language. They are used in c-common.c. */
1009 extern tree build_unary_op (location_t, enum tree_code, tree, bool);
1010 extern tree build_binary_op (location_t, enum tree_code, tree, tree, bool);
1011 extern tree perform_integral_promotions (tree);
1013 /* These functions must be defined by each front-end which implements
1014 a variant of the C language. They are used by port files. */
1016 extern tree default_conversion (tree);
1018 /* Given two integer or real types, return the type for their sum.
1019 Given two compatible ANSI C types, returns the merged type. */
1021 extern tree common_type (tree, tree);
1023 extern tree decl_constant_value (tree);
1025 /* Handle increment and decrement of boolean types. */
1026 extern tree boolean_increment (enum tree_code, tree);
1028 extern int case_compare (splay_tree_key, splay_tree_key);
1030 extern tree c_add_case_label (location_t, splay_tree, tree, tree, tree);
1031 extern bool c_switch_covers_all_cases_p (splay_tree, tree);
1032 extern bool c_block_may_fallthru (const_tree);
1034 extern tree build_function_call (location_t, tree, tree);
1036 extern tree build_function_call_vec (location_t, vec<location_t>, tree,
1037 vec<tree, va_gc> *, vec<tree, va_gc> *,
1038 tree = NULL_TREE);
1040 extern tree resolve_overloaded_builtin (location_t, tree, vec<tree, va_gc> *);
1042 extern tree finish_label_address_expr (tree, location_t);
1044 /* Same function prototype, but the C and C++ front ends have
1045 different implementations. Used in c-common.c. */
1046 extern tree lookup_label (tree);
1047 extern tree lookup_name (tree);
1048 extern bool lvalue_p (const_tree);
1050 extern bool vector_targets_convertible_p (const_tree t1, const_tree t2);
1051 extern bool vector_types_convertible_p (const_tree t1, const_tree t2, bool emit_lax_note);
1052 extern tree c_build_vec_perm_expr (location_t, tree, tree, tree, bool = true);
1053 extern tree c_build_shufflevector (location_t, tree, tree,
1054 const vec<tree> &, bool = true);
1055 extern tree c_build_vec_convert (location_t, tree, location_t, tree, bool = true);
1057 extern void init_c_lex (void);
1059 extern void c_cpp_builtins (cpp_reader *);
1060 extern void c_cpp_builtins_optimize_pragma (cpp_reader *, tree, tree);
1061 extern bool c_cpp_diagnostic (cpp_reader *, enum cpp_diagnostic_level,
1062 enum cpp_warning_reason, rich_location *,
1063 const char *, va_list *)
1064 ATTRIBUTE_GCC_DIAG(5,0);
1065 extern int c_common_has_attribute (cpp_reader *, bool);
1066 extern int c_common_has_builtin (cpp_reader *);
1068 extern bool parse_optimize_options (tree, bool);
1070 /* Positive if an implicit `extern "C"' scope has just been entered;
1071 negative if such a scope has just been exited. */
1072 extern GTY(()) int pending_lang_change;
1074 /* Information recorded about each file examined during compilation. */
1076 struct c_fileinfo
1078 int time; /* Time spent in the file. */
1080 /* Flags used only by C++.
1081 INTERFACE_ONLY nonzero means that we are in an "interface" section
1082 of the compiler. INTERFACE_UNKNOWN nonzero means we cannot trust
1083 the value of INTERFACE_ONLY. If INTERFACE_UNKNOWN is zero and
1084 INTERFACE_ONLY is zero, it means that we are responsible for
1085 exporting definitions that others might need. */
1086 short interface_only;
1087 short interface_unknown;
1090 struct c_fileinfo *get_fileinfo (const char *);
1091 extern void dump_time_statistics (void);
1093 extern bool c_dump_tree (void *, tree);
1095 extern void verify_sequence_points (tree);
1097 extern tree fold_offsetof (tree, tree = size_type_node,
1098 tree_code ctx = ERROR_MARK);
1100 extern int complete_array_type (tree *, tree, bool);
1101 extern void complete_flexible_array_elts (tree);
1103 extern tree builtin_type_for_size (int, bool);
1105 extern void c_common_mark_addressable_vec (tree);
1107 extern void set_underlying_type (tree);
1108 extern bool user_facing_original_type_p (const_tree);
1109 extern void record_types_used_by_current_var_decl (tree);
1110 extern vec<tree, va_gc> *make_tree_vector (void);
1111 extern void release_tree_vector (vec<tree, va_gc> *);
1112 extern vec<tree, va_gc> *make_tree_vector_single (tree);
1113 extern vec<tree, va_gc> *make_tree_vector_from_list (tree);
1114 extern vec<tree, va_gc> *make_tree_vector_from_ctor (tree);
1115 extern vec<tree, va_gc> *make_tree_vector_copy (const vec<tree, va_gc> *);
1117 /* Used for communication between c_common_type_for_mode and
1118 c_register_builtin_type. */
1119 extern GTY(()) tree registered_builtin_types;
1121 /* Read SOURCE_DATE_EPOCH from environment to have a deterministic
1122 timestamp to replace embedded current dates to get reproducible
1123 results. Returns -1 if SOURCE_DATE_EPOCH is not defined. */
1124 extern time_t cb_get_source_date_epoch (cpp_reader *pfile);
1126 /* The value (as a unix timestamp) corresponds to date
1127 "Dec 31 9999 23:59:59 UTC", which is the latest date that __DATE__ and
1128 __TIME__ can store. */
1129 #define MAX_SOURCE_DATE_EPOCH HOST_WIDE_INT_C (253402300799)
1131 /* Callback for libcpp for offering spelling suggestions for misspelled
1132 directives. */
1133 extern const char *cb_get_suggestion (cpp_reader *, const char *,
1134 const char *const *);
1136 extern GTY(()) string_concat_db *g_string_concat_db;
1138 class substring_loc;
1139 extern const char *c_get_substring_location (const substring_loc &substr_loc,
1140 location_t *out_loc);
1142 /* In c-gimplify.c. */
1143 typedef struct bc_state
1145 tree bc_label[2];
1146 } bc_state_t;
1147 extern void save_bc_state (bc_state_t *);
1148 extern void restore_bc_state (bc_state_t *);
1149 extern tree c_genericize_control_stmt (tree *, int *, void *,
1150 walk_tree_fn, walk_tree_lh);
1151 extern void c_genericize (tree);
1152 extern int c_gimplify_expr (tree *, gimple_seq *, gimple_seq *);
1153 extern tree c_build_bind_expr (location_t, tree, tree);
1155 /* In c-lex.c. */
1156 extern enum cpp_ttype
1157 conflict_marker_get_final_tok_kind (enum cpp_ttype tok1_kind);
1159 /* In c-pch.c */
1160 extern void pch_init (void);
1161 extern void pch_cpp_save_state (void);
1162 extern int c_common_valid_pch (cpp_reader *pfile, const char *name, int fd);
1163 extern void c_common_read_pch (cpp_reader *pfile, const char *name, int fd,
1164 const char *orig);
1165 extern void c_common_write_pch (void);
1166 extern void c_common_no_more_pch (void);
1167 extern void c_common_pch_pragma (cpp_reader *pfile, const char *);
1169 /* In *-checksum.c */
1170 extern const unsigned char executable_checksum[16];
1172 /* In c-cppbuiltin.c */
1173 extern void builtin_define_std (const char *macro);
1174 extern void builtin_define_with_value (const char *, const char *, int);
1175 extern void builtin_define_with_int_value (const char *, HOST_WIDE_INT);
1176 extern void builtin_define_type_sizeof (const char *, tree);
1177 extern void c_stddef_cpp_builtins (void);
1178 extern void fe_file_change (const line_map_ordinary *);
1179 extern void c_parse_error (const char *, enum cpp_ttype, tree, unsigned char,
1180 rich_location *richloc);
1182 /* In c-ppoutput.c */
1183 extern void init_pp_output (FILE *);
1184 extern void preprocess_file (cpp_reader *);
1185 extern void pp_file_change (const line_map_ordinary *);
1186 extern void pp_dir_change (cpp_reader *, const char *);
1187 extern bool check_missing_format_attribute (tree, tree);
1189 /* In c-omp.c */
1190 typedef wide_int_bitmask omp_clause_mask;
1192 #define OMP_CLAUSE_MASK_1 omp_clause_mask (1)
1194 enum c_omp_clause_split
1196 C_OMP_CLAUSE_SPLIT_TARGET = 0,
1197 C_OMP_CLAUSE_SPLIT_TEAMS,
1198 C_OMP_CLAUSE_SPLIT_DISTRIBUTE,
1199 C_OMP_CLAUSE_SPLIT_PARALLEL,
1200 C_OMP_CLAUSE_SPLIT_FOR,
1201 C_OMP_CLAUSE_SPLIT_SIMD,
1202 C_OMP_CLAUSE_SPLIT_COUNT,
1203 C_OMP_CLAUSE_SPLIT_SECTIONS = C_OMP_CLAUSE_SPLIT_FOR,
1204 C_OMP_CLAUSE_SPLIT_TASKLOOP = C_OMP_CLAUSE_SPLIT_FOR,
1205 C_OMP_CLAUSE_SPLIT_LOOP = C_OMP_CLAUSE_SPLIT_FOR,
1206 C_OMP_CLAUSE_SPLIT_MASKED = C_OMP_CLAUSE_SPLIT_DISTRIBUTE
1209 enum c_omp_region_type
1211 C_ORT_OMP = 1 << 0,
1212 C_ORT_ACC = 1 << 1,
1213 C_ORT_DECLARE_SIMD = 1 << 2,
1214 C_ORT_TARGET = 1 << 3,
1215 C_ORT_OMP_DECLARE_SIMD = C_ORT_OMP | C_ORT_DECLARE_SIMD,
1216 C_ORT_OMP_TARGET = C_ORT_OMP | C_ORT_TARGET
1219 extern tree c_finish_omp_master (location_t, tree);
1220 extern tree c_finish_omp_masked (location_t, tree, tree);
1221 extern tree c_finish_omp_taskgroup (location_t, tree, tree);
1222 extern tree c_finish_omp_critical (location_t, tree, tree, tree);
1223 extern tree c_finish_omp_ordered (location_t, tree, tree);
1224 extern void c_finish_omp_barrier (location_t);
1225 extern tree c_finish_omp_atomic (location_t, enum tree_code, enum tree_code,
1226 tree, tree, tree, tree, tree, tree, bool,
1227 enum omp_memory_order, bool, bool = false);
1228 extern bool c_omp_depend_t_p (tree);
1229 extern void c_finish_omp_depobj (location_t, tree, enum omp_clause_depend_kind,
1230 tree);
1231 extern void c_finish_omp_flush (location_t, int);
1232 extern void c_finish_omp_taskwait (location_t);
1233 extern void c_finish_omp_taskyield (location_t);
1234 extern tree c_finish_omp_for (location_t, enum tree_code, tree, tree, tree,
1235 tree, tree, tree, tree, bool);
1236 extern bool c_omp_check_loop_iv (tree, tree, walk_tree_lh);
1237 extern bool c_omp_check_loop_iv_exprs (location_t, tree, int, tree, tree, tree,
1238 walk_tree_lh);
1239 extern tree c_finish_oacc_wait (location_t, tree, tree);
1240 extern tree c_oacc_split_loop_clauses (tree, tree *, bool);
1241 extern void c_omp_split_clauses (location_t, enum tree_code, omp_clause_mask,
1242 tree, tree *);
1243 extern tree c_omp_declare_simd_clauses_to_numbers (tree, tree);
1244 extern void c_omp_declare_simd_clauses_to_decls (tree, tree);
1245 extern bool c_omp_predefined_variable (tree);
1246 extern enum omp_clause_default_kind c_omp_predetermined_sharing (tree);
1247 extern enum omp_clause_defaultmap_kind c_omp_predetermined_mapping (tree);
1248 extern tree c_omp_check_context_selector (location_t, tree);
1249 extern void c_omp_mark_declare_variant (location_t, tree, tree);
1250 extern const char *c_omp_map_clause_name (tree, bool);
1251 extern void c_omp_adjust_map_clauses (tree, bool);
1253 enum c_omp_directive_kind {
1254 C_OMP_DIR_STANDALONE,
1255 C_OMP_DIR_CONSTRUCT,
1256 C_OMP_DIR_DECLARATIVE,
1257 C_OMP_DIR_UTILITY,
1258 C_OMP_DIR_INFORMATIONAL
1261 struct c_omp_directive {
1262 const char *first, *second, *third;
1263 unsigned int id;
1264 enum c_omp_directive_kind kind;
1265 bool simd;
1268 extern const struct c_omp_directive *c_omp_categorize_directive (const char *,
1269 const char *,
1270 const char *);
1272 /* Return next tree in the chain for chain_next walking of tree nodes. */
1273 static inline tree
1274 c_tree_chain_next (tree t)
1276 /* TREE_CHAIN of a type is TYPE_STUB_DECL, which is different
1277 kind of object, never a long chain of nodes. Prefer
1278 TYPE_NEXT_VARIANT for types. */
1279 if (CODE_CONTAINS_STRUCT (TREE_CODE (t), TS_TYPE_COMMON))
1280 return TYPE_NEXT_VARIANT (t);
1281 /* Otherwise, if there is TREE_CHAIN, return it. */
1282 if (CODE_CONTAINS_STRUCT (TREE_CODE (t), TS_COMMON))
1283 return TREE_CHAIN (t);
1284 return NULL;
1287 /* Mask used by tm_stmt_attr. */
1288 #define TM_STMT_ATTR_OUTER 2
1289 #define TM_STMT_ATTR_ATOMIC 4
1290 #define TM_STMT_ATTR_RELAXED 8
1292 /* Mask used by tm_attr_to_mask and tm_mask_to_attr. Note that these
1293 are ordered specifically such that more restrictive attributes are
1294 at lower bit positions. This fact is known by the C++ tm attribute
1295 inheritance code such that least bit extraction (mask & -mask) results
1296 in the most restrictive attribute. */
1297 #define TM_ATTR_SAFE 1
1298 #define TM_ATTR_CALLABLE 2
1299 #define TM_ATTR_PURE 4
1300 #define TM_ATTR_IRREVOCABLE 8
1301 #define TM_ATTR_MAY_CANCEL_OUTER 16
1303 /* A suffix-identifier value doublet that represents user-defined literals
1304 for C++-0x. */
1305 enum overflow_type {
1306 OT_UNDERFLOW = -1,
1307 OT_NONE,
1308 OT_OVERFLOW
1311 struct GTY(()) tree_userdef_literal {
1312 struct tree_base base;
1313 tree suffix_id;
1314 tree value;
1315 tree num_string;
1316 enum overflow_type overflow;
1319 #define USERDEF_LITERAL_SUFFIX_ID(NODE) \
1320 (((struct tree_userdef_literal *)USERDEF_LITERAL_CHECK (NODE))->suffix_id)
1322 #define USERDEF_LITERAL_VALUE(NODE) \
1323 (((struct tree_userdef_literal *)USERDEF_LITERAL_CHECK (NODE))->value)
1325 #define USERDEF_LITERAL_OVERFLOW(NODE) \
1326 (((struct tree_userdef_literal *)USERDEF_LITERAL_CHECK (NODE))->overflow)
1328 #define USERDEF_LITERAL_NUM_STRING(NODE) \
1329 (((struct tree_userdef_literal *)USERDEF_LITERAL_CHECK (NODE))->num_string)
1331 #define USERDEF_LITERAL_TYPE(NODE) \
1332 (TREE_TYPE (USERDEF_LITERAL_VALUE (NODE)))
1334 extern tree build_userdef_literal (tree suffix_id, tree value,
1335 enum overflow_type overflow,
1336 tree num_string);
1339 /* WHILE_STMT accessors. These give access to the condition of the
1340 while statement and the body of the while statement, respectively. */
1341 #define WHILE_COND(NODE) TREE_OPERAND (WHILE_STMT_CHECK (NODE), 0)
1342 #define WHILE_BODY(NODE) TREE_OPERAND (WHILE_STMT_CHECK (NODE), 1)
1344 /* DO_STMT accessors. These give access to the condition of the do
1345 statement and the body of the do statement, respectively. */
1346 #define DO_COND(NODE) TREE_OPERAND (DO_STMT_CHECK (NODE), 0)
1347 #define DO_BODY(NODE) TREE_OPERAND (DO_STMT_CHECK (NODE), 1)
1349 /* FOR_STMT accessors. These give access to the init statement,
1350 condition, update expression, and body of the for statement,
1351 respectively. */
1352 #define FOR_INIT_STMT(NODE) TREE_OPERAND (FOR_STMT_CHECK (NODE), 0)
1353 #define FOR_COND(NODE) TREE_OPERAND (FOR_STMT_CHECK (NODE), 1)
1354 #define FOR_EXPR(NODE) TREE_OPERAND (FOR_STMT_CHECK (NODE), 2)
1355 #define FOR_BODY(NODE) TREE_OPERAND (FOR_STMT_CHECK (NODE), 3)
1356 #define FOR_SCOPE(NODE) TREE_OPERAND (FOR_STMT_CHECK (NODE), 4)
1358 #define SWITCH_STMT_COND(NODE) TREE_OPERAND (SWITCH_STMT_CHECK (NODE), 0)
1359 #define SWITCH_STMT_BODY(NODE) TREE_OPERAND (SWITCH_STMT_CHECK (NODE), 1)
1360 #define SWITCH_STMT_TYPE(NODE) TREE_OPERAND (SWITCH_STMT_CHECK (NODE), 2)
1361 #define SWITCH_STMT_SCOPE(NODE) TREE_OPERAND (SWITCH_STMT_CHECK (NODE), 3)
1362 /* True if there are case labels for all possible values of switch cond, either
1363 because there is a default: case label or because the case label ranges cover
1364 all values. */
1365 #define SWITCH_STMT_ALL_CASES_P(NODE) \
1366 TREE_LANG_FLAG_0 (SWITCH_STMT_CHECK (NODE))
1367 /* True if the body of a switch stmt contains no BREAK_STMTs. */
1368 #define SWITCH_STMT_NO_BREAK_P(NODE) \
1369 TREE_LANG_FLAG_2 (SWITCH_STMT_CHECK (NODE))
1372 /* Nonzero if NODE is the target for genericization of 'break' stmts. */
1373 #define LABEL_DECL_BREAK(NODE) \
1374 DECL_LANG_FLAG_0 (LABEL_DECL_CHECK (NODE))
1376 /* Nonzero if NODE is the target for genericization of 'continue' stmts. */
1377 #define LABEL_DECL_CONTINUE(NODE) \
1378 DECL_LANG_FLAG_1 (LABEL_DECL_CHECK (NODE))
1380 extern bool convert_vector_to_array_for_subscript (location_t, tree *, tree);
1382 /* Possibe cases of scalar_to_vector conversion. */
1383 enum stv_conv {
1384 stv_error, /* Error occurred. */
1385 stv_nothing, /* Nothing happened. */
1386 stv_firstarg, /* First argument must be expanded. */
1387 stv_secondarg /* Second argument must be expanded. */
1390 extern enum stv_conv scalar_to_vector (location_t loc, enum tree_code code,
1391 tree op0, tree op1, bool);
1393 extern tree find_inv_trees (tree *, int *, void *);
1394 extern tree replace_inv_trees (tree *, int *, void *);
1396 extern bool reject_gcc_builtin (const_tree, location_t = UNKNOWN_LOCATION);
1397 extern bool valid_array_size_p (location_t, const_tree, tree, bool = true);
1398 extern void invalid_array_size_error (location_t, cst_size_error,
1399 const_tree, const_tree);
1401 /* In c-warn.c. */
1402 extern void constant_expression_warning (tree);
1403 extern void constant_expression_error (tree);
1404 extern void overflow_warning (location_t, tree, tree = NULL_TREE);
1405 extern void warn_logical_operator (location_t, enum tree_code, tree,
1406 enum tree_code, tree, enum tree_code, tree);
1407 extern void warn_tautological_cmp (const op_location_t &, enum tree_code,
1408 tree, tree);
1409 extern void warn_logical_not_parentheses (location_t, enum tree_code, tree,
1410 tree);
1411 extern bool warn_if_unused_value (const_tree, location_t, bool = false);
1412 extern bool strict_aliasing_warning (location_t, tree, tree);
1413 extern void sizeof_pointer_memaccess_warning (location_t *, tree,
1414 vec<tree, va_gc> *, tree *,
1415 bool (*) (tree, tree));
1416 extern void check_main_parameter_types (tree decl);
1417 extern void warnings_for_convert_and_check (location_t, tree, tree, tree);
1418 extern void c_do_switch_warnings (splay_tree, location_t, tree, tree, bool);
1419 extern void warn_for_omitted_condop (location_t, tree);
1420 extern bool warn_for_restrict (unsigned, tree *, unsigned);
1421 extern void warn_for_address_or_pointer_of_packed_member (tree, tree);
1422 extern void warn_parm_array_mismatch (location_t, tree, tree);
1423 extern void maybe_warn_sizeof_array_div (location_t, tree, tree, tree, tree);
1424 extern void do_warn_array_compare (location_t, tree_code, tree, tree);
1426 /* Places where an lvalue, or modifiable lvalue, may be required.
1427 Used to select diagnostic messages in lvalue_error and
1428 readonly_error. */
1429 enum lvalue_use {
1430 lv_assign,
1431 lv_increment,
1432 lv_decrement,
1433 lv_addressof,
1434 lv_asm
1437 extern void lvalue_error (location_t, enum lvalue_use);
1438 extern void invalid_indirection_error (location_t, tree, ref_operator);
1439 extern void readonly_error (location_t, tree, enum lvalue_use);
1440 extern void warn_array_subscript_with_type_char (location_t, tree);
1441 extern void warn_about_parentheses (location_t,
1442 enum tree_code,
1443 enum tree_code, tree,
1444 enum tree_code, tree);
1445 extern void warn_for_unused_label (tree label);
1446 extern void warn_for_div_by_zero (location_t, tree divisor);
1447 extern void warn_for_memset (location_t, tree, tree, int);
1448 extern void warn_for_sign_compare (location_t,
1449 tree orig_op0, tree orig_op1,
1450 tree op0, tree op1,
1451 tree result_type,
1452 enum tree_code resultcode);
1453 extern void do_warn_double_promotion (tree, tree, tree, const char *,
1454 location_t);
1455 extern void do_warn_unused_parameter (tree);
1456 extern void record_locally_defined_typedef (tree);
1457 extern void maybe_record_typedef_use (tree);
1458 extern void maybe_warn_unused_local_typedefs (void);
1459 extern void maybe_warn_bool_compare (location_t, enum tree_code, tree, tree);
1460 extern bool maybe_warn_shift_overflow (location_t, tree, tree);
1461 extern void warn_duplicated_cond_add_or_warn (location_t, tree, vec<tree> **);
1462 extern bool diagnose_mismatched_attributes (tree, tree);
1463 extern tree do_warn_duplicated_branches_r (tree *, int *, void *);
1464 extern void warn_for_multistatement_macros (location_t, location_t,
1465 location_t, enum rid);
1467 /* In c-attribs.c. */
1468 extern bool attribute_takes_identifier_p (const_tree);
1469 extern tree handle_deprecated_attribute (tree *, tree, tree, int, bool *);
1470 extern tree handle_unused_attribute (tree *, tree, tree, int, bool *);
1471 extern tree handle_fallthrough_attribute (tree *, tree, tree, int, bool *);
1472 extern int parse_tm_stmt_attr (tree, int);
1473 extern int tm_attr_to_mask (tree);
1474 extern tree tm_mask_to_attr (int);
1475 extern tree find_tm_attribute (tree);
1476 extern const struct attribute_spec::exclusions attr_cold_hot_exclusions[];
1477 extern const struct attribute_spec::exclusions attr_noreturn_exclusions[];
1478 extern tree handle_noreturn_attribute (tree *, tree, tree, int, bool *);
1479 extern bool has_attribute (location_t, tree, tree, tree (*)(tree));
1480 extern tree build_attr_access_from_parms (tree, bool);
1482 /* In c-format.c. */
1483 extern bool valid_format_string_type_p (tree);
1485 /* A bitmap of flags to positional_argument. */
1486 enum posargflags {
1487 /* Consider positional attribute argument value zero valid. */
1488 POSARG_ZERO = 1,
1489 /* Consider positional attribute argument value valid if it refers
1490 to the ellipsis (i.e., beyond the last typed argument). */
1491 POSARG_ELLIPSIS = 2
1494 extern tree positional_argument (const_tree, const_tree, tree, tree_code,
1495 int = 0, int = posargflags ());
1497 extern enum flt_eval_method
1498 excess_precision_mode_join (enum flt_eval_method, enum flt_eval_method);
1500 extern int c_flt_eval_method (bool ts18661_p);
1501 extern void add_no_sanitize_value (tree node, unsigned int flags);
1503 extern void maybe_add_include_fixit (rich_location *, const char *, bool);
1504 extern void maybe_suggest_missing_token_insertion (rich_location *richloc,
1505 enum cpp_ttype token_type,
1506 location_t prev_token_loc);
1507 extern tree braced_lists_to_strings (tree, tree);
1509 #if CHECKING_P
1510 namespace selftest {
1511 /* Declarations for specific families of tests within c-family,
1512 by source file, in alphabetical order. */
1513 extern void c_format_c_tests (void);
1514 extern void c_indentation_c_tests (void);
1515 extern void c_pretty_print_c_tests (void);
1516 extern void c_spellcheck_cc_tests (void);
1518 /* The entrypoint for running all of the above tests. */
1519 extern void c_family_tests (void);
1520 } // namespace selftest
1521 #endif /* #if CHECKING_P */
1523 #endif /* ! GCC_C_COMMON_H */