dio_seek

(PHP 4 >= 4.2.0, PHP 5 < 5.1.0)

dio_seek — Переместить указатель в файловом дескрипторе

Описание

dio_seek ( resource $fd , int $pos [, int $whence = SEEK_SET ] ) : int

Функция dio_seek() используется для изменения указателя внутри файла.

Список параметров

fd

Файловый дескриптор, полученный из dio_open().

pos

новая позиция.

whence

Указывает, как надо интерпритировать pos:

  • SEEK_SET (по умолчанию) - указывает, что pos отсчитывается от начала файла.

  • SEEK_CUR - указывает, что pos отсчитывается от текущей позиции. Может быть отрицательным.

  • SEEK_END - указывает, что pos отсчитывается от конца файла. Отрицательное число определяет позицию внутри текущего файла; положительное число определяет позицию после текущего конца. Если вы укажете позицию за пределами текущего конца файла и начнете запись, то недостающий кусок файла будет заполнен нулями.

Возвращаемые значения

Примеры

Пример #1 Позиционирование внутри файла

<?php

$fd = dio_open('/dev/ttyS0', O_RDWR);

dio_seek($fd, 10, SEEK_SET);
// Текущая позиция - 10 байт от начала

dio_seek($fd, -2, SEEK_CUR);
// Текущая позиция - 8 байт от начала

dio_seek($fd, -5, SEEK_END);
// Текущая позиция - 5 байт от конца

dio_seek($fd, 10, SEEK_END);
// Текущая позиция - 10 байт дальше конца файла
// 10 байт от конца файла до текущей позиции заполнены нулями

dio_close($fd);
?>