c-tree.h revision 132727
11573Srgrimes/* Definitions for C parsing and type checking.
21573Srgrimes   Copyright (C) 1987, 1993, 1994, 1995, 1997, 1998,
31573Srgrimes   1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc.
41573Srgrimes
51573SrgrimesThis file is part of GCC.
61573Srgrimes
71573SrgrimesGCC is free software; you can redistribute it and/or modify it under
81573Srgrimesthe terms of the GNU General Public License as published by the Free
91573SrgrimesSoftware Foundation; either version 2, or (at your option) any later
101573Srgrimesversion.
111573Srgrimes
121573SrgrimesGCC is distributed in the hope that it will be useful, but WITHOUT ANY
131573SrgrimesWARRANTY; without even the implied warranty of MERCHANTABILITY or
141573SrgrimesFITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
151573Srgrimesfor more details.
161573Srgrimes
171573SrgrimesYou should have received a copy of the GNU General Public License
181573Srgrimesalong with GCC; see the file COPYING.  If not, write to the Free
191573SrgrimesSoftware Foundation, 59 Temple Place - Suite 330, Boston, MA
201573Srgrimes02111-1307, USA.  */
211573Srgrimes
221573Srgrimes#ifndef GCC_C_TREE_H
231573Srgrimes#define GCC_C_TREE_H
241573Srgrimes
251573Srgrimes#include "c-common.h"
261573Srgrimes
271573Srgrimes/* Language-dependent contents of an identifier.  */
281573Srgrimes
291573Srgrimes/* The limbo_value is used for block level extern declarations, which need
301573Srgrimes   to be type checked against subsequent extern declarations.  They can't
311573Srgrimes   be referenced after they fall out of scope, so they can't be global.
321573Srgrimes
3390039Sobrien   The rid_code field is used for keywords.  It is in all
3490039Sobrien   lang_identifier nodes, because some keywords are only special in a
351573Srgrimes   particular context.  */
3671579Sdeischen
371573Srgrimesstruct lang_identifier GTY(())
381573Srgrimes{
391573Srgrimes  struct c_common_identifier common_id;
401573Srgrimes  tree symbol_value;
4171579Sdeischen  tree tag_value;
421573Srgrimes  tree label_value;
431573Srgrimes};
4471579Sdeischen
451573Srgrimes/* The resulting tree type.  */
4671579Sdeischen
471573Srgrimesunion lang_tree_node
4855837Sjasone  GTY((desc ("TREE_CODE (&%h.generic) == IDENTIFIER_NODE"),
4956698Sjasone       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)")))
5071579Sdeischen{
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
59struct 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 incomplete RECORD_TYPE or UNION_TYPE, a list of variable
98   declarations whose type would be completed by completing that type.  */
99#define C_TYPE_INCOMPLETE_VARS(TYPE) TYPE_VFIELD (TYPE)
100
101/* In an IDENTIFIER_NODE, nonzero if this identifier is actually a
102   keyword.  C_RID_CODE (node) is then the RID_* value of the keyword,
103   and C_RID_YYCODE is the token number wanted by Yacc.  */
104#define C_IS_RESERVED_WORD(ID) TREE_LANG_FLAG_0 (ID)
105
106/* In a RECORD_TYPE, a sorted array of the fields of the type.  */
107struct lang_type GTY(())
108{
109  struct sorted_fields_type * GTY ((reorder ("resort_sorted_fields"))) s;
110};
111
112/* Record whether a type or decl was written with nonconstant size.
113   Note that TYPE_SIZE may have simplified to a constant.  */
114#define C_TYPE_VARIABLE_SIZE(TYPE) TYPE_LANG_FLAG_1 (TYPE)
115#define C_DECL_VARIABLE_SIZE(TYPE) DECL_LANG_FLAG_0 (TYPE)
116
117/* Store a value in that field.  */
118#define C_SET_EXP_ORIGINAL_CODE(EXP, CODE) \
119  (TREE_COMPLEXITY (EXP) = (int) (CODE))
120
121/* Record whether a typedef for type `int' was actually `signed int'.  */
122#define C_TYPEDEF_EXPLICITLY_SIGNED(EXP) DECL_LANG_FLAG_1 (EXP)
123
124/* For a FUNCTION_DECL, nonzero if it was defined without an explicit
125   return type.  */
126#define C_FUNCTION_IMPLICIT_INT(EXP) DECL_LANG_FLAG_1 (EXP)
127
128/* For a FUNCTION_DECL, nonzero if it was an implicit declaration.  */
129#define C_DECL_IMPLICIT(EXP) DECL_LANG_FLAG_2 (EXP)
130
131/* Nonzero for a declaration of an external object which is not
132   currently in scope.  This is either a built-in declaration of
133   a library function, before a real declaration has been seen,
134   or a declaration that appeared in an inner scope that has ended.  */
135#define C_DECL_INVISIBLE(EXP) DECL_LANG_FLAG_3 (EXP)
136
137/* Nonzero for a decl which either doesn't exist or isn't a prototype.
138   N.B. Could be simplified if all built-in decls had complete prototypes
139   (but this is presently difficult because some of them need FILE*).  */
140#define C_DECL_ISNT_PROTOTYPE(EXP)			\
141       (EXP == 0					\
142	|| (TYPE_ARG_TYPES (TREE_TYPE (EXP)) == 0	\
143	    && !DECL_BUILT_IN (EXP)))
144
145/* For FUNCTION_TYPE, a hidden list of types of arguments.  The same as
146   TYPE_ARG_TYPES for functions with prototypes, but created for functions
147   without prototypes.  */
148#define TYPE_ACTUAL_ARG_TYPES(NODE) TYPE_BINFO (NODE)
149
150/* Values for the first parameter to poplevel.  */
151#define KEEP_NO		0
152#define KEEP_YES	1
153#define KEEP_MAYBE	2
154
155/* Save and restore the variables in this file and elsewhere
156   that keep track of the progress of compilation of the current function.
157   Used for nested functions.  */
158
159struct language_function GTY(())
160{
161  struct c_language_function base;
162  int returns_value;
163  int returns_null;
164  int returns_abnormally;
165  int warn_about_return_type;
166  int extern_inline;
167  int x_in_iteration_stmt;
168  int x_in_case_stmt;
169};
170
171
172/* in c-parse.in */
173extern void c_parse_init (void);
174
175/* in c-aux-info.c */
176extern void gen_aux_info_record (tree, int, int, int);
177
178/* in c-decl.c */
179extern int c_in_iteration_stmt;
180extern int c_in_case_stmt;
181
182extern int global_bindings_p (void);
183extern tree getdecls (void);
184extern void pushlevel (int);
185extern void insert_block (tree);
186extern void set_block (tree);
187extern tree pushdecl (tree);
188extern void c_expand_body (tree);
189
190extern void c_init_decl_processing (void);
191extern void c_dup_lang_specific_decl (tree);
192extern void c_print_identifier (FILE *, tree, int);
193extern tree build_array_declarator (tree, tree, int, int);
194extern tree build_enumerator (tree, tree);
195extern void check_for_loop_decls (void);
196extern void mark_forward_parm_decls (void);
197extern int  complete_array_type (tree, tree, int);
198extern void declare_parm_level (void);
199extern void undeclared_variable (tree);
200extern tree declare_label (tree);
201extern tree define_label (location_t, tree);
202extern void finish_decl (tree, tree, tree);
203extern tree finish_enum (tree, tree, tree);
204extern void finish_function (void);
205extern tree finish_struct (tree, tree, tree);
206extern tree get_parm_info (int);
207extern tree grokfield (tree, tree, tree);
208extern tree groktypename (tree);
209extern tree groktypename_in_parm_context (tree);
210extern tree implicitly_declare (tree);
211extern int  in_parm_level_p (void);
212extern void keep_next_level (void);
213extern tree lookup_name (tree);
214extern void pending_xref_error (void);
215extern void c_push_function_context (struct function *);
216extern void c_pop_function_context (struct function *);
217extern void push_parm_decl (tree);
218extern tree pushdecl_top_level (tree);
219extern void pushtag (tree, tree);
220extern tree set_array_declarator_type (tree, tree, int);
221extern void shadow_tag (tree);
222extern void shadow_tag_warned (tree, int);
223extern tree start_enum (tree);
224extern int  start_function (tree, tree, tree);
225extern tree start_decl (tree, tree, int, tree);
226extern tree start_struct (enum tree_code, tree);
227extern void store_parm_decls (void);
228extern tree xref_tag (enum tree_code, tree);
229extern tree c_begin_compound_stmt (void);
230extern void c_expand_deferred_function (tree);
231extern void c_expand_decl_stmt (tree);
232extern void c_static_assembler_name (tree);
233extern tree make_pointer_declarator (tree, tree);
234extern void merge_translation_unit_decls (void);
235
236/* in c-objc-common.c */
237extern int c_disregard_inline_limits (tree);
238extern int c_cannot_inline_tree_fn (tree *);
239extern bool c_objc_common_init (void);
240extern int c_missing_noreturn_ok_p (tree);
241extern void c_objc_common_finish_file (void);
242extern int defer_fn (tree);
243extern bool c_warn_unused_global_decl (tree);
244
245#define c_build_type_variant(TYPE, CONST_P, VOLATILE_P)		  \
246  c_build_qualified_type ((TYPE),				  \
247			  ((CONST_P) ? TYPE_QUAL_CONST : 0) |	  \
248			  ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
249
250#define c_sizeof_nowarn(T)  c_sizeof_or_alignof_type (T, SIZEOF_EXPR, 0)
251
252/* in c-typeck.c */
253
254/* For use with comptypes.  */
255enum {
256  COMPARE_STRICT = 0
257};
258
259extern tree require_complete_type (tree);
260extern int comptypes (tree, tree, int);
261extern tree c_size_in_bytes (tree);
262extern bool c_mark_addressable (tree);
263extern void c_incomplete_type_error (tree, tree);
264extern tree c_type_promotes_to (tree);
265extern tree build_component_ref (tree, tree);
266extern tree build_indirect_ref (tree, const char *);
267extern tree build_array_ref (tree, tree);
268extern tree build_external_ref (tree, int);
269extern tree parser_build_binary_op (enum tree_code, tree, tree);
270extern int c_tree_expr_nonnegative_p (tree);
271extern void readonly_error (tree, const char *);
272extern tree build_conditional_expr (tree, tree, tree);
273extern tree build_compound_expr (tree);
274extern tree c_cast_expr (tree, tree);
275extern tree build_c_cast (tree, tree);
276extern tree build_modify_expr (tree, enum tree_code, tree);
277extern void store_init_value (tree, tree);
278extern void error_init (const char *);
279extern void pedwarn_init (const char *);
280extern void start_init (tree, tree, int);
281extern void finish_init (void);
282extern void really_start_incremental_init (tree);
283extern void push_init_level (int);
284extern tree pop_init_level (int);
285extern void set_init_index (tree, tree);
286extern void set_init_label (tree);
287extern void process_init_element (tree);
288extern tree build_compound_literal (tree, tree);
289extern void pedwarn_c90 (const char *, ...) ATTRIBUTE_PRINTF_1;
290extern void pedwarn_c99 (const char *, ...) ATTRIBUTE_PRINTF_1;
291extern tree c_start_case (tree);
292extern void c_finish_case (void);
293extern tree simple_asm_stmt (tree);
294extern tree build_asm_stmt (tree, tree, tree, tree, tree);
295extern tree c_convert_parm_for_inlining (tree, tree, tree, int);
296
297/* Set to 0 at beginning of a function definition, set to 1 if
298   a return statement that specifies a return value is seen.  */
299
300extern int current_function_returns_value;
301
302/* Set to 0 at beginning of a function definition, set to 1 if
303   a return statement with no argument is seen.  */
304
305extern int current_function_returns_null;
306
307/* Set to 0 at beginning of a function definition, set to 1 if
308   a call to a noreturn function is seen.  */
309
310extern int current_function_returns_abnormally;
311
312/* Nonzero means we are reading code that came from a system header file.  */
313
314extern int system_header_p;
315
316/* In c-decl.c */
317extern void c_finish_incomplete_decl (tree);
318extern void *get_current_scope (void);
319extern void objc_mark_locals_volatile (void *);
320extern void c_write_global_declarations (void);
321
322extern GTY(()) tree static_ctors;
323extern GTY(()) tree static_dtors;
324
325/* In order for the format checking to accept the C frontend
326   diagnostic framework extensions, you must include this file before
327   toplev.h, not after.  */
328#define GCC_DIAG_STYLE __gcc_cdiag__
329
330#endif /* ! GCC_C_TREE_H */
331