mysqli::$affected_rows

mysqli_affected_rows

(PHP 5, PHP 7, PHP 8)

mysqli::$affected_rows -- mysqli_affected_rows — Отримує кількість рядків, які стосуються попередньої операції MySQL

Опис

Об'єктно-орієнтований стиль

int|string$mysqli->affected_rows

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

mysqli_affected_rows(mysqli $mysql): int|string

Повертає кількість рядків, які торкнулися останнім запитом INSERT UPDATE REPLACEилиDELETE. Працює аналогічно mysqli_num_rows() для виразів SELECT

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

mysql

Тільки для процедурного стилю: об'єкт mysqli, який повернула функція mysqli_connect()или функцияmysqli_init()

Значення, що повертаються

Ціле число, більше нуля, означає кількість порушених чи отриманих рядків. Нуль означає, що записи для оператора UPDATE не оновлювалися, жодний рядок не відповідав виразу WHERE у запиті або що жодного запиту ще не було виконано . -1 означає, що під час виконання запиту сталася помилка або що mysqli_affected_rows() була викликана для небуферизованого запиту SELECT

Зауваження :

Якщо число порушених рядків більше, ніж максимальне значення цілого числа (PHP_INT_MAX), то число порушених рядків буде повернено у вигляді рядка.

Приклади

Приклад #1 Приклад використання $mysqli->affected_rows

Об'єктно-орієнтований стиль

Loading...
▶

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

Loading...
▶

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

Затронутые строки (INSERT): 984
Затронутые строки (UPDATE): 168
Затронутые строки (DELETE): 815
Затронутые строки (SELECT): 169

Дивіться також

• mysqli_num_rows() - Отримує кількість рядків у наборі результатів
• mysqli_info() - Витягує інформацію про останній виконаний запит