Enum Id 

pub enum Id<I = IriBuf, B = BlankIdBuf> {
    Valid(ValidId<I, B>),
    Invalid(String),
}

Node identifier.

Used to reference a node across a document or to a remote document. It can be an identifier (IRI), a blank node identifier for local blank nodes or an invalid reference (a string that is neither an IRI nor blank node identifier).

Hash implementation

It is guaranteed that the Hash implementation of Id is transparent, meaning that the hash of Id::Valid(id) the same as id, and the hash of Id::Invalid(id) is the same as id.

This may be useful to define custom indexmap::Equivalent<Id<I, B>> implementation.

Variants

Valid(ValidId<I, B>)

Valid node identifier.

Invalid(String)

Invalid reference.

Implementations

impl<I: From<IriBuf>, B: From<BlankIdBuf>> Id<I, B>

pub fn from_string(s: String) -> Self

Parses an identifier from a string, keeping it as invalid if it is neither an IRI nor a blank node identifier.

impl<I, B> Id<I, B>

pub fn iri(iri: I) -> Self

Builds an identifier from an IRI.

pub fn blank(b: B) -> Self

Builds an identifier from a blank node identifier.

pub fn from_string_in( vocabulary: &mut impl VocabularyMut<Iri = I, BlankId = B>, s: String, ) -> Self

Parses an identifier from a string, interning it in the given vocabulary.

pub fn is_valid(&self) -> bool

Checks whether this identifier is a well-formed IRI or blank node identifier, rather than a string that failed to parse as either.

pub fn into_blank(self) -> Option<B>

Consumes the identifier, returning the blank node identifier if it is one.

pub fn is_blank(&self) -> bool

Checks whether this identifier is a blank node identifier.

pub fn as_blank(&self) -> Option<&B>

Returns the blank node identifier, if this identifier is one.

pub fn is_iri(&self) -> bool

Checks whether this identifier is an IRI.

pub fn as_iri(&self) -> Option<&I>

Returns the IRI, if this identifier is one.

pub fn into_term(self) -> Term<I, B>

Converts this identifier into a term.

pub fn as_ref(&self) -> Ref<'_, I, B>

Borrows this Id.

pub fn map<J, C>( self, f: impl FnOnce(ValidId<I, B>) -> ValidId<J, C>, ) -> Id<J, C>

Rewrites this identifier with the given function, leaving invalid ones untouched.

impl<I: AsRef<str>, B: AsRef<str>> Id<I, B>

pub fn as_str(&self) -> &str

Returns this value as a string slice.

Trait Implementations

impl<T, B, N: Vocabulary<Iri = T, BlankId = B>> AsRefWithContext<str, N> for Id<T, B>

fn as_ref_with<'a>(&'a self, vocabulary: &'a N) -> &'a str

impl<I: Clone, B: Clone> Clone for Id<I, B>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug, B: Debug> Debug for Id<T, B>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Display, B: Display> Display for Id<T, B>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<V: IriVocabulary + BlankIdVocabulary> DisplayWithContext<V> for Id<V::Iri, V::BlankId>

