《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