CKTIS / C
fgets — funkcija toka C23
`fgets(s, n, stream)` iz `<stdio.h>` prebere največ `n - 1` znakov v polje `s` in se ustavi po prebranem znaku nove vrstice ali ob koncu datoteke. Prebrani znak ostane v polju, funkcija pa za podatke doda `\0`.
Različica: C23
Sintaksa
char *fgets(char * restrict s, int n, FILE * restrict stream);fgets(s, n, stream) iz <stdio.h> prebere največ n - 1 znakov v polje s in se ustavi po prebranem znaku nove vrstice ali ob koncu datoteke. Prebrani znak ostane v polju, funkcija pa za podatke doda \0.
Primer zapiše red\nblue v tmpfile() in dvakrat pokliče fgets. 4 1 blue pokaže, da prvi medpomnilnik vsebuje štiri znake z \n, drugi pa prebere zadnjo vrstico brez končnega znaka nove vrstice.
Ob uspehu vrne s, ob napaki ali EOF pred prvim znakom pa null; vzrok ločite z feof in ferror. Podajte pozitiven n, ki ne presega dejanske zmogljivosti niti območja int. Dolga vrstica lahko zahteva več klicev, vdelani bajt \0 pa pomeni, da strlen ne opiše vseh prebranih znakov.
Primeri
#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;
}
Rezultat
4 1 blue
Primer zapiše `red\nblue` v `tmpfile()` in dvakrat pokliče `fgets`. `4 1 blue` pokaže, da prvi medpomnilnik vsebuje štiri znake z `\n`, drugi pa prebere zadnjo vrstico brez končnega znaka nove vrstice.