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