Swift withThrowingTaskGroup(of:returning:body:)用法及代碼示例

withThrowingTaskGroup(of:returning:body:)

詳述

一個組在返回之前等待其所有子任務完成、拋出錯誤或被取消。此函數返回後，任務組始終為空。

要收集組子任務的結果，可以使用for - await - in 循環：

var sum = 0
for await result in group {
    sum += result
}

如果您需要更多控製或隻需要幾個結果，您可以直接調用next()：

guard let first = await group.next() else {
    group.cancelAll()
    return 0
}
let second = await group.next() ?? 0
group.cancelAll()
return first + second

任務組取消

您可以通過在任務組上調用cancellAll() 方法或取消正在運行該組的任務來取消任務組及其所有子任務。

如果您調用async(priority:operation:) 在已取消的組中創建新任務，則該任務在創建後立即取消。或者，您可以調用 asyncUnlessCancelled(priority:operation:) ，如果組已被取消，它不會創建任務 在這兩個函數之間進行選擇可以讓您控製如何對組內的取消做出反應：一些子任務需要運行而不管取消，但是當你知道它們不能產生有用的結果時，最好不要創建其他任務。

在任務組的一項任務中拋出錯誤不會立即取消該組中的其他任務。但是，如果您在任務組中調用 next() 並傳播其錯誤，則會取消所有其他任務。例如，在下麵的代碼中，沒有取消任何內容，並且組不會拋出錯誤：

withThrowingTaskGroup { group in
    group.addTask { throw SomeError() }
}

相比之下，此示例拋出 SomeError 並取消組中的所有任務：

withThrowingTaskGroup { group in
    group.addTask { throw SomeError() }
    try group.next()
}

單個任務在對 Group.next() 的相應調用中拋出其錯誤，這使您有機會處理單個錯誤或讓組重新拋出錯誤。