この関数は、cpiParseBuffer() インプリメンテーション関数の機能を拡張し、入力メッセージに関する追加情報を提供します。
このインプリメンテーション関数が CPI_VFT 構造で提供されている場合、cpiParseBuffer() または cpiParseBufferEncoded() のどちらも指定できません。指定した場合、cpiDefineParserClass() 関数は失敗し、CCI_INVALID_IMPL_FUNCTION の戻りコードが出されます。
定義されている場所 | タイプ | メンバー |
---|---|---|
CPI_VFT | 条件付き | iFpParseBufferFormatted |
int cpiParseBufferFormatted(
CciParser* parser,
CciContext* context,
int encoding,
int ccsid,
CciChar* set,
CciChar* type,
CciChar* format);
パーサーが所有権を持っているメッセージ・バッファーの残りの部分のサイズ (バイト数)。
この例は、サンプル・パーサー・ファイル BipSampPluginParser.c から取られています。
int cpiParseBufferFormatted(
CciParser* parser,
CciContext* context,
int encoding,
int ccsid,
CciChar* set,
CciChar* type,
CciChar* format
){
PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context ;
int rc;
/* Get a pointer to the message buffer and set the offset */
pc->iBuffer = (void *)cpiBufferPointer(&rc, parser);
pc->iIndex = 0;
/* Save the format of the buffer */
pc->iEncoding = encoding;
pc->iCcsid = ccsid;
/* Save size of the buffer */
pc->iSize = cpiBufferSize(&rc, parser);
/* Prime the first byte in the stream */
pc->iCurrentCharacter = cpiBufferByte(&rc, parser, pc->iIndex);
/* Set the current element to the root element */
pc->iCurrentElement = cpiRootElement(&rc, parser);
/* Reset flag to ensure parsing is reset correctly */
pc->iInTag = 0;
if (pc->trace) {
fprintf(pc->tracefile, "PLUGIN: <- cpiParseBufferFormatted()
retvalue=%d¥n", pc->iSize);
fflush(pc->tracefile);
}