com.ibm.icu.text

Class LocaleDisplayNames

java.lang.Object

com.ibm.icu.text.LocaleDisplayNames

Direct Known Subclasses:

LocaleDisplayNamesImpl

public abstract class LocaleDisplayNames
extends Object

Returns display names of ULocales and components of ULocales. For more information on language, script, region, variant, key, and values, see ULocale.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LocaleDisplayNames.DialectHandling Enum used in getInstance(ULocale, DialectHandling).
static class	LocaleDisplayNames.UiListItem Struct-like class used to return information for constructing a UI list, each corresponding to a locale.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	LocaleDisplayNames() Deprecated. This API is ICU internal only.

Method Summary

Modifier and Type	Method and Description
abstract DisplayContext	getContext(DisplayContext.Type type) Returns the current value for a specified DisplayContext.Type.
abstract LocaleDisplayNames.DialectHandling	getDialectHandling() Returns the dialect handling used in the display names.
static LocaleDisplayNames	getInstance(Locale locale) Convenience overload of getInstance(Locale, DisplayContext...) that specifies DisplayContext.STANDARD_NAMES.
static LocaleDisplayNames	getInstance(Locale locale, DisplayContext... contexts) Returns an instance of LocaleDisplayNames that returns names formatted for the provided JDK locale, using the provided DisplayContext settings
static LocaleDisplayNames	getInstance(ULocale locale) Convenience overload of getInstance(ULocale, DialectHandling) that specifies STANDARD dialect handling.
static LocaleDisplayNames	getInstance(ULocale locale, DisplayContext... contexts) Returns an instance of LocaleDisplayNames that returns names formatted for the provided locale, using the provided DisplayContext settings
static LocaleDisplayNames	getInstance(ULocale locale, LocaleDisplayNames.DialectHandling dialectHandling) Returns an instance of LocaleDisplayNames that returns names formatted for the provided locale, using the provided dialectHandling.
abstract ULocale	getLocale() Returns the locale used to determine the display names.
List<LocaleDisplayNames.UiListItem>	getUiList(Set<ULocale> localeSet, boolean inSelf, Comparator<Object> collator) Return a list of information used to construct a UI list of locale names.
abstract List<LocaleDisplayNames.UiListItem>	getUiListCompareWholeItems(Set<ULocale> localeSet, Comparator<LocaleDisplayNames.UiListItem> comparator) Return a list of information used to construct a UI list of locale names, providing more access to control the sorting.
abstract String	keyDisplayName(String key) Returns the display name of the provided locale key.
abstract String	keyValueDisplayName(String key, String value) Returns the display name of the provided value (used with the provided key).
abstract String	languageDisplayName(String lang) Returns the display name of the provided language code.
abstract String	localeDisplayName(Locale locale) Returns the display name of the provided locale.
abstract String	localeDisplayName(String localeId) Returns the display name of the provided locale id.
abstract String	localeDisplayName(ULocale locale) Returns the display name of the provided ulocale.
abstract String	regionDisplayName(String region) Returns the display name of the provided region code.
abstract String	scriptDisplayName(int scriptCode) Returns the display name of the provided script code.
abstract String	scriptDisplayName(String script) Returns the display name of the provided script code.
String	scriptDisplayNameInContext(String script) Deprecated. This API is ICU internal only.
abstract String	variantDisplayName(String variant) Returns the display name of the provided variant.

Methods inherited from class java.lang.Object

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

Constructor Detail

LocaleDisplayNames

@Deprecated
protected LocaleDisplayNames()

Deprecated. This API is ICU internal only.

Sole constructor. (For invocation by subclass constructors, typically implicit.)

Method Detail

getInstance

public static LocaleDisplayNames getInstance(ULocale locale)

Convenience overload of getInstance(ULocale, DialectHandling) that specifies STANDARD dialect handling.

Parameters:

locale - the display locale

Returns:

a LocaleDisplayNames instance

getInstance

public static LocaleDisplayNames getInstance(Locale locale)

Convenience overload of getInstance(Locale, DisplayContext...) that specifies DisplayContext.STANDARD_NAMES.

Parameters:

locale - the display JDK locale

Returns:

a LocaleDisplayNames instance

getInstance

public static LocaleDisplayNames getInstance(ULocale locale,
                                             LocaleDisplayNames.DialectHandling dialectHandling)

Returns an instance of LocaleDisplayNames that returns names formatted for the provided locale, using the provided dialectHandling.

Parameters:

locale - the display locale

dialectHandling - how to select names for locales

Returns:

a LocaleDisplayNames instance

getInstance

public static LocaleDisplayNames getInstance(ULocale locale,
                                             DisplayContext... contexts)

Returns an instance of LocaleDisplayNames that returns names formatted for the provided locale, using the provided DisplayContext settings

