CKTIS / C
fgets — função de fluxo C23
`fgets(s, n, stream)` de `<stdio.h>` lê no máximo `n - 1` carateres para o array `s`, parando depois de ler nova linha ou no fim do ficheiro. A nova linha lida fica no array e a função acrescenta depois `\0`.
Versão: C23
Sintaxe
char *fgets(char * restrict s, int n, FILE * restrict stream);fgets(s, n, stream) de <stdio.h> lê no máximo n - 1 carateres para o array s, parando depois de ler nova linha ou no fim do ficheiro. A nova linha lida fica no array e a função acrescenta depois \0.
O exemplo escreve red\nblue num tmpfile() e chama fgets duas vezes. 4 1 blue mostra que o primeiro buffer tem quatro carateres e inclui \n, enquanto o segundo lê a linha final sem nova linha terminadora.
Devolve s no sucesso ou null por erro de leitura ou se EOF ocorrer antes de qualquer caráter; distingue os casos com feof e ferror. Passa n positivo não superior à capacidade real nem ao intervalo de int. Linha longa pode exigir várias chamadas e um byte \0 incorporado impede que strlen descreva tudo o que foi lido.
Exemplos
#include <stdio.h>
#include <string.h>
int main(void) {
FILE *stream = tmpfile();
if (stream == NULL) return 1;
if (fputs("red\nblue", stream) == EOF) { fclose(stream); return 1; }
rewind(stream);
char first[8];
char second[8];
if (fgets(first, sizeof first, stream) == NULL || fgets(second, sizeof second, stream) == NULL) {
fclose(stream);
return 1;
}
printf("%zu %d %s\n", strlen(first), strchr(first, '\n') != NULL, second);
return fclose(stream) == 0 ? 0 : 1;
}
Resultado
4 1 blue
O exemplo escreve `red\nblue` num `tmpfile()` e chama `fgets` duas vezes. `4 1 blue` mostra que o primeiro buffer tem quatro carateres e inclui `\n`, enquanto o segundo lê a linha final sem nova linha terminadora.