PDOStatement::columnCount
PDOStatement::columnCount — Gibt die Anzahl der Spalten in der Ergebnismenge zurück. (PHP 5 >= 5.1.0, PECL pdo >= 0.2.0)
Beschreibung
Syntax
int PDOStatement::columnCount ( void )
PDOStatement::columnCount() gibt die Anzahl der Spalten in der durch das PDOStatement-Objekt dargestellten Ergebnismenge zurück.
Wenn das PDOStatement-Objekt von PDO::query() zurückgegeben wurde, ist die Spaltenanzahl sofort verfügbar.
Wenn das PDOStatement-Objekt von PDO::prepare() zurückgegeben wurde, kann die Spaltenanzahl erst dann genau berechnet werden, wenn PDOStatement::execute() aufgerufen wird.
Rückgabewerte
Gibt die Anzahl der Spalten in der durch das PDOStatement-Objekt dargestellten Ergebnismenge zurück. Wenn keine Ergebnismenge vorhanden ist, gibt PDOStatement::columnCount() 0 zurück.
Beispiele
Spalten zählen
Das folgende Beispiel zeigt, wie PDOStatement::columnCount() mit einer Ergebnismenge und einer leeren Menge verwendet wird.
<?php
$dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');
$sth = $dbh->prepare("SELECT name, colour FROM fruit");
/* 计算一个(不存在)的结果集中的列数 */
$colcount = $sth->columnCount();
print("Before execute(), result set has $colcount columns (should be 0)\n");
$sth->execute();
/* 计算结果集中的列数 */
$colcount = $sth->columnCount();
print("After execute(), result set has $colcount columns (should be 2)\n");
?>
Das obige Beispiel gibt Folgendes aus:
Before execute(), result set has 0 columns (should be 0) After execute(), result set has 2 columns (should be 2)
Andere Erweiterungen
PHP PDO-Referenzhandbuch