CKTIS / C
fgets — funkcija toka C23
`fgets(s, n, stream)` iz `<stdio.h>` čita najviše `n - 1` znakova u polje `s` i staje nakon pročitanog znaka novog retka ili na kraju datoteke. Pročitani novi red ostaje u polju, a funkcija iza podataka dodaje `\0`.
Verzija: C23
Sintaksa
char *fgets(char * restrict s, int n, FILE * restrict stream);fgets(s, n, stream) iz <stdio.h> čita najviše n - 1 znakova u polje s i staje nakon pročitanog znaka novog retka ili na kraju datoteke. Pročitani novi red ostaje u polju, a funkcija iza podataka dodaje \0.
Primjer piše red\nblue u tmpfile() i dvaput poziva fgets. 4 1 blue pokazuje da prvi međuspremnik ima četiri znaka uključujući \n, dok drugi čita zadnji redak bez završnog novog retka.
Pri uspjehu vraća s, a pri pogrešci ili EOF-u prije prvog znaka null; razlikuj uzrok s feof i ferror. Predaj pozitivan n koji ne prelazi stvarni kapacitet ni raspon int. Dugačak redak može zahtijevati više poziva, a ugrađeni bajt \0 znači da strlen ne opisuje sve pročitane znakove.
Primjeri
#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
Primjer piše `red\nblue` u `tmpfile()` i dvaput poziva `fgets`. `4 1 blue` pokazuje da prvi međuspremnik ima četiri znaka uključujući `\n`, dok drugi čita zadnji redak bez završnog novog retka.