PHP 8.4.0 RC4 available for testing

    mysqli_result::$num_rows

    mysqli_num_rows

    (PHP 5, PHP 7, PHP 8)

    mysqli_result::$num_rows -- mysqli_num_rows — Retourne le nombre de lignes dans le jeu de résultats

    Description

    Style orienté objet

    int|string $mysqli_result->num_rows;

    Style procédural

    mysqli_num_rows(mysqli_result $result): int|string

    Retourne le nombre de lignes dans un jeu de résultats.

    Le comportement de mysqli_num_rows() dépend de l'utilisation de jeux de résultats bufferisés ou non. Cette fonction renvoie 0 pour les ensembles de résultats non tamponnés, sauf si toutes les lignes ont été récupérées du serveur.

    Liste de paramètres

    result

    Style procédural uniquement : Un objet mysqli_result retourné par mysqli_query(), mysqli_store_result(), mysqli_use_result(), ou mysqli_stmt_get_result().

    Valeurs de retour

    Un entier représentant le nombre de lignes récupérées. Retourne 0 en mode non tamponné, sauf si toutes les lignes ont été récupérées depuis le serveur.

    Note:

    Si le nombre de ligne est supérieur à PHP_INT_MAX, le nombre sera retourné en tant que chaîne de caractères.

    Exemples

    Exemple #1 Style orienté objet

    <?php

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

    $result = $mysqli->query("SELECT Code, Name FROM Country ORDER BY Name");

    /* Détermine le nombre de lignes du jeu de résultats */
    $row_cnt = $result->num_rows;

    printf("Le jeu de résultats a %d lignes.\n", $row_cnt);

    Exemple #2 Style procédural

    <?php

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

    $result = mysqli_query($link, "SELECT Code, Name FROM Country ORDER BY Name");

    /* Détermine le nombre de lignes du jeu de résultats */
    $row_cnt = mysqli_num_rows($result);

    printf("Le jeu de résultats a %d lignes.\n", $row_cnt);
    ?>

    Les exemples ci-dessus vont afficher :

    Le jeu de résultats a 239 lignes.

    Notes

    Note:

    Contrairement à la fonction mysqli_stmt_num_rows(), cette fonction n'a pas de variante de méthode orientée objet. Dans le style orienté objet, utilisez le getter de la propriété.

    Voir aussi

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    116
    borisigna
    13 years ago
    If you have problems making work this num_rows, you have to declare ->store_result() first.

    <?php
    $mysqli     = new mysqli("localhost","root", "", "tables");

    $query = $mysqli->prepare("SELECT * FROM table1");
    $query->execute();
    $query->store_result();

    $rows = $query->num_rows;

    echo     $rows;

    // Return 4 for example
    ?>
    up
    4
    min0u
    7 years ago
    This function doesn't work with LIMIT used jointly with SQL_CALC_FOUND_ROWS. If you want to obtain the total rows found you must do it manually, example:

    <?php
    public function errorList(int $limit=25,int $offset=0){
    $errorList = array();
    $result = $this->con->query("SELECT SQL_CALC_FOUND_ROWS id, erreur FROM Erreurs ORDER BY id DESC LIMIT $limit OFFSET $offset");
    while(    $row = $result->fetch_assoc()){
    $errorList[] = new Erreur($row);
    }
    $result->free();
    // $foundRows = $result->num_rows; // 25
    $foundRows = $this->con->query("SELECT FOUND_ROWS() as foundRows");
    $this->foundRows = $foundRows->fetch_assoc(); // 178
    return $errorList;
    }
    ?>
    ＋add a note
    To Top