c-tree.h (C_DECL_FILE_SCOPE): Move ...
[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 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
27 /* Language-dependent contents of an identifier. */
28
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.
32
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. */
36
37 struct lang_identifier GTY(())
38 {
39 struct c_common_identifier common_id;
40 tree symbol_value;
41 tree tag_value;
42 tree label_value;
43 };
44
45 /* The resulting tree type. */
46
47 union lang_tree_node
48 GTY((desc ("TREE_CODE (&%h.generic) == IDENTIFIER_NODE"),
49 chain_next ("TREE_CODE (&%h.generic) == INTEGER_TYPE ? (union lang_tree_node *)TYPE_NEXT_VARIANT (&%h.generic) : (union lang_tree_node *)TREE_CHAIN (&%h.generic)")))
50 {
51 union tree_node GTY ((tag ("0"),
52 desc ("tree_node_structure (&%h)")))
53 generic;
54 struct lang_identifier GTY ((tag ("1"))) identifier;
55 };
56
57 /* Language-specific declaration information. */
58
59 struct lang_decl GTY(())
60 {
61 /* The return types and parameter types may have variable size.
62 This is a list of any SAVE_EXPRs that need to be evaluated to
63 compute those sizes. */
64 tree pending_sizes;
65 };
66
67 /* Macros for access to language-specific slots in an identifier. */
68 /* Each of these slots contains a DECL node or null. */
69
70 /* The value of the identifier in the namespace of "ordinary identifiers"
71 (data objects, enum constants, functions, typedefs). */
72 #define IDENTIFIER_SYMBOL_VALUE(NODE) \
73 (((struct lang_identifier *) (NODE))->symbol_value)
74 /* The value of the identifier in the namespace of struct, union,
75 and enum tags. */
76 #define IDENTIFIER_TAG_VALUE(NODE) \
77 (((struct lang_identifier *) (NODE))->tag_value)
78 /* The value of the identifier in the namespace of labels. */
79 #define IDENTIFIER_LABEL_VALUE(NODE) \
80 (((struct lang_identifier *) (NODE))->label_value)
81
82 /* In identifiers, C uses the following fields in a special way:
83 TREE_PUBLIC to record that there was a previous local extern decl.
84 TREE_USED to record that such a decl was used.
85 TREE_ADDRESSABLE to record that the address of such a decl was used. */
86
87 /* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is read-only. */
88 #define C_TYPE_FIELDS_READONLY(TYPE) TREE_LANG_FLAG_1 (TYPE)
89
90 /* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is volatile. */
91 #define C_TYPE_FIELDS_VOLATILE(TYPE) TREE_LANG_FLAG_2 (TYPE)
92
93 /* In a RECORD_TYPE or UNION_TYPE or ENUMERAL_TYPE
94 nonzero if the definition of the type has already started. */
95 #define C_TYPE_BEING_DEFINED(TYPE) TYPE_LANG_FLAG_0 (TYPE)
96
97 /* In an IDENTIFIER_NODE, nonzero if this identifier is actually a
98 keyword. C_RID_CODE (node) is then the RID_* value of the keyword,
99 and C_RID_YYCODE is the token number wanted by Yacc. */
100 #define C_IS_RESERVED_WORD(ID) TREE_LANG_FLAG_0 (ID)
101
102 /* In a RECORD_TYPE, a sorted array of the fields of the type. */
103 struct lang_type GTY(())
104 {
105 struct sorted_fields_type * GTY ((reorder ("resort_sorted_fields"))) s;
106 };
107
108 /* Record whether a type or decl was written with nonconstant size.
109 Note that TYPE_SIZE may have simplified to a constant. */
110 #define C_TYPE_VARIABLE_SIZE(TYPE) TYPE_LANG_FLAG_1 (TYPE)
111 #define C_DECL_VARIABLE_SIZE(TYPE) DECL_LANG_FLAG_0 (TYPE)
112
113 /* Store a value in that field. */
114 #define C_SET_EXP_ORIGINAL_CODE(EXP, CODE) \
115 (TREE_COMPLEXITY (EXP) = (int) (CODE))
116
117 /* Record whether a typedef for type `int' was actually `signed int'. */
118 #define C_TYPEDEF_EXPLICITLY_SIGNED(EXP) DECL_LANG_FLAG_1 (EXP)
119
120 /* For a FUNCTION_DECL, nonzero if it was defined without an explicit
121 return type. */
122 #define C_FUNCTION_IMPLICIT_INT(EXP) DECL_LANG_FLAG_1 (EXP)
123
124 /* For a FUNCTION_DECL, nonzero if it was an implicit declaration. */
125 #define C_DECL_IMPLICIT(EXP) DECL_LANG_FLAG_2 (EXP)
126
127 /* Nonzero for a declaration of an external object which is not
128 currently in scope. This is either a built-in declaration of
129 a library function, before a real declaration has been seen,
130 or a declaration that appeared in an inner scope that has ended. */
131 #define C_DECL_INVISIBLE(EXP) DECL_LANG_FLAG_3 (EXP)
132
133 /* Nonzero for a decl which either doesn't exist or isn't a prototype.
134 N.B. Could be simplified if all built-in decls had complete prototypes
135 (but this is presently difficult because some of them need FILE*). */
136 #define C_DECL_ISNT_PROTOTYPE(EXP) \
137 (EXP == 0 \
138 || (TYPE_ARG_TYPES (TREE_TYPE (EXP)) == 0 \
139 && !DECL_BUILT_IN (EXP)))
140
141 /* For FUNCTION_TYPE, a hidden list of types of arguments. The same as
142 TYPE_ARG_TYPES for functions with prototypes, but created for functions
143 without prototypes. */
144 #define TYPE_ACTUAL_ARG_TYPES(NODE) TYPE_BINFO (NODE)
145
146 /* Values for the first parameter to poplevel. */
147 #define KEEP_NO 0
148 #define KEEP_YES 1
149 #define KEEP_MAYBE 2
150
151 \f
152 /* in c-lang.c and objc-act.c */
153 extern tree lookup_interface (tree);
154 extern tree is_class_name (tree);
155 extern tree objc_is_id (tree);
156 extern void objc_check_decl (tree);
157 extern int objc_comptypes (tree, tree, int);
158 extern tree objc_message_selector (void);
159 extern tree lookup_objc_ivar (tree);
160 extern void c_expand_body (tree);
161
162 \f
163 /* in c-parse.in */
164 extern void c_parse_init (void);
165
166 /* in c-aux-info.c */
167 extern void gen_aux_info_record (tree, int, int, int);
168
169 /* in c-decl.c */
170 extern int global_bindings_p (void);
171 extern tree getdecls (void);
172 extern void pushlevel (int);
173 extern void insert_block (tree);
174 extern void set_block (tree);
175 extern tree pushdecl (tree);
176
177 extern void c_init_decl_processing (void);
178 extern void c_dup_lang_specific_decl (tree);
179 extern void c_print_identifier (FILE *, tree, int);
180 extern tree build_array_declarator (tree, tree, int, int);
181 extern tree build_enumerator (tree, tree);
182 extern void check_for_loop_decls (void);
183 extern void mark_forward_parm_decls (void);
184 extern int complete_array_type (tree, tree, int);
185 extern void declare_parm_level (void);
186 extern void undeclared_variable (tree);
187 extern tree declare_label (tree);
188 extern tree define_label (location_t, tree);
189 extern void finish_decl (tree, tree, tree);
190 extern tree finish_enum (tree, tree, tree);
191 extern void finish_function (int, int);
192 extern tree finish_struct (tree, tree, tree);
193 extern tree get_parm_info (int);
194 extern tree grokfield (tree, tree, tree);
195 extern tree groktypename (tree);
196 extern tree groktypename_in_parm_context (tree);
197 extern tree implicitly_declare (tree);
198 extern int in_parm_level_p (void);
199 extern void keep_next_level (void);
200 extern tree lookup_name (tree);
201 extern void pending_xref_error (void);
202 extern void c_push_function_context (struct function *);
203 extern void c_pop_function_context (struct function *);
204 extern void push_parm_decl (tree);
205 extern tree pushdecl_top_level (tree);
206 extern void pushtag (tree, tree);
207 extern tree set_array_declarator_type (tree, tree, int);
208 extern void shadow_tag (tree);
209 extern void shadow_tag_warned (tree, int);
210 extern tree start_enum (tree);
211 extern int start_function (tree, tree, tree);
212 extern tree start_decl (tree, tree, int, tree);
213 extern tree start_struct (enum tree_code, tree);
214 extern void store_parm_decls (void);
215 extern tree xref_tag (enum tree_code, tree);
216 extern tree c_begin_compound_stmt (void);
217 extern void c_expand_deferred_function (tree);
218 extern void c_expand_decl_stmt (tree);
219 extern void c_static_assembler_name (tree);
220 extern tree make_pointer_declarator (tree, tree);
221 extern void merge_translation_unit_decls (void);
222
223 /* in c-objc-common.c */
224 extern int c_disregard_inline_limits (tree);
225 extern int c_cannot_inline_tree_fn (tree *);
226 extern bool c_objc_common_init (void);
227 extern int c_missing_noreturn_ok_p (tree);
228 extern void c_objc_common_finish_file (void);
229 extern int defer_fn (tree);
230 extern bool c_warn_unused_global_decl (tree);
231
232 #define c_build_type_variant(TYPE, CONST_P, VOLATILE_P) \
233 c_build_qualified_type ((TYPE), \
234 ((CONST_P) ? TYPE_QUAL_CONST : 0) | \
235 ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
236
237 #define c_sizeof_nowarn(T) c_sizeof_or_alignof_type (T, SIZEOF_EXPR, 0)
238
239 /* in c-typeck.c */
240
241 /* For use with comptypes. */
242 enum {
243 COMPARE_STRICT = 0,
244 COMPARE_DIFFERENT_TU = 1
245 };
246
247 extern tree require_complete_type (tree);
248 extern int comptypes (tree, tree, int);
249 extern tree c_size_in_bytes (tree);
250 extern bool c_mark_addressable (tree);
251 extern void c_incomplete_type_error (tree, tree);
252 extern tree c_type_promotes_to (tree);
253 extern tree build_component_ref (tree, tree);
254 extern tree build_indirect_ref (tree, const char *);
255 extern tree build_array_ref (tree, tree);
256 extern tree build_external_ref (tree, int);
257 extern tree parser_build_binary_op (enum tree_code, tree, tree);
258 extern int c_tree_expr_nonnegative_p (tree);
259 extern void readonly_warning (tree, const char *);
260 extern tree build_conditional_expr (tree, tree, tree);
261 extern tree build_compound_expr (tree);
262 extern tree c_cast_expr (tree, tree);
263 extern tree build_c_cast (tree, tree);
264 extern tree build_modify_expr (tree, enum tree_code, tree);
265 extern void store_init_value (tree, tree);
266 extern void error_init (const char *);
267 extern void pedwarn_init (const char *);
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 tree 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 (tree);
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 (void);
281 extern tree simple_asm_stmt (tree);
282 extern tree build_asm_stmt (tree, tree, tree, tree, tree);
283 extern tree c_convert_parm_for_inlining (tree, tree, tree);
284
285 /* Set to 0 at beginning of a function definition, set to 1 if
286 a return statement that specifies a return value is seen. */
287
288 extern int current_function_returns_value;
289
290 /* Set to 0 at beginning of a function definition, set to 1 if
291 a return statement with no argument is seen. */
292
293 extern int current_function_returns_null;
294
295 /* Set to 0 at beginning of a function definition, set to 1 if
296 a call to a noreturn function is seen. */
297
298 extern int current_function_returns_abnormally;
299
300 /* Nonzero means we are reading code that came from a system header file. */
301
302 extern int system_header_p;
303
304 /* In c-decl.c */
305 extern void c_finish_incomplete_decl (tree);
306 extern void c_write_global_declarations (void);
307
308 extern GTY(()) tree static_ctors;
309 extern GTY(()) tree static_dtors;
310
311 /* In order for the format checking to accept the C frontend
312 diagnostic framework extensions, you must include this file before
313 toplev.h, not after. */
314 #define GCC_DIAG_STYLE __gcc_cdiag__
315
316 #endif /* ! GCC_C_TREE_H */