Interstage Charset Manager Standard Edition V9 システム構築ガイド コンバータ編

4.1.8 charsetmanager_converter_get_statistics

コード変換統計情報の取得関数です。

呼び出し形式

size_t charsetmanager_converter_get_statistics(
       charsetmanager_converter_stream_status_ptr cssp,
       int id,
       int *error
);

機能説明

コード変換の統計情報を取得する関数です。取得できる統計情報は以下のとおりです。

• 変換可能文字のコードポイント数

• 変換不能文字のコードポイント数

• 無効文字の数

• 処理したコードポイントの総数

パラメタ

cssp(IN)

ストリーム情報格納域のポインタを指定します。ストリーム情報生成関数（“4.1.5 charsetmanager_converter_stream_open_status”）の復帰値を指定します。

id(IN)

取得したい統計情報のIDを指定します。指定できる値は以下のとおりです。

ID	情報
CHARSETMANAGER_CONVERTER_STAT_CONVERTIBLE	変換可能文字のコードポイント数
CHARSETMANAGER_CONVERTER_STAT_INCONVERTIBLE	変換不能文字のコードポイント数
CHARSETMANAGER_CONVERTER_STAT_INVALID_CHAR	無効文字の数
CHARSETMANAGER_CONVERTER_STAT_TOTAL	処理したコードポイントの総数

error(OUT)

エラー番号を返却する領域のポインタを指定します。本ポインタがNULLの場合、処理を中断します。関数が正常終了した場合には0が返却され、エラー終了時には1以上の詳細エラー番号が返却されます。エラー番号については、“表4.1 エラー番号一覧”を参照してください。

復帰値

idパラメタで指定された統計情報を返却します。

注意

• コード変換の停止の原因となったコードは、処理したコードポイントの総数には含まれません。

• 改行コードなどの制御文字も通常の文字と同様にカウントされます。