CKTIS / C
fgets — funzione di flusso C23
`fgets(s, n, stream)` di `<stdio.h>` legge al massimo `n - 1` caratteri nell’array `s`, fermandosi dopo un newline letto o a fine file. Il newline resta nell’array e la funzione aggiunge poi `\0`.
Versione: C23
Sintassi
char *fgets(char * restrict s, int n, FILE * restrict stream);fgets(s, n, stream) di <stdio.h> legge al massimo n - 1 caratteri nell’array s, fermandosi dopo un newline letto o a fine file. Il newline resta nell’array e la funzione aggiunge poi \0.
L’esempio scrive red\nblue in un tmpfile() e chiama due volte fgets. 4 1 blue mostra che il primo buffer ha quattro caratteri e include \n, mentre il secondo legge l’ultima riga senza newline finale.
Restituisce s al successo o null per errore di lettura o se EOF arriva prima di un carattere; distingui i casi con feof e ferror. Passa un n positivo non superiore alla capacità reale né al range di int. Una riga lunga può richiedere più chiamate e un byte \0 incorporato rende strlen insufficiente a descrivere tutto il letto.
Esempi
#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;
}
Risultato
4 1 blue
L’esempio scrive `red\nblue` in un `tmpfile()` e chiama due volte `fgets`. `4 1 blue` mostra che il primo buffer ha quattro caratteri e include `\n`, mentre il secondo legge l’ultima riga senza newline finale.