await_any_of_or_fail

(PHP 8.6+, True Async 1.0)

await_any_of_or_fail() — Espera a que las primeras N tareas se completen exitosamente. Si una de las primeras N falla, lanza una excepción.

Descripción

await_any_of_or_fail(
    int $count,
    iterable $triggers,
    ?Async\Awaitable $cancellation = null,
    bool $preserveKeyOrder = true
): array

Parámetros

count El número de resultados exitosos que se esperan. Si es 0, devuelve un array vacío.

triggers Una colección iterable de objetos Async\Completable.

cancellation Un Awaitable opcional para cancelar la espera.

preserveKeyOrder Si es true, las claves de los resultados corresponden a las claves del array de entrada. Si es false, en orden de finalización.

Valores de retorno

Un array de $count resultados exitosos.

Errores/Excepciones

Si una tarea falla antes de alcanzar $count éxitos, se lanza la excepción.

Ejemplos

Ejemplo #1 Obtener 2 de 5 resultados

<?php
use function Async\spawn;
use function Async\await_any_of_or_fail;

$coroutines = [];
for ($i = 0; $i < 5; $i++) {
    $coroutines[] = spawn(file_get_contents(...), "https://api/server-$i");
}

// Esperar cualquier 2 respuestas exitosas
$results = await_any_of_or_fail(2, $coroutines);
echo count($results); // 2
?>

Notas

Nota: El parámetro triggers acepta cualquier iterable, incluyendo implementaciones de Iterator. Consulte el ejemplo con Iterator.

Ver también

• await_any_of() — primeras N con tolerancia a errores
• await_all_or_fail() — todas las tareas