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 — Retorna o número de linhas recebidas pelo servidor

Descrição

Estilo orientado a objetos

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

Estilo procedural

mysqli_stmt_num_rows(mysqli_stmt $statement): int|string

Retorna o número de linhas em buffer na instrução. Esta função somente funcionará depois que mysqli_stmt_store_result() for chamara para fazer buffer do conjunto inteiro de resultados no manipulador da instrução.

Esta função retorna 0 a menos que todas as linhas tenham sido recebidas do servidor.

Parâmetros

statement

Somente no estilo procedural: Um objeto mysqli_stmt retornado por mysqli_stmt_init().

Valor Retornado

Um int que representa o número de linhas em buffer. Retorna 0 em modo sem buffer a menos que todas as linhas tenham sido recebidas do servidor.

Note:

Se o número de linhas for maior que PHP_INT_MAX, o número será retornado como uma string.

Exemplos

Example #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();

/* armazena o resultado em um buffer interno */
$stmt->store_result();

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

Example #2 Estilo procedural

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

/* armazena o resultado em um buffer interno */
mysqli_stmt_store_result($stmt);

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

Os exemplos acima produzirão:

Número de linhas: 20.

Veja Também