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.