.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification
.\"      http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.\" Modified Tue Oct 16 23:18:40 BST 2001 by John Levon <moz@compsoc.man.ac.uk>
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH fgetwc 3 "20. Juli 2023" "Linux man\-pages 6.05.01" 
.SH BEZEICHNUNG
fgetwc, getwc \- Ein weites Zeichen aus einem FILE\-Datenstrom lesen
.SH BIBLIOTHEK
Standard\-C\-Bibliothek (\fIlibc\fP, \fI\-lc\fP)
.SH ÜBERSICHT
.nf
\fB#include <stdio.h>\fP
\fB#include <wchar.h>\fP
.PP
\fBwint_t fgetwc(FILE *\fP\fIDatenstrom\fP\fB);\fP
\fBwint_t getwc(FILE *\fP\fIDatenstrom\fP\fB);\fP
.fi
.SH BESCHREIBUNG
Die Funktion \fBfgetwc\fP() ist das Äquivalent der Funktion \fBfgetc\fP(3) für
weite Zeichen. Sie liest ein weites Zeichen aus \fIDatenstrom\fP und liefert es
zurück. Falls das Ende des Datenstroms erreicht ist oder falls
\fIferror(Datenstrom)\fP wahr wird, liefert sie \fBWEOF\fP zurück. Falls ein
Fehler bei der Umwandlung in weite Zeichen auftritt, setzt sie \fIerrno\fP auf
\fBEILSEQ\fP und liefert \fBWEOF\fP zurück.
.PP
Die Funktion oder das Makro \fBgetwc\fP() funktionieren identisch zu
\fBfgetwc\fP(). Sie kann als Makro implementiert sein und wertet ihre Argumente
mehrfach aus. Es gibt keinen Grund, sie jemals zu verwenden.
.PP
Für nicht sperrende Gegenstücke siehe \fBunlocked_stdio\fP(3).
.SH RÜCKGABEWERT
Im Erfolgsfall liefert \fBfgetwc\fP() das nächste weite Zeichen vom Datenstrom
zurück. Andernfalls wird \fBWEOF\fP zurückgeliefert und \fIerrno\fP gesetzt, um
den Fehler anzuzeigen.
.SH FEHLER
Abgesehen von den normalen gibt es
.TP 
\fBEILSEQ\fP
Die vom Datenstrom erlangten Daten ergeben kein gültiges Zeichen.
.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
\fBfgetwc\fP(),
\fBgetwc\fP()
T}	Multithread\-Fähigkeit	MT\-Sicher
.TE
.sp 1
.SH STANDARDS
C11, POSIX.1\-2008.
.SH GESCHICHTE
POSIX.1\-2001, C99.
.SH ANMERKUNGEN
Das Verhalten von \fBfgetwc\fP() hängt von der Kategorie \fBLC_CTYPE\fP der
aktuellen Locale ab.
.PP
Da keine zusätzlichen Informationen an den Aufruf \fBfopen\fP(3) übergeben
werden, kann vernünftigerweise erwartet werden, dass \fBfgetwc\fP() tatsächlich
eine Multibyte\-Sequenz aus dem Datenstrom liest und sie dann in ein weites
Zeichen konvertiert.
.SH "SIEHE AUCH"
\fBfgetws\fP(3), \fBfputwc\fP(3), \fBungetwc\fP(3), \fBunlocked_stdio\fP(3)
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
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 .