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

# MongoDB\Driver\WriteResult::getMatchedCount

(mongodb >=1.0.0)

MongoDB\Driver\WriteResult::getMatchedCount — Devuelve el número de documentos seleccionados para la actualización

### Descripción

final public function MongoDB\Driver\WriteResult::getMatchedCount(): int

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\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 #1 Ejemplo con MongoDB\Driver\WriteResult::getMatchedCount()

    <?php

    $manager = new MongoDB\Driver\Manager;

    $bulk = new MongoDB\Driver\BulkWrite;
    $bulk->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());

    ?>

Resultado del ejemplo anterior es similar a:

    int(1)

### Ver también

- MongoDB\Driver\WriteResult::getModifiedCount() - Devuelve el número de documentos existentes actualizados
- MongoDB\Driver\WriteResult::isAcknowledged() - Indica si la escritura ha sido reconocida

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open