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_errlista _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 streamproti . Funkce vymaže indikátor konce souboru a vrátí zpět všechny účinky ungetc na stream. Po volání fsetposmůž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.

Viz také

Vstupně-výstupní operace streamu
fgetpos