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;
    publicmysqli_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.

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


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


    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

    To Top