この関数は、既存の 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 から取られています (612 行から 642 行)。
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; }