PHPのお勉強！

PHP TOP
PHP 8.4.2 Released!

    eio_rename

    (PECL eio >= 0.0.1dev)

    eio_rename — ファイル名や場所を変更する

    説明

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

    eio_rename() は、ファイル名を変更したり別の場所に移動したりします。

    パラメータ

    path

    元のパス。

    new_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

    callback に渡す任意の引数。

    戻り値

    eio_rename() は、成功した場合にリクエストリソースを返します。失敗した場合に false を返します

    例

    例1 eio_rename() の例

    <?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

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top