PHP Dokumentation: Function sqlite-unbuffered-query
12. Januar 2010 von werner
sqlite_unbuffered_query
SQLiteDatabase->unbufferedQuery
(PHP 5, PECL sqlite >= 1.0.0)
sqlite_unbuffered_query — SQLiteDatabase->unbufferedQuery — Führt eine Abfrage aus, aber übernimmt die Daten nicht gleich ins PHP
Beschreibung
Objektorientierter Stil (Methode):
sqlite_unbuffered_query() entspricht im wesentlichen sqlite_query() mit der Ausnahme, dass das Ergebnis eine sequenzielle Folge ist, die nur zeilenweise vorwärts gelesen werden kann.
Dies Funktion ist ideal für die Generierung von Strukturen wie HTML-Tabellen, die ausschließlich sequenziell aufgebaut werden und kein expliziter Zugriff auf Datenreihen außerhalb der Sequenz nötig sind.
Hinweis: Funktionen, wie sqlite_seek(), sqlite_rewind(), sqlite_next(), sqlite_current() und sqlite_num_rows() können die Rückgabe von sqlite_unbuffered_query() nicht verarbeiten.
Parameter-Liste
- dbhandle
Die Ressource des SQLite-Ergebnisses, erzeugt von sqlite_open() wenn in prozeduralem Kontext genutzt. Dieser Parameter wird nicht benötigt, wenn die objekt-orientierte Methodik genutzt wird.
- query
Die auszuführende Anfrage
Daten innerhalb einer Anfrage sollten maskiert werden.
- result_type
Der optionale ParameterErgebnis_Typ akzeptiert eine Konstante und bestimmt,wie das zurückgegebene Array indiziert wird. Während mitSQLITE_ASSOC nur assoziative Indizes (Namensfelder)zurückgegeben werden, werden mit SQLITE_NUM nurnumerische Indizes (geordnete Feldnummern) zurückgegeben.SQLITE_BOTH gibt sowohl assoziative als auch numerischeIndizes zurück. SQLITE_BOTH ist dieStandardeinstellung.
- error_msg
Diese spezielle Variable wird genutzt, wenn ein Fehler auftritt. Sie hat einen besonderen Stellenwert, da SQL-Syntax-Fehler nicht mit sqlite_last_error() abgerufen werden können.
Hinweis: Zwei alternative Syntaxen werdenfür die Kompatibilität mit anderen Datenbank-Erweiterungen (wie z.B. MySQL)unterstützt. Die bevorzugte Form ist die erste, bei der der Parameterdbhandle der erste Parameter der Funktionist.
Rückgabewerte
Gibt den Ergebnis-Handler zurück. Im Fehlerfall wird FALSE zurückgegeben.
sqlite_unbuffered_query() gibt ein sequenzielles Ergebnis zurück, durch welches nur zeilenweise und vorwärts ausgelesen werden kann.
Changelog
| Version | Beschreibung |
|---|---|
| 5.1.0 | Parameter error_msg wurde hinzugefügt. |
Siehe auch
- sqlite_query() – Führt auf einer Datenbank eine Abfrage durch und liefert das Abfrageergebnis zurück
Loading ...