cpiBufferByte

Propósito

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
Visão Geral de Extensões Definidas pelo Usuário
Tarefas relacionadas
Criando um Analisador Definido pelo Usuário
Referências relacionadas
cpiAppendToBuffer
cpiBufferPointer
cpiBufferSize
Funções de Utilitários do Analisador C
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:13:10

as08270_