Récupère le jeu de résultats complet d'une requête et le retourne
dans un tableau associatif en utilisant la première colonne en
tant que clé. La fonction exécute la requête et libère le jeu
de résultats lorsqu'elle a terminée.
Si défini à TRUE, le tableau résultant sera modifié comme
suit : Si le jeu de résultats contient plus de deux colonnes,
la valeur sera un tableau de valeurs depuis la colonne 2 à n.
Si le jeu de résultats contient uniquemement deux colonnes,
la valeur retournée sera un scalaire, avec la valeur de la seconde
colonne (forcé à un tableau avec le paramètre $force_array).
Paramètres
string
$query
la requête SQL
array
$types
si fourni, les types des colonnes du jeu de résultats seront définis pour la récupération
si fourni, les valeurs du paramètres $param seront automatiquement fénis
aux types de données passées
integer
$fetchmode
le mode de récupération à utiliser
boolean
$force_array
utilisé uniquement si la requête retourne
exactement deux colonnes.
Si vaut TRUE, les valeurs du tableau retourné
seront un tableau d'un seul élément plutôt qu'un
scalaire.
boolean
boolean $group
si vaut TRUE, les valeurs du tableau retourné
seront mises dans un autre tableau. Si la même
valeur de clé (dans la première colonne) se répète,
les valeurs seront ajoutées à ce tableau plutôt
que d'écraser les valeurs existantes.
Valeur retournée
array - un tableau associatif de résultats depuis la requête.
Voir la documentation de prepareQuery(),
si vous voulez utiliser une requête SQL en utilisant des jokers.
MDB_ERROR_NEED_MORE_DATA
NULL
Trop peu de données pour remplir la requête SQL préparée.
Vérifiez le nombre de jokers fournis dans la requête SQL pour
prepareQuery(). Vérifiez le nombre d'entrées dans le tableau pour
$data. Le nombre d'entrées doit être égal
au nombre de jokers.
Le jeu de résultats contient moins de deux colonnes
Vérifiez la requête SQL ou choisissez une autre fonction
get*()
n'importe quel code erreur
Erreur spécifique à la base de données
Vérifiez la section relative à la base de données dans le
manuel PHP
afin de détecter la raison de cette erreur. Dans la plupart des cas,
une requête SQL incorrecte, i.e. utilisation d'une clause LIMIT
dans une requête destinée à une base de données Oracle.
Note
Cette fonction ne peut pas être appelée de façon statique.