(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
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().
Esta función no tiene parámetros.
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
.
Emits an error with level E_WARNING
if the attribute PDO::ATTR_ERRMODE
is set
to PDO::ERRMODE_WARNING
.
Throws a PDOException if the attribute PDO::ATTR_ERRMODE
is set to PDO::ERRMODE_EXCEPTION
.
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 resultado del ejemplo sería:
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)