Manuel PHP
Précédent |  | Suivant

# sqlite_array_query

(PHP 5)

sqlite_array_query

(no version information, might be only in CVS)

SQLiteDatabase->arrayQuery -- Exécute une requête SQL avec SQLite et retourne un tableau

## Description

array sqlite_array_query ( resource dbhandle, string query [, int result_type [, bool decode_binary]] )
array sqlite_array_query ( string query, resource dbhandle [, int result_type [, bool decode_binary]] )

Style orienté objet (méthode)

class SQLiteDatabase {
array arrayQuery ( string query [, int result_type [, bool decode_binary]] )
}

sqlite_array_query() exécute la requête donnée et retourne un tableau du jeu de résultats entier. Il est similaire d'appeler sqlite_query() et ensuite sqlite_fetch_array() pour chaque ligne dans le jeu de résultats. sqlite_array_query() est de manière significative plus rapide que les fonctions mentionnées ci-dessus.

> Astuce : sqlite_array_query() est plus convenable pour les requêtes retournant 45 lignes ou moins. Si vous avez plus de données que cela, il est recommandé que vous écriviez vos scripts avec la fonction sqlite_unbuffered_query() plutôt pour une performance optimale.

## Liste de paramètres

query

  La requête qui sera exécutée.

dbhandle

  La ressource de base de données SQLite; retournée par sqlite_open() lorsqu'utilisée de manière procédurale. Ce paramètre n'est pas requis si vous utilisez la méthode orientée objet.

result_type

  Le paramètre optionnel result_type accepte une constante et détermine comment le tableau retourné doit être indexé. L'utilisation de `SQLITE_ASSOC` retournera uniquement un tableau associatif (nom des champs) tandis que `SQLITE_NUM` retournera un tableau indexé numériquement (numéro ordinal des champs). `SQLITE_BOTH` retournera des indices numériques et associatifs. `SQLITE_BOTH` est la valeur par défaut pour cette fonction.

decode_binary

  Lorsque decode_binary vaut `TRUE` (par défaut), PHP va décoder les données binaires, si elles ont été codées avec la fonction sqlite_escape_string(). Vous allez généralement laisser cette valeur à sa valeur par défaut, à moins que vous ne travailliez avec des bases opérées par d'autres applications.

> Note : Deux syntaxes alternatives sont supportées pour assurer la compatibilité avec les autres bases de données (telles que MySQL) : La forme recommandée est la première, où le paramètre dbhandle est le premier dans la fonction.

## Valeurs de retour

Retourne un tableau du jeu de résultats entier; sinon `FALSE`

Les noms de colonnes retournés par `SQLITE_ASSOC` et `SQLITE_BOTH` suivent les règles concernant la case définie par l'option de configuration sqlite.assoc_case.

## Exemples

Exemple 1. Style procédural
`<?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']; } ?>`

Exemple 2. Style orienté objet
`<?php $dbhandle = new SQLiteDatabase('sqlitedb'); $result = $dbhandle->arrayQuery('SELECT name, email FROM users LIMIT 25', SQLITE_ASSOC); foreach ($result as $entry) { echo 'Nom : ' . $entry['name'] . ' E-mail : ' . $entry['email']; } ?>`

## Voir aussi

sqlite_query()
sqlite_fetch_array()
sqlite_fetch_string()

Précédent | Sommaire | Suivant
Fonctions SQLite | Niveau supérieur | sqlite_busy_timeout