NAME

       RDF::Trine::Iterator::Graph - Iterator class for graph query results

VERSION

       This document describes RDF::Trine::Iterator::Graph version 1.019

SYNOPSIS

        use RDF::Trine::Iterator::Graph;

        my $iterator = RDF::Trine::Iterator::Graph->new( \&data );
        while (my $st = $iterator->next) {
          # $st is a RDF::Trine::Statement object
          print $st->as_string;
        }

METHODS

       Beyond the methods documented below, this class inherits methods from the RDF::Trine::Iterator class.

       "new ( \@results, %args )"
       "new ( \&results, %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.

       "as_bindings ( $s, $p, $o )"
           Returns  the  iterator  as  a  Bindings  iterator,  using  the supplied triple nodes to determine the
           variable bindings.

       "materialize"
           Returns a materialized version of the current graph 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.

       "unique"
           Returns  a  Graph  iterator that ensures the returned statements are unique. While the underlying RDF
           graph is the same regardless of uniqueness, the iterator's serialization methods assume  the  results
           are unique, and so use this method before serialization.

           Uniqueness  is  opt-in  for  efficiency concerns -- this method requires O(n) memory, and so may have
           noticeable effects on large graphs.

       "is_graph"
           Returns true if the underlying result is an RDF graph.

       "as_string ( $max_size [, \$count] )"
           Returns a string table serialization of the stream data.

       "as_xml ( $max_size )"
           Returns an XML serialization of the stream data.

       "print_xml ( $fh, $max_size )"
           Prints an XML serialization of the stream data to the filehandle $fh.

       "as_json ( $max_size )"
           Returns a JSON serialization of the stream data.

       "as_hashref"
           Returns a hashref representing the model in an RDF/JSON-like manner.

           See "as_hashref" at RDF::Trine::Model for full documentation of the hashref format.

       "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

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.38.2                                       2024-01-13                   RDF::Trine::Iterator::Graph(3pm)