MongoDB\BulkWriteResult::getMatchedCount()

定义

MongoDB\BulkWriteResult::getMatchedCount()

返回批量写入中与所有更新和替换操作匹配的文档总数。

function getMatchedCount(): integer

仅当写入已确认时才应调用此方法。

注意

如果更新/替换操作没有导致文档发生任何更改（例如 将字段的值设置为其当前值）时，匹配的计数可能大于getModifiedCount()返回的值。

返回值

批量写入中与所有更新和替换操作匹配的文档总数。

错误/异常

MongoDB\Exception\BadMethodCallException如果调用此方法并且写入操作使用了未确认的 写关注）。

另请参阅

• MongoDB\BulkWriteResult::getModifiedCount()

• MongoDB\Driver\WriteResult::getMatchedCount()