fsetpos
Nastaví ukazatel pozice datového proudu.
Syntaxe
int fsetpos(
FILE *stream,
const fpos_t *pos
);
Parametry
stream
Ukazatel na FILE
strukturu.
pos
Úložiště ukazatele pozice.
Vrácená hodnota
V případě úspěchu fsetpos
vrátí hodnotu 0. Při selhání vrátí funkce nenulovou hodnotu a nastaví errno
jednu z následujících konstant manifestu (definovanou v ERRNO). H): EBADF
, což znamená, že soubor není přístupný nebo objekt, na který stream
odkazuje, není platná struktura souboru; nebo EINVAL
, což znamená neplatnou hodnotu pro stream
nebo pos
byla předána. Pokud je předán neplatný parametr, tyto funkce vyvolat neplatnou obslužnou rutinu parametru, jak je popsáno v ověření parametru.
Další informace o návratových kódech naleznete v tématu errno
, _doserrno
, _sys_errlist
a _sys_nerr
.
Poznámky
Funkce fsetpos
nastaví indikátor pozice souboru na stream
hodnotu pos
, která je získána při předchozím volání fgetpos
stream
proti . Funkce vymaže indikátor konce souboru a vrátí zpět všechny účinky ungetc
na stream
. Po volání fsetpos
může být další operace vstupem stream
nebo výstupem.
Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.
Požadavky
Function | Požadovaný hlavičkový soubor |
---|---|
fsetpos |
<stdio.h> |
Další informace o kompatibilitě najdete v tématu Kompatibilita.
Příklad
Podívejte se na příklad pro fgetpos
.