MongoDB\Driver\WriteResult::getModifiedCount

(mongodb >=1.0.0)

MongoDB\Driver\WriteResult::getModifiedCount — 업데이트된 기존 문서 수를 반환합니다.

설명

---

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

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

매개변수

---

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

반환 값

---

업데이트된 기존 문서의 수를 반환하거나 쓰기가 확인되지 않은 경우 null을 반환합니다.

레거시 유선 프로토콜 버전(예: OP_UPDATE)을 사용하는 2.6 이전의 MongoDB 버전에서는 수정된 개수를 사용할 수 없습니다. 이 경우 수정된 개수도 null이 됩니다.

오류/예외

---

• 인수 구문 분석 오류에 대해 MongoDB\Driver\Exception\InvalidArgumentException을 던집니다.

Examples

---

예제 #1 MongoDB\Driver\WriteResult::getModifiedCount() 예제

                  
<?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->getModifiedCount());

?>
                  
                

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

int(1)
                

기타

---

• MongoDB\Driver\WriteResult::getMatchedCount() - 업데이트를 위해 선택한 문서 수를 반환합니다.
• MongoDB\Driver\WriteResult::isAcknowledged() - 쓰기가 승인되었는지 여부를 반환합니다.