Documentación offline PHP master

MongoDB\Driver\WriteResult::getMatchedCount

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

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`
insert(['x' => 1]); $bulk->update(['x' => 1], ['$set' => ['y' => 3]]); $bulk->update(['x' => 2], ['$set' => ['y' => 1]], ['upsert' => true]); $bulk->update(['x' => 3], ['$set' => ['y' => 2]], ['upsert' => true]); $bulk->delete(['x' => 1]); $result = $manager->executeBulkWrite('db.collection', $bulk); var_dump($result->getMatchedCount()); ?>

```php

Resultado del ejemplo anterior es similar a:

int(1)

Véase también#

MongoDB\Driver\WriteResult::getModifiedCount

MongoDB\Driver\WriteResult::isAcknowledged