Toby Inkster > RDF-TriN3-0.206 > RDF::Trine::Parser::Notation3

Download:
RDF-TriN3-0.206.tar.gz

Dependencies

Annotate this POD

Website

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.206   Source  

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.

syntax highlighting: