jibber_jabber

README

Jibber Jabber

Jibber Jabber is a GoLang Library that can be used to detect an operating system's current language.

OS Support

OSX and Linux via the LC_ALL and LANG environment variables. These are standard variables that are used in ALL versions of UNIX for language detection.

Windows via GetUserDefaultLocaleName and GetSystemDefaultLocaleName system calls. These calls are supported in Windows Vista and up.

Usage

Add the following line to your go import:

	"github.com/cloudfoundry/jibber_jabber"

DetectIETF

DetectIETF will return the current locale as a string. The format of the locale will be the ISO 639 two-letter language code, a DASH, then an ISO 3166 two-letter country code.

	userLocale, err := jibber_jabber.DetectIETF()
	println("Locale:", userLocale)

DetectLanguage

DetectLanguage will return the current languge as a string. The format will be the ISO 639 two-letter language code.

	userLanguage, err := jibber_jabber.DetectLanguage()
	println("Language:", userLanguage)

DetectTerritory

DetectTerritory will return the current locale territory as a string. The format will be the ISO 3166 two-letter country code.

	localeTerritory, err := jibber_jabber.DetectTerritory()
	println("Territory:", localeTerritory)

Errors

All the Detect commands will return an error if they are unable to read the Locale from the system.

For Windows, additional error information is provided due to the nature of the system call being used.

Documentation

Index

• Constants
• Variables
• func DetectIETF() (locale string, err error)
• func DetectLanguage() (language string, err error)
• func DetectTerritory() (territory string, err error)

Constants

const (
	COULD_NOT_DETECT_PACKAGE_ERROR_MESSAGE = "Could not detect Language"
)

const LOCALE_NAME_MAX_LENGTH uint32 = 85

Variables

var SUPPORTED_LOCALES = map[uintptr]string{
	0x0407: "de-DE",
	0x0409: "en-US",
	0x0c0a: "es-ES",
	0x040c: "fr-FR",
	0x0410: "it-IT",
	0x0411: "ja-JA",
	0x0412: "ko_KR",
	0x0416: "pt-BR",

	0x0804: "zh-CN",
	0x0c04: "zh-HK",
	0x0404: "zh-TW",
}

Functions

func DetectIETF

func DetectIETF() (locale string, err error)

func DetectLanguage

func DetectLanguage() (language string, err error)

func DetectTerritory

func DetectTerritory() (territory string, err error)