cpiBufferByte

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

Syntax

CciByte cpiBufferByte(
  int*        Rückkkehrcode,
  CciParser*  Parser,
  CciSize     Index);

Parameter

Rückkehrcode
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 den Offset an, der als Index im Puffer verwendet werden muss (Eingabe).

Rückgabewerte

Das erforderliche Byte wird zurückgegeben. Wenn ein Fehler auftritt, gibt der Rückkehrcode den Grund für den Fehler an.

Mustercode

Das folgende Beispiel stammt aus der Musterparserdatei BipSampPluginParser.c:

void advance(
  PARSER_CONTEXT_ST* Kontext,
  CciParser*         Parser
){
  int rc = 0;

  /* Gehen Sie zum nächsten Zeichen */
  context->iIndex++;

  /* Die Schlussbedingung erkennen und bearbeiten */
  if (context->iIndex == context->iSize) return;

  /* Das nächste Zeichen vom Puffer erhalten */
  context->iCurrentCharacter = cpiBufferByte(&rc, parser, context->iIndex);
}
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2013-02-27 15:22:29


ReferenzthemaReferenzthema | Version 8.0.0.2 | as08270_