cpiRootElement

Scopo

Fornisce l'indirizzo dell'elemento di sintassi root dell'oggetto programma di analisi specificato.

Sintassi

CciElement* cpiRootElement(
  int*      returnCode,
  CciParser*   parser);

Parametri

returnCode
Riceve il codice di ritorno dalla funzione (output).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_PARSER_OBJECT
parser
Specifica l'indirizzo dell'oggetto programma di analisi (input).

Valori di restituzione

Viene restituito l'indirizzo dell'elemento di sintassi root. Se si verifica un errore, viene restituito un valore zero (CCI_NULL_ADDR) e il parametro returnCode indica il motivo dell'errore.

Esempio

Questo esempio è estratto dal file del programma di analisi di esempio BipSampPluginParser.c (da riga 428 a 470):

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

  /* Fornisce un puntatore nel buffer di messaggi e imposta l'offset */
  pc->iBuffer = (void *)cpiBufferPointer(&rc, parser);
  pc->iIndex = 0;

  /* Salva il formato del buffer */
  pc->iEncoding = encoding;
  pc->iCcsid = ccsid;

  /* Salva la dimensione del buffer */
  pc->iSize = cpiBufferSize(&rc, parser);

  /* Prepara il primo byte nel flusso */
  pc->iCurrentCharacter = cpiBufferByte(&rc, parser, pc->iIndex);

  /* Imposta l'elemento attuale nell'elemento root */
  pc->iCurrentElement = cpiRootElement(&rc, parser);

  /* Reimposta l'indicatore per garantire che l'analisi venga reimpostata correttamente */
  pc->iInTag = 0;

  /* Verrà assunta la proprietà della parte rimanente del buffer */
  return(pc->iSize);
}
Concetti correlati
Programmi di analisi definiti dall'utente
Estensioni definite dall'utente
Attività correlate
Creazione di un programma di analisi in C
Riferimenti correlati
Funzioni di utilità del programma di analisi in C
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as08300_