Package org.infinispan.commons.util
Interface IntSet
-
- All Known Implementing Classes:
ImmutableIntSet
,RangeSet
,SmallIntSet
public interface IntSet extends Set<Integer>
A set that represents primitive ints. This interface describes methods that can be used without having to box an int. This set does not support negative numbers.- Since:
- 9.2
- Author:
- wburns
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description boolean
add(int i)
Adds the given int to this set and returnstrue
if it was set orfalse
if it was already presentboolean
addAll(IntSet set)
Adds all ints from the provided set into this oneboolean
contains(int i)
Whether this set contains the given intboolean
containsAll(IntSet set)
Whether this set contains all ints in the given IntSetdefault void
forEach(IntConsumer action)
Performs the given action for each int of theIntSet
until all elements have been processed or the action throws an exception.default Spliterator.OfInt
intSpliterator()
Creates aSpliterator.OfInt
over the ints in this set.IntStream
intStream()
A stream of ints representing the data in this setPrimitiveIterator.OfInt
iterator()
A primtive iterator that allows iteration over the int values.boolean
remove(int i)
Removes, if present, the int from the set and returns if it was present or notboolean
removeAll(IntSet set)
Removes all ints from this IntSet that are in the provided IntSetdefault boolean
removeIf(IntPredicate filter)
Removes all of the ints of this set that satisfy the given predicate.boolean
retainAll(IntSet c)
Modifies this set to remove all ints that are not present in the provided IntSetvoid
set(int i)
Adds or sets the int without returning whether it was previously setdefault Stream<Integer>
stream()
byte[]
toBitSet()
Returns a byte array that has a bit set for each int in this set where each byte represents 8 numbers.default int[]
toIntArray()
Returns an array containing all of the elements in this set.
-
-
-
Method Detail
-
add
boolean add(int i)
Adds the given int to this set and returnstrue
if it was set orfalse
if it was already present- Parameters:
i
- the int value to add- Returns:
- whether this int was already present
-
set
void set(int i)
Adds or sets the int without returning whether it was previously set- Parameters:
i
- the value to make sure is in the set
-
remove
boolean remove(int i)
Removes, if present, the int from the set and returns if it was present or not- Parameters:
i
- the int to remove- Returns:
- whether the int was present in the set before it was removed
-
contains
boolean contains(int i)
Whether this set contains the given int- Parameters:
i
- the int to check- Returns:
- if the set contains the int
-
addAll
boolean addAll(IntSet set)
Adds all ints from the provided set into this one- Parameters:
set
- the set of ints to add- Returns:
- if this set has a new int in it
-
containsAll
boolean containsAll(IntSet set)
Whether this set contains all ints in the given IntSet- Parameters:
set
- the set to check if all are present- Returns:
- if the set contains all the ints
-
removeAll
boolean removeAll(IntSet set)
Removes all ints from this IntSet that are in the provided IntSet- Parameters:
set
- the ints to remove from this IntSet- Returns:
- if this set removed any ints
-
retainAll
boolean retainAll(IntSet c)
Modifies this set to remove all ints that are not present in the provided IntSet- Parameters:
c
- the ints this set should kep- Returns:
- if this set removed any ints
-
iterator
PrimitiveIterator.OfInt iterator()
A primtive iterator that allows iteration over the int values. This iterator supports removal if the set is modifiable.- Returns:
- the iterator
-
intStream
IntStream intStream()
A stream of ints representing the data in this set- Returns:
- the stream
-
forEach
default void forEach(IntConsumer action)
Performs the given action for each int of theIntSet
until all elements have been processed or the action throws an exception. Unless otherwise specified by the implementing class, actions are performed in the order of iteration (if an iteration order is specified). Exceptions thrown by the action are relayed to the caller.- Parameters:
action
- The action to be performed for each element- Throws:
NullPointerException
- if the specified action is null- Since:
- 9.3
-
intSpliterator
default Spliterator.OfInt intSpliterator()
Creates aSpliterator.OfInt
over the ints in this set.The
Spliterator.OfInt
reportsSpliterator.DISTINCT
. Implementations should document the reporting of additional characteristic values.- Returns:
- a
Spliterator.OfInt
over the ints in this set - Since:
- 9.3
-
removeIf
default boolean removeIf(IntPredicate filter)
Removes all of the ints of this set that satisfy the given predicate. Errors or runtime exceptions thrown during iteration or by the predicate are relayed to the caller.- Parameters:
filter
- a predicate which returnstrue
for ints to be removed- Returns:
true
if any ints were removed- Throws:
NullPointerException
- if the specified filter is nullUnsupportedOperationException
- if elements cannot be removed from this collection. Implementations may throw this exception if a matching element cannot be removed or if, in general, removal is not supported.- Since:
- 9.3
-
toIntArray
default int[] toIntArray()
Returns an array containing all of the elements in this set. If this set makes any guarantees as to what order its elements are returned by its iterator, this method must return the elements in the same order.- Returns:
- this int set as an array
- Since:
- 9.3
-
toBitSet
byte[] toBitSet()
Returns a byte array that has a bit set for each int in this set where each byte represents 8 numbers. That is if the ints 2, 5 and 9 are set this will return a byte array consisting of 2 bytes in little-endian representation of those values.Depending upon the implementation this array may or may not have trailing bytes and may be condensed to save space.
- Returns:
- a byte array containing a little-endian representation of all the ints of this int set as bits
- Since:
- 12.0
-
-