Convenience functions for creating and serializing RDF terms and quads following Turtle/SPARQL syntax
npm install rdf-string-ttl


This package contains utility functions to convert between the string-based
and RDFJS representations of RDF terms, quads and triples.
_This is a fork of RDF String that is adapted to make string representation compatible with Turtle/SPARQL syntax._
This allows for convenient and compact interaction with RDF terms and quads,
as they can be serialized as plain JSON.
Quads are represented as follows:
```
{
subject: '
predicate: '
object: '
graph: '
}<>`
Different terms types in quads are represented as follows:
* URLs, URIs and IRIs are strings wrapper in : ''"Tom"'
* Literals are represented as double quoted strings: , '"Tom"@en-gb', '"Tom"@en-gb--ltr', '"1"^^_:
* Blank nodes are prefixed by : '_:blankNodeName'?
* Variables are prefixed by : '?variableName'
The following examples assume the following imports:
`javascript`
import * as RdfDataModel from "rdf-data-model";
import * as RdfString from "rdf-string-ttl";
Convert an RDFJS term to the string-based representation.
`javascript
// Prints
console.log(RdfString.termToString(RdfDataModel.namedNode('http://example.org')));
// Prints _:b1
console.log(RdfString.termToString(RdfDataModel.blankNode('b1')));
// Prints "abc"
console.log(RdfString.termToString(RdfDataModel.literal('abc')));
// Prints "abc"@en-us
console.log(RdfString.termToString(RdfDataModel.literal('abc', 'en-us')));
// Prints "abc"@en-us--ltr
console.log(RdfString.termToString(RdfDataModel.literal('abc', { language: 'en-us', direction: 'ltr' })));
// Prints "abc"^^
console.log(RdfString.termToString(RdfDataModel.literal('abc', namedNode('http://example.org/'))));
// Prints ?v1
console.log(RdfString.termToString(RdfDataModel.variable('v1')));
// Prints empty string
console.log(RdfString.termToString(RdfDataModel.defaultGraph()));
`
Convert an string-based term to the RDFJS representation.
_Optionally, a custom RDFJS DataFactory can be provided as second argument to create terms instead of the built-in DataFactory._
`javascript
// Outputs a named node
RdfString.stringToTerm('
// Outputs a blank node
RdfString.stringToTerm('_:b1');
// Outputs a literal
RdfString.stringToTerm('"abc"');
// Outputs a literal with a language tag
RdfString.stringToTerm('"abc"@en-us');
// Outputs a literal with a language tag and direction
RdfString.stringToTerm('"abc"@en-us--ltr');
// Outputs a literal with a datatype
RdfString.stringToTerm('"abc"^^
// Outputs a variable
RdfString.stringToTerm('?v1');
// Outputs a default graph
RdfString.stringToTerm('');
`
Convert an RDFJS quad to a string-based quad.
`javascript`
// Prints { subject: '
console.log(RdfString.quadToStringQuad(RdfDataModel.triple(
namedNode('http://example.org'),
namedNode('http://example.org'),
literal('abc'),
)));
Converts a string-based quad to an RDFJS quad.
_Optionally, a custom RDFJS DataFactory can be provided as second argument to create quads and terms instead of the built-in DataFactory._
`javascript``
// Outputs a quad
RdfString.stringQuadToQuad({
subject: '
predicate: '
object: '"abc"',
graph: '',
});
This code is released under the MIT license.