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_rowsDevuelve el número de filas recuperadas del servidor

Descripción

Estilo orientado a objetos

public mysqli_stmt::num_rows(): int|string

Estilo por procedimientos

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

stmt

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

Valores devueltos

Un entier 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:

If the number of rows is greater than PHP_INT_MAX, the number will be returned as a chaîne de caractères.

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 por procedimientos

<?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));
?>

El resultado de los ejemplos sería:

Número de filas: 20.

Ver también