cpiElementValueValue

Scopo

Fornisce l'oggetto valore dell'elemento di sintassi specificato. Non è possibile eseguire interrogazioni in questo oggetto valore. Utilizzabile per impostare o ricavare il valore di un elemento da un altro, senza conoscerne il tipo, utilizzando la funzione cpiSetElementValueValue. Questa può essere utilizzata dai programmi di analisi che sostituiscono il funzionamento richiamando le funzioni di implementazione cpiElementValue e cpiSetElementValue.

Sintassi

const CciElementValue* cpiElementValueValue(
  int*      returnCode,
  CciElement*  targetElement);

Parametri

returnCode
Riceve il codice di ritorno dalla funzione (output).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
Specifica l'indirizzo dell'oggetto elemento di sintassi di destinazione (input).

Valori di restituzione

Viene restituito l'indirizzo dell'oggetto CciElementValue memorizzato nell'elemento di sintassi di destinazione specificato. 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 705 a 725):

const CciElementValue* cpiElementValue(
  CciParser*  parser,
  CciElement* element
){
  CciElement* firstChild;
  const CciElementValue* value;
  int rc;

  if ((cpiElementType(&rc, element) == CCI_ELEMENT_TYPE_VALUE) ||
      (cpiElementType(&rc, element) == CCI_ELEMENT_TYPE_NAME_VALUE))  {
    value = cpiElementValueValue(&rc, element);
  }
  else if (cpiElementType(&rc, element) == CCI_ELEMENT_TYPE_NAME) {
    firstChild = cniFirstChild(&rc, element);
    value = cpiElementValueValue(&rc, firstChild);
  }
  else {
  }

  return(value);
}
Concetti correlati
Programmi di analisi definiti dall'utente
Estensioni definite dall'utente
Attività correlate
Creazione di un programma di analisi in C
Riferimenti correlati
cpiElementName
cpiElementType
Gruppo cpiElementValue
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
as08460_