Provided by:
manpages-pl-dev_20060617-3_all 
NAZWA
wcrtomb - konwertuje szerokie znaki na sekwencje wielobajtowe
SK/LADNIA
#include <wchar.h>
size_t wcrtomb(char *s, wchar_t wc, mbstate_t *ps);
OPIS
Podstawowym zastosowaniem tej funkcji jest to, gdy s nie jest NULL i wc
nie jest L'\0'. W tym przypadku, funkcja ta konwertuje szeroki znak wc
na jego wielobajtow reprezentacj i zachowuje j na pocztku tablicy
znakowej, wskazywanej przez s. Aktualizuje stan przesunicia *ps i
zwraca dlugo reprezentacji wielobajtowej, tj. ilo bitow zapisanych do
s.
Innym przypadkiem jest sytuacja, gdy s rownie nie jest NULL, lecz wc
jest L'\0'. W tym przypadku, funkcja ta zachowuje w s sekwencj
przesunicia, wymagan do przeniesienia *ps z powrotem do stanu
pocztkowego. Za sekwencj doklejony bdzie bajt '\0'. Aktualizuje stan
przesunicia *ps (tj. przenosi go do stanu pocztkowego) i zwraca dlugo
sekwencji przesunicia plus jeden, tj. liczb bajtow zapisanych do s.
Trzecim przypadkiem jest gdy s jest NULL. W tym przypadku, wc jest
ignorowane, a funkcja zwraca wcrtomb(buf,L'\0',ps), gdzie buf jest
wewntrznym anonimowym buforem.
We wszystkich powyszych przypadkach, jeli ps jest wskanikiem NULL, w
jego miejscu uywany jest anonimowy stan, znany tylko funkcji wcrtomb.
WARTO ZWRACANA
Funkcja wcrtomb zwraca liczb bajtow, ktore zostaly (lub zostalyby)
zapisane do tablicy bajtowej s. Jeli wc nie moe by reprezentowane w
sekwencji wielobajtowej (wedlug obecnych locale), zwracane jest
(size_t)(-1) i errno jest ustawiane na EILSEQ.
ZGODNE Z
ISO/ANSI C, UNIX98
ZOBACZ TAKE
wcsrtombs(3)
UWAGI
Zachowanie tej funkcji zaley od kategorii LC_CTYPE aktualnych ustawie
locale.
Podawanie NULL jako ps nie jest bezpieczne w trybie wielowtkowym.
INFORMACJE O T/LUMACZENIU
Powysze tlumaczenie pochodzi z nieistniejcego ju Projektu Tlumaczenia
Manuali i moe nie by aktualne. W razie zauwaenia ronic midzy powyszym
opisem a rzeczywistym zachowaniem opisywanego programu lub funkcji,
prosimy o zapoznanie si z oryginaln (angielsk) wersj strony podrcznika.