PHP Conference Japan 2024

eio_sync_file_range

(PECL eio >= 0.0.1dev)

eio_sync_file_range同步檔案區段與磁碟

說明

eio_sync_file_range(
    混合 $fd,
    整數 $offset,
    整數 $nbytes,
    整數 $flags,
    整數 $pri = EIO_PRI_DEFAULT,
    可呼叫 $callback = NULL,
    混合型別 (mixed) $data = NULL
): 資源型別 (resource)

eio_sync_file_range() 允許在將檔案描述符 fd 所指的已開啟檔案與磁碟同步時進行精細控制。

參數

fd

檔案描述符

offset

要同步的檔案範圍的起始位元組

nbytes

指定要同步的範圍長度,以位元組為單位。如果 nbytes 為零,則從 offset 到檔案結尾的所有位元組都會同步。

flags

位元遮罩。可以包含以下任何值:EIO_SYNC_FILE_RANGE_WAIT_BEFOREEIO_SYNC_FILE_RANGE_WRITEEIO_SYNC_FILE_RANGE_WAIT_AFTER。這些旗標的含義與其 SYNC_FILE_RANGE_* 對應項相同(請參閱 SYNC_FILE_RANGE(2) 線上手冊頁面)。

pri

請求優先級:EIO_PRI_DEFAULTEIO_PRI_MINEIO_PRI_MAXnull。如果傳遞 nullpri 會在內部設定為 EIO_PRI_DEFAULT

callback

請求完成時會呼叫 callback 函式。它應符合以下原型

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

是傳遞給請求的自訂資料。

result

請求特定的結果值;基本上是對應系統呼叫返回的值。

req

是可選的請求資源,可與 eio_get_last_error() 等函式一起使用。

data

傳遞給 callback 的任意變數。

回傳值

eio_sync_file_range() 成功時返回請求資源,失敗時返回 false

新增註記

使用者貢獻的註記

此頁面沒有使用者貢獻的註記。
To Top