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⟩.