Trait sophia::streams::TripleSink

pub trait TripleSink {
    type Error: StdError;
    type Outcome;

    fn feed<T: Triple>(&mut self, t: &T) -> Result<(), Self::Error>;
    fn finish(&mut self) -> Result<Self::Outcome, Self::Error>;
}

A triple sink is anything that consumes triples, produces a result, and may also fail in the process.

Typical triple sinks are serializers or graphs’ inserters and removers.

See also TripleSource.

Required Associated Types

type Error: StdError

The error type that this triple sink may raise.

Must be Never for infallible sources.

type Outcome

The type of the result produced by this triple sink.

See finish.

Required Methods

fn feed<T: Triple>(&mut self, t: &T) -> Result<(), Self::Error>

Feed one triple in this sink.

fn finish(&mut self) -> Result<Self::Outcome, Self::Error>

Produce the result once all triples were fed.

NB: the behaviour of a triple sink after finish is called is unspecified by this trait.

Implementations on Foreign Types

impl TripleSink for ()

() acts as a “black hole”, consuming all triples without erring, and producing no result.

Useful for benchmarking triple sources.

type Error = Never

type Outcome = ()

fn feed<T: Triple>(&mut self, _: &T) -> Result<(), Self::Error>

fn finish(&mut self) -> Result<Self::Outcome, Self::Error>

Implementors

impl TripleSink for Stringifier

type Error = Never

type Outcome = String

impl<'a, G: MutableGraph + ?Sized + 'a> TripleSink for Inserter<'a, G>

type Error = <G as Graph>::Error

type Outcome = usize

impl<'a, G: MutableGraph + ?Sized + 'a> TripleSink for Remover<'a, G>

type Error = <G as Graph>::Error

type Outcome = usize

impl<W: Write> TripleSink for Writer<W>

type Error = Error

type Outcome = ()