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

use crate::util;
use json::JsonValue;
use std::convert::TryFrom;
use std::fmt;

/// Blank node identifier.
///
/// Blank nodes are non-uniquely identified nodes that are local to a JSON-LD document.
/// ```json
/// {
///   "@id": "_:node1",
///   "name": "Local blank node 1",
///   "knows": {
///     "name": "Local blank node 2, that needs to refer to local node 1",
///     "knows": { "@id": "_:node1" }
///   }
/// }
/// ```
/// This type represent a blank node identifier of the form `_:name`.
/// It is used by the `Reference` type to reference blank and non-blank nodes.
#[derive(Clone, PartialEq, Eq, Hash, Debug)]
pub struct BlankId(String);

impl BlankId {
	/// Create a new blank identifier from a given `name`.
	///
	/// The created blank node will be of the form `_:name`.
	pub fn new(name: &str) -> BlankId {
		BlankId("_:".to_string() + name)
	}

	/// Get the blank identifier as a string.
	///
	/// This includes the `_:` prefix.
	/// Use [`BlankId::name`] to get the suffix part only.
	pub fn as_str(&self) -> &str {
		&self.0
	}

	/// Get the name/suffix part of the identifier.
	///
	/// For a blank identifier `_:name`, this returns a string slice to `name`.
	pub fn name(&self) -> &str {
		&self.0[2..self.0.len()]
	}
}

impl<'a> TryFrom<&'a str> for BlankId {
	type Error = ();

	fn try_from(str: &'a str) -> Result<BlankId, ()> {
		if let Some(name) = str.strip_prefix("_:") {
			Ok(BlankId::new(name))
		} else {
			Err(())
		}
	}
}

impl util::AsJson for BlankId {
	/// Returns a JSON string of the form `_:name`.
	fn as_json(&self) -> JsonValue {
		self.0.as_json()
	}
}

impl fmt::Display for BlankId {
	fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
		self.0.fmt(f)
	}
}