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

MovePath - An bestimmte Stelle wechseln

CxiError CxiTree :: MovePath (const char *path) const
CxiError cxiMovePath (CxiHandle self, const char *path)

Wechselt das aktuelle Sichtfenster des CXI-Baums

path:
Pfadname der Unterbaum-Variablen, die das neue Sichtfenster wird

return:
0 ok, sonst Fehler

Mit dieser Funktion wird das Sichtfenster vom aktuellen Knoten auf einen beliebigen anderen Knoten verschoben. Der anzugebende Pfadname besteht aus einer Folge von Variablennamen, die jeweils durch Slash oder Backslash getrennt sind. Die Funktion arbeitet die einzelnen Komponenten ab, indem jeweils ein MoveDown durchgeführt wird. Um allgemein verwendbar zu sein, akzeptiert die Funktion vier Sonderfälle:

Ist das erste Zeichen von path ein Pfadtrennzeichen, so wird vor der weiteren Auswertung MoveHome ausgeführt, d.h. die Bewegung im Baum beginnt bei der Wurzel. Andernfalls beginnt die Abarbeitung beim aktuellen Sichtfenster.

Ist eine Komponente von path gleich ".." (zwei Punkte), so wird anstelle von MoveDown ein MoveUp ausgeführt, also eine Bewegung zum Elternknoten.

Ist eine Komponente von path gleich "." (ein Punkt), so wird keine Bewegung ausgeführt, das Sichtfenster bleibt unverändert.

Leere Komponenten, also zwei oder mehrere aufeinander folgende Trennzeichen oder ein Trennzeichen am Ende von path, werden ignoriert.

Die Arbeitsweise dieser Funktion entspricht dem CHDIR- bzw. CD-Befehl auf der Kommandozeile zum Wechseln des aktuellen Directorys.

Der Pfad des aktuellen Sichtfensters kann mit der Funktion QueryPath abgefragt werden.

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

Siehe auch:
QueryPath
NewSub (mit Beispiel)
MoveDownAuto
MovePathAuto
MoveDown
MoveUp
MoveHome
MoveNext
MovePop