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() 的相应调用中抛出其错误，这使您有机会处理单个错误或让组重新抛出错误。