MongoDB\Driver\WriteResult::getModifiedCount
(mongodb >=1.0.0)
MongoDB\Driver\WriteResult::getModifiedCount — Повертає кількість існуючих оновлених документів
Опис
final public MongoDB\Driver\WriteResult::getModifiedCount(): ?int
Якщо операція оновлення не призводить до зміни документа (наприклад, встановлення значення поля в його поточне значення), змінене число може бути менше, ніж значення, що повертається MongoDB\Driver\WriteResult::getMatchedCount()
Список параметрів
Ця функція не має параметрів.
Значення, що повертаються
Повертає кількість існуючих оновлених документів або null, якщо запис не було підтверджено.
Змінений лічильник недоступний у версіях MongoDB до версії 2.6, де використовувалася застаріла версія проводового протоколу (тобто OP_UPDATE). У цьому випадку змінена кількість також дорівнюватиме null
Помилки
- При помилці парсингу аргумент кидає винятокMongoDB\Driver\Exception\InvalidArgumentException
Приклади
Приклад #1 Приклад використання MongoDB\Driver\WriteResult::getModifiedCount()****
Результат виконання наведеного прикладу:
int(1)
Дивіться також
- MongoDB\Driver\WriteResult::getMatchedCount() - Повертає кількість документів, вибраних для оновлення
- MongoDB\Driver\WriteResult::isAcknowledged() - Повертає, чи був запис підтверджений