PHP マニュアル
前のページ |  | 次のページ

# 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 を返します。

> 注意: SELECT 文に関しては、mysqli_affected_rows() は mysqli_num_rows() と同様の働きをします。

mysqli_affected_rows() 関数は、テーブルを修正する クエリでのみ使用できます。SELECT から返される行の数を得る際には、 mysqli_num_rows() を使用してください。

## 返り値

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

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

## 参考

mysqli_num_rows() そして mysqli_info().

## 例

例 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

前のページ | ホーム | 次のページ
MySQL 改良版拡張サポート（mysqli） | 上に戻る | mysqli_autocommit