grdf 0.22.1

Generalized RDF graphs and datasets
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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144

#[macro_export]
macro_rules! reflect_graph_impl {
	() => {
		/// Returns any triple matching the given pattern.
		pub fn any_match(
			&self,
			pattern: Triple<
				Option<&<Self as $crate::Graph>::Subject>,
				Option<&<Self as $crate::Graph>::Predicate>,
				Option<&<Self as $crate::Graph>::Object>,
			>,
		) -> Option<
			Triple<
				&<Self as $crate::Graph>::Subject,
				&<Self as $crate::Graph>::Predicate,
				&<Self as $crate::Graph>::Object,
			>,
		> {
			$crate::Graph::any_match(self, pattern)
		}
	};
}

#[macro_export]
macro_rules! reflect_dataset_impl {
	() => {
		/// Get the default graph of the dataset.
		///
		/// This is the same as `graph(None)`.
		#[inline(always)]
		pub fn default_graph(&self) -> &<Self as $crate::Dataset>::Graph {
			$crate::Dataset::default_graph(self)
		}

		/// Iterate through all the subjects of the given graph.
		#[inline(always)]
		pub fn subjects<'a>(
			&'a self,
			id: Option<&<Self as $crate::Dataset>::GraphLabel>,
		) -> Option<<<Self as $crate::Dataset>::Graph as $crate::Graph>::Subjects<'a>>
		where
			<Self as $crate::Dataset>::Graph: 'a,
			<Self as $crate::Dataset>::Subject: 'a,
			<Self as $crate::Dataset>::Predicate: 'a,
			<Self as $crate::Dataset>::Object: 'a,
		{
			$crate::Dataset::subjects(self, id)
		}

		/// Iterate through all the predicates of the given subject of the given
		/// graph.
		#[inline(always)]
		pub fn predicates<'a>(
			&'a self,
			id: Option<&<Self as $crate::Dataset>::GraphLabel>,
			subject: &<Self as $crate::Dataset>::Subject,
		) -> Option<<<Self as $crate::Dataset>::Graph as $crate::Graph>::Predicates<'a>>
		where
			<Self as $crate::Dataset>::Graph: 'a,
			<Self as $crate::Dataset>::Predicate: 'a,
			<Self as $crate::Dataset>::Object: 'a,
		{
			$crate::Dataset::predicates(self, id, subject)
		}

		/// Iterate through all the objects of the given subject and predicate of the
		/// given graph.
		#[inline(always)]
		pub fn objects<'a>(
			&'a self,
			id: Option<&<Self as $crate::Dataset>::GraphLabel>,
			subject: &<Self as $crate::Dataset>::Subject,
			predicate: &<Self as $crate::Dataset>::Predicate,
		) -> Option<<<Self as $crate::Dataset>::Graph as $crate::Graph>::Objects<'a>>
		where
			<Self as $crate::Dataset>::Graph: 'a,
			<Self as $crate::Dataset>::Object: 'a,
		{
			$crate::Dataset::objects(self, id, subject, predicate)
		}
	};
}

#[macro_export]
macro_rules! reflect_sized_dataset_impl {
	() => {
		/// Consumes the dataset and returns the default graph.
		#[inline(always)]
		pub fn into_default_graph(self) -> <Self as $crate::Dataset>::Graph {
			$crate::SizedDataset::into_default_graph(self)
		}

		/// Consumes the dataset and returns an iterator over the subjects of the
		/// given graph.
		#[inline(always)]
		pub fn into_subjects(
			self,
			id: Option<&<Self as $crate::Dataset>::GraphLabel>,
		) -> Option<<<Self as $crate::Dataset>::Graph as $crate::SizedGraph>::IntoSubjects> {
			$crate::SizedDataset::into_subjects(self, id)
		}

		/// Consumes the dataset and returns an iterator over the predicates of the
		/// given subject of the given graph.
		#[inline(always)]
		pub fn into_predicates(
			self,
			id: Option<&<Self as $crate::Dataset>::GraphLabel>,
			subject: &<Self as $crate::Dataset>::Subject,
		) -> Option<<<Self as $crate::Dataset>::Graph as $crate::SizedGraph>::IntoPredicates> {
			$crate::SizedDataset::into_predicates(self, id, subject)
		}

		/// Consumes the dataset and returns an iterator over the objects of the
		/// given subject and predicate of the given graph.
		#[inline(always)]
		pub fn into_objects(
			self,
			id: Option<&<Self as $crate::Dataset>::GraphLabel>,
			subject: &<Self as $crate::Dataset>::Subject,
			predicate: &<Self as $crate::Dataset>::Predicate,
		) -> Option<<<Self as $crate::Dataset>::Graph as $crate::SizedGraph>::IntoObjects> {
			$crate::SizedDataset::into_objects(self, id, subject, predicate)
		}
	};
}

#[macro_export]
macro_rules! reflect_mutable_dataset_impl {
	() => {
		/// Get the default graph mutably.
		///
		/// Note to implementors: the default graph should always exists.
		#[inline(always)]
		pub fn default_graph_mut(&mut self) -> &mut <Self as $crate::Dataset>::Graph {
			$crate::MutableDataset::default_graph_mut(self)
		}
	};
}

pub use reflect_dataset_impl;
pub use reflect_graph_impl;
pub use reflect_mutable_dataset_impl;
pub use reflect_sized_dataset_impl;