Beschreibung
object
dbx_query
( object link_identifier, string sql_statement [, long flags])
dbx_query(
)
gibt
bei
Erfolg
ein
Objekt
oder
1
zurück
,
oder
0
im
Fehlerfall
.
Das
Objekt
wird
nur
zurückgegeben
,
wenn
die
in
sql_statement
angegebene
Abfrage
eine
Ergebnisliste
liefert
.
Beispiel
1
.
Wie
mit
dem
gelieferten
Wert
umgegangen
wird
?php
$link
=
dbx_connect(
DBX_ODBC
,
""
,
"db"
,
"username"
,
"password"
)
or
die("Fehler
beim
Verbinden")
;
$result
=
dbx_query($link
,
'SELECT
id
,
parentid
,
description
FROM
table')
;
if
(
is_object($result
)
)
{
/
/
..
.
tue
hier
irgendetwas
,
detaillierte
Beispiele
siehe
unten
..
.
/
/
erst
die
Ausgabe
der
Feldnamen
und
Typen
/
/
dann
die
Ausgabe
einer
Tabelle
mit
den
gelieferten
Werten
}
else
if
(
$result
==
1
)
{
echo("Abfrage
wurde
erfolgreich
ausgeführt
,
jedoch
keine
Ergebnisse")
;
}
else
{
exit("Fehler
bei
Abfrage")
;
}
dbx_close($link)
;
?
|
|
Der
Parameter
flags
Der
Parameter
flags
wird
verwendet
,
um
die
Menge
der
zu
liefernden
Informationen
zu
steuern
.
Die
folgenden
Konstanten
können
mit
dem
Bit-Operator
(
|
)
beliebig
kombiniert
werden
.
Die
Flags
DBX_COLNAMES_*
heben
die
Einstellungen
dbx.colnames_case
in
der
php.ini
auf
.
-
DBX_RESULT_INDEX
-
Dieser
Flag
ist
immer
gesetzt
,
d.h
.
dass
zurückgegebene
Objekt
hat
eine
Eigenschaft
data
,
welche
aus
einem
zweidimensionalen
,
numerisch
indizierten
Array
besteht
.
Zum
Beispiel
steht
in
data[
2][3
]
die
2
für
die
Reihen
-
(bzw
.
Datensatz
-)
Nummer
,
und
3
steht
für
die
Spalten
-
(bzw
.
Feld
-
Nummer
)
.
Die
erste
Reihe
und
Spalte
haben
den
Index
0
.
Ist
DBX_RESULT_ASSOC
ebenfalls
angegeben
,
so
enthält
das
zurückgegebene
Objekt
auch
Informationen
im
Zusammenhang
mit
DBX_RESULT_INFO
,
selbst
wenn
es
nicht
angegeben
wurde
.
-
DBX_RESULT_INFO
-
Liefert
Informationen
über
Spalten
,
wie
Feldnamen
und
Feldtypen
.
-
DBX_RESULT_ASSOC
-
Dies
bewirkt
,
dass
in
der
data
Eigenschaft
des
zurückgegebenen
Objektes
auf
die
Werte
eines
Feldes
mit
den
entsprechenden
Spaltennamen
als
Schlüssel
zugegriffen
werden
kann
.
Assoziierte
Ergebnisse
sind
eigentlich
Referenzen
zu
den
numerisch
indizierten
Daten
,
weshalb
eine
Änderung
von
data[
0][0
]
auch
den
Inhalt
von
data[0]['feldname_für_erste_spalte'
]
betrifft
.
-
DBX_COLNAMES_UNCHANGED
(available from PHP 4.3.0)
-
-
DBX_COLNAMES_UPPERCASE
(available from PHP 4.3.0)
-
-
DBX_COLNAMES_LOWERCASE
(available from PHP 4.3.0)
-
Beachten Sie, dass
DBX_RESULT_INDEX
unabhängig von dem aktuell verwendeten Wert des Parameters
flags
immer verwendet wird. Das heißt, dass es effektiv nur die
folgenden Kombinationen gibt:
Das
zurückgegebene
Objekt
hat
abhängig
von
flags
vier
oder
fünf
Eigenschaften
:
-
handle
-
Das
ein
gültiges
Handle
für
die
verbundene
Datenbank
,
und
als
solche
kann
es
(
wenn
nötig
)
auch
in
modulspezifischen
Funktionen
verwendet
werden
.
-
cols
und
rows
-
Diese
enthalten
die
Anzahl
der
Spalten
(
oder
Felder
)
bzw
.
Reihen
(
oder
Datensätze
)
.
-
info
(optional)
-
Dies
wird
nur
zurückgegeben
,
wenn
im
Parameter
flags
entweder
DBX_RESULT_INFO
oder
DBX_RESULT_ASSOC
spezifiziert
sind
.
Es
ist
ein
zweidimensionales
Array
mit
zwei
Reihen
(
name
und
type
)
,
welches
die
Spalteninformationen
enthält
.
Beispiel
2
.
Auflistung
von
Name
und
Typ
jedes
Feldes
|
-
data
-
Diese
Eigenschaft
enthält
die
aktuellen
Ergebnisdaten
,
möglicherweise
auch
mit
den
Spaltennamen
assoziiert
,
was
jedoch
vom
Parameter
flags
abhängig
ist
.
Wenn
DBX_RESULT_ASSOC
gesetzt
ist
,
können
Sie
$result
-
data[
2]["feldname"
]
verwenden
.
Beispiel
3
.
Ausgabe
des
Inhaltes
der
data
Eigenschaft
in
eine
HTML
Tabelle
|
Anmerkung
:
Konsultieren
Sie
bitte
auch
die
modulspezifische
Dokumentation
.
Spaltennamen
für
Abfragen
an
einer
Oracle
Datenbank
werden
in
Kleinbuchstaben
zurückgegeben
.
Siehe
auch
dbx_escape_string(
)
und
dbx_connect(
)
.