实例方法
share()
与多个订阅者共享上游发布者的输出。
声明
func share() -> Publishers.Share<Self>
返回值
一个类实例,它将从其上游接收到的元素共享给多个订阅者。
详述
该操作符返回的发布者支持多个订阅者,所有订阅者都从上游发布者接收未更改的元素和完成状态。
以下示例使用序列发布者作为计数器发布三个随机数,由 Publisher/map(_:)-99evh
运算符生成。它使用Publisher/share()
运算符向两个订阅者中的每一个共享相同的随机数。此示例仅使用 Publisher/delay(for:tolerance:scheduler:options:)
运算符来防止第一个订阅者立即耗尽序列发布者;异步发布者不需要这个。
let pub = (1...3).publisher
.delay(for: 1, scheduler: DispatchQueue.main)
.map( { _ in return Int.random(in: 0...100) } )
.print("Random")
.share()
cancellable1 = pub
.sink { print ("Stream 1 received: \($0)")}
cancellable2 = pub
.sink { print ("Stream 2 received: \($0)")}
// Prints:
// Random: receive value: (20)
// Stream 1 received: 20
// Stream 2 received: 20
// Random: receive value: (85)
// Stream 1 received: 85
// Stream 2 received: 85
// Random: receive value: (98)
// Stream 1 received: 98
// Stream 2 received: 98
如果没有 Publisher/share()
运算符,流 1 会接收三个随机值,然后流 2 会接收三个不同的随机值。
另请注意,Publishers/Share
是一个类,而不是像大多数其他发布者那样的结构。这意味着您可以使用此运算符创建使用引用语义的发布者实例。
可用版本
iOS 13.0+, iPadOS 13.0+, macOS 10.15+, Mac Catalyst 13.0+, tvOS 13.0+, watchOS 6.0+
相关用法
- Swift Optional.Publisher sink(receiveValue:)用法及代码示例
- Swift Optional.Publisher scan(_:_:)用法及代码示例
- Swift Optional.Publisher sink(receiveCompletion:receiveValue:)用法及代码示例
- Swift Optional.Publisher setFailureType(to:)用法及代码示例
- Swift Optional.Publisher subscribe(on:options:)用法及代码示例
- Swift Optional.Publisher reduce(_:_:)用法及代码示例
- Swift Optional.Publisher tryDrop(while:)用法及代码示例
- Swift Optional.Publisher debounce(for:scheduler:options:)用法及代码示例
- Swift Optional.Publisher breakpoint(receiveSubscription:receiveOutput:receiveCompletion:)用法及代码示例
- Swift Optional.Publisher mapError(_:)用法及代码示例
- Swift Optional.Publisher catch(_:)用法及代码示例
- Swift Optional.Publisher tryAllSatisfy(_:)用法及代码示例
- Swift Optional.Publisher zip(_:_:_:)用法及代码示例
- Swift Optional.Publisher throttle(for:scheduler:latest:)用法及代码示例
- Swift Optional.Publisher assertNoFailure(_:file:line:)用法及代码示例
- Swift Optional.Publisher collect(_:)用法及代码示例
- Swift Optional.Publisher combineLatest(_:_:_:_:)用法及代码示例
- Swift Optional.Publisher merge(with:_:_:)用法及代码示例
- Swift Optional.Publisher map(_:_:)用法及代码示例
- Swift Optional.Publisher assign(to:on:)用法及代码示例
- Swift Optional.Publisher zip(_:_:_:_:)用法及代码示例
- Swift Optional.Publisher output(in:)用法及代码示例
- Swift Optional.Publisher tryReduce(_:_:)用法及代码示例
- Swift Optional.Publisher map(_:_:_:)用法及代码示例
- Swift Optional.Publisher prepend(_:)用法及代码示例
注:本文由纯净天空筛选整理自apple.com大神的英文原创作品 Optional.Publisher share()。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。