localeutil

package module

v0.16.1 Latest Latest Go to latest Published: May 29, 2023 License: MIT Imports: 4 Imported by: 32

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/issue9/localeutil

Links

Open Source Insights

README ¶

localeutil

提供了一些常用的本地化相关功能，依赖于 golang.org/x/text

DetectUserLanguage 检测当前用户的本地化信息
LoadMessage 从 yaml、json 等格式中加载本地化的信息内容

安装

go get github.com/issue9/localeutil

版权

本项目采用 MIT 开源授权许可证，完整的授权说明可在 LICENSE 文件中找到。

Documentation ¶

Overview ¶

Package localeutil 提供一些本地化的工具

Index ¶

func DetectUserLanguage() string
func DetectUserLanguageTag() (language.Tag, error)
func Error(key Key, val ...any) error
func Width(s string) int
type Key
type LocaleStringer
- func Phrase(key Key, val ...any) LocaleStringer
type Printer
type WidthOptions
- func (wo WidthOptions) Width(s string) (w int)

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func DetectUserLanguage ¶ added in v0.13.0

func DetectUserLanguage() string

DetectUserLanguage 检测当前用户的本地化信息

按以下顺序读取本地化信息：

环境变量 LANGUAGE；
平台相关，比如 windows 下调用 GetUserDefaultLocaleName 等；
按顺序读取 LC_ALL、LC_MESSAGES 和 LANG 环境变量；

所有的环境变量遵守 tag.encoding 的格式，比如 zh_CN.UTF-8，其中的 encoding 可以省略。

func DetectUserLanguageTag ¶ added in v0.7.0

func DetectUserLanguageTag() (language.Tag, error)

DetectUserLanguageTag 检测当前用户的本地化信息

文档说明参考 DetectUserLanguage

func Error ¶ added in v0.6.0

func Error(key Key, val ...any) error

Error 返回未翻译的错误对象

该对象同时实现了 LocaleStringer 接口。

func Width ¶ added in v0.14.0

func Width(s string) int

Width 采用 defaultWidthOptions 计算字符串的宽度

如果有特殊要求，可以使用 WidthOptions 自定义各类字符的宽度。

Types ¶

type Key ¶ added in v0.12.8

type Key = message.Reference

type LocaleStringer ¶ added in v0.5.0

type LocaleStringer interface {
	// LocaleString 返回当前对象的本地化字符串
	LocaleString(*Printer) string
}

LocaleStringer 本地化字符串的接口中

func Phrase ¶ added in v0.4.0

func Phrase(key Key, val ...any) LocaleStringer

Phrase 返回一段未翻译的语言片段

key 和 val 参数与 message.Printer.Sprintf 的参数相同。如果 val 也实现了 LocaleStringer 接口，则会先调用 val 的 LocaleString 方法。

type Printer ¶ added in v0.12.8

type Printer = message.Printer

type WidthOptions ¶ added in v0.14.0

type WidthOptions map[width.Kind]int

WidthOptions 用于指定各类字符的宽度

NOTE: 对于 width.EastAsianAmbiguous 不同的字体可能有不同的设置。

func (WidthOptions) Width ¶ added in v0.14.0

func (wo WidthOptions) Width(s string) (w int)

Width 计算字符串的宽度

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
apple Package apple 苹果部分系统下的专有接口	Package apple 苹果部分系统下的专有接口
internal
defaults Package defaults 提供苹果系统功能	Package defaults 提供苹果系统功能
dll Package dll windows 平台下一些 dll	Package dll windows 平台下一些 dll
syslocale Package syslocale 获取所在系统的本地化语言信息	Package syslocale 获取所在系统的本地化语言信息
message Package message 本地化的语言文件处理	Package message 本地化的语言文件处理
windows Package windows 与 windows 系统相关的一些本地化操作函数	Package windows 与 windows 系统相关的一些本地化操作函数

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL