Definición
MongoDB\UpdateResult::getMatchedCount()Devuelve el número de documentos que se encontraron.
function getMatchedCount(): integer Este método solo debe llamarse si se reconoció el guardado.
Nota
Si una operación de actualizar/sustituir no produce ningún cambio en el documento (por ejemplo, establecer el valor de un campo en su valor actual), el recuento coincidente puede ser mayor que el valor devuelto por
getModifiedCount().
Return Values
El número de documentos que coincidieron.
Errores/Excepciones
MongoDB\Exception\BadMethodCallException si se llama a este método y la operación de guardar utilizó una operación no reconocida nivel de confirmación de escritura (write concern).