MongoDB\Driver\WriteResult::getMatchedCount

(mongodb >=1.0.0)

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

Descripción

final public 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 tiene parámetros.

Valores devueltos

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

Errores/Excepciones

Historial de cambios

Versión Descripción
PECL mongodb 2.0.0

This method now throws an exception when called for an unacknowledged write instead of returning 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());

?>

El resultado del ejemplo sería algo similar a:

int(1)

Ver también

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top