* rtl.h (struct rtx_def): Update comments.
[official-gcc.git] / gcc / c-tree.h
blob8ed0b642b904b0e7e9676a9c492d79aa6b46e7a8
1 /* Definitions for C parsing and type checking.
2 Copyright (C) 1987, 1993, 1994, 1995, 1997, 1998,
3 1999, 2000, 2001, 2002 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 2, 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 COPYING. If not, write to the Free
19 Software Foundation, 59 Temple Place - Suite 330, Boston, MA
20 02111-1307, USA. */
22 #ifndef GCC_C_TREE_H
23 #define GCC_C_TREE_H
25 #include "c-common.h"
27 /* Language-dependent contents of an identifier. */
29 /* The limbo_value is used for block level extern declarations, which need
30 to be type checked against subsequent extern declarations. They can't
31 be referenced after they fall out of scope, so they can't be global.
33 The rid_code field is used for keywords. It is in all
34 lang_identifier nodes, because some keywords are only special in a
35 particular context. */
37 struct lang_identifier
39 struct c_common_identifier ignore;
40 tree global_value, local_value, label_value, implicit_decl;
41 tree error_locus, limbo_value;
44 /* Language-specific declaration information. */
46 struct lang_decl
48 struct c_lang_decl base;
49 /* The return types and parameter types may have variable size.
50 This is a list of any SAVE_EXPRs that need to be evaluated to
51 compute those sizes. */
52 tree pending_sizes;
55 /* Macros for access to language-specific slots in an identifier. */
56 /* Each of these slots contains a DECL node or null. */
58 /* This represents the value which the identifier has in the
59 file-scope namespace. */
60 #define IDENTIFIER_GLOBAL_VALUE(NODE) \
61 (((struct lang_identifier *) (NODE))->global_value)
62 /* This represents the value which the identifier has in the current
63 scope. */
64 #define IDENTIFIER_LOCAL_VALUE(NODE) \
65 (((struct lang_identifier *) (NODE))->local_value)
66 /* This represents the value which the identifier has as a label in
67 the current label scope. */
68 #define IDENTIFIER_LABEL_VALUE(NODE) \
69 (((struct lang_identifier *) (NODE))->label_value)
70 /* This records the extern decl of this identifier, if it has had one
71 at any point in this compilation. */
72 #define IDENTIFIER_LIMBO_VALUE(NODE) \
73 (((struct lang_identifier *) (NODE))->limbo_value)
74 /* This records the implicit function decl of this identifier, if it
75 has had one at any point in this compilation. */
76 #define IDENTIFIER_IMPLICIT_DECL(NODE) \
77 (((struct lang_identifier *) (NODE))->implicit_decl)
78 /* This is the last function in which we printed an "undefined variable"
79 message for this identifier. Value is a FUNCTION_DECL or null. */
80 #define IDENTIFIER_ERROR_LOCUS(NODE) \
81 (((struct lang_identifier *) (NODE))->error_locus)
83 /* In identifiers, C uses the following fields in a special way:
84 TREE_PUBLIC to record that there was a previous local extern decl.
85 TREE_USED to record that such a decl was used.
86 TREE_ADDRESSABLE to record that the address of such a decl was used. */
88 /* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is read-only. */
89 #define C_TYPE_FIELDS_READONLY(TYPE) TREE_LANG_FLAG_1 (TYPE)
91 /* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is volatile. */
92 #define C_TYPE_FIELDS_VOLATILE(TYPE) TREE_LANG_FLAG_2 (TYPE)
94 /* In a RECORD_TYPE or UNION_TYPE or ENUMERAL_TYPE
95 nonzero if the definition of the type has already started. */
96 #define C_TYPE_BEING_DEFINED(TYPE) TYPE_LANG_FLAG_0 (TYPE)
98 /* In an IDENTIFIER_NODE, nonzero if this identifier is actually a
99 keyword. C_RID_CODE (node) is then the RID_* value of the keyword,
100 and C_RID_YYCODE is the token number wanted by Yacc. */
101 #define C_IS_RESERVED_WORD(ID) TREE_LANG_FLAG_0 (ID)
103 /* This function was declared inline. This flag controls the linkage
104 semantics of 'inline'; whether or not the function is inlined is
105 controlled by DECL_INLINE. */
106 #define DECL_DECLARED_INLINE_P(NODE) \
107 (DECL_LANG_SPECIFIC (NODE)->base.declared_inline)
109 /* In a RECORD_TYPE, a sorted array of the fields of the type. */
110 struct lang_type
112 int len;
113 tree elts[1];
116 /* Record whether a type or decl was written with nonconstant size.
117 Note that TYPE_SIZE may have simplified to a constant. */
118 #define C_TYPE_VARIABLE_SIZE(TYPE) TYPE_LANG_FLAG_1 (TYPE)
119 #define C_DECL_VARIABLE_SIZE(TYPE) DECL_LANG_FLAG_0 (TYPE)
121 #if 0 /* Not used. */
122 /* Record whether a decl for a function or function pointer has
123 already been mentioned (in a warning) because it was called
124 but didn't have a prototype. */
125 #define C_MISSING_PROTOTYPE_WARNED(DECL) DECL_LANG_FLAG_2 (DECL)
126 #endif
128 /* Store a value in that field. */
129 #define C_SET_EXP_ORIGINAL_CODE(EXP, CODE) \
130 (TREE_COMPLEXITY (EXP) = (int) (CODE))
132 /* Record whether a typedef for type `int' was actually `signed int'. */
133 #define C_TYPEDEF_EXPLICITLY_SIGNED(EXP) DECL_LANG_FLAG_1 (EXP)
135 /* For a FUNCTION_DECL, nonzero if it was defined without an explicit
136 return type. */
137 #define C_FUNCTION_IMPLICIT_INT(EXP) DECL_LANG_FLAG_1 (EXP)
139 /* Nonzero for a declaration of a built in function if there has been no
140 occasion that would declare the function in ordinary C.
141 Using the function draws a pedantic warning in this case. */
142 #define C_DECL_ANTICIPATED(EXP) DECL_LANG_FLAG_3 (EXP)
144 /* For FUNCTION_TYPE, a hidden list of types of arguments. The same as
145 TYPE_ARG_TYPES for functions with prototypes, but created for functions
146 without prototypes. */
147 #define TYPE_ACTUAL_ARG_TYPES(NODE) TYPE_BINFO (NODE)
150 /* in c-lang.c and objc-act.c */
151 extern tree lookup_interface PARAMS ((tree));
152 extern tree is_class_name PARAMS ((tree));
153 extern void maybe_objc_check_decl PARAMS ((tree));
154 extern void finish_file PARAMS ((void));
155 extern int maybe_objc_comptypes PARAMS ((tree, tree, int));
156 extern tree maybe_building_objc_message_expr PARAMS ((void));
157 extern int recognize_objc_keyword PARAMS ((void));
158 extern tree lookup_objc_ivar PARAMS ((tree));
161 /* in c-parse.in */
162 extern void c_parse_init PARAMS ((void));
164 /* in c-aux-info.c */
165 extern void gen_aux_info_record PARAMS ((tree, int, int, int));
167 /* in c-decl.c */
168 extern int global_bindings_p PARAMS ((void));
169 extern int kept_level_p PARAMS ((void));
170 extern tree getdecls PARAMS ((void));
171 extern void pushlevel PARAMS ((int));
172 extern tree poplevel PARAMS ((int,int, int));
173 extern void insert_block PARAMS ((tree));
174 extern void set_block PARAMS ((tree));
175 extern tree pushdecl PARAMS ((tree));
177 extern void c_insert_default_attributes PARAMS ((tree));
178 extern void c_init_decl_processing PARAMS ((void));
179 extern void c_dup_lang_specific_decl PARAMS ((tree));
180 extern void c_print_identifier PARAMS ((FILE *, tree, int));
181 extern void c_mark_tree PARAMS ((tree));
182 extern tree build_array_declarator PARAMS ((tree, tree, int, int));
183 extern tree build_enumerator PARAMS ((tree, tree));
184 extern int c_decode_option PARAMS ((int, char **));
185 extern void c_mark_varargs PARAMS ((void));
186 extern void check_for_loop_decls PARAMS ((void));
187 extern void clear_parm_order PARAMS ((void));
188 extern int complete_array_type PARAMS ((tree, tree, int));
189 extern void declare_parm_level PARAMS ((int));
190 extern tree define_label PARAMS ((const char *, int,
191 tree));
192 extern void finish_decl PARAMS ((tree, tree, tree));
193 extern tree finish_enum PARAMS ((tree, tree, tree));
194 extern void finish_function PARAMS ((int, int));
195 extern tree finish_struct PARAMS ((tree, tree, tree));
196 extern tree get_parm_info PARAMS ((int));
197 extern tree grokfield PARAMS ((const char *, int, tree, tree, tree));
198 extern tree groktypename PARAMS ((tree));
199 extern tree groktypename_in_parm_context PARAMS ((tree));
200 extern tree implicitly_declare PARAMS ((tree));
201 extern void implicit_decl_warning PARAMS ((tree));
202 extern int in_parm_level_p PARAMS ((void));
203 extern void keep_next_level PARAMS ((void));
204 extern tree lookup_name PARAMS ((tree));
205 extern tree lookup_name_current_level PARAMS ((tree));
206 extern void parmlist_tags_warning PARAMS ((void));
207 extern void pending_xref_error PARAMS ((void));
208 extern void c_mark_function_context PARAMS ((struct function *));
209 extern void c_push_function_context PARAMS ((struct function *));
210 extern void c_pop_function_context PARAMS ((struct function *));
211 extern void pop_label_level PARAMS ((void));
212 extern void push_label_level PARAMS ((void));
213 extern void push_parm_decl PARAMS ((tree));
214 extern tree pushdecl_top_level PARAMS ((tree));
215 extern void pushtag PARAMS ((tree, tree));
216 extern tree set_array_declarator_type PARAMS ((tree, tree, int));
217 extern tree shadow_label PARAMS ((tree));
218 extern void shadow_tag PARAMS ((tree));
219 extern void shadow_tag_warned PARAMS ((tree, int));
220 extern tree start_enum PARAMS ((tree));
221 extern int start_function PARAMS ((tree, tree, tree));
222 extern tree start_decl PARAMS ((tree, tree, int,
223 tree));
224 extern tree start_struct PARAMS ((enum tree_code, tree));
225 extern void store_parm_decls PARAMS ((void));
226 extern tree xref_tag PARAMS ((enum tree_code, tree));
227 extern tree c_begin_compound_stmt PARAMS ((void));
228 extern void c_expand_deferred_function PARAMS ((tree));
229 extern void c_expand_decl_stmt PARAMS ((tree));
232 /* in c-objc-common.c */
233 extern int c_disregard_inline_limits PARAMS ((tree));
234 extern int c_cannot_inline_tree_fn PARAMS ((tree *));
235 extern const char *c_objc_common_init PARAMS ((const char *));
236 extern int c_missing_noreturn_ok_p PARAMS ((tree));
237 extern void c_objc_common_finish_file PARAMS ((void));
238 extern int defer_fn PARAMS ((tree));
239 extern bool c_warn_unused_global_decl PARAMS ((tree));
241 #define c_build_type_variant(TYPE, CONST_P, VOLATILE_P) \
242 c_build_qualified_type ((TYPE), \
243 ((CONST_P) ? TYPE_QUAL_CONST : 0) | \
244 ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
246 /* in c-typeck.c */
247 extern tree require_complete_type PARAMS ((tree));
248 extern int comptypes PARAMS ((tree, tree));
249 extern tree c_sizeof_nowarn PARAMS ((tree));
250 extern tree c_size_in_bytes PARAMS ((tree));
251 extern bool c_mark_addressable PARAMS ((tree));
252 extern void c_incomplete_type_error PARAMS ((tree, tree));
253 extern tree c_type_promotes_to PARAMS ((tree));
254 extern tree build_component_ref PARAMS ((tree, tree));
255 extern tree build_indirect_ref PARAMS ((tree, const char *));
256 extern tree build_array_ref PARAMS ((tree, tree));
257 extern tree build_external_ref PARAMS ((tree, int));
258 extern tree parser_build_binary_op PARAMS ((enum tree_code,
259 tree, tree));
260 extern void readonly_warning PARAMS ((tree, const char *));
261 extern tree build_conditional_expr PARAMS ((tree, tree, tree));
262 extern tree build_compound_expr PARAMS ((tree));
263 extern tree c_cast_expr PARAMS ((tree, tree));
264 extern tree build_c_cast PARAMS ((tree, tree));
265 extern tree build_modify_expr PARAMS ((tree, enum tree_code,
266 tree));
267 extern void store_init_value PARAMS ((tree, tree));
268 extern void error_init PARAMS ((const char *));
269 extern void pedwarn_init PARAMS ((const char *));
270 extern void start_init PARAMS ((tree, tree, int));
271 extern void finish_init PARAMS ((void));
272 extern void really_start_incremental_init PARAMS ((tree));
273 extern void push_init_level PARAMS ((int));
274 extern tree pop_init_level PARAMS ((int));
275 extern void set_init_index PARAMS ((tree, tree));
276 extern void set_init_label PARAMS ((tree));
277 extern void process_init_element PARAMS ((tree));
278 extern tree build_compound_literal PARAMS ((tree, tree));
279 extern void pedwarn_c99 PARAMS ((const char *, ...))
280 ATTRIBUTE_PRINTF_1;
281 extern tree c_start_case PARAMS ((tree));
282 extern void c_finish_case PARAMS ((void));
283 extern tree simple_asm_stmt PARAMS ((tree));
284 extern tree build_asm_stmt PARAMS ((tree, tree, tree,
285 tree, tree));
286 extern tree c_convert_parm_for_inlining PARAMS ((tree, tree, tree));
288 /* Set to 0 at beginning of a function definition, set to 1 if
289 a return statement that specifies a return value is seen. */
291 extern int current_function_returns_value;
293 /* Set to 0 at beginning of a function definition, set to 1 if
294 a return statement with no argument is seen. */
296 extern int current_function_returns_null;
298 /* Set to 0 at beginning of a function definition, set to 1 if
299 a call to a noreturn function is seen. */
301 extern int current_function_returns_abnormally;
303 /* Nonzero means the expression being parsed will never be evaluated.
304 This is a count, since unevaluated expressions can nest. */
306 extern int skip_evaluation;
308 /* Nonzero means `$' can be in an identifier. */
310 extern int dollars_in_ident;
312 /* Nonzero means allow type mismatches in conditional expressions;
313 just make their values `void'. */
315 extern int flag_cond_mismatch;
317 /* Nonzero means don't recognize the keyword `asm'. */
319 extern int flag_no_asm;
321 /* Nonzero means warn about implicit declarations. */
323 extern int warn_implicit;
325 /* Nonzero means warn for all old-style non-prototype function decls. */
327 extern int warn_strict_prototypes;
329 /* Nonzero means warn about multiple (redundant) decls for the same single
330 variable or function. */
332 extern int warn_redundant_decls;
334 /* Nonzero means warn about extern declarations of objects not at
335 file-scope level and about *all* declarations of functions (whether
336 extern or static) not at file-scope level. Note that we exclude
337 implicit function declarations. To get warnings about those, use
338 -Wimplicit. */
340 extern int warn_nested_externs;
342 /* Nonzero means warn about pointer casts that can drop a type qualifier
343 from the pointer target type. */
345 extern int warn_cast_qual;
347 /* Nonzero means warn when casting a function call to a type that does
348 not match the return type (e.g. (float)sqrt() or (anything*)malloc()
349 when there is no previous declaration of sqrt or malloc. */
351 extern int warn_bad_function_cast;
353 /* Warn about traditional constructs whose meanings changed in ANSI C. */
355 extern int warn_traditional;
357 /* Warn about a subscript that has type char. */
359 extern int warn_char_subscripts;
361 /* Warn if main is suspicious. */
363 extern int warn_main;
365 /* Warn if initializer is not completely bracketed. */
367 extern int warn_missing_braces;
369 /* Warn about comparison of signed and unsigned values. */
371 extern int warn_sign_compare;
373 /* Warn about testing equality of floating point numbers. */
375 extern int warn_float_equal;
377 /* Nonzero means we are reading code that came from a system header file. */
379 extern int system_header_p;
381 /* Warn about implicit declarations. 1 = warning, 2 = error. */
382 extern int mesg_implicit_function_declaration;
384 /* In c-decl.c */
385 extern void c_finish_incomplete_decl PARAMS ((tree));
387 extern tree static_ctors;
388 extern tree static_dtors;
390 #endif /* ! GCC_C_TREE_H */