rewind
REPLACE le pointeur de fichier au début d'un fichier.
void rewind(
FILE *stream
);
Paramètres
- stream
Pointeur vers la structure FICHIER.
Notes
La fonction rewind REPLACE le pointeur de fichier associé à stream au début du fichier. Un appel à rewind est semblable à
(void) fseek( stream**,** 0L, SEEK_SET );
Toutefois, contrairement à fseek, rewind désactive les indicateurs d'erreur du flux de données ainsi que l'indicateur de fin de fichier. En outre, contrairement à fseek, rewind ne renvoie pas de valeur pour indiquer si le pointeur a été déplacement.
Pour désactiver la mémoire tampon de clavier, utilisez rewind avec le flux, stdinassocié à l'aide de le clavier par défaut.
Si NULL est un pointeur , le gestionnaire de paramètres non valides est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, cette fonction renvoie un résultat et errno est défini sur EINVAL.
Pour plus d'informations sur ces codes d'erreur et autres, consultez _doserrno, errno, _sys_errlist et _sys_nerr.
Configuration requise
Routine |
En-tête requis |
|---|---|
rewind |
<stdio.h> |
Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.
Bibliothèques
Toutes les versions des bibliothèques Runtime C.
Exemple
// 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 );
}
}
Sortie
The values written are: 1 and -37
The values read are: 1 and -37
Équivalent .NET Framework
Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.