sesam_seek_row

(PHP 3 CVS only)

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. Valid values for "whence" parameter

ValueConstantMeaning
0SESAM_SEEK_NEXTsequentielles Lesen
1SESAM_SEEK_PRIORsequentielles Lesen rückwärts
2SESAM_SEEK_FIRSTerste Zeile lesen (nach dem Lesen wird der Standardwert auf SESAM_SEEK_NEXT gesetzt)
3SESAM_SEEK_LASTletzte Zeile lesen (nach dem Lesen wird der Standardwert auf SESAM_SEEK_PRIOR gesetzt)
4SESAM_SEEK_ABSOLUTElesen 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)
5SESAM_SEEK_RELATIVEsuche 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.