Home/ Manual/ pdo / pdostatement/ PDOStatement::columnCount

PDOStatement::columnCount

PHP function Edit on GitHub ✎

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.2.0)

Returns the number of columns in the result set

Description

PDOStatement::columnCount(): int

Use PDOStatement::columnCount to return the number of columns in the result set represented by the PDOStatement object.

If the PDOStatement object was returned from PDO::query, the column count is immediately available.

If the PDOStatement object was returned from PDO::prepare, an accurate column count will not be available until you invoke PDOStatement::execute.

Parameters Parameters

Return Values

Returns the number of columns in the result set represented by the PDOStatement object, even if the result set is empty. If there is no result set, PDOStatement::columnCount returns 0.

Errors/Exceptions Errors

Examples

Counting columns

This example demonstrates how PDOStatement::columnCount operates with and without a result set.

php

<?php
$dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');

$sth = $dbh->prepare("SELECT name, colour FROM fruit");

/* Count the number of columns in the (non-existent) result set */
$colcount = $sth->columnCount();
print "Before execute(), result set has $colcount columns (should be 0)\n";

$sth->execute();

/* Count the number of columns in the result set */
$colcount = $sth->columnCount();
print "After execute(), result set has $colcount columns (should be 2)\n";

?>

The above example will output:

output

Before execute(), result set has 0 columns (should be 0)
After execute(), result set has 2 columns (should be 2)