在看洛书源码时看见的一个转换字符编码的API

MultiByteToWideChar 是一个在 Windows API 中定义的函数，它用于将一个包含多字节字符（通常是 UTF-8 或者其他编码的字符串）转换为宽字符格式。宽字符通常是指16位或32位的字符，足以表示Unicode字符。

函数原型如下（定义在 Windows.h 头文件中）：

int MultiByteToWideChar(UINT CodePage, DWORD dwFlags, 
                        LPCSTR lpMultiByteStr, int cbMultiByte, 
                        LPWSTR lpWideCharStr, int cchWideChar );

参数解释：

• CodePage: 指定要使用的代码页。代码页定义了多字节字符集的编码方式。例如，CP_UTF8 表示UTF-8编码。
• dwFlags: 指定转换标志。通常设置为0。
• lpMultiByteStr: 指向要转换的多字节字符串的指针。
• cbMultiByte: 多字节字符串中的字节数。如果设置为-1，表示该字符串以null结尾，函数会自动计算长度。
• lpWideCharStr: 指向接收宽字符结果的缓冲区的指针。
• cchWideChar: 缓冲区中可以容纳的宽字符的最大数量，包括null终止符。

返回值：

• 如果函数成功，返回值是转换的宽字符数量，不包括null终止符。
• 如果失败，返回0。可以通过调用 GetLastError 函数来获取错误代码。

例子：

int main() {
    const char* mbstr = "Hello, world!";
    WCHAR wcstr[50];
    int result = MultiByteToWideChar(CP_UTF8, 0, mbstr, -1, wcstr, 50);
    
    if (result > 0) {
        // 转换成功
        wprintf(L"Converted string: %ls\n", wcstr);
    } else {
        // 转换失败
        DWORD error = GetLastError();
        printf("Error converting string: %lu\n", error);
    }
    
    return 0;
}

在这个例子中，我们使用UTF-8编码将一个多字节字符串（mbstr）转换为宽字符字符串（wcstr）。如果转换成功，result 将包含转换的字符数，我们可以使用宽字符版本的 wprintf 来打印转换后的字符串。如果转换失败，我们可以通过 GetLastError 获取错误代码。