Documentación offline PHP master

MongoDB\Driver\BulkWriteCommandResult::getMatchedCount

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

En esta página

MongoDB\Driver\BulkWriteCommandResult::getMatchedCount

Devuelve el número de documentos seleccionados para actualización

Descripción#

final public MongoDB\Driver\BulkWriteCommandResult::getMatchedCount(): int
```php

Si la operación de actualización no produce cambios en el documento (por ejemplo, establecer el valor de un campo a su valor actual), el conteo de coincidencias puede ser mayor que el valor devuelto por MongoDB\Driver\BulkWriteCommandResult::getModifiedCount.

## Parámetros

Esta función no contiene ningún parámetro.

## Valores devueltos

Devuelve el número total de documentos seleccionados para actualización por todas las operaciones.

## Errores/Excepciones

Lanza una excepción

MongoDB\Driver\Exception\InvalidArgumentException

en caso de error durante el análisis de un argumento.

Levanta una excepción

MongoDB\Driver\Exception\LogicException

si la escritura no ha sido reconocida.

## Ejemplos

Ejemplo de `MongoDB\Driver\BulkWriteCommandResult::getMatchedCount`
insertOne('db.coll', ['x' => 1]); $bulk->updateOne('db.coll', ['x' => 1], ['$set' => ['y' => 3]]); $bulk->updateOne('db.coll', ['x' => 2], ['$set' => ['y' => 1]], ['upsert' => true]); $bulk->updateOne('db.coll', ['x' => 3], ['$set' => ['y' => 2]], ['upsert' => true]); $bulk->deleteMany('db.coll', []); $result = $manager->executeBulkWriteCommand($bulk); var_dump($result->getMatchedCount()); ?>

```php

El ejemplo anterior mostrará:

int(1)

Véase también#

MongoDB\Driver\BulkWriteCommandResult::getModifiedCount

MongoDB\Driver\BulkWriteCommandResult::getUpdateResults

MongoDB\Driver\BulkWriteCommandResult::isAcknowledged