llvm-project/llvm/unittests/Support/ItaniumManglingCanonicalizerTest.cpp

//===-------------- ItaniumManglingCanonicalizerTest.cpp ------------------===//
//
//                     The LLVM Compiler Infrastructure
//
// This file is dual licensed under the MIT and the University of Illinois Open
// Source Licenses. See LICENSE.TXT for details.
//
//===----------------------------------------------------------------------===//

#include "llvm/Support/ItaniumManglingCanonicalizer.h"

#include "gtest/gtest.h"

#include <cstdlib>
#include <map>

using EquivalenceError = llvm::ItaniumManglingCanonicalizer::EquivalenceError;
using FragmentKind = llvm::ItaniumManglingCanonicalizer::FragmentKind;

struct Equivalence {
  FragmentKind Kind;
  llvm::StringRef First;
  llvm::StringRef Second;
};

// A set of manglings that should all be considered equivalent.
using EquivalenceClass = std::initializer_list<llvm::StringRef>;

struct Testcase {
  // A set of equivalences to register.
  std::initializer_list<Equivalence> Equivalences;
  // A set of distinct equivalence classes created by registering the
  // equivalences.
  std::initializer_list<EquivalenceClass> Classes;
};

static std::initializer_list<Testcase> Testcases = {
  // Three different manglings for std::string (old libstdc++, new libstdc++,
  // libc++).
  {
    {
      {FragmentKind::Type, "Ss",
       "NSt3__112basic_stringIcNS_11char_traitsIcEENS_9allocatorIcEEEE"},
      {FragmentKind::Type, "Ss",
       "NSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEE"},
    },
    {
      {"_Z1fv"},
      {"_Z1fSs",
       "_Z1fNSt3__112basic_stringIcNS_11char_traitsIcEENS_9allocatorIcEEEE",
       "_Z1fNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEE"},
      {"_ZNKSs4sizeEv",
       "_ZNKSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEE4sizeEv",
       "_ZNKSt3__112basic_stringIcNS_11char_traitsIcEENS_9allocatorIcEEE4sizeEv"},
    }
  },

  // Check that substitutions are properly handled.
  {
    {
      // ::X <-> ::N::X<int>
      {FragmentKind::Type, "1X", "N1N1XIiEE"},
      // ::T<T<int, int>, T<int, int>> <-> T<int>
      {FragmentKind::Type, "1TIS_IiiES0_E", "1TIiE"},
      // A::B::foo <-> AB::foo
      {FragmentKind::Name, "N1A1B3fooE", "N2AB3fooE"},
    },
    {
      {"_Z1f1XPS_RS_", "_Z1fN1N1XIiEEPS1_RS1_"},
      {"_ZN1A1B3fooE1TIS1_IiiES2_EPS3_RS3_", "_ZN2AB3fooE1TIiEPS1_RS1_"},
    }
  },

  // Check that nested equivalences are properly handled.
  {
    {
      // std::__1::char_traits == std::__cxx11::char_traits
      // (Note that this is unused and should make no difference,
      // but it should not cause us to fail to match up the cases
      // below.)
      {FragmentKind::Name,
       "NSt3__111char_traitsE",
       "NSt7__cxx1111char_traitsE"},
      // std::__1::allocator == std::allocator
      {FragmentKind::Name,
       "NSt3__19allocatorE",
       "Sa"}, // "Sa" is not strictly a <name> but we accept it as one.
      // std::__1::vector == std::vector
      {FragmentKind::Name,
       "St6vector",
       "NSt3__16vectorE"},
      // std::__1::basic_string<
      //   char
      //   std::__1::char_traits<char>,
      //   std::__1::allocator<char>> ==
      // std::__cxx11::basic_string<
      //   char,
      //   std::char_traits<char>,
      //   std::allocator<char>>
      {FragmentKind::Type,
       "NSt3__112basic_stringIcNS_11char_traitsIcEENS_9allocatorIcEEEE",
       "NSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEE"},
      // X<A> <-> X<B>
      {FragmentKind::Type, "1XI1AE", "1XI1BE"},
      // X <-> Y
      {FragmentKind::Name, "1X", "1Y"},
    },
    {
      // f(std::string)
      {"_Z1fNSt3__112basic_stringIcNS_11char_traitsIcEENS_9allocatorIcEEEE",
       "_Z1fNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEE"},
      // f(std::vector<int>)
      {"_Z1fSt6vectorIiSaIiEE", "_Z1fNSt3__16vectorIiNS_9allocatorIiEEEE"},
      // f(X<A>), f(X<B>), f(Y<A>), f(Y<B>)
      {"_Z1f1XI1AE", "_Z1f1XI1BE", "_Z1f1YI1AE", "_Z1f1YI1BE"},
      // f(X<C>), f(Y<C>)
      {"_Z1f1XI1CE", "_Z1f1YI1CE"},
    }
  },

  // Check namespace equivalences.
  {
    {
      // std::__1 == std::__cxx11
      {FragmentKind::Name, "St3__1", "St7__cxx11"},
      // std::__1::allocator == std::allocator
      {FragmentKind::Name, "NSt3__19allocatorE", "Sa"},
      // std::vector == std::__1::vector
      {FragmentKind::Name, "St6vector", "NSt3__16vectorE"},
      // std::__cxx11::char_traits == std::char_traits
      // (This indirectly means that std::__1::char_traits == std::char_traits,
      // due to the std::__cxx11 == std::__1 equivalence, which is what we rely
      // on below.)
      {FragmentKind::Name, "NSt7__cxx1111char_traitsE", "St11char_traits"},
    },
    {
      // f(std::foo)
      {"_Z1fNSt7__cxx113fooE",
       "_Z1fNSt3__13fooE"},
      // f(std::string)
      {"_Z1fNSt7__cxx1111char_traitsIcEE",
       "_Z1fNSt3__111char_traitsIcEE",
       "_Z1fSt11char_traitsIcE"},
      // f(std::string)
      {"_Z1fNSt3__112basic_stringIcNS_11char_traitsIcEENS_9allocatorIcEEEE",
       "_Z1fNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEE"},
      // f(std::vector<int>)
      {"_Z1fSt6vectorIiSaIiEE", "_Z1fNSt3__16vectorIiNS_9allocatorIiEEEE"},
    }
  },

  // Check namespace equivalences for namespace 'std'. We support using 'St'
  // for this, despite it not technically being a <name>.
  {
    {
      // std::__1 == std
      {FragmentKind::Name, "St3__1", "St"},
      // std::__1 == std::__cxx11
      {FragmentKind::Name, "St3__1", "St7__cxx11"},
      // FIXME: Should a 'std' equivalence also cover the predefined
      // substitutions?
      // std::__1::allocator == std::allocator
      {FragmentKind::Name, "NSt3__19allocatorE", "Sa"},
    },
    {
      {"_Z1fSt3foo", "_Z1fNSt3__13fooE", "_Z1fNSt7__cxx113fooE"},
      {"_Z1fNSt3bar3bazE", "_Z1fNSt3__13bar3bazE"},
      // f(std::string)
      {"_Z1fNSt3__112basic_stringIcNS_11char_traitsIcEENS_9allocatorIcEEEE",
       "_Z1fNSt7__cxx1112basic_stringIcSt11char_traitsIcESaIcEEE"},
      // f(std::vector<int>)
      {"_Z1fSt6vectorIiSaIiEE", "_Z1fNSt3__16vectorIiNS_9allocatorIiEEEE"},
    }
  },

  // Check mutually-recursive equivalences.
  {
    {
      {FragmentKind::Type, "1A", "1B"},
      {FragmentKind::Type, "1A", "1C"},
      {FragmentKind::Type, "1D", "1B"},
      {FragmentKind::Type, "1C", "1E"},
    },
    {
      {"_Z1f1A", "_Z1f1B", "_Z1f1C", "_Z1f1D", "_Z1f1E"},
      {"_Z1f1F"},
    }
  },

  // Check <encoding>s.
  {
    {
      {FragmentKind::Encoding, "1fv", "1gv"},
    },
    {
      // f(void) -> g(void)
      {"_Z1fv", "_Z1gv"},
      // static local 'n' in f(void) -> static local 'n' in g(void)
      {"_ZZ1fvE1n", "_ZZ1gvE1n"},
    }
  },

  // Corner case: the substitution can appear within its own expansion.
  {
    {
      // X <-> Y<X>
      {FragmentKind::Type, "1X", "1YI1XE"},
      // A<B> <-> B
      {FragmentKind::Type, "1AI1BE", "1B"},
    },
    {
      // f(X) == f(Y<X>) == f(Y<Y<X>>) == f(Y<Y<Y<X>>>)
      {"_Z1f1X", "_Z1f1YI1XE", "_Z1f1YIS_I1XEE", "_Z1f1YIS_IS_I1XEEE"},
      // f(B) == f(A<B>) == f(A<A<B>>) == f(A<A<A<B>>>)
      {"_Z1f1B", "_Z1f1AI1BE", "_Z1f1AIS_I1BEE", "_Z1f1AIS_IS_I1BEEE"},
    }
  },

  // Redundant equivalences are accepted (and have no effect).
  {
    {
      {FragmentKind::Name, "3std", "St"},
      {FragmentKind::Name, "1X", "1Y"},
      {FragmentKind::Name, "N1X1ZE", "N1Y1ZE"},
    },
    {}
  },
};

