Declaração PDOS::columnCount

PDOStatement::columnCount — Retorna o número de colunas no conjunto de resultados. (PHP 5 >= 5.1.0, PECL pdo >= 0.2.0)

ilustrar

gramática

 int PDOStatement::columnCount ( void )

Use PDOStatement::columnCount() para retornar o número de colunas no conjunto de resultados representado pelo objeto PDOStatement.

No caso de um objeto PDOStatement retornado por PDO::query(), os cálculos de contagem de colunas ficam disponíveis imediatamente.

Se for um objeto PDOStatement retornado por PDO::prepare(), o número de colunas não poderá ser calculado com precisão até que PDOStatement::execute() seja chamado.

valor de retorno

Retorna o número de colunas no conjunto de resultados representado pelo objeto PDOStatement. Se não houver nenhum conjunto de resultados, PDOStatement::columnCount() retornará 0.

Exemplo

Conte o número de colunas

O exemplo a seguir demonstra como usar PDOStatement::columnCount() para operar em um conjunto de resultados e em um conjunto vazio.

 <?php$dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');$sth = $dbh->prepare("SELECT nome, cor FROM fruta");/* Calcula um (não exist )O número de colunas no conjunto de resultados*/$colcount = $sth->columnCount();print("Antes de executar(), o conjunto de resultados tem colunas $colcount (deve be 0)n");$sth->execute();/* Calcula o número de colunas no conjunto de resultados*/$colcount = $sth->columnCount();print("Depois de execute(), conjunto de resultados tem colunas $colcount (deve ser 2)n");?>

A rotina acima produzirá:

 Antes de executar(), o conjunto de resultados tem 0 colunas (deve ser 0) Depois de executar(), o conjunto de resultados tem 2 colunas (deve ser 2)