CKTIS / C
rewind — revenir au début d’un fichier
rewind positionne un flux au début de son fichier et efface son indicateur d’erreur. La fonction ne renvoie aucune valeur ; elle ne permet donc pas de savoir directement si le repositionnement a réussi.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdio.h>
void rewind(FILE *stream);rewind(stream) de <stdio.h> positionne un flux FILE ouvert au début de son fichier. Transmettez un pointeur valide vers un flux ouvert, et non NULL ni un pointeur utilisé après fclose.
La fonction agit comme (void)fseek(stream, 0L, SEEK_SET), mais efface aussi l’indicateur d’erreur. En cas de repositionnement réussi, elle efface également l’indicateur de fin de fichier et annule les effets de ungetc. Elle n’efface pas le contenu du fichier.
La fonction renvoie void. Pour détecter les échecs de positionnement, utilisez fseek et vérifiez son résultat. Vérifier uniquement ferror après rewind ne permet pas de confirmer la réussite. Ne supposez pas que tous les flux prennent en charge le positionnement.
Exemples
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
FILE *stream = tmpfile();
if (stream == NULL) {
return EXIT_FAILURE;
}
if (fputs("ABC", stream) == EOF || fflush(stream) == EOF) {
fclose(stream);
return EXIT_FAILURE;
}
rewind(stream);
int first = fgetc(stream);
if (first != 'A') {
fclose(stream);
return EXIT_FAILURE;
}
if (fclose(stream) == EOF) {
return EXIT_FAILURE;
}
if (printf("first: %c\n", first) < 0) {
return EXIT_FAILURE;
}
return EXIT_SUCCESS;
}Résultat
first: A
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.