c-tree.h revision 52300
1/* Definitions for C parsing and type checking.
2   Copyright (C) 1987, 93, 94, 95, 97, 98, 1999 Free Software Foundation, Inc.
3
4This file is part of GNU CC.
5
6GNU CC is free software; you can redistribute it and/or modify
7it under the terms of the GNU General Public License as published by
8the Free Software Foundation; either version 2, or (at your option)
9any later version.
10
11GNU CC is distributed in the hope that it will be useful,
12but WITHOUT ANY WARRANTY; without even the implied warranty of
13MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14GNU General Public License for more details.
15
16You should have received a copy of the GNU General Public License
17along with GNU CC; see the file COPYING.  If not, write to
18the Free Software Foundation, 59 Temple Place - Suite 330,
19Boston, MA 02111-1307, USA.  */
20
21/* $FreeBSD: head/contrib/gcc/c-tree.h 52300 1999-10-16 08:34:33Z obrien $ */
22
23#ifndef _C_TREE_H
24#define _C_TREE_H
25
26/* Language-dependent contents of an identifier.  */
27
28/* The limbo_value is used for block level extern declarations, which need
29   to be type checked against subsequent extern declarations.  They can't
30   be referenced after they fall out of scope, so they can't be global.  */
31
32struct lang_identifier
33{
34  struct tree_identifier ignore;
35  tree global_value, local_value, label_value, implicit_decl;
36  tree error_locus, limbo_value;
37};
38
39/* Macros for access to language-specific slots in an identifier.  */
40/* Each of these slots contains a DECL node or null.  */
41
42/* This represents the value which the identifier has in the
43   file-scope namespace.  */
44#define IDENTIFIER_GLOBAL_VALUE(NODE)	\
45  (((struct lang_identifier *) (NODE))->global_value)
46/* This represents the value which the identifier has in the current
47   scope.  */
48#define IDENTIFIER_LOCAL_VALUE(NODE)	\
49  (((struct lang_identifier *) (NODE))->local_value)
50/* This represents the value which the identifier has as a label in
51   the current label scope.  */
52#define IDENTIFIER_LABEL_VALUE(NODE)	\
53  (((struct lang_identifier *) (NODE))->label_value)
54/* This records the extern decl of this identifier, if it has had one
55   at any point in this compilation.  */
56#define IDENTIFIER_LIMBO_VALUE(NODE)	\
57  (((struct lang_identifier *) (NODE))->limbo_value)
58/* This records the implicit function decl of this identifier, if it
59   has had one at any point in this compilation.  */
60#define IDENTIFIER_IMPLICIT_DECL(NODE)	\
61  (((struct lang_identifier *) (NODE))->implicit_decl)
62/* This is the last function in which we printed an "undefined variable"
63   message for this identifier.  Value is a FUNCTION_DECL or null.  */
64#define IDENTIFIER_ERROR_LOCUS(NODE)	\
65  (((struct lang_identifier *) (NODE))->error_locus)
66
67/* In identifiers, C uses the following fields in a special way:
68   TREE_PUBLIC        to record that there was a previous local extern decl.
69   TREE_USED          to record that such a decl was used.
70   TREE_ADDRESSABLE   to record that the address of such a decl was used.  */
71
72/* Nonzero means reject anything that ANSI standard C forbids.  */
73extern int pedantic;
74
75/* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is read-only.  */
76#define C_TYPE_FIELDS_READONLY(type) TREE_LANG_FLAG_1 (type)
77
78/* In a RECORD_TYPE or UNION_TYPE, nonzero if any component is volatile.  */
79#define C_TYPE_FIELDS_VOLATILE(type) TREE_LANG_FLAG_2 (type)
80
81/* In a RECORD_TYPE or UNION_TYPE or ENUMERAL_TYPE
82   nonzero if the definition of the type has already started.  */
83#define C_TYPE_BEING_DEFINED(type) TYPE_LANG_FLAG_0 (type)
84
85/* C types are partitioned into three subsets: object, function, and
86   incomplete types.  */
87#define C_TYPE_OBJECT_P(type) \
88  (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
89
90#define C_TYPE_FUNCTION_P(type) \
91  (TREE_CODE (type) == FUNCTION_TYPE)
92
93#define C_TYPE_INCOMPLETE_P(type) \
94  (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
95
96/* For convenience we define a single macro to identify the class of
97   object or incomplete types.  */
98#define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
99  (!C_TYPE_FUNCTION_P (type))
100
101/* In a RECORD_TYPE, a sorted array of the fields of the type.  */
102struct lang_type
103{
104  int len;
105  tree elts[1];
106};
107
108/* Mark which labels are explicitly declared.
109   These may be shadowed, and may be referenced from nested functions.  */
110#define C_DECLARED_LABEL_FLAG(label) TREE_LANG_FLAG_1 (label)
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/* Record in each node resulting from a binary operator
118   what operator was specified for it.  */
119#define C_EXP_ORIGINAL_CODE(exp) ((enum tree_code) TREE_COMPLEXITY (exp))
120
121#if 0 /* Not used.  */
122/* Record whether a decl for a function or function pointer has
123   already been mentioned (in a warning) because it was called
124   but didn't have a prototype.  */
125#define C_MISSING_PROTOTYPE_WARNED(decl) DECL_LANG_FLAG_2(decl)
126#endif
127
128/* Store a value in that field.  */
129#define C_SET_EXP_ORIGINAL_CODE(exp, code) \
130  (TREE_COMPLEXITY (exp) = (int) (code))
131
132/* Record whether a typedef for type `int' was actually `signed int'.  */
133#define C_TYPEDEF_EXPLICITLY_SIGNED(exp) DECL_LANG_FLAG_1 ((exp))
134
135/* Nonzero for a declaration of a built in function if there has been no
136   occasion that would declare the function in ordinary C.
137   Using the function draws a pedantic warning in this case.  */
138#define C_DECL_ANTICIPATED(exp) DECL_LANG_FLAG_3 ((exp))
139
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_NONCOPIED_PARTS (NODE)
144
145/* In a FIELD_DECL, nonzero if the decl was originally a bitfield.  */
146#define DECL_C_BIT_FIELD(NODE) DECL_LANG_FLAG_4 (NODE)
147
148/* Nonzero if the type T promotes to itself.
149   ANSI C states explicitly the list of types that promote;
150   in particular, short promotes to int even if they have the same width.  */
151#define C_PROMOTING_INTEGER_TYPE_P(t)				\
152  (TREE_CODE ((t)) == INTEGER_TYPE				\
153   && (TYPE_MAIN_VARIANT (t) == char_type_node			\
154       || TYPE_MAIN_VARIANT (t) == signed_char_type_node	\
155       || TYPE_MAIN_VARIANT (t) == unsigned_char_type_node	\
156       || TYPE_MAIN_VARIANT (t) == short_integer_type_node	\
157       || TYPE_MAIN_VARIANT (t) == short_unsigned_type_node))
158
159/* In a VAR_DECL, means the variable is really an iterator.  */
160#define ITERATOR_P(D) (DECL_LANG_FLAG_4(D))
161
162/* In a VAR_DECL for an iterator, means we are within
163   an explicit loop over that iterator.  */
164#define ITERATOR_BOUND_P(NODE) ((NODE)->common.readonly_flag)
165
166/* in c-lang.c and objc-act.c */
167extern tree lookup_interface			PROTO((tree));
168extern tree is_class_name			PROTO((tree));
169extern void maybe_objc_check_decl		PROTO((tree));
170extern void finish_file				PROTO((void));
171extern int maybe_objc_comptypes                 PROTO((tree, tree, int));
172extern tree maybe_building_objc_message_expr    PROTO((void));
173extern tree maybe_objc_method_name		PROTO((tree));
174extern int recognize_objc_keyword		PROTO((void));
175extern tree build_objc_string			PROTO((int, const char *));
176
177/* in c-aux-info.c */
178extern void gen_aux_info_record                 PROTO((tree, int, int, int));
179
180/* in c-common.c */
181extern void declare_function_name               PROTO((void));
182extern void decl_attributes                     PROTO((tree, tree, tree));
183extern void init_function_format_info		PROTO((void));
184extern void check_function_format		PROTO((tree, tree, tree));
185extern int c_get_alias_set                      PROTO((tree));
186extern void c_apply_type_quals_to_decl          PROTO((int, tree));
187/* Print an error message for invalid operands to arith operation CODE.
188   NOP_EXPR is used as a special case (see truthvalue_conversion).  */
189extern void binary_op_error                     PROTO((enum tree_code));
190extern void c_expand_expr_stmt                  PROTO((tree));
191extern void c_expand_start_cond                 PROTO((tree, int, int));
192extern void c_expand_start_else                 PROTO((void));
193extern void c_expand_end_cond                   PROTO((void));
194/* Validate the expression after `case' and apply default promotions.  */
195extern tree check_case_value                    PROTO((tree));
196/* Concatenate a list of STRING_CST nodes into one STRING_CST.  */
197extern tree combine_strings                     PROTO((tree));
198extern void constant_expression_warning         PROTO((tree));
199extern tree convert_and_check			PROTO((tree, tree));
200extern void overflow_warning			PROTO((tree));
201extern void unsigned_conversion_warning		PROTO((tree, tree));
202/* Read the rest of the current #-directive line.  */
203#if USE_CPPLIB
204extern char *get_directive_line                 PROTO((void));
205#define GET_DIRECTIVE_LINE() get_directive_line ()
206#else
207extern char *get_directive_line                 PROTO((FILE *));
208#define GET_DIRECTIVE_LINE() get_directive_line (finput)
209#endif
210
211/* Subroutine of build_binary_op, used for comparison operations.
212   See if the operands have both been converted from subword integer types
213   and, if so, perhaps change them both back to their original type.  */
214extern tree shorten_compare                     PROTO((tree *, tree *, tree *, enum tree_code *));
215/* Prepare expr to be an argument of a TRUTH_NOT_EXPR,
216   or validate its data type for an `if' or `while' statement or ?..: exp. */
217extern tree truthvalue_conversion               PROTO((tree));
218extern tree type_for_mode                       PROTO((enum machine_mode, int));
219extern tree type_for_size                       PROTO((unsigned, int));
220
221/* in c-convert.c */
222extern tree convert                             PROTO((tree, tree));
223
224/* in c-decl.c */
225/* Standard named or nameless data types of the C compiler.  */
226extern tree char_array_type_node;
227extern tree char_type_node;
228extern tree const_ptr_type_node;
229extern tree const_string_type_node;
230extern tree default_function_type;
231extern tree double_ftype_double;
232extern tree double_ftype_double_double;
233extern tree double_type_node;
234extern tree float_type_node;
235#if HOST_BITS_PER_WIDE_INT >= 64
236extern tree intTI_type_node;
237#endif
238extern tree intDI_type_node;
239extern tree intHI_type_node;
240extern tree intQI_type_node;
241extern tree intSI_type_node;
242extern tree int_array_type_node;
243extern tree int_ftype_cptr_cptr_sizet;
244extern tree int_ftype_int;
245extern tree int_ftype_ptr_ptr_int;
246extern tree int_ftype_string_string;
247extern tree integer_type_node;
248extern tree long_double_type_node;
249extern tree long_ftype_long;
250extern tree long_integer_type_node;
251extern tree long_long_integer_type_node;
252extern tree long_long_unsigned_type_node;
253extern tree long_unsigned_type_node;
254extern tree complex_integer_type_node;
255extern tree complex_float_type_node;
256extern tree complex_double_type_node;
257extern tree complex_long_double_type_node;
258extern tree ptr_type_node;
259extern tree ptrdiff_type_node;
260extern tree short_integer_type_node;
261extern tree short_unsigned_type_node;
262extern tree signed_char_type_node;
263extern tree signed_wchar_type_node;
264extern tree string_ftype_ptr_ptr;
265extern tree string_type_node;
266extern tree unsigned_char_type_node;
267#if HOST_BITS_PER_WIDE_INT >= 64
268extern tree unsigned_intTI_type_node;
269#endif
270extern tree unsigned_intDI_type_node;
271extern tree unsigned_intHI_type_node;
272extern tree unsigned_intQI_type_node;
273extern tree unsigned_intSI_type_node;
274extern tree unsigned_type_node;
275extern tree unsigned_wchar_type_node;
276extern tree void_ftype_ptr_int_int;
277extern tree void_ftype_ptr_ptr_int;
278extern tree void_type_node;
279extern tree wchar_array_type_node;
280extern tree wchar_type_node;
281extern tree boolean_type_node;
282extern tree boolean_true_node;
283extern tree boolean_false_node;
284
285extern tree build_enumerator                    PROTO((tree, tree));
286/* Declare a predefined function.  Return the declaration.  */
287extern tree builtin_function                    PROTO((const char *, tree, enum built_in_function function_, const char *));
288/* Add qualifiers to a type, in the fashion for C.  */
289extern tree c_build_qualified_type              PROTO((tree, int));
290#define c_build_type_variant(TYPE, CONST_P, VOLATILE_P)		  \
291  c_build_qualified_type (TYPE, 				  \
292			  ((CONST_P) ? TYPE_QUAL_CONST : 0) |	  \
293			  ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
294extern int  c_decode_option                     PROTO((int, char **));
295extern void c_mark_varargs                      PROTO((void));
296extern tree check_identifier                    PROTO((tree, tree));
297extern void clear_parm_order                    PROTO((void));
298extern tree combine_parm_decls                  PROTO((tree, tree, int));
299extern int  complete_array_type                 PROTO((tree, tree, int));
300extern void declare_parm_level                  PROTO((int));
301extern tree define_label                        PROTO((char *, int, tree));
302extern void delete_block                        PROTO((tree));
303extern void finish_decl                         PROTO((tree, tree, tree));
304extern void finish_decl_top_level               PROTO((tree, tree, tree));
305extern tree finish_enum                         PROTO((tree, tree, tree));
306extern void finish_function                     PROTO((int));
307extern tree finish_struct                       PROTO((tree, tree, tree));
308extern tree get_parm_info                       PROTO((int));
309extern tree getdecls                            PROTO((void));
310extern tree gettags                             PROTO((void));
311extern int  global_bindings_p                   PROTO((void));
312extern tree grokfield                           PROTO((const char *, int, tree, tree, tree));
313extern tree groktypename                        PROTO((tree));
314extern tree groktypename_in_parm_context        PROTO((tree));
315extern tree implicitly_declare                  PROTO((tree));
316extern int  in_parm_level_p                     PROTO((void));
317extern void init_decl_processing                PROTO((void));
318extern void insert_block                        PROTO((tree));
319extern void keep_next_level                     PROTO((void));
320extern int  kept_level_p                        PROTO((void));
321extern tree lookup_label                        PROTO((tree));
322extern tree lookup_name                         PROTO((tree));
323extern tree lookup_name_current_level		PROTO((tree));
324extern tree lookup_name_current_level_global	PROTO((tree));
325extern tree maybe_build_cleanup                 PROTO((tree));
326extern void parmlist_tags_warning               PROTO((void));
327extern void pending_xref_error                  PROTO((void));
328extern void pop_c_function_context              PROTO((void));
329extern void pop_label_level                     PROTO((void));
330extern tree poplevel                            PROTO((int, int, int));
331extern void print_lang_decl                     PROTO((FILE *, tree, int));
332extern void print_lang_identifier               PROTO((FILE *, tree, int));
333extern void print_lang_type                     PROTO((FILE *, tree, int));
334extern void push_c_function_context             PROTO((void));
335extern void push_label_level                    PROTO((void));
336extern void push_parm_decl                      PROTO((tree));
337extern tree pushdecl                            PROTO((tree));
338extern tree pushdecl_top_level                  PROTO((tree));
339extern void pushlevel                           PROTO((int));
340extern void pushtag                             PROTO((tree, tree));
341extern void set_block                           PROTO((tree));
342extern tree shadow_label                        PROTO((tree));
343extern void shadow_record_fields                PROTO((tree));
344extern void shadow_tag                          PROTO((tree));
345extern void shadow_tag_warned                   PROTO((tree, int));
346extern tree start_enum                          PROTO((tree));
347extern int  start_function                      PROTO((tree, tree, tree,
348						       tree, int));
349extern tree start_decl                          PROTO((tree, tree, int,
350						       tree, tree));
351extern tree start_struct                        PROTO((enum tree_code, tree));
352extern void store_parm_decls                    PROTO((void));
353extern tree xref_tag                            PROTO((enum tree_code, tree));
354
355/* in c-typeck.c */
356extern tree require_complete_type		PROTO((tree));
357extern void incomplete_type_error		PROTO((tree, tree));
358/* Given two integer or real types, return the type for their sum.
359   Given two compatible ANSI C types, returns the merged type.  */
360extern tree common_type                         PROTO((tree, tree));
361extern int comptypes				PROTO((tree, tree));
362extern int self_promoting_args_p		PROTO((tree));
363extern tree c_sizeof                            PROTO((tree));
364extern tree c_sizeof_nowarn                     PROTO((tree));
365extern tree c_size_in_bytes                     PROTO((tree));
366extern tree c_alignof				PROTO((tree));
367extern tree c_alignof_expr			PROTO((tree));
368extern tree default_conversion                  PROTO((tree));
369extern tree build_component_ref                 PROTO((tree, tree));
370extern tree build_indirect_ref                  PROTO((tree, const char *));
371extern tree build_array_ref                     PROTO((tree, tree));
372extern tree build_function_call                 PROTO((tree, tree));
373extern tree parser_build_binary_op              PROTO((enum tree_code,
374						       tree, tree));
375extern tree build_binary_op                     PROTO((enum tree_code,
376						       tree, tree, int));
377extern tree build_unary_op                      PROTO((enum tree_code,
378						       tree, int));
379extern int lvalue_p				PROTO((tree));
380extern int lvalue_or_else			PROTO((tree, const char *));
381extern void readonly_warning			PROTO((tree, const char *));
382extern int mark_addressable			PROTO((tree));
383extern tree build_conditional_expr              PROTO((tree, tree, tree));
384extern tree build_compound_expr                 PROTO((tree));
385extern tree build_c_cast                        PROTO((tree, tree));
386extern tree build_modify_expr                   PROTO((tree, enum tree_code,
387						       tree));
388extern tree initializer_constant_valid_p	PROTO((tree, tree));
389extern void store_init_value                    PROTO((tree, tree));
390extern void error_init				PROTO((const char *));
391extern void pedwarn_init			PROTO((const char *));
392extern void start_init				PROTO((tree, tree, int));
393extern void finish_init				PROTO((void));
394extern void really_start_incremental_init	PROTO((tree));
395extern void push_init_level			PROTO((int));
396extern tree pop_init_level			PROTO((int));
397extern void set_init_index			PROTO((tree, tree));
398extern void set_init_label			PROTO((tree));
399extern void process_init_element		PROTO((tree));
400extern void c_expand_asm_operands		PROTO((tree, tree, tree, tree,
401						       int, char *, int));
402extern void c_expand_return			PROTO((tree));
403extern tree c_expand_start_case                 PROTO((tree));
404
405/* in c-iterate.c */
406extern void init_iterators			PROTO((void));
407extern void iterator_expand			PROTO((tree));
408extern void iterator_for_loop_start		PROTO((tree));
409extern void iterator_for_loop_end		PROTO((tree));
410extern void iterator_for_loop_record		PROTO((tree));
411extern void push_iterator_stack			PROTO((void));
412extern void pop_iterator_stack			PROTO((void));
413
414/* Set to 0 at beginning of a function definition, set to 1 if
415   a return statement that specifies a return value is seen.  */
416
417extern int current_function_returns_value;
418
419/* Set to 0 at beginning of a function definition, set to 1 if
420   a return statement with no argument is seen.  */
421
422extern int current_function_returns_null;
423
424/* Nonzero means the expression being parsed will never be evaluated.
425   This is a count, since unevaluated expressions can nest.  */
426
427extern int skip_evaluation;
428
429/* Nonzero means `$' can be in an identifier.  */
430
431extern int dollars_in_ident;
432
433/* Nonzero means allow type mismatches in conditional expressions;
434   just make their values `void'.   */
435
436extern int flag_cond_mismatch;
437
438/* Nonzero means don't recognize the keyword `asm'.  */
439
440extern int flag_no_asm;
441
442/* Nonzero means environment is hosted (i.e., not freestanding) */
443
444extern int flag_hosted;
445
446/* Nonzero means warn about implicit declarations.  */
447
448extern int warn_implicit;
449
450/* Nonzero means give string constants the type `const char *'
451   to get extra warnings from them.  These warnings will be too numerous
452   to be useful, except in thoroughly ANSIfied programs.  */
453
454extern int flag_const_strings;
455
456/* Nonzero means warn about sizeof (function) or addition/subtraction
457   of function pointers.  */
458
459extern int warn_pointer_arith;
460
461/* Nonzero means warn for all old-style non-prototype function decls.  */
462
463extern int warn_strict_prototypes;
464
465/* Nonzero means warn about multiple (redundant) decls for the same single
466   variable or function.  */
467
468extern int warn_redundant_decls;
469
470/* Nonzero means warn about extern declarations of objects not at
471   file-scope level and about *all* declarations of functions (whether
472   extern or static) not at file-scope level.  Note that we exclude
473   implicit function declarations.  To get warnings about those, use
474   -Wimplicit.  */
475
476extern int warn_nested_externs;
477
478/* Nonzero means warn about pointer casts that can drop a type qualifier
479   from the pointer target type.  */
480
481extern int warn_cast_qual;
482
483/* Nonzero means warn when casting a function call to a type that does
484   not match the return type (e.g. (float)sqrt() or (anything*)malloc()
485   when there is no previous declaration of sqrt or malloc.  */
486
487extern int warn_bad_function_cast;
488
489/* Warn about functions which might be candidates for attribute noreturn. */
490
491extern int warn_missing_noreturn;
492
493/* Warn about traditional constructs whose meanings changed in ANSI C.  */
494
495extern int warn_traditional;
496
497/* Warn about *printf or *scanf format/argument anomalies. */
498
499extern int warn_format;
500
501/* Warn about a subscript that has type char.  */
502
503extern int warn_char_subscripts;
504
505/* Warn if a type conversion is done that might have confusing results.  */
506
507extern int warn_conversion;
508
509/* Warn if main is suspicious. */
510
511extern int warn_main;
512
513/* Nonzero means do some things the same way PCC does.  */
514
515extern int flag_traditional;
516
517/* Nonzero means use the ISO C9x dialect of C.  */
518
519extern int flag_isoc9x;
520
521/* Nonzero means to allow single precision math even if we're generally
522   being traditional. */
523extern int flag_allow_single_precision;
524
525/* Nonzero means warn about suggesting putting in ()'s.  */
526
527extern int warn_parentheses;
528
529/* Warn if initializer is not completely bracketed.  */
530
531extern int warn_missing_braces;
532
533/* Warn about comparison of signed and unsigned values.  */
534
535extern int warn_sign_compare;
536
537/* Warn about multicharacter constants.  */
538
539extern int warn_multichar;
540
541/* Warn about long long.  */
542
543extern int warn_long_long;
544
545/* Nonzero means we are reading code that came from a system header file.  */
546
547extern int system_header_p;
548
549/* Nonzero enables objc features.  */
550
551extern int doing_objc_thang;
552
553/* In c-decl.c */
554extern void finish_incomplete_decl PROTO((tree));
555
556#endif /* not _C_TREE_H */
557