.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1990-1991, The Regents of the University of California. .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: BSD-4-Clause-UC .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH fseek 3 "17 мая 2025 г." "Linux man\-pages 6.18" .SH НАИМЕНОВАНИЕ fgetpos, fseek, fsetpos, ftell, rewind \- меняют положение в потоке .SH БИБЛИОТЕКА Стандартная библиотека языка C (\fIlibc\fP,\ \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .P \fBint fseek(FILE *\fP\fIstream\fP\fB, long \fP\fIoffset\fP\fB, int \fP\fIwhence\fP\fB);\fP \fBlong ftell(FILE *\fP\fIstream\fP\fB);\fP .P \fBvoid rewind(FILE *\fP\fIstream\fP\fB);\fP .P \fBint fgetpos(FILE *restrict \fP\fIstream\fP\fB, fpos_t *restrict \fP\fIpos\fP\fB);\fP \fBint fsetpos(FILE *\fP\fIstream\fP\fB, const fpos_t *\fP\fIpos\fP\fB);\fP .fi .SH ОПИСАНИЕ Функция \fBfseek\fP() устанавливает положение файлового индикатора в потоке, на который указывает аргумент \fIstream\fP. Новое положение (в байтах) получается прибавлением \fIoffset\fP байтов к положению, которое задаётся параметром \fIwhence\fP. Если значение \fIwhence\fP равно \fBSEEK_SET\fP, \fBSEEK_CUR\fP или \fBSEEK_END\fP, то смещение указывается относительно начала файла, текущего положения указателя или конца файла, соответственно. Успешный вызов функции \fBfseek\fP() очищает (clear) индикатор конца файла потока и отменяет влияние функции \fBungetc\fP(3) на этот же поток. .P Функция \fBftell\fP() возвращает текущее значение файлового индикатора положения для потока, на который указывает \fIstream\fP. .P Функция \fBrewind\fP() устанавливает файловый индикатор положения для потока, на который указывает \fIstream\fP, равным началу файла. Эта функция эквивалентна вызову: .P .RS (void) fseek(stream, 0L, SEEK_SET) .RE .P хотя в этом случае также сбрасывается индикатор ошибок потока (смотрите \fBclearerr\fP(3)). .P Функции \fBfgetpos\fP() и \fBfsetpos\fP() эквивалентны \fBftell\fP() и \fBfseek\fP() (где значение \fIwhence\fP равно \fBSEEK_SET\fP); они сохраняют или устанавливают текущее значение файлового смещения в объектах, определяемых \fIpos\fP. В некоторых не\-UNIX системах объект \fIfpos_t\fP может быть сложным объектом, а данные функции могут быть единственным переносимым способом изменения положения в текстовом потоке. .P If the stream refers to a regular file and the resulting stream offset is beyond the size of the file, subsequent writes will extend the file with a hole, up to the offset, before committing any data. See \fBlseek\fP(2) for details on file seeking semantics. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" Функция \fBrewind\fP() не возвращает значений. При успешном выполнении функции \fBfgetpos\fP(), \fBfseek\fP(), \fBfsetpos\fP() возвращают 0, а \fBftell\fP() возвращает значение текущего смещения. В противном случае возвращается \-1, а в \fIerrno\fP записывается соответствующий код ошибки. .SH ОШИБКИ .TP \fBEINVAL\fP Значение \fIwhence\fP в \fBfseek\fP() не равно \fBSEEK_SET\fP, \fBSEEK_\fP или \fBSEEK_CUR\fP. Или результирующее смещение файла получается отрицательным. .TP \fBESPIPE\fP Связанный со \fIstream\fP файловый дескриптор не допускает перемоток (верно для каналов, FIFO или сокетов). .P При ошибках функции \fBfgetpos\fP(), \fBfseek\fP(), \fBfsetpos\fP() и \fBftell\fP() устанавливают значение \fIerrno\fP равным значению, определённому в функциях \fBfflush\fP(3), \fBfstat\fP(2), \fBlseek\fP(2) и \fBmalloc\fP(3). .SH АТРИБУТЫ Описание терминов данного раздела смотрите в \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Интерфейс Атрибут Значение T{ .na .nh \fBfseek\fP(), \fBftell\fP(), \fBrewind\fP(), \fBfgetpos\fP(), \fBfsetpos\fP() T} Безвредность в нитях MT\-Safe .TE .SH СТАНДАРТЫ C11, POSIX.1\-2008. .SH ИСТОРИЯ POSIX.1\-2001, C89. .SH "СМОТРИТЕ ТАКЖЕ" \fBlseek\fP(2), \fBfseeko\fP(3) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства разработал(и) Azamat Hackimov , Dmitry Bolkhovskikh , Yuri Kozlov и Иван Павлов . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT debian-l10n-russian@lists.debian.org списка рассылки русских переводчиков .ME .