Retorna o número de linhas afetadas pela operação MySQL anterior

# mysqli::$affected_rows

# mysqli_affected_rows

(PHP 5, PHP 7, PHP 8)

mysqli::$affected_rows -- mysqli_affected_rows — Retorna o número de linhas afetadas pela operação MySQL anterior

### Descrição

Estilo orientado a objetos

int|string $mysqli->affected_rows;

Estilo procedural

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

Retorna o número de linhas afetadas pelo último comando `INSERT`, `UPDATE`, `REPLACE` ou `DELETE`. Funciona como mysqli_num_rows() para consultas `SELECT`.

### Parâmetros

`mysql`
  Somente no estilo procedural: Um objeto mysqli retornado por mysqli_connect() ou mysqli_init()

### Valor Retornado

Um inteiro maior do que zero indica o número de linhas afetadas ou obtidas. Zero indica que nenhum registro foi atualizado por uma declaração `UPDATE`, nenhuma linha correspondeu à claúsula `WHERE` na consulta ou que nenhuma consulta foi executada ainda. `-1` indica que a consulta retornou um erro ou que mysqli_affected_rows() foi chamada para uma consulta `SELECT` sem buffer.

> Nota:

> Se o número de linhas afetadas for maior do que o maior valor inteiro (`PHP_INT_MAX`), o número de linhas afetadas será retornado como uma string.

### Exemplos

Exemplo #1 Exemplo de $mysqli->affected_rows

Estilo orientado a objetos

    <?php

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

    /* Insert rows */
    $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");

    /* update rows */
    $mysqli->query("UPDATE Language SET Status=1 WHERE Percentage > 50");
    printf("Affected rows (UPDATE): %d\n", $mysqli->affected_rows);

    /* delete rows */
    $mysqli->query("DELETE FROM Language WHERE Percentage < 50");
    printf("Affected rows (DELETE): %d\n", $mysqli->affected_rows);

    /* select all rows */
    $result = $mysqli->query("SELECT CountryCode FROM Language");
    printf("Affected rows (SELECT): %d\n", $mysqli->affected_rows);

    /* Delete table Language */
    $mysqli->query("DROP TABLE Language");

Estilo procedural

    <?php

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

    /* Insert rows */
    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");

    /* update rows */
    mysqli_query($link, "UPDATE Language SET Status=1 WHERE Percentage > 50");
    printf("Affected rows (UPDATE): %d\n", mysqli_affected_rows($link));

    /* delete rows */
    mysqli_query($link, "DELETE FROM Language WHERE Percentage < 50");
    printf("Affected rows (DELETE): %d\n", mysqli_affected_rows($link));

    /* select all rows */
    $result = mysqli_query($link, "SELECT CountryCode FROM Language");
    printf("Affected rows (SELECT): %d\n", mysqli_affected_rows($link));

    /* Delete table Language */
    mysqli_query($link, "DROP TABLE Language");

Os exemplos acima produzirão:

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

### Veja Também

- mysqli_num_rows() - Obtém o número de linhas no resultado
- mysqli_info() - Recupera informação sobre a recente consulta executada

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