.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) 1990, 1991 The Regents of the University of California.
.\" and Copyright (c) 2020 Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to Berkeley by
.\" Chris Torek and the American National Standards Committee X3,
.\" on Information Processing Systems.
.\"
.\" SPDX-License-Identifier: BSD-4-Clause-UC
.\"
.\"     @(#)fread.3	6.6 (Berkeley) 6/29/91
.\"
.\" Converted for Linux, Mon Nov 29 15:37:33 1993, faith@cs.unc.edu
.\" Sun Feb 19 21:26:54 1995 by faith, return values
.\" Modified Thu Apr 20 20:43:53 1995 by Jim Van Zandt <jrv@vanzandt.mv.com>
.\" Modified Fri May 17 10:21:51 1996 by Martin Schulze <joey@infodrom.north.de>
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH fread 3 "29. Dezember 2022" "Linux man\-pages 6.03" 
.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
.PP
\fBsize_t fread(void \fP\fIzeiger\fP\fB[restrict .\fP\fIgroesse\fP\fB * .\fP\fInmemb\fP\fB],\fP
\fB             size_t \fP\fIgroesse\fP\fB, size_t \fP\fInmemb\fP\fB,\fP
\fB             FILE *restrict \fP\fIdatenstrom\fP\fB);\fP
\fBsize_t fwrite(const void \fP\fIptr\fP\fB[restrict .\fP\fIgroesse\fP\fB * .\fP\fInmemb\fP\fB],\fP
\fB             size_t \fP\fIgroesse\fP\fB, size_t \fP\fInmemb\fP\fB,\fP
\fB             FILE *restrict \fP\fIdatenstrom\fP\fB);\fP
.fi
.SH BESCHREIBUNG
Die Funktion \fBfread\fP() liest \fInmemb\fP Datenelemente, jeweils \fIgroesse\fP
Byte lang, vom Datenstrom, auf den \fIdatenstrom\fP zeigt, und speichert sie an
der Position, die \fIzeiger\fP angibt.
.PP
Die Funktion \fBfwrite\fP() schreibt \fInmemb\fP Datenelemente, jeweils \fIgroesse\fP
Byte lang, in den Datenstrom, auf den \fIdatenstrom\fP zeigt. Diese stammen von
der Position, die \fIzeiger\fP angibt.
.PP
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.
.PP
Der Dateipositionsanzeiger für den Datenstrom wird um die Anzahl der
erfolgreich gelesenen oder geschriebenen Bytes vorwärtsbewegt.
.PP
\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.
.ad l
.nh
.TS
allbox;
lbx lb lb
l l l.
Schnittstelle	Attribut	Wert
T{
\fBfread\fP(),
\fBfwrite\fP()
T}	Multithread\-Fähigkeit	MT\-Safe
.TE
.hy
.ad
.sp 1
.SH STANDARDS
POSIX.1\-2001, POSIX.1\-2008, C99.
.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:
.PP
.in +4n
.EX
$ \fB./a.out\fP
ELF\-Magie: 0x7f454c46
Klasse: 0x02
.EE
.in
.SS Programmquelltext
.\" SRC BEGIN (fread.c)
\&
.EX
#include <stdio.h>
#include <stdlib.h>

#define ARRAY_SIZE(arr) (sizeof(arr) / sizeof((arr)[0]))

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), ARRAY_SIZE(buffer), fp);
    if (ret != ARRAY_SIZE(buffer)) {
        fprintf(stderr, "fread() fehlgeschlagen: %zu\en", ret);
        exit(EXIT_FAILURE);
    }

    printf("ELF\-Magie: %#04x%02x%02x%02x\en", buffer[0], buffer[1],
           buffer[2], buffer[3]);

    ret = fread(buffer, 1, 1, fp);
    if (ret != 1) {
        fprintf(stderr, "fread() fehlgeschlagen: %zu\en", ret);
        exit(EXIT_FAILURE);
    }

    printf("Klasse: %#04x\en", 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 .