mysqli_affected_rows
(PHP 5)
mysqli_affected_rows
(no version information, might be only in CVS)
mysqli->affected_rows -- 直前の MySQL の操作で変更された行の数を得る
説明
手続き型:
int
mysqli_affected_rows ( mysqli link )
オブジェクト指向型（プロパティ）:
class
mysqli {
int affected_rows
}
mysqli_affected_rows() は、指定した link
に関連する直近の INSERT、UPDATE、DELETE クエリにより変更された行の数を
返します。直前のクエリが無効の場合に -1 を返します。
mysqli_affected_rows() 関数は、テーブルを修正する
クエリでのみ使用できます。SELECT から返される行の数を得る際には、
mysqli_num_rows() を使用してください。
返り値
正の整数が返された場合、それは変更された行数かあるいは取得された行数を
示します。ゼロが返された場合、それは UPDATE 文でレコードが更新されなかったか
WHERE 条件に当てはまる行がなかった、またはクエリが実行されなかったことを
示します。-1 は、クエリがエラーを返したことを示します。
注意:
変更された行数が整数型の最大値をこえた場合、結果の行数は
文字列として返されます。
例
例 1. オブジェクト指向型
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* 接続状況をチェックします */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
/* 行を挿入します */
$mysqli->query("CREATE TABLE Language SELECT * from CountryLanguage");
printf("Affected rows (INSERT): %d\n", $mysqli->affected_rows);
$mysqli->query("ALTER TABLE Language ADD Status int default 0");
/* 行を更新します */
$mysqli->query("UPDATE Language SET Status=1 WHERE Percentage > 50");
printf("Affected rows (UPDATE): %d\n", $mysqli->affected_rows);
/* 行を削除します */
$mysqli->query("DELETE FROM Language WHERE Percentage < 50");
printf("Affected rows (DELETE): %d\n", $mysqli->affected_rows);
/* すべての行を選択します */
$result = $mysqli->query("SELECT CountryCode FROM Language");
printf("Affected rows (SELECT): %d\n", $mysqli->affected_rows);
$result->close();
/* Language テーブルを削除します */
$mysqli->query("DROP TABLE Language");
/* 接続を閉じます */
$mysqli->close();
?>
|
|
例 2. 手続き型
<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
if (!$link) {
printf("Can't connect to localhost. Error: %s\n", mysqli_connect_error());
exit();
}
/* 行を挿入します */
mysqli_query($link, "CREATE TABLE Language SELECT * from CountryLanguage");
printf("Affected rows (INSERT): %d\n", mysqli_affected_rows($link));
mysqli_query($link, "ALTER TABLE Language ADD Status int default 0");
/* 行を更新します */
mysqli_query($link, "UPDATE Language SET Status=1 WHERE Percentage > 50");
printf("Affected rows (UPDATE): %d\n", mysqli_affected_rows($link));
/* 行を削除します */
mysqli_query($link, "DELETE FROM Language WHERE Percentage < 50");
printf("Affected rows (DELETE): %d\n", mysqli_affected_rows($link));
/* すべての行を選択します */
$result = mysqli_query($link, "SELECT CountryCode FROM Language");
printf("Affected rows (SELECT): %d\n", mysqli_affected_rows($link));
mysqli_free_result($result);
/* Language テーブルを削除します */
mysqli_query($link, "DROP TABLE Language");
/* 接続を閉じます */
mysqli_close($link);
?>
|
|
上の例の出力は以下となります。
Affected rows (INSERT): 984
Affected rows (UPDATE): 168
Affected rows (DELETE): 815
Affected rows (SELECT): 169 |