<META HREF="function.sesam-settransaction.html"><META

Beschreibung

bool sesam_seek_row ( string result_id, int whence [, int offset])

result_id ist eine gültige Ergebniskennung (???); nur bei Abfragen vom Typ select und nur, wenn beim Aufruf von sesam_query()) ein "scrollable Cursor" verlangt wurde.

whence definiert den globalen Standardwert für den Scroll-Typ, der in weiteren Lese-Operationen für "scrollable" Cursor angewendet wird; folgende vordefinierte Werte sind möglich: constants:

Tabelle 1. Valid values for "whence" parameter

Value	Constant	Meaning
0	`SESAM_SEEK_NEXT`	sequentielles Lesen
1	`SESAM_SEEK_PRIOR`	sequentielles Lesen rückwärts
2	`SESAM_SEEK_FIRST`	erste Zeile lesen (nach dem Lesen wird der Standardwert auf `SESAM_SEEK_NEXT` gesetzt)
3	`SESAM_SEEK_LAST`	letzte Zeile lesen (nach dem Lesen wird der Standardwert auf `SESAM_SEEK_PRIOR` gesetzt)
4	`SESAM_SEEK_ABSOLUTE`	lesen Zeile mit der Nummer definiert durch `offset` (Null-basierte Indizierung; nach "fetch" wird der interne Standardwert auf `SESAM_SEEK_ABSOLUTE` gesetzt und der interne offset-Wert wird automatisch hochgesetzt)
5	`SESAM_SEEK_RELATIVE`	suche relativ zur aktuellen Position; `offset` kann positiv oder negativ sein und wird auch als Standard-Offset für weitere Abfragen gesetzt

offset ist ein optionaler Parameter, der nur wirkt (und auch nur benötigt wird), wenn whence entweder den Wert SESAM_SEEK_RELATIVE oder SESAM_SEEK_ABSOLUTE hat.