Anfang des Inhaltsbereichs

Funktionsdokumentation Methode relative Dokument im Navigationsbaum lokalisieren

Verwendung

relative ist eine Methode der Klasse SapDB_ResultSet.

Mit dieser Methode positionieren Sie den Cursor auf einem Datensatz, der sich eine bestimmte Anzahl von Datensätzen weiter hinten/weiter vorne in der Ergebnismenge befindet.

Funktionsumfang

relative (offset)

 

offset

Anzahl von Datensätzen, die der Cursor vorwärts oder rückwärts bewegt werden soll

offset > 0: Sie bewegen den Cursor vorwärts in der Ergebnismenge

offset < 0: Sie bewegen den Cursor rückwärts in der Ergebnismenge

 

Ergebnis:

     Datensatz an der angegebenen Position der Ergebnismenge

     bei leerer Ergebnismenge/wenn offset größer als die Anzahl der Datensätze nach/vor der aktuellen Cursorposition ist: None

Beispiel

     Sie bewegen den Cursor 5 Datensätze nach vorne:

row = cursor.relative (5)

     Sie bewegen den Cursor 1 Datensatz nach hinten:

row = cursor.relative (-1)

Dieser Ausdruck ist äquivalent zu row = cursor.previous ().

     SQL-Anweisung ausführen und in der Ergebnismenge navigieren

Ende des Inhaltsbereichs