# Collection::remove

(No version information available, might only be in Git)

Collection::remove — Enlève des documents de la collection

### Description

public mysql_xdevapi\Collection::remove(string `$search_condition`): mysql_xdevapi\CollectionRemove

Enlève des documents d'une collection qui répondent à des conditions de recherche spécifiques. Plusieurs opérations sont autorisées, et la liaison de paramètres

### Liste de paramètres

`search_condition`

  Doit être une expression SQL valide utilisée pour faire correspondre les documents à modifier. Cette expression peut être aussi simple que `true`, qui correspond à tous les documents, ou elle peut utiliser des fonctions et des opérateurs tels que `'CAST(_id AS SIGNED) >= 10'`, `'age MOD 2 = 0 OR age MOD 3 = 0'`, ou `'_id IN ["2","5","7","10"]'`.

### Valeurs de retour

Si l'opération n'est pas exécutée, alors la fonction retournera un objet Remove qui peut être utilisé pour ajouter des opérations de suppression supplémentaires.

SI l'opération de suppression est exécutée, alors l'objet retourné contiendra le résultat de l'opération.

### Exemples

Exemple #1 Exemple de mysql_xdevapi\Collection::remove()

`<?php
$session = mysql_xdevapi\getSession("mysqlx://user:password@localhost");
$session->sql("DROP DATABASE IF EXISTS addressbook")->execute();
$session->sql("CREATE DATABASE addressbook")->execute();
$schema = $session->getSchema("addressbook");
$collection = $schema->createCollection("people");
$collection->add('{"name": "Alfred", "age": 18, "job": "Butler"}')->execute();
$collection->add('{"name": "Bob", "age": 19, "job": "Painter"}')->execute();
// Enlève tous les painters
$collection
->remove("job in ('Painter')")
->execute();
// Enlève le plus vieux butler
$collection
->remove("job in ('Butler')")
->sort('age desc')
->limit(1)
->execute();
// Enlève le record avec l'âge le plus élevé
$collection
->remove('true')
->sort('age desc')
->limit(1)
->execute();
?>`