array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'pdostatement.columncount.php', 1 => 'PDOStatement::columnCount', 2 => 'Liefert die Anzahl der Spalten in der Ergebnismenge', ), 'up' => array ( 0 => 'class.pdostatement.php', 1 => 'PDOStatement', ), 'prev' => array ( 0 => 'pdostatement.closecursor.php', 1 => 'PDOStatement::closeCursor', ), 'next' => array ( 0 => 'pdostatement.debugdumpparams.php', 1 => 'PDOStatement::debugDumpParams', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/pdo/pdostatement/columncount.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

PDOStatement::columnCount

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

PDOStatement::columnCount — Liefert die Anzahl der Spalten in der Ergebnismenge

Beschreibung

public PDOStatement::columnCount(): int

PDOStatement::columnCount() gibt die Anzahl der Spalten in der Ergebnismenge zurück, die durch das PDOStatement-Objekt repräsentiert wird.

Wenn das PDOStatement-Objekt von PDO::query() zurückgegeben wurde, ist die Anzahl der Spalten sofort verfügbar.

Wurde das PDOStatement-Objekt von PDO::prepare() zurückgegeben, ist die genaue Anzahl der Spalten erst verfügbar, nachdem PDOStatement::execute() aufgerufen wurde.

Parameter-Liste

Diese Funktion besitzt keine Parameter.

Rückgabewerte

Gibt die Anzahl der Spalten in der Ergebnismenge zurück, die durch das PDOStatement-Objekt repräsentiert wird, auch wenn die Ergebnismenge leer ist. Wenn es keine Ergebnismenge gibt, gibt PDOStatement::columnCount() 0 zurück.

Fehler/Exceptions

Gibt einen Fehler der Stufe E_WARNING aus, wenn das Attribut PDO::ATTR_ERRMODE auf PDO::ERRMODE_WARNING gesetzt ist.

Löst eine PDOException aus, wenn das Attribut PDO::ATTR_ERRMODE auf PDO::ERRMODE_EXCEPTION gesetzt ist.

Beispiele

Beispiel #1 Zählen der Spalten

In diesem Beispiel wird gezeigt, wie PDOStatement::columnCount() mit und ohne Ergebnismenge funktioniert.

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

$sth = $dbh->prepare("SELECT name, colour FROM fruit");

/* Zählen der Anzahl der Spalten in der (nicht vorhandenen) Ergebnismenge */
$colcount = $sth->columnCount();
print "Vor execute() hat die Ergebnismenge $colcount Spalten (sollte 0 sein)\n";

$sth->execute();

/* Zählen der Anzahl der Spalten in der Ergebnismenge */
$colcount = $sth->columnCount();
print "Nach execute() hat die Ergebnismenge $colcount Spalten (sollte 2 sein)\n";

?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Vor execute() hat die Ergebnismenge 0 Spalten (sollte 0 sein)
Nach execute() hat die Ergebnismenge 2 Spalten (sollte 2 sein)

Siehe auch