NAME

MongoDB::ChangeStream - A stream providing update information for collections.

VERSION

version v2.0.3

SYNOPSIS

    $stream = $collection->watch( $pipeline, $options );
    while(1) {

        # This inner loop will only iterate until there are no more
        # changes available.
        while (my $change = $stream->next) {
            ...
        }
    }

DESCRIPTION

This class models change stream results as returned by the "watch" in MongoDB::Collection method.

STREAM METHODS

next

    $change_stream = $collection->watch(...);
    $change = $change_stream->next;

Waits for the next change in the collection and returns it.

Note: This method will wait for the amount of milliseconds passed as maxAwaitTimeMS to "watch" in MongoDB::Collection or the server's default wait-time. It will not wait indefinitely.

SEE ALSO

The Change Streams manual section.

The Change Streams specification.

AUTHORS

• David Golden <david@mongodb.com>

• Rassi <rassi@mongodb.com>

• Mike Friedman <friedo@friedo.com>

• Kristina Chodorow <k.chodorow@gmail.com>

• Florian Ragwitz <rafl@debian.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2019 by MongoDB, Inc.

This is free software, licensed under:

  The Apache License, Version 2.0, January 2004