Retourne le nombre de lignes extraites du serveur

# 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 — Retourne le nombre de lignes extraites du serveur

### Description

Style orienté objet

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

Style procédural

function mysqli_stmt_num_rows(mysqli_stmt `$statement`): int|string

Retourne le nombre de lignes mises en mémoire tampon dans l'instruction. Cette fonction ne fonctionnera qu'après l'appel de mysqli_stmt_store_result() pour mettre en mémoire tampon l'ensemble des résultats dans le handle de l'instruction.

Cette fonction retourne `0` à moins que toutes les lignes aient été récupérées du serveur.

### Liste de paramètres

`statement`
  Style procédural uniquement : Un objet mysqli_stmt retourné par la fonction mysqli_stmt_init().

### Valeurs de retour

Un entier représentant le nombre de lignes mises en mémoire tampon. Retourne `0` en mode non tamponné, sauf si toutes les lignes ont été récupérées du 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");

    $query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";

    $stmt = $mysqli->prepare($query);
    $stmt->execute();

    /* Stocker le résultat dans un tampon interne */
    $stmt->store_result();

    printf("Nombre de lignes : %d.\n", $stmt->num_rows);
    ?>

Exemple #2 Style procédural

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

    /* Stocker le résultat dans un tampon interne */
    mysqli_stmt_store_result($stmt);

    printf("Nombre de lignes : %d.\n", mysqli_stmt_num_rows($stmt));
    ?>

Les exemples ci-dessus vont afficher :

    Nombre de lignes : 20.

### Voir aussi

- mysqli_stmt_store_result() - Stocke un ensemble de résultats dans un tampon interne
- mysqli_stmt_affected_rows() - Retourne le nombre total de lignes modifiées, effacées, insérées, ou correspondant par la dernière requête
- mysqli_prepare() - Prépare une requête SQL pour l'exécution

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