RDF::Trine::Parser(3pm) 				User Contributed Perl Documentation				   RDF::Trine::Parser(3pm)

NAME

       RDF::Trine::Parser - RDF Parser class

VERSION

       This document describes RDF::Trine::Parser version 1.000

SYNOPSIS

	use RDF::Trine::Parser;

	RDF::Trine::Parser->parse_url_into_model( $url, $model );

	my $parser     = RDF::Trine::Parser->new( 'turtle' );
	$parser->parse_into_model( $base_uri, $rdf, $model );

	$parser->parse_file_into_model( $base_uri, 'data.ttl', $model );

DESCRIPTION

       RDF::Trine::Parser is a base class for RDF parsers. It may be used as a factory class for constructing parser objects by name or media type
       with the "new" method, or used to abstract away the logic of choosing a parser based on the media type of RDF content retrieved over the
       network with the "parse_url_into_model" method.

METHODS

       "media_type"
	   Returns the canonical media type associated with this parser.

       "media_types"
	   Returns the media types associated with this parser.

       "parser_by_media_type ( $media_type )"
	   Returns the parser class appropriate for parsing content of the specified media type.

       "guess_parser_by_filename ( $filename )"
	   Returns the best-guess parser class to parse a file with the given filename.

       "new ( $parser_name, @args )"
	   Returns a new RDF::Trine::Parser object for the parser with the specified name (e.g. "rdfxml" or "turtle"). If no parser with the
	   specified name is found, throws a RDF::Trine::Error::ParserError exception.

	   Any @args will be passed through to the format-specific parser constructor.

	   If @args contains the key-value pair "(canonicalize => 1)", literal value canonicalization will be attempted during parsing with
	   warnings being emitted for invalid lexical forms for recognized datatypes.

       "parse_url_into_model ( $url, $model [, %args] )"
	   Retrieves the content from $url and attempts to parse the resulting RDF into $model using a parser chosen by the associated content
	   media type.

	   If %args contains a 'content_cb' key with a CODE reference value, that callback function will be called after a successful response as:

	    $content_cb->( $url, $content, $http_response_object )

       "parse_into_model ( $base_uri, $data, $model [, context => $context] )"
	   Parses the $data, using the given $base_uri. For each RDF statement parsed, will call "$model->add_statement( $statement )".

       "parse_file_into_model ( $base_uri, $fh, $model [, context => $context] )"
	   Parses all data read from the filehandle or file $fh, using the given $base_uri. For each RDF statement parsed, will call
	   "$model->add_statement( $statement )".

       "parse_file ( $base_uri, $fh, $handler )"
	   Parses all data read from the filehandle or file $fh, using the given $base_uri. If $fh is a filename, this method can guess the
	   associated parse. For each RDF statement parses $handler is called.

       "parse ( $base_uri, $rdf, &handler )"
       "new_bnode_prefix ()"
	   Returns a new prefix to be used in the construction of blank node identifiers.  If either Data::UUID or UUID::Tiny are available, they
	   are used to construct a globally unique bnode prefix. Otherwise, an empty string is returned.

BUGS

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

AUTHOR

       Gregory Todd Williams  "<gwilliams@cpan.org>"

COPYRIGHT

       Copyright (c) 2006-2012 Gregory Todd Williams. This program is free software; you can redistribute it and/or modify it under the same terms
       as Perl itself.

perl v5.14.2							    2012-06-29						   RDF::Trine::Parser(3pm)