Documentación

Aprenda a usar TrueAsync para crear aplicaciones PHP concurrentes.

Future::cancel

(PHP 8.6+, True Async 1.0)

public function cancel(?AsyncCancellation $cancellation = null): void

Cancela el Future. Todas las corrutinas que esperan este Future mediante await() recibirán una CancelledException. Si se proporciona el parámetro $cancellation, se usará como razón de cancelación.

Parámetros

cancellation — una excepción de cancelación personalizada. Si es null, se usa la CancelledException por defecto.

Valor de retorno

La función no devuelve un valor.

Ejemplos

Ejemplo #1 Cancelación básica del Future

<?php

use Async\Future;
use Async\FutureState;

$state = new FutureState();
$future = new Future($state);

// Una corrutina esperando el resultado
\Async\async(function() use ($future) {
    try {
        $result = $future->await();
    } catch (\Async\CancelledException $e) {
        echo "Future cancelado\n";
    }
});

// Cancelar el Future
$future->cancel();

Ejemplo #2 Cancelación con razón personalizada

<?php

use Async\Future;
use Async\FutureState;
use Async\AsyncCancellation;

$state = new FutureState();
$future = new Future($state);

\Async\async(function() use ($future) {
    try {
        $future->await();
    } catch (\Async\CancelledException $e) {
        echo "Razón: " . $e->getMessage() . "\n";
        // Razón: Tiempo de espera excedido
    }
});

$future->cancel(new AsyncCancellation("Tiempo de espera excedido"));

Ver también