fseek

説明

int fseek ( resource handle, int offset [, int whence] )

handle が指しているファイルのファイル位置識別子を ファイル・ストリーム中の offset バイト目に セットします。新規位置は、ファイルの先頭からのバイト数で 測られます。これは whence で指定した位置に offset を追加することにより得られます。 この値は、以下のように定義されます。

SEEK_SET - 位置を offset バイト目に設定する

SEEK_CUR - 現在の位置に offset を加えた位置に設定する。

SEEK_END - ファイル終端に offset を加えた位置に設定する （ファイル終端よりも手前に設定する場合、 offset に負の値をセットする必要があります）

whence を指定しない場合、 SEEK_SET が指定されたと仮定します。

成功すると 0 を返し、そうでなければ -1 を返します。EOF より先の 位置にシークしてもエラーとはならないので注意してください。

例 1. fseek() の例 <?php $fp = fopen('somefile.txt', 'r'); // データを読み込む $data = fgets($fp, 4096); // ファイルの先頭に移動する。 // rewind($fp); と等価。 fseek($fp, 0); ?>

"http://" または "ftp://" フォーマット指定の fopen () により返されたファイルポインタに対しては使わないでください。 fseek() は、("a" フラグ付きでオープンされた) 追加のみ可能なストリームに対する結果も未定義です。

ftell() および rewind() も参照ください。