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.
CciByte cpiBufferByte(
int* returnCode,
CciParser* parser,
CciSize index);
Das erforderliche Byte wird zurückgegeben. Wenn ein Fehler auftritt, gibt der Rückkehrcode den Grund für den Fehler an.
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);
}