com.ibm.icu.charset
Class CharsetICU
java.lang.Object
java.nio.charset.Charset
com.ibm.icu.charset.CharsetICU
- All Implemented Interfaces:
- Comparable
public abstract class CharsetICU
- extends Charset
A subclass of java.nio.Charset for providing implementation of ICU's charset converters.
This API is used to convert codepage or character encoded data to and
from UTF-16. You can open a converter with Charset.forName(java.lang.String)
and forNameICU(java.lang.String)
. With that
converter, you can get its properties, set options, convert your data.
Since many software programs recogize different converter names for
different types of converters, there are other functions in this API to
iterate over the converter aliases.
- Status:
- Draft ICU 3.6.
Method Summary |
boolean |
contains(Charset cs)
Ascertains if a charset is a sub set of this charset
Implements the abstract method of super class. |
static Charset |
forNameICU(String charsetName)
Returns a charset object for the named charset. |
Methods inherited from class java.nio.charset.Charset |
aliases, availableCharsets, canEncode, compareTo, compareTo, decode, defaultCharset, displayName, displayName, encode, encode, equals, forName, hashCode, isRegistered, isSupported, name, newDecoder, newEncoder, toString |
CharsetICU
protected CharsetICU(String icuCanonicalName,
String canonicalName,
String[] aliases)
- Parameters:
icuCanonicalName
- canonicalName
- aliases
- - Status:
- Draft ICU 3.6.
contains
public boolean contains(Charset cs)
- Ascertains if a charset is a sub set of this charset
Implements the abstract method of super class.
- Specified by:
contains
in class Charset
- Parameters:
cs
- charset to test
- Returns:
- true if the given charset is a subset of this charset
- Status:
- Stable ICU 3.6.
forNameICU
public static Charset forNameICU(String charsetName)
throws IllegalCharsetNameException,
UnsupportedCharsetException
- Returns a charset object for the named charset.
This method gurantee that ICU charset is returned when
available. If the ICU charset provider does not support
the specified charset, then try other charset providers
including the standard Java charset provider.
- Parameters:
charsetName
- The name of the requested charset,
may be either a canonical name or an alias
- Returns:
- A charset object for the named charset
- Throws:
IllegalCharsetNameException
- If the given charset name
is illegal
UnsupportedCharsetException
- If no support for the
named charset is available in this instance of th Java
virtual machine- Status:
- Draft ICU 3.6.
Copyright (c) 2007 IBM Corporation and others.