# mysqli_stmt::$num_rows

# mysqli_stmt_num_rows

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::$num_rows -- mysqli_stmt_num_rows — Devuelve el número de filas de un conjunto de resultados de una sentencia

### Descripción

Estilo orientado a objetos

int $mysqli_stmt->num_rows;

Estilo por procedimientos

mysqli_stmt_num_rows(mysqli_stmt `$stmt`): int

Devuelve el número de filas de un conjunto de resultados. El uso de mysqli_stmt_num_rows() depende de si se utiliza mysqli_stmt_store_result() para almacenar en buffer el conjunto de resultados completo en el gestor de sentencia.

Si se usa mysqli_stmt_store_result(), mysqli_stmt_num_rows() puede llamarse inmediatamente.

### Parámetros

`stmt`

  Sólo estilo por procediminetos: Un identificador de declaraciones devuelto por mysqli_stmt_init().

### Valores devueltos

Un valor integer que representa el número de filas del conjunto de resultados.

### Ejemplos

Ejemplo #1 Estilo orientado a objetos

`<?php
/* Abrir una conexión */
$mysqli = new mysqli("localhost", "mi_usuario", "mi_contraseña", "world");
/* comprobar la conexión */
if (mysqli_connect_errno()) {
printf("Falló la conexión: %s\n", mysqli_connect_error());
exit();
}
$consulta = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
if ($sentencia = $mysqli->prepare($consulta)) {
/* ejecutar la consulta */
$sentencia->execute();
/* almacenar el resultado */
$sentencia->store_result();
printf("Número de filas: %d.\n", $sentencia->num_rows);
/* cerrar la sentencia */
$sentencia->close();
}
/* cerrar la conexión */
$mysqli->close();
?>`

Ejemplo #2 Estilo por procedimientos

`<?php
/* Abrir una conexión */
$enlace = mysqli_connect("localhost", "mi_usuario", "mi_contraseña", "world");
/* comprobar la conexión */
if (mysqli_connect_errno()) {
printf("Falló la conexión: %s\n", mysqli_connect_error());
exit();
}
$consulta = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
if ($sentencia = mysqli_prepare($enlace, $consulta)) {
/* ejecutar la consulta */
mysqli_stmt_execute($sentencia);
/* almacenar el resultado */
mysqli_stmt_store_result($sentencia);
printf("Número de filas: %d.\n", mysqli_stmt_num_rows($sentencia));
/* cerrar la sentencia */
mysqli_stmt_close($sentencia);
}
/* cerrar la conexión */
mysqli_close($enlace);
?>`

El resultado de los ejemplos sería:

    Número de filas: 20.

### Ver también

- mysqli_stmt_affected_rows() - Devuelve el número total de filas cambiadas, borradas, o insertadas por la última sentencia ejecutada
- mysqli_prepare() - Prepara una sentencia SQL para su ejecución
- mysqli_stmt_store_result() - Transfiere un conjunto de resultados desde una sentencia preparada