cciMbsToUcs

将多字节字符串数据转换为通用字符集(UCS)。

语法

int cciMbsToUcs(
    int*                returnCode,
    const char*  mbString,
    CciChar*     ucsString,
    int          ucsStringLength,
    int            codePage);

参数

returnCode
来自函数(输出)的返回码。可能的返回码是:
  • CCI_SUCCESS
  • CCI_BUFFER_TOO_SMALL
  • CCI_INV_CHARACTER
  • CCI_FAILURE
  • CCI_INV_CODEPAGE
mbString
要转换的字符串,以‘文件代码’表示(输入)。
ucsString
结果得到的 UCS-2 Unicode 字符串的位置(输入)。这有尾随 CciChar 0,正如 mbString 有尾随字节 0 一样。
ucsStringLength
您提供的缓冲区的长度(以 CciChars 为单位)(输入)。mbString 中的每个字节扩展为不多于一个 CciChar 且这定义所需的缓冲区大小的上限。
codePage
源字符串的代码页(输入)。代码页的值应适用于编译用户定义的节点时所用的编译器。

对于 ASCII 系统,如果您使用 cciMbsToUcs 来转换字符串常量以供 WebSphere Message Broker 进行处理,则最好选择值 1208(即代码页 ibm-1208,它是 UTF-8 Unicode)。1208 适用于 Linux 和 UNIX,也适用于 Windows 平台。

在 Linux 和 UNIX 上,nl_langinfo(CODEPAGE) 可向您提供已通过 setlocale 选择的代码页。

对于 OS/390 和 z/OS,不应该使用 WebSphere MQ 的缺省代码页(此缺省代码页为 500)。您应该改为使用代码页值 1047。

返回值

以半字(UCS-2 字符)为单位的转换后长度。

相关概念
用户定义的扩展
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
as08555_