Server for Information Technologies Сервер поддерживается
Центром Информационных Технологий
(095) 932-9212, 932-9213, 939-0783
E-mail: info@citforum.ru
Сервер содержит море(!) аналитической информации CIT Forum CD-ROM

LSEEK(2)

НАЗВАНИЕ
lseek - передвижение указателя чтения/записи

СИНТАКСИС

        long lseek (fildes, offset, whence)
        int fildes;
        long offset;
        int whence;

ОПИСАНИЕ
Аргумент fildes - это дескриптор файла, полученный после выполнения системных вызовов creat, open, dup или fcntl. Системный вызов lseek устанавливает указатель текущей позиции файла, ассоциированного с дескриптором fildes, следующим образом, в зависимости от значения аргумента whence:

0Значение указателя устанавливается равным offset байт.
1К текущему значению указателя прибавляется значение offset.
2Значением указателя становится размер файла плюс offset.

При успешном завершении системного вызова lseek возвращается новое значение указателя текущей позиции (в байтах) относительно начала файла. Отметим, что если fildes является дескриптором файла на удаленном компьютере и значение offset отрицательно, вызов lseek возвращает значение указателя текущей позиции, даже если оно отрицательно.

Системный вызов lseek завершается неудачей и указатель текущей позиции не изменяется, если выполнено хотя бы одно из следующих условий:

[EBADF]
Аргумент fildes не является корректным дескриптором открытого файла.
[PIPE]
Дескриптор файла fildes ассоциирован с каналом.
[EINVAL и сигнал SIGSYS] Значение аргумента whence не равно 0, 1 или 2.
[EINVAL]
Дескриптор fildes не является дескриптором файла, расположенного на удаленном компьютере, и результирующее значение указателя текущей позиции отрицательно.

Некоторые устройства не поддерживают передвижение указателя текущей позиции. Для файлов, ассоциированных с такими устройствами, значение указателя не определено.

СМ. ТАКЖЕ
creat(2), dup(2), fcntl(2), open(2).

ДИАГНОСТИКА
При успешном завершении результатом служит неотрицательное целое число - указатель текущей позиции в файле; в случае ошибки возвращается -1, а переменной errno присваивается код ошибки
Comments: info@citmgu.ru
Designed by Andrey Novikov
Copyright © CIT