Set абстрактный класс

Коллекция объектов, в которой каждый объект может встречаться только один раз.

То есть для каждого объекта типа элемента объект либо считается присутствующим в множестве, либо отсутствующим в множестве.

Реализации множеств могут считать некоторые элементы неразличимыми. Эти элементы обрабатываются как одинаковые для любой операции над множеством.

По умолчанию реализация Set, LinkedHashSet, считает объекты неразличимыми, если они равны в отношении оператора Object.==.

Итерирование по элементам множества может быть либо неупорядоченным, либо упорядоченным каким-либо образом. Примеры:

HashSet неупорядочен, что означает, что порядок его итерации не определен,
LinkedHashSet итерирует в порядке вставки элементов, и
упорядоченное множество, такое как SplayTreeSet, итерирует элементы в отсортированном порядке.

В общем случае запрещается изменять множество (добавлять или удалять элементы) во время выполнения операции над множеством, например, во время вызова forEach или containsAll. Также запрещается изменять множество во время итерирования самого множества или любого Iterable, который поддерживается множеством, например, возвращаемых методами, такими как where и map.

Наследование

Object
Iterable<T>
EfficientLengthIterable<E>
Set

Реализует

Конструкторы

Set() factory: Создает пустое Set.
Set.from(Iterable elements) factory: Создает Set, содержащий все elements.
Set.identity() factory: Создает пустое идентичное Set.

Свойства

iterator → Iterator<E> только для чтения: Предоставляет итератор, который перебирает элементы этого множества.
first → E только для чтения, унаследованно: Возвращает первый элемент.
hashCode → int только для чтения, унаследованно: Хеш-код этого объекта.
isEmpty → bool только для чтения, унаследованно: Возвращает true , если в этой коллекции нет элементов.
isNotEmpty → bool только для чтения, унаследованно: Возвращает true, если в этой коллекции есть хотя бы один элемент.
last → E только для чтения, унаследованно: Возвращает последний элемент.
length → int только для чтения, унаследованно: Возвращает количество элементов в this.
runtimeType → Type только для чтения, унаследованно: Представление runtime-типа объекта.
single → E только для чтения, унаследованно: Проверяет, что в этом итерируемом объекте есть только один элемент, и возвращает этот элемент.

Операторы

operator ==(other) → bool унаследованно: Оператор равенства.

Методы

add(E значение) → bool: Добавляет value в множество.
addAll(Iterable<E> элементы) → void: Добавляет все elements в это множество.
clear() → void: Удаляет все элементы из множества.
contains(Объект значение) → bool: Возвращает true, если value содержится в множестве.
containsAll(Iterable<Объект> другое) → bool: Возвращает true, если это множество содержит все элементы из other.
difference(Множество<Объект> другое) → Множество<E>: Возвращает новое множество, содержащее элементы этого множества, которые не содержатся в other.
intersection(Множество<Объект> другое) → Множество<E>: Возвращает новое множество, которое является пересечением этого множества и other.
lookup(Объект объект) → E: Если в множестве есть объект, равный object, возвращает его.
remove(Объект значение) → bool: Удаляет value из множества. Возвращает true, если value было в множестве. Иначе возвращает false. Метод не оказывает никакого влияния, если value значение не было в множестве.
removeAll(Iterable<Объект> элементы) → void: Удаляет каждый элемент из elements из этого множества.
removeWhere(bool test(E элемент)) → void: Удаляет все элементы из этого множества, которые удовлетворяют test.
retainAll(Iterable<Объект> элементы) → void: Удаляет все элементы из этого множества, которые не являются элементами в elements.
retainWhere(bool test(E элемент)) → void: Удаляет все элементы из этого множества, которые не удовлетворяют test.
toSet() → Множество<E>: Создаёт Set, содержащее те же элементы, что и этот перечисляемый объект.
union(Множество<E> другое) → Множество<E>: Возвращает новое множество, которое содержит все элементы этого множества и other.
any(bool f(E элемент)) → bool inherited: Проверяет, удовлетворяет ли какой-либо элемент этого перечисляемого объекта test.
elementAt(int индекс) → E inherited: Возвращает index-й элемент.
every(bool f(E элемент)) → bool inherited: Проверяет, удовлетворяет ли каждый элемент этого перечисляемого объекта test.
expand<T>(Iterable<T> f(E элемент)) → Iterable<T> inherited: Расширяет каждый элемент этого Перечисляемого объекта на ноль или более элементов.
firstWhere(bool test(E элемент), { E илиElse() }) → E inherited: Возвращает первый элемент, удовлетворяющий заданному предикату test.
fold<T>(T начальноеЗначение, T combine(T предыдущееЗначение, E элемент)) → T inherited: Сокращает коллекцию до единственного значения, поэтапно комбинируя каждый элемент коллекции с существующим значением
forEach(void f(E элемент)) → void inherited: Применяет функцию f к каждому элементу этого объекта в порядке итерации.
join([Строка разделитель = "" ]) → Строка inherited: Преобразует каждый элемент в Строку и конкатенирует строки.
lastWhere(bool test(E элемент), { E илиElse() }) → E inherited: Возвращает последний элемент, удовлетворяющий заданному предикату test.
map<T>(T f(E e)) → Iterable<T> inherited: Возвращает новый ленивый Перечисляемый объект с элементами, созданными путём вызова f для каждого элемента этого Iterable в порядке итерации.
noSuchMethod(Вызов вызов) → dynamic inherited: Вызывается при попытке доступа к несуществующему методу или свойству.
reduce(E combine(E значение, E элемент)) → E inherited: Сокращает коллекцию до единственного значения, поэтапно комбинируя элементы коллекции с помощью предоставленной функции.
singleWhere(bool test(E элемент)) → E inherited: Возвращает единственный элемент, удовлетворяющий test.
skip(int количество) → Iterable<E> inherited: Возвращает Перечисляемый объект, содержащий все элементы, кроме первых count элементов.
skipWhile(bool test(E значение)) → Iterable<E> inherited: Возвращает Перечисляемый объект, пропуская начальные элементы, пока удовлетворяется условие test.
take(int количество) → Iterable<E> inherited: Возвращает ленивый перечисляемый объект первых count элементов этого перечисляемого объекта.
takeWhile(bool test(E значение)) → Iterable<E> inherited: Возвращает ленивый перечисляемый объект начальных элементов, удовлетворяющих test.
toList({bool growable: true }) → Список<E> inherited: Создаёт Список, содержащий элементы этого Перечисляемого объекта.
toString() → Строка inherited: Возвращает строковое представление (некоторых) элементов this.
where(bool test(E элемент)) → Iterable<E> inherited: Возвращает новый ленивый Перечисляемый объект со всеми элементами, удовлетворяющими предикату test.

© 2012 the Dart project authors
Licensed under the Creative Commons Attribution-ShareAlike License v4.0.
https://api.dartlang.org/stable/1.24.3/dart-core/Set-class.html