PDOStatement::columnCount

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

PDOStatement::columnCount — Devuelve el número de columnas en el conjunto de resultados

Descripción

public PDOStatement::columnCount(): int

Utilice la función PDOStatement::columnCount() para devolver el número de columnas en el conjunto de resultados representado por el objeto PDOStatement.

Si el objeto PDOStatement ha sido devuelto por la función PDO::query(), el número de columnas es inmediatamente disponible.

Si el objeto PDOStatement ha sido devuelto por la función PDO::prepare(), un conteo preciso de las columnas no estará disponible hasta que se invoque la función PDOStatement::execute().

Parámetros

Esta función no contiene ningún parámetro.

Valores devueltos

Devuelve el número de columnas en el conjunto de resultados representado por el objeto PDOStatement, incluso si el conjunto de resultados está vacío. Si no hay conjunto de resultados, PDOStatement::columnCount() devolverá 0.

Errores/Excepciones

Emite un error de nivel E_WARNING si el atributo PDO::ATTR_ERRMODE está definido a PDO::ERRMODE_WARNING.

Lanza una excepción PDOException si el atributo PDO::ATTR_ERRMODE está definido a PDO::ERRMODE_EXCEPTION.

Ejemplos

Ejemplo #1 Conteo de columnas

Este ejemplo demuestra cómo PDOStatement::columnCount() funciona con o sin conjunto de resultados.

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

$sth = $dbh->prepare("SELECT nom, couleur FROM fruit");

/* Cuenta el número de columnas en el conjunto de resultados (no existente) */
$colcount = $sth->columnCount();
print "Antes de execute(), el conjunto de resultados tenía $colcount columnas (debería ser 0)\n";

$sth->execute();

/* Cuenta el número de columnas en el conjunto de resultados */
$colcount = $sth->columnCount();
print "Después de execute(), el conjunto de resultados tiene $colcount columnas (debería ser 2)\n";

?>

El ejemplo anterior mostrará:

Antes de execute(), el conjunto de resultados tenía 0 columnas (debería ser 0)
Después de execute(), el conjunto de resultados tiene 2 columnas (debería ser 2)

Ver también

PDO::prepare() - Prepara una consulta para su ejecución y devuelve un objeto
PDOStatement::execute() - Ejecuta una consulta preparada
PDOStatement::rowCount() - Devuelve el número de filas afectadas por la última llamada a la función PDOStatement::execute()