Last updated: Fri, 13 Nov 2009

PDOStatement->fetchColumn

(PHP 5 >= 5.1.0, PECL pdo >= 0.9.0)

PDOStatement->fetchColumn — 結果セットの次行から単一カラムを返す

説明

string PDOStatement::fetchColumn ([ int $column_number = 0 ] )

結果セットの次行から単一カラムを返します。行がもうない場合には FALSE を返します。

パラメータ

column_number: 行から処理したい 0 で始まるカラム番号を指定します。何も値が与えられない場合、 PDOStatement::fetchColumn() は最初のカラムをフェッチします。

返り値

PDOStatement::fetchColumn() は結果セットの次行から単一カラムを返します。

警告

PDOStatement::fetchColumn() を使用してデータを処理する場合、同一行から他のカラムを返す方法はありません。

例

例1 次行の最初のカラムを返す


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

/* 結果セットの次行から最初のカラムをフェッチする */
print("Fetch the first column from the next row in the result set:\n");
$result = $sth->fetchColumn();
print("name = $result\n");

print("Fetch the second column from the next row in the result set:\n");
$result = $sth->fetchColumn(1);
print("colour = $result\n");
?>

上の例の出力は以下となります。

Fetch the first column from the next row in the result set:
name = lemon
Fetch the second column from the next row in the result set:
colour = red

参考

PDO::query() - SQL ステートメントを実行し、結果セットを PDOStatement オブジェクトとして返す
PDOStatement::fetch() - 結果セットから次の行を取得する
PDOStatement::fetchAll() - 全ての結果行を含む配列を返す
PDO::prepare() - 文を実行する準備を行い、文オブジェクトを返す
PDOStatement::setFetchMode() - この文に対するデフォルトのフェッチモードを設定する

add a note User Contributed Notes
PDOStatement->fetchColumn

seanferd at assmasterdonkeyranch dot com
25-Jan-2007 11:04


This is an excellent method for returning a column count. For example:





<?php


$db = new PDO('mysql:host=localhost;dbname=pictures','user','password');


$pics = $db->query('SELECT COUNT(id) FROM pics');


$this->totalpics = $pics->fetchColumn();


$db = null;


?>


In my case $pics->fetchColumn() returns 641 because that is how many pictures I have in my db.

add a note

PDOStatement->fetchObject

PDOStatement->fetchAll

Last updated: Fri, 13 Nov 2009