public interface CharSet extends CharCollection, java.util.Set<java.lang.Character>
Set
; provides some additional methods that use polymorphism to avoid (un)boxing.
Additionally, this interface strengthens (again) iterator()
.
Set
Modifier and Type | Method and Description |
---|---|
default boolean |
add(java.lang.Character o)
Deprecated.
Please use the corresponding type-specific method instead.
|
default boolean |
contains(java.lang.Object o)
Deprecated.
Please use the corresponding type-specific method instead.
|
CharIterator |
iterator()
Returns a type-specific iterator on the elements of this set.
|
static CharSet |
of()
Returns an immutable empty set.
|
static CharSet |
of(char... a)
Returns an immutable list with the elements given.
|
static CharSet |
of(char e)
Returns an immutable set with the element given.
|
static CharSet |
of(char e0,
char e1)
Returns an immutable set with the elements given.
|
static CharSet |
of(char e0,
char e1,
char e2)
Returns an immutable set with the elements given.
|
default boolean |
rem(char k)
Deprecated.
Please use
remove() instead. |
boolean |
remove(char k)
Removes an element from this set.
|
default boolean |
remove(java.lang.Object o)
Deprecated.
Please use the corresponding type-specific method instead.
|
default CharSpliterator |
spliterator()
Returns a type-specific spliterator on the elements of this set.
|
add, addAll, contains, containsAll, intIterator, intParallelStream, intSpliterator, intStream, parallelStream, removeAll, removeIf, removeIf, removeIf, retainAll, stream, toArray, toCharArray, toCharArray
forEach, forEach, forEach
CharIterator iterator()
iterator
in interface CharCollection
iterator
in interface CharIterable
iterator
in interface java.util.Collection<java.lang.Character>
iterator
in interface java.lang.Iterable<java.lang.Character>
iterator
in interface java.util.Set<java.lang.Character>
Iterable.iterator()
Iterable.iterator()
,
which was already strengthened in the corresponding type-specific class,
but was weakened by the fact that this interface extends Set
.
Also, this is generally the only iterator
method subclasses should override.
default CharSpliterator spliterator()
Set spliterators must report at least Spliterator.DISTINCT
.
See Set.spliterator()
for more documentation on the requirements
of the returned spliterator.
spliterator
in interface CharCollection
spliterator
in interface CharIterable
spliterator
in interface java.util.Collection<java.lang.Character>
spliterator
in interface java.lang.Iterable<java.lang.Character>
spliterator
in interface java.util.Set<java.lang.Character>
Collection.spliterator()
, which was already
strengthened in the corresponding type-specific class,
but was weakened by the fact that this interface extends Set
.
Also, this is generally the only spliterator
method subclasses should override.
Spliterator
for documentation on what binding policies mean)
that wraps this instance's type specific iterator()
.
Additionally, it reports Spliterator.SIZED
and Spliterator.DISTINCT
.
Iterator
is an inherently linear API, the returned spliterator will yield limited performance gains
when run in parallel contexts, as the returned spliterator's
trySplit()
will have linear runtime.boolean remove(char k)
Collection.remove(Object)
rem()
.
This unfortunate situation is caused by the clash
with the similarly named index-based method in the List
interface.@Deprecated default boolean remove(java.lang.Object o)
remove
in interface CharCollection
remove
in interface java.util.Collection<java.lang.Character>
remove
in interface java.util.Set<java.lang.Character>
@Deprecated default boolean add(java.lang.Character o)
add
in interface CharCollection
add
in interface java.util.Collection<java.lang.Character>
add
in interface java.util.Set<java.lang.Character>
@Deprecated default boolean contains(java.lang.Object o)
contains
in interface CharCollection
contains
in interface java.util.Collection<java.lang.Character>
contains
in interface java.util.Set<java.lang.Character>
@Deprecated default boolean rem(char k)
remove()
instead.This method is inherited from the type-specific collection this
type-specific set is based on, but it should not used as
this interface reinstates remove()
as removal method.
rem
in interface CharCollection
Collection.remove(Object)
static CharSet of()
static CharSet of(char e)
e
- an element.e
.static CharSet of(char e0, char e1)
e0
- the first element.e1
- the second element.e0
and e1
.java.lang.IllegalArgumentException
- if there were duplicate entries.static CharSet of(char e0, char e1, char e2)
e0
- the first element.e1
- the second element.e2
- the third element.e0
, e1
, and e2
.java.lang.IllegalArgumentException
- if there were duplicate entries.static CharSet of(char... a)
a
- the list of elements that will be in the final set.a
.java.lang.IllegalArgumentException
- if there are any duplicate entries.