NAME
RDF::Trine::Iterator::Bindings - Stream (iterator) class for bindings query results.
VERSION
This document describes RDF::Trine::Iterator::Bindings version 0.118_01
SYNOPSIS
use RDF::Trine::Iterator;
my $iterator = RDF::Trine::Iterator::Bindings->new( \&data, \@names );
while (my $row = $iterator->next) {
my @vars = keys %$row;
# do something with @vars
}METHODS
new ( \@results, \@names, %args )new ( \&results, \@names, %args )-
Returns a new SPARQL Result interator object. Results must be either an reference to an array containing results or a CODE reference that acts as an iterator, returning successive items when called, and returning undef when the iterator is exhausted.
$type should be one of: bindings, boolean, graph.
materialize-
Returns a materialized version of the current binding iterator.
project ( @columns )-
Returns a new stream that projects the current bindings to only the given columns.
join_streams ( $stream, $stream )-
Performs a natural, nested loop join of the two streams, returning a new stream of joined results.
nested_loop_join ( $outer, $inner )-
Performs a natural, nested loop join of the two streams, returning a new stream of joined results.
Note that the values from the
$inneriterator are fully materialized for this join, and the results of the join are in the order of values from the$outeriterator. This suggests that:* If sorting needs to be preserved, the
$outeriterator should be used to determine the result ordering.* If one iterator is much smaller than the other, it should likely be used as the
$inneriterator since materialization will require less total memory. sorted_bybinding_value_by_name ( $name )-
Returns the binding of the named variable in the current result.
binding_value ( $i )-
Returns the binding of the $i-th variable in the current result.
binding_values-
Returns a list of the binding values from the current result.
binding_names-
Returns a list of the binding names.
binding_name ( $i )-
Returns the name of the $i-th result column.
bindings_count-
Returns the number of variable bindings in the current result.
is_bindings-
Returns true if the underlying result is a set of variable bindings.
as_json ( $max_size )-
Returns a JSON serialization of the stream data.
as_xml ( $max_size )-
Returns an XML serialization of the stream data.
as_string ( $max_size )-
Returns a string table serialization of the stream data.
as_statements ( @names )print_xml ( $fh, $max_size )-
Prints an XML serialization of the stream data to the filehandle $fh.
construct_args-
Returns the arguments necessary to pass to the stream constructor _new to re-create this stream (assuming the same closure as the first argument).
DEPENDENCIES
AUTHOR
Gregory Todd Williams <gwilliams@cpan.org>
COPYRIGHT
Copyright (c) 2006-2010 Gregory Todd Williams. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.