fwide

NAZWA

fwide - ustawienie i określenie orientacji strumienia FILE

BIBLIOTEKA

Standardowa biblioteka C (libc, -lc)

SKŁADNIA

#include <wchar.h>

int fwide(FILE *stream, int mode);

Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

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

OPIS

When mode is zero, the fwide() function determines the current orientation of stream. It returns a positive value if stream is wide-character oriented, that is, if wide-character I/O is permitted but char I/O is disallowed. It returns a negative value if stream is byte oriented—that is, if char I/O is permitted but wide-character I/O is disallowed. It returns zero if stream has no orientation yet; in this case the next I/O operation might change the orientation (to byte oriented if it is a char I/O operation, or to wide-character oriented if it is a wide-character I/O operation).

Raz uzyskana przez strumień orientacja nie może zostać zmieniona aż do zamknięcia strumienia.

Gdy mode jest różne od zera, to funkcja fwide() najpierw próbuje ustawić orientację strumienia stream (na szerokoznakową, gdy mode jest większe od 0, lub na bajtową, gdy mode jest mniejsze od 0). Następnie zwraca wartość określającą bieżącą orientację, jak opisano powyżej.

WARTOŚĆ ZWRACANA

Funkcja fwide() zwraca orientację strumienia, po jej ewentualnej zamianie. Zwrócenie wartości dodatniej oznacza orientację szerokoznakową. Zwrócenie wartości ujemnej oznacza orientację bajtową. Zwrócenie wartości zero oznacza orientację nieokreśloną.

STANDARDY

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

UWAGI

Zapisanie szerokich znaków do strumienia zorientowanego bajtowo może zostać wykonane za pomocą funkcji fprintf(3) przy użyciu dyrektyw %lc oraz %ls.

Zapisanie znaków typu char do strumienia zorientowanego szerokoznakowo może być wykonane za pomocą funkcji fwprintf(3) przy użyciu dyrektyw %c oraz %s.

ZOBACZ TAKŻE

fprintf(3), fwprintf(3)

TŁUMACZENIE

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Andrzej Krzysztofowicz <ankry AT green DOT mf DOT pg DOT gda DOT pl>, Robert Luberda <robert AT debian DOT org> i Michał Kułach <michal DOT kulach AT gmail DOT com>

Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI.

Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-list.