eio_cancel

(PECL eio >= 0.0.1dev)

eio_cancel — Annule une requête

Description

eio_cancel(resource $req): void

La fonction eio_cancel() annule une requête spécifiée par req.

Liste de paramètres

req

La ressource de la requête.

pri

La priorité de la requête : EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, ou null. Si null est passé, le paramètre pri, en interne, est défini à EIO_PRI_DEFAULT.

callback

La fonction de rappel callback est appelée lorsque la requête est terminée. Elle doit correspondre au prototype suivant :

void callback(mixed $data, int $result[, resource $req]);
data

représente les données personnalisées passées à la requête.

result

représente la valeur résultante spécifique à la requête ; basiquement, la valeur retournée par l'appel système correspondant.

req

est la ressource optionnelle de la requête qui peut être utilisée avec les fonctions comme eio_get_last_error()

data

Variable arbitraire passée à la fonction de rappel callback.

Valeurs de retour

Aucune valeur n'est retournée.

Exemples

Exemple #1 Exemple avec eio_cancel()

<?php
 /* Appelé lorsque eio_nop() est terminé */
 function my_nop_cb($data, $result) {
  echo "my_nop ", $data, "\n";
 }

// Cet appel à la fonction eio_nop() sera annulé
$req = eio_nop(EIO_PRI_DEFAULT, "my_nop_cb", "1");
var_dump($req);
eio_cancel($req);

// Cette fois, la fonction eio_nop() sera exécuté
eio_nop(EIO_PRI_DEFAULT, "my_nop_cb", "2");

// Traitement des requêtes
eio_event_loop();
?>

Résultat de l'exemple ci-dessus est similaire à :

resource(4) of type (EIO Request Descriptor)
my_nop 2

Voir aussi