WideCharToMultiByte和MultiByteToWideChar函数

http://hi.baidu.com/magicfuzzx/item/e5fd6a954c0a3aae82d29531

//将unicode字符串转换为多字节字符串

int WideCharToMultiByte(

  UINT CodePage, //代码页，一般为CP_ACP

  DWORD dwFlags, //额外标记，一般为0

  LPCWSTR lpWideCharStr, //unicode字符串

  int cchWideChar, //unicode字符串的大小，（-1）为函数自己判断

  LPSTR lpMultiByteStr, //ANSI字符串的缓冲区，必须指定大小

  int cbMultiByte, //ANSI字符串缓冲区的大小（注意为0的意思）

  LPCSTR lpDefaultChar, //一般为NULL，不能转化的时候使用参数改指定的字符

  LPBOOL lpUsedDefaultChar //转换成功为FALSE,失败为TRUE

);

cbMultiByteStr：如果该参数为0的话，那么函数的作用就是返回需要的缓冲区的大小,而前面的lpMutliByteStr参数就可以为NULL（因为已经失去了意义）。

CodePage：要与新转换的字符串关联的代码页。

dwFlags：允许我们指定额外的转换控制，这些标志会影响带变音符号的字符和系统不能转化的字符，但我们一般不需要进行这种程度的转换控制，而直接赋值为0

lpWideCharStr：指向将被转换的unicode字符串。

cchWideChar：指定由参数lpWideCharStr指向的缓冲区的字符个数。如果这个值为-1，字符串将被设定为以NULL为结束符的字符串，并且自动计算长度。

lpMultiByteStr：指向接收被转换字符串的缓冲区。

cchMultiByte：指定由参数lpMultiByteStr指向的缓冲区最大值（用字节来计量）。若此值为零，函数返回lpMultiByteStr指向的目标缓冲区所必需的字节数，在这种情况下，lpMultiByteStr参数通常为NULL。

 

lpDefaultChar和pfUsedDefaultChar：只有当WideCharToMultiByte函数遇到一个宽字节字符，而该字符在uCodePage参数标识的代码页中并没有它的表示法时，WideCharToMultiByte函数才使用这两个参数。如果宽字节字符不能被转换，该函数便使用lpDefaultChar参数指向的字符。如果该参数是NULL（这是大多数情况下的参数值），那么该函数使用系统的默认字符。该默认字符通常是个问号。这对于文件名来说是危险的，因为问号是个通配符。pfUsedDefaultChar参数指向一个布尔变量，如果Unicode字符串中至少有一个字符不能转换成等价多字节字符，那么函数就将该变量置为TRUE。如果所有字符均被成功地转换，那么该函数就将该变量置为FALSE。当函数返回以便检查宽字节字符串是否被成功地转换后，可以测试该变量。这两个参数基本上被设置为NULL。

 

　　返回值：如果函数运行成功，并且cchMultiByte不为零，返回值是由lpMultiByteStr指向的缓冲区中写入的字节数；如果函数运行成功，并且cchMultiByte为零，返回值是接收到待转换字符串的缓冲区所必需的字节数。如果函数运行失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。它可以返回下面所列错误代码：

ERROR_INSUFFICIENT_BJFFER；ERROR_INVALID_FLAGS；

ERROR_INVALID_PARAMETER；ERROR_NO_UNICODE_TRANSLATION。

 

//将多字节字符串转换为uniode字符串

int MultiByteToWideChar(

  UINT CodePage,

  DWORD dwFlags,

  LPCSTR lpMultiByteStr,

  int cbMultiByte,

  LPWSTR lpWideCharStr,

  int cchWideChar

);

参数跟WideCharToMultiByte一致就是少了最后两个参数。

 

使用例子：

LPWSTRlpHello = L"Hello World";

/*获取所需要的缓冲区的大小*/

UINT  nBufferSize;

nBufferSize = WideCharToMultiByte(CP_ACP,0,lpHello,-1,NULL,0,NULL,NULL);

/*申请需要的缓冲区*/

LPSTRlpTarget;

lpTarget = (LPSTR)HeapAlloc(GetProcessHeap(),0,sizeof(char) * nBufferSize);

/*正式转换*/

WideCharToMultiByte(CP_ACP,0,lpHello,-1,lpTarget,nBufferSize,NULL,NULL);

//do something-_-

/*释放所缓冲区*/

HeapFree(GetProcessHeap(),0,lpTarget);

 

//比这样写要好看多了

LPWSTRlpHello = L"Hello World";

CHARszBuf[MAX_PATH];

memset(szBuf,0,sizeof(szBuf));

WideCharToMultiByte(CP_ACP,0,lpHello,(int)wcslen(lpHello),szBuf,sizeof(szBuf),NULL,NULL);

cout<<szBuf<<endl;