cciUcsToMbs

汎用文字セット (UCS) データをマルチバイト・ストリング・データに変換します。 この関数は、通常、診断メッセージのフォーマット設定だけに使用されます。 通常の処理は、UCS-2 を使用して実行するのが最善です。 これは、すべての言語のすべての文字を表記できます。

サンプル・コード (BipSampPluginUtil.c) では、 移植可能な方法で UCS-2 文字を処理するさらに別のユーティリティーを示します。

構文

int cciUcsToMbs(
  int*           returnCode,
  const CciChar* ucsString,
  char*          mbString,
  int            mbStringLength,
  int            codePage);

パラメーター

returnCode
関数からの戻りコード (出力)。
ucsString
変換されるストリング。UCS-2 Unicode で表現されます (入力)。
mbString
結果ストリングの位置 (入力)。 ストリングには、トレーリング・バイト 0 が付きます。 これは、Unicode に 0 のトレーリング CciChar が付くのと同じことです。
mbStringLength
提供したバッファーの長さ (バイト)(入力)。 ソース・ストリングにある各 CciChar は、1 バイト (SBCS コード・ページの場合)、 あるいは多くても、コード・ページの MB_CUR_MAX 値 (一般には 5 バイト未満) までしか拡張しません。 これは必要なバッファー・サイズの上限を定義します。
codePage
要求するコード・ページ (入力)。 Unix システムでは、nl_langinfo(CODEPAGE) で、setlocale により選択されたコード・ページを示します。 1208 は utf-8 Unicode を指定します。

戻り値

変換された長さ (バイト数)。

関連概念
ユーザー定義拡張機能

関連タスク
C での入力ノードの作成
C でのメッセージ処理ノードの作成
C でのパーサーの作成

関連資料
ユーザー定義拡張機能
cciMbsToUcs