PDOStatement::columnCount

(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

Descrição

public PDOStatement::columnCount(): int

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.

Parâmetros

Esta função não possui parâmetros.

Valor Retornado

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.

Erros/Exceções

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.

Exemplos

Example #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)

Veja Também