PDO::exec
PDO::exec — SQL 文を実行し、影響を受けた行数を返します(PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
説明
構文
int PDO::exec ( string $statement )
PDO::exec() は、単一の関数呼び出しで SQL 文を実行し、その文の影響を受けた行数を返します。
PDO::exec() は SELECT 文から結果を返しません。プログラム内で一度だけ発行する SELECT 文の場合は、PDO::query() の使用を検討してください。
パラメータ説明:
statement:準備および実行される SQL 文。
戻り値
PDO::exec() は、SQL 文によって変更または削除された行数を返します。影響を受けた行がない場合、PDO::exec() は 0 を返します。
以下の例は PDO::exec() の戻り値に依存しているため正しくありません。影響を受けた行数が 0 の文は die() を呼び出すことになります。
<?php $db->exec() or die(print_r($db->errorInfo(), true)); ?>
例
DELETE 文を実行する
WHERE 句のない DELETE 文によって削除された行数を計算します。
<?php
$dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');
/* 删除 FRUIT 数据表中满足条件的所有行 */
$count = $dbh->exec("DELETE FROM fruit WHERE colour = 'red'");
/* 返回被删除的行数 */
print("Deleted $count rows.\n");
?>
上記の例は次のように出力します:
Deleted 1 rows.
その他の拡張
PHP PDO リファレンスマニュアル