Devuelve el número de filas recuperadas del servidor

# mysqli_stmt::$num_rows

# mysqli_stmt::num_rows

# mysqli_stmt_num_rows

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::$num_rows -- mysqli_stmt::num_rows -- mysqli_stmt_num_rows — Devuelve el número de filas recuperadas del servidor

### Descripción

Estilo orientado a objetos

int|string $mysqli_stmt->num_rows;
public function mysqli_stmt::num_rows(): int|string

Estilo procedimental

function mysqli_stmt_num_rows(mysqli_stmt `$statement`): int|string

Devuelve el número de filas almacenadas en el búfer en la instrucción. Esta función solo funcionará después de llamar a mysqli_stmt_store_result() para almacenar en el búfer el conjunto completo de resultados en el gestor de la instrucción.

Esta función devuelve `0` a menos que todas las filas hayan sido recuperadas del servidor.

### Parámetros

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

### Valores devueltos

Un int que representa el número de filas almacenadas en el búfer. Devuelve `0` en modo no almacenado en búfer, excepto si todas las filas han sido recuperadas del servidor.

> Nota: Si el número de filas es mayor que `PHP_INT_MAX`, el número será devuelto como un string.

### Ejemplos

Ejemplo #1 Estilo orientado a objetos

    <?php

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

    $query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";

    $stmt = $mysqli->prepare($query);
    $stmt->execute();

    /* Almacenar el resultado en un búfer interno */
    $stmt->store_result();

    printf("Número de filas: %d.\n", $stmt->num_rows);
    ?>

Ejemplo #2 Estilo procedimental

    <?php

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

    $query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";

    $stmt = mysqli_prepare($link, $query);
    mysqli_stmt_execute($stmt);

    /* Almacenar el resultado en un búfer interno */
    mysqli_stmt_store_result($stmt);

    printf("Número de filas: %d.\n", mysqli_stmt_num_rows($stmt));
    ?>

Los ejemplos anteriores mostrarán:

    Número de filas: 20.

### Ver también

- mysqli_stmt_store_result() - Almacena un conjunto de resultados en un búfer interno
- mysqli_stmt_affected_rows() - Devuelve el número total de filas modificadas, eliminadas, insertadas o coincidentes por la última consulta
- mysqli_prepare() - Prepara una consulta SQL para su ejecución

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