PHP Handbuch | ||
---|---|---|
Zurück | Nach vorne |
Liefert ein Array entsprechend der gelesenen Zeile oder FALSE nach de letzten gefundenen Zeile.
Die Anzahl der Spalten im Ausgabesatz wird als Element des assoziativen Arrays $array["count"] geliefert. Da Ergebnisspalten auch leer sein können, kann die Funktion count() nicht auf das Ergebnis der Funktion sesam_fetch_row() angewendet werden.
result_id ist eine gültige Ergebniskennung (???) der Funktion sesam_query() (nur Abfragen vom Typ select!).
whence ist ein optionaler Parameter für eine "fetch"-Operation (???) bei "scrollable" Cursor und kann auf folgende vordefinierte Werte gesetzt werden:
Tabelle 1. Gültige Werte für Parameter "whence"
Value | Constant | Meaning |
---|---|---|
0 | SESAM_SEEK_NEXT | sequentielles Lesen (nach "fetch" wird der interne Standardwert auf SESAM_SEEK_NEXT gesetzt) |
1 | SESAM_SEEK_PRIOR | sequentielles Lesen rückwärts (nach "fetch" wird der interne Standardwert auf SESAM_SEEK_PRIOR gesetzt) |
2 | SESAM_SEEK_FIRST | zurück zur ersten Zeile (nach "fetch" wird der interne Standardwert auf SESAM_SEEK_NEXT gesetzt) |
3 | SESAM_SEEK_LAST | suche letzte Zeile (nach "fetch" wird der interne Standardwert auf SESAM_SEEK_PRIOR gesetzt) |
4 | SESAM_SEEK_ABSOLUTE | suche Zeilen 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. |
Bei "scrollable" kann der Cursor beliebig im Ausgabesatz positioniert werden. Wird der optionale Parameter whence nicht benutzt, werden die globalen Standardwerte für den Scroll-Typ verwendet (Initialiwert: SESAM_SEEK_NEXT, einstellbar mit der Funktion sesam_seek_row()). Bei Verwendung des Parameters whence ersetzen dessen Werte die golbalen Standardwerte.
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. Dieser Parameter ist nur für "scrollable" Cursors gültig.
sesam_fetch_row() holt eine Datenzeile aus dem Ergebnis mit der zugeordneten Ergebniskennung (???). Die Zeile wird als Array geliefert, wobei die indizierten Werte zwischen 0 und $array["count"]-1) liegen. Da Felder auch leer sein können, muß die Existenz eines mit der PHP-Funktion isset() verifiziert werden. Der Typ der gelieferten Felder ist abhängig von der entsprechenden SQL-Typdeklaration düe die Spalten (siehe SESAM overview für die angewendeten Umsetzungen). SESAM "multiple fields" sind "inlined" (???) und werden wie eine Spaltenfolge behandelt.
Nachfolgende Aufrufe von sesam_fetch_row() liefern die nächste Zeile (oder die vorhergehende, höchste/niedrigste je nach den Attributen) im Ausgabesatz oder FALSE wenn keine Zeilen mehr verfügabr sind.
Siehe auch: Funktion sesam_fetch_array() (liefert ein assoziatives Array ) und sesam_fetch_result() (liefert viele Zeilen pro Aufruf (???))
Zurück | Zum Anfang | Nach vorne |
sesam_fetch_result | Nach oben | sesam_field_array |