CKTIS / C
ungetc — rimettere un carattere in uno stream
ungetc rimette un carattere in uno stream per leggerlo di nuovo, senza modificare il file. Il codice portabile può fare affidamento sulla disponibilità di spazio per un carattere.
Versione: C23; repository compiler flag, production runtime not attested
Sintassi
#include <stdio.h>
int ungetc(int c, FILE *stream);ungetc di <stdio.h> rimette c, convertito in unsigned char, nello stream di input stream. La lettura successiva recupera quel carattere; non è necessario che corrisponda a un carattere letto in precedenza. Il file rimane invariato.
La funzione restituisce il valore rimesso nello stream oppure EOF in caso di errore. Passare EOF provoca un errore senza modificare lo stream. Memorizza i risultati di fgetc in un int, non in un char.
È garantito un carattere; ulteriori operazioni di pushback possono fallire. I caratteri vengono recuperati in ordine inverso. Una chiamata riuscita a ungetc azzera l’indicatore di fine file. Una chiamata riuscita a fseek, fsetpos o rewind scarta i caratteri rimessi nello stream. Questo meccanismo serve per anticipare la lettura dell’input, non per annullare letture in generale.
Esempi
#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;
}Risultato
X B
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.