blob: c27ef4fd97859365b62fe9025542079cd14d9b65 [file] [log] [blame]
Douglas Gregor6ec36682009-02-18 23:53:56 +00001//===--- Mangle.cpp - Mangle C++ Names --------------------------*- C++ -*-===//
Douglas Gregor5f2bfd42009-02-13 00:10:09 +00002//
3// The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9//
10// Implements C++ name mangling according to the Itanium C++ ABI,
11// which is used in GCC 3.2 and newer (and many compilers that are
12// ABI-compatible with GCC):
13//
14// http://www.codesourcery.com/public/cxx-abi/abi.html
15//
16//===----------------------------------------------------------------------===//
17#include "Mangle.h"
18#include "clang/AST/ASTContext.h"
19#include "clang/AST/Decl.h"
20#include "clang/AST/DeclCXX.h"
Anders Carlssona40c5e42009-03-07 22:03:21 +000021#include "clang/AST/DeclObjC.h"
Anders Carlsson7a0ba872009-05-15 16:09:15 +000022#include "clang/AST/DeclTemplate.h"
Douglas Gregor6ec36682009-02-18 23:53:56 +000023#include "clang/Basic/SourceManager.h"
Douglas Gregor5f2bfd42009-02-13 00:10:09 +000024#include "llvm/Support/Compiler.h"
25#include "llvm/Support/raw_ostream.h"
26using namespace clang;
27
28namespace {
29 class VISIBILITY_HIDDEN CXXNameMangler {
30 ASTContext &Context;
31 llvm::raw_ostream &Out;
32
Anders Carlsson27ae5362009-04-17 01:58:57 +000033 const CXXMethodDecl *Structor;
34 unsigned StructorType;
Anders Carlsson3ac86b52009-04-15 05:36:58 +000035 CXXCtorType CtorType;
36
Douglas Gregor5f2bfd42009-02-13 00:10:09 +000037 public:
38 CXXNameMangler(ASTContext &C, llvm::raw_ostream &os)
Anders Carlsson27ae5362009-04-17 01:58:57 +000039 : Context(C), Out(os), Structor(0), StructorType(0) { }
Douglas Gregor5f2bfd42009-02-13 00:10:09 +000040
41 bool mangle(const NamedDecl *D);
Anders Carlsson41aa8c12009-04-13 18:02:10 +000042 void mangleGuardVariable(const VarDecl *D);
Anders Carlsson27ae5362009-04-17 01:58:57 +000043
Anders Carlsson3ac86b52009-04-15 05:36:58 +000044 void mangleCXXCtor(const CXXConstructorDecl *D, CXXCtorType Type);
Anders Carlsson27ae5362009-04-17 01:58:57 +000045 void mangleCXXDtor(const CXXDestructorDecl *D, CXXDtorType Type);
Anders Carlsson3ac86b52009-04-15 05:36:58 +000046
Anders Carlsson43f17402009-04-02 15:51:53 +000047 private:
48 bool mangleFunctionDecl(const FunctionDecl *FD);
49
Douglas Gregor5f2bfd42009-02-13 00:10:09 +000050 void mangleFunctionEncoding(const FunctionDecl *FD);
51 void mangleName(const NamedDecl *ND);
52 void mangleUnqualifiedName(const NamedDecl *ND);
53 void mangleSourceName(const IdentifierInfo *II);
Anders Carlsson1b42c792009-04-02 16:24:45 +000054 void mangleLocalName(const NamedDecl *ND);
Douglas Gregor5f2bfd42009-02-13 00:10:09 +000055 void mangleNestedName(const NamedDecl *ND);
56 void manglePrefix(const DeclContext *DC);
57 void mangleOperatorName(OverloadedOperatorKind OO, unsigned Arity);
58 void mangleCVQualifiers(unsigned Quals);
59 void mangleType(QualType T);
60 void mangleType(const BuiltinType *T);
61 void mangleType(const FunctionType *T);
62 void mangleBareFunctionType(const FunctionType *T, bool MangleReturnType);
63 void mangleType(const TagType *T);
64 void mangleType(const ArrayType *T);
65 void mangleType(const MemberPointerType *T);
66 void mangleType(const TemplateTypeParmType *T);
Anders Carlssona40c5e42009-03-07 22:03:21 +000067 void mangleType(const ObjCInterfaceType *T);
Douglas Gregor5f2bfd42009-02-13 00:10:09 +000068 void mangleExpression(Expr *E);
Anders Carlsson3ac86b52009-04-15 05:36:58 +000069 void mangleCXXCtorType(CXXCtorType T);
Anders Carlsson27ae5362009-04-17 01:58:57 +000070 void mangleCXXDtorType(CXXDtorType T);
Anders Carlsson7a0ba872009-05-15 16:09:15 +000071
72 void mangleTemplateArgumentList(const TemplateArgumentList &L);
73 void mangleTemplateArgument(const TemplateArgument &A);
Douglas Gregor5f2bfd42009-02-13 00:10:09 +000074 };
75}
76
Anders Carlsson43f17402009-04-02 15:51:53 +000077static bool isInCLinkageSpecification(const Decl *D) {
78 for (const DeclContext *DC = D->getDeclContext();
79 !DC->isTranslationUnit(); DC = DC->getParent()) {
80 if (const LinkageSpecDecl *Linkage = dyn_cast<LinkageSpecDecl>(DC))
81 return Linkage->getLanguage() == LinkageSpecDecl::lang_c;
82 }
83
84 return false;
85}
86
87bool CXXNameMangler::mangleFunctionDecl(const FunctionDecl *FD) {
88 // Clang's "overloadable" attribute extension to C/C++ implies
89 // name mangling (always).
Daniel Dunbarb11fa0d2009-04-13 21:08:27 +000090 if (FD->hasAttr<OverloadableAttr>()) {
Anders Carlsson43f17402009-04-02 15:51:53 +000091 ; // fall into mangling code unconditionally.
92 } else if (// C functions are not mangled
93 !Context.getLangOptions().CPlusPlus ||
94 // "main" is not mangled in C++
95 FD->isMain() ||
96 // No mangling in an "implicit extern C" header.
97 Context.getSourceManager().getFileCharacteristic(FD->getLocation())
98 == SrcMgr::C_ExternCSystem ||
99 // No name mangling in a C linkage specification.
100 isInCLinkageSpecification(FD))
101 return false;
102
103 // If we get here, mangle the decl name!
104 Out << "_Z";
105 mangleFunctionEncoding(FD);
106 return true;
107}
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000108
109bool CXXNameMangler::mangle(const NamedDecl *D) {
Chris Lattnerca3f25c2009-03-21 08:24:40 +0000110 // Any decl can be declared with __asm("foo") on it, and this takes
111 // precedence over all other naming in the .o file.
112 if (const AsmLabelAttr *ALA = D->getAttr<AsmLabelAttr>()) {
113 // If we have an asm name, then we use it as the mangling.
114 Out << '\01'; // LLVM IR Marker for __asm("foo")
115 Out << ALA->getLabel();
116 return true;
117 }
118
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000119 // <mangled-name> ::= _Z <encoding>
120 // ::= <data name>
121 // ::= <special-name>
122
123 // FIXME: Actually use a visitor to decode these?
Anders Carlsson43f17402009-04-02 15:51:53 +0000124 if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(D))
125 return mangleFunctionDecl(FD);
Chris Lattnerbc7a0292009-03-21 06:19:20 +0000126
Anders Carlsson329749c2009-04-02 16:05:20 +0000127 if (const VarDecl *VD = dyn_cast<VarDecl>(D)) {
128 if (!Context.getLangOptions().CPlusPlus ||
Anders Carlsson9ccb0652009-04-11 01:19:45 +0000129 isInCLinkageSpecification(D) ||
130 D->getDeclContext()->isTranslationUnit())
Anders Carlsson329749c2009-04-02 16:05:20 +0000131 return false;
132
133 Out << "_Z";
134 mangleName(VD);
135 return true;
136 }
137
Anders Carlsson43f17402009-04-02 15:51:53 +0000138 return false;
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000139}
140
Anders Carlsson3ac86b52009-04-15 05:36:58 +0000141void CXXNameMangler::mangleCXXCtor(const CXXConstructorDecl *D,
142 CXXCtorType Type) {
Anders Carlsson27ae5362009-04-17 01:58:57 +0000143 assert(!Structor && "Structor already set!");
144 Structor = D;
145 StructorType = Type;
146
147 mangle(D);
148}
149
150void CXXNameMangler::mangleCXXDtor(const CXXDestructorDecl *D,
151 CXXDtorType Type) {
152 assert(!Structor && "Structor already set!");
153 Structor = D;
154 StructorType = Type;
Anders Carlsson3ac86b52009-04-15 05:36:58 +0000155
156 mangle(D);
157}
158
Anders Carlsson41aa8c12009-04-13 18:02:10 +0000159void CXXNameMangler::mangleGuardVariable(const VarDecl *D)
160{
161 // <special-name> ::= GV <object name> # Guard variable for one-time
162 // # initialization
163
164 Out << "_ZGV";
165 mangleName(D);
166}
167
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000168void CXXNameMangler::mangleFunctionEncoding(const FunctionDecl *FD) {
169 // <encoding> ::= <function name> <bare-function-type>
170 mangleName(FD);
171 mangleBareFunctionType(FD->getType()->getAsFunctionType(), false);
172}
173
174static bool isStdNamespace(const DeclContext *DC) {
175 if (!DC->isNamespace() || !DC->getParent()->isTranslationUnit())
176 return false;
177
178 const NamespaceDecl *NS = cast<NamespaceDecl>(DC);
Douglas Gregor6ec36682009-02-18 23:53:56 +0000179 return NS->getOriginalNamespace()->getIdentifier()->isStr("std");
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000180}
181
182void CXXNameMangler::mangleName(const NamedDecl *ND) {
183 // <name> ::= <nested-name>
184 // ::= <unscoped-name>
185 // ::= <unscoped-template-name> <template-args>
186 // ::= <local-name> # See Scope Encoding below
187 //
188 // <unscoped-name> ::= <unqualified-name>
189 // ::= St <unqualified-name> # ::std::
190 if (ND->getDeclContext()->isTranslationUnit())
191 mangleUnqualifiedName(ND);
192 else if (isStdNamespace(ND->getDeclContext())) {
193 Out << "St";
194 mangleUnqualifiedName(ND);
Anders Carlsson1b42c792009-04-02 16:24:45 +0000195 } else if (isa<FunctionDecl>(ND->getDeclContext()))
196 mangleLocalName(ND);
197 else
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000198 mangleNestedName(ND);
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000199}
200
201void CXXNameMangler::mangleUnqualifiedName(const NamedDecl *ND) {
202 // <unqualified-name> ::= <operator-name>
203 // ::= <ctor-dtor-name>
204 // ::= <source-name>
205 DeclarationName Name = ND->getDeclName();
206 switch (Name.getNameKind()) {
207 case DeclarationName::Identifier:
208 mangleSourceName(Name.getAsIdentifierInfo());
209 break;
210
211 case DeclarationName::ObjCZeroArgSelector:
212 case DeclarationName::ObjCOneArgSelector:
213 case DeclarationName::ObjCMultiArgSelector:
214 assert(false && "Can't mangle Objective-C selector names here!");
215 break;
216
217 case DeclarationName::CXXConstructorName:
Anders Carlsson27ae5362009-04-17 01:58:57 +0000218 if (ND == Structor)
Anders Carlsson3ac86b52009-04-15 05:36:58 +0000219 // If the named decl is the C++ constructor we're mangling, use the
220 // type we were given.
Anders Carlsson27ae5362009-04-17 01:58:57 +0000221 mangleCXXCtorType(static_cast<CXXCtorType>(StructorType));
Anders Carlsson3ac86b52009-04-15 05:36:58 +0000222 else
223 // Otherwise, use the complete constructor name. This is relevant if a
224 // class with a constructor is declared within a constructor.
225 mangleCXXCtorType(Ctor_Complete);
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000226 break;
227
228 case DeclarationName::CXXDestructorName:
Anders Carlsson27ae5362009-04-17 01:58:57 +0000229 if (ND == Structor)
230 // If the named decl is the C++ destructor we're mangling, use the
231 // type we were given.
232 mangleCXXDtorType(static_cast<CXXDtorType>(StructorType));
233 else
234 // Otherwise, use the complete destructor name. This is relevant if a
235 // class with a destructor is declared within a destructor.
236 mangleCXXDtorType(Dtor_Complete);
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000237 break;
238
239 case DeclarationName::CXXConversionFunctionName:
Douglas Gregor219cc612009-02-13 01:28:03 +0000240 // <operator-name> ::= cv <type> # (cast)
241 Out << "cv";
242 mangleType(Context.getCanonicalType(Name.getCXXNameType()));
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000243 break;
244
245 case DeclarationName::CXXOperatorName:
246 mangleOperatorName(Name.getCXXOverloadedOperator(),
247 cast<FunctionDecl>(ND)->getNumParams());
248 break;
249
250 case DeclarationName::CXXUsingDirective:
251 assert(false && "Can't mangle a using directive name!");
Douglas Gregor219cc612009-02-13 01:28:03 +0000252 break;
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000253 }
254}
255
256void CXXNameMangler::mangleSourceName(const IdentifierInfo *II) {
257 // <source-name> ::= <positive length number> <identifier>
258 // <number> ::= [n] <non-negative decimal integer>
259 // <identifier> ::= <unqualified source code identifier>
260 Out << II->getLength() << II->getName();
261}
262
263void CXXNameMangler::mangleNestedName(const NamedDecl *ND) {
264 // <nested-name> ::= N [<CV-qualifiers>] <prefix> <unqualified-name> E
265 // ::= N [<CV-qualifiers>] <template-prefix> <template-args> E
266 // FIXME: no template support
267 Out << 'N';
268 if (const CXXMethodDecl *Method = dyn_cast<CXXMethodDecl>(ND))
269 mangleCVQualifiers(Method->getTypeQualifiers());
270 manglePrefix(ND->getDeclContext());
271 mangleUnqualifiedName(ND);
272 Out << 'E';
273}
274
Anders Carlsson1b42c792009-04-02 16:24:45 +0000275void CXXNameMangler::mangleLocalName(const NamedDecl *ND) {
276 // <local-name> := Z <function encoding> E <entity name> [<discriminator>]
277 // := Z <function encoding> E s [<discriminator>]
278 // <discriminator> := _ <non-negative number>
279 Out << 'Z';
280 mangleFunctionEncoding(cast<FunctionDecl>(ND->getDeclContext()));
281 Out << 'E';
282 mangleSourceName(ND->getIdentifier());
283}
284
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000285void CXXNameMangler::manglePrefix(const DeclContext *DC) {
286 // <prefix> ::= <prefix> <unqualified-name>
287 // ::= <template-prefix> <template-args>
288 // ::= <template-param>
289 // ::= # empty
290 // ::= <substitution>
291 // FIXME: We only handle mangling of namespaces and classes at the moment.
Anders Carlssonc8dee9c2009-04-01 00:42:16 +0000292 if (!DC->getParent()->isTranslationUnit())
293 manglePrefix(DC->getParent());
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000294
295 if (const NamespaceDecl *Namespace = dyn_cast<NamespaceDecl>(DC))
296 mangleSourceName(Namespace->getIdentifier());
Anders Carlsson7a0ba872009-05-15 16:09:15 +0000297 else if (const RecordDecl *Record = dyn_cast<RecordDecl>(DC)) {
298 if (const ClassTemplateSpecializationDecl *D =
299 dyn_cast<ClassTemplateSpecializationDecl>(Record)) {
300 mangleType(QualType(D->getTypeForDecl(), 0));
301 } else
302 mangleSourceName(Record->getIdentifier());
303 }
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000304}
305
306void
307CXXNameMangler::mangleOperatorName(OverloadedOperatorKind OO, unsigned Arity) {
308 switch (OO) {
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000309 // <operator-name> ::= nw # new
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000310 case OO_New: Out << "nw"; break;
311 // ::= na # new[]
312 case OO_Array_New: Out << "na"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000313 // ::= dl # delete
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000314 case OO_Delete: Out << "dl"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000315 // ::= da # delete[]
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000316 case OO_Array_Delete: Out << "da"; break;
317 // ::= ps # + (unary)
318 // ::= pl # +
319 case OO_Plus: Out << (Arity == 1? "ps" : "pl"); break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000320 // ::= ng # - (unary)
321 // ::= mi # -
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000322 case OO_Minus: Out << (Arity == 1? "ng" : "mi"); break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000323 // ::= ad # & (unary)
324 // ::= an # &
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000325 case OO_Amp: Out << (Arity == 1? "ad" : "an"); break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000326 // ::= de # * (unary)
327 // ::= ml # *
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000328 case OO_Star: Out << (Arity == 1? "de" : "ml"); break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000329 // ::= co # ~
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000330 case OO_Tilde: Out << "co"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000331 // ::= dv # /
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000332 case OO_Slash: Out << "dv"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000333 // ::= rm # %
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000334 case OO_Percent: Out << "rm"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000335 // ::= or # |
336 case OO_Pipe: Out << "or"; break;
337 // ::= eo # ^
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000338 case OO_Caret: Out << "eo"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000339 // ::= aS # =
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000340 case OO_Equal: Out << "aS"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000341 // ::= pL # +=
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000342 case OO_PlusEqual: Out << "pL"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000343 // ::= mI # -=
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000344 case OO_MinusEqual: Out << "mI"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000345 // ::= mL # *=
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000346 case OO_StarEqual: Out << "mL"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000347 // ::= dV # /=
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000348 case OO_SlashEqual: Out << "dV"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000349 // ::= rM # %=
350 case OO_PercentEqual: Out << "rM"; break;
351 // ::= aN # &=
352 case OO_AmpEqual: Out << "aN"; break;
353 // ::= oR # |=
354 case OO_PipeEqual: Out << "oR"; break;
355 // ::= eO # ^=
356 case OO_CaretEqual: Out << "eO"; break;
357 // ::= ls # <<
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000358 case OO_LessLess: Out << "ls"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000359 // ::= rs # >>
360 case OO_GreaterGreater: Out << "rs"; break;
361 // ::= lS # <<=
362 case OO_LessLessEqual: Out << "lS"; break;
363 // ::= rS # >>=
364 case OO_GreaterGreaterEqual: Out << "rS"; break;
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000365 // ::= eq # ==
366 case OO_EqualEqual: Out << "eq"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000367 // ::= ne # !=
368 case OO_ExclaimEqual: Out << "ne"; break;
369 // ::= lt # <
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000370 case OO_Less: Out << "lt"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000371 // ::= gt # >
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000372 case OO_Greater: Out << "gt"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000373 // ::= le # <=
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000374 case OO_LessEqual: Out << "le"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000375 // ::= ge # >=
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000376 case OO_GreaterEqual: Out << "ge"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000377 // ::= nt # !
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000378 case OO_Exclaim: Out << "nt"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000379 // ::= aa # &&
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000380 case OO_AmpAmp: Out << "aa"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000381 // ::= oo # ||
382 case OO_PipePipe: Out << "oo"; break;
383 // ::= pp # ++
384 case OO_PlusPlus: Out << "pp"; break;
385 // ::= mm # --
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000386 case OO_MinusMinus: Out << "mm"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000387 // ::= cm # ,
388 case OO_Comma: Out << "cm"; break;
389 // ::= pm # ->*
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000390 case OO_ArrowStar: Out << "pm"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000391 // ::= pt # ->
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000392 case OO_Arrow: Out << "pt"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000393 // ::= cl # ()
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000394 case OO_Call: Out << "cl"; break;
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000395 // ::= ix # []
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000396 case OO_Subscript: Out << "ix"; break;
397 // UNSUPPORTED: ::= qu # ?
398
Sebastian Redl3201f6b2009-04-16 17:51:27 +0000399 case OO_None:
400 case OO_Conditional:
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000401 case NUM_OVERLOADED_OPERATORS:
Douglas Gregor6ec36682009-02-18 23:53:56 +0000402 assert(false && "Not an overloaded operator");
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000403 break;
404 }
405}
406
407void CXXNameMangler::mangleCVQualifiers(unsigned Quals) {
408 // <CV-qualifiers> ::= [r] [V] [K] # restrict (C99), volatile, const
409 if (Quals & QualType::Restrict)
410 Out << 'r';
411 if (Quals & QualType::Volatile)
412 Out << 'V';
413 if (Quals & QualType::Const)
414 Out << 'K';
415}
416
417void CXXNameMangler::mangleType(QualType T) {
Anders Carlsson4843e582009-03-10 17:07:44 +0000418 // Only operate on the canonical type!
419 T = Context.getCanonicalType(T);
420
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000421 // FIXME: Should we have a TypeNodes.def to make this easier? (YES!)
422
423 // <type> ::= <CV-qualifiers> <type>
424 mangleCVQualifiers(T.getCVRQualifiers());
425
426 // ::= <builtin-type>
Anders Carlsson4843e582009-03-10 17:07:44 +0000427 if (const BuiltinType *BT = dyn_cast<BuiltinType>(T.getTypePtr()))
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000428 mangleType(BT);
429 // ::= <function-type>
430 else if (const FunctionType *FT = dyn_cast<FunctionType>(T.getTypePtr()))
431 mangleType(FT);
432 // ::= <class-enum-type>
433 else if (const TagType *TT = dyn_cast<TagType>(T.getTypePtr()))
434 mangleType(TT);
435 // ::= <array-type>
436 else if (const ArrayType *AT = dyn_cast<ArrayType>(T.getTypePtr()))
437 mangleType(AT);
438 // ::= <pointer-to-member-type>
439 else if (const MemberPointerType *MPT
440 = dyn_cast<MemberPointerType>(T.getTypePtr()))
441 mangleType(MPT);
442 // ::= <template-param>
443 else if (const TemplateTypeParmType *TypeParm
444 = dyn_cast<TemplateTypeParmType>(T.getTypePtr()))
445 mangleType(TypeParm);
446 // FIXME: ::= <template-template-param> <template-args>
447 // FIXME: ::= <substitution> # See Compression below
448 // ::= P <type> # pointer-to
449 else if (const PointerType *PT = dyn_cast<PointerType>(T.getTypePtr())) {
450 Out << 'P';
451 mangleType(PT->getPointeeType());
452 }
453 // ::= R <type> # reference-to
Sebastian Redl7c80bd62009-03-16 23:22:08 +0000454 else if (const LValueReferenceType *RT =
455 dyn_cast<LValueReferenceType>(T.getTypePtr())) {
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000456 Out << 'R';
457 mangleType(RT->getPointeeType());
458 }
Sebastian Redl7c80bd62009-03-16 23:22:08 +0000459 // ::= O <type> # rvalue reference-to (C++0x)
460 else if (const RValueReferenceType *RT =
461 dyn_cast<RValueReferenceType>(T.getTypePtr())) {
462 Out << 'O';
463 mangleType(RT->getPointeeType());
464 }
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000465 // ::= C <type> # complex pair (C 2000)
466 else if (const ComplexType *CT = dyn_cast<ComplexType>(T.getTypePtr())) {
467 Out << 'C';
468 mangleType(CT->getElementType());
469 } else if (const VectorType *VT = dyn_cast<VectorType>(T.getTypePtr())) {
470 // GNU extension: vector types
471 Out << "U8__vector";
472 mangleType(VT->getElementType());
Anders Carlssona40c5e42009-03-07 22:03:21 +0000473 } else if (const ObjCInterfaceType *IT =
474 dyn_cast<ObjCInterfaceType>(T.getTypePtr())) {
475 mangleType(IT);
Anders Carlsson4843e582009-03-10 17:07:44 +0000476 }
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000477 // FIXME: ::= G <type> # imaginary (C 2000)
478 // FIXME: ::= U <source-name> <type> # vendor extended type qualifier
479 else
480 assert(false && "Cannot mangle unknown type");
481}
482
483void CXXNameMangler::mangleType(const BuiltinType *T) {
484 // <builtin-type> ::= v # void
485 // ::= w # wchar_t
486 // ::= b # bool
487 // ::= c # char
488 // ::= a # signed char
489 // ::= h # unsigned char
490 // ::= s # short
491 // ::= t # unsigned short
492 // ::= i # int
493 // ::= j # unsigned int
494 // ::= l # long
495 // ::= m # unsigned long
496 // ::= x # long long, __int64
497 // ::= y # unsigned long long, __int64
498 // ::= n # __int128
499 // UNSUPPORTED: ::= o # unsigned __int128
500 // ::= f # float
501 // ::= d # double
502 // ::= e # long double, __float80
503 // UNSUPPORTED: ::= g # __float128
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000504 // UNSUPPORTED: ::= Dd # IEEE 754r decimal floating point (64 bits)
505 // UNSUPPORTED: ::= De # IEEE 754r decimal floating point (128 bits)
506 // UNSUPPORTED: ::= Df # IEEE 754r decimal floating point (32 bits)
507 // UNSUPPORTED: ::= Dh # IEEE 754r half-precision floating point (16 bits)
508 // UNSUPPORTED: ::= Di # char32_t
509 // UNSUPPORTED: ::= Ds # char16_t
510 // ::= u <source-name> # vendor extended type
Sebastian Redl6e8ed162009-05-10 18:38:11 +0000511 // From our point of view, std::nullptr_t is a builtin, but as far as mangling
512 // is concerned, it's a type called std::nullptr_t.
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000513 switch (T->getKind()) {
514 case BuiltinType::Void: Out << 'v'; break;
515 case BuiltinType::Bool: Out << 'b'; break;
516 case BuiltinType::Char_U: case BuiltinType::Char_S: Out << 'c'; break;
517 case BuiltinType::UChar: Out << 'h'; break;
518 case BuiltinType::UShort: Out << 't'; break;
519 case BuiltinType::UInt: Out << 'j'; break;
520 case BuiltinType::ULong: Out << 'm'; break;
521 case BuiltinType::ULongLong: Out << 'y'; break;
Chris Lattner2df9ced2009-04-30 02:43:43 +0000522 case BuiltinType::UInt128: Out << 'o'; break;
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000523 case BuiltinType::SChar: Out << 'a'; break;
524 case BuiltinType::WChar: Out << 'w'; break;
525 case BuiltinType::Short: Out << 's'; break;
526 case BuiltinType::Int: Out << 'i'; break;
527 case BuiltinType::Long: Out << 'l'; break;
528 case BuiltinType::LongLong: Out << 'x'; break;
Chris Lattner2df9ced2009-04-30 02:43:43 +0000529 case BuiltinType::Int128: Out << 'n'; break;
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000530 case BuiltinType::Float: Out << 'f'; break;
531 case BuiltinType::Double: Out << 'd'; break;
532 case BuiltinType::LongDouble: Out << 'e'; break;
Sebastian Redl6e8ed162009-05-10 18:38:11 +0000533 case BuiltinType::NullPtr: Out << "St9nullptr_t"; break;
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000534
535 case BuiltinType::Overload:
536 case BuiltinType::Dependent:
537 assert(false &&
538 "Overloaded and dependent types shouldn't get to name mangling");
539 break;
540 }
541}
542
543void CXXNameMangler::mangleType(const FunctionType *T) {
544 // <function-type> ::= F [Y] <bare-function-type> E
545 Out << 'F';
Mike Stumpf5408fe2009-05-16 07:57:57 +0000546 // FIXME: We don't have enough information in the AST to produce the 'Y'
547 // encoding for extern "C" function types.
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000548 mangleBareFunctionType(T, /*MangleReturnType=*/true);
549 Out << 'E';
550}
551
552void CXXNameMangler::mangleBareFunctionType(const FunctionType *T,
553 bool MangleReturnType) {
554 // <bare-function-type> ::= <signature type>+
555 if (MangleReturnType)
556 mangleType(T->getResultType());
557
Douglas Gregor72564e72009-02-26 23:50:07 +0000558 const FunctionProtoType *Proto = dyn_cast<FunctionProtoType>(T);
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000559 assert(Proto && "Can't mangle K&R function prototypes");
560
Anders Carlssonc6c91bc2009-04-01 00:15:23 +0000561 if (Proto->getNumArgs() == 0) {
562 Out << 'v';
563 return;
564 }
565
Douglas Gregor72564e72009-02-26 23:50:07 +0000566 for (FunctionProtoType::arg_type_iterator Arg = Proto->arg_type_begin(),
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000567 ArgEnd = Proto->arg_type_end();
568 Arg != ArgEnd; ++Arg)
569 mangleType(*Arg);
Douglas Gregor219cc612009-02-13 01:28:03 +0000570
571 // <builtin-type> ::= z # ellipsis
572 if (Proto->isVariadic())
573 Out << 'z';
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000574}
575
576void CXXNameMangler::mangleType(const TagType *T) {
577 // <class-enum-type> ::= <name>
Anders Carlsson4843e582009-03-10 17:07:44 +0000578
579 if (!T->getDecl()->getIdentifier())
580 mangleName(T->getDecl()->getTypedefForAnonDecl());
581 else
582 mangleName(T->getDecl());
Anders Carlsson7a0ba872009-05-15 16:09:15 +0000583
584 // If this is a class template specialization, mangle the template
585 // arguments.
586 if (ClassTemplateSpecializationDecl *Spec
587 = dyn_cast<ClassTemplateSpecializationDecl>(T->getDecl()))
588 mangleTemplateArgumentList(Spec->getTemplateArgs());
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000589}
590
591void CXXNameMangler::mangleType(const ArrayType *T) {
592 // <array-type> ::= A <positive dimension number> _ <element type>
593 // ::= A [<dimension expression>] _ <element type>
594 Out << 'A';
595 if (const ConstantArrayType *CAT = dyn_cast<ConstantArrayType>(T))
596 Out << CAT->getSize();
597 else if (const VariableArrayType *VAT = dyn_cast<VariableArrayType>(T))
598 mangleExpression(VAT->getSizeExpr());
599 else if (const DependentSizedArrayType *DSAT
600 = dyn_cast<DependentSizedArrayType>(T))
601 mangleExpression(DSAT->getSizeExpr());
602
603 Out << '_';
604 mangleType(T->getElementType());
605}
606
607void CXXNameMangler::mangleType(const MemberPointerType *T) {
608 // <pointer-to-member-type> ::= M <class type> <member type>
609 Out << 'M';
610 mangleType(QualType(T->getClass(), 0));
611 mangleType(T->getPointeeType());
612}
613
614void CXXNameMangler::mangleType(const TemplateTypeParmType *T) {
615 // <template-param> ::= T_ # first template parameter
616 // ::= T <parameter-2 non-negative number> _
617 if (T->getIndex() == 0)
618 Out << "T_";
619 else
620 Out << 'T' << (T->getIndex() - 1) << '_';
621}
622
Anders Carlssona40c5e42009-03-07 22:03:21 +0000623void CXXNameMangler::mangleType(const ObjCInterfaceType *T) {
624 mangleSourceName(T->getDecl()->getIdentifier());
625}
626
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000627void CXXNameMangler::mangleExpression(Expr *E) {
628 assert(false && "Cannot mangle expressions yet");
629}
630
Anders Carlsson3ac86b52009-04-15 05:36:58 +0000631void CXXNameMangler::mangleCXXCtorType(CXXCtorType T) {
632 // <ctor-dtor-name> ::= C1 # complete object constructor
633 // ::= C2 # base object constructor
634 // ::= C3 # complete object allocating constructor
635 //
636 switch (T) {
637 case Ctor_Complete:
638 Out << "C1";
639 break;
640 case Ctor_Base:
641 Out << "C2";
642 break;
643 case Ctor_CompleteAllocating:
644 Out << "C3";
645 break;
646 }
647}
648
Anders Carlsson27ae5362009-04-17 01:58:57 +0000649void CXXNameMangler::mangleCXXDtorType(CXXDtorType T) {
650 // <ctor-dtor-name> ::= D0 # deleting destructor
651 // ::= D1 # complete object destructor
652 // ::= D2 # base object destructor
653 //
654 switch (T) {
655 case Dtor_Deleting:
656 Out << "D0";
657 break;
658 case Dtor_Complete:
659 Out << "D1";
660 break;
661 case Dtor_Base:
662 Out << "D2";
663 break;
664 }
665}
666
Anders Carlsson7a0ba872009-05-15 16:09:15 +0000667void CXXNameMangler::mangleTemplateArgumentList(const TemplateArgumentList &L) {
668 // <template-args> ::= I <template-arg>+ E
669 Out << "I";
670
671 for (unsigned i = 0, e = L.size(); i != e; ++i) {
672 const TemplateArgument &A = L[i];
673
674 mangleTemplateArgument(A);
675 }
676
677 Out << "E";
678}
679
680void CXXNameMangler::mangleTemplateArgument(const TemplateArgument &A) {
681 // <template-arg> ::= <type> # type or template
682 // ::= X <expression> E # expression
683 // ::= <expr-primary> # simple expressions
684 // ::= I <template-arg>* E # argument pack
685 // ::= sp <expression> # pack expansion of (C++0x)
686 switch (A.getKind()) {
687 default:
688 assert(0 && "Unknown template argument kind!");
689 case TemplateArgument::Type:
690 mangleType(A.getAsType());
691 break;
692 case TemplateArgument::Integral:
693 // <expr-primary> ::= L <type> <value number> E # integer literal
694
695 Out << 'L';
696
697 mangleType(A.getIntegralType());
698
699 const llvm::APSInt *Integral = A.getAsIntegral();
700 if (A.getIntegralType()->isBooleanType()) {
701 // Boolean values are encoded as 0/1.
702 Out << (Integral->getBoolValue() ? '1' : '0');
703 } else {
704 if (Integral->isNegative())
705 Out << 'n';
706 Integral->abs().print(Out, false);
707 }
708
709 Out << 'E';
710 break;
711 }
712}
713
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000714namespace clang {
715 /// \brief Mangles the name of the declaration D and emits that name
716 /// to the given output stream.
717 ///
718 /// If the declaration D requires a mangled name, this routine will
719 /// emit that mangled name to \p os and return true. Otherwise, \p
720 /// os will be unchanged and this routine will return false. In this
721 /// case, the caller should just emit the identifier of the declaration
722 /// (\c D->getIdentifier()) as its name.
723 bool mangleName(const NamedDecl *D, ASTContext &Context,
724 llvm::raw_ostream &os) {
Anders Carlsson578aa642009-05-03 16:51:04 +0000725 assert(!isa<CXXConstructorDecl>(D) &&
726 "Use mangleCXXCtor for constructor decls!");
727 assert(!isa<CXXDestructorDecl>(D) &&
728 "Use mangleCXXDtor for destructor decls!");
729
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000730 CXXNameMangler Mangler(Context, os);
Douglas Gregor6ec36682009-02-18 23:53:56 +0000731 if (!Mangler.mangle(D))
732 return false;
733
734 os.flush();
735 return true;
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000736 }
Anders Carlsson41aa8c12009-04-13 18:02:10 +0000737
Anders Carlsson3ac86b52009-04-15 05:36:58 +0000738 /// mangleGuardVariable - Returns the mangled name for a guard variable
739 /// for the passed in VarDecl.
Anders Carlsson41aa8c12009-04-13 18:02:10 +0000740 void mangleGuardVariable(const VarDecl *D, ASTContext &Context,
741 llvm::raw_ostream &os) {
742 CXXNameMangler Mangler(Context, os);
743 Mangler.mangleGuardVariable(D);
744
745 os.flush();
746 }
Anders Carlsson3ac86b52009-04-15 05:36:58 +0000747
748 void mangleCXXCtor(const CXXConstructorDecl *D, CXXCtorType Type,
749 ASTContext &Context, llvm::raw_ostream &os) {
750 CXXNameMangler Mangler(Context, os);
751 Mangler.mangleCXXCtor(D, Type);
752
753 os.flush();
754 }
Anders Carlsson27ae5362009-04-17 01:58:57 +0000755
756 void mangleCXXDtor(const CXXDestructorDecl *D, CXXDtorType Type,
757 ASTContext &Context, llvm::raw_ostream &os) {
758 CXXNameMangler Mangler(Context, os);
759 Mangler.mangleCXXDtor(D, Type);
760
761 os.flush();
762 }
763
764
Douglas Gregor5f2bfd42009-02-13 00:10:09 +0000765}
766