MDB_Common::queryCol()

MDB_Common::queryCol() -- Récupère une seule colonne

Synopsis

require_once 'MDB.php';

array &queryCol (string $query, string [$type = NULL], mixed [$colnum = 0])

Description

Récupère une seule colonne depuis le jeu de résultats d'une requête. Cette fonction exécute la requête et libère le résultat lorsqu'elle a terminé.

Paramètres

chaîne de caractères $query

la requête SQL

chaîne de caractères $type

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

mixed $colnum

la colonne à retourner (entier [numéro de colonne, commençant à 0] ou une chaîne de caractères [nom de la colonne])

Valeur retournée

array - la première ligne du résultat en tant que tableau indexé commençant à 0 ou une MDB_Error si une erreur survient

Valeurs renvoyées

Tableau 34-1. Valeurs PEAR_Error possibles

Code erreurMessage d'erreurRaisonSolution
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 query*()
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.

Voir aussi

query() , limitQuery() , prepareQuery() , executeQuery() , queryRow() , queryOne() , queryAll()