# eio_cancel

(PECL eio >= 0.0.1dev)

eio_cancel — Cancels a request

### 说明

eio_cancel ( resource `$req` ) : void

eio_cancel() cancels a request specified by `req`

### 参数

`req`

  The request resource

`pri`

  请求的优先级：`EIO_PRI_DEFAULT`，`EIO_PRI_MIN`，`EIO_PRI_MAX` 或 `NULL`。如果是 `NULL`，`pri` 将设为 `EIO_PRI_DEFAULT`。

`callback`

  `callback` 函数在请求完成时被调用。其应匹配一下原型：

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

  `data`

    传递给请求的用户数据。

  `result`

    针对请求的结果的值。通常是相应的系统调用返回的值。

  `req`

    可选的请求资源，可被 eio_get_last_error() 之类的函数使用。

`data`

  Arbitrary variable passed to `callback`.

### 返回值

没有返回值。

### 范例

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 processed
    eio_nop(EIO_PRI_DEFAULT, "my_nop_cb", "2");

    // Process requests
    eio_event_loop();
    ?>

以上例程的输出类似于：

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

### 参见

- eio_grp_cancel