Swift Result.Publisher combineLatest(_:_:)用法及代碼示例

實例方法

combineLatest(_:_:)

訂閱兩個額外的發布者，並在接收到任何發布者的輸出時發布一個元組。

聲明

func combineLatest<P, Q>(
    _ publisher1: P,
    _ publisher2: Q
) -> Publishers.CombineLatest3<Self, P, Q> where P : Publisher, Q : Publisher, Self.Failure == P.Failure, P.Failure == Q.Failure

返回值

一個從這個發布者和其他兩個發布者接收和組合元素的發布者。

參數

publisher1: 與第一個發布者合並的第二個發布者。
publisher2: 第三個發布者與第一個發布者合並。

詳述

當您希望下遊訂閱者在其中任何一個發布值時從多個發布者接收最新元素的元組時，請使用 Publisher/combineLatest(_:_:)-5crqg。要組合來自多個發布者的元素，請改用Publisher/zip(_:_:)-8d7k7。要僅接收來自多個發布者而不是元組的最新元素，請使用 Publisher/merge(with:_:) 。

合並的發布者將所有請求傳遞給all 上遊發布者。但是，它仍然遵循僅向下遊發送請求量的demand-fulfilling 規則。如果需求不是 Subscribers/Demand/unlimited ，它會從上遊發布者那裏刪除值。它通過為每個上遊使用 1 的緩衝區大小來實現這一點，並在每個緩衝區中保存最新的值。

所有上遊發布者都需要完成此發布者才能完成。如果上遊發布者從不發布值，則此發布者永遠不會完成。

在此示例中，PassthroughSubject 的三個實例發出值；當Publisher/combineLatest(_:_:)-5crqg 接收來自任何上遊發布者的輸入時，它將來自每個發布者的最新值組合成一個元組並發布它：


let pub = PassthroughSubject<Int, Never>()
let pub2 = PassthroughSubject<Int, Never>()
let pub3 = PassthroughSubject<Int, Never>()


cancellable = pub
    .combineLatest(pub2, pub3)
    .sink { print("Result: \($0).") }


pub.send(1)
pub.send(2)
pub2.send(2)
pub3.send(9)


pub.send(3)
pub2.send(12)
pub.send(13)
pub3.send(19)


// Prints:
//  Result: (2, 2, 9).
//  Result: (3, 2, 9).
//  Result: (3, 12, 9).
//  Result: (13, 12, 9).
//  Result: (13, 12, 19).

如果任何組合發布者因失敗而終止，則此發布者也會失敗。

可用版本

iOS 13.0+, iPadOS 13.0+, macOS 10.15+, Mac Catalyst 13.0+, tvOS 13.0+, watchOS 6.0+

相關用法

注：本文由純淨天空篩選整理自apple.com大神的英文原創作品 Result.Publisher combineLatest(_:_:)。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。