sesam_seek_row
(No version information available, might be only in CVS)
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:
| 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.