2009-08-05 Paul Thomas <pault@gcc.gnu.org>
[official-gcc.git] / gcc / c-common.h
blobd372e70631e6d74756252e95ecd77d9b88956ca1
1 /* Definitions for c-common.c.
2 Copyright (C) 1987, 1993, 1994, 1995, 1997, 1998,
3 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2007, 2008, 2009
4 Free Software Foundation, Inc.
6 This file is part of GCC.
8 GCC is free software; you can redistribute it and/or modify it under
9 the terms of the GNU General Public License as published by the Free
10 Software Foundation; either version 3, or (at your option) any later
11 version.
13 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
14 WARRANTY; without even the implied warranty of MERCHANTABILITY or
15 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
16 for more details.
18 You should have received a copy of the GNU General Public License
19 along with GCC; see the file COPYING3. If not see
20 <http://www.gnu.org/licenses/>. */
22 #ifndef GCC_C_COMMON_H
23 #define GCC_C_COMMON_H
25 #include "splay-tree.h"
26 #include "cpplib.h"
27 #include "ggc.h"
29 /* Usage of TREE_LANG_FLAG_?:
30 0: TREE_NEGATED_INT (in INTEGER_CST).
31 IDENTIFIER_MARKED (used by search routines).
32 DECL_PRETTY_FUNCTION_P (in VAR_DECL)
33 C_MAYBE_CONST_EXPR_INT_OPERANDS (in C_MAYBE_CONST_EXPR, for C)
34 1: C_DECLARED_LABEL_FLAG (in LABEL_DECL)
35 STATEMENT_LIST_STMT_EXPR (in STATEMENT_LIST)
36 C_MAYBE_CONST_EXPR_NON_CONST (in C_MAYBE_CONST_EXPR, for C)
37 2: unused
38 3: STATEMENT_LIST_HAS_LABEL (in STATEMENT_LIST)
39 4: unused
42 /* Reserved identifiers. This is the union of all the keywords for C,
43 C++, and Objective-C. All the type modifiers have to be in one
44 block at the beginning, because they are used as mask bits. There
45 are 27 type modifiers; if we add many more we will have to redesign
46 the mask mechanism. */
48 enum rid
50 /* Modifiers: */
51 /* C, in empirical order of frequency. */
52 RID_STATIC = 0,
53 RID_UNSIGNED, RID_LONG, RID_CONST, RID_EXTERN,
54 RID_REGISTER, RID_TYPEDEF, RID_SHORT, RID_INLINE,
55 RID_VOLATILE, RID_SIGNED, RID_AUTO, RID_RESTRICT,
57 /* C extensions */
58 RID_COMPLEX, RID_THREAD, RID_SAT,
60 /* C++ */
61 RID_FRIEND, RID_VIRTUAL, RID_EXPLICIT, RID_EXPORT, RID_MUTABLE,
63 /* ObjC */
64 RID_IN, RID_OUT, RID_INOUT, RID_BYCOPY, RID_BYREF, RID_ONEWAY,
66 /* C (reserved and imaginary types not implemented, so any use is a
67 syntax error) */
68 RID_IMAGINARY,
70 /* C */
71 RID_INT, RID_CHAR, RID_FLOAT, RID_DOUBLE, RID_VOID,
72 RID_ENUM, RID_STRUCT, RID_UNION, RID_IF, RID_ELSE,
73 RID_WHILE, RID_DO, RID_FOR, RID_SWITCH, RID_CASE,
74 RID_DEFAULT, RID_BREAK, RID_CONTINUE, RID_RETURN, RID_GOTO,
75 RID_SIZEOF,
77 /* C extensions */
78 RID_ASM, RID_TYPEOF, RID_ALIGNOF, RID_ATTRIBUTE, RID_VA_ARG,
79 RID_EXTENSION, RID_IMAGPART, RID_REALPART, RID_LABEL, RID_CHOOSE_EXPR,
80 RID_TYPES_COMPATIBLE_P,
81 RID_DFLOAT32, RID_DFLOAT64, RID_DFLOAT128,
82 RID_FRACT, RID_ACCUM,
84 /* This means to warn that this is a C++ keyword, and then treat it
85 as a normal identifier. */
86 RID_CXX_COMPAT_WARN,
88 /* Too many ways of getting the name of a function as a string */
89 RID_FUNCTION_NAME, RID_PRETTY_FUNCTION_NAME, RID_C99_FUNCTION_NAME,
91 /* C++ */
92 RID_BOOL, RID_WCHAR, RID_CLASS,
93 RID_PUBLIC, RID_PRIVATE, RID_PROTECTED,
94 RID_TEMPLATE, RID_NULL, RID_CATCH,
95 RID_DELETE, RID_FALSE, RID_NAMESPACE,
96 RID_NEW, RID_OFFSETOF, RID_OPERATOR,
97 RID_THIS, RID_THROW, RID_TRUE,
98 RID_TRY, RID_TYPENAME, RID_TYPEID,
99 RID_USING, RID_CHAR16, RID_CHAR32,
101 /* casts */
102 RID_CONSTCAST, RID_DYNCAST, RID_REINTCAST, RID_STATCAST,
104 /* C++ extensions */
105 RID_HAS_NOTHROW_ASSIGN, RID_HAS_NOTHROW_CONSTRUCTOR,
106 RID_HAS_NOTHROW_COPY, RID_HAS_TRIVIAL_ASSIGN,
107 RID_HAS_TRIVIAL_CONSTRUCTOR, RID_HAS_TRIVIAL_COPY,
108 RID_HAS_TRIVIAL_DESTRUCTOR, RID_HAS_VIRTUAL_DESTRUCTOR,
109 RID_IS_ABSTRACT, RID_IS_BASE_OF,
110 RID_IS_CONVERTIBLE_TO, RID_IS_CLASS,
111 RID_IS_EMPTY, RID_IS_ENUM,
112 RID_IS_POD, RID_IS_POLYMORPHIC,
113 RID_IS_STD_LAYOUT, RID_IS_TRIVIAL,
114 RID_IS_UNION,
116 /* C++0x */
117 RID_STATIC_ASSERT, RID_DECLTYPE,
119 /* Objective-C */
120 RID_AT_ENCODE, RID_AT_END,
121 RID_AT_CLASS, RID_AT_ALIAS, RID_AT_DEFS,
122 RID_AT_PRIVATE, RID_AT_PROTECTED, RID_AT_PUBLIC,
123 RID_AT_PROTOCOL, RID_AT_SELECTOR,
124 RID_AT_THROW, RID_AT_TRY, RID_AT_CATCH,
125 RID_AT_FINALLY, RID_AT_SYNCHRONIZED,
126 RID_AT_INTERFACE,
127 RID_AT_IMPLEMENTATION,
129 RID_MAX,
131 RID_FIRST_MODIFIER = RID_STATIC,
132 RID_LAST_MODIFIER = RID_ONEWAY,
134 RID_FIRST_CXX0X = RID_STATIC_ASSERT,
135 RID_LAST_CXX0X = RID_DECLTYPE,
136 RID_FIRST_AT = RID_AT_ENCODE,
137 RID_LAST_AT = RID_AT_IMPLEMENTATION,
138 RID_FIRST_PQ = RID_IN,
139 RID_LAST_PQ = RID_ONEWAY
142 #define OBJC_IS_AT_KEYWORD(rid) \
143 ((unsigned int) (rid) >= (unsigned int) RID_FIRST_AT && \
144 (unsigned int) (rid) <= (unsigned int) RID_LAST_AT)
146 #define OBJC_IS_PQ_KEYWORD(rid) \
147 ((unsigned int) (rid) >= (unsigned int) RID_FIRST_PQ && \
148 (unsigned int) (rid) <= (unsigned int) RID_LAST_PQ)
150 /* The elements of `ridpointers' are identifier nodes for the reserved
151 type names and storage classes. It is indexed by a RID_... value. */
152 extern GTY ((length ("(int) RID_MAX"))) tree *ridpointers;
154 /* Standard named or nameless data types of the C compiler. */
156 enum c_tree_index
158 CTI_CHAR16_TYPE,
159 CTI_CHAR32_TYPE,
160 CTI_WCHAR_TYPE,
161 CTI_UNDERLYING_WCHAR_TYPE,
162 CTI_WINT_TYPE,
163 CTI_SIGNED_SIZE_TYPE, /* For format checking only. */
164 CTI_UNSIGNED_PTRDIFF_TYPE, /* For format checking only. */
165 CTI_INTMAX_TYPE,
166 CTI_UINTMAX_TYPE,
167 CTI_WIDEST_INT_LIT_TYPE,
168 CTI_WIDEST_UINT_LIT_TYPE,
170 /* Types for <stdint.h>, that may not be defined on all
171 targets. */
172 CTI_SIG_ATOMIC_TYPE,
173 CTI_INT8_TYPE,
174 CTI_INT16_TYPE,
175 CTI_INT32_TYPE,
176 CTI_INT64_TYPE,
177 CTI_UINT8_TYPE,
178 CTI_UINT16_TYPE,
179 CTI_UINT32_TYPE,
180 CTI_UINT64_TYPE,
181 CTI_INT_LEAST8_TYPE,
182 CTI_INT_LEAST16_TYPE,
183 CTI_INT_LEAST32_TYPE,
184 CTI_INT_LEAST64_TYPE,
185 CTI_UINT_LEAST8_TYPE,
186 CTI_UINT_LEAST16_TYPE,
187 CTI_UINT_LEAST32_TYPE,
188 CTI_UINT_LEAST64_TYPE,
189 CTI_INT_FAST8_TYPE,
190 CTI_INT_FAST16_TYPE,
191 CTI_INT_FAST32_TYPE,
192 CTI_INT_FAST64_TYPE,
193 CTI_UINT_FAST8_TYPE,
194 CTI_UINT_FAST16_TYPE,
195 CTI_UINT_FAST32_TYPE,
196 CTI_UINT_FAST64_TYPE,
197 CTI_INTPTR_TYPE,
198 CTI_UINTPTR_TYPE,
200 CTI_CHAR_ARRAY_TYPE,
201 CTI_CHAR16_ARRAY_TYPE,
202 CTI_CHAR32_ARRAY_TYPE,
203 CTI_WCHAR_ARRAY_TYPE,
204 CTI_INT_ARRAY_TYPE,
205 CTI_STRING_TYPE,
206 CTI_CONST_STRING_TYPE,
208 /* Type for boolean expressions (bool in C++, int in C). */
209 CTI_TRUTHVALUE_TYPE,
210 CTI_TRUTHVALUE_TRUE,
211 CTI_TRUTHVALUE_FALSE,
213 CTI_DEFAULT_FUNCTION_TYPE,
215 /* These are not types, but we have to look them up all the time. */
216 CTI_FUNCTION_NAME_DECL,
217 CTI_PRETTY_FUNCTION_NAME_DECL,
218 CTI_C99_FUNCTION_NAME_DECL,
219 CTI_SAVED_FUNCTION_NAME_DECLS,
221 CTI_VOID_ZERO,
223 CTI_NULL,
225 CTI_MAX
228 #define C_CPP_HASHNODE(id) \
229 (&(((struct c_common_identifier *) (id))->node))
230 #define C_RID_CODE(id) \
231 ((enum rid) (((struct c_common_identifier *) (id))->node.rid_code))
232 #define C_SET_RID_CODE(id, code) \
233 (((struct c_common_identifier *) (id))->node.rid_code = (unsigned char) code)
235 /* Identifier part common to the C front ends. Inherits from
236 tree_identifier, despite appearances. */
237 struct GTY(()) c_common_identifier {
238 struct tree_common common;
239 struct cpp_hashnode node;
242 /* An entry in the reserved keyword table. */
244 struct c_common_resword
246 const char *const word;
247 ENUM_BITFIELD(rid) const rid : 16;
248 const unsigned int disable : 16;
251 /* Disable mask. Keywords are disabled if (reswords[i].disable &
252 mask) is _true_. Thus for keywords which are present in all
253 languages the disable field is zero. */
255 #define D_CONLY 0x001 /* C only (not in C++). */
256 #define D_CXXONLY 0x002 /* C++ only (not in C). */
257 #define D_C99 0x004 /* In C, C99 only. */
258 #define D_CXX0X 0x008 /* In C++, C++0X only. */
259 #define D_EXT 0x010 /* GCC extension. */
260 #define D_EXT89 0x020 /* GCC extension incorporated in C99. */
261 #define D_ASM 0x040 /* Disabled by -fno-asm. */
262 #define D_OBJC 0x080 /* In Objective C and neither C nor C++. */
263 #define D_CXX_OBJC 0x100 /* In Objective C, and C++, but not C. */
264 #define D_CXXWARN 0x200 /* In C warn with -Wcxx-compat. */
266 /* The reserved keyword table. */
267 extern const struct c_common_resword c_common_reswords[];
269 /* The number of items in the reserved keyword table. */
270 extern const unsigned int num_c_common_reswords;
272 #define char16_type_node c_global_trees[CTI_CHAR16_TYPE]
273 #define char32_type_node c_global_trees[CTI_CHAR32_TYPE]
274 #define wchar_type_node c_global_trees[CTI_WCHAR_TYPE]
275 #define underlying_wchar_type_node c_global_trees[CTI_UNDERLYING_WCHAR_TYPE]
276 #define wint_type_node c_global_trees[CTI_WINT_TYPE]
277 #define signed_size_type_node c_global_trees[CTI_SIGNED_SIZE_TYPE]
278 #define unsigned_ptrdiff_type_node c_global_trees[CTI_UNSIGNED_PTRDIFF_TYPE]
279 #define intmax_type_node c_global_trees[CTI_INTMAX_TYPE]
280 #define uintmax_type_node c_global_trees[CTI_UINTMAX_TYPE]
281 #define widest_integer_literal_type_node c_global_trees[CTI_WIDEST_INT_LIT_TYPE]
282 #define widest_unsigned_literal_type_node c_global_trees[CTI_WIDEST_UINT_LIT_TYPE]
284 #define sig_atomic_type_node c_global_trees[CTI_SIG_ATOMIC_TYPE]
285 #define int8_type_node c_global_trees[CTI_INT8_TYPE]
286 #define int16_type_node c_global_trees[CTI_INT16_TYPE]
287 #define int32_type_node c_global_trees[CTI_INT32_TYPE]
288 #define int64_type_node c_global_trees[CTI_INT64_TYPE]
289 #define uint8_type_node c_global_trees[CTI_UINT8_TYPE]
290 #define uint16_type_node c_global_trees[CTI_UINT16_TYPE]
291 #define c_uint32_type_node c_global_trees[CTI_UINT32_TYPE]
292 #define c_uint64_type_node c_global_trees[CTI_UINT64_TYPE]
293 #define int_least8_type_node c_global_trees[CTI_INT_LEAST8_TYPE]
294 #define int_least16_type_node c_global_trees[CTI_INT_LEAST16_TYPE]
295 #define int_least32_type_node c_global_trees[CTI_INT_LEAST32_TYPE]
296 #define int_least64_type_node c_global_trees[CTI_INT_LEAST64_TYPE]
297 #define uint_least8_type_node c_global_trees[CTI_UINT_LEAST8_TYPE]
298 #define uint_least16_type_node c_global_trees[CTI_UINT_LEAST16_TYPE]
299 #define uint_least32_type_node c_global_trees[CTI_UINT_LEAST32_TYPE]
300 #define uint_least64_type_node c_global_trees[CTI_UINT_LEAST64_TYPE]
301 #define int_fast8_type_node c_global_trees[CTI_INT_FAST8_TYPE]
302 #define int_fast16_type_node c_global_trees[CTI_INT_FAST16_TYPE]
303 #define int_fast32_type_node c_global_trees[CTI_INT_FAST32_TYPE]
304 #define int_fast64_type_node c_global_trees[CTI_INT_FAST64_TYPE]
305 #define uint_fast8_type_node c_global_trees[CTI_UINT_FAST8_TYPE]
306 #define uint_fast16_type_node c_global_trees[CTI_UINT_FAST16_TYPE]
307 #define uint_fast32_type_node c_global_trees[CTI_UINT_FAST32_TYPE]
308 #define uint_fast64_type_node c_global_trees[CTI_UINT_FAST64_TYPE]
309 #define intptr_type_node c_global_trees[CTI_INTPTR_TYPE]
310 #define uintptr_type_node c_global_trees[CTI_UINTPTR_TYPE]
312 #define truthvalue_type_node c_global_trees[CTI_TRUTHVALUE_TYPE]
313 #define truthvalue_true_node c_global_trees[CTI_TRUTHVALUE_TRUE]
314 #define truthvalue_false_node c_global_trees[CTI_TRUTHVALUE_FALSE]
316 #define char_array_type_node c_global_trees[CTI_CHAR_ARRAY_TYPE]
317 #define char16_array_type_node c_global_trees[CTI_CHAR16_ARRAY_TYPE]
318 #define char32_array_type_node c_global_trees[CTI_CHAR32_ARRAY_TYPE]
319 #define wchar_array_type_node c_global_trees[CTI_WCHAR_ARRAY_TYPE]
320 #define int_array_type_node c_global_trees[CTI_INT_ARRAY_TYPE]
321 #define string_type_node c_global_trees[CTI_STRING_TYPE]
322 #define const_string_type_node c_global_trees[CTI_CONST_STRING_TYPE]
324 #define default_function_type c_global_trees[CTI_DEFAULT_FUNCTION_TYPE]
326 #define function_name_decl_node c_global_trees[CTI_FUNCTION_NAME_DECL]
327 #define pretty_function_name_decl_node c_global_trees[CTI_PRETTY_FUNCTION_NAME_DECL]
328 #define c99_function_name_decl_node c_global_trees[CTI_C99_FUNCTION_NAME_DECL]
329 #define saved_function_name_decls c_global_trees[CTI_SAVED_FUNCTION_NAME_DECLS]
331 /* A node for `((void) 0)'. */
332 #define void_zero_node c_global_trees[CTI_VOID_ZERO]
334 /* The node for C++ `__null'. */
335 #define null_node c_global_trees[CTI_NULL]
337 extern GTY(()) tree c_global_trees[CTI_MAX];
339 /* In a RECORD_TYPE, a sorted array of the fields of the type, not a
340 tree for size reasons. */
341 struct GTY(()) sorted_fields_type {
342 int len;
343 tree GTY((length ("%h.len"))) elts[1];
346 /* Mark which labels are explicitly declared.
347 These may be shadowed, and may be referenced from nested functions. */
348 #define C_DECLARED_LABEL_FLAG(label) TREE_LANG_FLAG_1 (label)
350 typedef enum c_language_kind
352 clk_c = 0, /* C90, C94 or C99 */
353 clk_objc = 1, /* clk_c with ObjC features. */
354 clk_cxx = 2, /* ANSI/ISO C++ */
355 clk_objcxx = 3 /* clk_cxx with ObjC features. */
357 c_language_kind;
359 /* To test for a specific language use c_language, defined by each
360 front end. For "ObjC features" or "not C++" use the macros. */
361 extern c_language_kind c_language;
363 #define c_dialect_cxx() (c_language & clk_cxx)
364 #define c_dialect_objc() (c_language & clk_objc)
366 /* Information about a statement tree. */
368 struct GTY(()) stmt_tree_s {
369 /* The current statement list being collected. */
370 tree x_cur_stmt_list;
372 /* In C++, Nonzero if we should treat statements as full
373 expressions. In particular, this variable is no-zero if at the
374 end of a statement we should destroy any temporaries created
375 during that statement. Similarly, if, at the end of a block, we
376 should destroy any local variables in this block. Normally, this
377 variable is nonzero, since those are the normal semantics of
378 C++.
380 However, in order to represent aggregate initialization code as
381 tree structure, we use statement-expressions. The statements
382 within the statement expression should not result in cleanups
383 being run until the entire enclosing statement is complete.
385 This flag has no effect in C. */
386 int stmts_are_full_exprs_p;
389 typedef struct stmt_tree_s *stmt_tree;
391 /* Global state pertinent to the current function. Some C dialects
392 extend this structure with additional fields. */
394 struct GTY(()) c_language_function {
395 /* While we are parsing the function, this contains information
396 about the statement-tree that we are building. */
397 struct stmt_tree_s x_stmt_tree;
400 /* When building a statement-tree, this is the current statement list
401 being collected. It's TREE_CHAIN is a back-pointer to the previous
402 statement list. */
404 #define cur_stmt_list (current_stmt_tree ()->x_cur_stmt_list)
406 /* Language-specific hooks. */
408 /* If non-NULL, this function is called after a precompile header file
409 is loaded. */
410 extern void (*lang_post_pch_load) (void);
412 extern void push_file_scope (void);
413 extern void pop_file_scope (void);
414 extern stmt_tree current_stmt_tree (void);
415 extern tree push_stmt_list (void);
416 extern tree pop_stmt_list (tree);
417 extern tree add_stmt (tree);
418 extern void push_cleanup (tree, tree, bool);
419 extern tree pushdecl_top_level (tree);
420 extern tree pushdecl (tree);
421 extern tree build_modify_expr (location_t, tree, tree, enum tree_code,
422 location_t, tree, tree);
423 extern tree build_indirect_ref (location_t, tree, const char *);
425 extern int c_expand_decl (tree);
427 extern int field_decl_cmp (const void *, const void *);
428 extern void resort_sorted_fields (void *, void *, gt_pointer_operator,
429 void *);
430 extern bool has_c_linkage (const_tree decl);
432 /* Switches common to the C front ends. */
434 /* Nonzero if prepreprocessing only. */
436 extern int flag_preprocess_only;
438 /* Zero means that faster, ...NonNil variants of objc_msgSend...
439 calls will be used in ObjC; passing nil receivers to such calls
440 will most likely result in crashes. */
441 extern int flag_nil_receivers;
443 /* Nonzero means that we will allow new ObjC exception syntax (@throw,
444 @try, etc.) in source code. */
445 extern int flag_objc_exceptions;
447 /* Nonzero means that we generate NeXT setjmp based exceptions. */
448 extern int flag_objc_sjlj_exceptions;
450 /* Nonzero means that code generation will be altered to support
451 "zero-link" execution. This currently affects ObjC only, but may
452 affect other languages in the future. */
453 extern int flag_zero_link;
455 /* Nonzero means emit an '__OBJC, __image_info' for the current translation
456 unit. It will inform the ObjC runtime that class definition(s) herein
457 contained are to replace one(s) previously loaded. */
458 extern int flag_replace_objc_classes;
460 /* Nonzero means don't output line number information. */
462 extern char flag_no_line_commands;
464 /* Nonzero causes -E output not to be done, but directives such as
465 #define that have side effects are still obeyed. */
467 extern char flag_no_output;
469 /* Nonzero means dump macros in some fashion; contains the 'D', 'M',
470 'N' or 'U' of the command line switch. */
472 extern char flag_dump_macros;
474 /* Nonzero means pass #include lines through to the output. */
476 extern char flag_dump_includes;
478 /* Nonzero means process PCH files while preprocessing. */
480 extern bool flag_pch_preprocess;
482 /* The file name to which we should write a precompiled header, or
483 NULL if no header will be written in this compile. */
485 extern const char *pch_file;
487 /* Nonzero if an ISO standard was selected. It rejects macros in the
488 user's namespace. */
490 extern int flag_iso;
492 /* Nonzero if -undef was given. It suppresses target built-in macros
493 and assertions. */
495 extern int flag_undef;
497 /* Nonzero means don't recognize the non-ANSI builtin functions. */
499 extern int flag_no_builtin;
501 /* Nonzero means don't recognize the non-ANSI builtin functions.
502 -ansi sets this. */
504 extern int flag_no_nonansi_builtin;
506 /* Nonzero means give `double' the same size as `float'. */
508 extern int flag_short_double;
510 /* Nonzero means give `wchar_t' the same size as `short'. */
512 extern int flag_short_wchar;
514 /* Nonzero means allow implicit conversions between vectors with
515 differing numbers of subparts and/or differing element types. */
516 extern int flag_lax_vector_conversions;
518 /* Nonzero means allow Microsoft extensions without warnings or errors. */
519 extern int flag_ms_extensions;
521 /* Nonzero means don't recognize the keyword `asm'. */
523 extern int flag_no_asm;
525 /* Nonzero means give string constants the type `const char *', as mandated
526 by the standard. */
528 extern int flag_const_strings;
530 /* Nonzero means to treat bitfields as signed unless they say `unsigned'. */
532 extern int flag_signed_bitfields;
534 /* Warn about #pragma directives that are not recognized. */
536 extern int warn_unknown_pragmas; /* Tri state variable. */
538 /* Warn about format/argument anomalies in calls to formatted I/O functions
539 (*printf, *scanf, strftime, strfmon, etc.). */
541 extern int warn_format;
544 /* C/ObjC language option variables. */
547 /* Nonzero means allow type mismatches in conditional expressions;
548 just make their values `void'. */
550 extern int flag_cond_mismatch;
552 /* Nonzero means enable C89 Amendment 1 features. */
554 extern int flag_isoc94;
556 /* Nonzero means use the ISO C99 dialect of C. */
558 extern int flag_isoc99;
560 /* Nonzero means that we have builtin functions, and main is an int. */
562 extern int flag_hosted;
564 /* ObjC language option variables. */
567 /* Open and close the file for outputting class declarations, if
568 requested (ObjC). */
570 extern int flag_gen_declaration;
572 /* Tells the compiler that this is a special run. Do not perform any
573 compiling, instead we are to test some platform dependent features
574 and output a C header file with appropriate definitions. */
576 extern int print_struct_values;
578 /* ???. Undocumented. */
580 extern const char *constant_string_class_name;
583 /* C++ language option variables. */
586 /* Nonzero means don't recognize any extension keywords. */
588 extern int flag_no_gnu_keywords;
590 /* Nonzero means do emit exported implementations of functions even if
591 they can be inlined. */
593 extern int flag_implement_inlines;
595 /* Nonzero means that implicit instantiations will be emitted if needed. */
597 extern int flag_implicit_templates;
599 /* Nonzero means that implicit instantiations of inline templates will be
600 emitted if needed, even if instantiations of non-inline templates
601 aren't. */
603 extern int flag_implicit_inline_templates;
605 /* Nonzero means generate separate instantiation control files and
606 juggle them at link time. */
608 extern int flag_use_repository;
610 /* Nonzero if we want to issue diagnostics that the standard says are not
611 required. */
613 extern int flag_optional_diags;
615 /* Nonzero means we should attempt to elide constructors when possible. */
617 extern int flag_elide_constructors;
619 /* Nonzero means that member functions defined in class scope are
620 inline by default. */
622 extern int flag_default_inline;
624 /* Controls whether compiler generates 'type descriptor' that give
625 run-time type information. */
627 extern int flag_rtti;
629 /* Nonzero if we want to conserve space in the .o files. We do this
630 by putting uninitialized data and runtime initialized data into
631 .common instead of .data at the expense of not flagging multiple
632 definitions. */
634 extern int flag_conserve_space;
636 /* Nonzero if we want to obey access control semantics. */
638 extern int flag_access_control;
640 /* Nonzero if we want to check the return value of new and avoid calling
641 constructors if it is a null pointer. */
643 extern int flag_check_new;
645 /* The supported C++ dialects. */
647 enum cxx_dialect {
648 /* C++98 */
649 cxx98,
650 /* Experimental features that are likely to become part of
651 C++0x. */
652 cxx0x
655 /* The C++ dialect being used. C++98 is the default. */
656 extern enum cxx_dialect cxx_dialect;
658 /* Nonzero if we want the new ISO rules for pushing a new scope for `for'
659 initialization variables.
660 0: Old rules, set by -fno-for-scope.
661 2: New ISO rules, set by -ffor-scope.
662 1: Try to implement new ISO rules, but with backup compatibility
663 (and warnings). This is the default, for now. */
665 extern int flag_new_for_scope;
667 /* Nonzero if we want to emit defined symbols with common-like linkage as
668 weak symbols where possible, in order to conform to C++ semantics.
669 Otherwise, emit them as local symbols. */
671 extern int flag_weak;
673 /* 0 means we want the preprocessor to not emit line directives for
674 the current working directory. 1 means we want it to do it. -1
675 means we should decide depending on whether debugging information
676 is being emitted or not. */
678 extern int flag_working_directory;
680 /* Nonzero to use __cxa_atexit, rather than atexit, to register
681 destructors for local statics and global objects. */
683 extern int flag_use_cxa_atexit;
685 /* Nonzero to use __cxa_get_exception_ptr in the C++ exception-handling
686 logic. */
688 extern int flag_use_cxa_get_exception_ptr;
690 /* Nonzero means to implement standard semantics for exception
691 specifications, calling unexpected if an exception is thrown that
692 doesn't match the specification. Zero means to treat them as
693 assertions and optimize accordingly, but not check them. */
695 extern int flag_enforce_eh_specs;
697 /* Nonzero (the default) means to generate thread-safe code for
698 initializing local statics. */
700 extern int flag_threadsafe_statics;
702 /* Nonzero if we want to pretty-print template specializations as the
703 template signature followed by the arguments. */
705 extern int flag_pretty_templates;
707 /* Nonzero means warn about implicit declarations. */
709 extern int warn_implicit;
711 /* Warn about using __null (as NULL in C++) as sentinel. For code compiled
712 with GCC this doesn't matter as __null is guaranteed to have the right
713 size. */
715 extern int warn_strict_null_sentinel;
717 /* Maximum template instantiation depth. This limit is rather
718 arbitrary, but it exists to limit the time it takes to notice
719 infinite template instantiations. */
721 extern int max_tinst_depth;
723 /* Nonzero means that we should not issue warnings about problems that
724 occur when the code is executed, because the code being processed
725 is not expected to be executed. This is set during parsing. This
726 is used for cases like sizeof() and "0 ? a : b". This is a count,
727 not a bool, because unexecuted expressions can nest. */
729 extern int c_inhibit_evaluation_warnings;
731 /* Whether lexing has been completed, so subsequent preprocessor
732 errors should use the compiler's input_location. */
734 extern bool done_lexing;
736 /* C types are partitioned into three subsets: object, function, and
737 incomplete types. */
738 #define C_TYPE_OBJECT_P(type) \
739 (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
741 #define C_TYPE_INCOMPLETE_P(type) \
742 (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
744 #define C_TYPE_FUNCTION_P(type) \
745 (TREE_CODE (type) == FUNCTION_TYPE)
747 /* For convenience we define a single macro to identify the class of
748 object or incomplete types. */
749 #define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
750 (!C_TYPE_FUNCTION_P (type))
752 /* Attribute table common to the C front ends. */
753 extern const struct attribute_spec c_common_attribute_table[];
754 extern const struct attribute_spec c_common_format_attribute_table[];
756 /* Pointer to function to lazily generate the VAR_DECL for __FUNCTION__ etc.
757 ID is the identifier to use, NAME is the string.
758 TYPE_DEP indicates whether it depends on type of the function or not
759 (i.e. __PRETTY_FUNCTION__). */
761 extern tree (*make_fname_decl) (location_t, tree, int);
763 extern tree identifier_global_value (tree);
764 extern void record_builtin_type (enum rid, const char *, tree);
765 extern tree build_void_list_node (void);
766 extern void start_fname_decls (void);
767 extern void finish_fname_decls (void);
768 extern const char *fname_as_string (int);
769 extern tree fname_decl (location_t, unsigned, tree);
771 extern void check_function_arguments (tree, int, tree *, tree);
772 extern void check_function_arguments_recurse (void (*)
773 (void *, tree,
774 unsigned HOST_WIDE_INT),
775 void *, tree,
776 unsigned HOST_WIDE_INT);
777 extern bool check_builtin_function_arguments (tree, int, tree *);
778 extern void check_function_format (tree, int, tree *);
779 extern void set_Wformat (int);
780 extern tree handle_format_attribute (tree *, tree, tree, int, bool *);
781 extern tree handle_format_arg_attribute (tree *, tree, tree, int, bool *);
782 extern int c_common_handle_option (size_t code, const char *arg, int value);
783 extern bool c_common_missing_argument (const char *opt, size_t code);
784 extern tree c_common_type_for_mode (enum machine_mode, int);
785 extern tree c_common_type_for_size (unsigned int, int);
786 extern tree c_common_fixed_point_type_for_size (unsigned int, unsigned int,
787 int, int);
788 extern tree c_common_unsigned_type (tree);
789 extern tree c_common_signed_type (tree);
790 extern tree c_common_signed_or_unsigned_type (int, tree);
791 extern tree c_build_bitfield_integer_type (unsigned HOST_WIDE_INT, int);
792 extern bool decl_with_nonnull_addr_p (const_tree);
793 extern tree c_fully_fold (tree, bool, bool *);
794 extern tree decl_constant_value_for_optimization (tree);
795 extern tree c_save_expr (tree);
796 extern tree c_common_truthvalue_conversion (location_t, tree);
797 extern void c_apply_type_quals_to_decl (int, tree);
798 extern tree c_sizeof_or_alignof_type (location_t, tree, bool, int);
799 extern tree c_alignof_expr (location_t, tree);
800 /* Print an error message for invalid operands to arith operation CODE.
801 NOP_EXPR is used as a special case (see truthvalue_conversion). */
802 extern void binary_op_error (location_t, enum tree_code, tree, tree);
803 extern tree fix_string_type (tree);
804 struct varray_head_tag;
805 extern void constant_expression_warning (tree);
806 extern void constant_expression_error (tree);
807 extern bool strict_aliasing_warning (tree, tree, tree);
808 extern void warnings_for_convert_and_check (tree, tree, tree);
809 extern tree convert_and_check (tree, tree);
810 extern void overflow_warning (location_t, tree);
811 extern void warn_logical_operator (location_t, enum tree_code, tree,
812 enum tree_code, tree, enum tree_code, tree);
813 extern void check_main_parameter_types (tree decl);
814 extern bool c_determine_visibility (tree);
815 extern bool same_scalar_type_ignoring_signedness (tree, tree);
816 extern void mark_valid_location_for_stdc_pragma (bool);
817 extern bool valid_location_for_stdc_pragma_p (void);
818 extern void set_float_const_decimal64 (void);
819 extern void clear_float_const_decimal64 (void);
820 extern bool float_const_decimal64_p (void);
822 #define c_sizeof(LOC, T) c_sizeof_or_alignof_type (LOC, T, true, 1)
823 #define c_alignof(LOC, T) c_sizeof_or_alignof_type (LOC, T, false, 1)
825 /* Subroutine of build_binary_op, used for certain operations. */
826 extern tree shorten_binary_op (tree result_type, tree op0, tree op1, bool bitwise);
828 /* Subroutine of build_binary_op, used for comparison operations.
829 See if the operands have both been converted from subword integer types
830 and, if so, perhaps change them both back to their original type. */
831 extern tree shorten_compare (tree *, tree *, tree *, enum tree_code *);
833 extern tree pointer_int_sum (location_t, enum tree_code, tree, tree);
835 /* Add qualifiers to a type, in the fashion for C. */
836 extern tree c_build_qualified_type (tree, int);
838 /* Build tree nodes and builtin functions common to both C and C++ language
839 frontends. */
840 extern void c_common_nodes_and_builtins (void);
842 extern void set_builtin_user_assembler_name (tree decl, const char *asmspec);
844 extern void disable_builtin_function (const char *);
846 extern void set_compound_literal_name (tree decl);
848 extern tree build_va_arg (location_t, tree, tree);
850 extern unsigned int c_common_init_options (unsigned int, const char **);
851 extern bool c_common_post_options (const char **);
852 extern bool c_common_init (void);
853 extern void c_common_finish (void);
854 extern void c_common_parse_file (int);
855 extern alias_set_type c_common_get_alias_set (tree);
856 extern void c_register_builtin_type (tree, const char*);
857 extern bool c_promoting_integer_type_p (const_tree);
858 extern int self_promoting_args_p (const_tree);
859 extern tree strip_pointer_operator (tree);
860 extern tree strip_pointer_or_array_types (tree);
861 extern HOST_WIDE_INT c_common_to_target_charset (HOST_WIDE_INT);
863 /* This is the basic parsing function. */
864 extern void c_parse_file (void);
865 /* This is misnamed, it actually performs end-of-compilation processing. */
866 extern void finish_file (void);
869 /* These macros provide convenient access to the various _STMT nodes. */
871 /* Nonzero if a given STATEMENT_LIST represents the outermost binding
872 if a statement expression. */
873 #define STATEMENT_LIST_STMT_EXPR(NODE) \
874 TREE_LANG_FLAG_1 (STATEMENT_LIST_CHECK (NODE))
876 /* Nonzero if a label has been added to the statement list. */
877 #define STATEMENT_LIST_HAS_LABEL(NODE) \
878 TREE_LANG_FLAG_3 (STATEMENT_LIST_CHECK (NODE))
880 /* C_MAYBE_CONST_EXPR accessors. */
881 #define C_MAYBE_CONST_EXPR_PRE(NODE) \
882 TREE_OPERAND (C_MAYBE_CONST_EXPR_CHECK (NODE), 0)
883 #define C_MAYBE_CONST_EXPR_EXPR(NODE) \
884 TREE_OPERAND (C_MAYBE_CONST_EXPR_CHECK (NODE), 1)
885 #define C_MAYBE_CONST_EXPR_INT_OPERANDS(NODE) \
886 TREE_LANG_FLAG_0 (C_MAYBE_CONST_EXPR_CHECK (NODE))
887 #define C_MAYBE_CONST_EXPR_NON_CONST(NODE) \
888 TREE_LANG_FLAG_1 (C_MAYBE_CONST_EXPR_CHECK (NODE))
889 #define EXPR_INT_CONST_OPERANDS(EXPR) \
890 (INTEGRAL_TYPE_P (TREE_TYPE (EXPR)) \
891 && (TREE_CODE (EXPR) == INTEGER_CST \
892 || (TREE_CODE (EXPR) == C_MAYBE_CONST_EXPR \
893 && C_MAYBE_CONST_EXPR_INT_OPERANDS (EXPR))))
895 /* In a FIELD_DECL, nonzero if the decl was originally a bitfield. */
896 #define DECL_C_BIT_FIELD(NODE) \
897 (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) == 1)
898 #define SET_DECL_C_BIT_FIELD(NODE) \
899 (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 1)
900 #define CLEAR_DECL_C_BIT_FIELD(NODE) \
901 (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 0)
903 extern tree do_case (location_t, tree, tree);
904 extern tree build_stmt (location_t, enum tree_code, ...);
905 extern tree build_case_label (location_t, tree, tree, tree);
907 /* These functions must be defined by each front-end which implements
908 a variant of the C language. They are used in c-common.c. */
910 extern tree build_unary_op (location_t, enum tree_code, tree, int);
911 extern tree build_binary_op (location_t, enum tree_code, tree, tree, int);
912 extern tree perform_integral_promotions (tree);
914 /* These functions must be defined by each front-end which implements
915 a variant of the C language. They are used by port files. */
917 extern tree default_conversion (tree);
919 /* Given two integer or real types, return the type for their sum.
920 Given two compatible ANSI C types, returns the merged type. */
922 extern tree common_type (tree, tree);
924 extern tree decl_constant_value (tree);
926 /* Handle increment and decrement of boolean types. */
927 extern tree boolean_increment (enum tree_code, tree);
929 extern int case_compare (splay_tree_key, splay_tree_key);
931 extern tree c_add_case_label (location_t, splay_tree, tree, tree, tree, tree);
933 extern void c_do_switch_warnings (splay_tree, location_t, tree, tree);
935 extern tree build_function_call (location_t, tree, tree);
937 extern tree build_function_call_vec (location_t, tree,
938 VEC(tree,gc) *, VEC(tree,gc) *);
940 extern tree resolve_overloaded_builtin (location_t, tree, VEC(tree,gc) *);
942 extern tree finish_label_address_expr (tree, location_t);
944 /* Same function prototype, but the C and C++ front ends have
945 different implementations. Used in c-common.c. */
946 extern tree lookup_label (tree);
947 extern tree lookup_name (tree);
948 extern bool lvalue_p (const_tree);
950 extern bool vector_targets_convertible_p (const_tree t1, const_tree t2);
951 extern bool vector_types_convertible_p (const_tree t1, const_tree t2, bool emit_lax_note);
953 extern rtx c_expand_expr (tree, rtx, enum machine_mode, int, rtx *);
955 extern void init_c_lex (void);
957 extern void c_cpp_builtins (cpp_reader *);
958 extern void c_cpp_builtins_optimize_pragma (cpp_reader *, tree, tree);
960 /* Positive if an implicit `extern "C"' scope has just been entered;
961 negative if such a scope has just been exited. */
962 extern GTY(()) int pending_lang_change;
964 /* Information recorded about each file examined during compilation. */
966 struct c_fileinfo
968 int time; /* Time spent in the file. */
970 /* Flags used only by C++.
971 INTERFACE_ONLY nonzero means that we are in an "interface" section
972 of the compiler. INTERFACE_UNKNOWN nonzero means we cannot trust
973 the value of INTERFACE_ONLY. If INTERFACE_UNKNOWN is zero and
974 INTERFACE_ONLY is zero, it means that we are responsible for
975 exporting definitions that others might need. */
976 short interface_only;
977 short interface_unknown;
980 struct c_fileinfo *get_fileinfo (const char *);
981 extern void dump_time_statistics (void);
983 extern bool c_dump_tree (void *, tree);
985 extern void verify_sequence_points (tree);
987 extern tree fold_offsetof (tree, tree);
989 /* Places where an lvalue, or modifiable lvalue, may be required.
990 Used to select diagnostic messages in lvalue_error and
991 readonly_error. */
992 enum lvalue_use {
993 lv_assign,
994 lv_increment,
995 lv_decrement,
996 lv_addressof,
997 lv_asm
1000 extern void lvalue_error (enum lvalue_use);
1002 extern int complete_array_type (tree *, tree, bool);
1004 extern tree builtin_type_for_size (int, bool);
1006 extern void warn_array_subscript_with_type_char (tree);
1007 extern void warn_about_parentheses (enum tree_code,
1008 enum tree_code, tree,
1009 enum tree_code, tree);
1010 extern void warn_for_unused_label (tree label);
1011 extern void warn_for_div_by_zero (location_t, tree divisor);
1012 extern void warn_for_sign_compare (location_t,
1013 tree orig_op0, tree orig_op1,
1014 tree op0, tree op1,
1015 tree result_type,
1016 enum tree_code resultcode);
1017 extern void set_underlying_type (tree x);
1018 extern bool is_typedef_decl (tree x);
1019 extern VEC(tree,gc) *make_tree_vector (void);
1020 extern void release_tree_vector (VEC(tree,gc) *);
1021 extern VEC(tree,gc) *make_tree_vector_single (tree);
1022 extern VEC(tree,gc) *make_tree_vector_copy (const VEC(tree,gc) *);
1024 /* In c-gimplify.c */
1025 extern void c_genericize (tree);
1026 extern int c_gimplify_expr (tree *, gimple_seq *, gimple_seq *);
1027 extern tree c_build_bind_expr (location_t, tree, tree);
1029 /* In c-pch.c */
1030 extern void pch_init (void);
1031 extern int c_common_valid_pch (cpp_reader *pfile, const char *name, int fd);
1032 extern void c_common_read_pch (cpp_reader *pfile, const char *name, int fd,
1033 const char *orig);
1034 extern void c_common_write_pch (void);
1035 extern void c_common_no_more_pch (void);
1036 extern void c_common_pch_pragma (cpp_reader *pfile, const char *);
1037 extern void c_common_print_pch_checksum (FILE *f);
1039 /* In *-checksum.c */
1040 extern const unsigned char executable_checksum[16];
1042 /* In c-cppbuiltin.c */
1043 extern void builtin_define_std (const char *macro);
1044 extern void builtin_define_with_value (const char *, const char *, int);
1045 extern void c_stddef_cpp_builtins (void);
1046 extern void fe_file_change (const struct line_map *);
1047 extern void c_parse_error (const char *, enum cpp_ttype, tree, unsigned char);
1049 /* Objective-C / Objective-C++ entry points. */
1051 /* The following ObjC/ObjC++ functions are called by the C and/or C++
1052 front-ends; they all must have corresponding stubs in stub-objc.c. */
1053 extern tree objc_is_class_name (tree);
1054 extern tree objc_is_object_ptr (tree);
1055 extern void objc_check_decl (tree);
1056 extern int objc_is_reserved_word (tree);
1057 extern bool objc_compare_types (tree, tree, int, tree);
1058 extern void objc_volatilize_decl (tree);
1059 extern bool objc_type_quals_match (tree, tree);
1060 extern tree objc_rewrite_function_call (tree, tree);
1061 extern tree objc_message_selector (void);
1062 extern tree objc_lookup_ivar (tree, tree);
1063 extern void objc_clear_super_receiver (void);
1064 extern int objc_is_public (tree, tree);
1065 extern tree objc_is_id (tree);
1066 extern void objc_declare_alias (tree, tree);
1067 extern void objc_declare_class (tree);
1068 extern void objc_declare_protocols (tree);
1069 extern tree objc_build_message_expr (tree);
1070 extern tree objc_finish_message_expr (tree, tree, tree);
1071 extern tree objc_build_selector_expr (location_t, tree);
1072 extern tree objc_build_protocol_expr (tree);
1073 extern tree objc_build_encode_expr (tree);
1074 extern tree objc_build_string_object (tree);
1075 extern tree objc_get_protocol_qualified_type (tree, tree);
1076 extern tree objc_get_class_reference (tree);
1077 extern tree objc_get_class_ivars (tree);
1078 extern void objc_start_class_interface (tree, tree, tree);
1079 extern void objc_start_category_interface (tree, tree, tree);
1080 extern void objc_start_protocol (tree, tree);
1081 extern void objc_continue_interface (void);
1082 extern void objc_finish_interface (void);
1083 extern void objc_start_class_implementation (tree, tree);
1084 extern void objc_start_category_implementation (tree, tree);
1085 extern void objc_continue_implementation (void);
1086 extern void objc_finish_implementation (void);
1087 extern void objc_set_visibility (int);
1088 extern void objc_set_method_type (enum tree_code);
1089 extern tree objc_build_method_signature (tree, tree, tree, bool);
1090 extern void objc_add_method_declaration (tree);
1091 extern void objc_start_method_definition (tree);
1092 extern void objc_finish_method_definition (tree);
1093 extern void objc_add_instance_variable (tree);
1094 extern tree objc_build_keyword_decl (tree, tree, tree);
1095 extern tree objc_build_throw_stmt (location_t, tree);
1096 extern void objc_begin_try_stmt (location_t, tree);
1097 extern tree objc_finish_try_stmt (void);
1098 extern void objc_begin_catch_clause (tree);
1099 extern void objc_finish_catch_clause (void);
1100 extern void objc_build_finally_clause (location_t, tree);
1101 extern tree objc_build_synchronized (location_t, tree, tree);
1102 extern int objc_static_init_needed_p (void);
1103 extern tree objc_generate_static_init_call (tree);
1104 extern tree objc_generate_write_barrier (tree, enum tree_code, tree);
1106 /* The following are provided by the C and C++ front-ends, and called by
1107 ObjC/ObjC++. */
1108 extern void *objc_get_current_scope (void);
1109 extern void objc_mark_locals_volatile (void *);
1111 /* In c-ppoutput.c */
1112 extern void init_pp_output (FILE *);
1113 extern void preprocess_file (cpp_reader *);
1114 extern void pp_file_change (const struct line_map *);
1115 extern void pp_dir_change (cpp_reader *, const char *);
1116 extern bool check_missing_format_attribute (tree, tree);
1118 /* In c-omp.c */
1119 extern tree c_finish_omp_master (location_t, tree);
1120 extern tree c_finish_omp_critical (location_t, tree, tree);
1121 extern tree c_finish_omp_ordered (location_t, tree);
1122 extern void c_finish_omp_barrier (location_t);
1123 extern tree c_finish_omp_atomic (location_t, enum tree_code, tree, tree);
1124 extern void c_finish_omp_flush (location_t);
1125 extern void c_finish_omp_taskwait (location_t);
1126 extern tree c_finish_omp_for (location_t, tree, tree, tree, tree, tree, tree);
1127 extern void c_split_parallel_clauses (location_t, tree, tree *, tree *);
1128 extern enum omp_clause_default_kind c_omp_predetermined_sharing (tree);
1130 /* Not in c-omp.c; provided by the front end. */
1131 extern bool c_omp_sharing_predetermined (tree);
1132 extern tree c_omp_remap_decl (tree, bool);
1134 /* In order for the format checking to accept the C frontend
1135 diagnostic framework extensions, you must include this file before
1136 toplev.h, not after. The C front end formats are a subset of those
1137 for C++, so they are the appropriate set to use in common code;
1138 cp-tree.h overrides this for C++. */
1139 #ifndef GCC_DIAG_STYLE
1140 #define GCC_DIAG_STYLE __gcc_cdiag__
1141 #endif
1143 #endif /* ! GCC_C_COMMON_H */