array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'mongodb-driver-bulkwritecommandresult.getmatchedcount.php', 1 => 'MongoDB\\Driver\\BulkWriteCommandResult::getMatchedCount', 2 => 'Devuelve el número de documentos seleccionados para la actualización', ), 'up' => array ( 0 => 'class.mongodb-driver-bulkwritecommandresult.php', 1 => 'MongoDB\\Driver\\BulkWriteCommandResult', ), 'prev' => array ( 0 => 'mongodb-driver-bulkwritecommandresult.getinsertresults.php', 1 => 'MongoDB\\Driver\\BulkWriteCommandResult::getInsertResults', ), 'next' => array ( 0 => 'mongodb-driver-bulkwritecommandresult.getmodifiedcount.php', 1 => 'MongoDB\\Driver\\BulkWriteCommandResult::getModifiedCount', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/mongodb/mongodb/driver/bulkwritecommandresult/getmatchedcount.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

MongoDB\Driver\BulkWriteCommandResult::getMatchedCount

(mongodb >=2.1.0)

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

Descripción

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

Si la operación de actualización no realiza ningún cambio en el documento (por ejemplo, al definir el valor de un campo a su valor actual), el número de documentos 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 la actualización por todas las operaciones.

Errores/Excepciones

Ejemplos

Ejemplo #1 Ejemplo de MongoDB\Driver\BulkWriteCommandResult::getMatchedCount()

<?php

$manager = new MongoDB\Driver\Manager;

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

?>

El ejemplo anterior mostrará:

int(1)

Ver también