mbs字符串（char*）与Unicode字符串（wchar_t*）的转换.md

一、C语言库函数

（1）setlocale()

功能：配置地域化信息；在输出Unicode字符串时会用到，在使用wcstombs函数时也会用到。下面英文描述中的用粗体字标出的函数都会用到该函数
头文件：< locale.h>；
函数原型：

char *setlocale (int category, const char * locale);

函数参数：

• category 表示对本地化的某项内容进行设置，可取如下值：

  • LC_ALL 包括下面的全部选项都要；
  • LC_COLLATE 配置字符串比较；
    The strcoll, _stricoll, wcscoll, _wcsicoll, strxfrm, _strncoll, _strnicoll, _wcsncoll, _wcsnicoll, and wcsxfrm functions.
  • C_CTYPE 配置字符类别及转换，例如全变大写 strtoupper()；
    The character-handling functions (except isdigit, isxdigit, mbstowcs, and mbtowc, which are unaffected).
  • LC_MONETARY 配置金融货币；
    Monetary-formatting information returned by the localeconv function.
  • LC_NUMERIC 配置小数点后的位数；
    Decimal-point character for the formatted output routines (such as printf), for the data-conversion routines, and for the non-monetary formatting information returned by localeconv. In addition to the decimal-point character, LC_NUMERIC also sets the thousands separator and the grouping control string returned by localeconv.
  • LC_TIME 配置时间日期格式，与 strftime() 合用。
    The strftime and wcsftime functions.

• locale 表示本地域代号：
  如果为NULL，则返回当前的locale名称（一般为C）；如果非空，则根据category和locale进行设置，如果成功，则返回新的locale名称（地域名称），如果失败，则返回 NULL。

注意：可能刚开始对category参数有些不理解，category参数是指定全局变量locale会影响到的范围，也就是说如果我指定了LC_COLLATE参数，那么该函数的set只在字符串比较时会起作用

代码示例：

