CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiTree / Bewegung im Baum /

MoveNext - Zum nächsten Knoten wechseln

CxiError CxiTree :: MoveNext () const
CxiError cxiMoveNext (CxiHandle self)

Bewegt das Sichtfenster zum nächsten Knoten des CXI-Baums

return:
0 ok,
cxiErrorNoMoreNodes siehe Text,
sonst Fehler

Diese Funktion durchwandert den CXI-Baum in der PREORDER-Reihenfolge, d.h. übergeordnete Knoten werden vor ihren untergeordneten Knoten durchlaufen. Diese Reihenfolge enthält jeden Knoten des Baums genau einmal.

Ein einzelner Aufruf von MoveNext stellt die Position des aktuellen Sichtfensters in der PREORDER-Reihenfolge fest und bewegt das Fenster dann auf die folgende Position. Existiert kein Folgeknoten, so wird das Sichtfenster zur Wurzel bewegt und der Fehler cxiErrorNoMoreNodes zurückgeliefert.

Die Wurzel ist immer der erste Knoten der PREORDER-Reihenfolge.

Beispiel:
Im folgenden Beispiel sind die Knoten in der Reihenfolge nummeriert, in der sie von MoveNext angesprungen werden.

Um alle Knoten des CXI-Baums a zu verarbeiten, kann das folgende Programmfragment benutzt werden:

a.MoveHome ();  // Wurzel ist der erste Knoten
do
{
  // ... Verarbeitung ...
}
while (a.MoveNext () == cxiNoError);

Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar.

Siehe auch:
NewSub
MoveDown
MoveUp
MoveHome
MovePath
MovePop