locale

README

go-locale

go-locale is a Golang lib for cross platform locale detection.

OS Support

Linux

Check order

• LANGUAGE env
• LC_ALL env
• LC_MESSAGES env
• LANG env
• locale command call

Support

• All linux distributions

Windows

Check order

• Win32 OLE

Support

• Windows Vista or Windows Server 2008 Later

macOS X (darwin)

Check order

• All check for Linux
• User Defaults System

Support

• All macOS X version

Usage

import (
    "github.com/Xuanwo/go-locale"
)

func main() {
	tag, err := locale.Detect()
    if err != nil {
        log.Fatal(err)
    }
    // Have fun with language.Tag!
    
    tags, err := locale.DetectAll()
    if err != nil {
        log.Fatal(err)
    }
    // Get all available tags
}

Acknowledgments

Inspired by jibber_jabber

Documentation

Index

• Variables
• func Detect() (tag language.Tag, err error)
• func DetectAll() (tags []language.Tag, err error)
• type Error
  • func (e *Error) Error() string
  • func (e *Error) Unwrap() error

Variables

var (
	// ErrNotDetected returns while no locale detected.
	ErrNotDetected = errors.New("not detected")
	// ErrNotSupported means current platform or language is not supported.
	ErrNotSupported = errors.New("not supported")
)

Functions

func Detect

func Detect() (tag language.Tag, err error)

Detect will detect current env's language.

func DetectAll

func DetectAll() (tags []language.Tag, err error)

DetectAll will detect current env's all available language.

Types

type Error

type Error struct {
	Op  string
	Err error
}

Error is the error returned by locale.

func (*Error) Error

func (e *Error) Error() string

func (*Error) Unwrap

func (e *Error) Unwrap() error

Unwrap implements xerrors.Wrapper