2.38 :select()

Bewegt den XML-Cursor in der angegebenen Richtung oder auf den ersten Knoten im DOM-Baum, der einem angegebenen Muster entspricht.

Definition

boolean :select
(
  anyvalue DirectionOrPattern input
)

Parameter

anyvalue DirectionOrPattern input

Der Parameter darf nur von folgenden Typen sein:

enum DirectionOrPattern input

Gibt die Richtung an, in der der XML-Cursor innerhalb des DOM-Baums bewegt wird.

Wertebereich

select_document

Der XML-Cursor wird auf das Dokument gesetzt. Der XML-Cursor muss noch nicht auf einen DOM-Knoten verweisen

select_first

Der XML-Cursor wird auf den ersten DOM-Knoten gesetzt, der dem zuletzt gesuchten Muster entspricht.

select_first_child

Der XML-Cursor wird auf den ersten direkten Kindknoten gesetzt.

select_first_sibling

Der XML-Cursor wird auf den ersten DOM-Knoten mit demselben Vater gesetzt.

select_last

Der XML-Cursor wird auf den letzten DOM-Knoten gesetzt, der dem zuletzt gesuchten Muster entspricht. Diese Operation sucht den betreffenden DOM-Knoten.

select_last_child

Der XML-Cursor wird auf den letzten direkten Kindknoten gesetzt. Diese Operation sucht den betreffenden DOM-Knoten.

select_last_sibling

Der XML-Cursor wird auf den letzten DOM-Knoten mit demselben Vater gesetzt. Diese Operation sucht den betreffenden DOM-Knoten.

select_next

Der XML-Cursor wird auf den nächsten DOM-Knoten gesetzt, der dem zuletzt gesuchten Muster entspricht.

select_prev

Der XML-Cursor wird auf den vorherigen DOM-Knoten gesetzt, der dem zuletzt gesuchten Muster entspricht.

select_next_sibling

Der XML-Cursor wird auf den nächsten DOM-Knoten mit demselben Vater gesetzt.

select_prev_sibling

Der XML-Cursor wird auf den vorherigen DOM-Knoten mit demselben Vater gesetzt.

select_root

Der XML-Cursor wird auf den Wurzelknoten des DOM-Baums gesetzt. Dies ist der Initialwert eines XML-Cursors. Der XML-Cursor muss noch nicht auf einen DOM-Knoten verweisen

select_up

Der XML-Cursor wird auf den Vaterknoten gesetzt.

string DirectionOrPattern input

Gibt ein Muster an. Der XML-Cursor wird auf den ersten Knoten im DOM-Baum gesetzt, der dem Muster entspricht. Das Muster wird gemerkt, sodass mit der Methode :select und select_first, select_last, select_next und select_prev der XML-Cursor auf weitere DOM-Knoten, die dem Muster entsprechen, gesetzt werden kann.

Der Aufbau des Musters ist in Kapitel „Muster für die Methoden :match() und :select()“ des Handbuchs „XML-Schnittstelle“ beschrieben.

Rückgabewert

Gibt an, ob der XML-Cursor umgesetzt werden konnte.

Im Fehlerfall steht der XML-Cursor weiterhin auf dem ursprünglichen DOM-Knoten.

Es ist zu beachten, dass ein XML-Cursor, dessen Attribut .mapped den Wert false besitzt, automatisch auf die Wurzel des DOM-Dokuments positioniert wird.

Objekte mit dieser Methode

doccursor