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 GTY(()) globals {
94 /* An array of the current substitution candidates, in the order
96 VEC(tree,gc) *substitutions;
98 /* The entity that is being mangled. */
99 tree GTY ((skip)) entity;
101 /* True if the mangling will be different in a future version of the
103 bool need_abi_warning;
106 static GTY (()) globals G;
108 /* The obstack on which we build mangled names. */
109 static struct obstack *mangle_obstack;
111 /* The obstack on which we build mangled names that are not going to
112 be IDENTIFIER_NODEs. */
113 static struct obstack name_obstack;
115 /* The first object on the name_obstack; we use this to free memory
116 allocated on the name_obstack. */
117 static void *name_base;
119 /* Indices into subst_identifiers. These are identifiers used in
120 special substitution rules. */
128 SUBID_BASIC_IOSTREAM,
131 substitution_identifier_index_t;
133 /* For quick substitution checks, look up these common identifiers
135 static GTY(()) tree subst_identifiers[SUBID_MAX];
137 /* Single-letter codes for builtin integer types, defined in
138 <builtin-type>. These are indexed by integer_type_kind values. */
140 integer_type_codes[itk_none] =
143 'a', /* itk_signed_char */
144 'h', /* itk_unsigned_char */
146 't', /* itk_unsigned_short */
148 'j', /* itk_unsigned_int */
150 'm', /* itk_unsigned_long */
151 'x', /* itk_long_long */
152 'y' /* itk_unsigned_long_long */
155 static int decl_is_template_id (const tree, tree* const);
157 /* Functions for handling substitutions. */
159 static inline tree canonicalize_for_substitution (tree);
160 static void add_substitution (tree);
161 static inline int is_std_substitution (const tree,
162 const substitution_identifier_index_t);
163 static inline int is_std_substitution_char (const tree,
164 const substitution_identifier_index_t);
165 static int find_substitution (tree);
166 static void mangle_call_offset (const tree, const tree);
168 /* Functions for emitting mangled representations of things. */
170 static void write_mangled_name (const tree, bool);
171 static void write_encoding (const tree);
172 static void write_name (tree, const int);
173 static void write_unscoped_name (const tree);
174 static void write_unscoped_template_name (const tree);
175 static void write_nested_name (const tree);
176 static void write_prefix (const tree);
177 static void write_template_prefix (const tree);
178 static void write_unqualified_name (const tree);
179 static void write_conversion_operator_name (const tree);
180 static void write_source_name (tree);
181 static void write_unnamed_type_name (const tree);
182 static void write_closure_type_name (const tree);
183 static int hwint_to_ascii (unsigned HOST_WIDE_INT, const unsigned int, char *,
185 static void write_number (unsigned HOST_WIDE_INT, const int,
187 static void write_compact_number (int num);
188 static void write_integer_cst (const tree);
189 static void write_real_cst (const tree);
190 static void write_identifier (const char *);
191 static void write_special_name_constructor (const tree);
192 static void write_special_name_destructor (const tree);
193 static void write_type (tree);
194 static int write_CV_qualifiers_for_type (const tree);
195 static void write_builtin_type (tree);
196 static void write_function_type (const tree);
197 static void write_bare_function_type (const tree, const int, const tree);
198 static void write_method_parms (tree, const int, const tree);
199 static void write_class_enum_type (const tree);
200 static void write_template_args (tree);
201 static void write_expression (tree);
202 static void write_template_arg_literal (const tree);
203 static void write_template_arg (tree);
204 static void write_template_template_arg (const tree);
205 static void write_array_type (const tree);
206 static void write_pointer_to_member_type (const tree);
207 static void write_template_param (const tree);
208 static void write_template_template_param (const tree);
209 static void write_substitution (const int);
210 static int discriminator_for_local_entity (tree);
211 static int discriminator_for_string_literal (tree, tree);
212 static void write_discriminator (const int);
213 static void write_local_name (tree, const tree, const tree);
214 static void dump_substitution_candidates (void);
215 static tree mangle_decl_string (const tree);
216 static int local_class_index (tree);
218 /* Control functions. */
220 static inline void start_mangling (const tree);
221 static inline const char *finish_mangling (const bool);
222 static tree mangle_special_for_type (const tree, const char *);
224 /* Foreign language functions. */
226 static void write_java_integer_type_codes (const tree);
228 /* Append a single character to the end of the mangled
230 #define write_char(CHAR) \
231 obstack_1grow (mangle_obstack, (CHAR))
233 /* Append a sized buffer to the end of the mangled representation. */
234 #define write_chars(CHAR, LEN) \
235 obstack_grow (mangle_obstack, (CHAR), (LEN))
237 /* Append a NUL-terminated string to the end of the mangled
239 #define write_string(STRING) \
240 obstack_grow (mangle_obstack, (STRING), strlen (STRING))
242 /* Nonzero if NODE1 and NODE2 are both TREE_LIST nodes and have the
243 same purpose (context, which may be a type) and value (template
244 decl). See write_template_prefix for more information on what this
246 #define NESTED_TEMPLATE_MATCH(NODE1, NODE2) \
247 (TREE_CODE (NODE1) == TREE_LIST \
248 && TREE_CODE (NODE2) == TREE_LIST \
249 && ((TYPE_P (TREE_PURPOSE (NODE1)) \
250 && same_type_p (TREE_PURPOSE (NODE1), TREE_PURPOSE (NODE2))) \
251 || TREE_PURPOSE (NODE1) == TREE_PURPOSE (NODE2)) \
252 && TREE_VALUE (NODE1) == TREE_VALUE (NODE2))
254 /* Write out an unsigned quantity in base 10. */
255 #define write_unsigned_number(NUMBER) \
256 write_number ((NUMBER), /*unsigned_p=*/1, 10)
258 /* If DECL is a template instance, return nonzero and, if
259 TEMPLATE_INFO is non-NULL, set *TEMPLATE_INFO to its template info.
260 Otherwise return zero. */
263 decl_is_template_id (const tree decl, tree* const template_info)
265 if (TREE_CODE (decl) == TYPE_DECL)
267 /* TYPE_DECLs are handled specially. Look at its type to decide
268 if this is a template instantiation. */
269 const tree type = TREE_TYPE (decl);
271 if (CLASS_TYPE_P (type) && CLASSTYPE_TEMPLATE_ID_P (type))
273 if (template_info != NULL)
274 /* For a templated TYPE_DECL, the template info is hanging
276 *template_info = TYPE_TEMPLATE_INFO (type);
282 /* Check if this is a primary template. */
283 if (DECL_LANG_SPECIFIC (decl) != NULL
284 && DECL_USE_TEMPLATE (decl)
285 && PRIMARY_TEMPLATE_P (DECL_TI_TEMPLATE (decl))
286 && TREE_CODE (decl) != TEMPLATE_DECL)
288 if (template_info != NULL)
289 /* For most templated decls, the template info is hanging
291 *template_info = DECL_TEMPLATE_INFO (decl);
296 /* It's not a template id. */
300 /* Produce debugging output of current substitution candidates. */
303 dump_substitution_candidates (void)
308 fprintf (stderr, " ++ substitutions ");
309 for (i = 0; VEC_iterate (tree, G.substitutions, i, el); ++i)
311 const char *name = "???";
314 fprintf (stderr, " ");
316 name = IDENTIFIER_POINTER (DECL_NAME (el));
317 else if (TREE_CODE (el) == TREE_LIST)
318 name = IDENTIFIER_POINTER (DECL_NAME (TREE_VALUE (el)));
319 else if (TYPE_NAME (el))
320 name = IDENTIFIER_POINTER (DECL_NAME (TYPE_NAME (el)));
321 fprintf (stderr, " S%d_ = ", i - 1);
323 (CP_TYPE_RESTRICT_P (el)
324 || CP_TYPE_VOLATILE_P (el)
325 || CP_TYPE_CONST_P (el)))
326 fprintf (stderr, "CV-");
327 fprintf (stderr, "%s (%s at %p)\n",
328 name, tree_code_name[TREE_CODE (el)], (void *) el);
332 /* Both decls and types can be substitution candidates, but sometimes
333 they refer to the same thing. For instance, a TYPE_DECL and
334 RECORD_TYPE for the same class refer to the same thing, and should
335 be treated accordingly in substitutions. This function returns a
336 canonicalized tree node representing NODE that is used when adding
337 and substitution candidates and finding matches. */
340 canonicalize_for_substitution (tree node)
342 /* For a TYPE_DECL, use the type instead. */
343 if (TREE_CODE (node) == TYPE_DECL)
344 node = TREE_TYPE (node);
346 && TYPE_CANONICAL (node) != node
347 && TYPE_MAIN_VARIANT (node) != node)
348 /* Here we want to strip the topmost typedef only.
349 We need to do that so is_std_substitution can do proper
351 node = cp_build_qualified_type (TYPE_MAIN_VARIANT (node),
352 cp_type_quals (node));
356 /* Add NODE as a substitution candidate. NODE must not already be on
357 the list of candidates. */
360 add_substitution (tree node)
365 fprintf (stderr, " ++ add_substitution (%s at %10p)\n",
366 tree_code_name[TREE_CODE (node)], (void *) node);
368 /* Get the canonicalized substitution candidate for NODE. */
369 c = canonicalize_for_substitution (node);
370 if (DEBUG_MANGLE && c != node)
371 fprintf (stderr, " ++ using candidate (%s at %10p)\n",
372 tree_code_name[TREE_CODE (node)], (void *) node);
376 /* Make sure NODE isn't already a candidate. */
381 for (i = 0; VEC_iterate (tree, G.substitutions, i, candidate); i++)
383 gcc_assert (!(DECL_P (node) && node == candidate));
384 gcc_assert (!(TYPE_P (node) && TYPE_P (candidate)
385 && same_type_p (node, candidate)));
388 #endif /* ENABLE_CHECKING */
390 /* Put the decl onto the varray of substitution candidates. */
391 VEC_safe_push (tree, gc, G.substitutions, node);
394 dump_substitution_candidates ();
397 /* Helper function for find_substitution. Returns nonzero if NODE,
398 which may be a decl or a CLASS_TYPE, is a template-id with template
399 name of substitution_index[INDEX] in the ::std namespace. */
402 is_std_substitution (const tree node,
403 const substitution_identifier_index_t index)
410 type = TREE_TYPE (node);
413 else if (CLASS_TYPE_P (node))
416 decl = TYPE_NAME (node);
419 /* These are not the droids you're looking for. */
422 return (DECL_NAMESPACE_STD_P (CP_DECL_CONTEXT (decl))
423 && TYPE_LANG_SPECIFIC (type)
424 && TYPE_TEMPLATE_INFO (type)
425 && (DECL_NAME (TYPE_TI_TEMPLATE (type))
426 == subst_identifiers[index]));
429 /* Helper function for find_substitution. Returns nonzero if NODE,
430 which may be a decl or a CLASS_TYPE, is the template-id
431 ::std::identifier<char>, where identifier is
432 substitution_index[INDEX]. */
435 is_std_substitution_char (const tree node,
436 const substitution_identifier_index_t index)
439 /* Check NODE's name is ::std::identifier. */
440 if (!is_std_substitution (node, index))
442 /* Figure out its template args. */
444 args = DECL_TI_ARGS (node);
445 else if (CLASS_TYPE_P (node))
446 args = CLASSTYPE_TI_ARGS (node);
448 /* Oops, not a template. */
450 /* NODE's template arg list should be <char>. */
452 TREE_VEC_LENGTH (args) == 1
453 && TREE_VEC_ELT (args, 0) == char_type_node;
456 /* Check whether a substitution should be used to represent NODE in
459 First, check standard special-case substitutions.
461 <substitution> ::= St
468 # ::std::basic_string
471 # ::std::basic_string<char,
472 ::std::char_traits<char>,
473 ::std::allocator<char> >
476 # ::std::basic_istream<char, ::std::char_traits<char> >
479 # ::std::basic_ostream<char, ::std::char_traits<char> >
482 # ::std::basic_iostream<char, ::std::char_traits<char> >
484 Then examine the stack of currently available substitution
485 candidates for entities appearing earlier in the same mangling
487 If a substitution is found, write its mangled representation and
488 return nonzero. If none is found, just return zero. */
491 find_substitution (tree node)
494 const int size = VEC_length (tree, G.substitutions);
499 fprintf (stderr, " ++ find_substitution (%s at %p)\n",
500 tree_code_name[TREE_CODE (node)], (void *) node);
502 /* Obtain the canonicalized substitution representation for NODE.
503 This is what we'll compare against. */
504 node = canonicalize_for_substitution (node);
506 /* Check for builtin substitutions. */
508 decl = TYPE_P (node) ? TYPE_NAME (node) : node;
509 type = TYPE_P (node) ? node : TREE_TYPE (node);
511 /* Check for std::allocator. */
513 && is_std_substitution (decl, SUBID_ALLOCATOR)
514 && !CLASSTYPE_USE_TEMPLATE (TREE_TYPE (decl)))
520 /* Check for std::basic_string. */
521 if (decl && is_std_substitution (decl, SUBID_BASIC_STRING))
525 /* If this is a type (i.e. a fully-qualified template-id),
527 std::basic_string <char,
528 std::char_traits<char>,
529 std::allocator<char> > . */
530 if (cp_type_quals (type) == TYPE_UNQUALIFIED
531 && CLASSTYPE_USE_TEMPLATE (type))
533 tree args = CLASSTYPE_TI_ARGS (type);
534 if (TREE_VEC_LENGTH (args) == 3
535 && same_type_p (TREE_VEC_ELT (args, 0), char_type_node)
536 && is_std_substitution_char (TREE_VEC_ELT (args, 1),
538 && is_std_substitution_char (TREE_VEC_ELT (args, 2),
547 /* Substitute for the template name only if this isn't a type. */
554 /* Check for basic_{i,o,io}stream. */
556 && cp_type_quals (type) == TYPE_UNQUALIFIED
557 && CLASS_TYPE_P (type)
558 && CLASSTYPE_USE_TEMPLATE (type)
559 && CLASSTYPE_TEMPLATE_INFO (type) != NULL)
561 /* First, check for the template
562 args <char, std::char_traits<char> > . */
563 tree args = CLASSTYPE_TI_ARGS (type);
564 if (TREE_VEC_LENGTH (args) == 2
565 && TYPE_P (TREE_VEC_ELT (args, 0))
566 && same_type_p (TREE_VEC_ELT (args, 0), char_type_node)
567 && is_std_substitution_char (TREE_VEC_ELT (args, 1),
570 /* Got them. Is this basic_istream? */
571 if (is_std_substitution (decl, SUBID_BASIC_ISTREAM))
576 /* Or basic_ostream? */
577 else if (is_std_substitution (decl, SUBID_BASIC_OSTREAM))
582 /* Or basic_iostream? */
583 else if (is_std_substitution (decl, SUBID_BASIC_IOSTREAM))
591 /* Check for namespace std. */
592 if (decl && DECL_NAMESPACE_STD_P (decl))
598 /* Now check the list of available substitutions for this mangling
600 for (i = 0; i < size; ++i)
602 tree candidate = VEC_index (tree, G.substitutions, i);
603 /* NODE is a matched to a candidate if it's the same decl node or
604 if it's the same type. */
605 if (decl == candidate
606 || (TYPE_P (candidate) && type && TYPE_P (type)
607 && same_type_p (type, candidate))
608 || NESTED_TEMPLATE_MATCH (node, candidate))
610 write_substitution (i);
615 /* No substitution found. */
620 /* TOP_LEVEL is true, if this is being called at outermost level of
621 mangling. It should be false when mangling a decl appearing in an
622 expression within some other mangling.
624 <mangled-name> ::= _Z <encoding> */
627 write_mangled_name (const tree decl, bool top_level)
629 MANGLE_TRACE_TREE ("mangled-name", decl);
631 if (/* The names of `extern "C"' functions are not mangled. */
632 DECL_EXTERN_C_FUNCTION_P (decl)
633 /* But overloaded operator names *are* mangled. */
634 && !DECL_OVERLOADED_OPERATOR_P (decl))
639 write_string (IDENTIFIER_POINTER (DECL_NAME (decl)));
642 /* The standard notes: "The <encoding> of an extern "C"
643 function is treated like global-scope data, i.e. as its
644 <source-name> without a type." We cannot write
645 overloaded operators that way though, because it contains
646 characters invalid in assembler. */
647 if (abi_version_at_least (2))
650 G.need_abi_warning = true;
651 write_source_name (DECL_NAME (decl));
654 else if (TREE_CODE (decl) == VAR_DECL
655 /* The names of non-static global variables aren't mangled. */
656 && DECL_EXTERNAL_LINKAGE_P (decl)
657 && (CP_DECL_CONTEXT (decl) == global_namespace
658 /* And neither are `extern "C"' variables. */
659 || DECL_EXTERN_C_P (decl)))
661 if (top_level || abi_version_at_least (2))
665 G.need_abi_warning = true;
673 write_encoding (decl);
674 if (DECL_LANG_SPECIFIC (decl)
675 && (DECL_MAYBE_IN_CHARGE_DESTRUCTOR_P (decl)
676 || DECL_MAYBE_IN_CHARGE_CONSTRUCTOR_P (decl)))
677 /* We need a distinct mangled name for these entities, but
678 we should never actually output it. So, we append some
679 characters the assembler won't like. */
680 write_string (" *INTERNAL* ");
684 /* <encoding> ::= <function name> <bare-function-type>
688 write_encoding (const tree decl)
690 MANGLE_TRACE_TREE ("encoding", decl);
692 if (DECL_LANG_SPECIFIC (decl) && DECL_EXTERN_C_FUNCTION_P (decl))
694 /* For overloaded operators write just the mangled name
695 without arguments. */
696 if (DECL_OVERLOADED_OPERATOR_P (decl))
697 write_name (decl, /*ignore_local_scope=*/0);
699 write_source_name (DECL_NAME (decl));
703 write_name (decl, /*ignore_local_scope=*/0);
704 if (TREE_CODE (decl) == FUNCTION_DECL)
709 if (decl_is_template_id (decl, NULL))
711 fn_type = get_mostly_instantiated_function_type (decl);
712 /* FN_TYPE will not have parameter types for in-charge or
713 VTT parameters. Therefore, we pass NULL_TREE to
714 write_bare_function_type -- otherwise, it will get
715 confused about which artificial parameters to skip. */
720 fn_type = TREE_TYPE (decl);
724 write_bare_function_type (fn_type,
725 (!DECL_CONSTRUCTOR_P (decl)
726 && !DECL_DESTRUCTOR_P (decl)
727 && !DECL_CONV_FN_P (decl)
728 && decl_is_template_id (decl, NULL)),
733 /* Lambdas can have a bit more context for mangling, specifically VAR_DECL
734 or PARM_DECL context, which doesn't belong in DECL_CONTEXT. */
737 decl_mangling_context (tree decl)
739 if (TREE_CODE (decl) == TYPE_DECL
740 && LAMBDA_TYPE_P (TREE_TYPE (decl)))
742 tree extra = LAMBDA_TYPE_EXTRA_SCOPE (TREE_TYPE (decl));
746 else if (TREE_CODE (decl) == TYPE_DECL
747 && TREE_CODE (TREE_TYPE (decl)) == TEMPLATE_TYPE_PARM)
748 /* template type parms have no mangling context. */
750 return CP_DECL_CONTEXT (decl);
753 /* <name> ::= <unscoped-name>
754 ::= <unscoped-template-name> <template-args>
758 If IGNORE_LOCAL_SCOPE is nonzero, this production of <name> is
759 called from <local-name>, which mangles the enclosing scope
760 elsewhere and then uses this function to mangle just the part
761 underneath the function scope. So don't use the <local-name>
762 production, to avoid an infinite recursion. */
765 write_name (tree decl, const int ignore_local_scope)
769 MANGLE_TRACE_TREE ("name", decl);
771 if (TREE_CODE (decl) == TYPE_DECL)
773 /* In case this is a typedef, fish out the corresponding
774 TYPE_DECL for the main variant. */
775 decl = TYPE_NAME (TYPE_MAIN_VARIANT (TREE_TYPE (decl)));
778 context = decl_mangling_context (decl);
780 /* A decl in :: or ::std scope is treated specially. The former is
781 mangled using <unscoped-name> or <unscoped-template-name>, the
782 latter with a special substitution. Also, a name that is
783 directly in a local function scope is also mangled with
784 <unscoped-name> rather than a full <nested-name>. */
786 || context == global_namespace
787 || DECL_NAMESPACE_STD_P (context)
788 || (ignore_local_scope && TREE_CODE (context) == FUNCTION_DECL))
791 /* Is this a template instance? */
792 if (decl_is_template_id (decl, &template_info))
794 /* Yes: use <unscoped-template-name>. */
795 write_unscoped_template_name (TI_TEMPLATE (template_info));
796 write_template_args (TI_ARGS (template_info));
799 /* Everything else gets an <unqualified-name>. */
800 write_unscoped_name (decl);
804 /* Handle local names, unless we asked not to (that is, invoked
805 under <local-name>, to handle only the part of the name under
807 if (!ignore_local_scope)
809 /* Scan up the list of scope context, looking for a
810 function. If we find one, this entity is in local
811 function scope. local_entity tracks context one scope
812 level down, so it will contain the element that's
813 directly in that function's scope, either decl or one of
814 its enclosing scopes. */
815 tree local_entity = decl;
816 while (context != NULL && context != global_namespace)
818 /* Make sure we're always dealing with decls. */
819 if (context != NULL && TYPE_P (context))
820 context = TYPE_NAME (context);
821 /* Is this a function? */
822 if (TREE_CODE (context) == FUNCTION_DECL
823 || TREE_CODE (context) == PARM_DECL)
825 /* Yes, we have local scope. Use the <local-name>
826 production for the innermost function scope. */
827 write_local_name (context, local_entity, decl);
830 /* Up one scope level. */
831 local_entity = context;
832 context = decl_mangling_context (context);
835 /* No local scope found? Fall through to <nested-name>. */
838 /* Other decls get a <nested-name> to encode their scope. */
839 write_nested_name (decl);
843 /* <unscoped-name> ::= <unqualified-name>
844 ::= St <unqualified-name> # ::std:: */
847 write_unscoped_name (const tree decl)
849 tree context = CP_DECL_CONTEXT (decl);
851 MANGLE_TRACE_TREE ("unscoped-name", decl);
853 /* Is DECL in ::std? */
854 if (DECL_NAMESPACE_STD_P (context))
857 write_unqualified_name (decl);
861 /* If not, it should be either in the global namespace, or directly
862 in a local function scope. */
863 gcc_assert (context == global_namespace
865 || TREE_CODE (context) == FUNCTION_DECL);
867 write_unqualified_name (decl);
871 /* <unscoped-template-name> ::= <unscoped-name>
872 ::= <substitution> */
875 write_unscoped_template_name (const tree decl)
877 MANGLE_TRACE_TREE ("unscoped-template-name", decl);
879 if (find_substitution (decl))
881 write_unscoped_name (decl);
882 add_substitution (decl);
885 /* Write the nested name, including CV-qualifiers, of DECL.
887 <nested-name> ::= N [<CV-qualifiers>] <prefix> <unqualified-name> E
888 ::= N [<CV-qualifiers>] <template-prefix> <template-args> E
890 <CV-qualifiers> ::= [r] [V] [K] */
893 write_nested_name (const tree decl)
897 MANGLE_TRACE_TREE ("nested-name", decl);
901 /* Write CV-qualifiers, if this is a member function. */
902 if (TREE_CODE (decl) == FUNCTION_DECL
903 && DECL_NONSTATIC_MEMBER_FUNCTION_P (decl))
905 if (DECL_VOLATILE_MEMFUNC_P (decl))
907 if (DECL_CONST_MEMFUNC_P (decl))
911 /* Is this a template instance? */
912 if (decl_is_template_id (decl, &template_info))
914 /* Yes, use <template-prefix>. */
915 write_template_prefix (decl);
916 write_template_args (TI_ARGS (template_info));
918 else if (TREE_CODE (TREE_TYPE (decl)) == TYPENAME_TYPE)
920 tree name = TYPENAME_TYPE_FULLNAME (TREE_TYPE (decl));
921 if (TREE_CODE (name) == TEMPLATE_ID_EXPR)
923 write_template_prefix (decl);
924 write_template_args (TREE_OPERAND (name, 1));
928 write_prefix (CP_DECL_CONTEXT (decl));
929 write_unqualified_name (decl);
934 /* No, just use <prefix> */
935 write_prefix (DECL_CONTEXT (decl));
936 write_unqualified_name (decl);
941 /* <prefix> ::= <prefix> <unqualified-name>
943 ::= <template-prefix> <template-args>
945 ::= <substitution> */
948 write_prefix (const tree node)
951 /* Non-NULL if NODE represents a template-id. */
952 tree template_info = NULL;
955 || node == global_namespace)
958 MANGLE_TRACE_TREE ("prefix", node);
960 if (find_substitution (node))
965 /* If this is a function or parm decl, that means we've hit function
966 scope, so this prefix must be for a local name. In this
967 case, we're under the <local-name> production, which encodes
968 the enclosing function scope elsewhere. So don't continue
970 if (TREE_CODE (node) == FUNCTION_DECL
971 || TREE_CODE (node) == PARM_DECL)
975 decl_is_template_id (decl, &template_info);
979 /* Node is a type. */
980 decl = TYPE_NAME (node);
981 if (CLASSTYPE_TEMPLATE_ID_P (node))
982 template_info = TYPE_TEMPLATE_INFO (node);
985 /* In G++ 3.2, the name of the template parameter was used. */
986 if (TREE_CODE (node) == TEMPLATE_TYPE_PARM
987 && !abi_version_at_least (2))
988 G.need_abi_warning = true;
990 if (TREE_CODE (node) == TEMPLATE_TYPE_PARM
991 && abi_version_at_least (2))
992 write_template_param (node);
993 else if (template_info != NULL)
996 write_template_prefix (decl);
997 write_template_args (TI_ARGS (template_info));
999 else if (TREE_CODE (TREE_TYPE (decl)) == TYPENAME_TYPE)
1001 tree name = TYPENAME_TYPE_FULLNAME (TREE_TYPE (decl));
1002 if (TREE_CODE (name) == TEMPLATE_ID_EXPR)
1004 write_template_prefix (decl);
1005 write_template_args (TREE_OPERAND (name, 1));
1009 write_prefix (CP_DECL_CONTEXT (decl));
1010 write_unqualified_name (decl);
1014 /* Not templated. */
1016 write_prefix (decl_mangling_context (decl));
1017 write_unqualified_name (decl);
1018 if (TREE_CODE (decl) == VAR_DECL
1019 || TREE_CODE (decl) == FIELD_DECL)
1021 /* <data-member-prefix> := <member source-name> M */
1027 add_substitution (node);
1030 /* <template-prefix> ::= <prefix> <template component>
1031 ::= <template-param>
1032 ::= <substitution> */
1035 write_template_prefix (const tree node)
1037 tree decl = DECL_P (node) ? node : TYPE_NAME (node);
1038 tree type = DECL_P (node) ? TREE_TYPE (node) : node;
1039 tree context = CP_DECL_CONTEXT (decl);
1044 MANGLE_TRACE_TREE ("template-prefix", node);
1046 /* Find the template decl. */
1047 if (decl_is_template_id (decl, &template_info))
1048 templ = TI_TEMPLATE (template_info);
1049 else if (TREE_CODE (type) == TYPENAME_TYPE)
1050 /* For a typename type, all we have is the name. */
1051 templ = DECL_NAME (decl);
1054 gcc_assert (CLASSTYPE_TEMPLATE_ID_P (type));
1056 templ = TYPE_TI_TEMPLATE (type);
1059 /* For a member template, though, the template name for the
1060 innermost name must have all the outer template levels
1061 instantiated. For instance, consider
1063 template<typename T> struct Outer {
1064 template<typename U> struct Inner {};
1067 The template name for `Inner' in `Outer<int>::Inner<float>' is
1068 `Outer<int>::Inner<U>'. In g++, we don't instantiate the template
1069 levels separately, so there's no TEMPLATE_DECL available for this
1070 (there's only `Outer<T>::Inner<U>').
1072 In order to get the substitutions right, we create a special
1073 TREE_LIST to represent the substitution candidate for a nested
1074 template. The TREE_PURPOSE is the template's context, fully
1075 instantiated, and the TREE_VALUE is the TEMPLATE_DECL for the inner
1078 So, for the example above, `Outer<int>::Inner' is represented as a
1079 substitution candidate by a TREE_LIST whose purpose is `Outer<int>'
1080 and whose value is `Outer<T>::Inner<U>'. */
1081 if (TYPE_P (context))
1082 substitution = build_tree_list (context, templ);
1084 substitution = templ;
1086 if (find_substitution (substitution))
1089 /* In G++ 3.2, the name of the template template parameter was used. */
1090 if (TREE_TYPE (templ)
1091 && TREE_CODE (TREE_TYPE (templ)) == TEMPLATE_TEMPLATE_PARM
1092 && !abi_version_at_least (2))
1093 G.need_abi_warning = true;
1095 if (TREE_TYPE (templ)
1096 && TREE_CODE (TREE_TYPE (templ)) == TEMPLATE_TEMPLATE_PARM
1097 && abi_version_at_least (2))
1098 write_template_param (TREE_TYPE (templ));
1101 write_prefix (context);
1102 write_unqualified_name (decl);
1105 add_substitution (substitution);
1108 /* We don't need to handle thunks, vtables, or VTTs here. Those are
1109 mangled through special entry points.
1111 <unqualified-name> ::= <operator-name>
1114 ::= <unnamed-type-name>
1115 ::= <local-source-name>
1117 <local-source-name> ::= L <source-name> <discriminator> */
1120 write_unqualified_id (tree identifier)
1122 if (IDENTIFIER_TYPENAME_P (identifier))
1123 write_conversion_operator_name (TREE_TYPE (identifier));
1124 else if (IDENTIFIER_OPNAME_P (identifier))
1127 const char *mangled_name = NULL;
1129 /* Unfortunately, there is no easy way to go from the
1130 name of the operator back to the corresponding tree
1132 for (i = 0; i < MAX_TREE_CODES; ++i)
1133 if (operator_name_info[i].identifier == identifier)
1135 /* The ABI says that we prefer binary operator
1136 names to unary operator names. */
1137 if (operator_name_info[i].arity == 2)
1139 mangled_name = operator_name_info[i].mangled_name;
1142 else if (!mangled_name)
1143 mangled_name = operator_name_info[i].mangled_name;
1145 else if (assignment_operator_name_info[i].identifier
1149 = assignment_operator_name_info[i].mangled_name;
1152 write_string (mangled_name);
1155 write_source_name (identifier);
1159 write_unqualified_name (const tree decl)
1161 MANGLE_TRACE_TREE ("unqualified-name", decl);
1163 if (TREE_CODE (decl) == IDENTIFIER_NODE)
1165 write_unqualified_id (decl);
1169 if (DECL_NAME (decl) == NULL_TREE)
1171 gcc_assert (DECL_ASSEMBLER_NAME_SET_P (decl));
1172 write_source_name (DECL_ASSEMBLER_NAME (decl));
1175 else if (DECL_DECLARES_FUNCTION_P (decl))
1178 if (DECL_CONSTRUCTOR_P (decl))
1179 write_special_name_constructor (decl);
1180 else if (DECL_DESTRUCTOR_P (decl))
1181 write_special_name_destructor (decl);
1182 else if (DECL_CONV_FN_P (decl))
1184 /* Conversion operator. Handle it right here.
1185 <operator> ::= cv <type> */
1187 if (decl_is_template_id (decl, NULL))
1190 fn_type = get_mostly_instantiated_function_type (decl);
1191 type = TREE_TYPE (fn_type);
1194 type = DECL_CONV_FN_TYPE (decl);
1195 write_conversion_operator_name (type);
1197 else if (DECL_OVERLOADED_OPERATOR_P (decl))
1199 operator_name_info_t *oni;
1200 if (DECL_ASSIGNMENT_OPERATOR_P (decl))
1201 oni = assignment_operator_name_info;
1203 oni = operator_name_info;
1205 write_string (oni[DECL_OVERLOADED_OPERATOR_P (decl)].mangled_name);
1214 if (VAR_OR_FUNCTION_DECL_P (decl) && ! TREE_PUBLIC (decl)
1215 && DECL_NAMESPACE_SCOPE_P (decl)
1216 && decl_linkage (decl) == lk_internal)
1218 MANGLE_TRACE_TREE ("local-source-name", decl);
1220 write_source_name (DECL_NAME (decl));
1221 /* The default discriminator is 1, and that's all we ever use,
1222 so there's no code to output one here. */
1226 tree type = TREE_TYPE (decl);
1228 if (TREE_CODE (decl) == TYPE_DECL
1229 && TYPE_ANONYMOUS_P (type))
1230 write_unnamed_type_name (type);
1231 else if (TREE_CODE (decl) == TYPE_DECL
1232 && LAMBDA_TYPE_P (type))
1233 write_closure_type_name (type);
1235 write_source_name (DECL_NAME (decl));
1239 /* Write the unqualified-name for a conversion operator to TYPE. */
1242 write_conversion_operator_name (const tree type)
1244 write_string ("cv");
1248 /* Non-terminal <source-name>. IDENTIFIER is an IDENTIFIER_NODE.
1250 <source-name> ::= </length/ number> <identifier> */
1253 write_source_name (tree identifier)
1255 MANGLE_TRACE_TREE ("source-name", identifier);
1257 /* Never write the whole template-id name including the template
1258 arguments; we only want the template name. */
1259 if (IDENTIFIER_TEMPLATE (identifier))
1260 identifier = IDENTIFIER_TEMPLATE (identifier);
1262 write_unsigned_number (IDENTIFIER_LENGTH (identifier));
1263 write_identifier (IDENTIFIER_POINTER (identifier));
1266 /* Encode 0 as _, and 1+ as n-1_. */
1269 write_compact_number (int num)
1272 write_unsigned_number (num - 1);
1276 /* Return how many unnamed types precede TYPE in its enclosing class. */
1279 nested_anon_class_index (tree type)
1282 tree member = TYPE_FIELDS (TYPE_CONTEXT (type));
1283 for (; member; member = TREE_CHAIN (member))
1284 if (DECL_IMPLICIT_TYPEDEF_P (member))
1286 tree memtype = TREE_TYPE (member);
1287 if (memtype == type)
1289 else if (TYPE_ANONYMOUS_P (memtype))
1296 /* <unnamed-type-name> ::= Ut [ <nonnegative number> ] _ */
1299 write_unnamed_type_name (const tree type __attribute__ ((__unused__)))
1302 MANGLE_TRACE_TREE ("unnamed-type-name", type);
1304 if (TYPE_FUNCTION_SCOPE_P (type))
1305 discriminator = local_class_index (type);
1306 else if (TYPE_CLASS_SCOPE_P (type))
1307 discriminator = nested_anon_class_index (type);
1310 gcc_assert (no_linkage_check (type, /*relaxed_p=*/true));
1311 /* Just use the old mangling at namespace scope. */
1312 write_source_name (TYPE_IDENTIFIER (type));
1316 write_string ("Ut");
1317 write_compact_number (discriminator);
1320 /* <closure-type-name> ::= Ul <lambda-sig> E [ <nonnegative number> ] _
1321 <lambda-sig> ::= <parameter type>+ # Parameter types or "v" if the lambda has no parameters */
1324 write_closure_type_name (const tree type)
1326 tree fn = lambda_function (type);
1327 tree lambda = CLASSTYPE_LAMBDA_EXPR (type);
1328 tree parms = TYPE_ARG_TYPES (TREE_TYPE (fn));
1330 MANGLE_TRACE_TREE ("closure-type-name", type);
1332 write_string ("Ul");
1333 write_method_parms (parms, /*method_p=*/1, fn);
1335 write_compact_number (LAMBDA_EXPR_DISCRIMINATOR (lambda));
1338 /* Convert NUMBER to ascii using base BASE and generating at least
1339 MIN_DIGITS characters. BUFFER points to the _end_ of the buffer
1340 into which to store the characters. Returns the number of
1341 characters generated (these will be layed out in advance of where
1345 hwint_to_ascii (unsigned HOST_WIDE_INT number, const unsigned int base,
1346 char *buffer, const unsigned int min_digits)
1348 static const char base_digits[] = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ";
1349 unsigned digits = 0;
1353 unsigned HOST_WIDE_INT d = number / base;
1355 *--buffer = base_digits[number - d * base];
1359 while (digits < min_digits)
1361 *--buffer = base_digits[0];
1367 /* Non-terminal <number>.
1369 <number> ::= [n] </decimal integer/> */
1372 write_number (unsigned HOST_WIDE_INT number, const int unsigned_p,
1373 const unsigned int base)
1375 char buffer[sizeof (HOST_WIDE_INT) * 8];
1378 if (!unsigned_p && (HOST_WIDE_INT) number < 0)
1381 number = -((HOST_WIDE_INT) number);
1383 count = hwint_to_ascii (number, base, buffer + sizeof (buffer), 1);
1384 write_chars (buffer + sizeof (buffer) - count, count);
1387 /* Write out an integral CST in decimal. Most numbers are small, and
1388 representable in a HOST_WIDE_INT. Occasionally we'll have numbers
1389 bigger than that, which we must deal with. */
1392 write_integer_cst (const tree cst)
1394 int sign = tree_int_cst_sgn (cst);
1396 if (TREE_INT_CST_HIGH (cst) + (sign < 0))
1398 /* A bignum. We do this in chunks, each of which fits in a
1400 char buffer[sizeof (HOST_WIDE_INT) * 8 * 2];
1401 unsigned HOST_WIDE_INT chunk;
1402 unsigned chunk_digits;
1403 char *ptr = buffer + sizeof (buffer);
1408 /* HOST_WIDE_INT must be at least 32 bits, so 10^9 is
1413 if (sizeof (HOST_WIDE_INT) >= 8)
1415 /* It is at least 64 bits, so 10^18 is representable. */
1420 type = c_common_signed_or_unsigned_type (1, TREE_TYPE (cst));
1421 base = build_int_cstu (type, chunk);
1422 n = build_int_cst_wide (type,
1423 TREE_INT_CST_LOW (cst), TREE_INT_CST_HIGH (cst));
1428 n = fold_build1_loc (input_location, NEGATE_EXPR, type, n);
1432 tree d = fold_build2_loc (input_location, FLOOR_DIV_EXPR, type, n, base);
1433 tree tmp = fold_build2_loc (input_location, MULT_EXPR, type, d, base);
1436 done = integer_zerop (d);
1437 tmp = fold_build2_loc (input_location, MINUS_EXPR, type, n, tmp);
1438 c = hwint_to_ascii (TREE_INT_CST_LOW (tmp), 10, ptr,
1439 done ? 1 : chunk_digits);
1445 write_chars (ptr, count);
1450 unsigned HOST_WIDE_INT low = TREE_INT_CST_LOW (cst);
1457 write_unsigned_number (low);
1461 /* Write out a floating-point literal.
1463 "Floating-point literals are encoded using the bit pattern of the
1464 target processor's internal representation of that number, as a
1465 fixed-length lowercase hexadecimal string, high-order bytes first
1466 (even if the target processor would store low-order bytes first).
1467 The "n" prefix is not used for floating-point literals; the sign
1468 bit is encoded with the rest of the number.
1470 Here are some examples, assuming the IEEE standard representation
1471 for floating point numbers. (Spaces are for readability, not
1472 part of the encoding.)
1475 -1.0f Lf bf80 0000 E
1476 1.17549435e-38f Lf 0080 0000 E
1477 1.40129846e-45f Lf 0000 0001 E
1478 0.0f Lf 0000 0000 E"
1480 Caller is responsible for the Lx and the E. */
1482 write_real_cst (const tree value)
1484 if (abi_version_at_least (2))
1486 long target_real[4]; /* largest supported float */
1487 char buffer[9]; /* eight hex digits in a 32-bit number */
1490 tree type = TREE_TYPE (value);
1491 int words = GET_MODE_BITSIZE (TYPE_MODE (type)) / 32;
1493 real_to_target (target_real, &TREE_REAL_CST (value),
1496 /* The value in target_real is in the target word order,
1497 so we must write it out backward if that happens to be
1498 little-endian. write_number cannot be used, it will
1499 produce uppercase. */
1500 if (FLOAT_WORDS_BIG_ENDIAN)
1501 i = 0, limit = words, dir = 1;
1503 i = words - 1, limit = -1, dir = -1;
1505 for (; i != limit; i += dir)
1507 sprintf (buffer, "%08lx", (unsigned long) target_real[i]);
1508 write_chars (buffer, 8);
1513 /* In G++ 3.3 and before the REAL_VALUE_TYPE was written out
1514 literally. Note that compatibility with 3.2 is impossible,
1515 because the old floating-point emulator used a different
1516 format for REAL_VALUE_TYPE. */
1518 for (i = 0; i < sizeof (TREE_REAL_CST (value)); ++i)
1519 write_number (((unsigned char *) &TREE_REAL_CST (value))[i],
1522 G.need_abi_warning = 1;
1526 /* Non-terminal <identifier>.
1528 <identifier> ::= </unqualified source code identifier> */
1531 write_identifier (const char *identifier)
1533 MANGLE_TRACE ("identifier", identifier);
1534 write_string (identifier);
1537 /* Handle constructor productions of non-terminal <special-name>.
1538 CTOR is a constructor FUNCTION_DECL.
1540 <special-name> ::= C1 # complete object constructor
1541 ::= C2 # base object constructor
1542 ::= C3 # complete object allocating constructor
1544 Currently, allocating constructors are never used.
1546 We also need to provide mangled names for the maybe-in-charge
1547 constructor, so we treat it here too. mangle_decl_string will
1548 append *INTERNAL* to that, to make sure we never emit it. */
1551 write_special_name_constructor (const tree ctor)
1553 if (DECL_BASE_CONSTRUCTOR_P (ctor))
1554 write_string ("C2");
1557 gcc_assert (DECL_COMPLETE_CONSTRUCTOR_P (ctor)
1558 /* Even though we don't ever emit a definition of
1559 the old-style destructor, we still have to
1560 consider entities (like static variables) nested
1562 || DECL_MAYBE_IN_CHARGE_CONSTRUCTOR_P (ctor));
1563 write_string ("C1");
1567 /* Handle destructor productions of non-terminal <special-name>.
1568 DTOR is a destructor FUNCTION_DECL.
1570 <special-name> ::= D0 # deleting (in-charge) destructor
1571 ::= D1 # complete object (in-charge) destructor
1572 ::= D2 # base object (not-in-charge) destructor
1574 We also need to provide mangled names for the maybe-incharge
1575 destructor, so we treat it here too. mangle_decl_string will
1576 append *INTERNAL* to that, to make sure we never emit it. */
1579 write_special_name_destructor (const tree dtor)
1581 if (DECL_DELETING_DESTRUCTOR_P (dtor))
1582 write_string ("D0");
1583 else if (DECL_BASE_DESTRUCTOR_P (dtor))
1584 write_string ("D2");
1587 gcc_assert (DECL_COMPLETE_DESTRUCTOR_P (dtor)
1588 /* Even though we don't ever emit a definition of
1589 the old-style destructor, we still have to
1590 consider entities (like static variables) nested
1592 || DECL_MAYBE_IN_CHARGE_DESTRUCTOR_P (dtor));
1593 write_string ("D1");
1597 /* Scan the vector of local classes and return how many others with the
1598 same name (or same no name) and context precede ENTITY. */
1601 local_class_index (tree entity)
1603 int ix, discriminator = 0;
1604 tree name = (TYPE_ANONYMOUS_P (entity) ? NULL_TREE
1605 : TYPE_IDENTIFIER (entity));
1606 tree ctx = TYPE_CONTEXT (entity);
1607 for (ix = 0; ; ix++)
1609 tree type = VEC_index (tree, local_classes, ix);
1611 return discriminator;
1612 if (TYPE_CONTEXT (type) == ctx
1613 && (name ? TYPE_IDENTIFIER (type) == name
1614 : TYPE_ANONYMOUS_P (type)))
1620 /* Return the discriminator for ENTITY appearing inside
1621 FUNCTION. The discriminator is the lexical ordinal of VAR among
1622 entities with the same name in the same FUNCTION. */
1625 discriminator_for_local_entity (tree entity)
1627 if (DECL_DISCRIMINATOR_P (entity))
1629 if (DECL_DISCRIMINATOR_SET_P (entity))
1630 return DECL_DISCRIMINATOR (entity);
1632 /* The first entity with a particular name doesn't get
1633 DECL_DISCRIMINATOR set up. */
1636 else if (TREE_CODE (entity) == TYPE_DECL)
1638 /* Scan the list of local classes. */
1639 entity = TREE_TYPE (entity);
1641 /* Lambdas and unnamed types have their own discriminators. */
1642 if (LAMBDA_TYPE_P (entity) || TYPE_ANONYMOUS_P (entity))
1645 return local_class_index (entity);
1651 /* Return the discriminator for STRING, a string literal used inside
1652 FUNCTION. The discriminator is the lexical ordinal of STRING among
1653 string literals used in FUNCTION. */
1656 discriminator_for_string_literal (tree function ATTRIBUTE_UNUSED,
1657 tree string ATTRIBUTE_UNUSED)
1659 /* For now, we don't discriminate amongst string literals. */
1663 /* <discriminator> := _ <number>
1665 The discriminator is used only for the second and later occurrences
1666 of the same name within a single function. In this case <number> is
1667 n - 2, if this is the nth occurrence, in lexical order. */
1670 write_discriminator (const int discriminator)
1672 /* If discriminator is zero, don't write anything. Otherwise... */
1673 if (discriminator > 0)
1676 write_unsigned_number (discriminator - 1);
1680 /* Mangle the name of a function-scope entity. FUNCTION is the
1681 FUNCTION_DECL for the enclosing function, or a PARM_DECL for lambdas in
1682 default argument scope. ENTITY is the decl for the entity itself.
1683 LOCAL_ENTITY is the entity that's directly scoped in FUNCTION_DECL,
1684 either ENTITY itself or an enclosing scope of ENTITY.
1686 <local-name> := Z <function encoding> E <entity name> [<discriminator>]
1687 := Z <function encoding> E s [<discriminator>]
1688 := Z <function encoding> Ed [ <parameter number> ] _ <entity name> */
1691 write_local_name (tree function, const tree local_entity,
1694 tree parm = NULL_TREE;
1696 MANGLE_TRACE_TREE ("local-name", entity);
1698 if (TREE_CODE (function) == PARM_DECL)
1701 function = DECL_CONTEXT (parm);
1705 write_encoding (function);
1708 /* For this purpose, parameters are numbered from right-to-left. */
1713 for (t = DECL_ARGUMENTS (function); t; t = TREE_CHAIN (t))
1721 write_compact_number (i - 1);
1724 if (TREE_CODE (entity) == STRING_CST)
1727 write_discriminator (discriminator_for_string_literal (function,
1732 /* Now the <entity name>. Let write_name know its being called
1733 from <local-name>, so it doesn't try to process the enclosing
1734 function scope again. */
1735 write_name (entity, /*ignore_local_scope=*/1);
1736 write_discriminator (discriminator_for_local_entity (local_entity));
1740 /* Non-terminals <type> and <CV-qualifier>.
1742 <type> ::= <builtin-type>
1744 ::= <class-enum-type>
1746 ::= <pointer-to-member-type>
1747 ::= <template-param>
1750 ::= P <type> # pointer-to
1751 ::= R <type> # reference-to
1752 ::= C <type> # complex pair (C 2000)
1753 ::= G <type> # imaginary (C 2000) [not supported]
1754 ::= U <source-name> <type> # vendor extended type qualifier
1758 <type> ::= RR <type> # rvalue reference-to
1759 <type> ::= Dt <expression> # decltype of an id-expression or
1760 # class member access
1761 <type> ::= DT <expression> # decltype of an expression
1762 <type> ::= Dn # decltype of nullptr
1764 TYPE is a type node. */
1767 write_type (tree type)
1769 /* This gets set to nonzero if TYPE turns out to be a (possibly
1770 CV-qualified) builtin type. */
1771 int is_builtin_type = 0;
1773 MANGLE_TRACE_TREE ("type", type);
1775 if (type == error_mark_node)
1778 if (find_substitution (type))
1781 /* According to the C++ ABI, some library classes are passed the
1782 same as the scalar type of their single member and use the same
1784 if (TREE_CODE (type) == RECORD_TYPE && TYPE_TRANSPARENT_AGGR (type))
1785 type = TREE_TYPE (first_field (type));
1787 if (write_CV_qualifiers_for_type (type) > 0)
1788 /* If TYPE was CV-qualified, we just wrote the qualifiers; now
1789 mangle the unqualified type. The recursive call is needed here
1790 since both the qualified and unqualified types are substitution
1792 write_type (TYPE_MAIN_VARIANT (type));
1793 else if (TREE_CODE (type) == ARRAY_TYPE)
1794 /* It is important not to use the TYPE_MAIN_VARIANT of TYPE here
1795 so that the cv-qualification of the element type is available
1796 in write_array_type. */
1797 write_array_type (type);
1800 tree type_orig = type;
1802 /* See through any typedefs. */
1803 type = TYPE_MAIN_VARIANT (type);
1805 if (TYPE_PTRMEM_P (type))
1806 write_pointer_to_member_type (type);
1809 /* Handle any target-specific fundamental types. */
1810 const char *target_mangling
1811 = targetm.mangle_type (type_orig);
1813 if (target_mangling)
1815 write_string (target_mangling);
1816 /* Add substitutions for types other than fundamental
1818 if (TREE_CODE (type) != VOID_TYPE
1819 && TREE_CODE (type) != INTEGER_TYPE
1820 && TREE_CODE (type) != REAL_TYPE
1821 && TREE_CODE (type) != BOOLEAN_TYPE)
1822 add_substitution (type);
1826 switch (TREE_CODE (type))
1830 case INTEGER_TYPE: /* Includes wchar_t. */
1832 case FIXED_POINT_TYPE:
1834 /* If this is a typedef, TYPE may not be one of
1835 the standard builtin type nodes, but an alias of one. Use
1836 TYPE_MAIN_VARIANT to get to the underlying builtin type. */
1837 write_builtin_type (TYPE_MAIN_VARIANT (type));
1844 write_type (TREE_TYPE (type));
1849 write_function_type (type);
1855 /* A pointer-to-member function is represented as a special
1856 RECORD_TYPE, so check for this first. */
1857 if (TYPE_PTRMEMFUNC_P (type))
1858 write_pointer_to_member_type (type);
1860 write_class_enum_type (type);
1864 case UNBOUND_CLASS_TEMPLATE:
1865 /* We handle TYPENAME_TYPEs and UNBOUND_CLASS_TEMPLATEs like
1866 ordinary nested names. */
1867 write_nested_name (TYPE_STUB_DECL (type));
1872 write_type (TREE_TYPE (type));
1875 case REFERENCE_TYPE:
1876 if (TYPE_REF_IS_RVALUE (type))
1880 write_type (TREE_TYPE (type));
1883 case TEMPLATE_TYPE_PARM:
1884 case TEMPLATE_PARM_INDEX:
1885 write_template_param (type);
1888 case TEMPLATE_TEMPLATE_PARM:
1889 write_template_template_param (type);
1892 case BOUND_TEMPLATE_TEMPLATE_PARM:
1893 write_template_template_param (type);
1895 (TI_ARGS (TEMPLATE_TEMPLATE_PARM_TEMPLATE_INFO (type)));
1899 if (abi_version_at_least (4))
1901 write_string ("Dv");
1902 /* Non-constant vector size would be encoded with
1903 _ expression, but we don't support that yet. */
1904 write_unsigned_number (TYPE_VECTOR_SUBPARTS (type));
1909 G.need_abi_warning = 1;
1910 write_string ("U8__vector");
1912 write_type (TREE_TYPE (type));
1915 case TYPE_PACK_EXPANSION:
1916 write_string ("Dp");
1917 write_type (PACK_EXPANSION_PATTERN (type));
1921 /* These shouldn't make it into mangling. */
1922 gcc_assert (!DECLTYPE_FOR_LAMBDA_CAPTURE (type)
1923 && !DECLTYPE_FOR_LAMBDA_RETURN (type));
1926 if (DECLTYPE_TYPE_ID_EXPR_OR_MEMBER_ACCESS_P (type))
1930 ++cp_unevaluated_operand;
1931 write_expression (DECLTYPE_TYPE_EXPR (type));
1932 --cp_unevaluated_operand;
1937 write_string ("Dn");
1941 sorry ("mangling typeof, use decltype instead");
1950 /* Types other than builtin types are substitution candidates. */
1951 if (!is_builtin_type)
1952 add_substitution (type);
1955 /* Non-terminal <CV-qualifiers> for type nodes. Returns the number of
1956 CV-qualifiers written for TYPE.
1958 <CV-qualifiers> ::= [r] [V] [K] */
1961 write_CV_qualifiers_for_type (const tree type)
1963 int num_qualifiers = 0;
1965 /* The order is specified by:
1967 "In cases where multiple order-insensitive qualifiers are
1968 present, they should be ordered 'K' (closest to the base type),
1969 'V', 'r', and 'U' (farthest from the base type) ..."
1971 Note that we do not use cp_type_quals below; given "const
1972 int[3]", the "const" is emitted with the "int", not with the
1975 if (TYPE_QUALS (type) & TYPE_QUAL_RESTRICT)
1980 if (TYPE_QUALS (type) & TYPE_QUAL_VOLATILE)
1985 if (TYPE_QUALS (type) & TYPE_QUAL_CONST)
1991 return num_qualifiers;
1994 /* Non-terminal <builtin-type>.
1996 <builtin-type> ::= v # void
2001 ::= h # unsigned char
2003 ::= t # unsigned short
2005 ::= j # unsigned int
2007 ::= m # unsigned long
2008 ::= x # long long, __int64
2009 ::= y # unsigned long long, __int64
2011 ::= o # unsigned __int128
2014 ::= e # long double, __float80
2015 ::= g # __float128 [not supported]
2016 ::= u <source-name> # vendor extended type */
2019 write_builtin_type (tree type)
2021 if (TYPE_CANONICAL (type))
2022 type = TYPE_CANONICAL (type);
2024 switch (TREE_CODE (type))
2035 /* TYPE may still be wchar_t, char16_t, or char32_t, since that
2036 isn't in integer_type_nodes. */
2037 if (type == wchar_type_node)
2039 else if (type == char16_type_node)
2040 write_string ("Ds");
2041 else if (type == char32_type_node)
2042 write_string ("Di");
2043 else if (TYPE_FOR_JAVA (type))
2044 write_java_integer_type_codes (type);
2048 /* Assume TYPE is one of the shared integer type nodes. Find
2049 it in the array of these nodes. */
2051 for (itk = 0; itk < itk_none; ++itk)
2052 if (type == integer_types[itk])
2054 /* Print the corresponding single-letter code. */
2055 write_char (integer_type_codes[itk]);
2059 if (itk == itk_none)
2061 tree t = c_common_type_for_mode (TYPE_MODE (type),
2062 TYPE_UNSIGNED (type));
2069 if (TYPE_PRECISION (type) == 128)
2070 write_char (TYPE_UNSIGNED (type) ? 'o' : 'n');
2073 /* Allow for cases where TYPE is not one of the shared
2074 integer type nodes and write a "vendor extended builtin
2075 type" with a name the form intN or uintN, respectively.
2076 Situations like this can happen if you have an
2077 __attribute__((__mode__(__SI__))) type and use exotic
2078 switches like '-mint8' on AVR. Of course, this is
2079 undefined by the C++ ABI (and '-mint8' is not even
2080 Standard C conforming), but when using such special
2081 options you're pretty much in nowhere land anyway. */
2083 char prec[11]; /* up to ten digits for an unsigned */
2085 prefix = TYPE_UNSIGNED (type) ? "uint" : "int";
2086 sprintf (prec, "%u", (unsigned) TYPE_PRECISION (type));
2087 write_char ('u'); /* "vendor extended builtin type" */
2088 write_unsigned_number (strlen (prefix) + strlen (prec));
2089 write_string (prefix);
2090 write_string (prec);
2097 if (type == float_type_node
2098 || type == java_float_type_node)
2100 else if (type == double_type_node
2101 || type == java_double_type_node)
2103 else if (type == long_double_type_node)
2105 else if (type == dfloat32_type_node)
2106 write_string ("Df");
2107 else if (type == dfloat64_type_node)
2108 write_string ("Dd");
2109 else if (type == dfloat128_type_node)
2110 write_string ("De");
2115 case FIXED_POINT_TYPE:
2116 write_string ("DF");
2117 if (GET_MODE_IBIT (TYPE_MODE (type)) > 0)
2118 write_unsigned_number (GET_MODE_IBIT (TYPE_MODE (type)));
2119 if (type == fract_type_node
2120 || type == sat_fract_type_node
2121 || type == accum_type_node
2122 || type == sat_accum_type_node)
2124 else if (type == unsigned_fract_type_node
2125 || type == sat_unsigned_fract_type_node
2126 || type == unsigned_accum_type_node
2127 || type == sat_unsigned_accum_type_node)
2129 else if (type == short_fract_type_node
2130 || type == sat_short_fract_type_node
2131 || type == short_accum_type_node
2132 || type == sat_short_accum_type_node)
2134 else if (type == unsigned_short_fract_type_node
2135 || type == sat_unsigned_short_fract_type_node
2136 || type == unsigned_short_accum_type_node
2137 || type == sat_unsigned_short_accum_type_node)
2139 else if (type == long_fract_type_node
2140 || type == sat_long_fract_type_node
2141 || type == long_accum_type_node
2142 || type == sat_long_accum_type_node)
2144 else if (type == unsigned_long_fract_type_node
2145 || type == sat_unsigned_long_fract_type_node
2146 || type == unsigned_long_accum_type_node
2147 || type == sat_unsigned_long_accum_type_node)
2149 else if (type == long_long_fract_type_node
2150 || type == sat_long_long_fract_type_node
2151 || type == long_long_accum_type_node
2152 || type == sat_long_long_accum_type_node)
2154 else if (type == unsigned_long_long_fract_type_node
2155 || type == sat_unsigned_long_long_fract_type_node
2156 || type == unsigned_long_long_accum_type_node
2157 || type == sat_unsigned_long_long_accum_type_node)
2160 sorry ("mangling unknown fixed point type");
2161 write_unsigned_number (GET_MODE_FBIT (TYPE_MODE (type)));
2162 if (TYPE_SATURATING (type))
2173 /* Non-terminal <function-type>. NODE is a FUNCTION_TYPE or
2174 METHOD_TYPE. The return type is mangled before the parameter
2177 <function-type> ::= F [Y] <bare-function-type> E */
2180 write_function_type (const tree type)
2182 MANGLE_TRACE_TREE ("function-type", type);
2184 /* For a pointer to member function, the function type may have
2185 cv-qualifiers, indicating the quals for the artificial 'this'
2187 if (TREE_CODE (type) == METHOD_TYPE)
2189 /* The first parameter must be a POINTER_TYPE pointing to the
2190 `this' parameter. */
2191 tree this_type = TREE_TYPE (TREE_VALUE (TYPE_ARG_TYPES (type)));
2192 write_CV_qualifiers_for_type (this_type);
2196 /* We don't track whether or not a type is `extern "C"'. Note that
2197 you can have an `extern "C"' function that does not have
2198 `extern "C"' type, and vice versa:
2200 extern "C" typedef void function_t();
2201 function_t f; // f has C++ linkage, but its type is
2204 typedef void function_t();
2205 extern "C" function_t f; // Vice versa.
2208 write_bare_function_type (type, /*include_return_type_p=*/1,
2213 /* Non-terminal <bare-function-type>. TYPE is a FUNCTION_TYPE or
2214 METHOD_TYPE. If INCLUDE_RETURN_TYPE is nonzero, the return value
2215 is mangled before the parameter types. If non-NULL, DECL is
2216 FUNCTION_DECL for the function whose type is being emitted.
2218 If DECL is a member of a Java type, then a literal 'J'
2219 is output and the return type is mangled as if INCLUDE_RETURN_TYPE
2222 <bare-function-type> ::= [J]</signature/ type>+ */
2225 write_bare_function_type (const tree type, const int include_return_type_p,
2230 MANGLE_TRACE_TREE ("bare-function-type", type);
2232 /* Detect Java methods and emit special encoding. */
2234 && DECL_FUNCTION_MEMBER_P (decl)
2235 && TYPE_FOR_JAVA (DECL_CONTEXT (decl))
2236 && !DECL_CONSTRUCTOR_P (decl)
2237 && !DECL_DESTRUCTOR_P (decl)
2238 && !DECL_CONV_FN_P (decl))
2248 /* Mangle the return type, if requested. */
2249 if (include_return_type_p || java_method_p)
2250 write_type (TREE_TYPE (type));
2252 /* Now mangle the types of the arguments. */
2253 write_method_parms (TYPE_ARG_TYPES (type),
2254 TREE_CODE (type) == METHOD_TYPE,
2258 /* Write the mangled representation of a method parameter list of
2259 types given in PARM_TYPES. If METHOD_P is nonzero, the function is
2260 considered a non-static method, and the this parameter is omitted.
2261 If non-NULL, DECL is the FUNCTION_DECL for the function whose
2262 parameters are being emitted. */
2265 write_method_parms (tree parm_types, const int method_p, const tree decl)
2267 tree first_parm_type;
2268 tree parm_decl = decl ? DECL_ARGUMENTS (decl) : NULL_TREE;
2270 /* Assume this parameter type list is variable-length. If it ends
2271 with a void type, then it's not. */
2274 /* If this is a member function, skip the first arg, which is the
2276 "Member functions do not encode the type of their implicit this
2279 Similarly, there's no need to mangle artificial parameters, like
2280 the VTT parameters for constructors and destructors. */
2283 parm_types = TREE_CHAIN (parm_types);
2284 parm_decl = parm_decl ? TREE_CHAIN (parm_decl) : NULL_TREE;
2286 while (parm_decl && DECL_ARTIFICIAL (parm_decl))
2288 parm_types = TREE_CHAIN (parm_types);
2289 parm_decl = TREE_CHAIN (parm_decl);
2293 for (first_parm_type = parm_types;
2295 parm_types = TREE_CHAIN (parm_types))
2297 tree parm = TREE_VALUE (parm_types);
2298 if (parm == void_type_node)
2300 /* "Empty parameter lists, whether declared as () or
2301 conventionally as (void), are encoded with a void parameter
2303 if (parm_types == first_parm_type)
2305 /* If the parm list is terminated with a void type, it's
2308 /* A void type better be the last one. */
2309 gcc_assert (TREE_CHAIN (parm_types) == NULL);
2316 /* <builtin-type> ::= z # ellipsis */
2320 /* <class-enum-type> ::= <name> */
2323 write_class_enum_type (const tree type)
2325 write_name (TYPE_NAME (type), /*ignore_local_scope=*/0);
2328 /* Non-terminal <template-args>. ARGS is a TREE_VEC of template
2331 <template-args> ::= I <template-arg>* E */
2334 write_template_args (tree args)
2339 MANGLE_TRACE_TREE ("template-args", args);
2344 length = TREE_VEC_LENGTH (args);
2346 if (args && TREE_CODE (TREE_VEC_ELT (args, 0)) == TREE_VEC)
2348 /* We have nested template args. We want the innermost template
2350 args = TREE_VEC_ELT (args, length - 1);
2351 length = TREE_VEC_LENGTH (args);
2353 for (i = 0; i < length; ++i)
2354 write_template_arg (TREE_VEC_ELT (args, i));
2361 <unqualified-name> <template-args>
2362 part of SCOPE_REF or COMPONENT_REF mangling. */
2365 write_member_name (tree member)
2367 if (TREE_CODE (member) == IDENTIFIER_NODE)
2368 write_unqualified_id (member);
2369 else if (DECL_P (member))
2370 write_unqualified_name (member);
2371 else if (TREE_CODE (member) == TEMPLATE_ID_EXPR)
2373 tree name = TREE_OPERAND (member, 0);
2374 if (TREE_CODE (name) == OVERLOAD)
2375 name = OVL_FUNCTION (name);
2376 write_member_name (name);
2377 write_template_args (TREE_OPERAND (member, 1));
2380 write_expression (member);
2383 /* <expression> ::= <unary operator-name> <expression>
2384 ::= <binary operator-name> <expression> <expression>
2387 <expr-primary> ::= <template-param>
2388 ::= L <type> <value number> E # literal
2389 ::= L <mangled-name> E # external name
2390 ::= st <type> # sizeof
2391 ::= sr <type> <unqualified-name> # dependent name
2392 ::= sr <type> <unqualified-name> <template-args> */
2395 write_expression (tree expr)
2397 enum tree_code code = TREE_CODE (expr);
2399 /* Skip NOP_EXPRs. They can occur when (say) a pointer argument
2400 is converted (via qualification conversions) to another
2402 while (TREE_CODE (expr) == NOP_EXPR
2403 || TREE_CODE (expr) == NON_LVALUE_EXPR)
2405 expr = TREE_OPERAND (expr, 0);
2406 code = TREE_CODE (expr);
2409 if (code == BASELINK)
2411 expr = BASELINK_FUNCTIONS (expr);
2412 code = TREE_CODE (expr);
2415 /* Handle pointers-to-members by making them look like expression
2417 if (code == PTRMEM_CST)
2419 expr = build_nt (ADDR_EXPR,
2420 build_qualified_name (/*type=*/NULL_TREE,
2421 PTRMEM_CST_CLASS (expr),
2422 PTRMEM_CST_MEMBER (expr),
2423 /*template_p=*/false));
2424 code = TREE_CODE (expr);
2427 /* Handle template parameters. */
2428 if (code == TEMPLATE_TYPE_PARM
2429 || code == TEMPLATE_TEMPLATE_PARM
2430 || code == BOUND_TEMPLATE_TEMPLATE_PARM
2431 || code == TEMPLATE_PARM_INDEX)
2432 write_template_param (expr);
2433 /* Handle literals. */
2434 else if (TREE_CODE_CLASS (code) == tcc_constant
2435 || (abi_version_at_least (2) && code == CONST_DECL))
2436 write_template_arg_literal (expr);
2437 else if (code == PARM_DECL)
2439 /* A function parameter used in a late-specified return type. */
2440 int index = DECL_PARM_INDEX (expr);
2441 gcc_assert (index >= 1);
2442 write_string ("fp");
2443 write_compact_number (index - 1);
2445 else if (DECL_P (expr))
2447 /* G++ 3.2 incorrectly mangled non-type template arguments of
2448 enumeration type using their names. */
2449 if (code == CONST_DECL)
2450 G.need_abi_warning = 1;
2452 write_mangled_name (expr, false);
2455 else if (TREE_CODE (expr) == SIZEOF_EXPR
2456 && TYPE_P (TREE_OPERAND (expr, 0)))
2458 write_string ("st");
2459 write_type (TREE_OPERAND (expr, 0));
2461 else if (TREE_CODE (expr) == ALIGNOF_EXPR
2462 && TYPE_P (TREE_OPERAND (expr, 0)))
2464 write_string ("at");
2465 write_type (TREE_OPERAND (expr, 0));
2467 else if (TREE_CODE (expr) == SCOPE_REF)
2469 tree scope = TREE_OPERAND (expr, 0);
2470 tree member = TREE_OPERAND (expr, 1);
2472 if (!abi_version_at_least (2))
2474 write_string ("sr");
2476 /* G++ 3.2 incorrectly put out both the "sr" code and
2477 the nested name of the qualified name. */
2478 G.need_abi_warning = 1;
2479 write_encoding (member);
2482 /* If the MEMBER is a real declaration, then the qualifying
2483 scope was not dependent. Ideally, we would not have a
2484 SCOPE_REF in those cases, but sometimes we do. If the second
2485 argument is a DECL, then the name must not have been
2487 else if (DECL_P (member))
2488 write_expression (member);
2491 write_string ("sr");
2493 write_member_name (member);
2496 else if (TREE_CODE (expr) == INDIRECT_REF
2497 && TREE_TYPE (TREE_OPERAND (expr, 0))
2498 && TREE_CODE (TREE_TYPE (TREE_OPERAND (expr, 0))) == REFERENCE_TYPE)
2500 write_expression (TREE_OPERAND (expr, 0));
2502 else if (TREE_CODE (expr) == IDENTIFIER_NODE)
2504 /* An operator name appearing as a dependent name needs to be
2505 specially marked to disambiguate between a use of the operator
2506 name and a use of the operator in an expression. */
2507 if (IDENTIFIER_OPNAME_P (expr))
2508 write_string ("on");
2509 write_unqualified_id (expr);
2511 else if (TREE_CODE (expr) == TEMPLATE_ID_EXPR)
2513 tree fn = TREE_OPERAND (expr, 0);
2514 if (is_overloaded_fn (fn))
2515 fn = DECL_NAME (get_first_fn (fn));
2516 if (IDENTIFIER_OPNAME_P (fn))
2517 write_string ("on");
2518 write_unqualified_id (fn);
2519 write_template_args (TREE_OPERAND (expr, 1));
2526 /* When we bind a variable or function to a non-type template
2527 argument with reference type, we create an ADDR_EXPR to show
2528 the fact that the entity's address has been taken. But, we
2529 don't actually want to output a mangling code for the `&'. */
2530 if (TREE_CODE (expr) == ADDR_EXPR
2532 && TREE_CODE (TREE_TYPE (expr)) == REFERENCE_TYPE)
2534 expr = TREE_OPERAND (expr, 0);
2537 write_expression (expr);
2541 code = TREE_CODE (expr);
2544 if (code == COMPONENT_REF)
2546 tree ob = TREE_OPERAND (expr, 0);
2548 if (TREE_CODE (ob) == ARROW_EXPR)
2550 write_string (operator_name_info[(int)code].mangled_name);
2551 ob = TREE_OPERAND (ob, 0);
2554 write_string ("dt");
2556 write_expression (ob);
2557 write_member_name (TREE_OPERAND (expr, 1));
2561 /* If it wasn't any of those, recursively expand the expression. */
2562 name = operator_name_info[(int) code].mangled_name;
2565 sorry ("mangling %C", code);
2569 write_string (name);
2575 tree fn = CALL_EXPR_FN (expr);
2577 if (TREE_CODE (fn) == ADDR_EXPR)
2578 fn = TREE_OPERAND (fn, 0);
2580 /* Mangle a dependent name as the name, not whatever happens to
2581 be the first function in the overload set. */
2582 if ((TREE_CODE (fn) == FUNCTION_DECL
2583 || TREE_CODE (fn) == OVERLOAD)
2584 && type_dependent_expression_p_push (expr))
2585 fn = DECL_NAME (get_first_fn (fn));
2587 write_expression (fn);
2590 for (i = 0; i < call_expr_nargs (expr); ++i)
2591 write_expression (CALL_EXPR_ARG (expr, i));
2596 write_type (TREE_TYPE (expr));
2597 if (list_length (TREE_OPERAND (expr, 0)) == 1)
2598 write_expression (TREE_VALUE (TREE_OPERAND (expr, 0)));
2601 tree args = TREE_OPERAND (expr, 0);
2603 for (; args; args = TREE_CHAIN (args))
2604 write_expression (TREE_VALUE (args));
2609 /* FIXME these should have a distinct mangling. */
2610 case STATIC_CAST_EXPR:
2611 case CONST_CAST_EXPR:
2612 write_type (TREE_TYPE (expr));
2613 write_expression (TREE_OPERAND (expr, 0));
2617 sorry ("mangling new-expression");
2621 /* In the middle-end, some expressions have more operands than
2622 they do in templates (and mangling). */
2625 case PREINCREMENT_EXPR:
2626 case PREDECREMENT_EXPR:
2627 case POSTINCREMENT_EXPR:
2628 case POSTDECREMENT_EXPR:
2637 len = TREE_OPERAND_LENGTH (expr);
2641 for (i = 0; i < len; ++i)
2643 tree operand = TREE_OPERAND (expr, i);
2644 /* As a GNU extension, the middle operand of a
2645 conditional may be omitted. Since expression
2646 manglings are supposed to represent the input token
2647 stream, there's no good way to mangle such an
2648 expression without extending the C++ ABI. */
2649 if (code == COND_EXPR && i == 1 && !operand)
2651 error ("omitted middle operand to %<?:%> operand "
2652 "cannot be mangled");
2655 write_expression (operand);
2661 /* Literal subcase of non-terminal <template-arg>.
2663 "Literal arguments, e.g. "A<42L>", are encoded with their type
2664 and value. Negative integer values are preceded with "n"; for
2665 example, "A<-42L>" becomes "1AILln42EE". The bool value false is
2666 encoded as 0, true as 1." */
2669 write_template_arg_literal (const tree value)
2672 write_type (TREE_TYPE (value));
2674 switch (TREE_CODE (value))
2677 write_integer_cst (DECL_INITIAL (value));
2681 gcc_assert (!same_type_p (TREE_TYPE (value), boolean_type_node)
2682 || integer_zerop (value) || integer_onep (value));
2683 write_integer_cst (value);
2687 write_real_cst (value);
2697 /* Non-terminal <template-arg>.
2699 <template-arg> ::= <type> # type
2700 ::= L <type> </value/ number> E # literal
2701 ::= LZ <name> E # external name
2702 ::= X <expression> E # expression */
2705 write_template_arg (tree node)
2707 enum tree_code code = TREE_CODE (node);
2709 MANGLE_TRACE_TREE ("template-arg", node);
2711 /* A template template parameter's argument list contains TREE_LIST
2712 nodes of which the value field is the actual argument. */
2713 if (code == TREE_LIST)
2715 node = TREE_VALUE (node);
2716 /* If it's a decl, deal with its type instead. */
2719 node = TREE_TYPE (node);
2720 code = TREE_CODE (node);
2724 if (TREE_CODE (node) == NOP_EXPR
2725 && TREE_CODE (TREE_TYPE (node)) == REFERENCE_TYPE)
2727 /* Template parameters can be of reference type. To maintain
2728 internal consistency, such arguments use a conversion from
2729 address of object to reference type. */
2730 gcc_assert (TREE_CODE (TREE_OPERAND (node, 0)) == ADDR_EXPR);
2731 if (abi_version_at_least (2))
2732 node = TREE_OPERAND (TREE_OPERAND (node, 0), 0);
2734 G.need_abi_warning = 1;
2737 if (ARGUMENT_PACK_P (node))
2739 /* Expand the template argument pack. */
2740 tree args = ARGUMENT_PACK_ARGS (node);
2741 int i, length = TREE_VEC_LENGTH (args);
2743 for (i = 0; i < length; ++i)
2744 write_template_arg (TREE_VEC_ELT (args, i));
2747 else if (TYPE_P (node))
2749 else if (code == TEMPLATE_DECL)
2750 /* A template appearing as a template arg is a template template arg. */
2751 write_template_template_arg (node);
2752 else if ((TREE_CODE_CLASS (code) == tcc_constant && code != PTRMEM_CST)
2753 || (abi_version_at_least (2) && code == CONST_DECL))
2754 write_template_arg_literal (node);
2755 else if (DECL_P (node))
2757 /* Until ABI version 2, non-type template arguments of
2758 enumeration type were mangled using their names. */
2759 if (code == CONST_DECL && !abi_version_at_least (2))
2760 G.need_abi_warning = 1;
2762 /* Until ABI version 3, the underscore before the mangled name
2763 was incorrectly omitted. */
2764 if (!abi_version_at_least (3))
2766 G.need_abi_warning = 1;
2770 write_string ("_Z");
2771 write_encoding (node);
2776 /* Template arguments may be expressions. */
2778 write_expression (node);
2783 /* <template-template-arg>
2785 ::= <substitution> */
2788 write_template_template_arg (const tree decl)
2790 MANGLE_TRACE_TREE ("template-template-arg", decl);
2792 if (find_substitution (decl))
2794 write_name (decl, /*ignore_local_scope=*/0);
2795 add_substitution (decl);
2799 /* Non-terminal <array-type>. TYPE is an ARRAY_TYPE.
2801 <array-type> ::= A [</dimension/ number>] _ </element/ type>
2802 ::= A <expression> _ </element/ type>
2804 "Array types encode the dimension (number of elements) and the
2805 element type. For variable length arrays, the dimension (but not
2806 the '_' separator) is omitted." */
2809 write_array_type (const tree type)
2812 if (TYPE_DOMAIN (type))
2817 index_type = TYPE_DOMAIN (type);
2818 /* The INDEX_TYPE gives the upper and lower bounds of the
2820 max = TYPE_MAX_VALUE (index_type);
2821 if (TREE_CODE (max) == INTEGER_CST)
2823 /* The ABI specifies that we should mangle the number of
2824 elements in the array, not the largest allowed index. */
2825 max = size_binop (PLUS_EXPR, max, size_one_node);
2826 write_unsigned_number (tree_low_cst (max, 1));
2830 max = TREE_OPERAND (max, 0);
2831 if (!abi_version_at_least (2))
2833 /* value_dependent_expression_p presumes nothing is
2834 dependent when PROCESSING_TEMPLATE_DECL is zero. */
2835 ++processing_template_decl;
2836 if (!value_dependent_expression_p (max))
2837 G.need_abi_warning = 1;
2838 --processing_template_decl;
2840 write_expression (max);
2845 write_type (TREE_TYPE (type));
2848 /* Non-terminal <pointer-to-member-type> for pointer-to-member
2849 variables. TYPE is a pointer-to-member POINTER_TYPE.
2851 <pointer-to-member-type> ::= M </class/ type> </member/ type> */
2854 write_pointer_to_member_type (const tree type)
2857 write_type (TYPE_PTRMEM_CLASS_TYPE (type));
2858 write_type (TYPE_PTRMEM_POINTED_TO_TYPE (type));
2861 /* Non-terminal <template-param>. PARM is a TEMPLATE_TYPE_PARM,
2862 TEMPLATE_TEMPLATE_PARM, BOUND_TEMPLATE_TEMPLATE_PARM or a
2863 TEMPLATE_PARM_INDEX.
2865 <template-param> ::= T </parameter/ number> _ */
2868 write_template_param (const tree parm)
2872 MANGLE_TRACE_TREE ("template-parm", parm);
2874 switch (TREE_CODE (parm))
2876 case TEMPLATE_TYPE_PARM:
2877 case TEMPLATE_TEMPLATE_PARM:
2878 case BOUND_TEMPLATE_TEMPLATE_PARM:
2879 parm_index = TEMPLATE_TYPE_IDX (parm);
2882 case TEMPLATE_PARM_INDEX:
2883 parm_index = TEMPLATE_PARM_IDX (parm);
2891 /* NUMBER as it appears in the mangling is (-1)-indexed, with the
2892 earliest template param denoted by `_'. */
2893 write_compact_number (parm_index);
2896 /* <template-template-param>
2897 ::= <template-param>
2898 ::= <substitution> */
2901 write_template_template_param (const tree parm)
2903 tree templ = NULL_TREE;
2905 /* PARM, a TEMPLATE_TEMPLATE_PARM, is an instantiation of the
2906 template template parameter. The substitution candidate here is
2907 only the template. */
2908 if (TREE_CODE (parm) == BOUND_TEMPLATE_TEMPLATE_PARM)
2911 = TI_TEMPLATE (TEMPLATE_TEMPLATE_PARM_TEMPLATE_INFO (parm));
2912 if (find_substitution (templ))
2916 /* <template-param> encodes only the template parameter position,
2917 not its template arguments, which is fine here. */
2918 write_template_param (parm);
2920 add_substitution (templ);
2923 /* Non-terminal <substitution>.
2925 <substitution> ::= S <seq-id> _
2929 write_substitution (const int seq_id)
2931 MANGLE_TRACE ("substitution", "");
2935 write_number (seq_id - 1, /*unsigned=*/1, 36);
2939 /* Start mangling ENTITY. */
2942 start_mangling (const tree entity)
2945 G.need_abi_warning = false;
2946 obstack_free (&name_obstack, name_base);
2947 mangle_obstack = &name_obstack;
2948 name_base = obstack_alloc (&name_obstack, 0);
2951 /* Done with mangling. If WARN is true, and the name of G.entity will
2952 be mangled differently in a future version of the ABI, issue a
2956 finish_mangling_internal (const bool warn)
2958 if (warn_abi && warn && G.need_abi_warning)
2959 warning (OPT_Wabi, "the mangled name of %qD will change in a future "
2963 /* Clear all the substitutions. */
2964 VEC_truncate (tree, G.substitutions, 0);
2966 /* Null-terminate the string. */
2971 /* Like finish_mangling_internal, but return the mangled string. */
2973 static inline const char *
2974 finish_mangling (const bool warn)
2976 finish_mangling_internal (warn);
2977 return (const char *) obstack_finish (mangle_obstack);
2980 /* Like finish_mangling_internal, but return an identifier. */
2983 finish_mangling_get_identifier (const bool warn)
2985 finish_mangling_internal (warn);
2986 /* Don't obstack_finish here, and the next start_mangling will
2987 remove the identifier. */
2988 return get_identifier ((const char *) obstack_base (mangle_obstack));
2991 /* Initialize data structures for mangling. */
2996 gcc_obstack_init (&name_obstack);
2997 name_base = obstack_alloc (&name_obstack, 0);
2998 G.substitutions = NULL;
3000 /* Cache these identifiers for quick comparison when checking for
3001 standard substitutions. */
3002 subst_identifiers[SUBID_ALLOCATOR] = get_identifier ("allocator");
3003 subst_identifiers[SUBID_BASIC_STRING] = get_identifier ("basic_string");
3004 subst_identifiers[SUBID_CHAR_TRAITS] = get_identifier ("char_traits");
3005 subst_identifiers[SUBID_BASIC_ISTREAM] = get_identifier ("basic_istream");
3006 subst_identifiers[SUBID_BASIC_OSTREAM] = get_identifier ("basic_ostream");
3007 subst_identifiers[SUBID_BASIC_IOSTREAM] = get_identifier ("basic_iostream");
3010 /* Generate the mangled name of DECL. */
3013 mangle_decl_string (const tree decl)
3016 location_t saved_loc = input_location;
3017 tree saved_fn = NULL_TREE;
3018 bool template_p = false;
3020 if (DECL_LANG_SPECIFIC (decl) && DECL_USE_TEMPLATE (decl))
3022 struct tinst_level *tl = current_instantiation ();
3023 if (!tl || tl->decl != decl)
3026 saved_fn = current_function_decl;
3027 push_tinst_level (decl);
3028 current_function_decl = NULL_TREE;
3031 input_location = DECL_SOURCE_LOCATION (decl);
3033 start_mangling (decl);
3035 if (TREE_CODE (decl) == TYPE_DECL)
3036 write_type (TREE_TYPE (decl));
3038 write_mangled_name (decl, true);
3040 result = finish_mangling_get_identifier (/*warn=*/true);
3042 fprintf (stderr, "mangle_decl_string = '%s'\n\n",
3043 IDENTIFIER_POINTER (result));
3048 current_function_decl = saved_fn;
3050 input_location = saved_loc;
3055 /* Create an identifier for the external mangled name of DECL. */
3058 mangle_decl (const tree decl)
3060 tree id = mangle_decl_string (decl);
3061 id = targetm.mangle_decl_assembler_name (decl, id);
3062 SET_DECL_ASSEMBLER_NAME (decl, id);
3064 if (G.need_abi_warning)
3066 #ifdef ASM_OUTPUT_DEF
3067 /* If the mangling will change in the future, emit an alias with the
3068 future mangled name for forward-compatibility. */
3073 SET_IDENTIFIER_GLOBAL_VALUE (id, decl);
3074 if (IDENTIFIER_GLOBAL_VALUE (id) != decl)
3075 inform (DECL_SOURCE_LOCATION (decl), "-fabi-version=4 (or =0) "
3076 "avoids this error with a change in vector mangling");
3078 #ifdef ASM_OUTPUT_DEF
3079 save_ver = flag_abi_version;
3080 flag_abi_version = 0;
3081 id2 = mangle_decl_string (decl);
3082 id2 = targetm.mangle_decl_assembler_name (decl, id2);
3083 flag_abi_version = save_ver;
3085 alias = make_alias_for (decl, id2);
3086 DECL_IGNORED_P (alias) = 1;
3087 TREE_PUBLIC (alias) = TREE_PUBLIC (decl);
3088 DECL_VISIBILITY (alias) = DECL_VISIBILITY (decl);
3089 if (vague_linkage_p (decl))
3090 DECL_WEAK (alias) = 1;
3091 if (TREE_CODE (decl) == FUNCTION_DECL)
3092 cgraph_same_body_alias (alias, decl);
3094 varpool_extra_name_alias (alias, decl);
3099 /* Generate the mangled representation of TYPE. */
3102 mangle_type_string (const tree type)
3106 start_mangling (type);
3108 result = finish_mangling (/*warn=*/false);
3110 fprintf (stderr, "mangle_type_string = '%s'\n\n", result);
3114 /* Create an identifier for the mangled name of a special component
3115 for belonging to TYPE. CODE is the ABI-specified code for this
3119 mangle_special_for_type (const tree type, const char *code)
3123 /* We don't have an actual decl here for the special component, so
3124 we can't just process the <encoded-name>. Instead, fake it. */
3125 start_mangling (type);
3127 /* Start the mangling. */
3128 write_string ("_Z");
3129 write_string (code);
3133 result = finish_mangling_get_identifier (/*warn=*/false);
3136 fprintf (stderr, "mangle_special_for_type = %s\n\n",
3137 IDENTIFIER_POINTER (result));
3142 /* Create an identifier for the mangled representation of the typeinfo
3143 structure for TYPE. */
3146 mangle_typeinfo_for_type (const tree type)
3148 return mangle_special_for_type (type, "TI");
3151 /* Create an identifier for the mangled name of the NTBS containing
3152 the mangled name of TYPE. */
3155 mangle_typeinfo_string_for_type (const tree type)
3157 return mangle_special_for_type (type, "TS");
3160 /* Create an identifier for the mangled name of the vtable for TYPE. */
3163 mangle_vtbl_for_type (const tree type)
3165 return mangle_special_for_type (type, "TV");
3168 /* Returns an identifier for the mangled name of the VTT for TYPE. */
3171 mangle_vtt_for_type (const tree type)
3173 return mangle_special_for_type (type, "TT");
3176 /* Return an identifier for a construction vtable group. TYPE is
3177 the most derived class in the hierarchy; BINFO is the base
3178 subobject for which this construction vtable group will be used.
3180 This mangling isn't part of the ABI specification; in the ABI
3181 specification, the vtable group is dumped in the same COMDAT as the
3182 main vtable, and is referenced only from that vtable, so it doesn't
3183 need an external name. For binary formats without COMDAT sections,
3184 though, we need external names for the vtable groups.
3186 We use the production
3188 <special-name> ::= CT <type> <offset number> _ <base type> */
3191 mangle_ctor_vtbl_for_type (const tree type, const tree binfo)
3195 start_mangling (type);
3197 write_string ("_Z");
3198 write_string ("TC");
3200 write_integer_cst (BINFO_OFFSET (binfo));
3202 write_type (BINFO_TYPE (binfo));
3204 result = finish_mangling_get_identifier (/*warn=*/false);
3206 fprintf (stderr, "mangle_ctor_vtbl_for_type = %s\n\n",
3207 IDENTIFIER_POINTER (result));
3211 /* Mangle a this pointer or result pointer adjustment.
3213 <call-offset> ::= h <fixed offset number> _
3214 ::= v <fixed offset number> _ <virtual offset number> _ */
3217 mangle_call_offset (const tree fixed_offset, const tree virtual_offset)
3219 write_char (virtual_offset ? 'v' : 'h');
3221 /* For either flavor, write the fixed offset. */
3222 write_integer_cst (fixed_offset);
3225 /* For a virtual thunk, add the virtual offset. */
3228 write_integer_cst (virtual_offset);
3233 /* Return an identifier for the mangled name of a this-adjusting or
3234 covariant thunk to FN_DECL. FIXED_OFFSET is the initial adjustment
3235 to this used to find the vptr. If VIRTUAL_OFFSET is non-NULL, this
3236 is a virtual thunk, and it is the vtbl offset in
3237 bytes. THIS_ADJUSTING is nonzero for a this adjusting thunk and
3238 zero for a covariant thunk. Note, that FN_DECL might be a covariant
3239 thunk itself. A covariant thunk name always includes the adjustment
3240 for the this pointer, even if there is none.
3242 <special-name> ::= T <call-offset> <base encoding>
3243 ::= Tc <this_adjust call-offset> <result_adjust call-offset>
3247 mangle_thunk (tree fn_decl, const int this_adjusting, tree fixed_offset,
3248 tree virtual_offset)
3252 start_mangling (fn_decl);
3254 write_string ("_Z");
3257 if (!this_adjusting)
3259 /* Covariant thunk with no this adjustment */
3261 mangle_call_offset (integer_zero_node, NULL_TREE);
3262 mangle_call_offset (fixed_offset, virtual_offset);
3264 else if (!DECL_THUNK_P (fn_decl))
3265 /* Plain this adjusting thunk. */
3266 mangle_call_offset (fixed_offset, virtual_offset);
3269 /* This adjusting thunk to covariant thunk. */
3271 mangle_call_offset (fixed_offset, virtual_offset);
3272 fixed_offset = ssize_int (THUNK_FIXED_OFFSET (fn_decl));
3273 virtual_offset = THUNK_VIRTUAL_OFFSET (fn_decl);
3275 virtual_offset = BINFO_VPTR_FIELD (virtual_offset);
3276 mangle_call_offset (fixed_offset, virtual_offset);
3277 fn_decl = THUNK_TARGET (fn_decl);
3281 write_encoding (fn_decl);
3283 result = finish_mangling_get_identifier (/*warn=*/false);
3285 fprintf (stderr, "mangle_thunk = %s\n\n", IDENTIFIER_POINTER (result));
3289 /* This hash table maps TYPEs to the IDENTIFIER for a conversion
3290 operator to TYPE. The nodes are IDENTIFIERs whose TREE_TYPE is the
3293 static GTY ((param_is (union tree_node))) htab_t conv_type_names;
3295 /* Hash a node (VAL1) in the table. */
3298 hash_type (const void *val)
3300 return (hashval_t) TYPE_UID (TREE_TYPE ((const_tree) val));
3303 /* Compare VAL1 (a node in the table) with VAL2 (a TYPE). */
3306 compare_type (const void *val1, const void *val2)
3308 return TREE_TYPE ((const_tree) val1) == (const_tree) val2;
3311 /* Return an identifier for the mangled unqualified name for a
3312 conversion operator to TYPE. This mangling is not specified by the
3313 ABI spec; it is only used internally. */
3316 mangle_conv_op_name_for_type (const tree type)
3321 if (type == error_mark_node)
3322 return error_mark_node;
3324 if (conv_type_names == NULL)
3325 conv_type_names = htab_create_ggc (31, &hash_type, &compare_type, NULL);
3327 slot = htab_find_slot_with_hash (conv_type_names, type,
3328 (hashval_t) TYPE_UID (type), INSERT);
3329 identifier = (tree)*slot;
3334 /* Create a unique name corresponding to TYPE. */
3335 sprintf (buffer, "operator %lu",
3336 (unsigned long) htab_elements (conv_type_names));
3337 identifier = get_identifier (buffer);
3340 /* Hang TYPE off the identifier so it can be found easily later
3341 when performing conversions. */
3342 TREE_TYPE (identifier) = type;
3344 /* Set bits on the identifier so we know later it's a conversion. */
3345 IDENTIFIER_OPNAME_P (identifier) = 1;
3346 IDENTIFIER_TYPENAME_P (identifier) = 1;
3352 /* Return an identifier for the name of an initialization guard
3353 variable for indicated VARIABLE. */
3356 mangle_guard_variable (const tree variable)
3358 start_mangling (variable);
3359 write_string ("_ZGV");
3360 if (strncmp (IDENTIFIER_POINTER (DECL_NAME (variable)), "_ZGR", 4) == 0)
3361 /* The name of a guard variable for a reference temporary should refer
3362 to the reference, not the temporary. */
3363 write_string (IDENTIFIER_POINTER (DECL_NAME (variable)) + 4);
3365 write_name (variable, /*ignore_local_scope=*/0);
3366 return finish_mangling_get_identifier (/*warn=*/false);
3369 /* Return an identifier for the name of a temporary variable used to
3370 initialize a static reference. This isn't part of the ABI, but we might
3371 as well call them something readable. */
3374 mangle_ref_init_variable (const tree variable)
3376 start_mangling (variable);
3377 write_string ("_ZGR");
3378 write_name (variable, /*ignore_local_scope=*/0);
3379 return finish_mangling_get_identifier (/*warn=*/false);
3383 /* Foreign language type mangling section. */
3385 /* How to write the type codes for the integer Java type. */
3388 write_java_integer_type_codes (const tree type)
3390 if (type == java_int_type_node)
3392 else if (type == java_short_type_node)
3394 else if (type == java_byte_type_node)
3396 else if (type == java_char_type_node)
3398 else if (type == java_long_type_node)
3400 else if (type == java_boolean_type_node)
3406 #include "gt-cp-mangle.h"