Package one.microstream.collections

Class SubListAccessor<E>

java.lang.Object

one.microstream.collections.SubListView<E>

one.microstream.collections.SubListAccessor<E>

All Implemented Interfaces:

Iterable<E>, CapacityCarrying, ExtendedBag<E>, ExtendedCollection<E>, ExtendedList<E>, ExtendedSequence<E>, ReleasingCollection<E>, Sized, Sortable<E>, XGettingBag<E>, XGettingCollection<E>, XGettingList<E>, XGettingSequence<E>, XIndexIterable<E>, XIterable<E>, XJoinable<E>, XOrderingSequence<E>, XReplacingBag<E>, XReplacingCollection<E>, XSettingList<E>, XSettingSequence<E>, XSortableSequence<E>, Copyable

Direct Known Subclasses:

SubList

public class SubListAccessor<E>
extends SubListView<E>
implements XSettingList<E>

Nested Class Summary

Nested classes/interfaces inherited from interface one.microstream.typing.Copyable

Copyable.Static

Nested classes/interfaces inherited from interface one.microstream.collections.interfaces.ExtendedCollection

ExtendedCollection.Creator<E,C extends ExtendedCollection<E>>

Nested classes/interfaces inherited from interface one.microstream.collections.types.XGettingCollection

XGettingCollection.Creator<E>

Nested classes/interfaces inherited from interface one.microstream.collections.types.XGettingList

XGettingList.Factory<E>

Nested classes/interfaces inherited from interface one.microstream.collections.types.XGettingSequence

XGettingSequence.Factory<E>

Nested classes/interfaces inherited from interface one.microstream.collections.types.XIterable

XIterable.Executor<E>

Nested classes/interfaces inherited from interface one.microstream.collections.types.XReplacingBag

XReplacingBag.Factory<E>

Nested classes/interfaces inherited from interface one.microstream.collections.types.XSettingList

XSettingList.Creator<E>

Constructor Summary

Constructors

Constructor	Description
SubListAccessor(XSettingList<E> list, long fromIndex, long toIndex)

Method Summary

Modifier and Type	Method	Description
SubListAccessor<E>	copy()	Creates a true copy of this list which references the same elements in the same order as this list does at the time the method is called.
SubListAccessor<E>	fill(long offset, long length, E element)	Fills all slots from the offset to the offset+length with the given element, regardless of whether or not a slot is null.
one.microstream.collections.SubListAccessor.OldSubListAccessor<E>	old()
SubListAccessor<E>	range(long fromIndex, long toIndex)
long	replace(E element, E replacement)
long	replace(Predicate<? super E> predicate, E substitute)
long	replaceAll(XGettingCollection<? extends E> elements, E replacement)
boolean	replaceOne(E element, E replacement)	Replaces the first element that is equal to the given element with the replacement and then returns true.
boolean	replaceOne(Predicate<? super E> predicate, E substitute)
SubListAccessor<E>	reverse()	Reverses the order of its own elements and returns itself.
boolean	set(long index, E element)
SubListAccessor<E>	set(long offset, E[] src, int srcIndex, int srcLength)
SubListAccessor<E>	set(long offset, XGettingSequence<? extends E> elements, long elementsOffset, long elementsLength)
SubListAccessor<E>	setAll(long offset, E... elements)
void	setFirst(E element)
E	setGet(long index, E element)
void	setLast(E element)
SubListAccessor<E>	shiftBy(long sourceIndex, long distance)	Moves the element from the sourceIndex in the sequence to a higher index position. All other elements are possibly moved to create the empty slot for the shifting element.
SubListAccessor<E>	shiftBy(long sourceIndex, long distance, long length)	Moves multiple elements from the sourceIndex in the sequence to a higher index position. All other elements are possibly moved to create the empty slot for the shifting elements.
SubListAccessor<E>	shiftTo(long sourceIndex, long targetIndex)	Moves the element from the sourceIndex in the sequence to the targetIndex. All other elements are possibly moved to create the empty slot for the shifting element.
SubListAccessor<E>	shiftTo(long sourceIndex, long targetIndex, long length)	Moves multiple elements from the sourceIndex in the sequence to the targetIndex. All other elements are possibly moved to create the empty slot for the shifting element.
SubListAccessor<E>	sort(Comparator<? super E> comparator)	Sorts this collection according to the given comparator and returns itself.
long	substitute(Function<? super E,? extends E> mapper)
long	substitute(Predicate<? super E> predicate, Function<E,E> mapper)
SubListAccessor<E>	swap(long indexA, long indexB)
SubListAccessor<E>	swap(long indexA, long indexB, long length)
SubListAccessor<E>	toReversed()	Creates a new XGettingSequence with the reversed order of elements.
SubListView<E>	view(long fromIndex, long toIndex)	Creates a sub-view of this collection and returns it.

