C语言MultiByteToWideChar和WideCharToMultiByte案例详解

简介

在C语言中，字符编码的转换是一个基本操作，这通常需要用到 MultiByteToWideChar 和 WideCharToMultiByte 这两个Windows API函数。

MultiByteToWideChar 将ANSI格式的字符串(即单字节字符串)转换为宽字符格式的字符串(即双字节字符串)，WideCharToMultiByte 则将宽字符格式字符串转换为ANSI格式的字符串。

下面，我们将分别通过两个示例来详细讲解这两个函数的使用。

示例一: 将ANSI编码的字符串转换为宽字符格式字符串

#include <windows.h>
#include <stdio.h>

int main(void){

    //定义ANSI格式的字符串
    const char* str = "Hello, world!";

    //ANSI格式字符串对应的 code page, 这里是默认的 ANSI code page
    UINT code_page = CP_ACP;

    //定义宽字符格式的字符串
    wchar_t buffer[100];

    //向宽字符格式字符串中写入数据
    int len = MultiByteToWideChar(code_page, 0, str, -1, buffer, 100);

    wprintf(L"Length of buffer: %d\n", len);

    return 0;
}

代码中，我们以 const char* str = "Hello, world!"; 的形式定义了一个ANSI格式的字符串。

在代码块中，我们首先定义了一个 UINT 类型的变量 code_page，用于指定ANSI字符串对应的code page，这里指定为默认的 ANSI code page。

然后，我们继续定义一个宽字符格式字符串 buffer，大小为100。

最后，我们调用 MultiByteToWideChar 函数将ANSI格式字符串转化为宽字符格式字符串，并将转换后的字符串写入到我们前面定义的 buffer 变量中。

调用 MultiByteToWideChar 函数的语法为：

int MultiByteToWideChar(
    UINT CodePage,        //源字符串的编码格式（codepage）
    DWORD dwFlags,        //转换方式，一般为 0 
    LPCSTR lpMultiByteStr,//源字符串
    int cbMultiByte,      //源字符串长度
    LPWSTR lpWideCharStr, //转换后的字符串输出缓冲区
    int cchWideChar       //转换后的字符串缓冲区大小
);

我们调用此函数时七个参数的具体含义如下：

• CodePage： 源字符串的编码格式，如果是ANSI （即本例中的 str ），则使用 CP_ACP，如果是UTF-8，则使用 CP_UTF8 。
• dwFlags： 转换方式，一般直接设为0即可。
• lpMultiByteStr： 源字符串指针，即前面定义的ANSI格式的字符串。
• cbMultiByte： 源字符串的长度，如果为-1，则表示源字符串直到 NULL 终止符结束。
• lpWideCharStr： 用于存储转换后的宽字符格式字符串的指针，即前面定义的宽字符格式字符串。
• cchWideChar： 转换后的宽字符格式字符串的缓冲区大小，即前面所定义的 buffer 的大小。

最后，我们使用 wprintf(L"Length of buffer: %d\n", len); 打印输出输出缓冲区 buffer 的长度。

示例二：将宽字符格式的字符串转换为ANSI格式字符串

#include <windows.h>
#include <stdio.h>

int main(int argc, char* argv[]){

    //定义宽字符格式的字符串
    const wchar_t* wide_string = L"Hello, world!";

    //字节数组缓冲区
    char buffer[100];

    //ANSI格式字符串对应的 code page, 这里是默认的 ANSI code page
    UINT code_page = CP_ACP;

    //将宽字符格式的字符串转换为 ANSI 格式的字符串
    int len = WideCharToMultiByte(code_page, 0, wide_string, -1, buffer, 100, NULL, NULL);

    printf("Length of buffer: %d\n", len);

    return 0;
}

这里，我们以 const wchar_t* wide_string = L"Hello, world!"; 的形式定义一个宽字符格式的字符串。

我们首先定义一个字节数组缓冲区 buffer，指定其大小为100。

然后，我们依然指定了默认的 ANSI code page 作为 code_page。

最后，我们使用 WideCharToMultiByte 函数将宽字符格式字符串转换为ANSI格式字符串，并将转换后的字符串输出到我们指定的字节数组缓冲区 buffer 中。

调用 WideCharToMultiByte 函数的语法为：

int WideCharToMultiByte(
    UINT CodePage,           //目标字符串的编码格式（codepage）
    DWORD dwFlags,           //转换方式，一般为0即可
    LPCWSTR lpWideCharStr,   //源宽字符格式字符串
    int cchWideChar,         //源宽字符格式字符串长度
    LPSTR lpMultiByteStr,    //转换后的ANSI格式字符串输出缓冲区
    int cbMultiByte,         //转换后的ANSI格式字符串缓冲区大小
    LPCSTR lpDefaultChar,    //用于指定在客户机的字符集中无法表示在目标代码页中的字符情况
    LPBOOL lpUsedDefaultChar //输出参数，用于指示调用过程中 lpMultiByteStr 字符串中是否存在使用 lpDefaultChar 充当方块字符
);

我们调用此函数时的七个参数的具体含义如下：

• CodePage ： 目标字符串的编码格式，如果是ANSI，则使用 CP_ACP，如果是UTF-8，则使用 CP_UTF8 。
• dwFlags ：转换方式，一般直接设为0即可。
• lpWideCharStr ： 源宽字符格式字符串指针，即前面定义的宽字符格式字符串。
• cchWideChar ： 源宽字符格式字符串的长度，如果为-1，则表示源字符串直到 NULL 终止符结束。
• lpMultiByteStr ： 用于存储转换后的ANSI格式字符串的指针，即前面定义的字节数组缓冲区。
• cbMultiByte ： 转换后的ANSI格式字符串的缓冲区大小，即前面我们定义的字节数组缓冲区的大小。
• lpDefaultChar ： 指定在客户机的字符集中无法表示在目标代码页中的字符情况所使用的替代字符，一般使用 NULL 即可，并且不要修改。
• lpUsedDefaultChar ： 用于输出，用于指示调用过程中 lpMultiByteStr 字符串中是否存在使用 lpDefaultChar 充当方块字符，一般使用 NULL 即可，也不要修改。

最后，我们使用 printf("Length of buffer: %d\n", len); 打印输出输出缓冲区 buffer 的长度。

这两个示例中，我们分别介绍了如何将ANSI格式字符串转换为宽字符格式字符串和如何将宽字符格式字符串转换为ANSI格式字符串，这涉及到了C语言中字符编码的转换过程，读者可以按照实际需要对代码进行修改，并根据自己的理解深入了解 MultiByteToWideChar 和 WideCharToMultiByte 函数的使用。