noble (3) fwide.3.gz

BEZEICHNUNG

       fwide - Die Orientierung eines FILE-Datenstroms setzen und ermitteln

BIBLIOTHEK

       Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

       #include <wchar.h>

       int fwide(FILE *Datenstrom, int Modus);

   Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):

       fwide():
           _XOPEN_SOURCE >= 500 || _ISOC99_SOURCE
               || _POSIX_C_SOURCE >= 200112L

BESCHREIBUNG

       Wenn  Modus  Null  ist,  dann bestimmt die Funktion fwide() die aktuelle Orientierung vom Datenstrom. Sie
       liefert einen positiven Wert zurück, falls Datenstrom sich an weiten Zeichen orientiert.  Dies  bedeutet,
       dass  E/A  mit  weiten  Zeichen erlaubt, aber E/A mit Char nicht erlaubt ist. Sie liefert einen negativen
       Wert zurück, falls Datenstrom sich an Byte orientiert. Dies bedeutet, dass E/A mit Char erlaubt, aber E/A
       mit  weiten Zeichen nicht erlaubt ist. Sie liefert Null, falls Datenstrom noch keine Orientierung hat. In
       diesem Fall kann die nächste E/A-Aktion die Orientierung ändern  (zu  Byte-Orientierung,  falls  es  eine
       Char-E/A-Aktion ist oder zur Weiten-Zeichen-Orientierung, falls es eine Weite-Zeichen-E/A-Aktion ist).

       Sobald  ein  Datenstrom  eine Orientierung hat, kann diese nicht geändert werden und bleibt bestehen, bis
       der Datenstrom geschlossen wird.

       Wenn Modus von Null  verschieden  ist,  versucht  die  Funktion  fwide()  zuerst,  die  Orientierung  des
       Datenstroms   zu  setzen  (auf  Weite-Zeichen-Orientierung,  falls  Modus  größer  als  0  ist  oder  auf
       Byte-Orientierung, falls Modus kleiner als 0  ist).  Sie  liefert  dann  einen  Wert,  der  die  aktuelle
       Orientierung, wie oben beschrieben, anzeigt.

RÜCKGABEWERT

       Die  Funktion  fwide()  liefert die Orientierung des Datenstroms zurück, nachdem sie diese möglicherweise
       geändert hat. Ein positiver Rückgabewert bedeutet Weite-Zeichen-Orientierung. Ein negativer Wert bedeutet
       Byte-Orientierung. Ein Rückgabewert von Null bedeutet unentschieden.

STANDARDS

       POSIX.1-2001, POSIX.1-2008, C99.

ANMERKUNGEN

       Ausgabe weiter Zeichen in einen Byte-orientierten Datenstrom kann mittels der Funktion fprintf(3) mit den
       Direktiven %lc und %ls erfolgen.

       Char-orientierte Ausgabe  in  einen  Weite-Zeichen-orientierten  Datenstrom  kann  mittels  der  Funktion
       fwprintf(3) mit den Direktiven %c und %s erfolgen.

SIEHE AUCH

       fprintf(3), fwprintf(3)

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

       Diese  Übersetzung  ist  Freie  Dokumentation;  lesen  Sie  die  GNU  General  Public  License  Version 3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE
       HAFTUNG übernommen.

       Wenn  Sie  Fehler  in  der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die
       Mailingliste der Übersetzer ⟨debian-l10n-german@lists.debian.org⟩.