OSDN Git Service

* arm.c (arm_handle_notshared_attribute): Wrap declaration and use
[pf3gnuchains/gcc-fork.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 /* A kind of type specifier.  Note that this information is currently
135    only used to distinguish tag definitions, tag references and typeof
136    uses.  */
137 enum c_typespec_kind {
138   /* A reserved keyword type specifier.  */
139   ctsk_resword,
140   /* A reference to a tag, previously declared, such as "struct foo".
141      This includes where the previous declaration was as a different
142      kind of tag, in which case this is only valid if shadowing that
143      tag in an inner scope.  */
144   ctsk_tagref,
145   /* A reference to a tag, not previously declared in a visible
146      scope.  */
147   ctsk_tagfirstref,
148   /* A definition of a tag such as "struct foo { int a; }".  */
149   ctsk_tagdef,
150   /* A typedef name.  */
151   ctsk_typedef,
152   /* An ObjC-specific kind of type specifier.  */
153   ctsk_objc,
154   /* A typeof specifier.  */
155   ctsk_typeof
156 };
157
158 /* A type specifier: this structure is created in the parser and
159    passed to declspecs_add_type only.  */
160 struct c_typespec {
161   /* What kind of type specifier this is.  */
162   enum c_typespec_kind kind;
163   /* The specifier itself.  */
164   tree spec;
165 };
166
167 /* A storage class specifier.  */
168 enum c_storage_class {
169   csc_none,
170   csc_auto,
171   csc_extern,
172   csc_register,
173   csc_static,
174   csc_typedef
175 };
176
177 /* A type specifier keyword "void", "_Bool", "char", "int", "float",
178    "double", or none of these.  */
179 enum c_typespec_keyword {
180   cts_none,
181   cts_void,
182   cts_bool,
183   cts_char,
184   cts_int,
185   cts_float,
186   cts_double
187 };
188
189 /* A sequence of declaration specifiers in C.  */
190 struct c_declspecs {
191   /* The type specified, if a single type specifier such as a struct,
192      union or enum specifier, typedef name or typeof specifies the
193      whole type, or NULL_TREE if none or a keyword such as "void" or
194      "char" is used.  Does not include qualifiers.  */
195   tree type;
196   /* The attributes from a typedef decl.  */
197   tree decl_attr;
198   /* When parsing, the attributes.  Outside the parser, this will be
199      NULL; attributes (possibly from multiple lists) will be passed
200      separately.  */
201   tree attrs;
202   /* Any type specifier keyword used such as "int", not reflecting
203      modifiers such as "short", or cts_none if none.  */
204   enum c_typespec_keyword typespec_word;
205   /* The storage class specifier, or csc_none if none.  */
206   enum c_storage_class storage_class;
207   /* Whether something other than a storage class specifier or
208      attribute has been seen.  This is used to warn for the
209      obsolescent usage of storage class specifiers other than at the
210      start of the list.  (Doing this properly would require function
211      specifiers to be handled separately from storage class
212      specifiers.)  */
213   BOOL_BITFIELD non_sc_seen_p : 1;
214   /* Whether the type is specified by a typedef or typeof name.  */
215   BOOL_BITFIELD typedef_p : 1;
216   /* Whether a struct, union or enum type either had its content
217      defined by a type specifier in the list or was the first visible
218      declaration of its tag.  */
219   BOOL_BITFIELD tag_defined_p : 1;
220   /* Whether the type is explicitly "signed" or specified by a typedef
221      whose type is explicitly "signed".  */
222   BOOL_BITFIELD explicit_signed_p : 1;
223   /* Whether the specifiers include a deprecated typedef.  */
224   BOOL_BITFIELD deprecated_p : 1;
225   /* Whether the type defaulted to "int" because there were no type
226      specifiers.  */
227   BOOL_BITFIELD default_int_p;
228   /* Whether "long" was specified.  */
229   BOOL_BITFIELD long_p : 1;
230   /* Whether "long" was specified more than once.  */
231   BOOL_BITFIELD long_long_p : 1;
232   /* Whether "short" was specified.  */
233   BOOL_BITFIELD short_p : 1;
234   /* Whether "signed" was specified.  */
235   BOOL_BITFIELD signed_p : 1;
236   /* Whether "unsigned" was specified.  */
237   BOOL_BITFIELD unsigned_p : 1;
238   /* Whether "complex" was specified.  */
239   BOOL_BITFIELD complex_p : 1;
240   /* Whether "inline" was specified.  */
241   BOOL_BITFIELD inline_p : 1;
242   /* Whether "__thread" was specified.  */
243   BOOL_BITFIELD thread_p : 1;
244   /* Whether "const" was specified.  */
245   BOOL_BITFIELD const_p : 1;
246   /* Whether "volatile" was specified.  */
247   BOOL_BITFIELD volatile_p : 1;
248   /* Whether "restrict" was specified.  */
249   BOOL_BITFIELD restrict_p : 1;
250 };
251
252 /* The various kinds of declarators in C.  */
253 enum c_declarator_kind {
254   /* An identifier.  */
255   cdk_id,
256   /* A function.  */
257   cdk_function,
258   /* An array.  */
259   cdk_array,
260   /* A pointer.  */
261   cdk_pointer,
262   /* Parenthesized declarator with nested attributes.  */
263   cdk_attrs
264 };
265
266 /* Information about the parameters in a function declarator.  */
267 struct c_arg_info {
268   /* A list of parameter decls.  */
269   tree parms;
270   /* A list of structure, union and enum tags defined.  */
271   tree tags;
272   /* A list of argument types to go in the FUNCTION_TYPE.  */
273   tree types;
274   /* A list of non-parameter decls (notably enumeration constants)
275      defined with the parameters.  */
276   tree others;
277 };
278
279 /* A declarator.  */
280 struct c_declarator {
281   /* The kind of declarator.  */
282   enum c_declarator_kind kind;
283   /* Except for cdk_id, the contained declarator.  For cdk_id, NULL.  */
284   struct c_declarator *declarator;
285   union {
286     /* For identifiers, an IDENTIFIER_NODE or NULL_TREE if an abstract
287        declarator.  */
288     tree id;
289     /* For functions.  */
290     struct c_arg_info *arg_info;
291     /* For arrays.  */
292     struct {
293       /* The array dimension, or NULL for [] and [*].  */
294       tree dimen;
295       /* The qualifiers inside [].  */
296       int quals;
297       /* The attributes (currently ignored) inside [].  */
298       tree attrs;
299       /* Whether [static] was used.  */
300       BOOL_BITFIELD static_p : 1;
301       /* Whether [*] was used.  */
302       BOOL_BITFIELD vla_unspec_p : 1;
303     } array;
304     /* For pointers, the qualifiers on the pointer type.  */
305     int pointer_quals;
306     /* For attributes.  */
307     tree attrs;
308   } u;
309 };
310
311 /* A type name.  */
312 struct c_type_name {
313   /* The declaration specifiers.  */
314   struct c_declspecs *specs;
315   /* The declarator.  */
316   struct c_declarator *declarator;
317 };
318
319 /* A parameter.  */
320 struct c_parm {
321   /* The declaration specifiers, minus any prefix attributes.  */
322   struct c_declspecs *specs;
323   /* The attributes.  */
324   tree attrs;
325   /* The declarator.  */
326   struct c_declarator *declarator;
327 };
328
329 /* Save and restore the variables in this file and elsewhere
330    that keep track of the progress of compilation of the current function.
331    Used for nested functions.  */
332
333 struct language_function GTY(())
334 {
335   struct c_language_function base;
336   tree x_break_label;
337   tree x_cont_label;
338   struct c_switch * GTY((skip)) x_switch_stack;
339   struct c_arg_info * GTY((skip)) arg_info;
340   int returns_value;
341   int returns_null;
342   int returns_abnormally;
343   int warn_about_return_type;
344   int extern_inline;
345 };
346
347 \f
348 /* in c-parse.in */
349 extern void c_parse_init (void);
350
351 /* in c-aux-info.c */
352 extern void gen_aux_info_record (tree, int, int, int);
353
354 /* in c-decl.c */
355 extern struct obstack parser_obstack;
356 extern tree c_break_label;
357 extern tree c_cont_label;
358
359 extern int global_bindings_p (void);
360 extern void push_scope (void);
361 extern tree pop_scope (void);
362 extern void insert_block (tree);
363 extern tree pushdecl (tree);
364 extern void c_expand_body (tree);
365
366 extern void c_init_decl_processing (void);
367 extern void c_dup_lang_specific_decl (tree);
368 extern void c_print_identifier (FILE *, tree, int);
369 extern int quals_from_declspecs (const struct c_declspecs *);
370 extern struct c_declarator *build_array_declarator (tree, struct c_declspecs *,
371                                                     bool, bool);
372 extern tree build_enumerator (tree, tree);
373 extern void check_for_loop_decls (void);
374 extern void mark_forward_parm_decls (void);
375 extern int  complete_array_type (tree, tree, int);
376 extern void declare_parm_level (void);
377 extern void undeclared_variable (tree);
378 extern tree declare_label (tree);
379 extern tree define_label (location_t, tree);
380 extern void finish_decl (tree, tree, tree);
381 extern tree finish_enum (tree, tree, tree);
382 extern void finish_function (void);
383 extern tree finish_struct (tree, tree, tree);
384 extern struct c_arg_info *get_parm_info (bool);
385 extern tree grokfield (struct c_declarator *, struct c_declspecs *, tree);
386 extern tree groktypename (struct c_type_name *);
387 extern tree grokparm (const struct c_parm *);
388 extern tree implicitly_declare (tree);
389 extern void keep_next_level (void);
390 extern tree lookup_name (tree);
391 extern void pending_xref_error (void);
392 extern void c_push_function_context (struct function *);
393 extern void c_pop_function_context (struct function *);
394 extern void push_parm_decl (const struct c_parm *);
395 extern tree pushdecl_top_level (tree);
396 extern struct c_declarator *set_array_declarator_inner (struct c_declarator *,
397                                                         struct c_declarator *,
398                                                         bool);
399 extern tree builtin_function (const char *, tree, int, enum built_in_class,
400                               const char *, tree);
401 extern void shadow_tag (const struct c_declspecs *);
402 extern void shadow_tag_warned (const struct c_declspecs *, int);
403 extern tree start_enum (tree);
404 extern int  start_function (struct c_declspecs *, struct c_declarator *, tree);
405 extern tree start_decl (struct c_declarator *, struct c_declspecs *, bool,
406                         tree);
407 extern tree start_struct (enum tree_code, tree);
408 extern void store_parm_decls (void);
409 extern void store_parm_decls_from (struct c_arg_info *);
410 extern tree xref_tag (enum tree_code, tree);
411 extern struct c_typespec parser_xref_tag (enum tree_code, tree);
412 extern int c_expand_decl (tree);
413 extern struct c_parm *build_c_parm (struct c_declspecs *, tree,
414                                     struct c_declarator *);
415 extern struct c_declarator *build_attrs_declarator (tree,
416                                                     struct c_declarator *);
417 extern struct c_declarator *build_function_declarator (struct c_arg_info *,
418                                                        struct c_declarator *);
419 extern struct c_declarator *build_id_declarator (tree);
420 extern struct c_declarator *make_pointer_declarator (struct c_declspecs *,
421                                                      struct c_declarator *);
422 extern struct c_declspecs *build_null_declspecs (void);
423 extern struct c_declspecs *declspecs_add_qual (struct c_declspecs *, tree);
424 extern struct c_declspecs *declspecs_add_type (struct c_declspecs *,
425                                                struct c_typespec);
426 extern struct c_declspecs *declspecs_add_scspec (struct c_declspecs *, tree);
427 extern struct c_declspecs *declspecs_add_attrs (struct c_declspecs *, tree);
428 extern struct c_declspecs *finish_declspecs (struct c_declspecs *);
429
430 /* in c-objc-common.c */
431 extern int c_disregard_inline_limits (tree);
432 extern int c_cannot_inline_tree_fn (tree *);
433 extern bool c_objc_common_init (void);
434 extern bool c_missing_noreturn_ok_p (tree);
435 extern tree c_objc_common_truthvalue_conversion (tree expr);
436 extern int defer_fn (tree);
437 extern bool c_warn_unused_global_decl (tree);
438 extern void c_initialize_diagnostics (diagnostic_context *);
439
440 #define c_build_type_variant(TYPE, CONST_P, VOLATILE_P)           \
441   c_build_qualified_type ((TYPE),                                 \
442                           ((CONST_P) ? TYPE_QUAL_CONST : 0) |     \
443                           ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
444
445 /* in c-typeck.c */
446 extern int in_alignof;
447 extern int in_sizeof;
448 extern int in_typeof;
449
450 extern struct c_switch *c_switch_stack;
451
452 extern tree require_complete_type (tree);
453 extern int same_translation_unit_p (tree, tree);
454 extern int comptypes (tree, tree);
455 extern tree c_size_in_bytes (tree);
456 extern bool c_mark_addressable (tree);
457 extern void c_incomplete_type_error (tree, tree);
458 extern tree c_type_promotes_to (tree);
459 extern tree composite_type (tree, tree);
460 extern tree build_component_ref (tree, tree);
461 extern tree build_indirect_ref (tree, const char *);
462 extern tree build_array_ref (tree, tree);
463 extern tree build_external_ref (tree, int);
464 extern void record_maybe_used_decl (tree);
465 extern void pop_maybe_used (bool);
466 extern struct c_expr c_expr_sizeof_expr (struct c_expr);
467 extern struct c_expr c_expr_sizeof_type (struct c_type_name *);
468 extern struct c_expr parser_build_binary_op (enum tree_code, struct c_expr,
469                                              struct c_expr);
470 extern tree build_conditional_expr (tree, tree, tree);
471 extern tree build_compound_expr (tree, tree);
472 extern tree c_cast_expr (struct c_type_name *, tree);
473 extern tree build_c_cast (tree, tree);
474 extern tree build_modify_expr (tree, enum tree_code, tree);
475 extern void store_init_value (tree, tree);
476 extern void error_init (const char *);
477 extern void pedwarn_init (const char *);
478 extern void maybe_warn_string_init (tree, struct c_expr);
479 extern void start_init (tree, tree, int);
480 extern void finish_init (void);
481 extern void really_start_incremental_init (tree);
482 extern void push_init_level (int);
483 extern struct c_expr pop_init_level (int);
484 extern void set_init_index (tree, tree);
485 extern void set_init_label (tree);
486 extern void process_init_element (struct c_expr);
487 extern tree build_compound_literal (tree, tree);
488 extern tree c_start_case (tree);
489 extern void c_finish_case (tree);
490 extern tree build_asm_expr (tree, tree, tree, tree, bool);
491 extern tree build_asm_stmt (tree, tree);
492 extern tree c_convert_parm_for_inlining (tree, tree, tree, int);
493 extern int c_types_compatible_p (tree, tree);
494 extern tree c_begin_compound_stmt (bool);
495 extern tree c_end_compound_stmt (tree, bool);
496 extern void c_finish_if_stmt (location_t, tree, tree, tree, bool);
497 extern void c_finish_loop (location_t, tree, tree, tree, tree, tree, bool);
498 extern tree c_begin_stmt_expr (void);
499 extern tree c_finish_stmt_expr (tree);
500 extern tree c_process_expr_stmt (tree);
501 extern tree c_finish_expr_stmt (tree);
502 extern tree c_finish_return (tree);
503 extern tree c_finish_bc_stmt (tree *, bool);
504 extern tree c_finish_goto_label (tree);
505 extern tree c_finish_goto_ptr (tree);
506
507 /* Set to 0 at beginning of a function definition, set to 1 if
508    a return statement that specifies a return value is seen.  */
509
510 extern int current_function_returns_value;
511
512 /* Set to 0 at beginning of a function definition, set to 1 if
513    a return statement with no argument is seen.  */
514
515 extern int current_function_returns_null;
516
517 /* Set to 0 at beginning of a function definition, set to 1 if
518    a call to a noreturn function is seen.  */
519
520 extern int current_function_returns_abnormally;
521
522 /* Nonzero means we are reading code that came from a system header file.  */
523
524 extern int system_header_p;
525
526 /* True means global_bindings_p should return false even if the scope stack
527    says we are in file scope.  */
528
529 extern bool c_override_global_bindings_to_false;
530
531 /* True means we've initialized exception handling.  */
532 extern bool c_eh_initialized_p;
533
534 /* In c-decl.c */
535 extern void c_finish_incomplete_decl (tree);
536 extern void c_write_global_declarations (void);
537
538 /* In order for the format checking to accept the C frontend
539    diagnostic framework extensions, you must include this file before
540    toplev.h, not after.  */
541 #define GCC_DIAG_STYLE __gcc_cdiag__
542 #if GCC_VERSION >= 3005
543 #define ATTRIBUTE_GCC_CDIAG(m, n) __attribute__ ((__format__ (GCC_DIAG_STYLE, m ,n))) ATTRIBUTE_NONNULL(m)
544 #else
545 #define ATTRIBUTE_GCC_CDIAG(m, n) ATTRIBUTE_NONNULL(m)
546 #endif
547
548 extern void pedwarn_c90 (const char *, ...) ATTRIBUTE_GCC_CDIAG(1,2);
549 extern void pedwarn_c99 (const char *, ...) ATTRIBUTE_GCC_CDIAG(1,2);
550
551 #endif /* ! GCC_C_TREE_H */