CKTIS / C
fgets — C23-streamfunctie
`fgets(s, n, stream)` uit `<stdio.h>` leest hoogstens `n - 1` tekens in array `s` en stopt nadat een regeleinde is gelezen of bij bestandseinde. Het gelezen regeleinde blijft in de array en de functie voegt daarna `\0` toe.
Versie: C23
Syntax
char *fgets(char * restrict s, int n, FILE * restrict stream);fgets(s, n, stream) uit <stdio.h> leest hoogstens n - 1 tekens in array s en stopt nadat een regeleinde is gelezen of bij bestandseinde. Het gelezen regeleinde blijft in de array en de functie voegt daarna \0 toe.
Het voorbeeld schrijft red\nblue naar een tmpfile() en roept fgets tweemaal aan. 4 1 blue toont dat de eerste buffer vier tekens inclusief \n bevat en de tweede de slotregel zonder afsluitend regeleinde leest.
Resultaat is s bij succes of null bij leesfout of EOF voordat een teken is gelezen; onderscheid met feof en ferror. Geef een positieve n die werkelijke capaciteit en int-bereik niet overschrijdt. Een lange regel kan meerdere aanroepen vragen en een ingebed \0-byte maakt strlen onvoldoende om alle gelezen tekens te beschrijven.
Voorbeelden
#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;
}
Resultaat
4 1 blue
Het voorbeeld schrijft `red\nblue` naar een `tmpfile()` en roept `fgets` tweemaal aan. `4 1 blue` toont dat de eerste buffer vier tekens inclusief `\n` bevat en de tweede de slotregel zonder afsluitend regeleinde leest.