gcc/cp/mangle.c

   1 /* Name mangling for the 3.0 C++ ABI.
   2    Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2007, 2008
   3    Free Software Foundation, Inc.
   4    Written by Alex Samuel <samuel@codesourcery.com>
   5
   6    This file is part of GCC.
   7
   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)
  11    any later version.
  12
  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.
  17
  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/>.  */
  21
  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
  28    linkers.
  29
  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.
  34
  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:
  40
  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  */
  47
  48 #include "config.h"
  49 #include "system.h"
  50 #include "coretypes.h"
  51 #include "tm.h"
  52 #include "tree.h"
  53 #include "tm_p.h"
  54 #include "cp-tree.h"
  55 #include "real.h"
  56 #include "obstack.h"
  57 #include "toplev.h"
  58 #include "varray.h"
  59 #include "flags.h"
  60 #include "target.h"
  61
  62 /* Debugging support.  */
  63
  64 /* Define DEBUG_MANGLE to enable very verbose trace messages.  */
  65 #ifndef DEBUG_MANGLE
  66 #define DEBUG_MANGLE 0
  67 #endif
  68
  69 /* Macros for tracing the write_* functions.  */
  70 #if DEBUG_MANGLE
  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))
  76 #else
  77 # define MANGLE_TRACE(FN, INPUT)
  78 # define MANGLE_TRACE_TREE(FN, NODE)
  79 #endif
  80
  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))))))
  91
  92 /* Things we only need one of.  This module is not reentrant.  */
  93 typedef struct globals GTY(())
  94 {
  95   /* An array of the current substitution candidates, in the order
  96      we've seen them.  */
  97   VEC(tree,gc) *substitutions;
  98
  99   /* The entity that is being mangled.  */
 100   tree GTY ((skip)) entity;
 101
 102   /* True if the mangling will be different in a future version of the
 103      ABI.  */
 104   bool need_abi_warning;
 105 } globals;
 106
 107 static GTY (()) globals G;
 108
 109 /* The obstack on which we build mangled names.  */
 110 static struct obstack *mangle_obstack;
 111
 112 /* The obstack on which we build mangled names that are not going to
 113    be IDENTIFIER_NODEs.  */
 114 static struct obstack name_obstack;
 115
 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;
 119
 120 /* Indices into subst_identifiers.  These are identifiers used in
 121    special substitution rules.  */
 122 typedef enum
 123 {
 124   SUBID_ALLOCATOR,
 125   SUBID_BASIC_STRING,
 126   SUBID_CHAR_TRAITS,
 127   SUBID_BASIC_ISTREAM,
 128   SUBID_BASIC_OSTREAM,
 129   SUBID_BASIC_IOSTREAM,
 130   SUBID_MAX
 131 }
 132 substitution_identifier_index_t;
 133
 134 /* For quick substitution checks, look up these common identifiers
 135    once only.  */
 136 static GTY(()) tree subst_identifiers[SUBID_MAX];
 137
 138 /* Single-letter codes for builtin integer types, defined in
 139    <builtin-type>.  These are indexed by integer_type_kind values.  */
 140 static const char
 141 integer_type_codes[itk_none] =
 142 {
 143   'c',  /* itk_char */
 144   'a',  /* itk_signed_char */
 145   'h',  /* itk_unsigned_char */
 146   's',  /* itk_short */
 147   't',  /* itk_unsigned_short */
 148   'i',  /* itk_int */
 149   'j',  /* itk_unsigned_int */
 150   'l',  /* itk_long */
 151   'm',  /* itk_unsigned_long */
 152   'x',  /* itk_long_long */
 153   'y'   /* itk_unsigned_long_long */
 154 };
 155
 156 static int decl_is_template_id (const tree, tree* const);
 157
 158 /* Functions for handling substitutions.  */
 159
 160 static inline tree canonicalize_for_substitution (tree);
 161 static void add_substitution (tree);
 162 static inline int is_std_substitution (const tree,
 163                                        const substitution_identifier_index_t);
 164 static inline int is_std_substitution_char (const tree,
 165                                             const substitution_identifier_index_t);
 166 static int find_substitution (tree);
 167 static void mangle_call_offset (const tree, const tree);
 168
 169 /* Functions for emitting mangled representations of things.  */
 170
 171 static void write_mangled_name (const tree, bool);
 172 static void write_encoding (const tree);
 173 static void write_name (tree, const int);
 174 static void write_unscoped_name (const tree);
 175 static void write_unscoped_template_name (const tree);
 176 static void write_nested_name (const tree);
 177 static void write_prefix (const tree);
 178 static void write_template_prefix (const tree);
 179 static void write_unqualified_name (const tree);
 180 static void write_conversion_operator_name (const tree);
 181 static void write_source_name (tree);
 182 static int hwint_to_ascii (unsigned HOST_WIDE_INT, const unsigned int, char *,
 183                            const unsigned int);
 184 static void write_number (unsigned HOST_WIDE_INT, const int,
 185                           const unsigned int);
 186 static void write_integer_cst (const tree);
 187 static void write_real_cst (const tree);
 188 static void write_identifier (const char *);
 189 static void write_special_name_constructor (const tree);
 190 static void write_special_name_destructor (const tree);
 191 static void write_type (tree);
 192 static int write_CV_qualifiers_for_type (const tree);
 193 static void write_builtin_type (tree);
 194 static void write_function_type (const tree);
 195 static void write_bare_function_type (const tree, const int, const tree);
 196 static void write_method_parms (tree, const int, const tree);
 197 static void write_class_enum_type (const tree);
 198 static void write_template_args (tree);
 199 static void write_expression (tree);
 200 static void write_template_arg_literal (const tree);
 201 static void write_template_arg (tree);
 202 static void write_template_template_arg (const tree);
 203 static void write_array_type (const tree);
 204 static void write_pointer_to_member_type (const tree);
 205 static void write_template_param (const tree);
 206 static void write_template_template_param (const tree);
 207 static void write_substitution (const int);
 208 static int discriminator_for_local_entity (tree);
 209 static int discriminator_for_string_literal (tree, tree);
 210 static void write_discriminator (const int);
 211 static void write_local_name (const tree, const tree, const tree);
 212 static void dump_substitution_candidates (void);
 213 static tree mangle_decl_string (const tree);
 214
 215 /* Control functions.  */
 216
 217 static inline void start_mangling (const tree);
 218 static inline const char *finish_mangling (const bool);
 219 static tree mangle_special_for_type (const tree, const char *);
 220
 221 /* Foreign language functions.  */
 222
 223 static void write_java_integer_type_codes (const tree);
 224
 225 /* Append a single character to the end of the mangled
 226    representation.  */
 227 #define write_char(CHAR)                                                \
 228   obstack_1grow (mangle_obstack, (CHAR))
 229
 230 /* Append a sized buffer to the end of the mangled representation.  */
 231 #define write_chars(CHAR, LEN)                                          \
 232   obstack_grow (mangle_obstack, (CHAR), (LEN))
 233
 234 /* Append a NUL-terminated string to the end of the mangled
 235    representation.  */
 236 #define write_string(STRING)                                            \
 237   obstack_grow (mangle_obstack, (STRING), strlen (STRING))
 238
 239 /* Nonzero if NODE1 and NODE2 are both TREE_LIST nodes and have the
 240    same purpose (context, which may be a type) and value (template
 241    decl).  See write_template_prefix for more information on what this
 242    is used for.  */
 243 #define NESTED_TEMPLATE_MATCH(NODE1, NODE2)                             \
 244   (TREE_CODE (NODE1) == TREE_LIST                                       \
 245    && TREE_CODE (NODE2) == TREE_LIST                                    \
 246    && ((TYPE_P (TREE_PURPOSE (NODE1))                                   \
 247         && same_type_p (TREE_PURPOSE (NODE1), TREE_PURPOSE (NODE2)))    \
 248        || TREE_PURPOSE (NODE1) == TREE_PURPOSE (NODE2))                 \
 249    && TREE_VALUE (NODE1) == TREE_VALUE (NODE2))
 250
 251 /* Write out an unsigned quantity in base 10.  */
 252 #define write_unsigned_number(NUMBER)                                   \
 253   write_number ((NUMBER), /*unsigned_p=*/1, 10)
 254
 255 /* If DECL is a template instance, return nonzero and, if
 256    TEMPLATE_INFO is non-NULL, set *TEMPLATE_INFO to its template info.
 257    Otherwise return zero.  */
 258
 259 static int
 260 decl_is_template_id (const tree decl, tree* const template_info)
 261 {
 262   if (TREE_CODE (decl) == TYPE_DECL)
 263     {
 264       /* TYPE_DECLs are handled specially.  Look at its type to decide
 265          if this is a template instantiation.  */
 266       const tree type = TREE_TYPE (decl);
 267
 268       if (CLASS_TYPE_P (type) && CLASSTYPE_TEMPLATE_ID_P (type))
 269         {
 270           if (template_info != NULL)
 271             /* For a templated TYPE_DECL, the template info is hanging
 272                off the type.  */
 273             *template_info = TYPE_TEMPLATE_INFO (type);
 274           return 1;
 275         }
 276     }
 277   else
 278     {
 279       /* Check if this is a primary template.  */
 280       if (DECL_LANG_SPECIFIC (decl) != NULL
 281           && DECL_USE_TEMPLATE (decl)
 282           && PRIMARY_TEMPLATE_P (DECL_TI_TEMPLATE (decl))
 283           && TREE_CODE (decl) != TEMPLATE_DECL)
 284         {
 285           if (template_info != NULL)
 286             /* For most templated decls, the template info is hanging
 287                off the decl.  */
 288             *template_info = DECL_TEMPLATE_INFO (decl);
 289           return 1;
 290         }
 291     }
 292
 293   /* It's not a template id.  */
 294   return 0;
 295 }
 296
 297 /* Produce debugging output of current substitution candidates.  */
 298
 299 static void
 300 dump_substitution_candidates (void)
 301 {
 302   unsigned i;
 303   tree el;
 304
 305   fprintf (stderr, "  ++ substitutions  ");
 306   for (i = 0; VEC_iterate (tree, G.substitutions, i, el); ++i)
 307     {
 308       const char *name = "???";
 309
 310       if (i > 0)
 311         fprintf (stderr, "                    ");
 312       if (DECL_P (el))
 313         name = IDENTIFIER_POINTER (DECL_NAME (el));
 314       else if (TREE_CODE (el) == TREE_LIST)
 315         name = IDENTIFIER_POINTER (DECL_NAME (TREE_VALUE (el)));
 316       else if (TYPE_NAME (el))
 317         name = IDENTIFIER_POINTER (DECL_NAME (TYPE_NAME (el)));
 318       fprintf (stderr, " S%d_ = ", i - 1);
 319       if (TYPE_P (el) &&
 320           (CP_TYPE_RESTRICT_P (el)
 321            || CP_TYPE_VOLATILE_P (el)
 322            || CP_TYPE_CONST_P (el)))
 323         fprintf (stderr, "CV-");
 324       fprintf (stderr, "%s (%s at %p)\n",
 325                name, tree_code_name[TREE_CODE (el)], (void *) el);
 326     }
 327 }
 328
 329 /* Both decls and types can be substitution candidates, but sometimes
 330    they refer to the same thing.  For instance, a TYPE_DECL and
 331    RECORD_TYPE for the same class refer to the same thing, and should
 332    be treated accordingly in substitutions.  This function returns a
 333    canonicalized tree node representing NODE that is used when adding
 334    and substitution candidates and finding matches.  */
 335
 336 static inline tree
 337 canonicalize_for_substitution (tree node)
 338 {
 339   /* For a TYPE_DECL, use the type instead.  */
 340   if (TREE_CODE (node) == TYPE_DECL)
 341     node = TREE_TYPE (node);
 342   if (TYPE_P (node))
 343     node = canonical_type_variant (node);
 344
 345   return node;
 346 }
 347
 348 /* Add NODE as a substitution candidate.  NODE must not already be on
 349    the list of candidates.  */
 350
 351 static void
 352 add_substitution (tree node)
 353 {
 354   tree c;
 355
 356   if (DEBUG_MANGLE)
 357     fprintf (stderr, "  ++ add_substitution (%s at %10p)\n",
 358              tree_code_name[TREE_CODE (node)], (void *) node);
 359
 360   /* Get the canonicalized substitution candidate for NODE.  */
 361   c = canonicalize_for_substitution (node);
 362   if (DEBUG_MANGLE && c != node)
 363     fprintf (stderr, "  ++ using candidate (%s at %10p)\n",
 364              tree_code_name[TREE_CODE (node)], (void *) node);
 365   node = c;
 366
 367 #if ENABLE_CHECKING
 368   /* Make sure NODE isn't already a candidate.  */
 369   {
 370     int i;
 371     tree candidate;
 372
 373     for (i = 0; VEC_iterate (tree, G.substitutions, i, candidate); i++)
 374       {
 375         gcc_assert (!(DECL_P (node) && node == candidate));
 376         gcc_assert (!(TYPE_P (node) && TYPE_P (candidate)
 377                       && same_type_p (node, candidate)));
 378       }
 379   }
 380 #endif /* ENABLE_CHECKING */
 381
 382   /* Put the decl onto the varray of substitution candidates.  */
 383   VEC_safe_push (tree, gc, G.substitutions, node);
 384
 385   if (DEBUG_MANGLE)
 386     dump_substitution_candidates ();
 387 }
 388
 389 /* Helper function for find_substitution.  Returns nonzero if NODE,
 390    which may be a decl or a CLASS_TYPE, is a template-id with template
 391    name of substitution_index[INDEX] in the ::std namespace.  */
 392
 393 static inline int
 394 is_std_substitution (const tree node,
 395                      const substitution_identifier_index_t index)
 396 {
 397   tree type = NULL;
 398   tree decl = NULL;
 399
 400   if (DECL_P (node))
 401     {
 402       type = TREE_TYPE (node);
 403       decl = node;
 404     }
 405   else if (CLASS_TYPE_P (node))
 406     {
 407       type = node;
 408       decl = TYPE_NAME (node);
 409     }
 410   else
 411     /* These are not the droids you're looking for.  */
 412     return 0;
 413
 414   return (DECL_NAMESPACE_STD_P (CP_DECL_CONTEXT (decl))
 415           && TYPE_LANG_SPECIFIC (type)
 416           && TYPE_TEMPLATE_INFO (type)
 417           && (DECL_NAME (TYPE_TI_TEMPLATE (type))
 418               == subst_identifiers[index]));
 419 }
 420
 421 /* Helper function for find_substitution.  Returns nonzero if NODE,
 422    which may be a decl or a CLASS_TYPE, is the template-id
 423    ::std::identifier<char>, where identifier is
 424    substitution_index[INDEX].  */
 425
 426 static inline int
 427 is_std_substitution_char (const tree node,
 428                           const substitution_identifier_index_t index)
 429 {
 430   tree args;
 431   /* Check NODE's name is ::std::identifier.  */
 432   if (!is_std_substitution (node, index))
 433     return 0;
 434   /* Figure out its template args.  */
 435   if (DECL_P (node))
 436     args = DECL_TI_ARGS (node);
 437   else if (CLASS_TYPE_P (node))
 438     args = CLASSTYPE_TI_ARGS (node);
 439   else
 440     /* Oops, not a template.  */
 441     return 0;
 442   /* NODE's template arg list should be <char>.  */
 443   return
 444     TREE_VEC_LENGTH (args) == 1
 445     && TREE_VEC_ELT (args, 0) == char_type_node;
 446 }
 447
 448 /* Check whether a substitution should be used to represent NODE in
 449    the mangling.
 450
 451    First, check standard special-case substitutions.
 452
 453      <substitution> ::= St
 454          # ::std
 455
 456                     ::= Sa
 457          # ::std::allocator
 458
 459                     ::= Sb
 460          # ::std::basic_string
 461
 462                     ::= Ss
 463          # ::std::basic_string<char,
 464                                ::std::char_traits<char>,
 465                                ::std::allocator<char> >
 466
 467                     ::= Si
 468          # ::std::basic_istream<char, ::std::char_traits<char> >
 469
 470                     ::= So
 471          # ::std::basic_ostream<char, ::std::char_traits<char> >
 472
 473                     ::= Sd
 474          # ::std::basic_iostream<char, ::std::char_traits<char> >
 475
 476    Then examine the stack of currently available substitution
 477    candidates for entities appearing earlier in the same mangling
 478
 479    If a substitution is found, write its mangled representation and
 480    return nonzero.  If none is found, just return zero.  */
 481
 482 static int
 483 find_substitution (tree node)
 484 {
 485   int i;
 486   const int size = VEC_length (tree, G.substitutions);
 487   tree decl;
 488   tree type;
 489
 490   if (DEBUG_MANGLE)
 491     fprintf (stderr, "  ++ find_substitution (%s at %p)\n",
 492              tree_code_name[TREE_CODE (node)], (void *) node);
 493
 494   /* Obtain the canonicalized substitution representation for NODE.
 495      This is what we'll compare against.  */
 496   node = canonicalize_for_substitution (node);
 497
 498   /* Check for builtin substitutions.  */
 499
 500   decl = TYPE_P (node) ? TYPE_NAME (node) : node;
 501   type = TYPE_P (node) ? node : TREE_TYPE (node);
 502
 503   /* Check for std::allocator.  */
 504   if (decl
 505       && is_std_substitution (decl, SUBID_ALLOCATOR)
 506       && !CLASSTYPE_USE_TEMPLATE (TREE_TYPE (decl)))
 507     {
 508       write_string ("Sa");
 509       return 1;
 510     }
 511
 512   /* Check for std::basic_string.  */
 513   if (decl && is_std_substitution (decl, SUBID_BASIC_STRING))
 514     {
 515       if (TYPE_P (node))
 516         {
 517           /* If this is a type (i.e. a fully-qualified template-id),
 518              check for
 519                  std::basic_string <char,
 520                                     std::char_traits<char>,
 521                                     std::allocator<char> > .  */
 522           if (cp_type_quals (type) == TYPE_UNQUALIFIED
 523               && CLASSTYPE_USE_TEMPLATE (type))
 524             {
 525               tree args = CLASSTYPE_TI_ARGS (type);
 526               if (TREE_VEC_LENGTH (args) == 3
 527                   && same_type_p (TREE_VEC_ELT (args, 0), char_type_node)
 528                   && is_std_substitution_char (TREE_VEC_ELT (args, 1),
 529                                                SUBID_CHAR_TRAITS)
 530                   && is_std_substitution_char (TREE_VEC_ELT (args, 2),
 531                                                SUBID_ALLOCATOR))
 532                 {
 533                   write_string ("Ss");
 534                   return 1;
 535                 }
 536             }
 537         }
 538       else
 539         /* Substitute for the template name only if this isn't a type.  */
 540         {
 541           write_string ("Sb");
 542           return 1;
 543         }
 544     }
 545
 546   /* Check for basic_{i,o,io}stream.  */
 547   if (TYPE_P (node)
 548       && cp_type_quals (type) == TYPE_UNQUALIFIED
 549       && CLASS_TYPE_P (type)
 550       && CLASSTYPE_USE_TEMPLATE (type)
 551       && CLASSTYPE_TEMPLATE_INFO (type) != NULL)
 552     {
 553       /* First, check for the template
 554          args <char, std::char_traits<char> > .  */
 555       tree args = CLASSTYPE_TI_ARGS (type);
 556       if (TREE_VEC_LENGTH (args) == 2
 557           && TYPE_P (TREE_VEC_ELT (args, 0))
 558           && same_type_p (TREE_VEC_ELT (args, 0), char_type_node)
 559           && is_std_substitution_char (TREE_VEC_ELT (args, 1),
 560                                        SUBID_CHAR_TRAITS))
 561         {
 562           /* Got them.  Is this basic_istream?  */
 563           if (is_std_substitution (decl, SUBID_BASIC_ISTREAM))
 564             {
 565               write_string ("Si");
 566               return 1;
 567             }
 568           /* Or basic_ostream?  */
 569           else if (is_std_substitution (decl, SUBID_BASIC_OSTREAM))
 570             {
 571               write_string ("So");
 572               return 1;
 573             }
 574           /* Or basic_iostream?  */
 575           else if (is_std_substitution (decl, SUBID_BASIC_IOSTREAM))
 576             {
 577               write_string ("Sd");
 578               return 1;
 579             }
 580         }
 581     }
 582
 583   /* Check for namespace std.  */
 584   if (decl && DECL_NAMESPACE_STD_P (decl))
 585     {
 586       write_string ("St");
 587       return 1;
 588     }
 589
 590   /* Now check the list of available substitutions for this mangling
 591      operation.  */
 592   for (i = 0; i < size; ++i)
 593     {
 594       tree candidate = VEC_index (tree, G.substitutions, i);
 595       /* NODE is a matched to a candidate if it's the same decl node or
 596          if it's the same type.  */
 597       if (decl == candidate
 598           || (TYPE_P (candidate) && type && TYPE_P (type)
 599               && same_type_p (type, candidate))
 600           || NESTED_TEMPLATE_MATCH (node, candidate))
 601         {
 602           write_substitution (i);
 603           return 1;
 604         }
 605     }
 606
 607   /* No substitution found.  */
 608   return 0;
 609 }
 610
 611
 612 /* TOP_LEVEL is true, if this is being called at outermost level of
 613   mangling. It should be false when mangling a decl appearing in an
 614   expression within some other mangling.
 615
 616   <mangled-name>      ::= _Z <encoding>  */
 617
 618 static void
 619 write_mangled_name (const tree decl, bool top_level)
 620 {
 621   MANGLE_TRACE_TREE ("mangled-name", decl);
 622
 623   if (/* The names of `extern "C"' functions are not mangled.  */
 624       DECL_EXTERN_C_FUNCTION_P (decl)
 625       /* But overloaded operator names *are* mangled.  */
 626       && !DECL_OVERLOADED_OPERATOR_P (decl))
 627     {
 628     unmangled_name:;
 629
 630       if (top_level)
 631         write_string (IDENTIFIER_POINTER (DECL_NAME (decl)));
 632       else
 633         {
 634           /* The standard notes: "The <encoding> of an extern "C"
 635              function is treated like global-scope data, i.e. as its
 636              <source-name> without a type."  We cannot write
 637              overloaded operators that way though, because it contains
 638              characters invalid in assembler.  */
 639           if (abi_version_at_least (2))
 640             write_string ("_Z");
 641           else
 642             G.need_abi_warning = true;
 643           write_source_name (DECL_NAME (decl));
 644         }
 645     }
 646   else if (TREE_CODE (decl) == VAR_DECL
 647            /* The names of non-static global variables aren't mangled.  */
 648            && DECL_EXTERNAL_LINKAGE_P (decl)
 649            && (CP_DECL_CONTEXT (decl) == global_namespace
 650                /* And neither are `extern "C"' variables.  */
 651                || DECL_EXTERN_C_P (decl)))
 652     {
 653       if (top_level || abi_version_at_least (2))
 654         goto unmangled_name;
 655       else
 656         {
 657           G.need_abi_warning = true;
 658           goto mangled_name;
 659         }
 660     }
 661   else
 662     {
 663     mangled_name:;
 664       write_string ("_Z");
 665       write_encoding (decl);
 666       if (DECL_LANG_SPECIFIC (decl)
 667           && (DECL_MAYBE_IN_CHARGE_DESTRUCTOR_P (decl)
 668               || DECL_MAYBE_IN_CHARGE_CONSTRUCTOR_P (decl)))
 669         /* We need a distinct mangled name for these entities, but
 670            we should never actually output it.  So, we append some
 671            characters the assembler won't like.  */
 672         write_string (" *INTERNAL* ");
 673     }
 674 }
 675
 676 /*   <encoding>         ::= <function name> <bare-function-type>
 677                         ::= <data name>  */
 678
 679 static void
 680 write_encoding (const tree decl)
 681 {
 682   MANGLE_TRACE_TREE ("encoding", decl);
 683
 684   if (DECL_LANG_SPECIFIC (decl) && DECL_EXTERN_C_FUNCTION_P (decl))
 685     {
 686       /* For overloaded operators write just the mangled name
 687          without arguments.  */
 688       if (DECL_OVERLOADED_OPERATOR_P (decl))
 689         write_name (decl, /*ignore_local_scope=*/0);
 690       else
 691         write_source_name (DECL_NAME (decl));
 692       return;
 693     }
 694
 695   write_name (decl, /*ignore_local_scope=*/0);
 696   if (TREE_CODE (decl) == FUNCTION_DECL)
 697     {
 698       tree fn_type;
 699       tree d;
 700
 701       if (decl_is_template_id (decl, NULL))
 702         {
 703           fn_type = get_mostly_instantiated_function_type (decl);
 704           /* FN_TYPE will not have parameter types for in-charge or
 705              VTT parameters.  Therefore, we pass NULL_TREE to
 706              write_bare_function_type -- otherwise, it will get
 707              confused about which artificial parameters to skip.  */
 708           d = NULL_TREE;
 709         }
 710       else
 711         {
 712           fn_type = TREE_TYPE (decl);
 713           d = decl;
 714         }
 715
 716       write_bare_function_type (fn_type,
 717                                 (!DECL_CONSTRUCTOR_P (decl)
 718                                  && !DECL_DESTRUCTOR_P (decl)
 719                                  && !DECL_CONV_FN_P (decl)
 720                                  && decl_is_template_id (decl, NULL)),
 721                                 d);
 722     }
 723 }
 724
 725 /* <name> ::= <unscoped-name>
 726           ::= <unscoped-template-name> <template-args>
 727           ::= <nested-name>
 728           ::= <local-name>
 729
 730    If IGNORE_LOCAL_SCOPE is nonzero, this production of <name> is
 731    called from <local-name>, which mangles the enclosing scope
 732    elsewhere and then uses this function to mangle just the part
 733    underneath the function scope.  So don't use the <local-name>
 734    production, to avoid an infinite recursion.  */
 735
 736 static void
 737 write_name (tree decl, const int ignore_local_scope)
 738 {
 739   tree context;
 740
 741   MANGLE_TRACE_TREE ("name", decl);
 742
 743   if (TREE_CODE (decl) == TYPE_DECL)
 744     {
 745       /* In case this is a typedef, fish out the corresponding
 746          TYPE_DECL for the main variant.  */
 747       decl = TYPE_NAME (TYPE_MAIN_VARIANT (TREE_TYPE (decl)));
 748       context = TYPE_CONTEXT (TYPE_MAIN_VARIANT (TREE_TYPE (decl)));
 749     }
 750   else
 751     context = (DECL_CONTEXT (decl) == NULL) ? NULL : CP_DECL_CONTEXT (decl);
 752
 753   /* A decl in :: or ::std scope is treated specially.  The former is
 754      mangled using <unscoped-name> or <unscoped-template-name>, the
 755      latter with a special substitution.  Also, a name that is
 756      directly in a local function scope is also mangled with
 757      <unscoped-name> rather than a full <nested-name>.  */
 758   if (context == NULL
 759       || context == global_namespace
 760       || DECL_NAMESPACE_STD_P (context)
 761       || (ignore_local_scope && TREE_CODE (context) == FUNCTION_DECL))
 762     {
 763       tree template_info;
 764       /* Is this a template instance?  */
 765       if (decl_is_template_id (decl, &template_info))
 766         {
 767           /* Yes: use <unscoped-template-name>.  */
 768           write_unscoped_template_name (TI_TEMPLATE (template_info));
 769           write_template_args (TI_ARGS (template_info));
 770         }
 771       else
 772         /* Everything else gets an <unqualified-name>.  */
 773         write_unscoped_name (decl);
 774     }
 775   else
 776     {
 777       /* Handle local names, unless we asked not to (that is, invoked
 778          under <local-name>, to handle only the part of the name under
 779          the local scope).  */
 780       if (!ignore_local_scope)
 781         {
 782           /* Scan up the list of scope context, looking for a
 783              function.  If we find one, this entity is in local
 784              function scope.  local_entity tracks context one scope
 785              level down, so it will contain the element that's
 786              directly in that function's scope, either decl or one of
 787              its enclosing scopes.  */
 788           tree local_entity = decl;
 789           while (context != NULL && context != global_namespace)
 790             {
 791               /* Make sure we're always dealing with decls.  */
 792               if (context != NULL && TYPE_P (context))
 793                 context = TYPE_NAME (context);
 794               /* Is this a function?  */
 795               if (TREE_CODE (context) == FUNCTION_DECL)
 796                 {
 797                   /* Yes, we have local scope.  Use the <local-name>
 798                      production for the innermost function scope.  */
 799                   write_local_name (context, local_entity, decl);
 800                   return;
 801                 }
 802               /* Up one scope level.  */
 803               local_entity = context;
 804               context = CP_DECL_CONTEXT (context);
 805             }
 806
 807           /* No local scope found?  Fall through to <nested-name>.  */
 808         }
 809
 810       /* Other decls get a <nested-name> to encode their scope.  */
 811       write_nested_name (decl);
 812     }
 813 }
 814
 815 /* <unscoped-name> ::= <unqualified-name>
 816                    ::= St <unqualified-name>   # ::std::  */
 817
 818 static void
 819 write_unscoped_name (const tree decl)
 820 {
 821   tree context = CP_DECL_CONTEXT (decl);
 822
 823   MANGLE_TRACE_TREE ("unscoped-name", decl);
 824
 825   /* Is DECL in ::std?  */
 826   if (DECL_NAMESPACE_STD_P (context))
 827     {
 828       write_string ("St");
 829       write_unqualified_name (decl);
 830     }
 831   else
 832     {
 833       /* If not, it should be either in the global namespace, or directly
 834          in a local function scope.  */
 835       gcc_assert (context == global_namespace
 836                   || context == NULL
 837                   || TREE_CODE (context) == FUNCTION_DECL);
 838
 839       write_unqualified_name (decl);
 840     }
 841 }
 842
 843 /* <unscoped-template-name> ::= <unscoped-name>
 844                             ::= <substitution>  */
 845
 846 static void
 847 write_unscoped_template_name (const tree decl)
 848 {
 849   MANGLE_TRACE_TREE ("unscoped-template-name", decl);
 850
 851   if (find_substitution (decl))
 852     return;
 853   write_unscoped_name (decl);
 854   add_substitution (decl);
 855 }
 856
 857 /* Write the nested name, including CV-qualifiers, of DECL.
 858
 859    <nested-name> ::= N [<CV-qualifiers>] <prefix> <unqualified-name> E
 860                  ::= N [<CV-qualifiers>] <template-prefix> <template-args> E
 861
 862    <CV-qualifiers> ::= [r] [V] [K]  */
 863
 864 static void
 865 write_nested_name (const tree decl)
 866 {
 867   tree template_info;
 868
 869   MANGLE_TRACE_TREE ("nested-name", decl);
 870
 871   write_char ('N');
 872
 873   /* Write CV-qualifiers, if this is a member function.  */
 874   if (TREE_CODE (decl) == FUNCTION_DECL
 875       && DECL_NONSTATIC_MEMBER_FUNCTION_P (decl))
 876     {
 877       if (DECL_VOLATILE_MEMFUNC_P (decl))
 878         write_char ('V');
 879       if (DECL_CONST_MEMFUNC_P (decl))
 880         write_char ('K');
 881     }
 882
 883   /* Is this a template instance?  */
 884   if (decl_is_template_id (decl, &template_info))
 885     {
 886       /* Yes, use <template-prefix>.  */
 887       write_template_prefix (decl);
 888       write_template_args (TI_ARGS (template_info));
 889     }
 890   else if (TREE_CODE (TREE_TYPE (decl)) == TYPENAME_TYPE)
 891     {
 892       tree name = TYPENAME_TYPE_FULLNAME (TREE_TYPE (decl));
 893       if (TREE_CODE (name) == TEMPLATE_ID_EXPR)
 894         {
 895           write_template_prefix (decl);
 896           write_template_args (TREE_OPERAND (name, 1));
 897         }
 898       else
 899         {
 900           write_prefix (CP_DECL_CONTEXT (decl));
 901           write_unqualified_name (decl);
 902         }
 903     }
 904   else
 905     {
 906       /* No, just use <prefix>  */
 907       write_prefix (DECL_CONTEXT (decl));
 908       write_unqualified_name (decl);
 909     }
 910   write_char ('E');
 911 }
 912
 913 /* <prefix> ::= <prefix> <unqualified-name>
 914             ::= <template-param>
 915             ::= <template-prefix> <template-args>
 916             ::= # empty
 917             ::= <substitution>  */
 918
 919 static void
 920 write_prefix (const tree node)
 921 {
 922   tree decl;
 923   /* Non-NULL if NODE represents a template-id.  */
 924   tree template_info = NULL;
 925
 926   MANGLE_TRACE_TREE ("prefix", node);
 927
 928   if (node == NULL
 929       || node == global_namespace)
 930     return;
 931
 932   if (find_substitution (node))
 933     return;
 934
 935   if (DECL_P (node))
 936     {
 937       /* If this is a function decl, that means we've hit function
 938          scope, so this prefix must be for a local name.  In this
 939          case, we're under the <local-name> production, which encodes
 940          the enclosing function scope elsewhere.  So don't continue
 941          here.  */
 942       if (TREE_CODE (node) == FUNCTION_DECL)
 943         return;
 944
 945       decl = node;
 946       decl_is_template_id (decl, &template_info);
 947     }
 948   else
 949     {
 950       /* Node is a type.  */
 951       decl = TYPE_NAME (node);
 952       if (CLASSTYPE_TEMPLATE_ID_P (node))
 953         template_info = TYPE_TEMPLATE_INFO (node);
 954     }
 955
 956   /* In G++ 3.2, the name of the template parameter was used.  */
 957   if (TREE_CODE (node) == TEMPLATE_TYPE_PARM
 958       && !abi_version_at_least (2))
 959     G.need_abi_warning = true;
 960
 961   if (TREE_CODE (node) == TEMPLATE_TYPE_PARM
 962       && abi_version_at_least (2))
 963     write_template_param (node);
 964   else if (template_info != NULL)
 965     /* Templated.  */
 966     {
 967       write_template_prefix (decl);
 968       write_template_args (TI_ARGS (template_info));
 969     }
 970   else if (TREE_CODE (TREE_TYPE (decl)) == TYPENAME_TYPE)
 971     {
 972       tree name = TYPENAME_TYPE_FULLNAME (TREE_TYPE (decl));
 973       if (TREE_CODE (name) == TEMPLATE_ID_EXPR)
 974         {
 975           write_template_prefix (decl);
 976           write_template_args (TREE_OPERAND (name, 1));
 977         }
 978       else
 979         {
 980           write_prefix (CP_DECL_CONTEXT (decl));
 981           write_unqualified_name (decl);
 982         }
 983     }
 984   else
 985     /* Not templated.  */
 986     {
 987       write_prefix (CP_DECL_CONTEXT (decl));
 988       write_unqualified_name (decl);
 989     }
 990
 991   add_substitution (node);
 992 }
 993
 994 /* <template-prefix> ::= <prefix> <template component>
 995                      ::= <template-param>
 996                      ::= <substitution>  */
 997
 998 static void
 999 write_template_prefix (const tree node)