fn fmt_with(&self, vocabulary: &V, f: &mut Formatter<'_>) -> Result

impl<I: Eq, B: Eq> Eq for Id<I, B>

impl<I: PartialEq, B: PartialEq> Equivalent<Id<I, B>> for ValidId<I, B>

fn equivalent(&self, key: &Id<I, B>) -> bool

Compare self to key and return true if they are equal.

impl<I> Equivalent<Id<I>> for BlankId

fn equivalent(&self, key: &Id<I, BlankIdBuf>) -> bool

Compare self to key and return true if they are equal.

impl<I> Equivalent<Id<I>> for BlankIdBuf

fn equivalent(&self, key: &Id<I, BlankIdBuf>) -> bool

Compare self to key and return true if they are equal.

impl<B> Equivalent<Id<Iri<String>, B>> for Iri<&str>

fn equivalent(&self, key: &Id<IriBuf, B>) -> bool

Compare self to key and return true if they are equal.

impl<B> Equivalent<Id<Iri<String>, B>> for IriBuf

fn equivalent(&self, key: &Id<IriBuf, B>) -> bool

Compare self to key and return true if they are equal.

impl<'a, T, B> From<&'a Id<T, B>> for Id<&'a T, &'a B>

fn from(r: &'a Id<T, B>) -> Id<&'a T, &'a B>

Converts to this type from the input type.

impl<T, B> From<Id<T, B>> for Term<T, B>

fn from(prop: Id<T, B>) -> Term<T, B>

Converts to this type from the input type.

impl<T, B> From<T> for Id<T, B>

fn from(id: T) -> Id<T, B>

Converts to this type from the input type.

impl<T, B> From<ValidId<T, B>> for Id<T, B>

fn from(r: ValidId<T, B>) -> Self

Converts to this type from the input type.

impl<I: Hash, B: Hash> Hash for Id<I, B>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T, B, N: Vocabulary<Iri = T, BlankId = B>> IntoJsonWithContext<N> for Id<T, B>

fn into_json_with(self, context: &N) -> Value

Converts this value into JSON, resolving the identifiers it holds against the given vocabulary.

impl<T: PartialEq, B: PartialEq> MappedEq for Id<T, B>

type BlankId = B

Blank node identifier type the renaming applies to.

fn mapped_eq<'a, 'b, F: Clone + Fn(&'a Self::BlankId) -> &'b Self::BlankId>( &'a self, other: &Self, f: F, ) -> bool

where Self::BlankId: 'a + 'b,

Structural equality with mapped blank identifiers.

impl<I: Ord, B: Ord> Ord for Id<I, B>

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl<I: PartialEq, B: PartialEq> PartialEq for Id<I, B>

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<I: PartialEq, B> PartialEq<I> for Id<I, B>

fn eq(&self, other: &I) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<T: PartialEq, B: PartialEq> PartialEq<Id<T, B>> for Term<T, B>

fn eq(&self, r: &Id<T, B>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<T: PartialEq, B: PartialEq> PartialEq<Term<T, B>> for Id<T, B>

fn eq(&self, term: &Term<T, B>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<T: PartialEq<str>, B: PartialEq<str>> PartialEq<str> for Id<T, B>

fn eq(&self, other: &str) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<I: PartialOrd, B: PartialOrd> PartialOrd for Id<I, B>

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T, B, N: Vocabulary<Iri = T, BlankId = B>> PrecomputeSizeWithContext<N> for Id<T, B>

fn contextual_pre_compute_size( &self, vocabulary: &N, _options: &Options, _sizes: &mut Vec<Size>, ) -> Size

Computes the printed size of this value against context.

impl<T, B, N: Vocabulary<Iri = T, BlankId = B>> PrintWithContext<N> for Id<T, B>

fn contextual_fmt_with( &self, vocabulary: &N, f: &mut Formatter<'_>, _options: &Options, _indent: usize, ) -> Result

Writes the value to f, resolving it against context.

impl<T, B, N: Vocabulary<Iri = T, BlankId = B>> PrintWithSizeAndContext<N> for Id<T, B>

fn contextual_fmt_with_size( &self, vocabulary: &N, f: &mut Formatter<'_>, _options: &Options, _indent: usize, _sizes: &[Size], _index: &mut usize, ) -> Result

Writes the value to f against context, taking its layout from sizes[*index].

impl<I: PartialEq, B: PartialEq> StructuralPartialEq for Id<I, B>

impl<'a, T, B> TryFrom<&'a Id<T, B>> for &'a ValidId<T, B>

type Error = &'a String

The type returned in the event of a conversion error.

fn try_from(r: &'a Id<T, B>) -> Result<Self, Self::Error>

Performs the conversion.

impl<'a, T, B> TryFrom<&'a mut Id<T, B>> for &'a mut ValidId<T, B>

type Error = &'a mut String

The type returned in the event of a conversion error.

fn try_from(r: &'a mut Id<T, B>) -> Result<Self, Self::Error>

Performs the conversion.

impl<T, B> TryFrom<Id<T, B>> for ValidId<T, B>

type Error = String

The type returned in the event of a conversion error.

fn try_from(r: Id<T, B>) -> Result<Self, Self::Error>

Performs the conversion.

impl<T, B> TryFrom<Term<T, B>> for Id<T, B>

type Error = Term<T, B>

The type returned in the event of a conversion error.

fn try_from(term: Term<T, B>) -> Result<Id<T, B>, Term<T, B>>

Performs the conversion.

impl<I, B> TryFromJson<I, B> for Id<I, B>

fn try_from_json_in( vocabulary: &mut impl VocabularyMut<Iri = I, BlankId = B>, value: Value, ) -> Result<Self, InvalidExpandedJson>

Builds this fragment from a JSON value, interning terms in the given vocabulary.