.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1990-1991, The Regents of the University of California.
.\" Copyright 2020, Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: BSD-4-Clause-UC
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH fread 3 "10. Februar 2026" "Linux man\-pages 6.18" 
.SH BEZEICHNUNG
fread, fwrite \- Ein\-/Ausgabe binärer Datenströme
.SH BIBLIOTHEK
Standard\-C\-Bibliothek (\fIlibc\fP,\ \fI\-lc\fP)
.SH ÜBERSICHT
.nf
\fB#include <stdio.h>\fP
.P
\fBsize_t fread(\fPsize_t groesse, size_t n;
\fB             void \fP\fIzeiger\fP\fB[restrict \fP\fIgroesse\fP\fB * \fP\fIn\fP\fB],\fP
\fB             size_t \fP\fIgroesse\fP\fB, size_t \fP\fIn\fP\fB,\fP
\fB             FILE *restrict \fP\fIdatenstrom\fP\fB);\fP
\fBsize_t fwrite(\fPsize_t groesse, size_t n;
\fB             const void \fP\fIzeiger\fP\fB[restrict \fP\fIgroesse\fP\fB * \fP\fIn\fP\fB],\fP
\fB             size_t \fP\fIgroesse\fP\fB, size_t \fP\fIn\fP\fB,\fP
\fB             FILE *restrict \fP\fIdatenstrom\fP\fB);\fP
.fi
.SH BESCHREIBUNG
Die Funktion \fBfread\fP() liest \fIn\fP Datenelemente, jeweils \fIgroesse\fP Byte
lang, vom Datenstrom, auf den \fIdatenstrom\fP zeigt, und speichert sie an der
Position, die \fIzeiger\fP angibt.
.P
Die Funktion \fBfwrite\fP() schreibt \fIn\fP Datenelemente, jeweils \fIgroesse\fP
Byte lang, in den Datenstrom, auf den \fIdatenstrom\fP zeigt. Diese stammen von
der Position, die \fIzeiger\fP angibt.
.P
Für nicht sperrende Gegenstücke siehe \fBunlocked_stdio\fP(3).
.SH RÜCKGABEWERT
Bei Erfolg geben \fBfread\fP() und \fBfwrite\fP() die Anzahl der geschriebenen
oder gelesenen Elemente zurück. Diese Zahl ist nur gleich der Anzahl der
übertragenen Byte, wenn \fIgroesse\fP 1 ist. Falls ein Fehler auftritt oder das
Dateiende erreicht ist, wird eine kleinere Zahl von gelesenen Elementen
(oder Null) zurückgegeben.
.P
Der Dateipositionsanzeiger für den Datenstrom wird um die Anzahl der
erfolgreich gelesenen oder geschriebenen Bytes vorwärtsbewegt.
.P
\fBfread\fP() unterscheidet nicht zwischen Dateiende und Fehler, der Aufrufende
muss \fBfeof\fP(3) bzw. \fBferror\fP(3) benutzen, um herauszufinden was passiert
ist.
.SH ATTRIBUTE
Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt
verwandten Ausdrücke.
.TS
allbox;
lbx lb lb
l l l.
Schnittstelle	Attribut	Wert
T{
.na
.nh
\fBfread\fP(),
\fBfwrite\fP()
T}	Multithread\-Fähigkeit	MT\-Sicher
.TE
.SH STANDARDS
C11, POSIX.1\-2008.
.SH GESCHICHTE
POSIX.1\-2001, C89.
.SH BEISPIELE
Das nachfolgende Programm stellt die Verwendung von \fBfread\fP() dar, indem es
ein /bin/sh\-ELF\-Programm im binären Modus auswertet und dessen Magie und
Klasse ausgibt:
.P
.in +4n
.EX
$\fB ./a.out\fP;
ELF\-Magie: 0x7f454c46
Klasse: 0x02
.EE
.in
.SS Programmquelltext
.\" SRC BEGIN (fread.c)
\&
.EX
#include <stdcountof.h>
#include <stdio.h>
#include <stdlib.h>
\&
int
main(void)
{
    FILE           *fp;
    size_t         ret;
    unsigned char  buffer[4];
\&
    fp = fopen("/bin/sh", "rb");
    if (!fp) {
        perror("fopen");
        return EXIT_FAILURE;
    }
\&
    ret = fread(buffer, sizeof(*buffer), countof(buffer), fp);
    if (ret != countof(buffer)) {
        fprintf(stderr, "fread() fehlgeschlagen: %zu\[rs]n", ret);
        exit(EXIT_FAILURE);
    }
\&
    printf("ELF\-Magie: %#04x%02x%02x%02x\[rs]n", buffer[0], buffer[1],
           buffer[2], buffer[3]);
\&
    ret = fread(buffer, 1, 1, fp);
    if (ret != 1) {
        fprintf(stderr, "fread() fehlgeschlagen: %zu\[rs]n", ret);
        exit(EXIT_FAILURE);
    }
\&
    printf("Klasse: %#04x\[rs]n", buffer[0]);
\&
    fclose(fp);
\&
    exit(EXIT_SUCCESS);
}
.EE
.\" SRC END
.SH "SIEHE AUCH"
\fBread\fP(2), \fBwrite\fP(2), \fBfeof\fP(3), \fBferror\fP(3), \fBunlocked_stdio\fP(3)
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Martin Schulze <joey@infodrom.org>,
Chris Leick <c.leick@vollbio.de>
und
Helge Kreutzmann <debian@helgefjell.de>
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .