MYSQLI_STMT_NUM_ROWS(3) 1 MYSQLI_STMT_NUM_ROWS(3)
mysqli_stmt::$num_rows - Return the number of rows in statements result set
Object oriented style
SYNOPSIS
int$mysqli_stmt->num_rows ()
DESCRIPTION
Procedural style
int mysqli_stmt_num_rows (mysqli_stmt $stmt)
Returns the number of rows in the result set. The use of mysqli_stmt_num_rows(3) depends on whether or not you used
mysqli_stmt_store_result(3) to buffer the entire result set in the statement handle.
If you use mysqli_stmt_store_result(3), mysqli_stmt_num_rows(3) may be called immediately.
PARAMETERS
o $
stmt -Procedural style only: A statement identifier returned by mysqli_stmt_init(3).
RETURN VALUES
An integer representing the number of rows in result set.
EXAMPLES
Example #1
Object oriented style
<?php
/* Open a connection */
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* check connection */
if (mysqli_connect_errno()) {
printf("Connect failed: %s
", mysqli_connect_error());
exit();
}
$query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
if ($stmt = $mysqli->prepare($query)) {
/* execute query */
$stmt->execute();
/* store result */
$stmt->store_result();
printf("Number of rows: %d.
", $stmt->num_rows);
/* close statement */
$stmt->close();
}
/* close connection */
$mysqli->close();
?>
Example #2
Procedural style
<?php
/* Open a connection */
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* check connection */
if (mysqli_connect_errno()) {
printf("Connect failed: %s
", mysqli_connect_error());
exit();
}
$query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
if ($stmt = mysqli_prepare($link, $query)) {
/* execute query */
mysqli_stmt_execute($stmt);
/* store result */
mysqli_stmt_store_result($stmt);
printf("Number of rows: %d.
", mysqli_stmt_num_rows($stmt));
/* close statement */
mysqli_stmt_close($stmt);
}
/* close connection */
mysqli_close($link);
?>
The above examples will output:
Number of rows: 20.
SEE ALSO
mysqli_stmt_affected_rows(3), mysqli_prepare(3), mysqli_stmt_store_result(3).
PHP Documentation Group MYSQLI_STMT_NUM_ROWS(3)
