array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'pdostatement.columncount.php', 1 => 'PDOStatement::columnCount', 2 => 'Retorna o número de colunas no conjunto de resultados', ), 'up' => array ( 0 => 'class.pdostatement.php', 1 => 'PDOStatement', ), 'prev' => array ( 0 => 'pdostatement.closecursor.php', 1 => 'PDOStatement::closeCursor', ), 'next' => array ( 0 => 'pdostatement.debugdumpparams.php', 1 => 'PDOStatement::debugDumpParams', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/pdo/pdostatement/columncount.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

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)

Veja Também