Enum isolang::Language

pub enum Language {
    // some variants omitted
}

Implementations

impl Language

pub fn from_usize(u: usize) -> Option<Self>

impl Language

pub fn to_639_3(&self) -> &'static str

Create string representation of this Language as a ISO 639-3 code.

This method will return the ISO 639-3 code, which consists of three letters.

Example

use isolang::Language;

assert_eq!(Language::Deu.to_639_3(), "deu");

pub fn to_639_1(&self) -> Option<&'static str>

Create two-letter ISO 639-1 representation of the language.

This will return a two-letter ISO 639-1 code, if it exists and None otherwise. ISO 639-1 codes are only used for the most common languages.

Example

use isolang::Language;

assert!(Language::Gha.to_639_1().is_none());

pub fn to_name(&self) -> &'static str

Get the English name of this language.

This returns the English name of the language, as defined in the ISO 639 standard. It does not include additional comments, e.g. classification of a macrolanguage, etc. It is available if compiled with the english_names feature.

Examples

use isolang::Language;

assert_eq!(Language::Spa.to_name(), "Spanish");
// macro language
assert_eq!(Language::Swa.to_name(), "Swahili");
// individual language
assert_eq!(Language::Swh.to_name(), "Swahili");

pub fn from_name(engl_name: &str) -> Option<Self>

Get the ISO code by its English name.

This returns the ISO code by the given English name of the language string, as defined in the ISO 639 standard. It does not include additional comments, e.g. classification of a macrolanguage, etc. Only available if compiled with the english_names feature.

Examples

use isolang::Language;

assert_eq!(Language::from_name("Spanish"), Some(Language::Spa));

pub fn match_names<F>(matcher: F) -> impl Iterator<Item = Self>

where F: Fn(&str) -> bool + 'static,

Get all matching ISO codes by a provided English name pattern.

This returns the matching ISO codes for the provided matcher. The matcher matches all known English language names.

Examples

use isolang::Language;

assert!(Language::match_names(|lang| lang.contains("Engl")).count() > 1);

pub fn from_639_1(code: &str) -> Option<Language>

Create a Language instance rom a ISO 639-1 code.

This will return a Language instance if the given string is a valid two-letter language code. For invalid inputs, None is returned.

Example

use isolang::Language;

assert!(Language::from_639_1("de").is_some());
assert!(Language::from_639_1("…").is_none());

pub fn from_639_3(code: &str) -> Option<Language>

Create a Language instance rom a ISO 639-3 code.

This will return a Language instance if the given string is a valid three-letter language code. For invalid inputs, None is returned.

Example

use isolang::Language;

assert!(Language::from_639_3("dan").is_some());
assert!(Language::from_639_1("…").is_none());

pub fn from_locale(locale: &str) -> Option<Language>

Parse language from given locale

This parses a language from a given locale string, as used by UNIX-alike and other systems.

Example

use isolang::Language;

assert!(Language::from_locale("de_DE.UTF-8") == Some(Language::Deu));

Trait Implementations

impl Clone for Language

fn clone(&self) -> Language

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Language

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

Formats the value using the given formatter.

impl Default for Language

fn default() -> Self

Returns the “default value” for a type.

impl Display for Language

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

Formats the value using the given formatter.

impl FromStr for Language

type Err = ParseLanguageError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, ParseLanguageError>

Parses a string s to return a value of this type.

impl Hash for Language

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 Ord for Language

fn cmp(&self, other: &Language) -> 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 + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for Language

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Language

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl Copy for Language

impl Eq for Language

impl StructuralEq for Language

impl StructuralPartialEq for Language