# eio_rename

(PECL eio >= 0.0.1dev)

eio_rename — Change the name or location of a file

### 说明

eio_rename ( string `$path` , string `$new_path` [, int `$pri` = EIO_PRI_DEFAULT [, callable `$callback` = NULL [, mixed `$data` = NULL ]]] ) : resource

eio_rename() renames or moves a file to new location.

### 参数

`path`

  Source path

`new_path`

  Target path

`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`.

### 返回值

eio_rename() returns request resource on success or `FALSE` on error.

### 范例

Example #1 eio_rename() example

    <?php
    $filename = dirname(__FILE__)."/eio-temp-file.dat";
    touch($filename);
    $new_filename = dirname(__FILE__)."/eio-temp-file-new.dat";

    function my_rename_cb($data, $result) {
        global $filename, $new_filename;

        if ($result == 0 && !file_exists($filename) && file_exists($new_filename)) {
            @unlink($new_filename);
            echo "eio_rename_ok";
        } else {
            @unlink($filename);
        }
    }

    eio_rename($filename, $new_filename, EIO_PRI_DEFAULT, "my_rename_cb", $filename);
    eio_event_loop();
    ?>

以上例程的输出类似于：

    eio_rename_ok