Package Exports

rdf-string

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (rdf-string) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

RDF String

This package contains utility functions to convert between the string-based and RDFJS representations of RDF terms, quads and triples.

This allows for convenient and compact interaction with RDF terms and quads.

This string-based representation is based on the triple representation of N3.js.

Usage

The following examples assume the following imports:

import * as RdfDataModel from "rdf-data-model";
import * as RdfTerm from "rdf-string";

Term to string

Convert an RDFJS term to the string-based representation.

// Prints http://example.org
console.log(RdfTerm.termToString(RdfDataModel.namedNode('http://example.org')));

// Prints _:b1
console.log(RdfTerm.termToString(RdfDataModel.blankNode('b1')));

// Prints "abc"
console.log(RdfTerm.termToString(RdfDataModel.literal('abc')));

// Prints "abc"@en-us
console.log(RdfTerm.termToString(RdfDataModel.literal('abc', 'en-us')));

// Prints "abc"^^http://example.org/
console.log(RdfTerm.termToString(RdfDataModel.literal('abc', namedNode('http://example.org/'))));

// Prints ?v1
console.log(RdfTerm.termToString(RdfDataModel.variable('v1')));

// Prints empty string
console.log(RdfTerm.termToString(RdfDataModel.defaultGraph()));

String to term

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.

// Outputs a named node
RdfTerm.stringToTerm('http://example.org');

// Outputs a blank node
RdfTerm.stringToTerm('_:b1');

// Outputs a literal
RdfTerm.stringToTerm('"abc"');

// Outputs a literal with a language tag
RdfTerm.stringToTerm('"abc"@en-us');

// Outputs a literal with a datatype
RdfTerm.stringToTerm('"abc"^^http://example.org/');

// Outputs a variable
RdfTerm.stringToTerm('?v1');

// Outputs a default graph
RdfTerm.stringToTerm('');

Quad to string-based quad

Convert an RDFJS quad to a string-based quad.

// Prints { subject: 'http://example.org', predicate: 'http://example.org', object: '"abc"', graph: '' }
console.log(RdfTerm.quadToStringQuad(RdfDataModel.triple(
  namedNode('http://example.org'),
  namedNode('http://example.org'),
  literal('abc'),
)));

String-based quad to quad

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.

// Outputs a quad
RdfTerm.stringQuadToQuad({
  subject: 'http://example.org',
  predicate: 'http://example.org',
  object: '"abc"',
  graph: '',
});

License

This software is written by Ruben Taelman. These utility functions are inspired by the implementation of N3.js.

This code is released under the MIT license.