sqlite_fetch_array

SQLiteResult::fetch

SQLiteUnbuffered::fetch

(PHP 5 < 5.4.0, 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

array sqlite_fetch_array ( resource $result [, int $result_type = SQLITE_BOTH [, bool $decode_binary = true ]] )

Objektorientierter Stil (Methode):

array SQLiteResult::fetch ([ int $result_type = SQLITE_BOTH [, bool $decode_binary = true ]] )
array SQLiteUnbuffered::fetch ([ int $result_type = SQLITE_BOTH [, bool $decode_binary = true ]] )

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 Parameter Ergebnis_Typ akzeptiert eine Konstante und bestimmt, wie das zurückgegebene Array indiziert wird. Während mit SQLITE_ASSOC nur assoziative Indizes (Namensfelder) zurückgegeben werden, werden mit SQLITE_NUM nur numerische Indizes (geordnete Feldnummern) zurückgegeben. SQLITE_BOTH gibt sowohl assoziative als auch numerische Indizes zurück. SQLITE_BOTH ist die Standardeinstellung.

decode_binary

Falls der Parameter decode_binary auf TRUE gesetzt ist (das ist die Standardeinstellung), dekodiert PHP die Binärkodierung, die bei Verwendung von sqlite_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 der Spaltennamen, die von SQLITE_ASSOC und SQLITE_BOTH zurückgegeben werden, wird entsprechend der Konfigurationsdirektive 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 Datenbankergebnis

while ($entry = $query->fetch(SQLITE_ASSOC)) {
    echo 'Name: ' . $entry['name'] . '  E-mail: ' . $entry['email'];
}
?>

Siehe auch