mysqli_result::$num_rows
mysqli_num_rows
(PHP 5)
mysqli_result::$num_rows -- mysqli_num_rows — Retourne le nombre de lignes dans un résultat
Description
Style orienté objet
Style procédural
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. Pour les jeux de résultats non bufferisés, mysqli_num_rows() ne retournera pas le nombre correct de lignes tant que toutes les lignes du jeu de résultats ne sont pas retournées.
Liste de paramètres
-
result
-
Style procédural uniquement : Un identifiant de jeu de résultats retourné par la fonction mysqli_query(), mysqli_store_result() ou mysqli_use_result().
Valeurs de retour
Retourne le nombre de lignes dans le jeu de résultats.
Note:
Si le nombre de résultats est plus grand que
MAXINT
, le nombre sera retourné sous la forme d'une chaîne de caractères.
Exemples
Exemple #1 Style orienté objet
<?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } if ($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); /* Ferme le jeu de résultats */ $result->close(); } /* Ferme la connexion */ $mysqli->close(); ?>
Exemple #2 Style procédural
<?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } if ($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); /* Ferme le jeu de résultats */ mysqli_free_result($result); } /* Ferme la connexion */ mysqli_close($link); ?>
Les exemples ci-dessus vont afficher :
Le jeu de résultats a 239 lignes.
Voir aussi
- mysqli_affected_rows() - Retourne le nombre de lignes affectées par la dernière opération MySQL
- mysqli_store_result() - Transfère un jeu de résultats à partir de la dernière requête
- mysqli_use_result() - Initialise la récupération d'un jeu de résultats
- mysqli_query() - Exécute une requête sur la base de données