int main(){   wchar_t wstr[] = L"Hello 中国";   //locale传 "" 空字符串用来返回当前环境的local名   char* LocaleName = setlocale(LC_ALL, "");   //locale传 "chs" 表示设置locale为简体中文   setlocale(LC_ALL, "chs");   //输出"Hello 中国"，如果没有setlocale配置区域信息的话wprintf是无法正常输出中文字符的   wprintf(wstr);    //将区域信息设置回初始值   if (0 == setlocale(LC_ALL, LocaleName))   {       printf("配置出错\r\n");       return 0;   }   return 0;}

（2）wcstombs()

功能：将宽字符编码字符串转换成多字节编码字符串
头文件： < stdlib.h>
函数原型：

//普通版本size_t wcstombs(   char *mbstr,   const wchar_t *wcstr,   size_t count);//安全版本errno_t  wcstombs_s(   size_t * _PtNumOfCharConverted,    char * _Dst,    size_t _DstSizeInBytes,    const wchar_t * _Src,    size_t _MaxCountInBytes);//带区域设置的安全版本errno_t _wcstombs_s_l(   size_t *pReturnValue,   char *mbstr,   size_t sizeInBytes,   const wchar_t *wcstr,   size_t count,   _locale_t locale);

函数参数
_PtNumOfCharConverted：指向转换后的字符串的长度加上结束符（单位字节）；
_Dst：指向转换后的字符串首地址；
_DstSizeInBytes：目的地址最大字节空间（单位字节）；
_Src：源宽字符串首地址；
_MaxCountInBytes：最多可存入多字节字符串缓冲最的字节数，用于裁剪转换后的字符串。
返回值：成功返回0， 失败则返回失败代码。

代码示例:
没有写，和mbstowcs的差不多，写在下面了。

（3）mbstowcs()

函数功能：将多字节编码字符串转换成宽字符编码字符串
头文件：< stdlib.h>
函数原型：

//普通版本size_t mbstowcs(   wchar_t *wcstr,   const char *mbstr,   size_t count);//安全版本errno_t __cdecl mbstowcs_s(   size_t * _PtNumOfCharConverted,    wchar_t * _DstBuf,    size_t _SizeInWords,    const char * _SrcBuf,    size_t _MaxCount );//带区域参数的安全版本errno_t _mbstowcs_s_l(   size_t *pReturnValue,   wchar_t *wcstr,   size_t sizeInWords,   const char *mbstr,   size_t count,   _locale_t locale);

参数说明：
_PtNumOfCharConverted：指向转换后的字符串的长度加上结束符（单位wchar_t），；
_DstBuf：指向转换后的字符串首地址；
_SizeInWords：目的地址最大字空间大小（单位wchar_t）；
_SrcBuf：源多字节字符串首地址；
_MaxCount：最多可存入宽字符串缓冲中的字符个数，用于裁剪转换后的宽字符串。

返回值：成功返回0， 失败则返回失败代码。

代码示例

• 普通版本

  int main(){char str[] = "Hello 中国";//直接把宽度sizeof(str) * 2是有些内存资源浪费的，但也只能这样了，MultiByteToWideChar是可以直接计算缓冲区大小的wchar_t wstr[sizeof(str) * 2];//使用mbstowcs转换字符串mbstowcs(wstr,str,sizeof(str));//这里使用C++中的输出方式输出wcout.imbue(locale("chs"));wcout << wstr << endl;return 0;}

• 安全版本

  int main(){size_t convertedChars = 0;char str[] = "Hello 中国";//直接把宽度sizeof(str) * 2是有些内存资源浪费的，但也只能这样了wchar_t wstr[sizeof(str) * 2];//设置区域信息为简体中文setlocale(LC_ALL, "chs");//使用mbstowcs转换字符串mbstowcs_s(&convertedChars, wstr, str, sizeof(str));//convertedChars是_Out参数，用于记录转换成功的字符//这里使用C++中的输出方式输出wcout.imbue(locale("chs"));wcout << wstr << endl;return 0;}

• 带区域参数的安全版本

  int main(){size_t convertedChars = 0;char str[] = "Hello 中国";//直接把宽度sizeof(str) * 2是有些内存资源浪费的，但也只能这样了wchar_t wstr[sizeof(str) * 2];//使用_mbstowcs_s_l转换字符串_mbstowcs_s_l(&convertedChars, wstr, sizeof(str)*2, str, sizeof(str), _create_locale(LC_ALL,"chs"));//convertedChars是_Out参数，用于记录转换成功的字符//这里使用C++中的输出方式输出wcout.imbue(locale("chs"));wcout << wstr << endl;return 0;}

二、Windows函数

（1）WideCharToMultiByte()

函数功能：将宽字符串转换成多字节字符串
头文件：< windows.h>
函数原型：

int WINAPI WideCharToMultiByte(    _In_ UINT CodePage,    _In_ DWORD dwFlags,    _In_NLS_string_(cchWideChar) LPCWCH lpWideCharStr,    _In_ int cchWideChar,    _Out_writes_bytes_to_opt_(cbMultiByte, return) LPSTR lpMultiByteStr,    _In_ int cbMultiByte,    _In_opt_ LPCCH lpDefaultChar,    _Out_opt_ LPBOOL lpUsedDefaultChar);

参数详解：

• CodePage：指定执行转换的代码页字符集，可以为操作系统已安装或有效的任何代码页字符集，也可以指定其为下面的任意一值：
  CP_ACP：ANSI代码页；
  CP_MACCP：Macintosh代码页；
  CP_OEMCP：OEM代码页；
  CP_SYMBOL：符号代码页；
  CP_THREAD_ACP：当前线程ANSI代码页；
  CP_UTF7：使用UTF-7转换；
  CP_UTF8：使用UTF-8转换。
  使用最多的就是CP_ACP和CP_UTF8；
• dwFlags：指定如何处理没有转换成功的字符，也可以不设此参数（设置为0），函数会运行的更快一些。对于UTF-8，dwflags必须为0或者WC_ERR_INVALID_CHARS,否则函数都将失败返回并设置错误码ERROR_INVALID_FLAGS，可以调用GetLastError获得；
• lpWideCharStr：待转换为宽字符串；
• cchWideChar：待转换的宽字符串的长度（字符个数），-1表示转换到字符串结尾；
• lpMultiByteStr：转换后目的字符串缓冲区；
• cbMultiByte：目的字符串缓冲区大小（单位字节）。如果设置为0，函数将返回所需缓冲区大小而忽略lpMultiByteStr；
• lpDefaultChar：指向字符的指针，在指定编码里找不到相应字符时使用此字符作为默认字符替代。如果为NULL，则使用系统默认字符。使用dwFlags时不能使用此参数，否则报ERROR_INVLID_PARAMETER错误。
• lpUsedDefaultChar：开关变量的指针，表明是否使用过默认字符。对于要求此参数为NULL的dwflags而使用此参数，函数将失败返回，并设置错误码ERROR_INVLID_PARAMETER。lpDefaultChar和lpUsedDefaultChar都设为NULL，函数会更快一些。

函数返回值：如果函数运行成功，并且cbMultiByte不为零，返回值是由 lpMultiByteStr指向的缓冲区中写入的字节数；如果函数运行成功，并且cbMultiByte为零，返回值是接存放目的字符串缓冲区所必需的字节数。如果函数运行失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。

代码示例：将wstr中的字符转换为多字符集字符存储到缓冲字符串str中

    WCHAR* wstr = L"Hollo 中国";    char* str = NULL;    //计算所需缓冲区大小，参数四-1表示转换到字符串尾，参数六NULL表示计算并返回缓冲区大小，最后两个参数传NULL即可    int lpMultiByteStr = WideCharToMultiByte(CP_ACP, NULL, wstr, -1,str,NULL,NULL,NULL);    //动态申请缓冲区内存    str = new char[lpMultiByteStr];    //将转换后的字符串写进缓冲区，最后两个参数传NULL即可    WideCharToMultiByte(CP_ACP, NULL, wstr, -1, str, lpMultiByteStr, NULL, NULL);    //输出测试    setlocale(LC_ALL, str);    cout << str << endl;    //释放缓冲区内存空间    delete[] str;    str = NULL;

（2）MultiByteToWideChar()

函数功能：多字节字符串到款字节字符串的转换；
头文件：< windows.h>
函数原型：

int WINAPI MultiByteToWideChar(    _In_ UINT CodePage,    _In_ DWORD dwFlags,    _In_NLS_string_(cbMultiByte) LPCCH lpMultiByteStr,    _In_ int cbMultiByte,    _Out_writes_to_opt_(cchWideChar, return) LPWSTR lpWideCharStr,    _In_ int cchWideChar);

参数详解：
- CodePage：同上；
- dwFlags：指定是否转换成预制字符或合成的宽字符，是否使用象形文字替代控制字符，以及如何处理无效字符。对于UTF-8，dwflags必须为0或者WC_ERR_INVALID_CHARS,否则函数都将失败返回并设置错误码ERROR_INVALID_FLAGS，可以调用GetLastError获得；
- lpMultiByteStr：多字节字符串；
- cbMultiByte：待转换的多字节字符串长度，-1表示转换到字符串结尾；
- lpWideCharStr：存放转换后的宽字符串缓冲；
- cchWideChar：宽字符串缓冲的大小（单位字符数）。

返回值：如果函数运行成功，并且cchWideChar不为零，返回值是由 lpWideCharStr指向的缓冲区中写入的字符数；如果函数运行成功，并且cchWideChar为零，返回值是接存放目的字符串缓冲区所必需的字符数。如果函数运行失败，返回值为零。若想获得更多错误信息，请调用GetLastError函数。

代码示例：将str中的字符转换为多字符集字符存储到缓冲字符串wstr中

    char str[] = "Hollo 中国";    WCHAR* wstr = NULL;    //计算所需缓冲区大小，参数四-1表示转换到字符串尾，参数六NULL表示计算并返回缓冲区大小    int lpMultiByteStr = MultiByteToWideChar(CP_ACP,NULL,str,-1,wstr,NULL);    //动态申请缓冲区内存    wstr = new wchar_t[lpMultiByteStr];    //将转换后的字符串写进缓冲区    MultiByteToWideChar(CP_ACP, NULL, str, -1, wstr, lpMultiByteStr);    //输出测试    _wsetlocale(LC_ALL, L"chs"); //简体中文的locale名称为："chs"简体中文的locale名称为："chs"    wprintf(wstr);    //释放缓冲区内存空间    delete[] wstr;    wstr = NULL;

参考资料
Dablelv的博客
http://blog.csdn.net/k346k346/article/details/50082705
白永辉的专栏
http://blog.csdn.net/xiaobai1593/article/details/7387889
感谢博主的好文！