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(
)
|
|
|
Anzahl
von
Ergebnis-Spalten
im
Ausgabesatz
(
oder
NULL
bei
"immediate
"
Abfragen
)
|
|
Anzahl
von
Zeilen
im
Ausgabesatz
(
zwischen
NULL
und
max_rows
)
|
|
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
.
|
|
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(
)
.