cpiNextSibling

Zweck

Gibt die Adresse des Syntaxelementobjekts zurück, das das nächste (rechte) gleichgeordnete Element des angegebenen Zielelements ist.

Syntax

CciElement* cpiNextSibling(
  int*               Rückkehrcode,
  const 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
Zielelement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).

Rückgabewerte

Die Adresse des erforderlichen Syntaxelementobjekts wird zurückgegeben, wenn es kein nächstes gleichgeordnetes Element gibt. Ansonsten wird null zurückgegeben. Wenn ein Fehler auftritt, wird null (CCI_NULL_ADDR) zurückgegeben, und der Rückkehrcode gibt den Grund für den Fehler an.

Beispielprogramm

Dieses Beispiel stammt aus der Musterknotendatei BipSampPluginParser.c (Zeile 494 bis 496):

while ((!cpiElementCompleteNext(&rc, cpiParent(&rc, element))) &&
         (!cpiNextSibling(&rc, element))       &&
         (pc->iCurrentElement))
Zugehörige Konzepte
Benutzerdefinierte Parser
Benutzerdefinierte Erweiterungen
Zugehörige Tasks
Parser in C erstellen
Zugehörige Verweise
C-Parser-Dienstprogrammfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as08320_