Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

fgets — proudová funkce C23

`fgets(s, n, stream)` z `<stdio.h>` načte do pole `s` nejvýše `n - 1` znaků a zastaví se po přečteném konci řádku nebo na konci souboru. Přečtený konec řádku v poli zůstane a funkce za data přidá `\0`.

Verze: C23

Syntaxe

char *fgets(char * restrict s, int n, FILE * restrict stream);

fgets(s, n, stream) z <stdio.h> načte do pole s nejvýše n - 1 znaků a zastaví se po přečteném konci řádku nebo na konci souboru. Přečtený konec řádku v poli zůstane a funkce za data přidá \0.

Příklad zapíše red\nblue do tmpfile() a dvakrát zavolá fgets. 4 1 blue ukazuje, že první buffer má čtyři znaky včetně \n, zatímco druhý přečte poslední řádek bez koncového znaku nového řádku.

Při úspěchu vrací s, při chybě nebo EOF před prvním znakem null; příčinu rozlište pomocí feof a ferror. Předejte kladné n nejvýše rovné skutečné kapacitě a v rozsahu int. Dlouhý řádek může vyžadovat více volání a vložený bajt \0 znamená, že strlen nepopisuje všechny přečtené znaky.

Příklady

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

Výsledek

4 1 blue

Příklad zapíše `red\nblue` do `tmpfile()` a dvakrát zavolá `fgets`. `4 1 blue` ukazuje, že první buffer má čtyři znaky včetně `\n`, zatímco druhý přečte poslední řádek bez koncového znaku nového řádku.

Zdroje