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() |