Cancels a request

- « eio_busy

- eio_chmod »

- 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