1 /* Definitions for C parsing and type checking.
2 Copyright (C) 1987, 1993, 1994, 1995, 1997, 1998,
3 1999, 2000, 2001, 2002, 2003, 2004, 2005 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
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
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, 51 Franklin Street, Fifth Floor, Boston, MA
27 #include "diagnostic.h"
29 /* struct lang_identifier is private to c-decl.c, but langhooks.c needs to
30 know how big it is. This is sanity-checked in c-decl.c. */
31 #define C_SIZEOF_STRUCT_LANG_IDENTIFIER \
32 (sizeof (struct c_common_identifier) + 3 * sizeof (void *))
34 /* Language-specific declaration information. */
36 struct lang_decl
GTY(())
41 /* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is read-only. */
42 #define C_TYPE_FIELDS_READONLY(TYPE) TREE_LANG_FLAG_1 (TYPE)
44 /* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is volatile. */
45 #define C_TYPE_FIELDS_VOLATILE(TYPE) TREE_LANG_FLAG_2 (TYPE)
47 /* In a RECORD_TYPE or UNION_TYPE or ENUMERAL_TYPE
48 nonzero if the definition of the type has already started. */
49 #define C_TYPE_BEING_DEFINED(TYPE) TYPE_LANG_FLAG_0 (TYPE)
51 /* In an incomplete RECORD_TYPE or UNION_TYPE, a list of variable
52 declarations whose type would be completed by completing that type. */
53 #define C_TYPE_INCOMPLETE_VARS(TYPE) TYPE_VFIELD (TYPE)
55 /* In an IDENTIFIER_NODE, nonzero if this identifier is actually a
56 keyword. C_RID_CODE (node) is then the RID_* value of the keyword,
57 and C_RID_YYCODE is the token number wanted by Yacc. */
58 #define C_IS_RESERVED_WORD(ID) TREE_LANG_FLAG_0 (ID)
60 struct lang_type
GTY(())
62 /* In a RECORD_TYPE, a sorted array of the fields of the type. */
63 struct sorted_fields_type
* GTY ((reorder ("resort_sorted_fields"))) s
;
64 /* In an ENUMERAL_TYPE, the min and max values. */
67 /* In a RECORD_TYPE, information specific to Objective-C, such
68 as a list of adopted protocols or a pointer to a corresponding
69 @interface. See objc/objc-act.h for details. */
73 /* Record whether a type or decl was written with nonconstant size.
74 Note that TYPE_SIZE may have simplified to a constant. */
75 #define C_TYPE_VARIABLE_SIZE(TYPE) TYPE_LANG_FLAG_1 (TYPE)
76 #define C_DECL_VARIABLE_SIZE(TYPE) DECL_LANG_FLAG_0 (TYPE)
78 /* Record whether a typedef for type `int' was actually `signed int'. */
79 #define C_TYPEDEF_EXPLICITLY_SIGNED(EXP) DECL_LANG_FLAG_1 (EXP)
81 /* For a FUNCTION_DECL, nonzero if it was defined without an explicit
83 #define C_FUNCTION_IMPLICIT_INT(EXP) DECL_LANG_FLAG_1 (EXP)
85 /* For a FUNCTION_DECL, nonzero if it was an implicit declaration. */
86 #define C_DECL_IMPLICIT(EXP) DECL_LANG_FLAG_2 (EXP)
88 /* For FUNCTION_DECLs, evaluates true if the decl is built-in but has
90 #define C_DECL_DECLARED_BUILTIN(EXP) \
91 DECL_LANG_FLAG_3 (FUNCTION_DECL_CHECK (EXP))
93 /* For FUNCTION_DECLs, evaluates true if the decl is built-in, has a
94 built-in prototype and does not have a non-built-in prototype. */
95 #define C_DECL_BUILTIN_PROTOTYPE(EXP) \
96 DECL_LANG_FLAG_6 (FUNCTION_DECL_CHECK (EXP))
98 /* Record whether a decl was declared register. This is strictly a
99 front-end flag, whereas DECL_REGISTER is used for code generation;
100 they may differ for structures with volatile fields. */
101 #define C_DECL_REGISTER(EXP) DECL_LANG_FLAG_4 (EXP)
103 /* Record whether a decl was used in an expression anywhere except an
104 unevaluated operand of sizeof / typeof / alignof. This is only
105 used for functions declared static but not defined, though outside
106 sizeof and typeof it is set for other function decls as well. */
107 #define C_DECL_USED(EXP) DECL_LANG_FLAG_5 (FUNCTION_DECL_CHECK (EXP))
109 /* Record whether a label was defined in a statement expression which
110 has finished and so can no longer be jumped to. */
111 #define C_DECL_UNJUMPABLE_STMT_EXPR(EXP) \
112 DECL_LANG_FLAG_6 (LABEL_DECL_CHECK (EXP))
114 /* Record whether a label was the subject of a goto from outside the
115 current level of statement expression nesting and so cannot be
116 defined right now. */
117 #define C_DECL_UNDEFINABLE_STMT_EXPR(EXP) \
118 DECL_LANG_FLAG_7 (LABEL_DECL_CHECK (EXP))
120 /* Record whether a label was defined in the scope of an identifier
121 with variably modified type which has finished and so can no longer
123 #define C_DECL_UNJUMPABLE_VM(EXP) \
124 DECL_LANG_FLAG_3 (LABEL_DECL_CHECK (EXP))
126 /* Record whether a label was the subject of a goto from outside the
127 current level of scopes of identifiers with variably modified type
128 and so cannot be defined right now. */
129 #define C_DECL_UNDEFINABLE_VM(EXP) \
130 DECL_LANG_FLAG_5 (LABEL_DECL_CHECK (EXP))
132 /* Nonzero for a decl which either doesn't exist or isn't a prototype.
133 N.B. Could be simplified if all built-in decls had complete prototypes
134 (but this is presently difficult because some of them need FILE*). */
135 #define C_DECL_ISNT_PROTOTYPE(EXP) \
137 || (TYPE_ARG_TYPES (TREE_TYPE (EXP)) == 0 \
138 && !DECL_BUILT_IN (EXP)))
140 /* For FUNCTION_TYPE, a hidden list of types of arguments. The same as
141 TYPE_ARG_TYPES for functions with prototypes, but created for functions
142 without prototypes. */
143 #define TYPE_ACTUAL_ARG_TYPES(NODE) TYPE_LANG_SLOT_1 (NODE)
145 /* Record parser information about an expression that is irrelevant
146 for code generation alongside a tree representing its value. */
149 /* The value of the expression. */
151 /* Record the original binary operator of an expression, which may
152 have been changed by fold, STRING_CST for unparenthesized string
153 constants, or ERROR_MARK for other expressions (including
154 parenthesized expressions). */
155 enum tree_code original_code
;
158 /* A kind of type specifier. Note that this information is currently
159 only used to distinguish tag definitions, tag references and typeof
161 enum c_typespec_kind
{
162 /* A reserved keyword type specifier. */
164 /* A reference to a tag, previously declared, such as "struct foo".
165 This includes where the previous declaration was as a different
166 kind of tag, in which case this is only valid if shadowing that
167 tag in an inner scope. */
169 /* A reference to a tag, not previously declared in a visible
172 /* A definition of a tag such as "struct foo { int a; }". */
174 /* A typedef name. */
176 /* An ObjC-specific kind of type specifier. */
178 /* A typeof specifier. */
182 /* A type specifier: this structure is created in the parser and
183 passed to declspecs_add_type only. */
185 /* What kind of type specifier this is. */
186 enum c_typespec_kind kind
;
187 /* The specifier itself. */
191 /* A storage class specifier. */
192 enum c_storage_class
{
201 /* A type specifier keyword "void", "_Bool", "char", "int", "float",
202 "double", or none of these. */
203 enum c_typespec_keyword
{
216 /* A sequence of declaration specifiers in C. */
218 /* The type specified, if a single type specifier such as a struct,
219 union or enum specifier, typedef name or typeof specifies the
220 whole type, or NULL_TREE if none or a keyword such as "void" or
221 "char" is used. Does not include qualifiers. */
223 /* The attributes from a typedef decl. */
225 /* When parsing, the attributes. Outside the parser, this will be
226 NULL; attributes (possibly from multiple lists) will be passed
229 /* Any type specifier keyword used such as "int", not reflecting
230 modifiers such as "short", or cts_none if none. */
231 enum c_typespec_keyword typespec_word
;
232 /* The storage class specifier, or csc_none if none. */
233 enum c_storage_class storage_class
;
234 /* Whether any declaration specifiers have been seen at all. */
235 BOOL_BITFIELD declspecs_seen_p
: 1;
236 /* Whether a type specifier has been seen. */
237 BOOL_BITFIELD type_seen_p
: 1;
238 /* Whether something other than a storage class specifier or
239 attribute has been seen. This is used to warn for the
240 obsolescent usage of storage class specifiers other than at the
241 start of the list. (Doing this properly would require function
242 specifiers to be handled separately from storage class
244 BOOL_BITFIELD non_sc_seen_p
: 1;
245 /* Whether the type is specified by a typedef or typeof name. */
246 BOOL_BITFIELD typedef_p
: 1;
247 /* Whether a struct, union or enum type either had its content
248 defined by a type specifier in the list or was the first visible
249 declaration of its tag. */
250 BOOL_BITFIELD tag_defined_p
: 1;
251 /* Whether the type is explicitly "signed" or specified by a typedef
252 whose type is explicitly "signed". */
253 BOOL_BITFIELD explicit_signed_p
: 1;
254 /* Whether the specifiers include a deprecated typedef. */
255 BOOL_BITFIELD deprecated_p
: 1;
256 /* Whether the type defaulted to "int" because there were no type
258 BOOL_BITFIELD default_int_p
;
259 /* Whether "long" was specified. */
260 BOOL_BITFIELD long_p
: 1;
261 /* Whether "long" was specified more than once. */
262 BOOL_BITFIELD long_long_p
: 1;
263 /* Whether "short" was specified. */
264 BOOL_BITFIELD short_p
: 1;
265 /* Whether "signed" was specified. */
266 BOOL_BITFIELD signed_p
: 1;
267 /* Whether "unsigned" was specified. */
268 BOOL_BITFIELD unsigned_p
: 1;
269 /* Whether "complex" was specified. */
270 BOOL_BITFIELD complex_p
: 1;
271 /* Whether "inline" was specified. */
272 BOOL_BITFIELD inline_p
: 1;
273 /* Whether "__thread" was specified. */
274 BOOL_BITFIELD thread_p
: 1;
275 /* Whether "const" was specified. */
276 BOOL_BITFIELD const_p
: 1;
277 /* Whether "volatile" was specified. */
278 BOOL_BITFIELD volatile_p
: 1;
279 /* Whether "restrict" was specified. */
280 BOOL_BITFIELD restrict_p
: 1;
283 /* The various kinds of declarators in C. */
284 enum c_declarator_kind
{
293 /* Parenthesized declarator with nested attributes. */
297 /* Information about the parameters in a function declarator. */
299 /* A list of parameter decls. */
301 /* A list of structure, union and enum tags defined. */
303 /* A list of argument types to go in the FUNCTION_TYPE. */
305 /* A list of non-parameter decls (notably enumeration constants)
306 defined with the parameters. */
311 struct c_declarator
{
312 /* The kind of declarator. */
313 enum c_declarator_kind kind
;
314 /* Except for cdk_id, the contained declarator. For cdk_id, NULL. */
315 struct c_declarator
*declarator
;
316 location_t id_loc
; /* Currently only set for cdk_id. */
318 /* For identifiers, an IDENTIFIER_NODE or NULL_TREE if an abstract
322 struct c_arg_info
*arg_info
;
325 /* The array dimension, or NULL for [] and [*]. */
327 /* The qualifiers inside []. */
329 /* The attributes (currently ignored) inside []. */
331 /* Whether [static] was used. */
332 BOOL_BITFIELD static_p
: 1;
333 /* Whether [*] was used. */
334 BOOL_BITFIELD vla_unspec_p
: 1;
336 /* For pointers, the qualifiers on the pointer type. */
338 /* For attributes. */
345 /* The declaration specifiers. */
346 struct c_declspecs
*specs
;
347 /* The declarator. */
348 struct c_declarator
*declarator
;
353 /* The declaration specifiers, minus any prefix attributes. */
354 struct c_declspecs
*specs
;
355 /* The attributes. */
357 /* The declarator. */
358 struct c_declarator
*declarator
;
361 /* Save and restore the variables in this file and elsewhere
362 that keep track of the progress of compilation of the current function.
363 Used for nested functions. */
365 struct language_function
GTY(())
367 struct c_language_function base
;
370 struct c_switch
* GTY((skip
)) x_switch_stack
;
371 struct c_arg_info
* GTY((skip
)) arg_info
;
374 int returns_abnormally
;
375 int warn_about_return_type
;
379 /* Save lists of labels used or defined in particular contexts.
380 Allocated on the parser obstack. */
384 /* The label at the head of the list. */
386 /* The rest of the list. */
387 struct c_label_list
*next
;
390 /* Statement expression context. */
392 struct c_label_context_se
394 /* The labels defined at this level of nesting. */
395 struct c_label_list
*labels_def
;
396 /* The labels used at this level of nesting. */
397 struct c_label_list
*labels_used
;
398 /* The next outermost context. */
399 struct c_label_context_se
*next
;
402 /* Context of variably modified declarations. */
404 struct c_label_context_vm
406 /* The labels defined at this level of nesting. */
407 struct c_label_list
*labels_def
;
408 /* The labels used at this level of nesting. */
409 struct c_label_list
*labels_used
;
410 /* The scope of this context. Multiple contexts may be at the same
411 numbered scope, since each variably modified declaration starts a
414 /* The next outermost context. */
415 struct c_label_context_vm
*next
;
420 extern void c_parse_init (void);
422 /* in c-aux-info.c */
423 extern void gen_aux_info_record (tree
, int, int, int);
426 extern struct obstack parser_obstack
;
427 extern tree c_break_label
;
428 extern tree c_cont_label
;
430 extern int global_bindings_p (void);
431 extern void push_scope (void);
432 extern tree
pop_scope (void);
433 extern void insert_block (tree
);
434 extern tree
pushdecl (tree
);
435 extern void c_expand_body (tree
);
437 extern void c_init_decl_processing (void);
438 extern void c_dup_lang_specific_decl (tree
);
439 extern void c_print_identifier (FILE *, tree
, int);
440 extern int quals_from_declspecs (const struct c_declspecs
*);
441 extern struct c_declarator
*build_array_declarator (tree
, struct c_declspecs
*,
443 extern tree
build_enumerator (tree
, tree
);
444 extern void check_for_loop_decls (void);
445 extern void mark_forward_parm_decls (void);
446 extern void declare_parm_level (void);
447 extern void undeclared_variable (tree
, location_t
);
448 extern tree
declare_label (tree
);
449 extern tree
define_label (location_t
, tree
);
450 extern void finish_decl (tree
, tree
, tree
);
451 extern tree
finish_enum (tree
, tree
, tree
);
452 extern void finish_function (void);
453 extern tree
finish_struct (tree
, tree
, tree
);
454 extern struct c_arg_info
*get_parm_info (bool);
455 extern tree
grokfield (struct c_declarator
*, struct c_declspecs
*, tree
);
456 extern tree
groktypename (struct c_type_name
*);
457 extern tree
grokparm (const struct c_parm
*);
458 extern tree
implicitly_declare (tree
);
459 extern void keep_next_level (void);
460 extern void pending_xref_error (void);
461 extern void c_push_function_context (struct function
*);
462 extern void c_pop_function_context (struct function
*);
463 extern void push_parm_decl (const struct c_parm
*);
464 extern tree
pushdecl_top_level (tree
);
465 extern struct c_declarator
*set_array_declarator_inner (struct c_declarator
*,
466 struct c_declarator
*,
468 extern tree
builtin_function (const char *, tree
, int, enum built_in_class
,
470 extern void shadow_tag (const struct c_declspecs
*);
471 extern void shadow_tag_warned (const struct c_declspecs
*, int);
472 extern tree
start_enum (tree
);
473 extern int start_function (struct c_declspecs
*, struct c_declarator
*, tree
);
474 extern tree
start_decl (struct c_declarator
*, struct c_declspecs
*, bool,
476 extern tree
start_struct (enum tree_code
, tree
);
477 extern void store_parm_decls (void);
478 extern void store_parm_decls_from (struct c_arg_info
*);
479 extern tree
xref_tag (enum tree_code
, tree
);
480 extern struct c_typespec
parser_xref_tag (enum tree_code
, tree
);
481 extern int c_expand_decl (tree
);
482 extern struct c_parm
*build_c_parm (struct c_declspecs
*, tree
,
483 struct c_declarator
*);
484 extern struct c_declarator
*build_attrs_declarator (tree
,
485 struct c_declarator
*);
486 extern struct c_declarator
*build_function_declarator (struct c_arg_info
*,
487 struct c_declarator
*);
488 extern struct c_declarator
*build_id_declarator (tree
);
489 extern struct c_declarator
*make_pointer_declarator (struct c_declspecs
*,
490 struct c_declarator
*);
491 extern struct c_declspecs
*build_null_declspecs (void);
492 extern struct c_declspecs
*declspecs_add_qual (struct c_declspecs
*, tree
);
493 extern struct c_declspecs
*declspecs_add_type (struct c_declspecs
*,
495 extern struct c_declspecs
*declspecs_add_scspec (struct c_declspecs
*, tree
);
496 extern struct c_declspecs
*declspecs_add_attrs (struct c_declspecs
*, tree
);
497 extern struct c_declspecs
*finish_declspecs (struct c_declspecs
*);
499 /* in c-objc-common.c */
500 extern int c_disregard_inline_limits (tree
);
501 extern int c_cannot_inline_tree_fn (tree
*);
502 extern bool c_objc_common_init (void);
503 extern bool c_missing_noreturn_ok_p (tree
);
504 extern tree
c_objc_common_truthvalue_conversion (tree expr
);
505 extern bool c_warn_unused_global_decl (tree
);
506 extern void c_initialize_diagnostics (diagnostic_context
*);
508 #define c_build_type_variant(TYPE, CONST_P, VOLATILE_P) \
509 c_build_qualified_type ((TYPE), \
510 ((CONST_P) ? TYPE_QUAL_CONST : 0) | \
511 ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
514 extern int in_alignof
;
515 extern int in_sizeof
;
516 extern int in_typeof
;
518 extern struct c_switch
*c_switch_stack
;
519 extern struct c_label_context_se
*label_context_stack_se
;
520 extern struct c_label_context_vm
*label_context_stack_vm
;
522 extern tree
require_complete_type (tree
);
523 extern int same_translation_unit_p (tree
, tree
);
524 extern int comptypes (tree
, tree
);
525 extern bool c_mark_addressable (tree
);
526 extern void c_incomplete_type_error (tree
, tree
);
527 extern tree
c_type_promotes_to (tree
);
528 extern tree
default_conversion (tree
);
529 extern struct c_expr
default_function_array_conversion (struct c_expr
);
530 extern tree
composite_type (tree
, tree
);
531 extern tree
build_component_ref (tree
, tree
);
532 extern tree
build_indirect_ref (tree
, const char *);
533 extern tree
build_array_ref (tree
, tree
);
534 extern tree
build_external_ref (tree
, int, location_t
);
535 extern void pop_maybe_used (bool);
536 extern struct c_expr
c_expr_sizeof_expr (struct c_expr
);
537 extern struct c_expr
c_expr_sizeof_type (struct c_type_name
*);
538 extern struct c_expr
parser_build_unary_op (enum tree_code
, struct c_expr
);
539 extern struct c_expr
parser_build_binary_op (enum tree_code
, struct c_expr
,
541 extern tree
build_conditional_expr (tree
, tree
, tree
);
542 extern tree
build_compound_expr (tree
, tree
);
543 extern tree
c_cast_expr (struct c_type_name
*, tree
);
544 extern tree
build_c_cast (tree
, tree
);
545 extern tree
build_modify_expr (tree
, enum tree_code
, tree
);
546 extern void store_init_value (tree
, tree
);
547 extern void error_init (const char *);
548 extern void pedwarn_init (const char *);
549 extern void maybe_warn_string_init (tree
, struct c_expr
);
550 extern void start_init (tree
, tree
, int);
551 extern void finish_init (void);
552 extern void really_start_incremental_init (tree
);
553 extern void push_init_level (int);
554 extern struct c_expr
pop_init_level (int);
555 extern void set_init_index (tree
, tree
);
556 extern void set_init_label (tree
);
557 extern void process_init_element (struct c_expr
);
558 extern tree
build_compound_literal (tree
, tree
);
559 extern tree
c_start_case (tree
);
560 extern void c_finish_case (tree
);
561 extern tree
build_asm_expr (tree
, tree
, tree
, tree
, bool);
562 extern tree
build_asm_stmt (tree
, tree
);
563 extern tree
c_convert_parm_for_inlining (tree
, tree
, tree
, int);
564 extern int c_types_compatible_p (tree
, tree
);
565 extern tree
c_begin_compound_stmt (bool);
566 extern tree
c_end_compound_stmt (tree
, bool);
567 extern void c_finish_if_stmt (location_t
, tree
, tree
, tree
, bool);
568 extern void c_finish_loop (location_t
, tree
, tree
, tree
, tree
, tree
, bool);
569 extern tree
c_begin_stmt_expr (void);
570 extern tree
c_finish_stmt_expr (tree
);
571 extern tree
c_process_expr_stmt (tree
);
572 extern tree
c_finish_expr_stmt (tree
);
573 extern tree
c_finish_return (tree
);
574 extern tree
c_finish_bc_stmt (tree
*, bool);
575 extern tree
c_finish_goto_label (tree
);
576 extern tree
c_finish_goto_ptr (tree
);
577 extern void c_begin_vm_scope (unsigned int);
578 extern void c_end_vm_scope (unsigned int);
579 extern tree
c_expr_to_decl (tree
, bool *, bool *, bool *);
581 /* Set to 0 at beginning of a function definition, set to 1 if
582 a return statement that specifies a return value is seen. */
584 extern int current_function_returns_value
;
586 /* Set to 0 at beginning of a function definition, set to 1 if
587 a return statement with no argument is seen. */
589 extern int current_function_returns_null
;
591 /* Set to 0 at beginning of a function definition, set to 1 if
592 a call to a noreturn function is seen. */
594 extern int current_function_returns_abnormally
;
596 /* Nonzero means we are reading code that came from a system header file. */
598 extern int system_header_p
;
600 /* True means global_bindings_p should return false even if the scope stack
601 says we are in file scope. */
603 extern bool c_override_global_bindings_to_false
;
605 /* True means we've initialized exception handling. */
606 extern bool c_eh_initialized_p
;
609 extern void c_finish_incomplete_decl (tree
);
610 extern void c_write_global_declarations (void);
612 /* In order for the format checking to accept the C frontend
613 diagnostic framework extensions, you must include this file before
614 toplev.h, not after. */
615 #if GCC_VERSION >= 4001
616 #define ATTRIBUTE_GCC_CDIAG(m, n) __attribute__ ((__format__ (GCC_DIAG_STYLE, m ,n))) ATTRIBUTE_NONNULL(m)
618 #define ATTRIBUTE_GCC_CDIAG(m, n) ATTRIBUTE_NONNULL(m)
621 extern void pedwarn_c90 (const char *, ...) ATTRIBUTE_GCC_CDIAG(1,2);
622 extern void pedwarn_c99 (const char *, ...) ATTRIBUTE_GCC_CDIAG(1,2);
624 #endif /* ! GCC_C_TREE_H */