LLVM 17.0.0git
Demangle.cpp
Go to the documentation of this file.
1//===-- Demangle.cpp - Common demangling functions ------------------------===//
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/// \file This file contains definitions of common demangling functions.
10///
11//===----------------------------------------------------------------------===//
12
14#include <cstdlib>
15#include <cstring>
16
17static bool isItaniumEncoding(const char *S) {
18 // Itanium encoding requires 1 or 3 leading underscores, followed by 'Z'.
19 return std::strncmp(S, "_Z", 2) == 0 || std::strncmp(S, "___Z", 4) == 0;
20}
21
22static bool isRustEncoding(const char *S) { return S[0] == '_' && S[1] == 'R'; }
23
24static bool isDLangEncoding(const std::string &MangledName) {
25 return MangledName.size() >= 2 && MangledName[0] == '_' &&
26 MangledName[1] == 'D';
27}
28
29std::string llvm::demangle(const std::string &MangledName) {
30 std::string Result;
31 const char *S = MangledName.c_str();
32
33 if (nonMicrosoftDemangle(S, Result))
34 return Result;
35
36 if (S[0] == '_' && nonMicrosoftDemangle(S + 1, Result))
37 return Result;
38
39 if (char *Demangled = microsoftDemangle(S, nullptr, nullptr)) {
40 Result = Demangled;
41 std::free(Demangled);
42 return Result;
43 }
44
45 return MangledName;
46}
47
48bool llvm::nonMicrosoftDemangle(const char *MangledName, std::string &Result) {
49 char *Demangled = nullptr;
50 if (isItaniumEncoding(MangledName))
51 Demangled = itaniumDemangle(MangledName);
52 else if (isRustEncoding(MangledName))
53 Demangled = rustDemangle(MangledName);
54 else if (isDLangEncoding(MangledName))
55 Demangled = dlangDemangle(MangledName);
56
57 if (!Demangled)
58 return false;
59
60 Result = Demangled;
61 std::free(Demangled);
62 return true;
63}
static bool isDLangEncoding(const std::string &MangledName)
Definition: Demangle.cpp:24
static bool isRustEncoding(const char *S)
Definition: Demangle.cpp:22
static bool isItaniumEncoding(const char *S)
Definition: Demangle.cpp:17
std::string demangle(const std::string &MangledName)
Attempt to demangle a string using different demangling schemes.
Definition: Demangle.cpp:29
char * dlangDemangle(const char *MangledName)
char * microsoftDemangle(const char *mangled_name, size_t *n_read, int *status, MSDemangleFlags Flags=MSDF_None)
Demangles the Microsoft symbol pointed at by mangled_name and returns it.
char * rustDemangle(const char *MangledName)
bool nonMicrosoftDemangle(const char *MangledName, std::string &Result)
Definition: Demangle.cpp:48
char * itaniumDemangle(const char *mangled_name)
Returns a non-NULL pointer to a NUL-terminated C style string that should be explicitly freed,...