cpiBufferByte

Scopo

Fornisce un unico byte del buffer contenente la rappresentazione del flusso di bit del messaggio di input, per l'oggetto programma di analisi specificato. Il valore dell'argomento indice indica il byte, nell'array di byte, che deve essere restituito.

Sintassi

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

Parametri

returnCode
Riceve il codice di ritorno dalla funzione (output).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_PARSER_OBJECT
  • CCI_NO_BUFFER_EXISTS
parser
Specifica l'indirizzo dell'oggetto programma di analisi (input).
index
Specifica l'offset da utilizzare come indice nel buffer (input).

Valori di restituzione

Il byte richiesto viene restituito. Se si verifica un errore, il parametro returnCode indica il motivo dell'errore.

Esempio

Questo esempio è estratto dal file del programma di analisi di esempio BipSampPluginParser.c (da riga 61 a 75):

void advance(
  PARSER_CONTEXT_ST* context,
  CciParser*         parser
){
  int                  rc = 0;

  /* Passa al successivo carattere */
  context->iIndex++;

  /* Rileva e gestisce la condizione finale */
  if (context->iIndex == context->iSize) return;

  /* Ottiene il successivo carattere dal buffer */
  context->iCurrentCharacter = cpiBufferByte(&rc, parser, context->iIndex);
}
Concetti correlati
Programmi di analisi definiti dall'utente
Estensioni definite dall'utente
Attività correlate
Creazione di un programma di analisi in C
Riferimenti correlati
cpiAppendToBuffer
cpiBufferPointer
cpiBufferSize
Funzioni di utilità del programma di analisi in C
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as08270_