OSDN Git Service

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