Set<E> 类 抽象 接口

一个集合，其中每个对象只能出现一次。

也就是说，对于元素类型的每个对象，该对象要么被认为在集合中，要么被认为不在集合中。

Set 实现可能认为某些元素不可区分。这些元素在集合的任何操作中被视为相同。

默认的 Set 实现，LinkedHashSet，如果对象在 Object.== 和 Object.hashCode 方面相等，则认为它们不可区分。

遍历集合的元素可能是无序的，也可能以某种方式有序。例如

  • HashSet 是无序的，这意味着其迭代顺序是不确定的，
  • LinkedHashSet 按其元素的插入顺序迭代，
  • 以及像 SplayTreeSet 这样的有序集合按排序顺序迭代元素。

通常不允许在执行集合操作时修改集合（添加或删除元素），例如在调用 forEach 或 containsAll 期间。也不允许在迭代集合本身或由集合支持的任何 Iterable 时修改集合，例如由 where 和 map 等方法返回的集合。

通常不允许在元素在集合中时修改元素的相等性（以及因此它们的哈希码）。某些专门的子类型可能更宽松，在这种情况下，它们应记录此行为。

实现类型
实现者
可用扩展

构造函数

Set()
创建一个空的 Set。
工厂
Set.from(Iterable elements)
创建包含所有 elements 的 Set。
工厂
Set.identity()
创建一个空的标识 Set。
工厂
Set.of(Iterable<E> elements)
从 elements 创建一个 Set。
工厂
Set.unmodifiable(Iterable<E> elements)
从 elements 创建一个不可修改的 Set。
工厂

属性

first → E
第一个元素。
无setter继承
hashCode → int
此对象的哈希码。
无setter继承
isEmpty → bool
此集合是否没有元素。
无setter继承
isNotEmpty → bool
此集合至少有一个元素。
无setter继承
iterator → Iterator<E>
迭代此集合元素的迭代器。
无setter重写
last → E
最后一个元素。
无setter继承
length → int
此可迭代中的元素数量。
无setter继承
runtimeType → Type
对象运行时类型的表示。
无setter继承
single → E
检查此可迭代是否只有一个元素，并返回该元素。
无setter继承

方法

add(E value) → bool
将 value 添加到集合中。
addAll(Iterable<E> elements) → void
将所有 elements 添加到此集合中。
any(bool test(E element)) → bool
检查此可迭代中的任何元素是否满足 test。
继承
cast<R>() → Set<R>
提供此集合作为 R 实例集合的视图。
重写
clear() → void
从集合中删除所有元素。
contains(Object? value) → bool
value 是否在集合中。
重写
containsAll(Iterable<Object?> other) → bool
此集合是否包含 other 的所有元素。
difference(Set<Object?> other) → Set<E>
创建一个新集合，其中包含此集合中不在 other 中的元素。
elementAt(int index) → E
返回第 index 个元素。
继承
every(bool test(E element)) → bool
检查此可迭代对象中的每个元素是否满足 test。
继承
expand<T>(Iterable<T> toElements(E element)) → Iterable<T>
将此 Iterable 的每个元素扩展为零个或多个元素。
继承
firstWhere(bool test(E element), {E orElse()?}) → E
返回满足给定谓词 test 的第一个元素。
继承
fold<T>(T initialValue, T combine(T previousValue, E element)) → T
通过迭代将每个集合元素与现有值结合来减少一个集合到一个单一值
继承
followedBy(Iterable<E> other) → Iterable<E>
创建此可迭代对象和 other 的懒连接。
继承
forEach(void action(E element)) → void
按迭代顺序对每个元素调用 action。
继承
intersection(Set<Object?> other) → Set<E>
创建一个新集合，该集合是本集合与other的交集。
join([String separator = ""]) → String
将每个元素转换为并连接这些字符串。
继承
lastWhere(bool test(E element), {E orElse()?}) → E
满足给定谓词test的最后一个元素。
继承
lookup(Object? object) → E?
如果集合中存在与object相等的对象，则返回它。
map<T>(T toElement(E e)) → Iterable<T>
通过toElement修改的当前可迭代元素的集合。
继承
noSuchMethod(Invocation invocation) → dynamic
当访问不存在的方法或属性时调用。
继承
reduce(E combine(E value, E element)) → E
通过迭代使用提供的函数结合集合的元素来将集合简化为单个值。
继承
remove(Object? value) → bool
从集合中移除value。
removeAll(Iterable<Object?> elements) → void
从本集合中移除elements中的每个元素。
removeWhere(bool test(E element)) → void
移除满足test的所有元素。
retainAll(Iterable<Object?> elements) → void
从本集合中移除所有不在 elements 中的元素。
retainWhere(bool test(E element)) → void
移除所有不满足 test 的元素。
singleWhere(bool test(E element), {E orElse()?}) → E
满足 test 的单个元素。
继承
skip(int count) → Iterable<E>
创建一个提供除前 count 个元素之外所有元素的 Iterable。
继承
skipWhile(bool test(E value)) → Iterable<E>
创建一个在满足 test 条件时跳过前导元素的 Iterable。
继承
take(int count) → Iterable<E>
创建一个包含此可迭代对象前 count 个元素的惰性可迭代对象。
继承
takeWhile(bool test(E value)) → Iterable<E>
创建一个包含满足 test 的前导元素的惰性可迭代对象。
继承
toList({bool growable = true}) → List<E>
创建一个包含此 Iterable 元素的 List。
继承
toSet() → Set<E>
创建一个具有与本 Set 相同元素和行为 Set。
重写
toString() → String
此对象的一个字符串表示形式。
继承
并集(Set<E> other) → Set<E>
创建一个新的集合，该集合包含此集合和 other 中的所有元素。
where(bool test(E element)) → Iterable<E>
创建一个新的惰性 Iterable，包含所有满足谓词 test 的元素。
继承
whereType<T>() → Iterable<T>
创建一个新的惰性 Iterable，包含所有类型为 T 的元素。
继承

运算符

operator ==(Object other) → bool
相等运算符。
继承

静态方法

castFrom<S, T>(Set<S> source, {Set<R> newSet<R>()?}) → Set<T>
将 source 转换为 Set<T>。
重写