Php/docs/function.eio-cancel

• PHP Manual
• Eio Functions
• Cancels a request

eio_cancel

(PECL eio >= 0.0.1dev)

eio_cancel — Cancels a request

Description

eio_cancel ( resource $req ) : void

eio_cancel() cancels a request specified by req

Parameters

req

The request resource

pri

The request priority: EIO_PRI_DEFAULT, EIO_PRI_MIN, EIO_PRI_MAX, or NULL. If NULL passed, pri internally is set to EIO_PRI_DEFAULT.

callback

callback function is called when the request is done. It should match the following prototype:

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

data

is custom data passed to the request.

result

request-specific result value; basically, the value returned by corresponding system call.

req

is optional request resource which can be used with functions like eio_get_last_error()

data

Arbitrary variable passed to callback.

Return Values

No value is returned.

Examples

Example #1 eio_cancel() example

<?php /* Is called when eio_nop() finished */ function my_nop_cb($data, $result) {  echo "my_nop ", $data, "\n"; }// This eio_nop() call will be cancelled$req = eio_nop(EIO_PRI_DEFAULT, "my_nop_cb", "1");var_dump($req);eio_cancel($req);// This time eio_nop() will be processedeio_nop(EIO_PRI_DEFAULT, "my_nop_cb", "2");// Process requestseio_event_loop();?>

The above example will output something similar to:

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

See Also

• eio_grp_cancel() - Cancels a request group