Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

rdf::trine::serializer::ntriples::canonical(3pm) [debian man page]

RDF::Trine::Serializer::NTriples::Canonical(3pm)	User Contributed Perl Documentation	  RDF::Trine::Serializer::NTriples::Canonical(3pm)

NAME

       RDF::Trine::Serializer::NTriples::Canonical - Canonical representation of an RDF model

VERSION

       This document describes RDF::Trine::Serializer::NTriples::Canonical version 1.000

SYNOPSIS

	 use RDF::Trine::Serializer::NTriples::Canonical;
	 my $serializer = RDF::Trine::Serializer::NTriples->new( onfail=>'truncate' );
	 $serializer->serialize_model_to_file(FH, $model);

DESCRIPTION

       This module produces a canonical string representation of an RDF graph.	If the graph contains blank nodes, sometimes there is no canonical
       representation that can be produced. The 'onfail' option allows you to decide what is done in those circumstances:

       o       truncate - drop problematic triples and only serialize a subgraph.

       o       append - append problematic triples to the end of graph. The result will be non-canonical. This is the default behaviour.

       o       space - As with 'append', but leave a blank line separating the canonical and non-canonical portions of the graph.

       o       die - cause a fatal error.

       Other than the 'onfail' option, this package has exactly the same interface as RDF::Trine::Serializer::NTriples, providing
       "serialize_model_to_file" and "serialize_model_to_string" methods.

       This package will be considerably slower than the non-canonicalising serializer though, so should only be used for small to medium-sized
       graphs, and only when you need canonicalisation (e.g. for side-by-side comparison of two graphs to check they're isomorphic; or creating a
       canonical representation for digital signing).

METHODS

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

       "new ( [ onfail => $rule ] )"
	   Returns a new Canonical N-Triples serializer object. If specified, the value of the 'onfail' argument dictates the handling of blank
	   nodes with no canonical representation. The allowable rule values are 'truncate', 'append', 'space', and 'die', and their respective
	   behaviour is described in "DESCRIPTION" above.

       "serialize_model_to_file ( $fh, $model )"
	   Serializes the $model to canonical NTriples, printing the results to the supplied filehandle "<$fh">.

       "serialize_model_to_string ( $model )"
	   Serializes the $model to canonical NTriples, returning the result as a string.

BUGS

       Please report any bugs or feature requests to through the GitHub web interface at <https://github.com/kasei/perlrdf/issues>.

SEE ALSO

       Signing RDF Graphs, Jeremey J Carroll, Digital Media Systems Laboratory, HB Laboratories Bristol.  HPL-2003-142, 23 July 2003.
       http://www.hpl.hp.com/techreports/2003/HPL-2003-142.pdf <http://www.hpl.hp.com/techreports/2003/HPL-2003-142.pdf>.

       RDF::Trine, RDF::Trine::Serializer::NTriples.

       <http://www.perlrdf.org/>.

AUTHOR

       Toby Inkster, <tobyink@cpan.org>

COPYRIGHT AND LICENSE

       Copyright (c) 2010 Toby Inkster

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.1 or,
       at your option, any later version of Perl 5 you may have available.

perl v5.14.2							    2012-06-29			  RDF::Trine::Serializer::NTriples::Canonical(3pm)

Check Out this Related Man Page

RDF::Trine::Serializer::Notation3(3pm)			User Contributed Perl Documentation		    RDF::Trine::Serializer::Notation3(3pm)

NAME

       RDF::Trine::Serializer::Notation3 - Notation 3 Serializer

SYNOPSIS

	use RDF::Trine::Serializer::Notation3;
	my $serializer = RDF::Trine::Serializer::Notation3->new();

DESCRIPTION

       The RDF::Trine::Serializer::Notation3 class provides an API for serializing RDF graphs to the Notation 3 syntax.

       The output of this class is not optimised for human-readability; it's a data dump.  The only minor concession it makes to human readers is
       that it will nicely indent formulae. I do have plans to port cwm's Notation 3 output to Perl, but this is likely to be distributed
       separately due to licensing concerns.

       Caveat scriptor: while RDF::Trine::Node::Formula understands quantification (@forAll, @forSome), RDF::Trine::Model does not. This means
       that @forAll and @forSome defined in the top-level graph are not-round-tripped between the Notation 3 parser and serialiser (the parser
       will give you warnings about this).  @forAll and @forSome within formulae will work fine.

METHODS

       "new"
	   Returns a new Notation 3 serializer object.

       "serialize_model_to_file ( $fh, $model )"
	   Serializes the $model to Notation 3, printing the results to the supplied filehandle "<$fh">.

       "serialize_model_to_string ( $model )"
	   Serializes the $model to Notation 3, returning the result as a string.

       "serialize_iterator_to_file ( $file, $iter )"
	   Serializes the iterator to Notation 3, printing the results to the supplied filehandle "<$fh">.

       "serialize_iterator_to_string ( $iter )"
	   Serializes the iterator to Notation 3, returning the result as a string.

SEE ALSO

       http://www.w3.org/TR/rdf-testcases/#ntriples <http://www.w3.org/TR/rdf-testcases/#ntriples>

AUTHOR

       Toby Inkster  "<tobyink@cpan.org>"

COPYRIGHT AND LICENCE

       Copyright (c) 2010-2011 Toby Inkster.

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

DISCLAIMER OF WARRANTIES

       THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
       MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

perl v5.14.2							    2011-10-22				    RDF::Trine::Serializer::Notation3(3pm)
Man Page