static std::initializer_list<Testcase> ForwardTemplateReferenceTestcases = {
  // ForwardTemplateReference does not support canonicalization.
  // FIXME: We should consider ways of fixing this, perhaps by eliminating
  // the ForwardTemplateReference node with a tree transformation.
  {
    {
      // X::operator T() <with T = A> == Y::operator T() <with T = A>
      {FragmentKind::Encoding, "N1XcvT_I1AEEv", "N1YcvT_I1AEEv"},
      // A == B
      {FragmentKind::Name, "1A", "1B"},
    },
    {
      // All combinations result in unique equivalence classes.
      {"_ZN1XcvT_I1AEEv"},
      {"_ZN1XcvT_I1BEEv"},
      {"_ZN1YcvT_I1AEEv"},
      {"_ZN1YcvT_I1BEEv"},
      // Even giving the same string twice gives a new class.
      {"_ZN1XcvT_I1AEEv"},
    }
  },
};

template<bool CanonicalizeFirst>
static void testTestcases(std::initializer_list<Testcase> Testcases) {
  for (const auto &Testcase : Testcases) {
    llvm::ItaniumManglingCanonicalizer Canonicalizer;
    for (const auto &Equiv : Testcase.Equivalences) {
      auto Result =
          Canonicalizer.addEquivalence(Equiv.Kind, Equiv.First, Equiv.Second);
      EXPECT_EQ(Result, EquivalenceError::Success)
          << "couldn't add equivalence between " << Equiv.First << " and "
          << Equiv.Second;
    }

    using CanonKey = llvm::ItaniumManglingCanonicalizer::Key;

    std::map<const EquivalenceClass*, CanonKey> Keys;
    if (CanonicalizeFirst)
      for (const auto &Class : Testcase.Classes)
        Keys.insert({&Class, Canonicalizer.canonicalize(*Class.begin())});

    std::map<CanonKey, llvm::StringRef> Found;
    for (const auto &Class : Testcase.Classes) {
      CanonKey ClassKey = Keys[&Class];
      for (llvm::StringRef Str : Class) {
        // Force a copy to be made when calling lookup to test that it doesn't
        // retain any part of the provided string.
        CanonKey ThisKey = CanonicalizeFirst
                               ? Canonicalizer.lookup(std::string(Str))
                               : Canonicalizer.canonicalize(Str);
        EXPECT_NE(ThisKey, CanonKey()) << "couldn't canonicalize " << Str;
        if (ClassKey) {
          EXPECT_EQ(ThisKey, ClassKey)
              << Str << " not in the same class as " << *Class.begin();
        } else {
          ClassKey = ThisKey;
        }
      }
      EXPECT_TRUE(Found.insert({ClassKey, *Class.begin()}).second)
          << *Class.begin() << " is in the same class as " << Found[ClassKey];
    }
  }
}

