CollectionModify::limit

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

En esta página

Descripción#

Limita el número de documentos modificados

Descripción#

public mysql_xdevapi\CollectionModify::limit(int $rows): mysql_xdevapi\CollectionModify
```php

Limita el número de documentos modificados por esta operación. Combina eventualmente con skip() para definir un valor de desplazamiento.

## Parámetros

`rows`  
El número máximo de documentos a modificar.

## Valores devueltos

Un objeto CollectionModify.

## Ejemplos

Ejemplo de `mysql_xdevapi\CollectionModify::limit`

sql("DROP DATABASE IF EXISTS addressbook")->execute(); $session->sql("CREATE DATABASE addressbook")->execute(); $schema = $session->getSchema("addressbook"); $collection = $schema->createCollection("people"); $collection->add('{"name": "Fred", "age": 21, "job": "Construction"}')->execute(); $collection->add('{"name": "Wilma", "age": 23, "job": "Teacher"}')->execute(); $collection->add('{"name": "Betty", "age": 24, "job": "Teacher"}')->execute(); $collection ->modify("job = :job") ->bind(['job' => 'Teacher']) ->set('job', 'Principal') ->limit(1) ->execute(); $result = $collection ->find() ->execute(); print_r($result->fetchAll()); ?>

```php

Resultado del ejemplo anterior es similar a:

Array
(
    [0] => Array
        (
            [_id] => 00005b6b53610000000000000118
            [age] => 21
            [job] => Construction
            [name] => Fred
        )
    [1] => Array
        (
            [_id] => 00005b6b53610000000000000119
            [age] => 23
            [job] => Principal
            [name] => Wilma
        )
    [2] => Array
        (
            [_id] => 00005b6b5361000000000000011a
            [age] => 24
            [job] => Teacher
            [name] => Betty
        )
)