实例方法
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 Result.Publisher sink(receiveCompletion:receiveValue:)用法及代码示例
- Swift Result.Publisher sink(receiveValue:)用法及代码示例
- Swift Result.Publisher setFailureType(to:)用法及代码示例
- Swift Result.Publisher subscribe(on:options:)用法及代码示例
- Swift Result.Publisher scan(_:_:)用法及代码示例
- Swift Result.Publisher zip(_:_:_:)用法及代码示例
- Swift Result.Publisher tryLast(where:)用法及代码示例
- Swift Result.Publisher merge(with:_:_:)用法及代码示例
- Swift Result.Publisher tryCompactMap(_:)用法及代码示例
- Swift Result.Publisher print(_:to:)用法及代码示例
- Swift Result.Publisher eraseToAnyPublisher()用法及代码示例
- Swift Result.Publisher first(where:)用法及代码示例
- Swift Result.Publisher output(at:)用法及代码示例
- Swift Result.Publisher tryCatch(_:)用法及代码示例
- Swift Result.Publisher dropFirst(_:)用法及代码示例
- Swift Result.Publisher merge(with:_:_:_:_:_:_:)用法及代码示例
- Swift Result.Publisher flatMap(maxPublishers:_:)用法及代码示例
- Swift Result.Publisher map(_:_:_:)用法及代码示例
- Swift Result.Publisher catch(_:)用法及代码示例
- Swift Result.Publisher drop(while:)用法及代码示例
- Swift Result.Publisher prefix(_:)用法及代码示例
- Swift Result.Publisher timeout(_:scheduler:options:customError:)用法及代码示例
- Swift Result.Publisher merge(with:_:)用法及代码示例
- Swift Result.Publisher map(_:)用法及代码示例
- Swift Result.Publisher append(_:)用法及代码示例
注:本文由纯净天空筛选整理自apple.com大神的英文原创作品 Result.Publisher share()。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。