Elimina documentos de la colección

# Collection::remove

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

Collection::remove — Elimina documentos de la colección

### Descripción

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

Elimina documentos de una colección que cumplen con condiciones de búsqueda específicas. Se permiten varias operaciones, y la ligadura de argumentos.

### Parámetros

`search_condition`

  Debe ser una expresión SQL válida utilizada para hacer coincidir los documentos a modificar. Esta expresión puede ser tan simple como `true`, que coincide con todos los documentos, o puede utilizar funciones y operadores tales como `'CAST(_id AS SIGNED) >= 10'`, `'age MOD 2 = 0 OR age MOD 3 = 0'`, o `'_id IN ["2","5","7","10"]'`.

### Valores devueltos

Si la operación no se ejecuta, entonces la función devolverá un objeto Remove que puede ser utilizado para añadir operaciones de eliminación adicionales.

SI la operación de eliminación se ejecuta, entonces el objeto devuelto contendrá el resultado de la operación.

### Ejemplos

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

    // Elimina todos los painters
    $collection
      ->remove("job in ('Painter')")
      ->execute();

    // Elimina el butler más viejo
    $collection
      ->remove("job in ('Butler')")
      ->sort('age desc')
      ->limit(1)
      ->execute();

    // Elimina el registro con la edad más alta
    $collection
      ->remove('true')
      ->sort('age desc')
      ->limit(1)
      ->execute();
    ?>

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