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

### Descrição

Estilo orientado a objetos

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

Estilo procedural

function 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.

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

### Exemplos

Exemplo #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);

Exemplo #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

- mysqli_stmt_store_result() - Armazena um conjunto de resultados em um buffer interno
- mysqli_stmt_affected_rows() - Retorna o número total de linhas modificadas, apagadas, inseridas ou correspondidas pela última instrução executada
- mysqli_prepare() - Prepara uma instrução SQL para execução

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