rdf::trine::iterator::saxhandler(3pm) [debian man page]
RDF::Trine::Iterator::SAXHandler(3pm) User Contributed Perl Documentation RDF::Trine::Iterator::SAXHandler(3pm)NAME
RDF::Trine::Iterator::SAXHandler - SAX Handler for parsing SPARQL XML Results format
VERSION
This document describes RDF::Trine::Iterator::SAXHandler version 1.000
STATUS
This module's API and functionality should be considered unstable. In the future, this module may change in backwards-incompatible ways,
or be removed entirely. If you need functionality that this module provides, please get in touch <http://www.perlrdf.org/>.
SYNOPSIS
use RDF::Trine::Iterator::SAXHandler;
my $handler = RDF::Trine::Iterator::SAXHandler->new();
my $p = XML::SAX::ParserFactory->parser(Handler => $handler);
$p->parse_file( $string );
my $iter = $handler->iterator;
METHODS
Beyond the methods documented below, this class inherits methods from the XML::SAX::Base class.
"new ( [ &handler ] )"
Returns a new XML::SAX handler object. If &handler is supplied, it will be called with a variable bindings object as each is parsed,
bypassing the normal process of collecting the results for retrieval via an iterator object.
"iterator"
Returns the RDF::Trine::Iterator object after parsing is complete.
"iterator_class"
Returns the iterator class appropriate for the parsed results (either ::Iterator::Boolean or ::Iterator::Bindings).
"iterator_args"
Returns the arguments suitable for passing to the iterator constructor after the iterator data.
"pull_result"
Returns the next result from the iterator, if available (if it has been parsed yet). Otherwise, returns the empty list.
BUGS
Please report any bugs or feature requests to through the GitHub web interface at <https://github.com/kasei/perlrdf/issues>.
AUTHOR
Gregory Todd Williams "<gwilliams@cpan.org>"
COPYRIGHT
Copyright (c) 2006-2012 Gregory Todd Williams. This program is free software; you can redistribute it and/or modify it under the same terms
as Perl itself.
perl v5.14.2 2012-06-29 RDF::Trine::Iterator::SAXHandler(3pm)
Check Out this Related Man Page
RDF::Trine::Iterator::Bindings(3pm) User Contributed Perl Documentation RDF::Trine::Iterator::Bindings(3pm)NAME
RDF::Trine::Iterator::Bindings - Iterator class for bindings query results
VERSION
This document describes RDF::Trine::Iterator::Bindings version 1.000
SYNOPSIS
use RDF::Trine::Iterator::Bindings;
my $iterator = RDF::Trine::Iterator::Bindings->new( &data, @names );
while (my $row = $iterator->next) {
# $row is a HASHref containing variable name -> RDF Term bindings
my @vars = keys %$row;
print $row->{ 'var' }->as_string;
}
METHODS
Beyond the methods documented below, this class inherits methods from the RDF::Trine::Iterator class.
"new ( @results, @names, %args )"
"new ( &results, @names, %args )"
Returns a new SPARQL Result interator object. Results must be either a 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.
"materialize"
Returns a materialized version of the current binding iterator. The materialization process will leave this iterator empty. The
materialized iterator that is returned should be used for any future need for the iterator's data.
"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 $inner iterator are fully materialized for this join, and the results of the join are in the order of
values from the $outer iterator. This suggests that:
* If sorting needs to be preserved, the $outer iterator should be used to determine the result ordering.
* If one iterator is much smaller than the other, it should likely be used as the $inner iterator since materialization will require
less total memory.
"sorted_by"
"binding_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 [, $count] )"
Returns a string table serialization of the stream data.
"as_statements ( @names )"
Returns a RDF::Trine::Iterator::Graph with the statements of the stream.
"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
JSON
Scalar::Util
BUGS
Please report any bugs or feature requests to through the GitHub web interface at <https://github.com/kasei/perlrdf/issues>.
AUTHOR
Gregory Todd Williams "<gwilliams@cpan.org>"
COPYRIGHT
Copyright (c) 2006-2012 Gregory Todd Williams. This program is free software; you can redistribute it and/or modify it under the same terms
as Perl itself.
perl v5.14.2 2012-06-29 RDF::Trine::Iterator::Bindings(3pm)