(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.2.0)
PDOStatement::columnCount — Retorna o número de colunas no conjunto de resultados
Use PDOStatement::columnCount() para retornar o número de colunas no conjunto de resultados representado pelo objeto PDOStatement.
Se o objeto PDOStatement foi retornado por PDO::query(), a contagem de colunas estará disponível imediatamente.
Se o objeto PDOStatement foi retornado por PDO::prepare(), uma contagem precisa de colunas não estará disponível até que o método PDOStatement::execute() seja chamado.
Esta função não possui parâmetros.
Retorna o número de colunas no conjunto de resultados representado pelo
objeto PDOStatement, mesmo se o conjunto de resultados estiver vazio. Se não houver conjunto de resultados,
PDOStatement::columnCount() retornará 0.
Emite um erro de nível E_WARNING se o atributo PDO::ATTR_ERRMODE estiver definido
como PDO::ERRMODE_WARNING.
Lança uma exceção PDOException se o atributo PDO::ATTR_ERRMODE
estiver definido como PDO::ERRMODE_EXCEPTION.
Exemplo #1 Contando colunas
Este exemplo demonstra como PDOStatement::columnCount() opera com e sem um conjunto de resultados.
<?php
$dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
/* Conta o número de colunas no conjunto de resultados (não existente) */
$colcount = $sth->columnCount();
print "Antes de execute(), o resultado tem $colcount colunas (deve ser 0)\n";
$sth->execute();
/* Conta o número de colunas no conjunto de resultados */
$colcount = $sth->columnCount();
print "Depois de execute(), o resultado tem $colcount colunas (devem ser 2)\n";
?>O exemplo acima produzirá:
Antes de execute(), o resultado tem 0 colunas (deve ser 0) Depois de execute(), o resultado tem 2 colunas (devem ser 2)