2024 PHP Conference Japan

eio_fallocate

(PECL eio >= 0.0.1dev)

eio_fallocate允許呼叫者直接操作檔案的已分配磁碟空間

說明

eio_fallocate(
    混合 $fd,
    整數 $mode,
    整數 $offset,
    整數 $length,
    整數 $pri = EIO_PRI_DEFAULT,
    可呼叫 $callback = NULL,
    混合 $data = NULL
): 資源

eio_fallocate() 允許呼叫者直接操作由檔案描述器 fd 指定的檔案所配置的磁碟空間,範圍從 offset 位元組開始,持續 length 個位元組。

注意檔案應以寫入模式開啟

EIO_O_CREAT 應該與 EIO_O_WRONLYEIO_O_RDWR 進行邏輯 *OR* 運算。

參數

fd

串流、Socket 資源或數字檔案描述器,例如由 eio_open() 返回的值。

mode

目前 mode 只支援一個旗標:EIO_FALLOC_FL_KEEP_SIZE(與 POSIX 常數 FALLOC_FL_KEEP_SIZE 相同)。

offset

指定位元組範圍的起始位置。

length

指定位元組範圍的長度。

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_fallocate() 成功時返回請求資源,失敗時返回 false

新增註解

使用者貢獻的註解

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