sophia_api::term::language_tag

Struct LanguageTag

Source
pub struct LanguageTag<T: Borrow<str>>(/* private fields */);
Expand description

This wrapper guarantees that the underlying str is a valid BCP47 language tag.

NB: it is actually more permissive than BCP47.

A LanguageTag can be combined to a &str with the * operator, to produce an RDF language tagged string implementing the Term trait:

let fr = LanguageTag::new_unchecked("fr");
let message = "Bonjour le monde" * fr;
assert!(message.is_literal());
assert_eq!(message.lexical_form().unwrap(), "Bonjour le monde");
assert_eq!(message.datatype().unwrap(), rdf::langString.iri().unwrap());
assert_eq!(message.language_tag().unwrap(), fr);

Implementations§

Source§

impl<T: Borrow<str>> LanguageTag<T>

Source

pub fn new(tag: T) -> Result<Self, InvalidLanguageTag>

Build a new LanguageTag from tag, returning an error if it is not a valid BCP47 language tag.

Source

pub fn new_unchecked(tag: T) -> Self

Build a new LanguageTag from tag. It does not check that the value returned by the function is valid. If it is not, it may result in undefined behaviour.

Source

pub fn unwrap(self) -> T

Returns the wrapped value, consuming self.

Source

pub fn as_str(&self) -> &str

Gets a reference to the underlying str.

Source

pub fn as_ref(&self) -> LanguageTag<&str>

Convert reference to a LanguageTag<&str>

Source

pub fn map_unchecked<F, U>(self, f: F) -> LanguageTag<U>
where F: FnOnce(T) -> U, U: Borrow<str>,

Map a LanguageTag<T> to a LanguageTag<U> by applying a function to the wrapped value.

It does not check that the value returned by the function is valid. If it is not, it may result in undefined behaviour.

Source§

impl LanguageTag<&'static str>

Source

pub const fn new_unchecked_const(inner: &'static str) -> Self

Construct a LanguageTag<&'static> without checking that the inner value is valid. If it is not, it may result in undefined behaviour.

Trait Implementations§

Source§

impl<T: Borrow<str>> AsRef<T> for LanguageTag<T>

Source§

fn as_ref(&self) -> &T

Converts this type into a shared reference of the (usually inferred) input type.
Source§

impl<T: Borrow<str>> AsRef<str> for LanguageTag<T>

Source§

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.
Source§

impl<T: Borrow<str>> Borrow<T> for LanguageTag<T>

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T: Borrow<str>> Borrow<str> for LanguageTag<T>

Source§

fn borrow(&self) -> &str

Immutably borrows from an owned value. Read more
Source§

impl<T: Clone + Borrow<str>> Clone for LanguageTag<T>

Source§

fn clone(&self) -> LanguageTag<T>

Returns a copy of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<T: Debug + Borrow<str>> Debug for LanguageTag<T>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<T: Borrow<str>> Hash for LanguageTag<T>

Source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

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

Feeds a slice of this type into the given Hasher. Read more
Source§

impl<'a> Mul<LanguageTag<&'a str>> for &'a str

Source§

type Output = SimpleTerm<'a>

The resulting type after applying the * operator.
Source§

fn mul(self, rhs: LanguageTag<&'a str>) -> Self::Output

Performs the * operation. Read more
Source§

impl<T: Borrow<str>> Mul<LanguageTag<T>> for Any

Source§

type Output = LanguageTagMatcher<T>

The resulting type after applying the * operator.
Source§

fn mul(self, rhs: LanguageTag<T>) -> Self::Output

Performs the * operation. Read more
Source§

impl<T: Borrow<str>> Ord for LanguageTag<T>

Source§

fn cmp(&self, other: &LanguageTag<T>) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 · Source§

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

Compares and returns the maximum of two values. Read more
1.21.0 · Source§

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

Compares and returns the minimum of two values. Read more
1.50.0 · Source§

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

Restrict a value to a certain interval. Read more
Source§

impl<T: Borrow<str>, U: Borrow<str>> PartialEq<LanguageTag<T>> for LanguageTag<U>

Source§

fn eq(&self, other: &LanguageTag<T>) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl<T: Borrow<str>> PartialEq<str> for LanguageTag<T>

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl<T: Borrow<str>> PartialOrd<str> for LanguageTag<T>

Source§

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

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · Source§

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

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · Source§

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

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · Source§

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

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · Source§

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

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

impl<T: Borrow<str>> PartialOrd for LanguageTag<T>

Source§

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

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · Source§

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

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · Source§

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

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · Source§

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

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · Source§

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

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

impl<T: Borrow<str>> Deref for LanguageTag<T>

Source§

type Target = T

The resulting type after dereferencing.
Source§

fn deref(&self) -> &T

Dereferences the value.
Source§

impl<T: Copy + Borrow<str>> Copy for LanguageTag<T>

Source§

impl<T: Borrow<str>> Eq for LanguageTag<T>

Auto Trait Implementations§

§

impl<T> Freeze for LanguageTag<T>
where T: Freeze,

§

impl<T> RefUnwindSafe for LanguageTag<T>
where T: RefUnwindSafe,

§

impl<T> Send for LanguageTag<T>
where T: Send,

§

impl<T> Sync for LanguageTag<T>
where T: Sync,

§

impl<T> Unpin for LanguageTag<T>
where T: Unpin,

§

impl<T> UnwindSafe for LanguageTag<T>
where T: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dst: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<P, T> Receiver for P
where P: Deref<Target = T> + ?Sized, T: ?Sized,

Source§

type Target = T

🔬This is a nightly-only experimental API. (arbitrary_self_types)
The target type on which the method may be called.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.