Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
mbtowc(3)
Edit
PageHistory
Diff
Info
LikePages
MBTOWC !!!MBTOWC NAME SYNOPSIS DESCRIPTION RETURN VALUE CONFORMING TO SEE ALSO NOTES ---- !!NAME mbtowc - convert a multibyte sequence to a wide character !!SYNOPSIS __#include __''pwc''__, const char *__''s''__, size_t__ ''n''__); __ !!DESCRIPTION The main case for this function is when ''s'' is not NULL and ''pwc'' is not NULL. In this case, the __mbtowc__ function inspects at most ''n'' bytes of the multibyte string starting at ''s'', extracts the next complete multibyte character, converts it to a wide character and stores it at ''*pwc''. It updates an internal shift state only known to the mbtowc function. If ''s'' does not point to a '0' byte, it returns the number of bytes that were consumed from ''s'', otherwise it returns 0. If the ''n'' bytes starting at ''s'' do not contain a complete multibyte character, or if they contain an invalid multibyte sequence, __mbtowc__ returns ''-1''. This can happen even if ''n'' ''MB_CUR_MAX'', if the multibyte string contains redundant shift sequences. A different case is when ''s'' is not NULL but ''pwc'' is NULL. In this case the __mbtowc__ function behaves as above, excepts that it does not store the converted wide character in memory. A third case is when ''s'' is NULL. In this case, ''pwc'' and ''n'' are ignored. The __mbtowc__ function resets the shift state, only known to this function, to the initial state, and returns non-zero if the encoding has non-trivial shift state, or zero if the encoding is stateless. !!RETURN VALUE If ''s'' is not NULL, the __mbtowc__ function returns the number of consumed bytes starting at ''s'', or 0 if ''s'' points to a null byte, or -1 upon failure. If ''s'' is NULL, the __mbtowc__ function returns non-zero if the encoding has non-trivial shift state, or zero if the encoding is stateless. !!CONFORMING TO ISO/ANSI C, UNIX98 !!SEE ALSO mbrtowc(3), mbstowcs(3), MB_CUR_MAX(3) !!NOTES The behaviour of __mbtowc__ depends on the LC_CTYPE category of the current locale. This function is not multi-thread safe. The function __mbrtowc__ provides a better interface to the same functionality. ----
3 pages link to
mbtowc(3)
:
Man3m
MB_CUR_MAX(3)
btowc(3)
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
