Struct TurtleSerializer

Source

pub struct TurtleSerializer { /* private fields */ }

Expand description

A Turtle serializer.

Support for Turtle-star is available behind the rdf-star feature.

use oxrdf::vocab::rdf;
use oxrdf::{NamedNodeRef, TripleRef};
use oxttl::TurtleSerializer;

let mut serializer = TurtleSerializer::new()
    .with_prefix("schema", "http://schema.org/")?
    .for_writer(Vec::new());
serializer.serialize_triple(TripleRef::new(
    NamedNodeRef::new("http://example.com#me")?,
    rdf::TYPE,
    NamedNodeRef::new("http://schema.org/Person")?,
))?;
assert_eq!(
    b"@prefix schema: <http://schema.org/> .\n<http://example.com#me> a schema:Person .\n",
    serializer.finish()?.as_slice()
);

Implementations§

Source §

impl TurtleSerializer

Source

pub fn new() -> Self

Builds a new TurtleSerializer.

Source

pub fn with_prefix( self, prefix_name: impl Into<String>, prefix_iri: impl Into<String>, ) -> Result<Self, IriParseError>

Source

pub fn with_base_iri( self, base_iri: impl Into<String>, ) -> Result<Self, IriParseError>

Adds a base IRI to the serialization.

use oxrdf::vocab::rdf;
use oxrdf::{NamedNodeRef, TripleRef};
use oxttl::TurtleSerializer;

let mut serializer = TurtleSerializer::new()
    .with_base_iri("http://example.com")?
    .with_prefix("ex", "http://example.com/ns#")?
    .for_writer(Vec::new());
serializer.serialize_triple(TripleRef::new(
    NamedNodeRef::new("http://example.com/me")?,
    rdf::TYPE,
    NamedNodeRef::new("http://example.com/ns#Person")?,
))?;
assert_eq!(
    b"@base <http://example.com> .\n@prefix ex: </ns#> .\n</me> a ex:Person .\n",
    serializer.finish()?.as_slice()
);

Source

pub fn for_writer<W: Write>(self, writer: W) -> WriterTurtleSerializer<W>

Writes a Turtle file to a Write implementation.

use oxrdf::vocab::rdf;
use oxrdf::{NamedNodeRef, TripleRef};
use oxttl::TurtleSerializer;

let mut serializer = TurtleSerializer::new()
    .with_prefix("schema", "http://schema.org/")?
    .for_writer(Vec::new());
serializer.serialize_triple(TripleRef::new(
    NamedNodeRef::new("http://example.com#me")?,
    rdf::TYPE,
    NamedNodeRef::new("http://schema.org/Person")?,
))?;
assert_eq!(
    b"@prefix schema: <http://schema.org/> .\n<http://example.com#me> a schema:Person .\n",
    serializer.finish()?.as_slice()
);

Source

pub fn low_level(self) -> LowLevelTurtleSerializer

Builds a low-level Turtle writer.

use oxrdf::vocab::rdf;
use oxrdf::{NamedNodeRef, TripleRef};
use oxttl::TurtleSerializer;

let mut buf = Vec::new();
let mut serializer = TurtleSerializer::new()
    .with_prefix("schema", "http://schema.org/")?
    .low_level();
serializer.serialize_triple(
    TripleRef::new(
        NamedNodeRef::new("http://example.com#me")?,
        rdf::TYPE,
        NamedNodeRef::new("http://schema.org/Person")?,
    ),
    &mut buf,
)?;
serializer.finish(&mut buf)?;
assert_eq!(
    b"@prefix schema: <http://schema.org/> .\n<http://example.com#me> a schema:Person .\n",
    buf.as_slice()
);