MongoDB\Driver\WriteResult::getMatchedCount
En esta página
MongoDB\Driver\WriteResult::getMatchedCount
Devuelve el número de documentos seleccionados para la actualización
Descripción#
final public MongoDB\Driver\WriteResult::getMatchedCount(): int
```php
Si la operación de actualización no resulta en ninguna modificación del documento (por ejemplo, al establecer el valor de un campo en su valor actual), el número correspondiente puede ser mayor que el valor devuelto por MongoDB\Driver\WriteResult::getModifiedCount.
## Parámetros
Esta función no contiene ningún parámetro.
## Valores devueltos
Devuelve el número de documentos seleccionados para la actualización.
## Errores/Excepciones
Levanta una excepción
MongoDB\Driver\Exception\LogicException
si la escritura no ha sido reconocida.
Lanza una excepción
MongoDB\Driver\Exception\InvalidArgumentException
en caso de error durante el análisis de un argumento.
## Historial de cambios
| Versión | Descripción |
|----|----|
| PECL mongodb 2.0.0 | Este método ahora lanza una excepción cuando es llamado para una escritura no reconocida, en lugar de retornar `null`. |
## Ejemplos
Ejemplo con `MongoDB\Driver\WriteResult::getMatchedCount`
```php
Resultado del ejemplo anterior es similar a:
int(1)
Véase también#
MongoDB\Driver\WriteResult::getModifiedCount
MongoDB\Driver\WriteResult::isAcknowledged