Module datarush.library
Package com.pervasive.datarush.sequences.scalar

Interface MutableBinaryTokenSequence

All Superinterfaces:
BinaryTokenSequence, MutableScalarTokenSequence, MutableTokenSequence, ScalarTokenAppendable, ScalarTokenSequence, ScalarTyped, TokenAppendable, TokenSequence, TokenTyped
All Known Implementing Classes:
BinaryTokenList, SparseBinaryTokenList
public interface MutableBinaryTokenSequence extends BinaryTokenSequence, MutableScalarTokenSequence
A MutableTokenSequence containing binary valued data.
See Also:
  • TokenTypeConstant#BINARY

  • Method Details

    • append

      void append(byte[] value)
      Appends the specified binary value to this sequence.

      A copy of the input will be made.

      Parameters:
      value - the value to append. If null, this is equivalent to appendNull().

    • appendReference

      void appendReference(byte[] value)
      Appends the specified binary value to this sequence.

      A reference to the input value will be stored; subsequent modification of the input modifies the stored value.

      Parameters:
      value - the value to append. If null, this is equivalent to appendNull().

    • append

      void append(byte[] value, int count)
      Appends the specified binary value to this sequence multiple times.

      A copy of the input will be made.

      Parameters:
      value - the value to append. If null, this is equivalent to appendNull(count).
      count - the number of copies to append.

    • appendReference

      void appendReference(byte[] value, int count)
      Appends the specified binary value to this sequence multiple times.

      A reference to the input value will be stored; subsequent modification of the input modifies the stored value.

      Parameters:
      value - the value to append. If null, this is equivalent to appendNull(count).
      count - the number of copies to append.

    • set

      void set(int index, byte[] value)
      Sets the token at the specified position to the given binary value.

      The input array is copied to prevent later modification of the value that is set. To avoid this overhead and prevent the data copy, use the setRef(int,byte[]) method instead.

      Parameters:
      index - the position of the token in the array
      value - the binary value to which to set the token. Passing null is equivalent to calling setNull(index).

    • setRef

      void setRef(int index, byte[] value)
      Sets the token at the specified position to the given byte array reference.

      While this call avoids the overhead seen with set(int,byte[]), subsequent modification of the value will modify the token value in the array.

      Parameters:
      index - the position of the token in the array
      value - the binary value to which to set the token. Passing null is equivalent to calling setNull(index).

    • getTokenSetter

      BinarySettable getTokenSetter(int index)
      Description copied from interface: MutableTokenSequence
      Returns a mutator for the given index.
      Specified by:
      getTokenSetter in interface MutableScalarTokenSequence
      Specified by:
      getTokenSetter in interface MutableTokenSequence
      Parameters:
      index - the position
      Returns:
      a mutator for the given index.