Module io.github.mmm.base

Package io.github.mmm.base.i18n

Class LocaleHelper

java.lang.Object

io.github.mmm.base.i18n.LocaleHelper

public final class LocaleHelper
extends Object

Simple helper for Locale specific stuff.

Since:

1.0.0

Field Summary

Fields

Modifier and Type	Field	Description
static final char	SEPARATOR_DEFAULT	The default separator used for locale-infixes.
static final char	SEPARATOR_EXTENSION	The separator used for extension keys.
static final char	SEPARATOR_FOR_LANGUAGE_TAG	The separator used for language tag.
static final char	SEPARATOR_SCRIPT	The separator used for script.

Method Summary

Modifier and Type	Method	Description
static Locale	fromString(String locale)	Create a Locale from a given String representation such as Locale.toString() or Locale.forLanguageTag(String).
static String	toInfix(Locale locale)
static String[]	toInfixes(Locale locale)	This method determines the infix-strings for localization lookup ordered from most specific to least specific (empty string representing Locale.ROOT).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

SEPARATOR_DEFAULT

public static final char SEPARATOR_DEFAULT

The default separator used for locale-infixes.

See Also:

• Constant Field Values

SEPARATOR_FOR_LANGUAGE_TAG

public static final char SEPARATOR_FOR_LANGUAGE_TAG

The separator used for language tag.

See Also:

• Constant Field Values

SEPARATOR_EXTENSION

public static final char SEPARATOR_EXTENSION

The separator used for extension keys.

See Also:

• Constant Field Values

SEPARATOR_SCRIPT

public static final char SEPARATOR_SCRIPT

The separator used for script.

See Also:

• Constant Field Values

Method Details

toInfix

public static String toInfix(Locale locale)

Parameters:

locale - is the Locale.

Returns:

the localization-infix in the form [_language[_country[_variant]]]. Will be the empty String for the root locale. E.g. for Locale.GERMANY this method will return "_de_DE".

toInfixes

public static String[] toInfixes(Locale locale)

This method determines the infix-strings for localization lookup ordered from most specific to least specific (empty string representing Locale.ROOT). Each infix is defined as:

 [_language[_country[_variant]]]
 

Please note that if a segment is empty but a following segment is present, multiple underscores ('_') will occur.
Examples:

locale	result
Locale.GERMANY	{"_de_DE", "_de", ""}
new Locale("", "CM")	{"__CM", ""}
new Locale("", "", "variant")	{"___variant", ""}

Parameters:

locale - is the Locale.

Returns:

the localization-infixes ordered from most specific to least specific. The returned array will always contain the empty string as last entry.

fromString

public static Locale fromString(String locale)

Create a Locale from a given String representation such as Locale.toString() or Locale.forLanguageTag(String).

Parameters:

locale - the String representation of the Locale. May be an from Locale.toString(), Locale.toLanguageTag() or toInfix(Locale).

Returns:

the parsed Locale.