rdf-syntax 1.0.0

Lexical (syntactic) representation of RDF resources, built on top of rdf-types.
Documentation
use core::fmt;
use std::borrow::Cow;
use std::cmp::Ordering;

use iref::{Iri, IriBuf};

use into_owned_trait::IntoOwned;

use crate::{BlankId, BlankIdBuf, RdfDisplay};

use super::{CowId, Id};

/// Resource identifier reference.
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub enum IdRef<'a> {
	/// Blank node identifier.
	BlankId(&'a BlankId),

	/// IRI.
	Iri(&'a Iri),
}

impl<'a> IdRef<'a> {
	/// Checks if this is a blank node identifier.
	pub fn is_blank_id(&self) -> bool {
		matches!(self, Self::BlankId(_))
	}

	/// Checks if this is an IRI.
	pub fn is_iri(&self) -> bool {
		matches!(self, Self::Iri(_))
	}

	/// Returns this identifier as a blank node identifier, if it is one.
	pub fn as_blank_id(&self) -> Option<&'a BlankId> {
		match self {
			Self::BlankId(b) => Some(b),
			_ => None,
		}
	}

	/// Returns this identifier as an IRI, if it is one.
	pub fn as_iri(&self) -> Option<&'a Iri> {
		match self {
			Self::Iri(iri) => Some(iri),
			_ => None,
		}
	}

	/// Turns this identifier reference into a copy-on-write identifier.
	pub fn into_cow(self) -> CowId<'a> {
		match self {
			Self::BlankId(b) => CowId::BlankId(Cow::Borrowed(b)),
			Self::Iri(iri) => CowId::Iri(Cow::Borrowed(iri)),
		}
	}
}

impl IdRef<'_> {
	/// Clones the referenced identifier.
	pub fn to_owned(&self) -> Id {
		(*self).into_owned()
	}

	/// Clones the referenced identifier.
	pub fn into_owned(self) -> Id {
		match self {
			Self::BlankId(blank_id) => Id::BlankId(blank_id.to_owned()),
			Self::Iri(iri) => Id::Iri(iri.to_owned()),
		}
	}
}

impl fmt::Display for IdRef<'_> {
	fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
		match self {
			Self::BlankId(b) => b.fmt(f),
			Self::Iri(i) => i.fmt(f),
		}
	}
}

impl RdfDisplay for IdRef<'_> {
	fn rdf_fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
		match self {
			Self::BlankId(b) => b.rdf_fmt(f),
			Self::Iri(i) => i.rdf_fmt(f),
		}
	}
}

impl PartialEq<Iri> for IdRef<'_> {
	fn eq(&self, other: &Iri) -> bool {
		match self {
			Self::Iri(iri) => *iri == other,
			_ => false,
		}
	}
}

impl PartialEq<&Iri> for IdRef<'_> {
	fn eq(&self, other: &&Iri) -> bool {
		self.eq(*other)
	}
}

impl PartialEq<IriBuf> for IdRef<'_> {
	fn eq(&self, other: &IriBuf) -> bool {
		match self {
			Self::Iri(iri) => *iri == other.as_iri(),
			_ => false,
		}
	}
}

impl PartialEq<&IriBuf> for IdRef<'_> {
	fn eq(&self, other: &&IriBuf) -> bool {
		self.eq(*other)
	}
}

impl PartialEq<BlankId> for IdRef<'_> {
	fn eq(&self, other: &BlankId) -> bool {
		match self {
			Self::BlankId(b) => *b == other,
			_ => false,
		}
	}
}

impl PartialEq<BlankIdBuf> for IdRef<'_> {
	fn eq(&self, other: &BlankIdBuf) -> bool {
		match self {
			Self::BlankId(b) => *b == other.as_blank_id(),
			_ => false,
		}
	}
}

impl PartialEq<&BlankId> for IdRef<'_> {
	fn eq(&self, other: &&BlankId) -> bool {
		self.eq(*other)
	}
}

impl PartialEq<&BlankIdBuf> for IdRef<'_> {
	fn eq(&self, other: &&BlankIdBuf) -> bool {
		self.eq(*other)
	}
}

impl PartialEq<Id> for IdRef<'_> {
	fn eq(&self, other: &Id) -> bool {
		match (self, other) {
			(Self::BlankId(a), Id::BlankId(b)) => *a == b,
			(Self::Iri(a), Id::Iri(b)) => *a == b,
			_ => false,
		}
	}
}

impl PartialOrd<Id> for IdRef<'_> {
	fn partial_cmp(&self, other: &Id) -> Option<Ordering> {
		match (self, other) {
			(Self::BlankId(a), Id::BlankId(b)) => (*a).partial_cmp(b),
			(Self::BlankId(_), Id::Iri(_)) => Some(Ordering::Less),
			(Self::Iri(_), Id::BlankId(_)) => Some(Ordering::Greater),
			(Self::Iri(a), Id::Iri(b)) => (*a).partial_cmp(b),
		}
	}
}

impl AsRef<str> for IdRef<'_> {
	fn as_ref(&self) -> &str {
		match self {
			Self::BlankId(b) => b.as_ref(),
			Self::Iri(i) => i.as_str(),
		}
	}
}

impl IntoOwned for IdRef<'_> {
	type Owned = Id;

	fn into_owned(self) -> Id {
		match self {
			Self::BlankId(blank_id) => Id::BlankId(blank_id.to_owned()),
			Self::Iri(iri) => Id::Iri(iri.to_owned()),
		}
	}
}

impl From<IdRef<'_>> for Id {
	fn from(value: IdRef<'_>) -> Self {
		value.into_owned()
	}
}

impl equivalent::Equivalent<Id> for IdRef<'_> {
	fn equivalent(&self, key: &Id) -> bool {
		self == key
	}
}

impl equivalent::Comparable<Id> for IdRef<'_> {
	fn compare(&self, key: &Id) -> std::cmp::Ordering {
		self.partial_cmp(key).unwrap()
	}
}