PHP Dokumentation: Function sqlite-fetch-array
12. Januar 2010 von werner
sqlite_fetch_array
SQLiteResult->fetch
SQLiteUnbuffered->fetch
(PHP 5, PECL sqlite >= 1.0.0)
sqlite_fetch_array — SQLiteResult->fetch — SQLiteUnbuffered->fetch — Liest die nächste Zeile aus dem Datenbankergebnis und gibt sie als Array zurück
Beschreibung
Objektorientierter Stil (Methode):
Liest die nächste Zeile von angegebenen result-Handle. Sind alle Zeilen ausgelesen, wird FALSE, anderenfalls ein assoziatives Array zurückgegeben, das die Daten der gelesenen Zeile enthält.
Parameter-Liste
- result
Die SQLite-Ergebnisressource. Dieser Parameter wird nicht benötigt, wenn die objektorientierte Notation genutzt wird.
- 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.
- decode_binary
Falls der Parameterdecode_binary auf TRUE gesetzt ist (das ist dieStandardeinstellung), dekodiert PHP die Binärkodierung, die bei Verwendung vonsqlite_escape_string() auf die Daten angewendet wird.Solange Sie die Daten nicht mit anderen SQLite-Fähigen Applikationen teilen,sollten Sie diesen Wert in der Standardeinstellung lassen.
Rückgabewerte
Liefert ein Array der nächsten Zeile des Datenbankerbegnisses oder FALSE, wenn die Position der nächsten Zeile ausserhalb des Datenbankergebnisses liegt.
Die Groß- und Kleinschreibung derSpaltennamen, die von SQLITE_ASSOC undSQLITE_BOTH zurückgegeben werden, wird entsprechend derKonfigurationsdirektive sqlite.assoc_case geändert.
Beispiele
Beispiel #1 Beispiel zur prozduralen Notation
<?php
$dbhandle = sqlite_open('sqlitedb');
$query = sqlite_query($dbhandle, 'SELECT name, email FROM users LIMIT 25');
while ($entry = sqlite_fetch_array($query, SQLITE_ASSOC)) {
echo 'Name: ' . $entry['name'] . ' E-mail: ' . $entry['email'];
}
?>Beispiel #2 Beispiel zur objektorientierten Notation
<?php
$dbhandle = new SQLiteDatabase('sqlitedb');$query = $dbhandle->query('SELECT name, email FROM users LIMIT 25'); // gepuffertes Datenbankergebnis
$query = $dbhandle->unbufferedQuery('SELECT name, email FROM users LIMIT 25'); // ungepuffertes Datenbankergebniswhile ($entry = $query->fetch(SQLITE_ASSOC)) {
echo 'Name: ' . $entry['name'] . ' E-mail: ' . $entry['email'];
}
?>Siehe auch
- sqlite_array_query() – Führt eine Datenbankabfrage durch und liefert das gesamte Abfrageergebnis als Liste zurück
- sqlite_fetch_string() – Alias von sqlite_fetch_single