Update version
[official-gcc.git] / gcc / tree.h
blob07303ca19002799029faa8d4a8b40e7b64f27c21
1 /* Front-end tree definitions for GNU compiler.
2 Copyright (C) 1989, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000
3 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 #include "machmode.h"
23 #include "version.h"
25 #ifndef RTX_CODE
26 struct rtx_def;
27 #endif
29 /* Codes of tree nodes */
31 #define DEFTREECODE(SYM, STRING, TYPE, NARGS) SYM,
33 enum tree_code {
34 #include "tree.def"
36 LAST_AND_UNUSED_TREE_CODE /* A convenient way to get a value for
37 NUM_TREE_CODE. */
40 #undef DEFTREECODE
42 /* Number of language-independent tree codes. */
43 #define NUM_TREE_CODES ((int) LAST_AND_UNUSED_TREE_CODE)
45 /* Indexed by enum tree_code, contains a character which is
46 `<' for a comparison expression, `1', for a unary arithmetic
47 expression, `2' for a binary arithmetic expression, `e' for
48 other types of expressions, `r' for a reference, `c' for a
49 constant, `d' for a decl, `t' for a type, `s' for a statement,
50 and `x' for anything else (TREE_LIST, IDENTIFIER, etc). */
52 #define MAX_TREE_CODES 256
53 extern char tree_code_type[MAX_TREE_CODES];
54 #define TREE_CODE_CLASS(CODE) tree_code_type[(int) (CODE)]
56 /* Returns non-zero iff CLASS is the tree-code class of an
57 expression. */
59 #define IS_EXPR_CODE_CLASS(CLASS) \
60 (CLASS == '<' || CLASS == '1' || CLASS == '2' || CLASS == 'e')
62 /* Number of argument-words in each kind of tree-node. */
64 extern int tree_code_length[MAX_TREE_CODES];
65 #define TREE_CODE_LENGTH(CODE) tree_code_length[(int) (CODE)]
67 /* Names of tree components. */
69 extern const char *tree_code_name[MAX_TREE_CODES];
71 /* Classify which part of the compiler has defined a given builtin function.
72 Note that we assume below that this is no more than two bits. */
73 enum built_in_class
75 NOT_BUILT_IN = 0,
76 BUILT_IN_FRONTEND,
77 BUILT_IN_MD,
78 BUILT_IN_NORMAL
81 /* Names for the above. */
82 extern const char *const built_in_class_names[4];
84 /* Codes that identify the various built in functions
85 so that expand_call can identify them quickly. */
87 #define DEF_BUILTIN(x) x,
88 enum built_in_function
90 #include "builtins.def"
92 /* Upper bound on non-language-specific builtins. */
93 END_BUILTINS
95 #undef DEF_BUILTIN
97 /* Names for the above. */
98 extern const char *const built_in_names[(int) END_BUILTINS];
100 /* An array of _DECL trees for the above. */
101 extern union tree_node *built_in_decls[(int) END_BUILTINS];
103 /* The definition of tree nodes fills the next several pages. */
105 /* A tree node can represent a data type, a variable, an expression
106 or a statement. Each node has a TREE_CODE which says what kind of
107 thing it represents. Some common codes are:
108 INTEGER_TYPE -- represents a type of integers.
109 ARRAY_TYPE -- represents a type of pointer.
110 VAR_DECL -- represents a declared variable.
111 INTEGER_CST -- represents a constant integer value.
112 PLUS_EXPR -- represents a sum (an expression).
114 As for the contents of a tree node: there are some fields
115 that all nodes share. Each TREE_CODE has various special-purpose
116 fields as well. The fields of a node are never accessed directly,
117 always through accessor macros. */
119 /* This type is used everywhere to refer to a tree node. */
121 typedef union tree_node *tree;
123 /* Every kind of tree node starts with this structure,
124 so all nodes have these fields.
126 See the accessor macros, defined below, for documentation of the
127 fields. */
129 struct tree_common
131 union tree_node *chain;
132 union tree_node *type;
133 ENUM_BITFIELD(tree_code) code : 8;
134 unsigned side_effects_flag : 1;
135 unsigned constant_flag : 1;
136 unsigned addressable_flag : 1;
137 unsigned volatile_flag : 1;
138 unsigned readonly_flag : 1;
139 unsigned unsigned_flag : 1;
140 unsigned asm_written_flag: 1;
142 unsigned used_flag : 1;
143 unsigned nothrow_flag : 1;
144 unsigned static_flag : 1;
145 unsigned public_flag : 1;
146 unsigned private_flag : 1;
147 unsigned protected_flag : 1;
148 unsigned bounded_flag : 1;
150 unsigned lang_flag_0 : 1;
151 unsigned lang_flag_1 : 1;
152 unsigned lang_flag_2 : 1;
153 unsigned lang_flag_3 : 1;
154 unsigned lang_flag_4 : 1;
155 unsigned lang_flag_5 : 1;
156 unsigned lang_flag_6 : 1;
157 /* This flag is presently unused. However, language front-ends
158 should not make use of this flag; it is reserved for future
159 expansion. */
160 unsigned dummy : 1;
163 /* The following table lists the uses of each of the above flags and
164 for which types of nodes they are defined. Note that expressions
165 include decls.
167 addressable_flag:
169 TREE_ADDRESSABLE in
170 VAR_DECL, FUNCTION_DECL, FIELD_DECL, CONSTRUCTOR, LABEL_DECL,
171 ..._TYPE, IDENTIFIER_NODE
173 static_flag:
175 TREE_STATIC in
176 VAR_DECL, FUNCTION_DECL, CONSTRUCTOR, ADDR_EXPR
177 TREE_NO_UNUSED_WARNING in
178 CONVERT_EXPR, NOP_EXPR, COMPOUND_EXPR
179 TREE_VIA_VIRTUAL in
180 TREE_LIST or TREE_VEC
181 TREE_CONSTANT_OVERFLOW in
182 INTEGER_CST, REAL_CST, COMPLEX_CST
183 TREE_SYMBOL_REFERENCED in
184 IDENTIFIER_NODE
186 public_flag:
188 TREE_OVERFLOW in
189 INTEGER_CST, REAL_CST, COMPLEX_CST
190 TREE_PUBLIC in
191 VAR_DECL or FUNCTION_DECL
192 TREE_VIA_PUBLIC in
193 TREE_LIST or TREE_VEC
194 EXPR_WFL_EMIT_LINE_NOTE in
195 EXPR_WITH_FILE_LOCATION
197 private_flag:
199 TREE_VIA_PRIVATE in
200 TREE_LIST or TREE_VEC
201 TREE_PRIVATE in
202 ??? unspecified nodes
204 protected_flag:
206 TREE_VIA_PROTECTED in
207 TREE_LIST
208 TREE_PROTECTED in
209 BLOCK
210 ??? unspecified nodes
212 side_effects_flag:
214 TREE_SIDE_EFFECTS in
215 all expressions
217 volatile_flag:
219 TREE_THIS_VOLATILE in
220 all expressions
221 TYPE_VOLATILE in
222 ..._TYPE
224 readonly_flag:
226 TREE_READONLY in
227 all expressions
228 TYPE_READONLY in
229 ..._TYPE
231 constant_flag:
233 TREE_CONSTANT in
234 all expressions
236 unsigned_flag:
238 TREE_UNSIGNED in
239 INTEGER_TYPE, ENUMERAL_TYPE, FIELD_DECL
240 DECL_BUILT_IN_NONANSI in
241 FUNCTION_DECL
242 SAVE_EXPR_NOPLACEHOLDER in
243 SAVE_EXPR
245 asm_written_flag:
247 TREE_ASM_WRITTEN in
248 VAR_DECL, FUNCTION_DECL, RECORD_TYPE, UNION_TYPE, QUAL_UNION_TYPE
249 BLOCK
251 used_flag:
253 TREE_USED in
254 expressions, IDENTIFIER_NODE
256 nothrow_flag:
258 TREE_NOTHROW in
259 CALL_EXPR, FUNCTION_DECL
261 bounded_flag:
263 TREE_BOUNDED in
264 expressions, VAR_DECL, PARM_DECL, FIELD_DECL, FUNCTION_DECL
265 TYPE_BOUNDED in
266 ..._TYPE
269 /* Define accessors for the fields that all tree nodes have
270 (though some fields are not used for all kinds of nodes). */
272 /* The tree-code says what kind of node it is.
273 Codes are defined in tree.def. */
274 #define TREE_CODE(NODE) ((enum tree_code) (NODE)->common.code)
275 #define TREE_SET_CODE(NODE, VALUE) \
276 ((NODE)->common.code = (ENUM_BITFIELD(tree_code)) (VALUE))
278 /* When checking is enabled, errors will be generated if a tree node
279 is accessed incorrectly. The macros abort with a fatal error. */
280 #if defined ENABLE_TREE_CHECKING && (GCC_VERSION >= 2007)
282 #define TREE_CHECK(t, code) __extension__ \
283 ({ const tree __t = t; \
284 if (TREE_CODE(__t) != (code)) \
285 tree_check_failed (__t, code, __FILE__, __LINE__, __FUNCTION__); \
286 __t; })
287 #define TREE_CLASS_CHECK(t, class) __extension__ \
288 ({ const tree __t = t; \
289 if (TREE_CODE_CLASS(TREE_CODE(__t)) != (class)) \
290 tree_class_check_failed (__t, class, __FILE__, __LINE__, __FUNCTION__); \
291 __t; })
293 /* These checks have to be special cased. */
294 #define CST_OR_CONSTRUCTOR_CHECK(t) __extension__ \
295 ({ const tree __t = t; \
296 enum tree_code __c = TREE_CODE(__t); \
297 if (__c != CONSTRUCTOR && TREE_CODE_CLASS(__c) != 'c') \
298 tree_check_failed (__t, CONSTRUCTOR, __FILE__, __LINE__, __FUNCTION__); \
299 __t; })
300 #define EXPR_CHECK(t) __extension__ \
301 ({ const tree __t = t; \
302 char __c = TREE_CODE_CLASS(TREE_CODE(__t)); \
303 if (__c != 'r' && __c != 's' && __c != '<' \
304 && __c != '1' && __c != '2' && __c != 'e') \
305 tree_class_check_failed(__t, 'e', __FILE__, __LINE__, __FUNCTION__); \
306 __t; })
308 extern void tree_check_failed PARAMS ((const tree, enum tree_code,
309 const char *, int, const char *))
310 ATTRIBUTE_NORETURN;
311 extern void tree_class_check_failed PARAMS ((const tree, int,
312 const char *, int, const char *))
313 ATTRIBUTE_NORETURN;
315 #else /* not ENABLE_TREE_CHECKING, or not gcc */
317 #define TREE_CHECK(t, code) (t)
318 #define TREE_CLASS_CHECK(t, code) (t)
319 #define CST_OR_CONSTRUCTOR_CHECK(t) (t)
320 #define EXPR_CHECK(t) (t)
322 #endif
324 #include "tree-check.h"
326 #define TYPE_CHECK(tree) TREE_CLASS_CHECK (tree, 't')
327 #define DECL_CHECK(tree) TREE_CLASS_CHECK (tree, 'd')
328 #define CST_CHECK(tree) TREE_CLASS_CHECK (tree, 'c')
330 /* In all nodes that are expressions, this is the data type of the expression.
331 In POINTER_TYPE nodes, this is the type that the pointer points to.
332 In ARRAY_TYPE nodes, this is the type of the elements.
333 In VECTOR_TYPE nodes, this is the type of the elements. */
334 #define TREE_TYPE(NODE) ((NODE)->common.type)
336 /* Nodes are chained together for many purposes.
337 Types are chained together to record them for being output to the debugger
338 (see the function `chain_type').
339 Decls in the same scope are chained together to record the contents
340 of the scope.
341 Statement nodes for successive statements used to be chained together.
342 Often lists of things are represented by TREE_LIST nodes that
343 are chained together. */
345 #define TREE_CHAIN(NODE) ((NODE)->common.chain)
347 /* Given an expression as a tree, strip any NON_LVALUE_EXPRs and NOP_EXPRs
348 that don't change the machine mode. */
350 #define STRIP_NOPS(EXP) \
351 while ((TREE_CODE (EXP) == NOP_EXPR \
352 || TREE_CODE (EXP) == CONVERT_EXPR \
353 || TREE_CODE (EXP) == NON_LVALUE_EXPR) \
354 && TREE_OPERAND (EXP, 0) != error_mark_node \
355 && (TYPE_MODE (TREE_TYPE (EXP)) \
356 == TYPE_MODE (TREE_TYPE (TREE_OPERAND (EXP, 0))))) \
357 (EXP) = TREE_OPERAND (EXP, 0);
359 /* Like STRIP_NOPS, but don't let the signedness change either. */
361 #define STRIP_SIGN_NOPS(EXP) \
362 while ((TREE_CODE (EXP) == NOP_EXPR \
363 || TREE_CODE (EXP) == CONVERT_EXPR \
364 || TREE_CODE (EXP) == NON_LVALUE_EXPR) \
365 && TREE_OPERAND (EXP, 0) != error_mark_node \
366 && (TYPE_MODE (TREE_TYPE (EXP)) \
367 == TYPE_MODE (TREE_TYPE (TREE_OPERAND (EXP, 0)))) \
368 && (TREE_UNSIGNED (TREE_TYPE (EXP)) \
369 == TREE_UNSIGNED (TREE_TYPE (TREE_OPERAND (EXP, 0))))) \
370 (EXP) = TREE_OPERAND (EXP, 0);
372 /* Like STRIP_NOPS, but don't alter the TREE_TYPE either. */
374 #define STRIP_TYPE_NOPS(EXP) \
375 while ((TREE_CODE (EXP) == NOP_EXPR \
376 || TREE_CODE (EXP) == CONVERT_EXPR \
377 || TREE_CODE (EXP) == NON_LVALUE_EXPR) \
378 && TREE_OPERAND (EXP, 0) != error_mark_node \
379 && (TREE_TYPE (EXP) \
380 == TREE_TYPE (TREE_OPERAND (EXP, 0)))) \
381 (EXP) = TREE_OPERAND (EXP, 0);
383 /* Nonzero if TYPE represents an integral type. Note that we do not
384 include COMPLEX types here. */
386 #define INTEGRAL_TYPE_P(TYPE) \
387 (TREE_CODE (TYPE) == INTEGER_TYPE || TREE_CODE (TYPE) == ENUMERAL_TYPE \
388 || TREE_CODE (TYPE) == BOOLEAN_TYPE || TREE_CODE (TYPE) == CHAR_TYPE)
390 /* Nonzero if TYPE represents a floating-point type, including complex
391 floating-point types. */
393 #define FLOAT_TYPE_P(TYPE) \
394 (TREE_CODE (TYPE) == REAL_TYPE \
395 || (TREE_CODE (TYPE) == COMPLEX_TYPE \
396 && TREE_CODE (TREE_TYPE (TYPE)) == REAL_TYPE))
398 /* Nonzero if TYPE represents an aggregate (multi-component) type. */
400 #define AGGREGATE_TYPE_P(TYPE) \
401 (TREE_CODE (TYPE) == ARRAY_TYPE || TREE_CODE (TYPE) == RECORD_TYPE \
402 || TREE_CODE (TYPE) == UNION_TYPE || TREE_CODE (TYPE) == QUAL_UNION_TYPE \
403 || TREE_CODE (TYPE) == SET_TYPE)
405 /* Nonzero if TYPE represents an unbounded pointer or unbounded
406 reference type. (It should be renamed to INDIRECT_TYPE_P.) */
408 #define POINTER_TYPE_P(TYPE) \
409 (TREE_CODE (TYPE) == POINTER_TYPE || TREE_CODE (TYPE) == REFERENCE_TYPE)
411 /* Nonzero if TYPE represents a bounded pointer or bounded reference type. */
413 #define BOUNDED_INDIRECT_TYPE_P(TYPE) \
414 (TREE_CODE (TYPE) == RECORD_TYPE && TREE_TYPE (TYPE))
416 /* Nonzero if TYPE represents a bounded pointer type. */
418 #define BOUNDED_POINTER_TYPE_P(TYPE) \
419 (BOUNDED_INDIRECT_TYPE_P (TYPE) \
420 && TREE_CODE (TYPE_BOUNDED_SUBTYPE (TYPE)) == POINTER_TYPE)
422 /* Nonzero if TYPE represents a bounded reference type. Bounded
423 reference types have two specific uses: (1) When a reference is
424 seated to a variable-length RECORD_TYPE that has an array of
425 indeterminate length as its final field. For all other objects, it
426 is sufficient to check bounds at the time the reference is seated,
427 and assume that all future uses of the reference are safe, since
428 the address of references cannot change. (2) When a reference
429 supertype is seated to an subtype object. The bounds "remember"
430 the true size of the complete object, so that subsequent upcasts of
431 the address of the reference will be checked properly (is such a
432 thing valid C++?). */
434 #define BOUNDED_REFERENCE_TYPE_P(TYPE) \
435 (BOUNDED_INDIRECT_TYPE_P (TYPE) \
436 && TREE_CODE (TYPE_BOUNDED_SUBTYPE (TYPE)) == REFERENCE_TYPE)
438 /* Nonzero if TYPE represents a pointer or reference type, either
439 bounded or unbounded. */
441 #define MAYBE_BOUNDED_INDIRECT_TYPE_P(TYPE) \
442 (POINTER_TYPE_P (TYPE) || BOUNDED_INDIRECT_TYPE_P (TYPE))
444 /* Nonzero if TYPE represents a pointer type, either bounded or unbounded. */
446 #define MAYBE_BOUNDED_POINTER_TYPE_P(TYPE) \
447 (TREE_CODE (TYPE) == POINTER_TYPE || BOUNDED_POINTER_TYPE_P (TYPE))
449 /* Nonzero if TYPE represents a reference type, either bounded or unbounded. */
451 #define MAYBE_BOUNDED_REFERENCE_TYPE_P(TYPE) \
452 (TREE_CODE (TYPE) == REFERENCE_TYPE || BOUNDED_REFERENCE_TYPE_P (TYPE))
454 /* Nonzero if this type is a complete type. */
455 #define COMPLETE_TYPE_P(NODE) (TYPE_SIZE (NODE) != NULL_TREE)
457 /* Nonzero if this type is the (possibly qualified) void type. */
458 #define VOID_TYPE_P(NODE) (TREE_CODE (NODE) == VOID_TYPE)
460 /* Nonzero if this type is complete or is cv void. */
461 #define COMPLETE_OR_VOID_TYPE_P(NODE) \
462 (COMPLETE_TYPE_P (NODE) || VOID_TYPE_P (NODE))
464 /* Nonzero if this type is complete or is an array with unspecified bound. */
465 #define COMPLETE_OR_UNBOUND_ARRAY_TYPE_P(NODE) \
466 (COMPLETE_TYPE_P (TREE_CODE (NODE) == ARRAY_TYPE ? TREE_TYPE (NODE) : NODE))
468 /* Nonzero if TYPE represents a type. */
470 #define TYPE_P(TYPE) (TREE_CODE_CLASS (TREE_CODE (TYPE)) == 't')
472 /* Define many boolean fields that all tree nodes have. */
474 /* In VAR_DECL nodes, nonzero means address of this is needed.
475 So it cannot be in a register.
476 In a FUNCTION_DECL, nonzero means its address is needed.
477 So it must be compiled even if it is an inline function.
478 In a FIELD_DECL node, it means that the programmer is permitted to
479 construct the address of this field. This is used for aliasing
480 purposes: see record_component_aliases.
481 In CONSTRUCTOR nodes, it means object constructed must be in memory.
482 In LABEL_DECL nodes, it means a goto for this label has been seen
483 from a place outside all binding contours that restore stack levels.
484 In ..._TYPE nodes, it means that objects of this type must
485 be fully addressable. This means that pieces of this
486 object cannot go into register parameters, for example.
487 In IDENTIFIER_NODEs, this means that some extern decl for this name
488 had its address taken. That matters for inline functions. */
489 #define TREE_ADDRESSABLE(NODE) ((NODE)->common.addressable_flag)
491 /* In a VAR_DECL, nonzero means allocate static storage.
492 In a FUNCTION_DECL, nonzero if function has been defined.
493 In a CONSTRUCTOR, nonzero means allocate static storage. */
494 #define TREE_STATIC(NODE) ((NODE)->common.static_flag)
496 /* In a CONVERT_EXPR, NOP_EXPR or COMPOUND_EXPR, this means the node was
497 made implicitly and should not lead to an "unused value" warning. */
498 #define TREE_NO_UNUSED_WARNING(NODE) ((NODE)->common.static_flag)
500 /* Nonzero for a TREE_LIST or TREE_VEC node means that the derivation
501 chain is via a `virtual' declaration. */
502 #define TREE_VIA_VIRTUAL(NODE) ((NODE)->common.static_flag)
504 /* In an INTEGER_CST, REAL_CST, or COMPLEX_CST, this means there was an
505 overflow in folding. This is distinct from TREE_OVERFLOW because ANSI C
506 requires a diagnostic when overflows occur in constant expressions. */
507 #define TREE_CONSTANT_OVERFLOW(NODE) ((NODE)->common.static_flag)
509 /* In an IDENTIFIER_NODE, this means that assemble_name was called with
510 this string as an argument. */
511 #define TREE_SYMBOL_REFERENCED(NODE) ((NODE)->common.static_flag)
513 /* In an INTEGER_CST, REAL_CST, of COMPLEX_CST, this means there was an
514 overflow in folding, and no warning has been issued for this subexpression.
515 TREE_OVERFLOW implies TREE_CONSTANT_OVERFLOW, but not vice versa. */
516 #define TREE_OVERFLOW(NODE) ((NODE)->common.public_flag)
518 /* In a VAR_DECL or FUNCTION_DECL,
519 nonzero means name is to be accessible from outside this module.
520 In an identifier node, nonzero means an external declaration
521 accessible from outside this module was previously seen
522 for this name in an inner scope. */
523 #define TREE_PUBLIC(NODE) ((NODE)->common.public_flag)
525 /* Nonzero for TREE_LIST or TREE_VEC node means that the path to the
526 base class is via a `public' declaration, which preserves public
527 fields from the base class as public. */
528 #define TREE_VIA_PUBLIC(NODE) ((NODE)->common.public_flag)
530 /* Ditto, for `private' declarations. */
531 #define TREE_VIA_PRIVATE(NODE) ((NODE)->common.private_flag)
533 /* Nonzero for TREE_LIST node means that the path to the
534 base class is via a `protected' declaration, which preserves
535 protected fields from the base class as protected.
536 OVERLOADED. */
537 #define TREE_VIA_PROTECTED(NODE) ((NODE)->common.protected_flag)
539 /* In any expression, nonzero means it has side effects or reevaluation
540 of the whole expression could produce a different value.
541 This is set if any subexpression is a function call, a side effect
542 or a reference to a volatile variable.
543 In a ..._DECL, this is set only if the declaration said `volatile'. */
544 #define TREE_SIDE_EFFECTS(NODE) ((NODE)->common.side_effects_flag)
546 /* Nonzero means this expression is volatile in the C sense:
547 its address should be of type `volatile WHATEVER *'.
548 In other words, the declared item is volatile qualified.
549 This is used in _DECL nodes and _REF nodes.
551 In a ..._TYPE node, means this type is volatile-qualified.
552 But use TYPE_VOLATILE instead of this macro when the node is a type,
553 because eventually we may make that a different bit.
555 If this bit is set in an expression, so is TREE_SIDE_EFFECTS. */
556 #define TREE_THIS_VOLATILE(NODE) ((NODE)->common.volatile_flag)
558 /* In a VAR_DECL, PARM_DECL or FIELD_DECL, or any kind of ..._REF node,
559 nonzero means it may not be the lhs of an assignment.
560 In a ..._TYPE node, means this type is const-qualified
561 (but the macro TYPE_READONLY should be used instead of this macro
562 when the node is a type). */
563 #define TREE_READONLY(NODE) ((NODE)->common.readonly_flag)
565 /* Value of expression is constant.
566 Always appears in all ..._CST nodes.
567 May also appear in an arithmetic expression, an ADDR_EXPR or a CONSTRUCTOR
568 if the value is constant. */
569 #define TREE_CONSTANT(NODE) ((NODE)->common.constant_flag)
571 /* In INTEGER_TYPE or ENUMERAL_TYPE nodes, means an unsigned type.
572 In FIELD_DECL nodes, means an unsigned bit field.
573 The same bit is used in functions as DECL_BUILT_IN_NONANSI. */
574 #define TREE_UNSIGNED(NODE) ((NODE)->common.unsigned_flag)
576 #define TYPE_TRAP_SIGNED(NODE) (flag_trapv && ! TREE_UNSIGNED (NODE))
578 /* Nonzero in a VAR_DECL means assembler code has been written.
579 Nonzero in a FUNCTION_DECL means that the function has been compiled.
580 This is interesting in an inline function, since it might not need
581 to be compiled separately.
582 Nonzero in a RECORD_TYPE, UNION_TYPE, QUAL_UNION_TYPE or ENUMERAL_TYPE
583 if the sdb debugging info for the type has been written.
584 In a BLOCK node, nonzero if reorder_blocks has already seen this block. */
585 #define TREE_ASM_WRITTEN(NODE) ((NODE)->common.asm_written_flag)
587 /* Nonzero in a _DECL if the name is used in its scope.
588 Nonzero in an expr node means inhibit warning if value is unused.
589 In IDENTIFIER_NODEs, this means that some extern decl for this name
590 was used. */
591 #define TREE_USED(NODE) ((NODE)->common.used_flag)
593 /* In a FUNCTION_DECL, nonzero means a call to the function cannot throw
594 an exception. In a CALL_EXPR, nonzero means the call cannot throw. */
595 #define TREE_NOTHROW(NODE) ((NODE)->common.nothrow_flag)
597 /* Used in classes in C++. */
598 #define TREE_PRIVATE(NODE) ((NODE)->common.private_flag)
599 /* Used in classes in C++.
600 In a BLOCK node, this is BLOCK_HANDLER_BLOCK. */
601 #define TREE_PROTECTED(NODE) ((NODE)->common.protected_flag)
603 /* In a ..._TYPE node, nonzero means that the type's size and layout,
604 (or the size and layout of its arguments and/or return value in the
605 case of a FUNCTION_TYPE or METHOD_TYPE) was changed by the presence
606 of pointer bounds. Use TYPE_BOUNDED instead of this macro when the
607 node is a type, because eventually we may make that a different
608 bit. TYPE_BOUNDED doesn't mean that this type is a bounded indirect
609 type--use BOUNDED_POINTER_TYPE_P, BOUNDED_REFERENCE_TYPE_P,
610 BOUNDED_INDIRECT_TYPE_P to test for that.
612 In a FUNCTION_DECL, nonzero means that the size and layout of one
613 of its arguments and/or return value was changed by the presence of
614 pointer bounds. This value can differ from the value of
615 TYPE_BOUNDED (TREE_TYPE (fundecl)) if the function was implicitly
616 declared, then later called with pointer args, or was declared with
617 a variable argument list and is later called with pointer values in
618 the variable argument list.
620 In a VAR_DECL, PARM_DECL or FIELD_DECL, TREE_BOUNDED matches the value
621 of the decl's type's BOUNDED_POINTER_TYPE_P.
623 In a CONSTRUCTOR or other expression, nonzero means the value is a
624 bounded pointer. It is insufficient to determine the boundedness
625 of an expression EXP with BOUNDED_POINTER_TYPE_P (TREE_TYPE (EXP)),
626 since we allow pointer to be temporarily cast to integer for
627 rounding up to an alignment boudary in a way that preserves the
628 pointer's bounds.
630 In an IDENTIFIER_NODE, nonzero means that the name is prefixed with
631 BP_PREFIX (see varasm.c). This occurs for the DECL_ASSEMBLER_NAME
632 of a function that has bounded pointer(s) for its return type and/or
633 argument type(s). */
635 #define TREE_BOUNDED(NODE) ((NODE)->common.bounded_flag)
637 /* These flags are available for each language front end to use internally. */
638 #define TREE_LANG_FLAG_0(NODE) ((NODE)->common.lang_flag_0)
639 #define TREE_LANG_FLAG_1(NODE) ((NODE)->common.lang_flag_1)
640 #define TREE_LANG_FLAG_2(NODE) ((NODE)->common.lang_flag_2)
641 #define TREE_LANG_FLAG_3(NODE) ((NODE)->common.lang_flag_3)
642 #define TREE_LANG_FLAG_4(NODE) ((NODE)->common.lang_flag_4)
643 #define TREE_LANG_FLAG_5(NODE) ((NODE)->common.lang_flag_5)
644 #define TREE_LANG_FLAG_6(NODE) ((NODE)->common.lang_flag_6)
646 /* Define additional fields and accessors for nodes representing constants. */
648 /* In an INTEGER_CST node. These two together make a 2-word integer.
649 If the data type is signed, the value is sign-extended to 2 words
650 even though not all of them may really be in use.
651 In an unsigned constant shorter than 2 words, the extra bits are 0. */
652 #define TREE_INT_CST(NODE) (INTEGER_CST_CHECK (NODE)->int_cst.int_cst)
653 #define TREE_INT_CST_LOW(NODE) (TREE_INT_CST (NODE).low)
654 #define TREE_INT_CST_HIGH(NODE) (TREE_INT_CST (NODE).high)
656 #define INT_CST_LT(A, B) \
657 (TREE_INT_CST_HIGH (A) < TREE_INT_CST_HIGH (B) \
658 || (TREE_INT_CST_HIGH (A) == TREE_INT_CST_HIGH (B) \
659 && TREE_INT_CST_LOW (A) < TREE_INT_CST_LOW (B)))
661 #define INT_CST_LT_UNSIGNED(A, B) \
662 (((unsigned HOST_WIDE_INT) TREE_INT_CST_HIGH (A) \
663 < (unsigned HOST_WIDE_INT) TREE_INT_CST_HIGH (B)) \
664 || (((unsigned HOST_WIDE_INT) TREE_INT_CST_HIGH (A) \
665 == (unsigned HOST_WIDE_INT) TREE_INT_CST_HIGH (B)) \
666 && TREE_INT_CST_LOW (A) < TREE_INT_CST_LOW (B)))
668 struct tree_int_cst
670 struct tree_common common;
671 struct rtx_def *rtl; /* acts as link to register transfer language
672 (rtl) info */
673 /* A sub-struct is necessary here because the function `const_hash'
674 wants to scan both words as a unit and taking the address of the
675 sub-struct yields the properly inclusive bounded pointer. */
676 struct {
677 unsigned HOST_WIDE_INT low;
678 HOST_WIDE_INT high;
679 } int_cst;
682 /* In REAL_CST, STRING_CST, COMPLEX_CST nodes, and CONSTRUCTOR nodes,
683 and generally in all kinds of constants that could
684 be given labels (rather than being immediate). */
686 #define TREE_CST_RTL(NODE) (CST_OR_CONSTRUCTOR_CHECK (NODE)->real_cst.rtl)
688 /* In a REAL_CST node. */
689 /* We can represent a real value as either a `double' or a string.
690 Strings don't allow for any optimization, but they do allow
691 for cross-compilation. */
693 #define TREE_REAL_CST(NODE) (REAL_CST_CHECK (NODE)->real_cst.real_cst)
695 #include "real.h"
697 struct tree_real_cst
699 struct tree_common common;
700 struct rtx_def *rtl; /* acts as link to register transfer language
701 (rtl) info */
702 REAL_VALUE_TYPE real_cst;
705 /* In a STRING_CST */
706 #define TREE_STRING_LENGTH(NODE) (STRING_CST_CHECK (NODE)->string.length)
707 #define TREE_STRING_POINTER(NODE) (STRING_CST_CHECK (NODE)->string.pointer)
709 struct tree_string
711 struct tree_common common;
712 struct rtx_def *rtl; /* acts as link to register transfer language
713 (rtl) info */
714 int length;
715 const char *pointer;
718 /* In a COMPLEX_CST node. */
719 #define TREE_REALPART(NODE) (COMPLEX_CST_CHECK (NODE)->complex.real)
720 #define TREE_IMAGPART(NODE) (COMPLEX_CST_CHECK (NODE)->complex.imag)
722 struct tree_complex
724 struct tree_common common;
725 struct rtx_def *rtl; /* acts as link to register transfer language
726 (rtl) info */
727 union tree_node *real;
728 union tree_node *imag;
731 /* Define fields and accessors for some special-purpose tree nodes. */
733 #define IDENTIFIER_LENGTH(NODE) (IDENTIFIER_NODE_CHECK (NODE)->identifier.length)
734 #define IDENTIFIER_POINTER(NODE) (IDENTIFIER_NODE_CHECK (NODE)->identifier.pointer)
736 struct tree_identifier
738 struct tree_common common;
739 int length;
740 const char *pointer;
743 /* In a TREE_LIST node. */
744 #define TREE_PURPOSE(NODE) (TREE_LIST_CHECK (NODE)->list.purpose)
745 #define TREE_VALUE(NODE) (TREE_LIST_CHECK (NODE)->list.value)
747 struct tree_list
749 struct tree_common common;
750 union tree_node *purpose;
751 union tree_node *value;
754 /* In a TREE_VEC node. */
755 #define TREE_VEC_LENGTH(NODE) (TREE_VEC_CHECK (NODE)->vec.length)
756 #define TREE_VEC_ELT(NODE,I) (TREE_VEC_CHECK (NODE)->vec.a[I])
757 #define TREE_VEC_END(NODE) ((void) TREE_VEC_CHECK (NODE),&((NODE)->vec.a[(NODE)->vec.length]))
759 struct tree_vec
761 struct tree_common common;
762 int length;
763 union tree_node *a[1];
766 /* Define fields and accessors for some nodes that represent expressions. */
768 /* In a SAVE_EXPR node. */
769 #define SAVE_EXPR_CONTEXT(NODE) TREE_OPERAND(NODE, 1)
770 #define SAVE_EXPR_RTL(NODE) (*(struct rtx_def **) &EXPR_CHECK (NODE)->exp.operands[2])
771 #define SAVE_EXPR_NOPLACEHOLDER(NODE) TREE_UNSIGNED (NODE)
772 /* Nonzero if the SAVE_EXPRs value should be kept, even if it occurs
773 both in normal code and in a handler. (Normally, in a handler, all
774 SAVE_EXPRs are unsaved, meaning that there values are
775 recalculated.) */
776 #define SAVE_EXPR_PERSISTENT_P(NODE) TREE_ASM_WRITTEN (NODE)
778 /* In a RTL_EXPR node. */
779 #define RTL_EXPR_SEQUENCE(NODE) (*(struct rtx_def **) &EXPR_CHECK (NODE)->exp.operands[0])
780 #define RTL_EXPR_RTL(NODE) (*(struct rtx_def **) &EXPR_CHECK (NODE)->exp.operands[1])
782 /* In a CONSTRUCTOR node. */
783 #define CONSTRUCTOR_ELTS(NODE) TREE_OPERAND (NODE, 1)
785 /* In ordinary expression nodes. */
786 #define TREE_OPERAND(NODE, I) (EXPR_CHECK (NODE)->exp.operands[I])
787 #define TREE_COMPLEXITY(NODE) (EXPR_CHECK (NODE)->exp.complexity)
789 /* In a LABELED_BLOCK_EXPR node. */
790 #define LABELED_BLOCK_LABEL(NODE) TREE_OPERAND (NODE, 0)
791 #define LABELED_BLOCK_BODY(NODE) TREE_OPERAND (NODE, 1)
793 /* In a EXIT_BLOCK_EXPR node. */
794 #define EXIT_BLOCK_LABELED_BLOCK(NODE) TREE_OPERAND (NODE, 0)
795 #define EXIT_BLOCK_RETURN(NODE) TREE_OPERAND (NODE, 1)
797 /* In a LOOP_EXPR node. */
798 #define LOOP_EXPR_BODY(NODE) TREE_OPERAND (NODE, 0)
800 /* In a EXPR_WITH_FILE_LOCATION node. */
801 #define EXPR_WFL_NODE(NODE) TREE_OPERAND((NODE), 0)
802 #define EXPR_WFL_FILENAME(NODE) \
803 (IDENTIFIER_POINTER (EXPR_WFL_FILENAME_NODE ((NODE))))
804 #define EXPR_WFL_FILENAME_NODE(NODE) TREE_OPERAND((NODE), 1)
805 #define EXPR_WFL_LINENO(NODE) (EXPR_CHECK (NODE)->exp.complexity >> 12)
806 #define EXPR_WFL_COLNO(NODE) (EXPR_CHECK (NODE)->exp.complexity & 0xfff)
807 #define EXPR_WFL_LINECOL(NODE) (EXPR_CHECK (NODE)->exp.complexity)
808 #define EXPR_WFL_SET_LINECOL(NODE, LINE, COL) \
809 (EXPR_WFL_LINECOL(NODE) = ((LINE) << 12) | ((COL) & 0xfff))
810 #define EXPR_WFL_EMIT_LINE_NOTE(NODE) ((NODE)->common.public_flag)
812 struct tree_exp
814 struct tree_common common;
815 int complexity;
816 union tree_node *operands[1];
819 /* In a BLOCK node. */
820 #define BLOCK_VARS(NODE) (BLOCK_CHECK (NODE)->block.vars)
821 #define BLOCK_SUBBLOCKS(NODE) (BLOCK_CHECK (NODE)->block.subblocks)
822 #define BLOCK_SUPERCONTEXT(NODE) (BLOCK_CHECK (NODE)->block.supercontext)
823 /* Note: when changing this, make sure to find the places
824 that use chainon or nreverse. */
825 #define BLOCK_CHAIN(NODE) TREE_CHAIN (BLOCK_CHECK (NODE))
826 #define BLOCK_ABSTRACT_ORIGIN(NODE) (BLOCK_CHECK (NODE)->block.abstract_origin)
827 #define BLOCK_ABSTRACT(NODE) (BLOCK_CHECK (NODE)->block.abstract_flag)
829 /* Nonzero means that this block is prepared to handle exceptions
830 listed in the BLOCK_VARS slot. */
831 #define BLOCK_HANDLER_BLOCK(NODE) (BLOCK_CHECK (NODE)->block.handler_block_flag)
833 /* An index number for this block. These values are not guaranteed to
834 be unique across functions -- whether or not they are depends on
835 the debugging output format in use. */
836 #define BLOCK_NUMBER(NODE) (BLOCK_CHECK (NODE)->block.block_num)
838 struct tree_block
840 struct tree_common common;
842 unsigned handler_block_flag : 1;
843 unsigned abstract_flag : 1;
844 unsigned block_num : 30;
846 union tree_node *vars;
847 union tree_node *subblocks;
848 union tree_node *supercontext;
849 union tree_node *abstract_origin;
852 /* Define fields and accessors for nodes representing data types. */
854 /* See tree.def for documentation of the use of these fields.
855 Look at the documentation of the various ..._TYPE tree codes. */
857 #define TYPE_UID(NODE) (TYPE_CHECK (NODE)->type.uid)
858 #define TYPE_SIZE(NODE) (TYPE_CHECK (NODE)->type.size)
859 #define TYPE_SIZE_UNIT(NODE) (TYPE_CHECK (NODE)->type.size_unit)
860 #define TYPE_MODE(NODE) (TYPE_CHECK (NODE)->type.mode)
861 #define TYPE_VALUES(NODE) (TYPE_CHECK (NODE)->type.values)
862 #define TYPE_DOMAIN(NODE) (TYPE_CHECK (NODE)->type.values)
863 #define TYPE_FIELDS(NODE) (TYPE_CHECK (NODE)->type.values)
864 #define TYPE_METHODS(NODE) (TYPE_CHECK (NODE)->type.maxval)
865 #define TYPE_VFIELD(NODE) (TYPE_CHECK (NODE)->type.minval)
866 #define TYPE_ARG_TYPES(NODE) (TYPE_CHECK (NODE)->type.values)
867 #define TYPE_METHOD_BASETYPE(NODE) (TYPE_CHECK (NODE)->type.maxval)
868 #define TYPE_OFFSET_BASETYPE(NODE) (TYPE_CHECK (NODE)->type.maxval)
869 #define TYPE_POINTER_TO(NODE) (TYPE_CHECK (NODE)->type.pointer_to)
870 #define TYPE_REFERENCE_TO(NODE) (TYPE_CHECK (NODE)->type.reference_to)
871 #define TYPE_MIN_VALUE(NODE) (TYPE_CHECK (NODE)->type.minval)
872 #define TYPE_MAX_VALUE(NODE) (TYPE_CHECK (NODE)->type.maxval)
873 #define TYPE_PRECISION(NODE) (TYPE_CHECK (NODE)->type.precision)
874 #define TYPE_SYMTAB_ADDRESS(NODE) (TYPE_CHECK (NODE)->type.symtab.address)
875 #define TYPE_SYMTAB_POINTER(NODE) (TYPE_CHECK (NODE)->type.symtab.pointer)
876 #define TYPE_NAME(NODE) (TYPE_CHECK (NODE)->type.name)
877 #define TYPE_NEXT_VARIANT(NODE) (TYPE_CHECK (NODE)->type.next_variant)
878 #define TYPE_MAIN_VARIANT(NODE) (TYPE_CHECK (NODE)->type.main_variant)
879 #define TYPE_NONCOPIED_PARTS(NODE) (TYPE_CHECK (NODE)->type.noncopied_parts)
880 #define TYPE_CONTEXT(NODE) (TYPE_CHECK (NODE)->type.context)
881 #define TYPE_LANG_SPECIFIC(NODE) (TYPE_CHECK (NODE)->type.lang_specific)
883 /* For a VECTOR_TYPE node, this describes a different type which is emitted
884 in the debugging output. We use this to describe a vector as a
885 structure containing an array. */
886 #define TYPE_DEBUG_REPRESENTATION_TYPE(NODE) (TYPE_CHECK (NODE)->type.values)
888 /* Indirect types present difficulties because they may be represented
889 as either POINTER_TYPE/REFERENCE_TYPE nodes (unbounded) or as
890 RECORD_TYPE nodes (bounded). Bounded and unbounded pointers might
891 be logically equivalent, but physically different. Simple
892 comparison of the main variant only tells if the types are
893 logically equivalent. Use this predicate to compare for physical
894 equivalency. */
896 /* Types have the same main variant, and have the same boundedness. */
897 #define TYPE_MAIN_VARIANTS_PHYSICALLY_EQUAL_P(TYPE1, TYPE2) \
898 (TYPE_MAIN_VARIANT (TYPE1) == TYPE_MAIN_VARIANT (TYPE2) \
899 && TREE_CODE (TYPE1) == TREE_CODE (TYPE2))
901 /* Return the type variant that has no qualifiers (i.e., the main variant),
902 except that the boundedness qualifier is preserved. */
903 #define TYPE_MAIN_PHYSICAL_VARIANT(TYPE) \
904 (BOUNDED_POINTER_TYPE_P (TYPE) \
905 ? build_qualified_type (TYPE, TYPE_QUAL_BOUNDED) \
906 : TYPE_MAIN_VARIANT (TYPE))
908 /* For aggregate types, information about this type, as a base type
909 for itself. Used in a language-dependent way for types that are
910 neither a RECORD_TYPE, QUAL_UNION_TYPE, nor a UNION_TYPE. */
911 #define TYPE_BINFO(NODE) (TYPE_CHECK (NODE)->type.binfo)
913 /* The (language-specific) typed-based alias set for this type.
914 Objects whose TYPE_ALIAS_SETs are different cannot alias each
915 other. If the TYPE_ALIAS_SET is -1, no alias set has yet been
916 assigned to this type. If the TYPE_ALIAS_SET is 0, objects of this
917 type can alias objects of any type. */
918 #define TYPE_ALIAS_SET(NODE) (TYPE_CHECK (NODE)->type.alias_set)
920 /* Nonzero iff the typed-based alias set for this type has been
921 calculated. */
922 #define TYPE_ALIAS_SET_KNOWN_P(NODE) \
923 (TYPE_CHECK (NODE)->type.alias_set != -1)
925 /* A TREE_LIST of IDENTIFIER nodes of the attributes that apply
926 to this type. */
927 #define TYPE_ATTRIBUTES(NODE) (TYPE_CHECK (NODE)->type.attributes)
929 /* The alignment necessary for objects of this type.
930 The value is an int, measured in bits. */
931 #define TYPE_ALIGN(NODE) (TYPE_CHECK (NODE)->type.align)
933 /* 1 if the alignment for this type was requested by "aligned" attribute,
934 0 if it is the default for this type. */
935 #define TYPE_USER_ALIGN(NODE) (TYPE_CHECK (NODE)->type.user_align)
937 /* The alignment for NODE, in bytes. */
938 #define TYPE_ALIGN_UNIT(NODE) \
939 (TYPE_ALIGN (NODE) / BITS_PER_UNIT)
941 /* If your language allows you to declare types, and you want debug info
942 for them, then you need to generate corresponding TYPE_DECL nodes.
943 These "stub" TYPE_DECL nodes have no name, and simply point at the
944 type node. You then set the TYPE_STUB_DECL field of the type node
945 to point back at the TYPE_DECL node. This allows the debug routines
946 to know that the two nodes represent the same type, so that we only
947 get one debug info record for them. */
948 #define TYPE_STUB_DECL(NODE) (TREE_CHAIN (NODE))
950 /* In a RECORD_TYPE, UNION_TYPE or QUAL_UNION_TYPE, it means the type
951 has BLKmode only because it lacks the alignment requirement for
952 its size. */
953 #define TYPE_NO_FORCE_BLK(NODE) (TYPE_CHECK (NODE)->type.no_force_blk_flag)
955 /* In an INTEGER_TYPE, it means the type represents a size. We use
956 this both for validity checking and to permit optimizations that
957 are unsafe for other types. Note that the C `size_t' type should
958 *not* have this flag set. The `size_t' type is simply a typedef
959 for an ordinary integer type that happens to be the type of an
960 expression returned by `sizeof'; `size_t' has no special
961 properties. Expressions whose type have TYPE_IS_SIZETYPE set are
962 always actual sizes. */
963 #define TYPE_IS_SIZETYPE(NODE) \
964 (INTEGER_TYPE_CHECK (NODE)->type.no_force_blk_flag)
966 /* In a FUNCTION_TYPE, indicates that the function returns with the stack
967 pointer depressed. */
968 #define TYPE_RETURNS_STACK_DEPRESSED(NODE) \
969 (FUNCTION_TYPE_CHECK (NODE)->type.no_force_blk_flag)
971 /* Nonzero in a type considered volatile as a whole. */
972 #define TYPE_VOLATILE(NODE) ((NODE)->common.volatile_flag)
974 /* Means this type is const-qualified. */
975 #define TYPE_READONLY(NODE) ((NODE)->common.readonly_flag)
977 /* If nonzero, this type is `restrict'-qualified, in the C sense of
978 the term. */
979 #define TYPE_RESTRICT(NODE) (TYPE_CHECK (NODE)->type.restrict_flag)
981 /* If nonzero, this type's size and layout, (or the size and layout of
982 its arguments and/or return value in the case of a FUNCTION_TYPE or
983 METHOD_TYPE) was changed by the presence of pointer bounds. */
984 #define TYPE_BOUNDED(NODE) (TYPE_CHECK (NODE)->common.bounded_flag)
986 /* There is a TYPE_QUAL value for each type qualifier. They can be
987 combined by bitwise-or to form the complete set of qualifiers for a
988 type. */
990 #define TYPE_UNQUALIFIED 0x0
991 #define TYPE_QUAL_CONST 0x1
992 #define TYPE_QUAL_VOLATILE 0x2
993 #define TYPE_QUAL_RESTRICT 0x4
994 #define TYPE_QUAL_BOUNDED 0x8
996 /* The set of type qualifiers for this type. */
997 #define TYPE_QUALS(NODE) \
998 ((TYPE_READONLY (NODE) * TYPE_QUAL_CONST) \
999 | (TYPE_VOLATILE (NODE) * TYPE_QUAL_VOLATILE) \
1000 | (TYPE_RESTRICT (NODE) * TYPE_QUAL_RESTRICT) \
1001 | (BOUNDED_INDIRECT_TYPE_P (NODE) * TYPE_QUAL_BOUNDED))
1003 /* The set of qualifiers pertinent to an expression node. */
1004 #define TREE_EXPR_QUALS(NODE) \
1005 ((TREE_READONLY (NODE) * TYPE_QUAL_CONST) \
1006 | (TREE_THIS_VOLATILE (NODE) * TYPE_QUAL_VOLATILE) \
1007 | (TREE_BOUNDED (NODE) * TYPE_QUAL_BOUNDED))
1009 /* The set of qualifiers pertinent to a FUNCTION_DECL node. */
1010 #define TREE_FUNC_QUALS(NODE) \
1011 ((TREE_READONLY (NODE) * TYPE_QUAL_CONST) \
1012 | (TREE_THIS_VOLATILE (NODE) * TYPE_QUAL_VOLATILE))
1014 /* These flags are available for each language front end to use internally. */
1015 #define TYPE_LANG_FLAG_0(NODE) (TYPE_CHECK (NODE)->type.lang_flag_0)
1016 #define TYPE_LANG_FLAG_1(NODE) (TYPE_CHECK (NODE)->type.lang_flag_1)
1017 #define TYPE_LANG_FLAG_2(NODE) (TYPE_CHECK (NODE)->type.lang_flag_2)
1018 #define TYPE_LANG_FLAG_3(NODE) (TYPE_CHECK (NODE)->type.lang_flag_3)
1019 #define TYPE_LANG_FLAG_4(NODE) (TYPE_CHECK (NODE)->type.lang_flag_4)
1020 #define TYPE_LANG_FLAG_5(NODE) (TYPE_CHECK (NODE)->type.lang_flag_5)
1021 #define TYPE_LANG_FLAG_6(NODE) (TYPE_CHECK (NODE)->type.lang_flag_6)
1023 /* If set in an ARRAY_TYPE, indicates a string type (for languages
1024 that distinguish string from array of char).
1025 If set in a SET_TYPE, indicates a bitstring type. */
1026 #define TYPE_STRING_FLAG(NODE) (TYPE_CHECK (NODE)->type.string_flag)
1028 /* If non-NULL, this is a upper bound of the size (in bytes) of an
1029 object of the given ARRAY_TYPE. This allows temporaries to be allocated. */
1030 #define TYPE_ARRAY_MAX_SIZE(ARRAY_TYPE) TYPE_MAX_VALUE (ARRAY_TYPE)
1032 /* For a VECTOR_TYPE, this is the number of sub-parts of the vector. */
1033 #define TYPE_VECTOR_SUBPARTS(VECTOR_TYPE) (GET_MODE_NUNITS (TYPE_CHECK (VECTOR_TYPE)->type.mode))
1035 /* Indicates that objects of this type must be initialized by calling a
1036 function when they are created. */
1037 #define TYPE_NEEDS_CONSTRUCTING(NODE) \
1038 (TYPE_CHECK (NODE)->type.needs_constructing_flag)
1040 /* Indicates that objects of this type (a UNION_TYPE), should be passed
1041 the same way that the first union alternative would be passed. */
1042 #define TYPE_TRANSPARENT_UNION(NODE) \
1043 (UNION_TYPE_CHECK (NODE)->type.transparent_union_flag)
1045 /* For an ARRAY_TYPE, indicates that it is not permitted to
1046 take the address of a component of the type. */
1047 #define TYPE_NONALIASED_COMPONENT(NODE) \
1048 (ARRAY_TYPE_CHECK (NODE)->type.transparent_union_flag)
1050 /* Indicated that objects of this type should be laid out in as
1051 compact a way as possible. */
1052 #define TYPE_PACKED(NODE) (TYPE_CHECK (NODE)->type.packed_flag)
1054 /* A bounded pointer or bounded reference type (collectively called
1055 indirect types) is represented as a RECORD_TYPE node containing
1056 three pointer fields whose type is the corresponding unbounded
1057 POINTER_TYPE or REFERENCE_TYPE. A RECORD_TYPE node that represents
1058 a bounded indirect type differs from a normal RECORD_TYPE node in
1059 that its TREE_TYPE is non-NULL and has the pointed-to type just as
1060 a POINTER_TYPE or REFERENCE_TYPE node has. The bounded RECORD_TYPE
1061 nodes are stored on the same type variant chain alongside the
1062 variants of the underlaying indirect types nodes. The main variant
1063 of such chains is always the unbounded type. */
1065 /* Access the field decls of a bounded-pointer type. */
1066 #define TYPE_BOUNDED_VALUE(TYPE) TYPE_FIELDS (TYPE)
1067 #define TYPE_BOUNDED_BASE(TYPE) TREE_CHAIN (TYPE_BOUNDED_VALUE (TYPE))
1068 #define TYPE_BOUNDED_EXTENT(TYPE) TREE_CHAIN (TYPE_BOUNDED_BASE (TYPE))
1070 /* Access the simple-pointer subtype of a bounded-pointer type. */
1071 #define TYPE_BOUNDED_SUBTYPE(TYPE) TREE_TYPE (TYPE_BOUNDED_VALUE (TYPE))
1073 /* Find the unbounded counterpart to a type, or return TYPE if it is
1074 already unbounded. */
1075 #define TYPE_UNBOUNDED_VARIANT(TYPE) \
1076 (BOUNDED_POINTER_TYPE_P (TYPE) ? TYPE_BOUNDED_SUBTYPE (TYPE) : (TYPE))
1078 /* This field comprises two bits, for values in the range 0..3:
1080 depth=0 means that type is a scalar, or an aggregate that contains
1081 only depth=0 types, or a function that has only depth=0 types for
1082 its return value and argument types.
1084 depth=1 means that type is a pointer to a depth=0 type, or an
1085 aggregate that contains only depth=0 and depth=1 types, or a
1086 function that has only depth=0 and depth=1 types for its return
1087 value and argument types.
1089 The meanings of depth=2 and depth=3 are obvious by induction.
1090 Varargs functions are depth=3. The type `va_list' is depth=3.
1092 The purpose of measuring pointer depth of a type is to determine
1093 the eligibility of a function for an automatically-generated
1094 bounded-pointer thunk. A depth=0 functions needs no thunk. A
1095 depth=1 function is eligible for an automatic thunk. Functions
1096 with depth 2 or more are too complex to get automatic thunks.
1098 Function decls also have a pointer_depth field, since we also
1099 consider the actual argument types for functions. */
1101 #define TYPE_POINTER_DEPTH(TYPE) (TYPE_CHECK (TYPE)->type.pointer_depth)
1103 /* In a FUNCTION_TYPE node, this bit stores the value of
1104 default_pointer_boundedness at the time TYPE was created. It is
1105 useful for choosing default boundedness of function arguments for
1106 non-prototype function decls and for varargs/stdarg lists. */
1107 #define TYPE_AMBIENT_BOUNDEDNESS(TYPE) \
1108 (FUNCTION_TYPE_CHECK (TYPE)->type.transparent_union_flag)
1110 #define MAX_POINTER_DEPTH 2
1111 #define VA_LIST_POINTER_DEPTH 3
1113 struct tree_type
1115 struct tree_common common;
1116 union tree_node *values;
1117 union tree_node *size;
1118 union tree_node *size_unit;
1119 union tree_node *attributes;
1120 unsigned int uid;
1122 unsigned int precision : 9;
1123 ENUM_BITFIELD(machine_mode) mode : 7;
1125 unsigned string_flag : 1;
1126 unsigned no_force_blk_flag : 1;
1127 unsigned needs_constructing_flag : 1;
1128 unsigned transparent_union_flag : 1;
1129 unsigned packed_flag : 1;
1130 unsigned restrict_flag : 1;
1131 unsigned pointer_depth : 2;
1133 unsigned lang_flag_0 : 1;
1134 unsigned lang_flag_1 : 1;
1135 unsigned lang_flag_2 : 1;
1136 unsigned lang_flag_3 : 1;
1137 unsigned lang_flag_4 : 1;
1138 unsigned lang_flag_5 : 1;
1139 unsigned lang_flag_6 : 1;
1140 unsigned user_align : 1;
1142 unsigned int align;
1143 union tree_node *pointer_to;
1144 union tree_node *reference_to;
1145 union {int address; char *pointer; } symtab;
1146 union tree_node *name;
1147 union tree_node *minval;
1148 union tree_node *maxval;
1149 union tree_node *next_variant;
1150 union tree_node *main_variant;
1151 union tree_node *binfo;
1152 union tree_node *noncopied_parts;
1153 union tree_node *context;
1154 HOST_WIDE_INT alias_set;
1155 /* Points to a structure whose details depend on the language in use. */
1156 struct lang_type *lang_specific;
1159 /* Define accessor macros for information about type inheritance
1160 and basetypes.
1162 A "basetype" means a particular usage of a data type for inheritance
1163 in another type. Each such basetype usage has its own "binfo"
1164 object to describe it. The binfo object is a TREE_VEC node.
1166 Inheritance is represented by the binfo nodes allocated for a
1167 given type. For example, given types C and D, such that D is
1168 inherited by C, 3 binfo nodes will be allocated: one for describing
1169 the binfo properties of C, similarly one for D, and one for
1170 describing the binfo properties of D as a base type for C.
1171 Thus, given a pointer to class C, one can get a pointer to the binfo
1172 of D acting as a basetype for C by looking at C's binfo's basetypes. */
1174 /* The actual data type node being inherited in this basetype. */
1175 #define BINFO_TYPE(NODE) TREE_TYPE (NODE)
1177 /* The offset where this basetype appears in its containing type.
1178 BINFO_OFFSET slot holds the offset (in bytes)
1179 from the base of the complete object to the base of the part of the
1180 object that is allocated on behalf of this `type'.
1181 This is always 0 except when there is multiple inheritance. */
1183 #define BINFO_OFFSET(NODE) TREE_VEC_ELT ((NODE), 1)
1184 #define TYPE_BINFO_OFFSET(NODE) BINFO_OFFSET (TYPE_BINFO (NODE))
1185 #define BINFO_OFFSET_ZEROP(NODE) (integer_zerop (BINFO_OFFSET (NODE)))
1187 /* The virtual function table belonging to this basetype. Virtual
1188 function tables provide a mechanism for run-time method dispatching.
1189 The entries of a virtual function table are language-dependent. */
1191 #define BINFO_VTABLE(NODE) TREE_VEC_ELT ((NODE), 2)
1192 #define TYPE_BINFO_VTABLE(NODE) BINFO_VTABLE (TYPE_BINFO (NODE))
1194 /* The virtual functions in the virtual function table. This is
1195 a TREE_LIST that is used as an initial approximation for building
1196 a virtual function table for this basetype. */
1197 #define BINFO_VIRTUALS(NODE) TREE_VEC_ELT ((NODE), 3)
1198 #define TYPE_BINFO_VIRTUALS(NODE) BINFO_VIRTUALS (TYPE_BINFO (NODE))
1200 /* A vector of binfos for the direct basetypes inherited by this
1201 basetype.
1203 If this basetype describes type D as inherited in C, and if the
1204 basetypes of D are E and F, then this vector contains binfos for
1205 inheritance of E and F by C.
1207 ??? This could probably be done by just allocating the
1208 base types at the end of this TREE_VEC (instead of using
1209 another TREE_VEC). This would simplify the calculation
1210 of how many basetypes a given type had. */
1211 #define BINFO_BASETYPES(NODE) TREE_VEC_ELT ((NODE), 4)
1212 #define TYPE_BINFO_BASETYPES(NODE) TREE_VEC_ELT (TYPE_BINFO (NODE), 4)
1214 /* The number of basetypes for NODE. */
1215 #define BINFO_N_BASETYPES(NODE) \
1216 (BINFO_BASETYPES (NODE) ? TREE_VEC_LENGTH (BINFO_BASETYPES (NODE)) : 0)
1218 /* Accessor macro to get to the Nth basetype of this basetype. */
1219 #define BINFO_BASETYPE(NODE,N) TREE_VEC_ELT (BINFO_BASETYPES (NODE), (N))
1220 #define TYPE_BINFO_BASETYPE(NODE,N) BINFO_TYPE (TREE_VEC_ELT (BINFO_BASETYPES (TYPE_BINFO (NODE)), (N)))
1222 /* For a BINFO record describing a virtual base class, i.e., one where
1223 TREE_VIA_VIRTUAL is set, this field assists in locating the virtual
1224 base. The actual contents are language-dependent. Under the old
1225 ABI, the C++ front-end uses a FIELD_DECL whose contents are a
1226 pointer to the virtual base; under the new ABI this field is
1227 instead a INTEGER_CST giving an offset into the vtable where the
1228 offset to the virtual base can be found. */
1229 #define BINFO_VPTR_FIELD(NODE) TREE_VEC_ELT ((NODE), 5)
1231 /* The size of a base class subobject of this type. Not all frontends
1232 currently allocate the space for these fields. */
1233 #define BINFO_SIZE(NODE) TREE_VEC_ELT ((NODE), 6)
1234 #define BINFO_SIZE_UNIT(NODE) TREE_VEC_ELT ((NODE), 7)
1235 #define TYPE_BINFO_SIZE(NODE) BINFO_SIZE (TYPE_BINFO (NODE))
1236 #define TYPE_BINFO_SIZE_UNIT(NODE) BINFO_SIZE_UNIT (TYPE_BINFO (NODE))
1238 /* Slot used to build a chain that represents a use of inheritance.
1239 For example, if X is derived from Y, and Y is derived from Z,
1240 then this field can be used to link the binfo node for X to
1241 the binfo node for X's Y to represent the use of inheritance
1242 from X to Y. Similarly, this slot of the binfo node for X's Y
1243 can point to the Z from which Y is inherited (in X's inheritance
1244 hierarchy). In this fashion, one can represent and traverse specific
1245 uses of inheritance using the binfo nodes themselves (instead of
1246 consing new space pointing to binfo nodes).
1247 It is up to the language-dependent front-ends to maintain
1248 this information as necessary. */
1249 #define BINFO_INHERITANCE_CHAIN(NODE) TREE_VEC_ELT ((NODE), 0)
1251 /* Define fields and accessors for nodes representing declared names. */
1253 /* Nonzero if DECL represents a decl. */
1254 #define DECL_P(DECL) (TREE_CODE_CLASS (TREE_CODE (DECL)) == 'd')
1255 /* This is the name of the object as written by the user.
1256 It is an IDENTIFIER_NODE. */
1257 #define DECL_NAME(NODE) (DECL_CHECK (NODE)->decl.name)
1258 /* The name of the object as the assembler will see it (but before any
1259 translations made by ASM_OUTPUT_LABELREF). Often this is the same
1260 as DECL_NAME. It is an IDENTIFIER_NODE. */
1261 #define DECL_ASSEMBLER_NAME(NODE) \
1262 ((DECL_ASSEMBLER_NAME_SET_P (NODE) \
1263 ? (void) 0 \
1264 : (*lang_set_decl_assembler_name) (NODE)), \
1265 DECL_CHECK (NODE)->decl.assembler_name)
1266 /* Returns non-zero if the DECL_ASSEMBLER_NAME for NODE has been
1267 set. If zero, the NODE might still have a DECL_ASSEMBLER_NAME --
1268 it just hasn't been set yet. */
1269 #define DECL_ASSEMBLER_NAME_SET_P(NODE) \
1270 (DECL_CHECK (NODE)->decl.assembler_name != NULL_TREE)
1271 /* Set the DECL_ASSEMBLER_NAME for NODE to NAME. */
1272 #define SET_DECL_ASSEMBLER_NAME(NODE, NAME) \
1273 (DECL_CHECK (NODE)->decl.assembler_name = (NAME))
1274 /* Copy the DECL_ASSEMBLER_NAME from DECL1 to DECL2. Note that if
1275 DECL1's DECL_ASSEMBLER_NAME has not yet been set, using this macro
1276 will not cause the DECL_ASSEMBLER_NAME of either DECL to be set.
1277 In other words, the semantics of using this macro, are different
1278 than saying:
1280 SET_DECL_ASSEMBLER_NAME(DECL2, DECL_ASSEMBLER_NAME (DECL1))
1282 which will try to set the DECL_ASSEMBLER_NAME for DECL1. */
1283 #define COPY_DECL_ASSEMBLER_NAME(DECL1, DECL2) \
1284 (DECL_ASSEMBLER_NAME_SET_P (DECL1) \
1285 ? (void) SET_DECL_ASSEMBLER_NAME (DECL2, \
1286 DECL_ASSEMBLER_NAME (DECL1)) \
1287 : (void) 0)
1289 /* Records the section name in a section attribute. Used to pass
1290 the name from decl_attributes to make_function_rtl and make_decl_rtl. */
1291 #define DECL_SECTION_NAME(NODE) (DECL_CHECK (NODE)->decl.section_name)
1292 /* For FIELD_DECLs, this is the
1293 RECORD_TYPE, UNION_TYPE, or QUAL_UNION_TYPE node that the field is
1294 a member of. For VAR_DECL, PARM_DECL, FUNCTION_DECL, LABEL_DECL,
1295 and CONST_DECL nodes, this points to either the FUNCTION_DECL for the
1296 containing function, the RECORD_TYPE or UNION_TYPE for the containing
1297 type, or NULL_TREE if the given decl has "file scope". */
1298 #define DECL_CONTEXT(NODE) (DECL_CHECK (NODE)->decl.context)
1299 #define DECL_FIELD_CONTEXT(NODE) (FIELD_DECL_CHECK (NODE)->decl.context)
1300 /* In a DECL this is the field where configuration dependent machine
1301 attributes are store */
1302 #define DECL_MACHINE_ATTRIBUTES(NODE) (DECL_CHECK (NODE)->decl.machine_attributes)
1303 /* In a FIELD_DECL, this is the field position, counting in bytes, of the
1304 byte containing the bit closest to the beginning of the structure. */
1305 #define DECL_FIELD_OFFSET(NODE) (FIELD_DECL_CHECK (NODE)->decl.arguments)
1306 /* In a FIELD_DECL, this is the offset, in bits, of the first bit of the
1307 field from DECL_FIELD_OFFSET. */
1308 #define DECL_FIELD_BIT_OFFSET(NODE) (FIELD_DECL_CHECK (NODE)->decl.u2.t)
1309 /* In a FIELD_DECL, this indicates whether the field was a bit-field and
1310 if so, the type that was originally specified for it.
1311 TREE_TYPE may have been modified (in finish_struct). */
1312 #define DECL_BIT_FIELD_TYPE(NODE) (FIELD_DECL_CHECK (NODE)->decl.result)
1313 /* In FUNCTION_DECL, a chain of ..._DECL nodes. */
1314 /* VAR_DECL and PARM_DECL reserve the arguments slot
1315 for language-specific uses. */
1316 #define DECL_ARGUMENTS(NODE) (DECL_CHECK (NODE)->decl.arguments)
1317 /* This field is used to reference anything in decl.result and is meant only
1318 for use by the garbage collector. */
1319 #define DECL_RESULT_FLD(NODE) (DECL_CHECK (NODE)->decl.result)
1320 /* In FUNCTION_DECL, holds the decl for the return value. */
1321 #define DECL_RESULT(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.result)
1322 /* For a TYPE_DECL, holds the "original" type. (TREE_TYPE has the copy.) */
1323 #define DECL_ORIGINAL_TYPE(NODE) (TYPE_DECL_CHECK (NODE)->decl.result)
1324 /* In PARM_DECL, holds the type as written (perhaps a function or array). */
1325 #define DECL_ARG_TYPE_AS_WRITTEN(NODE) (PARM_DECL_CHECK (NODE)->decl.result)
1326 /* For a FUNCTION_DECL, holds the tree of BINDINGs.
1327 For a VAR_DECL, holds the initial value.
1328 For a PARM_DECL, not used--default
1329 values for parameters are encoded in the type of the function,
1330 not in the PARM_DECL slot. */
1331 #define DECL_INITIAL(NODE) (DECL_CHECK (NODE)->decl.initial)
1332 /* For a PARM_DECL, records the data type used to pass the argument,
1333 which may be different from the type seen in the program. */
1334 #define DECL_ARG_TYPE(NODE) (PARM_DECL_CHECK (NODE)->decl.initial)
1335 /* For a FIELD_DECL in a QUAL_UNION_TYPE, records the expression, which
1336 if nonzero, indicates that the field occupies the type. */
1337 #define DECL_QUALIFIER(NODE) (FIELD_DECL_CHECK (NODE)->decl.initial)
1338 /* These two fields describe where in the source code the declaration
1339 was. If the declaration appears in several places (as for a C
1340 function that is declared first and then defined later), this
1341 information should refer to the definition. */
1342 #define DECL_SOURCE_FILE(NODE) (DECL_CHECK (NODE)->decl.filename)
1343 #define DECL_SOURCE_LINE(NODE) (DECL_CHECK (NODE)->decl.linenum)
1344 /* Holds the size of the datum, in bits, as a tree expression.
1345 Need not be constant. */
1346 #define DECL_SIZE(NODE) (DECL_CHECK (NODE)->decl.size)
1347 /* Likewise for the size in bytes. */
1348 #define DECL_SIZE_UNIT(NODE) (DECL_CHECK (NODE)->decl.size_unit)
1349 /* Holds the alignment required for the datum, in bits. */
1350 #define DECL_ALIGN(NODE) (DECL_CHECK (NODE)->decl.u1.a.align)
1351 /* The alignment of NODE, in bytes. */
1352 #define DECL_ALIGN_UNIT(NODE) (DECL_ALIGN (NODE) / BITS_PER_UNIT)
1353 /* For FIELD_DECLs, off_align holds the number of low-order bits of
1354 DECL_FIELD_OFFSET which are known to be always zero.
1355 DECL_OFFSET_ALIGN thus returns the alignment that DECL_FIELD_OFFSET
1356 has. */
1357 #define DECL_OFFSET_ALIGN(NODE) \
1358 (((unsigned HOST_WIDE_INT)1) << FIELD_DECL_CHECK (NODE)->decl.u1.a.off_align)
1359 /* Specify that DECL_ALIGN(NODE) is a multiple of X. */
1360 #define SET_DECL_OFFSET_ALIGN(NODE, X) \
1361 (FIELD_DECL_CHECK (NODE)->decl.u1.a.off_align = exact_log2 ((X) & -(X)))
1362 /* 1 if the alignment for this type was requested by "aligned" attribute,
1363 0 if it is the default for this type. */
1364 #define DECL_USER_ALIGN(NODE) (DECL_CHECK (NODE)->decl.user_align)
1365 /* Holds the machine mode corresponding to the declaration of a variable or
1366 field. Always equal to TYPE_MODE (TREE_TYPE (decl)) except for a
1367 FIELD_DECL. */
1368 #define DECL_MODE(NODE) (DECL_CHECK (NODE)->decl.mode)
1369 /* Holds the RTL expression for the value of a variable or function. If
1370 PROMOTED_MODE is defined, the mode of this expression may not be same
1371 as DECL_MODE. In that case, DECL_MODE contains the mode corresponding
1372 to the variable's data type, while the mode
1373 of DECL_RTL is the mode actually used to contain the data.
1375 This value can be evaluated lazily for functions, variables with
1376 static storage duration, and labels. */
1377 #define DECL_RTL(NODE) \
1378 (DECL_CHECK (NODE)->decl.rtl \
1379 ? (NODE)->decl.rtl \
1380 : (make_decl_rtl (NODE, NULL), (NODE)->decl.rtl))
1381 /* Set the DECL_RTL for NODE to RTL. */
1382 #define SET_DECL_RTL(NODE, RTL) \
1383 (DECL_CHECK (NODE)->decl.rtl = (RTL))
1384 /* Returns non-zero if the DECL_RTL for NODE has already been set. */
1385 #define DECL_RTL_SET_P(NODE) \
1386 (DECL_CHECK (NODE)->decl.rtl != NULL)
1387 /* Copy the RTL from NODE1 to NODE2. If the RTL was not set for
1388 NODE1, it will not be set for NODE2; this is a lazy copy. */
1389 #define COPY_DECL_RTL(NODE1, NODE2) \
1390 (DECL_CHECK (NODE2)->decl.rtl = DECL_CHECK (NODE1)->decl.rtl)
1391 /* The DECL_RTL for NODE, if it is set, or NULL, if it is not set. */
1392 #define DECL_RTL_IF_SET(NODE) \
1393 (DECL_RTL_SET_P (NODE) ? DECL_RTL (NODE) : NULL)
1394 /* Holds an INSN_LIST of all of the live ranges in which the variable
1395 has been moved to a possibly different register. */
1396 #define DECL_LIVE_RANGE_RTL(NODE) (DECL_CHECK (NODE)->decl.live_range_rtl)
1397 /* For PARM_DECL, holds an RTL for the stack slot or register
1398 where the data was actually passed. */
1399 #define DECL_INCOMING_RTL(NODE) (PARM_DECL_CHECK (NODE)->decl.u2.r)
1400 /* For FUNCTION_DECL, if it is inline, holds the saved insn chain. */
1401 #define DECL_SAVED_INSNS(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.u2.f)
1402 /* For FUNCTION_DECL, if it is built-in,
1403 this identifies which built-in operation it is. */
1404 #define DECL_FUNCTION_CODE(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.u1.f)
1406 /* The DECL_VINDEX is used for FUNCTION_DECLS in two different ways.
1407 Before the struct containing the FUNCTION_DECL is laid out,
1408 DECL_VINDEX may point to a FUNCTION_DECL in a base class which
1409 is the FUNCTION_DECL which this FUNCTION_DECL will replace as a virtual
1410 function. When the class is laid out, this pointer is changed
1411 to an INTEGER_CST node which is suitable for use as an index
1412 into the virtual function table. */
1413 #define DECL_VINDEX(NODE) (DECL_CHECK (NODE)->decl.vindex)
1414 /* For FIELD_DECLS, DECL_FCONTEXT is the *first* baseclass in
1415 which this FIELD_DECL is defined. This information is needed when
1416 writing debugging information about vfield and vbase decls for C++. */
1417 #define DECL_FCONTEXT(NODE) (FIELD_DECL_CHECK (NODE)->decl.vindex)
1419 /* Every ..._DECL node gets a unique number. */
1420 #define DECL_UID(NODE) (DECL_CHECK (NODE)->decl.uid)
1422 /* For any sort of a ..._DECL node, this points to the original (abstract)
1423 decl node which this decl is an instance of, or else it is NULL indicating
1424 that this decl is not an instance of some other decl. For example,
1425 in a nested declaration of an inline function, this points back to the
1426 definition. */
1427 #define DECL_ABSTRACT_ORIGIN(NODE) (DECL_CHECK (NODE)->decl.abstract_origin)
1429 /* Like DECL_ABSTRACT_ORIGIN, but returns NODE if there's no abstract
1430 origin. This is useful when setting the DECL_ABSTRACT_ORIGIN. */
1431 #define DECL_ORIGIN(NODE) \
1432 (DECL_ABSTRACT_ORIGIN (NODE) ? DECL_ABSTRACT_ORIGIN (NODE) : NODE)
1434 /* Nonzero for any sort of ..._DECL node means this decl node represents an
1435 inline instance of some original (abstract) decl from an inline function;
1436 suppress any warnings about shadowing some other variable. FUNCTION_DECL
1437 nodes can also have their abstract origin set to themselves. */
1438 #define DECL_FROM_INLINE(NODE) (DECL_ABSTRACT_ORIGIN (NODE) != (tree) 0 \
1439 && DECL_ABSTRACT_ORIGIN (NODE) != (NODE))
1441 /* Nonzero if a _DECL means that the name of this decl should be ignored
1442 for symbolic debug purposes. */
1443 #define DECL_IGNORED_P(NODE) (DECL_CHECK (NODE)->decl.ignored_flag)
1445 /* Nonzero for a given ..._DECL node means that this node represents an
1446 "abstract instance" of the given declaration (e.g. in the original
1447 declaration of an inline function). When generating symbolic debugging
1448 information, we mustn't try to generate any address information for nodes
1449 marked as "abstract instances" because we don't actually generate
1450 any code or allocate any data space for such instances. */
1451 #define DECL_ABSTRACT(NODE) (DECL_CHECK (NODE)->decl.abstract_flag)
1453 /* Nonzero if a _DECL means that no warnings should be generated just
1454 because this decl is unused. */
1455 #define DECL_IN_SYSTEM_HEADER(NODE) (DECL_CHECK (NODE)->decl.in_system_header_flag)
1457 /* Nonzero for a given ..._DECL node means that this node should be
1458 put in .common, if possible. If a DECL_INITIAL is given, and it
1459 is not error_mark_node, then the decl cannot be put in .common. */
1460 #define DECL_COMMON(NODE) (DECL_CHECK (NODE)->decl.common_flag)
1462 /* Language-specific decl information. */
1463 #define DECL_LANG_SPECIFIC(NODE) (DECL_CHECK (NODE)->decl.lang_specific)
1465 /* In a VAR_DECL or FUNCTION_DECL,
1466 nonzero means external reference:
1467 do not allocate storage, and refer to a definition elsewhere. */
1468 #define DECL_EXTERNAL(NODE) (DECL_CHECK (NODE)->decl.external_flag)
1470 /* In a VAR_DECL for a RECORD_TYPE, sets number for non-init_priority
1471 initializatons. */
1472 #define DEFAULT_INIT_PRIORITY 65535
1473 #define MAX_INIT_PRIORITY 65535
1474 #define MAX_RESERVED_INIT_PRIORITY 100
1476 /* In a TYPE_DECL
1477 nonzero means the detail info about this type is not dumped into stabs.
1478 Instead it will generate cross reference ('x') of names.
1479 This uses the same flag as DECL_EXTERNAL. */
1480 #define TYPE_DECL_SUPPRESS_DEBUG(NODE) \
1481 (TYPE_DECL_CHECK (NODE)->decl.external_flag)
1483 /* In VAR_DECL and PARM_DECL nodes, nonzero means declared `register'. */
1484 #define DECL_REGISTER(NODE) (DECL_CHECK (NODE)->decl.regdecl_flag)
1485 /* In LABEL_DECL nodes, nonzero means that an error message about
1486 jumping into such a binding contour has been printed for this label. */
1487 #define DECL_ERROR_ISSUED(NODE) (LABEL_DECL_CHECK (NODE)->decl.regdecl_flag)
1488 /* In a FIELD_DECL, indicates this field should be bit-packed. */
1489 #define DECL_PACKED(NODE) (FIELD_DECL_CHECK (NODE)->decl.regdecl_flag)
1490 /* In a FUNCTION_DECL with a non-zero DECL_CONTEXT, indicates that a
1491 static chain is not needed. */
1492 #define DECL_NO_STATIC_CHAIN(NODE) \
1493 (FUNCTION_DECL_CHECK (NODE)->decl.regdecl_flag)
1495 /* Nonzero in a ..._DECL means this variable is ref'd from a nested function.
1496 For VAR_DECL nodes, PARM_DECL nodes, and FUNCTION_DECL nodes.
1498 For LABEL_DECL nodes, nonzero if nonlocal gotos to the label are permitted.
1500 Also set in some languages for variables, etc., outside the normal
1501 lexical scope, such as class instance variables. */
1502 #define DECL_NONLOCAL(NODE) (DECL_CHECK (NODE)->decl.nonlocal_flag)
1504 /* Nonzero in a FUNCTION_DECL means this function can be substituted
1505 where it is called. */
1506 #define DECL_INLINE(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.inline_flag)
1508 /* In a FUNCTION_DECL, nonzero if the function cannot be inlined. */
1509 #define DECL_UNINLINABLE(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.uninlinable)
1511 /* Nonzero in a FUNCTION_DECL means this is a built-in function
1512 that is not specified by ansi C and that users are supposed to be allowed
1513 to redefine for any purpose whatever. */
1514 #define DECL_BUILT_IN_NONANSI(NODE) \
1515 (FUNCTION_DECL_CHECK (NODE)->common.unsigned_flag)
1517 /* Nonzero in a FUNCTION_DECL means this function should be treated
1518 as if it were a malloc, meaning it returns a pointer that is
1519 not an alias. */
1520 #define DECL_IS_MALLOC(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.malloc_flag)
1522 /* Nonzero in a FUNCTION_DECL means this function should be treated
1523 as "pure" function (like const function, but may read global memory). */
1524 #define DECL_IS_PURE(NODE) (FUNCTION_DECL_CHECK (NODE)->decl.pure_flag)
1526 /* Nonzero in a FIELD_DECL means it is a bit field, and must be accessed
1527 specially. */
1528 #define DECL_BIT_FIELD(NODE) (FIELD_DECL_CHECK (NODE)->decl.bit_field_flag)
1529 /* In a LABEL_DECL, nonzero means label was defined inside a binding
1530 contour that restored a stack level and which is now exited. */
1531 #define DECL_TOO_LATE(NODE) (LABEL_DECL_CHECK (NODE)->decl.bit_field_flag)
1533 /* Unused in FUNCTION_DECL. */
1535 /* In a VAR_DECL that's static,
1536 nonzero if the space is in the text section. */
1537 #define DECL_IN_TEXT_SECTION(NODE) (VAR_DECL_CHECK (NODE)->decl.bit_field_flag)
1539 /* In a FUNCTION_DECL, nonzero means a built in function. */
1540 #define DECL_BUILT_IN(NODE) (DECL_BUILT_IN_CLASS (NODE) != NOT_BUILT_IN)
1541 /* For a builtin function, identify which part of the compiler defined it. */
1542 #define DECL_BUILT_IN_CLASS(NODE) \
1543 (FUNCTION_DECL_CHECK (NODE)->decl.built_in_class)
1545 /* Used in VAR_DECLs to indicate that the variable is a vtable.
1546 Used in FIELD_DECLs for vtable pointers.
1547 Used in FUNCTION_DECLs to indicate that the function is virtual. */
1548 #define DECL_VIRTUAL_P(NODE) (DECL_CHECK (NODE)->decl.virtual_flag)
1550 /* Used to indicate that the linkage status of this DECL is not yet known,
1551 so it should not be output now. */
1552 #define DECL_DEFER_OUTPUT(NODE) (DECL_CHECK (NODE)->decl.defer_output)
1554 /* Used in PARM_DECLs whose type are unions to indicate that the
1555 argument should be passed in the same way that the first union
1556 alternative would be passed. */
1557 #define DECL_TRANSPARENT_UNION(NODE) \
1558 (PARM_DECL_CHECK (NODE)->decl.transparent_union)
1560 /* Used in FUNCTION_DECLs to indicate that they should be run automatically
1561 at the beginning or end of execution. */
1562 #define DECL_STATIC_CONSTRUCTOR(NODE) \
1563 (FUNCTION_DECL_CHECK (NODE)->decl.static_ctor_flag)
1565 #define DECL_STATIC_DESTRUCTOR(NODE) \
1566 (FUNCTION_DECL_CHECK (NODE)->decl.static_dtor_flag)
1568 /* Used to indicate that this DECL represents a compiler-generated entity. */
1569 #define DECL_ARTIFICIAL(NODE) (DECL_CHECK (NODE)->decl.artificial_flag)
1571 /* Used to indicate that this DECL has weak linkage. */
1572 #define DECL_WEAK(NODE) (DECL_CHECK (NODE)->decl.weak_flag)
1574 /* Used in TREE_PUBLIC decls to indicate that copies of this DECL in
1575 multiple translation units should be merged. */
1576 #define DECL_ONE_ONLY(NODE) (DECL_CHECK (NODE)->decl.transparent_union)
1578 /* Used in a DECL to indicate that, even if it TREE_PUBLIC, it need
1579 not be put out unless it is needed in this translation unit.
1580 Entities like this are shared across translation units (like weak
1581 entities), but are guaranteed to be generated by any translation
1582 unit that needs them, and therefore need not be put out anywhere
1583 where they are not needed. DECL_COMDAT is just a hint to the
1584 back-end; it is up to front-ends which set this flag to ensure
1585 that there will never be any harm, other than bloat, in putting out
1586 something which is DECL_COMDAT. */
1587 #define DECL_COMDAT(NODE) (DECL_CHECK (NODE)->decl.comdat_flag)
1589 /* Used in FUNCTION_DECLs to indicate that function entry and exit should
1590 be instrumented with calls to support routines. */
1591 #define DECL_NO_INSTRUMENT_FUNCTION_ENTRY_EXIT(NODE) \
1592 (FUNCTION_DECL_CHECK (NODE)->decl.no_instrument_function_entry_exit)
1594 /* Used in FUNCTION_DECLs to indicate that check-memory-usage should be
1595 disabled in this function. */
1596 #define DECL_NO_CHECK_MEMORY_USAGE(NODE) \
1597 (FUNCTION_DECL_CHECK (NODE)->decl.no_check_memory_usage)
1599 /* Used in FUNCTION_DECLs to indicate that limit-stack-* should be
1600 disabled in this function. */
1601 #define DECL_NO_LIMIT_STACK(NODE) \
1602 (FUNCTION_DECL_CHECK (NODE)->decl.no_limit_stack)
1604 /* Additional flags for language-specific uses. */
1605 #define DECL_LANG_FLAG_0(NODE) (DECL_CHECK (NODE)->decl.lang_flag_0)
1606 #define DECL_LANG_FLAG_1(NODE) (DECL_CHECK (NODE)->decl.lang_flag_1)
1607 #define DECL_LANG_FLAG_2(NODE) (DECL_CHECK (NODE)->decl.lang_flag_2)
1608 #define DECL_LANG_FLAG_3(NODE) (DECL_CHECK (NODE)->decl.lang_flag_3)
1609 #define DECL_LANG_FLAG_4(NODE) (DECL_CHECK (NODE)->decl.lang_flag_4)
1610 #define DECL_LANG_FLAG_5(NODE) (DECL_CHECK (NODE)->decl.lang_flag_5)
1611 #define DECL_LANG_FLAG_6(NODE) (DECL_CHECK (NODE)->decl.lang_flag_6)
1612 #define DECL_LANG_FLAG_7(NODE) (DECL_CHECK (NODE)->decl.lang_flag_7)
1614 /* Used to indicate that the pointer to this DECL cannot be treated as
1615 an address constant. */
1616 #define DECL_NON_ADDR_CONST_P(NODE) (DECL_CHECK (NODE)->decl.non_addr_const_p)
1618 /* Used in a FIELD_DECL to indicate that we cannot form the address of
1619 this component. */
1620 #define DECL_NONADDRESSABLE_P(NODE) \
1621 (FIELD_DECL_CHECK (NODE)->decl.non_addressable)
1623 /* Used to indicate an alias set for the memory pointed to by this
1624 particular FIELD_DECL, PARM_DECL, or VAR_DECL, which must have
1625 pointer (or reference) type. */
1626 #define DECL_POINTER_ALIAS_SET(NODE) \
1627 (DECL_CHECK (NODE)->decl.pointer_alias_set)
1629 /* Nonzero if an alias set has been assigned to this declaration. */
1630 #define DECL_POINTER_ALIAS_SET_KNOWN_P(NODE) \
1631 (DECL_POINTER_ALIAS_SET (NODE) != - 1)
1633 /* The pointer_depth field comprises two bits for values in the range
1634 0..3. The value is normally equal to TYPE_POINTER_DEPTH of decl's
1635 type node, but for functions it migth be greater. For example,
1636 this can happen when the function is declared to accept a parameter
1637 of type void* (depth=1), but is actually called with an argument of
1638 type foo** (depth=2). The function type will get the formal
1639 parameter's depth, but the function decl will get the actual
1640 argument's depth. */
1641 #define DECL_POINTER_DEPTH(DECL) (DECL_CHECK (DECL)->decl.pointer_depth)
1643 struct tree_decl
1645 struct tree_common common;
1646 const char *filename;
1647 int linenum;
1648 unsigned int uid;
1649 union tree_node *size;
1650 ENUM_BITFIELD(machine_mode) mode : 8;
1652 unsigned external_flag : 1;
1653 unsigned nonlocal_flag : 1;
1654 unsigned regdecl_flag : 1;
1655 unsigned inline_flag : 1;
1656 unsigned bit_field_flag : 1;
1657 unsigned virtual_flag : 1;
1658 unsigned ignored_flag : 1;
1659 unsigned abstract_flag : 1;
1661 unsigned in_system_header_flag : 1;
1662 unsigned common_flag : 1;
1663 unsigned defer_output : 1;
1664 unsigned transparent_union : 1;
1665 unsigned static_ctor_flag : 1;
1666 unsigned static_dtor_flag : 1;
1667 unsigned artificial_flag : 1;
1668 unsigned weak_flag : 1;
1670 unsigned non_addr_const_p : 1;
1671 unsigned no_instrument_function_entry_exit : 1;
1672 unsigned no_check_memory_usage : 1;
1673 unsigned comdat_flag : 1;
1674 unsigned malloc_flag : 1;
1675 unsigned no_limit_stack : 1;
1676 ENUM_BITFIELD(built_in_class) built_in_class : 2;
1678 unsigned pure_flag : 1;
1679 unsigned pointer_depth : 2;
1680 unsigned non_addressable : 1;
1681 unsigned user_align : 1;
1682 unsigned uninlinable : 1;
1683 /* Two unused bits. */
1685 unsigned lang_flag_0 : 1;
1686 unsigned lang_flag_1 : 1;
1687 unsigned lang_flag_2 : 1;
1688 unsigned lang_flag_3 : 1;
1689 unsigned lang_flag_4 : 1;
1690 unsigned lang_flag_5 : 1;
1691 unsigned lang_flag_6 : 1;
1692 unsigned lang_flag_7 : 1;
1694 union {
1695 /* In a FUNCTION_DECL for which DECL_BUILT_IN holds, this is
1696 DECL_FUNCTION_CODE. */
1697 enum built_in_function f;
1698 /* In a FUNCITON_DECL for which DECL_BUILT_IN does not hold, this
1699 is used by language-dependent code. */
1700 HOST_WIDE_INT i;
1701 /* DECL_ALIGN and DECL_OFFSET_ALIGN. (These are not used for
1702 FUNCTION_DECLs). */
1703 struct {unsigned int align : 24; unsigned int off_align : 8;} a;
1704 } u1;
1706 union tree_node *size_unit;
1707 union tree_node *name;
1708 union tree_node *context;
1709 union tree_node *arguments; /* Also used for DECL_FIELD_OFFSET */
1710 union tree_node *result; /* Also used for DECL_BIT_FIELD_TYPE */
1711 union tree_node *initial; /* Also used for DECL_QUALIFIER */
1712 union tree_node *abstract_origin;
1713 union tree_node *assembler_name;
1714 union tree_node *section_name;
1715 union tree_node *machine_attributes;
1716 struct rtx_def *rtl; /* RTL representation for object. */
1717 struct rtx_def *live_range_rtl;
1719 /* In FUNCTION_DECL, if it is inline, holds the saved insn chain.
1720 In FIELD_DECL, is DECL_FIELD_BIT_OFFSET.
1721 In PARM_DECL, holds an RTL for the stack slot
1722 of register where the data was actually passed.
1723 Used by Chill and Java in LABEL_DECL and by C++ and Java in VAR_DECL. */
1724 union {
1725 struct function *f;
1726 struct rtx_def *r;
1727 union tree_node *t;
1728 int i;
1729 } u2;
1731 union tree_node *vindex;
1732 HOST_WIDE_INT pointer_alias_set;
1733 /* Points to a structure whose details depend on the language in use. */
1734 struct lang_decl *lang_specific;
1737 /* Define the overall contents of a tree node.
1738 It may be any of the structures declared above
1739 for various types of node. */
1741 union tree_node
1743 struct tree_common common;
1744 struct tree_int_cst int_cst;
1745 struct tree_real_cst real_cst;
1746 struct tree_string string;
1747 struct tree_complex complex;
1748 struct tree_identifier identifier;
1749 struct tree_decl decl;
1750 struct tree_type type;
1751 struct tree_list list;
1752 struct tree_vec vec;
1753 struct tree_exp exp;
1754 struct tree_block block;
1757 /* Standard named or nameless data types of the C compiler. */
1759 enum tree_index
1761 TI_ERROR_MARK,
1762 TI_INTQI_TYPE,
1763 TI_INTHI_TYPE,
1764 TI_INTSI_TYPE,
1765 TI_INTDI_TYPE,
1766 TI_INTTI_TYPE,
1768 TI_UINTQI_TYPE,
1769 TI_UINTHI_TYPE,
1770 TI_UINTSI_TYPE,
1771 TI_UINTDI_TYPE,
1772 TI_UINTTI_TYPE,
1774 TI_INTEGER_ZERO,
1775 TI_INTEGER_ONE,
1776 TI_INTEGER_MINUS_ONE,
1777 TI_NULL_POINTER,
1779 TI_SIZE_ZERO,
1780 TI_SIZE_ONE,
1782 TI_BITSIZE_ZERO,
1783 TI_BITSIZE_ONE,
1784 TI_BITSIZE_UNIT,
1786 TI_COMPLEX_INTEGER_TYPE,
1787 TI_COMPLEX_FLOAT_TYPE,
1788 TI_COMPLEX_DOUBLE_TYPE,
1789 TI_COMPLEX_LONG_DOUBLE_TYPE,
1791 TI_FLOAT_TYPE,
1792 TI_DOUBLE_TYPE,
1793 TI_LONG_DOUBLE_TYPE,
1795 TI_VOID_TYPE,
1796 TI_PTR_TYPE,
1797 TI_CONST_PTR_TYPE,
1798 TI_PTRDIFF_TYPE,
1799 TI_VA_LIST_TYPE,
1801 TI_VOID_LIST_NODE,
1803 TI_V4SF_TYPE,
1804 TI_V4SI_TYPE,
1805 TI_V8QI_TYPE,
1806 TI_V4HI_TYPE,
1807 TI_V2SI_TYPE,
1809 TI_MAIN_IDENTIFIER,
1811 TI_MAX
1814 extern tree global_trees[TI_MAX];
1816 #define error_mark_node global_trees[TI_ERROR_MARK]
1818 #define intQI_type_node global_trees[TI_INTQI_TYPE]
1819 #define intHI_type_node global_trees[TI_INTHI_TYPE]
1820 #define intSI_type_node global_trees[TI_INTSI_TYPE]
1821 #define intDI_type_node global_trees[TI_INTDI_TYPE]
1822 #define intTI_type_node global_trees[TI_INTTI_TYPE]
1824 #define unsigned_intQI_type_node global_trees[TI_UINTQI_TYPE]
1825 #define unsigned_intHI_type_node global_trees[TI_UINTHI_TYPE]
1826 #define unsigned_intSI_type_node global_trees[TI_UINTSI_TYPE]
1827 #define unsigned_intDI_type_node global_trees[TI_UINTDI_TYPE]
1828 #define unsigned_intTI_type_node global_trees[TI_UINTTI_TYPE]
1830 #define integer_zero_node global_trees[TI_INTEGER_ZERO]
1831 #define integer_one_node global_trees[TI_INTEGER_ONE]
1832 #define integer_minus_one_node global_trees[TI_INTEGER_MINUS_ONE]
1833 #define size_zero_node global_trees[TI_SIZE_ZERO]
1834 #define size_one_node global_trees[TI_SIZE_ONE]
1835 #define bitsize_zero_node global_trees[TI_BITSIZE_ZERO]
1836 #define bitsize_one_node global_trees[TI_BITSIZE_ONE]
1837 #define bitsize_unit_node global_trees[TI_BITSIZE_UNIT]
1839 #define null_pointer_node global_trees[TI_NULL_POINTER]
1841 #define float_type_node global_trees[TI_FLOAT_TYPE]
1842 #define double_type_node global_trees[TI_DOUBLE_TYPE]
1843 #define long_double_type_node global_trees[TI_LONG_DOUBLE_TYPE]
1845 #define complex_integer_type_node global_trees[TI_COMPLEX_INTEGER_TYPE]
1846 #define complex_float_type_node global_trees[TI_COMPLEX_FLOAT_TYPE]
1847 #define complex_double_type_node global_trees[TI_COMPLEX_DOUBLE_TYPE]
1848 #define complex_long_double_type_node global_trees[TI_COMPLEX_LONG_DOUBLE_TYPE]
1850 #define void_type_node global_trees[TI_VOID_TYPE]
1851 /* The C type `void *'. */
1852 #define ptr_type_node global_trees[TI_PTR_TYPE]
1853 /* The C type `const void *'. */
1854 #define const_ptr_type_node global_trees[TI_CONST_PTR_TYPE]
1855 #define ptrdiff_type_node global_trees[TI_PTRDIFF_TYPE]
1856 #define va_list_type_node global_trees[TI_VA_LIST_TYPE]
1858 /* The node that should be placed at the end of a parameter list to
1859 indicate that the function does not take a variable number of
1860 arguments. The TREE_VALUE will be void_type_node and there will be
1861 no TREE_CHAIN. Language-independent code should not assume
1862 anything else about this node. */
1863 #define void_list_node global_trees[TI_VOID_LIST_NODE]
1865 #define main_identifier_node global_trees[TI_MAIN_IDENTIFIER]
1866 #define MAIN_NAME_P(NODE) (IDENTIFIER_NODE_CHECK (NODE) == main_identifier_node)
1868 #define V4SF_type_node global_trees[TI_V4SF_TYPE]
1869 #define V4SI_type_node global_trees[TI_V4SI_TYPE]
1870 #define V8QI_type_node global_trees[TI_V8QI_TYPE]
1871 #define V4HI_type_node global_trees[TI_V4HI_TYPE]
1872 #define V2SI_type_node global_trees[TI_V2SI_TYPE]
1874 /* An enumeration of the standard C integer types. These must be
1875 ordered so that shorter types appear before longer ones. */
1876 enum integer_type_kind
1878 itk_char,
1879 itk_signed_char,
1880 itk_unsigned_char,
1881 itk_short,
1882 itk_unsigned_short,
1883 itk_int,
1884 itk_unsigned_int,
1885 itk_long,
1886 itk_unsigned_long,
1887 itk_long_long,
1888 itk_unsigned_long_long,
1889 itk_none
1892 typedef enum integer_type_kind integer_type_kind;
1894 /* The standard C integer types. Use integer_type_kind to index into
1895 this array. */
1896 extern tree integer_types[itk_none];
1898 #define char_type_node integer_types[itk_char]
1899 #define signed_char_type_node integer_types[itk_signed_char]
1900 #define unsigned_char_type_node integer_types[itk_unsigned_char]
1901 #define short_integer_type_node integer_types[itk_short]
1902 #define short_unsigned_type_node integer_types[itk_unsigned_short]
1903 #define integer_type_node integer_types[itk_int]
1904 #define unsigned_type_node integer_types[itk_unsigned_int]
1905 #define long_integer_type_node integer_types[itk_long]
1906 #define long_unsigned_type_node integer_types[itk_unsigned_long]
1907 #define long_long_integer_type_node integer_types[itk_long_long]
1908 #define long_long_unsigned_type_node integer_types[itk_unsigned_long_long]
1911 #define NULL_TREE (tree) NULL
1913 /* The following functions accept a wide integer argument. Rather than
1914 having to cast on every function call, we use a macro instead, that is
1915 defined here and in rtl.h. */
1917 #ifndef exact_log2
1918 #define exact_log2(N) exact_log2_wide ((unsigned HOST_WIDE_INT) (N))
1919 #define floor_log2(N) floor_log2_wide ((unsigned HOST_WIDE_INT) (N))
1920 #endif
1921 extern int exact_log2_wide PARAMS ((unsigned HOST_WIDE_INT));
1922 extern int floor_log2_wide PARAMS ((unsigned HOST_WIDE_INT));
1924 /* Approximate positive square root of a host double. This is for
1925 statistical reports, not code generation. */
1926 extern double approx_sqrt PARAMS ((double));
1928 extern char *permalloc PARAMS ((int));
1929 extern char *expralloc PARAMS ((int));
1931 /* Compute the number of bytes occupied by 'node'. This routine only
1932 looks at TREE_CODE and, if the code is TREE_VEC, TREE_VEC_LENGTH. */
1934 extern size_t tree_size PARAMS ((tree));
1936 /* Lowest level primitive for allocating a node.
1937 The TREE_CODE is the only argument. Contents are initialized
1938 to zero except for a few of the common fields. */
1940 extern tree make_node PARAMS ((enum tree_code));
1941 extern tree make_lang_type PARAMS ((enum tree_code));
1942 extern tree (*make_lang_type_fn) PARAMS ((enum tree_code));
1944 /* Make a copy of a node, with all the same contents except
1945 for TREE_PERMANENT. (The copy is permanent
1946 iff nodes being made now are permanent.) */
1948 extern tree copy_node PARAMS ((tree));
1950 /* Make a copy of a chain of TREE_LIST nodes. */
1952 extern tree copy_list PARAMS ((tree));
1954 /* Make a TREE_VEC. */
1956 extern tree make_tree_vec PARAMS ((int));
1958 /* Return the (unique) IDENTIFIER_NODE node for a given name.
1959 The name is supplied as a char *. */
1961 extern tree get_identifier PARAMS ((const char *));
1963 /* If an identifier with the name TEXT (a null-terminated string) has
1964 previously been referred to, return that node; otherwise return
1965 NULL_TREE. */
1967 extern tree maybe_get_identifier PARAMS ((const char *));
1969 /* Look up an identifier with the name TEXT, replace its identifier
1970 node with NODE, and return the old identifier node. This is used
1971 by languages which need to enable and disable keywords based on
1972 context; e.g. see remember_protocol_qualifiers in objc/objc-act.c. */
1974 extern tree set_identifier PARAMS ((const char *, tree));
1976 /* Construct various types of nodes. */
1978 #define build_int_2(LO,HI) \
1979 build_int_2_wide ((unsigned HOST_WIDE_INT) (LO), (HOST_WIDE_INT) (HI))
1981 extern tree build PARAMS ((enum tree_code, tree, ...));
1982 extern tree build_nt PARAMS ((enum tree_code, ...));
1984 extern tree build_int_2_wide PARAMS ((unsigned HOST_WIDE_INT, HOST_WIDE_INT));
1985 extern tree build_real PARAMS ((tree, REAL_VALUE_TYPE));
1986 extern tree build_real_from_int_cst PARAMS ((tree, tree));
1987 extern tree build_complex PARAMS ((tree, tree, tree));
1988 extern tree build_string PARAMS ((int, const char *));
1989 extern tree build1 PARAMS ((enum tree_code, tree, tree));
1990 extern tree build_tree_list PARAMS ((tree, tree));
1991 extern tree build_decl PARAMS ((enum tree_code, tree, tree));
1992 extern tree build_block PARAMS ((tree, tree, tree, tree, tree));
1993 extern tree build_expr_wfl PARAMS ((tree, const char *, int, int));
1995 /* Construct various nodes representing data types. */
1997 extern tree make_signed_type PARAMS ((int));
1998 extern tree make_unsigned_type PARAMS ((int));
1999 extern void initialize_sizetypes PARAMS ((void));
2000 extern void set_sizetype PARAMS ((tree));
2001 extern tree signed_or_unsigned_type PARAMS ((int, tree));
2002 extern void fixup_unsigned_type PARAMS ((tree));
2003 extern tree build_pointer_type PARAMS ((tree));
2004 extern tree build_reference_type PARAMS ((tree));
2005 extern tree build_type_no_quals PARAMS ((tree));
2006 extern tree build_index_type PARAMS ((tree));
2007 extern tree build_index_2_type PARAMS ((tree, tree));
2008 extern tree build_array_type PARAMS ((tree, tree));
2009 extern tree build_function_type PARAMS ((tree, tree));
2010 extern tree build_method_type PARAMS ((tree, tree));
2011 extern tree build_offset_type PARAMS ((tree, tree));
2012 extern tree build_complex_type PARAMS ((tree));
2013 extern tree array_type_nelts PARAMS ((tree));
2015 extern tree value_member PARAMS ((tree, tree));
2016 extern tree purpose_member PARAMS ((tree, tree));
2017 extern tree binfo_member PARAMS ((tree, tree));
2018 extern unsigned int attribute_hash_list PARAMS ((tree));
2019 extern int attribute_list_equal PARAMS ((tree, tree));
2020 extern int attribute_list_contained PARAMS ((tree, tree));
2021 extern int tree_int_cst_equal PARAMS ((tree, tree));
2022 extern int tree_int_cst_lt PARAMS ((tree, tree));
2023 extern int tree_int_cst_compare PARAMS ((tree, tree));
2024 extern int host_integerp PARAMS ((tree, int));
2025 extern HOST_WIDE_INT tree_low_cst PARAMS ((tree, int));
2026 extern int tree_int_cst_msb PARAMS ((tree));
2027 extern int tree_int_cst_sgn PARAMS ((tree));
2028 extern int tree_expr_nonnegative_p PARAMS ((tree));
2029 extern int rtl_expr_nonnegative_p PARAMS ((struct rtx_def *));
2030 extern int index_type_equal PARAMS ((tree, tree));
2031 extern tree get_inner_array_type PARAMS ((tree));
2033 /* From expmed.c. Since rtl.h is included after tree.h, we can't
2034 put the prototype here. Rtl.h does declare the prototype if
2035 tree.h had been included. */
2037 extern tree make_tree PARAMS ((tree, struct rtx_def *));
2039 /* Return a type like TTYPE except that its TYPE_ATTRIBUTES
2040 is ATTRIBUTE.
2042 Such modified types already made are recorded so that duplicates
2043 are not made. */
2045 extern tree build_type_attribute_variant PARAMS ((tree, tree));
2046 extern tree build_decl_attribute_variant PARAMS ((tree, tree));
2048 extern tree merge_machine_decl_attributes PARAMS ((tree, tree));
2049 extern tree merge_machine_type_attributes PARAMS ((tree, tree));
2051 /* Split a list of declspecs and attributes into two. */
2053 extern void split_specs_attrs PARAMS ((tree, tree *, tree *));
2055 /* Strip attributes from a list of combined specs and attrs. */
2057 extern tree strip_attrs PARAMS ((tree));
2059 /* Return 1 if an attribute and its arguments are valid for a decl or type. */
2061 extern int valid_machine_attribute PARAMS ((tree, tree, tree, tree));
2063 /* Given a tree node and a string, return non-zero if the tree node is
2064 a valid attribute name for the string. */
2066 extern int is_attribute_p PARAMS ((const char *, tree));
2068 /* Given an attribute name and a list of attributes, return the list element
2069 of the attribute or NULL_TREE if not found. */
2071 extern tree lookup_attribute PARAMS ((const char *, tree));
2073 /* Given two attributes lists, return a list of their union. */
2075 extern tree merge_attributes PARAMS ((tree, tree));
2077 /* Return a version of the TYPE, qualified as indicated by the
2078 TYPE_QUALS, if one exists. If no qualified version exists yet,
2079 return NULL_TREE. */
2081 extern tree get_qualified_type PARAMS ((tree, int));
2083 /* Like get_qualified_type, but creates the type if it does not
2084 exist. This function never returns NULL_TREE. */
2086 extern tree build_qualified_type PARAMS ((tree, int));
2088 /* Like build_qualified_type, but only deals with the `const' and
2089 `volatile' qualifiers. This interface is retained for backwards
2090 compatiblity with the various front-ends; new code should use
2091 build_qualified_type instead. */
2093 #define build_type_variant(TYPE, CONST_P, VOLATILE_P) \
2094 build_qualified_type (TYPE, \
2095 ((CONST_P) ? TYPE_QUAL_CONST : 0) \
2096 | ((VOLATILE_P) ? TYPE_QUAL_VOLATILE : 0))
2098 /* Make a copy of a type node. */
2100 extern tree build_type_copy PARAMS ((tree));
2102 /* Given a ..._TYPE node, calculate the TYPE_SIZE, TYPE_SIZE_UNIT,
2103 TYPE_ALIGN and TYPE_MODE fields. If called more than once on one
2104 node, does nothing except for the first time. */
2106 extern void layout_type PARAMS ((tree));
2108 /* These functions allow a front-end to perform a manual layout of a
2109 RECORD_TYPE. (For instance, if the placement of subsequent fields
2110 depends on the placement of fields so far.) Begin by calling
2111 start_record_layout. Then, call place_field for each of the
2112 fields. Then, call finish_record_layout. See layout_type for the
2113 default way in which these functions are used. */
2115 typedef struct record_layout_info_s
2117 /* The RECORD_TYPE that we are laying out. */
2118 tree t;
2119 /* The offset into the record so far, in bytes, not including bits in
2120 BITPOS. */
2121 tree offset;
2122 /* The last known alignment of SIZE. */
2123 unsigned int offset_align;
2124 /* The bit position within the last OFFSET_ALIGN bits, in bits. */
2125 tree bitpos;
2126 /* The alignment of the record so far, in bits. */
2127 unsigned int record_align;
2128 /* The alignment of the record so far, not including padding, in bits. */
2129 unsigned int unpacked_align;
2130 /* The static variables (i.e., class variables, as opposed to
2131 instance variables) encountered in T. */
2132 tree pending_statics;
2133 int packed_maybe_necessary;
2134 } *record_layout_info;
2136 extern record_layout_info start_record_layout PARAMS ((tree));
2137 extern tree bit_from_pos PARAMS ((tree, tree));
2138 extern tree byte_from_pos PARAMS ((tree, tree));
2139 extern void pos_from_byte PARAMS ((tree *, tree *, unsigned int,
2140 tree));
2141 extern void pos_from_bit PARAMS ((tree *, tree *, unsigned int,
2142 tree));
2143 extern void normalize_offset PARAMS ((tree *, tree *,
2144 unsigned int));
2145 extern tree rli_size_unit_so_far PARAMS ((record_layout_info));
2146 extern tree rli_size_so_far PARAMS ((record_layout_info));
2147 extern void normalize_rli PARAMS ((record_layout_info));
2148 extern void place_field PARAMS ((record_layout_info, tree));
2149 extern void compute_record_mode PARAMS ((tree));
2150 extern void finish_record_layout PARAMS ((record_layout_info));
2152 /* Given a hashcode and a ..._TYPE node (for which the hashcode was made),
2153 return a canonicalized ..._TYPE node, so that duplicates are not made.
2154 How the hash code is computed is up to the caller, as long as any two
2155 callers that could hash identical-looking type nodes agree. */
2157 extern tree type_hash_canon PARAMS ((unsigned int, tree));
2159 /* Given a VAR_DECL, PARM_DECL, RESULT_DECL or FIELD_DECL node,
2160 calculates the DECL_SIZE, DECL_SIZE_UNIT, DECL_ALIGN and DECL_MODE
2161 fields. Call this only once for any given decl node.
2163 Second argument is the boundary that this field can be assumed to
2164 be starting at (in bits). Zero means it can be assumed aligned
2165 on any boundary that may be needed. */
2167 extern void layout_decl PARAMS ((tree, unsigned));
2169 /* Return the mode for data of a given size SIZE and mode class CLASS.
2170 If LIMIT is nonzero, then don't use modes bigger than MAX_FIXED_MODE_SIZE.
2171 The value is BLKmode if no other mode is found. This is like
2172 mode_for_size, but is passed a tree. */
2174 extern enum machine_mode mode_for_size_tree PARAMS ((tree, enum mode_class,
2175 int));
2177 /* Return an expr equal to X but certainly not valid as an lvalue. */
2179 extern tree non_lvalue PARAMS ((tree));
2180 extern tree pedantic_non_lvalue PARAMS ((tree));
2182 extern tree convert PARAMS ((tree, tree));
2183 extern unsigned int expr_align PARAMS ((tree));
2184 extern tree size_in_bytes PARAMS ((tree));
2185 extern HOST_WIDE_INT int_size_in_bytes PARAMS ((tree));
2186 extern tree bit_position PARAMS ((tree));
2187 extern HOST_WIDE_INT int_bit_position PARAMS ((tree));
2188 extern tree byte_position PARAMS ((tree));
2189 extern HOST_WIDE_INT int_byte_position PARAMS ((tree));
2191 /* Define data structures, macros, and functions for handling sizes
2192 and the various types used to represent sizes. */
2194 enum size_type_kind
2196 SIZETYPE, /* Normal representation of sizes in bytes. */
2197 SSIZETYPE, /* Signed representation of sizes in bytes. */
2198 USIZETYPE, /* Unsigned representation of sizes in bytes. */
2199 BITSIZETYPE, /* Normal representation of sizes in bits. */
2200 SBITSIZETYPE, /* Signed representation of sizes in bits. */
2201 UBITSIZETYPE, /* Unsifgned representation of sizes in bits. */
2202 TYPE_KIND_LAST};
2204 extern tree sizetype_tab[(int) TYPE_KIND_LAST];
2206 #define sizetype sizetype_tab[(int) SIZETYPE]
2207 #define bitsizetype sizetype_tab[(int) BITSIZETYPE]
2208 #define ssizetype sizetype_tab[(int) SSIZETYPE]
2209 #define usizetype sizetype_tab[(int) USIZETYPE]
2210 #define sbitsizetype sizetype_tab[(int) SBITSIZETYPE]
2211 #define ubitsizetype sizetype_tab[(int) UBITSIZETYPE]
2213 extern tree size_binop PARAMS ((enum tree_code, tree, tree));
2214 extern tree size_diffop PARAMS ((tree, tree));
2215 extern tree size_int_wide PARAMS ((HOST_WIDE_INT,
2216 enum size_type_kind));
2217 extern tree size_int_type_wide PARAMS ((HOST_WIDE_INT, tree));
2219 #define size_int_type(L, T) size_int_type_wide ((HOST_WIDE_INT) (L), T)
2220 #define size_int(L) size_int_wide ((HOST_WIDE_INT) (L), SIZETYPE)
2221 #define ssize_int(L) size_int_wide ((HOST_WIDE_INT) (L), SSIZETYPE)
2222 #define bitsize_int(L) size_int_wide ((HOST_WIDE_INT) (L), BITSIZETYPE)
2223 #define sbitsize_int(L) size_int_wide ((HOST_WIDE_INT) (L), SBITSIZETYPE)
2225 extern tree round_up PARAMS ((tree, int));
2226 extern tree round_down PARAMS ((tree, int));
2227 extern tree get_pending_sizes PARAMS ((void));
2228 extern void put_pending_sizes PARAMS ((tree));
2230 /* Type for sizes of data-type. */
2232 #define BITS_PER_UNIT_LOG \
2233 ((BITS_PER_UNIT > 1) + (BITS_PER_UNIT > 2) + (BITS_PER_UNIT > 4) \
2234 + (BITS_PER_UNIT > 8) + (BITS_PER_UNIT > 16) + (BITS_PER_UNIT > 32) \
2235 + (BITS_PER_UNIT > 64) + (BITS_PER_UNIT > 128) + (BITS_PER_UNIT > 256))
2237 /* If nonzero, an upper limit on alignment of structure fields, in bits. */
2238 extern unsigned int maximum_field_alignment;
2240 /* If non-zero, the alignment of a bitstring or (power-)set value, in bits. */
2241 extern unsigned int set_alignment;
2243 /* Concatenate two lists (chains of TREE_LIST nodes) X and Y
2244 by making the last node in X point to Y.
2245 Returns X, except if X is 0 returns Y. */
2247 extern tree chainon PARAMS ((tree, tree));
2249 /* Make a new TREE_LIST node from specified PURPOSE, VALUE and CHAIN. */
2251 extern tree tree_cons PARAMS ((tree, tree, tree));
2253 /* Return the last tree node in a chain. */
2255 extern tree tree_last PARAMS ((tree));
2257 /* Reverse the order of elements in a chain, and return the new head. */
2259 extern tree nreverse PARAMS ((tree));
2261 /* Returns the length of a chain of nodes
2262 (number of chain pointers to follow before reaching a null pointer). */
2264 extern int list_length PARAMS ((tree));
2266 /* Returns the number of FIELD_DECLs in a type. */
2268 extern int fields_length PARAMS ((tree));
2270 /* integer_zerop (tree x) is nonzero if X is an integer constant of value 0 */
2272 extern int integer_zerop PARAMS ((tree));
2274 /* integer_onep (tree x) is nonzero if X is an integer constant of value 1 */
2276 extern int integer_onep PARAMS ((tree));
2278 /* integer_all_onesp (tree x) is nonzero if X is an integer constant
2279 all of whose significant bits are 1. */
2281 extern int integer_all_onesp PARAMS ((tree));
2283 /* integer_pow2p (tree x) is nonzero is X is an integer constant with
2284 exactly one bit 1. */
2286 extern int integer_pow2p PARAMS ((tree));
2288 /* staticp (tree x) is nonzero if X is a reference to data allocated
2289 at a fixed address in memory. */
2291 extern int staticp PARAMS ((tree));
2293 /* Gets an error if argument X is not an lvalue.
2294 Also returns 1 if X is an lvalue, 0 if not. */
2296 extern int lvalue_or_else PARAMS ((tree, const char *));
2298 /* save_expr (EXP) returns an expression equivalent to EXP
2299 but it can be used multiple times within context CTX
2300 and only evaluate EXP once. */
2302 extern tree save_expr PARAMS ((tree));
2304 /* Returns the index of the first non-tree operand for CODE, or the number
2305 of operands if all are trees. */
2307 extern int first_rtl_op PARAMS ((enum tree_code));
2309 /* unsave_expr (EXP) returns an expression equivalent to EXP but it
2310 can be used multiple times and will evaluate EXP in its entirety
2311 each time. */
2313 extern tree unsave_expr PARAMS ((tree));
2315 /* Reset EXP in place so that it can be expaned again. Does not
2316 recurse into subtrees. */
2318 extern void unsave_expr_1 PARAMS ((tree));
2320 /* Like unsave_expr_1, but recurses into all subtrees. */
2322 extern tree unsave_expr_now PARAMS ((tree));
2324 /* If non-null, these are language-specific helper functions for
2325 unsave_expr_now. If present, LANG_UNSAVE is called before its
2326 argument (an UNSAVE_EXPR) is to be unsaved, and all other
2327 processing in unsave_expr_now is aborted. LANG_UNSAVE_EXPR_NOW is
2328 called from unsave_expr_1 for language-specific tree codes. */
2329 extern void (*lang_unsave) PARAMS ((tree *));
2330 extern void (*lang_unsave_expr_now) PARAMS ((tree));
2332 /* Return 0 if it is safe to evaluate EXPR multiple times,
2333 return 1 if it is safe if EXPR is unsaved afterward, or
2334 return 2 if it is completely unsafe. */
2335 extern int unsafe_for_reeval PARAMS ((tree));
2337 /* If non-null, these are language-specific helper functions for
2338 unsafe_for_reeval. Return negative to not handle some tree. */
2339 extern int (*lang_unsafe_for_reeval) PARAMS ((tree));
2341 /* Return 1 if EXP contains a PLACEHOLDER_EXPR; i.e., if it represents a size
2342 or offset that depends on a field within a record.
2344 Note that we only allow such expressions within simple arithmetic
2345 or a COND_EXPR. */
2347 extern int contains_placeholder_p PARAMS ((tree));
2349 /* Return 1 if EXP contains any expressions that produce cleanups for an
2350 outer scope to deal with. Used by fold. */
2352 extern int has_cleanups PARAMS ((tree));
2354 /* Given a tree EXP, a FIELD_DECL F, and a replacement value R,
2355 return a tree with all occurrences of references to F in a
2356 PLACEHOLDER_EXPR replaced by R. Note that we assume here that EXP
2357 contains only arithmetic expressions. */
2359 extern tree substitute_in_expr PARAMS ((tree, tree, tree));
2361 /* variable_size (EXP) is like save_expr (EXP) except that it
2362 is for the special case of something that is part of a
2363 variable size for a data type. It makes special arrangements
2364 to compute the value at the right time when the data type
2365 belongs to a function parameter. */
2367 extern tree variable_size PARAMS ((tree));
2369 /* stabilize_reference (EXP) returns an reference equivalent to EXP
2370 but it can be used multiple times
2371 and only evaluate the subexpressions once. */
2373 extern tree stabilize_reference PARAMS ((tree));
2375 /* Subroutine of stabilize_reference; this is called for subtrees of
2376 references. Any expression with side-effects must be put in a SAVE_EXPR
2377 to ensure that it is only evaluated once. */
2379 extern tree stabilize_reference_1 PARAMS ((tree));
2381 /* Return EXP, stripped of any conversions to wider types
2382 in such a way that the result of converting to type FOR_TYPE
2383 is the same as if EXP were converted to FOR_TYPE.
2384 If FOR_TYPE is 0, it signifies EXP's type. */
2386 extern tree get_unwidened PARAMS ((tree, tree));
2388 /* Return OP or a simpler expression for a narrower value
2389 which can be sign-extended or zero-extended to give back OP.
2390 Store in *UNSIGNEDP_PTR either 1 if the value should be zero-extended
2391 or 0 if the value should be sign-extended. */
2393 extern tree get_narrower PARAMS ((tree, int *));
2395 /* Given MODE and UNSIGNEDP, return a suitable type-tree
2396 with that mode.
2397 The definition of this resides in language-specific code
2398 as the repertoire of available types may vary. */
2400 extern tree type_for_mode PARAMS ((enum machine_mode, int));
2402 /* Given PRECISION and UNSIGNEDP, return a suitable type-tree
2403 for an integer type with at least that precision.
2404 The definition of this resides in language-specific code
2405 as the repertoire of available types may vary. */
2407 extern tree type_for_size PARAMS ((unsigned, int));
2409 /* Given an integer type T, return a type like T but unsigned.
2410 If T is unsigned, the value is T.
2411 The definition of this resides in language-specific code
2412 as the repertoire of available types may vary. */
2414 extern tree unsigned_type PARAMS ((tree));
2416 /* Given an integer type T, return a type like T but signed.
2417 If T is signed, the value is T.
2418 The definition of this resides in language-specific code
2419 as the repertoire of available types may vary. */
2421 extern tree signed_type PARAMS ((tree));
2423 /* This function must be defined in the language-specific files.
2424 expand_expr calls it to build the cleanup-expression for a TARGET_EXPR.
2425 This is defined in a language-specific file. */
2427 extern tree maybe_build_cleanup PARAMS ((tree));
2429 /* Given an expression EXP that may be a COMPONENT_REF or an ARRAY_REF,
2430 look for nested component-refs or array-refs at constant positions
2431 and find the ultimate containing object, which is returned. */
2433 extern tree get_inner_reference PARAMS ((tree, HOST_WIDE_INT *,
2434 HOST_WIDE_INT *, tree *,
2435 enum machine_mode *, int *,
2436 int *, unsigned int *));
2438 /* Given a DECL or TYPE, return the scope in which it was declared, or
2439 NUL_TREE if there is no containing scope. */
2441 extern tree get_containing_scope PARAMS ((tree));
2443 /* Return the FUNCTION_DECL which provides this _DECL with its context,
2444 or zero if none. */
2445 extern tree decl_function_context PARAMS ((tree));
2447 /* Return the RECORD_TYPE, UNION_TYPE, or QUAL_UNION_TYPE which provides
2448 this _DECL with its context, or zero if none. */
2449 extern tree decl_type_context PARAMS ((tree));
2451 /* Given the FUNCTION_DECL for the current function,
2452 return zero if it is ok for this function to be inline.
2453 Otherwise return a warning message with a single %s
2454 for the function's name. */
2456 extern const char *function_cannot_inline_p PARAMS ((tree));
2458 /* Return 1 if EXPR is the real constant zero. */
2459 extern int real_zerop PARAMS ((tree));
2461 /* Declare commonly used variables for tree structure. */
2463 /* Points to the name of the input file from which the current input
2464 being parsed originally came (before it went into cpp). */
2465 extern const char *input_filename;
2467 /* Current line number in input file. */
2468 extern int lineno;
2470 /* Nonzero for -pedantic switch: warn about anything
2471 that standard C forbids. */
2472 extern int pedantic;
2474 /* Nonzero means lvalues are limited to those valid in pedantic ANSI C.
2475 Zero means allow extended lvalues. */
2477 extern int pedantic_lvalues;
2479 /* Nonzero means can safely call expand_expr now;
2480 otherwise layout_type puts variable sizes onto `pending_sizes' instead. */
2482 extern int immediate_size_expand;
2484 /* Points to the FUNCTION_DECL of the function whose body we are reading. */
2486 extern tree current_function_decl;
2488 /* Nonzero means a FUNC_BEGIN label was emitted. */
2489 extern tree current_function_func_begin_label;
2491 /* Nonzero means all ..._TYPE nodes should be allocated permanently. */
2493 extern int all_types_permanent;
2495 /* Pointer to function to compute the name to use to print a declaration.
2496 DECL is the declaration in question.
2497 VERBOSITY determines what information will be printed:
2498 0: DECL_NAME, demangled as necessary.
2499 1: and scope information.
2500 2: and any other information that might be interesting, such as function
2501 parameter types in C++. */
2503 extern const char *(*decl_printable_name) PARAMS ((tree, int));
2505 /* Pointer to function to finish handling an incomplete decl at the
2506 end of compilation. */
2508 extern void (*incomplete_decl_finalize_hook) PARAMS ((tree));
2510 extern const char *init_parse PARAMS ((const char *));
2511 extern void finish_parse PARAMS ((void));
2513 extern const char * const language_string;
2515 /* Declare a predefined function. Return the declaration. This function is
2516 provided by each language frontend. */
2517 extern tree builtin_function PARAMS ((const char *, tree, int,
2518 enum built_in_class,
2519 const char *));
2521 /* In tree.c */
2522 extern char *perm_calloc PARAMS ((int, long));
2523 extern void clean_symbol_name PARAMS ((char *));
2524 extern tree get_file_function_name_long PARAMS ((const char *));
2525 extern tree get_set_constructor_bits PARAMS ((tree, char *, int));
2526 extern tree get_set_constructor_bytes PARAMS ((tree,
2527 unsigned char *, int));
2528 extern tree get_callee_fndecl PARAMS ((tree));
2529 extern void set_decl_assembler_name PARAMS ((tree));
2530 extern int type_num_arguments PARAMS ((tree));
2532 /* In stmt.c */
2534 extern int in_control_zone_p PARAMS ((void));
2535 extern void expand_fixups PARAMS ((struct rtx_def *));
2536 extern tree expand_start_stmt_expr PARAMS ((void));
2537 extern tree expand_end_stmt_expr PARAMS ((tree));
2538 extern void expand_expr_stmt PARAMS ((tree));
2539 extern int warn_if_unused_value PARAMS ((tree));
2540 extern void expand_decl_init PARAMS ((tree));
2541 extern void clear_last_expr PARAMS ((void));
2542 extern void expand_label PARAMS ((tree));
2543 extern void expand_goto PARAMS ((tree));
2544 extern void expand_asm PARAMS ((tree));
2545 extern void expand_start_cond PARAMS ((tree, int));
2546 extern void expand_end_cond PARAMS ((void));
2547 extern void expand_start_else PARAMS ((void));
2548 extern void expand_start_elseif PARAMS ((tree));
2549 extern struct nesting *expand_start_loop PARAMS ((int));
2550 extern struct nesting *expand_start_loop_continue_elsewhere PARAMS ((int));
2551 extern struct nesting *expand_start_null_loop PARAMS ((void));
2552 extern void expand_loop_continue_here PARAMS ((void));
2553 extern void expand_end_loop PARAMS ((void));
2554 extern void expand_end_null_loop PARAMS ((void));
2555 extern int expand_continue_loop PARAMS ((struct nesting *));
2556 extern int expand_exit_loop PARAMS ((struct nesting *));
2557 extern int expand_exit_loop_if_false PARAMS ((struct nesting *,
2558 tree));
2559 extern int expand_exit_something PARAMS ((void));
2561 extern void expand_null_return PARAMS ((void));
2562 extern void expand_return PARAMS ((tree));
2563 extern int optimize_tail_recursion PARAMS ((tree, struct rtx_def *));
2564 extern void expand_start_bindings_and_block PARAMS ((int, tree));
2565 #define expand_start_bindings(flags) \
2566 expand_start_bindings_and_block(flags, NULL_TREE)
2567 extern void expand_end_bindings PARAMS ((tree, int, int));
2568 extern void warn_about_unused_variables PARAMS ((tree));
2569 extern void start_cleanup_deferral PARAMS ((void));
2570 extern void end_cleanup_deferral PARAMS ((void));
2571 extern int is_body_block PARAMS ((tree));
2573 extern int conditional_context PARAMS ((void));
2574 extern tree last_cleanup_this_contour PARAMS ((void));
2575 extern void expand_start_case PARAMS ((int, tree, tree,
2576 const char *));
2577 extern void expand_end_case PARAMS ((tree));
2578 extern int add_case_node PARAMS ((tree, tree,
2579 tree, tree *));
2580 extern int pushcase PARAMS ((tree,
2581 tree (*) (tree, tree),
2582 tree, tree *));
2583 extern int pushcase_range PARAMS ((tree, tree,
2584 tree (*) (tree, tree),
2585 tree, tree *));
2586 extern void using_eh_for_cleanups PARAMS ((void));
2587 extern int stmt_loop_nest_empty PARAMS ((void));
2589 /* In fold-const.c */
2591 /* Fold constants as much as possible in an expression.
2592 Returns the simplified expression.
2593 Acts only on the top level of the expression;
2594 if the argument itself cannot be simplified, its
2595 subexpressions are not changed. */
2597 extern tree fold PARAMS ((tree));
2599 extern int force_fit_type PARAMS ((tree, int));
2600 extern int add_double PARAMS ((unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2601 unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2602 unsigned HOST_WIDE_INT *,
2603 HOST_WIDE_INT *));
2604 extern int neg_double PARAMS ((unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2605 unsigned HOST_WIDE_INT *,
2606 HOST_WIDE_INT *));
2607 extern int mul_double PARAMS ((unsigned HOST_WIDE_INT,
2608 HOST_WIDE_INT,
2609 unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2610 unsigned HOST_WIDE_INT *,
2611 HOST_WIDE_INT *));
2612 extern void lshift_double PARAMS ((unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2613 HOST_WIDE_INT, unsigned int,
2614 unsigned HOST_WIDE_INT *,
2615 HOST_WIDE_INT *, int));
2616 extern void rshift_double PARAMS ((unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2617 HOST_WIDE_INT, unsigned int,
2618 unsigned HOST_WIDE_INT *,
2619 HOST_WIDE_INT *, int));
2620 extern void lrotate_double PARAMS ((unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2621 HOST_WIDE_INT, unsigned int,
2622 unsigned HOST_WIDE_INT *,
2623 HOST_WIDE_INT *));
2624 extern void rrotate_double PARAMS ((unsigned HOST_WIDE_INT, HOST_WIDE_INT,
2625 HOST_WIDE_INT, unsigned int,
2626 unsigned HOST_WIDE_INT *,
2627 HOST_WIDE_INT *));
2628 extern int operand_equal_p PARAMS ((tree, tree, int));
2629 extern tree invert_truthvalue PARAMS ((tree));
2631 /* In builtins.c. Given a type, apply default promotions wrt unnamed
2632 function arguments and return the new type. Return NULL_TREE if no
2633 change. Required by any language that supports variadic arguments. */
2635 extern tree (*lang_type_promotes_to) PARAMS ((tree));
2636 extern tree fold_builtin PARAMS ((tree));
2638 /* The language front-end must define these functions. */
2640 /* Function of no arguments for initializing lexical scanning. */
2641 extern void init_lex PARAMS ((void));
2642 /* Function of no arguments for initializing the symbol table. */
2643 extern void init_decl_processing PARAMS ((void));
2645 /* Function to identify which front-end produced the output file. */
2646 extern const char *lang_identify PARAMS ((void));
2648 /* Called by report_error_function to print out function name.
2649 * Default may be overridden by language front-ends. */
2650 extern void (*print_error_function) PARAMS ((const char *));
2652 /* Function to replace the DECL_LANG_SPECIFIC field of a DECL with a copy. */
2653 extern void copy_lang_decl PARAMS ((tree));
2655 /* Function called with no arguments to parse and compile the input. */
2656 extern int yyparse PARAMS ((void));
2657 /* Functions for processing symbol declarations. */
2658 /* Function to enter a new lexical scope.
2659 Takes one argument: always zero when called from outside the front end. */
2660 extern void pushlevel PARAMS ((int));
2661 /* Function to exit a lexical scope. It returns a BINDING for that scope.
2662 Takes three arguments:
2663 KEEP -- nonzero if there were declarations in this scope.
2664 REVERSE -- reverse the order of decls before returning them.
2665 FUNCTIONBODY -- nonzero if this level is the body of a function. */
2666 extern tree poplevel PARAMS ((int, int, int));
2667 /* Set the BLOCK node for the current scope level. */
2668 extern void set_block PARAMS ((tree));
2669 /* Function to add a decl to the current scope level.
2670 Takes one argument, a decl to add.
2671 Returns that decl, or, if the same symbol is already declared, may
2672 return a different decl for that name. */
2673 extern tree pushdecl PARAMS ((tree));
2674 /* Function to return the chain of decls so far in the current scope level. */
2675 extern tree getdecls PARAMS ((void));
2676 /* Function to return the chain of structure tags in the current scope level. */
2677 extern tree gettags PARAMS ((void));
2679 extern tree build_range_type PARAMS ((tree, tree, tree));
2681 /* Called after finishing a record, union or enumeral type. */
2682 extern void rest_of_type_compilation PARAMS ((tree, int));
2684 /* In alias.c */
2685 extern void record_component_aliases PARAMS ((tree));
2686 extern HOST_WIDE_INT get_alias_set PARAMS ((tree));
2687 extern int alias_sets_conflict_p PARAMS ((HOST_WIDE_INT,
2688 HOST_WIDE_INT));
2689 extern int readonly_fields_p PARAMS ((tree));
2690 extern int objects_must_conflict_p PARAMS ((tree, tree));
2692 /* In c-common.c */
2693 extern HOST_WIDE_INT lang_get_alias_set PARAMS ((tree));
2695 /* Set the DECL_ASSEMBLER_NAME for a node. If it is the sort of thing
2696 that the assembler should talk about, set DECL_ASSEMBLER_NAME to an
2697 appropriate IDENTIFIER_NODE. Otherwise, set it to the
2698 ERROR_MARK_NODE to ensure that the assembler does not talk about
2699 it. */
2700 extern void (*lang_set_decl_assembler_name) PARAMS ((tree));
2702 struct obstack;
2704 /* In tree.c */
2705 extern int really_constant_p PARAMS ((tree));
2706 extern void set_identifier_size PARAMS ((int));
2707 extern int int_fits_type_p PARAMS ((tree, tree));
2708 extern int tree_log2 PARAMS ((tree));
2709 extern int tree_floor_log2 PARAMS ((tree));
2710 extern void preserve_data PARAMS ((void));
2711 extern int object_permanent_p PARAMS ((tree));
2712 extern int type_precision PARAMS ((tree));
2713 extern int simple_cst_equal PARAMS ((tree, tree));
2714 extern int compare_tree_int PARAMS ((tree, unsigned int));
2715 extern int type_list_equal PARAMS ((tree, tree));
2716 extern int chain_member PARAMS ((tree, tree));
2717 extern int chain_member_purpose PARAMS ((tree, tree));
2718 extern int chain_member_value PARAMS ((tree, tree));
2719 extern tree listify PARAMS ((tree));
2720 extern tree type_hash_lookup PARAMS ((unsigned int, tree));
2721 extern void type_hash_add PARAMS ((unsigned int, tree));
2722 extern unsigned int type_hash_list PARAMS ((tree));
2723 extern int simple_cst_list_equal PARAMS ((tree, tree));
2724 extern void dump_tree_statistics PARAMS ((void));
2725 extern void print_obstack_statistics PARAMS ((const char *,
2726 struct obstack *));
2727 #ifdef BUFSIZ
2728 extern void print_obstack_name PARAMS ((char *, FILE *,
2729 const char *));
2730 #endif
2731 extern void expand_function_end PARAMS ((const char *, int, int));
2732 extern void expand_function_start PARAMS ((tree, int));
2733 extern void expand_pending_sizes PARAMS ((tree));
2735 extern int real_onep PARAMS ((tree));
2736 extern int real_twop PARAMS ((tree));
2737 extern void start_identifier_warnings PARAMS ((void));
2738 extern void gcc_obstack_init PARAMS ((struct obstack *));
2739 extern void init_obstacks PARAMS ((void));
2740 extern void build_common_tree_nodes PARAMS ((int));
2741 extern void build_common_tree_nodes_2 PARAMS ((int));
2742 extern void mark_tree_hashtable PARAMS ((void *));
2744 /* In function.c */
2745 extern void setjmp_protect_args PARAMS ((void));
2746 extern void setjmp_protect PARAMS ((tree));
2747 extern void expand_main_function PARAMS ((void));
2748 extern void mark_varargs PARAMS ((void));
2749 extern void init_dummy_function_start PARAMS ((void));
2750 extern void expand_dummy_function_end PARAMS ((void));
2751 extern void init_function_for_compilation PARAMS ((void));
2752 extern void init_function_start PARAMS ((tree, const char *, int));
2753 extern void assign_parms PARAMS ((tree));
2754 extern void put_var_into_stack PARAMS ((tree));
2755 extern void flush_addressof PARAMS ((tree));
2756 extern void uninitialized_vars_warning PARAMS ((tree));
2757 extern void setjmp_args_warning PARAMS ((void));
2758 extern void mark_all_temps_used PARAMS ((void));
2759 extern void init_temp_slots PARAMS ((void));
2760 extern void combine_temp_slots PARAMS ((void));
2761 extern void free_temp_slots PARAMS ((void));
2762 extern void pop_temp_slots PARAMS ((void));
2763 extern void push_temp_slots PARAMS ((void));
2764 extern void preserve_temp_slots PARAMS ((struct rtx_def *));
2765 extern void preserve_rtl_expr_temps PARAMS ((tree));
2766 extern int aggregate_value_p PARAMS ((tree));
2767 extern void free_temps_for_rtl_expr PARAMS ((tree));
2768 extern void instantiate_virtual_regs PARAMS ((tree, struct rtx_def *));
2769 extern void unshare_all_rtl PARAMS ((tree, struct rtx_def *));
2770 extern int max_parm_reg_num PARAMS ((void));
2771 extern void push_function_context PARAMS ((void));
2772 extern void pop_function_context PARAMS ((void));
2773 extern void push_function_context_to PARAMS ((tree));
2774 extern void pop_function_context_from PARAMS ((tree));
2776 /* In print-rtl.c */
2777 #ifdef BUFSIZ
2778 extern void print_rtl PARAMS ((FILE *, struct rtx_def *));
2779 #endif
2781 /* In print-tree.c */
2782 extern void debug_tree PARAMS ((tree));
2783 #ifdef BUFSIZ
2784 extern void print_node PARAMS ((FILE *, const char *, tree,
2785 int));
2786 extern void print_node_brief PARAMS ((FILE *, const char *, tree,
2787 int));
2788 extern void indent_to PARAMS ((FILE *, int));
2789 #endif
2791 /* In expr.c */
2792 extern void emit_queue PARAMS ((void));
2793 extern int apply_args_register_offset PARAMS ((int));
2794 extern struct rtx_def *expand_builtin_return_addr
2795 PARAMS ((enum built_in_function, int, struct rtx_def *));
2796 extern void do_pending_stack_adjust PARAMS ((void));
2797 extern struct rtx_def *expand_assignment PARAMS ((tree, tree, int,
2798 int));
2799 extern struct rtx_def *store_expr PARAMS ((tree,
2800 struct rtx_def *,
2801 int));
2802 extern void check_max_integer_computation_mode PARAMS ((tree));
2804 /* In emit-rtl.c */
2805 extern void start_sequence_for_rtl_expr PARAMS ((tree));
2806 extern struct rtx_def *emit_line_note_after PARAMS ((const char *, int,
2807 struct rtx_def *));
2808 extern struct rtx_def *emit_line_note PARAMS ((const char *, int));
2809 extern struct rtx_def *emit_line_note_force PARAMS ((const char *, int));
2811 /* In calls.c */
2813 extern int setjmp_call_p PARAMS ((tree));
2815 /* In front end. */
2817 extern int mark_addressable PARAMS ((tree));
2818 extern void incomplete_type_error PARAMS ((tree, tree));
2819 extern void print_lang_statistics PARAMS ((void));
2820 extern tree truthvalue_conversion PARAMS ((tree));
2821 extern void split_specs_attrs PARAMS ((tree, tree *, tree *));
2822 #ifdef BUFSIZ
2823 extern void print_lang_decl PARAMS ((FILE *, tree, int));
2824 extern void print_lang_type PARAMS ((FILE *, tree, int));
2825 extern void print_lang_identifier PARAMS ((FILE *, tree, int));
2826 #endif
2827 extern int global_bindings_p PARAMS ((void));
2828 extern void insert_block PARAMS ((tree));
2830 /* In integrate.c */
2831 extern void save_for_inline PARAMS ((tree));
2832 extern void set_decl_abstract_flags PARAMS ((tree, int));
2833 extern void output_inline_function PARAMS ((tree));
2834 extern void set_decl_origin_self PARAMS ((tree));
2836 /* In front end. */
2837 extern void set_yydebug PARAMS ((int));
2839 /* In stor-layout.c */
2840 extern void fixup_signed_type PARAMS ((tree));
2841 extern void internal_reference_types PARAMS ((void));
2843 /* varasm.c */
2844 extern void make_decl_rtl PARAMS ((tree, const char *));
2845 extern void make_decl_one_only PARAMS ((tree));
2846 extern int supports_one_only PARAMS ((void));
2847 extern void variable_section PARAMS ((tree, int));
2849 /* In fold-const.c */
2850 extern int div_and_round_double PARAMS ((enum tree_code, int,
2851 unsigned HOST_WIDE_INT,
2852 HOST_WIDE_INT,
2853 unsigned HOST_WIDE_INT,
2854 HOST_WIDE_INT,
2855 unsigned HOST_WIDE_INT *,
2856 HOST_WIDE_INT *,
2857 unsigned HOST_WIDE_INT *,
2858 HOST_WIDE_INT *));
2860 /* In stmt.c */
2861 extern void emit_nop PARAMS ((void));
2862 extern void expand_computed_goto PARAMS ((tree));
2863 extern struct rtx_def *label_rtx PARAMS ((tree));
2864 extern bool parse_output_constraint PARAMS ((const char **,
2865 int, int, int,
2866 bool *, bool *, bool *));
2867 extern void expand_asm_operands PARAMS ((tree, tree, tree, tree, int,
2868 const char *, int));
2869 extern int any_pending_cleanups PARAMS ((int));
2870 extern void init_stmt PARAMS ((void));
2871 extern void init_stmt_for_function PARAMS ((void));
2872 extern int drop_through_at_end_p PARAMS ((void));
2873 extern void expand_start_target_temps PARAMS ((void));
2874 extern void expand_end_target_temps PARAMS ((void));
2875 extern void expand_elseif PARAMS ((tree));
2876 extern void save_stack_pointer PARAMS ((void));
2877 extern void expand_decl PARAMS ((tree));
2878 extern int expand_decl_cleanup PARAMS ((tree, tree));
2879 extern void expand_anon_union_decl PARAMS ((tree, tree, tree));
2880 extern void move_cleanups_up PARAMS ((void));
2881 extern void expand_start_case_dummy PARAMS ((void));
2882 extern void expand_end_case_dummy PARAMS ((void));
2883 extern tree case_index_expr_type PARAMS ((void));
2884 extern HOST_WIDE_INT all_cases_count PARAMS ((tree, int *));
2885 extern void check_for_full_enumeration_handling PARAMS ((tree));
2886 extern void declare_nonlocal_label PARAMS ((tree));
2887 #ifdef BUFSIZ
2888 extern void lang_print_xnode PARAMS ((FILE *, tree, int));
2889 #endif
2892 /* If KIND=='I', return a suitable global initializer (constructor) name.
2893 If KIND=='D', return a suitable global clean-up (destructor) name. */
2894 extern tree get_file_function_name PARAMS ((int));
2896 /* Interface of the DWARF2 unwind info support. */
2898 /* Decide whether we want to emit frame unwind information for the current
2899 translation unit. */
2901 extern int dwarf2out_do_frame PARAMS ((void));
2903 /* Generate a new label for the CFI info to refer to. */
2905 extern char *dwarf2out_cfi_label PARAMS ((void));
2907 /* Entry point to update the canonical frame address (CFA). */
2909 extern void dwarf2out_def_cfa PARAMS ((const char *, unsigned, long));
2911 /* Add the CFI for saving a register window. */
2913 extern void dwarf2out_window_save PARAMS ((const char *));
2915 /* Add a CFI to update the running total of the size of arguments pushed
2916 onto the stack. */
2918 extern void dwarf2out_args_size PARAMS ((const char *, long));
2920 /* Entry point for saving a register to the stack. */
2922 extern void dwarf2out_reg_save PARAMS ((const char *, unsigned, long));
2924 /* Entry point for saving the return address in the stack. */
2926 extern void dwarf2out_return_save PARAMS ((const char *, long));
2928 /* Entry point for saving the return address in a register. */
2930 extern void dwarf2out_return_reg PARAMS ((const char *, unsigned));
2932 /* Output a marker (i.e. a label) for the beginning of a function, before
2933 the prologue. */
2935 extern void dwarf2out_begin_prologue PARAMS ((void));
2937 /* Output a marker (i.e. a label) for the absolute end of the generated
2938 code for a function definition. */
2940 extern void dwarf2out_end_epilogue PARAMS ((void));
2942 /* Redefine abort to report an internal error w/o coredump, and
2943 reporting the location of the error in the source file. This logic
2944 is duplicated in rtl.h and tree.h because every file that needs the
2945 special abort includes one or both. toplev.h gets too few files,
2946 system.h gets too many. */
2948 extern void fancy_abort PARAMS ((const char *, int, const char *))
2949 ATTRIBUTE_NORETURN;
2950 #define abort() fancy_abort (__FILE__, __LINE__, __FUNCTION__)