LLVM 19.0.0git
MicrosoftDemangleNodes.cpp
Go to the documentation of this file.
1//===- MicrosoftDemangle.cpp ----------------------------------------------===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file defines a demangler for MSVC-style mangled symbols.
10//
11//===----------------------------------------------------------------------===//
12
15#include <cctype>
16#include <string>
17
18using namespace llvm;
19using namespace ms_demangle;
20
21#define OUTPUT_ENUM_CLASS_VALUE(Enum, Value, Desc) \
22 case Enum::Value: \
23 OB << Desc; \
24 break;
25
26// Writes a space if the last token does not end with a punctuation.
28 if (OB.empty())
29 return;
30
31 char C = OB.back();
32 if (std::isalnum(C) || C == '>')
33 OB << " ";
34}
35
37 switch (Q) {
38 case Q_Const:
39 OB << "const";
40 break;
41 case Q_Volatile:
42 OB << "volatile";
43 break;
44 case Q_Restrict:
45 OB << "__restrict";
46 break;
47 default:
48 break;
49 }
50}
51
53 Qualifiers Mask, bool NeedSpace) {
54 if (!(Q & Mask))
55 return NeedSpace;
56
57 if (NeedSpace)
58 OB << " ";
59
60 outputSingleQualifier(OB, Mask);
61 return true;
62}
63
64static void outputQualifiers(OutputBuffer &OB, Qualifiers Q, bool SpaceBefore,
65 bool SpaceAfter) {
66 if (Q == Q_None)
67 return;
68
69 size_t Pos1 = OB.getCurrentPosition();
70 SpaceBefore = outputQualifierIfPresent(OB, Q, Q_Const, SpaceBefore);
71 SpaceBefore = outputQualifierIfPresent(OB, Q, Q_Volatile, SpaceBefore);
72 SpaceBefore = outputQualifierIfPresent(OB, Q, Q_Restrict, SpaceBefore);
73 size_t Pos2 = OB.getCurrentPosition();
74 if (SpaceAfter && Pos2 > Pos1)
75 OB << " ";
76}
77
80
81 switch (CC) {
82 case CallingConv::Cdecl:
83 OB << "__cdecl";
84 break;
85 case CallingConv::Fastcall:
86 OB << "__fastcall";
87 break;
88 case CallingConv::Pascal:
89 OB << "__pascal";
90 break;
91 case CallingConv::Regcall:
92 OB << "__regcall";
93 break;
94 case CallingConv::Stdcall:
95 OB << "__stdcall";
96 break;
97 case CallingConv::Thiscall:
98 OB << "__thiscall";
99 break;
100 case CallingConv::Eabi:
101 OB << "__eabi";
102 break;
103 case CallingConv::Vectorcall:
104 OB << "__vectorcall";
105 break;
106 case CallingConv::Clrcall:
107 OB << "__clrcall";
108 break;
110 OB << "__attribute__((__swiftcall__)) ";
111 break;
112 case CallingConv::SwiftAsync:
113 OB << "__attribute__((__swiftasynccall__)) ";
114 break;
115 default:
116 break;
117 }
118}
119
120std::string Node::toString(OutputFlags Flags) const {
121 OutputBuffer OB;
122 this->output(OB, Flags);
123 std::string_view SV = OB;
124 std::string Owned(SV.begin(), SV.end());
125 std::free(OB.getBuffer());
126 return Owned;
127}
128
129void PrimitiveTypeNode::outputPre(OutputBuffer &OB, OutputFlags Flags) const {
130 switch (PrimKind) {
140 OUTPUT_ENUM_CLASS_VALUE(PrimitiveKind, Ushort, "unsigned short");
146 OUTPUT_ENUM_CLASS_VALUE(PrimitiveKind, Uint64, "unsigned __int64");
152 }
153 outputQualifiers(OB, Quals, true, false);
154}
155
156void NodeArrayNode::output(OutputBuffer &OB, OutputFlags Flags) const {
157 output(OB, Flags, ", ");
158}
159
160void NodeArrayNode::output(OutputBuffer &OB, OutputFlags Flags,
161 std::string_view Separator) const {
162 if (Count == 0)
163 return;
164 if (Nodes[0])
165 Nodes[0]->output(OB, Flags);
166 for (size_t I = 1; I < Count; ++I) {
167 OB << Separator;
168 Nodes[I]->output(OB, Flags);
169 }
170}
171
173 OutputFlags Flags) const {
174 switch (Char) {
175 case CharKind::Wchar:
176 OB << "L\"";
177 break;
178 case CharKind::Char:
179 OB << "\"";
180 break;
181 case CharKind::Char16:
182 OB << "u\"";
183 break;
184 case CharKind::Char32:
185 OB << "U\"";
186 break;
187 }
188 OB << DecodedString << "\"";
189 if (IsTruncated)
190 OB << "...";
191}
192
193void IntegerLiteralNode::output(OutputBuffer &OB, OutputFlags Flags) const {
194 if (IsNegative)
195 OB << '-';
196 OB << Value;
197}
198
200 OutputFlags Flags) const {
201 if (ThunkOffsetCount > 0)
202 OB << "{";
204 OB << "&";
205
206 if (Symbol) {
207 Symbol->output(OB, Flags);
208 if (ThunkOffsetCount > 0)
209 OB << ", ";
210 }
211
212 if (ThunkOffsetCount > 0)
213 OB << ThunkOffsets[0];
214 for (int I = 1; I < ThunkOffsetCount; ++I) {
215 OB << ", " << ThunkOffsets[I];
216 }
217 if (ThunkOffsetCount > 0)
218 OB << "}";
219}
220
222 OutputFlags Flags) const {
223 if (!TemplateParams)
224 return;
225 OB << "<";
226 TemplateParams->output(OB, Flags);
227 OB << ">";
228}
229
231 OutputFlags Flags) const {
232 if (IsDestructor)
233 OB << "`dynamic atexit destructor for ";
234 else
235 OB << "`dynamic initializer for ";
236
237 if (Variable) {
238 OB << "`";
239 Variable->output(OB, Flags);
240 OB << "''";
241 } else {
242 OB << "'";
243 Name->output(OB, Flags);
244 OB << "''";
245 }
246}
247
248void NamedIdentifierNode::output(OutputBuffer &OB, OutputFlags Flags) const {
249 OB << Name;
250 outputTemplateParameters(OB, Flags);
251}
252
254 OutputFlags Flags) const {
255 switch (Operator) {
265 "operator[]");
274 "operator->*");
281 "operator>=");
297 "operator&=");
299 "operator|=");
301 "operator^=");
304 "`vector deleting dtor'");
306 "`default ctor closure'");
308 "`scalar deleting dtor'");
310 "`vector ctor iterator'");
312 "`vector dtor iterator'");
314 "`vector vbase ctor iterator'");
316 "`virtual displacement map'");
318 "`eh vector ctor iterator'");
320 "`eh vector dtor iterator'");
322 "`eh vector vbase ctor iterator'");
324 "`copy ctor closure'");
326 "`local vftable ctor closure'");
329 "operator delete[]");
331 "`managed vector ctor iterator'");
333 "`managed vector dtor iterator'");
335 "`EH vector copy ctor iterator'");
337 "`EH vector vbase copy ctor iterator'");
339 "`vector copy ctor iterator'");
341 "`vector vbase copy constructor iterator'");
343 "`managed vector vbase copy constructor iterator'");
345 "operator co_await");
349 break;
350 }
351 outputTemplateParameters(OB, Flags);
352}
353
355 OutputFlags Flags) const {
356 if (IsThread)
357 OB << "`local static thread guard'";
358 else
359 OB << "`local static guard'";
360 if (ScopeIndex > 0)
361 OB << "{" << ScopeIndex << "}";
362}
363
365 OutputFlags Flags) const {
366 OB << "operator";
367 outputTemplateParameters(OB, Flags);
368 OB << " ";
369 TargetType->output(OB, Flags);
370}
371
372void StructorIdentifierNode::output(OutputBuffer &OB, OutputFlags Flags) const {
373 if (IsDestructor)
374 OB << "~";
375 Class->output(OB, Flags);
376 outputTemplateParameters(OB, Flags);
377}
378
380 OutputFlags Flags) const {
381 OB << "operator \"\"" << Name;
382 outputTemplateParameters(OB, Flags);
383}
384
386 OutputFlags Flags) const {
387 if (!(Flags & OF_NoAccessSpecifier)) {
389 OB << "public: ";
391 OB << "protected: ";
393 OB << "private: ";
394 }
395
396 if (!(Flags & OF_NoMemberType)) {
397 if (!(FunctionClass & FC_Global)) {
399 OB << "static ";
400 }
402 OB << "virtual ";
403
405 OB << "extern \"C\" ";
406 }
407
408 if (!(Flags & OF_NoReturnType) && ReturnType) {
409 ReturnType->outputPre(OB, Flags);
410 OB << " ";
411 }
412
413 if (!(Flags & OF_NoCallingConvention))
415}
416
418 OutputFlags Flags) const {
420 OB << "(";
421 if (Params)
422 Params->output(OB, Flags);
423 else
424 OB << "void";
425
426 if (IsVariadic) {
427 if (OB.back() != '(')
428 OB << ", ";
429 OB << "...";
430 }
431 OB << ")";
432 }
433
434 if (Quals & Q_Const)
435 OB << " const";
436 if (Quals & Q_Volatile)
437 OB << " volatile";
438 if (Quals & Q_Restrict)
439 OB << " __restrict";
440 if (Quals & Q_Unaligned)
441 OB << " __unaligned";
442
443 if (IsNoexcept)
444 OB << " noexcept";
445
447 OB << " &";
449 OB << " &&";
450
451 if (!(Flags & OF_NoReturnType) && ReturnType)
452 ReturnType->outputPost(OB, Flags);
453}
454
455void ThunkSignatureNode::outputPre(OutputBuffer &OB, OutputFlags Flags) const {
456 OB << "[thunk]: ";
457
459}
460
461void ThunkSignatureNode::outputPost(OutputBuffer &OB, OutputFlags Flags) const {
463 OB << "`adjustor{" << ThisAdjust.StaticOffset << "}'";
464 } else if (FunctionClass & FC_VirtualThisAdjust) {
466 OB << "`vtordispex{" << ThisAdjust.VBPtrOffset << ", "
468 << ", " << ThisAdjust.StaticOffset << "}'";
469 } else {
470 OB << "`vtordisp{" << ThisAdjust.VtordispOffset << ", "
471 << ThisAdjust.StaticOffset << "}'";
472 }
473 }
474
476}
477
478void PointerTypeNode::outputPre(OutputBuffer &OB, OutputFlags Flags) const {
480 // If this is a pointer to a function, don't output the calling convention.
481 // It needs to go inside the parentheses.
482 const FunctionSignatureNode *Sig =
483 static_cast<const FunctionSignatureNode *>(Pointee);
485 } else
486 Pointee->outputPre(OB, Flags);
487
489
490 if (Quals & Q_Unaligned)
491 OB << "__unaligned ";
492
493 if (Pointee->kind() == NodeKind::ArrayType) {
494 OB << "(";
495 } else if (Pointee->kind() == NodeKind::FunctionSignature) {
496 OB << "(";
497 const FunctionSignatureNode *Sig =
498 static_cast<const FunctionSignatureNode *>(Pointee);
500 OB << " ";
501 }
502
503 if (ClassParent) {
504 ClassParent->output(OB, Flags);
505 OB << "::";
506 }
507
508 switch (Affinity) {
510 OB << "*";
511 break;
513 OB << "&";
514 break;
516 OB << "&&";
517 break;
518 default:
519 assert(false);
520 }
521 outputQualifiers(OB, Quals, false, false);
522}
523
524void PointerTypeNode::outputPost(OutputBuffer &OB, OutputFlags Flags) const {
525 if (Pointee->kind() == NodeKind::ArrayType ||
527 OB << ")";
528
529 Pointee->outputPost(OB, Flags);
530}
531
532void TagTypeNode::outputPre(OutputBuffer &OB, OutputFlags Flags) const {
533 if (!(Flags & OF_NoTagSpecifier)) {
534 switch (Tag) {
539 }
540 OB << " ";
541 }
542 QualifiedName->output(OB, Flags);
543 outputQualifiers(OB, Quals, true, false);
544}
545
546void TagTypeNode::outputPost(OutputBuffer &OB, OutputFlags Flags) const {}
547
548void ArrayTypeNode::outputPre(OutputBuffer &OB, OutputFlags Flags) const {
549 ElementType->outputPre(OB, Flags);
550 outputQualifiers(OB, Quals, true, false);
551}
552
554 Node *N) const {
556 IntegerLiteralNode *ILN = static_cast<IntegerLiteralNode *>(N);
557 if (ILN->Value != 0)
558 ILN->output(OB, Flags);
559}
560
562 OutputFlags Flags) const {
563 if (Dimensions->Count == 0)
564 return;
565
566 outputOneDimension(OB, Flags, Dimensions->Nodes[0]);
567 for (size_t I = 1; I < Dimensions->Count; ++I) {
568 OB << "][";
569 outputOneDimension(OB, Flags, Dimensions->Nodes[I]);
570 }
571}
572
573void ArrayTypeNode::outputPost(OutputBuffer &OB, OutputFlags Flags) const {
574 OB << "[";
575 outputDimensionsImpl(OB, Flags);
576 OB << "]";
577
578 ElementType->outputPost(OB, Flags);
579}
580
581void SymbolNode::output(OutputBuffer &OB, OutputFlags Flags) const {
582 Name->output(OB, Flags);
583}
584
585void FunctionSymbolNode::output(OutputBuffer &OB, OutputFlags Flags) const {
586 Signature->outputPre(OB, Flags);
588 Name->output(OB, Flags);
589 Signature->outputPost(OB, Flags);
590}
591
592void VariableSymbolNode::output(OutputBuffer &OB, OutputFlags Flags) const {
593 const char *AccessSpec = nullptr;
594 bool IsStatic = true;
595 switch (SC) {
597 AccessSpec = "private";
598 break;
600 AccessSpec = "public";
601 break;
603 AccessSpec = "protected";
604 break;
605 default:
606 IsStatic = false;
607 break;
608 }
609 if (!(Flags & OF_NoAccessSpecifier) && AccessSpec)
610 OB << AccessSpec << ": ";
611 if (!(Flags & OF_NoMemberType) && IsStatic)
612 OB << "static ";
613
614 if (!(Flags & OF_NoVariableType) && Type) {
615 Type->outputPre(OB, Flags);
617 }
618 Name->output(OB, Flags);
619 if (!(Flags & OF_NoVariableType) && Type)
620 Type->outputPost(OB, Flags);
621}
622
623void CustomTypeNode::outputPre(OutputBuffer &OB, OutputFlags Flags) const {
624 Identifier->output(OB, Flags);
625}
626void CustomTypeNode::outputPost(OutputBuffer &OB, OutputFlags Flags) const {}
627
628void QualifiedNameNode::output(OutputBuffer &OB, OutputFlags Flags) const {
629 Components->output(OB, Flags, "::");
630}
631
633 OutputFlags Flags) const {
634 OB << "`RTTI Base Class Descriptor at (";
635 OB << NVOffset << ", " << VBPtrOffset << ", " << VBTableOffset << ", "
636 << this->Flags;
637 OB << ")'";
638}
639
641 OutputFlags Flags) const {
642 Name->output(OB, Flags);
643}
644
646 OutputFlags Flags) const {
647 OB << "`vcall'{" << OffsetInVTable << ", {flat}}";
648}
649
650void SpecialTableSymbolNode::output(OutputBuffer &OB, OutputFlags Flags) const {
651 outputQualifiers(OB, Quals, false, true);
652 Name->output(OB, Flags);
653 if (TargetName) {
654 OB << "{for `";
655 TargetName->output(OB, Flags);
656 OB << "'}";
657 }
658}
Qualifiers
#define I(x, y, z)
Definition: MD5.cpp:58
static void outputCallingConvention(OutputBuffer &OB, CallingConv CC)
#define OUTPUT_ENUM_CLASS_VALUE(Enum, Value, Desc)
static void outputSingleQualifier(OutputBuffer &OB, Qualifiers Q)
static bool outputQualifierIfPresent(OutputBuffer &OB, Qualifiers Q, Qualifiers Mask, bool NeedSpace)
static void outputQualifiers(OutputBuffer &OB, Qualifiers Q, bool SpaceBefore, bool SpaceAfter)
static void outputSpaceIfNecessary(OutputBuffer &OB)
assert(ImpDefSCC.getReg()==AMDGPU::SCC &&ImpDefSCC.isDef())
This is a utility class that provides an abstraction for the common functionality between Instruction...
Definition: Operator.h:31
The instances of the Type class are immutable: once they are created, they are never changed.
Definition: Type.h:45
@ Swift
Calling convention for Swift.
Definition: CallingConv.h:69
@ C
The default llvm calling convention, compatible with C.
Definition: CallingConv.h:34
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
#define N
void outputPost(OutputBuffer &OB, OutputFlags Flags) const override
void outputOneDimension(OutputBuffer &OB, OutputFlags Flags, Node *N) const
void outputPre(OutputBuffer &OB, OutputFlags Flags) const override
void outputDimensionsImpl(OutputBuffer &OB, OutputFlags Flags) const
void output(OutputBuffer &OB, OutputFlags Flags) const override
void outputPost(OutputBuffer &OB, OutputFlags Flags) const override
void outputPre(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
void outputPre(OutputBuffer &OB, OutputFlags Flags) const override
void outputPost(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
void outputTemplateParameters(OutputBuffer &OB, OutputFlags Flags) const
void output(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
virtual void output(OutputBuffer &OB, OutputFlags Flags) const =0
void outputPost(OutputBuffer &OB, OutputFlags Flags) const override
void outputPre(OutputBuffer &OB, OutputFlags Flags) const override
void outputPre(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
void outputPost(OutputBuffer &OB, OutputFlags Flags) const override
void outputPre(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
void outputPost(OutputBuffer &OB, OutputFlags Flags) const override
void outputPre(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override
virtual void outputPre(OutputBuffer &OB, OutputFlags Flags) const =0
virtual void outputPost(OutputBuffer &OB, OutputFlags Flags) const =0
void output(OutputBuffer &OB, OutputFlags Flags) const override
void output(OutputBuffer &OB, OutputFlags Flags) const override