NAZWA

       fgetpos, fseek, fsetpos, ftell, rewind - zmiana pozycji w strumieniu

SKŁADNIA

       #include <stdio.h>

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

       long ftell(FILE *stream);

       void rewind(FILE *stream);

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

OPIS

       Funkcja  fseek()  ustawia wskaźnik pozycji pliku dla strumienia wskazywanego przez stream.
       Nową pozycję, określoną w  bajtach,  otrzymuje  się,  dodając  offset  bajtów  do  pozycji
       określonej  przez  whence.  Gdy  whence jest ustawione na SEEK_SET, SEEK_CUR lub SEEK_END,
       offset jest określany, odpowiednio, względem początku pliku,  wskaźnika  bieżącej  pozycji
       lub  końca  pliku. Pomyślne wywołanie funkcji fseek() powoduje wyczyszczenie sygnalizatora
       końca pliku dla strumienia i wycofuje wszelkie efekty funkcji ungetc(3)  dla  tego  samego
       strumienia.

       Funkcja   ftell()   pobiera   bieżącą  wartość  wskaźnika  pozycji  pliku  dla  strumienia
       wskazywanego przez stream.

       Funkcja rewind() ustawia wskaźnik pozycji pliku dla strumienia wskazywanego  przez  stream
       na początku pliku. Jest równoważna:

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

       z  tą  różnicą,  że  jest  również  czyszczony  wskaźnik błędu dla tego strumienia (zobacz
       clearerr(3)).

       Funkcje fgetpos() i fsetpos() stanowią alternatywne  interfejsy  równoważne  z  ftell()  i
       fseek()  (z  whence  ustawionym  na  SEEK_SET), służące odpowiednio do zachowania bieżącej
       wartości offsetu pliku w obiekcie wskazywanym przez pos i do ustawienia  tej  wartości  na
       podstawie  podanego  obiektu.  W niektórych systemach nieuniksowych obiekt fpos_t może być
       złożonym obiektem i powyższe funkcje mogą dawać jedyną przenośną możliwość zmiany  pozycji
       strumienia tekstowego.

WARTOŚĆ ZWRACANA

       Funkcja  rewind()  nie  zwraca  wartości. Przy pomyślnym zakończeniu, fgetpos(), fseek() i
       fsetpos() zwracają 0, a ftell() zwraca bieżący offset.  W  przeciwnym  przypadku  zwracane
       jest -1 i ustawiane jest errno, wskazujące na rodzaj błędu.

BŁĘDY

       EBADF  Podanego strumienia stream nie można pozycjonować.

       EINVAL Argument  whence funkcji fseek() nie jest jednym z SEEK_SET, SEEK_END lub SEEK_CUR.
              Albo: wynikowe przesunięcie pliku będzie ujemne.

       Funkcje fgetpos(), fseek(), fsetpos() i ftell mogą również  zawieść,  ustawiając  w  errno
       dowolny z błędów określonych dla funkcji fflush(3), fstat(2), lseek(2) i malloc(3).

ATRYBUTY

       Informacje   o   pojęciach   używanych   w  tym  rozdziale  można  znaleźć  w  podręczniku
       attributes(7).

       ┌────────────────────────────┬────────────────────────┬─────────┐
       │Interfejs                   │ Atrybut                │ Wartość │
       ├────────────────────────────┼────────────────────────┼─────────┤
       │fseek(), ftell(), rewind(), │ Bezpieczeństwo wątkowe │ MT-Safe │
       │fgetpos(), fsetpos()        │                        │         │
       └────────────────────────────┴────────────────────────┴─────────┘

ZGODNE Z

       POSIX.1-2001, POSIX.1-2008, C89, C99.

ZOBACZ TAKŻE

       lseek(2), fseeko(3)

O STRONIE

       Angielska wersja tej strony  pochodzi  z  wydania  4.07  projektu  Linux  man-pages.  Opis
       projektu,  informacje  dotyczące  zgłaszania  błędów oraz najnowszą wersję oryginału można
       znaleźć pod adresem https://www.kernel.org/doc/man-pages/.

TŁUMACZENIE

       Autorami  polskiego  tłumaczenia   niniejszej   strony   podręcznika   man   są:   Andrzej
       Krzysztofowicz  (PTM)  <ankry@mif.pg.gda.pl>,  Robert Luberda <robert@debian.org> i Michał
       Kułach <michal.kulach@gmail.com>.

       Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów  na
       stronie   http://sourceforge.net/projects/manpages-pl/.   Jest   zgodne   z  wersją   4.07
       oryginału.