mirror of
https://github.com/apple/swift.git
synced 2025-12-14 20:36:38 +01:00
f3ff561c6f
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.
84 lines
2.8 KiB
C++
84 lines
2.8 KiB
C++
//===--- ModuleInterfacePrinting.h - Routines to print module interface ---===//
|
|
//
|
|
// 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
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef SWIFT_IDE_MODULE_INTERFACE_PRINTING_H
|
|
#define SWIFT_IDE_MODULE_INTERFACE_PRINTING_H
|
|
|
|
#include "swift/Basic/LLVM.h"
|
|
#include "swift/Basic/OptionSet.h"
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
namespace clang {
|
|
class Module;
|
|
}
|
|
|
|
namespace swift {
|
|
class ASTContext;
|
|
class ASTPrinter;
|
|
class ModuleDecl;
|
|
class SourceFile;
|
|
class Type;
|
|
struct PrintOptions;
|
|
|
|
namespace ide {
|
|
|
|
/// Flags used when traversing a module for printing.
|
|
enum class ModuleTraversal : unsigned {
|
|
/// Visit modules even if their contents wouldn't be visible to name lookup.
|
|
VisitHidden = 0x01,
|
|
/// Visit submodules.
|
|
VisitSubmodules = 0x02,
|
|
/// Skip the declarations in a Swift overlay module.
|
|
SkipOverlay = 0x04,
|
|
};
|
|
|
|
/// Options used to describe the traversal of a module for printing.
|
|
using ModuleTraversalOptions = OptionSet<ModuleTraversal>;
|
|
|
|
void collectModuleGroups(ModuleDecl *M, SmallVectorImpl<StringRef> &Into);
|
|
|
|
llvm::Optional<StringRef>
|
|
findGroupNameForUSR(ModuleDecl *M, StringRef USR);
|
|
|
|
bool printTypeInterface(ModuleDecl *M, Type Ty, ASTPrinter &Printer,
|
|
std::string &TypeName, std::string &Error);
|
|
|
|
bool printTypeInterface(ModuleDecl *M, StringRef TypeUSR, ASTPrinter &Printer,
|
|
std::string &TypeName, std::string &Error);
|
|
|
|
void printModuleInterface(ModuleDecl *M, ArrayRef<StringRef> GroupNames,
|
|
ModuleTraversalOptions TraversalOptions,
|
|
ASTPrinter &Printer, const PrintOptions &Options,
|
|
const bool PrintSynthesizedExtensions);
|
|
|
|
/// Print the interface for a header that has been imported via the implicit
|
|
/// objc header importing feature.
|
|
void printHeaderInterface(StringRef Filename, ASTContext &Ctx,
|
|
ASTPrinter &Printer, const PrintOptions &Options);
|
|
|
|
|
|
/// Print the interface for a given swift source file.
|
|
void printSwiftSourceInterface(SourceFile &File, ASTPrinter &Printer,
|
|
const PrintOptions &Options);
|
|
|
|
/// Print the symbolic Swift interface for a given imported clang module.
|
|
void printSymbolicSwiftClangModuleInterface(ModuleDecl *M, ASTPrinter &Printer,
|
|
const clang::Module *clangModule);
|
|
|
|
} // namespace ide
|
|
|
|
} // namespace swift
|
|
|
|
#endif // SWIFT_IDE_MODULE_INTERFACE_PRINTING_H
|