cpiRootElement

Finalidade

Obtém o endereço do elemento de sintaxe raiz do objeto do analisador especificado.

Sintaxe

CciElement* cpiRootElement(
    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
parser
Especifica o endereço do objeto do analisador (entrada).

Valores de Retorno

O endereço do elemento de sintaxe raiz é 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 do analisador de amostra BipSampPluginParser.c (linhas 428 a 470):

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;

    /* Vamos supor a propriedade do restante do buffer */
  return(pc->iSize);
}
Conceitos relacionados
Analisadores Definidos pelo Usuário
Extensões Definidas pelo Usuário
Tarefas relacionadas
Criando um Analisador em C
Referências relacionadas
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
as08300_