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 /* Record whether a variable has been declared threadprivate by
133 #pragma omp threadprivate. */
134 #define C_DECL_THREADPRIVATE_P(DECL) DECL_LANG_FLAG_3 (VAR_DECL_CHECK (DECL))
136 /* Nonzero for a decl which either doesn't exist or isn't a prototype.
137 N.B. Could be simplified if all built-in decls had complete prototypes
138 (but this is presently difficult because some of them need FILE*). */
139 #define C_DECL_ISNT_PROTOTYPE(EXP) \
141 || (TYPE_ARG_TYPES (TREE_TYPE (EXP)) == 0 \
142 && !DECL_BUILT_IN (EXP)))
144 /* For FUNCTION_TYPE, a hidden list of types of arguments. The same as
145 TYPE_ARG_TYPES for functions with prototypes, but created for functions
146 without prototypes. */
147 #define TYPE_ACTUAL_ARG_TYPES(NODE) TYPE_LANG_SLOT_1 (NODE)
149 /* Record parser information about an expression that is irrelevant
150 for code generation alongside a tree representing its value. */
153 /* The value of the expression. */
155 /* Record the original binary operator of an expression, which may
156 have been changed by fold, STRING_CST for unparenthesized string
157 constants, or ERROR_MARK for other expressions (including
158 parenthesized expressions). */
159 enum tree_code original_code
;
162 /* A kind of type specifier. Note that this information is currently
163 only used to distinguish tag definitions, tag references and typeof
165 enum c_typespec_kind
{
166 /* A reserved keyword type specifier. */
168 /* A reference to a tag, previously declared, such as "struct foo".
169 This includes where the previous declaration was as a different
170 kind of tag, in which case this is only valid if shadowing that
171 tag in an inner scope. */
173 /* A reference to a tag, not previously declared in a visible
176 /* A definition of a tag such as "struct foo { int a; }". */
178 /* A typedef name. */
180 /* An ObjC-specific kind of type specifier. */
182 /* A typeof specifier. */
186 /* A type specifier: this structure is created in the parser and
187 passed to declspecs_add_type only. */
189 /* What kind of type specifier this is. */
190 enum c_typespec_kind kind
;
191 /* The specifier itself. */
195 /* A storage class specifier. */
196 enum c_storage_class
{
205 /* A type specifier keyword "void", "_Bool", "char", "int", "float",
206 "double", or none of these. */
207 enum c_typespec_keyword
{
220 /* A sequence of declaration specifiers in C. */
222 /* The type specified, if a single type specifier such as a struct,
223 union or enum specifier, typedef name or typeof specifies the
224 whole type, or NULL_TREE if none or a keyword such as "void" or
225 "char" is used. Does not include qualifiers. */
227 /* The attributes from a typedef decl. */
229 /* When parsing, the attributes. Outside the parser, this will be
230 NULL; attributes (possibly from multiple lists) will be passed
233 /* Any type specifier keyword used such as "int", not reflecting
234 modifiers such as "short", or cts_none if none. */
235 enum c_typespec_keyword typespec_word
;
236 /* The storage class specifier, or csc_none if none. */
237 enum c_storage_class storage_class
;
238 /* Whether any declaration specifiers have been seen at all. */
239 BOOL_BITFIELD declspecs_seen_p
: 1;
240 /* Whether a type specifier has been seen. */
241 BOOL_BITFIELD type_seen_p
: 1;
242 /* Whether something other than a storage class specifier or
243 attribute has been seen. This is used to warn for the
244 obsolescent usage of storage class specifiers other than at the
245 start of the list. (Doing this properly would require function
246 specifiers to be handled separately from storage class
248 BOOL_BITFIELD non_sc_seen_p
: 1;
249 /* Whether the type is specified by a typedef or typeof name. */
250 BOOL_BITFIELD typedef_p
: 1;
251 /* Whether a struct, union or enum type either had its content
252 defined by a type specifier in the list or was the first visible
253 declaration of its tag. */
254 BOOL_BITFIELD tag_defined_p
: 1;
255 /* Whether the type is explicitly "signed" or specified by a typedef
256 whose type is explicitly "signed". */
257 BOOL_BITFIELD explicit_signed_p
: 1;
258 /* Whether the specifiers include a deprecated typedef. */
259 BOOL_BITFIELD deprecated_p
: 1;
260 /* Whether the type defaulted to "int" because there were no type
262 BOOL_BITFIELD default_int_p
;
263 /* Whether "long" was specified. */
264 BOOL_BITFIELD long_p
: 1;
265 /* Whether "long" was specified more than once. */
266 BOOL_BITFIELD long_long_p
: 1;
267 /* Whether "short" was specified. */
268 BOOL_BITFIELD short_p
: 1;
269 /* Whether "signed" was specified. */
270 BOOL_BITFIELD signed_p
: 1;
271 /* Whether "unsigned" was specified. */
272 BOOL_BITFIELD unsigned_p
: 1;
273 /* Whether "complex" was specified. */
274 BOOL_BITFIELD complex_p
: 1;
275 /* Whether "inline" was specified. */
276 BOOL_BITFIELD inline_p
: 1;
277 /* Whether "__thread" was specified. */
278 BOOL_BITFIELD thread_p
: 1;
279 /* Whether "const" was specified. */
280 BOOL_BITFIELD const_p
: 1;
281 /* Whether "volatile" was specified. */
282 BOOL_BITFIELD volatile_p
: 1;
283 /* Whether "restrict" was specified. */
284 BOOL_BITFIELD restrict_p
: 1;
287 /* The various kinds of declarators in C. */
288 enum c_declarator_kind
{
297 /* Parenthesized declarator with nested attributes. */
301 /* Information about the parameters in a function declarator. */
303 /* A list of parameter decls. */
305 /* A list of structure, union and enum tags defined. */
307 /* A list of argument types to go in the FUNCTION_TYPE. */
309 /* A list of non-parameter decls (notably enumeration constants)
310 defined with the parameters. */
312 /* True when these arguments had [*]. */
313 BOOL_BITFIELD had_vla_unspec
: 1;
317 struct c_declarator
{
318 /* The kind of declarator. */
319 enum c_declarator_kind kind
;
320 /* Except for cdk_id, the contained declarator. For cdk_id, NULL. */
321 struct c_declarator
*declarator
;
322 location_t id_loc
; /* Currently only set for cdk_id. */
324 /* For identifiers, an IDENTIFIER_NODE or NULL_TREE if an abstract
328 struct c_arg_info
*arg_info
;
331 /* The array dimension, or NULL for [] and [*]. */
333 /* The qualifiers inside []. */
335 /* The attributes (currently ignored) inside []. */
337 /* Whether [static] was used. */
338 BOOL_BITFIELD static_p
: 1;
339 /* Whether [*] was used. */
340 BOOL_BITFIELD vla_unspec_p
: 1;
342 /* For pointers, the qualifiers on the pointer type. */
344 /* For attributes. */
351 /* The declaration specifiers. */
352 struct c_declspecs
*specs
;
353 /* The declarator. */
354 struct c_declarator
*declarator
;
359 /* The declaration specifiers, minus any prefix attributes. */
360 struct c_declspecs
*specs
;
361 /* The attributes. */
363 /* The declarator. */
364 struct c_declarator
*declarator
;
367 /* Save and restore the variables in this file and elsewhere
368 that keep track of the progress of compilation of the current function.
369 Used for nested functions. */
371 struct language_function
GTY(())
373 struct c_language_function base
;
376 struct c_switch
* GTY((skip
)) x_switch_stack
;
377 struct c_arg_info
* GTY((skip
)) arg_info
;
380 int returns_abnormally
;
381 int warn_about_return_type
;
385 /* Save lists of labels used or defined in particular contexts.
386 Allocated on the parser obstack. */
390 /* The label at the head of the list. */
392 /* The rest of the list. */
393 struct c_label_list
*next
;
396 /* Statement expression context. */
398 struct c_label_context_se
400 /* The labels defined at this level of nesting. */
401 struct c_label_list
*labels_def
;
402 /* The labels used at this level of nesting. */
403 struct c_label_list
*labels_used
;
404 /* The next outermost context. */
405 struct c_label_context_se
*next
;
408 /* Context of variably modified declarations. */
410 struct c_label_context_vm
412 /* The labels defined at this level of nesting. */
413 struct c_label_list
*labels_def
;
414 /* The labels used at this level of nesting. */
415 struct c_label_list
*labels_used
;
416 /* The scope of this context. Multiple contexts may be at the same
417 numbered scope, since each variably modified declaration starts a
420 /* The next outermost context. */
421 struct c_label_context_vm
*next
;
426 extern void c_parse_init (void);
428 /* in c-aux-info.c */
429 extern void gen_aux_info_record (tree
, int, int, int);
432 extern struct obstack parser_obstack
;
433 extern tree c_break_label
;
434 extern tree c_cont_label
;
436 extern int global_bindings_p (void);
437 extern void push_scope (void);
438 extern tree
pop_scope (void);
439 extern void insert_block (tree
);
440 extern void c_expand_body (tree
);
442 extern void c_init_decl_processing (void);
443 extern void c_dup_lang_specific_decl (tree
);
444 extern void c_print_identifier (FILE *, tree
, int);
445 extern int quals_from_declspecs (const struct c_declspecs
*);
446 extern struct c_declarator
*build_array_declarator (tree
, struct c_declspecs
*,
448 extern tree
build_enumerator (tree
, tree
);
449 extern tree
check_for_loop_decls (void);
450 extern void mark_forward_parm_decls (void);
451 extern void declare_parm_level (void);
452 extern void undeclared_variable (tree
, location_t
);
453 extern tree
declare_label (tree
);
454 extern tree
define_label (location_t
, tree
);
455 extern void finish_decl (tree
, tree
, tree
);
456 extern tree
finish_enum (tree
, tree
, tree
);
457 extern void finish_function (void);
458 extern tree
finish_struct (tree
, tree
, tree
);
459 extern struct c_arg_info
*get_parm_info (bool);
460 extern tree
grokfield (struct c_declarator
*, struct c_declspecs
*, tree
);
461 extern tree
groktypename (struct c_type_name
*);
462 extern tree
grokparm (const struct c_parm
*);
463 extern tree
implicitly_declare (tree
);
464 extern void keep_next_level (void);
465 extern void pending_xref_error (void);
466 extern void c_push_function_context (struct function
*);
467 extern void c_pop_function_context (struct function
*);
468 extern void push_parm_decl (const struct c_parm
*);
469 extern struct c_declarator
*set_array_declarator_inner (struct c_declarator
*,
470 struct c_declarator
*,
472 extern tree
builtin_function (const char *, tree
, int, enum built_in_class
,
474 extern void shadow_tag (const struct c_declspecs
*);
475 extern void shadow_tag_warned (const struct c_declspecs
*, int);
476 extern tree
start_enum (tree
);
477 extern int start_function (struct c_declspecs
*, struct c_declarator
*, tree
);
478 extern tree
start_decl (struct c_declarator
*, struct c_declspecs
*, bool,
480 extern tree
start_struct (enum tree_code
, tree
);
481 extern void store_parm_decls (void);
482 extern void store_parm_decls_from (struct c_arg_info
*);
483 extern tree
xref_tag (enum tree_code
, tree
);
484 extern struct c_typespec
parser_xref_tag (enum tree_code
, tree
);
485 extern int c_expand_decl (tree
);
486 extern struct c_parm
*build_c_parm (struct c_declspecs
*, tree
,
487 struct c_declarator
*);
488 extern struct c_declarator
*build_attrs_declarator (tree
,
489 struct c_declarator
*);
490 extern struct c_declarator
*build_function_declarator (struct c_arg_info
*,
491 struct c_declarator
*);
492 extern struct c_declarator
*build_id_declarator (tree
);
493 extern struct c_declarator
*make_pointer_declarator (struct c_declspecs
*,
494 struct c_declarator
*);
495 extern struct c_declspecs
*build_null_declspecs (void);
496 extern struct c_declspecs
*declspecs_add_qual (struct c_declspecs
*, tree
);
497 extern struct c_declspecs
*declspecs_add_type (struct c_declspecs
*,
499 extern struct c_declspecs
*declspecs_add_scspec (struct c_declspecs
*, tree
);
500 extern struct c_declspecs
*declspecs_add_attrs (struct c_declspecs
*, tree
);
501 extern struct c_declspecs
*finish_declspecs (struct c_declspecs
*);
503 /* in c-objc-common.c */
504 extern int c_disregard_inline_limits (tree
);
505 extern int c_cannot_inline_tree_fn (tree
*);
506 extern bool c_objc_common_init (void);
507 extern bool c_missing_noreturn_ok_p (tree
);
508 extern tree
c_objc_common_truthvalue_conversion (tree expr
);
509 extern bool c_warn_unused_global_decl (tree
);
510 extern void c_initialize_diagnostics (diagnostic_context
*);
511 extern bool c_vla_unspec_p (tree x
, tree fn
);
513 #define c_build_type_variant(TYPE, CONST_P, VOLATILE_P) \
514 c_build_qualified_type ((TYPE), \
515 ((CONST_P) ? TYPE_QUAL_CONST : 0) | \
516 ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
519 extern int in_alignof
;
520 extern int in_sizeof
;
521 extern int in_typeof
;
523 extern struct c_switch
*c_switch_stack
;
524 extern struct c_label_context_se
*label_context_stack_se
;
525 extern struct c_label_context_vm
*label_context_stack_vm
;
527 extern tree
require_complete_type (tree
);
528 extern int same_translation_unit_p (tree
, tree
);
529 extern int comptypes (tree
, tree
);
530 extern bool c_vla_type_p (tree
);
531 extern bool c_mark_addressable (tree
);
532 extern void c_incomplete_type_error (tree
, tree
);
533 extern tree
c_type_promotes_to (tree
);
534 extern struct c_expr
default_function_array_conversion (struct c_expr
);
535 extern tree
composite_type (tree
, tree
);
536 extern tree
build_component_ref (tree
, tree
);
537 extern tree
build_array_ref (tree
, tree
);
538 extern tree
build_external_ref (tree
, int, location_t
);
539 extern void pop_maybe_used (bool);
540 extern struct c_expr
c_expr_sizeof_expr (struct c_expr
);
541 extern struct c_expr
c_expr_sizeof_type (struct c_type_name
*);
542 extern struct c_expr
parser_build_unary_op (enum tree_code
, struct c_expr
);
543 extern struct c_expr
parser_build_binary_op (enum tree_code
, struct c_expr
,
545 extern tree
build_conditional_expr (tree
, tree
, tree
);
546 extern tree
build_compound_expr (tree
, tree
);
547 extern tree
c_cast_expr (struct c_type_name
*, tree
);
548 extern tree
build_c_cast (tree
, tree
);
549 extern void store_init_value (tree
, tree
);
550 extern void error_init (const char *);
551 extern void pedwarn_init (const char *);
552 extern void maybe_warn_string_init (tree
, struct c_expr
);
553 extern void start_init (tree
, tree
, int);
554 extern void finish_init (void);
555 extern void really_start_incremental_init (tree
);
556 extern void push_init_level (int);
557 extern struct c_expr
pop_init_level (int);
558 extern void set_init_index (tree
, tree
);
559 extern void set_init_label (tree
);
560 extern void process_init_element (struct c_expr
);
561 extern tree
build_compound_literal (tree
, tree
);
562 extern tree
c_start_case (tree
);
563 extern void c_finish_case (tree
);
564 extern tree
build_asm_expr (tree
, tree
, tree
, tree
, bool);
565 extern tree
build_asm_stmt (tree
, tree
);
566 extern tree
c_convert_parm_for_inlining (tree
, tree
, tree
, int);
567 extern int c_types_compatible_p (tree
, tree
);
568 extern tree
c_begin_compound_stmt (bool);
569 extern tree
c_end_compound_stmt (tree
, bool);
570 extern void c_finish_if_stmt (location_t
, tree
, tree
, tree
, bool);
571 extern void c_finish_loop (location_t
, tree
, tree
, tree
, tree
, tree
, bool);
572 extern tree
c_begin_stmt_expr (void);
573 extern tree
c_finish_stmt_expr (tree
);
574 extern tree
c_process_expr_stmt (tree
);
575 extern tree
c_finish_expr_stmt (tree
);
576 extern tree
c_finish_return (tree
);
577 extern tree
c_finish_bc_stmt (tree
*, bool);
578 extern tree
c_finish_goto_label (tree
);
579 extern tree
c_finish_goto_ptr (tree
);
580 extern void c_begin_vm_scope (unsigned int);
581 extern void c_end_vm_scope (unsigned int);
582 extern tree
c_expr_to_decl (tree
, bool *, bool *, bool *);
583 extern tree
c_begin_omp_parallel (void);
584 extern tree
c_finish_omp_parallel (tree
, tree
);
585 extern tree
c_finish_omp_clauses (tree
);
587 /* Set to 0 at beginning of a function definition, set to 1 if
588 a return statement that specifies a return value is seen. */
590 extern int current_function_returns_value
;
592 /* Set to 0 at beginning of a function definition, set to 1 if
593 a return statement with no argument is seen. */
595 extern int current_function_returns_null
;
597 /* Set to 0 at beginning of a function definition, set to 1 if
598 a call to a noreturn function is seen. */
600 extern int current_function_returns_abnormally
;
602 /* Nonzero means we are reading code that came from a system header file. */
604 extern int system_header_p
;
606 /* True means global_bindings_p should return false even if the scope stack
607 says we are in file scope. */
609 extern bool c_override_global_bindings_to_false
;
611 /* True means we've initialized exception handling. */
612 extern bool c_eh_initialized_p
;
615 extern void c_finish_incomplete_decl (tree
);
616 extern void c_write_global_declarations (void);
618 /* In order for the format checking to accept the C frontend
619 diagnostic framework extensions, you must include this file before
620 toplev.h, not after. */
621 #if GCC_VERSION >= 4001
622 #define ATTRIBUTE_GCC_CDIAG(m, n) __attribute__ ((__format__ (GCC_DIAG_STYLE, m ,n))) ATTRIBUTE_NONNULL(m)
624 #define ATTRIBUTE_GCC_CDIAG(m, n) ATTRIBUTE_NONNULL(m)
627 extern void pedwarn_c90 (const char *, ...) ATTRIBUTE_GCC_CDIAG(1,2);
628 extern void pedwarn_c99 (const char *, ...) ATTRIBUTE_GCC_CDIAG(1,2);
630 #endif /* ! GCC_C_TREE_H */