Add D30V options
[official-gcc.git] / gcc / c-common.h
blobba5d0fad6121fbdd87fd467c1386db26c2c604db
1 /* Definitions for c-common.c.
2 Copyright (C) 1987, 1993, 1994, 1995, 1997, 1998,
3 1999, 2000 Free Software Foundation, Inc.
5 This file is part of GNU CC.
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.
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.
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. */
22 /* Usage of TREE_LANG_FLAG_?:
23 0: COMPOUND_STMT_NO_SCOPE (in COMPOUND_STMT).
24 TREE_NEGATED_INT (in INTEGER_CST).
25 IDENTIFIER_MARKED (used by search routines).
26 SCOPE_BEGIN_P (in SCOPE_STMT)
27 DECL_PRETTY_FUNCTION_P (in VAR_DECL)
28 NEW_FOR_SCOPE_P (in FOR_STMT)
29 1: C_DECLARED_LABEL_FLAG (in LABEL_DECL)
30 STMT_IS_FULL_EXPR_P (in _STMT)
31 2: STMT_LINENO_FOR_FN_P (in _STMT)
32 3: SCOPE_NO_CLEANUPS_P (in SCOPE_STMT)
33 4: SCOPE_PARTIAL_P (in SCOPE_STMT)
36 /* Reserved identifiers. */
38 enum rid
40 RID_UNUSED,
41 RID_INT,
42 RID_CHAR,
43 RID_FLOAT,
44 RID_DOUBLE,
45 RID_VOID,
46 RID_UNUSED1,
48 /* The first seven are in the order of most frequently used,
49 as emiprically determined. */
50 RID_FIRST_MODIFIER,
51 RID_EXTERN = RID_FIRST_MODIFIER,
52 RID_CONST,
53 RID_LONG,
54 RID_TYPEDEF,
55 RID_UNSIGNED,
56 RID_SHORT,
57 RID_INLINE,
58 RID_AUTO,
59 RID_STATIC,
60 RID_REGISTER,
61 RID_SIGNED,
62 RID_RESTRICT,
63 RID_VOLATILE,
64 RID_BOUNDED,
65 RID_UNBOUNDED,
66 RID_NOALIAS,
67 RID_ITERATOR,
68 RID_COMPLEX,
70 RID_IN,
71 RID_OUT,
72 RID_INOUT,
73 RID_BYCOPY,
74 RID_BYREF,
75 RID_ONEWAY,
76 RID_ID,
78 RID_MAX
81 #define NORID RID_UNUSED
83 /* The elements of `ridpointers' are identifier nodes for the reserved
84 type names and storage classes. It is indexed by a RID_... value. */
85 extern tree *ridpointers;
87 /* Standard named or nameless data types of the C compiler. */
89 enum c_tree_index
91 CTI_WCHAR_TYPE,
92 CTI_SIGNED_WCHAR_TYPE,
93 CTI_UNSIGNED_WCHAR_TYPE,
94 CTI_WIDEST_INT_LIT_TYPE,
95 CTI_WIDEST_UINT_LIT_TYPE,
97 CTI_CHAR_ARRAY_TYPE,
98 CTI_WCHAR_ARRAY_TYPE,
99 CTI_INT_ARRAY_TYPE,
100 CTI_STRING_TYPE,
101 CTI_CONST_STRING_TYPE,
103 CTI_BOOLEAN_TYPE,
104 CTI_BOOLEAN_TRUE,
105 CTI_BOOLEAN_FALSE,
106 CTI_DEFAULT_FUNCTION_TYPE,
107 CTI_VOID_LIST,
109 CTI_VOID_FTYPE,
110 CTI_VOID_FTYPE_PTR,
111 CTI_INT_FTYPE_INT,
112 CTI_PTR_FTYPE_SIZETYPE,
114 CTI_G77_INTEGER_TYPE,
115 CTI_G77_UINTEGER_TYPE,
116 CTI_G77_LONGINT_TYPE,
117 CTI_G77_ULONGINT_TYPE,
119 CTI_MAX
122 #define wchar_type_node c_global_trees[CTI_WCHAR_TYPE]
123 #define signed_wchar_type_node c_global_trees[CTI_SIGNED_WCHAR_TYPE]
124 #define unsigned_wchar_type_node c_global_trees[CTI_UNSIGNED_WCHAR_TYPE]
125 #define widest_integer_literal_type_node c_global_trees[CTI_WIDEST_INT_LIT_TYPE]
126 #define widest_unsigned_literal_type_node c_global_trees[CTI_WIDEST_UINT_LIT_TYPE]
128 #define boolean_type_node c_global_trees[CTI_BOOLEAN_TYPE]
129 #define boolean_true_node c_global_trees[CTI_BOOLEAN_TRUE]
130 #define boolean_false_node c_global_trees[CTI_BOOLEAN_FALSE]
132 #define char_array_type_node c_global_trees[CTI_CHAR_ARRAY_TYPE]
133 #define wchar_array_type_node c_global_trees[CTI_WCHAR_ARRAY_TYPE]
134 #define int_array_type_node c_global_trees[CTI_INT_ARRAY_TYPE]
135 #define string_type_node c_global_trees[CTI_STRING_TYPE]
136 #define const_string_type_node c_global_trees[CTI_CONST_STRING_TYPE]
138 #define default_function_type c_global_trees[CTI_DEFAULT_FUNCTION_TYPE]
139 #define void_list_node c_global_trees[CTI_VOID_LIST]
140 #define void_ftype c_global_trees[CTI_VOID_FTYPE]
141 #define void_ftype_ptr c_global_trees[CTI_VOID_FTYPE_PTR]
142 #define int_ftype_int c_global_trees[CTI_INT_FTYPE_INT]
143 #define ptr_ftype_sizetype c_global_trees[CTI_PTR_FTYPE_SIZETYPE]
145 /* g77 integer types, which which must be kept in sync with f/com.h */
146 #define g77_integer_type_node c_global_trees[CTI_G77_INTEGER_TYPE]
147 #define g77_uinteger_type_node c_global_trees[CTI_G77_UINTEGER_TYPE]
148 #define g77_longint_type_node c_global_trees[CTI_G77_LONGINT_TYPE]
149 #define g77_ulongint_type_node c_global_trees[CTI_G77_ULONGINT_TYPE]
151 extern tree c_global_trees[CTI_MAX];
153 typedef enum c_language_kind
155 clk_c, /* A dialect of C: K&R C, ANSI/ISO C89, C2000,
156 etc. */
157 clk_cplusplus, /* ANSI/ISO C++ */
158 clk_objective_c /* Objective C */
160 c_language_kind;
162 /* The variant of the C language being processed. Each C language
163 front-end defines this variable. */
165 extern c_language_kind c_language;
167 /* Nonzero means give string constants the type `const char *', rather
168 than `char *'. */
170 extern int flag_const_strings;
172 /* Warn about *printf or *scanf format/argument anomalies. */
174 extern int warn_format;
176 /* Nonzero means do some things the same way PCC does. */
178 extern int flag_traditional;
180 /* Nonzero means use the ISO C99 dialect of C. */
182 extern int flag_isoc99;
184 /* Nonzero means accept digraphs. */
186 extern int flag_digraphs;
188 /* Nonzero means warn about suggesting putting in ()'s. */
190 extern int warn_parentheses;
192 /* Warn if a type conversion is done that might have confusing results. */
194 extern int warn_conversion;
196 /* C types are partitioned into three subsets: object, function, and
197 incomplete types. */
198 #define C_TYPE_OBJECT_P(type) \
199 (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type))
201 #define C_TYPE_INCOMPLETE_P(type) \
202 (TREE_CODE (type) != FUNCTION_TYPE && TYPE_SIZE (type) == 0)
204 #define C_TYPE_FUNCTION_P(type) \
205 (TREE_CODE (type) == FUNCTION_TYPE)
207 /* For convenience we define a single macro to identify the class of
208 object or incomplete types. */
209 #define C_TYPE_OBJECT_OR_INCOMPLETE_P(type) \
210 (!C_TYPE_FUNCTION_P (type))
212 /* Record in each node resulting from a binary operator
213 what operator was specified for it. */
214 #define C_EXP_ORIGINAL_CODE(exp) ((enum tree_code) TREE_COMPLEXITY (exp))
216 /* Pointer to function to generate the VAR_DECL for __FUNCTION__ etc.
217 ID is the identifier to use, NAME is the string.
218 TYPE_DEP indicates whether it depends on type of the function or not
219 (i.e. __PRETTY_FUNCTION__). */
221 extern tree (*make_fname_decl) PARAMS ((tree, const char *, int));
223 extern void declare_function_name PARAMS ((void));
224 extern void decl_attributes PARAMS ((tree, tree, tree));
225 extern void init_function_format_info PARAMS ((void));
226 extern void check_function_format PARAMS ((tree, tree, tree));
227 extern void c_apply_type_quals_to_decl PARAMS ((int, tree));
228 /* Print an error message for invalid operands to arith operation CODE.
229 NOP_EXPR is used as a special case (see truthvalue_conversion). */
230 extern void binary_op_error PARAMS ((enum tree_code));
231 extern void c_expand_expr_stmt PARAMS ((tree));
232 extern void c_expand_start_cond PARAMS ((tree, int, int));
233 extern void c_expand_start_else PARAMS ((void));
234 extern void c_expand_end_cond PARAMS ((void));
235 /* Validate the expression after `case' and apply default promotions. */
236 extern tree check_case_value PARAMS ((tree));
237 /* Concatenate a list of STRING_CST nodes into one STRING_CST. */
238 extern tree combine_strings PARAMS ((tree));
239 extern void constant_expression_warning PARAMS ((tree));
240 extern tree convert_and_check PARAMS ((tree, tree));
241 extern void overflow_warning PARAMS ((tree));
242 extern void unsigned_conversion_warning PARAMS ((tree, tree));
244 /* Read the rest of the current #-directive line. */
245 #if USE_CPPLIB
246 extern char *get_directive_line PARAMS ((void));
247 #define GET_DIRECTIVE_LINE() get_directive_line ()
248 #else
249 extern char *get_directive_line PARAMS ((FILE *));
250 #define GET_DIRECTIVE_LINE() get_directive_line (finput)
251 #endif
253 /* Subroutine of build_binary_op, used for comparison operations.
254 See if the operands have both been converted from subword integer types
255 and, if so, perhaps change them both back to their original type. */
256 extern tree shorten_compare PARAMS ((tree *, tree *, tree *, enum tree_code *));
257 /* Prepare expr to be an argument of a TRUTH_NOT_EXPR,
258 or validate its data type for an `if' or `while' statement or ?..: exp. */
259 extern tree truthvalue_conversion PARAMS ((tree));
260 extern tree type_for_mode PARAMS ((enum machine_mode, int));
261 extern tree type_for_size PARAMS ((unsigned, int));
263 /* Build tree nodes and builtin functions common to both C and C++ language
264 frontends. */
265 extern void c_common_nodes_and_builtins PARAMS ((int, int, int));
267 extern tree build_va_arg PARAMS ((tree, tree));
269 /* Nonzero if the type T promotes to itself.
270 ANSI C states explicitly the list of types that promote;
271 in particular, short promotes to int even if they have the same width. */
272 #define C_PROMOTING_INTEGER_TYPE_P(t) \
273 (TREE_CODE ((t)) == INTEGER_TYPE \
274 && (TYPE_MAIN_VARIANT (t) == char_type_node \
275 || TYPE_MAIN_VARIANT (t) == signed_char_type_node \
276 || TYPE_MAIN_VARIANT (t) == unsigned_char_type_node \
277 || TYPE_MAIN_VARIANT (t) == short_integer_type_node \
278 || TYPE_MAIN_VARIANT (t) == short_unsigned_type_node))
280 extern int self_promoting_args_p PARAMS ((tree));
281 extern tree simple_type_promotes_to PARAMS ((tree));
283 /* These macros provide convenient access to the various _STMT nodes
284 created when parsing template declarations. */
286 /* IF_STMT accessors. These give access to the condtion of the if
287 statement, the then block of the if statement, and the else block
288 of the if stsatement if it exists. */
289 #define IF_COND(NODE) TREE_OPERAND (IF_STMT_CHECK (NODE), 0)
290 #define THEN_CLAUSE(NODE) TREE_OPERAND (IF_STMT_CHECK (NODE), 1)
291 #define ELSE_CLAUSE(NODE) TREE_OPERAND (IF_STMT_CHECK (NODE), 2)
293 /* WHILE_STMT accessors. These give access to the condtion of the
294 while statement and the body of the while statement, respectively. */
295 #define WHILE_COND(NODE) TREE_OPERAND (WHILE_STMT_CHECK (NODE), 0)
296 #define WHILE_BODY(NODE) TREE_OPERAND (WHILE_STMT_CHECK (NODE), 1)
298 /* DO_STMT accessors. These give access to the condition of the do
299 statement and the body of the do statement, respectively. */
300 #define DO_COND(NODE) TREE_OPERAND (DO_STMT_CHECK (NODE), 0)
301 #define DO_BODY(NODE) TREE_OPERAND (DO_STMT_CHECK (NODE), 1)
303 /* RETURN_STMT accessor. This gives the expression associated with a
304 return statement. */
305 #define RETURN_EXPR(NODE) TREE_OPERAND (RETURN_STMT_CHECK (NODE), 0)
307 /* EXPR_STMT accessor. This gives the expression associated with an
308 expression statement. */
309 #define EXPR_STMT_EXPR(NODE) TREE_OPERAND (EXPR_STMT_CHECK (NODE), 0)
311 /* FOR_STMT accessors. These give access to the init statement,
312 condition, update expression, and body of the for statement,
313 respectively. */
314 #define FOR_INIT_STMT(NODE) TREE_OPERAND (FOR_STMT_CHECK (NODE), 0)
315 #define FOR_COND(NODE) TREE_OPERAND (FOR_STMT_CHECK (NODE), 1)
316 #define FOR_EXPR(NODE) TREE_OPERAND (FOR_STMT_CHECK (NODE), 2)
317 #define FOR_BODY(NODE) TREE_OPERAND (FOR_STMT_CHECK (NODE), 3)
319 /* SWITCH_STMT accessors. These give access to the condition and body
320 of the switch statement, respectively. */
321 #define SWITCH_COND(NODE) TREE_OPERAND (SWITCH_STMT_CHECK (NODE), 0)
322 #define SWITCH_BODY(NODE) TREE_OPERAND (SWITCH_STMT_CHECK (NODE), 1)
324 /* CASE_LABEL accessors. These give access to the high and low values
325 of a case label, respectively. */
326 #define CASE_LOW(NODE) TREE_OPERAND (CASE_LABEL_CHECK (NODE), 0)
327 #define CASE_HIGH(NODE) TREE_OPERAND (CASE_LABEL_CHECK (NODE), 1)
329 /* GOTO_STMT accessor. This gives access to the label associated with
330 a goto statement. */
331 #define GOTO_DESTINATION(NODE) TREE_OPERAND (GOTO_STMT_CHECK (NODE), 0)
333 /* COMPOUND_STMT accessor. This gives access to the TREE_LIST of
334 statements assocated with a compound statement. The result is the
335 first statement in the list. Succeeding nodes can be acccessed by
336 calling TREE_CHAIN on a node in the list. */
337 #define COMPOUND_BODY(NODE) TREE_OPERAND (COMPOUND_STMT_CHECK (NODE), 0)
339 /* ASM_STMT accessors. ASM_STRING returns a STRING_CST for the
340 instruction (e.g., "mov x, y"). ASM_OUTPUTS, ASM_INPUTS, and
341 ASM_CLOBBERS represent the outputs, inputs, and clobbers for the
342 statement. */
343 #define ASM_CV_QUAL(NODE) TREE_OPERAND (ASM_STMT_CHECK (NODE), 0)
344 #define ASM_STRING(NODE) TREE_OPERAND (ASM_STMT_CHECK (NODE), 1)
345 #define ASM_OUTPUTS(NODE) TREE_OPERAND (ASM_STMT_CHECK (NODE), 2)
346 #define ASM_INPUTS(NODE) TREE_OPERAND (ASM_STMT_CHECK (NODE), 3)
347 #define ASM_CLOBBERS(NODE) TREE_OPERAND (ASM_STMT_CHECK (NODE), 4)
349 /* DECL_STMT accessor. This gives access to the DECL associated with
350 the given declaration statement. */
351 #define DECL_STMT_DECL(NODE) TREE_OPERAND (DECL_STMT_CHECK (NODE), 0)
353 /* STMT_EXPR accessor. */
354 #define STMT_EXPR_STMT(NODE) TREE_OPERAND (STMT_EXPR_CHECK (NODE), 0)
356 /* LABEL_STMT accessor. This gives access to the label associated with
357 the given label statement. */
358 #define LABEL_STMT_LABEL(NODE) TREE_OPERAND (LABEL_STMT_CHECK (NODE), 0)
360 /* Nonzero if this SCOPE_STMT is for the beginning of a scope. */
361 #define SCOPE_BEGIN_P(NODE) \
362 (TREE_LANG_FLAG_0 (SCOPE_STMT_CHECK (NODE)))
364 /* Nonzero if this SCOPE_STMT is for the end of a scope. */
365 #define SCOPE_END_P(NODE) \
366 (!SCOPE_BEGIN_P (SCOPE_STMT_CHECK (NODE)))
368 /* The BLOCK containing the declarations contained in this scope. */
369 #define SCOPE_STMT_BLOCK(NODE) \
370 (TREE_OPERAND (SCOPE_STMT_CHECK (NODE), 0))
372 /* Nonzero for a SCOPE_STMT if there were no variables in this scope. */
373 #define SCOPE_NULLIFIED_P(NODE) \
374 (SCOPE_STMT_BLOCK ((NODE)) == NULL_TREE)
376 /* Nonzero for a SCOPE_STMT which represents a lexical scope, but
377 which should be treated as non-existant from the point of view of
378 running cleanup actions. */
379 #define SCOPE_NO_CLEANUPS_P(NODE) \
380 (TREE_LANG_FLAG_3 (SCOPE_STMT_CHECK (NODE)))
382 /* Nonzero for a SCOPE_STMT if this statement is for a partial scope.
383 For example, in:
385 S s;
387 S s2;
388 goto l;
390 there is (implicitly) a new scope after `l', even though there are
391 no curly braces. In particular, when we hit the goto, we must
392 destroy s2 and then re-construct it. For the implicit scope,
393 SCOPE_PARTIAL_P will be set. */
394 #define SCOPE_PARTIAL_P(NODE) \
395 (TREE_LANG_FLAG_4 (SCOPE_STMT_CHECK (NODE)))
397 /* Nonzero for an ASM_STMT if the assembly statement is volatile. */
398 #define ASM_VOLATILE_P(NODE) \
399 (ASM_CV_QUAL (ASM_STMT_CHECK (NODE)) != NULL_TREE)
401 /* The line-number at which a statement began. But if
402 STMT_LINENO_FOR_FN_P does holds, then this macro gives the
403 line number for the end of the current function instead. */
404 #define STMT_LINENO(NODE) \
405 (TREE_COMPLEXITY ((NODE)))
407 /* If non-zero, the STMT_LINENO for NODE is the line at which the
408 function ended. */
409 #define STMT_LINENO_FOR_FN_P(NODE) \
410 (TREE_LANG_FLAG_2 ((NODE)))
412 /* Nonzero if we want the new ISO rules for pushing a new scope for `for'
413 initialization variables. */
414 #define NEW_FOR_SCOPE_P(NODE) (TREE_LANG_FLAG_0 (NODE))
416 #define DEFTREECODE(SYM, NAME, TYPE, LENGTH) SYM,
418 enum c_tree_code {
419 C_DUMMY_TREE_CODE = LAST_AND_UNUSED_TREE_CODE,
420 #include "c-common.def"
421 LAST_C_TREE_CODE
424 #undef DEFTREECODE
426 extern void add_c_tree_codes PARAMS ((void));
427 extern void genrtl_do_pushlevel PARAMS ((void));
428 extern void genrtl_clear_out_block PARAMS ((void));
429 extern void genrtl_goto_stmt PARAMS ((tree));
430 extern void genrtl_expr_stmt PARAMS ((tree));
431 extern void genrtl_decl_stmt PARAMS ((tree));
432 extern void genrtl_if_stmt PARAMS ((tree));
433 extern void genrtl_while_stmt PARAMS ((tree));
434 extern void genrtl_do_stmt PARAMS ((tree));
435 extern void genrtl_return_stmt PARAMS ((tree));
436 extern void genrtl_for_stmt PARAMS ((tree));
437 extern void genrtl_break_stmt PARAMS ((void));
438 extern void genrtl_continue_stmt PARAMS ((void));
439 extern void genrtl_scope_stmt PARAMS ((tree));
440 extern void genrtl_switch_stmt PARAMS ((tree));
441 extern void genrtl_case_label PARAMS ((tree, tree));
442 extern void genrtl_compound_stmt PARAMS ((tree));
443 extern void genrtl_asm_stmt PARAMS ((tree, tree,
444 tree, tree,
445 tree));
446 extern void genrtl_decl_cleanup PARAMS ((tree, tree));
447 extern int stmts_are_full_exprs_p PARAMS ((void));
448 typedef void (*expand_expr_stmt_fn) PARAMS ((tree));
449 extern expand_expr_stmt_fn lang_expand_expr_stmt;
450 extern int anon_aggr_type_p PARAMS ((tree));
452 /* For a VAR_DECL that is an anonymous union, these are the various
453 sub-variables that make up the anonymous union. */
454 #define DECL_ANON_UNION_ELEMS(NODE) DECL_ARGUMENTS ((NODE))
456 extern void emit_local_var PARAMS ((tree));
457 extern void make_rtl_for_local_static PARAMS ((tree));
458 extern tree expand_cond PARAMS ((tree));
459 extern tree expand_stmt PARAMS ((tree));
460 extern tree lang_expand_stmt PARAMS ((tree));
461 extern void c_expand_return PARAMS ((tree));
462 extern tree c_expand_start_case PARAMS ((tree));
463 extern void do_case PARAMS ((tree, tree));
464 extern tree build_stmt PARAMS ((enum tree_code, ...));
465 extern tree build_case_label PARAMS ((tree, tree));
466 extern tree build_continue_stmt PARAMS ((void));
467 extern tree build_break_stmt PARAMS ((void));
468 extern tree build_return_stmt PARAMS ((tree));
470 #define COMPOUND_STMT_NO_SCOPE(NODE) TREE_LANG_FLAG_0 (NODE)
472 extern void c_expand_asm_operands PARAMS ((tree, tree, tree, tree, int, const char *, int));
473 extern int current_function_name_declared PARAMS ((void));
474 extern void set_current_function_name_declared PARAMS ((int));
476 /* These functions must be defined by each front-end which implements
477 a variant of the C language. They are used in c-common.c. */
479 extern tree build_unary_op PARAMS ((enum tree_code,
480 tree, int));
481 extern tree build_binary_op PARAMS ((enum tree_code,
482 tree, tree, int));
483 extern int lvalue_p PARAMS ((tree));
484 extern tree default_conversion PARAMS ((tree));
486 /* Given two integer or real types, return the type for their sum.
487 Given two compatible ANSI C types, returns the merged type. */
489 extern tree common_type PARAMS ((tree, tree));