NAME

RDF::Trine::Node::Formula - RDF Node class for formulae / graph literals

DESCRIPTION

Formulae are implemented as a subclass of literals. Parts of Trine that have no special knowledge about formulae (e.g. the Turtle serialiser) will just see them as literals with a particular datatype URI (http://open.vocab.org/terms/Formula).

If your code needs to detect formulae nodes, try:

  use Scalar::Util qw[blessed];
  if (blessed($node) && $node->isa('RDF::Trine::Node::Formula'))
    { ... do stuff to formulae ... }

or perhaps

  use Scalar::Util qw[blessed];
  if (blessed($node) && $node->can('pattern'))
    { ... do stuff to formulae ... }

Constructor

new ( $pattern )

Returns a new Formula structure. This is a subclass of RDF::Trine::Node::Literal.

$pattern is an RDF::Trine::Pattern or a string capable of being parsed with RDF::Trine::Parser::Notation3->parse_formula.

Methods

pattern ( $node )

Returns the formula as an RDF::Trine::Pattern.

forAll

Returns the a list of nodes with the @forAll quantifier.

This is a fairly obscure bit of N3 semantics.

forSome

Returns the a list of nodes with the @forSome quantifier.

This is a fairly obscure bit of N3 semantics.

as_literal_notation

Returns the formula in Notation-3-like syntax, excluding the wrapping "{"..."}".

Uses absolute URIs whenever possible, avoiding relative URI references, QNames and keywords.

from_literal_notation ( $string, $base )

Modifies the formula's value using Notation 3 syntax, excluding the wrapping "{"..."}".

equal ( $node )

Returns true if the two nodes are equal, false otherwise.

TODO - really need a "not equal, but equivalent" method.

BUGS

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

SEE ALSO

RDF::Trine::Node, RDF::Trine::Pattern.

AUTHOR

Toby Inkster <tobyink@cpan.org>

Based on RDF::Trine::Node::Literal 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.