* doc/gcc.texi, doc/install.texi, doc/invoke.texi: Remove trailing
[official-gcc.git] / gcc / c-tree.h
blob1ea096f88b29e7fd20fe22dae56fbcd094479218
1 /* Definitions for C parsing and type checking.
2 Copyright (C) 1987, 1993, 1994, 1995, 1997, 1998,
3 1999, 2000 Free Software Foundation, Inc.
5 This file is part of GNU CC.
7 GNU CC is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
12 GNU CC is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GNU CC; see the file COPYING. If not, write to
19 the Free Software Foundation, 59 Temple Place - Suite 330,
20 Boston, MA 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. */
102 #define C_IS_RESERVED_WORD(id) TREE_LANG_FLAG_0 (id)
104 /* In a RECORD_TYPE, a sorted array of the fields of the type. */
105 struct lang_type
107 int len;
108 tree elts[1];
111 /* Record whether a type or decl was written with nonconstant size.
112 Note that TYPE_SIZE may have simplified to a constant. */
113 #define C_TYPE_VARIABLE_SIZE(type) TYPE_LANG_FLAG_1 (type)
114 #define C_DECL_VARIABLE_SIZE(type) DECL_LANG_FLAG_0 (type)
116 #if 0 /* Not used. */
117 /* Record whether a decl for a function or function pointer has
118 already been mentioned (in a warning) because it was called
119 but didn't have a prototype. */
120 #define C_MISSING_PROTOTYPE_WARNED(decl) DECL_LANG_FLAG_2(decl)
121 #endif
123 /* Store a value in that field. */
124 #define C_SET_EXP_ORIGINAL_CODE(exp, code) \
125 (TREE_COMPLEXITY (exp) = (int) (code))
127 /* Record whether a typedef for type `int' was actually `signed int'. */
128 #define C_TYPEDEF_EXPLICITLY_SIGNED(exp) DECL_LANG_FLAG_1 ((exp))
130 /* Nonzero for a declaration of a built in function if there has been no
131 occasion that would declare the function in ordinary C.
132 Using the function draws a pedantic warning in this case. */
133 #define C_DECL_ANTICIPATED(exp) DECL_LANG_FLAG_3 ((exp))
135 /* For FUNCTION_TYPE, a hidden list of types of arguments. The same as
136 TYPE_ARG_TYPES for functions with prototypes, but created for functions
137 without prototypes. */
138 #define TYPE_ACTUAL_ARG_TYPES(NODE) TYPE_NONCOPIED_PARTS (NODE)
141 /* in c-lang.c and objc-act.c */
142 extern tree lookup_interface PARAMS ((tree));
143 extern tree is_class_name PARAMS ((tree));
144 extern void maybe_objc_check_decl PARAMS ((tree));
145 extern void finish_file PARAMS ((void));
146 extern int maybe_objc_comptypes PARAMS ((tree, tree, int));
147 extern tree maybe_building_objc_message_expr PARAMS ((void));
148 extern int recognize_objc_keyword PARAMS ((void));
149 extern tree lookup_objc_ivar PARAMS ((tree));
151 /* in c-parse.in */
152 extern void c_parse_init PARAMS ((void));
153 extern int yyparse_1 PARAMS ((void));
155 /* in c-aux-info.c */
156 extern void gen_aux_info_record PARAMS ((tree, int, int, int));
158 /* in c-decl.c */
159 extern tree build_array_declarator PARAMS ((tree, tree, int, int));
160 extern tree build_enumerator PARAMS ((tree, tree));
162 #define c_build_type_variant(TYPE, CONST_P, VOLATILE_P) \
163 c_build_qualified_type (TYPE, \
164 ((CONST_P) ? TYPE_QUAL_CONST : 0) | \
165 ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
166 extern int c_decode_option PARAMS ((int, char **));
167 extern void c_mark_varargs PARAMS ((void));
168 extern void check_for_loop_decls PARAMS ((void));
169 extern tree check_identifier PARAMS ((tree, tree));
170 extern void clear_parm_order PARAMS ((void));
171 extern tree combine_parm_decls PARAMS ((tree, tree, int));
172 extern int complete_array_type PARAMS ((tree, tree, int));
173 extern void declare_parm_level PARAMS ((int));
174 extern tree define_label PARAMS ((const char *, int,
175 tree));
176 extern void delete_block PARAMS ((tree));
177 extern void finish_decl PARAMS ((tree, tree, tree));
178 extern void finish_decl_top_level PARAMS ((tree, tree, tree));
179 extern tree finish_enum PARAMS ((tree, tree, tree));
180 extern void finish_function PARAMS ((int));
181 extern tree finish_struct PARAMS ((tree, tree, tree));
182 extern tree get_parm_info PARAMS ((int));
183 extern tree grokfield PARAMS ((const char *, int, tree, tree, tree));
184 extern tree groktypename PARAMS ((tree));
185 extern tree groktypename_in_parm_context PARAMS ((tree));
186 extern tree implicitly_declare PARAMS ((tree));
187 extern void implicit_decl_warning PARAMS ((tree));
188 extern int in_parm_level_p PARAMS ((void));
189 extern void keep_next_level PARAMS ((void));
190 extern int kept_level_p PARAMS ((void));
191 extern tree lookup_name PARAMS ((tree));
192 extern tree lookup_name_current_level PARAMS ((tree));
193 extern tree lookup_name_current_level_global PARAMS ((tree));
194 extern void parmlist_tags_warning PARAMS ((void));
195 extern void pending_xref_error PARAMS ((void));
196 extern void mark_c_function_context PARAMS ((struct function *));
197 extern void push_c_function_context PARAMS ((struct function *));
198 extern void pop_c_function_context PARAMS ((struct function *));
199 extern void pop_label_level PARAMS ((void));
200 extern void push_label_level PARAMS ((void));
201 extern void push_parm_decl PARAMS ((tree));
202 extern tree pushdecl_top_level PARAMS ((tree));
203 extern void pushtag PARAMS ((tree, tree));
204 extern tree set_array_declarator_type PARAMS ((tree, tree, int));
205 extern tree shadow_label PARAMS ((tree));
206 extern void shadow_record_fields PARAMS ((tree));
207 extern void shadow_tag PARAMS ((tree));
208 extern void shadow_tag_warned PARAMS ((tree, int));
209 extern tree start_enum PARAMS ((tree));
210 extern int start_function PARAMS ((tree, tree, tree,
211 tree));
212 extern tree start_decl PARAMS ((tree, tree, int,
213 tree, tree));
214 extern tree start_struct PARAMS ((enum tree_code, tree));
215 extern void store_parm_decls PARAMS ((void));
216 extern tree xref_tag PARAMS ((enum tree_code, tree));
217 extern tree c_begin_compound_stmt PARAMS ((void));
218 extern void c_expand_decl_stmt PARAMS ((tree));
220 /* in c-typeck.c */
221 extern tree require_complete_type PARAMS ((tree));
222 extern int comptypes PARAMS ((tree, tree));
223 extern tree c_sizeof PARAMS ((tree));
224 extern tree c_sizeof_nowarn PARAMS ((tree));
225 extern tree c_size_in_bytes PARAMS ((tree));
226 extern tree c_alignof PARAMS ((tree));
227 extern tree c_alignof_expr PARAMS ((tree));
228 extern tree build_component_ref PARAMS ((tree, tree));
229 extern tree build_indirect_ref PARAMS ((tree, const char *));
230 extern tree build_array_ref PARAMS ((tree, tree));
231 extern tree build_external_ref PARAMS ((tree, int));
232 extern tree parser_build_binary_op PARAMS ((enum tree_code,
233 tree, tree));
234 extern void readonly_warning PARAMS ((tree, const char *));
235 extern tree build_conditional_expr PARAMS ((tree, tree, tree));
236 extern tree build_compound_expr PARAMS ((tree));
237 extern tree c_cast_expr PARAMS ((tree, tree));
238 extern tree build_c_cast PARAMS ((tree, tree));
239 extern tree build_modify_expr PARAMS ((tree, enum tree_code,
240 tree));
241 extern void store_init_value PARAMS ((tree, tree));
242 extern void error_init PARAMS ((const char *));
243 extern void pedwarn_init PARAMS ((const char *));
244 extern void start_init PARAMS ((tree, tree, int));
245 extern void finish_init PARAMS ((void));
246 extern void really_start_incremental_init PARAMS ((tree));
247 extern void push_init_level PARAMS ((int));
248 extern tree pop_init_level PARAMS ((int));
249 extern void set_init_index PARAMS ((tree, tree));
250 extern void set_init_label PARAMS ((tree));
251 extern void process_init_element PARAMS ((tree));
252 extern void pedwarn_c99 PARAMS ((const char *, ...))
253 ATTRIBUTE_PRINTF_1;
254 extern tree c_start_case PARAMS ((tree));
255 extern void c_finish_case PARAMS ((void));
256 extern tree simple_asm_stmt PARAMS ((tree));
257 extern tree build_asm_stmt PARAMS ((tree, tree, tree,
258 tree, tree));
260 /* Set to 0 at beginning of a function definition, set to 1 if
261 a return statement that specifies a return value is seen. */
263 extern int current_function_returns_value;
265 /* Set to 0 at beginning of a function definition, set to 1 if
266 a return statement with no argument is seen. */
268 extern int current_function_returns_null;
270 /* Nonzero means the expression being parsed will never be evaluated.
271 This is a count, since unevaluated expressions can nest. */
273 extern int skip_evaluation;
275 /* Nonzero means `$' can be in an identifier. */
277 extern int dollars_in_ident;
279 /* Nonzero means allow type mismatches in conditional expressions;
280 just make their values `void'. */
282 extern int flag_cond_mismatch;
284 /* Nonzero means don't recognize the keyword `asm'. */
286 extern int flag_no_asm;
288 /* Nonzero means warn about implicit declarations. */
290 extern int warn_implicit;
292 /* Nonzero means warn about sizeof (function) or addition/subtraction
293 of function pointers. */
295 extern int warn_pointer_arith;
297 /* Nonzero means warn for all old-style non-prototype function decls. */
299 extern int warn_strict_prototypes;
301 /* Nonzero means warn about multiple (redundant) decls for the same single
302 variable or function. */
304 extern int warn_redundant_decls;
306 /* Nonzero means warn about extern declarations of objects not at
307 file-scope level and about *all* declarations of functions (whether
308 extern or static) not at file-scope level. Note that we exclude
309 implicit function declarations. To get warnings about those, use
310 -Wimplicit. */
312 extern int warn_nested_externs;
314 /* Nonzero means warn about pointer casts that can drop a type qualifier
315 from the pointer target type. */
317 extern int warn_cast_qual;
319 /* Nonzero means warn when casting a function call to a type that does
320 not match the return type (e.g. (float)sqrt() or (anything*)malloc()
321 when there is no previous declaration of sqrt or malloc. */
323 extern int warn_bad_function_cast;
325 /* Warn about traditional constructs whose meanings changed in ANSI C. */
327 extern int warn_traditional;
329 /* Warn about a subscript that has type char. */
331 extern int warn_char_subscripts;
333 /* Warn if main is suspicious. */
335 extern int warn_main;
337 /* Nonzero means to allow single precision math even if we're generally
338 being traditional. */
339 extern int flag_allow_single_precision;
341 /* Warn if initializer is not completely bracketed. */
343 extern int warn_missing_braces;
345 /* Warn about comparison of signed and unsigned values. */
347 extern int warn_sign_compare;
349 /* Warn about testing equality of floating point numbers. */
351 extern int warn_float_equal;
353 /* Warn about multicharacter constants. */
355 extern int warn_multichar;
357 /* Nonzero means we are reading code that came from a system header file. */
359 extern int system_header_p;
361 /* Warn about implicit declarations. 1 = warning, 2 = error. */
362 extern int mesg_implicit_function_declaration;
364 /* In c-decl.c */
365 extern void finish_incomplete_decl PARAMS ((tree));
367 #endif /* ! GCC_C_TREE_H */