mirror of
https://github.com/apple/swift.git
synced 2025-12-14 20:36:38 +01:00
41f99fc2ae
* [Executors][Distributed] custom executors for distributed actor * harden ordering guarantees of synthesised fields * the issue was that a non-default actor must implement the is remote check differently * NonDefaultDistributedActor to complete support and remote flag handling * invoke nonDefaultDistributedActorInitialize when necessary in SILGen * refactor inline assertion into method * cleanup * [Executors][Distributed] Update module version for NonDefaultDistributedActor * Minor docs cleanup * we solved those fixme's * add mangling test for non-def-dist-actor
75 lines
3.1 KiB
Swift
75 lines
3.1 KiB
Swift
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This source file is part of the Swift.org open source project
|
|
//
|
|
// Copyright (c) 2020-2022 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
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
import Swift
|
|
@_implementationOnly import _SwiftConcurrencyShims
|
|
|
|
/// Common marker protocol providing a shared "base" for both (local) `Actor`
|
|
/// and (potentially remote) `DistributedActor` types.
|
|
///
|
|
/// The `AnyActor` marker protocol generalizes over all actor types, including
|
|
/// distributed ones. In practice, this protocol can be used to restrict
|
|
/// protocols, or generic parameters to only be usable with actors, which
|
|
/// provides the guarantee that calls may be safely made on instances of given
|
|
/// type without worrying about the thread-safety of it -- as they are
|
|
/// guaranteed to follow the actor-style isolation semantics.
|
|
///
|
|
/// While both local and distributed actors are conceptually "actors", there are
|
|
/// some important isolation model differences between the two, which make it
|
|
/// impossible for one to refine the other.
|
|
@_marker
|
|
@available(SwiftStdlib 5.1, *)
|
|
public protocol AnyActor: AnyObject, Sendable {}
|
|
|
|
/// Common protocol to which all actors conform.
|
|
///
|
|
/// The `Actor` protocol generalizes over all `actor` types. Actor types
|
|
/// implicitly conform to this protocol.
|
|
@available(SwiftStdlib 5.1, *)
|
|
public protocol Actor: AnyActor {
|
|
|
|
/// Retrieve the executor for this actor as an optimized, unowned
|
|
/// reference.
|
|
///
|
|
/// This property must always evaluate to the same executor for a
|
|
/// given actor instance, and holding on to the actor must keep the
|
|
/// executor alive.
|
|
///
|
|
/// This property will be implicitly accessed when work needs to be
|
|
/// scheduled onto this actor. These accesses may be merged,
|
|
/// eliminated, and rearranged with other work, and they may even
|
|
/// be introduced when not strictly required. Visible side effects
|
|
/// are therefore strongly discouraged within this property.
|
|
nonisolated var unownedExecutor: UnownedSerialExecutor { get }
|
|
}
|
|
|
|
/// Called to initialize the default actor instance in an actor.
|
|
/// The implementation will call this within the actor's initializer.
|
|
@available(SwiftStdlib 5.1, *)
|
|
@_silgen_name("swift_defaultActor_initialize")
|
|
public func _defaultActorInitialize(_ actor: AnyObject)
|
|
|
|
@available(SwiftStdlib 5.9, *)
|
|
@_silgen_name("swift_nonDefaultDistributedActor_initialize")
|
|
public func _nonDefaultDistributedActorInitialize(_ actor: AnyObject)
|
|
|
|
/// Called to destroy the default actor instance in an actor.
|
|
/// The implementation will call this within the actor's deinit.
|
|
@available(SwiftStdlib 5.1, *)
|
|
@_silgen_name("swift_defaultActor_destroy")
|
|
public func _defaultActorDestroy(_ actor: AnyObject)
|
|
|
|
@available(SwiftStdlib 5.1, *)
|
|
@_silgen_name("swift_task_enqueueMainExecutor")
|
|
@usableFromInline
|
|
internal func _enqueueOnMain(_ job: UnownedJob)
|