67 lines · c
1//===-- CxxModuleHandler.h --------------------------------------*- C++ -*-===//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-exception6//7//===----------------------------------------------------------------------===//8 9#ifndef LLDB_SOURCE_PLUGINS_EXPRESSIONPARSER_CLANG_CXXMODULEHANDLER_H10#define LLDB_SOURCE_PLUGINS_EXPRESSIONPARSER_CLANG_CXXMODULEHANDLER_H11 12#include "clang/AST/ASTImporter.h"13#include "clang/Sema/Sema.h"14#include "llvm/ADT/StringSet.h"15#include <optional>16 17namespace lldb_private {18 19/// Handles importing decls into an ASTContext with an attached C++ module.20///21/// This class searches a C++ module (which must be attached to the target22/// ASTContext) for an equivalent decl to the one that should be imported.23/// If the decl that is found in the module is a suitable replacement24/// for the decl that should be imported, the module decl will be treated as25/// the result of the import process.26///27/// If the Decl that should be imported is a template specialization28/// that doesn't exist yet in the target ASTContext (e.g. `std::vector<int>`),29/// then this class tries to create the template specialization in the target30/// ASTContext. This is only possible if the CxxModuleHandler can determine31/// that instantiating this template is safe to do, e.g. because the target32/// decl is a container class from the STL.33class CxxModuleHandler {34 /// The ASTImporter that should be used to import any Decls which aren't35 /// directly handled by this class itself.36 clang::ASTImporter *m_importer = nullptr;37 38 /// The Sema instance of the target ASTContext.39 clang::Sema *m_sema = nullptr;40 41 /// List of template names this class currently supports. These are the42 /// template names inside the 'std' namespace such as 'vector' or 'list'.43 llvm::StringSet<> m_supported_templates;44 45 /// Tries to manually instantiate the given foreign template in the target46 /// context (designated by m_sema).47 std::optional<clang::Decl *> tryInstantiateStdTemplate(clang::Decl *d);48 49public:50 CxxModuleHandler() = default;51 CxxModuleHandler(clang::ASTImporter &importer, clang::ASTContext *target);52 53 /// Attempts to import the given decl into the target ASTContext by54 /// deserializing it from the 'std' module. This function returns a Decl if a55 /// Decl has been deserialized from the 'std' module. Otherwise this function56 /// returns nothing.57 std::optional<clang::Decl *> Import(clang::Decl *d);58 59 /// Returns true iff this instance is capable of importing any declarations60 /// in the target ASTContext.61 bool isValid() const { return m_sema != nullptr; }62};63 64} // namespace lldb_private65 66#endif // LLDB_SOURCE_PLUGINS_EXPRESSIONPARSER_CLANG_CXXMODULEHANDLER_H67