C++使用WideCharToMultiByte函数生成UTF-8编码文件的方法
WideCharToMultiByte函数映射一个unicode字符串到一个多字节字符串。
函数原型:
intWideCharToMultiByte
- UINTCodePage,//指定执行转换的代码页
- DWORDdwFlags,//允许你进行额外的控制,它会影响使用了读音符号(比如重音)的字符
- LPCWSTRlpWideCharStr,//指定要转换为宽字节字符串的缓冲区
- intcchWideChar,//指定由参数lpWideCharStr指向的缓冲区的字符个数
- LPSTRlpMultiByteStr,//指向接收被转换字符串的缓冲区
- intcchMultiByte,//指定由参数lpMultiByteStr指向的缓冲区最大值
- LPCSTRlpDefaultChar,//遇到一个不能转换的宽字符,函数便会使用pDefaultChar参数指向的字符
- LPBOOLpfUsedDefaultChar//至少有一个字符不能转换为其多字节形式,函数就会把这个变量设为TRUE
参数:
CodePage:指定执行转换的代码页,这个参数可以为系统已安装或有效的任何代码页所给定的值。你也可以指定其为下面的任意一值:
- CP_ACP:ANSI代码页;CP_MACCP:Macintosh代码页;CP_OEMCP:OEM代码页;
- CP_SYMBOL:符号代码页(42);CP_THREAD_ACP:当前线程ANSI代码页;
- CP_UTF7:使用UTF-7转换;CP_UTF8:使用UTF-8转换。
相关变量
- lpWideCharStr:指向将被转换的unicode字符串。
- cchWideChar:指定由参数lpWideCharStr指向的缓冲区的字符个数。如果这个值为-1,字符串将被设定为以NULL为结束符的字符串,并且自动计算长度。
- lpMultiByteStr:指向接收被转换字符串的缓冲区。
- cchMultiByte:指定由参数lpMultiByteStr指向的缓冲区最大值(用字节来计量)。若此值为零,函数返回lpMultiByteStr指向的目标缓冲区所必需的字节数,在这种情况下,lpMultiByteStr参数通常为NULL。
- lpDefaultChar和pfUsedDefaultChar:只有当WideCharToMultiByte函数遇到一个宽字节字符,而该字符在uCodePage参数标识的代码页中并没有它的表示法时,WideCharToMultiByte函数才使用这两个参数。如果宽字节字符不能被转换,该函数便使用lpDefaultChar参数指向的字符。如果该参数是NULL(这是大多数情况下的参数值),那么该函数使用系统的默认字符。该默认字符通常是个问号。这对于文件名来说是危险的,因为问号是个通配符。pfUsedDefaultChar参数指向一个布尔变量,如果Unicode字符串中至少有一个字符不能转换成等价多字节字符,那么函数就将该变量置为TRUE。如果所有字符均被成功地转换,那么该函数就将该变量置为FALSE。当函数返回以便检查宽字节字符串是否被成功地转换后,可以测试该变量。
- 返回值:如果函数运行成功,并且cchMultiByte不为零,返回值是由lpMultiByteStr指向的缓冲区中写入的字节数;如果函数运行成功,并且cchMultiByte为零,返回值是接收到待转换字符串的缓冲区所必需的字节数。如果函数运行失败,返回值为零。若想获得更多错误信息,请调用GetLastError函数。它可以返回下面所列错误代码:
- ERROR_INSUFFICIENT_BJFFER;ERROR_INVALID_FLAGS;
- ERROR_INVALID_PARAMETER;ERROR_NO_UNICODE_TRANSLATION。
- 注意:指针lpMultiByteStr和lpWideCharStr必须不一样。如果一样,函数将失败,GetLastError将返回ERROR_INVALID_PARAMETER的值。
- WindowsCE:不支持参数CodePage中的CP_UTF7和CP_UTF8的值,以及参数dwFlags中的WC_NO_BEST_FIT_CHARS值。
生成utf-8编码的文件
步骤如下:
1.首先要写一个BOM头。UTF-8文件一般是要这个头的,当然也可以没有。
2.将要生成的字符先使用宽字符格式生成,然后调用WideCharToMultiByte转为utf-8编码,写入文件。
例子如下:
FILE*pFile=fopen("d://a.txt","w"); charszBOM[4]={(char)0xEF,(char)0xBB,(char)0xBF,0}; fprintf(pFile,"%s",szBOM); wchar_tchNum[11]=L"零壹贰叁肆伍陆柒捌玖"; wchar_tchNum2[10]=L"亿千百拾万千百拾个"; charsz[10]="112304823"; wchar_tresult[32]=L""; intoffset=0; for(inti=0;i<strlen(sz);++i) { charc=sz[i]; wchar_tw1=chNum[c-'0']; wchar_tw2=chNum2[i]; swprintf(result+offset,L"%c%c",w1,w2); offset+=2; } charszChar[64]=""; ::WideCharToMultiByte(CP_UTF8,0,result,wcslen(result),szChar,64,0,0); fprintf(pFile,"%s",szChar); fclose(pFile);
注意的是,当使用wchar_t而不再是char时,所有的字符串操作函数都需要时w系列的,例如wcslen、swprintf