PDO::exec

(no version information, might be only in CVS)

PDO::exec --  SQL 文を実行し、作用した行数を返す

説明

long PDO::exec ( string statement )

警告

この関数は、 実験的なステータスにあります。これは、この関数の 動作、関数名、ここで書かれていること全てがPHPの将来のバージョンで予告 なく変更される可能性があることを意味します。注意を喚起するとともに自分 のリスクでこの関数を使用してください。

PDO::exec() は、一度の関数コールで SQL 文を準備、実行し、文によって作用した行数を返します。

PDO::exec() は SELECT 文からは結果を返しません。 プログラム中で一度だけ発行が必要になる SELECT 文に対しては、 PDO::query() の発行を検討してください。 複数回発行が必要な SELECT 文については、PDO::prepare() による PDOStatement オブジェクトの準備と PDOStatement::execute() による文の発行を行ってください。

パラメータ

statement

準備、実行する SQL 文を指定します。

戻り値

PDO::exec() は、発行した SQL 文によって更新もしくは 削除された行数を返します。 1 行も作用しなかった場合、PDO::exec()0 を返します。

例 1. DELETE 文の発行

WHERE 句を伴う DELETE 文によって削除された行数をカウントします。

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

/* FRUIT テーブルから全ての行を削除する */
$count = $dbh->exec("DELETE FROM fruit WHERE colour = 'red'");

/* 削除された行数を返す */
print("Return number of rows that were deleted:\n");
print(
"Deleted $count rows.\n");
?>

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

Return number of rows that were deleted:
Deleted 1 rows.

以下も参照ください

PDO::prepare()
PDO::query()
PDOStatement::execute()