php8.5
Home/ Manual/ mysqli / mysqli_result/ mysqli_result::$num_rows

mysqli_result::$num_rows

PHP function Edit on GitHub ✎

Gets the number of rows in the result set

Description

Oop

int|stringmysqli_result->num_rows

Procedural

mysqli_num_rows(mysqli_result $result): int|string

Returns the number of rows in the result set.

The behaviour of mysqli_num_rows() depends on whether buffered or unbuffered result sets are being used. This function returns 0 for unbuffered result sets unless all rows have been fetched from the server.

Parameters

Return Values

An Integer representing the number of fetched rows. Returns 0 in unbuffered mode unless all rows have been fetched from the server.

Note

Examples

Oop

php
<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

$result = $mysqli->query("SELECT Code, Name FROM Country ORDER BY Name");

/* Get the number of rows in the result set */
$row_cnt = $result->num_rows;

printf("Result set has %d rows.\n", $row_cnt);

Procedural

php
<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

$result = mysqli_query($link, "SELECT Code, Name FROM Country ORDER BY Name");

/* Get the number of rows in the result set */
$row_cnt = mysqli_num_rows($result);

printf("Result set has %d rows.\n", $row_cnt);

Outputs

output
Result set has 239 rows.

Notes

Note

In contrast to the mysqli_stmt_num_rows() function, this function doesn't have an object-oriented method variant. In the object-oriented style, use the getter property.

See Also

Source: reference/mysqli/mysqli_result/num-rows.xml · from the official PHP manual (php/doc-en)