#localization

language-tag

Handle language tags as defined in BCP47 (e.g. 'en-US', 'fr-FR', 'zh-cmn-Hans-CN')

1 unstable release

Uses old Rust 2015

0.9.0 Feb 23, 2018

#275 in Internationalization (i18n)


Used in 2 crates

MIT license

30KB
670 lines

This crate can handle language tags as defined in the BCP47 standard.

A language tag is the small string that describe a culture (language with script, region, etc). Examples: "en-US" (english as used in US), "fr-FR" (french as used in France), "zh-cmn-Hans-CN" (Chinese, Mandarin, Simplified script, as used in China).

To use this crate, add the relevant dependency in your Cargo.toml.

[dependencies]
language-tag = "0.9"

Then load the lib in your crate root:

extern crate language_tag;

Examples

This crate support the LanguageTag as defined in the standard but mostly you will probably be interested in the LangTag only (names are taken from the standard).

Query a parsed language tag

use language_tag::*;
use std::str::FromStr;

let langtag = LangTag::from_str("zh-cmn-Hans-CN").unwrap();

assert!(langtag.get_language().get_mainlang() == "zh");
assert!(langtag.get_script().unwrap().str() == "Hans");
assert!(langtag.get_region().unwrap().str() == "CN");

Use the LangTagBuilder

use language_tag::*;

let langtag = LangTagBuilder::new("zh")
                .language_extension("cmn")
                .script("Hans")
                .region("CN")
                .build().unwrap();

assert!(langtag.get_language().get_mainlang() == "zh");
assert!(langtag.get_script().unwrap().str() == "Hans");
assert!(langtag.get_region().unwrap().str() == "CN");

Todo

  • Better error reporting.
  • Finish doc

No runtime deps

~12KB