OSDN Git Service

Remove bogus patch.
[pf3gnuchains/gcc-fork.git] / gcc / c-common.h
1 /* Definitions for c-common.c.
2    Copyright (C) 1987, 1993, 1994, 1995, 1997, 1998,
3    1999, 2000, 2001 Free Software Foundation, Inc.
4
5 This file is part of GNU CC.
6
7 GNU CC is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
11
12 GNU CC is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with GNU CC; see the file COPYING.  If not, write to
19 the Free Software Foundation, 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA.  */
21
22 #ifndef GCC_C_COMMON_H
23 #define GCC_C_COMMON_H
24
25 #include "splay-tree.h"
26 #include "cpplib.h"
27
28 /* Usage of TREE_LANG_FLAG_?:
29    0: COMPOUND_STMT_NO_SCOPE (in COMPOUND_STMT).
30       TREE_NEGATED_INT (in INTEGER_CST).
31       IDENTIFIER_MARKED (used by search routines).
32       SCOPE_BEGIN_P (in SCOPE_STMT)
33       DECL_PRETTY_FUNCTION_P (in VAR_DECL)
34       NEW_FOR_SCOPE_P (in FOR_STMT)
35       RETURN_NULLIFIED_P (in RETURN_STMT)
36       ASM_INPUT_P (in ASM_STMT)
37    1: C_DECLARED_LABEL_FLAG (in LABEL_DECL)
38       STMT_IS_FULL_EXPR_P (in _STMT)
39    2: STMT_LINENO_FOR_FN_P (in _STMT)
40    3: SCOPE_NO_CLEANUPS_P (in SCOPE_STMT)
41    4: SCOPE_PARTIAL_P (in SCOPE_STMT)
42 */
43
44 /* Reserved identifiers.  This is the union of all the keywords for C,
45    C++, and Objective C.  All the type modifiers have to be in one
46    block at the beginning, because they are used as mask bits.  There
47    are 27 type modifiers; if we add many more we will have to redesign
48    the mask mechanism.  */
49
50 enum rid
51 {
52   /* Modifiers: */
53   /* C, in empirical order of frequency. */
54   RID_STATIC = 0,
55   RID_UNSIGNED, RID_LONG,    RID_CONST, RID_EXTERN,
56   RID_REGISTER, RID_TYPEDEF, RID_SHORT, RID_INLINE,
57   RID_VOLATILE, RID_SIGNED,  RID_AUTO,  RID_RESTRICT,
58
59   /* C extensions */
60   RID_BOUNDED, RID_UNBOUNDED, RID_COMPLEX,
61
62   /* C++ */
63   RID_FRIEND, RID_VIRTUAL, RID_EXPLICIT, RID_EXPORT, RID_MUTABLE,
64
65   /* ObjC */
66   RID_IN, RID_OUT, RID_INOUT, RID_BYCOPY, RID_BYREF, RID_ONEWAY,
67
68   /* C */
69   RID_INT,     RID_CHAR,   RID_FLOAT,    RID_DOUBLE, RID_VOID,
70   RID_ENUM,    RID_STRUCT, RID_UNION,    RID_IF,     RID_ELSE,
71   RID_WHILE,   RID_DO,     RID_FOR,      RID_SWITCH, RID_CASE,
72   RID_DEFAULT, RID_BREAK,  RID_CONTINUE, RID_RETURN, RID_GOTO,
73   RID_SIZEOF,
74
75   /* C extensions */
76   RID_ASM,       RID_TYPEOF,   RID_ALIGNOF,  RID_ATTRIBUTE,  RID_VA_ARG,
77   RID_EXTENSION, RID_IMAGPART, RID_REALPART, RID_LABEL,      RID_PTRBASE,
78   RID_PTREXTENT, RID_PTRVALUE,
79
80   /* Too many ways of getting the name of a function as a string */
81   RID_FUNCTION_NAME, RID_PRETTY_FUNCTION_NAME, RID_C99_FUNCTION_NAME,
82
83   /* C++ */
84   RID_BOOL,     RID_WCHAR,    RID_CLASS,
85   RID_PUBLIC,   RID_PRIVATE,  RID_PROTECTED,
86   RID_TEMPLATE, RID_NULL,     RID_CATCH,
87   RID_DELETE,   RID_FALSE,    RID_NAMESPACE,
88   RID_NEW,      RID_OPERATOR, RID_THIS,
89   RID_THROW,    RID_TRUE,     RID_TRY,
90   RID_TYPENAME, RID_TYPEID,   RID_USING,
91
92   /* casts */
93   RID_CONSTCAST, RID_DYNCAST, RID_REINTCAST, RID_STATCAST,
94
95   /* alternate spellings */
96   RID_AND, RID_AND_EQ, RID_NOT, RID_NOT_EQ,
97   RID_OR,  RID_OR_EQ,  RID_XOR, RID_XOR_EQ,
98   RID_BITAND, RID_BITOR, RID_COMPL,
99
100   /* Objective C */
101   RID_ID,          RID_AT_ENCODE,    RID_AT_END,
102   RID_AT_CLASS,    RID_AT_ALIAS,     RID_AT_DEFS,
103   RID_AT_PRIVATE,  RID_AT_PROTECTED, RID_AT_PUBLIC,
104   RID_AT_PROTOCOL, RID_AT_SELECTOR,  RID_AT_INTERFACE,
105   RID_AT_IMPLEMENTATION,
106
107   RID_MAX,
108
109   RID_FIRST_MODIFIER = RID_STATIC,
110   RID_LAST_MODIFIER = RID_ONEWAY,
111
112   RID_FIRST_AT = RID_AT_ENCODE,
113   RID_LAST_AT = RID_AT_IMPLEMENTATION,
114   RID_FIRST_PQ = RID_IN,
115   RID_LAST_PQ = RID_ONEWAY
116 };
117
118 #define OBJC_IS_AT_KEYWORD(rid) \
119   ((unsigned int)(rid) >= (unsigned int)RID_FIRST_AT && \
120    (unsigned int)(rid) <= (unsigned int)RID_LAST_AT)
121
122 #define OBJC_IS_PQ_KEYWORD(rid) \
123   ((unsigned int)(rid) >= (unsigned int)RID_FIRST_PQ && \
124    (unsigned int)(rid) <= (unsigned int)RID_LAST_PQ)
125
126 /* The elements of `ridpointers' are identifier nodes for the reserved
127    type names and storage classes.  It is indexed by a RID_... value.  */
128 extern tree *ridpointers;
129
130 /* Standard named or nameless data types of the C compiler.  */
131
132 enum c_tree_index
133 {
134     CTI_WCHAR_TYPE,
135     CTI_SIGNED_WCHAR_TYPE,
136     CTI_UNSIGNED_WCHAR_TYPE,
137     CTI_WINT_TYPE,
138     CTI_C_SIZE_TYPE, /* The type used for the size_t typedef and the
139                         result type of sizeof (an ordinary type without
140                         TYPE_IS_SIZETYPE set, unlike the internal
141                         sizetype).  */
142     CTI_SIGNED_SIZE_TYPE, /* For format checking only.  */
143     CTI_UNSIGNED_PTRDIFF_TYPE, /* For format checking only.  */
144     CTI_INTMAX_TYPE,
145     CTI_UINTMAX_TYPE,
146     CTI_WIDEST_INT_LIT_TYPE,
147     CTI_WIDEST_UINT_LIT_TYPE,
148
149     CTI_CHAR_ARRAY_TYPE,
150     CTI_WCHAR_ARRAY_TYPE,
151     CTI_INT_ARRAY_TYPE,
152     CTI_STRING_TYPE,
153     CTI_CONST_STRING_TYPE,
154
155     /* Type for boolean expressions (bool in C++, int in C).  */
156     CTI_BOOLEAN_TYPE,
157     CTI_BOOLEAN_TRUE,
158     CTI_BOOLEAN_FALSE,
159     /* C99's _Bool type.  */
160     CTI_C_BOOL_TYPE,
161     CTI_C_BOOL_TRUE,
162     CTI_C_BOOL_FALSE,
163     CTI_DEFAULT_FUNCTION_TYPE,
164
165     CTI_G77_INTEGER_TYPE,
166     CTI_G77_UINTEGER_TYPE,
167     CTI_G77_LONGINT_TYPE,
168     CTI_G77_ULONGINT_TYPE,
169
170     /* These are not types, but we have to look them up all the time. */
171     CTI_FUNCTION_NAME_DECL,
172     CTI_PRETTY_FUNCTION_NAME_DECL,
173     CTI_C99_FUNCTION_NAME_DECL,
174     CTI_SAVED_FUNCTION_NAME_DECLS,
175     
176     CTI_VOID_ZERO,
177
178     CTI_MAX
179 };
180
181 #define C_RID_CODE(id)  (((struct c_common_identifier *) (id))->rid_code)
182
183 /* Identifier part common to the C front ends.  Inherits from
184    tree_identifier, despite appearances.  */
185 struct c_common_identifier
186 {
187   struct tree_common common;
188   struct cpp_hashnode node;
189   ENUM_BITFIELD(rid) rid_code: CHAR_BIT;
190 };
191
192 #define wchar_type_node                 c_global_trees[CTI_WCHAR_TYPE]
193 #define signed_wchar_type_node          c_global_trees[CTI_SIGNED_WCHAR_TYPE]
194 #define unsigned_wchar_type_node        c_global_trees[CTI_UNSIGNED_WCHAR_TYPE]
195 #define wint_type_node                  c_global_trees[CTI_WINT_TYPE]
196 #define c_size_type_node                c_global_trees[CTI_C_SIZE_TYPE]
197 #define signed_size_type_node           c_global_trees[CTI_SIGNED_SIZE_TYPE]
198 #define unsigned_ptrdiff_type_node      c_global_trees[CTI_UNSIGNED_PTRDIFF_TYPE]
199 #define intmax_type_node                c_global_trees[CTI_INTMAX_TYPE]
200 #define uintmax_type_node               c_global_trees[CTI_UINTMAX_TYPE]
201 #define widest_integer_literal_type_node c_global_trees[CTI_WIDEST_INT_LIT_TYPE]
202 #define widest_unsigned_literal_type_node c_global_trees[CTI_WIDEST_UINT_LIT_TYPE]
203
204 #define boolean_type_node               c_global_trees[CTI_BOOLEAN_TYPE]
205 #define boolean_true_node               c_global_trees[CTI_BOOLEAN_TRUE]
206 #define boolean_false_node              c_global_trees[CTI_BOOLEAN_FALSE]
207
208 #define c_bool_type_node                c_global_trees[CTI_C_BOOL_TYPE]
209 #define c_bool_true_node                c_global_trees[CTI_C_BOOL_TRUE]
210 #define c_bool_false_node               c_global_trees[CTI_C_BOOL_FALSE]
211
212 #define char_array_type_node            c_global_trees[CTI_CHAR_ARRAY_TYPE]
213 #define wchar_array_type_node           c_global_trees[CTI_WCHAR_ARRAY_TYPE]
214 #define int_array_type_node             c_global_trees[CTI_INT_ARRAY_TYPE]
215 #define string_type_node                c_global_trees[CTI_STRING_TYPE]
216 #define const_string_type_node          c_global_trees[CTI_CONST_STRING_TYPE]
217
218 #define default_function_type           c_global_trees[CTI_DEFAULT_FUNCTION_TYPE]
219
220 /* g77 integer types, which which must be kept in sync with f/com.h */
221 #define g77_integer_type_node           c_global_trees[CTI_G77_INTEGER_TYPE]
222 #define g77_uinteger_type_node          c_global_trees[CTI_G77_UINTEGER_TYPE]
223 #define g77_longint_type_node           c_global_trees[CTI_G77_LONGINT_TYPE]
224 #define g77_ulongint_type_node          c_global_trees[CTI_G77_ULONGINT_TYPE]
225
226 #define function_name_decl_node         c_global_trees[CTI_FUNCTION_NAME_DECL]
227 #define pretty_function_name_decl_node  c_global_trees[CTI_PRETTY_FUNCTION_NAME_DECL]
228 #define c99_function_name_decl_node             c_global_trees[CTI_C99_FUNCTION_NAME_DECL]
229 #define saved_function_name_decls       c_global_trees[CTI_SAVED_FUNCTION_NAME_DECLS]
230
231 /* A node for `((void) 0)'.  */
232 #define void_zero_node                  c_global_trees[CTI_VOID_ZERO]
233
234 extern tree c_global_trees[CTI_MAX];
235
236 /* Mark which labels are explicitly declared.
237    These may be shadowed, and may be referenced from nested functions.  */
238 #define C_DECLARED_LABEL_FLAG(label) TREE_LANG_FLAG_1 (label)
239
240 typedef enum c_language_kind
241 {
242   clk_c,           /* A dialect of C: K&R C, ANSI/ISO C89, C2000,
243                        etc. */
244   clk_cplusplus,   /* ANSI/ISO C++ */
245   clk_objective_c  /* Objective C */
246 }
247 c_language_kind;
248
249 /* Information about a statement tree.  */
250
251 struct stmt_tree_s {
252   /* The last statement added to the tree.  */
253   tree x_last_stmt;
254   /* The type of the last expression statement.  (This information is
255      needed to implement the statement-expression extension.)  */
256   tree x_last_expr_type;
257   /* In C++, Non-zero if we should treat statements as full
258      expressions.  In particular, this variable is no-zero if at the
259      end of a statement we should destroy any temporaries created
260      during that statement.  Similarly, if, at the end of a block, we
261      should destroy any local variables in this block.  Normally, this
262      variable is non-zero, since those are the normal semantics of
263      C++.
264
265      However, in order to represent aggregate initialization code as
266      tree structure, we use statement-expressions.  The statements
267      within the statement expression should not result in cleanups
268      being run until the entire enclosing statement is complete.
269
270      This flag has no effect in C.  */
271   int stmts_are_full_exprs_p;
272 };
273
274 typedef struct stmt_tree_s *stmt_tree;
275
276 /* Global state pertinent to the current function.  Some C dialects
277    extend this structure with additional fields.  */
278
279 struct language_function {
280   /* While we are parsing the function, this contains information
281      about the statement-tree that we are building.  */
282   struct stmt_tree_s x_stmt_tree;
283   /* The stack of SCOPE_STMTs for the current function.  */
284   tree x_scope_stmt_stack;
285 };
286
287 /* When building a statement-tree, this is the last statement added to
288    the tree.  */
289
290 #define last_tree (current_stmt_tree ()->x_last_stmt)
291
292 /* The type of the last expression-statement we have seen.  */
293
294 #define last_expr_type (current_stmt_tree ()->x_last_expr_type)
295
296 /* LAST_TREE contains the last statement parsed.  These are chained
297    together through the TREE_CHAIN field, but often need to be
298    re-organized since the parse is performed bottom-up.  This macro
299    makes LAST_TREE the indicated SUBSTMT of STMT.  */
300
301 #define RECHAIN_STMTS(stmt, substmt)            \
302   do {                                          \
303     substmt = TREE_CHAIN (stmt);                \
304     TREE_CHAIN (stmt) = NULL_TREE;              \
305     last_tree = stmt;                           \
306   } while (0)
307
308 /* Language-specific hooks.  */
309
310 extern int (*lang_statement_code_p)             PARAMS ((enum tree_code));
311 extern void (*lang_expand_stmt)                 PARAMS ((tree));
312 extern void (*lang_expand_decl_stmt)            PARAMS ((tree));
313 extern void (*lang_expand_function_end)         PARAMS ((void));
314
315 /* Callback that determines if it's ok for a function to have no
316    noreturn attribute.  */
317 extern int (*lang_missing_noreturn_ok_p)        PARAMS ((tree));
318
319
320 /* The type of a function that walks over tree structure.  */
321
322 typedef tree (*walk_tree_fn)                    PARAMS ((tree *,
323                                                          int *,
324                                                          void *));
325
326 extern stmt_tree current_stmt_tree              PARAMS ((void));
327 extern tree *current_scope_stmt_stack           PARAMS ((void));
328 extern void begin_stmt_tree                     PARAMS ((tree *));
329 extern tree add_stmt                            PARAMS ((tree));
330 extern void add_decl_stmt                       PARAMS ((tree));
331 extern tree add_scope_stmt                      PARAMS ((int, int));
332 extern void finish_stmt_tree                    PARAMS ((tree *));
333
334 extern int statement_code_p                     PARAMS ((enum tree_code));
335 extern tree walk_stmt_tree                      PARAMS ((tree *,
336                                                          walk_tree_fn,
337                                                          void *));
338 extern void prep_stmt                           PARAMS ((tree));
339 extern void expand_stmt                         PARAMS ((tree));
340 extern void mark_stmt_tree                      PARAMS ((void *));
341
342 /* Extra information associated with a DECL.  Other C dialects extend
343    this structure in various ways.  The C front-end only uses this
344    structure for FUNCTION_DECLs; all other DECLs have a NULL
345    DECL_LANG_SPECIFIC field.  */
346
347 struct c_lang_decl {
348   /* In a FUNCTION_DECL, this is DECL_SAVED_TREE.  */
349   tree saved_tree;
350 };
351
352 /* In a FUNCTION_DECL, the saved representation of the body of the
353    entire function.  Usually a COMPOUND_STMT, but in C++ this may also
354    be a RETURN_INIT, CTOR_INITIALIZER, or TRY_BLOCK.  */
355 #define DECL_SAVED_TREE(NODE)                                               \
356   (((struct c_lang_decl *) DECL_LANG_SPECIFIC (FUNCTION_DECL_CHECK (NODE))) \
357    ->saved_tree)
358
359 /* In a FUNCTION_DECL for which DECL_BUILT_IN does not hold, this is
360      the approximate number of statements in this function.  There is
361      no need for this number to be exact; it is only used in various
362      heuristics regarding optimization.  */
363 #define DECL_NUM_STMTS(NODE) \
364   (FUNCTION_DECL_CHECK (NODE)->decl.u1.i)
365
366 extern void c_mark_lang_decl                    PARAMS ((struct c_lang_decl *));
367
368 /* The variant of the C language being processed.  Each C language
369    front-end defines this variable.  */
370
371 extern c_language_kind c_language;
372
373 /* Nonzero means give string constants the type `const char *', rather
374    than `char *'.  */
375
376 extern int flag_const_strings;
377
378 /* Nonzero means give `double' the same size as `float'.  */
379
380 extern int flag_short_double;
381
382 /* Nonzero means give `wchar_t' the same size as `short'.  */
383
384 extern int flag_short_wchar;
385
386 /* Warn about *printf or *scanf format/argument anomalies. */
387
388 extern int warn_format;
389
390 /* Warn about Y2K problems with strftime formats.  */
391
392 extern int warn_format_y2k;
393
394 /* Warn about excess arguments to formats.  */
395
396 extern int warn_format_extra_args;
397
398 /* Warn about non-literal format arguments.  */
399
400 extern int warn_format_nonliteral;
401
402 /* Warn about possible security problems with calls to format functions.  */
403
404 extern int warn_format_security;
405
406 /* Warn about possible violations of sequence point rules.  */
407
408 extern int warn_sequence_point;
409
410 /* Warn about functions which might be candidates for format attributes.  */
411
412 extern int warn_missing_format_attribute;
413
414 /* Nonzero means do some things the same way PCC does.  */
415
416 extern int flag_traditional;
417
418 /* Nonzero means enable C89 Amendment 1 features.  */
419
420 extern int flag_isoc94;
421
422 /* Nonzero means use the ISO C99 dialect of C.  */
423
424 extern int flag_isoc99;
425
426 /* Nonzero means environment is hosted (i.e., not freestanding) */
427
428 extern int flag_hosted;
429
430 /* Nonzero means add default format_arg attributes for functions not
431    in ISO C.  */
432
433 extern int flag_noniso_default_format_attributes;
434
435 /* Nonzero means don't recognize any builtin functions.  */
436
437 extern int flag_no_builtin;
438
439 /* Nonzero means don't recognize the non-ANSI builtin functions.
440    -ansi sets this.  */
441
442 extern int flag_no_nonansi_builtin;
443
444 /* Nonzero means warn about suggesting putting in ()'s.  */
445
446 extern int warn_parentheses;
447
448 /* Warn if a type conversion is done that might have confusing results.  */
449
450 extern int warn_conversion;
451
452 /* Nonzero means warn about usage of long long,
453    when `-pedantic' and not C99.  */
454
455 extern int warn_long_long;
456
457 /* C types are partitioned into three subsets: object, function, and
458    incomplete types.  */
459 #define C_TYPE_OBJECT_P(type) \
460   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
461
462 #define C_TYPE_INCOMPLETE_P(type) \
463   (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
464
465 #define C_TYPE_FUNCTION_P(type) \
466   (TREE_CODE (type) == FUNCTION_TYPE)
467
468 /* Return the qualifiers that apply to this type.  In C++, that means
469    descending through array types.  Note that this macro evaluates its
470    arguments mor than once.  */
471 #define C_TYPE_QUALS(TYPE)                              \
472   (TYPE_QUALS ((TREE_CODE (TYPE) == ARRAY_TYPE          \
473                 && c_language == clk_cplusplus)         \
474                ? strip_array_types (TYPE) : TYPE))
475
476 /* For convenience we define a single macro to identify the class of
477    object or incomplete types.  */
478 #define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
479   (!C_TYPE_FUNCTION_P (type))
480
481 /* Record in each node resulting from a binary operator
482    what operator was specified for it.  */
483 #define C_EXP_ORIGINAL_CODE(exp) ((enum tree_code) TREE_COMPLEXITY (exp))
484
485 /* Pointer to function to lazily generate the VAR_DECL for __FUNCTION__ etc.
486    ID is the identifier to use, NAME is the string.
487    TYPE_DEP indicates whether it depends on type of the function or not
488    (i.e. __PRETTY_FUNCTION__).  */
489
490 extern tree (*make_fname_decl)                  PARAMS ((tree, int));
491
492 extern tree identifier_global_value             PARAMS ((tree));
493 extern void record_builtin_type                 PARAMS ((enum rid,
494                                                          const char *, tree));
495 extern tree build_void_list_node                PARAMS ((void));
496 extern void start_fname_decls                   PARAMS ((void));
497 extern void finish_fname_decls                  PARAMS ((void));
498 extern const char *fname_as_string              PARAMS ((int));
499 extern tree fname_decl                          PARAMS ((unsigned, tree));
500 extern const char *fname_string                 PARAMS ((unsigned));
501 extern void decl_attributes                     PARAMS ((tree, tree, tree));
502 extern void init_function_format_info           PARAMS ((void));
503 extern void check_function_format               PARAMS ((int *, tree, tree, tree));
504 extern void set_Wformat                         PARAMS ((int));
505 extern void decl_handle_format_attribute        PARAMS ((tree, tree));
506 extern void decl_handle_format_arg_attribute    PARAMS ((tree, tree));
507 extern void c_apply_type_quals_to_decl          PARAMS ((int, tree));
508 /* Print an error message for invalid operands to arith operation CODE.
509    NOP_EXPR is used as a special case (see truthvalue_conversion).  */
510 extern void binary_op_error                     PARAMS ((enum tree_code));
511 extern tree c_expand_expr_stmt                  PARAMS ((tree));
512 extern void c_expand_start_cond                 PARAMS ((tree, int));
513 extern void c_finish_then                       PARAMS ((void));
514 extern void c_expand_start_else                 PARAMS ((void));
515 extern void c_finish_else                   PARAMS ((void));
516 extern void c_expand_end_cond                   PARAMS ((void));
517 /* Validate the expression after `case' and apply default promotions.  */
518 extern tree check_case_value                    PARAMS ((tree));
519 /* Concatenate a list of STRING_CST nodes into one STRING_CST.  */
520 extern tree combine_strings                     PARAMS ((tree));
521 extern void constant_expression_warning         PARAMS ((tree));
522 extern tree convert_and_check                   PARAMS ((tree, tree));
523 extern void overflow_warning                    PARAMS ((tree));
524 extern void unsigned_conversion_warning         PARAMS ((tree, tree));
525
526 /* Read the rest of the current #-directive line.  */
527 extern char *get_directive_line                 PARAMS ((void));
528 #define GET_DIRECTIVE_LINE() get_directive_line ()
529
530 /* Subroutine of build_binary_op, used for comparison operations.
531    See if the operands have both been converted from subword integer types
532    and, if so, perhaps change them both back to their original type.  */
533 extern tree shorten_compare                     PARAMS ((tree *, tree *, tree *, enum tree_code *));
534
535 extern unsigned int min_precision               PARAMS ((tree, int));
536
537 /* Add qualifiers to a type, in the fashion for C.  */
538 extern tree c_build_qualified_type              PARAMS ((tree, int));
539
540 /* Build tree nodes and builtin functions common to both C and C++ language
541    frontends.  */
542 extern void c_common_nodes_and_builtins         PARAMS ((void));
543
544 extern tree build_va_arg                        PARAMS ((tree, tree));
545
546 extern void c_common_lang_init                  PARAMS ((void));
547
548 extern bool c_promoting_integer_type_p          PARAMS ((tree));
549 extern int self_promoting_args_p                PARAMS ((tree));
550 extern tree simple_type_promotes_to             PARAMS ((tree));
551 extern tree strip_array_types                   PARAMS ((tree));
552
553 /* These macros provide convenient access to the various _STMT nodes.  */
554
555 /* Nonzero if this statement should be considered a full-expression,
556    i.e., if temporaries created during this statement should have
557    their destructors run at the end of this statement.  (In C, this
558    will always be false, since there are no destructors.)  */
559 #define STMT_IS_FULL_EXPR_P(NODE) TREE_LANG_FLAG_1 ((NODE))
560
561 /* IF_STMT accessors. These give access to the condtion of the if
562    statement, the then block of the if statement, and the else block
563    of the if stsatement if it exists. */
564 #define IF_COND(NODE)           TREE_OPERAND (IF_STMT_CHECK (NODE), 0)
565 #define THEN_CLAUSE(NODE)       TREE_OPERAND (IF_STMT_CHECK (NODE), 1)
566 #define ELSE_CLAUSE(NODE)       TREE_OPERAND (IF_STMT_CHECK (NODE), 2)
567
568 /* WHILE_STMT accessors. These give access to the condtion of the
569    while statement and the body of the while statement, respectively. */
570 #define WHILE_COND(NODE)        TREE_OPERAND (WHILE_STMT_CHECK (NODE), 0)
571 #define WHILE_BODY(NODE)        TREE_OPERAND (WHILE_STMT_CHECK (NODE), 1)
572
573 /* DO_STMT accessors. These give access to the condition of the do
574    statement and the body of the do statement, respectively. */
575 #define DO_COND(NODE)           TREE_OPERAND (DO_STMT_CHECK (NODE), 0)
576 #define DO_BODY(NODE)           TREE_OPERAND (DO_STMT_CHECK (NODE), 1)
577
578 /* RETURN_STMT accessors. These give the expression associated with a
579    return statement, and whether it should be ignored when expanding
580    (as opposed to inlining).  */
581 #define RETURN_EXPR(NODE)       TREE_OPERAND (RETURN_STMT_CHECK (NODE), 0)
582 #define RETURN_NULLIFIED_P(NODE) TREE_LANG_FLAG_0 (RETURN_STMT_CHECK (NODE))
583
584 /* EXPR_STMT accessor. This gives the expression associated with an
585    expression statement. */
586 #define EXPR_STMT_EXPR(NODE)    TREE_OPERAND (EXPR_STMT_CHECK (NODE), 0)
587
588 /* FOR_STMT accessors. These give access to the init statement,
589    condition, update expression, and body of the for statement,
590    respectively. */
591 #define FOR_INIT_STMT(NODE)     TREE_OPERAND (FOR_STMT_CHECK (NODE), 0)
592 #define FOR_COND(NODE)          TREE_OPERAND (FOR_STMT_CHECK (NODE), 1)
593 #define FOR_EXPR(NODE)          TREE_OPERAND (FOR_STMT_CHECK (NODE), 2)
594 #define FOR_BODY(NODE)          TREE_OPERAND (FOR_STMT_CHECK (NODE), 3)
595
596 /* SWITCH_STMT accessors. These give access to the condition and body
597    of the switch statement, respectively. */
598 #define SWITCH_COND(NODE)       TREE_OPERAND (SWITCH_STMT_CHECK (NODE), 0)
599 #define SWITCH_BODY(NODE)       TREE_OPERAND (SWITCH_STMT_CHECK (NODE), 1)
600
601 /* CASE_LABEL accessors. These give access to the high and low values
602    of a case label, respectively. */
603 #define CASE_LOW(NODE)          TREE_OPERAND (CASE_LABEL_CHECK (NODE), 0)
604 #define CASE_HIGH(NODE)         TREE_OPERAND (CASE_LABEL_CHECK (NODE), 1)
605 #define CASE_LABEL_DECL(NODE)   TREE_OPERAND (CASE_LABEL_CHECK (NODE), 2)
606
607 /* GOTO_STMT accessor. This gives access to the label associated with
608    a goto statement. */
609 #define GOTO_DESTINATION(NODE)  TREE_OPERAND (GOTO_STMT_CHECK (NODE), 0)
610
611 /* COMPOUND_STMT accessor. This gives access to the TREE_LIST of
612    statements assocated with a compound statement. The result is the
613    first statement in the list. Succeeding nodes can be acccessed by
614    calling TREE_CHAIN on a node in the list. */
615 #define COMPOUND_BODY(NODE)     TREE_OPERAND (COMPOUND_STMT_CHECK (NODE), 0)
616
617 /* ASM_STMT accessors. ASM_STRING returns a STRING_CST for the
618    instruction (e.g., "mov x, y"). ASM_OUTPUTS, ASM_INPUTS, and
619    ASM_CLOBBERS represent the outputs, inputs, and clobbers for the
620    statement. */
621 #define ASM_CV_QUAL(NODE)       TREE_OPERAND (ASM_STMT_CHECK (NODE), 0)
622 #define ASM_STRING(NODE)        TREE_OPERAND (ASM_STMT_CHECK (NODE), 1)
623 #define ASM_OUTPUTS(NODE)       TREE_OPERAND (ASM_STMT_CHECK (NODE), 2)
624 #define ASM_INPUTS(NODE)        TREE_OPERAND (ASM_STMT_CHECK (NODE), 3)
625 #define ASM_CLOBBERS(NODE)      TREE_OPERAND (ASM_STMT_CHECK (NODE), 4)
626
627 /* DECL_STMT accessor. This gives access to the DECL associated with
628    the given declaration statement. */
629 #define DECL_STMT_DECL(NODE)    TREE_OPERAND (DECL_STMT_CHECK (NODE), 0)
630
631 /* STMT_EXPR accessor. */
632 #define STMT_EXPR_STMT(NODE)    TREE_OPERAND (STMT_EXPR_CHECK (NODE), 0)
633
634 /* LABEL_STMT accessor. This gives access to the label associated with
635    the given label statement. */
636 #define LABEL_STMT_LABEL(NODE)  TREE_OPERAND (LABEL_STMT_CHECK (NODE), 0)
637
638 /* Nonzero if this SCOPE_STMT is for the beginning of a scope.  */
639 #define SCOPE_BEGIN_P(NODE) \
640   (TREE_LANG_FLAG_0 (SCOPE_STMT_CHECK (NODE)))
641
642 /* Nonzero if this SCOPE_STMT is for the end of a scope.  */
643 #define SCOPE_END_P(NODE) \
644   (!SCOPE_BEGIN_P (SCOPE_STMT_CHECK (NODE)))
645
646 /* The BLOCK containing the declarations contained in this scope.  */
647 #define SCOPE_STMT_BLOCK(NODE) \
648   (TREE_OPERAND (SCOPE_STMT_CHECK (NODE), 0))
649
650 /* Nonzero for a SCOPE_STMT if there were no variables in this scope.  */
651 #define SCOPE_NULLIFIED_P(NODE) \
652   (SCOPE_STMT_BLOCK ((NODE)) == NULL_TREE)
653
654 /* Nonzero for a SCOPE_STMT which represents a lexical scope, but
655    which should be treated as non-existant from the point of view of
656    running cleanup actions.  */
657 #define SCOPE_NO_CLEANUPS_P(NODE) \
658   (TREE_LANG_FLAG_3 (SCOPE_STMT_CHECK (NODE)))
659
660 /* Nonzero for a SCOPE_STMT if this statement is for a partial scope.
661    For example, in:
662
663      S s;
664      l:
665      S s2;
666      goto l;
667
668    there is (implicitly) a new scope after `l', even though there are
669    no curly braces.  In particular, when we hit the goto, we must
670    destroy s2 and then re-construct it.  For the implicit scope,
671    SCOPE_PARTIAL_P will be set.  */
672 #define SCOPE_PARTIAL_P(NODE) \
673   (TREE_LANG_FLAG_4 (SCOPE_STMT_CHECK (NODE)))
674
675 /* Nonzero for an ASM_STMT if the assembly statement is volatile.  */
676 #define ASM_VOLATILE_P(NODE)                    \
677   (ASM_CV_QUAL (ASM_STMT_CHECK (NODE)) != NULL_TREE)
678
679 /* The line-number at which a statement began.  But if
680    STMT_LINENO_FOR_FN_P does holds, then this macro gives the
681    line number for the end of the current function instead.  */
682 #define STMT_LINENO(NODE)                       \
683   (TREE_COMPLEXITY ((NODE)))
684
685 /* If non-zero, the STMT_LINENO for NODE is the line at which the
686    function ended.  */
687 #define STMT_LINENO_FOR_FN_P(NODE)              \
688   (TREE_LANG_FLAG_2 ((NODE)))
689
690 /* Nonzero if we want the new ISO rules for pushing a new scope for `for'
691    initialization variables. */
692 #define NEW_FOR_SCOPE_P(NODE) (TREE_LANG_FLAG_0 (NODE))
693
694 /* Nonzero if we want to create an ASM_INPUT instead of an
695    ASM_OPERAND with no operands.  */
696 #define ASM_INPUT_P(NODE) (TREE_LANG_FLAG_0 (NODE))
697
698 #define DEFTREECODE(SYM, NAME, TYPE, LENGTH) SYM,
699
700 enum c_tree_code {
701   C_DUMMY_TREE_CODE = LAST_AND_UNUSED_TREE_CODE,
702 #include "c-common.def"
703   LAST_C_TREE_CODE
704 };
705
706 #undef DEFTREECODE
707
708 extern void add_c_tree_codes                    PARAMS ((void));
709 extern void genrtl_do_pushlevel                 PARAMS ((void));
710 extern void genrtl_goto_stmt                    PARAMS ((tree));
711 extern void genrtl_expr_stmt                    PARAMS ((tree));
712 extern void genrtl_decl_stmt                    PARAMS ((tree));
713 extern void genrtl_if_stmt                      PARAMS ((tree));
714 extern void genrtl_while_stmt                   PARAMS ((tree));
715 extern void genrtl_do_stmt                      PARAMS ((tree));
716 extern void genrtl_return_stmt                  PARAMS ((tree));
717 extern void genrtl_for_stmt                     PARAMS ((tree));
718 extern void genrtl_break_stmt                   PARAMS ((void));
719 extern void genrtl_continue_stmt                PARAMS ((void));
720 extern void genrtl_scope_stmt                   PARAMS ((tree));
721 extern void genrtl_switch_stmt                  PARAMS ((tree));
722 extern void genrtl_case_label                   PARAMS ((tree));
723 extern void genrtl_compound_stmt                PARAMS ((tree));
724 extern void genrtl_asm_stmt                     PARAMS ((tree, tree,
725                                                          tree, tree,
726                                                          tree, int));
727 extern void genrtl_decl_cleanup                 PARAMS ((tree, tree));
728 extern int stmts_are_full_exprs_p               PARAMS ((void));
729 extern int anon_aggr_type_p                     PARAMS ((tree));
730
731 /* For a VAR_DECL that is an anonymous union, these are the various
732    sub-variables that make up the anonymous union.  */
733 #define DECL_ANON_UNION_ELEMS(NODE) DECL_ARGUMENTS ((NODE))
734
735 /* In a FIELD_DECL, nonzero if the decl was originally a bitfield.  */
736 #define DECL_C_BIT_FIELD(NODE) \
737   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) == 1)
738 #define SET_DECL_C_BIT_FIELD(NODE) \
739   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 1)
740 #define CLEAR_DECL_C_BIT_FIELD(NODE) \
741   (DECL_LANG_FLAG_4 (FIELD_DECL_CHECK (NODE)) = 0)
742
743 /* In a VAR_DECL, nonzero if the decl is a register variable with
744    an explicit asm specification.  */
745 #define DECL_C_HARD_REGISTER(DECL)  DECL_LANG_FLAG_4 (VAR_DECL_CHECK (DECL))
746
747 extern void emit_local_var                      PARAMS ((tree));
748 extern void make_rtl_for_local_static           PARAMS ((tree));
749 extern tree expand_cond                         PARAMS ((tree));
750 extern tree c_expand_return                     PARAMS ((tree));
751 extern tree do_case                             PARAMS ((tree, tree));
752 extern tree build_stmt                          PARAMS ((enum tree_code, ...));
753 extern tree build_case_label                    PARAMS ((tree, tree, tree));
754 extern tree build_continue_stmt                 PARAMS ((void));
755 extern tree build_break_stmt                    PARAMS ((void));
756 extern tree build_return_stmt                   PARAMS ((tree));
757
758 #define COMPOUND_STMT_NO_SCOPE(NODE)    TREE_LANG_FLAG_0 (NODE)
759
760 extern void c_expand_asm_operands               PARAMS ((tree, tree, tree, tree, int, const char *, int));
761
762 /* These functions must be defined by each front-end which implements
763    a variant of the C language.  They are used in c-common.c.  */
764
765 extern tree build_unary_op                      PARAMS ((enum tree_code,
766                                                          tree, int));
767 extern tree build_binary_op                     PARAMS ((enum tree_code,
768                                                          tree, tree, int));
769 extern int lvalue_p                             PARAMS ((tree));
770 extern tree default_conversion                  PARAMS ((tree));
771
772 /* Given two integer or real types, return the type for their sum.
773    Given two compatible ANSI C types, returns the merged type.  */
774
775 extern tree common_type                         PARAMS ((tree, tree));
776
777 extern tree expand_tree_builtin                 PARAMS ((tree, tree, tree));
778
779 extern tree decl_constant_value         PARAMS ((tree));
780
781 /* Handle increment and decrement of boolean types.  */
782 extern tree boolean_increment                   PARAMS ((enum tree_code,
783                                                          tree));
784
785 /* Hook currently used only by the C++ front end to reset internal state
786    after entering or leaving a header file.  */
787 extern void extract_interface_info              PARAMS ((void));
788
789 extern void mark_c_language_function            PARAMS ((struct language_function *));
790
791 extern int case_compare                         PARAMS ((splay_tree_key,
792                                                          splay_tree_key));
793
794 extern tree c_add_case_label                    PARAMS ((splay_tree,
795                                                          tree, tree,
796                                                          tree));
797
798 extern tree build_function_call                 PARAMS ((tree, tree));
799
800 extern tree finish_label_address_expr           PARAMS ((tree));
801
802 /* Same function prototype, but the C and C++ front ends have
803    different implementations.  Used in c-common.c.  */
804 extern tree lookup_label                        PARAMS ((tree));
805
806 /* If this variable is defined to a non-NULL value, it will be called
807    after the file has been completely parsed.  The argument will be
808    the GLOBAL_NAMESPACE in C++, or the list of top-level declarations
809    in C.  */
810 extern void (*back_end_hook) PARAMS ((tree));
811
812 #ifdef RTX_CODE
813
814 extern struct rtx_def *c_expand_expr            PARAMS ((tree, rtx,
815                                                          enum machine_mode,
816                                                          enum expand_modifier));
817
818 extern int c_safe_from_p                        PARAMS ((rtx, tree));
819 #endif
820
821 extern int c_unsafe_for_reeval                  PARAMS ((tree));
822
823 /* In dump.c */
824
825 /* Different tree dump places. */
826 enum tree_dump_index
827 {
828   TDI_all,                      /* dump the whole translation unit */
829   TDI_class,                    /* dump class heirarchy */
830   TDI_original,                 /* dump each function before optimizing it */
831   TDI_optimized,                /* dump each function after optimizing it */
832   TDI_inlined,                  /* dump each function after inlining
833                                    within it. */
834   TDI_end
835 };
836
837 /* Bit masks to control tree dumping. */
838 #define TDF_ADDRESS     (1 << 0)        /* dump node addresses */
839 #define TDF_SLIM        (1 << 1)        /* don't go wild following links */
840
841 typedef struct dump_info *dump_info_p;
842
843 /* A callback function used dump language-specific parts of tree
844    nodes.  Returns non-zero if it does not want the usual dumping of
845    the second argument.  */
846
847 typedef int (*dump_tree_fn) PARAMS ((dump_info_p, tree));
848
849 extern dump_tree_fn lang_dump_tree;
850
851 extern int dump_flag                    PARAMS ((dump_info_p, int, tree));
852 extern int dump_enabled_p               PARAMS ((enum tree_dump_index));
853 extern FILE *dump_begin                 PARAMS ((enum tree_dump_index, int *));
854 extern void dump_end                    PARAMS ((enum tree_dump_index, FILE *));
855 extern void dump_node                   PARAMS ((tree, int, FILE *));
856 extern int dump_switch_p                PARAMS ((const char *));
857 extern const char *dump_flag_name       PARAMS ((enum tree_dump_index));
858
859 /* Information recorded about each file examined during compilation.  */
860
861 struct c_fileinfo
862 {
863   int time;     /* Time spent in the file.  */
864   short interface_only;         /* Flags - used only by C++ */
865   short interface_unknown;
866 };
867
868 struct c_fileinfo *get_fileinfo                 PARAMS ((const char *));
869 extern void dump_time_statistics                PARAMS ((void));
870
871 #endif /* ! GCC_C_COMMON_H */