ptr727.LanguageTags 1.0.14

LanguageTags

C# .NET library for ISO 639-2, ISO 639-3, RFC 5646 / BCP 47 language tags.

Build Status

Code and Pipeline is on GitHub

NuGet Package

Packages published on NuGet

References

• Wikipedia : Codes for constructed languages
• Wikipedia : IETF language tag
• W3C : Choosing a Language Tag
• W3C : Language tags in HTML and XML
• W3C : BCP47 language subtag lookup
• IANA : Language Subtags, Tag Extensions, and Tags
• RFC : BCP47
• RFC : 4647 : Matching of Language Tags
• RFC : 5646 : Tags for Identifying Languages
• Unicode Consortium : Unicode CLDR Project
• Library of Congress : ISO 639-2 Language Coding Agency
• SIL International : ISO 639-3 Language Coding Agency

Build Process

The build process downloads the latest language tag data files, converts them into JSON files for easy consumption, and generates C# classes with all the tags for direct use in code.

• ISO 639-2: Source, Data, JSON, Code
• ISO 639-3: Source, Data, JSON, Code
• RFC 5646: Source, Data, JSON, Code

The data files are updated on a weekly bases using a scheduled actions job.

Usage

Tag Lookup

Iso6392 iso6392 = Iso6392.Create();
Iso6393 iso6393 = Iso6393.LoadData("Iso6393");
Rfc5646 rfc5646 = Rfc5646.LoadJson("Rfc5646.json");

public Record Find(string languageTag, bool includeDescription);

Iso6392.Record record = iso6392.Find("afr", false)
// record.Part2B = afr
// record.RefName = Afrikaans
record = iso6392.Find("zulu", true)
// record.Part2B = zul
// record.RefName = Zulu

Iso6393.Record record = iso6393.Find("zh", false)
// record.Id = zho
// record.Part1 = zh
// record.RefName = Chinese
record = iso6392.Find("yue chinese", true)
// record.Id = yue
// record.RefName = Yue Chinese

Rfc5646.Record record = rfc5646.Find("de", false)
// record.SubTag = de
// record.Description = German
record = iso6392.Find("zh-cmn-Hant", false)
// record.Tag = zh-cmn-Hant
// record.Description = Mandarin Chinese (Traditional)
record = iso6392.Find("Inuktitut in Canadian", true)
// record.Tag = iu-Cans
// record.Description = Inuktitut in Canadian Aboriginal Syllabic script

Tag Conversion

LanguageLookup languageLookup = new();
languageLookup.GetIetfFromIso("afr"); // af
languageLookup.GetIetfFromIso("zho"); // zh

LanguageLookup languageLookup = new();
languageLookup.GetIsoFromIetf("af"); // afr
languageLookup.GetIsoFromIetf("zh-cmn-Hant"); // chi
languageLookup.GetIsoFromIetf("cmn-Hant"); // chi

Tag Matching

RFC 5646 / BCP 47 language tags are in the form of language-extlang-script-region-variant-extension-privateuse, and matching happens left to right.
E.g. pt will match pt Portuguese, or pt-BR Brazilian Portuguese, or pt-PT European Portuguese.
E.g. pt-BR will only match only pt-BR Brazilian Portuguese.
E.g. zh will match zh Chinese, or zh-Hans simplified Chinese, or zh-Hant for traditional Chinese, and other variants.
E.g. zh-Hans will only match zh-Hans simplified Chinese.

LanguageLookup languageLookup = new();
languageLookup.IsMatch("en", "en-US"); // true
languageLookup.IsMatch("zh", "zh-cmn-Hant"); // true
languageLookup.IsMatch("sr-Latn", "sr-Latn-RS"); // true
languageLookup.IsMatch("zha", "zh-Hans"); // false
languageLookup.IsMatch("zh-Hant", "zh-Hans"); // false

3rd Party Tools

• AwesomeAssertions
• Bring Your Own Badge
• CSharpier
• Create Pull Request
• GH Release
• Git Auto Commit
• GitHub Actions
• GitHub Dependabot
• Husky.Net
• Nerdbank.GitVersioning
• Serilog
• xUnit.Net

Other Language Tag Libraries

• github.com/DanSmith/languagetags-sharp
• github.com/jkporter/bcp47
• github.com/mattcg/language-subtag-registry
• github.com/rspeer/langcodes

License

Licensed under the MIT License