cpiElementValue-Gruppe

Zweck

Funktionen, um den Wert des angegebenen Syntaxelements abzurufen.

Syntax

CciSize cpiElementBitArrayValue(
  int*         Rückkehrcode,
  CciElement*  Zielelement,
  const struct CciBitArray* Wert);
CciBool cpiElementBooleanValue(
  int*         Rückkehrcode,
  CciElement*  Zielelement);
CciSize cpiElementByteArrayValue(
  int*         Rückkehrcode,
  CciElement*  Zielelement,
  const struct CciByteArray* Wert);
CciSize cpiElementCharacterValue(
  int*         Rückkehrcode,
  CciElement*  Zielelement,
  const CciChar*  Wert,
  CciSize         Länge);
struct CciDate cpiElementDateValue(
  int*         Rückkehrcode,
  CciElement*  Zielelement);
CciSize cpiElementDecimalValue(
  int*         Rückkehrcode,
  CciElement*  Zielelement,
  const CciChar*  Wert,
  CciSize         Länge);
struct CciTimestamp cpiElementGmtTimestampValue(
  int*         Rückkehrcode,
  CciElement*  Zielelement);
struct CciTime cpiElementGmtTimeValue(
  int*         Rückkehrcode,
  CciElement*  Zielelement);
CciInt cpiElementIntegerValue(
  int*         Rückkehrcode,
  CciElement*  Zielelement);
CciReal cpiElementRealValue(
  int*         Rückkehrcode,
  CciElement*  Zielelement);
struct CciTimestamp cpiElementTimestampValue(
  int*         Rückkehrcode,
  CciElement*  Zielelement);
struct CciTime cpiElementTimeValue(
  int*         Rückkehrcode,
  CciElement*  Zielelement);

Parameter

Rückkehrcode
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
Zielelement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).
Wert
Die Adresse eines Ausgabepuffers, in den der Wert des Syntaxelements gespeichert wird (Eingabe). Nur unter relevanten Funktionsaufrufen verwendet.
Länge
Die Länge in Buchstaben, angegeben im Parameter Wert (Eingabe). Nur unter relevanten Funktionsaufrufen verwendet.

Rückgabewerte

Der Wert des Elements wird zurückgegeben.

In einigen Fällen, beispielsweise cpiElementCharacterValue oder cpiElementDecimalValue, wenn der Puffer nicht groß genug ist, um die Daten zu empfangen, werden die Daten nicht in den Puffer geschrieben. Die Größe des erforderlichen Puffers wird als Rückgabewert übergeben, und der Rückkehrcode wird auf CCI_BUFFER_TOO_SMALL gesetzt.

Wenn ein Fehler auftritt, gibt der Rückkehrcode den Grund für den Fehler an.

Zugehörige Konzepte
Benutzerdefinierte Parser
Benutzerdefinierte Erweiterungen
Zugehörige Tasks
Parser in C erstellen
Zugehörige Verweise
cpiElementName
cpiElementType
cpiElementValueValue
C-Parser-Dienstprogrammfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as08450_