1 /* Name mangling for the 3.0 C++ ABI.
2 Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2007, 2008, 2009
3 Free Software Foundation, Inc.
4 Written by Alex Samuel <samuel@codesourcery.com>
6 This file is part of GCC.
8 GCC is free software; you can redistribute it and/or modify it
9 under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3, or (at your option)
13 GCC is distributed in the hope that it will be useful, but
14 WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GCC; see the file COPYING3. If not see
20 <http://www.gnu.org/licenses/>. */
22 /* This file implements mangling of C++ names according to the IA64
23 C++ ABI specification. A mangled name encodes a function or
24 variable's name, scope, type, and/or template arguments into a text
25 identifier. This identifier is used as the function's or
26 variable's linkage name, to preserve compatibility between C++'s
27 language features (templates, scoping, and overloading) and C
30 Additionally, g++ uses mangled names internally. To support this,
31 mangling of types is allowed, even though the mangled name of a
32 type should not appear by itself as an exported name. Ditto for
33 uninstantiated templates.
35 The primary entry point for this module is mangle_decl, which
36 returns an identifier containing the mangled name for a decl.
37 Additional entry points are provided to build mangled names of
38 particular constructs when the appropriate decl for that construct
39 is not available. These are:
41 mangle_typeinfo_for_type: typeinfo data
42 mangle_typeinfo_string_for_type: typeinfo type name
43 mangle_vtbl_for_type: virtual table data
44 mangle_vtt_for_type: VTT data
45 mangle_ctor_vtbl_for_type: `C-in-B' constructor virtual table data
46 mangle_thunk: thunk function or entry */
50 #include "coretypes.h"
62 /* Debugging support. */
64 /* Define DEBUG_MANGLE to enable very verbose trace messages. */
66 #define DEBUG_MANGLE 0
69 /* Macros for tracing the write_* functions. */
71 # define MANGLE_TRACE(FN, INPUT) \
72 fprintf (stderr, " %-24s: %-24s\n", (FN), (INPUT))
73 # define MANGLE_TRACE_TREE(FN, NODE) \
74 fprintf (stderr, " %-24s: %-24s (%p)\n", \
75 (FN), tree_code_name[TREE_CODE (NODE)], (void *) (NODE))
77 # define MANGLE_TRACE(FN, INPUT)
78 # define MANGLE_TRACE_TREE(FN, NODE)
81 /* Nonzero if NODE is a class template-id. We can't rely on
82 CLASSTYPE_USE_TEMPLATE here because of tricky bugs in the parser
83 that hard to distinguish A<T> from A, where A<T> is the type as
84 instantiated outside of the template, and A is the type used
85 without parameters inside the template. */
86 #define CLASSTYPE_TEMPLATE_ID_P(NODE) \
87 (TYPE_LANG_SPECIFIC (NODE) != NULL \
88 && (TREE_CODE (NODE) == BOUND_TEMPLATE_TEMPLATE_PARM \
89 || (CLASSTYPE_TEMPLATE_INFO (NODE) != NULL \
90 && (PRIMARY_TEMPLATE_P (CLASSTYPE_TI_TEMPLATE (NODE))))))
92 /* Things we only need one of. This module is not reentrant. */
93 typedef struct globals GTY(())
95 /* An array of the current substitution candidates, in the order
97 VEC(tree,gc) *substitutions;
99 /* The entity that is being mangled. */
100 tree GTY ((skip)) entity;
102 /* True if the mangling will be different in a future version of the
104 bool need_abi_warning;
107 static GTY (()) globals G;
109 /* The obstack on which we build mangled names. */
110 static struct obstack *mangle_obstack;
112 /* The obstack on which we build mangled names that are not going to
113 be IDENTIFIER_NODEs. */
114 static struct obstack name_obstack;
116 /* The first object on the name_obstack; we use this to free memory
117 allocated on the name_obstack. */
118 static void *name_base;
120 /* Indices into subst_identifiers. These are identifiers used in
121 special substitution rules. */
129 SUBID_BASIC_IOSTREAM,
132 substitution_identifier_index_t;
134 /* For quick substitution checks, look up these common identifiers
136 static GTY(()) tree subst_identifiers[SUBID_MAX];
138 /* Single-letter codes for builtin integer types, defined in
139 <builtin-type>. These are indexed by integer_type_kind values. */
141 integer_type_codes[itk_none] =
144 'a', /* itk_signed_char */
145 'h', /* itk_unsigned_char */
147 't', /* itk_unsigned_short */
149 'j', /* itk_unsigned_int */
151 'm', /* itk_unsigned_long */
152 'x', /* itk_long_long */
153 'y' /* itk_unsigned_long_long */
156 static int decl_is_template_id (const tree, tree* const);
158 /* Functions for handling substitutions. */
160 static inline tree canonicalize_for_substitution (tree);
161 static void add_substitution (tree);
162 static inline int is_std_substitution (const tree,
163 const substitution_identifier_index_t);
164 static inline int is_std_substitution_char (const tree,
165 const substitution_identifier_index_t);
166 static int find_substitution (tree);
167 static void mangle_call_offset (const tree, const tree);
169 /* Functions for emitting mangled representations of things. */
171 static void write_mangled_name (const tree, bool);
172 static void write_encoding (const tree);
173 static void write_name (tree, const int);
174 static void write_unscoped_name (const tree);
175 static void write_unscoped_template_name (const tree);
176 static void write_nested_name (const tree);
177 static void write_prefix (const tree);
178 static void write_template_prefix (const tree);
179 static void write_unqualified_name (const tree);
180 static void write_conversion_operator_name (const tree);
181 static void write_source_name (tree);
182 static int hwint_to_ascii (unsigned HOST_WIDE_INT, const unsigned int, char *,
184 static void write_number (unsigned HOST_WIDE_INT, const int,
186 static void write_integer_cst (const tree);
187 static void write_real_cst (const tree);
188 static void write_identifier (const char *);
189 static void write_special_name_constructor (const tree);
190 static void write_special_name_destructor (const tree);
191 static void write_type (tree);
192 static int write_CV_qualifiers_for_type (const tree);
193 static void write_builtin_type (tree);
194 static void write_function_type (const tree);
195 static void write_bare_function_type (const tree, const int, const tree);
196 static void write_method_parms (tree, const int, const tree);
197 static void write_class_enum_type (const tree);
198 static void write_template_args (tree);
199 static void write_expression (tree);
200 static void write_template_arg_literal (const tree);
201 static void write_template_arg (tree);
202 static void write_template_template_arg (const tree);
203 static void write_array_type (const tree);
204 static void write_pointer_to_member_type (const tree);
205 static void write_template_param (const tree);
206 static void write_template_template_param (const tree);
207 static void write_substitution (const int);
208 static int discriminator_for_local_entity (tree);
209 static int discriminator_for_string_literal (tree, tree);
210 static void write_discriminator (const int);
211 static void write_local_name (const tree, const tree, const tree);
212 static void dump_substitution_candidates (void);
213 static tree mangle_decl_string (const tree);
215 /* Control functions. */
217 static inline void start_mangling (const tree);
218 static inline const char *finish_mangling (const bool);
219 static tree mangle_special_for_type (const tree, const char *);
221 /* Foreign language functions. */
223 static void write_java_integer_type_codes (const tree);
225 /* Append a single character to the end of the mangled
227 #define write_char(CHAR) \
228 obstack_1grow (mangle_obstack, (CHAR))
230 /* Append a sized buffer to the end of the mangled representation. */
231 #define write_chars(CHAR, LEN) \
232 obstack_grow (mangle_obstack, (CHAR), (LEN))
234 /* Append a NUL-terminated string to the end of the mangled
236 #define write_string(STRING) \
237 obstack_grow (mangle_obstack, (STRING), strlen (STRING))
239 /* Nonzero if NODE1 and NODE2 are both TREE_LIST nodes and have the
240 same purpose (context, which may be a type) and value (template
241 decl). See write_template_prefix for more information on what this
243 #define NESTED_TEMPLATE_MATCH(NODE1, NODE2) \
244 (TREE_CODE (NODE1) == TREE_LIST \
245 && TREE_CODE (NODE2) == TREE_LIST \
246 && ((TYPE_P (TREE_PURPOSE (NODE1)) \
247 && same_type_p (TREE_PURPOSE (NODE1), TREE_PURPOSE (NODE2))) \
248 || TREE_PURPOSE (NODE1) == TREE_PURPOSE (NODE2)) \
249 && TREE_VALUE (NODE1) == TREE_VALUE (NODE2))
251 /* Write out an unsigned quantity in base 10. */
252 #define write_unsigned_number(NUMBER) \
253 write_number ((NUMBER), /*unsigned_p=*/1, 10)
255 /* If DECL is a template instance, return nonzero and, if
256 TEMPLATE_INFO is non-NULL, set *TEMPLATE_INFO to its template info.
257 Otherwise return zero. */
260 decl_is_template_id (const tree decl, tree* const template_info)
262 if (TREE_CODE (decl) == TYPE_DECL)
264 /* TYPE_DECLs are handled specially. Look at its type to decide
265 if this is a template instantiation. */
266 const tree type = TREE_TYPE (decl);
268 if (CLASS_TYPE_P (type) && CLASSTYPE_TEMPLATE_ID_P (type))
270 if (template_info != NULL)
271 /* For a templated TYPE_DECL, the template info is hanging
273 *template_info = TYPE_TEMPLATE_INFO (type);
279 /* Check if this is a primary template. */
280 if (DECL_LANG_SPECIFIC (decl) != NULL
281 && DECL_USE_TEMPLATE (decl)
282 && PRIMARY_TEMPLATE_P (DECL_TI_TEMPLATE (decl))
283 && TREE_CODE (decl) != TEMPLATE_DECL)
285 if (template_info != NULL)
286 /* For most templated decls, the template info is hanging
288 *template_info = DECL_TEMPLATE_INFO (decl);
293 /* It's not a template id. */
297 /* Produce debugging output of current substitution candidates. */
300 dump_substitution_candidates (void)
305 fprintf (stderr, " ++ substitutions ");
306 for (i = 0; VEC_iterate (tree, G.substitutions, i, el); ++i)
308 const char *name = "???";
311 fprintf (stderr, " ");
313 name = IDENTIFIER_POINTER (DECL_NAME (el));
314 else if (TREE_CODE (el) == TREE_LIST)
315 name = IDENTIFIER_POINTER (DECL_NAME (TREE_VALUE (el)));
316 else if (TYPE_NAME (el))
317 name = IDENTIFIER_POINTER (DECL_NAME (TYPE_NAME (el)));
318 fprintf (stderr, " S%d_ = ", i - 1);
320 (CP_TYPE_RESTRICT_P (el)
321 || CP_TYPE_VOLATILE_P (el)
322 || CP_TYPE_CONST_P (el)))
323 fprintf (stderr, "CV-");
324 fprintf (stderr, "%s (%s at %p)\n",
325 name, tree_code_name[TREE_CODE (el)], (void *) el);
329 /* Both decls and types can be substitution candidates, but sometimes
330 they refer to the same thing. For instance, a TYPE_DECL and
331 RECORD_TYPE for the same class refer to the same thing, and should
332 be treated accordingly in substitutions. This function returns a
333 canonicalized tree node representing NODE that is used when adding
334 and substitution candidates and finding matches. */
337 canonicalize_for_substitution (tree node)
339 /* For a TYPE_DECL, use the type instead. */
340 if (TREE_CODE (node) == TYPE_DECL)
341 node = TREE_TYPE (node);
343 node = canonical_type_variant (node);
348 /* Add NODE as a substitution candidate. NODE must not already be on
349 the list of candidates. */
352 add_substitution (tree node)
357 fprintf (stderr, " ++ add_substitution (%s at %10p)\n",
358 tree_code_name[TREE_CODE (node)], (void *) node);
360 /* Get the canonicalized substitution candidate for NODE. */
361 c = canonicalize_for_substitution (node);
362 if (DEBUG_MANGLE && c != node)
363 fprintf (stderr, " ++ using candidate (%s at %10p)\n",
364 tree_code_name[TREE_CODE (node)], (void *) node);
368 /* Make sure NODE isn't already a candidate. */
373 for (i = 0; VEC_iterate (tree, G.substitutions, i, candidate); i++)
375 gcc_assert (!(DECL_P (node) && node == candidate));
376 gcc_assert (!(TYPE_P (node) && TYPE_P (candidate)
377 && same_type_p (node, candidate)));
380 #endif /* ENABLE_CHECKING */
382 /* Put the decl onto the varray of substitution candidates. */
383 VEC_safe_push (tree, gc, G.substitutions, node);
386 dump_substitution_candidates ();
389 /* Helper function for find_substitution. Returns nonzero if NODE,
390 which may be a decl or a CLASS_TYPE, is a template-id with template
391 name of substitution_index[INDEX] in the ::std namespace. */
394 is_std_substitution (const tree node,
395 const substitution_identifier_index_t index)
402 type = TREE_TYPE (node);
405 else if (CLASS_TYPE_P (node))
408 decl = TYPE_NAME (node);
411 /* These are not the droids you're looking for. */
414 return (DECL_NAMESPACE_STD_P (CP_DECL_CONTEXT (decl))
415 && TYPE_LANG_SPECIFIC (type)
416 && TYPE_TEMPLATE_INFO (type)
417 && (DECL_NAME (TYPE_TI_TEMPLATE (type))
418 == subst_identifiers[index]));
421 /* Helper function for find_substitution. Returns nonzero if NODE,
422 which may be a decl or a CLASS_TYPE, is the template-id
423 ::std::identifier<char>, where identifier is
424 substitution_index[INDEX]. */
427 is_std_substitution_char (const tree node,
428 const substitution_identifier_index_t index)
431 /* Check NODE's name is ::std::identifier. */
432 if (!is_std_substitution (node, index))
434 /* Figure out its template args. */
436 args = DECL_TI_ARGS (node);
437 else if (CLASS_TYPE_P (node))
438 args = CLASSTYPE_TI_ARGS (node);
440 /* Oops, not a template. */
442 /* NODE's template arg list should be <char>. */
444 TREE_VEC_LENGTH (args) == 1
445 && TREE_VEC_ELT (args, 0) == char_type_node;
448 /* Check whether a substitution should be used to represent NODE in
451 First, check standard special-case substitutions.
453 <substitution> ::= St
460 # ::std::basic_string
463 # ::std::basic_string<char,
464 ::std::char_traits<char>,
465 ::std::allocator<char> >
468 # ::std::basic_istream<char, ::std::char_traits<char> >
471 # ::std::basic_ostream<char, ::std::char_traits<char> >
474 # ::std::basic_iostream<char, ::std::char_traits<char> >
476 Then examine the stack of currently available substitution
477 candidates for entities appearing earlier in the same mangling
479 If a substitution is found, write its mangled representation and
480 return nonzero. If none is found, just return zero. */
483 find_substitution (tree node)
486 const int size = VEC_length (tree, G.substitutions);
491 fprintf (stderr, " ++ find_substitution (%s at %p)\n",
492 tree_code_name[TREE_CODE (node)], (void *) node);
494 /* Obtain the canonicalized substitution representation for NODE.
495 This is what we'll compare against. */
496 node = canonicalize_for_substitution (node);
498 /* Check for builtin substitutions. */
500 decl = TYPE_P (node) ? TYPE_NAME (node) : node;
501 type = TYPE_P (node) ? node : TREE_TYPE (node);
503 /* Check for std::allocator. */
505 && is_std_substitution (decl, SUBID_ALLOCATOR)
506 && !CLASSTYPE_USE_TEMPLATE (TREE_TYPE (decl)))
512 /* Check for std::basic_string. */
513 if (decl && is_std_substitution (decl, SUBID_BASIC_STRING))
517 /* If this is a type (i.e. a fully-qualified template-id),
519 std::basic_string <char,
520 std::char_traits<char>,
521 std::allocator<char> > . */
522 if (cp_type_quals (type) == TYPE_UNQUALIFIED
523 && CLASSTYPE_USE_TEMPLATE (type))
525 tree args = CLASSTYPE_TI_ARGS (type);
526 if (TREE_VEC_LENGTH (args) == 3
527 && same_type_p (TREE_VEC_ELT (args, 0), char_type_node)
528 && is_std_substitution_char (TREE_VEC_ELT (args, 1),
530 && is_std_substitution_char (TREE_VEC_ELT (args, 2),
539 /* Substitute for the template name only if this isn't a type. */
546 /* Check for basic_{i,o,io}stream. */
548 && cp_type_quals (type) == TYPE_UNQUALIFIED
549 && CLASS_TYPE_P (type)
550 && CLASSTYPE_USE_TEMPLATE (type)
551 && CLASSTYPE_TEMPLATE_INFO (type) != NULL)
553 /* First, check for the template
554 args <char, std::char_traits<char> > . */
555 tree args = CLASSTYPE_TI_ARGS (type);
556 if (TREE_VEC_LENGTH (args) == 2
557 && TYPE_P (TREE_VEC_ELT (args, 0))
558 && same_type_p (TREE_VEC_ELT (args, 0), char_type_node)
559 && is_std_substitution_char (TREE_VEC_ELT (args, 1),
562 /* Got them. Is this basic_istream? */
563 if (is_std_substitution (decl, SUBID_BASIC_ISTREAM))
568 /* Or basic_ostream? */
569 else if (is_std_substitution (decl, SUBID_BASIC_OSTREAM))
574 /* Or basic_iostream? */
575 else if (is_std_substitution (decl, SUBID_BASIC_IOSTREAM))
583 /* Check for namespace std. */
584 if (decl && DECL_NAMESPACE_STD_P (decl))
590 /* Now check the list of available substitutions for this mangling
592 for (i = 0; i < size; ++i)
594 tree candidate = VEC_index (tree, G.substitutions, i);
595 /* NODE is a matched to a candidate if it's the same decl node or
596 if it's the same type. */
597 if (decl == candidate
598 || (TYPE_P (candidate) && type && TYPE_P (type)
599 && same_type_p (type, candidate))
600 || NESTED_TEMPLATE_MATCH (node, candidate))
602 write_substitution (i);
607 /* No substitution found. */
612 /* TOP_LEVEL is true, if this is being called at outermost level of
613 mangling. It should be false when mangling a decl appearing in an
614 expression within some other mangling.
616 <mangled-name> ::= _Z <encoding> */
619 write_mangled_name (const tree decl, bool top_level)
621 MANGLE_TRACE_TREE ("mangled-name", decl);
623 if (/* The names of `extern "C"' functions are not mangled. */
624 DECL_EXTERN_C_FUNCTION_P (decl)
625 /* But overloaded operator names *are* mangled. */
626 && !DECL_OVERLOADED_OPERATOR_P (decl))
631 write_string (IDENTIFIER_POINTER (DECL_NAME (decl)));
634 /* The standard notes: "The <encoding> of an extern "C"
635 function is treated like global-scope data, i.e. as its
636 <source-name> without a type." We cannot write
637 overloaded operators that way though, because it contains
638 characters invalid in assembler. */
639 if (abi_version_at_least (2))
642 G.need_abi_warning = true;
643 write_source_name (DECL_NAME (decl));
646 else if (TREE_CODE (decl) == VAR_DECL
647 /* The names of non-static global variables aren't mangled. */
648 && DECL_EXTERNAL_LINKAGE_P (decl)
649 && (CP_DECL_CONTEXT (decl) == global_namespace
650 /* And neither are `extern "C"' variables. */
651 || DECL_EXTERN_C_P (decl)))
653 if (top_level || abi_version_at_least (2))
657 G.need_abi_warning = true;
665 write_encoding (decl);
666 if (DECL_LANG_SPECIFIC (decl)
667 && (DECL_MAYBE_IN_CHARGE_DESTRUCTOR_P (decl)
668 || DECL_MAYBE_IN_CHARGE_CONSTRUCTOR_P (decl)))
669 /* We need a distinct mangled name for these entities, but
670 we should never actually output it. So, we append some
671 characters the assembler won't like. */
672 write_string (" *INTERNAL* ");
676 /* <encoding> ::= <function name> <bare-function-type>
680 write_encoding (const tree decl)
682 MANGLE_TRACE_TREE ("encoding", decl);
684 if (DECL_LANG_SPECIFIC (decl) && DECL_EXTERN_C_FUNCTION_P (decl))
686 /* For overloaded operators write just the mangled name
687 without arguments. */
688 if (DECL_OVERLOADED_OPERATOR_P (decl))
689 write_name (decl, /*ignore_local_scope=*/0);
691 write_source_name (DECL_NAME (decl));
695 write_name (decl, /*ignore_local_scope=*/0);
696 if (TREE_CODE (decl) == FUNCTION_DECL)
701 if (decl_is_template_id (decl, NULL))
703 fn_type = get_mostly_instantiated_function_type (decl);
704 /* FN_TYPE will not have parameter types for in-charge or
705 VTT parameters. Therefore, we pass NULL_TREE to
706 write_bare_function_type -- otherwise, it will get
707 confused about which artificial parameters to skip. */
712 fn_type = TREE_TYPE (decl);
716 write_bare_function_type (fn_type,
717 (!DECL_CONSTRUCTOR_P (decl)
718 && !DECL_DESTRUCTOR_P (decl)
719 && !DECL_CONV_FN_P (decl)
720 && decl_is_template_id (decl, NULL)),
725 /* <name> ::= <unscoped-name>
726 ::= <unscoped-template-name> <template-args>
730 If IGNORE_LOCAL_SCOPE is nonzero, this production of <name> is
731 called from <local-name>, which mangles the enclosing scope
732 elsewhere and then uses this function to mangle just the part
733 underneath the function scope. So don't use the <local-name>
734 production, to avoid an infinite recursion. */
737 write_name (tree decl, const int ignore_local_scope)
741 MANGLE_TRACE_TREE ("name", decl);
743 if (TREE_CODE (decl) == TYPE_DECL)
745 /* In case this is a typedef, fish out the corresponding
746 TYPE_DECL for the main variant. */
747 decl = TYPE_NAME (TYPE_MAIN_VARIANT (TREE_TYPE (decl)));
748 context = TYPE_CONTEXT (TYPE_MAIN_VARIANT (TREE_TYPE (decl)));
751 context = (DECL_CONTEXT (decl) == NULL) ? NULL : CP_DECL_CONTEXT (decl);
753 /* A decl in :: or ::std scope is treated specially. The former is
754 mangled using <unscoped-name> or <unscoped-template-name>, the
755 latter with a special substitution. Also, a name that is
756 directly in a local function scope is also mangled with
757 <unscoped-name> rather than a full <nested-name>. */
759 || context == global_namespace
760 || DECL_NAMESPACE_STD_P (context)
761 || (ignore_local_scope && TREE_CODE (context) == FUNCTION_DECL))
764 /* Is this a template instance? */
765 if (decl_is_template_id (decl, &template_info))
767 /* Yes: use <unscoped-template-name>. */
768 write_unscoped_template_name (TI_TEMPLATE (template_info));
769 write_template_args (TI_ARGS (template_info));
772 /* Everything else gets an <unqualified-name>. */
773 write_unscoped_name (decl);
777 /* Handle local names, unless we asked not to (that is, invoked
778 under <local-name>, to handle only the part of the name under
780 if (!ignore_local_scope)
782 /* Scan up the list of scope context, looking for a
783 function. If we find one, this entity is in local
784 function scope. local_entity tracks context one scope
785 level down, so it will contain the element that's
786 directly in that function's scope, either decl or one of
787 its enclosing scopes. */
788 tree local_entity = decl;
789 while (context != NULL && context != global_namespace)
791 /* Make sure we're always dealing with decls. */
792 if (context != NULL && TYPE_P (context))
793 context = TYPE_NAME (context);
794 /* Is this a function? */
795 if (TREE_CODE (context) == FUNCTION_DECL)
797 /* Yes, we have local scope. Use the <local-name>
798 production for the innermost function scope. */
799 write_local_name (context, local_entity, decl);
802 /* Up one scope level. */
803 local_entity = context;
804 context = CP_DECL_CONTEXT (context);
807 /* No local scope found? Fall through to <nested-name>. */
810 /* Other decls get a <nested-name> to encode their scope. */
811 write_nested_name (decl);
815 /* <unscoped-name> ::= <unqualified-name>
816 ::= St <unqualified-name> # ::std:: */
819 write_unscoped_name (const tree decl)
821 tree context = CP_DECL_CONTEXT (decl);
823 MANGLE_TRACE_TREE ("unscoped-name", decl);
825 /* Is DECL in ::std? */
826 if (DECL_NAMESPACE_STD_P (context))
829 write_unqualified_name (decl);
833 /* If not, it should be either in the global namespace, or directly
834 in a local function scope. */
835 gcc_assert (context == global_namespace
837 || TREE_CODE (context) == FUNCTION_DECL);
839 write_unqualified_name (decl);
843 /* <unscoped-template-name> ::= <unscoped-name>
844 ::= <substitution> */
847 write_unscoped_template_name (const tree decl)
849 MANGLE_TRACE_TREE ("unscoped-template-name", decl);
851 if (find_substitution (decl))
853 write_unscoped_name (decl);
854 add_substitution (decl);
857 /* Write the nested name, including CV-qualifiers, of DECL.
859 <nested-name> ::= N [<CV-qualifiers>] <prefix> <unqualified-name> E
860 ::= N [<CV-qualifiers>] <template-prefix> <template-args> E
862 <CV-qualifiers> ::= [r] [V] [K] */
865 write_nested_name (const tree decl)
869 MANGLE_TRACE_TREE ("nested-name", decl);
873 /* Write CV-qualifiers, if this is a member function. */
874 if (TREE_CODE (decl) == FUNCTION_DECL
875 && DECL_NONSTATIC_MEMBER_FUNCTION_P (decl))
877 if (DECL_VOLATILE_MEMFUNC_P (decl))
879 if (DECL_CONST_MEMFUNC_P (decl))
883 /* Is this a template instance? */
884 if (decl_is_template_id (decl, &template_info))
886 /* Yes, use <template-prefix>. */
887 write_template_prefix (decl);
888 write_template_args (TI_ARGS (template_info));
890 else if (TREE_CODE (TREE_TYPE (decl)) == TYPENAME_TYPE)
892 tree name = TYPENAME_TYPE_FULLNAME (TREE_TYPE (decl));
893 if (TREE_CODE (name) == TEMPLATE_ID_EXPR)
895 write_template_prefix (decl);
896 write_template_args (TREE_OPERAND (name, 1));
900 write_prefix (CP_DECL_CONTEXT (decl));
901 write_unqualified_name (decl);
906 /* No, just use <prefix> */
907 write_prefix (DECL_CONTEXT (decl));
908 write_unqualified_name (decl);
913 /* <prefix> ::= <prefix> <unqualified-name>
915 ::= <template-prefix> <template-args>
917 ::= <substitution> */
920 write_prefix (const tree node)
923 /* Non-NULL if NODE represents a template-id. */
924 tree template_info = NULL;
926 MANGLE_TRACE_TREE ("prefix", node);
929 || node == global_namespace)
932 if (find_substitution (node))
937 /* If this is a function decl, that means we've hit function
938 scope, so this prefix must be for a local name. In this
939 case, we're under the <local-name> production, which encodes
940 the enclosing function scope elsewhere. So don't continue
942 if (TREE_CODE (node) == FUNCTION_DECL)
946 decl_is_template_id (decl, &template_info);
950 /* Node is a type. */
951 decl = TYPE_NAME (node);
952 if (CLASSTYPE_TEMPLATE_ID_P (node))
953 template_info = TYPE_TEMPLATE_INFO (node);
956 /* In G++ 3.2, the name of the template parameter was used. */
957 if (TREE_CODE (node) == TEMPLATE_TYPE_PARM
958 && !abi_version_at_least (2))
959 G.need_abi_warning = true;
961 if (TREE_CODE (node) == TEMPLATE_TYPE_PARM
962 && abi_version_at_least (2))
963 write_template_param (node);
964 else if (template_info != NULL)
967 write_template_prefix (decl);
968 write_template_args (TI_ARGS (template_info));
970 else if (TREE_CODE (TREE_TYPE (decl)) == TYPENAME_TYPE)
972 tree name = TYPENAME_TYPE_FULLNAME (TREE_TYPE (decl));
973 if (TREE_CODE (name) == TEMPLATE_ID_EXPR)
975 write_template_prefix (decl);
976 write_template_args (TREE_OPERAND (name, 1));
980 write_prefix (CP_DECL_CONTEXT (decl));
981 write_unqualified_name (decl);
987 write_prefix (CP_DECL_CONTEXT (decl));
988 write_unqualified_name (decl);
991 add_substitution (node);
994 /* <template-prefix> ::= <prefix> <template component>
996 ::= <substitution> */
999 write_template_prefix (const tree node)
1001 tree decl = DECL_P (node) ? node : TYPE_NAME (node);
1002 tree type = DECL_P (node) ? TREE_TYPE (node) : node;
1003 tree context = CP_DECL_CONTEXT (decl);
1008 MANGLE_TRACE_TREE ("template-prefix", node);
1010 /* Find the template decl. */
1011 if (decl_is_template_id (decl, &template_info))
1012 templ = TI_TEMPLATE (template_info);
1013 else if (TREE_CODE (type) == TYPENAME_TYPE)
1014 /* For a typename type, all we have is the name. */
1015 templ = DECL_NAME (decl);
1018 gcc_assert (CLASSTYPE_TEMPLATE_ID_P (type));
1020 templ = TYPE_TI_TEMPLATE (type);
1023 /* For a member template, though, the template name for the
1024 innermost name must have all the outer template levels
1025 instantiated. For instance, consider
1027 template<typename T> struct Outer {
1028 template<typename U> struct Inner {};
1031 The template name for `Inner' in `Outer<int>::Inner<float>' is
1032 `Outer<int>::Inner<U>'. In g++, we don't instantiate the template
1033 levels separately, so there's no TEMPLATE_DECL available for this
1034 (there's only `Outer<T>::Inner<U>').
1036 In order to get the substitutions right, we create a special
1037 TREE_LIST to represent the substitution candidate for a nested
1038 template. The TREE_PURPOSE is the template's context, fully
1039 instantiated, and the TREE_VALUE is the TEMPLATE_DECL for the inner
1042 So, for the example above, `Outer<int>::Inner' is represented as a
1043 substitution candidate by a TREE_LIST whose purpose is `Outer<int>'
1044 and whose value is `Outer<T>::Inner<U>'. */
1045 if (TYPE_P (context))
1046 substitution = build_tree_list (context, templ);
1048 substitution = templ;
1050 if (find_substitution (substitution))
1053 /* In G++ 3.2, the name of the template template parameter was used. */
1054 if (TREE_TYPE (templ)
1055 && TREE_CODE (TREE_TYPE (templ)) == TEMPLATE_TEMPLATE_PARM
1056 && !abi_version_at_least (2))
1057 G.need_abi_warning = true;
1059 if (TREE_TYPE (templ)
1060 && TREE_CODE (TREE_TYPE (templ)) == TEMPLATE_TEMPLATE_PARM
1061 && abi_version_at_least (2))
1062 write_template_param (TREE_TYPE (templ));
1065 write_prefix (context);
1066 write_unqualified_name (decl);
1069 add_substitution (substitution);
1072 /* We don't need to handle thunks, vtables, or VTTs here. Those are
1073 mangled through special entry points.
1075 <unqualified-name> ::= <operator-name>
1078 ::= <local-source-name>
1080 <local-source-name> ::= L <source-name> <discriminator> */
1083 write_unqualified_name (const tree decl)
1085 MANGLE_TRACE_TREE ("unqualified-name", decl);
1087 if (DECL_LANG_SPECIFIC (decl) != NULL && DECL_CONSTRUCTOR_P (decl))
1088 write_special_name_constructor (decl);
1089 else if (DECL_LANG_SPECIFIC (decl) != NULL && DECL_DESTRUCTOR_P (decl))
1090 write_special_name_destructor (decl);
1091 else if (DECL_NAME (decl) == NULL_TREE)
1093 gcc_assert (DECL_ASSEMBLER_NAME_SET_P (decl));
1094 write_source_name (DECL_ASSEMBLER_NAME (decl));
1096 else if (DECL_CONV_FN_P (decl))
1098 /* Conversion operator. Handle it right here.
1099 <operator> ::= cv <type> */
1101 if (decl_is_template_id (decl, NULL))
1104 fn_type = get_mostly_instantiated_function_type (decl);
1105 type = TREE_TYPE (fn_type);
1108 type = DECL_CONV_FN_TYPE (decl);
1109 write_conversion_operator_name (type);
1111 else if (DECL_OVERLOADED_OPERATOR_P (decl))
1113 operator_name_info_t *oni;
1114 if (DECL_ASSIGNMENT_OPERATOR_P (decl))
1115 oni = assignment_operator_name_info;
1117 oni = operator_name_info;
1119 write_string (oni[DECL_OVERLOADED_OPERATOR_P (decl)].mangled_name);
1121 else if (VAR_OR_FUNCTION_DECL_P (decl) && ! TREE_PUBLIC (decl)
1122 && DECL_NAMESPACE_SCOPE_P (decl)
1123 && decl_linkage (decl) == lk_internal)
1125 MANGLE_TRACE_TREE ("local-source-name", decl);
1127 write_source_name (DECL_NAME (decl));
1128 /* The default discriminator is 1, and that's all we ever use,
1129 so there's no code to output one here. */
1132 write_source_name (DECL_NAME (decl));
1135 /* Write the unqualified-name for a conversion operator to TYPE. */
1138 write_conversion_operator_name (const tree type)
1140 write_string ("cv");
1144 /* Non-terminal <source-name>. IDENTIFIER is an IDENTIFIER_NODE.
1146 <source-name> ::= </length/ number> <identifier> */
1149 write_source_name (tree identifier)
1151 MANGLE_TRACE_TREE ("source-name", identifier);
1153 /* Never write the whole template-id name including the template
1154 arguments; we only want the template name. */
1155 if (IDENTIFIER_TEMPLATE (identifier))
1156 identifier = IDENTIFIER_TEMPLATE (identifier);
1158 write_unsigned_number (IDENTIFIER_LENGTH (identifier));
1159 write_identifier (IDENTIFIER_POINTER (identifier));
1162 /* Convert NUMBER to ascii using base BASE and generating at least
1163 MIN_DIGITS characters. BUFFER points to the _end_ of the buffer
1164 into which to store the characters. Returns the number of
1165 characters generated (these will be layed out in advance of where
1169 hwint_to_ascii (unsigned HOST_WIDE_INT number, const unsigned int base,
1170 char *buffer, const unsigned int min_digits)
1172 static const char base_digits[] = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ";
1173 unsigned digits = 0;
1177 unsigned HOST_WIDE_INT d = number / base;
1179 *--buffer = base_digits[number - d * base];
1183 while (digits < min_digits)
1185 *--buffer = base_digits[0];
1191 /* Non-terminal <number>.
1193 <number> ::= [n] </decimal integer/> */
1196 write_number (unsigned HOST_WIDE_INT number, const int unsigned_p,
1197 const unsigned int base)
1199 char buffer[sizeof (HOST_WIDE_INT) * 8];
1202 if (!unsigned_p && (HOST_WIDE_INT) number < 0)
1205 number = -((HOST_WIDE_INT) number);
1207 count = hwint_to_ascii (number, base, buffer + sizeof (buffer), 1);
1208 write_chars (buffer + sizeof (buffer) - count, count);
1211 /* Write out an integral CST in decimal. Most numbers are small, and
1212 representable in a HOST_WIDE_INT. Occasionally we'll have numbers
1213 bigger than that, which we must deal with. */
1216 write_integer_cst (const tree cst)
1218 int sign = tree_int_cst_sgn (cst);
1220 if (TREE_INT_CST_HIGH (cst) + (sign < 0))
1222 /* A bignum. We do this in chunks, each of which fits in a
1224 char buffer[sizeof (HOST_WIDE_INT) * 8 * 2];
1225 unsigned HOST_WIDE_INT chunk;
1226 unsigned chunk_digits;
1227 char *ptr = buffer + sizeof (buffer);
1232 /* HOST_WIDE_INT must be at least 32 bits, so 10^9 is
1237 if (sizeof (HOST_WIDE_INT) >= 8)
1239 /* It is at least 64 bits, so 10^18 is representable. */
1244 type = c_common_signed_or_unsigned_type (1, TREE_TYPE (cst));
1245 base = build_int_cstu (type, chunk);
1246 n = build_int_cst_wide (type,
1247 TREE_INT_CST_LOW (cst), TREE_INT_CST_HIGH (cst));
1252 n = fold_build1 (NEGATE_EXPR, type, n);
1256 tree d = fold_build2 (FLOOR_DIV_EXPR, type, n, base);
1257 tree tmp = fold_build2 (MULT_EXPR, type, d, base);
1260 done = integer_zerop (d);
1261 tmp = fold_build2 (MINUS_EXPR, type, n, tmp);
1262 c = hwint_to_ascii (TREE_INT_CST_LOW (tmp), 10, ptr,
1263 done ? 1 : chunk_digits);
1269 write_chars (ptr, count);
1274 unsigned HOST_WIDE_INT low = TREE_INT_CST_LOW (cst);
1281 write_unsigned_number (low);
1285 /* Write out a floating-point literal.
1287 "Floating-point literals are encoded using the bit pattern of the
1288 target processor's internal representation of that number, as a
1289 fixed-length lowercase hexadecimal string, high-order bytes first
1290 (even if the target processor would store low-order bytes first).
1291 The "n" prefix is not used for floating-point literals; the sign
1292 bit is encoded with the rest of the number.
1294 Here are some examples, assuming the IEEE standard representation
1295 for floating point numbers. (Spaces are for readability, not
1296 part of the encoding.)
1299 -1.0f Lf bf80 0000 E
1300 1.17549435e-38f Lf 0080 0000 E
1301 1.40129846e-45f Lf 0000 0001 E
1302 0.0f Lf 0000 0000 E"
1304 Caller is responsible for the Lx and the E. */
1306 write_real_cst (const tree value)
1308 if (abi_version_at_least (2))
1310 long target_real[4]; /* largest supported float */
1311 char buffer[9]; /* eight hex digits in a 32-bit number */
1314 tree type = TREE_TYPE (value);
1315 int words = GET_MODE_BITSIZE (TYPE_MODE (type)) / 32;
1317 real_to_target (target_real, &TREE_REAL_CST (value),
1320 /* The value in target_real is in the target word order,
1321 so we must write it out backward if that happens to be
1322 little-endian. write_number cannot be used, it will
1323 produce uppercase. */
1324 if (FLOAT_WORDS_BIG_ENDIAN)
1325 i = 0, limit = words, dir = 1;
1327 i = words - 1, limit = -1, dir = -1;
1329 for (; i != limit; i += dir)
1331 sprintf (buffer, "%08lx", (unsigned long) target_real[i]);
1332 write_chars (buffer, 8);
1337 /* In G++ 3.3 and before the REAL_VALUE_TYPE was written out
1338 literally. Note that compatibility with 3.2 is impossible,
1339 because the old floating-point emulator used a different
1340 format for REAL_VALUE_TYPE. */
1342 for (i = 0; i < sizeof (TREE_REAL_CST (value)); ++i)
1343 write_number (((unsigned char *) &TREE_REAL_CST (value))[i],
1346 G.need_abi_warning = 1;
1350 /* Non-terminal <identifier>.
1352 <identifier> ::= </unqualified source code identifier> */
1355 write_identifier (const char *identifier)
1357 MANGLE_TRACE ("identifier", identifier);
1358 write_string (identifier);
1361 /* Handle constructor productions of non-terminal <special-name>.
1362 CTOR is a constructor FUNCTION_DECL.
1364 <special-name> ::= C1 # complete object constructor
1365 ::= C2 # base object constructor
1366 ::= C3 # complete object allocating constructor
1368 Currently, allocating constructors are never used.
1370 We also need to provide mangled names for the maybe-in-charge
1371 constructor, so we treat it here too. mangle_decl_string will
1372 append *INTERNAL* to that, to make sure we never emit it. */
1375 write_special_name_constructor (const tree ctor)
1377 if (DECL_BASE_CONSTRUCTOR_P (ctor))
1378 write_string ("C2");
1381 gcc_assert (DECL_COMPLETE_CONSTRUCTOR_P (ctor)
1382 /* Even though we don't ever emit a definition of
1383 the old-style destructor, we still have to
1384 consider entities (like static variables) nested
1386 || DECL_MAYBE_IN_CHARGE_CONSTRUCTOR_P (ctor));
1387 write_string ("C1");
1391 /* Handle destructor productions of non-terminal <special-name>.
1392 DTOR is a destructor FUNCTION_DECL.
1394 <special-name> ::= D0 # deleting (in-charge) destructor
1395 ::= D1 # complete object (in-charge) destructor
1396 ::= D2 # base object (not-in-charge) destructor
1398 We also need to provide mangled names for the maybe-incharge
1399 destructor, so we treat it here too. mangle_decl_string will
1400 append *INTERNAL* to that, to make sure we never emit it. */
1403 write_special_name_destructor (const tree dtor)
1405 if (DECL_DELETING_DESTRUCTOR_P (dtor))
1406 write_string ("D0");
1407 else if (DECL_BASE_DESTRUCTOR_P (dtor))
1408 write_string ("D2");
1411 gcc_assert (DECL_COMPLETE_DESTRUCTOR_P (dtor)
1412 /* Even though we don't ever emit a definition of
1413 the old-style destructor, we still have to
1414 consider entities (like static variables) nested
1416 || DECL_MAYBE_IN_CHARGE_DESTRUCTOR_P (dtor));
1417 write_string ("D1");
1421 /* Return the discriminator for ENTITY appearing inside
1422 FUNCTION. The discriminator is the lexical ordinal of VAR among
1423 entities with the same name in the same FUNCTION. */
1426 discriminator_for_local_entity (tree entity)
1428 /* Assume this is the only local entity with this name. */
1429 int discriminator = 0;
1431 if (DECL_DISCRIMINATOR_P (entity) && DECL_LANG_SPECIFIC (entity))
1432 discriminator = DECL_DISCRIMINATOR (entity);
1433 else if (TREE_CODE (entity) == TYPE_DECL)
1437 /* Scan the list of local classes. */
1438 entity = TREE_TYPE (entity);
1439 for (ix = 0; ; ix++)
1441 tree type = VEC_index (tree, local_classes, ix);
1444 if (TYPE_IDENTIFIER (type) == TYPE_IDENTIFIER (entity)
1445 && TYPE_CONTEXT (type) == TYPE_CONTEXT (entity))
1450 return discriminator;
1453 /* Return the discriminator for STRING, a string literal used inside
1454 FUNCTION. The discriminator is the lexical ordinal of STRING among
1455 string literals used in FUNCTION. */
1458 discriminator_for_string_literal (tree function ATTRIBUTE_UNUSED,
1459 tree string ATTRIBUTE_UNUSED)
1461 /* For now, we don't discriminate amongst string literals. */
1465 /* <discriminator> := _ <number>
1467 The discriminator is used only for the second and later occurrences
1468 of the same name within a single function. In this case <number> is
1469 n - 2, if this is the nth occurrence, in lexical order. */
1472 write_discriminator (const int discriminator)
1474 /* If discriminator is zero, don't write anything. Otherwise... */
1475 if (discriminator > 0)
1478 write_unsigned_number (discriminator - 1);
1482 /* Mangle the name of a function-scope entity. FUNCTION is the
1483 FUNCTION_DECL for the enclosing function. ENTITY is the decl for
1484 the entity itself. LOCAL_ENTITY is the entity that's directly
1485 scoped in FUNCTION_DECL, either ENTITY itself or an enclosing scope
1488 <local-name> := Z <function encoding> E <entity name> [<discriminator>]
1489 := Z <function encoding> E s [<discriminator>] */
1492 write_local_name (const tree function, const tree local_entity,
1495 MANGLE_TRACE_TREE ("local-name", entity);
1498 write_encoding (function);
1500 if (TREE_CODE (entity) == STRING_CST)
1503 write_discriminator (discriminator_for_string_literal (function,
1508 /* Now the <entity name>. Let write_name know its being called
1509 from <local-name>, so it doesn't try to process the enclosing
1510 function scope again. */
1511 write_name (entity, /*ignore_local_scope=*/1);
1512 write_discriminator (discriminator_for_local_entity (local_entity));
1516 /* Non-terminals <type> and <CV-qualifier>.
1518 <type> ::= <builtin-type>
1520 ::= <class-enum-type>
1522 ::= <pointer-to-member-type>
1523 ::= <template-param>
1526 ::= P <type> # pointer-to
1527 ::= R <type> # reference-to
1528 ::= C <type> # complex pair (C 2000)
1529 ::= G <type> # imaginary (C 2000) [not supported]
1530 ::= U <source-name> <type> # vendor extended type qualifier
1534 <type> ::= RR <type> # rvalue reference-to
1535 <type> ::= Dt <expression> # decltype of an id-expression or
1536 # class member access
1537 <type> ::= DT <expression> # decltype of an expression
1539 TYPE is a type node. */
1542 write_type (tree type)
1544 /* This gets set to nonzero if TYPE turns out to be a (possibly
1545 CV-qualified) builtin type. */
1546 int is_builtin_type = 0;
1548 MANGLE_TRACE_TREE ("type", type);
1550 if (type == error_mark_node)
1553 if (find_substitution (type))
1556 if (write_CV_qualifiers_for_type (type) > 0)
1557 /* If TYPE was CV-qualified, we just wrote the qualifiers; now
1558 mangle the unqualified type. The recursive call is needed here
1559 since both the qualified and unqualified types are substitution
1561 write_type (TYPE_MAIN_VARIANT (type));
1562 else if (TREE_CODE (type) == ARRAY_TYPE)
1563 /* It is important not to use the TYPE_MAIN_VARIANT of TYPE here
1564 so that the cv-qualification of the element type is available
1565 in write_array_type. */
1566 write_array_type (type);
1569 tree type_orig = type;
1571 /* See through any typedefs. */
1572 type = TYPE_MAIN_VARIANT (type);
1574 if (TYPE_PTRMEM_P (type))
1575 write_pointer_to_member_type (type);
1578 /* Handle any target-specific fundamental types. */
1579 const char *target_mangling
1580 = targetm.mangle_type (type_orig);
1582 if (target_mangling)
1584 write_string (target_mangling);
1585 /* Add substitutions for types other than fundamental
1587 if (TREE_CODE (type) != VOID_TYPE
1588 && TREE_CODE (type) != INTEGER_TYPE
1589 && TREE_CODE (type) != REAL_TYPE
1590 && TREE_CODE (type) != BOOLEAN_TYPE)
1591 add_substitution (type);
1595 switch (TREE_CODE (type))
1599 case INTEGER_TYPE: /* Includes wchar_t. */
1601 case FIXED_POINT_TYPE:
1603 /* If this is a typedef, TYPE may not be one of
1604 the standard builtin type nodes, but an alias of one. Use
1605 TYPE_MAIN_VARIANT to get to the underlying builtin type. */
1606 write_builtin_type (TYPE_MAIN_VARIANT (type));
1613 write_type (TREE_TYPE (type));
1618 write_function_type (type);
1624 /* A pointer-to-member function is represented as a special
1625 RECORD_TYPE, so check for this first. */
1626 if (TYPE_PTRMEMFUNC_P (type))
1627 write_pointer_to_member_type (type);
1629 write_class_enum_type (type);
1633 case UNBOUND_CLASS_TEMPLATE:
1634 /* We handle TYPENAME_TYPEs and UNBOUND_CLASS_TEMPLATEs like
1635 ordinary nested names. */
1636 write_nested_name (TYPE_STUB_DECL (type));
1641 write_type (TREE_TYPE (type));
1644 case REFERENCE_TYPE:
1645 if (TYPE_REF_IS_RVALUE (type))
1649 write_type (TREE_TYPE (type));
1652 case TEMPLATE_TYPE_PARM:
1653 case TEMPLATE_PARM_INDEX:
1654 write_template_param (type);
1657 case TEMPLATE_TEMPLATE_PARM:
1658 write_template_template_param (type);
1661 case BOUND_TEMPLATE_TEMPLATE_PARM:
1662 write_template_template_param (type);
1664 (TI_ARGS (TEMPLATE_TEMPLATE_PARM_TEMPLATE_INFO (type)));
1668 write_string ("U8__vector");
1669 write_type (TREE_TYPE (type));
1672 case TYPE_PACK_EXPANSION:
1673 write_string ("Dp");
1674 write_type (PACK_EXPANSION_PATTERN (type));
1679 if (DECLTYPE_TYPE_ID_EXPR_OR_MEMBER_ACCESS_P (type))
1684 write_expression (DECLTYPE_TYPE_EXPR (type));
1690 sorry ("mangling typeof, use decltype instead");
1699 /* Types other than builtin types are substitution candidates. */
1700 if (!is_builtin_type)
1701 add_substitution (type);
1704 /* Non-terminal <CV-qualifiers> for type nodes. Returns the number of
1705 CV-qualifiers written for TYPE.
1707 <CV-qualifiers> ::= [r] [V] [K] */
1710 write_CV_qualifiers_for_type (const tree type)
1712 int num_qualifiers = 0;
1714 /* The order is specified by:
1716 "In cases where multiple order-insensitive qualifiers are
1717 present, they should be ordered 'K' (closest to the base type),
1718 'V', 'r', and 'U' (farthest from the base type) ..."
1720 Note that we do not use cp_type_quals below; given "const
1721 int[3]", the "const" is emitted with the "int", not with the
1724 if (TYPE_QUALS (type) & TYPE_QUAL_RESTRICT)
1729 if (TYPE_QUALS (type) & TYPE_QUAL_VOLATILE)
1734 if (TYPE_QUALS (type) & TYPE_QUAL_CONST)
1740 return num_qualifiers;
1743 /* Non-terminal <builtin-type>.
1745 <builtin-type> ::= v # void
1750 ::= h # unsigned char
1752 ::= t # unsigned short
1754 ::= j # unsigned int
1756 ::= m # unsigned long
1757 ::= x # long long, __int64
1758 ::= y # unsigned long long, __int64
1760 ::= o # unsigned __int128
1763 ::= e # long double, __float80
1764 ::= g # __float128 [not supported]
1765 ::= u <source-name> # vendor extended type */
1768 write_builtin_type (tree type)
1770 if (TYPE_CANONICAL (type))
1771 type = TYPE_CANONICAL (type);
1773 switch (TREE_CODE (type))
1784 /* TYPE may still be wchar_t, char16_t, or char32_t, since that
1785 isn't in integer_type_nodes. */
1786 if (type == wchar_type_node)
1788 else if (type == char16_type_node)
1789 write_string ("Ds");
1790 else if (type == char32_type_node)
1791 write_string ("Di");
1792 else if (TYPE_FOR_JAVA (type))
1793 write_java_integer_type_codes (type);
1797 /* Assume TYPE is one of the shared integer type nodes. Find
1798 it in the array of these nodes. */
1800 for (itk = 0; itk < itk_none; ++itk)
1801 if (type == integer_types[itk])
1803 /* Print the corresponding single-letter code. */
1804 write_char (integer_type_codes[itk]);
1808 if (itk == itk_none)
1810 tree t = c_common_type_for_mode (TYPE_MODE (type),
1811 TYPE_UNSIGNED (type));
1818 if (TYPE_PRECISION (type) == 128)
1819 write_char (TYPE_UNSIGNED (type) ? 'o' : 'n');
1822 /* Allow for cases where TYPE is not one of the shared
1823 integer type nodes and write a "vendor extended builtin
1824 type" with a name the form intN or uintN, respectively.
1825 Situations like this can happen if you have an
1826 __attribute__((__mode__(__SI__))) type and use exotic
1827 switches like '-mint8' on AVR. Of course, this is
1828 undefined by the C++ ABI (and '-mint8' is not even
1829 Standard C conforming), but when using such special
1830 options you're pretty much in nowhere land anyway. */
1832 char prec[11]; /* up to ten digits for an unsigned */
1834 prefix = TYPE_UNSIGNED (type) ? "uint" : "int";
1835 sprintf (prec, "%u", (unsigned) TYPE_PRECISION (type));
1836 write_char ('u'); /* "vendor extended builtin type" */
1837 write_unsigned_number (strlen (prefix) + strlen (prec));
1838 write_string (prefix);
1839 write_string (prec);
1846 if (type == float_type_node
1847 || type == java_float_type_node)
1849 else if (type == double_type_node
1850 || type == java_double_type_node)
1852 else if (type == long_double_type_node)
1858 case FIXED_POINT_TYPE:
1859 write_string ("DF");
1860 if (GET_MODE_IBIT (TYPE_MODE (type)) > 0)
1861 write_unsigned_number (GET_MODE_IBIT (TYPE_MODE (type)));
1862 if (type == fract_type_node
1863 || type == sat_fract_type_node
1864 || type == accum_type_node
1865 || type == sat_accum_type_node)
1867 else if (type == unsigned_fract_type_node
1868 || type == sat_unsigned_fract_type_node
1869 || type == unsigned_accum_type_node
1870 || type == sat_unsigned_accum_type_node)
1872 else if (type == short_fract_type_node
1873 || type == sat_short_fract_type_node
1874 || type == short_accum_type_node
1875 || type == sat_short_accum_type_node)
1877 else if (type == unsigned_short_fract_type_node
1878 || type == sat_unsigned_short_fract_type_node
1879 || type == unsigned_short_accum_type_node
1880 || type == sat_unsigned_short_accum_type_node)
1882 else if (type == long_fract_type_node
1883 || type == sat_long_fract_type_node
1884 || type == long_accum_type_node
1885 || type == sat_long_accum_type_node)
1887 else if (type == unsigned_long_fract_type_node
1888 || type == sat_unsigned_long_fract_type_node
1889 || type == unsigned_long_accum_type_node
1890 || type == sat_unsigned_long_accum_type_node)
1892 else if (type == long_long_fract_type_node
1893 || type == sat_long_long_fract_type_node
1894 || type == long_long_accum_type_node
1895 || type == sat_long_long_accum_type_node)
1897 else if (type == unsigned_long_long_fract_type_node
1898 || type == sat_unsigned_long_long_fract_type_node
1899 || type == unsigned_long_long_accum_type_node
1900 || type == sat_unsigned_long_long_accum_type_node)
1903 sorry ("mangling unknown fixed point type");
1904 write_unsigned_number (GET_MODE_FBIT (TYPE_MODE (type)));
1905 if (TYPE_SATURATING (type))
1916 /* Non-terminal <function-type>. NODE is a FUNCTION_TYPE or
1917 METHOD_TYPE. The return type is mangled before the parameter
1920 <function-type> ::= F [Y] <bare-function-type> E */
1923 write_function_type (const tree type)
1925 MANGLE_TRACE_TREE ("function-type", type);
1927 /* For a pointer to member function, the function type may have
1928 cv-qualifiers, indicating the quals for the artificial 'this'
1930 if (TREE_CODE (type) == METHOD_TYPE)
1932 /* The first parameter must be a POINTER_TYPE pointing to the
1933 `this' parameter. */
1934 tree this_type = TREE_TYPE (TREE_VALUE (TYPE_ARG_TYPES (type)));
1935 write_CV_qualifiers_for_type (this_type);
1939 /* We don't track whether or not a type is `extern "C"'. Note that
1940 you can have an `extern "C"' function that does not have
1941 `extern "C"' type, and vice versa:
1943 extern "C" typedef void function_t();
1944 function_t f; // f has C++ linkage, but its type is
1947 typedef void function_t();
1948 extern "C" function_t f; // Vice versa.
1951 write_bare_function_type (type, /*include_return_type_p=*/1,
1956 /* Non-terminal <bare-function-type>. TYPE is a FUNCTION_TYPE or
1957 METHOD_TYPE. If INCLUDE_RETURN_TYPE is nonzero, the return value
1958 is mangled before the parameter types. If non-NULL, DECL is
1959 FUNCTION_DECL for the function whose type is being emitted.
1961 If DECL is a member of a Java type, then a literal 'J'
1962 is output and the return type is mangled as if INCLUDE_RETURN_TYPE
1965 <bare-function-type> ::= [J]</signature/ type>+ */
1968 write_bare_function_type (const tree type, const int include_return_type_p,
1973 MANGLE_TRACE_TREE ("bare-function-type", type);
1975 /* Detect Java methods and emit special encoding. */
1977 && DECL_FUNCTION_MEMBER_P (decl)
1978 && TYPE_FOR_JAVA (DECL_CONTEXT (decl))
1979 && !DECL_CONSTRUCTOR_P (decl)
1980 && !DECL_DESTRUCTOR_P (decl)
1981 && !DECL_CONV_FN_P (decl))
1991 /* Mangle the return type, if requested. */
1992 if (include_return_type_p || java_method_p)
1993 write_type (TREE_TYPE (type));
1995 /* Now mangle the types of the arguments. */
1996 write_method_parms (TYPE_ARG_TYPES (type),
1997 TREE_CODE (type) == METHOD_TYPE,
2001 /* Write the mangled representation of a method parameter list of
2002 types given in PARM_TYPES. If METHOD_P is nonzero, the function is
2003 considered a non-static method, and the this parameter is omitted.
2004 If non-NULL, DECL is the FUNCTION_DECL for the function whose
2005 parameters are being emitted. */
2008 write_method_parms (tree parm_types, const int method_p, const tree decl)
2010 tree first_parm_type;
2011 tree parm_decl = decl ? DECL_ARGUMENTS (decl) : NULL_TREE;
2013 /* Assume this parameter type list is variable-length. If it ends
2014 with a void type, then it's not. */
2017 /* If this is a member function, skip the first arg, which is the
2019 "Member functions do not encode the type of their implicit this
2022 Similarly, there's no need to mangle artificial parameters, like
2023 the VTT parameters for constructors and destructors. */
2026 parm_types = TREE_CHAIN (parm_types);
2027 parm_decl = parm_decl ? TREE_CHAIN (parm_decl) : NULL_TREE;
2029 while (parm_decl && DECL_ARTIFICIAL (parm_decl))
2031 parm_types = TREE_CHAIN (parm_types);
2032 parm_decl = TREE_CHAIN (parm_decl);
2036 for (first_parm_type = parm_types;
2038 parm_types = TREE_CHAIN (parm_types))
2040 tree parm = TREE_VALUE (parm_types);
2041 if (parm == void_type_node)
2043 /* "Empty parameter lists, whether declared as () or
2044 conventionally as (void), are encoded with a void parameter
2046 if (parm_types == first_parm_type)
2048 /* If the parm list is terminated with a void type, it's
2051 /* A void type better be the last one. */
2052 gcc_assert (TREE_CHAIN (parm_types) == NULL);
2059 /* <builtin-type> ::= z # ellipsis */
2063 /* <class-enum-type> ::= <name> */
2066 write_class_enum_type (const tree type)
2068 write_name (TYPE_NAME (type), /*ignore_local_scope=*/0);
2071 /* Non-terminal <template-args>. ARGS is a TREE_VEC of template
2074 <template-args> ::= I <template-arg>* E */
2077 write_template_args (tree args)
2082 MANGLE_TRACE_TREE ("template-args", args);
2087 length = TREE_VEC_LENGTH (args);
2089 if (args && TREE_CODE (TREE_VEC_ELT (args, 0)) == TREE_VEC)
2091 /* We have nested template args. We want the innermost template
2093 args = TREE_VEC_ELT (args, length - 1);
2094 length = TREE_VEC_LENGTH (args);
2096 for (i = 0; i < length; ++i)
2097 write_template_arg (TREE_VEC_ELT (args, i));
2104 <unqualified-name> <template-args>
2105 part of SCOPE_REF or COMPONENT_REF mangling. */
2108 write_member_name (tree member)
2110 if (TREE_CODE (member) == IDENTIFIER_NODE)
2111 write_source_name (member);
2112 else if (DECL_P (member))
2113 write_unqualified_name (member);
2114 else if (TREE_CODE (member) == TEMPLATE_ID_EXPR)
2116 tree name = TREE_OPERAND (member, 0);
2117 if (TREE_CODE (name) == OVERLOAD)
2118 name = OVL_FUNCTION (name);
2119 write_member_name (name);
2120 write_template_args (TREE_OPERAND (member, 1));
2123 write_expression (member);
2126 /* <expression> ::= <unary operator-name> <expression>
2127 ::= <binary operator-name> <expression> <expression>
2130 <expr-primary> ::= <template-param>
2131 ::= L <type> <value number> E # literal
2132 ::= L <mangled-name> E # external name
2133 ::= st <type> # sizeof
2134 ::= sr <type> <unqualified-name> # dependent name
2135 ::= sr <type> <unqualified-name> <template-args> */
2138 write_expression (tree expr)
2140 enum tree_code code = TREE_CODE (expr);
2142 /* Skip NOP_EXPRs. They can occur when (say) a pointer argument
2143 is converted (via qualification conversions) to another
2145 while (TREE_CODE (expr) == NOP_EXPR
2146 || TREE_CODE (expr) == NON_LVALUE_EXPR)
2148 expr = TREE_OPERAND (expr, 0);
2149 code = TREE_CODE (expr);
2152 if (code == BASELINK)
2154 expr = BASELINK_FUNCTIONS (expr);
2155 code = TREE_CODE (expr);
2158 /* Handle pointers-to-members by making them look like expression
2160 if (code == PTRMEM_CST)
2162 expr = build_nt (ADDR_EXPR,
2163 build_qualified_name (/*type=*/NULL_TREE,
2164 PTRMEM_CST_CLASS (expr),
2165 PTRMEM_CST_MEMBER (expr),
2166 /*template_p=*/false));
2167 code = TREE_CODE (expr);
2170 /* Handle template parameters. */
2171 if (code == TEMPLATE_TYPE_PARM
2172 || code == TEMPLATE_TEMPLATE_PARM
2173 || code == BOUND_TEMPLATE_TEMPLATE_PARM
2174 || code == TEMPLATE_PARM_INDEX)
2175 write_template_param (expr);
2176 /* Handle literals. */
2177 else if (TREE_CODE_CLASS (code) == tcc_constant
2178 || (abi_version_at_least (2) && code == CONST_DECL))
2179 write_template_arg_literal (expr);
2180 else if (code == PARM_DECL)
2182 /* A function parameter used in a late-specified return type. */
2183 int index = parm_index (expr);
2184 write_string ("fp");
2186 write_unsigned_number (index - 2);
2189 else if (DECL_P (expr))
2191 /* G++ 3.2 incorrectly mangled non-type template arguments of
2192 enumeration type using their names. */
2193 if (code == CONST_DECL)
2194 G.need_abi_warning = 1;
2196 write_mangled_name (expr, false);
2199 else if (TREE_CODE (expr) == SIZEOF_EXPR
2200 && TYPE_P (TREE_OPERAND (expr, 0)))
2202 write_string ("st");
2203 write_type (TREE_OPERAND (expr, 0));
2205 else if (TREE_CODE (expr) == ALIGNOF_EXPR
2206 && TYPE_P (TREE_OPERAND (expr, 0)))
2208 write_string ("at");
2209 write_type (TREE_OPERAND (expr, 0));
2211 else if (TREE_CODE (expr) == SCOPE_REF)
2213 tree scope = TREE_OPERAND (expr, 0);
2214 tree member = TREE_OPERAND (expr, 1);
2216 if (!abi_version_at_least (2))
2218 write_string ("sr");
2220 /* G++ 3.2 incorrectly put out both the "sr" code and
2221 the nested name of the qualified name. */
2222 G.need_abi_warning = 1;
2223 write_encoding (member);
2226 /* If the MEMBER is a real declaration, then the qualifying
2227 scope was not dependent. Ideally, we would not have a
2228 SCOPE_REF in those cases, but sometimes we do. If the second
2229 argument is a DECL, then the name must not have been
2231 else if (DECL_P (member))
2232 write_expression (member);
2237 write_string ("sr");
2239 /* If MEMBER is a template-id, separate the template
2240 from the arguments. */
2241 if (TREE_CODE (member) == TEMPLATE_ID_EXPR)
2243 template_args = TREE_OPERAND (member, 1);
2244 member = TREE_OPERAND (member, 0);
2247 template_args = NULL_TREE;
2248 /* Write out the name of the MEMBER. */
2249 if (IDENTIFIER_TYPENAME_P (member))
2250 write_conversion_operator_name (TREE_TYPE (member));
2251 else if (IDENTIFIER_OPNAME_P (member))
2254 const char *mangled_name = NULL;
2256 /* Unfortunately, there is no easy way to go from the
2257 name of the operator back to the corresponding tree
2259 for (i = 0; i < MAX_TREE_CODES; ++i)
2260 if (operator_name_info[i].identifier == member)
2262 /* The ABI says that we prefer binary operator
2263 names to unary operator names. */
2264 if (operator_name_info[i].arity == 2)
2266 mangled_name = operator_name_info[i].mangled_name;
2269 else if (!mangled_name)
2270 mangled_name = operator_name_info[i].mangled_name;
2272 else if (assignment_operator_name_info[i].identifier
2276 = assignment_operator_name_info[i].mangled_name;
2279 write_string (mangled_name);
2282 write_source_name (member);
2283 /* Write out the template arguments. */
2285 write_template_args (template_args);
2288 else if (TREE_CODE (expr) == INDIRECT_REF
2289 && TREE_TYPE (TREE_OPERAND (expr, 0))
2290 && TREE_CODE (TREE_TYPE (TREE_OPERAND (expr, 0))) == REFERENCE_TYPE)
2292 write_expression (TREE_OPERAND (expr, 0));
2299 /* When we bind a variable or function to a non-type template
2300 argument with reference type, we create an ADDR_EXPR to show
2301 the fact that the entity's address has been taken. But, we
2302 don't actually want to output a mangling code for the `&'. */
2303 if (TREE_CODE (expr) == ADDR_EXPR
2305 && TREE_CODE (TREE_TYPE (expr)) == REFERENCE_TYPE)
2307 expr = TREE_OPERAND (expr, 0);
2310 write_expression (expr);
2314 code = TREE_CODE (expr);
2317 if (code == COMPONENT_REF)
2319 tree ob = TREE_OPERAND (expr, 0);
2321 if (TREE_CODE (ob) == ARROW_EXPR)
2323 write_string (operator_name_info[(int)code].mangled_name);
2324 ob = TREE_OPERAND (ob, 0);
2327 write_string ("dt");
2329 write_expression (ob);
2330 write_member_name (TREE_OPERAND (expr, 1));
2334 /* If it wasn't any of those, recursively expand the expression. */
2335 name = operator_name_info[(int) code].mangled_name;
2338 sorry ("mangling %C", code);
2342 write_string (name);
2348 tree fn = CALL_EXPR_FN (expr);
2350 if (TREE_CODE (fn) == ADDR_EXPR)
2351 fn = TREE_OPERAND (fn, 0);
2353 /* Mangle a dependent name as the name, not whatever happens to
2354 be the first function in the overload set. */
2355 if ((TREE_CODE (fn) == FUNCTION_DECL
2356 || TREE_CODE (fn) == OVERLOAD)
2357 && type_dependent_expression_p_push (expr))
2358 fn = DECL_NAME (get_first_fn (fn));
2360 if (TREE_CODE (fn) == IDENTIFIER_NODE)
2361 write_source_name (fn);
2363 write_expression (fn);
2366 for (i = 0; i < call_expr_nargs (expr); ++i)
2367 write_expression (CALL_EXPR_ARG (expr, i));
2372 write_type (TREE_TYPE (expr));
2373 if (list_length (TREE_OPERAND (expr, 0)) == 1)
2374 write_expression (TREE_VALUE (TREE_OPERAND (expr, 0)));
2377 tree args = TREE_OPERAND (expr, 0);
2379 for (; args; args = TREE_CHAIN (args))
2380 write_expression (TREE_VALUE (args));
2385 /* FIXME these should have a distinct mangling. */
2386 case STATIC_CAST_EXPR:
2387 case CONST_CAST_EXPR:
2388 write_type (TREE_TYPE (expr));
2389 write_expression (TREE_OPERAND (expr, 0));
2393 sorry ("mangling new-expression");
2397 for (i = 0; i < TREE_OPERAND_LENGTH (expr); ++i)
2399 tree operand = TREE_OPERAND (expr, i);
2400 /* As a GNU extension, the middle operand of a
2401 conditional may be omitted. Since expression
2402 manglings are supposed to represent the input token
2403 stream, there's no good way to mangle such an
2404 expression without extending the C++ ABI. */
2405 if (code == COND_EXPR && i == 1 && !operand)
2407 error ("omitted middle operand to %<?:%> operand "
2408 "cannot be mangled");
2411 write_expression (operand);
2417 /* Literal subcase of non-terminal <template-arg>.
2419 "Literal arguments, e.g. "A<42L>", are encoded with their type
2420 and value. Negative integer values are preceded with "n"; for
2421 example, "A<-42L>" becomes "1AILln42EE". The bool value false is
2422 encoded as 0, true as 1." */
2425 write_template_arg_literal (const tree value)
2428 write_type (TREE_TYPE (value));
2430 switch (TREE_CODE (value))
2433 write_integer_cst (DECL_INITIAL (value));
2437 gcc_assert (!same_type_p (TREE_TYPE (value), boolean_type_node)
2438 || integer_zerop (value) || integer_onep (value));
2439 write_integer_cst (value);
2443 write_real_cst (value);
2453 /* Non-terminal <template-arg>.
2455 <template-arg> ::= <type> # type
2456 ::= L <type> </value/ number> E # literal
2457 ::= LZ <name> E # external name
2458 ::= X <expression> E # expression */
2461 write_template_arg (tree node)
2463 enum tree_code code = TREE_CODE (node);
2465 MANGLE_TRACE_TREE ("template-arg", node);
2467 /* A template template parameter's argument list contains TREE_LIST
2468 nodes of which the value field is the actual argument. */
2469 if (code == TREE_LIST)
2471 node = TREE_VALUE (node);
2472 /* If it's a decl, deal with its type instead. */
2475 node = TREE_TYPE (node);
2476 code = TREE_CODE (node);
2480 if (TREE_CODE (node) == NOP_EXPR
2481 && TREE_CODE (TREE_TYPE (node)) == REFERENCE_TYPE)
2483 /* Template parameters can be of reference type. To maintain
2484 internal consistency, such arguments use a conversion from
2485 address of object to reference type. */
2486 gcc_assert (TREE_CODE (TREE_OPERAND (node, 0)) == ADDR_EXPR);
2487 if (abi_version_at_least (2))
2488 node = TREE_OPERAND (TREE_OPERAND (node, 0), 0);
2490 G.need_abi_warning = 1;
2493 if (ARGUMENT_PACK_P (node))
2495 /* Expand the template argument pack. */
2496 tree args = ARGUMENT_PACK_ARGS (node);
2497 int i, length = TREE_VEC_LENGTH (args);
2499 for (i = 0; i < length; ++i)
2500 write_template_arg (TREE_VEC_ELT (args, i));
2503 else if (TYPE_P (node))
2505 else if (code == TEMPLATE_DECL)
2506 /* A template appearing as a template arg is a template template arg. */
2507 write_template_template_arg (node);
2508 else if ((TREE_CODE_CLASS (code) == tcc_constant && code != PTRMEM_CST)
2509 || (abi_version_at_least (2) && code == CONST_DECL))
2510 write_template_arg_literal (node);
2511 else if (DECL_P (node))
2513 /* Until ABI version 2, non-type template arguments of
2514 enumeration type were mangled using their names. */
2515 if (code == CONST_DECL && !abi_version_at_least (2))
2516 G.need_abi_warning = 1;
2518 /* Until ABI version 3, the underscore before the mangled name
2519 was incorrectly omitted. */
2520 if (!abi_version_at_least (3))
2522 G.need_abi_warning = 1;
2526 write_string ("_Z");
2527 write_encoding (node);
2532 /* Template arguments may be expressions. */
2534 write_expression (node);
2539 /* <template-template-arg>
2541 ::= <substitution> */
2544 write_template_template_arg (const tree decl)
2546 MANGLE_TRACE_TREE ("template-template-arg", decl);
2548 if (find_substitution (decl))
2550 write_name (decl, /*ignore_local_scope=*/0);
2551 add_substitution (decl);
2555 /* Non-terminal <array-type>. TYPE is an ARRAY_TYPE.
2557 <array-type> ::= A [</dimension/ number>] _ </element/ type>
2558 ::= A <expression> _ </element/ type>
2560 "Array types encode the dimension (number of elements) and the
2561 element type. For variable length arrays, the dimension (but not
2562 the '_' separator) is omitted." */
2565 write_array_type (const tree type)
2568 if (TYPE_DOMAIN (type))
2573 index_type = TYPE_DOMAIN (type);
2574 /* The INDEX_TYPE gives the upper and lower bounds of the
2576 max = TYPE_MAX_VALUE (index_type);
2577 if (TREE_CODE (max) == INTEGER_CST)
2579 /* The ABI specifies that we should mangle the number of
2580 elements in the array, not the largest allowed index. */
2581 max = size_binop (PLUS_EXPR, max, size_one_node);
2582 write_unsigned_number (tree_low_cst (max, 1));
2586 max = TREE_OPERAND (max, 0);
2587 if (!abi_version_at_least (2))
2589 /* value_dependent_expression_p presumes nothing is
2590 dependent when PROCESSING_TEMPLATE_DECL is zero. */
2591 ++processing_template_decl;
2592 if (!value_dependent_expression_p (max))
2593 G.need_abi_warning = 1;
2594 --processing_template_decl;
2596 write_expression (max);
2601 write_type (TREE_TYPE (type));
2604 /* Non-terminal <pointer-to-member-type> for pointer-to-member
2605 variables. TYPE is a pointer-to-member POINTER_TYPE.
2607 <pointer-to-member-type> ::= M </class/ type> </member/ type> */
2610 write_pointer_to_member_type (const tree type)
2613 write_type (TYPE_PTRMEM_CLASS_TYPE (type));
2614 write_type (TYPE_PTRMEM_POINTED_TO_TYPE (type));
2617 /* Non-terminal <template-param>. PARM is a TEMPLATE_TYPE_PARM,
2618 TEMPLATE_TEMPLATE_PARM, BOUND_TEMPLATE_TEMPLATE_PARM or a
2619 TEMPLATE_PARM_INDEX.
2621 <template-param> ::= T </parameter/ number> _ */
2624 write_template_param (const tree parm)
2628 tree parm_type = NULL_TREE;
2630 MANGLE_TRACE_TREE ("template-parm", parm);
2632 switch (TREE_CODE (parm))
2634 case TEMPLATE_TYPE_PARM:
2635 case TEMPLATE_TEMPLATE_PARM:
2636 case BOUND_TEMPLATE_TEMPLATE_PARM:
2637 parm_index = TEMPLATE_TYPE_IDX (parm);
2638 parm_level = TEMPLATE_TYPE_LEVEL (parm);
2641 case TEMPLATE_PARM_INDEX:
2642 parm_index = TEMPLATE_PARM_IDX (parm);
2643 parm_level = TEMPLATE_PARM_LEVEL (parm);
2644 parm_type = TREE_TYPE (TEMPLATE_PARM_DECL (parm));
2652 /* NUMBER as it appears in the mangling is (-1)-indexed, with the
2653 earliest template param denoted by `_'. */
2655 write_unsigned_number (parm_index - 1);
2659 /* <template-template-param>
2660 ::= <template-param>
2661 ::= <substitution> */
2664 write_template_template_param (const tree parm)
2666 tree templ = NULL_TREE;
2668 /* PARM, a TEMPLATE_TEMPLATE_PARM, is an instantiation of the
2669 template template parameter. The substitution candidate here is
2670 only the template. */
2671 if (TREE_CODE (parm) == BOUND_TEMPLATE_TEMPLATE_PARM)
2674 = TI_TEMPLATE (TEMPLATE_TEMPLATE_PARM_TEMPLATE_INFO (parm));
2675 if (find_substitution (templ))
2679 /* <template-param> encodes only the template parameter position,
2680 not its template arguments, which is fine here. */
2681 write_template_param (parm);
2683 add_substitution (templ);
2686 /* Non-terminal <substitution>.
2688 <substitution> ::= S <seq-id> _
2692 write_substitution (const int seq_id)
2694 MANGLE_TRACE ("substitution", "");
2698 write_number (seq_id - 1, /*unsigned=*/1, 36);
2702 /* Start mangling ENTITY. */
2705 start_mangling (const tree entity)
2708 G.need_abi_warning = false;
2709 obstack_free (&name_obstack, name_base);
2710 mangle_obstack = &name_obstack;
2711 name_base = obstack_alloc (&name_obstack, 0);
2714 /* Done with mangling. If WARN is true, and the name of G.entity will
2715 be mangled differently in a future version of the ABI, issue a
2719 finish_mangling_internal (const bool warn)
2721 if (warn_abi && warn && G.need_abi_warning)
2722 warning (OPT_Wabi, "the mangled name of %qD will change in a future "
2726 /* Clear all the substitutions. */
2727 VEC_truncate (tree, G.substitutions, 0);
2729 /* Null-terminate the string. */
2734 /* Like finish_mangling_internal, but return the mangled string. */
2736 static inline const char *
2737 finish_mangling (const bool warn)
2739 finish_mangling_internal (warn);
2740 return (const char *) obstack_finish (mangle_obstack);
2743 /* Like finish_mangling_internal, but return an identifier. */
2746 finish_mangling_get_identifier (const bool warn)
2748 finish_mangling_internal (warn);
2749 /* Don't obstack_finish here, and the next start_mangling will
2750 remove the identifier. */
2751 return get_identifier ((const char *) obstack_base (mangle_obstack));
2754 /* Initialize data structures for mangling. */
2759 gcc_obstack_init (&name_obstack);
2760 name_base = obstack_alloc (&name_obstack, 0);
2761 G.substitutions = NULL;
2763 /* Cache these identifiers for quick comparison when checking for
2764 standard substitutions. */
2765 subst_identifiers[SUBID_ALLOCATOR] = get_identifier ("allocator");
2766 subst_identifiers[SUBID_BASIC_STRING] = get_identifier ("basic_string");
2767 subst_identifiers[SUBID_CHAR_TRAITS] = get_identifier ("char_traits");
2768 subst_identifiers[SUBID_BASIC_ISTREAM] = get_identifier ("basic_istream");
2769 subst_identifiers[SUBID_BASIC_OSTREAM] = get_identifier ("basic_ostream");
2770 subst_identifiers[SUBID_BASIC_IOSTREAM] = get_identifier ("basic_iostream");
2773 /* Generate the mangled name of DECL. */
2776 mangle_decl_string (const tree decl)
2780 start_mangling (decl);
2782 if (TREE_CODE (decl) == TYPE_DECL)
2783 write_type (TREE_TYPE (decl));
2785 write_mangled_name (decl, true);
2787 result = finish_mangling_get_identifier (/*warn=*/true);
2789 fprintf (stderr, "mangle_decl_string = '%s'\n\n",
2790 IDENTIFIER_POINTER (result));
2794 /* Create an identifier for the external mangled name of DECL. */
2797 mangle_decl (const tree decl)
2799 tree id = mangle_decl_string (decl);
2800 id = targetm.mangle_decl_assembler_name (decl, id);
2801 SET_DECL_ASSEMBLER_NAME (decl, id);
2804 /* Generate the mangled representation of TYPE. */
2807 mangle_type_string (const tree type)
2811 start_mangling (type);
2813 result = finish_mangling (/*warn=*/false);
2815 fprintf (stderr, "mangle_type_string = '%s'\n\n", result);
2819 /* Create an identifier for the mangled name of a special component
2820 for belonging to TYPE. CODE is the ABI-specified code for this
2824 mangle_special_for_type (const tree type, const char *code)
2828 /* We don't have an actual decl here for the special component, so
2829 we can't just process the <encoded-name>. Instead, fake it. */
2830 start_mangling (type);
2832 /* Start the mangling. */
2833 write_string ("_Z");
2834 write_string (code);
2838 result = finish_mangling_get_identifier (/*warn=*/false);
2841 fprintf (stderr, "mangle_special_for_type = %s\n\n",
2842 IDENTIFIER_POINTER (result));
2847 /* Create an identifier for the mangled representation of the typeinfo
2848 structure for TYPE. */
2851 mangle_typeinfo_for_type (const tree type)
2853 return mangle_special_for_type (type, "TI");
2856 /* Create an identifier for the mangled name of the NTBS containing
2857 the mangled name of TYPE. */
2860 mangle_typeinfo_string_for_type (const tree type)
2862 return mangle_special_for_type (type, "TS");
2865 /* Create an identifier for the mangled name of the vtable for TYPE. */
2868 mangle_vtbl_for_type (const tree type)
2870 return mangle_special_for_type (type, "TV");
2873 /* Returns an identifier for the mangled name of the VTT for TYPE. */
2876 mangle_vtt_for_type (const tree type)
2878 return mangle_special_for_type (type, "TT");
2881 /* Return an identifier for a construction vtable group. TYPE is
2882 the most derived class in the hierarchy; BINFO is the base
2883 subobject for which this construction vtable group will be used.
2885 This mangling isn't part of the ABI specification; in the ABI
2886 specification, the vtable group is dumped in the same COMDAT as the
2887 main vtable, and is referenced only from that vtable, so it doesn't
2888 need an external name. For binary formats without COMDAT sections,
2889 though, we need external names for the vtable groups.
2891 We use the production
2893 <special-name> ::= CT <type> <offset number> _ <base type> */
2896 mangle_ctor_vtbl_for_type (const tree type, const tree binfo)
2900 start_mangling (type);
2902 write_string ("_Z");
2903 write_string ("TC");
2905 write_integer_cst (BINFO_OFFSET (binfo));
2907 write_type (BINFO_TYPE (binfo));
2909 result = finish_mangling_get_identifier (/*warn=*/false);
2911 fprintf (stderr, "mangle_ctor_vtbl_for_type = %s\n\n",
2912 IDENTIFIER_POINTER (result));
2916 /* Mangle a this pointer or result pointer adjustment.
2918 <call-offset> ::= h <fixed offset number> _
2919 ::= v <fixed offset number> _ <virtual offset number> _ */
2922 mangle_call_offset (const tree fixed_offset, const tree virtual_offset)
2924 write_char (virtual_offset ? 'v' : 'h');
2926 /* For either flavor, write the fixed offset. */
2927 write_integer_cst (fixed_offset);
2930 /* For a virtual thunk, add the virtual offset. */
2933 write_integer_cst (virtual_offset);
2938 /* Return an identifier for the mangled name of a this-adjusting or
2939 covariant thunk to FN_DECL. FIXED_OFFSET is the initial adjustment
2940 to this used to find the vptr. If VIRTUAL_OFFSET is non-NULL, this
2941 is a virtual thunk, and it is the vtbl offset in
2942 bytes. THIS_ADJUSTING is nonzero for a this adjusting thunk and
2943 zero for a covariant thunk. Note, that FN_DECL might be a covariant
2944 thunk itself. A covariant thunk name always includes the adjustment
2945 for the this pointer, even if there is none.
2947 <special-name> ::= T <call-offset> <base encoding>
2948 ::= Tc <this_adjust call-offset> <result_adjust call-offset>
2952 mangle_thunk (tree fn_decl, const int this_adjusting, tree fixed_offset,
2953 tree virtual_offset)
2957 start_mangling (fn_decl);
2959 write_string ("_Z");
2962 if (!this_adjusting)
2964 /* Covariant thunk with no this adjustment */
2966 mangle_call_offset (integer_zero_node, NULL_TREE);
2967 mangle_call_offset (fixed_offset, virtual_offset);
2969 else if (!DECL_THUNK_P (fn_decl))
2970 /* Plain this adjusting thunk. */
2971 mangle_call_offset (fixed_offset, virtual_offset);
2974 /* This adjusting thunk to covariant thunk. */
2976 mangle_call_offset (fixed_offset, virtual_offset);
2977 fixed_offset = ssize_int (THUNK_FIXED_OFFSET (fn_decl));
2978 virtual_offset = THUNK_VIRTUAL_OFFSET (fn_decl);
2980 virtual_offset = BINFO_VPTR_FIELD (virtual_offset);
2981 mangle_call_offset (fixed_offset, virtual_offset);
2982 fn_decl = THUNK_TARGET (fn_decl);
2986 write_encoding (fn_decl);
2988 result = finish_mangling_get_identifier (/*warn=*/false);
2990 fprintf (stderr, "mangle_thunk = %s\n\n", IDENTIFIER_POINTER (result));
2994 /* This hash table maps TYPEs to the IDENTIFIER for a conversion
2995 operator to TYPE. The nodes are IDENTIFIERs whose TREE_TYPE is the
2998 static GTY ((param_is (union tree_node))) htab_t conv_type_names;
3000 /* Hash a node (VAL1) in the table. */
3003 hash_type (const void *val)
3005 return (hashval_t) TYPE_UID (TREE_TYPE ((const_tree) val));
3008 /* Compare VAL1 (a node in the table) with VAL2 (a TYPE). */
3011 compare_type (const void *val1, const void *val2)
3013 return TREE_TYPE ((const_tree) val1) == (const_tree) val2;
3016 /* Return an identifier for the mangled unqualified name for a
3017 conversion operator to TYPE. This mangling is not specified by the
3018 ABI spec; it is only used internally. */
3021 mangle_conv_op_name_for_type (const tree type)
3026 if (type == error_mark_node)
3027 return error_mark_node;
3029 if (conv_type_names == NULL)
3030 conv_type_names = htab_create_ggc (31, &hash_type, &compare_type, NULL);
3032 slot = htab_find_slot_with_hash (conv_type_names, type,
3033 (hashval_t) TYPE_UID (type), INSERT);
3034 identifier = (tree)*slot;
3039 /* Create a unique name corresponding to TYPE. */
3040 sprintf (buffer, "operator %lu",
3041 (unsigned long) htab_elements (conv_type_names));
3042 identifier = get_identifier (buffer);
3045 /* Hang TYPE off the identifier so it can be found easily later
3046 when performing conversions. */
3047 TREE_TYPE (identifier) = type;
3049 /* Set bits on the identifier so we know later it's a conversion. */
3050 IDENTIFIER_OPNAME_P (identifier) = 1;
3051 IDENTIFIER_TYPENAME_P (identifier) = 1;
3057 /* Return an identifier for the name of an initialization guard
3058 variable for indicated VARIABLE. */
3061 mangle_guard_variable (const tree variable)
3063 start_mangling (variable);
3064 write_string ("_ZGV");
3065 if (strncmp (IDENTIFIER_POINTER (DECL_NAME (variable)), "_ZGR", 4) == 0)
3066 /* The name of a guard variable for a reference temporary should refer
3067 to the reference, not the temporary. */
3068 write_string (IDENTIFIER_POINTER (DECL_NAME (variable)) + 4);
3070 write_name (variable, /*ignore_local_scope=*/0);
3071 return finish_mangling_get_identifier (/*warn=*/false);
3074 /* Return an identifier for the name of a temporary variable used to
3075 initialize a static reference. This isn't part of the ABI, but we might
3076 as well call them something readable. */
3079 mangle_ref_init_variable (const tree variable)
3081 start_mangling (variable);
3082 write_string ("_ZGR");
3083 write_name (variable, /*ignore_local_scope=*/0);
3084 return finish_mangling_get_identifier (/*warn=*/false);
3088 /* Foreign language type mangling section. */
3090 /* How to write the type codes for the integer Java type. */
3093 write_java_integer_type_codes (const tree type)
3095 if (type == java_int_type_node)
3097 else if (type == java_short_type_node)
3099 else if (type == java_byte_type_node)
3101 else if (type == java_char_type_node)
3103 else if (type == java_long_type_node)
3105 else if (type == java_boolean_type_node)
3111 #include "gt-cp-mangle.h"