Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
mbrtowc(3)
Edit
PageHistory
Diff
Info
LikePages
MBRTOWC !!!MBRTOWC NAME SYNOPSIS DESCRIPTION RETURN VALUE CONFORMING TO SEE ALSO NOTES ---- !!NAME mbrtowc - convert a multibyte sequence to a wide character !!SYNOPSIS __#include __''pwc''__, const char *__''s''__, size_t__ ''n''__, mbstate_t *__''ps''__); __ !!DESCRIPTION The main case for this function is when ''s'' is not NULL and ''pwc'' is not NULL. In this case, the __mbrtowc__ 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 the shift state ''*ps''. If the converted wide character is not L'0', it returns the number of bytes that were consumed from ''s''. If the converted wide character is L'0', it resets the shift state ''*ps'' to the initial state and returns 0. If the ''n'' bytes starting at ''s'' do not contain a complete multibyte character, __mbrtowc__ returns ''(size_t)(-2)''. This can happen even if ''n'' ''MB_CUR_MAX'', if the multibyte string contains redundant shift sequences. If the multibyte string starting at ''s'' contains an invalid multibyte sequence before the next complete character, __mbrtowc__ returns ''(size_t)(-1)'' and sets __errno__ to __EILSEQ__. In this case, the effects on ''*ps'' are undefined. A different case is when ''s'' is not NULL but ''pwc'' is NULL. In this case the __mbrtowc__ 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 __mbrtowc__ function puts ''*ps'' in the initial state and returns 0. In all of the above cases, if ''ps'' is a NULL pointer, a static anonymous state only known to the mbrtowc function is used instead. !!RETURN VALUE The __mbrtowc__ function returns the number of bytes parsed from the multibyte sequence starting at ''s'', if a non-L'0' wide character was recognized. It returns 0, if a L'0' wide character was recognized. It returns (size_t)(-1) and sets __errno__ to __EILSEQ__, if an invalid multibyte sequence was encountered. It returns (size_t)(-2) if it couldn't parse a complete multibyte character, meaning that ''n'' should be increased. !!CONFORMING TO ISO/ANSI C, UNIX98 !!SEE ALSO mbsrtowcs(3) !!NOTES The behaviour of __mbrtowc__ depends on the LC_CTYPE category of the current locale. ----
3 pages link to
mbrtowc(3)
:
mbtowc(3)
Man3m
mbrlen(3)
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
