mirror of
https://github.com/apple/swift.git
synced 2025-12-21 12:14:44 +01:00
This is phase-1 of switching from llvm::Optional to std::optional in the
next rebranch. llvm::Optional was removed from upstream LLVM, so we need
to migrate off rather soon. On Darwin, std::optional, and llvm::Optional
have the same layout, so we don't need to be as concerned about ABI
beyond the name mangling. `llvm::Optional` is only returned from one
function in
```
getStandardTypeSubst(StringRef TypeName,
bool allowConcurrencyManglings);
```
It's the return value, so it should not impact the mangling of the
function, and the layout is the same as `std::optional`, so it should be
mostly okay. This function doesn't appear to have users, and the ABI was
already broken 2 years ago for concurrency and no one seemed to notice
so this should be "okay".
I'm doing the migration incrementally so that folks working on main can
cherry-pick back to the release/5.9 branch. Once 5.9 is done and locked
away, then we can go through and finish the replacement. Since `None`
and `Optional` show up in contexts where they are not `llvm::None` and
`llvm::Optional`, I'm preparing the work now by going through and
removing the namespace unwrapping and making the `llvm` namespace
explicit. This should make it fairly mechanical to go through and
replace llvm::Optional with std::optional, and llvm::None with
std::nullopt. It's also a change that can be brought onto the
release/5.9 with minimal impact. This should be an NFC change.
139 lines
4.7 KiB
C++
139 lines
4.7 KiB
C++
//===--- ClangModule.h - An imported Clang module ---------------*- C++ -*-===//
|
|
//
|
|
// This source file is part of the Swift.org open source project
|
|
//
|
|
// Copyright (c) 2014 - 2017 Apple Inc. and the Swift project authors
|
|
// Licensed under Apache License v2.0 with Runtime Library Exception
|
|
//
|
|
// See https://swift.org/LICENSE.txt for license information
|
|
// See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This file implements support for loading Clang modules into Swift.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
#ifndef SWIFT_CLANGIMPORTER_CLANGMODULE_H
|
|
#define SWIFT_CLANGIMPORTER_CLANGMODULE_H
|
|
|
|
#include "swift/AST/FileUnit.h"
|
|
#include "swift/ClangImporter/ClangImporter.h"
|
|
#include "clang/AST/ExternalASTSource.h"
|
|
#include "clang/Basic/Module.h"
|
|
|
|
namespace clang {
|
|
class ASTContext;
|
|
class Module;
|
|
}
|
|
|
|
namespace swift {
|
|
|
|
class ASTContext;
|
|
class ModuleLoader;
|
|
|
|
/// Represents a Clang module that has been imported into Swift.
|
|
class ClangModuleUnit final : public LoadedFile {
|
|
ClangImporter::Implementation &owner;
|
|
const clang::Module *clangModule;
|
|
llvm::PointerIntPair<ModuleDecl *, 1, bool> overlayModule;
|
|
mutable llvm::Optional<ArrayRef<ImportedModule>> importedModulesForLookup;
|
|
/// The metadata of the underlying Clang module.
|
|
clang::ASTSourceDescriptor ASTSourceDescriptor;
|
|
|
|
public:
|
|
/// True if the given Module contains an imported Clang module unit.
|
|
static bool hasClangModule(ModuleDecl *M);
|
|
|
|
ClangModuleUnit(ModuleDecl &M, ClangImporter::Implementation &owner,
|
|
const clang::Module *clangModule);
|
|
|
|
/// Retrieve the underlying Clang module.
|
|
///
|
|
/// This will be null if the module unit represents the imported headers.
|
|
const clang::Module *getClangModule() const { return clangModule; }
|
|
|
|
/// Returns true if this is a top-level Clang module (not a submodule).
|
|
bool isTopLevel() const;
|
|
|
|
/// Returns the Swift module that overlays this Clang module.
|
|
ModuleDecl *getOverlayModule() const override;
|
|
|
|
/// Retrieve the "exported" name of the module, which is usually the module
|
|
/// real name, but might be the name of the public module through which this
|
|
/// (private) module is re-exported.
|
|
StringRef getExportedModuleName() const override;
|
|
|
|
virtual bool isSystemModule() const override;
|
|
|
|
virtual void lookupValue(DeclName name, NLKind lookupKind,
|
|
OptionSet<ModuleLookupFlags> Flags,
|
|
SmallVectorImpl<ValueDecl*> &results) const override;
|
|
|
|
virtual TypeDecl *
|
|
lookupNestedType(Identifier name,
|
|
const NominalTypeDecl *baseType) const override;
|
|
|
|
virtual void lookupVisibleDecls(ImportPath::Access accessPath,
|
|
VisibleDeclConsumer &consumer,
|
|
NLKind lookupKind) const override;
|
|
|
|
virtual void lookupClassMembers(ImportPath::Access accessPath,
|
|
VisibleDeclConsumer &consumer) const override;
|
|
|
|
virtual void
|
|
lookupClassMember(ImportPath::Access accessPath, DeclName name,
|
|
SmallVectorImpl<ValueDecl*> &decls) const override;
|
|
|
|
void lookupObjCMethods(
|
|
ObjCSelector selector,
|
|
SmallVectorImpl<AbstractFunctionDecl *> &results) const override;
|
|
|
|
virtual bool shouldCollectDisplayDecls() const override;
|
|
|
|
virtual void getTopLevelDecls(SmallVectorImpl<Decl*> &results) const override;
|
|
|
|
virtual void getDisplayDecls(SmallVectorImpl<Decl*> &results, bool recursive = false) const override;
|
|
|
|
virtual void
|
|
getImportedModules(SmallVectorImpl<ImportedModule> &imports,
|
|
ModuleDecl::ImportFilter filter) const override;
|
|
|
|
virtual void getImportedModulesForLookup(
|
|
SmallVectorImpl<ImportedModule> &imports) const override;
|
|
|
|
virtual void
|
|
collectLinkLibraries(ModuleDecl::LinkLibraryCallback callback) const override;
|
|
|
|
Identifier
|
|
getDiscriminatorForPrivateDecl(const Decl *D) const override {
|
|
llvm_unreachable("no private decls in Clang modules");
|
|
}
|
|
|
|
virtual StringRef getFilename() const override;
|
|
|
|
virtual StringRef getLoadedFilename() const override;
|
|
|
|
virtual const clang::Module *getUnderlyingClangModule() const override {
|
|
return getClangModule();
|
|
}
|
|
|
|
clang::ASTContext &getClangASTContext() const;
|
|
|
|
/// Returns the ASTSourceDescriptor of the associated Clang module if one
|
|
/// exists.
|
|
llvm::Optional<clang::ASTSourceDescriptor> getASTSourceDescriptor() const;
|
|
|
|
virtual StringRef getModuleDefiningPath() const override;
|
|
|
|
static bool classof(const FileUnit *file) {
|
|
return file->getKind() == FileUnitKind::ClangModule;
|
|
}
|
|
static bool classof(const DeclContext *DC) {
|
|
return isa<FileUnit>(DC) && classof(cast<FileUnit>(DC));
|
|
}
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|