(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
mysqli_stmt::num_rows(): int|string
mysqli_stmt_num_rows(mysqli_stmt
$statement
): int|string
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