(PECL eio >= 0.0.1dev)
eio_fallocate — 允許呼叫者直接操作檔案的已分配磁碟空間
$fd
,$mode
,$offset
,$length
,$pri
= EIO_PRI_DEFAULT,$callback
= NULL,$data
= NULL
eio_fallocate() 允許呼叫者直接操作由檔案描述器 fd
指定的檔案所配置的磁碟空間,範圍從 offset
位元組開始,持續 length
個位元組。
注意:檔案應以寫入模式開啟
EIO_O_CREAT
應該與EIO_O_WRONLY
或EIO_O_RDWR
進行邏輯 *OR* 運算。
fd
串流、Socket 資源或數字檔案描述器,例如由 eio_open() 返回的值。
mode
目前 mode 只支援一個旗標:EIO_FALLOC_FL_KEEP_SIZE
(與 POSIX 常數 FALLOC_FL_KEEP_SIZE
相同)。
offset
指定位元組範圍的起始位置。
length
指定位元組範圍的長度。
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_fallocate() 成功時返回請求資源,失敗時返回 false
。