Struct langtag::LangTag

pub struct LangTag<T> { /* fields omitted */ }

Normal language subtag.

The language subtag can be modified when the internal buffer type (T) is Vec<u8>.

Implementations

impl<'a> LangTag<&'a [u8]>

pub fn parse<T: AsRef<[u8]> + ?Sized>(
    bytes: &'a T
) -> Result<LangTag<&'a [u8]>, Error>

Parse a normal language tag.

impl LangTag<Vec<u8>>

pub fn parse_copy<T: AsRef<[u8]> + ?Sized>(
    bytes: &T
) -> Result<LangTag<Vec<u8>>, Error>

Parse and copy a normal language tag.

The returned normal language tag owns its buffer.

impl<T: AsRef<[u8]>> LangTag<T>

pub fn new(data: T) -> Result<LangTag<T>, Error>

Create a new normal language tag by parsing and using the given buffer.

pub fn into_raw_parts(self) -> (T, ParsedLangTag)

Consume the tag and returns its internal buffer along with the parsing metadata.

pub unsafe fn from_raw_parts(data: T, p: ParsedLangTag) -> LangTag<T>

Create a new normal language tag using p as parsing metadata.

Safety

The input data is not checked for well-formedness, which must be ensred by the caller.

pub fn inner(&self) -> &T

Returns a reference to the tag's buffer.

pub fn parsing_data(&self) -> ParsedLangTag

Returns a copy of the parsing metadata.

pub fn as_bytes(&self) -> &[u8]

Returns the bytes representation of the tag.

pub fn as_str(&self) -> &str

Returns the string representation of the tag.

pub fn language(&self) -> &Language

Get the language subtags.

pub fn script(&self) -> Option<&Script>

Get the script subtag, if any.

pub fn region(&self) -> Option<&Region>

Get the region subtag, if any.

pub fn variants(&self) -> &Variants

Get the variant subtags.

pub fn extensions(&self) -> &Extensions

Get the extension subtags.

pub fn private_use_subtags(&self) -> &PrivateUseSubtags

Get the private use subtags.

impl<T: AsMut<Vec<u8>>> LangTag<T>

pub fn language_mut(&mut self) -> LanguageMut<'_>

Get and modify the language subtags.

pub fn set_language(&mut self, lang: &Language)

Set the language subtags.

pub fn set_script(&mut self, script: Option<&Script>)

Set the script subtag.

pub fn set_region(&mut self, region: Option<&Region>)

Set the region subtag.

pub fn variants_mut(&mut self) -> VariantsMut<'_>

Get and modify the variant subtags.

pub fn extensions_mut(&mut self) -> ExtensionsMut<'_>

Get and modify the extension subtags.

pub fn private_use_subtags_mut(&mut self) -> PrivateUseSubtagsMut<'_>

Get and modify the private use subtags.

Trait Implementations

impl<T: Clone> Clone for LangTag<T>

pub fn clone(&self) -> LangTag<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: AsRef<[u8]>> Debug for LangTag<T>

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

Formats the value using the given formatter.

impl<T: AsRef<[u8]>> Display for LangTag<T>

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

Formats the value using the given formatter.

impl<T: AsRef<[u8]>> Eq for LangTag<T>

impl<T: AsRef<[u8]>> Hash for LangTag<T>

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl<T: AsRef<[u8]>, U: AsRef<[u8]>> PartialEq<LangTag<U>> for LangTag<T>

pub fn eq(&self, other: &LangTag<U>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: AsRef<[u8]>, U: AsRef<[u8]> + ?Sized> PartialEq<U> for LangTag<T>

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

This method tests for self and other values to be equal, and is used by ==.

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.