1 /* Name mangling for the 3.0 C++ ABI.
2 Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2007
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 /* An incomplete mangled name. There will be no NUL terminator. If
121 there is no incomplete mangled name, this variable is NULL. */
122 static char *partially_mangled_name
;
124 /* The number of characters in the PARTIALLY_MANGLED_NAME. */
125 static size_t partially_mangled_name_len
;
127 /* Indices into subst_identifiers. These are identifiers used in
128 special substitution rules. */
136 SUBID_BASIC_IOSTREAM
,
139 substitution_identifier_index_t
;
141 /* For quick substitution checks, look up these common identifiers
143 static GTY(()) tree subst_identifiers
[SUBID_MAX
];
145 /* Single-letter codes for builtin integer types, defined in
146 <builtin-type>. These are indexed by integer_type_kind values. */
148 integer_type_codes
[itk_none
] =
151 'a', /* itk_signed_char */
152 'h', /* itk_unsigned_char */
154 't', /* itk_unsigned_short */
156 'j', /* itk_unsigned_int */
158 'm', /* itk_unsigned_long */
159 'x', /* itk_long_long */
160 'y' /* itk_unsigned_long_long */
163 static int decl_is_template_id (const tree
, tree
* const);
165 /* Functions for handling substitutions. */
167 static inline tree
canonicalize_for_substitution (tree
);
168 static void add_substitution (tree
);
169 static inline int is_std_substitution (const tree
,
170 const substitution_identifier_index_t
);
171 static inline int is_std_substitution_char (const tree
,
172 const substitution_identifier_index_t
);
173 static int find_substitution (tree
);
174 static void mangle_call_offset (const tree
, const tree
);
176 /* Functions for emitting mangled representations of things. */
178 static void write_mangled_name (const tree
, bool);
179 static void write_encoding (const tree
);
180 static void write_name (tree
, const int);
181 static void write_unscoped_name (const tree
);
182 static void write_unscoped_template_name (const tree
);
183 static void write_nested_name (const tree
);
184 static void write_prefix (const tree
);
185 static void write_template_prefix (const tree
);
186 static void write_unqualified_name (const tree
);
187 static void write_conversion_operator_name (const tree
);
188 static void write_source_name (tree
);
189 static int hwint_to_ascii (unsigned HOST_WIDE_INT
, const unsigned int, char *,
191 static void write_number (unsigned HOST_WIDE_INT
, const int,
193 static void write_integer_cst (const tree
);
194 static void write_real_cst (const tree
);
195 static void write_identifier (const char *);
196 static void write_special_name_constructor (const tree
);
197 static void write_special_name_destructor (const tree
);
198 static void write_type (tree
);
199 static int write_CV_qualifiers_for_type (const tree
);
200 static void write_builtin_type (tree
);
201 static void write_function_type (const tree
);
202 static void write_bare_function_type (const tree
, const int, const tree
);
203 static void write_method_parms (tree
, const int, const tree
);
204 static void write_class_enum_type (const tree
);
205 static void write_template_args (tree
);
206 static void write_expression (tree
);
207 static void write_template_arg_literal (const tree
);
208 static void write_template_arg (tree
);
209 static void write_template_template_arg (const tree
);
210 static void write_array_type (const tree
);
211 static void write_pointer_to_member_type (const tree
);
212 static void write_template_param (const tree
);
213 static void write_template_template_param (const tree
);
214 static void write_substitution (const int);
215 static int discriminator_for_local_entity (tree
);
216 static int discriminator_for_string_literal (tree
, tree
);
217 static void write_discriminator (const int);
218 static void write_local_name (const tree
, const tree
, const tree
);
219 static void dump_substitution_candidates (void);
220 static const char *mangle_decl_string (const tree
);
222 /* Control functions. */
224 static inline void start_mangling (const tree
, bool);
225 static inline const char *finish_mangling (const bool);
226 static tree
mangle_special_for_type (const tree
, const char *);
228 /* Foreign language functions. */
230 static void write_java_integer_type_codes (const tree
);
232 /* Append a single character to the end of the mangled
234 #define write_char(CHAR) \
235 obstack_1grow (mangle_obstack, (CHAR))
237 /* Append a sized buffer to the end of the mangled representation. */
238 #define write_chars(CHAR, LEN) \
239 obstack_grow (mangle_obstack, (CHAR), (LEN))
241 /* Append a NUL-terminated string to the end of the mangled
243 #define write_string(STRING) \
244 obstack_grow (mangle_obstack, (STRING), strlen (STRING))
246 /* Nonzero if NODE1 and NODE2 are both TREE_LIST nodes and have the
247 same purpose (context, which may be a type) and value (template
248 decl). See write_template_prefix for more information on what this
250 #define NESTED_TEMPLATE_MATCH(NODE1, NODE2) \
251 (TREE_CODE (NODE1) == TREE_LIST \
252 && TREE_CODE (NODE2) == TREE_LIST \
253 && ((TYPE_P (TREE_PURPOSE (NODE1)) \
254 && same_type_p (TREE_PURPOSE (NODE1), TREE_PURPOSE (NODE2))) \
255 || TREE_PURPOSE (NODE1) == TREE_PURPOSE (NODE2)) \
256 && TREE_VALUE (NODE1) == TREE_VALUE (NODE2))
258 /* Write out an unsigned quantity in base 10. */
259 #define write_unsigned_number(NUMBER) \
260 write_number ((NUMBER), /*unsigned_p=*/1, 10)
262 /* Save the current (incomplete) mangled name and release the obstack
263 storage holding it. This function should be used during mangling
264 when making a call that could result in a call to get_identifier,
265 as such a call will clobber the same obstack being used for
266 mangling. This function may not be called twice without an
267 intervening call to restore_partially_mangled_name. */
270 save_partially_mangled_name (void)
272 if (mangle_obstack
== &ident_hash
->stack
)
274 gcc_assert (!partially_mangled_name
);
275 partially_mangled_name_len
= obstack_object_size (mangle_obstack
);
276 partially_mangled_name
= XNEWVEC (char, partially_mangled_name_len
);
277 memcpy (partially_mangled_name
, obstack_base (mangle_obstack
),
278 partially_mangled_name_len
);
279 obstack_free (mangle_obstack
, obstack_finish (mangle_obstack
));
283 /* Restore the incomplete mangled name saved with
284 save_partially_mangled_name. */
287 restore_partially_mangled_name (void)
289 if (partially_mangled_name
)
291 obstack_grow (mangle_obstack
, partially_mangled_name
,
292 partially_mangled_name_len
);
293 free (partially_mangled_name
);
294 partially_mangled_name
= NULL
;
298 /* If DECL is a template instance, return nonzero and, if
299 TEMPLATE_INFO is non-NULL, set *TEMPLATE_INFO to its template info.
300 Otherwise return zero. */
303 decl_is_template_id (const tree decl
, tree
* const template_info
)
305 if (TREE_CODE (decl
) == TYPE_DECL
)
307 /* TYPE_DECLs are handled specially. Look at its type to decide
308 if this is a template instantiation. */
309 const tree type
= TREE_TYPE (decl
);
311 if (CLASS_TYPE_P (type
) && CLASSTYPE_TEMPLATE_ID_P (type
))
313 if (template_info
!= NULL
)
314 /* For a templated TYPE_DECL, the template info is hanging
316 *template_info
= TYPE_TEMPLATE_INFO (type
);
322 /* Check if this is a primary template. */
323 if (DECL_LANG_SPECIFIC (decl
) != NULL
324 && DECL_USE_TEMPLATE (decl
)
325 && PRIMARY_TEMPLATE_P (DECL_TI_TEMPLATE (decl
))
326 && TREE_CODE (decl
) != TEMPLATE_DECL
)
328 if (template_info
!= NULL
)
329 /* For most templated decls, the template info is hanging
331 *template_info
= DECL_TEMPLATE_INFO (decl
);
336 /* It's not a template id. */
340 /* Produce debugging output of current substitution candidates. */
343 dump_substitution_candidates (void)
348 fprintf (stderr
, " ++ substitutions ");
349 for (i
= 0; VEC_iterate (tree
, G
.substitutions
, i
, el
); ++i
)
351 const char *name
= "???";
354 fprintf (stderr
, " ");
356 name
= IDENTIFIER_POINTER (DECL_NAME (el
));
357 else if (TREE_CODE (el
) == TREE_LIST
)
358 name
= IDENTIFIER_POINTER (DECL_NAME (TREE_VALUE (el
)));
359 else if (TYPE_NAME (el
))
360 name
= IDENTIFIER_POINTER (DECL_NAME (TYPE_NAME (el
)));
361 fprintf (stderr
, " S%d_ = ", i
- 1);
363 (CP_TYPE_RESTRICT_P (el
)
364 || CP_TYPE_VOLATILE_P (el
)
365 || CP_TYPE_CONST_P (el
)))
366 fprintf (stderr
, "CV-");
367 fprintf (stderr
, "%s (%s at %p)\n",
368 name
, tree_code_name
[TREE_CODE (el
)], (void *) el
);
372 /* Both decls and types can be substitution candidates, but sometimes
373 they refer to the same thing. For instance, a TYPE_DECL and
374 RECORD_TYPE for the same class refer to the same thing, and should
375 be treated accordingly in substitutions. This function returns a
376 canonicalized tree node representing NODE that is used when adding
377 and substitution candidates and finding matches. */
380 canonicalize_for_substitution (tree node
)
382 /* For a TYPE_DECL, use the type instead. */
383 if (TREE_CODE (node
) == TYPE_DECL
)
384 node
= TREE_TYPE (node
);
386 node
= canonical_type_variant (node
);
391 /* Add NODE as a substitution candidate. NODE must not already be on
392 the list of candidates. */
395 add_substitution (tree node
)
400 fprintf (stderr
, " ++ add_substitution (%s at %10p)\n",
401 tree_code_name
[TREE_CODE (node
)], (void *) node
);
403 /* Get the canonicalized substitution candidate for NODE. */
404 c
= canonicalize_for_substitution (node
);
405 if (DEBUG_MANGLE
&& c
!= node
)
406 fprintf (stderr
, " ++ using candidate (%s at %10p)\n",
407 tree_code_name
[TREE_CODE (node
)], (void *) node
);
411 /* Make sure NODE isn't already a candidate. */
416 for (i
= 0; VEC_iterate (tree
, G
.substitutions
, i
, candidate
); i
++)
418 gcc_assert (!(DECL_P (node
) && node
== candidate
));
419 gcc_assert (!(TYPE_P (node
) && TYPE_P (candidate
)
420 && same_type_p (node
, candidate
)));
423 #endif /* ENABLE_CHECKING */
425 /* Put the decl onto the varray of substitution candidates. */
426 VEC_safe_push (tree
, gc
, G
.substitutions
, node
);
429 dump_substitution_candidates ();
432 /* Helper function for find_substitution. Returns nonzero if NODE,
433 which may be a decl or a CLASS_TYPE, is a template-id with template
434 name of substitution_index[INDEX] in the ::std namespace. */
437 is_std_substitution (const tree node
,
438 const substitution_identifier_index_t index
)
445 type
= TREE_TYPE (node
);
448 else if (CLASS_TYPE_P (node
))
451 decl
= TYPE_NAME (node
);
454 /* These are not the droids you're looking for. */
457 return (DECL_NAMESPACE_STD_P (CP_DECL_CONTEXT (decl
))
458 && TYPE_LANG_SPECIFIC (type
)
459 && TYPE_TEMPLATE_INFO (type
)
460 && (DECL_NAME (TYPE_TI_TEMPLATE (type
))
461 == subst_identifiers
[index
]));
464 /* Helper function for find_substitution. Returns nonzero if NODE,
465 which may be a decl or a CLASS_TYPE, is the template-id
466 ::std::identifier<char>, where identifier is
467 substitution_index[INDEX]. */
470 is_std_substitution_char (const tree node
,
471 const substitution_identifier_index_t index
)
474 /* Check NODE's name is ::std::identifier. */
475 if (!is_std_substitution (node
, index
))
477 /* Figure out its template args. */
479 args
= DECL_TI_ARGS (node
);
480 else if (CLASS_TYPE_P (node
))
481 args
= CLASSTYPE_TI_ARGS (node
);
483 /* Oops, not a template. */
485 /* NODE's template arg list should be <char>. */
487 TREE_VEC_LENGTH (args
) == 1
488 && TREE_VEC_ELT (args
, 0) == char_type_node
;
491 /* Check whether a substitution should be used to represent NODE in
494 First, check standard special-case substitutions.
496 <substitution> ::= St
503 # ::std::basic_string
506 # ::std::basic_string<char,
507 ::std::char_traits<char>,
508 ::std::allocator<char> >
511 # ::std::basic_istream<char, ::std::char_traits<char> >
514 # ::std::basic_ostream<char, ::std::char_traits<char> >
517 # ::std::basic_iostream<char, ::std::char_traits<char> >
519 Then examine the stack of currently available substitution
520 candidates for entities appearing earlier in the same mangling
522 If a substitution is found, write its mangled representation and
523 return nonzero. If none is found, just return zero. */
526 find_substitution (tree node
)
529 const int size
= VEC_length (tree
, G
.substitutions
);
534 fprintf (stderr
, " ++ find_substitution (%s at %p)\n",
535 tree_code_name
[TREE_CODE (node
)], (void *) node
);
537 /* Obtain the canonicalized substitution representation for NODE.
538 This is what we'll compare against. */
539 node
= canonicalize_for_substitution (node
);
541 /* Check for builtin substitutions. */
543 decl
= TYPE_P (node
) ? TYPE_NAME (node
) : node
;
544 type
= TYPE_P (node
) ? node
: TREE_TYPE (node
);
546 /* Check for std::allocator. */
548 && is_std_substitution (decl
, SUBID_ALLOCATOR
)
549 && !CLASSTYPE_USE_TEMPLATE (TREE_TYPE (decl
)))
555 /* Check for std::basic_string. */
556 if (decl
&& is_std_substitution (decl
, SUBID_BASIC_STRING
))
560 /* If this is a type (i.e. a fully-qualified template-id),
562 std::basic_string <char,
563 std::char_traits<char>,
564 std::allocator<char> > . */
565 if (cp_type_quals (type
) == TYPE_UNQUALIFIED
566 && CLASSTYPE_USE_TEMPLATE (type
))
568 tree args
= CLASSTYPE_TI_ARGS (type
);
569 if (TREE_VEC_LENGTH (args
) == 3
570 && same_type_p (TREE_VEC_ELT (args
, 0), char_type_node
)
571 && is_std_substitution_char (TREE_VEC_ELT (args
, 1),
573 && is_std_substitution_char (TREE_VEC_ELT (args
, 2),
582 /* Substitute for the template name only if this isn't a type. */
589 /* Check for basic_{i,o,io}stream. */
591 && cp_type_quals (type
) == TYPE_UNQUALIFIED
592 && CLASS_TYPE_P (type
)
593 && CLASSTYPE_USE_TEMPLATE (type
)
594 && CLASSTYPE_TEMPLATE_INFO (type
) != NULL
)
596 /* First, check for the template
597 args <char, std::char_traits<char> > . */
598 tree args
= CLASSTYPE_TI_ARGS (type
);
599 if (TREE_VEC_LENGTH (args
) == 2
600 && TYPE_P (TREE_VEC_ELT (args
, 0))
601 && same_type_p (TREE_VEC_ELT (args
, 0), char_type_node
)
602 && is_std_substitution_char (TREE_VEC_ELT (args
, 1),
605 /* Got them. Is this basic_istream? */
606 if (is_std_substitution (decl
, SUBID_BASIC_ISTREAM
))
611 /* Or basic_ostream? */
612 else if (is_std_substitution (decl
, SUBID_BASIC_OSTREAM
))
617 /* Or basic_iostream? */
618 else if (is_std_substitution (decl
, SUBID_BASIC_IOSTREAM
))
626 /* Check for namespace std. */
627 if (decl
&& DECL_NAMESPACE_STD_P (decl
))
633 /* Now check the list of available substitutions for this mangling
635 for (i
= 0; i
< size
; ++i
)
637 tree candidate
= VEC_index (tree
, G
.substitutions
, i
);
638 /* NODE is a matched to a candidate if it's the same decl node or
639 if it's the same type. */
640 if (decl
== candidate
641 || (TYPE_P (candidate
) && type
&& TYPE_P (type
)
642 && same_type_p (type
, candidate
))
643 || NESTED_TEMPLATE_MATCH (node
, candidate
))
645 write_substitution (i
);
650 /* No substitution found. */
655 /* TOP_LEVEL is true, if this is being called at outermost level of
656 mangling. It should be false when mangling a decl appearing in an
657 expression within some other mangling.
659 <mangled-name> ::= _Z <encoding> */
662 write_mangled_name (const tree decl
, bool top_level
)
664 MANGLE_TRACE_TREE ("mangled-name", decl
);
666 if (/* The names of `extern "C"' functions are not mangled. */
667 DECL_EXTERN_C_FUNCTION_P (decl
)
668 /* But overloaded operator names *are* mangled. */
669 && !DECL_OVERLOADED_OPERATOR_P (decl
))
674 write_string (IDENTIFIER_POINTER (DECL_NAME (decl
)));
677 /* The standard notes: "The <encoding> of an extern "C"
678 function is treated like global-scope data, i.e. as its
679 <source-name> without a type." We cannot write
680 overloaded operators that way though, because it contains
681 characters invalid in assembler. */
682 if (abi_version_at_least (2))
685 G
.need_abi_warning
= true;
686 write_source_name (DECL_NAME (decl
));
689 else if (TREE_CODE (decl
) == VAR_DECL
690 /* The names of non-static global variables aren't mangled. */
691 && DECL_EXTERNAL_LINKAGE_P (decl
)
692 && (CP_DECL_CONTEXT (decl
) == global_namespace
693 /* And neither are `extern "C"' variables. */
694 || DECL_EXTERN_C_P (decl
)))
696 if (top_level
|| abi_version_at_least (2))
700 G
.need_abi_warning
= true;
708 write_encoding (decl
);
709 if (DECL_LANG_SPECIFIC (decl
)
710 && (DECL_MAYBE_IN_CHARGE_DESTRUCTOR_P (decl
)
711 || DECL_MAYBE_IN_CHARGE_CONSTRUCTOR_P (decl
)))
712 /* We need a distinct mangled name for these entities, but
713 we should never actually output it. So, we append some
714 characters the assembler won't like. */
715 write_string (" *INTERNAL* ");
719 /* <encoding> ::= <function name> <bare-function-type>
723 write_encoding (const tree decl
)
725 MANGLE_TRACE_TREE ("encoding", decl
);
727 if (DECL_LANG_SPECIFIC (decl
) && DECL_EXTERN_C_FUNCTION_P (decl
))
729 /* For overloaded operators write just the mangled name
730 without arguments. */
731 if (DECL_OVERLOADED_OPERATOR_P (decl
))
732 write_name (decl
, /*ignore_local_scope=*/0);
734 write_source_name (DECL_NAME (decl
));
738 write_name (decl
, /*ignore_local_scope=*/0);
739 if (TREE_CODE (decl
) == FUNCTION_DECL
)
744 if (decl_is_template_id (decl
, NULL
))
746 save_partially_mangled_name ();
747 fn_type
= get_mostly_instantiated_function_type (decl
);
748 restore_partially_mangled_name ();
749 /* FN_TYPE will not have parameter types for in-charge or
750 VTT parameters. Therefore, we pass NULL_TREE to
751 write_bare_function_type -- otherwise, it will get
752 confused about which artificial parameters to skip. */
757 fn_type
= TREE_TYPE (decl
);
761 write_bare_function_type (fn_type
,
762 (!DECL_CONSTRUCTOR_P (decl
)
763 && !DECL_DESTRUCTOR_P (decl
)
764 && !DECL_CONV_FN_P (decl
)
765 && decl_is_template_id (decl
, NULL
)),
770 /* <name> ::= <unscoped-name>
771 ::= <unscoped-template-name> <template-args>
775 If IGNORE_LOCAL_SCOPE is nonzero, this production of <name> is
776 called from <local-name>, which mangles the enclosing scope
777 elsewhere and then uses this function to mangle just the part
778 underneath the function scope. So don't use the <local-name>
779 production, to avoid an infinite recursion. */
782 write_name (tree decl
, const int ignore_local_scope
)
786 MANGLE_TRACE_TREE ("name", decl
);
788 if (TREE_CODE (decl
) == TYPE_DECL
)
790 /* In case this is a typedef, fish out the corresponding
791 TYPE_DECL for the main variant. */
792 decl
= TYPE_NAME (TYPE_MAIN_VARIANT (TREE_TYPE (decl
)));
793 context
= TYPE_CONTEXT (TYPE_MAIN_VARIANT (TREE_TYPE (decl
)));
796 context
= (DECL_CONTEXT (decl
) == NULL
) ? NULL
: CP_DECL_CONTEXT (decl
);
798 /* A decl in :: or ::std scope is treated specially. The former is
799 mangled using <unscoped-name> or <unscoped-template-name>, the
800 latter with a special substitution. Also, a name that is
801 directly in a local function scope is also mangled with
802 <unscoped-name> rather than a full <nested-name>. */
804 || context
== global_namespace
805 || DECL_NAMESPACE_STD_P (context
)
806 || (ignore_local_scope
&& TREE_CODE (context
) == FUNCTION_DECL
))
809 /* Is this a template instance? */
810 if (decl_is_template_id (decl
, &template_info
))
812 /* Yes: use <unscoped-template-name>. */
813 write_unscoped_template_name (TI_TEMPLATE (template_info
));
814 write_template_args (TI_ARGS (template_info
));
817 /* Everything else gets an <unqualified-name>. */
818 write_unscoped_name (decl
);
822 /* Handle local names, unless we asked not to (that is, invoked
823 under <local-name>, to handle only the part of the name under
825 if (!ignore_local_scope
)
827 /* Scan up the list of scope context, looking for a
828 function. If we find one, this entity is in local
829 function scope. local_entity tracks context one scope
830 level down, so it will contain the element that's
831 directly in that function's scope, either decl or one of
832 its enclosing scopes. */
833 tree local_entity
= decl
;
834 while (context
!= NULL
&& context
!= global_namespace
)
836 /* Make sure we're always dealing with decls. */
837 if (context
!= NULL
&& TYPE_P (context
))
838 context
= TYPE_NAME (context
);
839 /* Is this a function? */
840 if (TREE_CODE (context
) == FUNCTION_DECL
)
842 /* Yes, we have local scope. Use the <local-name>
843 production for the innermost function scope. */
844 write_local_name (context
, local_entity
, decl
);
847 /* Up one scope level. */
848 local_entity
= context
;
849 context
= CP_DECL_CONTEXT (context
);
852 /* No local scope found? Fall through to <nested-name>. */
855 /* Other decls get a <nested-name> to encode their scope. */
856 write_nested_name (decl
);
860 /* <unscoped-name> ::= <unqualified-name>
861 ::= St <unqualified-name> # ::std:: */
864 write_unscoped_name (const tree decl
)
866 tree context
= CP_DECL_CONTEXT (decl
);
868 MANGLE_TRACE_TREE ("unscoped-name", decl
);
870 /* Is DECL in ::std? */
871 if (DECL_NAMESPACE_STD_P (context
))
874 write_unqualified_name (decl
);
878 /* If not, it should be either in the global namespace, or directly
879 in a local function scope. */
880 gcc_assert (context
== global_namespace
882 || TREE_CODE (context
) == FUNCTION_DECL
);
884 write_unqualified_name (decl
);
888 /* <unscoped-template-name> ::= <unscoped-name>
889 ::= <substitution> */
892 write_unscoped_template_name (const tree decl
)
894 MANGLE_TRACE_TREE ("unscoped-template-name", decl
);
896 if (find_substitution (decl
))
898 write_unscoped_name (decl
);
899 add_substitution (decl
);
902 /* Write the nested name, including CV-qualifiers, of DECL.
904 <nested-name> ::= N [<CV-qualifiers>] <prefix> <unqualified-name> E
905 ::= N [<CV-qualifiers>] <template-prefix> <template-args> E
907 <CV-qualifiers> ::= [r] [V] [K] */
910 write_nested_name (const tree decl
)
914 MANGLE_TRACE_TREE ("nested-name", decl
);
918 /* Write CV-qualifiers, if this is a member function. */
919 if (TREE_CODE (decl
) == FUNCTION_DECL
920 && DECL_NONSTATIC_MEMBER_FUNCTION_P (decl
))
922 if (DECL_VOLATILE_MEMFUNC_P (decl
))
924 if (DECL_CONST_MEMFUNC_P (decl
))
928 /* Is this a template instance? */
929 if (decl_is_template_id (decl
, &template_info
))
931 /* Yes, use <template-prefix>. */
932 write_template_prefix (decl
);
933 write_template_args (TI_ARGS (template_info
));
937 /* No, just use <prefix> */
938 write_prefix (DECL_CONTEXT (decl
));
939 write_unqualified_name (decl
);
944 /* <prefix> ::= <prefix> <unqualified-name>
946 ::= <template-prefix> <template-args>
948 ::= <substitution> */
951 write_prefix (const tree node
)
954 /* Non-NULL if NODE represents a template-id. */
955 tree template_info
= NULL
;
957 MANGLE_TRACE_TREE ("prefix", node
);
960 || node
== global_namespace
)
963 if (find_substitution (node
))
968 /* If this is a function decl, that means we've hit function
969 scope, so this prefix must be for a local name. In this
970 case, we're under the <local-name> production, which encodes
971 the enclosing function scope elsewhere. So don't continue
973 if (TREE_CODE (node
) == FUNCTION_DECL
)
977 decl_is_template_id (decl
, &template_info
);
981 /* Node is a type. */
982 decl
= TYPE_NAME (node
);
983 if (CLASSTYPE_TEMPLATE_ID_P (node
))
984 template_info
= TYPE_TEMPLATE_INFO (node
);
987 /* In G++ 3.2, the name of the template parameter was used. */
988 if (TREE_CODE (node
) == TEMPLATE_TYPE_PARM
989 && !abi_version_at_least (2))
990 G
.need_abi_warning
= true;
992 if (TREE_CODE (node
) == TEMPLATE_TYPE_PARM
993 && abi_version_at_least (2))
994 write_template_param (node
);
995 else if (template_info
!= NULL
)
998 write_template_prefix (decl
);
999 write_template_args (TI_ARGS (template_info
));
1002 /* Not templated. */
1004 write_prefix (CP_DECL_CONTEXT (decl
));
1005 write_unqualified_name (decl
);
1008 add_substitution (node
);
1011 /* <template-prefix> ::= <prefix> <template component>
1012 ::= <template-param>
1013 ::= <substitution> */
1016 write_template_prefix (const tree node
)
1018 tree decl
= DECL_P (node
) ? node
: TYPE_NAME (node
);
1019 tree type
= DECL_P (node
) ? TREE_TYPE (node
) : node
;
1020 tree context
= CP_DECL_CONTEXT (decl
);
1025 MANGLE_TRACE_TREE ("template-prefix", node
);
1027 /* Find the template decl. */
1028 if (decl_is_template_id (decl
, &template_info
))
1029 template = TI_TEMPLATE (template_info
);
1032 gcc_assert (CLASSTYPE_TEMPLATE_ID_P (type
));
1034 template = TYPE_TI_TEMPLATE (type
);
1037 /* For a member template, though, the template name for the
1038 innermost name must have all the outer template levels
1039 instantiated. For instance, consider
1041 template<typename T> struct Outer {
1042 template<typename U> struct Inner {};
1045 The template name for `Inner' in `Outer<int>::Inner<float>' is
1046 `Outer<int>::Inner<U>'. In g++, we don't instantiate the template
1047 levels separately, so there's no TEMPLATE_DECL available for this
1048 (there's only `Outer<T>::Inner<U>').
1050 In order to get the substitutions right, we create a special
1051 TREE_LIST to represent the substitution candidate for a nested
1052 template. The TREE_PURPOSE is the template's context, fully
1053 instantiated, and the TREE_VALUE is the TEMPLATE_DECL for the inner
1056 So, for the example above, `Outer<int>::Inner' is represented as a
1057 substitution candidate by a TREE_LIST whose purpose is `Outer<int>'
1058 and whose value is `Outer<T>::Inner<U>'. */
1059 if (TYPE_P (context
))
1060 substitution
= build_tree_list (context
, template);
1062 substitution
= template;
1064 if (find_substitution (substitution
))
1067 /* In G++ 3.2, the name of the template template parameter was used. */
1068 if (TREE_CODE (TREE_TYPE (template)) == TEMPLATE_TEMPLATE_PARM
1069 && !abi_version_at_least (2))
1070 G
.need_abi_warning
= true;
1072 if (TREE_CODE (TREE_TYPE (template)) == TEMPLATE_TEMPLATE_PARM
1073 && abi_version_at_least (2))
1074 write_template_param (TREE_TYPE (template));
1077 write_prefix (context
);
1078 write_unqualified_name (decl
);
1081 add_substitution (substitution
);
1084 /* We don't need to handle thunks, vtables, or VTTs here. Those are
1085 mangled through special entry points.
1087 <unqualified-name> ::= <operator-name>
1090 ::= <local-source-name>
1092 <local-source-name> ::= L <source-name> <discriminator> */
1095 write_unqualified_name (const tree decl
)
1097 MANGLE_TRACE_TREE ("unqualified-name", decl
);
1099 if (DECL_LANG_SPECIFIC (decl
) != NULL
&& DECL_CONSTRUCTOR_P (decl
))
1100 write_special_name_constructor (decl
);
1101 else if (DECL_LANG_SPECIFIC (decl
) != NULL
&& DECL_DESTRUCTOR_P (decl
))
1102 write_special_name_destructor (decl
);
1103 else if (DECL_NAME (decl
) == NULL_TREE
)
1104 write_source_name (DECL_ASSEMBLER_NAME (decl
));
1105 else if (DECL_CONV_FN_P (decl
))
1107 /* Conversion operator. Handle it right here.
1108 <operator> ::= cv <type> */
1110 if (decl_is_template_id (decl
, NULL
))
1113 save_partially_mangled_name ();
1114 fn_type
= get_mostly_instantiated_function_type (decl
);
1115 restore_partially_mangled_name ();
1116 type
= TREE_TYPE (fn_type
);
1119 type
= DECL_CONV_FN_TYPE (decl
);
1120 write_conversion_operator_name (type
);
1122 else if (DECL_OVERLOADED_OPERATOR_P (decl
))
1124 operator_name_info_t
*oni
;
1125 if (DECL_ASSIGNMENT_OPERATOR_P (decl
))
1126 oni
= assignment_operator_name_info
;
1128 oni
= operator_name_info
;
1130 write_string (oni
[DECL_OVERLOADED_OPERATOR_P (decl
)].mangled_name
);
1132 else if (VAR_OR_FUNCTION_DECL_P (decl
) && ! TREE_PUBLIC (decl
)
1133 && DECL_NAMESPACE_SCOPE_P (decl
)
1134 && decl_linkage (decl
) == lk_internal
)
1136 MANGLE_TRACE_TREE ("local-source-name", decl
);
1138 write_source_name (DECL_NAME (decl
));
1139 /* The default discriminator is 1, and that's all we ever use,
1140 so there's no code to output one here. */
1143 write_source_name (DECL_NAME (decl
));
1146 /* Write the unqualified-name for a conversion operator to TYPE. */
1149 write_conversion_operator_name (const tree type
)
1151 write_string ("cv");
1155 /* Non-terminal <source-name>. IDENTIFIER is an IDENTIFIER_NODE.
1157 <source-name> ::= </length/ number> <identifier> */
1160 write_source_name (tree identifier
)
1162 MANGLE_TRACE_TREE ("source-name", identifier
);
1164 /* Never write the whole template-id name including the template
1165 arguments; we only want the template name. */
1166 if (IDENTIFIER_TEMPLATE (identifier
))
1167 identifier
= IDENTIFIER_TEMPLATE (identifier
);
1169 write_unsigned_number (IDENTIFIER_LENGTH (identifier
));
1170 write_identifier (IDENTIFIER_POINTER (identifier
));
1173 /* Convert NUMBER to ascii using base BASE and generating at least
1174 MIN_DIGITS characters. BUFFER points to the _end_ of the buffer
1175 into which to store the characters. Returns the number of
1176 characters generated (these will be layed out in advance of where
1180 hwint_to_ascii (unsigned HOST_WIDE_INT number
, const unsigned int base
,
1181 char *buffer
, const unsigned int min_digits
)
1183 static const char base_digits
[] = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ";
1184 unsigned digits
= 0;
1188 unsigned HOST_WIDE_INT d
= number
/ base
;
1190 *--buffer
= base_digits
[number
- d
* base
];
1194 while (digits
< min_digits
)
1196 *--buffer
= base_digits
[0];
1202 /* Non-terminal <number>.
1204 <number> ::= [n] </decimal integer/> */
1207 write_number (unsigned HOST_WIDE_INT number
, const int unsigned_p
,
1208 const unsigned int base
)
1210 char buffer
[sizeof (HOST_WIDE_INT
) * 8];
1213 if (!unsigned_p
&& (HOST_WIDE_INT
) number
< 0)
1216 number
= -((HOST_WIDE_INT
) number
);
1218 count
= hwint_to_ascii (number
, base
, buffer
+ sizeof (buffer
), 1);
1219 write_chars (buffer
+ sizeof (buffer
) - count
, count
);
1222 /* Write out an integral CST in decimal. Most numbers are small, and
1223 representable in a HOST_WIDE_INT. Occasionally we'll have numbers
1224 bigger than that, which we must deal with. */
1227 write_integer_cst (const tree cst
)
1229 int sign
= tree_int_cst_sgn (cst
);
1231 if (TREE_INT_CST_HIGH (cst
) + (sign
< 0))
1233 /* A bignum. We do this in chunks, each of which fits in a
1235 char buffer
[sizeof (HOST_WIDE_INT
) * 8 * 2];
1236 unsigned HOST_WIDE_INT chunk
;
1237 unsigned chunk_digits
;
1238 char *ptr
= buffer
+ sizeof (buffer
);
1243 /* HOST_WIDE_INT must be at least 32 bits, so 10^9 is
1248 if (sizeof (HOST_WIDE_INT
) >= 8)
1250 /* It is at least 64 bits, so 10^18 is representable. */
1255 type
= c_common_signed_or_unsigned_type (1, TREE_TYPE (cst
));
1256 base
= build_int_cstu (type
, chunk
);
1257 n
= build_int_cst_wide (type
,
1258 TREE_INT_CST_LOW (cst
), TREE_INT_CST_HIGH (cst
));
1263 n
= fold_build1 (NEGATE_EXPR
, type
, n
);
1267 tree d
= fold_build2 (FLOOR_DIV_EXPR
, type
, n
, base
);
1268 tree tmp
= fold_build2 (MULT_EXPR
, type
, d
, base
);
1271 done
= integer_zerop (d
);
1272 tmp
= fold_build2 (MINUS_EXPR
, type
, n
, tmp
);
1273 c
= hwint_to_ascii (TREE_INT_CST_LOW (tmp
), 10, ptr
,
1274 done
? 1 : chunk_digits
);
1280 write_chars (ptr
, count
);
1285 unsigned HOST_WIDE_INT low
= TREE_INT_CST_LOW (cst
);
1292 write_unsigned_number (low
);
1296 /* Write out a floating-point literal.
1298 "Floating-point literals are encoded using the bit pattern of the
1299 target processor's internal representation of that number, as a
1300 fixed-length lowercase hexadecimal string, high-order bytes first
1301 (even if the target processor would store low-order bytes first).
1302 The "n" prefix is not used for floating-point literals; the sign
1303 bit is encoded with the rest of the number.
1305 Here are some examples, assuming the IEEE standard representation
1306 for floating point numbers. (Spaces are for readability, not
1307 part of the encoding.)
1310 -1.0f Lf bf80 0000 E
1311 1.17549435e-38f Lf 0080 0000 E
1312 1.40129846e-45f Lf 0000 0001 E
1313 0.0f Lf 0000 0000 E"
1315 Caller is responsible for the Lx and the E. */
1317 write_real_cst (const tree value
)
1319 if (abi_version_at_least (2))
1321 long target_real
[4]; /* largest supported float */
1322 char buffer
[9]; /* eight hex digits in a 32-bit number */
1325 tree type
= TREE_TYPE (value
);
1326 int words
= GET_MODE_BITSIZE (TYPE_MODE (type
)) / 32;
1328 real_to_target (target_real
, &TREE_REAL_CST (value
),
1331 /* The value in target_real is in the target word order,
1332 so we must write it out backward if that happens to be
1333 little-endian. write_number cannot be used, it will
1334 produce uppercase. */
1335 if (FLOAT_WORDS_BIG_ENDIAN
)
1336 i
= 0, limit
= words
, dir
= 1;
1338 i
= words
- 1, limit
= -1, dir
= -1;
1340 for (; i
!= limit
; i
+= dir
)
1342 sprintf (buffer
, "%08lx", (unsigned long) target_real
[i
]);
1343 write_chars (buffer
, 8);
1348 /* In G++ 3.3 and before the REAL_VALUE_TYPE was written out
1349 literally. Note that compatibility with 3.2 is impossible,
1350 because the old floating-point emulator used a different
1351 format for REAL_VALUE_TYPE. */
1353 for (i
= 0; i
< sizeof (TREE_REAL_CST (value
)); ++i
)
1354 write_number (((unsigned char *) &TREE_REAL_CST (value
))[i
],
1357 G
.need_abi_warning
= 1;
1361 /* Non-terminal <identifier>.
1363 <identifier> ::= </unqualified source code identifier> */
1366 write_identifier (const char *identifier
)
1368 MANGLE_TRACE ("identifier", identifier
);
1369 write_string (identifier
);
1372 /* Handle constructor productions of non-terminal <special-name>.
1373 CTOR is a constructor FUNCTION_DECL.
1375 <special-name> ::= C1 # complete object constructor
1376 ::= C2 # base object constructor
1377 ::= C3 # complete object allocating constructor
1379 Currently, allocating constructors are never used.
1381 We also need to provide mangled names for the maybe-in-charge
1382 constructor, so we treat it here too. mangle_decl_string will
1383 append *INTERNAL* to that, to make sure we never emit it. */
1386 write_special_name_constructor (const tree ctor
)
1388 if (DECL_BASE_CONSTRUCTOR_P (ctor
))
1389 write_string ("C2");
1392 gcc_assert (DECL_COMPLETE_CONSTRUCTOR_P (ctor
)
1393 /* Even though we don't ever emit a definition of
1394 the old-style destructor, we still have to
1395 consider entities (like static variables) nested
1397 || DECL_MAYBE_IN_CHARGE_CONSTRUCTOR_P (ctor
));
1398 write_string ("C1");
1402 /* Handle destructor productions of non-terminal <special-name>.
1403 DTOR is a destructor FUNCTION_DECL.
1405 <special-name> ::= D0 # deleting (in-charge) destructor
1406 ::= D1 # complete object (in-charge) destructor
1407 ::= D2 # base object (not-in-charge) destructor
1409 We also need to provide mangled names for the maybe-incharge
1410 destructor, so we treat it here too. mangle_decl_string will
1411 append *INTERNAL* to that, to make sure we never emit it. */
1414 write_special_name_destructor (const tree dtor
)
1416 if (DECL_DELETING_DESTRUCTOR_P (dtor
))
1417 write_string ("D0");
1418 else if (DECL_BASE_DESTRUCTOR_P (dtor
))
1419 write_string ("D2");
1422 gcc_assert (DECL_COMPLETE_DESTRUCTOR_P (dtor
)
1423 /* Even though we don't ever emit a definition of
1424 the old-style destructor, we still have to
1425 consider entities (like static variables) nested
1427 || DECL_MAYBE_IN_CHARGE_DESTRUCTOR_P (dtor
));
1428 write_string ("D1");
1432 /* Return the discriminator for ENTITY appearing inside
1433 FUNCTION. The discriminator is the lexical ordinal of VAR among
1434 entities with the same name in the same FUNCTION. */
1437 discriminator_for_local_entity (tree entity
)
1439 /* Assume this is the only local entity with this name. */
1440 int discriminator
= 0;
1442 if (DECL_DISCRIMINATOR_P (entity
) && DECL_LANG_SPECIFIC (entity
))
1443 discriminator
= DECL_DISCRIMINATOR (entity
);
1444 else if (TREE_CODE (entity
) == TYPE_DECL
)
1448 /* Scan the list of local classes. */
1449 entity
= TREE_TYPE (entity
);
1450 for (ix
= 0; ; ix
++)
1452 tree type
= VEC_index (tree
, local_classes
, ix
);
1455 if (TYPE_IDENTIFIER (type
) == TYPE_IDENTIFIER (entity
)
1456 && TYPE_CONTEXT (type
) == TYPE_CONTEXT (entity
))
1461 return discriminator
;
1464 /* Return the discriminator for STRING, a string literal used inside
1465 FUNCTION. The discriminator is the lexical ordinal of STRING among
1466 string literals used in FUNCTION. */
1469 discriminator_for_string_literal (tree function ATTRIBUTE_UNUSED
,
1470 tree string ATTRIBUTE_UNUSED
)
1472 /* For now, we don't discriminate amongst string literals. */
1476 /* <discriminator> := _ <number>
1478 The discriminator is used only for the second and later occurrences
1479 of the same name within a single function. In this case <number> is
1480 n - 2, if this is the nth occurrence, in lexical order. */
1483 write_discriminator (const int discriminator
)
1485 /* If discriminator is zero, don't write anything. Otherwise... */
1486 if (discriminator
> 0)
1489 write_unsigned_number (discriminator
- 1);
1493 /* Mangle the name of a function-scope entity. FUNCTION is the
1494 FUNCTION_DECL for the enclosing function. ENTITY is the decl for
1495 the entity itself. LOCAL_ENTITY is the entity that's directly
1496 scoped in FUNCTION_DECL, either ENTITY itself or an enclosing scope
1499 <local-name> := Z <function encoding> E <entity name> [<discriminator>]
1500 := Z <function encoding> E s [<discriminator>] */
1503 write_local_name (const tree function
, const tree local_entity
,
1506 MANGLE_TRACE_TREE ("local-name", entity
);
1509 write_encoding (function
);
1511 if (TREE_CODE (entity
) == STRING_CST
)
1514 write_discriminator (discriminator_for_string_literal (function
,
1519 /* Now the <entity name>. Let write_name know its being called
1520 from <local-name>, so it doesn't try to process the enclosing
1521 function scope again. */
1522 write_name (entity
, /*ignore_local_scope=*/1);
1523 write_discriminator (discriminator_for_local_entity (local_entity
));
1527 /* Non-terminals <type> and <CV-qualifier>.
1529 <type> ::= <builtin-type>
1531 ::= <class-enum-type>
1533 ::= <pointer-to-member-type>
1534 ::= <template-param>
1537 ::= P <type> # pointer-to
1538 ::= R <type> # reference-to
1539 ::= C <type> # complex pair (C 2000)
1540 ::= G <type> # imaginary (C 2000) [not supported]
1541 ::= U <source-name> <type> # vendor extended type qualifier
1545 <type> ::= RR <type> # rvalue reference-to
1546 <type> ::= Dt <expression> # decltype of an id-expression or
1547 # class member access
1548 <type> ::= DT <expression> # decltype of an expression
1550 TYPE is a type node. */
1553 write_type (tree type
)
1555 /* This gets set to nonzero if TYPE turns out to be a (possibly
1556 CV-qualified) builtin type. */
1557 int is_builtin_type
= 0;
1559 MANGLE_TRACE_TREE ("type", type
);
1561 if (type
== error_mark_node
)
1564 if (find_substitution (type
))
1567 if (write_CV_qualifiers_for_type (type
) > 0)
1568 /* If TYPE was CV-qualified, we just wrote the qualifiers; now
1569 mangle the unqualified type. The recursive call is needed here
1570 since both the qualified and unqualified types are substitution
1572 write_type (TYPE_MAIN_VARIANT (type
));
1573 else if (TREE_CODE (type
) == ARRAY_TYPE
)
1574 /* It is important not to use the TYPE_MAIN_VARIANT of TYPE here
1575 so that the cv-qualification of the element type is available
1576 in write_array_type. */
1577 write_array_type (type
);
1580 tree type_orig
= type
;
1582 /* See through any typedefs. */
1583 type
= TYPE_MAIN_VARIANT (type
);
1585 if (TYPE_PTRMEM_P (type
))
1586 write_pointer_to_member_type (type
);
1589 /* Handle any target-specific fundamental types. */
1590 const char *target_mangling
1591 = targetm
.mangle_type (type_orig
);
1593 if (target_mangling
)
1595 write_string (target_mangling
);
1599 switch (TREE_CODE (type
))
1603 case INTEGER_TYPE
: /* Includes wchar_t. */
1606 /* If this is a typedef, TYPE may not be one of
1607 the standard builtin type nodes, but an alias of one. Use
1608 TYPE_MAIN_VARIANT to get to the underlying builtin type. */
1609 write_builtin_type (TYPE_MAIN_VARIANT (type
));
1616 write_type (TREE_TYPE (type
));
1621 write_function_type (type
);
1627 /* A pointer-to-member function is represented as a special
1628 RECORD_TYPE, so check for this first. */
1629 if (TYPE_PTRMEMFUNC_P (type
))
1630 write_pointer_to_member_type (type
);
1632 write_class_enum_type (type
);
1636 case UNBOUND_CLASS_TEMPLATE
:
1637 /* We handle TYPENAME_TYPEs and UNBOUND_CLASS_TEMPLATEs like
1638 ordinary nested names. */
1639 write_nested_name (TYPE_STUB_DECL (type
));
1644 write_type (TREE_TYPE (type
));
1647 case REFERENCE_TYPE
:
1648 if (TYPE_REF_IS_RVALUE (type
))
1652 write_type (TREE_TYPE (type
));
1655 case TEMPLATE_TYPE_PARM
:
1656 case TEMPLATE_PARM_INDEX
:
1657 write_template_param (type
);
1660 case TEMPLATE_TEMPLATE_PARM
:
1661 write_template_template_param (type
);
1664 case BOUND_TEMPLATE_TEMPLATE_PARM
:
1665 write_template_template_param (type
);
1667 (TI_ARGS (TEMPLATE_TEMPLATE_PARM_TEMPLATE_INFO (type
)));
1671 write_string ("U8__vector");
1672 write_type (TREE_TYPE (type
));
1675 case TYPE_PACK_EXPANSION
:
1676 write_string ("U10__variadic");
1677 write_type (PACK_EXPANSION_PATTERN (type
));
1682 if (DECLTYPE_TYPE_ID_EXPR_OR_MEMBER_ACCESS_P (type
))
1686 write_expression (DECLTYPE_TYPE_EXPR (type
));
1696 /* Types other than builtin types are substitution candidates. */
1697 if (!is_builtin_type
)
1698 add_substitution (type
);
1701 /* Non-terminal <CV-qualifiers> for type nodes. Returns the number of
1702 CV-qualifiers written for TYPE.
1704 <CV-qualifiers> ::= [r] [V] [K] */
1707 write_CV_qualifiers_for_type (const tree type
)
1709 int num_qualifiers
= 0;
1711 /* The order is specified by:
1713 "In cases where multiple order-insensitive qualifiers are
1714 present, they should be ordered 'K' (closest to the base type),
1715 'V', 'r', and 'U' (farthest from the base type) ..."
1717 Note that we do not use cp_type_quals below; given "const
1718 int[3]", the "const" is emitted with the "int", not with the
1721 if (TYPE_QUALS (type
) & TYPE_QUAL_RESTRICT
)
1726 if (TYPE_QUALS (type
) & TYPE_QUAL_VOLATILE
)
1731 if (TYPE_QUALS (type
) & TYPE_QUAL_CONST
)
1737 return num_qualifiers
;
1740 /* Non-terminal <builtin-type>.
1742 <builtin-type> ::= v # void
1747 ::= h # unsigned char
1749 ::= t # unsigned short
1751 ::= j # unsigned int
1753 ::= m # unsigned long
1754 ::= x # long long, __int64
1755 ::= y # unsigned long long, __int64
1757 ::= o # unsigned __int128
1760 ::= e # long double, __float80
1761 ::= g # __float128 [not supported]
1762 ::= u <source-name> # vendor extended type */
1765 write_builtin_type (tree type
)
1767 switch (TREE_CODE (type
))
1778 /* TYPE may still be wchar_t, since that isn't in
1779 integer_type_nodes. */
1780 if (type
== wchar_type_node
)
1782 else if (TYPE_FOR_JAVA (type
))
1783 write_java_integer_type_codes (type
);
1787 /* Assume TYPE is one of the shared integer type nodes. Find
1788 it in the array of these nodes. */
1790 for (itk
= 0; itk
< itk_none
; ++itk
)
1791 if (type
== integer_types
[itk
])
1793 /* Print the corresponding single-letter code. */
1794 write_char (integer_type_codes
[itk
]);
1798 if (itk
== itk_none
)
1800 tree t
= c_common_type_for_mode (TYPE_MODE (type
),
1801 TYPE_UNSIGNED (type
));
1808 if (TYPE_PRECISION (type
) == 128)
1809 write_char (TYPE_UNSIGNED (type
) ? 'o' : 'n');
1812 /* Allow for cases where TYPE is not one of the shared
1813 integer type nodes and write a "vendor extended builtin
1814 type" with a name the form intN or uintN, respectively.
1815 Situations like this can happen if you have an
1816 __attribute__((__mode__(__SI__))) type and use exotic
1817 switches like '-mint8' on AVR. Of course, this is
1818 undefined by the C++ ABI (and '-mint8' is not even
1819 Standard C conforming), but when using such special
1820 options you're pretty much in nowhere land anyway. */
1822 char prec
[11]; /* up to ten digits for an unsigned */
1824 prefix
= TYPE_UNSIGNED (type
) ? "uint" : "int";
1825 sprintf (prec
, "%u", (unsigned) TYPE_PRECISION (type
));
1826 write_char ('u'); /* "vendor extended builtin type" */
1827 write_unsigned_number (strlen (prefix
) + strlen (prec
));
1828 write_string (prefix
);
1829 write_string (prec
);
1836 if (type
== float_type_node
1837 || type
== java_float_type_node
)
1839 else if (type
== double_type_node
1840 || type
== java_double_type_node
)
1842 else if (type
== long_double_type_node
)
1853 /* Non-terminal <function-type>. NODE is a FUNCTION_TYPE or
1854 METHOD_TYPE. The return type is mangled before the parameter
1857 <function-type> ::= F [Y] <bare-function-type> E */
1860 write_function_type (const tree type
)
1862 MANGLE_TRACE_TREE ("function-type", type
);
1864 /* For a pointer to member function, the function type may have
1865 cv-qualifiers, indicating the quals for the artificial 'this'
1867 if (TREE_CODE (type
) == METHOD_TYPE
)
1869 /* The first parameter must be a POINTER_TYPE pointing to the
1870 `this' parameter. */
1871 tree this_type
= TREE_TYPE (TREE_VALUE (TYPE_ARG_TYPES (type
)));
1872 write_CV_qualifiers_for_type (this_type
);
1876 /* We don't track whether or not a type is `extern "C"'. Note that
1877 you can have an `extern "C"' function that does not have
1878 `extern "C"' type, and vice versa:
1880 extern "C" typedef void function_t();
1881 function_t f; // f has C++ linkage, but its type is
1884 typedef void function_t();
1885 extern "C" function_t f; // Vice versa.
1888 write_bare_function_type (type
, /*include_return_type_p=*/1,
1893 /* Non-terminal <bare-function-type>. TYPE is a FUNCTION_TYPE or
1894 METHOD_TYPE. If INCLUDE_RETURN_TYPE is nonzero, the return value
1895 is mangled before the parameter types. If non-NULL, DECL is
1896 FUNCTION_DECL for the function whose type is being emitted.
1898 If DECL is a member of a Java type, then a literal 'J'
1899 is output and the return type is mangled as if INCLUDE_RETURN_TYPE
1902 <bare-function-type> ::= [J]</signature/ type>+ */
1905 write_bare_function_type (const tree type
, const int include_return_type_p
,
1910 MANGLE_TRACE_TREE ("bare-function-type", type
);
1912 /* Detect Java methods and emit special encoding. */
1914 && DECL_FUNCTION_MEMBER_P (decl
)
1915 && TYPE_FOR_JAVA (DECL_CONTEXT (decl
))
1916 && !DECL_CONSTRUCTOR_P (decl
)
1917 && !DECL_DESTRUCTOR_P (decl
)
1918 && !DECL_CONV_FN_P (decl
))
1928 /* Mangle the return type, if requested. */
1929 if (include_return_type_p
|| java_method_p
)
1930 write_type (TREE_TYPE (type
));
1932 /* Now mangle the types of the arguments. */
1933 write_method_parms (TYPE_ARG_TYPES (type
),
1934 TREE_CODE (type
) == METHOD_TYPE
,
1938 /* Write the mangled representation of a method parameter list of
1939 types given in PARM_TYPES. If METHOD_P is nonzero, the function is
1940 considered a non-static method, and the this parameter is omitted.
1941 If non-NULL, DECL is the FUNCTION_DECL for the function whose
1942 parameters are being emitted. */
1945 write_method_parms (tree parm_types
, const int method_p
, const tree decl
)
1947 tree first_parm_type
;
1948 tree parm_decl
= decl
? DECL_ARGUMENTS (decl
) : NULL_TREE
;
1950 /* Assume this parameter type list is variable-length. If it ends
1951 with a void type, then it's not. */
1954 /* If this is a member function, skip the first arg, which is the
1956 "Member functions do not encode the type of their implicit this
1959 Similarly, there's no need to mangle artificial parameters, like
1960 the VTT parameters for constructors and destructors. */
1963 parm_types
= TREE_CHAIN (parm_types
);
1964 parm_decl
= parm_decl
? TREE_CHAIN (parm_decl
) : NULL_TREE
;
1966 while (parm_decl
&& DECL_ARTIFICIAL (parm_decl
))
1968 parm_types
= TREE_CHAIN (parm_types
);
1969 parm_decl
= TREE_CHAIN (parm_decl
);
1973 for (first_parm_type
= parm_types
;
1975 parm_types
= TREE_CHAIN (parm_types
))
1977 tree parm
= TREE_VALUE (parm_types
);
1978 if (parm
== void_type_node
)
1980 /* "Empty parameter lists, whether declared as () or
1981 conventionally as (void), are encoded with a void parameter
1983 if (parm_types
== first_parm_type
)
1985 /* If the parm list is terminated with a void type, it's
1988 /* A void type better be the last one. */
1989 gcc_assert (TREE_CHAIN (parm_types
) == NULL
);
1996 /* <builtin-type> ::= z # ellipsis */
2000 /* <class-enum-type> ::= <name> */
2003 write_class_enum_type (const tree type
)
2005 write_name (TYPE_NAME (type
), /*ignore_local_scope=*/0);
2008 /* Non-terminal <template-args>. ARGS is a TREE_VEC of template
2011 <template-args> ::= I <template-arg>+ E */
2014 write_template_args (tree args
)
2017 int length
= TREE_VEC_LENGTH (args
);
2019 MANGLE_TRACE_TREE ("template-args", args
);
2023 gcc_assert (length
> 0);
2025 if (TREE_CODE (TREE_VEC_ELT (args
, 0)) == TREE_VEC
)
2027 /* We have nested template args. We want the innermost template
2029 args
= TREE_VEC_ELT (args
, length
- 1);
2030 length
= TREE_VEC_LENGTH (args
);
2032 for (i
= 0; i
< length
; ++i
)
2033 write_template_arg (TREE_VEC_ELT (args
, i
));
2038 /* <expression> ::= <unary operator-name> <expression>
2039 ::= <binary operator-name> <expression> <expression>
2042 <expr-primary> ::= <template-param>
2043 ::= L <type> <value number> E # literal
2044 ::= L <mangled-name> E # external name
2045 ::= sr <type> <unqualified-name>
2046 ::= sr <type> <unqualified-name> <template-args> */
2049 write_expression (tree expr
)
2051 enum tree_code code
;
2053 code
= TREE_CODE (expr
);
2055 /* Skip NOP_EXPRs. They can occur when (say) a pointer argument
2056 is converted (via qualification conversions) to another
2058 while (TREE_CODE (expr
) == NOP_EXPR
2059 || TREE_CODE (expr
) == NON_LVALUE_EXPR
)
2061 expr
= TREE_OPERAND (expr
, 0);
2062 code
= TREE_CODE (expr
);
2065 if (code
== BASELINK
)
2067 expr
= BASELINK_FUNCTIONS (expr
);
2068 code
= TREE_CODE (expr
);
2071 /* Handle pointers-to-members by making them look like expression
2073 if (code
== PTRMEM_CST
)
2075 expr
= build_nt (ADDR_EXPR
,
2076 build_qualified_name (/*type=*/NULL_TREE
,
2077 PTRMEM_CST_CLASS (expr
),
2078 PTRMEM_CST_MEMBER (expr
),
2079 /*template_p=*/false));
2080 code
= TREE_CODE (expr
);
2083 /* Handle template parameters. */
2084 if (code
== TEMPLATE_TYPE_PARM
2085 || code
== TEMPLATE_TEMPLATE_PARM
2086 || code
== BOUND_TEMPLATE_TEMPLATE_PARM
2087 || code
== TEMPLATE_PARM_INDEX
)
2088 write_template_param (expr
);
2089 /* Handle literals. */
2090 else if (TREE_CODE_CLASS (code
) == tcc_constant
2091 || (abi_version_at_least (2) && code
== CONST_DECL
))
2092 write_template_arg_literal (expr
);
2093 else if (DECL_P (expr
))
2095 /* G++ 3.2 incorrectly mangled non-type template arguments of
2096 enumeration type using their names. */
2097 if (code
== CONST_DECL
)
2098 G
.need_abi_warning
= 1;
2100 write_mangled_name (expr
, false);
2103 else if (TREE_CODE (expr
) == SIZEOF_EXPR
2104 && TYPE_P (TREE_OPERAND (expr
, 0)))
2106 write_string ("st");
2107 write_type (TREE_OPERAND (expr
, 0));
2109 else if (abi_version_at_least (2) && TREE_CODE (expr
) == SCOPE_REF
)
2111 tree scope
= TREE_OPERAND (expr
, 0);
2112 tree member
= TREE_OPERAND (expr
, 1);
2114 /* If the MEMBER is a real declaration, then the qualifying
2115 scope was not dependent. Ideally, we would not have a
2116 SCOPE_REF in those cases, but sometimes we do. If the second
2117 argument is a DECL, then the name must not have been
2119 if (DECL_P (member
))
2120 write_expression (member
);
2125 write_string ("sr");
2127 /* If MEMBER is a template-id, separate the template
2128 from the arguments. */
2129 if (TREE_CODE (member
) == TEMPLATE_ID_EXPR
)
2131 template_args
= TREE_OPERAND (member
, 1);
2132 member
= TREE_OPERAND (member
, 0);
2135 template_args
= NULL_TREE
;
2136 /* Write out the name of the MEMBER. */
2137 if (IDENTIFIER_TYPENAME_P (member
))
2138 write_conversion_operator_name (TREE_TYPE (member
));
2139 else if (IDENTIFIER_OPNAME_P (member
))
2142 const char *mangled_name
= NULL
;
2144 /* Unfortunately, there is no easy way to go from the
2145 name of the operator back to the corresponding tree
2147 for (i
= 0; i
< LAST_CPLUS_TREE_CODE
; ++i
)
2148 if (operator_name_info
[i
].identifier
== member
)
2150 /* The ABI says that we prefer binary operator
2151 names to unary operator names. */
2152 if (operator_name_info
[i
].arity
== 2)
2154 mangled_name
= operator_name_info
[i
].mangled_name
;
2157 else if (!mangled_name
)
2158 mangled_name
= operator_name_info
[i
].mangled_name
;
2160 else if (assignment_operator_name_info
[i
].identifier
2164 = assignment_operator_name_info
[i
].mangled_name
;
2167 write_string (mangled_name
);
2170 write_source_name (member
);
2171 /* Write out the template arguments. */
2173 write_template_args (template_args
);
2180 /* When we bind a variable or function to a non-type template
2181 argument with reference type, we create an ADDR_EXPR to show
2182 the fact that the entity's address has been taken. But, we
2183 don't actually want to output a mangling code for the `&'. */
2184 if (TREE_CODE (expr
) == ADDR_EXPR
2186 && TREE_CODE (TREE_TYPE (expr
)) == REFERENCE_TYPE
)
2188 expr
= TREE_OPERAND (expr
, 0);
2191 write_expression (expr
);
2195 code
= TREE_CODE (expr
);
2198 /* If it wasn't any of those, recursively expand the expression. */
2199 write_string (operator_name_info
[(int) code
].mangled_name
);
2204 sorry ("call_expr cannot be mangled due to a defect in the C++ ABI");
2208 write_type (TREE_TYPE (expr
));
2209 /* There is no way to mangle a zero-operand cast like
2211 if (!TREE_OPERAND (expr
, 0))
2212 sorry ("zero-operand casts cannot be mangled due to a defect "
2215 write_expression (TREE_VALUE (TREE_OPERAND (expr
, 0)));
2218 case STATIC_CAST_EXPR
:
2219 case CONST_CAST_EXPR
:
2220 write_type (TREE_TYPE (expr
));
2221 write_expression (TREE_OPERAND (expr
, 0));
2225 /* Handle pointers-to-members specially. */
2227 write_type (TREE_OPERAND (expr
, 0));
2228 if (TREE_CODE (TREE_OPERAND (expr
, 1)) == IDENTIFIER_NODE
)
2229 write_source_name (TREE_OPERAND (expr
, 1));
2230 else if (TREE_CODE (TREE_OPERAND (expr
, 1)) == TEMPLATE_ID_EXPR
)
2235 template_id
= TREE_OPERAND (expr
, 1);
2236 name
= TREE_OPERAND (template_id
, 0);
2237 /* FIXME: What about operators? */
2238 gcc_assert (TREE_CODE (name
) == IDENTIFIER_NODE
);
2239 write_source_name (TREE_OPERAND (template_id
, 0));
2240 write_template_args (TREE_OPERAND (template_id
, 1));
2244 /* G++ 3.2 incorrectly put out both the "sr" code and
2245 the nested name of the qualified name. */
2246 G
.need_abi_warning
= 1;
2247 write_encoding (TREE_OPERAND (expr
, 1));
2252 for (i
= 0; i
< TREE_OPERAND_LENGTH (expr
); ++i
)
2254 tree operand
= TREE_OPERAND (expr
, i
);
2255 /* As a GNU extension, the middle operand of a
2256 conditional may be omitted. Since expression
2257 manglings are supposed to represent the input token
2258 stream, there's no good way to mangle such an
2259 expression without extending the C++ ABI. */
2260 if (code
== COND_EXPR
&& i
== 1 && !operand
)
2262 error ("omitted middle operand to %<?:%> operand "
2263 "cannot be mangled");
2266 write_expression (operand
);
2272 /* Literal subcase of non-terminal <template-arg>.
2274 "Literal arguments, e.g. "A<42L>", are encoded with their type
2275 and value. Negative integer values are preceded with "n"; for
2276 example, "A<-42L>" becomes "1AILln42EE". The bool value false is
2277 encoded as 0, true as 1." */
2280 write_template_arg_literal (const tree value
)
2283 write_type (TREE_TYPE (value
));
2285 switch (TREE_CODE (value
))
2288 write_integer_cst (DECL_INITIAL (value
));
2292 gcc_assert (!same_type_p (TREE_TYPE (value
), boolean_type_node
)
2293 || integer_zerop (value
) || integer_onep (value
));
2294 write_integer_cst (value
);
2298 write_real_cst (value
);
2308 /* Non-terminal <template-arg>.
2310 <template-arg> ::= <type> # type
2311 ::= L <type> </value/ number> E # literal
2312 ::= LZ <name> E # external name
2313 ::= X <expression> E # expression */
2316 write_template_arg (tree node
)
2318 enum tree_code code
= TREE_CODE (node
);
2320 MANGLE_TRACE_TREE ("template-arg", node
);
2322 /* A template template parameter's argument list contains TREE_LIST
2323 nodes of which the value field is the actual argument. */
2324 if (code
== TREE_LIST
)
2326 node
= TREE_VALUE (node
);
2327 /* If it's a decl, deal with its type instead. */
2330 node
= TREE_TYPE (node
);
2331 code
= TREE_CODE (node
);
2335 if (TREE_CODE (node
) == NOP_EXPR
2336 && TREE_CODE (TREE_TYPE (node
)) == REFERENCE_TYPE
)
2338 /* Template parameters can be of reference type. To maintain
2339 internal consistency, such arguments use a conversion from
2340 address of object to reference type. */
2341 gcc_assert (TREE_CODE (TREE_OPERAND (node
, 0)) == ADDR_EXPR
);
2342 if (abi_version_at_least (2))
2343 node
= TREE_OPERAND (TREE_OPERAND (node
, 0), 0);
2345 G
.need_abi_warning
= 1;
2348 if (ARGUMENT_PACK_P (node
))
2350 /* Expand the template argument pack. */
2351 tree args
= ARGUMENT_PACK_ARGS (node
);
2352 int i
, length
= TREE_VEC_LENGTH (args
);
2353 for (i
= 0; i
< length
; ++i
)
2354 write_template_arg (TREE_VEC_ELT (args
, i
));
2356 else if (TYPE_P (node
))
2358 else if (code
== TEMPLATE_DECL
)
2359 /* A template appearing as a template arg is a template template arg. */
2360 write_template_template_arg (node
);
2361 else if ((TREE_CODE_CLASS (code
) == tcc_constant
&& code
!= PTRMEM_CST
)
2362 || (abi_version_at_least (2) && code
== CONST_DECL
))
2363 write_template_arg_literal (node
);
2364 else if (DECL_P (node
))
2366 /* Until ABI version 2, non-type template arguments of
2367 enumeration type were mangled using their names. */
2368 if (code
== CONST_DECL
&& !abi_version_at_least (2))
2369 G
.need_abi_warning
= 1;
2371 /* Until ABI version 3, the underscore before the mangled name
2372 was incorrectly omitted. */
2373 if (!abi_version_at_least (3))
2375 G
.need_abi_warning
= 1;
2379 write_string ("_Z");
2380 write_encoding (node
);
2385 /* Template arguments may be expressions. */
2387 write_expression (node
);
2392 /* <template-template-arg>
2394 ::= <substitution> */
2397 write_template_template_arg (const tree decl
)
2399 MANGLE_TRACE_TREE ("template-template-arg", decl
);
2401 if (find_substitution (decl
))
2403 write_name (decl
, /*ignore_local_scope=*/0);
2404 add_substitution (decl
);
2408 /* Non-terminal <array-type>. TYPE is an ARRAY_TYPE.
2410 <array-type> ::= A [</dimension/ number>] _ </element/ type>
2411 ::= A <expression> _ </element/ type>
2413 "Array types encode the dimension (number of elements) and the
2414 element type. For variable length arrays, the dimension (but not
2415 the '_' separator) is omitted." */
2418 write_array_type (const tree type
)
2421 if (TYPE_DOMAIN (type
))
2426 index_type
= TYPE_DOMAIN (type
);
2427 /* The INDEX_TYPE gives the upper and lower bounds of the
2429 max
= TYPE_MAX_VALUE (index_type
);
2430 if (TREE_CODE (max
) == INTEGER_CST
)
2432 /* The ABI specifies that we should mangle the number of
2433 elements in the array, not the largest allowed index. */
2434 max
= size_binop (PLUS_EXPR
, max
, size_one_node
);
2435 write_unsigned_number (tree_low_cst (max
, 1));
2439 max
= TREE_OPERAND (max
, 0);
2440 if (!abi_version_at_least (2))
2442 /* value_dependent_expression_p presumes nothing is
2443 dependent when PROCESSING_TEMPLATE_DECL is zero. */
2444 ++processing_template_decl
;
2445 if (!value_dependent_expression_p (max
))
2446 G
.need_abi_warning
= 1;
2447 --processing_template_decl
;
2449 write_expression (max
);
2454 write_type (TREE_TYPE (type
));
2457 /* Non-terminal <pointer-to-member-type> for pointer-to-member
2458 variables. TYPE is a pointer-to-member POINTER_TYPE.
2460 <pointer-to-member-type> ::= M </class/ type> </member/ type> */
2463 write_pointer_to_member_type (const tree type
)
2466 write_type (TYPE_PTRMEM_CLASS_TYPE (type
));
2467 write_type (TYPE_PTRMEM_POINTED_TO_TYPE (type
));
2470 /* Non-terminal <template-param>. PARM is a TEMPLATE_TYPE_PARM,
2471 TEMPLATE_TEMPLATE_PARM, BOUND_TEMPLATE_TEMPLATE_PARM or a
2472 TEMPLATE_PARM_INDEX.
2474 <template-param> ::= T </parameter/ number> _ */
2477 write_template_param (const tree parm
)
2481 tree parm_type
= NULL_TREE
;
2483 MANGLE_TRACE_TREE ("template-parm", parm
);
2485 switch (TREE_CODE (parm
))
2487 case TEMPLATE_TYPE_PARM
:
2488 case TEMPLATE_TEMPLATE_PARM
:
2489 case BOUND_TEMPLATE_TEMPLATE_PARM
:
2490 parm_index
= TEMPLATE_TYPE_IDX (parm
);
2491 parm_level
= TEMPLATE_TYPE_LEVEL (parm
);
2494 case TEMPLATE_PARM_INDEX
:
2495 parm_index
= TEMPLATE_PARM_IDX (parm
);
2496 parm_level
= TEMPLATE_PARM_LEVEL (parm
);
2497 parm_type
= TREE_TYPE (TEMPLATE_PARM_DECL (parm
));
2505 /* NUMBER as it appears in the mangling is (-1)-indexed, with the
2506 earliest template param denoted by `_'. */
2508 write_unsigned_number (parm_index
- 1);
2512 /* <template-template-param>
2513 ::= <template-param>
2514 ::= <substitution> */
2517 write_template_template_param (const tree parm
)
2519 tree
template = NULL_TREE
;
2521 /* PARM, a TEMPLATE_TEMPLATE_PARM, is an instantiation of the
2522 template template parameter. The substitution candidate here is
2523 only the template. */
2524 if (TREE_CODE (parm
) == BOUND_TEMPLATE_TEMPLATE_PARM
)
2527 = TI_TEMPLATE (TEMPLATE_TEMPLATE_PARM_TEMPLATE_INFO (parm
));
2528 if (find_substitution (template))
2532 /* <template-param> encodes only the template parameter position,
2533 not its template arguments, which is fine here. */
2534 write_template_param (parm
);
2536 add_substitution (template);
2539 /* Non-terminal <substitution>.
2541 <substitution> ::= S <seq-id> _
2545 write_substitution (const int seq_id
)
2547 MANGLE_TRACE ("substitution", "");
2551 write_number (seq_id
- 1, /*unsigned=*/1, 36);
2555 /* Start mangling ENTITY. */
2558 start_mangling (const tree entity
, const bool ident_p
)
2561 G
.need_abi_warning
= false;
2564 obstack_free (&name_obstack
, name_base
);
2565 mangle_obstack
= &name_obstack
;
2566 name_base
= obstack_alloc (&name_obstack
, 0);
2569 mangle_obstack
= &ident_hash
->stack
;
2572 /* Done with mangling. Return the generated mangled name. If WARN is
2573 true, and the name of G.entity will be mangled differently in a
2574 future version of the ABI, issue a warning. */
2576 static inline const char *
2577 finish_mangling (const bool warn
)
2579 if (warn_abi
&& warn
&& G
.need_abi_warning
)
2580 warning (OPT_Wabi
, "the mangled name of %qD will change in a future "
2584 /* Clear all the substitutions. */
2585 VEC_truncate (tree
, G
.substitutions
, 0);
2587 /* Null-terminate the string. */
2590 return (const char *) obstack_finish (mangle_obstack
);
2593 /* Initialize data structures for mangling. */
2598 gcc_obstack_init (&name_obstack
);
2599 name_base
= obstack_alloc (&name_obstack
, 0);
2600 G
.substitutions
= NULL
;
2602 /* Cache these identifiers for quick comparison when checking for
2603 standard substitutions. */
2604 subst_identifiers
[SUBID_ALLOCATOR
] = get_identifier ("allocator");
2605 subst_identifiers
[SUBID_BASIC_STRING
] = get_identifier ("basic_string");
2606 subst_identifiers
[SUBID_CHAR_TRAITS
] = get_identifier ("char_traits");
2607 subst_identifiers
[SUBID_BASIC_ISTREAM
] = get_identifier ("basic_istream");
2608 subst_identifiers
[SUBID_BASIC_OSTREAM
] = get_identifier ("basic_ostream");
2609 subst_identifiers
[SUBID_BASIC_IOSTREAM
] = get_identifier ("basic_iostream");
2612 /* Generate the mangled name of DECL. */
2615 mangle_decl_string (const tree decl
)
2619 start_mangling (decl
, /*ident_p=*/true);
2621 if (TREE_CODE (decl
) == TYPE_DECL
)
2622 write_type (TREE_TYPE (decl
));
2624 write_mangled_name (decl
, true);
2626 result
= finish_mangling (/*warn=*/true);
2628 fprintf (stderr
, "mangle_decl_string = '%s'\n\n", result
);
2632 /* Like get_identifier, except that NAME is assumed to have been
2633 allocated on the obstack used by the identifier hash table. */
2636 get_identifier_nocopy (const char *name
)
2638 hashnode ht_node
= ht_lookup (ident_hash
, (const unsigned char *) name
,
2639 strlen (name
), HT_ALLOCED
);
2640 return HT_IDENT_TO_GCC_IDENT (ht_node
);
2643 /* Create an identifier for the external mangled name of DECL. */
2646 mangle_decl (const tree decl
)
2648 tree id
= get_identifier_nocopy (mangle_decl_string (decl
));
2649 id
= targetm
.mangle_decl_assembler_name (decl
, id
);
2650 SET_DECL_ASSEMBLER_NAME (decl
, id
);
2653 /* Generate the mangled representation of TYPE. */
2656 mangle_type_string (const tree type
)
2660 start_mangling (type
, /*ident_p=*/false);
2662 result
= finish_mangling (/*warn=*/false);
2664 fprintf (stderr
, "mangle_type_string = '%s'\n\n", result
);
2668 /* Create an identifier for the mangled name of a special component
2669 for belonging to TYPE. CODE is the ABI-specified code for this
2673 mangle_special_for_type (const tree type
, const char *code
)
2677 /* We don't have an actual decl here for the special component, so
2678 we can't just process the <encoded-name>. Instead, fake it. */
2679 start_mangling (type
, /*ident_p=*/true);
2681 /* Start the mangling. */
2682 write_string ("_Z");
2683 write_string (code
);
2687 result
= finish_mangling (/*warn=*/false);
2690 fprintf (stderr
, "mangle_special_for_type = %s\n\n", result
);
2692 return get_identifier_nocopy (result
);
2695 /* Create an identifier for the mangled representation of the typeinfo
2696 structure for TYPE. */
2699 mangle_typeinfo_for_type (const tree type
)
2701 return mangle_special_for_type (type
, "TI");
2704 /* Create an identifier for the mangled name of the NTBS containing
2705 the mangled name of TYPE. */
2708 mangle_typeinfo_string_for_type (const tree type
)
2710 return mangle_special_for_type (type
, "TS");
2713 /* Create an identifier for the mangled name of the vtable for TYPE. */
2716 mangle_vtbl_for_type (const tree type
)
2718 return mangle_special_for_type (type
, "TV");
2721 /* Returns an identifier for the mangled name of the VTT for TYPE. */
2724 mangle_vtt_for_type (const tree type
)
2726 return mangle_special_for_type (type
, "TT");
2729 /* Return an identifier for a construction vtable group. TYPE is
2730 the most derived class in the hierarchy; BINFO is the base
2731 subobject for which this construction vtable group will be used.
2733 This mangling isn't part of the ABI specification; in the ABI
2734 specification, the vtable group is dumped in the same COMDAT as the
2735 main vtable, and is referenced only from that vtable, so it doesn't
2736 need an external name. For binary formats without COMDAT sections,
2737 though, we need external names for the vtable groups.
2739 We use the production
2741 <special-name> ::= CT <type> <offset number> _ <base type> */
2744 mangle_ctor_vtbl_for_type (const tree type
, const tree binfo
)
2748 start_mangling (type
, /*ident_p=*/true);
2750 write_string ("_Z");
2751 write_string ("TC");
2753 write_integer_cst (BINFO_OFFSET (binfo
));
2755 write_type (BINFO_TYPE (binfo
));
2757 result
= finish_mangling (/*warn=*/false);
2759 fprintf (stderr
, "mangle_ctor_vtbl_for_type = %s\n\n", result
);
2760 return get_identifier_nocopy (result
);
2763 /* Mangle a this pointer or result pointer adjustment.
2765 <call-offset> ::= h <fixed offset number> _
2766 ::= v <fixed offset number> _ <virtual offset number> _ */
2769 mangle_call_offset (const tree fixed_offset
, const tree virtual_offset
)
2771 write_char (virtual_offset
? 'v' : 'h');
2773 /* For either flavor, write the fixed offset. */
2774 write_integer_cst (fixed_offset
);
2777 /* For a virtual thunk, add the virtual offset. */
2780 write_integer_cst (virtual_offset
);
2785 /* Return an identifier for the mangled name of a this-adjusting or
2786 covariant thunk to FN_DECL. FIXED_OFFSET is the initial adjustment
2787 to this used to find the vptr. If VIRTUAL_OFFSET is non-NULL, this
2788 is a virtual thunk, and it is the vtbl offset in
2789 bytes. THIS_ADJUSTING is nonzero for a this adjusting thunk and
2790 zero for a covariant thunk. Note, that FN_DECL might be a covariant
2791 thunk itself. A covariant thunk name always includes the adjustment
2792 for the this pointer, even if there is none.
2794 <special-name> ::= T <call-offset> <base encoding>
2795 ::= Tc <this_adjust call-offset> <result_adjust call-offset>
2799 mangle_thunk (tree fn_decl
, const int this_adjusting
, tree fixed_offset
,
2800 tree virtual_offset
)
2804 start_mangling (fn_decl
, /*ident_p=*/true);
2806 write_string ("_Z");
2809 if (!this_adjusting
)
2811 /* Covariant thunk with no this adjustment */
2813 mangle_call_offset (integer_zero_node
, NULL_TREE
);
2814 mangle_call_offset (fixed_offset
, virtual_offset
);
2816 else if (!DECL_THUNK_P (fn_decl
))
2817 /* Plain this adjusting thunk. */
2818 mangle_call_offset (fixed_offset
, virtual_offset
);
2821 /* This adjusting thunk to covariant thunk. */
2823 mangle_call_offset (fixed_offset
, virtual_offset
);
2824 fixed_offset
= ssize_int (THUNK_FIXED_OFFSET (fn_decl
));
2825 virtual_offset
= THUNK_VIRTUAL_OFFSET (fn_decl
);
2827 virtual_offset
= BINFO_VPTR_FIELD (virtual_offset
);
2828 mangle_call_offset (fixed_offset
, virtual_offset
);
2829 fn_decl
= THUNK_TARGET (fn_decl
);
2833 write_encoding (fn_decl
);
2835 result
= finish_mangling (/*warn=*/false);
2837 fprintf (stderr
, "mangle_thunk = %s\n\n", result
);
2838 return get_identifier_nocopy (result
);
2841 /* This hash table maps TYPEs to the IDENTIFIER for a conversion
2842 operator to TYPE. The nodes are IDENTIFIERs whose TREE_TYPE is the
2845 static GTY ((param_is (union tree_node
))) htab_t conv_type_names
;
2847 /* Hash a node (VAL1) in the table. */
2850 hash_type (const void *val
)
2852 return (hashval_t
) TYPE_UID (TREE_TYPE ((const_tree
) val
));
2855 /* Compare VAL1 (a node in the table) with VAL2 (a TYPE). */
2858 compare_type (const void *val1
, const void *val2
)
2860 return TREE_TYPE ((const_tree
) val1
) == (const_tree
) val2
;
2863 /* Return an identifier for the mangled unqualified name for a
2864 conversion operator to TYPE. This mangling is not specified by the
2865 ABI spec; it is only used internally. */
2868 mangle_conv_op_name_for_type (const tree type
)
2873 if (type
== error_mark_node
)
2874 return error_mark_node
;
2876 if (conv_type_names
== NULL
)
2877 conv_type_names
= htab_create_ggc (31, &hash_type
, &compare_type
, NULL
);
2879 slot
= htab_find_slot_with_hash (conv_type_names
, type
,
2880 (hashval_t
) TYPE_UID (type
), INSERT
);
2881 identifier
= (tree
)*slot
;
2886 /* Create a unique name corresponding to TYPE. */
2887 sprintf (buffer
, "operator %lu",
2888 (unsigned long) htab_elements (conv_type_names
));
2889 identifier
= get_identifier (buffer
);
2892 /* Hang TYPE off the identifier so it can be found easily later
2893 when performing conversions. */
2894 TREE_TYPE (identifier
) = type
;
2896 /* Set bits on the identifier so we know later it's a conversion. */
2897 IDENTIFIER_OPNAME_P (identifier
) = 1;
2898 IDENTIFIER_TYPENAME_P (identifier
) = 1;
2904 /* Return an identifier for the name of an initialization guard
2905 variable for indicated VARIABLE. */
2908 mangle_guard_variable (const tree variable
)
2910 start_mangling (variable
, /*ident_p=*/true);
2911 write_string ("_ZGV");
2912 if (strncmp (IDENTIFIER_POINTER (DECL_NAME (variable
)), "_ZGR", 4) == 0)
2913 /* The name of a guard variable for a reference temporary should refer
2914 to the reference, not the temporary. */
2915 write_string (IDENTIFIER_POINTER (DECL_NAME (variable
)) + 4);
2917 write_name (variable
, /*ignore_local_scope=*/0);
2918 return get_identifier_nocopy (finish_mangling (/*warn=*/false));
2921 /* Return an identifier for the name of a temporary variable used to
2922 initialize a static reference. This isn't part of the ABI, but we might
2923 as well call them something readable. */
2926 mangle_ref_init_variable (const tree variable
)
2928 start_mangling (variable
, /*ident_p=*/true);
2929 write_string ("_ZGR");
2930 write_name (variable
, /*ignore_local_scope=*/0);
2931 return get_identifier_nocopy (finish_mangling (/*warn=*/false));
2935 /* Foreign language type mangling section. */
2937 /* How to write the type codes for the integer Java type. */
2940 write_java_integer_type_codes (const tree type
)
2942 if (type
== java_int_type_node
)
2944 else if (type
== java_short_type_node
)
2946 else if (type
== java_byte_type_node
)
2948 else if (type
== java_char_type_node
)
2950 else if (type
== java_long_type_node
)
2952 else if (type
== java_boolean_type_node
)
2958 #include "gt-cp-mangle.h"