| MDB_Common::getAssoc() (Previous) | (Next) MDB_Common::getOne() | ||||
| |
|||||
|
|||||
MDB_Common::getCol()
Description
Récupère une seule colonne depuis un jeu de résultats d'une requête. La fonction exécute la requête et libère le résultat lorsqu'elle a terminée.
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 la 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ésultats en tant que tableau indexé commençant à 0, ou une MDB_Error si une erreur survient
Valeurs renvoyées
Tableau 39-1. Valeurs PEAR_Error possibles
| 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 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. |
Voir aussi
query() , limitQuery() , prepareQuery() , executeQuery() , getRow() , getOne() , getAssoc()
| MDB_Common::getAssoc() (Previous) | (Next) MDB_Common::getOne() | ||||||||
| |
|||||||||
|
|||||||||