Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti