rdfx 0.23.1

RDF 1.2 data-structures, traits and utilities: terms (incl. triple terms), triples, quads, interpretations, graphs, datasets, unstar/restar reification helpers.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106

use iri_rs::{Iri, IriBuf};

use super::{EmbedIntoVocabulary, EmbeddedIntoVocabulary};

/// IRI vocabulary.
pub trait IriVocabulary {
    type Iri;

    /// Returns the IRI associated to the given IRI id.
    fn iri<'i>(&'i self, id: &'i Self::Iri) -> Option<Iri<&'i str>>;

    /// Returns a copy of the IRI associated to the given IRI id.
    fn owned_iri(&self, id: Self::Iri) -> Result<IriBuf, Self::Iri> {
        self.iri(&id).map(IriBuf::from).ok_or(id)
    }

    /// Returns the id of the given IRI, if any.
    fn get(&self, iri: Iri<&str>) -> Option<Self::Iri>;
}

impl<V: IriVocabulary> IriVocabulary for &V {
    type Iri = V::Iri;

    fn iri<'i>(&'i self, id: &'i Self::Iri) -> Option<Iri<&'i str>> {
        V::iri(*self, id)
    }

    fn owned_iri(&self, id: Self::Iri) -> Result<IriBuf, Self::Iri> {
        V::owned_iri(*self, id)
    }

    fn get(&self, iri: Iri<&str>) -> Option<Self::Iri> {
        V::get(*self, iri)
    }
}

impl<V: IriVocabulary> IriVocabulary for &mut V {
    type Iri = V::Iri;

    fn iri<'i>(&'i self, id: &'i Self::Iri) -> Option<Iri<&'i str>> {
        V::iri(*self, id)
    }

    fn owned_iri(&self, id: Self::Iri) -> Result<IriBuf, Self::Iri> {
        V::owned_iri(*self, id)
    }

    fn get(&self, iri: Iri<&str>) -> Option<Self::Iri> {
        V::get(*self, iri)
    }
}

/// Mutable IRI vocabulary.
pub trait IriVocabularyMut: IriVocabulary {
    /// Inserts an IRI to the vocabulary and returns its id.
    ///
    /// If the IRI was already present in the vocabulary, no new id is created
    /// and the current one is returned.
    fn insert(&mut self, iri: Iri<&str>) -> Self::Iri;

    fn insert_owned(&mut self, iri: IriBuf) -> Self::Iri {
        self.insert(iri.as_ref())
    }
}

impl<V: IriVocabularyMut> IriVocabularyMut for &mut V {
    fn insert(&mut self, iri: Iri<&str>) -> Self::Iri {
        V::insert(*self, iri)
    }

    fn insert_owned(&mut self, iri: IriBuf) -> Self::Iri {
        V::insert_owned(*self, iri)
    }
}

impl<V: IriVocabularyMut> EmbedIntoVocabulary<V> for Iri<&str> {
    type Embedded = V::Iri;

    fn embed_into_vocabulary(self, vocabulary: &mut V) -> Self::Embedded {
        vocabulary.insert(self)
    }
}

impl<V: IriVocabularyMut> EmbedIntoVocabulary<V> for IriBuf {
    type Embedded = V::Iri;

    fn embed_into_vocabulary(self, vocabulary: &mut V) -> Self::Embedded {
        vocabulary.insert_owned(self)
    }
}

impl<V: IriVocabularyMut> EmbeddedIntoVocabulary<V> for Iri<&str> {
    type Embedded = V::Iri;

    fn embedded_into_vocabulary(&self, vocabulary: &mut V) -> Self::Embedded {
        vocabulary.insert(*self)
    }
}

impl<V: IriVocabularyMut> EmbeddedIntoVocabulary<V> for IriBuf {
    type Embedded = V::Iri;

    fn embedded_into_vocabulary(&self, vocabulary: &mut V) -> Self::Embedded {
        vocabulary.insert(self.as_ref())
    }
}