Ignorar un número dado de elementos a devolver

# CollectionFind::offset

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

CollectionFind::offset — Ignorar un número dado de elementos a devolver

### Descripción

public function mysql_xdevapi\CollectionFind::offset(int `$position`): mysql_xdevapi\CollectionFind

Ignora (desplaza) un número dado de elementos que de otro modo serían devueltos por la operación find. Utilícese con el método limit().

Definir un desplazamiento mayor que el tamaño del conjunto de resultados da un conjunto vacío.

### Parámetros

`position`

  El número de elementos a ignorar para la operación limit().

### Valores devueltos

Un objeto CollectionFind que puede ser utilizado para un tratamiento ulterior.

### Ejemplos

Ejemplo #1 Ejemplo de mysql_xdevapi\CollectionFind::offset()

    <?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");
    $create = $schema->createCollection("people");
    $create
      ->add('{"name": "Alfred", "age": 18, "job": "Butler"}')
      ->execute();
    $create
      ->add('{"name": "Reginald", "age": 42, "job": "Butler"}')
      ->execute();

    // ...

    $collection = $schema->getCollection("people");

    $result = $collection
      ->find()
      ->sort('age asc')
      ->offset(1)
      ->limit(1)
      ->execute();

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

Resultado del ejemplo anterior es similar a:

    array(1) {
      [0]=>
      array(4) {
        ["_id"]=>
        string(28) "00005b6b536100000000000000f3"
        ["age"]=>
        int(42)
        ["job"]=>
        string(6) "Butler"
        ["name"]=>
        string(8) "Reginald"
      }
    }

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