Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.11.x will end 14 Nov 2022 (12 months plus 6 months extension).
  • Bug fixes for security issues in 3.11.x will end 13 Nov 2023 (18 months plus 12 months extension).
  • PHP version: minimum PHP 7.3.0 Note: minimum PHP version has increased since Moodle 3.10. PHP 7.4.x is supported too.
<?php
/*
< * Copyright 2015-2017 MongoDB, Inc.
> * Copyright 2015-present MongoDB, Inc.
* * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at *
< * http://www.apache.org/licenses/LICENSE-2.0
> * https://www.apache.org/licenses/LICENSE-2.0
* * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ namespace MongoDB; use MongoDB\Driver\WriteResult; use MongoDB\Exception\BadMethodCallException; /** * Result class for a multi-document insert operation. */ class InsertManyResult { /** @var WriteResult */ private $writeResult;
< /** @var mixed[] */
> /** @var array */
private $insertedIds; /** @var boolean */ private $isAcknowledged;
< /** < * @param WriteResult $writeResult < * @param mixed[] $insertedIds < */
public function __construct(WriteResult $writeResult, array $insertedIds) { $this->writeResult = $writeResult; $this->insertedIds = $insertedIds; $this->isAcknowledged = $writeResult->isAcknowledged(); } /** * Return the number of documents that were inserted. * * This method should only be called if the write was acknowledged. * * @see InsertManyResult::isAcknowledged()
< * @return integer
> * @return integer|null
* @throws BadMethodCallException is the write result is unacknowledged */ public function getInsertedCount() { if ($this->isAcknowledged) { return $this->writeResult->getInsertedCount(); } throw BadMethodCallException::unacknowledgedWriteResultAccess(__METHOD__); } /** * Return a map of the inserted documents' IDs. * * The index of each ID in the map corresponds to each document's position * in the bulk operation. If a document had an ID prior to inserting (i.e. * the driver did not generate an ID), the index will contain its "_id" * field value. Any driver-generated ID will be a MongoDB\BSON\ObjectId * instance. *
< * @return mixed[]
> * @return array
*/ public function getInsertedIds() { return $this->insertedIds; } /** * Return whether this insert result was acknowledged by the server. * * If the insert was not acknowledged, other fields from the WriteResult * (e.g. insertedCount) will be undefined. * * @return boolean */ public function isAcknowledged() { return $this->writeResult->isAcknowledged(); } }