(PHP 5 >= 5.1.0,PHP 7,PHP 8,PECL pdo >= 0.2.0)
PDOStatement::columnCount — 返回结果集中的列数
使用 PDOStatement::columnCount() 返回由 PDOStatement 对象表示的结果集中的列数。
如果 PDOStatement 对象是由 PDO::query() 返回的,则列数立即可用。
如果 PDOStatement 对象是由 PDO::prepare() 返回的,则在调用 PDOStatement::execute() 之前,无法获得准确的列数。
此函数没有参数。
返回由 PDOStatement 对象表示的结果集中的列数,即使结果集为空也是如此。如果没有结果集,PDOStatement::columnCount() 返回 0
。
如果属性 PDO::ATTR_ERRMODE
设置为 PDO::ERRMODE_WARNING
,则发出级别为 E_WARNING
的错误。
如果属性 PDO::ATTR_ERRMODE
设置为 PDO::ERRMODE_EXCEPTION
,则抛出 PDOException。
示例 #1 统计列数
此示例演示了 PDOStatement::columnCount() 在有和没有结果集的情况下如何操作。
<?php
$dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
/* 统计(不存在的)结果集中的列数 */
$colcount = $sth->columnCount();
print "在 execute() 之前,结果集有 $colcount 列(应该为 0)\n";
$sth->execute();
/* 统计结果集中的列数 */
$colcount = $sth->columnCount();
print "在 execute() 之后,结果集有 $colcount 列(应该为 2)\n";
?>
以上示例将输出
Before execute(), result set has 0 columns (should be 0) After execute(), result set has 2 columns (should be 2)