WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

fgets — C23-Datenstromfunktion

`fgets(s, n, stream)` aus `<stdio.h>` liest höchstens `n - 1` Zeichen in das Array `s` und stoppt nach einem gelesenen Zeilenumbruch oder am Dateiende. Ein gelesener Zeilenumbruch bleibt im Array, danach fügt die Funktion `\0` an.

Version: C23

Syntax

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

fgets(s, n, stream) aus <stdio.h> liest höchstens n - 1 Zeichen in das Array s und stoppt nach einem gelesenen Zeilenumbruch oder am Dateiende. Ein gelesener Zeilenumbruch bleibt im Array, danach fügt die Funktion \0 an.

Das Beispiel schreibt red\nblue in eine tmpfile() und ruft fgets zweimal auf. 4 1 blue zeigt, dass der erste Puffer vier Zeichen einschließlich \n enthält und der zweite die letzte Zeile ohne abschließenden Umbruch liest.

Ergebnis ist s bei Erfolg oder null bei Lesefehler beziehungsweise EOF vor dem ersten Zeichen; mit feof und ferror unterscheiden. Positives n übergeben, nicht größer als wirkliche Kapazität oder int-Bereich. Eine lange Zeile braucht mehrere Aufrufe; bei eingebettetem \0 beschreibt strlen nicht alle gelesenen Zeichen.

Beispiele

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

Ergebnis

4 1 blue

Das Beispiel schreibt `red\nblue` in eine `tmpfile()` und ruft `fgets` zweimal auf. `4 1 blue` zeigt, dass der erste Puffer vier Zeichen einschließlich `\n` enthält und der zweite die letzte Zeile ohne abschließenden Umbruch liest.

Quellen