MongoDB\Driver\WriteResult::getMatchedCount

(mongodb >=1.0.0)

MongoDB\Driver\WriteResult::getMatchedCount — 업데이트를 위해 선택한 문서 수를 반환합니다.


설명

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

업데이트 작업으로 인해 문서가 변경되지 않으면(예: 필드 값을 현재 값으로 설정) 일치하는 개수가 MongoDB\Driver\WriteResult::getModifiedCount()에서 반환된 값보다 클 수 있습니다.


매개변수

이 함수에는 매개변수가 없습니다.


반환 값

업데이트를 위해 선택한 문서 수를 반환하거나 쓰기가 확인되지 않은 경우 null을 반환합니다.


오류/예외


Examples

예제 #1 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());

?>
                  
                

위의 예는 다음을 출력합니다.

int(1)
                

기타