com.ibm.icu.charset

Class CharsetSelector

java.lang.Object

com.ibm.icu.charset.CharsetSelector

public final class CharsetSelector
extends Object

Charset Selector A charset selector is built with a list of charset names and given an input CharSequence returns the list of names the corresponding charsets which can convert the CharSequence.

Status:

Draft ICU 4.2.

Constructor Summary

Constructors

Constructor and Description
CharsetSelector(List charsetList, UnicodeSet excludedCodePoints, int mappingTypes) Construct a CharsetSelector from a list of charset names.

Method Summary

Methods

Modifier and Type	Method and Description
List	selectForString(CharSequence unicodeText) Select charsets that can map all characters in a CharSequence, ignoring the excluded code points.

Methods inherited from class java.lang.Object

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

Constructor Detail

CharsetSelector

public CharsetSelector(List charsetList,
               UnicodeSet excludedCodePoints,
               int mappingTypes)

Construct a CharsetSelector from a list of charset names.

Parameters:

charsetList - a list of charset names in the form of strings. If charsetList is empty, a selector for all available charset is constructed.

excludedCodePoints - a set of code points to be excluded from consideration. Excluded code points appearing in the input CharSequence do not change the selection result. It could be empty when no code point should be excluded.

mappingTypes - an int which determines whether to consider only roundtrip mappings or also fallbacks, e.g. CharsetICU.ROUNDTRIP_SET. See CharsetICU.java for the constants that are currently supported.

Throws:

IllegalArgumentException - if the parameters is invalid.

IllegalCharsetNameException - If the given charset name is illegal.

UnsupportedCharsetException - If no support for the named charset is available in this instance of the Java virtual machine.

Status:

Draft ICU 4.2.

Method Detail

selectForString

public List selectForString(CharSequence unicodeText)

Select charsets that can map all characters in a CharSequence, ignoring the excluded code points.

Parameters:

unicodeText - a CharSequence. It could be empty.

Returns:

a list that contains charset names in the form of strings. The returned encoding names and their order will be the same as supplied when building the selector.

Status:

Draft ICU 4.2.