NAZWA

       fwide - ustawienie i określenie orientacji strumienia FILE

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

       Gdy  mode  jest  zerem,  funkcja  fwide()  podaje  bieżącą  orientację  strumienia stream. Zwraca wartość
       dodatnią, gdy stream jest zorientowany szerokoznakowo, tzn. gdy  wejście/wyjście  szerokich  znaków  jest
       dozwolone,  a  wejście/wyjście dla znaków typu char nie jest dozwolone. Wartość ujemna jest zwracana, gdy
       stream jest zorientowany bajtowo, tzn. gdy  wejście/wyjście  dla  znaków  typu  char  jest  dozwolone,  a
       wejście/wyjście  dla  szerokich znaków nie jest dozwolone. Zero jest zwracane, gdy strumień stream nie ma
       jeszcze orienatcji; w tym  przypadku  następna  operacja  wejścia/wyjścia  może  zmienić  orientację  (na
       bajtową,  jeśli  będzie to operacja wejścia/wyjścia znaków typu char, lub na szerokoznakową, jeśli będzie
       to operacja wejścia/wyjścia szerokich znaków).

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

ZGODNE Z

       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)

O STRONIE

       Angielska  wersja  tej strony pochodzi z wydania 4.07 projektu Linux man-pages. Opis projektu, informacje
       dotyczące  zgłaszania   błędów,   oraz   najnowszą   wersję   oryginału   można   znaleźć   pod   adresem
       https://www.kernel.org/doc/man-pages/.

TŁUMACZENIE

       Autorami  polskiego  tłumaczenia  niniejszej  strony  podręcznika  man  są:  Andrzej Krzysztofowicz (PTM)
       <ankry@mif.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>.

       Polskie tłumaczenie jest częścią  projektu  manpages-pl;  uwagi,  pomoc,  zgłaszanie  błędów  na  stronie
       http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją  4.07 oryginału.

GNU                                                2016-03-15                                           FWIDE(3)