Beschreibung
array
sesam_fetch_array
( string result_id [, int whence [, int offset]])
Liefert
ein
Array
,
das
der
gelesenen
Zeile
entspricht
oder
FALSE
falls
es
keine
weiteren
Zeilen
mehr
gibt
.
sesam_fetch_array(
)
ist
eine
Alternative
zur
Funktion
sesam_fetch_row(
)
.
Die
Daten
werden
anstatt
in
numerischen
Indizes
des
Ergebnisarrays
in
assoziativen
Indizes
gespeichert
,
wobei
die
Feldnamen
als
Indizes
benutzt
werden
.
result_id
ist
eine
gültige
Ergebniskennung
(
??
?
)
der
Funktion
sesam_query(
)
(nur
Abfragen
vom
Typ
select
!
).
Für
die
gültigen
Werte
der
optionalen
Parameter
whence
und
offset
im
Detail
siehe
sesam_fetch_row(
)
.
Die
Funktion
sesam_fetch_array(
)
Die
Funktion
sesam_fetch_array(
)
holt
eine
mit
der
spezifizierten
Ergebniskennung
(??
?
)
assoziierte
Datenzeile
.
Die
Zeile
wird
als
assoziatives
Array
zur
Verfügung
gestellt
.
Jede
Ergebnisspalte
wird
mit
einem
assoziativen
Index
gleich
dem
Spaltennamen
(
aka
.
field
)
abgespeichert
.
Die
Spaltennamen
werden
in
Kleinschreibung
konvertiert
dargestellt
.
Spalten
ohne
Feldnamen
(
z.B
.
Ergebnisse
von
arithmetischen
Operationen
)
und
leere
Felder
werden
im
Array
nicht
gespeichert
.
Haben
zwei
oder
mehr
Spalten
im
Ergebnis
den
selben
Namen
,
bekommt
diesen
die
letzte
Spalte
.
In
diesem
Fall
empfiehlt
sich
der
Einsatz
von
sesam_fetch_row(
)
oder
Alias-Definitionen
für
die
Spalten
.
Eine
Spezialbehandlung
erlaubt
den
Zugriff
auf
"
multiple
field
"
Spalten
(die
sonst
alle
den
selben
Spaltennamen
haben
würden
)
.
Für
jede
Spalte
eines
"
multiple
field
"
wird
der
Name
gebildet
durch
Anhängen
von
"(n)"
,
wobei
n
den
Sub-Index
der
"multiple
field
"
Spalte
darstellt
und
Werte
von
1
bis
zum
deklarierten
Wiederholungsfaktor
annehmen
kann
.
Zur
Übereinstimmung
mit
der
entsprechenden
Abfragesyntax
sind
die
Indizes
n
i
c
h
t
null-basiert
.
Für
eine
Spalte
der
Definition
:
ergäben sich die assoziativen Indizes für die einzelnen "multiple
fields" als
"multi(1)"
,
"multi(2)"
, and
"multi(3)"
.
Nachfolgende
Aufrufe
von
sesam_fetch_array(
)
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
.
Beispiel
1
.
SESAM
fetch
rows
?php
$result
=
sesam_query
(
"SELECT
*
FROM
phone\n"
.
"
WHERE
LASTNAME='".strtoupper($name)
."'\n"
.
"
ORDER
BY
FIRSTNAME"
,
1)
;
if
(
!
$result
)
{
..
.
error
..
.
}
/
/
print
the
table
:
print
"
TABLE
BORDER
\n"
;
while
(($row
=
sesam_fetch_array
($result)
)
count($row
)
0
)
{
print
"
TR
\n"
;
print
"
TD
".htmlspecialchars($row["firstname"])
.
"
/
TD
\n"
;
print
"
TD
".htmlspecialchars($row["lastname"])
.
"
/
TD
\n"
;
print
"
TD
".htmlspecialchars($row["phoneno"])
.
"
/
TD
\n"
;
print
"
/
TR
\n"
;
}
print
"
/
TABLE
\n"
;
sesam_free_result
($result)
;
?
|
|
Siehe
auch
:
sesam_fetch_row(
)
(liefert
ein
indiziertes
Array
)