cniElementValue group

Queste funzioni richiamano il valore dell'elemento di sintassi specificato.

Sintassi

CciSize cniElementBitArrayValue(
  int*      returnCode,
  CciElement*     targetElement,
  const struct   CciBitArray* value);
CciBool cniElementBooleanValue(
  int*      returnCode,
  CciElement*  targetElement);
CciSize cniElementByteArrayValue(
  int*      returnCode,
  CciElement*     targetElement,
  const struct   CciByteArray* value);
CciSize cniElementCharacterValue(
  int*      returnCode,
  CciElement*     targetElement,
  	const CciChar* value,
  CciSize        length);
struct CciDate cniElementDateValue(
  int*      returnCode,
  CciElement*  targetElement);
CciSize cniElementDecimalValue(
  int*      returnCode,
  CciElement*     targetElement,
  	const CciChar* value,
  CciSize        length);
struct CciTimestamp cniElementGmtTimestampValue(
  int*      returnCode,
  CciElement*  targetElement);
struct CciTime cniElementGmtTimeValue(
  int*      returnCode,
  CciElement*  targetElement);
CciInt cniElementIntegerValue(
  int*      returnCode,
  CciElement*  targetElement);
CciReal cniElementRealValue(
  int*      returnCode,
  CciElement*  targetElement);
struct CciTimestamp cniElementTimestampValue(
  int*      returnCode,
  CciElement*  targetElement);
struct CciTime cniElementTimeValue(
  int*      returnCode,
  CciElement*  targetElement);

Parametri

returnCode
Il codice di ritorno dalla funzione (output).
I codici di ritorno possibili sono:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
  • CCI_INV_BUFFER_TOO_SMALL
targetElement
L'indirizzo dell'oggetto elemento di sintassi di destinazione (input).
value
L'indirizzo di un buffer di output in cui viene memorizzato il valore dell'elemento di sintassi (input). Viene utilizzato solo nelle chiamate di funzioni rilevanti.
length
La lunghezza, in caratteri, del buffer di output specificata nel parametro value (input). Viene utilizzato solo nelle chiamate di funzioni rilevanti.

Valori di restituzione

  • Se ha esito positivo, viene restituito il valore dell'elemento di destinazione.
  • Se la dimensione dei dati di un elemento può variare, viene restituita l'esatta dimensione dei dati.
  • Se la lunghezza specificata non è sufficiente, il codice di errore è impostato su CCI_BUFFER_TOO_SMALL.
  • Se si verifica un errore, il parametro returnCode indica il motivo dell'errore.

Esempio

 numberOfChars     = cniElementCharacterValue(
		 		 &rc, firstChild, (CciChar*)&elementValue, sizeof(elementValue)
		 		 );

if (rc==CCI_BUFFER_TOO_SMALL){
    free(elementValue);
    elementValue      = (CciChar*)malloc(numberOfChars * sizeof(CciChar));
    numberOfChars     = cniElementCharacterValue(
                  &rc, firstChild, (CciChar*)&elementValue, sizeof(elementValue));
  }
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as07910_