cpiWriteBufferFormatted

Zweck

Diese Funktion ist eine Erweiterung der vorhandenen Implementierungsfunktion cpiWriteBuffer(), die Folgendes bereitstellt:
  1. Die Codierung und der codierte Zeichensatz, in denen die Ausgabenachricht dargestellt werden soll, wenn der Parser seine Element-Baumstruktur zu einem Ausgabebitstrom serialisiert.
  2. Die Nachrichtengruppe, den Typ und das Format für die Ausgabenachricht für solche Parser, die derartige Informationen benötigen, um deren Element-Baumstruktur korrekt zu einem Ausgabebitstrom zu serialisieren.

Wenn keine Serialisierung erforderlich ist, zum Beispiel wenn die Ausgabe auf einem Eingabebitstrom basiert und die Baumstruktur nicht verändert wurde, wird diese Implementierungsfunktion nicht vom Broker aufgerufen.

Wenn diese Implementierungsfunktion in der Struktur CPI_VFT bereitgestellt wird, kann weder cpiWriteBuffer() noch cpiWriteBufferEncoded() angegeben werden, da die Funktion cpiDefineParserClass() mit dem Rückkehrcode CCI_INVALID_IMPL_FUNCTION fehlschlägt.

Definiert in Typ Mitglied
CPI_VFT Bedingt iFpWriteBufferFormatted

Syntax

int cpiWriteBufferFormatted(
  CciParser*     parser,
  CciContext*    context,
  int            encoding,
  int            ccsid,
  CciChar*       set,
  CciChar*       type,
  CciChar*       format); 

Parameter

parser
Die Adresse des Parser-Objekts (Eingabe).
context
Die Adresse des Plug-in-Kontextes (Eingabe).
encoding
Die Codierung des Nachrichtenpuffers (Eingabe).
ccsid
Die ID des codierten Zeichensatzes (CCSID) des Nachrichtenpuffers (Eingabe).
set
Die Nachrichtengruppe, der die Nachricht angehört (Eingabe).
type
Der Nachrichtentyp (Eingabe).
format
Das Nachrichtenformat (Eingabe).

Rückgabewerte

Die Größe der Daten in Byte, die an den Bitstrom im Puffer angehängt sind.

Beispiel

int cpiWriteBufferFormatted(
  CciParser*  parser,
  CciContext* context,
  int         encoding,
  int         ccsid
  CciChar*       set,
  CciChar*       type,
  CciChar*       format
){
  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;
}
Zugehörige Konzepte
Benutzerdefinierte Parser
Benutzerdefinierte Erweiterungen
Zugehörige Tasks
Parser in C erstellen
Zugehörige Verweise
cpiWriteBuffer
cpiWriteBufferEncoded
C-Parser-Implementierungsfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
as08230_