The 5th Annual China PHP Conference


(PHP 4 >= 4.3.2, PHP 5)

streamWrapper::stream_seekSeeks to specific location in a stream


public bool streamWrapper::stream_seek ( int $offset , int $whence = SEEK_SET )

This method is called in response to fseek().

The read/write position of the stream should be updated according to the offset and whence.



The stream offset to seek to.


Possible values:

  • SEEK_SET - Set position equal to offset bytes.
  • SEEK_CUR - Set position to current location plus offset.
  • SEEK_END - Set position to end-of-file plus offset.

Return Values

Return TRUE if the position was updated, FALSE otherwise.



If not implemented, FALSE is assumed as the return value.


Upon success, streamWrapper::stream_tell() is called directly after calling streamWrapper::stream_seek(). If streamWrapper::stream_tell() fails, the return value to the caller function will be set to FALSE

See Also

  • fseek() - Seeks on a file pointer

add a note add a note

User Contributed Notes 1 note

fb at tigermedia dot dk
2 years ago
Please notice that the return value of this function is a boolean but the return value of fseek is 0 for ok and -1 for failure.

Please use this implementation when working with files:

function stream_seek($offset, $whence) {
        if(0 === fseek($this->_handler, $offset, $whence)){
            return true;
        return false;
To Top