Devuelve el número de documentos insertados por un upsert

# MongoDB\Driver\WriteResult::getUpsertedCount

(mongodb >=1.0.0)

MongoDB\Driver\WriteResult::getUpsertedCount — Devuelve el número de documentos insertados por un upsert

### Descripción

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

### Parámetros

Esta función no contiene ningún parámetro.

### Valores devueltos

Devuelve el número de documentos insertados por un upsert.

### Errores/Excepciones

- Levanta una excepción MongoDB\Driver\Exception\LogicException si la escritura no ha sido reconocida.
- Lanza una excepción MongoDB\Driver\InvalidArgumentException en caso de error durante el análisis de un argumento.

### Historial de cambios

Versión | Descripción
--- | ---
PECL mongodb 2.0.0 | Este método ahora lanza una excepción cuando es llamado para una escritura no reconocida, en lugar de retornar `null`.

### Ejemplos

Ejemplo #1 Ejemplo con 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());

    ?>

Resultado del ejemplo anterior es similar a:

    int(2)

### Ver también

- MongoDB\Driver\WriteResult::getUpsertedIds() - Devuelve un array de identificadores para los documentos upserted
- MongoDB\Driver\WriteResult::isAcknowledged() - Indica si la escritura ha sido reconocida

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open