README
¶
i18n 
Package i18n is for app Internationalization and Localization.
This package is a fork of the https://github.com/Unknwon/i18n.
It's heavly used inside the https://github.com/kataras/iris/tree/master/middleware/i18n middleware.
Changes
This package provides some additional functionality compared to the original one;
PATCH by @j-lenoch at L129:
// IsExistSimilar returns true if the language, or something similar
// exists (e.g. en-US maps to en).
// it returns the found name and whether it was able to match something.
func IsExistSimilar(lang string) (string, bool) {
_, ok := locales.store[lang]
if ok {
return lang, true
}
// remove the internationalization element from the IETF code
code := strings.Split(lang, "-")[0]
for _, lc := range locales.store {
if strings.Contains(lc.lang, code) {
return lc.lang, true
}
}
return "", false
}
A full Patch by @kataras to support multi languages, look the `localeFiles` new type
and the `GetKey, Reload` and improvement of `locales.Add` and more.
Documentation
¶
Overview ¶
Package i18n is for app Internationalization and Localization.
Index ¶
- Variables
- func Count() int
- func GetDescriptionByIndex(index int) string
- func GetDescriptionByLang(lang string) string
- func GetLangByIndex(index int) string
- func IndexLang(lang string) int
- func IsExist(lang string) bool
- func IsExistSimilar(lang string) (string, bool)
- func ListLangDescs() []string
- func ListLangs() []string
- func ReloadLangs(langs ...string) error
- func SetDefaultLang(lang string)
- func SetMessage(lang string, localeFile interface{}, otherLocaleFiles ...interface{}) error
- func SetMessageWithDesc(lang, langDesc string, localeFile interface{}, otherLocaleFiles ...interface{}) error
- func Tr(lang, format string, args ...interface{}) string
- type Locale
Constants ¶
This section is empty.
Variables ¶
var ( // ErrLangAlreadyExist throwed when language is already exists. ErrLangAlreadyExist = errors.New("lang already exists") )
Functions ¶
func GetDescriptionByIndex ¶
func GetDescriptionByLang ¶
func GetLangByIndex ¶
GetLangByIndex return language by given index.
func IsExistSimilar ¶
IsExistSimilar returns true if the language, or something similar exists (e.g. en-US maps to en). it returns the found name and whether it was able to match something. - PATCH by @j-lenoch.
func ListLangDescs ¶
func ListLangDescs() []string
func SetDefaultLang ¶
func SetDefaultLang(lang string)
SetDefaultLang sets default language which is a indicator that when target language is not found, try find in default language again.
func SetMessage ¶
SetMessage sets the message file for localization.
Source Files