rewind
Riposizionare il puntatore del file all'inizio del file stesso.
void rewind(
FILE *stream
);
Parametri
- stream
Puntatore alla struttura FILE.
Note
La funzione rewind riposiziona il puntatore del file associato allo stream all'inizio del file stesso.Una chiamata a rewind è simile a
(void) fseek(stream,0L,SEEK_SET);
Tuttavia, a differenza di fseek, rewind rimuove sia gli indicatori di errore per il flusso sia l'indicatore di fine del file.Inoltre, a differenza di fseek, rewind non restituisce un valore per indicare se il puntatore è stato spostato correttamente.
Per rimuovere il buffer di tastiera, utilizzare rewind con il flusso stdin, associato alla tastiera per impostazione predefinita.
Se il flusso è un puntatore a NULL, viene richiamato il gestore di parametro non valido, come descritto in Convalida dei parametri.Se l'esecuzione può continuare, la funziona restituisce e errno viene impostato su EINVAL.
Per ulteriori informazioni su questi, e altri, codici di errore vedere _doserrno, errno, _sys_errlist, and _sys_nerr .
Requisiti
Routine |
Intestazione obbligatoria |
|---|---|
riavvolgi |
<stdio.h> |
Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.
Librerie
Tutte le versioni delle Librerie di runtime C.
Esempio
// crt_rewind.c
/* This program first opens a file named
* crt_rewind.out for input and output and writes two
* integers to the file. Next, it uses rewind to
* reposition the file pointer to the beginning of
* the file and reads the data back in.
*/
#include <stdio.h>
int main( void )
{
FILE *stream;
int data1, data2;
data1 = 1;
data2 = -37;
fopen_s( &stream, "crt_rewind.out", "w+" );
if( stream != NULL )
{
fprintf( stream, "%d %d", data1, data2 );
printf( "The values written are: %d and %d\n", data1, data2 );
rewind( stream );
fscanf_s( stream, "%d %d", &data1, &data2 );
printf( "The values read are: %d and %d\n", data1, data2 );
fclose( stream );
}
}
Output
The values written are: 1 and -37
The values read are: 1 and -37
Equivalente .NET Framework
Non applicabile. Per chiamare la funzione standard C, utilizzare PInvoke. Per ulteriori informazioni, vedere Esempi di Invocazione della Piattaforma.