CollectionModify::limit

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

CollectionModify::limit — Ограничивает количество изменяемых документов

Описание

public mysql_xdevapi\CollectionModify::limit ( integer $rows ) : mysql_xdevapi\CollectionModify

Ограничивает количество документов, изменяемых этой операцией. При желании можно использовать skip() для определения значения смещения.

Список параметров

rows: Максимальное количество документов для изменения.

Возвращаемые значения

Объект CollectionModify.

Примеры

Пример #1 Пример использования mysql_xdevapi\CollectionModify::limit()


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

Результатом выполнения данного примера будет что-то подобное:

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
        )
)