- java.lang.Object
-
- com.pervasive.datarush.sequences.scalar.AbstractScalarTokenSequence
-
- com.pervasive.datarush.sequences.scalar.ObjectTokenList<O>
-
- Type Parameters:
O- the type of Java objects in the list
- All Implemented Interfaces:
MutableTokenSequence,MutableObjectTokenSequence<O>,MutableScalarTokenSequence,ObjectTokenSequence<O>,ScalarTokenAppendable,ScalarTokenSequence,TokenAppendable,TokenSequence,ObjectTyped<O>,ScalarTyped,TokenTyped
public final class ObjectTokenList<O> extends AbstractScalarTokenSequence implements MutableObjectTokenSequence<O>
Primary implementation ofMutableObjectTokenSequence.- See Also:
TokenTypeConstant#OBJECT(Class)
-
-
Constructor Summary
Constructors Constructor Description ObjectTokenList(ObjectTokenType<O> type, int capacity)Create an empty array
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidappend(O value)Appends the specified object to this sequence.voidappend(O value, int count)Appends the specified object to this sequence multiple times.voidfill(int start, int length, O value)Sets the tokens in the specified subsequence to the given object value.voidfillValue(int start, int length, TokenValued value)Sets the tokens in the specified subsequence to the given value.OgetObject(int i)Gets the value of the specified token as an object.ObjectValued<O>getToken(int index)Gets the value at the specified position.ObjectSettable<O>getTokenSetter(int index)Returns a mutator for the given index.ObjectTokenType<O>getType()Gets the data type of the tokens in the sequence.voidgetValues(int index, O[] values, boolean[] nullFlags, int offset, int length)Gets the values and null indicators for a range of tokens.booleanisZero(int index)Indicates whether the specified token has a zero value.ObjectValuedIterator<O>newValueIterator()Creates an iterator over the non-null values of this sequence.voidsetNull(int index)Sets the token at the specified position to be null valued.voidsetNull(int start, int length)Sets the tokens in the specified subsequence to be null valued.voidsetObject(int index, O value)Sets the token at the specified position to the given object value.voidsetValue(int index, TokenValued value)Sets the token at the specified position to the given value.voidsetValues(int start, TokenSequence values, int offset, int length)Sets the tokens in the specified subsequence of the array to the corresponding values from a subsequence of the given source sequence.voidsetZero(int index)Sets the token at the specified position to be zero valued.voidsetZero(int start, int length)Sets the tokens in the specified subsequence to be zero valued.-
Methods inherited from class com.pervasive.datarush.sequences.scalar.AbstractScalarTokenSequence
append, append, append, append, appendNull, appendNull, appendZero, appendZero, capacity, compareElement, compareElements, ensureCanonical, getElementComparator, getModificationCount, hashCode, isNull, isNull, map, remaining, reset, size, toString, toString
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface com.pervasive.datarush.sequences.scalar.MutableScalarTokenSequence
ensureCanonical, getModificationCount
-
Methods inherited from interface com.pervasive.datarush.sequences.MutableTokenSequence
appendNull, appendNull, appendZero, appendZero, reset
-
Methods inherited from interface com.pervasive.datarush.sequences.scalar.ScalarTokenSequence
isNull
-
Methods inherited from interface com.pervasive.datarush.sequences.TokenAppendable
append, append, append, append
-
Methods inherited from interface com.pervasive.datarush.sequences.TokenSequence
compareElement, compareElements, getElementComparator, hashCode, isNull, size, toString
-
-
-
-
Constructor Detail
-
ObjectTokenList
public ObjectTokenList(ObjectTokenType<O> type, int capacity)
Create an empty array- Parameters:
type- the type of objects in the listcapacity- the initial capacity.
-
-
Method Detail
-
getType
public ObjectTokenType<O> getType()
Description copied from interface:ScalarTokenSequenceGets the data type of the tokens in the sequence.- Specified by:
getTypein interfaceObjectTokenSequence<O>- Specified by:
getTypein interfaceObjectTyped<O>- Specified by:
getTypein interfaceScalarTokenSequence- Specified by:
getTypein interfaceScalarTyped- Specified by:
getTypein interfaceTokenTyped- Returns:
- the token data type
-
getObject
public O getObject(int i)
Description copied from interface:ObjectTokenSequenceGets the value of the specified token as an object.This is a reference to the object representing the value. If the object is mutable, changing it modifies the value of the token in the sequence.
- Specified by:
getObjectin interfaceObjectTokenSequence<O>- Parameters:
i- the position of the token in the sequence- Returns:
- the value of the token. If the
token is null valued,
nullis returned.
-
getToken
public ObjectValued<O> getToken(int index)
Description copied from interface:TokenSequenceGets the value at the specified position.- Specified by:
getTokenin interfaceObjectTokenSequence<O>- Specified by:
getTokenin interfaceScalarTokenSequence- Specified by:
getTokenin interfaceTokenSequence- Parameters:
index- the index of the token- Returns:
- the value
-
getTokenSetter
public ObjectSettable<O> getTokenSetter(int index)
Description copied from interface:MutableTokenSequenceReturns a mutator for the given index.- Specified by:
getTokenSetterin interfaceMutableObjectTokenSequence<O>- Specified by:
getTokenSetterin interfaceMutableScalarTokenSequence- Specified by:
getTokenSetterin interfaceMutableTokenSequence- Parameters:
index- the position- Returns:
- a mutator for the given index.
-
getValues
public void getValues(int index, O[] values, boolean[] nullFlags, int offset, int length)Description copied from interface:ObjectTokenSequenceGets the values and null indicators for a range of tokens.References to the objects representing the token values are returned. If these objects are mutable, changing any modifies the values of the tokens in the sequence.
- Specified by:
getValuesin interfaceObjectTokenSequence<O>- Parameters:
index- the starting index of the rangevalues- an array into which to place element valuesnullFlags- an array into which to place null indicator valuesoffset- the starting offset into the target arrays. That is,elements[offset]andnulls[offset]will get the value and null indicator respectively of the token at positionstart, and so on.length- number of tokens to get
-
setNull
public void setNull(int index)
Description copied from interface:MutableTokenSequenceSets the token at the specified position to be null valued.- Specified by:
setNullin interfaceMutableTokenSequence- Parameters:
index- the position of the token in the array
-
setNull
public void setNull(int start, int length)Description copied from interface:MutableTokenSequenceSets the tokens in the specified subsequence to be null valued.- Specified by:
setNullin interfaceMutableTokenSequence- Parameters:
start- the starting index of the subsequence in the arraylength- the length of the subsequence
-
setZero
public void setZero(int index)
Description copied from interface:MutableTokenSequenceSets the token at the specified position to be zero valued.- Specified by:
setZeroin interfaceMutableTokenSequence- Parameters:
index- the position of the token in the array
-
setZero
public void setZero(int start, int length)Description copied from interface:MutableTokenSequenceSets the tokens in the specified subsequence to be zero valued.- Specified by:
setZeroin interfaceMutableTokenSequence- Parameters:
start- the starting index of the subsequence in the arraylength- the length of the subsequence
-
isZero
public boolean isZero(int index)
Description copied from interface:ScalarTokenSequenceIndicates whether the specified token has a zero value.- Specified by:
isZeroin interfaceScalarTokenSequence- Parameters:
index- the index of the token- Returns:
trueif the element is zero,falseotherwise
-
setObject
public void setObject(int index, O value)Sets the token at the specified position to the given object value. If the object is mutable, subsequently modifying it will modify the token in the array.- Specified by:
setObjectin interfaceMutableObjectTokenSequence<O>- Parameters:
index- the position of the token in the arrayvalue- the object value to which to set the token. Passingnullis equivalent to callingsetNull(index).
-
fill
public void fill(int start, int length, O value)Sets the tokens in the specified subsequence to the given object value. If the object is mutable, subsequently modifying it will modify the tokens in the array.- Parameters:
start- the starting index of the subsequence in the arraylength- the length of the subsequencevalue- the numeric value to which to set the tokens. Passingnullis equivalent to callingsetNull(start, length).
-
setValue
public void setValue(int index, TokenValued value)Description copied from interface:MutableTokenSequenceSets the token at the specified position to the given value.- Specified by:
setValuein interfaceMutableTokenSequence- Parameters:
index- the position of the token in the arrayvalue- the value to which to set the token. This value must be of an appropriate type for the array.
-
fillValue
public void fillValue(int start, int length, TokenValued value)Description copied from interface:MutableTokenSequenceSets the tokens in the specified subsequence to the given value.- Specified by:
fillValuein interfaceMutableTokenSequence- Parameters:
start- the starting index of the subsequence in the arraylength- the length of the subsequencevalue- the value to which to set the tokens. This value must be of an appropriate type for the array
-
setValues
public void setValues(int start, TokenSequence values, int offset, int length)Description copied from interface:MutableTokenSequenceSets the tokens in the specified subsequence of the array to the corresponding values from a subsequence of the given source sequence.- Specified by:
setValuesin interfaceMutableTokenSequence- Parameters:
start- the starting index of the subsequence in the arrayvalues- the source sequence. This sequence must be of an appropriate type for the array.offset- the starting index in the source sequence. Corresponding values will be taken relative to this position. That is, the value of the token at positionoffsetinvalueswill be assigned to the token at positionstart, and so on.length- the number of tokens to copy
-
append
public void append(O value)
Description copied from interface:MutableObjectTokenSequenceAppends the specified object to this sequence.- Specified by:
appendin interfaceMutableObjectTokenSequence<O>- Parameters:
value- the value to append. Ifnull, this is equivalent toappendNull().
-
append
public void append(O value, int count)
Description copied from interface:MutableObjectTokenSequenceAppends the specified object to this sequence multiple times.- Specified by:
appendin interfaceMutableObjectTokenSequence<O>- Parameters:
value- the value to append. Ifnull, this is equivalent toappendNull(count).count- the number of copies to append.
-
newValueIterator
public ObjectValuedIterator<O> newValueIterator()
Description copied from interface:TokenSequenceCreates an iterator over the non-null values of this sequence. The iterator will automatically be reset as modifications are made to the sequence.- Specified by:
newValueIteratorin interfaceObjectTokenSequence<O>- Specified by:
newValueIteratorin interfaceScalarTokenSequence- Specified by:
newValueIteratorin interfaceTokenSequence- Returns:
- an newly-created iterator over the non-null values of this sequence.
-
-