MDB_Common::getAssoc()

MDB_Common::getAssoc() – Récupère un jeu de résultats en tant que tableau associatif

Synopsis

require_once 'MDB.php';

array &getAssoc ( string $query , array $types = = null , array $params = array() , array $param_types = = null , integer $fetchmode = = MDB_FETCHMODE_DEFAULT , boolean $force_array = = false , boolean $group = = false )

Description

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).

Parameter

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

array $params

si fourni, prepareQuery()/ executeQuery() seront utilisés avec ce tableau en tant que paramètres d'exécution

array $param_types

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.

Return value

array - un tableau associatif de résultats depuis la requête.

Throws

Possible PEAR_Error values
Code erreur Message d'erreur Raison Solution
MDB_ERROR_INVALID NULL la requête SQL préparée n'est pas valide. 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.
MDB_ERROR_NO_DB_SELECTED NULL Aucune base de données n'a été choisie. Vérifiez le DSN dans la fonction connect() .
MDB_ERROR_TRUNCATED NULL 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

This function can not be called statically.

Récupère toutes les lignes (Previous) Récupère une seule colonne (Next)
Last updated: Sun, 29 Aug 2010 — Download Documentation
Do you think that something on this page is wrong? Please file a bug report or add a note.
View this page in:

User Notes:

There are no user contributed notes for this page.