streamWrapper::stream_seek
(PHP 4 >= 4.3.2, PHP 5)
streamWrapper::stream_seek — Перемещение на заданную позицию в потоке
Описание
$offset
, int $whence = SEEK_SET
)Этот метод вызывается в результате вызова функции fseek().
Позицию чтения/записи в потоке необходимо обновлять в соответствии с
аргументами offset и whence.
Список параметров
-
offset -
Смещение в потоке, на которое требуется переместиться.
-
whence -
Возможные значения:
-
SEEK_SET- Переместиться на позициюoffsetбайт от начала файла. -
SEEK_CUR- Переместиться наoffsetбайт относительно текущей позиции. -
SEEK_END- Переместиться на позициюoffsetбайт от конца файла.
-
Возвращаемые значения
Возвращает TRUE, если позиция обновлена, FALSE в остальных случаях.
Примечания
Замечание:
Если не реализован, в качестве возвращаемого значения принимается
FALSE.
Замечание:
В случае успеха streamWrapper::stream_tell() будет вызвана сразу после того, как streamWrapper::stream_seek() отработает. Если выполнение streamWrapper::stream_tell() завершится неудачей, то в вызывающую функцию будет возвращено значение
FALSE
Замечание:
Не все операции перемещения в потоке приведут к вызову этой функции. В PHP по умолчанию включена буферизация потоков (см. также stream_set_read_buffer()), поэтому перемещение в потоке может означать лишь перемещение указателя в буфере.
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Другие базовые расширения
- Потоки
- Функция streamWrapper::__construct() - Создает новый объект-обертку для потока
- Функция streamWrapper::__destruct() - Уничтожает существующую обертку потока
- Функция streamWrapper::dir_closedir() - Обработчик закрытия директории
- Функция streamWrapper::dir_opendir() - Обработчик открытия директории
- Функция streamWrapper::dir_readdir() - Обработчик чтения содержимого директории
- Функция streamWrapper::dir_rewinddir() - Обработчик перемещения на начало директории
- Функция streamWrapper::mkdir() - Создание директории
- Функция streamWrapper::rename() - Переименовывает файл или директорию
- Функция streamWrapper::rmdir() - Удаляет директорию
- Функция streamWrapper::stream_cast() - Получает ресурс уровнем ниже
- Функция streamWrapper::stream_close() - Закрывает ресурс
- Функция streamWrapper::stream_eof() - Проверяет достижение конца файла по файловому указателю
- Функция streamWrapper::stream_flush() - Сохранение данных вывода
- Функция streamWrapper::stream_lock() - Advisory file locking
- Функция streamWrapper::stream_metadata() - Изменяет настройки потока
- Функция streamWrapper::stream_open() - Открывает файл или URL
- Функция streamWrapper::stream_read() - Читает из потока
- Функция streamWrapper::stream_seek() - Перемещение на заданную позицию в потоке
- Функция streamWrapper::stream_set_option() - Изменение настроек потока
- Функция streamWrapper::stream_stat() - Получение информации о файловом ресурсе
- Функция streamWrapper::stream_tell() - Определение текущей позиции потока
- Функция streamWrapper::stream_truncate() - Усечение потока
- Функция streamWrapper::stream_write() - Запись в поток
- Функция streamWrapper::unlink() - Удаление файла
- Функция streamWrapper::url_stat() - Получение информации о файле
Коментарии
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;
}