Package com.adobe.agl.charset

Class CharsetICU

  • All Implemented Interfaces:
    java.lang.Comparable<java.nio.charset.Charset>
    public abstract class CharsetICU
extends java.nio.charset.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.

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static int ROUNDTRIP_AND_FALLBACK_SET
      Deprecated.
      This API is ICU internal only.
      static int ROUNDTRIP_SET
      Parameter that select the set of roundtrippable Unicode code points.

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean contains​(java.nio.charset.Charset cs)
      Ascertains if a charset is a sub set of this charset Implements the abstract method of super class.
      static java.nio.charset.Charset forNameICU​(java.lang.String charsetName)
      Returns a charset object for the named charset.

      • Methods inherited from class java.nio.charset.Charset

        aliases, availableCharsets, canEncode, compareTo, decode, defaultCharset, displayName, displayName, encode, encode, equals, forName, hashCode, isRegistered, isSupported, name, newDecoder, newEncoder, toString

      • Methods inherited from class java.lang.Object

        getClass, notify, notifyAll, wait, wait, wait

    • Field Detail

      • ROUNDTRIP_SET

        public static final int ROUNDTRIP_SET
        Parameter that select the set of roundtrippable Unicode code points.
        See Also:
        Constant Field Values

      • ROUNDTRIP_AND_FALLBACK_SET

        public static final int ROUNDTRIP_AND_FALLBACK_SET
        Deprecated.
        This API is ICU internal only.
        Select the set of Unicode code points with roundtrip or fallback mappings. Not supported at this point.
        See Also:
        Constant Field Values

    • Method Detail

      • contains

        public boolean contains​(java.nio.charset.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 java.nio.charset.Charset
        Parameters:
        cs - charset to test
        Returns:
        true if the given charset is a subset of this charset

      • forNameICU

        public static java.nio.charset.Charset forNameICU​(java.lang.String charsetName)
                                           throws java.nio.charset.IllegalCharsetNameException,
                                                  java.nio.charset.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:
        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 th Java virtual machine