Struct substudy::lang::Lang

pub struct Lang { /* private fields */ }

A language identifier.

Implementations

impl Lang

pub fn iso639(code: &str) -> Result<Lang>

Specify a language using an ISO 639-1, -2/T or -2/B code. We know that the same language is sometimes represented by more than one code, and we do our best to treat equivalent codes as the same language.

use substudy::lang::Lang;
assert_eq!(Lang::iso639("en").unwrap(), Lang::iso639("eng").unwrap());
assert!(Lang::iso639("en").unwrap() != Lang::iso639("fr").unwrap());
assert!(Lang::iso639("abcd").is_err());

pub fn as_str(&self) -> &str

Get the normalized language code as a &str. Prefers ISO 639-1 codes when possible, and -2/T if that’s the best it can do.

use substudy::lang::Lang;
assert_eq!("en", Lang::iso639("en").unwrap().as_str());
assert_eq!("en", Lang::iso639("eng").unwrap().as_str());

pub fn for_text(text: &str) -> Option<Lang>

Try to determine the language of text. We return None unless we’re pretty sure.

use substudy::lang::Lang;
let text = "Pour que le caractère d’un être humain dévoile des qualités";
assert_eq!(Lang::for_text(text).unwrap(), Lang::iso639("fr").unwrap());

pub fn english_names(&self) -> Result<Vec<&'static str>>

Names of the language (or related languages) in English. These may be separated by semi-colons.

use substudy::lang::Lang;
assert_eq!(
    vec!["English".to_owned()],
    Lang::iso639("en").unwrap().english_names().unwrap(),
);

Trait Implementations

impl Clone for Lang

fn clone(&self) -> Lang

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Lang

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

Formats the value using the given formatter.

impl Display for Lang

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

Formats the value using the given formatter.

impl PartialEq for Lang

fn eq(&self, other: &Lang) -> 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 Serialize for Lang

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Lang

impl Eq for Lang

impl StructuralPartialEq for Lang