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
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as08270_