it.unimi.dsi.fastutil.longs

Class LongSortedSets.Singleton

java.lang.Object

java.util.AbstractCollection<Long>

it.unimi.dsi.fastutil.longs.AbstractLongCollection

it.unimi.dsi.fastutil.longs.AbstractLongSet

it.unimi.dsi.fastutil.longs.LongSets.Singleton

it.unimi.dsi.fastutil.longs.LongSortedSets.Singleton

All Implemented Interfaces:

LongBidirectionalIterable, LongCollection, LongIterable, LongSet, LongSortedSet, Serializable, Cloneable, Iterable<Long>, Collection<Long>, Set<Long>, SortedSet<Long>

Enclosing class:

LongSortedSets

public static class LongSortedSets.Singleton
extends LongSets.Singleton
implements LongSortedSet, Serializable, Cloneable

A class representing a singleton sorted set.

This class may be useful to implement your own in case you subclass a type-specific sorted set.

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
LongComparator	comparator() Returns the comparator used to order the elements in this set, or null if this set uses the natural ordering of its elements.
Long	first() Deprecated. Please use the corresponding type-specific method instead.
long	firstLong() Returns the first (lowest) element currently in this set.
LongSortedSet	headSet(long to) Returns a view of the portion of this sorted set whose elements are strictly less than toElement.
LongSortedSet	headSet(Long to) Deprecated. Please use the corresponding type-specific method instead.
LongBidirectionalIterator	iterator(long from) Returns a type-specific BidirectionalIterator on the elements in this set, starting from a given element of the domain (optional operation).
Long	last() Deprecated. Please use the corresponding type-specific method instead.
long	lastLong() Returns the last (highest) element currently in this set.
LongSortedSet	subSet(long from, long to) Returns a view of the portion of this sorted set whose elements range from fromElement, inclusive, to toElement, exclusive.
LongSortedSet	subSet(Long from, Long to) Deprecated. Please use the corresponding type-specific method instead.
LongSortedSet	tailSet(long from) Returns a view of the portion of this sorted set whose elements are greater than or equal to fromElement.
LongSortedSet	tailSet(Long from) Deprecated. Please use the corresponding type-specific method instead.

Methods inherited from class it.unimi.dsi.fastutil.longs.LongSets.Singleton

addAll, addAll, clone, contains, iterator, remove, removeAll, removeAll, retainAll, retainAll, size

Methods inherited from class it.unimi.dsi.fastutil.longs.AbstractLongSet

equals, hashCode, rem

Methods inherited from class it.unimi.dsi.fastutil.longs.AbstractLongCollection

add, add, contains, containsAll, remove, toArray, toLongArray, toLongArray, toString

Methods inherited from class java.util.AbstractCollection

clear, containsAll, isEmpty, toArray, toArray

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface it.unimi.dsi.fastutil.longs.LongSortedSet

iterator

Methods inherited from interface it.unimi.dsi.fastutil.longs.LongSet

add, contains, rem, remove, remove

Methods inherited from interface it.unimi.dsi.fastutil.longs.LongCollection

add, addAll, contains, containsAll, removeAll, retainAll, toArray, toLongArray, toLongArray

Methods inherited from interface it.unimi.dsi.fastutil.longs.LongIterable

forEach, forEach

Methods inherited from interface java.util.SortedSet

spliterator

Methods inherited from interface java.util.Set

addAll, clear, containsAll, equals, hashCode, isEmpty, removeAll, retainAll, size, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Method Detail

iterator

public LongBidirectionalIterator iterator(long from)

Description copied from interface: LongSortedSet

Returns a type-specific BidirectionalIterator on the elements in this set, starting from a given element of the domain (optional operation).

This method returns a type-specific bidirectional iterator with given starting point. The starting point is any element comparable to the elements of this set (even if it does not actually belong to the set). The next element of the returned iterator is the least element of the set that is greater than the starting point (if there are no elements greater than the starting point, hasNext() will return false). The previous element of the returned iterator is the greatest element of the set that is smaller than or equal to the starting point (if there are no elements smaller than or equal to the starting point, hasPrevious() will return false).

Note that passing the last element of the set as starting point and calling previous() you can traverse the entire set in reverse order.

Specified by:

iterator in interface LongSortedSet

Parameters:

from - an element to start from.

Returns:

a bidirectional iterator on the element in this set, starting at the given element.

comparator

public LongComparator comparator()

Description copied from interface: LongSortedSet

Returns the comparator used to order the elements in this set, or null if this set uses the natural ordering of its elements.

