MongoDB\Driver\WriteResult::getUpsertedCount

(mongodb >=1.0.0)

MongoDB\Driver\WriteResult::getUpsertedCount — Возвращает количество документов, вставленных операцией upsert

Описание

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

Список параметров

Сигнатура функции не содержит параметров.

Возвращаемые значения

Метод возвращает количество документов, вставленных операцией upsert.

Ошибки

При записи без подтверждения метод выбрасывает исключение MongoDB\Driver\Exception\LogicException.
При ошибке парсинга аргумента метод выбрасывает исключение MongoDB\Driver\Exception\InvalidArgumentException.

Список изменений

Версия	Описание
PECL-модуль mongodb 2.0.0	При вызове для записи без подтверждения метод вместо возврата значения `null` теперь выбрасывает исключение.

Примеры

Пример #1 Пример получения количества документов, вставленных операцией upsert, методом MongoDB\Driver\WriteResult::getUpsertedCount()

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

?>

Результат выполнения приведённого примера:

int(2)

Смотрите также

MongoDB\Driver\WriteResult::getUpsertedIds() - Возвращает массив идентификаторов для объединённых документов
MongoDB\Driver\WriteResult::isAcknowledged() - Возвращает, была ли запись подтверждена

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы