com.ibm.icu.charset
Class CharsetSelector
java.lang.Object
com.ibm.icu.charset.CharsetSelector
public final class CharsetSelector
- extends java.lang.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:
- Stable ICU 4.2.
Constructor Summary |
CharsetSelector(java.util.List<java.lang.String> charsetList,
UnicodeSet excludedCodePoints,
int mappingTypes)
Construct a CharsetSelector from a list of charset names. |
Method Summary |
java.util.List<java.lang.String> |
selectForString(java.lang.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 |
CharsetSelector
public CharsetSelector(java.util.List<java.lang.String> 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:
java.lang.IllegalArgumentException
- if the parameters is invalid.
java.nio.charset.IllegalCharsetNameException
- If the given charset name is illegal.
java.nio.charset.UnsupportedCharsetException
- If no support for the named charset is available in this
instance of the Java virtual machine.- Status:
- Stable ICU 4.2.
selectForString
public java.util.List<java.lang.String> selectForString(java.lang.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:
- Stable ICU 4.2.
Copyright (c) 2011 IBM Corporation and others.