Provided by: manpages-pl-dev_4.23.1-1_all 
NAZWA
mbtowc - przekształca ciąg wielobajtowy na znak szeroki
BIBLIOTEKA
Standardowa biblioteka C (libc, -lc)
SKŁADNIA
#include <stdlib.h> int mbtowc(wchar_t *restrict pwc, const char s[restrict .n], size_t n);
OPIS
Podstawową dla tej funkcji jest sytuacja, gdy s jest różne od NULL i pwc jest różne od NULL. W tym
przypadku, funkcja mbtowc() sprawdza co najwyżej n bajtów ciągu wielobajtowego, zaczynając od s, wydziela
następny pełny znak wielobajtowy, przetwarza go na znak szeroki i umieszcza w *pwc. Aktualizuje
wewnętrzny, znany tylko funkcji mbtowc(), stan przesunięty. Jeśli s nie wskazuje na bajt null ('\0'),
funkcja zwraca liczbę bajtów s, które zostały zużyte; w pozostałych przypadkach zwracane jest 0.
Jeśli n bajtów, zaczynając od s, nie zawiera pełnego znaku wielobajtowego lub jeśli zawierają niepoprawny
ciąg wielobajtowy, mbtowc() zwraca -1. Może się to zdarzyć, nawet gdy n >= MB_CUR_MAX, jeśli wielobajtowy
łańcuch zawiera nadmiarowe ciągi przesunięć.
Inna sytuacja ma miejsce, gdy s jest różne od NULL, ale pwc jest równe NULL. Wówczas funkcja mbtowc()
zachowuje się jak powyżej, z tym wyjątkiem, że nie przechowuje przetworzonego znaku szerokiego w pamięci.
Trzecia sytuacja występuje, gdy s jest równe NULL. Wówczas pwc i n są ignorowane. Funkcja mbtowc()
sprowadza stan przesunięty, znany tylko tej funkcji, do stanu wyjściowego i zwraca wartość różną od zera,
gdy kodowanie zawiera nietrywialne stany przesunięte, lub zero, jeśli kodowanie jest bezstanowe.
WARTOŚĆ ZWRACANA
Jeśli s jest różne od NULL, funkcja mbtowc() zwraca liczbę zużytych bajtów, zaczynając od s; zwraca 0,
jeśli s wskazuje na bajt null lub -1 w przypadku błędu.
Jeśli s jest równe NULL, funkcja mbtowc zwraca wartość różną od zera, gdy kodowanie posiada nietrywialne
stany przesunięte, a zero, gdy kodowanie jest bezstanowe.
ATRYBUTY
Informacje o pojęciach używanych w tym rozdziale można znaleźć w podręczniku attributes(7). ┌───────────────────────────────────────────────────────┬────────────────────────┬───────────────────────┐ │Interfejs │ Atrybut │ Wartość │ ├───────────────────────────────────────────────────────┼────────────────────────┼───────────────────────┤ │mbtowc() │ Bezpieczeństwo wątkowe │ MT-niebezpieczne race │ └───────────────────────────────────────────────────────┴────────────────────────┴───────────────────────┘
WERSJE
Funkcja ta nie jest przystosowana do wielowątkowości. Funkcja mbrtowc(3) zapewnia lepszy interfejs przy tym samym działaniu.
STANDARDY
C11, POSIX.1-2008.
HISTORIA
POSIX.1-2001, C99.
UWAGI
Zachowanie mbtowc() zależy od kategorii LC_CTYPE bieżących ustawień regionalnych.
ZOBACZ TAKŻE
MB_CUR_MAX(3), mblen(3), mbrtowc(3), mbstowcs(3), wcstombs(3), wctomb(3)
TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Andrzej Krzysztofowicz
<ankry@green.mf.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach <michal.kulach@gmail.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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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@lists.sourceforge.net⟩.