- java.lang.Object
-
- com.pervasive.datarush.sequences.scalar.AbstractScalarTokenSequence
-
- com.pervasive.datarush.sequences.scalar.StringTokenList
-
- All Implemented Interfaces:
MutableTokenSequence,MutableScalarTokenSequence,MutableStringTokenSequence,ScalarTokenAppendable,ScalarTokenSequence,StringTokenSequence,TokenAppendable,TokenSequence,ScalarTyped,TokenTyped
public final class StringTokenList extends AbstractScalarTokenSequence
Primary implementation ofMutableStringTokenSequence.- See Also:
TokenTypeConstant#STRING
-
-
Constructor Summary
Constructors Constructor Description StringTokenList(int capacity)Create a new array of string tokens with the specified number of elements.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidappend(String value)Appends the specified string to this sequence.voidappend(String value, int count)Appends the specified string to this sequence multiple times.intcompareElement(int index, String value)protected voidexpandValueBuffers(int capacity)voidfillString(int start, int length, String value)Sets the tokens in the specified subsequence to the given string value.voidfillValue(int startIndex, int count, TokenValued value)Sets the tokens in the specified subsequence to the given value.StringgetString(int i)Gets the value of the specified element as a string.StringValuedgetToken(int index)Gets the value at the specified position.StringSettablegetTokenSetter(int index)Returns a mutator for the given index.ScalarTokenTypegetType()Gets the data type of the tokens in the sequence.voidgetValues(int index, String[] 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.StringValuedIteratornewValueIterator()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.voidsetString(int index, String value)Sets the token at the specified position to the given string value.voidsetValue(int position, TokenValued value)Sets the token at the specified position to the given value.voidsetValues(int startIndex, 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
-
-
-
-
Method Detail
-
getString
public String getString(int i)
Description copied from interface:StringTokenSequenceGets the value of the specified element as a string.- Parameters:
i- the position of the token in the sequence- Returns:
- the value of the token. If the token is null valued, the empty string is returned.
-
getValues
public void getValues(int index, String[] values, boolean[] nullFlags, int offset, int length)Description copied from interface:StringTokenSequenceGets the values and null indicators for a range of tokens.- 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.- 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.- 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.- 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.- 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.- Parameters:
index- the index of the token- Returns:
trueif the element is zero,falseotherwise
-
setString
public void setString(int index, String value)Sets the token at the specified position to the given string value.- Parameters:
index- the position of the token in the arrayvalue- the string value to which to set the token. Passingnullis equivalent to callingsetNull(index).
-
fillString
public void fillString(int start, int length, String value)Sets the tokens in the specified subsequence to the given string value.- Parameters:
start- the starting index of the subsequence in the arraylength- the length of the subsequencevalue- the string value to which to set the tokens. Passingnullis equivalent to callingsetNull(start, length).
-
setValue
public void setValue(int position, TokenValued value)Description copied from interface:MutableTokenSequenceSets the token at the specified position to the given value.- Parameters:
position- 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 startIndex, int count, TokenValued value)Description copied from interface:MutableTokenSequenceSets the tokens in the specified subsequence to the given value.- Parameters:
startIndex- the starting index of the subsequence in the arraycount- 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 startIndex, 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.- Parameters:
startIndex- 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
-
expandValueBuffers
protected void expandValueBuffers(int capacity)
-
append
public void append(String value)
Description copied from interface:MutableStringTokenSequenceAppends the specified string to this sequence.- Parameters:
value- the value to append. Ifnull, this is equivalent toappendNull().
-
append
public void append(String value, int count)
Description copied from interface:MutableStringTokenSequenceAppends the specified string to this sequence multiple times.- Parameters:
value- the value to append. Ifnull, this is equivalent toappendNull(count).count- the number of copies to append.
-
newValueIterator
public StringValuedIterator 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.- Returns:
- an newly-created iterator over the non-null values of this sequence.
-
getType
public final ScalarTokenType getType()
Description copied from interface:ScalarTokenSequenceGets the data type of the tokens in the sequence.- Specified by:
getTypein interfaceScalarTokenSequence- Specified by:
getTypein interfaceScalarTyped- Specified by:
getTypein interfaceTokenTyped- Returns:
- the token data type
-
compareElement
public final int compareElement(int index, String value)
-
getToken
public final StringValued getToken(int index)
Description copied from interface:TokenSequenceGets the value at the specified position.- Specified by:
getTokenin interfaceScalarTokenSequence- Specified by:
getTokenin interfaceStringTokenSequence- Specified by:
getTokenin interfaceTokenSequence- Parameters:
index- the index of the token- Returns:
- the value
-
getTokenSetter
public final StringSettable getTokenSetter(int index)
Description copied from interface:MutableTokenSequenceReturns a mutator for the given index.- Specified by:
getTokenSetterin interfaceMutableScalarTokenSequence- Specified by:
getTokenSetterin interfaceMutableStringTokenSequence- Specified by:
getTokenSetterin interfaceMutableTokenSequence- Parameters:
index- the position- Returns:
- a mutator for the given index.
-
-