Diese Funktion erweitert die Funktionalität der Implementierungsfunktion cpiParseBuffer() und stellt zusätzliche Informationen zur Eingabenachricht bereit.
Wenn diese Implementierungsfunktion in der Struktur CPI_VFT bereitgestellt wird, können Sie weder cpiParseBuffer() noch cpiParseBufferEncoded() angeben, da die Funktion cpiDefineParserClass() dann mit dem Rückkehrcode CCI_INVALID_IMPL_FUNCTION fehlschlägt.
Definiert in | Typ | Mitglied |
---|---|---|
CPI_VFT | Bedingt | iFpParseBufferFormatted |
int cpiParseBufferFormatted(
CciParser* parser,
CciContext* context,
int encoding,
int ccsid,
CciChar* set,
CciChar* type,
CciChar* format);
Die Größe (in Byte) des restlichen Teils des Nachrichtenpuffers, für den der Parser das Eigentumsrecht übernimmt.
Das folgende Beispiel stammt aus der Musterparserdatei 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;
/* Zeiger auf den Nachrichtenpuffer abrufen und Offset festlegen */
pc->iBuffer = (void *)cpiBufferPointer(&rc, parser);
pc->iIndex = 0;
/* Format des Puffers speichern */
pc->iEncoding = encoding;
pc->iCcsid = ccsid;
/* Größe des Puffers speichern */
pc->iSize = cpiBufferSize(&rc, parser);
/* Ersten Byte im Datenstrom einsetzen */
pc->iCurrentCharacter = cpiBufferByte(&rc, parser, pc->iIndex);
/* Aktuelles Element für das Stammelement festlegen */
pc->iCurrentElement = cpiRootElement(&rc, parser);
/* Flag zurücksetzen, um sicherzustellen, dass die Analyse korrekt zurückgesetzt wird */
pc->iInTag = 0;
if (pc->trace) {
fprintf(pc->tracefile, "PLUGIN: <- cpiParseBufferFormatted()
retvalue=%d\n", pc->iSize);
fflush(pc->tracefile);
}