SYNOPSIS

use RDF::Trine::Parser;
my $parser = RDF::Trine::Parser->new( 'Notation3' );
$parser->parse_into_model( $base_uri, $data, $model );

DESCRIPTION

This module provides a Notation 3 parser for RDF::Trine.

Methods

This package exposes the standard RDF::Trine::Parser methods, plus:

"forAll($handler)"

Sets a callback handler for @forAll directives found in the top-level graph. (@forAll found in nested formulae will not be passed to this callback.)

The handler should be a coderef that takes a single argument: an RDF::Trine::Node::Resource.

If you do not set a handler, a warning will be issued when this directive are encountered in the top level graph, but parsing will continue.

"forSome($handler)"

As "forAll" but handles @forSome directives.

"parse_formula($base, $input)"

Returns an RDF::Trine::Node::Formula object representing the Notation 3 formula given as $input. $input should not include the ``{''...``}'' wrappers.

Datatype Callbacks

The constructor accepts a hashref of callbacks associated with datatypes, which will be triggered after a literal has been parsed with that datatype. Let's imagine that you want to replace all xsd:integer literals with URIs like "http:;//example.net/numbers/123"...

 my $parser = RDF::Trine::Parser::Notation3->new(
   datatype_callback => {
     'http://www.w3.org/2001/XMLSchema#integer' => sub {
       my ($lit, $tr_hnd) = @_;
       return RDF::Trine::Node::Resource->new(
         'http:;//example.net/numbers/' . $lit->literal_value
       );
     },
   },
 );

Note the second argument passed to the callback $tr_hnd. We don't use it here, but it's a coderef that can be called with RDF::Trine::Statement objects to add additional triples to the graph being parsed.

This facility, combined with shortcuts from RDF::Trine::Parser::ShorthandRDF is pretty useful for creating domain-specific languages.

AUTHOR

Toby Inkster "<[email protected]>"

Based on RDF::Trine::Parser::Turtle by Gregory Todd Williams.

COPYRIGHT AND LICENCE

Copyright (c) 2006-2010 Gregory Todd Williams.

Copyright (c) 2010-2012 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.