mbtowc

将由 s 指向首字节的多字节字符转换为宽字符，若 pwc 非空则写入 * pwc 。

如果 s 是空指针，则重置全局转换状态并确定是否使用移位序列。

注释

每次调用 mbtowc 都会更新其内部全局转换状态（一个仅该函数可知的 mbstate_t 类型静态对象）。若多字节编码使用移位状态，必须注意避免回溯或多次扫描。在任何情况下，多线程调用 mbtowc 时需进行同步：可改用 mbrtowc 函数。

参数

返回值

如果 s 不是空指针，则返回该多字节字符包含的字节数；如果 s 指向的首字节不构成有效的多字节字符，则返回 - 1 ；如果 s 指向空字符 ' \0 ' ，则返回 ​ 0 ​ 。

如果 s 是空指针，则重置其内部转换状态以表示初始移位状态，并在当前多字节编码不依赖状态（不使用移位序列）时返回 ​ 0 ​ ，或者当当前多字节编码依赖状态（使用移位序列）时返回非零值。

示例

#include <locale.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <wchar.h>
// 将多字节字符串打印至宽字符标准输出
// 等效于 wprintf(L"%s\n", ptr);
void print_mb(const char* ptr)
{
    mbtowc(NULL, NULL, 0); // 重置转换状态
    const char* end = ptr + strlen(ptr);
    int ret = 0;
    for (wchar_t wc; (ret = mbtowc(&wc, ptr, end - ptr)) > 0; ptr += ret)
        wprintf(L"%lc", wc);
    wprintf(L"\n");
}
int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 窄多字节编码
    print_mb("z\u00df\u6c34\U0001F34C"); // 或 "zß水🍌"
}

zß水🍌

参考文献

参见