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
Der 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 den der Wert des Syntaxelements gespeichert wird (Eingabe). Wird nur bei relevanten Funktionsaufrufen verwendet.
length
Die Länge des Ausgabepuffers (in Zeichen), die vom Parameter value angegeben wird (Eingabe). Wird nur bei relevanten Funktionsaufrufen verwendet.

Rückgabewerte

  • Bei Erfolg wird der Wert des Zielelements ausgegeben.
  • Wenn die Größe der Daten eines Elements variieren kann, wird die korrekte Datengröße ausgegeben.
  • Ist die angegebene Länge zu klein, wird der Fehlercode auf CCI_BUFFER_TOO_SMALL gesetzt.
  • Beim Auftreten eines Fehlers gibt der Parameter returnCode den Grund dafür 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, 2006 Letzte Aktualisierung: 23. Aug. 2006
as07910_