直前の MySQL の操作で変更された行の数を得る

# mysqli::$affected_rows

# mysqli_affected_rows

(PHP 5, PHP 7, PHP 8)

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

### 説明

オブジェクト指向型

int|string $mysqli->affected_rows;

手続き型

function mysqli_affected_rows(mysqli `$mysql`): int|string

直近の `INSERT`、 `UPDATE`、`REPLACE` あるいは `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_num_rows() - 結果セットの行数を取得する
- mysqli_info() - 直近に実行されたクエリの情報を取得する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open