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

       C11, POSIX.1-2008.

GESCHICHTE

       POSIX.1-2001, 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 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.

Linux man-pages 6.9.1                              2. Mai 2024                                          fwide(3)