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

QueryPath - Position abfragen

CxiError CxiTree :: QueryPath (char *pbuf, CxiShort psize)
CxiError cxiQueryPath (CxiHandle self, char *pbuf, CxiShort psize)

Liefert den Pfad des aktuellen Sichtfensters des CXI-Baums

pbuf:
Adresse des Puffers für den Pfadnamen

psize:
Größe des Puffers für den Pfadnamen

return:
0 ok, sonst Fehler

Mit dieser Funktion wird die Position des Sichtfensters in Form eines Pfadnamens zur Verfügung gestellt. Der gelieferte Pfadname beginnt mit dem Trennzeichen '/', er ist also ein absoluter Pfad.

QueryPath führt intern einen Flush auf das Sichtfenster durch.

Weitere Informationen zu Pfaden sind bei der Funktion MovePath zu finden.

Da das CXI-System intern nicht mit Pfadnamen, sondern mit Referenzen arbeitet, muss QueryPath den Baum nach den entsprechenden Namen durchsuchen. Daher ist diese Funktion eine sehr zeitaufwendige Operation. Um die Position des Sichtfensters zwischenzusichern und später wiederherzustellen, sind die Funktionen Push und MovePop vorzuziehen.

Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar. Der bisherige Parameter psep wird ab Version 2.07 60 nicht mehr unterstützt, als Pfadtrennzeichen gelten NUR NOCH Slash und Backslash. Diese Funktion setzt immer das Zeichen '/' zur Trennung ein.

Siehe auch:
MoveDownAuto
MovePathAuto
MoveDown
MoveUp
MoveHome
MoveNext
MovePath
MovePop