fseek(3)                   Library Functions Manual                   fseek(3)

NUME
       fgetpos, fseek, fsetpos, ftell, rewind - repozi<?>ioneaza un flux

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <stdio.h>

       int fseek(FILE *stream, long offset, int whence);
       long ftell(FILE *stream);

       void rewind(FILE *stream);

       int fgetpos(FILE *restrict stream, fpos_t *restrict pos);
       int fsetpos(FILE *stream, const fpos_t *pos);

DESCRIERE
       Func<?>ia fseek() stabile<?>te indicatorul de pozi<?>ie al fi<?>ierului
       pentru fluxul indicat de stream.  Noua pozi<?>ie, masurata in octe<?>i,
       se ob<?>ine prin adaugarea de offset octe<?>i la pozi<?>ia specificata
       de whence.  Daca whence este stabilit la SEEK_SET, SEEK_CUR sau
       SEEK_END, pozi<?>ia este relativa la inceputul fi<?>ierului, la
       indicatorul pozi<?>iei curente sau, respectiv, la sfar<?>itul
       fi<?>ierului.  Un apel reu<?>it la func<?>ia fseek() <?>terge
       indicatorul de sfar<?>it de fi<?>ier al fluxului <?>i anuleaza orice
       efect al func<?>iei ungetc(3) asupra aceluia<?>i flux.

       Func<?>ia ftell() ob<?>ine valoarea curenta a indicatorului de
       pozi<?>ie a fi<?>ierului pentru fluxul indicat de stream.

       Func<?>ia rewind() stabile<?>te indicatorul de pozi<?>ie al
       fi<?>ierului pentru fluxul indicat de stream la inceputul fi<?>ierului.
       Este echivalenta cu:

              (void) fseek(stream, 0L, SEEK_SET)

       cu excep<?>ia faptului ca indicatorul de eroare pentru flux este, de
       asemenea, eliminat (a se vedea clearerr(3)).

       Func<?>iile fgetpos() <?> i fsetpos() sunt interfe<?>e alternative
       echivalente cu ftell() <?> i fseek() (cu whence stabilit la SEEK_SET),
       care stabilesc <?>i stocheaza valoarea curenta a pozi<?>iei
       fi<?>ierului in sau din obiectul la care face referire pos.  Pe unele
       sisteme non-UNIX, un obiect fpos_t poate fi un obiect complex <?>i
       aceste rutine pot fi singura modalitate de a repozi<?>iona portabil un
       flux de text.

       In cazul in care fluxul se refera la un fi<?>ier obi<?>nuit <?>i
       pozi<?>ia fluxului rezultata depa<?>e<?>te dimensiunea fi<?>ierului,
       scrierile ulterioare vor extinde fi<?>ierul cu o gaura, pana la
       pozi<?>ia de deplasare, inainte de a trimite orice date.  A se vedea
       lseek(2) pentru detalii privind semantica de cautare a fi<?>ierelor.

VALOAREA RETURNATA
       Func<?>ia rewind() nu returneaza nicio valoare.  La finalizarea cu
       succes, fgetpos(), fseek(), fsetpos() returneaza 0, iar ftell()
       returneaza pozi<?>ia curenta.  In caz contrar, se returneaza -1, iar
       errno este configurata pentru a indica eroarea.

ERORI-IE<?>IRE
       EINVAL Argumentul whence la fseek() nu a fost SEEK_SET, SEEK_END sau
              SEEK_CUR.  Sau: pozi<?>ia rezultata a fi<?>ierului ar fi fost
              negativa.

       ESPIPE Descriptorul de fi<?>ier care sta la baza stream nu poate fi
              cautat (de exemplu, se refera la o conducta, FIFO sau soclu).

       Func<?>iile fgetpos(), fseek(), fsetpos() <?>i ftell() pot, de
       asemenea, sa e<?>ueze <?>i sa configureze errno pentru oricare dintre
       erorile specificate pentru rutinele fflush(3), fstat(2), lseek(2) <?>i
       malloc(3).

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |fseek(), ftell(), rewind(),           | Siguran<?>a firelor | MT-Safe |
       |fgetpos(), fsetpos()                  |                     |         |
       +--------------------------------------+---------------------+---------+
STANDARDE
       C11, POSIX.1-2008.

ISTORIC
       POSIX.1-2001, C89.

CONSULTA<?>I <?>I
       lseek(2), fseeko(3)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.15    17 mai 2025                         fseek(3)