array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'mongodb-driver-bulkwritecommandexception.getpartialresult.php', 1 => 'MongoDB\\Driver\\Exception\\BulkWriteCommandException::getPartialResult', 2 => 'Renvoie le résultat de toutes les opérations d\'écriture réussies', ), 'up' => array ( 0 => 'class.mongodb-driver-exception-bulkwritecommandexception.php', 1 => 'MongoDB\\Driver\\Exception\\BulkWriteCommandException', ), 'prev' => array ( 0 => 'mongodb-driver-bulkwritecommandexception.geterrorreply.php', 1 => 'MongoDB\\Driver\\Exception\\BulkWriteCommandException::getErrorReply', ), 'next' => array ( 0 => 'mongodb-driver-bulkwritecommandexception.getwriteconcernerrors.php', 1 => 'MongoDB\\Driver\\Exception\\BulkWriteCommandException::getWriteConcernErrors', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/mongodb/mongodb/driver/exception/bulkwritecommandexception/getpartialresult.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

MongoDB\Driver\Exception\BulkWriteCommandException::getPartialResult

(mongodb >=2.1.0)

MongoDB\Driver\Exception\BulkWriteCommandException::getPartialResult — Renvoie le résultat de toutes les opérations d'écriture réussies

Description

final public MongoDB\Driver\Exception\BulkWriteCommandException::getPartialResult(): ?MongoDB\Driver\BulkWriteCommandResult

Liste de paramètres

Cette fonction ne contient aucun paramètre.

Valeurs de retour

Renvoie un MongoDB\Driver\BulkWriteCommandResult apportant les résultats de chacune des opérations réussies qui ont été faites avant que l'erreur ne soit rencontrée. La valeur retournée sera null si on ne peut pas déterminer si au moins une écriture a été effectuée avec succès (et reconnue).

Exemples

Exemple #1 Résultat partiel si au moins une écriture est réussie

<?php

$manager = new MongoDB\Driver\Manager;

$bulk = new MongoDB\Driver\BulkWriteCommand;
$bulk->deleteMany('db.coll', []);
$bulk->insertOne('db.coll', ['_id' => 1]);
$bulk->insertOne('db.coll', ['_id' => 1]);

try {
$result = $manager->executeBulkWriteCommand($bulk);
} catch (MongoDB\Driver\Exception\BulkWriteCommandException $e) {
$result = $e->getPartialResult();
}

var_dump($result?->getInsertedCount());

?>

L'exemple ci-dessus va afficher :

int(1)

Exemple #2 Aucun résultat partiel si aucune écriture n'est réussie

<?php

$manager = new MongoDB\Driver\Manager;

$bulk = new MongoDB\Driver\BulkWriteCommand;
$bulk->deleteMany('db.coll', []);
$bulk->insertOne('db.coll', ['_id' => 1]);
$manager->executeBulkWriteCommand($bulk);

$bulk = new MongoDB\Driver\BulkWriteCommand;
$bulk->insertOne('db.coll', ['_id' => 1]);

try {
$result = $manager->executeBulkWriteCommand($bulk);
} catch (MongoDB\Driver\Exception\BulkWriteCommandException $e) {
$result = $e->getPartialResult();
}

var_dump($result?->getInsertedCount());

?>

L'exemple ci-dessus va afficher :

NULL

Voir aussi