Php/docs/mysqli.affected-rows

提供:Dev Guides
< Php
移動先:案内検索

mysqli::$affected_rows

mysqli_affected_rows

(PHP 5, PHP 7)

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


説明

オブジェクト指向型

int $mysqli->affected_rows;

手続き型

mysqli_affected_rows ( mysqli $link ) : int

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

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


パラメータ

link
手続き型のみ: mysqli_connect() あるいは mysqli_init() が返すリンク ID。


返り値

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

注意:

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

例1 $mysqli->affected_rows の例

オブジェクト指向型


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

手続き型


<?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

参考