/usr/share/perl5/Tangram/Cursor.pod is in libtangram-perl 2.10-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 | # -*- perl -*-
=head1 NAME
Tangram::Cursor - traverse a result set
=head1 SYNOPSIS
$cursor = $storage->cursor($remote, $filter);
while (my $obj = $cursor->current())
{
# process $obj
$cursor->next();
}
$cursor->execute();
while (my $obj = $cursor->current())
{
# process $obj
$cursor->next();
}
=head1 DESCRIPTION
A Cursor makes it possible to iterate over a result set without
loading all the objects in memory.
See also the "limit" option to the select method of the
Tangram::Storage class.
=head1 INSTANCE METHODS
=head2 current
$obj = $cursor->current();
Returns the current object, or undef() if the result set is exhausted.
=head2 next
$obj = $cursor->next();
@obj = $cursor->next();
Moves to the next object in the result set, if any. Returns the new
current object, or undef() if the result set is exhausted. In list
context, return all the remaining objects.
=head2 execute
$cursor->execute();
Moves the cursor to the first object in the result set, and return it.
Note that preparing Cursors is an expensive operation, you should
reuse them if possible. execute() allows just that.
execute() may be called several times in a row, or on a Cursor that
has just been obtained from a Storage, without ill effects.
=head2 residue
my @vals = $cursor->residue();
Returns the values of the Expr that were passed to the C<retrieve>
directive of the Storage::select() or Storage::cursor() statement.
=head1 CURSORS AND CONNECTIONS
Each Cursor opens its own connection to the database.
=head1 SEE ALSO
L<Tangram::Storage>
|