sesam_seek_row

sesam_seek_row -- Setzt "scrollable Cursor" Modus für weitere Aufrufe

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 .

sequentielles Lesen
sequentielles Lesen rückwärts
erste Zeile lesen ( nach dem Lesen wird der Standardwert auf SESAM_SEEK_NEXT gesetzt )
letzte Zeile lesen ( nach dem Lesen wird der Standardwert auf SESAM_SEEK_PRIOR gesetzt )
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 )
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 .