Function.sesam-fetch-result

Aus PHP-Wiki

Wechseln zu: Navigation, Suche
Rentenversicherung Online - Vergleich und Internet TarifePferdehalterhaftpflichtversicherung Vergleichen Online . Pinolino Schwenk-Rollensatz für Schaukelwiege Moritz

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])
</BR >

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.


<P >Tabelle 1. Gemischtes Resultat mit der Funktion sesam_fetch_result() </P ><THEAD ></THEAD ><TBODY ></TBODY >
Array ElementContents
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 function.isset verifiziert werden. Der zurückgelieferte Feldtyp hängt vom entsprechenden, für die Spalte defineirten SQL-Typ ab (siehe ref.sesam 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: function.sesam-fetch-row, und function.sesam-field-array zur Überprüfung auf "multiple fields". Ein komplettes Beispiel für die Funktion sesam_fetch_result() findet man in function.sesam-query.

Persönliche Werkzeuge