Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

ungetc — devolver um carácter a um fluxo

ungetc devolve um carácter a um fluxo para ser lido novamente, sem modificar o ficheiro. O código portátil pode contar com espaço para um carácter.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <stdio.h>
int ungetc(int c, FILE *stream);

ungetc, de <stdio.h>, devolve c, convertido para unsigned char, ao fluxo de entrada stream. A leitura seguinte recupera esse carácter; não tem de corresponder a um carácter lido anteriormente. O ficheiro permanece inalterado.

A função devolve o valor devolvido ao fluxo ou EOF em caso de falha. Passar EOF provoca uma falha sem modificar o fluxo. Guarda os resultados de fgetc num int, não num char.

É garantido um carácter; as devoluções adicionais podem falhar. Os caracteres são recuperados pela ordem inversa. Uma chamada bem-sucedida a ungetc limpa o indicador de fim de ficheiro. Uma chamada bem-sucedida a fseek, fsetpos ou rewind descarta os caracteres devolvidos. Este mecanismo serve para antecipar a leitura da entrada, não para desfazer leituras de forma geral.

Exemplos

#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;
}

Resultado

X B

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes