Mark ChangeLog
[official-gcc.git] / gcc / c-common.h
blob7e2fab281b4ba8cc200a7be1b97593a0a385baaa
1 /* Definitions for c-common.c.
2 Copyright (C) 1987, 1993, 1994, 1995, 1997, 1998,
3 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2007 Free Software Foundation, Inc.
5 This file is part of GCC.
7 GCC is free software; you can redistribute it and/or modify it under
8 the terms of the GNU General Public License as published by the Free
9 Software Foundation; either version 3, or (at your option) any later
10 version.
12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
15 for more details.
17 You should have received a copy of the GNU General Public License
18 along with GCC; see the file COPYING3. If not see
19 <http://www.gnu.org/licenses/>. */
21 #ifndef GCC_C_COMMON_H
22 #define GCC_C_COMMON_H
24 #include "splay-tree.h"
25 #include "cpplib.h"
26 #include "ggc.h"
28 /* Usage of TREE_LANG_FLAG_?:
29 0: TREE_NEGATED_INT (in INTEGER_CST).
30 IDENTIFIER_MARKED (used by search routines).
31 DECL_PRETTY_FUNCTION_P (in VAR_DECL)
32 1: C_DECLARED_LABEL_FLAG (in LABEL_DECL)
33 STATEMENT_LIST_STMT_EXPR (in STATEMENT_LIST)
34 2: unused
35 3: STATEMENT_LIST_HAS_LABEL (in STATEMENT_LIST)
36 4: unused
39 /* Reserved identifiers. This is the union of all the keywords for C,
40 C++, and Objective-C. All the type modifiers have to be in one
41 block at the beginning, because they are used as mask bits. There
42 are 27 type modifiers; if we add many more we will have to redesign
43 the mask mechanism. */
45 enum rid
47 /* Modifiers: */
48 /* C, in empirical order of frequency. */
49 RID_STATIC = 0,
50 RID_UNSIGNED, RID_LONG, RID_CONST, RID_EXTERN,
51 RID_REGISTER, RID_TYPEDEF, RID_SHORT, RID_INLINE,
52 RID_VOLATILE, RID_SIGNED, RID_AUTO, RID_RESTRICT,
54 /* C extensions */
55 RID_COMPLEX, RID_THREAD,
57 /* C++ */
58 RID_FRIEND, RID_VIRTUAL, RID_EXPLICIT, RID_EXPORT, RID_MUTABLE,
60 /* ObjC */
61 RID_IN, RID_OUT, RID_INOUT, RID_BYCOPY, RID_BYREF, RID_ONEWAY,
63 /* C */
64 RID_INT, RID_CHAR, RID_FLOAT, RID_DOUBLE, RID_VOID,
65 RID_ENUM, RID_STRUCT, RID_UNION, RID_IF, RID_ELSE,
66 RID_WHILE, RID_DO, RID_FOR, RID_SWITCH, RID_CASE,
67 RID_DEFAULT, RID_BREAK, RID_CONTINUE, RID_RETURN, RID_GOTO,
68 RID_SIZEOF,
70 /* C extensions */
71 RID_ASM, RID_TYPEOF, RID_ALIGNOF, RID_ATTRIBUTE, RID_VA_ARG,
72 RID_EXTENSION, RID_IMAGPART, RID_REALPART, RID_LABEL, RID_CHOOSE_EXPR,
73 RID_TYPES_COMPATIBLE_P,
74 RID_DFLOAT32, RID_DFLOAT64, RID_DFLOAT128,
76 /* Too many ways of getting the name of a function as a string */
77 RID_FUNCTION_NAME, RID_PRETTY_FUNCTION_NAME, RID_C99_FUNCTION_NAME,
79 /* C++ */
80 RID_BOOL, RID_WCHAR, RID_CLASS,
81 RID_PUBLIC, RID_PRIVATE, RID_PROTECTED,
82 RID_TEMPLATE, RID_NULL, RID_CATCH,
83 RID_DELETE, RID_FALSE, RID_NAMESPACE,
84 RID_NEW, RID_OFFSETOF, RID_OPERATOR,
85 RID_THIS, RID_THROW, RID_TRUE,
86 RID_TRY, RID_TYPENAME, RID_TYPEID,
87 RID_USING,
89 /* casts */
90 RID_CONSTCAST, RID_DYNCAST, RID_REINTCAST, RID_STATCAST,
92 /* Objective-C */
93 RID_AT_ENCODE, RID_AT_END,
94 RID_AT_CLASS, RID_AT_ALIAS, RID_AT_DEFS,
95 RID_AT_PRIVATE, RID_AT_PROTECTED, RID_AT_PUBLIC,
96 RID_AT_PROTOCOL, RID_AT_SELECTOR,
97 RID_AT_THROW, RID_AT_TRY, RID_AT_CATCH,
98 RID_AT_FINALLY, RID_AT_SYNCHRONIZED,
99 RID_AT_INTERFACE,
100 RID_AT_IMPLEMENTATION,
102 RID_MAX,
104 RID_FIRST_MODIFIER = RID_STATIC,
105 RID_LAST_MODIFIER = RID_ONEWAY,
107 RID_FIRST_AT = RID_AT_ENCODE,
108 RID_LAST_AT = RID_AT_IMPLEMENTATION,
109 RID_FIRST_PQ = RID_IN,
110 RID_LAST_PQ = RID_ONEWAY
113 #define OBJC_IS_AT_KEYWORD(rid) \
114 ((unsigned int) (rid) >= (unsigned int) RID_FIRST_AT && \
115 (unsigned int) (rid) <= (unsigned int) RID_LAST_AT)
117 #define OBJC_IS_PQ_KEYWORD(rid) \
118 ((unsigned int) (rid) >= (unsigned int) RID_FIRST_PQ && \
119 (unsigned int) (rid) <= (unsigned int) RID_LAST_PQ)
121 /* The elements of `ridpointers' are identifier nodes for the reserved
122 type names and storage classes. It is indexed by a RID_... value. */
123 extern GTY ((length ("(int) RID_MAX"))) tree *ridpointers;
125 /* Standard named or nameless data types of the C compiler. */
127 enum c_tree_index
129 CTI_WCHAR_TYPE,
130 CTI_SIGNED_WCHAR_TYPE,
131 CTI_UNSIGNED_WCHAR_TYPE,
132 CTI_WINT_TYPE,
133 CTI_SIGNED_SIZE_TYPE, /* For format checking only. */
134 CTI_UNSIGNED_PTRDIFF_TYPE, /* For format checking only. */
135 CTI_INTMAX_TYPE,
136 CTI_UINTMAX_TYPE,
137 CTI_WIDEST_INT_LIT_TYPE,
138 CTI_WIDEST_UINT_LIT_TYPE,
140 CTI_CHAR_ARRAY_TYPE,
141 CTI_WCHAR_ARRAY_TYPE,
142 CTI_INT_ARRAY_TYPE,
143 CTI_STRING_TYPE,
144 CTI_CONST_STRING_TYPE,
146 /* Type for boolean expressions (bool in C++, int in C). */
147 CTI_TRUTHVALUE_TYPE,
148 CTI_TRUTHVALUE_TRUE,
149 CTI_TRUTHVALUE_FALSE,
151 CTI_DEFAULT_FUNCTION_TYPE,
153 /* These are not types, but we have to look them up all the time. */
154 CTI_FUNCTION_NAME_DECL,
155 CTI_PRETTY_FUNCTION_NAME_DECL,
156 CTI_C99_FUNCTION_NAME_DECL,
157 CTI_SAVED_FUNCTION_NAME_DECLS,
159 CTI_VOID_ZERO,
161 CTI_NULL,
163 CTI_MAX
166 #define C_RID_CODE(id) (((struct c_common_identifier *) (id))->node.rid_code)
168 /* Identifier part common to the C front ends. Inherits from
169 tree_identifier, despite appearances. */
170 struct c_common_identifier GTY(())
172 struct tree_common common;
173 struct cpp_hashnode node;
176 #define wchar_type_node c_global_trees[CTI_WCHAR_TYPE]
177 #define signed_wchar_type_node c_global_trees[CTI_SIGNED_WCHAR_TYPE]
178 #define unsigned_wchar_type_node c_global_trees[CTI_UNSIGNED_WCHAR_TYPE]
179 #define wint_type_node c_global_trees[CTI_WINT_TYPE]
180 #define signed_size_type_node c_global_trees[CTI_SIGNED_SIZE_TYPE]
181 #define unsigned_ptrdiff_type_node c_global_trees[CTI_UNSIGNED_PTRDIFF_TYPE]
182 #define intmax_type_node c_global_trees[CTI_INTMAX_TYPE]
183 #define uintmax_type_node c_global_trees[CTI_UINTMAX_TYPE]
184 #define widest_integer_literal_type_node c_global_trees[CTI_WIDEST_INT_LIT_TYPE]
185 #define widest_unsigned_literal_type_node c_global_trees[CTI_WIDEST_UINT_LIT_TYPE]
187 #define truthvalue_type_node c_global_trees[CTI_TRUTHVALUE_TYPE]
188 #define truthvalue_true_node c_global_trees[CTI_TRUTHVALUE_TRUE]
189 #define truthvalue_false_node c_global_trees[CTI_TRUTHVALUE_FALSE]
191 #define char_array_type_node c_global_trees[CTI_CHAR_ARRAY_TYPE]
192 #define wchar_array_type_node c_global_trees[CTI_WCHAR_ARRAY_TYPE]
193 #define int_array_type_node c_global_trees[CTI_INT_ARRAY_TYPE]
194 #define string_type_node c_global_trees[CTI_STRING_TYPE]
195 #define const_string_type_node c_global_trees[CTI_CONST_STRING_TYPE]
197 #define default_function_type c_global_trees[CTI_DEFAULT_FUNCTION_TYPE]
199 #define function_name_decl_node c_global_trees[CTI_FUNCTION_NAME_DECL]
200 #define pretty_function_name_decl_node c_global_trees[CTI_PRETTY_FUNCTION_NAME_DECL]
201 #define c99_function_name_decl_node c_global_trees[CTI_C99_FUNCTION_NAME_DECL]
202 #define saved_function_name_decls c_global_trees[CTI_SAVED_FUNCTION_NAME_DECLS]
204 /* A node for `((void) 0)'. */
205 #define void_zero_node c_global_trees[CTI_VOID_ZERO]
207 /* The node for C++ `__null'. */
208 #define null_node c_global_trees[CTI_NULL]
210 extern GTY(()) tree c_global_trees[CTI_MAX];
212 /* In a RECORD_TYPE, a sorted array of the fields of the type, not a
213 tree for size reasons. */
214 struct sorted_fields_type GTY(())
216 int len;
217 tree GTY((length ("%h.len"))) elts[1];
220 /* Mark which labels are explicitly declared.
221 These may be shadowed, and may be referenced from nested functions. */
222 #define C_DECLARED_LABEL_FLAG(label) TREE_LANG_FLAG_1 (label)
224 typedef enum c_language_kind
226 clk_c = 0, /* C90, C94 or C99 */
227 clk_objc = 1, /* clk_c with ObjC features. */
228 clk_cxx = 2, /* ANSI/ISO C++ */
229 clk_objcxx = 3 /* clk_cxx with ObjC features. */
231 c_language_kind;
233 /* To test for a specific language use c_language, defined by each
234 front end. For "ObjC features" or "not C++" use the macros. */
235 extern c_language_kind c_language;
237 #define c_dialect_cxx() (c_language & clk_cxx)
238 #define c_dialect_objc() (c_language & clk_objc)
240 /* Information about a statement tree. */
242 struct stmt_tree_s GTY(()) {
243 /* The current statement list being collected. */
244 tree x_cur_stmt_list;
246 /* In C++, Nonzero if we should treat statements as full
247 expressions. In particular, this variable is no-zero if at the
248 end of a statement we should destroy any temporaries created
249 during that statement. Similarly, if, at the end of a block, we
250 should destroy any local variables in this block. Normally, this
251 variable is nonzero, since those are the normal semantics of
252 C++.
254 However, in order to represent aggregate initialization code as
255 tree structure, we use statement-expressions. The statements
256 within the statement expression should not result in cleanups
257 being run until the entire enclosing statement is complete.
259 This flag has no effect in C. */
260 int stmts_are_full_exprs_p;
263 typedef struct stmt_tree_s *stmt_tree;
265 /* Global state pertinent to the current function. Some C dialects
266 extend this structure with additional fields. */
268 struct c_language_function GTY(()) {
269 /* While we are parsing the function, this contains information
270 about the statement-tree that we are building. */
271 struct stmt_tree_s x_stmt_tree;
274 /* When building a statement-tree, this is the current statement list
275 being collected. It's TREE_CHAIN is a back-pointer to the previous
276 statement list. */
278 #define cur_stmt_list (current_stmt_tree ()->x_cur_stmt_list)
280 /* Language-specific hooks. */
282 /* Callback that determines if it's ok for a function to have no
283 noreturn attribute. */
284 extern int (*lang_missing_noreturn_ok_p) (tree);
286 /* If non-NULL, this function is called after a precompile header file
287 is loaded. */
288 extern void (*lang_post_pch_load) (void);
290 extern void push_file_scope (void);
291 extern void pop_file_scope (void);
292 extern stmt_tree current_stmt_tree (void);
293 extern tree push_stmt_list (void);
294 extern tree pop_stmt_list (tree);
295 extern tree add_stmt (tree);
296 extern void push_cleanup (tree, tree, bool);
297 extern tree pushdecl_top_level (tree);
298 extern tree pushdecl (tree);
299 extern tree build_modify_expr (tree, enum tree_code, tree);
300 extern tree build_indirect_ref (tree, const char *);
302 extern int c_expand_decl (tree);
304 extern int field_decl_cmp (const void *, const void *);
305 extern void resort_sorted_fields (void *, void *, gt_pointer_operator,
306 void *);
307 extern bool has_c_linkage (tree decl);
309 /* Switches common to the C front ends. */
311 /* Nonzero if prepreprocessing only. */
313 extern int flag_preprocess_only;
315 /* Zero means that faster, ...NonNil variants of objc_msgSend...
316 calls will be used in ObjC; passing nil receivers to such calls
317 will most likely result in crashes. */
318 extern int flag_nil_receivers;
320 /* Nonzero means that we will allow new ObjC exception syntax (@throw,
321 @try, etc.) in source code. */
322 extern int flag_objc_exceptions;
324 /* Nonzero means that we generate NeXT setjmp based exceptions. */
325 extern int flag_objc_sjlj_exceptions;
327 /* Nonzero means that code generation will be altered to support
328 "zero-link" execution. This currently affects ObjC only, but may
329 affect other languages in the future. */
330 extern int flag_zero_link;
332 /* Nonzero means emit an '__OBJC, __image_info' for the current translation
333 unit. It will inform the ObjC runtime that class definition(s) herein
334 contained are to replace one(s) previously loaded. */
335 extern int flag_replace_objc_classes;
337 /* Nonzero means don't output line number information. */
339 extern char flag_no_line_commands;
341 /* Nonzero causes -E output not to be done, but directives such as
342 #define that have side effects are still obeyed. */
344 extern char flag_no_output;
346 /* Nonzero means dump macros in some fashion; contains the 'D', 'M' or
347 'N' of the command line switch. */
349 extern char flag_dump_macros;
351 /* Nonzero means pass #include lines through to the output. */
353 extern char flag_dump_includes;
355 /* Nonzero means process PCH files while preprocessing. */
357 extern bool flag_pch_preprocess;
359 /* The file name to which we should write a precompiled header, or
360 NULL if no header will be written in this compile. */
362 extern const char *pch_file;
364 /* Nonzero if an ISO standard was selected. It rejects macros in the
365 user's namespace. */
367 extern int flag_iso;
369 /* Nonzero if -undef was given. It suppresses target built-in macros
370 and assertions. */
372 extern int flag_undef;
374 /* Nonzero means don't recognize the non-ANSI builtin functions. */
376 extern int flag_no_builtin;
378 /* Nonzero means don't recognize the non-ANSI builtin functions.
379 -ansi sets this. */
381 extern int flag_no_nonansi_builtin;
383 /* Nonzero means give `double' the same size as `float'. */
385 extern int flag_short_double;
387 /* Nonzero means give `wchar_t' the same size as `short'. */
389 extern int flag_short_wchar;
391 /* Nonzero means allow Microsoft extensions without warnings or errors. */
392 extern int flag_ms_extensions;
394 /* Nonzero means don't recognize the keyword `asm'. */
396 extern int flag_no_asm;
398 /* Nonzero means give string constants the type `const char *', as mandated
399 by the standard. */
401 extern int flag_const_strings;
403 /* Nonzero means to treat bitfields as signed unless they say `unsigned'. */
405 extern int flag_signed_bitfields;
407 /* Warn about #pragma directives that are not recognized. */
409 extern int warn_unknown_pragmas; /* Tri state variable. */
411 /* Warn about format/argument anomalies in calls to formatted I/O functions
412 (*printf, *scanf, strftime, strfmon, etc.). */
414 extern int warn_format;
417 /* C/ObjC language option variables. */
420 /* Nonzero means allow type mismatches in conditional expressions;
421 just make their values `void'. */
423 extern int flag_cond_mismatch;
425 /* Nonzero means enable C89 Amendment 1 features. */
427 extern int flag_isoc94;
429 /* Nonzero means use the ISO C99 dialect of C. */
431 extern int flag_isoc99;
433 /* Nonzero means that we have builtin functions, and main is an int. */
435 extern int flag_hosted;
437 /* Warn if main is suspicious. */
439 extern int warn_main;
442 /* ObjC language option variables. */
445 /* Open and close the file for outputting class declarations, if
446 requested (ObjC). */
448 extern int flag_gen_declaration;
450 /* Tells the compiler that this is a special run. Do not perform any
451 compiling, instead we are to test some platform dependent features
452 and output a C header file with appropriate definitions. */
454 extern int print_struct_values;
456 /* ???. Undocumented. */
458 extern const char *constant_string_class_name;
461 /* C++ language option variables. */
464 /* Nonzero means don't recognize any extension keywords. */
466 extern int flag_no_gnu_keywords;
468 /* Nonzero means do emit exported implementations of functions even if
469 they can be inlined. */
471 extern int flag_implement_inlines;
473 /* Nonzero means that implicit instantiations will be emitted if needed. */
475 extern int flag_implicit_templates;
477 /* Nonzero means that implicit instantiations of inline templates will be
478 emitted if needed, even if instantiations of non-inline templates
479 aren't. */
481 extern int flag_implicit_inline_templates;
483 /* Nonzero means generate separate instantiation control files and
484 juggle them at link time. */
486 extern int flag_use_repository;
488 /* Nonzero if we want to issue diagnostics that the standard says are not
489 required. */
491 extern int flag_optional_diags;
493 /* Nonzero means we should attempt to elide constructors when possible. */
495 extern int flag_elide_constructors;
497 /* Nonzero means that member functions defined in class scope are
498 inline by default. */
500 extern int flag_default_inline;
502 /* Controls whether compiler generates 'type descriptor' that give
503 run-time type information. */
505 extern int flag_rtti;
507 /* Nonzero if we want to conserve space in the .o files. We do this
508 by putting uninitialized data and runtime initialized data into
509 .common instead of .data at the expense of not flagging multiple
510 definitions. */
512 extern int flag_conserve_space;
514 /* Nonzero if we want to obey access control semantics. */
516 extern int flag_access_control;
518 /* Nonzero if we want to check the return value of new and avoid calling
519 constructors if it is a null pointer. */
521 extern int flag_check_new;
523 /* Nonzero if we want the new ISO rules for pushing a new scope for `for'
524 initialization variables.
525 0: Old rules, set by -fno-for-scope.
526 2: New ISO rules, set by -ffor-scope.
527 1: Try to implement new ISO rules, but with backup compatibility
528 (and warnings). This is the default, for now. */
530 extern int flag_new_for_scope;
532 /* Nonzero if we want to emit defined symbols with common-like linkage as
533 weak symbols where possible, in order to conform to C++ semantics.
534 Otherwise, emit them as local symbols. */
536 extern int flag_weak;
538 /* 0 means we want the preprocessor to not emit line directives for
539 the current working directory. 1 means we want it to do it. -1
540 means we should decide depending on whether debugging information
541 is being emitted or not. */
543 extern int flag_working_directory;
545 /* Nonzero to use __cxa_atexit, rather than atexit, to register
546 destructors for local statics and global objects. */
548 extern int flag_use_cxa_atexit;
550 /* Nonzero to use __cxa_get_exception_ptr in the C++ exception-handling
551 logic. */
553 extern int flag_use_cxa_get_exception_ptr;
555 /* Nonzero means make the default pedwarns warnings instead of errors.
556 The value of this flag is ignored if -pedantic is specified. */
558 extern int flag_permissive;
560 /* Nonzero means to implement standard semantics for exception
561 specifications, calling unexpected if an exception is thrown that
562 doesn't match the specification. Zero means to treat them as
563 assertions and optimize accordingly, but not check them. */
565 extern int flag_enforce_eh_specs;
567 /* Nonzero (the default) means to generate thread-safe code for
568 initializing local statics. */
570 extern int flag_threadsafe_statics;
572 /* Nonzero means warn about implicit declarations. */
574 extern int warn_implicit;
576 /* Warn about using __null (as NULL in C++) as sentinel. For code compiled
577 with GCC this doesn't matter as __null is guaranteed to have the right
578 size. */
580 extern int warn_strict_null_sentinel;
582 /* Maximum template instantiation depth. This limit is rather
583 arbitrary, but it exists to limit the time it takes to notice
584 infinite template instantiations. */
586 extern int max_tinst_depth;
588 /* Nonzero means the expression being parsed will never be evaluated.
589 This is a count, since unevaluated expressions can nest. */
591 extern int skip_evaluation;
593 /* C types are partitioned into three subsets: object, function, and
594 incomplete types. */
595 #define C_TYPE_OBJECT_P(type) \
596 (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
598 #define C_TYPE_INCOMPLETE_P(type) \
599 (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
601 #define C_TYPE_FUNCTION_P(type) \
602 (TREE_CODE (type) == FUNCTION_TYPE)
604 /* For convenience we define a single macro to identify the class of
605 object or incomplete types. */
606 #define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
607 (!C_TYPE_FUNCTION_P (type))
609 /* Attribute table common to the C front ends. */
610 extern const struct attribute_spec c_common_attribute_table[];
611 extern const struct attribute_spec c_common_format_attribute_table[];
613 /* Pointer to function to lazily generate the VAR_DECL for __FUNCTION__ etc.
614 ID is the identifier to use, NAME is the string.
615 TYPE_DEP indicates whether it depends on type of the function or not
616 (i.e. __PRETTY_FUNCTION__). */
618 extern tree (*make_fname_decl) (tree, int);
620 extern tree identifier_global_value (tree);
621 extern void record_builtin_type (enum rid, const char *, tree);
622 extern tree build_void_list_node (void);
623 extern void start_fname_decls (void);
624 extern void finish_fname_decls (void);
625 extern const char *fname_as_string (int);
626 extern tree fname_decl (unsigned, tree);
628 extern void check_function_arguments (tree, tree, tree);
629 extern void check_function_arguments_recurse (void (*)
630 (void *, tree,
631 unsigned HOST_WIDE_INT),
632 void *, tree,
633 unsigned HOST_WIDE_INT);
634 extern void check_function_format (tree, tree);
635 extern void set_Wformat (int);
636 extern tree handle_format_attribute (tree *, tree, tree, int, bool *);
637 extern tree handle_format_arg_attribute (tree *, tree, tree, int, bool *);
638 extern int c_common_handle_option (size_t code, const char *arg, int value);
639 extern bool c_common_missing_argument (const char *opt, size_t code);
640 extern tree c_common_type_for_mode (enum machine_mode, int);
641 extern tree c_common_type_for_size (unsigned int, int);
642 extern tree c_common_unsigned_type (tree);
643 extern tree c_common_signed_type (tree);
644 extern tree c_common_signed_or_unsigned_type (int, tree);
645 extern tree c_build_bitfield_integer_type (unsigned HOST_WIDE_INT, int);
646 extern tree c_common_truthvalue_conversion (tree);
647 extern void c_apply_type_quals_to_decl (int, tree);
648 extern tree c_sizeof_or_alignof_type (tree, bool, int);
649 extern tree c_alignof_expr (tree);
650 /* Print an error message for invalid operands to arith operation CODE.
651 NOP_EXPR is used as a special case (see truthvalue_conversion). */
652 extern void binary_op_error (enum tree_code);
653 extern tree fix_string_type (tree);
654 struct varray_head_tag;
655 extern void constant_expression_warning (tree);
656 extern void strict_aliasing_warning(tree, tree, tree);
657 extern void empty_body_warning (tree, tree);
658 extern tree convert_and_check (tree, tree);
659 extern void overflow_warning (tree);
660 extern bool c_determine_visibility (tree);
661 extern bool same_scalar_type_ignoring_signedness (tree, tree);
663 #define c_sizeof(T) c_sizeof_or_alignof_type (T, true, 1)
664 #define c_alignof(T) c_sizeof_or_alignof_type (T, false, 1)
666 /* Subroutine of build_binary_op, used for comparison operations.
667 See if the operands have both been converted from subword integer types
668 and, if so, perhaps change them both back to their original type. */
669 extern tree shorten_compare (tree *, tree *, tree *, enum tree_code *);
671 extern tree pointer_int_sum (enum tree_code, tree, tree);
672 extern unsigned int min_precision (tree, int);
674 /* Add qualifiers to a type, in the fashion for C. */
675 extern tree c_build_qualified_type (tree, int);
677 /* Build tree nodes and builtin functions common to both C and C++ language
678 frontends. */
679 extern void c_common_nodes_and_builtins (void);
681 extern void set_builtin_user_assembler_name (tree decl, const char *asmspec);
683 extern void disable_builtin_function (const char *);
685 extern void set_compound_literal_name (tree decl);
687 extern tree build_va_arg (tree, tree);
689 extern unsigned int c_common_init_options (unsigned int, const char **);
690 extern bool c_common_post_options (const char **);
691 extern bool c_common_init (void);
692 extern void c_common_finish (void);
693 extern void c_common_parse_file (int);
694 extern HOST_WIDE_INT c_common_get_alias_set (tree);
695 extern void c_register_builtin_type (tree, const char*);
696 extern bool c_promoting_integer_type_p (tree);
697 extern int self_promoting_args_p (tree);
698 extern tree strip_array_types (tree);
699 extern tree strip_pointer_operator (tree);
700 extern HOST_WIDE_INT c_common_to_target_charset (HOST_WIDE_INT);
702 /* This is the basic parsing function. */
703 extern void c_parse_file (void);
704 /* This is misnamed, it actually performs end-of-compilation processing. */
705 extern void finish_file (void);
708 /* These macros provide convenient access to the various _STMT nodes. */
710 /* Nonzero if a given STATEMENT_LIST represents the outermost binding
711 if a statement expression. */
712 #define STATEMENT_LIST_STMT_EXPR(NODE) \
713 TREE_LANG_FLAG_1 (STATEMENT_LIST_CHECK (NODE))
715 /* Nonzero if a label has been added to the statement list. */
716 #define STATEMENT_LIST_HAS_LABEL(NODE) \
717 TREE_LANG_FLAG_3 (STATEMENT_LIST_CHECK (NODE))
719 /* COMPOUND_LITERAL_EXPR accessors. */
720 #define COMPOUND_LITERAL_EXPR_DECL_STMT(NODE) \
721 TREE_OPERAND (COMPOUND_LITERAL_EXPR_CHECK (NODE), 0)
722 #define COMPOUND_LITERAL_EXPR_DECL(NODE) \
723 DECL_EXPR_DECL (COMPOUND_LITERAL_EXPR_DECL_STMT (NODE))
725 #define DEFTREECODE(SYM, NAME, TYPE, LENGTH) SYM,
727 enum c_tree_code {
728 C_DUMMY_TREE_CODE = LAST_AND_UNUSED_TREE_CODE,
729 #include "c-common.def"
730 LAST_C_TREE_CODE
733 #undef DEFTREECODE
735 extern int anon_aggr_type_p (tree);
737 /* For a VAR_DECL that is an anonymous union, these are the various
738 sub-variables that make up the anonymous union. */
739 #define DECL_ANON_UNION_ELEMS(NODE) DECL_ARGUMENTS ((NODE))
741 /* In a FIELD_DECL, nonzero if the decl was originally a bitfield. */
742 #define DECL_C_BIT_FIELD(NODE) \
743 (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) == 1)
744 #define SET_DECL_C_BIT_FIELD(NODE) \
745 (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 1)
746 #define CLEAR_DECL_C_BIT_FIELD(NODE) \
747 (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 0)
749 extern void emit_local_var (tree);
750 extern tree do_case (tree, tree);
751 extern tree build_stmt (enum tree_code, ...);
752 extern tree build_case_label (tree, tree, tree);
754 /* These functions must be defined by each front-end which implements
755 a variant of the C language. They are used in c-common.c. */
757 extern tree build_unary_op (enum tree_code, tree, int);
758 extern tree build_binary_op (enum tree_code, tree, tree, int);
759 extern tree perform_integral_promotions (tree);
761 /* These functions must be defined by each front-end which implements
762 a variant of the C language. They are used by port files. */
764 extern tree default_conversion (tree);
766 /* Given two integer or real types, return the type for their sum.
767 Given two compatible ANSI C types, returns the merged type. */
769 extern tree common_type (tree, tree);
771 extern tree decl_constant_value (tree);
773 /* Handle increment and decrement of boolean types. */
774 extern tree boolean_increment (enum tree_code, tree);
776 extern int case_compare (splay_tree_key, splay_tree_key);
778 extern tree c_add_case_label (splay_tree, tree, tree, tree, tree);
780 extern void c_do_switch_warnings (splay_tree, location_t, tree, tree);
782 extern tree build_function_call (tree, tree);
784 extern tree resolve_overloaded_builtin (tree, tree);
786 extern tree finish_label_address_expr (tree);
788 /* Same function prototype, but the C and C++ front ends have
789 different implementations. Used in c-common.c. */
790 extern tree lookup_label (tree);
791 extern tree lookup_name (tree);
793 extern int vector_types_convertible_p (tree t1, tree t2);
795 extern rtx c_expand_expr (tree, rtx, enum machine_mode, int, rtx *);
797 extern tree c_staticp (tree);
799 extern void init_c_lex (void);
801 extern void c_cpp_builtins (cpp_reader *);
803 /* Positive if an implicit `extern "C"' scope has just been entered;
804 negative if such a scope has just been exited. */
805 extern GTY(()) int pending_lang_change;
807 /* Information recorded about each file examined during compilation. */
809 struct c_fileinfo
811 int time; /* Time spent in the file. */
813 /* Flags used only by C++.
814 INTERFACE_ONLY nonzero means that we are in an "interface" section
815 of the compiler. INTERFACE_UNKNOWN nonzero means we cannot trust
816 the value of INTERFACE_ONLY. If INTERFACE_UNKNOWN is zero and
817 INTERFACE_ONLY is zero, it means that we are responsible for
818 exporting definitions that others might need. */
819 short interface_only;
820 short interface_unknown;
823 struct c_fileinfo *get_fileinfo (const char *);
824 extern void dump_time_statistics (void);
826 extern bool c_dump_tree (void *, tree);
828 extern void c_warn_unused_result (tree *);
830 extern void verify_sequence_points (tree);
832 extern tree fold_offsetof (tree, tree);
834 /* Places where an lvalue, or modifiable lvalue, may be required.
835 Used to select diagnostic messages in lvalue_error and
836 readonly_error. */
837 enum lvalue_use {
838 lv_assign,
839 lv_increment,
840 lv_decrement,
841 lv_addressof,
842 lv_asm
845 extern void lvalue_error (enum lvalue_use);
847 extern int complete_array_type (tree *, tree, bool);
849 extern tree builtin_type_for_size (int, bool);
851 extern void warn_array_subscript_with_type_char (tree);
853 /* In c-gimplify.c */
854 extern void c_genericize (tree);
855 extern int c_gimplify_expr (tree *, tree *, tree *);
856 extern tree c_build_bind_expr (tree, tree);
858 /* In c-pch.c */
859 extern void pch_init (void);
860 extern int c_common_valid_pch (cpp_reader *pfile, const char *name, int fd);
861 extern void c_common_read_pch (cpp_reader *pfile, const char *name, int fd,
862 const char *orig);
863 extern void c_common_write_pch (void);
864 extern void c_common_no_more_pch (void);
865 extern void c_common_pch_pragma (cpp_reader *pfile, const char *);
866 extern void c_common_print_pch_checksum (FILE *f);
868 /* In *-checksum.c */
869 extern const unsigned char executable_checksum[16];
871 extern void builtin_define_with_value (const char *, const char *, int);
872 extern void c_stddef_cpp_builtins (void);
873 extern void fe_file_change (const struct line_map *);
874 extern void c_parse_error (const char *, enum cpp_ttype, tree);
876 /* Objective-C / Objective-C++ entry points. */
878 /* The following ObjC/ObjC++ functions are called by the C and/or C++
879 front-ends; they all must have corresponding stubs in stub-objc.c. */
880 extern tree objc_is_class_name (tree);
881 extern tree objc_is_object_ptr (tree);
882 extern void objc_check_decl (tree);
883 extern int objc_is_reserved_word (tree);
884 extern bool objc_compare_types (tree, tree, int, tree);
885 extern void objc_volatilize_decl (tree);
886 extern bool objc_type_quals_match (tree, tree);
887 extern tree objc_rewrite_function_call (tree, tree);
888 extern tree objc_message_selector (void);
889 extern tree objc_lookup_ivar (tree, tree);
890 extern void objc_clear_super_receiver (void);
891 extern int objc_is_public (tree, tree);
892 extern tree objc_is_id (tree);
893 extern void objc_declare_alias (tree, tree);
894 extern void objc_declare_class (tree);
895 extern void objc_declare_protocols (tree);
896 extern tree objc_build_message_expr (tree);
897 extern tree objc_finish_message_expr (tree, tree, tree);
898 extern tree objc_build_selector_expr (tree);
899 extern tree objc_build_protocol_expr (tree);
900 extern tree objc_build_encode_expr (tree);
901 extern tree objc_build_string_object (tree);
902 extern tree objc_get_protocol_qualified_type (tree, tree);
903 extern tree objc_get_class_reference (tree);
904 extern tree objc_get_class_ivars (tree);
905 extern void objc_start_class_interface (tree, tree, tree);
906 extern void objc_start_category_interface (tree, tree, tree);
907 extern void objc_start_protocol (tree, tree);
908 extern void objc_continue_interface (void);
909 extern void objc_finish_interface (void);
910 extern void objc_start_class_implementation (tree, tree);
911 extern void objc_start_category_implementation (tree, tree);
912 extern void objc_continue_implementation (void);
913 extern void objc_finish_implementation (void);
914 extern void objc_set_visibility (int);
915 extern void objc_set_method_type (enum tree_code);
916 extern tree objc_build_method_signature (tree, tree, tree, bool);
917 extern void objc_add_method_declaration (tree);
918 extern void objc_start_method_definition (tree);
919 extern void objc_finish_method_definition (tree);
920 extern void objc_add_instance_variable (tree);
921 extern tree objc_build_keyword_decl (tree, tree, tree);
922 extern tree objc_build_throw_stmt (tree);
923 extern void objc_begin_try_stmt (location_t, tree);
924 extern tree objc_finish_try_stmt (void);
925 extern void objc_begin_catch_clause (tree);
926 extern void objc_finish_catch_clause (void);
927 extern void objc_build_finally_clause (location_t, tree);
928 extern tree objc_build_synchronized (location_t, tree, tree);
929 extern int objc_static_init_needed_p (void);
930 extern tree objc_generate_static_init_call (tree);
931 extern tree objc_generate_write_barrier (tree, enum tree_code, tree);
933 /* The following are provided by the C and C++ front-ends, and called by
934 ObjC/ObjC++. */
935 extern void *objc_get_current_scope (void);
936 extern void objc_mark_locals_volatile (void *);
938 /* In c-ppoutput.c */
939 extern void init_pp_output (FILE *);
940 extern void preprocess_file (cpp_reader *);
941 extern void pp_file_change (const struct line_map *);
942 extern void pp_dir_change (cpp_reader *, const char *);
943 extern bool check_missing_format_attribute (tree, tree);
945 /* In c-omp.c */
946 extern tree c_finish_omp_master (tree);
947 extern tree c_finish_omp_critical (tree, tree);
948 extern tree c_finish_omp_ordered (tree);
949 extern void c_finish_omp_barrier (void);
950 extern tree c_finish_omp_atomic (enum tree_code, tree, tree);
951 extern void c_finish_omp_flush (void);
952 extern tree c_finish_omp_for (location_t, tree, tree, tree, tree, tree, tree);
953 extern void c_split_parallel_clauses (tree, tree *, tree *);
954 extern enum omp_clause_default_kind c_omp_predetermined_sharing (tree);
956 /* Not in c-omp.c; provided by the front end. */
957 extern bool c_omp_sharing_predetermined (tree);
958 extern tree c_omp_remap_decl (tree, bool);
960 /* In order for the format checking to accept the C frontend
961 diagnostic framework extensions, you must include this file before
962 toplev.h, not after. The C front end formats are a subset of those
963 for C++, so they are the appropriate set to use in common code;
964 cp-tree.h overrides this for C++. */
965 #ifndef GCC_DIAG_STYLE
966 #define GCC_DIAG_STYLE __gcc_cdiag__
967 #endif
969 #endif /* ! GCC_C_COMMON_H */