Files
swift-mirror/lib/IDE/ExprContextAnalysis.h
Evan Wilde f3ff561c6f [NFC] add llvm namespace to Optional and None
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.
2023-06-27 09:03:52 -07:00

109 lines
3.8 KiB
C++

//===--- ExprContextAnalysis.h - Expession context analysis ---------------===//
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2019 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_EXPRCONTEXTANALYSIS_H
#define SWIFT_IDE_EXPRCONTEXTANALYSIS_H
#include "swift/AST/Type.h"
#include "swift/AST/TypeCheckRequests.h"
#include "swift/AST/Types.h"
#include "swift/Basic/LLVM.h"
#include "swift/Basic/SourceLoc.h"
#include "swift/IDE/PossibleParamInfo.h"
namespace swift {
class DeclContext;
class Expr;
class ValueDecl;
namespace ide {
enum class SemanticContextKind : uint8_t;
/// Type check parent contexts of the given decl context, and the body of the
/// given context until \c Loc if the context is a function body.
void typeCheckContextAt(TypeCheckASTNodeAtLocContext TypeCheckCtx,
SourceLoc Loc);
/// From \p DC, find and returns the outer most expression which source range is
/// exact the same as \p TargetRange. Returns \c nullptr if not found.
Expr *findParsedExpr(const DeclContext *DC, SourceRange TargetRange);
/// Remove \c CodeCompletionExpr from \p expr . Returns \c true if it actually
/// mutated the expression.
///
/// NOTE: Currently, this only removes CodeCompletionExpr at call argument
/// position.
bool removeCodeCompletionExpr(ASTContext &Ctx, Expr *&expr);
/// Collects possible expected return types of the given decl context.
/// \p DC should be an \c AbstractFunctionDecl or an \c AbstractClosureExpr.
void collectPossibleReturnTypesFromContext(DeclContext *DC,
SmallVectorImpl<Type> &candidates);
struct FunctionTypeAndDecl {
AnyFunctionType *Type;
ValueDecl *Decl;
llvm::Optional<SemanticContextKind> SemanticContext;
FunctionTypeAndDecl(AnyFunctionType *Type, ValueDecl *Decl)
: Type(Type), Decl(Decl) {}
FunctionTypeAndDecl(AnyFunctionType *Type, ValueDecl *Decl,
SemanticContextKind SemanticContext)
: Type(Type), Decl(Decl), SemanticContext(SemanticContext) {}
};
/// Given an expression and its decl context, the analyzer tries to figure out
/// the expected type of the expression by analyzing its context.
class ExprContextInfo {
SmallVector<Type, 2> PossibleTypes;
SmallVector<PossibleParamInfo, 2> PossibleParams;
SmallVector<FunctionTypeAndDecl, 2> PossibleCallees;
Expr *AnalyzedExpr = nullptr;
bool implicitSingleExpressionReturn = false;
public:
ExprContextInfo(DeclContext *DC, Expr *TargetExpr);
// Returns a list of possible context types.
ArrayRef<Type> getPossibleTypes() const { return PossibleTypes; }
/// Whether the type context comes from a single-expression body without
/// and explicit return e.g. `foo({ <here> })` and not foo({ return <here>}).
///
/// Since the input may be incomplete, such as in code-completion, take into
/// account that the types returned by `getPossibleTypes()` are only a hint.
bool isImplicitSingleExpressionReturn() const {
return implicitSingleExpressionReturn;
}
// Returns a list of possible argument label names.
// Valid only if \c getKind() is \c CallArgument.
ArrayRef<PossibleParamInfo> getPossibleParams() const {
return PossibleParams;
}
// Returns a list of possible callee
// Valid only if \c getKind() is \c CallArgument.
ArrayRef<FunctionTypeAndDecl> getPossibleCallees() const {
return PossibleCallees;
}
Expr *getAnalyzedExpr() const {
return AnalyzedExpr;
}
};
} // namespace ide
} // namespace swift
#endif // SWIFT_IDE_EXPRCONTEXTANALYSIS_H