sqlite_array_query
SQLiteDatabase->arrayQuery
(No version information available, might be only in CVS)
SQLiteDatabase->arrayQuery — Esegue una query in un dato database e restituisce una matrice
Descrizione
Versione ad oggetti (metodo):
sqlite_array_query() esegue una data query e restituisce un matrice con l'intero set di risultati. E' simile a sqlite_query() e a eseguiresqlite_fetch_array() per ogni riga. sqlite_array_query() è significativamente più veloce.
Le migliori performance con sqlite_array_query() si ottengono con query che restituiscono fino a 45 righe. Se si ha più dati si raccomanda di scrivere una propria funzione e di utilizzare sqlite_unbuffered_query().
Elenco dei parametri
- query
-
Query da eseguire.
- dbhandle
-
Risorsa SQLite Database restituita da sqlite_open () quando usato in modo procedurale. Questo parametro non è richiesto nel metodo ad oggetti.
- result_type
-
Il parametro opzionale result_type accetta una costante e determina come l'array restituito sarà indicizzato. Usando SQLITE_ASSOC restituirà solo indici associativi (campi nominali) mentre SQLITE_NUM restituirà solo indici numerici (campi numerici ordinali). SQLITE_BOTH restituirà sia gli indici associativi che numerici. SQLITE_BOTH è il default per questa funzione.
- decode_binary
-
Quando decode_binary è impostato a TRUE (per default), il PHP decodificherà i dati binari se questi furono codificati con la funzione sqlite_escape_string(). Normalmente si dovrebbe lasciare inalterato il comportamento di default, a meno che non si debba intervenire su database creati da altre applicazioni SQLite.
Nota: Due sintassi alternative sono supportate per compatibilità con altre estensioni di database (come MySQL). La forma preferita è la prima, dove il parametro dbhandle è il primo parametro per la funzione.
Valori restituiti
Restituisce una matrice contenente tutti i risultati, oppure FALSE.
I nomi delle colonne restituiti da SQLITE_ASSOC e da SQLITE_BOTH saranno maiuscoli o minuscoli in base al valore del parametro di configurazione sqlite.assoc_case .
Esempi
Example#1 Stile procedurale
<?php
$dbhandle = sqlite_open('sqlitedb');
$result = sqlite_array_query($dbhandle, 'SELECT name, email FROM users LIMIT 25', SQLITE_ASSOC);
foreach ($result as $entry) {
echo 'Name: ' . $entry['name'] . ' E-mail: ' . $entry['email'];
}
?>
Example#2 Stile ad oggetti
<?php
$dbhandle = new SQLiteDatabase('sqlitedb');
$result = $dbhandle->arrayQuery('SELECT name, email FROM users LIMIT 25', SQLITE_ASSOC);
foreach ($result as $entry) {
echo 'Name: ' . $entry['name'] . ' E-mail: ' . $entry['email'];
}
?>