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
変換されるストリング。 'file code' で表現されます (入力)。
ucsString
結果の UCS-2 Unicode ストリングの位置 (入力)。 これには 0 のトレーリング CciChar が付きます。 これは、mbString にトレーリング・バイト 0 が付くのと同じです。
ucsStringLength
提供したバッファーの長さ (CciChars) (入力)。 mbString の各バイトは、多くても 1 つの CciChar までしか拡張しません。 これは必要なバッファー・サイズの上限を定義します。
codePage
ソース・ストリングのコード・ページ (入力)。 コード・ページの値は、ユーザー定義ノードをコンパイルするために使用されるコンパイラーに適したものでなければなりません。

ASCII システムの場合、WebSphere Message Broker で処理するために cciMbsToUcs を使用してストリング定数を変換する場合には、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 最終更新: 08/21/2006
as08555_