fwide(3)

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