この関数は、既存の cpiWriteBuffer() インプリメンテーション関数によって提供される機能の拡張で、 パーサーがエレメント・ツリーを出力ビット・ストリームに逐次化する際に、 出力メッセージを表すために使用されるエンコードおよびコード化文字セットを提供します。
逐次化が必要ない場合 (例えば、出力が入力ビット・ストリームに基づく場合や、ツリーが変更されていない場合)、ブローカーはこのインプリメンテーション関数を呼び出しません。 このインプリメンテーション関数が CPI_VFT 構造で提供されている場合、cpiWriteBuffer() または cpiWriteBufferFormatted() のどちらも指定できません。指定した場合、cpiDefineParserClass() 関数は失敗し、CCI_INVALID_IMPL_FUNCTION の戻りコードが出されます。
定義されている場所 | タイプ | メンバー |
---|---|---|
CPI_VFT | 条件付き | iFpWriteBufferEncoded |
int cpiWriteBufferEncoded(
CciParser* parser,
CciContext* context,
int encoding,
int ccsid);
バッファーでビット・ストリームに追加されるデータのサイズ (バイト数)。
この例は、サンプル・パーサー・ファイル BipSampPluginParser.c から取られています。
int cpiWriteBufferEncoded(
CciParser* parser,
CciContext* context,
int encoding,
int ccsid
){
PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context ;
int initialSize = 0;
int rc = 0;
const void* a;
CciByte b;
initialSize = cpiBufferSize(&rc, parser);
a = cpiBufferPointer(&rc, parser);
b = cpiBufferByte(&rc, parser, 0);
cpiAppendToBuffer(&rc, parser, (char *)"Some test data", 14);
return cpiBufferSize(0, parser) - initialSize;
}