MultiByteToWideChar是一种电脑函数程序,该函数映射一个字符串到一个宽字符(unicode)的字符串。由该函数映射的字符串没必要是多字节字符组。
函数功能:该函数映射一个字符串到一个宽字符(unicode)的字符串。由该函数映射的字符串没必要是多
字节字符组。
函数原型:
int MultiByteToWideChar(
UINT CodePage,
DWORD dwFlags,
LPCSTR lpMultiByteStr,
int cchMultiByte,
LPWSTR lpWideCharStr,
int cchWideChar
);
补充:如果ANSI代码页允许在不同的计算机上不相同,甚至在单台计算机上不一样,将会导致数据崩溃。为了代码页一致性,
应用程序应该使用Unicode编码,如UTF-8或者
UTF-16,而不是使用特殊的代码页,除了早期标准或者数据格式化不允许使用Unicode编码。在特殊情况下,有些函数不允许使用Unicode编码,
应用程序应在协议充许的情况下在数据流中用合适的编码名称标识。在HTML、XML、HTTP等文件中都允许标识,但TEXT文本不允许这样做。
参数
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转换。
dwFlags:一组未标记用以指出是否未转换成预作或宽字符(若组合形式存在),是否使用象形文字替代控制字符,以及如何处理无效字符。你可以指定下面是标记
常量的组合,含义如下:
MB_PRECOMPOSED:通常使用预作字符——就是说,由一个基本字符和一个非空字符组成的字符只有一个单一的字符值。这是缺省的转换选择。不能与
MB_COMPOSITE值一起使用。
MB_COMPOSITE:通常使用组合字符——就是说,由一个基本字符和一个非空字符组成的字符分别有不同的字符值。不能与MB_PRECOMPOSED值一起使用。
MB_ERR_INVALID_CHARS:如果函数遇到无效的输入字符,它将运行失败,且GetLastErro返回ERROR_NO_UNICODE_TRANSLATION值。
MB_USEGLYPHCHARS:使用象形文字替代控制字符。
组合字符由一个基础字符和一个非空字符构成,每一个都有不同的字符值。每个预作字符都有单一的字符值给基础/非空字符的组成。在字符è中,e就是基础字符,而重音符标记就是非空字符。
函数的缺省动作是转换成预作的形式。如果预作的形式不存在,函数将尝试转换成组合形式。
标记MB_PRECOMPOSED和MB_COMPOSITE是互斥的,而标记MB_USEGLYPHCHARS和MB_ERR_INVALID_CHARS则不管其它标记如何都可以设置。
lpMultiByteStr:指向将被转换字符串的字符。
cbhMultiByte:指定由参数lpMultiByteStr指向的字符串中
字节的个数。如果lpMultiByteStr指定的字符串以空字符终止,可以设置为-1(如果字符串不是以空字符中止,设置为-1可能失败,可能成功),此参数设置为0函数将失败。
lpWideCharStr:指向接收被转换字符串的缓冲区。
cchWideChar:指定由参数lpWideCharStr指向的缓冲区的宽字符个数。若此值为零,函数返回缓冲区所必需的宽字符数,在这种情况下,lpWideCharStr中的缓冲区不被使用。
如果函数运行成功,并且cchWideChar不为零,返回值是由lpWideCharStr指向的缓冲区中写入的宽字符数;如果函数运行成功,并且cchWideChar为零,返回值是接收到待转换字符串的缓冲区所需求的宽字符数大小。如果函数运行失败,返回值为零。若想获得更多错误信息,请调用GetLastError函数。它可以返回下面所列错误代码:
ERROR_INSUFFICIENT_BUFFER;ERROR_INVALID_FLAGS;
ERROR_INVALID_PARAMETER;ERROR_NO_UNICODE_TRANSLATION。
指针lpMultiByteStr和lpWideCharStr必须不一样。如果一样,函数将失败,GetLastError将返回ERROR_INVALID_PARAMETER的值。
如果MB_ERR_INVALID_CHARS被设置并且在资源字符串中遇到无效的字符时,函数将失败。如果MB_ERR_INVALID_CHARS不被设置,或是DBCS串中发现了头
字节而没有有效的尾字节,无效字符将转换为缺省字符,但不是资源字符串中的缺省字符。当无效字符被发现,且MB_ERR_INVALID_CHARS值被设置,函数返回零,GetLastErro显示ERROR_NO_UNICODE_TRANSLATION的出错信息。
Windows CE:不支持参数CodePage中的CP_UTF7和CP_UTF8的值,以及参数dwFlags中的WC_NO_BEST_FIT_CHARS值。
速查:
Windows NT 3.1、Windows 95以上、Windows CE 1.0以上,头文件:winnls.h;库文件:kernel32.lib。需要引用的头文件:windows.h
void CUnicodeDlg::OnTranslate()
{
// TODO: Add your control notification handler code here
UpdateData(true);
CString PP;
PP=m_chinesecharacters;
if(m_chinesecharacters.IsEmpty())
{
AfxMessageBox("请输入汉字!");
return;
}
int len=PP.GetLength();
int unicode; //十进制转化为十六进制进用到的中间值
const int MAX_FILE_LENGTH=500;
WCHAR UnicodeFile[MAX_FILE_LENGTH];
MultiByteToWideChar( CP_ACP, 0, PP,-1,UnicodeFile,MAX_FILE_LENGTH);
PP="";
CString midd,temp="";//中间值
for(int loop=0;loop<len/2;loop++)
{
unicode=UnicodeFile[loop];
m_binary=tentobinary(unicode);
midd.Format("%d",unicode);
temp.Format("%d",unicode);
m_unicodedec=m_unicodedec+temp;
m_unicodedec=m_unicodedec+" ";
midd.Format("%d",(unicode)/(16*16*16));
midd=tentosixteen(midd);
PP=PP+midd;
unicode=unicode-(unicode)/(16*16*16)*16*16*16;
midd.Format("%d",(unicode)/(16*16));
midd=tentosixteen(midd);
PP=PP+midd;
unicode=unicode-(unicode)/(16*16)*16*16;
midd.Format("%d",(unicode)/16);
midd=tentosixteen(midd);
PP=PP+midd;
unicode=unicode-unicode/16*16;
midd.Format("%d",unicode);
midd=tentosixteen(midd);
PP=PP+midd; //这是最后结果
m_unicodehex=PP;
UpdateData(false);
}
}
CString CUnicodeDlg::tentosixteen(CString ten)
{
if(ten=="10")
ten="A";
if(ten=="11")
ten="B";
if(ten=="12")
ten="C";
if(ten=="13")
ten="D";
if(ten=="14")
ten="E";
if(ten=="15")
ten="F";
return ten;
}
CString CUnicodeDlg::tentobinary(int iNum)
{
int i; /*循环变量*/
char a[17]; /*输出的进制数*/
memset(a,0,17);
a[16]='/0';
printf("please input the number(>0):");
scanf("%d",&iNum);
for (i=15;i>=0;i--)
{
if(iNum==0 )
{
for(;i>=0;i--)
{
a[i]='0';
}
break;
}
if(iNum%2 == 0 )
{/*如果进制数被整除*/
iNum=iNum/2;
a[i] ='0'; /*相应进制数位置*/
}
else
{
iNum=(iNum-1)/2;
a[i]= '1'; /*否则置 */
}
}
return (CString)a;
}