fgets

Liest maximal count - 1 Zeichen aus dem gegebenen Dateistrom und speichert sie im Zeichenarray, auf das str zeigt. Das Parsen wird beendet, wenn ein Zeilenumbruchzeichen gefunden wird (in diesem Fall enthält str dieses Zeilenumbruchzeichen) oder wenn das Dateiende erreicht wird. Wenn Bytes gelesen werden und keine Fehler auftreten, wird ein Nullzeichen an der Position unmittelbar nach dem letzten in str geschriebenen Zeichen geschrieben.

Parameter

Rückgabewert

str bei Erfolg, Nullzeiger bei Fehler.

Wenn die Dateiende-Bedingung auftritt, setzt es den eof -Indikator auf stream (siehe feof() ). Dies ist nur ein Fehler, wenn dadurch keine Bytes gelesen werden, in welchem Fall ein Nullzeiger zurückgegeben wird und der Inhalt des Arrays, auf das str zeigt, unverändert bleibt (d.h. das erste Byte wird nicht mit einem Nullzeichen überschrieben).

Wenn der Fehler durch einen anderen Fehler verursacht wurde, setzt es den error -Indikator (siehe ferror() ) auf stream . Der Inhalt des Arrays, auf das str zeigt, ist unbestimmt (es muss nicht einmal nullterminiert sein).

Hinweise

POSIX verlangt zusätzlich , dass fgets den errno setzt, wenn ein Lesefehler auftritt.

Obwohl die Spezifikation des Standards in den Fällen, in denen unklar ist, wo count <= 1 , tun gängige Implementierungen dies

• wenn count < 1 , tue nichts, melde Fehler,
• wenn count == 1 ,

• manche Implementierungen tun nichts, melden einen Fehler,
• andere lesen nichts, speichern Null in str [ 0 ] , melden Erfolg.

Beispiel

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    FILE* tmpf = tmpfile();
    fputs("Alan Turing\n", tmpf);
    fputs("John von Neumann\n", tmpf);
    fputs("Alonzo Church\n", tmpf);
    rewind(tmpf);
    char buf[8];
    while (fgets(buf, sizeof buf, tmpf) != NULL)
          printf("\"%s\"\n", buf);
    if (feof(tmpf))
       puts("End of file reached");
}

"Alan Tu"
"ring
"
"John vo"
"n Neuma"
"nn
"
"Alonzo "
"Church
"
End of file reached

Referenzen

Siehe auch