NAME
   RDF::Trine::Serializer::SparqlUpdate - SPARQL/U serialization of triples

SYNOPSIS
       my $sparqlu = RDF::Trine::Serializer::SparqlUpdate->new;
       $query = $sparqlu->serialize_to_string( $stmt, delete => $model );
       $query = $sparqlu->serialize_to_string( undef, delete => $iter );

       my $sparqlu_quad = RDF::Trine::Serializer->new('sparqlu', quad_semantics => 1 );
       $query = $sparqlu_quad->insert( $model );

DESCRIPTION
   TODO

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

 `new( [quad_semantics => (0|1)] )'
   Returns a new SPARQL/Update serializer object.

   If ` quad_semantics ' is set, contexts/graphs will be considered for
   INSERT and DELETE clauses. Otherwise, the serializer works on the union
   graph of the model.

 `serialize_to_string ( $data, %opts )'
   Coerces both $data and $opts{delete} to a model and calls
   `serialize_model_to_string' with those.

 `serialize_to_string ( $fh, $data, %opts )'
   Coerces both $data and $opts{delete} to a model and calls
   `serialize_model_to_string' with those and writes the resulting string
   to filehandle $fh.

 `serialize_model_to_string ( $model )'
   Serializes the `$model' to SPARQL/Update, returning the result as a
   string.

 `serialize_model_to_file ( $fh, $model )'
   Serializes the `$model' to SPARQL/Update, printing the results to the
   supplied filehandle `<$fh'>.

   Alias for serialize_to_file.

 `serialize_iterator_to_file ( $file, $iter )'
   Serializes the iterator to SPARQL/Update, printing the results to the
   supplied filehandle `<$fh'>.

   Alias for serialize_to_file.

 `serialize_iterator_to_string ( $iter )'
   Serializes the iterator to SPARQL/Update, returning the result as a
   string.

   Alias for serialize_to_string.

 `statement_as_string ( $st )'
   Serializes a statement to a SPARQL/Update INSERT DATA clause.

   Alias for serialize_to_string.

 `_serialize_data( $data )'
   Turns $data into a string of N-Triples.

 `_to_model( $data )'
   Turns $data into a RDF::Trine::Model.

 `_create_clause( $type, $data, [$graph] )'
   Creates a SPARQL/U 'INSERT' or 'DELETE' clause, depending on $type.

   `$data' can be anything that _serialize_data can coerce to N-Triples.

   If `$graph' is given, clauses take the form

       INSERT DATA { GRAPH <$graph> { ... } };

   otherwise they act on the default graph, like so:

       INSERT DATA { ... };

SEE ALSO
   http://www.w3.org/TR/rdf-testcases/#ntriples

   http://www.w3.org/TR/sparql11-update/#deleteInsert

AUTHOR
   Konstantin Baierer <[email protected]>

COPYRIGHT
   Copyright (c) 2011 Konstantin Baierer. This program is free software;
   you can redistribute it and/or modify it under the same terms as Perl
   itself.