Class ObjectTokenList<O>

    • Constructor Detail

      • ObjectTokenList

        public ObjectTokenList​(ObjectTokenType<O> type,
                               int capacity)
        Create an empty array
        Parameters:
        type - the type of objects in the list
        capacity - the initial capacity.
    • Method Detail

      • getObject

        public O getObject​(int i)
        Description copied from interface: ObjectTokenSequence
        Gets 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:
        getObject in interface ObjectTokenSequence<O>
        Parameters:
        i - the position of the token in the sequence
        Returns:
        the value of the token. If the token is null valued, null is returned.
      • getValues

        public void getValues​(int index,
                              O[] values,
                              boolean[] nullFlags,
                              int offset,
                              int length)
        Description copied from interface: ObjectTokenSequence
        Gets 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:
        getValues in interface ObjectTokenSequence<O>
        Parameters:
        index - the starting index of the range
        values - an array into which to place element values
        nullFlags - an array into which to place null indicator values
        offset - the starting offset into the target arrays. That is, elements[offset] and nulls[offset] will get the value and null indicator respectively of the token at position start, and so on.
        length - number of tokens to get
      • setNull

        public void setNull​(int index)
        Description copied from interface: MutableTokenSequence
        Sets the token at the specified position to be null valued.
        Specified by:
        setNull in interface MutableTokenSequence
        Parameters:
        index - the position of the token in the array
      • setNull

        public void setNull​(int start,
                            int length)
        Description copied from interface: MutableTokenSequence
        Sets the tokens in the specified subsequence to be null valued.
        Specified by:
        setNull in interface MutableTokenSequence
        Parameters:
        start - the starting index of the subsequence in the array
        length - the length of the subsequence
      • setZero

        public void setZero​(int index)
        Description copied from interface: MutableTokenSequence
        Sets the token at the specified position to be zero valued.
        Specified by:
        setZero in interface MutableTokenSequence
        Parameters:
        index - the position of the token in the array
      • setZero

        public void setZero​(int start,
                            int length)
        Description copied from interface: MutableTokenSequence
        Sets the tokens in the specified subsequence to be zero valued.
        Specified by:
        setZero in interface MutableTokenSequence
        Parameters:
        start - the starting index of the subsequence in the array
        length - the length of the subsequence
      • isZero

        public boolean isZero​(int index)
        Description copied from interface: ScalarTokenSequence
        Indicates whether the specified token has a zero value.
        Specified by:
        isZero in interface ScalarTokenSequence
        Parameters:
        index - the index of the token
        Returns:
        true if the element is zero, false otherwise
      • 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:
        setObject in interface MutableObjectTokenSequence<O>
        Parameters:
        index - the position of the token in the array
        value - the object value to which to set the token. Passing null is equivalent to calling setNull(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 array
        length - the length of the subsequence
        value - the numeric value to which to set the tokens. Passing null is equivalent to calling setNull(start, length).
      • setValue

        public void setValue​(int index,
                             TokenValued value)
        Description copied from interface: MutableTokenSequence
        Sets the token at the specified position to the given value.
        Specified by:
        setValue in interface MutableTokenSequence
        Parameters:
        index - the position of the token in the array
        value - 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: MutableTokenSequence
        Sets the tokens in the specified subsequence to the given value.
        Specified by:
        fillValue in interface MutableTokenSequence
        Parameters:
        start - the starting index of the subsequence in the array
        length - the length of the subsequence
        value - 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: MutableTokenSequence
        Sets the tokens in the specified subsequence of the array to the corresponding values from a subsequence of the given source sequence.
        Specified by:
        setValues in interface MutableTokenSequence
        Parameters:
        start - the starting index of the subsequence in the array
        values - 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 position offset in values will be assigned to the token at position start, and so on.
        length - the number of tokens to copy
      • append

        public void append​(O value)
        Description copied from interface: MutableObjectTokenSequence
        Appends the specified object to this sequence.
        Specified by:
        append in interface MutableObjectTokenSequence<O>
        Parameters:
        value - the value to append. If null, this is equivalent to appendNull().
      • append

        public void append​(O value,
                           int count)
        Description copied from interface: MutableObjectTokenSequence
        Appends the specified object to this sequence multiple times.
        Specified by:
        append in interface MutableObjectTokenSequence<O>
        Parameters:
        value - the value to append. If null, this is equivalent to appendNull(count).
        count - the number of copies to append.