Manuel PHP
Précédent |  | Suivant

# PDOStatement::columnCount

(no version information, might be only in CVS)

PDOStatement::columnCount -- Retourne le nombre de colonnes dans le jeu de résultats

## Description

int PDOStatement::columnCount ( void )

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. 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()
PDOStatement::execute()
PDOStatement::rowCount()

Précédent | Sommaire | Suivant
PDOStatement::closeCursor | Niveau supérieur | PDOStatement::errorCode