Package 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 org.apache.commons.io.input.BOMInputStream.

Since:

2.0

Version:

$Id: ByteOrderMark.java 1304166 2012-03-23 02:35:48Z ggregory $

See Also:

org.apache.commons.io.input.BOMInputStream, Wikipedia: Byte Order Mark, W3C: Autodetection of Character Encodings (Non-Normative), Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static ByteOrderMark	UTF_16BE	UTF-16BE BOM (Big-Endian)
static ByteOrderMark	UTF_16LE	UTF-16LE BOM (Little-Endian)
static ByteOrderMark	UTF_32BE	UFT-32BE BOM (Big-Endian)
static ByteOrderMark	UTF_32LE	UTF-32LE BOM (Big-Endian)
static ByteOrderMark	UTF_8	UTF-8 BOM

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
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

UFT-32BE BOM (Big-Endian)

Since:

2.2

UTF_32LE

public static final ByteOrderMark UTF_32LE

UTF-32LE BOM (Big-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