cpiBufferSize

Finalidade

Obtém o tamanho do buffer contendo a representação de fluxo de bits da mensagem de entrada para o objeto do analisador especificado.

Sintaxe

CciSize cpiBufferSize(
    int*            returnCode,
    CciParser*  parser);

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).

Valores de Retorno

Se bem-sucedida, o tamanho do buffer, em bytes, é retornado. Se ocorrer um erro, zero (CCI_NULL_ADDR) é retornado e returnCode indica a razão do erro.

Amostra

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

int cpiParseBufferEncoded(
    CciParser*  parser,


    CciContext*  context,
    int            encoding,
    int         ccsid
){
    PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context ;
    int                rc;

    /* Obter um ponteiro para o buffer de mensagem e definir o
deslocamento */
  pc->iBuffer = (void *)cpiBufferPointer(&rc, parser);
  pc->iIndex = 0;

    /* Salvar o formato do buffer */
  pc->iEncoding = encoding;
  pc->iCcsid = ccsid;

    /* Salvar o tamanho do buffer */
  pc->iSize = cpiBufferSize(&rc, parser);
Conceitos relacionados
Analisadores Definidos pelo Usuário
Extensões Definidas pelo Usuário
Tarefas relacionadas
Criando um Analisador em C
Referências relacionadas
cpiAppendToBuffer
cpiBufferByte
cpiBufferPointer
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
as08290_