Parameters:

locale - the display locale

contexts - one or more context settings (e.g. for dialect handling, capitalization, etc.

Returns:

a LocaleDisplayNames instance

getInstance

public static LocaleDisplayNames getInstance(Locale locale,
                                             DisplayContext... contexts)

Returns an instance of LocaleDisplayNames that returns names formatted for the provided JDK locale, using the provided DisplayContext settings

Parameters:

locale - the display JDK locale

contexts - one or more context settings (e.g. for dialect handling, capitalization, etc.

Returns:

a LocaleDisplayNames instance

getLocale

public abstract ULocale getLocale()

Returns the locale used to determine the display names. This is not necessarily the same locale passed to getInstance(com.ibm.icu.util.ULocale).

Returns:

the display locale

getDialectHandling

public abstract LocaleDisplayNames.DialectHandling getDialectHandling()

Returns the dialect handling used in the display names.

Returns:

the dialect handling enum

getContext

public abstract DisplayContext getContext(DisplayContext.Type type)

Returns the current value for a specified DisplayContext.Type.

Parameters:

type - the DisplayContext.Type whose value to return

Returns:

the current DisplayContext setting for the specified type

localeDisplayName

public abstract String localeDisplayName(ULocale locale)

Returns the display name of the provided ulocale.

Parameters:

locale - the locale whose display name to return

Returns:

the display name of the provided locale

localeDisplayName

public abstract String localeDisplayName(Locale locale)

Returns the display name of the provided locale.

Parameters:

locale - the locale whose display name to return

Returns:

the display name of the provided locale

localeDisplayName

public abstract String localeDisplayName(String localeId)

Returns the display name of the provided locale id.

Parameters:

localeId - the id of the locale whose display name to return

Returns:

the display name of the provided locale

languageDisplayName

public abstract String languageDisplayName(String lang)

Returns the display name of the provided language code.

Parameters:

lang - the language code

Returns:

the display name of the provided language code

scriptDisplayName

public abstract String scriptDisplayName(String script)

Returns the display name of the provided script code.

Parameters:

script - the script code

Returns:

the display name of the provided script code

scriptDisplayNameInContext

@Deprecated
public String scriptDisplayNameInContext(String script)

Deprecated. This API is ICU internal only.

Returns the display name of the provided script code when used in the context of a full locale name.

Parameters:

script - the script code

Returns:

the display name of the provided script code

scriptDisplayName

public abstract String scriptDisplayName(int scriptCode)

Returns the display name of the provided script code. See UScript for recognized script codes.

Parameters:

scriptCode - the script code number

Returns:

the display name of the provided script code

regionDisplayName

public abstract String regionDisplayName(String region)

Returns the display name of the provided region code.

Parameters:

region - the region code

Returns:

the display name of the provided region code

variantDisplayName

public abstract String variantDisplayName(String variant)

Returns the display name of the provided variant.

Parameters:

variant - the variant string

Returns:

the display name of the provided variant

keyDisplayName

public abstract String keyDisplayName(String key)

Returns the display name of the provided locale key.

Parameters:

key - the locale key name

Returns:

the display name of the provided locale key

keyValueDisplayName

public abstract String keyValueDisplayName(String key,
                                           String value)

Returns the display name of the provided value (used with the provided key).

Parameters:

key - the locale key name

value - the locale key's value

Returns:

the display name of the provided value

getUiList

public List<LocaleDisplayNames.UiListItem> getUiList(Set<ULocale> localeSet,
                                                     boolean inSelf,
                                                     Comparator<Object> collator)

Return a list of information used to construct a UI list of locale names.

Parameters:

collator - how to collate—should normally be Collator.getInstance(getDisplayLocale())

inSelf - if true, compares the nameInSelf, otherwise the nameInDisplayLocale. Set depending on which field (displayLocale vs self) is to show up in the UI. If both are to show up in the UI, then it should be the one used for the primary sort order.

localeSet - a list of locales to present in a UI list. The casing uses the settings in the LocaleDisplayNames instance.

Returns:

an ordered list of UiListItems.

Throws:

IllformedLocaleException - if any of the locales in localeSet are malformed.

getUiListCompareWholeItems

public abstract List<LocaleDisplayNames.UiListItem> getUiListCompareWholeItems(Set<ULocale> localeSet,
                                                                               Comparator<LocaleDisplayNames.UiListItem> comparator)

Return a list of information used to construct a UI list of locale names, providing more access to control the sorting. Normally use getUiList instead.

Parameters:

comparator - how to sort the UiListItems in the result.

localeSet - a list of locales to present in a UI list. The casing uses the settings in the LocaleDisplayNames instance.

Returns:

an ordered list of UiListItems.

Throws:

IllformedLocaleException - if any of the locales in localeSet are malformed.