1000 {
1001   tree decl = DECL_P (node) ? node : TYPE_NAME (node);
1002   tree type = DECL_P (node) ? TREE_TYPE (node) : node;
1003   tree context = CP_DECL_CONTEXT (decl);
1004   tree template_info;
1005   tree templ;
1006   tree substitution;
1007
1008   MANGLE_TRACE_TREE ("template-prefix", node);
1009
1010   /* Find the template decl.  */
1011   if (decl_is_template_id (decl, &template_info))
1012     templ = TI_TEMPLATE (template_info);
1013   else if (TREE_CODE (type) == TYPENAME_TYPE)
1014     /* For a typename type, all we have is the name.  */
1015     templ = DECL_NAME (decl);
1016   else
1017     {
1018       gcc_assert (CLASSTYPE_TEMPLATE_ID_P (type));
1019
1020       templ = TYPE_TI_TEMPLATE (type);
1021     }
1022
1023   /* For a member template, though, the template name for the
1024      innermost name must have all the outer template levels
1025      instantiated.  For instance, consider
1026
1027        template<typename T> struct Outer {
1028          template<typename U> struct Inner {};
1029        };
1030
1031      The template name for `Inner' in `Outer<int>::Inner<float>' is
1032      `Outer<int>::Inner<U>'.  In g++, we don't instantiate the template
1033      levels separately, so there's no TEMPLATE_DECL available for this
1034      (there's only `Outer<T>::Inner<U>').
1035
1036      In order to get the substitutions right, we create a special
1037      TREE_LIST to represent the substitution candidate for a nested
1038      template.  The TREE_PURPOSE is the template's context, fully
1039      instantiated, and the TREE_VALUE is the TEMPLATE_DECL for the inner
1040      template.
1041
1042      So, for the example above, `Outer<int>::Inner' is represented as a
1043      substitution candidate by a TREE_LIST whose purpose is `Outer<int>'
1044      and whose value is `Outer<T>::Inner<U>'.  */
1045   if (TYPE_P (context))
1046     substitution = build_tree_list (context, templ);
1047   else
1048     substitution = templ;
1049
1050   if (find_substitution (substitution))
1051     return;
1052
1053   /* In G++ 3.2, the name of the template template parameter was used.  */
1054   if (TREE_TYPE (templ)
1055       && TREE_CODE (TREE_TYPE (templ)) == TEMPLATE_TEMPLATE_PARM
1056       && !abi_version_at_least (2))
1057     G.need_abi_warning = true;
1058
1059   if (TREE_TYPE (templ)
1060       && TREE_CODE (TREE_TYPE (templ)) == TEMPLATE_TEMPLATE_PARM
1061       && abi_version_at_least (2))
1062     write_template_param (TREE_TYPE (templ));
1063   else
1064     {
1065       write_prefix (context);
1066       write_unqualified_name (decl);
1067     }
1068
1069   add_substitution (substitution);
1070 }
1071
1072 /* We don't need to handle thunks, vtables, or VTTs here.  Those are
1073    mangled through special entry points.
1074
1075     <unqualified-name>  ::= <operator-name>
1076                         ::= <special-name>
1077                         ::= <source-name>
1078                         ::= <local-source-name>
1079
1080     <local-source-name> ::= L <source-name> <discriminator> */
1081
1082 static void
1083 write_unqualified_name (const tree decl)
1084 {
1085   MANGLE_TRACE_TREE ("unqualified-name", decl);
1086
1087   if (DECL_LANG_SPECIFIC (decl) != NULL && DECL_CONSTRUCTOR_P (decl))
1088     write_special_name_constructor (decl);
1089   else if (DECL_LANG_SPECIFIC (decl) != NULL && DECL_DESTRUCTOR_P (decl))
1090     write_special_name_destructor (decl);
1091   else if (DECL_NAME (decl) == NULL_TREE)
1092     {
1093       gcc_assert (DECL_ASSEMBLER_NAME_SET_P (decl));
1094       write_source_name (DECL_ASSEMBLER_NAME (decl));
1095     }
1096   else if (DECL_CONV_FN_P (decl))
1097     {
1098       /* Conversion operator. Handle it right here.
1099            <operator> ::= cv <type>  */
1100       tree type;
1101       if (decl_is_template_id (decl, NULL))
1102         {
1103           tree fn_type;
1104           fn_type = get_mostly_instantiated_function_type (decl);
1105           type = TREE_TYPE (fn_type);
1106         }
1107       else
1108         type = DECL_CONV_FN_TYPE (decl);
1109       write_conversion_operator_name (type);
1110     }
1111   else if (DECL_OVERLOADED_OPERATOR_P (decl))
1112     {
1113       operator_name_info_t *oni;
1114       if (DECL_ASSIGNMENT_OPERATOR_P (decl))
1115         oni = assignment_operator_name_info;
1116       else
1117         oni = operator_name_info;
1118
1119       write_string (oni[DECL_OVERLOADED_OPERATOR_P (decl)].mangled_name);
1120     }
1121   else if (VAR_OR_FUNCTION_DECL_P (decl) && ! TREE_PUBLIC (decl)
1122            && DECL_NAMESPACE_SCOPE_P (decl)
1123            && decl_linkage (decl) == lk_internal)
1124     {
1125       MANGLE_TRACE_TREE ("local-source-name", decl);
1126       write_char ('L');
1127       write_source_name (DECL_NAME (decl));
1128       /* The default discriminator is 1, and that's all we ever use,
1129          so there's no code to output one here.  */
1130     }
1131   else
1132     write_source_name (DECL_NAME (decl));
1133 }
1134
1135 /* Write the unqualified-name for a conversion operator to TYPE.  */
1136
1137 static void
1138 write_conversion_operator_name (const tree type)
1139 {
1140   write_string ("cv");
1141   write_type (type);
1142 }
1143
1144 /* Non-terminal <source-name>.  IDENTIFIER is an IDENTIFIER_NODE.
1145
1146      <source-name> ::= </length/ number> <identifier>  */
1147
1148 static void
1149 write_source_name (tree identifier)
1150 {
1151   MANGLE_TRACE_TREE ("source-name", identifier);
1152
1153   /* Never write the whole template-id name including the template
1154      arguments; we only want the template name.  */
1155   if (IDENTIFIER_TEMPLATE (identifier))
1156     identifier = IDENTIFIER_TEMPLATE (identifier);
1157
1158   write_unsigned_number (IDENTIFIER_LENGTH (identifier));
1159   write_identifier (IDENTIFIER_POINTER (identifier));
1160 }
1161
1162 /* Convert NUMBER to ascii using base BASE and generating at least
1163    MIN_DIGITS characters. BUFFER points to the _end_ of the buffer
1164    into which to store the characters. Returns the number of
1165    characters generated (these will be layed out in advance of where
1166    BUFFER points).  */
1167
1168 static int
1169 hwint_to_ascii (unsigned HOST_WIDE_INT number, const unsigned int base,
1170                 char *buffer, const unsigned int min_digits)
1171 {
1172   static const char base_digits[] = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ";
1173   unsigned digits = 0;
1174
1175   while (number)
1176     {
1177       unsigned HOST_WIDE_INT d = number / base;
1178
1179       *--buffer = base_digits[number - d * base];
1180       digits++;
1181       number = d;
1182     }
1183   while (digits < min_digits)
1184     {
1185       *--buffer = base_digits[0];
1186       digits++;
1187     }
1188   return digits;
1189 }
1190
1191 /* Non-terminal <number>.
1192
1193      <number> ::= [n] </decimal integer/>  */
1194
1195 static void
1196 write_number (unsigned HOST_WIDE_INT number, const int unsigned_p,
1197               const unsigned int base)
1198 {
1199   char buffer[sizeof (HOST_WIDE_INT) * 8];
1200   unsigned count = 0;
1201
1202   if (!unsigned_p && (HOST_WIDE_INT) number < 0)
1203     {
1204       write_char ('n');
1205       number = -((HOST_WIDE_INT) number);
1206     }
1207   count = hwint_to_ascii (number, base, buffer + sizeof (buffer), 1);
1208   write_chars (buffer + sizeof (buffer) - count, count);
1209 }
1210
1211 /* Write out an integral CST in decimal. Most numbers are small, and
1212    representable in a HOST_WIDE_INT. Occasionally we'll have numbers
1213    bigger than that, which we must deal with.  */
1214
1215 static inline void
1216 write_integer_cst (const tree cst)
1217 {
1218   int sign = tree_int_cst_sgn (cst);
1219
1220   if (TREE_INT_CST_HIGH (cst) + (sign < 0))
1221     {
1222       /* A bignum. We do this in chunks, each of which fits in a
1223          HOST_WIDE_INT.  */
1224       char buffer[sizeof (HOST_WIDE_INT) * 8 * 2];
1225       unsigned HOST_WIDE_INT chunk;
1226       unsigned chunk_digits;
1227       char *ptr = buffer + sizeof (buffer);
1228       unsigned count = 0;
1229       tree n, base, type;
1230       int done;
1231
1232       /* HOST_WIDE_INT must be at least 32 bits, so 10^9 is
1233          representable.  */
1234       chunk = 1000000000;
1235       chunk_digits = 9;
1236
1237       if (sizeof (HOST_WIDE_INT) >= 8)
1238         {
1239           /* It is at least 64 bits, so 10^18 is representable.  */
1240           chunk_digits = 18;
1241           chunk *= chunk;
1242         }
1243
1244       type = c_common_signed_or_unsigned_type (1, TREE_TYPE (cst));
1245       base = build_int_cstu (type, chunk);
1246       n = build_int_cst_wide (type,
1247                               TREE_INT_CST_LOW (cst), TREE_INT_CST_HIGH (cst));
1248
1249       if (sign < 0)
1250         {
1251           write_char ('n');
1252           n = fold_build1 (NEGATE_EXPR, type, n);
1253         }
1254       do
1255         {
1256           tree d = fold_build2 (FLOOR_DIV_EXPR, type, n, base);
1257           tree tmp = fold_build2 (MULT_EXPR, type, d, base);
1258           unsigned c;
1259
1260           done = integer_zerop (d);
1261           tmp = fold_build2 (MINUS_EXPR, type, n, tmp);
1262           c = hwint_to_ascii (TREE_INT_CST_LOW (tmp), 10, ptr,
1263                               done ? 1 : chunk_digits);
1264           ptr -= c;
1265           count += c;
1266           n = d;
1267         }
1268       while (!done);
1269       write_chars (ptr, count);
1270     }
1271   else
1272     {
1273       /* A small num.  */
1274       unsigned HOST_WIDE_INT low = TREE_INT_CST_LOW (cst);
1275
1276       if (sign < 0)
1277         {
1278           write_char ('n');
1279           low = -low;
1280         }
1281       write_unsigned_number (low);
1282     }
1283 }
1284
1285 /* Write out a floating-point literal.
1286
1287     "Floating-point literals are encoded using the bit pattern of the
1288     target processor's internal representation of that number, as a
1289     fixed-length lowercase hexadecimal string, high-order bytes first
1290     (even if the target processor would store low-order bytes first).
1291     The "n" prefix is not used for floating-point literals; the sign
1292     bit is encoded with the rest of the number.
1293
1294     Here are some examples, assuming the IEEE standard representation
1295     for floating point numbers.  (Spaces are for readability, not
1296     part of the encoding.)
1297
1298         1.0f                    Lf 3f80 0000 E
1299        -1.0f                    Lf bf80 0000 E
1300         1.17549435e-38f         Lf 0080 0000 E
1301         1.40129846e-45f         Lf 0000 0001 E
1302         0.0f                    Lf 0000 0000 E"
1303
1304    Caller is responsible for the Lx and the E.  */
1305 static void
1306 write_real_cst (const tree value)
1307 {
1308   if (abi_version_at_least (2))
1309     {
1310       long target_real[4];  /* largest supported float */
1311       char buffer[9];       /* eight hex digits in a 32-bit number */
1312       int i, limit, dir;
1313
1314       tree type = TREE_TYPE (value);
1315       int words = GET_MODE_BITSIZE (TYPE_MODE (type)) / 32;
1316
1317       real_to_target (target_real, &TREE_REAL_CST (value),
1318                       TYPE_MODE (type));
1319
1320       /* The value in target_real is in the target word order,
1321          so we must write it out backward if that happens to be
1322          little-endian.  write_number cannot be used, it will
1323          produce uppercase.  */
1324       if (FLOAT_WORDS_BIG_ENDIAN)
1325         i = 0, limit = words, dir = 1;
1326       else
1327         i = words - 1, limit = -1, dir = -1;
1328
1329       for (; i != limit; i += dir)
1330         {
1331           sprintf (buffer, "%08lx", (unsigned long) target_real[i]);
1332           write_chars (buffer, 8);
1333         }
1334     }
1335   else
1336     {
1337       /* In G++ 3.3 and before the REAL_VALUE_TYPE was written out
1338          literally.  Note that compatibility with 3.2 is impossible,
1339          because the old floating-point emulator used a different
1340          format for REAL_VALUE_TYPE.  */
1341       size_t i;
1342       for (i = 0; i < sizeof (TREE_REAL_CST (value)); ++i)
1343         write_number (((unsigned char *) &TREE_REAL_CST (value))[i],
1344                       /*unsigned_p*/ 1,
1345                       /*base*/ 16);
1346       G.need_abi_warning = 1;
1347     }
1348 }
1349
1350 /* Non-terminal <identifier>.
1351
1352      <identifier> ::= </unqualified source code identifier>  */
1353
1354 static void
1355 write_identifier (const char *identifier)
1356 {
1357   MANGLE_TRACE ("identifier", identifier);
1358   write_string (identifier);
1359 }
1360
1361 /* Handle constructor productions of non-terminal <special-name>.
1362    CTOR is a constructor FUNCTION_DECL.
1363
1364      <special-name> ::= C1   # complete object constructor
1365                     ::= C2   # base object constructor
1366                     ::= C3   # complete object allocating constructor
1367
1368    Currently, allocating constructors are never used.
1369
1370    We also need to provide mangled names for the maybe-in-charge
1371    constructor, so we treat it here too.  mangle_decl_string will
1372    append *INTERNAL* to that, to make sure we never emit it.  */
1373
1374 static void
1375 write_special_name_constructor (const tree ctor)
1376 {
1377   if (DECL_BASE_CONSTRUCTOR_P (ctor))
1378     write_string ("C2");
1379   else
1380     {
1381       gcc_assert (DECL_COMPLETE_CONSTRUCTOR_P (ctor)
1382                   /* Even though we don't ever emit a definition of
1383                      the old-style destructor, we still have to
1384                      consider entities (like static variables) nested
1385                      inside it.  */
1386                   || DECL_MAYBE_IN_CHARGE_CONSTRUCTOR_P (ctor));
1387       write_string ("C1");
1388     }
1389 }
1390
1391 /* Handle destructor productions of non-terminal <special-name>.
1392    DTOR is a destructor FUNCTION_DECL.
1393
1394      <special-name> ::= D0 # deleting (in-charge) destructor
1395                     ::= D1 # complete object (in-charge) destructor
1396                     ::= D2 # base object (not-in-charge) destructor
1397
1398    We also need to provide mangled names for the maybe-incharge
1399    destructor, so we treat it here too.  mangle_decl_string will
1400    append *INTERNAL* to that, to make sure we never emit it.  */
1401
1402 static void
1403 write_special_name_destructor (const tree dtor)
1404 {
1405   if (DECL_DELETING_DESTRUCTOR_P (dtor))
1406     write_string ("D0");
1407   else if (DECL_BASE_DESTRUCTOR_P (dtor))
1408     write_string ("D2");
1409   else
1410     {
1411       gcc_assert (DECL_COMPLETE_DESTRUCTOR_P (dtor)
1412                   /* Even though we don't ever emit a definition of
1413                      the old-style destructor, we still have to
1414                      consider entities (like static variables) nested
1415                      inside it.  */
1416                   || DECL_MAYBE_IN_CHARGE_DESTRUCTOR_P (dtor));
1417       write_string ("D1");
1418     }
1419 }
1420
1421 /* Return the discriminator for ENTITY appearing inside
1422    FUNCTION.  The discriminator is the lexical ordinal of VAR among
1423    entities with the same name in the same FUNCTION.  */
1424
1425 static int
1426 discriminator_for_local_entity (tree entity)
1427 {
1428   /* Assume this is the only local entity with this name.  */
1429   int discriminator = 0;
1430
1431   if (DECL_DISCRIMINATOR_P (entity) && DECL_LANG_SPECIFIC (entity))
1432     discriminator = DECL_DISCRIMINATOR (entity);
1433   else if (TREE_CODE (entity) == TYPE_DECL)
1434     {
1435       int ix;
1436
1437       /* Scan the list of local classes.  */
1438       entity = TREE_TYPE (entity);
1439       for (ix = 0; ; ix++)
1440         {
1441           tree type = VEC_index (tree, local_classes, ix);
1442           if (type == entity)
1443             break;
1444           if (TYPE_IDENTIFIER (type) == TYPE_IDENTIFIER (entity)
1445               && TYPE_CONTEXT (type) == TYPE_CONTEXT (entity))
1446             ++discriminator;
1447         }
1448     }
1449
1450   return discriminator;
1451 }
1452
1453 /* Return the discriminator for STRING, a string literal used inside
1454    FUNCTION.  The discriminator is the lexical ordinal of STRING among
1455    string literals used in FUNCTION.  */
1456
1457 static int
1458 discriminator_for_string_literal (tree function ATTRIBUTE_UNUSED,
1459                                   tree string ATTRIBUTE_UNUSED)
1460 {
1461   /* For now, we don't discriminate amongst string literals.  */
1462   return 0;
1463 }
1464
1465 /*   <discriminator> := _ <number>
1466
1467    The discriminator is used only for the second and later occurrences
1468    of the same name within a single function. In this case <number> is
1469    n - 2, if this is the nth occurrence, in lexical order.  */
1470
1471 static void
1472 write_discriminator (const int discriminator)
1473 {
1474   /* If discriminator is zero, don't write anything.  Otherwise...  */
1475   if (discriminator > 0)
1476     {
1477       write_char ('_');
1478       write_unsigned_number (discriminator - 1);
1479     }
1480 }
1481
1482 /* Mangle the name of a function-scope entity.  FUNCTION is the
1483    FUNCTION_DECL for the enclosing function.  ENTITY is the decl for
1484    the entity itself.  LOCAL_ENTITY is the entity that's directly
1485    scoped in FUNCTION_DECL, either ENTITY itself or an enclosing scope
1486    of ENTITY.
1487
1488      <local-name> := Z <function encoding> E <entity name> [<discriminator>]
1489                   := Z <function encoding> E s [<discriminator>]  */
1490
1491 static void
1492 write_local_name (const tree function, const tree local_entity,
1493                   const tree entity)
1494 {
1495   MANGLE_TRACE_TREE ("local-name", entity);
1496
1497   write_char ('Z');
1498   write_encoding (function);
1499   write_char ('E');
1500   if (TREE_CODE (entity) == STRING_CST)
1501     {
1502       write_char ('s');
1503       write_discriminator (discriminator_for_string_literal (function,
1504                                                              entity));
1505     }
1506   else
1507     {
1508       /* Now the <entity name>.  Let write_name know its being called
1509          from <local-name>, so it doesn't try to process the enclosing
1510          function scope again.  */
1511       write_name (entity, /*ignore_local_scope=*/1);
1512       write_discriminator (discriminator_for_local_entity (local_entity));
1513     }
1514 }
1515
1516 /* Non-terminals <type> and <CV-qualifier>.
1517
1518      <type> ::= <builtin-type>
1519             ::= <function-type>
1520             ::= <class-enum-type>
1521             ::= <array-type>
1522             ::= <pointer-to-member-type>
1523             ::= <template-param>
1524             ::= <substitution>
1525             ::= <CV-qualifier>
1526             ::= P <type>    # pointer-to
1527             ::= R <type>    # reference-to
1528             ::= C <type>    # complex pair (C 2000)
1529             ::= G <type>    # imaginary (C 2000)     [not supported]
1530             ::= U <source-name> <type>   # vendor extended type qualifier
1531
1532    C++0x extensions
1533
1534      <type> ::= RR <type>   # rvalue reference-to
1535      <type> ::= Dt <expression> # decltype of an id-expression or
1536                                 # class member access
1537      <type> ::= DT <expression> # decltype of an expression
1538
1539    TYPE is a type node.  */
1540
1541 static void
1542 write_type (tree type)
1543 {
1544   /* This gets set to nonzero if TYPE turns out to be a (possibly
1545      CV-qualified) builtin type.  */
1546   int is_builtin_type = 0;
1547
1548   MANGLE_TRACE_TREE ("type", type);
1549
1550   if (type == error_mark_node)
1551     return;
1552
1553   if (find_substitution (type))
1554     return;
1555
1556   if (write_CV_qualifiers_for_type (type) > 0)
1557     /* If TYPE was CV-qualified, we just wrote the qualifiers; now
1558        mangle the unqualified type.  The recursive call is needed here
1559        since both the qualified and unqualified types are substitution
1560        candidates.  */
1561     write_type (TYPE_MAIN_VARIANT (type));
1562   else if (TREE_CODE (type) == ARRAY_TYPE)
1563     /* It is important not to use the TYPE_MAIN_VARIANT of TYPE here
1564        so that the cv-qualification of the element type is available
1565        in write_array_type.  */
1566     write_array_type (type);
1567   else
1568     {
1569       tree type_orig = type;
1570
1571       /* See through any typedefs.  */
1572       type = TYPE_MAIN_VARIANT (type);
1573
1574       if (TYPE_PTRMEM_P (type))
1575         write_pointer_to_member_type (type);
1576       else
1577         {
1578           /* Handle any target-specific fundamental types.  */
1579           const char *target_mangling
1580             = targetm.mangle_type (type_orig);
1581
1582           if (target_mangling)
1583             {
1584               write_string (target_mangling);
1585               /* Add substitutions for types other than fundamental
1586                  types.  */
1587               if (TREE_CODE (type) != VOID_TYPE
1588                   && TREE_CODE (type) != INTEGER_TYPE
1589                   && TREE_CODE (type) != REAL_TYPE
1590                   && TREE_CODE (type) != BOOLEAN_TYPE)
1591                 add_substitution (type);
1592               return;
1593             }
1594
1595           switch (TREE_CODE (type))
1596             {
1597             case VOID_TYPE:
1598             case BOOLEAN_TYPE:
1599             case INTEGER_TYPE:  /* Includes wchar_t.  */
1600             case REAL_TYPE:
1601             case FIXED_POINT_TYPE:
1602               {
1603                 /* If this is a typedef, TYPE may not be one of
1604                    the standard builtin type nodes, but an alias of one.  Use
1605                    TYPE_MAIN_VARIANT to get to the underlying builtin type.  */
1606                 write_builtin_type (TYPE_MAIN_VARIANT (type));
1607                 ++is_builtin_type;
1608               }
1609               break;
1610
1611             case COMPLEX_TYPE:
1612               write_char ('C');
1613               write_type (TREE_TYPE (type));
1614               break;
1615
1616             case FUNCTION_TYPE:
1617             case METHOD_TYPE:
1618               write_function_type (type);
1619               break;
1620
1621             case UNION_TYPE:
1622             case RECORD_TYPE:
1623             case ENUMERAL_TYPE:
1624               /* A pointer-to-member function is represented as a special
1625                  RECORD_TYPE, so check for this first.  */
1626               if (TYPE_PTRMEMFUNC_P (type))
1627                 write_pointer_to_member_type (type);
1628               else
1629                 write_class_enum_type (type);
1630               break;
1631
1632             case TYPENAME_TYPE:
1633             case UNBOUND_CLASS_TEMPLATE:
1634               /* We handle TYPENAME_TYPEs and UNBOUND_CLASS_TEMPLATEs like
1635                  ordinary nested names.  */
1636               write_nested_name (TYPE_STUB_DECL (type));
1637               break;
1638
1639             case POINTER_TYPE:
1640               write_char ('P');
1641               write_type (TREE_TYPE (type));
1642               break;
1643
1644             case REFERENCE_TYPE:
1645               if (TYPE_REF_IS_RVALUE (type))
1646                 write_char('O');
1647               else
1648                 write_char ('R');
1649               write_type (TREE_TYPE (type));
1650               break;
1651
1652             case TEMPLATE_TYPE_PARM:
1653             case TEMPLATE_PARM_INDEX:
1654               write_template_param (type);
1655               break;
1656
1657             case TEMPLATE_TEMPLATE_PARM:
1658               write_template_template_param (type);
1659               break;
1660
1661             case BOUND_TEMPLATE_TEMPLATE_PARM:
1662               write_template_template_param (type);
1663               write_template_args
1664                 (TI_ARGS (TEMPLATE_TEMPLATE_PARM_TEMPLATE_INFO (type)));
1665               break;
1666
1667             case VECTOR_TYPE:
1668               write_string ("U8__vector");
1669               write_type (TREE_TYPE (type));
1670               break;
1671
1672             case TYPE_PACK_EXPANSION:
1673               write_string ("Dp");
1674               write_type (PACK_EXPANSION_PATTERN (type));
1675               break;
1676
1677             case DECLTYPE_TYPE:
1678               write_char ('D');
1679               if (DECLTYPE_TYPE_ID_EXPR_OR_MEMBER_ACCESS_P (type))
1680                 write_char ('t');
1681               else
1682                 write_char ('T');
1683               write_expression (DECLTYPE_TYPE_EXPR (type));
1684               write_char ('E');
1685               break;
1686
1687             case TYPEOF_TYPE:
1688               sorry ("mangling typeof, use decltype instead");
1689               break;
1690
1691             default:
1692               gcc_unreachable ();
1693             }
1694         }
1695     }
1696
1697   /* Types other than builtin types are substitution candidates.  */
1698   if (!is_builtin_type)
1699     add_substitution (type);
1700 }
1701
1702 /* Non-terminal <CV-qualifiers> for type nodes.  Returns the number of
1703    CV-qualifiers written for TYPE.
1704
1705      <CV-qualifiers> ::= [r] [V] [K]  */
1706
1707 static int
1708 write_CV_qualifiers_for_type (const tree type)
1709 {
1710   int num_qualifiers = 0;
1711
1712   /* The order is specified by:
1713
1714        "In cases where multiple order-insensitive qualifiers are
1715        present, they should be ordered 'K' (closest to the base type),
1716        'V', 'r', and 'U' (farthest from the base type) ..."
1717
1718      Note that we do not use cp_type_quals below; given "const
1719      int[3]", the "const" is emitted with the "int", not with the
1720      array.  */
1721
1722   if (TYPE_QUALS (type) & TYPE_QUAL_RESTRICT)
1723     {
1724       write_char ('r');
1725       ++num_qualifiers;
1726     }
1727   if (TYPE_QUALS (type) & TYPE_QUAL_VOLATILE)
1728     {
1729       write_char ('V');
1730       ++num_qualifiers;
1731     }
1732   if (TYPE_QUALS (type) & TYPE_QUAL_CONST)
1733     {
1734       write_char ('K');
1735       ++num_qualifiers;
1736     }
1737
1738   return num_qualifiers;
1739 }
1740
1741 /* Non-terminal <builtin-type>.
1742
1743      <builtin-type> ::= v   # void
1744                     ::= b   # bool
1745                     ::= w   # wchar_t
1746                     ::= c   # char
1747                     ::= a   # signed char
1748                     ::= h   # unsigned char
1749                     ::= s   # short
1750                     ::= t   # unsigned short
1751                     ::= i   # int
1752                     ::= j   # unsigned int
1753                     ::= l   # long
1754                     ::= m   # unsigned long
1755                     ::= x   # long long, __int64
1756                     ::= y   # unsigned long long, __int64
1757                     ::= n   # __int128
1758                     ::= o   # unsigned __int128
1759                     ::= f   # float
1760                     ::= d   # double
1761                     ::= e   # long double, __float80
1762                     ::= g   # __float128          [not supported]
1763                     ::= u <source-name>  # vendor extended type */
1764
1765 static void
1766 write_builtin_type (tree type)
1767 {
1768   if (TYPE_CANONICAL (type))
1769     type = TYPE_CANONICAL (type);
1770
1771   switch (TREE_CODE (type))
1772     {
1773     case VOID_TYPE:
1774       write_char ('v');
1775       break;
1776
1777     case BOOLEAN_TYPE:
1778       write_char ('b');
1779       break;
1780
1781     case INTEGER_TYPE:
1782       /* TYPE may still be wchar_t, char16_t, or char32_t, since that
1783          isn't in integer_type_nodes.  */
1784       if (type == wchar_type_node)
1785         write_char ('w');
1786       else if (type == char16_type_node)
1787         write_string ("Ds");
1788       else if (type == char32_type_node)
1789         write_string ("Di");
1790       else if (TYPE_FOR_JAVA (type))
1791         write_java_integer_type_codes (type);
1792       else
1793         {
1794           size_t itk;
1795           /* Assume TYPE is one of the shared integer type nodes.  Find
1796              it in the array of these nodes.  */
1797         iagain:
1798           for (itk = 0; itk < itk_none; ++itk)
1799             if (type == integer_types[itk])
1800               {
1801                 /* Print the corresponding single-letter code.  */
1802                 write_char (integer_type_codes[itk]);
1803                 break;
1804               }
1805
1806           if (itk == itk_none)
1807             {
1808               tree t = c_common_type_for_mode (TYPE_MODE (type),
1809                                                TYPE_UNSIGNED (type));
1810               if (type != t)
1811                 {
1812                   type = t;
1813                   goto iagain;
1814                 }
1815
1816               if (TYPE_PRECISION (type) == 128)
1817                 write_char (TYPE_UNSIGNED (type) ? 'o' : 'n');
1818               else
1819                 {
1820                   /* Allow for cases where TYPE is not one of the shared
1821                      integer type nodes and write a "vendor extended builtin
1822                      type" with a name the form intN or uintN, respectively.
1823                      Situations like this can happen if you have an
1824                      __attribute__((__mode__(__SI__))) type and use exotic
1825                      switches like '-mint8' on AVR.  Of course, this is
1826                      undefined by the C++ ABI (and '-mint8' is not even
1827                      Standard C conforming), but when using such special
1828                      options you're pretty much in nowhere land anyway.  */
1829                   const char *prefix;
1830                   char prec[11];        /* up to ten digits for an unsigned */
1831
1832                   prefix = TYPE_UNSIGNED (type) ? "uint" : "int";
1833                   sprintf (prec, "%u", (unsigned) TYPE_PRECISION (type));
1834                   write_char ('u');     /* "vendor extended builtin type" */
1835                   write_unsigned_number (strlen (prefix) + strlen (prec));
1836                   write_string (prefix);
1837                   write_string (prec);
1838                 }
1839             }
1840         }
1841       break;
1842
1843     case REAL_TYPE:
1844       if (type == float_type_node
1845           || type == java_float_type_node)
1846         write_char ('f');
1847       else if (type == double_type_node
1848                || type == java_double_type_node)
1849         write_char ('d');
1850       else if (type == long_double_type_node)
1851         write_char ('e');
1852       else
1853         gcc_unreachable ();
1854       break;
1855
1856     case FIXED_POINT_TYPE:
1857       write_string ("DF");
1858       if (GET_MODE_IBIT (TYPE_MODE (type)) > 0)
1859         write_unsigned_number (GET_MODE_IBIT (TYPE_MODE (type)));
1860       if (type == fract_type_node
1861           || type == sat_fract_type_node
1862           || type == accum_type_node
1863           || type == sat_accum_type_node)
1864         write_char ('i');
1865       else if (type == unsigned_fract_type_node
1866                || type == sat_unsigned_fract_type_node
1867                || type == unsigned_accum_type_node
1868                || type == sat_unsigned_accum_type_node)
1869         write_char ('j');
1870       else if (type == short_fract_type_node
1871                || type == sat_short_fract_type_node
1872                || type == short_accum_type_node
1873                || type == sat_short_accum_type_node)
1874         write_char ('s');
1875       else if (type == unsigned_short_fract_type_node
1876                || type == sat_unsigned_short_fract_type_node
1877                || type == unsigned_short_accum_type_node
1878                || type == sat_unsigned_short_accum_type_node)
1879         write_char ('t');
1880       else if (type == long_fract_type_node
1881                || type == sat_long_fract_type_node
1882                || type == long_accum_type_node
1883                || type == sat_long_accum_type_node)
1884         write_char ('l');
1885       else if (type == unsigned_long_fract_type_node
1886                || type == sat_unsigned_long_fract_type_node
1887                || type == unsigned_long_accum_type_node
1888                || type == sat_unsigned_long_accum_type_node)
1889         write_char ('m');
1890       else if (type == long_long_fract_type_node
1891                || type == sat_long_long_fract_type_node
1892                || type == long_long_accum_type_node
1893                || type == sat_long_long_accum_type_node)
1894         write_char ('x');
1895       else if (type == unsigned_long_long_fract_type_node
1896                || type == sat_unsigned_long_long_fract_type_node
1897                || type == unsigned_long_long_accum_type_node
1898                || type == sat_unsigned_long_long_accum_type_node)
1899         write_char ('y');
1900       else
1901         sorry ("mangling unknown fixed point type");
1902       write_unsigned_number (GET_MODE_FBIT (TYPE_MODE (type)));
1903       if (TYPE_SATURATING (type))
1904         write_char ('s');
1905       else
1906         write_char ('n');
1907       break;
1908
1909     default:
1910       gcc_unreachable ();
1911     }
1912 }
1913
1914 /* Non-terminal <function-type>.  NODE is a FUNCTION_TYPE or
1915    METHOD_TYPE.  The return type is mangled before the parameter
1916    types.
1917
1918      <function-type> ::= F [Y] <bare-function-type> E   */
1919
1920 static void
1921 write_function_type (const tree type)
1922 {
1923   MANGLE_TRACE_TREE ("function-type", type);
1924
1925   /* For a pointer to member function, the function type may have
1926      cv-qualifiers, indicating the quals for the artificial 'this'
1927      parameter.  */
1928   if (TREE_CODE (type) == METHOD_TYPE)
1929     {
1930       /* The first parameter must be a POINTER_TYPE pointing to the
1931          `this' parameter.  */
1932       tree this_type = TREE_TYPE (TREE_VALUE (TYPE_ARG_TYPES (type)));
1933       write_CV_qualifiers_for_type (this_type);
1934     }
1935
1936   write_char ('F');
1937   /* We don't track whether or not a type is `extern "C"'.  Note that
1938      you can have an `extern "C"' function that does not have
1939      `extern "C"' type, and vice versa:
1940
1941        extern "C" typedef void function_t();
1942        function_t f; // f has C++ linkage, but its type is
1943                      // `extern "C"'
1944
1945        typedef void function_t();
1946        extern "C" function_t f; // Vice versa.
1947
1948      See [dcl.link].  */
1949   write_bare_function_type (type, /*include_return_type_p=*/1,
1950                             /*decl=*/NULL);
1951   write_char ('E');
1952 }
1953
1954 /* Non-terminal <bare-function-type>.  TYPE is a FUNCTION_TYPE or
1955    METHOD_TYPE.  If INCLUDE_RETURN_TYPE is nonzero, the return value
1956    is mangled before the parameter types.  If non-NULL, DECL is
1957    FUNCTION_DECL for the function whose type is being emitted.
1958
1959    If DECL is a member of a Java type, then a literal 'J'
1960    is output and the return type is mangled as if INCLUDE_RETURN_TYPE
1961    were nonzero.
1962
1963      <bare-function-type> ::= [J]</signature/ type>+  */
1964
1965 static void
1966 write_bare_function_type (const tree type, const int include_return_type_p,
1967                           const tree decl)
1968 {
1969   int java_method_p;
1970
1971   MANGLE_TRACE_TREE ("bare-function-type", type);
1972
1973   /* Detect Java methods and emit special encoding.  */
1974   if (decl != NULL
1975       && DECL_FUNCTION_MEMBER_P (decl)
1976       && TYPE_FOR_JAVA (DECL_CONTEXT (decl))
1977       && !DECL_CONSTRUCTOR_P (decl)
1978       && !DECL_DESTRUCTOR_P (decl)
1979       && !DECL_CONV_FN_P (decl))
1980     {
1981       java_method_p = 1;
1982       write_char ('J');
1983     }
1984   else
1985     {
1986       java_method_p = 0;
1987     }
1988
1989   /* Mangle the return type, if requested.  */
1990   if (include_return_type_p || java_method_p)
1991     write_type (TREE_TYPE (type));
1992
1993   /* Now mangle the types of the arguments.  */
1994   write_method_parms (TYPE_ARG_TYPES (type),
1995                       TREE_CODE (type) == METHOD_TYPE,
1996                       decl);
1997 }
1998
1999 /* Write the mangled representation of a method parameter list of
2000    types given in PARM_TYPES.  If METHOD_P is nonzero, the function is
2001    considered a non-static method, and the this parameter is omitted.
2002    If non-NULL, DECL is the FUNCTION_DECL for the function whose
2003    parameters are being emitted.  */
2004
2005 static void
2006 write_method_parms (tree parm_types, const int method_p, const tree decl)
2007 {
2008   tree first_parm_type;
2009   tree parm_decl = decl ? DECL_ARGUMENTS (decl) : NULL_TREE;
2010
2011   /* Assume this parameter type list is variable-length.  If it ends
2012      with a void type, then it's not.  */
2013   int varargs_p = 1;
2014
2015   /* If this is a member function, skip the first arg, which is the
2016      this pointer.
2017        "Member functions do not encode the type of their implicit this
2018        parameter."
2019
2020      Similarly, there's no need to mangle artificial parameters, like
2021      the VTT parameters for constructors and destructors.  */
2022   if (method_p)
2023     {
2024       parm_types = TREE_CHAIN (parm_types);
2025       parm_decl = parm_decl ? TREE_CHAIN (parm_decl) : NULL_TREE;
2026
2027       while (parm_decl && DECL_ARTIFICIAL (parm_decl))
2028         {
2029           parm_types = TREE_CHAIN (parm_types);
2030           parm_decl = TREE_CHAIN (parm_decl);
2031         }
2032     }
2033
2034   for (first_parm_type = parm_types;
2035        parm_types;
2036        parm_types = TREE_CHAIN (parm_types))
2037     {
2038       tree parm = TREE_VALUE (parm_types);
2039       if (parm == void_type_node)
2040         {
2041           /* "Empty parameter lists, whether declared as () or
2042              conventionally as (void), are encoded with a void parameter
2043              (v)."  */
2044           if (parm_types == first_parm_type)
2045             write_type (parm);
2046           /* If the parm list is terminated with a void type, it's
2047              fixed-length.  */
2048           varargs_p = 0;
2049           /* A void type better be the last one.  */
2050           gcc_assert (TREE_CHAIN (parm_types) == NULL);
2051         }
2052       else
2053         write_type (parm);
2054     }
2055
2056   if (varargs_p)
2057     /* <builtin-type> ::= z  # ellipsis  */
2058     write_char ('z');
2059 }
2060
2061 /* <class-enum-type> ::= <name>  */
2062
2063 static void
2064 write_class_enum_type (const tree type)
2065 {
2066   write_name (TYPE_NAME (type), /*ignore_local_scope=*/0);
2067 }
2068
2069 /* Non-terminal <template-args>.  ARGS is a TREE_VEC of template
2070    arguments.
2071
2072      <template-args> ::= I <template-arg>+ E  */
2073
2074 static void
2075 write_template_args (tree args)
2076 {
2077   int i;
2078   int length = TREE_VEC_LENGTH (args);
2079
2080   MANGLE_TRACE_TREE ("template-args", args);
2081
2082   write_char ('I');
2083
2084   gcc_assert (length > 0);
2085
2086   if (TREE_CODE (TREE_VEC_ELT (args, 0)) == TREE_VEC)
2087     {
2088       /* We have nested template args.  We want the innermost template
2089          argument list.  */
2090       args = TREE_VEC_ELT (args, length - 1);
2091       length = TREE_VEC_LENGTH (args);
2092     }
2093   for (i = 0; i < length; ++i)
2094     write_template_arg (TREE_VEC_ELT (args, i));
2095
2096   write_char ('E');
2097 }
2098
2099 /* Write out the
2100    <unqualified-name>
2101    <unqualified-name> <template-args>
2102    part of SCOPE_REF or COMPONENT_REF mangling.  */
2103
2104 static void
2105 write_member_name (tree member)
2106 {
2107   if (TREE_CODE (member) == IDENTIFIER_NODE)
2108     write_source_name (member);
2109   else if (DECL_P (member))
2110     {
2111       /* G++ 3.2 incorrectly put out both the "sr" code and
2112          the nested name of the qualified name.  */
2113       G.need_abi_warning = 1;
2114       write_unqualified_name (member);
2115     }
2116   else if (TREE_CODE (member) == TEMPLATE_ID_EXPR)
2117     {
2118       tree name = TREE_OPERAND (member, 0);
2119       if (TREE_CODE (name) == OVERLOAD)
2120         name = OVL_FUNCTION (name);
2121       write_member_name (name);
2122       write_template_args (TREE_OPERAND (member, 1));
2123     }
2124   else
2125     write_expression (member);
2126 }
2127
2128 /* <expression> ::= <unary operator-name> <expression>
2129                 ::= <binary operator-name> <expression> <expression>
2130                 ::= <expr-primary>
2131
2132    <expr-primary> ::= <template-param>
2133                   ::= L <type> <value number> E         # literal
2134                   ::= L <mangled-name> E                # external name
2135                   ::= st <type>                         # sizeof
2136                   ::= sr <type> <unqualified-name>      # dependent name
2137                   ::= sr <type> <unqualified-name> <template-args> */
2138
2139 static void
2140 write_expression (tree expr)
2141 {
2142   enum tree_code code;
2143
2144   code = TREE_CODE (expr);
2145
2146   /* Skip NOP_EXPRs.  They can occur when (say) a pointer argument
2147      is converted (via qualification conversions) to another
2148      type.  */
2149   while (TREE_CODE (expr) == NOP_EXPR
2150          || TREE_CODE (expr) == NON_LVALUE_EXPR)
2151     {
2152       expr = TREE_OPERAND (expr, 0);
2153       code = TREE_CODE (expr);
2154     }
2155
2156   if (code == BASELINK)
2157     {
2158       expr = BASELINK_FUNCTIONS (expr);
2159       code = TREE_CODE (expr);
2160     }
2161
2162   if (code == OVERLOAD)
2163     {
2164       expr = OVL_FUNCTION (expr);
2165       code = TREE_CODE (expr);
2166     }
2167
2168   /* Handle pointers-to-members by making them look like expression
2169      nodes.  */
2170   if (code == PTRMEM_CST)
2171     {
2172       expr = build_nt (ADDR_EXPR,
2173                        build_qualified_name (/*type=*/NULL_TREE,
2174                                              PTRMEM_CST_CLASS (expr),
2175                                              PTRMEM_CST_MEMBER (expr),
2176                                              /*template_p=*/false));
2177       code = TREE_CODE (expr);
2178     }
2179
2180   /* Handle template parameters.  */
2181   if (code == TEMPLATE_TYPE_PARM
2182       || code == TEMPLATE_TEMPLATE_PARM
2183       || code == BOUND_TEMPLATE_TEMPLATE_PARM
2184       || code == TEMPLATE_PARM_INDEX)
2185     write_template_param (expr);
2186   /* Handle literals.  */
2187   else if (TREE_CODE_CLASS (code) == tcc_constant
2188            || (abi_version_at_least (2) && code == CONST_DECL))
2189     write_template_arg_literal (expr);
2190   else if (code == PARM_DECL)
2191     {
2192       /* A function parameter used under decltype in a late-specified
2193          return type.  Represented with a type placeholder.  */
2194       write_string ("sT");
2195       write_type (non_reference (TREE_TYPE (expr)));
2196     }
2197   else if (DECL_P (expr))
2198     {
2199       /* G++ 3.2 incorrectly mangled non-type template arguments of
2200          enumeration type using their names.  */
2201       if (code == CONST_DECL)
2202         G.need_abi_warning = 1;
2203       write_char ('L');
2204       write_mangled_name (expr, false);
2205       write_char ('E');
2206     }
2207   else if (TREE_CODE (expr) == SIZEOF_EXPR
2208            && TYPE_P (TREE_OPERAND (expr, 0)))
2209     {
2210       write_string ("st");
2211       write_type (TREE_OPERAND (expr, 0));
2212     }
2213   else if (abi_version_at_least (2) && TREE_CODE (expr) == SCOPE_REF)
2214     {
2215       tree scope = TREE_OPERAND (expr, 0);
2216       tree member = TREE_OPERAND (expr, 1);
2217
2218       /* If the MEMBER is a real declaration, then the qualifying
2219          scope was not dependent.  Ideally, we would not have a
2220          SCOPE_REF in those cases, but sometimes we do.  If the second
2221          argument is a DECL, then the name must not have been
2222          dependent.  */
2223       if (DECL_P (member))
2224         write_expression (member);
2225       else
2226         {
2227           tree template_args;
2228
2229           write_string ("sr");
2230           write_type (scope);
2231           /* If MEMBER is a template-id, separate the template
2232              from the arguments.  */
2233           if (TREE_CODE (member) == TEMPLATE_ID_EXPR)
2234             {
2235               template_args = TREE_OPERAND (member, 1);
2236               member = TREE_OPERAND (member, 0);
2237             }
2238           else
2239             template_args = NULL_TREE;
2240           /* Write out the name of the MEMBER.  */
2241           if (IDENTIFIER_TYPENAME_P (member))
2242             write_conversion_operator_name (TREE_TYPE (member));
2243           else if (IDENTIFIER_OPNAME_P (member))
2244             {
2245               int i;
2246               const char *mangled_name = NULL;
2247
2248               /* Unfortunately, there is no easy way to go from the
2249                  name of the operator back to the corresponding tree
2250                  code.  */
2251               for (i = 0; i < MAX_TREE_CODES; ++i)
2252                 if (operator_name_info[i].identifier == member)
2253                   {
2254                     /* The ABI says that we prefer binary operator
2255                        names to unary operator names.  */
2256                     if (operator_name_info[i].arity == 2)
2257                       {
2258                         mangled_name = operator_name_info[i].mangled_name;
2259                         break;
2260                       }
2261                     else if (!mangled_name)
2262                       mangled_name = operator_name_info[i].mangled_name;
2263                   }
2264                 else if (assignment_operator_name_info[i].identifier
2265                          == member)
2266                   {
2267                     mangled_name
2268                       = assignment_operator_name_info[i].mangled_name;
2269                     break;
2270                   }
2271               write_string (mangled_name);
2272             }
2273           else
2274             write_source_name (member);
2275           /* Write out the template arguments.  */
2276           if (template_args)
2277             write_template_args (template_args);
2278         }
2279     }
2280   else if (code == COMPONENT_REF)
2281     {
2282       tree ob = TREE_OPERAND (expr, 0);
2283
2284       if (TREE_CODE (ob) == ARROW_EXPR)
2285         {
2286           code = ARROW_EXPR;
2287           ob = TREE_OPERAND (ob, 0);
2288         }
2289
2290       write_string (operator_name_info[(int)code].mangled_name);
2291       write_expression (ob);
2292       write_member_name (TREE_OPERAND (expr, 1));
2293     }
2294   else
2295     {
2296       int i;
2297
2298       /* When we bind a variable or function to a non-type template
2299          argument with reference type, we create an ADDR_EXPR to show
2300          the fact that the entity's address has been taken.  But, we
2301          don't actually want to output a mangling code for the `&'.  */
2302       if (TREE_CODE (expr) == ADDR_EXPR
2303           && TREE_TYPE (expr)
2304           && TREE_CODE (TREE_TYPE (expr)) == REFERENCE_TYPE)
2305         {
2306           expr = TREE_OPERAND (expr, 0);
2307           if (DECL_P (expr))
2308             {
2309               write_expression (expr);
2310               return;
2311             }
2312
2313           code = TREE_CODE (expr);
2314         }
2315
2316       /* If it wasn't any of those, recursively expand the expression.  */
2317       write_string (operator_name_info[(int) code].mangled_name);
2318
2319       switch (code)
2320         {
2321         case CALL_EXPR:
2322           write_expression (CALL_EXPR_FN (expr));
2323           for (i = 0; i < call_expr_nargs (expr); ++i)
2324             write_expression (CALL_EXPR_ARG (expr, i));
2325           write_char ('E');
2326           break;
2327
2328         case CAST_EXPR:
2329           write_type (TREE_TYPE (expr));
2330           if (!TREE_OPERAND (expr, 0))
2331             /* "T()" is mangled as "T(void)".  */
2332             write_char ('v');
2333           else if (list_length (TREE_OPERAND (expr, 0)) > 1)
2334             /* FIXME the above hack for T() needs to be replaced with
2335                something more general.  */
2336             sorry ("mangling function-style cast with more than one argument");
2337           else
2338             write_expression (TREE_VALUE (TREE_OPERAND (expr, 0)));
2339           break;
2340
2341         case STATIC_CAST_EXPR:
2342         case CONST_CAST_EXPR:
2343           write_type (TREE_TYPE (expr));
2344           write_expression (TREE_OPERAND (expr, 0));
2345           break;
2346
2347         /* Handle pointers-to-members specially.  */
2348         case SCOPE_REF:
2349           write_type (TREE_OPERAND (expr, 0));
2350           write_member_name (TREE_OPERAND (expr, 1));
2351           break;
2352
2353         default:
2354           for (i = 0; i < TREE_OPERAND_LENGTH (expr); ++i)
2355             {
2356               tree operand = TREE_OPERAND (expr, i);
2357               /* As a GNU extension, the middle operand of a
2358                  conditional may be omitted.  Since expression
2359                  manglings are supposed to represent the input token
2360                  stream, there's no good way to mangle such an
2361                  expression without extending the C++ ABI.  */
2362               if (code == COND_EXPR && i == 1 && !operand)
2363                 {
2364                   error ("omitted middle operand to %<?:%> operand "
2365                          "cannot be mangled");
2366                   continue;
2367                 }
2368               write_expression (operand);
2369             }
2370         }
2371     }
2372 }
2373
2374 /* Literal subcase of non-terminal <template-arg>.
2375
2376      "Literal arguments, e.g. "A<42L>", are encoded with their type
2377      and value. Negative integer values are preceded with "n"; for
2378      example, "A<-42L>" becomes "1AILln42EE". The bool value false is
2379      encoded as 0, true as 1."  */
2380
2381 static void
2382 write_template_arg_literal (const tree value)
2383 {
2384   write_char ('L');
2385   write_type (TREE_TYPE (value));
2386
2387   switch (TREE_CODE (value))
2388     {
2389     case CONST_DECL:
2390       write_integer_cst (DECL_INITIAL (value));
2391       break;
2392
2393     case INTEGER_CST:
2394       gcc_assert (!same_type_p (TREE_TYPE (value), boolean_type_node)
2395                   || integer_zerop (value) || integer_onep (value));
2396       write_integer_cst (value);
2397       break;
2398
2399     case REAL_CST:
2400       write_real_cst (value);
2401       break;
2402
2403     default:
2404       gcc_unreachable ();
2405     }
2406
2407   write_char ('E');
2408 }
2409
2410 /* Non-terminal <template-arg>.
2411
2412      <template-arg> ::= <type>                          # type
2413                     ::= L <type> </value/ number> E     # literal
2414                     ::= LZ <name> E                     # external name
2415                     ::= X <expression> E                # expression  */
2416
2417 static void
2418 write_template_arg (tree node)
2419 {
2420   enum tree_code code = TREE_CODE (node);
2421
2422   MANGLE_TRACE_TREE ("template-arg", node);
2423
2424   /* A template template parameter's argument list contains TREE_LIST
2425      nodes of which the value field is the actual argument.  */
2426   if (code == TREE_LIST)
2427     {
2428       node = TREE_VALUE (node);
2429       /* If it's a decl, deal with its type instead.  */
2430       if (DECL_P (node))
2431         {
2432           node = TREE_TYPE (node);
2433           code = TREE_CODE (node);
2434         }
2435     }
2436
2437   if (TREE_CODE (node) == NOP_EXPR
2438       && TREE_CODE (TREE_TYPE (node)) == REFERENCE_TYPE)
2439     {
2440       /* Template parameters can be of reference type. To maintain
2441          internal consistency, such arguments use a conversion from
2442          address of object to reference type.  */
2443       gcc_assert (TREE_CODE (TREE_OPERAND (node, 0)) == ADDR_EXPR);
2444       if (abi_version_at_least (2))
2445         node = TREE_OPERAND (TREE_OPERAND (node, 0), 0);
2446       else
2447         G.need_abi_warning = 1;
2448     }
2449
2450   if (ARGUMENT_PACK_P (node))
2451     {
2452       /* Expand the template argument pack. */
2453       tree args = ARGUMENT_PACK_ARGS (node);
2454       int i, length = TREE_VEC_LENGTH (args);
2455       write_char ('I');
2456       for (i = 0; i < length; ++i)
2457         write_template_arg (TREE_VEC_ELT (args, i));
2458       write_char ('E');
2459     }
2460   else if (TYPE_P (node))
2461     write_type (node);
2462   else if (code == TEMPLATE_DECL)
2463     /* A template appearing as a template arg is a template template arg.  */
2464     write_template_template_arg (node);
2465   else if ((TREE_CODE_CLASS (code) == tcc_constant && code != PTRMEM_CST)
2466            || (abi_version_at_least (2) && code == CONST_DECL))
2467     write_template_arg_literal (node);
2468   else if (DECL_P (node))
2469     {
2470       /* Until ABI version 2, non-type template arguments of
2471          enumeration type were mangled using their names.  */
2472       if (code == CONST_DECL && !abi_version_at_least (2))
2473         G.need_abi_warning = 1;
2474       write_char ('L');
2475       /* Until ABI version 3, the underscore before the mangled name
2476          was incorrectly omitted.  */
2477       if (!abi_version_at_least (3))
2478         {
2479           G.need_abi_warning = 1;
2480           write_char ('Z');
2481         }
2482       else
2483         write_string ("_Z");
2484       write_encoding (node);
2485       write_char ('E');
2486     }
2487   else
2488     {
2489       /* Template arguments may be expressions.  */
2490       write_char ('X');
2491       write_expression (node);
2492       write_char ('E');
2493     }
2494 }
2495
2496 /*  <template-template-arg>
2497                         ::= <name>
2498                         ::= <substitution>  */
2499
2500 static void
2501 write_template_template_arg (const tree decl)
2502 {
2503   MANGLE_TRACE_TREE ("template-template-arg", decl);
2504
2505   if (find_substitution (decl))
2506     return;
2507   write_name (decl, /*ignore_local_scope=*/0);
2508   add_substitution (decl);
2509 }
2510
2511
2512 /* Non-terminal <array-type>.  TYPE is an ARRAY_TYPE.
2513
2514      <array-type> ::= A [</dimension/ number>] _ </element/ type>
2515                   ::= A <expression> _ </element/ type>
2516
2517      "Array types encode the dimension (number of elements) and the
2518      element type. For variable length arrays, the dimension (but not
2519      the '_' separator) is omitted."  */
2520
2521 static void
2522 write_array_type (const tree type)
2523 {
2524   write_char ('A');
2525   if (TYPE_DOMAIN (type))
2526     {
2527       tree index_type;
2528       tree max;
2529
2530       index_type = TYPE_DOMAIN (type);
2531       /* The INDEX_TYPE gives the upper and lower bounds of the
2532          array.  */
2533       max = TYPE_MAX_VALUE (index_type);
2534       if (TREE_CODE (max) == INTEGER_CST)
2535         {
2536           /* The ABI specifies that we should mangle the number of
2537              elements in the array, not the largest allowed index.  */
2538           max = size_binop (PLUS_EXPR, max, size_one_node);
2539           write_unsigned_number (tree_low_cst (max, 1));
2540         }
2541       else
2542         {
2543           max = TREE_OPERAND (max, 0);
2544           if (!abi_version_at_least (2))
2545             {
2546               /* value_dependent_expression_p presumes nothing is
2547                  dependent when PROCESSING_TEMPLATE_DECL is zero.  */
2548               ++processing_template_decl;
2549               if (!value_dependent_expression_p (max))
2550                 G.need_abi_warning = 1;
2551               --processing_template_decl;
2552             }
2553           write_expression (max);
2554         }
2555
2556     }
2557   write_char ('_');
2558   write_type (TREE_TYPE (type));
2559 }
2560
2561 /* Non-terminal <pointer-to-member-type> for pointer-to-member
2562    variables.  TYPE is a pointer-to-member POINTER_TYPE.
2563
2564      <pointer-to-member-type> ::= M </class/ type> </member/ type>  */
2565
2566 static void
2567 write_pointer_to_member_type (const tree type)
2568 {
2569   write_char ('M');
2570   write_type (TYPE_PTRMEM_CLASS_TYPE (type));
2571   write_type (TYPE_PTRMEM_POINTED_TO_TYPE (type));
2572 }
2573
2574 /* Non-terminal <template-param>.  PARM is a TEMPLATE_TYPE_PARM,
2575    TEMPLATE_TEMPLATE_PARM, BOUND_TEMPLATE_TEMPLATE_PARM or a
2576    TEMPLATE_PARM_INDEX.
2577
2578      <template-param> ::= T </parameter/ number> _  */
2579
2580 static void
2581 write_template_param (const tree parm)
2582 {
2583   int parm_index;
2584   int parm_level;
2585   tree parm_type = NULL_TREE;
2586
2587   MANGLE_TRACE_TREE ("template-parm", parm);
2588
2589   switch (TREE_CODE (parm))
2590     {
2591     case TEMPLATE_TYPE_PARM:
2592     case TEMPLATE_TEMPLATE_PARM:
2593     case BOUND_TEMPLATE_TEMPLATE_PARM:
2594       parm_index = TEMPLATE_TYPE_IDX (parm);
2595       parm_level = TEMPLATE_TYPE_LEVEL (parm);
2596       break;
2597
2598     case TEMPLATE_PARM_INDEX:
2599       parm_index = TEMPLATE_PARM_IDX (parm);
2600       parm_level = TEMPLATE_PARM_LEVEL (parm);
2601       parm_type = TREE_TYPE (TEMPLATE_PARM_DECL (parm));
2602       break;
2603
2604     default:
2605       gcc_unreachable ();
2606     }
2607
2608   write_char ('T');
2609   /* NUMBER as it appears in the mangling is (-1)-indexed, with the
2610      earliest template param denoted by `_'.  */
2611   if (parm_index > 0)
2612     write_unsigned_number (parm_index - 1);
2613   write_char ('_');
2614 }
2615
2616 /*  <template-template-param>
2617                         ::= <template-param>
2618                         ::= <substitution>  */
2619
2620 static void
2621 write_template_template_param (const tree parm)
2622 {
2623   tree templ = NULL_TREE;
2624
2625   /* PARM, a TEMPLATE_TEMPLATE_PARM, is an instantiation of the
2626      template template parameter.  The substitution candidate here is
2627      only the template.  */
2628   if (TREE_CODE (parm) == BOUND_TEMPLATE_TEMPLATE_PARM)
2629     {
2630       templ
2631         = TI_TEMPLATE (TEMPLATE_TEMPLATE_PARM_TEMPLATE_INFO (parm));
2632       if (find_substitution (templ))
2633         return;
2634     }
2635
2636   /* <template-param> encodes only the template parameter position,
2637      not its template arguments, which is fine here.  */
2638   write_template_param (parm);
2639   if (templ)
2640     add_substitution (templ);
2641 }
2642
2643 /* Non-terminal <substitution>.
2644
2645       <substitution> ::= S <seq-id> _
2646                      ::= S_  */
2647
2648 static void
2649 write_substitution (const int seq_id)
2650 {
2651   MANGLE_TRACE ("substitution", "");
2652
2653   write_char ('S');
2654   if (seq_id > 0)
2655     write_number (seq_id - 1, /*unsigned=*/1, 36);
2656   write_char ('_');
2657 }
2658
2659 /* Start mangling ENTITY.  */
2660
2661 static inline void
2662 start_mangling (const tree entity)
2663 {
2664   G.entity = entity;
2665   G.need_abi_warning = false;
2666   obstack_free (&name_obstack, name_base);
2667   mangle_obstack = &name_obstack;
2668   name_base = obstack_alloc (&name_obstack, 0);
2669 }
2670
2671 /* Done with mangling. If WARN is true, and the name of G.entity will
2672    be mangled differently in a future version of the ABI, issue a
2673    warning.  */
2674
2675 static void
2676 finish_mangling_internal (const bool warn)
2677 {
2678   if (warn_abi && warn && G.need_abi_warning)
2679     warning (OPT_Wabi, "the mangled name of %qD will change in a future "
2680              "version of GCC",
2681              G.entity);
2682
2683   /* Clear all the substitutions.  */
2684   VEC_truncate (tree, G.substitutions, 0);
2685
2686   /* Null-terminate the string.  */
2687   write_char ('\0');
2688 }
2689
2690
2691 /* Like finish_mangling_internal, but return the mangled string.  */
2692
2693 static inline const char *
2694 finish_mangling (const bool warn)
2695 {
2696   finish_mangling_internal (warn);
2697   return (const char *) obstack_finish (mangle_obstack);
2698 }
2699
2700 /* Like finish_mangling_internal, but return an identifier.  */
2701
2702 static tree
2703 finish_mangling_get_identifier (const bool warn)
2704 {
2705   finish_mangling_internal (warn);
2706   /* Don't obstack_finish here, and the next start_mangling will
2707      remove the identifier.  */
2708   return get_identifier ((const char *) name_base);
2709 }
2710
2711 /* Initialize data structures for mangling.  */
2712
2713 void
2714 init_mangle (void)
2715 {
2716   gcc_obstack_init (&name_obstack);
2717   name_base = obstack_alloc (&name_obstack, 0);
2718   G.substitutions = NULL;
2719
2720   /* Cache these identifiers for quick comparison when checking for
2721      standard substitutions.  */
2722   subst_identifiers[SUBID_ALLOCATOR] = get_identifier ("allocator");
2723   subst_identifiers[SUBID_BASIC_STRING] = get_identifier ("basic_string");
2724   subst_identifiers[SUBID_CHAR_TRAITS] = get_identifier ("char_traits");
2725   subst_identifiers[SUBID_BASIC_ISTREAM] = get_identifier ("basic_istream");
2726   subst_identifiers[SUBID_BASIC_OSTREAM] = get_identifier ("basic_ostream");
2727   subst_identifiers[SUBID_BASIC_IOSTREAM] = get_identifier ("basic_iostream");
2728 }
2729
2730 /* Generate the mangled name of DECL.  */
2731
2732 static tree
2733 mangle_decl_string (const tree decl)
2734 {
2735   tree result;
2736
2737   start_mangling (decl);
2738
2739   if (TREE_CODE (decl) == TYPE_DECL)
2740     write_type (TREE_TYPE (decl));
2741   else
2742     write_mangled_name (decl, true);
2743
2744   result = finish_mangling_get_identifier (/*warn=*/true);
2745   if (DEBUG_MANGLE)
2746     fprintf (stderr, "mangle_decl_string = '%s'\n\n",
2747              IDENTIFIER_POINTER (result));
2748   return result;
2749 }
2750
2751 /* Create an identifier for the external mangled name of DECL.  */
2752
2753 void
2754 mangle_decl (const tree decl)
2755 {
2756   tree id = mangle_decl_string (decl);
2757   id = targetm.mangle_decl_assembler_name (decl, id);
2758   SET_DECL_ASSEMBLER_NAME (decl, id);
2759 }
2760
2761 /* Generate the mangled representation of TYPE.  */
2762
2763 const char *
2764 mangle_type_string (const tree type)
2765 {
2766   const char *result;
2767
2768   start_mangling (type);
2769   write_type (type);
2770   result = finish_mangling (/*warn=*/false);
2771   if (DEBUG_MANGLE)
2772     fprintf (stderr, "mangle_type_string = '%s'\n\n", result);
2773   return result;
2774 }
2775
2776 /* Create an identifier for the mangled name of a special component
2777    for belonging to TYPE.  CODE is the ABI-specified code for this
2778    component.  */
2779
2780 static tree
2781 mangle_special_for_type (const tree type, const char *code)
2782 {
2783   tree result;
2784
2785   /* We don't have an actual decl here for the special component, so
2786      we can't just process the <encoded-name>.  Instead, fake it.  */
2787   start_mangling (type);
2788
2789   /* Start the mangling.  */
2790   write_string ("_Z");
2791   write_string (code);
2792
2793   /* Add the type.  */
2794   write_type (type);
2795   result = finish_mangling_get_identifier (/*warn=*/false);
2796
2797   if (DEBUG_MANGLE)
2798     fprintf (stderr, "mangle_special_for_type = %s\n\n",
2799              IDENTIFIER_POINTER (result));
2800
2801   return result;
2802 }
2803
2804 /* Create an identifier for the mangled representation of the typeinfo
2805    structure for TYPE.  */
2806
2807 tree
2808 mangle_typeinfo_for_type (const tree type)
2809 {
2810   return mangle_special_for_type (type, "TI");
2811 }
2812
2813 /* Create an identifier for the mangled name of the NTBS containing
2814    the mangled name of TYPE.  */
2815
2816 tree
2817 mangle_typeinfo_string_for_type (const tree type)
2818 {
2819   return mangle_special_for_type (type, "TS");
2820 }
2821
2822 /* Create an identifier for the mangled name of the vtable for TYPE.  */
2823
2824 tree
2825 mangle_vtbl_for_type (const tree type)
2826 {
2827   return mangle_special_for_type (type, "TV");
2828 }
2829
2830 /* Returns an identifier for the mangled name of the VTT for TYPE.  */
2831
2832 tree
2833 mangle_vtt_for_type (const tree type)
2834 {
2835   return mangle_special_for_type (type, "TT");
2836 }
2837
2838 /* Return an identifier for a construction vtable group.  TYPE is
2839    the most derived class in the hierarchy; BINFO is the base
2840    subobject for which this construction vtable group will be used.
2841
2842    This mangling isn't part of the ABI specification; in the ABI
2843    specification, the vtable group is dumped in the same COMDAT as the
2844    main vtable, and is referenced only from that vtable, so it doesn't
2845    need an external name.  For binary formats without COMDAT sections,
2846    though, we need external names for the vtable groups.
2847
2848    We use the production
2849
2850     <special-name> ::= CT <type> <offset number> _ <base type>  */
2851
2852 tree
2853 mangle_ctor_vtbl_for_type (const tree type, const tree binfo)
2854 {
2855   tree result;
2856
2857   start_mangling (type);
2858
2859   write_string ("_Z");
2860   write_string ("TC");
2861   write_type (type);
2862   write_integer_cst (BINFO_OFFSET (binfo));
2863   write_char ('_');
2864   write_type (BINFO_TYPE (binfo));
2865
2866   result = finish_mangling_get_identifier (/*warn=*/false);
2867   if (DEBUG_MANGLE)
2868     fprintf (stderr, "mangle_ctor_vtbl_for_type = %s\n\n",
2869              IDENTIFIER_POINTER (result));
2870   return result;
2871 }
2872
2873 /* Mangle a this pointer or result pointer adjustment.
2874
2875    <call-offset> ::= h <fixed offset number> _
2876                  ::= v <fixed offset number> _ <virtual offset number> _ */
2877
2878 static void
2879 mangle_call_offset (const tree fixed_offset, const tree virtual_offset)
2880 {
2881   write_char (virtual_offset ? 'v' : 'h');
2882
2883   /* For either flavor, write the fixed offset.  */
2884   write_integer_cst (fixed_offset);
2885   write_char ('_');
2886
2887   /* For a virtual thunk, add the virtual offset.  */
2888   if (virtual_offset)
2889     {
2890       write_integer_cst (virtual_offset);
2891       write_char ('_');
2892     }
2893 }
2894
2895 /* Return an identifier for the mangled name of a this-adjusting or
2896    covariant thunk to FN_DECL.  FIXED_OFFSET is the initial adjustment
2897    to this used to find the vptr.  If VIRTUAL_OFFSET is non-NULL, this
2898    is a virtual thunk, and it is the vtbl offset in
2899    bytes. THIS_ADJUSTING is nonzero for a this adjusting thunk and
2900    zero for a covariant thunk. Note, that FN_DECL might be a covariant
2901    thunk itself. A covariant thunk name always includes the adjustment
2902    for the this pointer, even if there is none.
2903
2904    <special-name> ::= T <call-offset> <base encoding>
2905                   ::= Tc <this_adjust call-offset> <result_adjust call-offset>
2906                                         <base encoding>  */
2907
2908 tree
2909 mangle_thunk (tree fn_decl, const int this_adjusting, tree fixed_offset,
2910               tree virtual_offset)
2911 {
2912   tree result;
2913
2914   start_mangling (fn_decl);
2915
2916   write_string ("_Z");
2917   write_char ('T');
2918
2919   if (!this_adjusting)
2920     {
2921       /* Covariant thunk with no this adjustment */
2922       write_char ('c');
2923       mangle_call_offset (integer_zero_node, NULL_TREE);
2924       mangle_call_offset (fixed_offset, virtual_offset);
2925     }
2926   else if (!DECL_THUNK_P (fn_decl))
2927     /* Plain this adjusting thunk.  */
2928     mangle_call_offset (fixed_offset, virtual_offset);
2929   else
2930     {
2931       /* This adjusting thunk to covariant thunk.  */
2932       write_char ('c');
2933       mangle_call_offset (fixed_offset, virtual_offset);
2934       fixed_offset = ssize_int (THUNK_FIXED_OFFSET (fn_decl));
2935       virtual_offset = THUNK_VIRTUAL_OFFSET (fn_decl);
2936       if (virtual_offset)
2937         virtual_offset = BINFO_VPTR_FIELD (virtual_offset);
2938       mangle_call_offset (fixed_offset, virtual_offset);
2939       fn_decl = THUNK_TARGET (fn_decl);
2940     }
2941
2942   /* Scoped name.  */
2943   write_encoding (fn_decl);
2944
2945   result = finish_mangling_get_identifier (/*warn=*/false);
2946   if (DEBUG_MANGLE)
2947     fprintf (stderr, "mangle_thunk = %s\n\n", IDENTIFIER_POINTER (result));
2948   return result;
2949 }
2950
2951 /* This hash table maps TYPEs to the IDENTIFIER for a conversion
2952    operator to TYPE.  The nodes are IDENTIFIERs whose TREE_TYPE is the
2953    TYPE.  */
2954
2955 static GTY ((param_is (union tree_node))) htab_t conv_type_names;
2956
2957 /* Hash a node (VAL1) in the table.  */
2958
2959 static hashval_t
2960 hash_type (const void *val)
2961 {
2962   return (hashval_t) TYPE_UID (TREE_TYPE ((const_tree) val));
2963 }
2964
2965 /* Compare VAL1 (a node in the table) with VAL2 (a TYPE).  */
2966
2967 static int
2968 compare_type (const void *val1, const void *val2)
2969 {
2970   return TREE_TYPE ((const_tree) val1) == (const_tree) val2;
2971 }
2972
2973 /* Return an identifier for the mangled unqualified name for a
2974    conversion operator to TYPE.  This mangling is not specified by the
2975    ABI spec; it is only used internally.  */
2976
2977 tree
2978 mangle_conv_op_name_for_type (const tree type)
2979 {
2980   void **slot;
2981   tree identifier;
2982
2983   if (type == error_mark_node)
2984     return error_mark_node;
2985
2986   if (conv_type_names == NULL)
2987     conv_type_names = htab_create_ggc (31, &hash_type, &compare_type, NULL);
2988
2989   slot = htab_find_slot_with_hash (conv_type_names, type,
2990                                    (hashval_t) TYPE_UID (type), INSERT);
2991   identifier = (tree)*slot;
2992   if (!identifier)
2993     {
2994       char buffer[64];
2995
2996        /* Create a unique name corresponding to TYPE.  */
2997       sprintf (buffer, "operator %lu",
2998                (unsigned long) htab_elements (conv_type_names));
2999       identifier = get_identifier (buffer);
3000       *slot = identifier;
3001
3002       /* Hang TYPE off the identifier so it can be found easily later
3003          when performing conversions.  */
3004       TREE_TYPE (identifier) = type;
3005
3006       /* Set bits on the identifier so we know later it's a conversion.  */
3007       IDENTIFIER_OPNAME_P (identifier) = 1;
3008       IDENTIFIER_TYPENAME_P (identifier) = 1;
3009     }
3010
3011   return identifier;
3012 }
3013
3014 /* Return an identifier for the name of an initialization guard
3015    variable for indicated VARIABLE.  */
3016
3017 tree
3018 mangle_guard_variable (const tree variable)
3019 {
3020   start_mangling (variable);
3021   write_string ("_ZGV");
3022   if (strncmp (IDENTIFIER_POINTER (DECL_NAME (variable)), "_ZGR", 4) == 0)
3023     /* The name of a guard variable for a reference temporary should refer
3024        to the reference, not the temporary.  */
3025     write_string (IDENTIFIER_POINTER (DECL_NAME (variable)) + 4);
3026   else
3027     write_name (variable, /*ignore_local_scope=*/0);
3028   return finish_mangling_get_identifier (/*warn=*/false);
3029 }
3030
3031 /* Return an identifier for the name of a temporary variable used to
3032    initialize a static reference.  This isn't part of the ABI, but we might
3033    as well call them something readable.  */
3034
3035 tree
3036 mangle_ref_init_variable (const tree variable)
3037 {
3038   start_mangling (variable);
3039   write_string ("_ZGR");
3040   write_name (variable, /*ignore_local_scope=*/0);
3041   return finish_mangling_get_identifier (/*warn=*/false);
3042 }
3043 \f
3044
3045 /* Foreign language type mangling section.  */
3046
3047 /* How to write the type codes for the integer Java type.  */
3048
3049 static void
3050 write_java_integer_type_codes (const tree type)
3051 {
3052   if (type == java_int_type_node)
3053     write_char ('i');
3054   else if (type == java_short_type_node)
3055     write_char ('s');
3056   else if (type == java_byte_type_node)
3057     write_char ('c');
3058   else if (type == java_char_type_node)
3059     write_char ('w');
3060   else if (type == java_long_type_node)
3061     write_char ('x');
3062   else if (type == java_boolean_type_node)
3063     write_char ('b');
3064   else
3065     gcc_unreachable ();
3066 }
3067
3068 #include "gt-cp-mangle.h"