CKTIS / C
fgets — funkcja strumieniowa C23
`fgets(s, n, stream)` z `<stdio.h>` czyta do tablicy `s` najwyżej `n - 1` znaków ze strumienia, zatrzymując się po odczytanym znaku nowego wiersza albo na końcu pliku. Znak nowego wiersza zostaje w tablicy, a po odczytanych danych funkcja dopisuje `\0`.
Wersja: C23
Składnia
char *fgets(char * restrict s, int n, FILE * restrict stream);fgets(s, n, stream) z <stdio.h> czyta do tablicy s najwyżej n - 1 znaków ze strumienia, zatrzymując się po odczytanym znaku nowego wiersza albo na końcu pliku. Znak nowego wiersza zostaje w tablicy, a po odczytanych danych funkcja dopisuje \0.
Przykład zapisuje red\nblue do tmpfile() i dwukrotnie wywołuje fgets. Wynik 4 1 blue pokazuje, że pierwszy bufor ma cztery znaki i zawiera \n, a drugi odczytuje ostatni wiersz bez końcowego znaku nowego wiersza.
Wynik to s przy sukcesie albo null przy błędzie lub gdy EOF wystąpi przed odczytaniem choć jednego znaku; rozróżnij te przypadki przez feof i ferror. Przekaż dodatnie n nieprzekraczające rzeczywistej pojemności i zakresu int. Długi wiersz może wymagać kilku wywołań, a osadzony bajt \0 sprawia, że samo strlen nie opisuje wszystkich odczytanych danych.
Przykłady
#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;
}
Wynik
4 1 blue
Przykład zapisuje `red\nblue` do `tmpfile()` i dwukrotnie wywołuje `fgets`. Wynik `4 1 blue` pokazuje, że pierwszy bufor ma cztery znaki i zawiera `\n`, a drugi odczytuje ostatni wiersz bez końcowego znaku nowego wiersza.