PHP Handbuch
Zurück |  | Nach vorne

# 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

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.

Zurück | Zum Anfang | Nach vorne
sesam_rollback | Nach oben | sesam_settransaction