C中的mbtowc函数

简介

mbtowc是一个用于将多字节字符转换成宽字符的C函数。它的原型如下：

#include <stdlib.h>
int mbtowc(wchar_t * __restrict__ pwc, const char * __restrict__ s, size_t n);

• 第一个参数指向要存储转换后结果的宽字符的指针；
• 第二个参数指向要转换的多字节字符的地址；
• 第三个参数指示要在第二个参数中转换的最多字节数。

其返回值为成功转换的字符数，如果无法转换或者遇到了无效的多字节字符，将返回-1。

需要注意的是，这个函数需要依赖本地的区域设置（locale），因为不同的字符编码和本地化环境会影响字符的表示和转换。

用法示例

以下是一个简单的示例，演示如何使用mbtowc函数将GB2312编码的字符转换成宽字符：

#include <locale.h>
#include <stdlib.h>
#include <stdio.h>
#include <wchar.h>

int main() {
    setlocale(LC_ALL, "zh_CN.gb2312");
    char gb_string[] = "中文字符";
    wchar_t wc_buf[128] = {0};
    int n = mbtowc(wc_buf, gb_string, sizeof(gb_string));
    if (n == -1) {
        fputs("无效的多字节字符序列\n", stderr);
        exit(EXIT_FAILURE);
    }
    wprintf(L"转换结果为：%ls\n", wc_buf);
    return 0;
}

参考资料

• mbtowc - cppreference.com