mirror of
https://github.com/apple/swift.git
synced 2025-12-21 12:14:44 +01:00
6ac729ea41
Treat `@_unavailableInEmbedded` as if it were `@available(Embedded, unavailable)` and apply platform compatibility logic in the availability checker. Revert back to disallowing calls to universally unavailable functions (`@available(*, unavailable)`) in all contexts.
85 lines
2.9 KiB
C++
85 lines
2.9 KiB
C++
//===--- AvailabilityContextStorage.h - Swift AvailabilityContext ---------===//
|
|
//
|
|
// This source file is part of the Swift.org open source project
|
|
//
|
|
// Copyright (c) 2024 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 defines types used in the implementation of AvailabilityContext.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef SWIFT_AST_AVAILABILITY_CONTEXT_STORAGE_H
|
|
#define SWIFT_AST_AVAILABILITY_CONTEXT_STORAGE_H
|
|
|
|
#include "swift/AST/AvailabilityContext.h"
|
|
#include "llvm/ADT/FoldingSet.h"
|
|
#include <optional>
|
|
|
|
namespace swift {
|
|
|
|
/// Summarizes platform specific availability constraints.
|
|
struct AvailabilityContext::PlatformInfo {
|
|
/// The introduction version.
|
|
AvailabilityRange Range;
|
|
|
|
/// When `IsUnavailable` is true, this value stores the broadest platform
|
|
/// kind for which the context is unavailable.
|
|
PlatformKind UnavailablePlatform;
|
|
|
|
/// Whether or not the context is considered unavailable on the current
|
|
/// platform.
|
|
unsigned IsUnavailable : 1;
|
|
|
|
/// Whether or not the context is `@_unavailableInEmbedded`.
|
|
unsigned IsUnavailableInEmbedded : 1;
|
|
|
|
/// Whether or not the context is considered deprecated on the current
|
|
/// platform.
|
|
unsigned IsDeprecated : 1;
|
|
|
|
/// Sets each field to the value of the corresponding field in `other` if the
|
|
/// other is more restrictive. Returns true if any field changed as a result
|
|
/// of adding this constraint.
|
|
bool constrainWith(const PlatformInfo &other);
|
|
|
|
/// Updates each field to reflect the availability of `decl`, if that
|
|
/// availability is more restrictive. Returns true if any field was updated.
|
|
bool constrainWith(const Decl *decl);
|
|
|
|
bool constrainUnavailability(std::optional<PlatformKind> unavailablePlatform);
|
|
|
|
/// Returns true if `other` is as available or is more available.
|
|
bool isContainedIn(const PlatformInfo &other) const;
|
|
|
|
void Profile(llvm::FoldingSetNodeID &ID) const {
|
|
Range.getRawVersionRange().Profile(ID);
|
|
ID.AddBoolean(IsUnavailable);
|
|
ID.AddBoolean(IsUnavailableInEmbedded);
|
|
ID.AddInteger(static_cast<uint8_t>(UnavailablePlatform));
|
|
ID.AddBoolean(IsDeprecated);
|
|
}
|
|
};
|
|
|
|
/// As an implementation detail, the values that make up an `Availability`
|
|
/// context are uniqued and stored as folding set nodes.
|
|
class AvailabilityContext::Storage final : public llvm::FoldingSetNode {
|
|
Storage(const PlatformInfo &platformInfo) : Platform(platformInfo){};
|
|
|
|
public:
|
|
PlatformInfo Platform;
|
|
|
|
static const Storage *get(const PlatformInfo &platformInfo, ASTContext &ctx);
|
|
|
|
void Profile(llvm::FoldingSetNodeID &ID) const;
|
|
};
|
|
|
|
} // end namespace swift
|
|
|
|
#endif
|