Charsets (Apache Commons Codec 1.10 API)

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

Version:

$Id: Charsets.html 928559 2014-11-10 02:53:54Z ggregory $

See Also:
Standard charsets

Field Summary

Fields
Modifier and Type	Field and Description
`static Charset`	`ISO_8859_1` Deprecated. Use Java 7's `StandardCharsets`
`static Charset`	`US_ASCII` Deprecated. Use Java 7's `StandardCharsets`
`static Charset`	`UTF_16` Deprecated. Use Java 7's `StandardCharsets`
`static Charset`	`UTF_16BE` Deprecated. Use Java 7's `StandardCharsets`
`static Charset`	`UTF_16LE` Deprecated. Use Java 7's `StandardCharsets`
`static Charset`	`UTF_8` Deprecated. Use Java 7's `StandardCharsets`

Constructor Summary

Constructors
Constructor and Description

Charsets()

Constructors
Constructor and Description
`Charsets()`

Method Summary

Methods
Modifier and Type	Method and Description
`static Charset`	`toCharset(Charset charset)` Returns the given Charset or the default Charset if the given Charset is null.
`static Charset`	`toCharset(String charset)` Returns a Charset for the named charset.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - ISO_8859_1
```
@Deprecated
public static final Charset ISO_8859_1
```
    Deprecated. Use Java 7's StandardCharsets
    
    CharEncodingISO Latin Alphabet No. 1, a.k.a. ISO-LATIN-1.
    Every implementation of the Java platform is required to support this character encoding.
    
    See Also:
    Standard charsets
  - US_ASCII
```
@Deprecated
public static final Charset US_ASCII
```
    Deprecated. Use Java 7's StandardCharsets
    
    Seven-bit ASCII, also known as ISO646-US, also known as the Basic Latin block of the Unicode character set.
    Every implementation of the Java platform is required to support this character encoding.
    
    See Also:
    Standard charsets
  - UTF_16
```
@Deprecated
public static final Charset UTF_16
```
    Deprecated. Use Java 7's StandardCharsets
    
    Sixteen-bit Unicode Transformation Format, The byte order specified by a mandatory initial byte-order mark (either order accepted on input, big-endian used on output)
    Every implementation of the Java platform is required to support this character encoding.
    
    See Also:
    Standard charsets
  - UTF_16BE
```
@Deprecated
public static final Charset UTF_16BE
```
    Deprecated. Use Java 7's StandardCharsets
    
    Sixteen-bit Unicode Transformation Format, big-endian byte order.
    Every implementation of the Java platform is required to support this character encoding.
    
    See Also:
    Standard charsets
  - UTF_16LE
```
@Deprecated
public static final Charset UTF_16LE
```
    Deprecated. Use Java 7's StandardCharsets
    
    Sixteen-bit Unicode Transformation Format, little-endian byte order.
    Every implementation of the Java platform is required to support this character encoding.
    
    See Also:
    Standard charsets
  - UTF_8
```
@Deprecated
public static final Charset UTF_8
```
    Deprecated. Use Java 7's StandardCharsets
    
    Eight-bit Unicode Transformation Format.
    Every implementation of the Java platform is required to support this character encoding.
    
    See Also:
    Standard charsets
- Constructor Detail
  - Charsets
```
public Charsets()
```
- Method Detail
  - 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

Class Charsets

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ISO_8859_1

US_ASCII

UTF_16

UTF_16BE

UTF_16LE

UTF_8

Constructor Detail

Charsets

Method Detail

toCharset

toCharset