.\" -*- 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 fgetws 3 "31. Oktober 2023" "Linux man\-pages 6.06" 
.SH BEZEICHNUNG
fgetws \- Eine Zeichenkette weiter Zeichen aus einem FILE\-Datenstrom lesen
.SH BIBLIOTHEK
Standard\-C\-Bibliothek (\fIlibc\fP, \fI\-lc\fP)
.SH ÜBERSICHT
.nf
\fB#include <wchar.h>\fP
.P
\fBwchar_t *fgetws(wchar_t \fP\fIws\fP\fB[restrict .\fP\fIn\fP\fB], int \fP\fIn\fP\fB, FILE *restrict \fP\fIDatenstrom\fP\fB);\fP
.fi
.SH BESCHREIBUNG
Die Funktion \fBfgetws\fP() ist das Äquivalent der Funktion \fBfgets\fP(3) für
weite Zeichen. Sie liest eine Zeichenkette von höchstens \fIn\-1\fP weiten
Zeichen in das Feld weiter Zeichen auf das \fIws\fP zeigt und fügt ein
abschließendes weites Nullzeichen (L\[aq]\e0\[aq]) hinzu. Sie beendet das
Lesen weiter Zeichen, nachdem sie auf ein weites Zeilenumbruchzeichen
gestoßen ist und dieses gespeichert hat. Sie stoppt auch beim Ende des
Datenstroms.
.P
Der Programmierer muss sicherstellen, dass es Raum für mindestens \fIn\fP weite
Zeichen unter \fIws\fP gibt.
.P
Für ein nicht sperrendes Gegenstück siehe \fBunlocked_stdio\fP(3).
.SH RÜCKGABEWERT
Die Funktion \fBfgetws\fP() liefert im Erfolgsfall \fIws\fP zurück. Falls bereits
das Ende des Datenstrom erreicht wurde oder ein Fehler auftrat, wird NULL
zurückgeliefert.
.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
\fBfgetws\fP()
T}	Multithread\-Fähigkeit	MT\-Sicher
.TE
.SH STANDARDS
C11, POSIX.1\-2008.
.SH GESCHICHTE
POSIX.1\-2001, C99.
.SH ANMERKUNGEN
Das Verhalten der Funktion \fBfgetws\fP() hängt von der Kategorie \fBLC_CTYPE\fP
der aktuellen Locale ab.
.P
Werden keine zusätzlichen Informationen an den Aufruf \fBfopen\fP(3) übergeben,
kann vernünftigerweise angenommen werden, dass \fBfgetws\fP() tatsächlich eine
Multibyte\-Zeichenkette aus dem Datenstrom lesen und sie dann in eine
Zeichenkette weiter Zeichen umwandeln wird.
.P
Diese Funktion ist unzuverlässig, da sie es nicht erlaubt, korrekt mit
weiten Nullzeichen umzugehen, die in der Eingabe vorhanden sein können.
.SH "SIEHE AUCH"
\fBfgetwc\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 .