CollectionModify::limit

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

CollectionModify::limit変更されるドキュメントの数を限定する

説明

publicmysql_xdevapi\CollectionModify::limit(int$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 ) )
To Top