rdf_ntriples.pl -- Process files in the RDF N-Triples format

The library(semweb/rdf_ntriples) provides a fast reader for the RDF N-Triples and N-Quads format. N-Triples is a simple format, originally used to support the W3C RDF test suites. The current format has been extended and is a subset of the Turtle format (see library(semweb/turtle)).

The API of this library is almost identical to library(semweb/turtle). This module provides a plugin into rdf_load/2, making this predicate support the format ntriples and nquads.

See also: - http://www.w3.org/TR/n-triples/
To be done: - Sync with RDF 1.1. specification.

read_ntriple(+Stream, -Triple) is det

Read the next triple from Stream as Triple. Stream must have UTF-8 encoding.

Arguments:

Triple - is a term triple(Subject,Predicate,Object). Arguments follow the normal conventions of the RDF libraries. NodeID elements are mapped to node(Id). If end-of-file is reached, Triple is unified with end_of_file.

Errors

- syntax_error(Message) on syntax errors

read_nquad(+Stream, -Quad) is det

Read the next quad from Stream as Quad. Stream must have UTF-8 encoding.

Arguments:

Quad - is a term quad(Subject,Predicate,Object,Graph). Arguments follow the normal conventions of the RDF libraries. NodeID elements are mapped to node(Id). If end-of-file is reached, Quad is unified with end_of_file.

Errors

- syntax_error(Message) on syntax errors

read_ntuple(+Stream, -Tuple) is det

Read the next triple or quad from Stream as Tuple. Tuple is one of the terms below. See read_ntriple/2 and read_nquad/2 for details.

triple(Subject,Predicate,Object)
quad(Subject,Predicate,Object,Graph).

rdf_read_ntriples(+Input, -Triples, +Options) is det

rdf_read_nquads(+Input, -Quads, +Options) is det

True when Triples/Quads is a list of triples/quads from Input. Options:

anon_prefix(+AtomOrNode): Prefix nodeIDs with this atom. If AtomOrNode is the term node(_), bnodes are returned as node(Id).
base_uri(+Atom): Defines the default anon_prefix as _:<baseuri>_
on_error(Action): One of warning (default) or error
error_count(-Count): If on_error is warning, unify Count with th number of errors.
graph(+Graph): For rdf_read_nquads/3, this defines the graph associated to triples loaded from the input. For rdf_read_ntriples/3 this opion is ignored.

Arguments:

`Triples`	- is a list of `rdf(Subject, Predicate, Object)`
`Quads`	- is a list of `rdf(Subject, Predicate, Object, Graph)`

rdf_process_ntriples(+Input, :CallBack, +Options)

Call-back interface, compatible with the other triple readers. In addition to the options from rdf_read_ntriples/3, this processes the option graph(Graph).

Arguments:

CallBack - is called as call(CallBack, Triples, Graph), where Triples is a list holding a single rdf(S,P,O) triple. Graph is passed from the graph option and unbound if this option is omitted.

read_ntuples(+Stream, -Triples, +State0, -State)[private]

process_ntriple(+Stream, :CallBack, +State0, -State)[private]

read_ntuple(+Stream, -Tuple, +State0, -State) is det[private]

True when Tuple is the next triple on Stream. May increment the error count on State.

open_input(+Input, -Stream, -Close) is det[private]

Open input for reading ntriples. The default encoding is UTF-8. If the input has a different encoding, Input must be a stream with the correct encoding and the stream type must be text.

init_state(+Input, +Options, -State) is det[private]

rdf_db:rdf_load_stream(+Format, +Stream, :Options) is semidet[multifile]

Plugin rule that supports loading the ntriples and nquads formats.

rdf_db:rdf_file_type(+Extension, -Format)[multifile]

Bind the ntriples reader to files with the extensions nt, ntriples and nquads.

Undocumented predicates

The following predicates are exported, but not or incorrectly documented.

rdf_read_nquads(Arg1, Arg2, Arg3)