PDOStatement::columnCount
(PHP 5 >= 5.1.0, PHP 7, PECL pdo >= 0.2.0)
PDOStatement::columnCount — Retourne le nombre de colonnes dans le jeu de résultats
Description
Utilisez la fonction PDOStatement::columnCount() pour retourner le nombre de colonnes dans le jeu de résultats représenté par l'objet PDOStatement.
Si l'objet PDOStatement a été retourné par la fonction PDO::query(), le nombre de colonnes est immédiatement disponible.
Si l'objet PDOStatement a été retourné par la fonction PDO::prepare(), un compte précis des colonnes ne sera pas disponible tant que vous n'invoquerez pas la fonction PDOStatement::execute().
Valeurs de retour
Retourne le nombre de colonnes dans le jeu de résultats représenté par l'objet PDOStatement, même si le jeu de résultats est vide. S'il n'y a pas de jeu de résultats, PDOStatement::columnCount() retournera 0.
Exemples
Exemple #1 Comptage des colonnes
Cet exemple démontre comment PDOStatement::columnCount() fonctionne avec ou sans jeu de résultats.
<?php
$dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');
$sth = $dbh->prepare("SELECT nom, couleur FROM fruit");
/* Compte le nombre de colonnes dans le jeu de résultat (non-existant) */
$colcount = $sth->columnCount();
print("Avant execute(), le jeu de résultats avait $colcount colonnes (devrait être 0)\n");
$sth->execute();
/* Compte le nombre de colonnes dans le jeu de résultats */
$colcount = $sth->columnCount();
print("Après execute(), le jeu de résultats a $colcount colonnes (devrait être 2)\n");
?>
L'exemple ci-dessus va afficher :
Avant execute(), le jeu de résultats avait 0 colonnes (devrait être 0) Après execute(), le jeu de résultat a 2 colonnes (devrait être 2)
Voir aussi
- PDO::prepare() - Prépare une requête à l'exécution et retourne un objet
- PDOStatement::execute() - Exécute une requête préparée
- PDOStatement::rowCount() - Retourne le nombre de lignes affectées par le dernier appel à la fonction PDOStatement::execute()
Version en cache
05/11/2024 11:36:19 Cette version de la page est en cache (à la date du 05/11/2024 11:36:19) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-pdostatement.columncount.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.