cpiBufferSize

Zweck

Diese Funktion ruft für das angegebene Parser-Objekt die Größe des Puffers ab, der die Bitstromdarstellung der Eingabenachricht enthält.

Syntax

CciSize cpiBufferSize(
  int*        returnCode,
  CciParser*  parser);

Parameter

returnCode
Empfängt den Rückkehrcode von der Funktion (Ausgabe). Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_PARSER_OBJECT
  • CCI_NO_BUFFER_EXISTS
parser
Gibt die Adresse des Parser-Objekts an (Eingabe).

Rückgabewerte

Bei erfolgreicher Ausführung wird die Größe des Puffers in Byte zurückgegeben. Wenn ein Fehler auftritt, wird null (CCI_NULL_ADDR) zurückgegeben, und returnCode gibt die Fehlerursache an.

Beispiel

Dieses Beispiel wurde aus der Knotenbeispieldatei BipSampPluginParser.c entnommen (Zeile 428 bis 452):

int cpiParseBufferEncoded(
  CciParser*  parser,


  CciContext* context,
  int         encoding,
  int         ccsid
){
  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);
Zugehörige Konzepte
Benutzerdefinierte Parser
Benutzerdefinierte Erweiterungen
Zugehörige Tasks
Parser in C erstellen
Zugehörige Verweise
cpiAppendToBuffer
cpiBufferByte
cpiBufferPointer
C-Parser-Dienstprogrammfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
as08290_