函式名:SplFileObject::ftell()
適用版本:所有版本的 PHP
用法:SplFileObject::ftell() 函式用於獲取當前檔案指標的位置。
語法:public SplFileObject::ftell(): int|false
返回值:返回當前檔案指標的位置(以位元組為單位),如果發生錯誤則返回 false。
示例:
$file = new SplFileObject('path/to/file.txt', 'r');
// 移動檔案指標到第5個位元組的位置
$file->fseek(4);
// 獲取當前檔案指標的位置
$position = $file->ftell();
echo "當前檔案指標的位置是:$position 位元組";
在上面的示例中,我們首先建立了一個 SplFileObject 物件,開啟了一個檔案。然後使用 fseek()
函式將檔案指標移動到第5個位元組的位置。最後,我們使用 ftell()
函式獲取當前檔案指標的位置,並將其輸出。
注意事項:
- SplFileObject 類需要使用
new
關鍵字進行例項化。 - 在呼叫
ftell()
函式之前,需要先呼叫fseek()
函式或其他檔案指標相關的函式,確保檔案指標已經移動到所需位置。 - 如果發生錯誤,
ftell()
函式將返回 false。因此,在使用返回值之前,應該先檢查返回值是否為 false。