Methods inherited from class one.microstream.collections.SubListView

applies, at, contains, containsAll, containsId, containsSearched, copySelection, copyTo, count, countBy, distinct, distinct, equality, equals, equalsContent, except, filterTo, first, get, getEndIndex, hasVolatileElements, immure, indexBy, indexOf, intersect, isEmpty, isFull, isSorted, iterate, iterateIndexed, iterator, join, last, lastIndexBy, lastIndexOf, listIterator, listIterator, max, maximumCapacity, maxIndex, min, minIndex, nullAllowed, nullContained, peek, poll, remainingCapacity, scan, search, seek, shiftIndices, size, toArray, toArray, union, view

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface one.microstream.collections.interfaces.CapacityCarrying

isFull, maximumCapacity, remainingCapacity

Methods inherited from interface one.microstream.collections.interfaces.ExtendedCollection

nullAllowed

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface one.microstream.collections.interfaces.Sized

isEmpty

Methods inherited from interface one.microstream.collections.types.XGettingCollection

applies, contains, containsAll, containsId, containsSearched, copyTo, count, countBy, distinct, distinct, equality, equals, equals, equalsContent, except, filterTo, hashCode, hasVolatileElements, intersect, intSize, iterator, join, max, min, nullContained, search, seek, size, toArray, toArray, union

Methods inherited from interface one.microstream.collections.types.XGettingList

immure, listIterator, listIterator, view

Methods inherited from interface one.microstream.collections.types.XGettingSequence

at, copySelection, first, get, hasIndex, indexBy, indexOf, isSorted, last, lastIndexBy, lastIndexOf, maxIndex, minIndex, peek, poll, scan

Methods inherited from interface one.microstream.collections.types.XIndexIterable

iterateIndexed

Methods inherited from interface one.microstream.collections.types.XIterable

iterate

Constructor Details

SubListAccessor

public SubListAccessor(XSettingList<E> list, long fromIndex, long toIndex)

Method Details

replace

public long replace(E element, E replacement)

Specified by:

replace in interface XReplacingBag<E>

replaceOne

public boolean replaceOne(E element, E replacement)

Description copied from interface: XReplacingBag

Replaces the first element that is equal to the given element with the replacement and then returns true.

Specified by:

replaceOne in interface XReplacingBag<E>

Parameters:

element - to replace

replacement - for the found element

Returns:

true if element is found, false if not

substitute

public long substitute(Function<? super E,? extends E> mapper)

Specified by:

substitute in interface XReplacingCollection<E>

substitute

public long substitute(Predicate<? super E> predicate, Function<E,E> mapper)

Specified by:

substitute in interface XReplacingBag<E>

range

public SubListAccessor<E> range(long fromIndex, long toIndex)

Specified by:

range in interface XGettingList<E>

Specified by:

range in interface XGettingSequence<E>

Specified by:

range in interface XSettingList<E>

Specified by:

range in interface XSettingSequence<E>

Overrides:

range in class SubListView<E>

fill

public SubListAccessor<E> fill(long offset, long length, E element)

Description copied from interface: XSettingList

Fills all slots from the offset to the offset+length with the given element, regardless of whether or not a slot is null.

Specified by:

fill in interface XSettingList<E>

Parameters:

offset - from the start of the collection (start index)

length - of how many slots should be filled

element - to use for filling of slots

Returns:

this

replaceOne

public boolean replaceOne(Predicate<? super E> predicate, E substitute)

