CollectionFind::offset

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Descripción#

Ignorar un número dado de elementos a devolver

Descripción#

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

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 de `mysql_xdevapi\CollectionFind::offset`

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()); ?>

```php

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"
  }
}