博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
MultiByteToWideChar
阅读量:7033 次
发布时间:2019-06-28

本文共 2621 字,大约阅读时间需要 8 分钟。

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和CP_UTF8了,前者将宽字符转换为ANSI,后者转换为UTF8。 )  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_ERR_INVALID_CHARS 设置此选项,函数遇到非法字符就失败并返回错误码ERROR_NO_UNICODE_TRANSLATION,否则丢弃非法字符 MB_USEGLYPHCHARS 使用像形字符代替控制字符 注意:       组合字符由一个基础字符和一个非空字符构成,每一个都有不同的字符值。每个预作字符都有单一的字符值给基础/非空字符的组成。在字符è中,e就是基础字符,而重音符标记就是非空字符。   函数的缺省动作是转换成预作的形式。如果预作的形式不存在,函数将尝试转换成组合形式。   标记MB_PRECOMPOSED和MB_COMPOSITE是互斥的,而标记MB_USEGLYPHCHARS和MB_ERR_INVALID_CHARS则不管其它标记如何都可以设置。对于下列代码页,dwFlags必须为0,否则函数返回错误码ERROR_INVALID_FLAGS。 50220 50221 50222 50225 50227 50229 52936 54936 57002到57011 65000(UTF7) 42(Symbol) 对于UTF8,dwFlags必须为0或MB_ERR_INVALID_CHARS,否则函数都将失败并返回错误码ERROR_INVALID_FLAGS。 lpMultiByteStr:指向将被转换字符串的字符。   cchMultiByte:指定由参数lpMultiByteStr指向的字符串中字节的个数。如果lpMultiByteStr指定的字符串以空字符终止,可以设置为-1(如果字符串不是以空字符中止,设置为-1可能失败,可能成功),此参数设置为0函数将失败。   lpWideCharStr:指向接收被转换字符串的缓冲区。    cchWideChar:指定由参数lpWideCharStr指向的缓冲区的字符个数。若此值为零,函数返回缓冲区所必需的宽字符数,在这种情况下,lpWideCharStr中的缓冲区不被使用。 返回值如果函数运行成功,并且cchWideChar不为零,返回值是由lpWideCharStr指向的缓冲区中写入的宽字符数;如果函数运行成功,并且cchMultiByte为零,返回值是接收到待转换字符串的缓冲区所需求的宽字符数大小。如果函数运行失败,返回值为零。若想获得更多错误信息,请调用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。
View Code

 

转载于:https://www.cnblogs.com/cwbo-win/articles/3393922.html

你可能感兴趣的文章
Android VelocityTracker
查看>>
oracle 修改表名几种方法
查看>>
deepin15.4配置nginx时出现主页展现,其他全部找不到的问题
查看>>
python基础一:之字符串
查看>>
用emacs进行批量查找替换的例子
查看>>
开源 免费 java CMS - FreeCMS-数据对象-link
查看>>
JVM与字节码—类的方法区模型
查看>>
java中的getParentFile
查看>>
Linux下软链接与硬链接的区别
查看>>
git 基本操作指令
查看>>
linux21-磁盘阵列
查看>>
构造函数和析构函数
查看>>
Zabbix自定义交换机接口名称
查看>>
linux 命令 —— find
查看>>
在线建立或重做mysql主从复制架构方法(传统模式和GTID模式)
查看>>
centos 6.5 下安装配置GO 1.2.1
查看>>
Hudson持续集成工具安装配置指南
查看>>
Setting Up Tez Ui
查看>>
druid.io 从本地批(batch)导入数据与从hdfs 批导入数据的index task配置
查看>>
vue里实现echarts中国地图
查看>>