NAZWA

       btowc - przekształca znak jednobajtowy na znak szeroki

SKŁADNIA

       #include <wchar.h>

       wint_t btowc(int c);

OPIS

       Funkcja  btowc()  przekształca  c,  interpretowane  jako  wielobajtowy  ciąg  o  długości 1, zaczynając w
       początkowym stanie przesunięcia, na znak wielobajtowy i zwraca ten znak. Jeśli c jest równe EOF  lub  nie
       jest poprawnym ciągiem wielobajtowym o długości 1, to funkcja btowc() zwraca WEOF.

WARTOŚĆ ZWRACANA

       Funkcja  btowc()  zwraca  szeroki znak będący wynikiem przekształcenia pojedynczego bajtu c. Jeśli c jest
       równe EOF lub nie jest poprawnym ciągiem wielobajtowym o długości 1, to funkcja zwraca WEOF.

ATRYBUTY

       Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7).

       ┌──────────┬────────────────────────┬─────────┐
       │Interfejs │ Atrybut                │ Wartość │
       ├──────────┼────────────────────────┼─────────┤
       │btowc()   │ Bezpieczeństwo wątkowe │ MT-Safe │
       └──────────┴────────────────────────┴─────────┘

ZGODNE Z

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

UWAGI

       Zachowanie btowc() zależy od kategorii LC_CTYPE bieżących ustawień regionalnych.

       Tej funkcji nie należy nigdy używać. Nie działa ona dla kodowań  mających  stan,  a  także  niepotrzebnie
       traktuje  pojedyncze  bajty inaczej niż ciągi wielobajtowe. Zamiast niej, należy korzystać albo z funkcji
       mbtowc(3), albo z  bezpiecznej dla wątków funkcji mbrtowc(3).

ZOBACZ TAKŻE

       mbrtowc(3), mbtowc(3), wctob(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.