Package com.metsci.glimpse.util.primitives

Class BytesArray

java.lang.Object

com.metsci.glimpse.util.primitives.BytesArray

All Implemented Interfaces:

Bytes, BytesModifiable

public class BytesArray
extends Object
implements BytesModifiable

Author:

hogye

Field Summary

Fields

Modifier and Type	Field	Description
byte[]	a
static CharsetEncoder	encoder
int	n

Fields inherited from interface com.metsci.glimpse.util.primitives.Bytes

utf8

Constructor Summary

Constructors

Constructor	Description
BytesArray()
BytesArray(byte[] a)	For efficiency, does not clone the array arg.
BytesArray(byte[] a, int n)	For efficiency, does not clone the array arg.
BytesArray(int n)
BytesArray(Bytes xs)	Clones the sequence arg.
BytesArray(String s)

Method Summary

Modifier and Type	Method	Description
void	append(byte v)
void	append(byte[] vs)
void	append(byte[] vs, int from, int to)
void	append(Bytes vs)
void	append(Bytes vs, int from, int to)
void	append(String s)
void	append(String s, int from, int to)
void	append(ByteBuffer vs)
void	append(ByteBuffer vs, int c)
void	clear()
void	compact()
BytesArray	copy()
byte[]	copyOf()
byte[]	copyOf(int i, int c)
void	copyTo(int i, byte[] dest, int iDest, int c)
void	copyTo(int i, ByteBuffer dest, int c)
void	copyTo(ByteBuffer dest)
void	ensureCapacity(int minCapacity)
byte	first()
void	insert(int i, byte v)
void	insert(int i, byte[] vs)
void	insert(int i, byte[] vs, int from, int to)
void	insert(int i, Bytes vs)
void	insert(int i, Bytes vs, int from, int to)
void	insert(int i, String s)
void	insert(int i, String s, int from, int to)
void	insert(int i, ByteBuffer vs)
void	insert(int i, ByteBuffer vs, int c)
boolean	isEmpty()
byte	last()
int	n()	Length of the sequence
static byte[]	newArray(int oldCapacity, int minNewCapacity)	Creates a new array whose capacity is at least minNewCapacity, and at least 1.618 * oldCapacity, up to Integer.MAX_VALUE.
void	prepend(byte v)
void	prepend(byte[] vs)
void	prepend(byte[] vs, int from, int to)
void	prepend(Bytes vs)
void	prepend(Bytes vs, int from, int to)
void	prepend(String s)
void	prepend(String s, int from, int to)
void	prepend(ByteBuffer vs)
void	prepend(ByteBuffer vs, int c)
void	prepForAppend(int c)	Makes room in this array for new values to be appended.
void	prepForInsert(int i, int c)	Makes room in this array for new values to be inserted.
void	prepForPrepend(int c)	Makes room in this array for new values to be prepended.
void	remove(byte v)	Removes a single copy of the specified value.
void	removeIndex(int index)	Remove value at index.
void	removeRange(int from, int to)	Removes values starting at index from (inclusive) to index to (exclusive).
void	set(int i, byte v)
void	set(int i, byte[] vs)
void	set(int i, byte[] vs, int from, int to)
String	string()
String	string(int i, int c)	Strings are encoded and decoded using the UTF-8 charset (multi-byte charsets just aren't worth the increased complication in indexing).
byte	v(int i)	Value at index i

Methods inherited from class java.lang.Object

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

Field Detail

encoder

public static final CharsetEncoder encoder

a

public byte[] a

n

public int n

Constructor Detail

BytesArray

public BytesArray(byte[] a)

For efficiency, does not clone the array arg.

BytesArray

public BytesArray(int n)

BytesArray

public BytesArray()

BytesArray

public BytesArray(byte[] a,
                  int n)

For efficiency, does not clone the array arg.

BytesArray

public BytesArray(Bytes xs)

Clones the sequence arg.

BytesArray

public BytesArray(String s)

Method Detail

v

public byte v(int i)

Description copied from interface: Bytes

Value at index i

Specified by:

v in interface Bytes

n

public int n()

Description copied from interface: Bytes

Length of the sequence

Specified by:

n in interface Bytes

copyTo

public void copyTo(int i,
                   byte[] dest,
                   int iDest,
                   int c)

Specified by:

copyTo in interface Bytes

copyTo

public void copyTo(int i,
                   ByteBuffer dest,
                   int c)

Specified by:

copyTo in interface Bytes

copyTo

public void copyTo(ByteBuffer dest)

Specified by:

copyTo in interface Bytes

copyOf

public byte[] copyOf(int i,
                     int c)

Specified by:

copyOf in interface Bytes

copyOf

public byte[] copyOf()

Specified by:

copyOf in interface Bytes

copy

public BytesArray copy()

Specified by:

copy in interface Bytes

Specified by:

copy in interface BytesModifiable

string

public String string()

Specified by:

string in interface Bytes

string

public String string(int i,
                     int c)

Description copied from interface: Bytes

Strings are encoded and decoded using the UTF-8 charset (multi-byte charsets just aren't worth the increased complication in indexing). FIXME: This is probably broken, because UTF-8 *is* a multi-byte charset

Specified by:

string in interface Bytes

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Bytes

first

public byte first()

Specified by:

first in interface Bytes

last

public byte last()

Specified by:

last in interface Bytes

set

public void set(int i,
                byte v)

Specified by:

set in interface BytesModifiable

set

public void set(int i,
                byte[] vs)

Specified by:

set in interface BytesModifiable

set

public void set(int i,
                byte[] vs,
                int from,
                int to)

Specified by:

set in interface BytesModifiable

insert

public void insert(int i,
                   byte v)

Specified by:

insert in interface BytesModifiable

insert

public void insert(int i,
                   Bytes vs)

Specified by:

insert in interface BytesModifiable

insert

public void insert(int i,
                   Bytes vs,
                   int from,
                   int to)

Specified by:

insert in interface BytesModifiable

insert

public void insert(int i,
                   String s)

Specified by:

insert in interface BytesModifiable

insert

public void insert(int i,
                   String s,
                   int from,
                   int to)

Specified by:

insert in interface BytesModifiable

insert

public void insert(int i,
                   byte[] vs)

Specified by:

insert in interface BytesModifiable

insert

public void insert(int i,
                   byte[] vs,
                   int from,
                   int to)

Specified by:

insert in interface BytesModifiable

insert

public void insert(int i,
                   ByteBuffer vs)

Specified by:

insert in interface BytesModifiable

insert

public void insert(int i,
                   ByteBuffer vs,
                   int c)

Specified by:

insert in interface BytesModifiable

prepForInsert

public void prepForInsert(int i,
                          int c)

Makes room in this array for new values to be inserted. When this call returns, the values in this.a on [i,i+c) are undefined. Writing meaningful values to these indices is up to the caller.

Parameters:

i - The index at which new values will be inserted

c - The count of new values that will be inserted

prepend

public void prepend(byte v)

Specified by:

prepend in interface BytesModifiable

prepend

public void prepend(Bytes vs)

Specified by:

prepend in interface BytesModifiable

prepend

public void prepend(Bytes vs,
                    int from,
                    int to)

Specified by:

prepend in interface BytesModifiable

prepend

public void prepend(String s)

Specified by:

prepend in interface BytesModifiable

prepend

public void prepend(String s,
                    int from,
                    int to)

Specified by:

prepend in interface BytesModifiable

prepend

public void prepend(byte[] vs)

Specified by:

prepend in interface BytesModifiable

prepend

public void prepend(byte[] vs,
                    int from,
                    int to)

Specified by:

prepend in interface BytesModifiable

prepend

public void prepend(ByteBuffer vs)

Specified by:

prepend in interface BytesModifiable

prepend

public void prepend(ByteBuffer vs,
                    int c)

Specified by:

prepend in interface BytesModifiable

prepForPrepend

public void prepForPrepend(int c)

Makes room in this array for new values to be prepended. When this call returns, the values in this.a on [0,c) are undefined. Writing meaningful values to these indices is up to the caller.

Parameters:

c - The count of new values that will be inserted

append

public void append(byte v)

Specified by:

append in interface BytesModifiable

append

public void append(Bytes vs)

Specified by:

append in interface BytesModifiable

append

public void append(Bytes vs,
                   int from,
                   int to)

Specified by:

append in interface BytesModifiable

append

public void append(String s)

Specified by:

append in interface BytesModifiable

append

public void append(String s,
                   int from,
                   int to)

Specified by:

append in interface BytesModifiable

append

public void append(byte[] vs)

Specified by:

append in interface BytesModifiable

append

public void append(byte[] vs,
                   int from,
                   int to)

Specified by:

append in interface BytesModifiable

append

public void append(ByteBuffer vs)

Specified by:

append in interface BytesModifiable

append

public void append(ByteBuffer vs,
                   int c)

Specified by:

append in interface BytesModifiable

prepForAppend

public void prepForAppend(int c)

Makes room in this array for new values to be appended. When this call returns, the values in this.a on [this.n-c,this.n) are undefined. Writing meaningful values to these indices is up to the caller.

Parameters:

c - The count of new values that will be appended

remove

public void remove(byte v)

Description copied from interface: BytesModifiable

Removes a single copy of the specified value. If multiple copies are present, there is no guarantee which one will be removed.

Specified by:

remove in interface BytesModifiable

removeRange

public void removeRange(int from,
                        int to)

Description copied from interface: BytesModifiable

Removes values starting at index from (inclusive) to index to (exclusive). All other values with indices greater than or equal to index to have their index in the array decreased by to-from and the size of the array is decreased by to-from.

Specified by:

removeRange in interface BytesModifiable

removeIndex

public void removeIndex(int index)

Description copied from interface: BytesModifiable

Remove value at index. All other values with indices greater than index have their index in the array decreased by one and the size of the array is decreased by one.

Specified by:

removeIndex in interface BytesModifiable

clear

public void clear()

Specified by:

clear in interface BytesModifiable

ensureCapacity

public void ensureCapacity(int minCapacity)

Specified by:

ensureCapacity in interface BytesModifiable

compact

public void compact()

Specified by:

compact in interface BytesModifiable

newArray

public static byte[] newArray(int oldCapacity,
                              int minNewCapacity)

Creates a new array whose capacity is at least minNewCapacity, and at least 1.618 * oldCapacity, up to Integer.MAX_VALUE.