| Functions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Wide/multibyte conversions | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
(C95) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Types | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Macros | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Defined in header <wchar.h> | ||
| (since C95) (until C99) | ||
| (since C99) | ||
Determines the size, in bytes, of the representation of a multibyte character.
This function is equivalent to the callmbrtowc(NULL, s, n, ps? ps:&internal) for some hidden objectinternal of typembstate_t, except that the expressionps is evaluated only once.
Contents |
| s | - | pointer to an element of a multibyte character string |
| n | - | limit on the number of bytes in s that can be examined |
| ps | - | pointer to the variable holding the conversion state |
The first of the following that applies:
#include <locale.h>#include <stdio.h>#include <string.h>#include <wchar.h> int main(void){// allow mbrlen() to work with UTF-8 multibyte encodingsetlocale(LC_ALL,"en_US.utf8"); // UTF-8 narrow multibyte encodingconstchar* str="水";size_t sz=strlen(str); mbstate_t mb;memset(&mb,0,sizeof mb);int len1= mbrlen(str,1,&mb);if(len1==-2)printf("The first 1 byte of %s is an incomplete multibyte char"" (mbrlen returns -2)\n", str); int len2= mbrlen(str+1, sz-1,&mb);printf("The remaining %zu bytes of %s hold %d bytes of the multibyte"" character\n", sz-1, str, len2); printf("Attempting to call mbrlen() in the middle of %s while in initial"" shift state returns %zd\n", str, mbrlen(str+1, sz-1,&mb));}
Output:
The first 1 byte of 水 is an incomplete multibyte char (mbrlen returns -2)The remaining 2 bytes of 水 hold 2 bytes of the multibyte characterAttempting to call mbrlen() in the middle of 水 while in initial shift state returns -1
(C95) | converts the next multibyte character to wide character, given state (function)[edit] |
| returns the number of bytes in the next multibyte character (function)[edit] | |
C++ documentation formbrlen | |
