CKTIS / C
fgets — prúdová funkcia C23
`fgets(s, n, stream)` z `<stdio.h>` načíta do poľa `s` najviac `n - 1` znakov a zastaví sa po prečítanom konci riadka alebo na konci súboru. Prečítaný koniec riadka v poli zostane a funkcia za dáta pridá `\0`.
Verzia: C23
Syntax
char *fgets(char * restrict s, int n, FILE * restrict stream);fgets(s, n, stream) z <stdio.h> načíta do poľa s najviac n - 1 znakov a zastaví sa po prečítanom konci riadka alebo na konci súboru. Prečítaný koniec riadka v poli zostane a funkcia za dáta pridá \0.
Príklad zapíše red\nblue do tmpfile() a dvakrát zavolá fgets. 4 1 blue ukazuje, že prvý buffer má štyri znaky vrátane \n, zatiaľ čo druhý prečíta posledný riadok bez koncového znaku nového riadka.
Pri úspechu vracia s, pri chybe alebo EOF pred prvým znakom null; príčinu odlíšte pomocou feof a ferror. Odovzdajte kladné n najviac rovné skutočnej kapacite a v rozsahu int. Dlhý riadok môže vyžadovať viac volaní a vložený bajt \0 znamená, že strlen neopisuje všetky prečítané znaky.
Prí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ýsledok
4 1 blue
Príklad zapíše `red\nblue` do `tmpfile()` a dvakrát zavolá `fgets`. `4 1 blue` ukazuje, že prvý buffer má štyri znaky vrátane `\n`, zatiaľ čo druhý prečíta posledný riadok bez koncového znaku nového riadka.