Specified by:

replaceOne in interface XReplacingBag<E>

reverse

public SubListAccessor<E> reverse()

Description copied from interface: XSortableSequence

Reverses the order of its own elements and returns itself.

Unlike the XSortableSequence.toReversed() method, this method does not create a new collection, but changes the order of its own elements.

Specified by:

reverse in interface XOrderingSequence<E>

Specified by:

reverse in interface XSettingList<E>

Specified by:

reverse in interface XSettingSequence<E>

Specified by:

reverse in interface XSortableSequence<E>

Returns:

this

setAll

public SubListAccessor<E> setAll(long offset, E... elements)

Specified by:

setAll in interface XSettingList<E>

Specified by:

setAll in interface XSettingSequence<E>

set

public SubListAccessor<E> set(long offset, E[] src, int srcIndex, int srcLength)

Specified by:

set in interface XSettingList<E>

Specified by:

set in interface XSettingSequence<E>

set

public SubListAccessor<E> set(long offset, XGettingSequence<? extends E> elements, long elementsOffset, long elementsLength)

Specified by:

set in interface XSettingList<E>

Specified by:

set in interface XSettingSequence<E>

setFirst

public void setFirst(E element)

Specified by:

setFirst in interface XSettingSequence<E>

setLast

public void setLast(E element)

Specified by:

setLast in interface XSettingSequence<E>

sort

public SubListAccessor<E> sort(Comparator<? super E> comparator)

Description copied from interface: Sortable

Sorts this collection according to the given comparator and returns itself.

Specified by:

sort in interface Sortable<E>

Specified by:

sort in interface XSettingList<E>

Specified by:

sort in interface XSettingSequence<E>

Specified by:

sort in interface XSortableSequence<E>

Parameters:

comparator - to sort this collection

Returns:

this

shiftTo

public SubListAccessor<E> shiftTo(long sourceIndex, long targetIndex)

Description copied from interface: XOrderingSequence

Moves the element from the sourceIndex in the sequence to the targetIndex.
All other elements are possibly moved to create the empty slot for the shifting element.

Does not expand or shrink the capacity of the sequence.

Throws a IndexExceededException if sourceIndex or targetIndex are greater than the size of the sequence.

Specified by:

shiftTo in interface XOrderingSequence<E>

Specified by:

shiftTo in interface XSortableSequence<E>

Parameters:

sourceIndex - points to the source element; Index of the source element

targetIndex - points to the target element; Index of the target element

Returns:

this

shiftTo

public SubListAccessor<E> shiftTo(long sourceIndex, long targetIndex, long length)

Description copied from interface: XOrderingSequence

Moves multiple elements from the sourceIndex in the sequence to the targetIndex.
All other elements are possibly moved to create the empty slot for the shifting element.

Does not expand or shrink the capacity of the sequence.

Throws a IndexExceededException if sourceIndex or targetIndex exceed the size of the sequence.

Specified by:

shiftTo in interface XOrderingSequence<E>

Specified by:

shiftTo in interface XSortableSequence<E>

Parameters:

sourceIndex - points to the source element; Index of the source element

targetIndex - points to the target element; Index of the target element

length - Amount of moved elements.

Returns:

self

shiftBy

public SubListAccessor<E> shiftBy(long sourceIndex, long distance)

Description copied from interface: XOrderingSequence

Moves the element from the sourceIndex in the sequence to a higher index position.
All other elements are possibly moved to create the empty slot for the shifting element. ("to the right")

Does not expand or shrink the capacity of the sequence.

Throws a IndexExceededException if sourceIndex or targetIndex (sourceIndex+distance) exceed the size of the sequence.

Specified by:

shiftBy in interface XOrderingSequence<E>

Specified by:

shiftBy in interface XSortableSequence<E>

Parameters:

sourceIndex - points to the source element; Index of the source element

distance - of how far the element should be moved. Example: 1 moves the element from position 21 to position 22

Returns:

self

shiftBy

public SubListAccessor<E> shiftBy(long sourceIndex, long distance, long length)

Description copied from interface: XOrderingSequence

