NAME

RDF::Trine::Parser::Notation3 - Notation 3 Parser

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.

BUGS

Please report any bugs to http://rt.cpan.org/Dist/Display.html?Queue=RDF-TriN3.

SEE ALSO

RDF::Trine::Parser::NTriples, RDF::Trine::Parser::Turtle, RDF::Trine::Parser::ShorthandRDF.

AUTHOR

Toby Inkster <tobyink@cpan.org>

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.