LongSeq Class Reference
[Built-in Sequences]

Instantiates com.rti.dds.util.Sequence < long >. More...

Inheritance diagram for LongSeq:

List of all members.

Public Member Functions
	LongSeq ()
	Constructs an empty sequence of long integers with an initial maximum of zero.
	LongSeq (int initialMaximum)
	Constructs an empty sequence of long integers with the given initial maximum.
	LongSeq (long[] longs)
	Constructs a new sequence containing the given longs.
boolean	addAllLong (long[] elements, int offset, int length)
	Append length elements from the given array to this sequence, starting at index offset in that array.
boolean	addAllLong (long[] elements)
void	addLong (long element)
	Append the element to the end of the sequence.
void	addLong (int index, long element)
	Shift all elements in the sequence starting from the given index and add the element to the given index.
long	getLong (int index)
	Returns the long at the given index.
long	setLong (int index, long element)
	Set the new long at the given index and return the old long.
void	setLong (int dstIndex, long[] elements, int srcIndex, int length)
	Copy a portion of the given array into this sequence.
long[]	toArrayLong (long[] array)
	Return an array containing copy of the contents of this sequence.
int	getMaximum ()
	Get the current maximum number of elements that can be stored in this sequence.
Object	get (int index)
	A wrapper for getLong(int) that return a java.lang.Long.
Object	set (int index, Object element)
	A wrapper for setLong().
void	add (int index, Object element)
	A wrapper for addLong(int, int).

---

Detailed Description

Instantiates com.rti.dds.util.Sequence < long >.

Instantiates:

<<generic>> com.rti.dds.util.Sequence

See also:

long

com.rti.dds.util.Sequence

---

Constructor & Destructor Documentation

LongSeq

(

)

Constructs an empty sequence of long integers with an initial maximum of zero.

LongSeq

(

int

initialMaximum

)

Constructs an empty sequence of long integers with the given initial maximum.

LongSeq

(

long[]

longs

)

Constructs a new sequence containing the given longs.

Parameters:

longs

the initial contents of this sequence

Exceptions:

NullPointerException

if the input array is null

---

Member Function Documentation

boolean addAllLong	(	long[]	elements,
		int	offset,
		int	length
	)

Append length elements from the given array to this sequence, starting at index offset in that array.

Exceptions:

NullPointerException

if the given array is null.

boolean addAllLong

(

long[]

elements

)

Exceptions:

NullPointerException

if the given array is null

void addLong

(

long

element

)

Append the element to the end of the sequence.

void addLong	(	int	index,
		long	element
	)

Shift all elements in the sequence starting from the given index and add the element to the given index.

long getLong

(

int

index

)

Returns the long at the given index.

Exceptions:

IndexOutOfBoundsException

if the index is out of bounds.

long setLong	(	int	index,
		long	element
	)

Set the new long at the given index and return the old long.

Exceptions:

IndexOutOfBoundsException

if the index is out of bounds.

void setLong	(	int	dstIndex,
		long[]	elements,
		int	srcIndex,
		int	length
	)

Copy a portion of the given array into this sequence.

Parameters:

	dstIndex	the index at which to start copying into this sequence.
	elements	an array of primitive elements.
	srcIndex	the index at which to start copying from the given array.
	length	the number of elements to copy.

Exceptions:

IndexOutOfBoundsException

if copying would cause access of data outside array bounds.

long [] toArrayLong

(

long[]

array

)

Return an array containing copy of the contents of this sequence.

Parameters:

array

The array into which this sequence should be copied. It may be null. If it is, or if array length is too small, the array will be ignored, and a new array of the necessary length will be created and copied into instead.

Returns:

A non-null array containing a copy of the contents of this sequence.

int getMaximum

(

)

Get the current maximum number of elements that can be stored in this sequence.

The maximum of the sequence represents the maximum number of elements that the underlying buffer can hold. It does not represent the current number of elements.

The maximum is a non-negative number. It is initialized when the sequence is first created.

The maximum can be changed implicitly by adding an element to the sequence with add(), or explicitly by calling Sequence.setMaximum.

Returns:

the current maximum of the sequence.

See also:

Sequence.size()

Implements Sequence.

Object get

(

int

index

)

[virtual]

A wrapper for getLong(int) that return a java.lang.Long.

See also:

java.util.List.get(int)

Implements AbstractPrimitiveSequence.

Object set	(	int	index,
		Object	element
	)			[virtual]

A wrapper for setLong().

Exceptions:

ClassCastException

if the element is not of type Long.

See also:

java.util.List.set(int, java.lang.Object)

Implements AbstractPrimitiveSequence.

void add	(	int	index,
		Object	element
	)			[virtual]

A wrapper for addLong(int, int).

Exceptions:

ClassCastException

if the element is not of type Long.

See also:

java.util.List.add(int, java.lang.Object)

Implements AbstractPrimitiveSequence.