MongoDB\ChangeStream::rewind()

定义

MongoDB\ChangeStream::rewind()

重置更改流并尝试加载第一个事件。

function rewind(): void

此方法应在更改流迭代开始时调用。

注意

重置更改流不能保证有当前事件可访问。您仍应调用MongoDB\ChangeStream::valid() 在迭代的每个步骤检查当前事件。在最初重置更改流后，应使用 MongoDB\ChangeStream::next() 进一步迭代。

错误/异常

MongoDB\Driver\Exception\LogicException 如果在调用 MongoDB\ChangeStream::next() (即底层的 MongoDB\Driver\Cursor 已被前进) 之后调用此方法。

MongoDB\Driver\Exception\RuntimeException 在扩展级别上出现其他错误（例如连接错误）。

另请参阅

• MongoDB\Client::watch()

• MongoDB\Collection::watch()

• MongoDB\Database::watch()

• Iterator::rewind()

• 可尾游标迭代

• 更改流的MongoDB手册文档