(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。