blob: 6920000340d4f5643ae28b4fd7e1a7b8bfd006b4 [file] [log] [blame]
//===--- ItaniumManglingCanonicalizer.h -------------------------*- C++ -*-===//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
// This file defines a class for computing equivalence classes of mangled names
// given a set of equivalences between name fragments.
#include "llvm/ADT/StringRef.h"
#include <cstddef>
namespace llvm {
/// Canonicalizer for mangled names.
/// This class allows specifying a list of "equivalent" manglings. For example,
/// you can specify that Ss is equivalent to
/// NSt3__112basic_stringIcNS_11char_traitsIcEENS_9allocatorIcEEEE
/// and then manglings that refer to libstdc++'s 'std::string' will be
/// considered equivalent to manglings that are the same except that they refer
/// to libc++'s 'std::string'.
/// This can be used when data (eg, profiling data) is available for a version
/// of a program built in a different configuration, with correspondingly
/// different manglings.
class ItaniumManglingCanonicalizer {
ItaniumManglingCanonicalizer(const ItaniumManglingCanonicalizer &) = delete;
void operator=(const ItaniumManglingCanonicalizer &) = delete;
enum class EquivalenceError {
/// Both the equivalent manglings have already been used as components of
/// some other mangling we've looked at. It's too late to add this
/// equivalence.
/// The first equivalent mangling is invalid.
/// The second equivalent mangling is invalid.
enum class FragmentKind {
/// The mangling fragment is a <name> (or a predefined <substitution>).
/// The mangling fragment is a <type>.
/// The mangling fragment is an <encoding>.
/// Add an equivalence between \p First and \p Second. Both manglings must
/// live at least as long as the canonicalizer.
EquivalenceError addEquivalence(FragmentKind Kind, StringRef First,
StringRef Second);
using Key = uintptr_t;
/// Form a canonical key for the specified mangling. They key will be the
/// same for all equivalent manglings, and different for any two
/// non-equivalent manglings, but is otherwise unspecified.
/// Returns Key() if (and only if) the mangling is not a valid Itanium C++
/// ABI mangling.
/// The string denoted by Mangling must live as long as the canonicalizer.
Key canonicalize(StringRef Mangling);
/// Find a canonical key for the specified mangling, if one has already been
/// formed. Otherwise returns Key().
Key lookup(StringRef Mangling);
struct Impl;
Impl *P;
} // namespace llvm