sqlite_querySQLiteDatabase->queryFührt auf einer Datenbank eine Abfrage durch und liefert das Abfrageergebnis zurück
&reftitle.description;
resourcesqlite_queryresourcedbhandlestringqueryintresult_typestringerror_msgresourcesqlite_querystringqueryresourcedbhandleintresult_typestringerror_msgObjektorientierter Stil (Methode):SQLiteDatabaseSQLiteResultquerystringqueryintresult_typestringerror_msg
Führt eine, durch den Parameter query übergebene,
SQL-Anfrage auf der übergebenen Datenbank-Verbindung aus.
&reftitle.parameters;
dbhandle
Die SQLite-Datenbankressource, zurückgegeben von
sqlite_open, wenn prozedural genutzt.
In der objektorientierten Notation wird dieser Parameter nicht
benötigt.
query
Die auszuführende Anfrage.
Daten innerhalb einer Anfrage sollten maskiert werden.
result_type
&sqlite.result-type;
error_msg
Die spezifizierte Variable wird im Falle eines Fehlers gesetzt.
Diese ist besonders wichtig, denn SQL-Syntaxfehler können nicht mittels
sqlite_last_error ausgelesen werden.
&sqlite.param-compat;
&reftitle.returnvalues;
Diese Funktion gibt ein Ergebnis-Handle zurück. &return.falseforfailure;
Für Anfragen, die Reihen liefern, kann das Abfrageergebnis mit Funktionen, wie
sqlite_seek oder sqlite_fetch_array
augelesen werden.
Ungeachtet des Anfrage-Typs, gibt diese Funktion &false; zurück, wenn
die Anfrage fehlschlägt.
sqlite_query gib ein gepuffertes Ergebnis, dessen Zeilen
einzeln ansprechbar sind. Dies ist für kleine Abfragen nützlich, bei
denen man abwechselnd unterschiedliche Zeilen abfragen will.
Die gepufferten Ergebnisse belegen Speicher, um das gesamte Ergebnis
halten zu können. Dieser Speicher wird erst dann wieder freigegeben,
wenn das komplette Ergebnis durchlaufen wurde. Wenn nur ein sequentieller
Zugriff auf die Daten nötig ist, wird empfohlen, die performantere
Funktion sqlite_unbuffered_query zu nutzen.
&reftitle.changelog;
&Version;&Description;5.1.0error_msg wurde hinzugefügt
&reftitle.notes;
SQLite führt Mehrfach-Anfragen, die durch Semikolon getrennt wurden, aus,
so dass Sie Anfragen ausführen können, die aus einer Datei oder
über ein Skript geladen wurden. Wie auch immer, das funktioniert nur, wenn
das Ergebins der Anfrage nicht benutzt wird. Sollte es doch genutzt werden, wird
nur die erste SQL-Anfrage der Liste ausgeführt. Die Funktion
sqlite_exec wird immer Mehrfach-Anfragen ausführen.
Wenn Mehrfach-Anfrage ausgeführt werden, wird die Funktion im Fehlerfall
&false; zurückgeben, anderenfalls jedoch ein undefiniertes Ergebnis
(das kann, sollte die Anfrage gelingen, &true; oder ein Ergebnis-Handle sein).
&reftitle.seealso;
sqlite_unbuffered_querysqlite_array_query