PHP Handbuch
Zurück |  | Nach vorne

# sesam_fetch_result

(PHP 3 CVS only)

sesam_fetch_result -- Liefert das Ergebnis einer Abfrage (ganz oder teilweise)

## Beschreibung

mixed sesam_fetch_result ( string result_id [, int max_rows])

Liefert ein gemischtes Array (???) mit den Ergebnissen einer Abfrage, optional begrenzt auf ein Maximum durch `max_rows` Zeilen. Sowohl Zeilen- als auch Spaltenindizes sind Null-basiert.

Tabelle 1. Gemischtes Resultat mit der Funktion sesam_fetch_result()

Array Element | Contents
--- | ---
int $arr["count"] | Anzahl von Ergebnis-Spalten im Ausgabesatz (oder `NULL` bei "immediate" Abfragen)
int $arr["rows"] | Anzahl von Zeilen im Ausgabesatz (zwischen `NULL` und `max_rows`)
bool $arr["truncated"] | `TRUE` wenn die Anzahl der Zeilen mindestens `max_rows` ist, ansonsten `FALSE`. Hinweis: auch bei `TRUE` kann der nächste sesam_fetch_result() u.U. 0 Zeilen zurückliefern, weil es keine weiteren Ergebniseinträge gibt.

mixed $arr[col][row]

Ergebnisdaten für alle Felder in Zeile(`row`) und Spalte(`col`), wobei der Integer-Index `row` zwischen 0 and `$arr["rows"]-1`, und `col` zwischen 0 und `$arr["count"]-1`) liegt. Da Felder auch leer sein können, muss ihre Existenz mit der PHP-Funktion isset() verifiziert werden. Der zurückgelieferte Feldtyp hängt vom entsprechenden, für die Spalte defineirten SQL-Typ ab (siehe SESAM overview für die angewendeten Umsetzungen). SESAM "multiple fields" sind "inlined" (???) und werden wie eine Spaltenfolge behandelt.

Hinweis: der Speicherbedarf für eine umfangreiche Abfrage kann immens groß werden. Es ist empfehlenswert, den Parameter `max_rows` zum Begrenzen der maximalen Anzahl von gelieferten Zeilen zu verwenden, um zu verhindern, dass die Ausgabe nicht den gesamten verfügbaren Speicher belegt.

Siehe auch: sesam_fetch_row(), und sesam_field_array() zur Überprüfung auf "multiple fields". Ein komplettes Beispiel für die Funktion sesam_fetch_result() findet man in sesam_query().

Zurück | Zum Anfang | Nach vorne
sesam_fetch_array | Nach oben | sesam_fetch_row