mysqli_stmt::$num_rows

mysqli_stmt::num_rows

mysqli_stmt_num_rows

(PHP 5, PHP 7)

mysqli_stmt::$num_rows -- mysqli_stmt::num_rows -- mysqli_stmt_num_rowsВозвращает число строк в результате запроса

Описание

Объектно-ориентированный стиль

mysqli_stmt::num_rows ( void ) : int

Процедурный стиль

mysqli_stmt_num_rows ( mysqli_stmt $stmt ) : int

Возвращает число строк в результате запроса. Результат выполнения mysqli_stmt_num_rows() зависит от того использовалась ли mysqli_stmt_store_result() для буферизации результата выборки в дескрипторе.

Если используется mysqli_stmt_store_result(), mysqli_stmt_num_rows() может быть вызвана в тот же момент.

Список параметров

stmt

Только для процедурного стиля: Идентификатор выражения, полученный с помощью mysqli_stmt_init().

Возвращаемые значения

Целое число, отражающее число строк в результате запроса.

Примеры

Пример #1 Объектно-ориентированный стиль

<?php
/* Открыть соединение */
$mysqli = new mysqli("localhost""my_user""my_password""world");

/* Проверить соединение */
if (mysqli_connect_errno()) {
    
printf("Ошибка соединения: %s\n"mysqli_connect_error());
    exit();
}

$query "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
if (
$stmt $mysqli->prepare($query)) {

    
/* Выполнить запрос */
    
$stmt->execute();

    
/* Сохранить результат */
    
$stmt->store_result();

    
printf("Число строк: %d.\n"$stmt->num_rows);

    
/* Закрыть выражение */
    
$stmt->close();
}

/* Закрыть соединение */
$mysqli->close();
?>

Пример #2 Процедурный стиль

<?php
/* Открыть соединение */
$link mysqli_connect("localhost""my_user""my_password""world");

/* Проверить соединение */
if (mysqli_connect_errno()) {
    
printf("Ошибка соединения: %s\n"mysqli_connect_error());
    exit();
}

$query "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
if (
$stmt mysqli_prepare($link$query)) {

    
/* Выполнить запрос */
    
mysqli_stmt_execute($stmt);

    
/* Сохранить результат */
    
mysqli_stmt_store_result($stmt);

    
printf("Число строк: %d.\n"mysqli_stmt_num_rows($stmt));

    
/* Закрыть выражение */
    
mysqli_stmt_close($stmt);
}

/* Закрыть соединение */
mysqli_close($link);
?>

Результат выполнения данных примеров:

Число строк: 20.

Смотрите также

  • mysqli_stmt_affected_rows() - Возвращает общее количество строк, измененных, удаленных или добавленных последним выполненным выражением
  • mysqli_prepare() - Подготавливает SQL выражение к выполнению
  • mysqli_stmt_store_result() - Передает результирующий набор запроса на клиента