TEST(ItaniumManglingCanonicalizerTest, TestCanonicalize) {
  testTestcases<false>(Testcases);
}

TEST(ItaniumManglingCanonicalizerTest, TestLookup) {
  testTestcases<true>(Testcases);
}

TEST(ItaniumManglingCanonicalizerTest, TestForwardTemplateReference) {
  // lookup(...) after canonicalization (intentionally) returns different
  // values for this testcase.
  testTestcases<false>(ForwardTemplateReferenceTestcases);
}


TEST(ItaniumManglingCanonicalizerTest, TestInvalidManglings) {
  llvm::ItaniumManglingCanonicalizer Canonicalizer;
  EXPECT_EQ(Canonicalizer.addEquivalence(FragmentKind::Type, "", "1X"),
            EquivalenceError::InvalidFirstMangling);
  EXPECT_EQ(Canonicalizer.addEquivalence(FragmentKind::Type, "1X", "1ab"),
            EquivalenceError::InvalidSecondMangling);
  EXPECT_EQ(Canonicalizer.canonicalize("_Z3fooE"),
            llvm::ItaniumManglingCanonicalizer::Key());
  EXPECT_EQ(Canonicalizer.canonicalize("foo"),
            llvm::ItaniumManglingCanonicalizer::Key());

  // A reference to a template parameter ('T_' etc) cannot appear in a <name>,
  // because we don't have template arguments to bind to it. (The arguments in
  // an 'I ... E' construct in the <name> aren't registered as
  // backreferenceable arguments in this sense, because they're not part of
  // the template argument list of an <encoding>.
  EXPECT_EQ(Canonicalizer.addEquivalence(FragmentKind::Name, "N1XcvT_I1AEE",
                                         "1f"),
            EquivalenceError::InvalidFirstMangling);
}

TEST(ItaniumManglingCanonicalizerTest, TestBadEquivalenceOrder) {
  llvm::ItaniumManglingCanonicalizer Canonicalizer;
  EXPECT_EQ(Canonicalizer.addEquivalence(FragmentKind::Type, "N1P1XE", "N1Q1XE"),
            EquivalenceError::Success);
  EXPECT_EQ(Canonicalizer.addEquivalence(FragmentKind::Type, "1P", "1Q"),
            EquivalenceError::ManglingAlreadyUsed);

  EXPECT_EQ(Canonicalizer.addEquivalence(FragmentKind::Type, "N1C1XE", "N1A1YE"),
            EquivalenceError::Success);
  EXPECT_EQ(Canonicalizer.addEquivalence(FragmentKind::Type, "1A", "1B"),
            EquivalenceError::Success);
  EXPECT_EQ(Canonicalizer.addEquivalence(FragmentKind::Type, "1C", "1D"),
            EquivalenceError::Success);
  EXPECT_EQ(Canonicalizer.addEquivalence(FragmentKind::Type, "1B", "1D"),
            EquivalenceError::ManglingAlreadyUsed);
}