Note that this specification strengthens the one given in SortedSet.comparator().

Specified by:

comparator in interface LongSortedSet

Specified by:

comparator in interface SortedSet<Long>

Returns:

the comparator used to order the elements in this set, or null if this set uses the natural ordering of its elements

subSet

public LongSortedSet subSet(long from,
                            long to)

Description copied from interface: LongSortedSet

Returns a view of the portion of this sorted set whose elements range from fromElement, inclusive, to toElement, exclusive.

Note that this specification strengthens the one given in SortedSet.subSet(Object,Object).

Specified by:

subSet in interface LongSortedSet

See Also:

SortedSet.subSet(Object,Object)

headSet

public LongSortedSet headSet(long to)

Description copied from interface: LongSortedSet

Returns a view of the portion of this sorted set whose elements are strictly less than toElement.

Note that this specification strengthens the one given in SortedSet.headSet(Object).

Specified by:

headSet in interface LongSortedSet

See Also:

SortedSet.headSet(Object)

tailSet

public LongSortedSet tailSet(long from)

Description copied from interface: LongSortedSet

Returns a view of the portion of this sorted set whose elements are greater than or equal to fromElement.

Note that this specification strengthens the one given in SortedSet.headSet(Object).

Specified by:

tailSet in interface LongSortedSet

See Also:

SortedSet.tailSet(Object)

firstLong

public long firstLong()

Description copied from interface: LongSortedSet

Returns the first (lowest) element currently in this set.

Specified by:

firstLong in interface LongSortedSet

See Also:

SortedSet.first()

lastLong

public long lastLong()

Description copied from interface: LongSortedSet

Returns the last (highest) element currently in this set.

Specified by:

lastLong in interface LongSortedSet

See Also:

SortedSet.last()

subSet

@Deprecated
public LongSortedSet subSet(Long from,
                                        Long to)

Deprecated. Please use the corresponding type-specific method instead.

Returns a view of the portion of this set whose elements range from fromElement, inclusive, to toElement, exclusive. (If fromElement and toElement are equal, the returned set is empty.) The returned set is backed by this set, so changes in the returned set are reflected in this set, and vice-versa. The returned set supports all optional set operations that this set supports.

The returned set will throw an IllegalArgumentException on an attempt to insert an element outside its range.

Specified by:

subSet in interface LongSortedSet

Specified by:

subSet in interface SortedSet<Long>

Parameters:

from - low endpoint (inclusive) of the returned set

to - high endpoint (exclusive) of the returned set

Returns:

a view of the portion of this set whose elements range from fromElement, inclusive, to toElement, exclusive

headSet

@Deprecated
public LongSortedSet headSet(Long to)

Deprecated. Please use the corresponding type-specific method instead.

Returns a view of the portion of this set whose elements are strictly less than toElement. The returned set is backed by this set, so changes in the returned set are reflected in this set, and vice-versa. The returned set supports all optional set operations that this set supports.

The returned set will throw an IllegalArgumentException on an attempt to insert an element outside its range.

Specified by:

headSet in interface LongSortedSet

Specified by:

headSet in interface SortedSet<Long>

Parameters:

to - high endpoint (exclusive) of the returned set

Returns:

a view of the portion of this set whose elements are strictly less than toElement

tailSet

@Deprecated
public LongSortedSet tailSet(Long from)

Deprecated. Please use the corresponding type-specific method instead.

Returns a view of the portion of this set whose elements are greater than or equal to fromElement. The returned set is backed by this set, so changes in the returned set are reflected in this set, and vice-versa. The returned set supports all optional set operations that this set supports.

The returned set will throw an IllegalArgumentException on an attempt to insert an element outside its range.

Specified by:

tailSet in interface LongSortedSet

Specified by:

tailSet in interface SortedSet<Long>

Parameters:

from - low endpoint (inclusive) of the returned set

Returns:

a view of the portion of this set whose elements are greater than or equal to fromElement

first

@Deprecated
public Long first()

Deprecated. Please use the corresponding type-specific method instead.

Returns the first (lowest) element currently in this set.

Specified by:

first in interface LongSortedSet

Specified by:

first in interface SortedSet<Long>

Returns:

the first (lowest) element currently in this set

last

@Deprecated
public Long last()

Deprecated. Please use the corresponding type-specific method instead.

Returns the last (highest) element currently in this set.

Specified by:

last in interface LongSortedSet

Specified by:

last in interface SortedSet<Long>

Returns:

the last (highest) element currently in this set