cniElementValue-Gruppe

Diese Funktionen rufen den Wert des angegebenen Syntaxelements ab.

Syntax

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);

Parameter

returnCode
Empfängt den Rückkehrcode von der Funktion (Ausgabe). Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
  • CCI_INV_BUFFER_TOO_SMALL
targetElement
Die Adresse des Zielsyntaxelementobjekts (Eingabe).
value
Die Adresse eines Ausgabepuffers, in dem der Wert des Syntaxelements gespeichert wird (Eingabe). Dieser Parameter wird nur für relevante Funktionsaufrufe verwendet.
length
Die Länge (in Zeichen) des Ausgabepuffers, der im Parameter value angegeben wird (Eingabe). Dieser Parameter wird nur für relevante Funktionsaufrufe verwendet.

Rückgabewerte

  • Bei erfolgreicher Ausführung wird der Wert des Zielelements zurückgegeben.
  • Wenn die Datengröße eines Elements variieren kann, wird die korrekte Datengröße zurückgegeben.
  • Wenn die angegebene Länge zu gering ist, wird als Fehlercode CCI_BUFFER_TOO_SMALL festgelegt.
  • Wenn ein Fehler auftritt, gibt der Parameter returnCode die Fehlerursache an.

Beispiel

 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));
  }
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2005 Letzte Aktualisierung: Nov 17, 2005
as07910_