cpiBufferByte

Finalidade

Obtém um único byte do buffer contendo a representação de fluxo de bits da mensagem de entrada para o objeto do analisador especificado. O valor do argumento index indica qual byte na matriz de bytes deve ser retornado.

Sintaxe

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

Parâmetros

returnCode
Recebe o código de retorno da função (saída).Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_PARSER_OBJECT
  • CCI_NO_BUFFER_EXISTS
parser
Especifica o endereço do objeto do analisador (entrada).
index
Especifica o deslocamento a utilizar como um índice para o buffer (entrada).

Valores de Retorno

O byte pedido é retornado. Se ocorrer um erro, returnCode indicará o motivo do erro.

Amostra

Este exemplo foi tirado do arquivo do analisador de amostra BipSampPluginParser.c (linhas 61 a 75):

void advance(
  PARSER_CONTEXT_ST* context,
  CciParser* parser
){
  int rc = 0;
  /* Avançar para o próximo caractere */
context->iIndex++;
  /* Detectar e manipular a condição de final */
if (context->iIndex == context->iSize) return;
  /* Obter o próximo caractere do buffer */
context->iCurrentCharacter = cpiBufferByte(&rc, parser,
context->iIndex);
}
Conceitos relacionados
Analisadores Definidos pelo Usuário
Extensões Definidas pelo Usuário
Tarefas relacionadas
Criando um Analisador em C
Referências relacionadas
cpiAppendToBuffer
cpiBufferPointer
cpiBufferSize
Funções de Utilitários do Analisador C
Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
as08270_