array &getCol
(
string $query
,
string
$type
= = null
,
array
$params = array()
,
array
$param_types
= = null
,
mixed
$colnum = 0
)
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.
la requête SQL
si fourni, les types des colonnes du jeu de résultats seront définis pour la récupération
si fourni, prepareQuery()/ executeQuery() seront utilisés avec ce tableau en tant que paramètres d'exécution
si fourni, les valeurs du paramètres $param seront automatiquement fénis aux types de données passées
la colonne à retourner (entier [numéro de la colonne, commençant à 0] ou une chaîne de caractères [nom de la colonne])
array - la première ligne du résultats en tant que tableau indexé commençant à 0, ou une MDB_Error si une erreur survient
| 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. |
This function can not be called statically.
query() , limitQuery() , prepareQuery() , executeQuery() , getRow() , getOne() , getAssoc()