Swift ThrowingTaskGroup next()用法及代码示例

next()

返回值

下一个完成的子任务返回的值。

详述

对该方法的连续调用返回的值按照任务 completed 的顺序出现，而不是按照这些任务添加到任务组的顺序出现。例如：

group.addTask { 1 }
group.addTask { 2 }


print(await group.next())
// Prints either "2" or "1".

如果任务组中没有任何挂起的任务，则此方法返回 nil ，它允许您编写以下内容以等待单个任务完成：

if let first = try await group.next() {
   return first
}

它还允许您编写如下代码来等待所有子任务完成，并收集它们返回的值：

while let first = try await group.next() {
   collected += value
}
return collected

等待空组立即返回 nil 而不会暂停。

您还可以使用 for - await - in 循环来收集任务组的结果：

for await try value in group {
    collected += value
}

如果下一个子任务引发错误，并且您将该错误从此方法传播到对ThrowingTaskGroup.withThrowingTaskGroup(of:returning:body:)方法，则该组中所有剩余的子任务都被隐式取消。

不要从创建此任务组的任务外部调用此方法。在大多数情况下，Swift 类型系统可以防止这种错误；例如，因为 add(priority:operation:) 方法正在变异，所以不能像子任务一样从并发执行上下文中调用该方法。