PDOStatement::getColumnMeta
PDOStatement::getColumnMeta — Retourne les métadonnées d'une colonne dans un jeu de résultats (PHP 5 >= 5.1.0, PECL pdo >= 0.2.0)
Description
Syntaxe
array PDOStatement::getColumnMeta ( int $column )
Récupère les métadonnées d'une colonne d'indice 0 dans un jeu de résultats sous forme de tableau associatif.
Remarque :Cette fonction est expérimentale. Le comportement de cette fonction, y compris son nom et sa documentation associée, peut être modifié sans préavis dans les futures versions de PHP. Utilisez cette fonction à vos propres risques.
Remarque :Tous les pilotes PDO ne prennent pas en charge PDOStatement::getColumnMeta().
Parameters
column
La colonne d'indice 0 dans le jeu de résultats.
Valeurs de retour
Retourne un tableau associatif contenant les valeurs suivantes qui représentent les métadonnées d'une seule colonne :
| Name | Valeur |
|---|---|
| native_type | Le type natif PHP utilisé pour représenter la valeur de la colonne. |
| driver:decl_type | Le type SQL utilisé pour représenter la valeur de la colonne dans la base de données. Si la colonne dans le jeu de résultats est le résultat d'une fonction, cette valeur ne peut pas être retournée parPDOStatement::getColumnMeta(). |
| indicateurs | Indicateurs définis pour cette colonne. |
| name | Le nom de la colonne renvoyé par la base de données. |
| table | Le nom de la table pour cette colonne renvoyé par la base de données |
| len | La longueur de cette colonne. Sauf pour les nombres décimaux à virgule flottante, elle est généralement-1 |
| precision | La précision numérique de cette colonne. Sauf pour les nombres décimaux à virgule flottante, elle est généralement0 。 |
| pdo_type | avecPDO::PARAM_*Le type de colonne représenté par une constante. |
Exemples
Récupérer les métadonnées de colonne
L'exemple suivant montre le résultat de la récupération des métadonnées d'une seule colonne générée par une fonction (COUNT) dans PDO_SQLITE.
<?php
$select = $DB->query('SELECT COUNT(*) FROM fruit');
$meta = $select->getColumnMeta(0);
var_dump($meta);
?>
L'exemple ci-dessus produit :
array(6) {
["native_type"]=>
string(7) "integer"
["flags"]=>
array(0) {
}
["name"]=>
string(8) "COUNT(*)"
["len"]=>
int(-1)
["precision"]=>
int(0)
["pdo_type"]=>
int(2)
}
Autres extensions
Manuel de référence PHP PDO