PHP Conference Japan 2024

SplFileObject::fseek

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

SplFileObject::fseek搜尋位置

說明

public SplFileObject::fseek(int $offset, int $whence = SEEK_SET): int

從檔案開頭計算以位元組為單位的檔案位置,藉由將 offset 加到 whence 指定的位置來搜尋該位置。

參數

offset

偏移量。 負值可用於在檔案中向後移動,這在使用 SEEK_END 作為 whence 值時很有用。

whence

whence 值為

  • SEEK_SET - 將位置設定為等於 offset 位元組。
  • SEEK_CUR - 將位置設定為目前位置加上 offset 的值。
  • SEEK_END - 將位置設定為檔案結尾加上 offset 的值。

如果未指定 whence 參數,則預設為 SEEK_SET

返回值

如果搜尋成功,則返回 0,否則返回 -1。請注意,搜尋超過檔案結尾不被視為錯誤。

範例

範例 #1 SplFileObject::fseek() 範例

<?php
$file
= new SplFileObject("somefile.txt");

// 讀取第一行
$data = $file->fgets();

// 將檔案指標移回檔案開頭
// 等同於 $file->rewind();
$file->fseek(0);
?>

另請參閱

  • fseek() - 在檔案指標上搜尋

新增註解

使用者貢獻的註解

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