streamWrapper::stream_seek
(PHP 4 >= 4.3.2, PHP 5, PHP 7)
streamWrapper::stream_seek — ストリーム内の特定の場所に移動する
説明
public streamWrapper::stream_seek
( int
$offset
, int $whence = SEEK_SET
) : boolこのメソッドは、fseek() に対応してコールされます。
ストリームの読み込み/書き込み位置を、
offset と whence
に応じて更新しなければなりません。
パラメータ
-
offset -
移動するストリームオフセット。
-
whence -
使用可能な値
SEEK_SET-offsetバイト目の位置に移動する。SEEK_CUR- 現在位置からoffsetバイトぶん進める。SEEK_END- ファイルの終端からoffsetバイトぶん進める。
返り値
位置を更新した場合に TRUE、それ以外の場合に FALSE を返します。
注意
注意:
実装されていないの返り値は
FALSEとみなされます。
注意:
成功した場合、 streamWrapper::stream_seek() をコールした直後に streamWrapper::stream_tell() がコールされます。 streamWrapper::stream_tell() が失敗すると、 呼び出し元関数への返り値は
FALSEに設定されます。
注意:
ストリーム上でシーク操作をしたときに、必ずこの関数がコールされるとは限りません。 PHP のストリームはバッファ付きの読み込みがデフォルトで有効になっている (stream_set_read_buffer() も参照ください) ので、シーク操作が単なるバッファポインタの移動だけで済む場合があります。