MongoCollection
PHP Manual

MongoCollection::remove

(PECL mongo >=0.9.0)

MongoCollection::removeSupprime un enregistrement d'une collection

Description

public mixed MongoCollection::remove ( array $criteria [, array $options = array() ] )

Liste de paramètres

criteria

La description des enregistrements à supprimer.

options

Options pour l'effacement.

  • "justOne"

    Efface un seul enregistrement correspondant aux critères.

  • "safe"

    Vérifie si l'effacement a réussi et le nombre d'éléments effacés.

Valeurs de retour

Si l'option "safe" est définie, retourne un tableau associatif contenant le statut de l'effacement ("ok"), le nombre d'éléments effacés ("n"), mais aussi toutes les erreurs rencontrées ("err"). Sinon, retourne TRUE si l'effacement a été correctement émise, FALSE sinon.

Erreurs / Exceptions

Lance une exception MongoCursorException si l'option "safe" est définie et que l'effacement échoue.

Historique

Version Description
1.0.5 Modification du second paramètre en un tableau d'options. Avant la version 1.0.5, le second paramètre était un booléen indiquant l'option "justOne" et il n'y avait pas d'option "safe".

Exemples

Exemple #1 Exemple avec MongoCollection::remove() et justOne

<?php

$radioactive 
$db->radioactive;

// compte la quantité de plutonium
$remaining $radioactive->count(array('type' => 94));

$halflife $remaining/2;

// Suppression de la moitié
while ($halflife 0) {
    
$uranium->remove(array('type' => 94), array("justOne" => true));
    
$halflife--;
}

?>

Voir aussi

Documentation de MongoDB » concernant remove.


MongoCollection
PHP Manual