X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=gcc%2Fcp%2Fcp-tree.def;h=02afea97a50245e9669eeb50e2fe19f5abeef0ff;hb=42c244d8479bf2900995626586b8ec25b9b3eb5a;hp=d965783188a8dfd6a745143cb04fcd122f9e3d54;hpb=ec25526966761fb80b027fc17431911f91a95ee6;p=gcc.git diff --git a/gcc/cp/cp-tree.def b/gcc/cp/cp-tree.def index d965783188a..02afea97a50 100644 --- a/gcc/cp/cp-tree.def +++ b/gcc/cp/cp-tree.def @@ -1,73 +1,111 @@ /* This file contains the definitions and documentation for the additional tree codes used in the GNU C++ compiler (see tree.def for the standard codes). - Copyright (C) 1987, 1988, 1990, 1993 Free Software Foundation, Inc. + Copyright (C) 1987, 1988, 1990, 1993, 1997, 1998, 2003, 2004, + 1999, 2000, 2001, 2002, 2003 Free Software Foundation, Inc. Hacked by Michael Tiemann (tiemann@cygnus.com) -This file is part of GNU CC. +This file is part of GCC. -GNU CC is free software; you can redistribute it and/or modify +GCC is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. -GNU CC is distributed in the hope that it will be useful, +GCC is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License -along with GNU CC; see the file COPYING. If not, write to +along with GCC; see the file COPYING. If not, write to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ -/* Reference to the contents of an offset - (a value whose type is an OFFSET_TYPE). - Operand 0 is the object within which the offset is taken. - Operand 1 is the offset. The language independent OFFSET_REF - just won't work for us. */ -DEFTREECODE (CP_OFFSET_REF, "cp_offset_ref", "r", 2) +/* An OFFSET_REF is used in two situations: + + 1. An expression of the form `A::m' where `A' is a class and `m' is + a non-static member. In this case, operand 0 will be a TYPE + (corresponding to `A') and operand 1 will be a FIELD_DECL, + BASELINK, or TEMPLATE_ID_EXPR (corresponding to `m'). + + The expression is a pointer-to-member if its address is taken, + but simply denotes a member of the object if its address isnot + taken. In the latter case, resolve_offset_ref is used to + convert it to a representation of the member referred to by the + OFFSET_REF. + + This form is only used during the parsing phase; once semantic + analysis has taken place they are eliminated. + + 2. An expression of the form `x.*p'. In this case, operand 0 will + be an expression corresponding to `x' and operand 1 will be an + expression with pointer-to-member type. */ +DEFTREECODE (OFFSET_REF, "offset_ref", 'r', 2) + +/* A pointer-to-member constant. For a pointer-to-member constant + `X::Y' The PTRMEM_CST_CLASS is the RECORD_TYPE for `X' and the + PTRMEM_CST_MEMBER is the _DECL for `Y'. */ +DEFTREECODE (PTRMEM_CST, "ptrmem_cst", 'c', 0) + +/* For NEW_EXPR, operand 0 is the placement list. + Operand 1 is the new-declarator. + Operand 2 is the number of elements in the array. + Operand 3 is the initializer. */ +DEFTREECODE (NEW_EXPR, "nw_expr", 'e', 4) +DEFTREECODE (VEC_NEW_EXPR, "vec_nw_expr", 'e', 3) /* For DELETE_EXPR, operand 0 is the store to be destroyed. Operand 1 is the value to pass to the destroying function saying whether the store should be deallocated as well. */ -DEFTREECODE (DELETE_EXPR, "dl_expr", "e", 2) -DEFTREECODE (VEC_DELETE_EXPR, "vec_dl_expr", "e", 2) - -/* For a UNSAVE_EXPR, operand 0 is the value to unsave. By unsave, we - mean that all _EXPRs such as TARGET_EXPRs, SAVE_EXPRs, - CALL_EXPRs and RTL_EXPRs, that are protected - from being evaluated more than once should be reset so that a new - expand_expr call of this expr will cause those to be re-evaluated. - This is useful when we want to reuse a tree in different places, - but where we must re-expand. */ -DEFTREECODE (UNSAVE_EXPR, "unsave_expr", "e", 1) +DEFTREECODE (DELETE_EXPR, "dl_expr", 'e', 2) +DEFTREECODE (VEC_DELETE_EXPR, "vec_dl_expr", 'e', 2) /* Value is reference to particular overloaded class method. - Operand 0 is the class name (an IDENTIFIER_NODE); - operand 1 is the field (also an IDENTIFIER_NODE). + Operand 0 is the class, operand 1 is the field The COMPLEXITY field holds the class level (usually 0). */ -DEFTREECODE (SCOPE_REF, "scope_ref", "r", 2) +DEFTREECODE (SCOPE_REF, "scope_ref", 'r', 2) /* When composing an object with a member, this is the result. Operand 0 is the object. Operand 1 is the member (usually a dereferenced pointer to member). */ -DEFTREECODE (MEMBER_REF, "member_ref", "r", 2) +DEFTREECODE (MEMBER_REF, "member_ref", 'r', 2) /* Type conversion operator in C++. TREE_TYPE is type that this operator converts to. Operand is expression to be converted. */ -DEFTREECODE (TYPE_EXPR, "type_expr", "e", 1) +DEFTREECODE (TYPE_EXPR, "type_expr", 'e', 1) -/* For CPLUS_NEW_EXPR, operand 0 is function which performs initialization, +/* For AGGR_INIT_EXPR, operand 0 is function which performs initialization, operand 1 is argument list to initialization function, and operand 2 is the slot which was allocated for this expression. */ -DEFTREECODE (NEW_EXPR, "nw_expr", "e", 3) -DEFTREECODE (VEC_NEW_EXPR, "vec_nw_expr", "e", 3) +DEFTREECODE (AGGR_INIT_EXPR, "aggr_init_expr", 'e', 3) /* A throw expression. operand 0 is the expression, if there was one, else it is NULL_TREE. */ -DEFTREECODE (THROW_EXPR, "throw_expr", "e", 1) +DEFTREECODE (THROW_EXPR, "throw_expr", 'e', 1) + +/* An empty class object. The TREE_TYPE gives the class type. We use + these to avoid actually creating instances of the empty classes. */ +DEFTREECODE (EMPTY_CLASS_EXPR, "empty_class_expr", 'e', 0) + +/* A DECL which is really just a placeholder for an expression. Used to + implement non-class scope anonymous unions. */ +DEFTREECODE (ALIAS_DECL, "alias_decl", 'd', 0) + +/* A reference to a member function or member functions from a base + class. BASELINK_FUNCTIONS gives the FUNCTION_DECL, + TEMPLATE_DECL, OVERLOAD, or TEMPLATE_ID_EXPR corresponding to the + functions. BASELINK_BINFO gives the base from which the functions + come, i.e., the base to which the `this' pointer must be converted + before the functions are called. BASELINK_ACCESS_BINFO gives the + base used to name the functions. + + A BASELINK is an expression; the TREE_TYPE of the BASELINK gives + the type of the expression. This type is either a FUNCTION_TYPE, + METHOD_TYPE, or `unknown_type_node' indicating that the function is + overloaded. */ +DEFTREECODE (BASELINK, "baselink", 'x', 0) /* Template definition. The following fields have the specified uses, although there are other macros in cp-tree.h that should be used for @@ -78,62 +116,177 @@ DEFTREECODE (THROW_EXPR, "throw_expr", "e", 1) only done for functions so far For class template: DECL_INITIAL associated templates (methods &c) - DECL_RESULT null + DECL_TEMPLATE_RESULT null For non-class templates: TREE_TYPE type of object to be constructed - DECL_RESULT decl for object to be created + DECL_TEMPLATE_RESULT decl for object to be created (e.g., FUNCTION_DECL with tmpl parms used) */ -DEFTREECODE (TEMPLATE_DECL, "template_decl", "d", 0) +DEFTREECODE (TEMPLATE_DECL, "template_decl", 'd', 0) + +/* Index into a template parameter list. The TEMPLATE_PARM_IDX gives + the index (from 0) of the parameter, while the TEMPLATE_PARM_LEVEL + gives the level (from 1) of the parameter. + + Here's an example: + + template // Index 0, Level 1. + struct S + { + template // Index 1, Level 2. + void f(); + }; + + The DESCENDANTS will be a chain of TEMPLATE_PARM_INDEXs descended + from this one. The first descendant will have the same IDX, but + its LEVEL will be one less. The TREE_CHAIN field is used to chain + together the descendants. The TEMPLATE_PARM_DECL is the + declaration of this parameter, either a TYPE_DECL or CONST_DECL. + The TEMPLATE_PARM_ORIG_LEVEL is the LEVEL of the most distant + parent, i.e., the LEVEL that the parameter originally had when it + was declared. For example, if we instantiate S, we will have: + + struct S + { + template // Index 1, Level 1, Orig Level 2 + void f(); + }; + + The LEVEL is the level of the parameter when we are worrying about + the types of things; the ORIG_LEVEL is the level when we are + worrying about instantiating things. */ +DEFTREECODE (TEMPLATE_PARM_INDEX, "template_parm_index", 'x', 0) /* Index into a template parameter list. This parameter must be a type. - Use TYPE_FIELDS to find parmlist and index. */ -DEFTREECODE (TEMPLATE_TYPE_PARM, "template_type_parm", "t", 0) + The type.value field will be a TEMPLATE_PARM_INDEX. */ +DEFTREECODE (TEMPLATE_TYPE_PARM, "template_type_parm", 't', 0) -/* A type designated by 'typename T::t'. */ -DEFTREECODE (TYPENAME_TYPE, "typename_type", "t", 0) +/* Index into a template parameter list for template template parameters. + This parameter must be a type. The TYPE_FIELDS value will be a + TEMPLATE_PARM_INDEX. -/* Index into a template parameter list. This parameter must not be a - type. */ -DEFTREECODE (TEMPLATE_CONST_PARM, "template_const_parm", "c", 2) + It is used without template arguments like TT in C, + TEMPLATE_TEMPLATE_PARM_TEMPLATE_INFO is NULL_TREE + and TYPE_NAME is a TEMPLATE_DECL. */ +DEFTREECODE (TEMPLATE_TEMPLATE_PARM, "template_template_parm", 't', 0) -/* A thunk is a stub function. +/* Like TEMPLATE_TEMPLATE_PARM it is used with bound template arguments + like TT. + In this case, TEMPLATE_TEMPLATE_PARM_TEMPLATE_INFO contains the + template name and its bound arguments. TYPE_NAME is a TYPE_DECL. */ +DEFTREECODE (BOUND_TEMPLATE_TEMPLATE_PARM, "bound_template_template_parm", 't', 0) - Thunks are used to implement multiple inheritance: - At run-time, such a thunk subtracts THUNK_DELTA (an int, not a tree) - from the this pointer, and then jumps to DECL_INITIAL - (which is an ADDR_EXPR whose operand is a FUNCTION_DECL). +/* A type designated by `typename T::t'. TYPE_CONTEXT is `T', + TYPE_NAME is an IDENTIFIER_NODE for `t'. If the type was named via + template-id, TYPENAME_TYPE_FULLNAME will hold the TEMPLATE_ID_EXPR. + If TREE_TYPE is present, this type was generated by the implicit + typename extension, and the TREE_TYPE is a _TYPE from a baseclass + of `T'. */ +DEFTREECODE (TYPENAME_TYPE, "typename_type", 't', 0) - Other kinds of thunks may be defined later. */ -DEFTREECODE (THUNK_DECL, "thunk_decl", "d", 0) +/* For template template argument of the form `T::template C'. + TYPE_CONTEXT is `T', the template parameter dependent object. + TYPE_NAME is an IDENTIFIER_NODE for `C', the member class template. */ +DEFTREECODE (UNBOUND_CLASS_TEMPLATE, "unbound_class_template", 't', 0) -/* A namespace declaration. */ -DEFTREECODE (NAMESPACE_DECL, "namespace_decl", "d", 0) +/* A type designated by `__typeof (expr)'. TYPEOF_TYPE_EXPR is the + expression in question. */ +DEFTREECODE (TYPEOF_TYPE, "typeof_type", 't', 0) /* A using declaration. DECL_INITIAL contains the specified scope. - This is not an alias, but is later expanded into multiple aliases. */ -DEFTREECODE (USING_DECL, "using_decl", "d", 0) - -DEFTREECODE (LOOKUP_EXPR, "lookup_expr", "e", 2) -DEFTREECODE (MODOP_EXPR, "modop_expr", "e", 3) -DEFTREECODE (CAST_EXPR, "cast_expr", "1", 1) -DEFTREECODE (REINTERPRET_CAST_EXPR, "reinterpret_cast_expr", "1", 1) -DEFTREECODE (SIZEOF_EXPR, "sizeof_expr", "1", 1) -DEFTREECODE (ARROW_EXPR, "arrow_expr", "e", 1) -DEFTREECODE (DOTSTAR_EXPR, "dotstar_expr", "e", 2) - -DEFTREECODE (EXPR_STMT, "expr_stmt", "e", 1) -DEFTREECODE (COMPOUND_STMT, "compound_stmt", "e", 1) -DEFTREECODE (DECL_STMT, "decl_stmt", "e", 4) -DEFTREECODE (IF_STMT, "if_stmt", "e", 3) -DEFTREECODE (FOR_STMT, "for_stmt", "e", 4) -DEFTREECODE (WHILE_STMT, "while_stmt", "e", 2) -DEFTREECODE (DO_STMT, "do_stmt", "e", 2) -DEFTREECODE (RETURN_STMT, "return_stmt", "e", 1) -DEFTREECODE (BREAK_STMT, "break_stmt", "e", 0) -DEFTREECODE (CONTINUE_STMT, "continue_stmt", "e", 0) -DEFTREECODE (SWITCH_STMT, "switch_stmt", "e", 2) -DEFTREECODE (GOTO_STMT, "goto_stmt", "e", 1) - -DEFTREECODE (CTOR_INITIALIZER, "ctor_initializer", "e", 2) -DEFTREECODE (CASE_LABEL, "case_label", "e", 2) + This is not an alias, but is later expanded into multiple aliases. + The decl will have a NULL_TYPE iff the scope is a dependent scope, + otherwise it will have a void type. */ +DEFTREECODE (USING_DECL, "using_decl", 'd', 0) + +/* A using directive. The operand is USING_STMT_NAMESPACE. */ +DEFTREECODE (USING_STMT, "using_directive", 'e', 1) + +/* An un-parsed default argument. Looks like an IDENTIFIER_NODE. */ +DEFTREECODE (DEFAULT_ARG, "default_arg", 'x', 0) + +/* A template-id, like foo. The first operand is the template. + The second is NULL if there are no explicit arguments, or a + TREE_VEC of arguments. The template will be a FUNCTION_DECL, + TEMPLATE_DECL, or an OVERLOAD. If the template-id refers to a + member template, the template may be an IDENTIFIER_NODE. */ +DEFTREECODE (TEMPLATE_ID_EXPR, "template_id_expr", 'e', 2) + +/* A list-like node for chaining overloading candidates. TREE_TYPE is + the original name, and the parameter is the FUNCTION_DECL. */ +DEFTREECODE (OVERLOAD, "overload", 'x', 0) + +/* A whole bunch of tree codes for the initial, superficial parsing of + templates. */ +DEFTREECODE (MODOP_EXPR, "modop_expr", 'e', 3) +DEFTREECODE (CAST_EXPR, "cast_expr", '1', 1) +DEFTREECODE (REINTERPRET_CAST_EXPR, "reinterpret_cast_expr", '1', 1) +DEFTREECODE (CONST_CAST_EXPR, "const_cast_expr", '1', 1) +DEFTREECODE (STATIC_CAST_EXPR, "static_cast_expr", '1', 1) +DEFTREECODE (DYNAMIC_CAST_EXPR, "dynamic_cast_expr", '1', 1) +DEFTREECODE (DOTSTAR_EXPR, "dotstar_expr", 'e', 2) +DEFTREECODE (TYPEID_EXPR, "typeid_expr", 'e', 1) +DEFTREECODE (PSEUDO_DTOR_EXPR, "pseudo_dtor_expr", 'e', 3) + +/* A placeholder for an expression that is not type-dependent, but + does occur in a template. When an expression that is not + type-dependent appears in a larger expression, we must compute the + type of that larger expression. That computation would normally + modify the original expression, which would change the mangling of + that expression if it appeared in a template argument list. In + that situation, we create a NON_DEPENDENT_EXPR to take the place of + the original expression. The expression is the only operand -- it + is only needed for diagnostics. */ +DEFTREECODE (NON_DEPENDENT_EXPR, "non_dependent_expr", 'e', 1) + +/* CTOR_INITIALIZER is a placeholder in template code for a call to + setup_vtbl_pointer (and appears in all functions, not just ctors). */ +DEFTREECODE (CTOR_INITIALIZER, "ctor_initializer", 'e', 1) + +DEFTREECODE (TRY_BLOCK, "try_block", 'e', 2) + +DEFTREECODE (EH_SPEC_BLOCK, "eh_spec_block", 'e', 2) + +/* A HANDLER wraps a catch handler for the HANDLER_TYPE. If this is + CATCH_ALL_TYPE, then the handler catches all types. The declaration of + the catch variable is in HANDLER_PARMS, and the body block in + HANDLER_BODY. */ +DEFTREECODE (HANDLER, "handler", 'e', 2) + +/* A MUST_NOT_THROW_EXPR wraps an expression that may not + throw, and must call terminate if it does. */ +DEFTREECODE (MUST_NOT_THROW_EXPR, "must_not_throw_expr", 'e', 1) + +/* A CLEANUP_STMT marks the point at which a declaration is fully + constructed. The CLEANUP_EXPR is run on behalf of CLEANUP_DECL + when CLEANUP_BODY completes. */ +DEFTREECODE (CLEANUP_STMT, "cleanup_stmt", 'e', 3) + +/* Represents an 'if' statement. The operands are IF_COND, + THEN_CLAUSE, and ELSE_CLAUSE, respectively. */ +/* ??? It is currently still necessary to distinguish between IF_STMT + and COND_EXPR for the benefit of templates. */ +DEFTREECODE (IF_STMT, "if_stmt", 'e', 3) + +DEFTREECODE (TAG_DEFN, "tag_defn", 'e', 0) + +/* Template instantiation level node. + + TINST_DECL contains the original DECL node. + TINST_LOCATION contains the location where the template is instantiated. + + A stack of template instantiation nodes is kept through the TREE_CHAIN + fields of these nodes. */ + +DEFTREECODE (TINST_LEVEL, "TINST_LEVEL", 'x', 0) + +/* Represents an 'offsetof' expression during template expansion. */ +DEFTREECODE (OFFSETOF_EXPR, "offsetof_expr", 'e', 1) + +/* +Local variables: +mode:c +End: +*/