mysqli::$affected_rows

mysqli_affected_rows

(PHP 5, PHP 7, PHP 8)

mysqli::$affected_rows -- mysqli_affected_rows直前の MySQL の操作で変更された行の数を得る

説明

オブジェクト指向型

手続き型

mysqli_affected_rows(mysqli $mysql): int|string

直近の INSERTUPDATEREPLACE あるいは DELETE クエリにより変更された行の数を返します。

SELECT 文の場合は、 mysqli_num_rows() と同じように動作します。

パラメータ

link

手続き型のみ: mysqli_connect() あるいは mysqli_init() が返す mysqliオブジェクト。

戻り値

正の整数が返された場合、それは変更された行数かあるいは取得された行数を 示します。ゼロが返された場合、それは UPDATE 文でレコードが更新されなかったか WHERE 条件に当てはまる行がなかった、またはクエリが実行されなかったことを 示します。-1 は、クエリがエラーを返したか、 mysqli_affected_rows() がバッファリングされていない SELECT に対してコールされたことを示します。

注意:

変更された行数が整数型の最大値 (PHP_INT_MAX) をこえた場合、 結果の行数は文字列として返されます。

例1 $mysqli->affected_rows の例

オブジェクト指向型

<?php

mysqli_report
(MYSQLI_REPORT_ERROR MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost""my_user""my_password""world");

/* 行を挿入します */
$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);

/* Language テーブルを削除します。 */
$mysqli->query("DROP TABLE Language");

手続き型

<?php

mysqli_report
(MYSQLI_REPORT_ERROR MYSQLI_REPORT_STRICT);
$link mysqli_connect("localhost""my_user""my_password""world");

/* 行を挿入します */
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));

/* Language テーブルを削除します。 */
mysqli_query($link"DROP TABLE Language");

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

Affected rows (INSERT): 984
Affected rows (UPDATE): 168
Affected rows (DELETE): 815
Affected rows (SELECT): 169

参考

関連キーワード:  mysqli, rows, た行, 変更, affected, 直前, 操作, , UPDATE, 取得