mysqli_stmt::$affected_rows

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Descripción#
Véase también#

mysqli_stmt::\$affected_rows

mysqli_stmt_affected_rows

Devuelve el número total de filas modificadas, eliminadas, insertadas o coincidentes por la última consulta

Descripción#

Estilo orientado a objetos

int

string

mysqli_stmt->affected_rows

Estilo procedimental

mysqli_stmt_affected_rows(mysqli_stmt $statement): int
```php

Devuelve el número de filas afectadas por una consulta `INSERT`, `UPDATE` o `DELETE`.

Funciona como `mysqli_stmt_num_rows` para las consultas `SELECT`.

## Parámetros

`statement`  
Solo estilo procedimental: Un objeto `mysqli_stmt` devuelto por `mysqli_stmt_init`.

## Valores devueltos

Un entero mayor que cero indica el número de filas afectadas o recuperadas. Cero indica que ningún registro fue modificado por una consulta de tipo `UPDATE`, ninguna fila coincide con la cláusula `WHERE` en la consulta o que ninguna consulta fue ejecutada. `-1` indica que la consulta devolvió un error o que, para una consulta `SELECT`, `mysqli_stmt_affected_rows` fue llamado antes de llamar `mysqli_stmt_store_result`.

> [!NOTE]
> Si el número de filas afectadas es mayor que el valor máximo de un entero PHP, el número de filas afectadas será devuelto como una cadena de caracteres.

## Ejemplos

Ejemplo de mysqli_stmt_affected_rows

Estilo orientado a objetos

query("CREATE TEMPORARY TABLE myCountry LIKE Country"); $query = "INSERT INTO myCountry SELECT * FROM Country WHERE Code LIKE ?"; /* Preparación de la consulta */ $stmt = $mysqli->prepare($query); /* Vincula una variable a un parámetro ficticio */ $code = 'A%'; $stmt->bind_param("s", $code); /* Ejecución de la consulta */ $stmt->execute(); printf("Filas insertadas: %d\n", $stmt->affected_rows); ?>

Estilo procedimental

```php

El ejemplo anterior mostrará:

Filas insertadas: 17

Véase también#

mysqli_stmt_num_rows, mysqli_stmt_store_result