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().