fgetws(3) Library Functions Manual fgetws(3) BEZEICHNUNG fgetws - Eine Zeichenkette weiter Zeichen aus einem FILE-Datenstrom lesen BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include wchar_t *fgetws(wchar_t ws[restrict .n], int n, FILE *restrict Datenstrom); BESCHREIBUNG Die Funktion fgetws() ist das Aquivalent der Funktion fgets(3) fur weite Zeichen. Sie liest eine Zeichenkette von hochstens n-1 weiten Zeichen in das Feld weiter Zeichen auf das ws zeigt und fugt ein abschliessendes weites Nullzeichen (L'\0') hinzu. Sie beendet das Lesen weiter Zeichen, nachdem sie auf ein weites Zeilenumbruchzeichen gestossen ist und dieses gespeichert hat. Sie stoppt auch beim Ende des Datenstroms. Der Programmierer muss sicherstellen, dass es Raum fur mindestens n weite Zeichen unter ws gibt. Fur ein nicht sperrendes Gegenstuck siehe unlocked_stdio(3). RUCKGABEWERT Die Funktion fgetws() liefert im Erfolgsfall ws zuruck. Falls bereits das Ende des Datenstrom erreicht wurde oder ein Fehler auftrat, wird NULL zuruckgeliefert. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +--------------------------------+-------------------------+-----------+ |Schnittstelle | Attribut | Wert | +--------------------------------+-------------------------+-----------+ |fgetws() | Multithread-Fahigkeit | MT-Sicher | +--------------------------------+-------------------------+-----------+ STANDARDS C11, POSIX.1-2008. GESCHICHTE POSIX.1-2001, C99. ANMERKUNGEN Das Verhalten der Funktion fgetws() hangt von der Kategorie LC_CTYPE der aktuellen Locale ab. Werden keine zusatzlichen Informationen an den Aufruf fopen(3) ubergeben, kann vernunftigerweise angenommen werden, dass fgetws() tatsachlich eine Multibyte-Zeichenkette aus dem Datenstrom lesen und sie dann in eine Zeichenkette weiter Zeichen umwandeln wird. Diese Funktion ist unzuverlassig, da sie es nicht erlaubt, korrekt mit weiten Nullzeichen umzugehen, die in der Eingabe vorhanden sein konnen. SIEHE AUCH fgetwc(3), unlocked_stdio(3) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.06 31. Oktober 2023 fgetws(3)