cpiBufferByte

Zweck

Diese Funktion ruft für das angegebene Parserobjekt ein einzelnes Byte aus dem Puffer ab, der die Bitstromdarstellung der Eingabenachricht enthält. Der Wert des Indexarguments gibt an, welches Byte in der Bytefeldgruppe zurückgegeben werden soll.

Syntax

CciByte cpiBufferByte(
int*        returnCode,
CciParser*  parser,
CciSize     index);

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 Parserobjekts an (Eingabe).
index
Gibt die relative Position an, die als Index im Puffer verwendet werden soll (Eingabe).

Rückgabewerte

Das angeforderte Byte wird zurückgegeben. Wenn ein Fehler auftritt, gibt returnCode die Fehlerursache an.

Beispiel

Dieses Beispiel wurde aus der Parser-Beispieldatei BipSampPluginParser.c entnommen (Zeile 61 bis 75):

void advance(
PARSER_CONTEXT_ST* context,
CciParser*         parser
){
int rc = 0;
/* Gehen Sie zum nächsten Zeichen */
context->iIndex++;
/* Suchen Sie die Endbedingung und bearbeiten Sie diese */
if (context->iIndex == context->iSize) return;
/* Rufen Sie das nächste Zeichen aus dem Puffer ab */
context->iCurrentCharacter = cpiBufferByte(&rc, parser, context->iIndex);
}
Zugehörige Konzepte
Benutzerdefinierte Parser
Benutzerdefinierte Erweiterungen
Zugehörige Tasks
Parser in C erstellen
Zugehörige Verweise
cpiAppendToBuffer
cpiBufferPointer
cpiBufferSize
C-Parser-Dienstprogrammfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
as08270_