mysqli_stmt::$affected_rows
mysqli_stmt_affected_rows
(PHP 5, PHP 7, PHP 8)
mysqli_stmt::$affected_rows -- mysqli_stmt_affected_rows - Повертає загальну кількість рядків, змінених, віддалених, вставлених або зіставлених останнім виконаним виразом
Опис
Об'єктно-орієнтований стиль
int|string$mysqli_stmt->affected_rows
Процедурний стиль
mysqli_stmt_affected_rows(mysqli_stmt $statement): int|string
Повертає кількість рядків, змінених запитом INSERT UPDATEилиDELETE. Працює аналогічно mysqli_stmt_num_rows() для виразів SELECT
Список параметрів
stmt
Тільки для процедурного стилю: об'єкт mysqli_stmt, який повернула функція mysqli_stmt_init()
Значення, що повертаються
Ціле число більше за нуль вказує кількість порушених або витягнутих рядків. Нуль означає, що записи для оператора UPDATE не оновлювалися, жодний рядок не відповідав виразу WHERE у запиті або що жодного запиту ще не було виконано . -1 означає, що під час виконання запиту сталася помилка або для запиту SELECT mysqli_stmt_affected_rows() була викликана до виклику mysqli_stmt_store_result()
Зауваження :
Якщо кількість змінених рядків більша за максимальне значення для цілого числа в PHP, то ця кількість буде повернена у вигляді рядкового значення.
Приклади
Приклад #1 Приклад використання mysqli_stmt_affected_rows()****
Об'єктно-орієнтований стиль
Процедурний стиль
Результат виконання наведених прикладів:
Добавлено строк: 17
Дивіться також
- mysqli_stmt_num_rows() - Повертає кількість рядків, отриманих із сервера
- mysqli_stmt_store_result() - Зберігає набір результатів у внутрішньому буфері