(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 contiene ningún parámetro.
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
.
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
.
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)