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_errlist
e _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 stream
fgetpos
. 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
.