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

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.

Fontes