fsetpos

Imposta l'indicatore di posizione del flusso.

Sintassi

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

Parametri

stream
Puntatore alla struttura FILE .

pos
Archiviazione dell'indicatore di posizione.

Valore restituito

Se l'esito è positivo, fsetpos restituisce 0. In caso di errore, la funzione restituisce un valore diverso da zero e imposta errno su una delle costanti manifesto seguenti (definite in ERRNO. H): EBADF, il che significa che il file non è accessibile o l'oggetto a cui stream punta non è una struttura di file valida oppure EINVAL, ovvero un valore non valido per stream o pos è stato passato. Se viene passato un parametro non valido, queste funzioni richiamano il gestore di parametri non validi, come descritto in Convalida dei parametri.

Per altre informazioni sui codici restituiti, vedere errno, _doserrno, _sys_errliste _sys_nerr.

Osservazioni:

La fsetpos funzione imposta l'indicatore di posizione del file per stream sul valore di pos, ottenuto in una chiamata precedente a su streamfgetpos . La funzione cancella l'indicatore di fine del file e annulla qualsiasi effetto di ungetc su stream. Dopo una chiamata a fsetpos, l'operazione successiva su stream può essere di input o output.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Requisiti

Funzione	Intestazione obbligatoria
fsetpos	<stdio.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

Vedere l'esempio per fgetpos.

Vedi anche

I/O di flusso
fgetpos