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

CKTIS / C

fgetc — função de fluxo C23

`fgetc(stream)` de `<stdio.h>` lê o caráter seguinte de um fluxo de entrada, avança a posição e devolve o byte interpretado como `unsigned char` e depois convertido em `int`. No fim do ficheiro ou em falha devolve `EOF` e define o indicador correspondente.

Versão: C23

Sintaxe

int fgetc(FILE *stream);

fgetc(stream) de <stdio.h> lê o caráter seguinte de um fluxo de entrada, avança a posição e devolve o byte interpretado como unsigned char e depois convertido em int. No fim do ficheiro ou em falha devolve EOF e define o indicador correspondente.

O exemplo escreve A num tmpfile(), rebobina e chama fgetc duas vezes. 1 1 1 0 confirma o primeiro caráter, EOF na segunda tentativa, o indicador de fim definido e nenhum indicador de erro.

Guarda sempre o resultado em int; estreitá-lo primeiro para char pode confundir um byte válido com EOF, sobretudo se char tiver sinal. Depois de EOF, distingue a causa com feof e ferror. O modo texto pode traduzir representações e ungetc repõe um caráter, mas não posiciona arbitrariamente por byte.

Exemplos

#include <stdio.h>

int main(void) {
    FILE *stream = tmpfile();
    if (stream == NULL) return 1;
    if (fputc('A', stream) == EOF) { fclose(stream); return 1; }
    rewind(stream);
    int first = fgetc(stream);
    int second = fgetc(stream);
    printf("%d %d %d %d\n", first == 'A', second == EOF, feof(stream) != 0, ferror(stream) != 0);
    return fclose(stream) == 0 ? 0 : 1;
}

Resultado

1 1 1 0

O exemplo escreve `A` num `tmpfile()`, rebobina e chama `fgetc` duas vezes. `1 1 1 0` confirma o primeiro caráter, `EOF` na segunda tentativa, o indicador de fim definido e nenhum indicador de erro.

Fontes