c-tree.h (C_DECL_USED, [...]): New.
[gcc.git] / gcc / c-tree.h
1 /* Definitions for C parsing and type checking.
2 Copyright (C) 1987, 1993, 1994, 1995, 1997, 1998,
3 1999, 2000, 2001, 2002, 2003, 2004 Free Software Foundation, Inc.
4
5 This file is part of GCC.
6
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 2, or (at your option) any later
10 version.
11
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.
16
17 You should have received a copy of the GNU General Public License
18 along with GCC; see the file COPYING. If not, write to the Free
19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
20 02111-1307, USA. */
21
22 #ifndef GCC_C_TREE_H
23 #define GCC_C_TREE_H
24
25 #include "c-common.h"
26 #include "diagnostic.h"
27
28 /* struct lang_identifier is private to c-decl.c, but langhooks.c needs to
29 know how big it is. This is sanity-checked in c-decl.c. */
30 #define C_SIZEOF_STRUCT_LANG_IDENTIFIER \
31 (sizeof (struct c_common_identifier) + 3 * sizeof (void *))
32
33 /* For gc purposes, return the most likely link for the longest chain. */
34 #define C_LANG_TREE_NODE_CHAIN_NEXT(T) \
35 ((union lang_tree_node *) \
36 (TREE_CODE (T) == INTEGER_TYPE ? TYPE_NEXT_VARIANT (T) \
37 : TREE_CODE (T) == COMPOUND_EXPR ? TREE_OPERAND (T, 1) \
38 : TREE_CHAIN (T)))
39
40 /* Language-specific declaration information. */
41
42 struct lang_decl GTY(())
43 {
44 /* The return types and parameter types may have variable size.
45 This is a list of any SAVE_EXPRs that need to be evaluated to
46 compute those sizes. */
47 tree pending_sizes;
48 };
49
50 /* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is read-only. */
51 #define C_TYPE_FIELDS_READONLY(TYPE) TREE_LANG_FLAG_1 (TYPE)
52
53 /* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is volatile. */
54 #define C_TYPE_FIELDS_VOLATILE(TYPE) TREE_LANG_FLAG_2 (TYPE)
55
56 /* In a RECORD_TYPE or UNION_TYPE or ENUMERAL_TYPE
57 nonzero if the definition of the type has already started. */
58 #define C_TYPE_BEING_DEFINED(TYPE) TYPE_LANG_FLAG_0 (TYPE)
59
60 /* In an incomplete RECORD_TYPE or UNION_TYPE, a list of variable
61 declarations whose type would be completed by completing that type. */
62 #define C_TYPE_INCOMPLETE_VARS(TYPE) TYPE_VFIELD (TYPE)
63
64 /* In an IDENTIFIER_NODE, nonzero if this identifier is actually a
65 keyword. C_RID_CODE (node) is then the RID_* value of the keyword,
66 and C_RID_YYCODE is the token number wanted by Yacc. */
67 #define C_IS_RESERVED_WORD(ID) TREE_LANG_FLAG_0 (ID)
68
69 struct lang_type GTY(())
70 {
71 /* In a RECORD_TYPE, a sorted array of the fields of the type. */
72 struct sorted_fields_type * GTY ((reorder ("resort_sorted_fields"))) s;
73 /* In an ENUMERAL_TYPE, the min and max values. */
74 tree enum_min;
75 tree enum_max;
76 };
77
78 /* Record whether a type or decl was written with nonconstant size.
79 Note that TYPE_SIZE may have simplified to a constant. */
80 #define C_TYPE_VARIABLE_SIZE(TYPE) TYPE_LANG_FLAG_1 (TYPE)
81 #define C_DECL_VARIABLE_SIZE(TYPE) DECL_LANG_FLAG_0 (TYPE)
82
83 /* Record whether a typedef for type `int' was actually `signed int'. */
84 #define C_TYPEDEF_EXPLICITLY_SIGNED(EXP) DECL_LANG_FLAG_1 (EXP)
85
86 /* For a FUNCTION_DECL, nonzero if it was defined without an explicit
87 return type. */
88 #define C_FUNCTION_IMPLICIT_INT(EXP) DECL_LANG_FLAG_1 (EXP)
89
90 /* For a FUNCTION_DECL, nonzero if it was an implicit declaration. */
91 #define C_DECL_IMPLICIT(EXP) DECL_LANG_FLAG_2 (EXP)
92
93 /* For FUNCTION_DECLs, evaluates true if the decl is built-in but has
94 been declared. */
95 #define C_DECL_DECLARED_BUILTIN(EXP) DECL_LANG_FLAG_3 (EXP)
96
97 /* Record whether a decl was declared register. This is strictly a
98 front-end flag, whereas DECL_REGISTER is used for code generation;
99 they may differ for structures with volatile fields. */
100 #define C_DECL_REGISTER(EXP) DECL_LANG_FLAG_4 (EXP)
101
102 /* Record whether a decl was used in an expression anywhere except an
103 unevaluated operand of sizeof / typeof / alignof. This is only
104 used for functions declared static but not defined, though outside
105 sizeof and typeof it is set for other function decls as well. */
106 #define C_DECL_USED(EXP) DECL_LANG_FLAG_5 (EXP)
107
108 /* Nonzero for a decl which either doesn't exist or isn't a prototype.
109 N.B. Could be simplified if all built-in decls had complete prototypes
110 (but this is presently difficult because some of them need FILE*). */
111 #define C_DECL_ISNT_PROTOTYPE(EXP) \
112 (EXP == 0 \
113 || (TYPE_ARG_TYPES (TREE_TYPE (EXP)) == 0 \
114 && !DECL_BUILT_IN (EXP)))
115
116 /* For FUNCTION_TYPE, a hidden list of types of arguments. The same as
117 TYPE_ARG_TYPES for functions with prototypes, but created for functions
118 without prototypes. */
119 #define TYPE_ACTUAL_ARG_TYPES(NODE) TYPE_LANG_SLOT_1 (NODE)
120
121 /* Record parser information about an expression that is irrelevant
122 for code generation alongside a tree representing its value. */
123 struct c_expr
124 {
125 /* The value of the expression. */
126 tree value;
127 /* Record the original binary operator of an expression, which may
128 have been changed by fold, STRING_CST for unparenthesised string
129 constants, or ERROR_MARK for other expressions (including
130 parenthesized expressions). */
131 enum tree_code original_code;
132 };
133
134 /* Save and restore the variables in this file and elsewhere
135 that keep track of the progress of compilation of the current function.
136 Used for nested functions. */
137
138 struct language_function GTY(())
139 {
140 struct c_language_function base;
141 tree x_break_label;
142 tree x_cont_label;
143 struct c_switch * GTY((skip)) x_switch_stack;
144 tree arg_info;
145 int returns_value;
146 int returns_null;
147 int returns_abnormally;
148 int warn_about_return_type;
149 int extern_inline;
150 };
151
152 \f
153 /* in c-parse.in */
154 extern void c_parse_init (void);
155
156 /* in c-aux-info.c */
157 extern void gen_aux_info_record (tree, int, int, int);
158
159 /* in c-decl.c */
160 extern struct obstack parser_obstack;
161 extern tree c_break_label;
162 extern tree c_cont_label;
163
164 extern int global_bindings_p (void);
165 extern void push_scope (void);
166 extern tree pop_scope (void);
167 extern void insert_block (tree);
168 extern tree pushdecl (tree);
169 extern void c_expand_body (tree);
170
171 extern void c_init_decl_processing (void);
172 extern void c_dup_lang_specific_decl (tree);
173 extern void c_print_identifier (FILE *, tree, int);
174 extern tree build_array_declarator (tree, tree, bool, bool);
175 extern tree build_enumerator (tree, tree);
176 extern void check_for_loop_decls (void);
177 extern void mark_forward_parm_decls (void);
178 extern int complete_array_type (tree, tree, int);
179 extern void declare_parm_level (void);
180 extern void undeclared_variable (tree);
181 extern tree declare_label (tree);
182 extern tree define_label (location_t, tree);
183 extern void finish_decl (tree, tree, tree);
184 extern tree finish_enum (tree, tree, tree);
185 extern void finish_function (void);
186 extern tree finish_struct (tree, tree, tree);
187 extern tree get_parm_info (bool);
188 extern tree grokfield (tree, tree, tree);
189 extern void split_specs_attrs (tree, tree *, tree *);
190 extern tree groktypename (tree);
191 extern tree grokparm (tree);
192 extern tree implicitly_declare (tree);
193 extern void keep_next_level (void);
194 extern tree lookup_name (tree);
195 extern void pending_xref_error (void);
196 extern void c_push_function_context (struct function *);
197 extern void c_pop_function_context (struct function *);
198 extern void push_parm_decl (tree);
199 extern tree pushdecl_top_level (tree);
200 extern tree set_array_declarator_inner (tree, tree, bool);
201 extern tree builtin_function (const char *, tree, int, enum built_in_class,
202 const char *, tree);
203 extern void shadow_tag (tree);
204 extern void shadow_tag_warned (tree, int);
205 extern tree start_enum (tree);
206 extern int start_function (tree, tree, tree);
207 extern tree start_decl (tree, tree, bool, tree);
208 extern tree start_struct (enum tree_code, tree);
209 extern void store_parm_decls (void);
210 extern void store_parm_decls_from (tree);
211 extern tree xref_tag (enum tree_code, tree);
212 extern int c_expand_decl (tree);
213 extern tree build_c_parm (tree, tree, tree);
214 extern tree build_attrs_declarator (tree, tree);
215 extern tree build_function_declarator (tree, tree);
216 extern tree make_pointer_declarator (tree, tree);
217
218 /* in c-objc-common.c */
219 extern int c_disregard_inline_limits (tree);
220 extern int c_cannot_inline_tree_fn (tree *);
221 extern bool c_objc_common_init (void);
222 extern bool c_missing_noreturn_ok_p (tree);
223 extern tree c_objc_common_truthvalue_conversion (tree expr);
224 extern int defer_fn (tree);
225 extern bool c_warn_unused_global_decl (tree);
226 extern void c_initialize_diagnostics (diagnostic_context *);
227
228 #define c_build_type_variant(TYPE, CONST_P, VOLATILE_P) \
229 c_build_qualified_type ((TYPE), \
230 ((CONST_P) ? TYPE_QUAL_CONST : 0) | \
231 ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
232
233 /* in c-typeck.c */
234 extern int in_alignof;
235 extern int in_sizeof;
236 extern int in_typeof;
237
238 extern struct c_switch *c_switch_stack;
239
240 extern tree require_complete_type (tree);
241 extern int same_translation_unit_p (tree, tree);
242 extern int comptypes (tree, tree);
243 extern tree c_size_in_bytes (tree);
244 extern bool c_mark_addressable (tree);
245 extern void c_incomplete_type_error (tree, tree);
246 extern tree c_type_promotes_to (tree);
247 extern tree composite_type (tree, tree);
248 extern tree build_component_ref (tree, tree);
249 extern tree build_indirect_ref (tree, const char *);
250 extern tree build_array_ref (tree, tree);
251 extern tree build_external_ref (tree, int);
252 extern void record_maybe_used_decl (tree);
253 extern void pop_maybe_used (bool);
254 extern struct c_expr c_expr_sizeof_expr (struct c_expr);
255 extern struct c_expr c_expr_sizeof_type (tree);
256 extern struct c_expr parser_build_binary_op (enum tree_code, struct c_expr,
257 struct c_expr);
258 extern void readonly_error (tree, const char *);
259 extern tree build_conditional_expr (tree, tree, tree);
260 extern tree build_compound_expr (tree, tree);
261 extern tree c_cast_expr (tree, tree);
262 extern tree build_c_cast (tree, tree);
263 extern tree build_modify_expr (tree, enum tree_code, tree);
264 extern void store_init_value (tree, tree);
265 extern void error_init (const char *);
266 extern void pedwarn_init (const char *);
267 extern void maybe_warn_string_init (tree, struct c_expr);
268 extern void start_init (tree, tree, int);
269 extern void finish_init (void);
270 extern void really_start_incremental_init (tree);
271 extern void push_init_level (int);
272 extern struct c_expr pop_init_level (int);
273 extern void set_init_index (tree, tree);
274 extern void set_init_label (tree);
275 extern void process_init_element (struct c_expr);
276 extern tree build_compound_literal (tree, tree);
277 extern void pedwarn_c90 (const char *, ...) ATTRIBUTE_PRINTF_1;
278 extern void pedwarn_c99 (const char *, ...) ATTRIBUTE_PRINTF_1;
279 extern tree c_start_case (tree);
280 extern void c_finish_case (tree);
281 extern tree build_asm_expr (tree, tree, tree, tree, bool);
282 extern tree build_asm_stmt (tree, tree);
283 extern tree c_convert_parm_for_inlining (tree, tree, tree, int);
284 extern int c_types_compatible_p (tree, tree);
285 extern tree c_begin_compound_stmt (bool);
286 extern tree c_end_compound_stmt (tree, bool);
287 extern void c_finish_if_stmt (location_t, tree, tree, tree, bool);
288 extern void c_finish_loop (location_t, tree, tree, tree, tree, tree, bool);
289 extern tree c_begin_stmt_expr (void);
290 extern tree c_finish_stmt_expr (tree);
291 extern tree c_process_expr_stmt (tree);
292 extern tree c_finish_expr_stmt (tree);
293 extern tree c_finish_return (tree);
294 extern tree c_finish_bc_stmt (tree *, bool);
295 extern tree c_finish_goto_label (tree);
296 extern tree c_finish_goto_ptr (tree);
297
298 /* Set to 0 at beginning of a function definition, set to 1 if
299 a return statement that specifies a return value is seen. */
300
301 extern int current_function_returns_value;
302
303 /* Set to 0 at beginning of a function definition, set to 1 if
304 a return statement with no argument is seen. */
305
306 extern int current_function_returns_null;
307
308 /* Set to 0 at beginning of a function definition, set to 1 if
309 a call to a noreturn function is seen. */
310
311 extern int current_function_returns_abnormally;
312
313 /* Nonzero means we are reading code that came from a system header file. */
314
315 extern int system_header_p;
316
317 /* True means global_bindings_p should return false even if the scope stack
318 says we are in file scope. */
319
320 extern bool c_override_global_bindings_to_false;
321
322 /* True means we've initialized exception handling. */
323 extern bool c_eh_initialized_p;
324
325 /* In c-decl.c */
326 extern void c_finish_incomplete_decl (tree);
327 extern void c_write_global_declarations (void);
328
329 /* In order for the format checking to accept the C frontend
330 diagnostic framework extensions, you must include this file before
331 toplev.h, not after. */
332 #define GCC_DIAG_STYLE __gcc_cdiag__
333
334 #endif /* ! GCC_C_TREE_H */