org.apache.commons.io
Class ByteOrderMark

java.lang.Object
  org.apache.commons.io.ByteOrderMark

All Implemented Interfaces:

Serializable

public class ByteOrderMark
extends Object
implements Serializable

Byte Order Mark (BOM) representation - see BOMInputStream.

Since:

2.0

Version:

$Id: ByteOrderMark.java 1347571 2012-06-07 11:13:53Z sebb $

See Also:

BOMInputStream, Wikipedia: Byte Order Mark, W3C: Autodetection of Character Encodings (Non-Normative), Serialized Form

Field Summary

static ByteOrderMark	UTF_16BE UTF-16BE BOM (Big-Endian)
static ByteOrderMark	UTF_16LE UTF-16LE BOM (Little-Endian)
static ByteOrderMark	UTF_32BE UTF-32BE BOM (Big-Endian)
static ByteOrderMark	UTF_32LE UTF-32LE BOM (Little-Endian)
static ByteOrderMark	UTF_8 UTF-8 BOM

Constructor Summary

ByteOrderMark(String charsetName, int... bytes)
Construct a new BOM.

Method Summary

boolean	equals(Object obj) Indicates if this BOM's bytes equals another.
int	get(int pos) The byte at the specified position.
byte[]	getBytes() Return a copy of the BOM's bytes.
String	getCharsetName() Return the name of the Charset the BOM represents.
int	hashCode() Return the hashcode for this BOM.
int	length() Return the length of the BOM's bytes.
String	toString() Provide a String representation of the BOM.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

UTF_8

public static final ByteOrderMark UTF_8

UTF-8 BOM

UTF_16BE

public static final ByteOrderMark UTF_16BE

UTF-16BE BOM (Big-Endian)

UTF_16LE

public static final ByteOrderMark UTF_16LE

UTF-16LE BOM (Little-Endian)

UTF_32BE

public static final ByteOrderMark UTF_32BE

UTF-32BE BOM (Big-Endian)

Since:

2.2

UTF_32LE

public static final ByteOrderMark UTF_32LE

UTF-32LE BOM (Little-Endian)

Since:

2.2

Constructor Detail

ByteOrderMark

public ByteOrderMark(String charsetName,
                     int... bytes)

Construct a new BOM.

Parameters:

charsetName - The name of the charset the BOM represents

bytes - The BOM's bytes

Throws:

IllegalArgumentException - if the charsetName is null or zero length

IllegalArgumentException - if the bytes are null or zero length

Method Detail

getCharsetName

public String getCharsetName()

Return the name of the Charset the BOM represents.

Returns:

the character set name

length

public int length()

Return the length of the BOM's bytes.

Returns:

the length of the BOM's bytes

get

public int get(int pos)

The byte at the specified position.

Parameters:

pos - The position

Returns:

The specified byte

getBytes

public byte[] getBytes()

Return a copy of the BOM's bytes.

Returns:

a copy of the BOM's bytes

equals

public boolean equals(Object obj)

Indicates if this BOM's bytes equals another.

Overrides:

equals in class Object

Parameters:

obj - The object to compare to

Returns:

true if the bom's bytes are equal, otherwise false

hashCode

public int hashCode()

Return the hashcode for this BOM.

Overrides:

hashCode in class Object

Returns:

the hashcode for this BOM.

See Also:

Object.hashCode()

toString

public String toString()

Provide a String representation of the BOM.

Overrides:

toString in class Object

Returns:

the length of the BOM's bytes