Moves multiple elements from the sourceIndex in the sequence to a higher index position.
All other elements are possibly moved to create the empty slot for the shifting elements. ("to the right")

Does not expand or shrink the capacity of the sequence.

Throws a IndexExceededException if sourceIndex or targetIndex (sourceIndex+distance+length) exceed the size of the sequence.

Specified by:

shiftBy in interface XOrderingSequence<E>

Specified by:

shiftBy in interface XSortableSequence<E>

Parameters:

sourceIndex - points to the source element; Index of the source element

distance - of how far the element should be moved. Example: 1 moves the element from position 21 to position 22

length - Amount of moved elements.

Returns:

self

swap

public SubListAccessor<E> swap(long indexA, long indexB)

Specified by:

swap in interface XOrderingSequence<E>

Specified by:

swap in interface XSettingList<E>

Specified by:

swap in interface XSettingSequence<E>

Specified by:

swap in interface XSortableSequence<E>

swap

public SubListAccessor<E> swap(long indexA, long indexB, long length)

Specified by:

swap in interface XOrderingSequence<E>

Specified by:

swap in interface XSettingList<E>

Specified by:

swap in interface XSettingSequence<E>

Specified by:

swap in interface XSortableSequence<E>

replace

public long replace(Predicate<? super E> predicate, E substitute)

Specified by:

replace in interface XReplacingBag<E>

replaceAll

public long replaceAll(XGettingCollection<? extends E> elements, E replacement)

Specified by:

replaceAll in interface XReplacingBag<E>

set

public boolean set(long index, E element)

Specified by:

set in interface XSettingSequence<E>

setGet

public E setGet(long index, E element)

Specified by:

setGet in interface XSettingSequence<E>

view

public SubListView<E> view(long fromIndex, long toIndex)

Description copied from interface: XGettingSequence

Creates a sub-view of this collection and returns it. It is a read-only collection, which wraps around this collection and only allows read methods.
The view is limited to a range from the lowIndex to the highIndex.

A view is different from immutable collection (XGettingCollection.immure()) in the way, that changes in this collection are still affecting the view. The immutable collection on the other hand has no reference to this collection and changes therefore do not affect the immutable collection.

Specified by:

view in interface XGettingList<E>

Specified by:

view in interface XGettingSequence<E>

Overrides:

view in class SubListView<E>

Parameters:

fromIndex - defines lower boundary for the view of the collection.

toIndex - defines higher boundary for the view of the collection.

Returns:

new read-only collection to view a range of elements in this collection

toReversed

public SubListAccessor<E> toReversed()

Description copied from interface: XGettingSequence

Creates a new XGettingSequence with the reversed order of elements.

This method creates a new collection and does not change the existing collection.

Specified by:

toReversed in interface XGettingList<E>

Specified by:

toReversed in interface XGettingSequence<E>

Specified by:

toReversed in interface XSettingList<E>

Specified by:

toReversed in interface XSettingSequence<E>

Specified by:

toReversed in interface XSortableSequence<E>

Overrides:

toReversed in class SubListView<E>

Returns:

New copy of the collection

copy

public SubListAccessor<E> copy()

Description copied from interface: XGettingSequence

Creates a true copy of this list which references the same elements in the same order as this list does at the time the method is called. The elements themselves are NOT copied (no deep copying).
The type of the returned list is the same as of this list if possible (i.e.: a SubList can not meaningful return a true copy that references its elements but still is a SubList)

Specified by:

copy in interface Copyable

Specified by:

copy in interface XGettingBag<E>

Specified by:

copy in interface XGettingCollection<E>

Specified by:

copy in interface XGettingList<E>

Specified by:

copy in interface XGettingSequence<E>

Specified by:

copy in interface XReplacingBag<E>

Specified by:

copy in interface XSettingList<E>

Specified by:

copy in interface XSettingSequence<E>

Specified by:

copy in interface XSortableSequence<E>

Overrides:

copy in class SubListView<E>

Returns:

a copy of this list

old

public one.microstream.collections.SubListAccessor.OldSubListAccessor<E> old()

Specified by:

old in interface XGettingCollection<E>

Specified by:

old in interface XGettingList<E>

Overrides:

old in class SubListView<E>