Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła