Class Charsets

java.lang.Object
org.apache.commons.codec.Charsets

public class Charsets extends Object
Charsets required of every implementation of the Java platform. From the Java documentation Standard charsets:

Every implementation of the Java platform is required to support the following character encodings. Consult the release documentation for your implementation to see if any other encodings are supported. Consult the release documentation for your implementation to see if any other encodings are supported.

  • US-ASCII

    Seven-bit ASCII, a.k.a. ISO646-US, a.k.a. the Basic Latin block of the Unicode character set.

  • ISO-8859-1

    ISO Latin Alphabet No. 1, a.k.a. ISO-LATIN-1.

  • UTF-8

    Eight-bit Unicode Transformation Format.

  • UTF-16BE

    Sixteen-bit Unicode Transformation Format, big-endian byte order.

  • UTF-16LE

    Sixteen-bit Unicode Transformation Format, little-endian byte order.

  • UTF-16

    Sixteen-bit Unicode Transformation Format, byte order specified by a mandatory initial byte-order mark (either order accepted on input, big-endian used on output.)

This perhaps would best belong in the Commons Lang project. Even if a similar class is defined in Commons Lang, it is not foreseen that Commons Codec would be made to depend on Commons Lang.

This class is immutable and thread-safe.

Since:
1.7
See Also:
  • Field Details

  • Constructor Details

    • Charsets

      Deprecated.
      TODO Make private in 2.0.
      TODO Make private in 2.0.
  • Method Details

    • toCharset

      public static Charset toCharset(Charset charset)
      Returns the given Charset or the default Charset if the given Charset is null.
      Parameters:
      charset - A charset or null.
      Returns:
      the given Charset or the default Charset if the given Charset is null
    • toCharset

      public static Charset toCharset(String charset)
      Returns a Charset for the named charset. If the name is null, return the default Charset.
      Parameters:
      charset - The name of the requested charset, may be null.
      Returns:
      a Charset for the named charset
      Throws:
      UnsupportedCharsetException - If the named charset is unavailable