com.idevicesinc.sweetblue.utils

Class ByteBuffer

java.lang.Object

com.idevicesinc.sweetblue.utils.ByteBuffer

public final class ByteBuffer
extends java.lang.Object

Convenience class to build up a byte array by appending bytes, or byte arrays.

Field Summary

Fields

Modifier and Type	Field and Description
static byte	DEFAULT_BUFFER_SIZE The default size to initialize the ByteBuffer with.

Constructor Summary

Constructors

Constructor and Description
ByteBuffer() Construct a new ByteBuffer with the default of DEFAULT_BUFFER_SIZE.
ByteBuffer(byte[] bytes) Create a new ByteBuffer with the given byte array.
ByteBuffer(int initialSize) Initialize this buffer with the given initial size

Method Summary

Modifier and Type	Method and Description
void	append(byte b) Append a byte to the buffer.
void	append(byte[] bytes) Append a byte array to this buffer
void	append(byte[] data, int length) Append the given byte array (of the length given, so you can pass in an array 100 bytes, but specify 50 to be added.
byte[]	bytes() Returns the bytes currently in this buffer.
byte[]	bytesAndClear() Returns the bytes that were added to this buffer.
void	clear() Clears the buffer of any existing data.
int	length() Returns the current length of the buffer
void	setToSubData(int start, int length) Update the buffer to only contain the current data from the given start and length.
byte[]	subData(int start, int length) Returns a byte array from this buffer from the given start index, and length If length is less than 1, an empty byte array will be returned.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_BUFFER_SIZE

public static final byte DEFAULT_BUFFER_SIZE

The default size to initialize the ByteBuffer with.

See Also:

Constant Field Values

Constructor Detail

ByteBuffer

public ByteBuffer(int initialSize)

Initialize this buffer with the given initial size

ByteBuffer

public ByteBuffer(byte[] bytes)

Create a new ByteBuffer with the given byte array. Note, the byte array is cloned before inserting into the buffer.

ByteBuffer

public ByteBuffer()

Construct a new ByteBuffer with the default of DEFAULT_BUFFER_SIZE.

Method Detail

clear

public final void clear()

Clears the buffer of any existing data.

append

public final void append(byte b)

Append a byte to the buffer.

append

public final void append(byte[] bytes)

Append a byte array to this buffer

append

public final void append(byte[] data,
                         int length)

Append the given byte array (of the length given, so you can pass in an array 100 bytes, but specify 50 to be added. This operation always starts at the first index of the array).

setToSubData

public final void setToSubData(int start,
                               int length)

Update the buffer to only contain the current data from the given start and length. If the start or length are out-of-bounds, then nothing will be done to the buffer.

subData

public final byte[] subData(int start,
                            int length)

Returns a byte array from this buffer from the given start index, and length If length is less than 1, an empty byte array will be returned. An empty array will be returned also if the start index is out of range. If the length is larger than the available bytes, then a byte array will be returned with whatever bytes are available after the start index.

length

public final int length()

Returns the current length of the buffer

bytes

public final byte[] bytes()

Returns the bytes currently in this buffer.

bytesAndClear

public final byte[] bytesAndClear()

Returns the bytes that were added to this buffer. NOTE: This clears out the buffer, and starts with a fresh one.