《Windows API巡礼》之MultiByteToWideChar函数和WideCharToMultiByte函数

我们一般使用Windows函数MultiByteToWideChar将多字节字符串转换为宽字符字符串，函数原型如下：

int MultiByteToWideChar( __in UINT CodePage, //与多字节字符串关联的一个代码页值，一般设为CP_ACP __in DWORD dwFlags, //指定额外的转换控制，一般为0 __in LPCSTR lpMultiByteStr, //要转换的多字节字符串 __in int cbMultiByte, //多字节字符串字节数，为-1则自动判断字符串长度 __out LPWSTR lpWideCharStr, //转换后Unicode字符串的缓冲区 __in int cchWideChar //接收缓冲区最大长度（字符数） );

一般按下面步骤将一个多字节字符串转换为Unicode形式：

1）调用MultiByteToWideChar，为lpWideCharStr传入NULL，为cchWideChar传入0，为cbMultiByte传入-1；

2）分配一块足以容纳转换后的Unicode字符串的内存，它的大小是1）中函数返回值乘以sizeof(wchar_t)；

3）再次调用MultiByteToWideChar，这次将缓冲区地址作为lpWideCharStr参数的值传入，将1）中函数返回值乘以sizeof(w_char_t)后得到的大小作为cchWideChar参数的值传入；

4）使用转换后的字符串；

5）释放Unicode字符串占用的内存块。

 

下面是我们封装的多字节字符串转Unicode字符串的函数：

/****************************************************** *function: convert multibyte character set to wide-character set *param: pwStr--[out] Points to a buffer that receives the translated buffers. * pStr--[in] Points to the multibyte character set(or string) to be converted. * len --[in] Specify the size in bytes of the string pointed to by the pStr * parameter, or it can be -1 if the string is null terminated. * IsEnd--[in]Specify whether you add '/0' to the end of converted array or not. *return: the length of converted set (or string ) *******************************************************/ int ToWideString( WCHAR* &pwStr, const char* pStr, int len, BOOL IsEnd) { ASSERT_POINTER(pStr, char); ASSERT(len >= 0 || len == -1); int nWideLen = MultiByteToWideChar(CP_ACP, 0, pStr, len, NULL, 0); if (len == -1) { --nWideLen; } if (nWideLen == 0) { return 0; } if (IsEnd) { pwStr = new WCHAR[(nWideLen+1)*sizeof(WCHAR)]; ZeroMemory(pwStr, (nWideLen+1)*sizeof(WCHAR)); } else { pwStr = new WCHAR[nWideLen*sizeof(WCHAR)]; ZeroMemory(pwStr, nWideLen*sizeof(WCHAR)); } MultiByteToWideChar(CP_ACP, 0, pStr, len, pwStr, nWideLen); return nWideLen; }

---

相应的，我们使用WideCharToMultiByte函数将宽字符字符串转换为多字节字符串，函数原型如下：

int WideCharToMultiByte( __in UINT CodePage, //标识要与新转换的字符串关联的代码页 __in DWORD dwFlags, //指定额外的转换控制，一般设为0 __in LPCWSTR lpWideCharStr, //要转换的字符串的内存地址 __in int cchWideChar, //上面字符串的长度（字符数），传-1则有函数判断字符串长度 __out LPSTR lpMultiByteStr, //转换后得到多字节字符串的缓冲区 __in int cbMultiByte, //上面缓冲区最大值（字节数），传0则导致该函数返回目标缓冲区需要的大小，且返回值直接就是转换成功后所需的字节数，无需乘以sizeof… __in LPCSTR lpDefaultChar, //遇到不能转换的宽字符时，函数使用该参数指定的字符，为NULL时，函数使用系统默认的一个字符 __out LPBOOL lpUsedDefaultChar //在宽字符字符串中，如果至少有一个字符不能转换为对应的多字节形式，函数将这个值设为TRUE，我们通常传入NULL );

下面是我们封装的将多字节字符串转换为宽字符字符串的函数：

/****************************************************** *function: convert wide-character set to multibyte character set *param: pStr--[in] Points to a buffer that receives the translated buffer. * pwStr--[out] Points to the wide character set ( or string ) to be converted. * len --[in] Specify the size in bytes of the string pointed to by the pwStr * parameter, or it can be -1 if the string is null terminated. * IsEnd--[in]Specify whether you add '/0' to the end of converted array or not. *return: the length of converted set (or string ) *******************************************************/ int ToMultiBytes( char* &pStr, const WCHAR* pwStr, int len, BOOL IsEnd) { ASSERT_POINTER(pwStr, WCHAR) ; ASSERT( len >= 0 || len == -1 ) ; int nChars = WideCharToMultiByte(CP_ACP, 0, pwStr, len, NULL, 0, NULL, NULL); if (len == -1) { --nChars; } if (nChars == 0) { return 0; } if(IsEnd) { pStr = new char[nChars+1]; ZeroMemory(pStr, nChars+1); } else { pStr = new char[nChars]; ZeroMemory(pStr, nChars); } WideCharToMultiByte(CP_ACP, 0, pwStr, len, pStr, nChars, NULL, NULL); return nChars; }

上面两个封装的函数使用示例如下：

1）

 

 

 

char *pStr = "ASCE1885"; WCHAR *pwStr; int nWideLen = ToWideString(pwStr, pStr, -1, TRUE);

2）

WCHAR *pwStr = _T("ASCE1885"); char *pStr; int nWideLen = ToMultiBytes(pStr, pwStr, -1, TRUE);

参考文献：

《Windows via C/C++》

http://www.codeproject.com/Tips/128870/Useful-function-for-conversion-between-MBCS-and-WC.aspx