Возвращает количество строк, полученных с сервера

# 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 — Возвращает количество строк, полученных с сервера

### Описание

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

int|string $mysqli_stmt->num_rows;
public function mysqli_stmt::num_rows(): int|string

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

function mysqli_stmt_num_rows(mysqli_stmt `$statement`): int|string

Возвращает количество строк, помещённых в буфер в выражении. Функция будет работать только после вызова mysqli_stmt_store_result() для буферизации всего набора результатов в дескрипторе оператора.

Функция возвращает `0`, если с сервера не были получены все строки.

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

`stmt`
  Только для процедурного стиля: объект mysqli_stmt, который вернула функция mysqli_stmt_init().

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

Целое число (int), представляющее количество буферизованных строк. Возвращает `0` в небуферизованном режиме, если с сервера не были получены все строки.

> Замечание: Если количество строк больше, чем `PHP_INT_MAX`, число будет возвращено как строка (string).

### Примеры

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

    <?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();

    /* сохранение результата во внутреннем буфере */
    $stmt->store_result();

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

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

    <?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);

    /* сохранение результата во внутреннем буфере */
    mysqli_stmt_store_result($stmt);

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

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

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

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

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open