Expand description
This crate provides an implementation of language tags defined by RFC5646 (BCP47).
Usage
You can easily parse new language from anything that provides a [u8]
reference:
extern crate langtag;
use langtag::LanguageTag;
fn main() -> Result<(), langtag::Error> {
let tag = LanguageTag::parse("fr-FR")?;
assert_eq!(tag.language().unwrap().primary(), "fr");
assert!(tag == "Fr-fr"); // comparison is case-insensitive.
Ok(())
}
Note that LanguageTag::parse
does not copy the data it is given,
but only borrows it.
You can create an owning LanguageTag
instance by using
LanguageTagBuf::parse_copy
to copy the data,
or simply LanguageTagBuf::new
to move the data.
Once parsed, you can explore every component of the language tag using the provided functions.
Mutable language tags
When the language tags owns its buffer through Vec<u8>
,
it becomes possible to access the tag mutably to modify it.
extern crate langtag;
use std::convert::TryInto;
use langtag::LangTag;
fn main() -> Result<(), langtag::Error> {
let mut tag = LangTag::parse_copy("fr-FR")?;
tag.language_mut().set_primary("jp".try_into()?);
tag.set_region(None);
tag.extensions_mut().insert('f'.try_into()?, "bar".try_into()?);
assert_eq!(tag, "jp-f-bar");
Ok(())
}
Structs
Single extended language subtag.
Single extension and its subtags.
Extension subtags iterator.
Single extension subtag.
Extension subtags iterator.
List of extensions.
Extensions iterator.
Mutable reference to extension subtags.
Extensions subtags iterator.
Normal language subtag.
Primary and extended language subtags.
List of extended language subtags.
Language extension subtags iterator.
Mutable reference to extended language subtags.
Mutable reference to language subtags.
Primary language subtag.
Single private use subtag.
List of private use subtags.
Private use subtags iterator.
Mutable reference to private use subtags.
Private use tag.
Region subtag.
Script subtag.
Extension identifier.
Single variant subtag.
List of variant subtags.
Variant subtags iterator.
Mutable reference to the variants of a language tag.
Enums
Parsing errors.
Grandfathered tags.
Language tag with borrowed data.
Language tag with owned data.
Statics
List of all grandfathered tags.