Linguaggio C - fseek(), rewind(), ftell(), fgetpos(), fsetpos()

NOME

fseek(), rewind(), ftell(), fgetpos(), fsetpos() - riposiziona uno stream

SINOPSI

#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, fpos_t *pos);

DESCRIZIONE

La funzione fseek() imposta l'indicatore di posizione del file. La prossima operazione di I/O su stream verra' eseguita dalla nuova posizione impostata.
La posizione e' calcolata aggiungendo offset (che puo' assumere anche valori negativi) a whence.
whence puo' valere SEEK_SET, SEEK_CUR o SEEK_END per specificare rispettivamente il riferimento dall'inizio file, dalla posizione corrente o dalla fine file.
In caso di successo, fseek() ritorna 0 e viene cancellato l'indicatore di fine file. In caso di fallimento ritorna -1.

La funzione rewind() imposta l'indicatore di posizione del file puntato da stream all'inizio file. E' equivalente a: (void)fseek(stream, 0L, SEEK_SET)
eccetto al fatto che viene resettato anche l'indicatore di errore.

La funzione ftell() ritorna il valore corrente dell'indicatore di posizione del file associato a stream.

La funzione fgetpos() memorizza nell'oggetto puntato da pos il valore corrente dell'indicatore di posizione del file associato a stream.
Ritorna 0 in caso di successo e -1 in caso di fallimento.

La funzione fsetpos() riposiziona il file associato a stream in base all'indicatore di posizione del file precedentemente salvato nell'oggetto puntato da pos.
Ritorna 0 in caso di successo e -1 in caso di fallimento.

VALORE DI RITORNO

La funzione rewind() non ritorna valori.

Le funzioni fseek(), fgetpos() e fsetpos() ritornano 0 in caso di successo e -1 in caso di errore.

La funzione ftell() ritorna l'offset corrente dello stream in caso di successo e -1 in caso di errore.

CONFORME A

ANSI C3.159-1989 (`ANSI C')

VEDI ANCHE

fopen() fdopen() freopen() tmpfile() fclose() setbuf() setbuffer() setlinebuf() setvbuf() clearerr() feof() ferror() fileno() fflush() fgetc() getc() getchar() ungetc() fputc() putc() putchar() fgets() gets() fputs() puts() scanf() fscanf() sscanf() vscanf() vsscanf() vfscanf() printf() fprintf() sprintf() snprintf() vprintf() vfprintf() vsprintf() vsnprintf() fread() fwrite()

Indice-C Indice linguaggio C
 Indice librerie Indice librerie C
At Home Umberto Zappi Home Page
 Indice funzioni Indice funzioni C