cpiParseBufferEncoded

Finalidade

Essa função é uma extensão da capacidade fornecida pela função de implementação cpiParseBuffer() existente que fornece a codificação e o conjunto de caracteres codificados nos quais a mensagem de entrada é representada. Se essa função de implementação for fornecida na estrutura CPI_VFT, nem cpiParseBuffer() nem cpiParseBufferFormatted() podem ser especificados, caso contrário a função cpiDefineParserClass() falhará com um código de retorno de CCI_INVALID_IMPL_FUNCTION.

Definido em Type Membro
CPI_VFT Condicional iFpParseBufferEncoded

Sintaxe

int cpiParseBufferEncoded(
  CciParser*  parser,
  CciContext*  context,
  int            encoding,
  int            ccsid); 

Parâmetros

parser
O endereço do objeto analisador (entrada).
context
O endereço do contexto de propriedade do objeto analisador (entrada).
encoding
A codificação do buffer de mensagem (entrada).
ccsid
O ccsid do buffer de mensagem (entrada).

Valores de Retorno

O tamanho (em bytes) da parte restante do buffer de mensagem para o qual o analisador assume a propriedade.

Amostra

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

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);
  /* Obter o primeiro byte no fluxo */
pc->iCurrentCharacter = cpiBufferByte(&rc, parser, pc->iIndex);
  /* Definir o elemento atual como o elemento raiz */
pc->iCurrentElement = cpiRootElement(&rc, parser);
  /* Reconfigurar o sinalizador para garantir que a análise
seja redefinida corretamente */
pc->iInTag = 0;
if (pc->trace) {
fprintf(pc->tracefile, "PLUGIN: <- cpiParseBufferEncoded()
retvalue=%d\n", pc->iSize);
fflush(pc->tracefile);
}
Conceitos relacionados
Analisadores Definidos pelo Usuário
Extensões Definidas pelo Usuário
Tarefas relacionadas
Criando um Analisador em C
Referências relacionadas
cpiParseBuffer
cpiParseBufferFormatted
Funções de Implementação do Analisador C
Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
as08160_