array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'mysqli-stmt.num-rows.php', 1 => 'mysqli_stmt::$num_rows', 2 => 'Retourne le nombre de lignes extraites du serveur', ), 'up' => array ( 0 => 'class.mysqli-stmt.php', 1 => 'mysqli_stmt', ), 'prev' => array ( 0 => 'mysqli-stmt.next-result.php', 1 => 'mysqli_stmt::next_result', ), 'next' => array ( 0 => 'mysqli-stmt.param-count.php', 1 => 'mysqli_stmt::$param_count', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/mysqli/mysqli_stmt/num-rows.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

Style procédural

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