CKTIS / C
ungetc — remettre un caractère dans un flux
ungetc remet un caractère dans un flux afin qu’il soit lu à nouveau, sans modifier le fichier. Le code portable peut compter sur la possibilité de remettre un caractère.
Version : C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdio.h>
int ungetc(int c, FILE *stream);ungetc, déclaré dans <stdio.h>, remet c, converti en unsigned char, dans le flux d’entrée stream. La lecture suivante récupère ce caractère ; il n’est pas nécessaire qu’il corresponde à un caractère lu précédemment. Le fichier reste inchangé.
La fonction renvoie la valeur remise dans le flux ou EOF en cas d’échec. Passer EOF entraîne un échec sans modifier le flux. Stockez les résultats de fgetc dans un int, et non dans un char.
Un caractère est garanti ; les remises en arrière supplémentaires peuvent échouer. Les caractères sont récupérés dans l’ordre inverse. Un appel réussi à ungetc efface l’indicateur de fin de fichier. Un appel réussi à fseek, fsetpos ou rewind supprime les caractères remis dans le flux. Ce mécanisme sert à anticiper la lecture, et non à annuler des lectures de façon générale.
Exemples
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
FILE *stream = tmpfile();
if (stream == NULL)
return EXIT_FAILURE;
if (fputs("AB", stream) == EOF || fseek(stream, 0L, SEEK_SET) != 0) {
fclose(stream);
return EXIT_FAILURE;
}
if (fgetc(stream) != 'A' || ungetc('X', stream) == EOF) {
fclose(stream);
return EXIT_FAILURE;
}
int first = fgetc(stream);
int second = fgetc(stream);
int close_result = fclose(stream);
if (first != 'X' || second != 'B' || close_result == EOF)
return EXIT_FAILURE;
if (printf("%c %c\n", first, second) < 0)
return EXIT_FAILURE;
return EXIT_SUCCESS;
}Résultat
X B
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.