Интерфейс Set<E>

Параметры типа:: E - тип элементов, поддерживаемых этим множеством

Все суперинтерфейсы:: Collection<E>, Iterable<E>

Все известные подинтерфейсы:: EventSet, NavigableSet<E>, SequencedSet<E>, SortedSet<E>

Все известные реализующие классы:: AbstractSet, ConcurrentHashMap.KeySetView, ConcurrentSkipListSet, CopyOnWriteArraySet, EnumSet, HashSet, JobStateReasons, LinkedHashSet, TreeSet

public interface Set<E> extends Collection<E>

Коллекция, не содержащая дублирующих элементов. Более формально, множества не содержат пары элементов e1 и e2, таких что e1.equals(e2), и не более одного нулевого элемента. Как следует из его названия, этот интерфейс моделирует абстракцию математического множества.

Интерфейс Set накладывает дополнительные условия, помимо унаследованных от интерфейса Collection, на контракты всех конструкторов и на контракты методов add, equals и hashCode. Объявления других унаследованных методов также включены сюда для удобства. (Спецификации, сопровождающие эти объявления, адаптированы к интерфейсу Set, но они не содержат дополнительных положений.)

Дополнительное условие для конструкторов, как нетрудно догадаться, заключается в том, что все конструкторы должны создавать множество, не содержащее дублирующих элементов (как определено выше).

Примечание: Необходимо проявлять особую осторожность, если в качестве элементов множества используются изменяемые объекты. Поведение множества не определено, если значение объекта изменяется таким образом, что влияет на equals сравнения, пока объект является элементом множества. Специальным случаем этого запрета является то, что множество не может содержать себя как элемент.

Некоторые реализации множеств имеют ограничения на элементы, которые они могут содержать. Например, некоторые реализации запрещают нулевые элементы, а некоторые имеют ограничения на типы элементов. Попытка добавить неприемлемый элемент вызывает необработанное исключение, как правило, NullPointerException или ClassCastException. Попытка запросить наличие неприемлемого элемента может вызвать исключение или просто вернуть false; некоторые реализации проявят первое поведение, а некоторые — второе. В более общем плане, попытка выполнения операции с неприемлемым элементом, завершение которой не приведет к вставке неприемлемого элемента в множество, может вызвать исключение или завершиться успешно, по выбору реализации. Такие исключения отмечаются как «необязательные» в спецификации этого интерфейса.

Неизменяемые множества

Статические фабричные методы Set.of и Set.copyOf предоставляют удобный способ создания неизменяемых множеств. Экземпляры Set, созданные этими методами, обладают следующими характеристиками:

Они являются неизменяемыми. Элементы не могут быть добавлены или удалены. Вызов любого метода-мутатора для множества всегда вызовет UnsupportedOperationException . Однако, если содержащиеся элементы сами по себе изменяемы, это может привести к несогласованному поведению множества или его содержимое может показаться изменённым.
Они запрещают null элементы. Попытки создать их с null элементами приводят к NullPointerException.
Они сериализуемы, если все элементы сериализуемы.
Они отбрасывают дублируемые элементы при создании. Дублируемые элементы, переданные фабричному методу, приводят к IllegalArgumentException.
Порядок итерации элементов множества не определён и может измениться.
Они являются значение-ориентированными. Программисты должны рассматривать экземпляры, которые равны, как взаимозаменяемые и не должны использовать их для синхронизации, в противном случае может возникнуть непредсказуемое поведение. Например, в будущих версиях синхронизация может не сработать. Вызывающие стороны не должны делать предположений об идентичности возвращаемых экземпляров. Фабрики свободны создавать новые экземпляры или повторно использовать существующие.
Они сериализуются как указано на странице Формат сериализации.

Этот интерфейс является членом Java Collections Framework.

С тех пор:

1.2

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`add(E e)`	Добавляет указанный элемент в этот набор, если он ещё не присутствует (необязательная операция).
`boolean`	`addAll(Collection<? extends E> c)`	Добавляет все элементы из указанной коллекции в этот набор, если они ещё не присутствуют (необязательная операция).
`void`	`clear()`	Удаляет все элементы из этого набора (необязательная операция).
`boolean`	`contains(Object o)`	Возвращает значение `true`, если этот набор содержит указанный элемент.
`boolean`	`containsAll(Collection<?> c)`	Возвращает значение `true`, если этот набор содержит все элементы указанной коллекции.
`static <E> Set<E>`	`copyOf(Collection<? extends E> coll)`	Возвращает неизменяемый набор содержащий элементы заданной коллекции.
`boolean`	`equals(Object o)`	Сравнивает указанный объект с этим набором на равенство.
`int`	`hashCode()`	Возвращает хэш-код для этого набора.
`boolean`	`isEmpty()`	Возвращает значение `true`, если этот набор не содержит элементов.
`Iterator<E>`	`iterator()`	Возвращает итератор по элементам в этом наборе.
`static <E> Set<E>`	`of()`	Возвращает неизменяемый набор, содержащий ноль элементов.
`static <E> Set<E>`	`of(E e1)`	Возвращает неизменяемый набор, содержащий один элемент.
`static <E> Set<E>`	`of(E... elements)`	Возвращает неизменяемый набор, содержащий произвольное количество элементов.
`static <E> Set<E>`	`of(E e1, E e2)`	Возвращает неизменяемый набор, содержащий два элемента.
`static <E> Set<E>`	`of(E e1, E e2, E e3)`	Возвращает неизменяемый набор, содержащий три элемента.
`static <E> Set<E>`	`of(E e1, E e2, E e3, E e4)`	Возвращает неизменяемый набор, содержащий четыре элемента.
`static <E> Set<E>`	`of(E e1, E e2, E e3, E e4, E e5)`	Возвращает неизменяемый набор, содержащий пять элементов.
`static <E> Set<E>`	`of(E e1, E e2, E e3, E e4, E e5, E e6)`	Возвращает неизменяемый набор, содержащий шесть элементов.
`static <E> Set<E>`	`of(E e1, E e2, E e3, E e4, E e5, E e6, E e7)`	Возвращает неизменяемый набор, содержащий семь элементов.
`static <E> Set<E>`	`of(E e1, E e2, E e3, E e4, E e5, E e6, E e7, E e8)`	Возвращает неизменяемый набор, содержащий восемь элементов.
`static <E> Set<E>`	`of(E e1, E e2, E e3, E e4, E e5, E e6, E e7, E e8, E e9)`	Возвращает неизменяемый набор, содержащий девять элементов.
`static <E> Set<E>`	`of(E e1, E e2, E e3, E e4, E e5, E e6, E e7, E e8, E e9, E e10)`	Возвращает неизменяемый набор, содержащий десять элементов.
`boolean`	`remove(Object o)`	Удаляет указанный элемент из этого набора, если он присутствует (необязательная операция).
`boolean`	`removeAll(Collection<?> c)`	Удаляет из этого набора все его элементы, которые содержатся в заданной коллекции (необязательная операция).
`boolean`	`retainAll(Collection<?> c)`	Оставляет только элементы в этом наборе, которые содержатся в указанной коллекции (необязательная операция).
`int`	`size()`	Возвращает количество элементов в этом наборе (его мощность).
`default Spliterator<E>`	`spliterator()`	Создаёт `Spliterator` по элементам в этом наборе.
`Object[]`	`toArray()`	Возвращает массив, содержащий все элементы в этом наборе.
`<T> T[]`	`toArray(T[] a)`	Возвращает массив, содержащий все элементы в этом наборе; тип возвращаемого массива - тип указанного массива.

Методы, объявленные в интерфейсе java.util.Collection

parallelStream, removeIf, stream, toArray

Методы, объявленные в интерфейсе java.lang.Iterable

forEach

Подробное описание методов

size

int size()

Возвращает количество элементов в этом множестве (его мощность). Если это множество содержит более Integer.MAX_VALUE элементов, возвращает Integer.MAX_VALUE.

Указано в:: size в интерфейсе Collection<E>
Возвращает:: количество элементов в этом множестве (его мощность)

isEmpty

boolean isEmpty()

Возвращает true, если это множество не содержит элементов.

Указано в:: isEmpty в интерфейсе Collection<E>
Возвращает:: true если это множество не содержит элементов

contains

boolean contains(Object o)

Возвращает true, если это множество содержит указанный элемент. Более формально, возвращает true тогда и только тогда, когда это множество содержит элемент e, такой, что Objects.equals(o, e).

Указано в:: contains в интерфейсе Collection<E>
Параметры:: o - элемент, наличие которого в этом множестве необходимо проверить
Возвращает:: true если это множество содержит указанный элемент
Исключение:: ClassCastException - если тип указанного элемента несовместим с этим множеством (необязательно); NullPointerException - если указанный элемент имеет значение null, а это множество не допускает null-элементов (необязательно)

iterator

Iterator<E> iterator()

Возвращает итератор по элементам этого множества. Элементы возвращаются в произвольном порядке (если это множество не является экземпляром какого-либо класса, обеспечивающего гарантию).

Указано в:: iterator в интерфейсе Collection<E>
Указано в:: iterator в интерфейсе Iterable<E>
Возвращает:: итератор по элементам этого множества

toArray

Object[] toArray()

Возвращает массив, содержащий все элементы этого множества. Если это множество гарантирует порядок возврата элементов своим итератором, этот метод должен возвращать элементы в том же порядке.

Возвращаемый массив будет «безопасным» в том смысле, что к нему не сохраняются ссылки этого множества. (Другими словами, этот метод должен выделять новый массив, даже если это множество основано на массиве). Таким образом, вызывающий метод свободен изменять возвращаемый массив.

Этот метод служит мостом между основанными на массивах и основанными на коллекциях API.

Указано в:: toArray в интерфейсе Collection<E>
Возвращает:: массив, содержащий все элементы этого множества

toArray

<T> T[] toArray(T[] a)

Возвращает массив, содержащий все элементы этого множества; тип времени выполнения возвращаемого массива соответствует типу указанного массива. Если множество помещается в указанный массив, оно возвращается в нём. В противном случае выделяется новый массив с типом времени выполнения указанного массива и размером этого множества.

Если это множество помещается в указанный массив с избытком места (т.е. массив имеет больше элементов, чем это множество), элемент в массиве сразу после конца множества устанавливается в null. (Это полезно для определения длины этого множества *только* если вызывающий метод знает, что это множество не содержит null-элементов.)

Если это множество гарантирует порядок возврата элементов своим итератором, этот метод должен возвращать элементы в том же порядке.

Как и метод toArray(), этот метод действует как мост между основанными на массивах и основанными на коллекциях API. Кроме того, этот метод позволяет точно управлять типом времени выполнения выходного массива и может в определённых обстоятельствах использоваться для экономии затрат на выделение памяти.

Предположим, x — множество, известное тем, что содержит только строки. Следующий код может быть использован для выгрузки множества в новый выделенный массив типа String:

     String[] y = x.toArray(new String[0]);

Обратите внимание, что toArray(new Object[0]) идентично по функциональности toArray().

Указано в:: toArray в интерфейсе Collection<E>
Параметры типа:: T - тип компонента массива, содержащего коллекцию
Параметры:: a - массив, в который должны быть помещены элементы этого множества, если он достаточно большой; в противном случае для этой цели выделяется новый массив того же типа времени выполнения.
Возвращает:: массив, содержащий все элементы этого множества
Исключение:: ArrayStoreException - если тип времени выполнения указанного массива не является супертипом типа времени выполнения каждого элемента в этом множестве; NullPointerException - если указанный массив равен null

add

boolean add(E e)

Добавляет указанный элемент в это множество, если он ещё не присутствует (необязательная операция). Более формально, добавляет указанный элемент e в это множество, если множество не содержит элемент e2, такой, что Objects.equals(e, e2). Если это множество уже содержит элемент, вызов оставляет множество неизменным и возвращает false. В сочетании с ограничением на конструкторы это гарантирует, что множества никогда не содержат дублирующих элементов.

Вышеупомянутое условие не подразумевает, что множества должны принимать все элементы; множества могут отказаться добавить конкретный элемент, включая null, и бросить исключение, как описано в спецификации для Collection.add. Отдельные реализации множеств должны чётко документировать любые ограничения на элементы, которые они могут содержать.

Указано в:: add в интерфейсе Collection<E>
Параметры:: e - элемент, который должен быть добавлен в это множество
Возвращает:: true если это множество ещё не содержало указанный элемент
Исключение:: UnsupportedOperationException - если операция add не поддерживается этим множеством; ClassCastException - если класс указанного элемента препятствует его добавлению в это множество; NullPointerException - если указанный элемент имеет значение null, а это множество не допускает null-элементов; IllegalArgumentException - если какое-либо свойство указанного элемента препятствует его добавлению в это множество

remove

boolean remove(Object o)

Удаляет указанный элемент из этого множества, если он присутствует (необязательная операция). Более формально, удаляет элемент e, такой, что Objects.equals(o, e), если это множество содержит такой элемент. Возвращает true если это множество содержало элемент (или, что эквивалентно, если это множество изменилось в результате вызова). (Это множество не будет содержать элемент после возврата вызова).

Указано в:: remove в интерфейсе Collection<E>
Параметры:: o - объект, который нужно удалить из этого множества, если он присутствует
Возвращает:: true если это множество содержало указанный элемент
Исключение:: ClassCastException - если тип указанного элемента несовместим с этим множеством (необязательно); NullPointerException - если указанный элемент имеет значение null, а это множество не допускает null-элементов (необязательно); UnsupportedOperationException - если операция remove не поддерживается этим множеством

containsAll

boolean containsAll(Collection<?> c)

Возвращает true если это множество содержит все элементы указанной коллекции. Если указанная коллекция также является множеством, этот метод возвращает true если она является подмножеством этого множества.

Указано в:

containsAll в интерфейсе Collection<E>

Параметры:

c - коллекция, проверяемая на вхождение в это множество

Возвращает:

true если это множество содержит все элементы указанной коллекции

Исключение:

ClassCastException - если типы одного или нескольких элементов в указанной коллекции несовместимы с этим множеством (необязательно)

NullPointerException - если указанная коллекция содержит один или несколько null-элементов, и это множество не допускает null-элементов (необязательно), или если указанная коллекция равна null

См. также:

addAll

boolean addAll(Collection<? extends E> c)

Добавляет все элементы из указанного набора в этот набор, если они ещё не присутствуют (необязательная операция). Если указанный набор также является набором, операция addAll фактически изменяет этот набор так, чтобы его значением было объединение двух наборов. Поведение этой операции не определено, если указанный набор изменяется во время выполнения операции.

Указано в:

addAll в интерфейсе Collection<E>

Параметры:

c - набор, содержащий элементы, которые необходимо добавить в этот набор

Возвращает:

true если этот набор изменился в результате вызова

Исключения:

UnsupportedOperationException - если операция addAll не поддерживается этим набором

ClassCastException - если класс элемента указанного набора не позволяет добавить его в этот набор

NullPointerException - если указанный набор содержит один или несколько нулевых элементов, а этот набор не допускает нулевых элементов, или если указанный набор равен null

IllegalArgumentException - если какое-либо свойство элемента указанного набора препятствует его добавлению в этот набор

См. также:

retainAll

boolean retainAll(Collection<?> c)

Оставляет только элементы в этом наборе, которые содержатся в указанном наборе (необязательная операция). Другими словами, удаляет из этого набора все его элементы, которые не содержатся в указанном наборе. Если указанный набор также является набором, эта операция фактически изменяет этот набор так, чтобы его значением было пересечение двух наборов.

Указано в:

retainAll в интерфейсе Collection<E>

Параметры:

c - набор, содержащий элементы, которые необходимо сохранить в этом наборе

Возвращает:

true если этот набор изменился в результате вызова

Исключения:

UnsupportedOperationException - если операция retainAll не поддерживается этим набором

ClassCastException - если класс элемента этого набора несовместим с указанным набором (необязательно)

NullPointerException - если этот набор содержит нулевой элемент, а указанный набор не допускает нулевых элементов (необязательно), или если указанный набор равен null

См. также:

removeAll

boolean removeAll(Collection<?> c)

Удаляет из этого набора все его элементы, которые содержатся в указанном наборе (необязательная операция). Если указанный набор также является набором, эта операция фактически изменяет этот набор так, чтобы его значением было симметричное разность двух наборов.

Указано в:

removeAll в интерфейсе Collection<E>

Параметры:

c - набор, содержащий элементы, которые необходимо удалить из этого набора

Возвращает:

true если этот набор изменился в результате вызова

Исключения:

UnsupportedOperationException - если операция removeAll не поддерживается этим набором

ClassCastException - если класс элемента этого набора несовместим с указанным набором (необязательно)

См. также:

clear

void clear()

Удаляет все элементы из этого набора (необязательная операция). После возврата вызова набор будет пустым.

Указано в:: clear в интерфейсе Collection<E>
Исключения:: UnsupportedOperationException - если метод clear не поддерживается этим набором

equals

boolean equals(Object o)

Сравнивает указанный объект с этим набором на равенство. Возвращает true если указанный объект также является набором, у двух наборов одинаковый размер, и каждый член указанного набора содержится в этом наборе (или, что эквивалентно, каждый член этого набора содержится в указанном наборе). Это определение гарантирует, что метод equals работает правильно для разных реализаций интерфейса набора.

Указано в:

equals в интерфейсе Collection<E>

Переопределяет:

equals в классе Object

Параметры:

o - объект, который необходимо сравнить на равенство с этим набором

Возвращает:

true если указанный объект равен этому набору

См. также:

hashCode

int hashCode()

Возвращает значение хэш-кода для этого набора. Хэш-код набора определяется как сумма хэш-кодов элементов в наборе, где хэш-код null элемента определяется как ноль. Это гарантирует, что s1.equals(s2) подразумевает, что s1.hashCode()==s2.hashCode() для любых двух наборов s1 и s2, как требуется общим контрактом Object.hashCode().

Указано в:

hashCode в интерфейсе Collection<E>

Переопределяет:

hashCode в классе Object

Возвращает:

значение хэш-кода для этого набора

См. также:

spliterator

default Spliterator<E> spliterator()

Создаёт Spliterator по элементам в этом наборе.

Spliterator сообщает о Spliterator.DISTINCT. Реализации должны документировать отчёт об дополнительных характеристических значениях.

Указано в:: spliterator в интерфейсе Collection<E>
Указано в:: spliterator в интерфейсе Iterable<E>
Требования к реализации:: Базовая реализация создаёт отложенную привязку Iterator из Iterator набора. Spliterator унаследует свойства fail-fast итератора набора.
Созданный Spliterator дополнительно сообщает о Spliterator.SIZED.
Примечание к реализации:: Созданный Spliterator дополнительно сообщает о Spliterator.SUBSIZED.
Возвращает:: Spliterator по элементам в этом наборе
С тех пор:: 1.8

of

static <E> Set<E> of()

Возвращает неизменяемый набор, содержащий ноль элементов. Подробности см. в разделе Неизменяемые наборы.

Параметры типа:: E - тип элемента набора
Возвращает:: пустой набор
С тех пор:: 9

of

static <E> Set<E> of(E e1)

Возвращает неизменяемый набор, содержащий один элемент. Подробности см. в разделе Неизменяемые наборы.

Параметры типа:: E - тип элемента набора
Параметры:: e1 - единственный элемент
Возвращает:: набор, содержащий указанный элемент
Исключения:: NullPointerException - если элемент null
С тех пор:: 9

of

static <E> Set<E> of(E e1, E e2)

Возвращает неизменяемый набор, содержащий два элемента. Подробности см. в разделе Неизменяемые наборы.

Параметры типа:: E - тип элемента набора
Параметры:: e1 - первый элемент; e2 - второй элемент
Возвращает:: набор, содержащий указанные элементы
Исключения:: IllegalArgumentException - если элементы являются дубликатами; NullPointerException - если элемент null
С тех пор:: 9

of

static <E> Set<E> of(E e1, E e2, E e3)

Возвращает неизменяемый набор, содержащий три элемента. Подробности см. в разделе Неизменяемые наборы.

Параметры типа:: E - тип элемента набора
Параметры:: e1 - первый элемент; e2 - второй элемент; e3 - третий элемент
Возвращает:: набор, содержащий указанные элементы
Исключения:: IllegalArgumentException - если существуют дублирующие элементы; NullPointerException - если элемент null
С тех пор:: 9

of

static <E> Set<E> of(E e1, E e2, E e3, E e4)

Возвращает неизменяемый набор, содержащий четыре элемента. См. Неизменяемые наборы для получения подробностей.

Параметры типа:: E - тип элемента набора
Параметры:: e1 - первый элемент; e2 - второй элемент; e3 - третий элемент; e4 - четвёртый элемент
Возвращаемое значение:: набор, содержащий указанные элементы
Исключения:: IllegalArgumentException - если есть какие-либо дублируемые элементы; NullPointerException - если элемент является null
С:: 9

of

static <E> Set<E> of(E e1, E e2, E e3, E e4, E e5)

Возвращает неизменяемый набор, содержащий пять элементов. См. Неизменяемые наборы для получения подробностей.

Параметры типа:: E - тип элемента набора
Параметры:: e1 - первый элемент; e2 - второй элемент; e3 - третий элемент; e4 - четвёртый элемент; e5 - пятый элемент
Возвращаемое значение:: набор, содержащий указанные элементы
Исключения:: IllegalArgumentException - если есть какие-либо дублируемые элементы; NullPointerException - если элемент является null
С:: 9

of

static <E> Set<E> of(E e1, E e2, E e3, E e4, E e5, E e6)

Возвращает неизменяемый набор, содержащий шесть элементов. См. Неизменяемые наборы для получения подробностей.

Параметры типа:: E - тип элемента набора
Параметры:: e1 - первый элемент; e2 - второй элемент; e3 - третий элемент; e4 - четвёртый элемент; e5 - пятый элемент; e6 - шестой элемент
Возвращаемое значение:: набор, содержащий указанные элементы
Исключения:: IllegalArgumentException - если есть какие-либо дублируемые элементы; NullPointerException - если элемент является null
С:: 9

of

static <E> Set<E> of(E e1, E e2, E e3, E e4, E e5, E e6, E e7)

Возвращает неизменяемый набор, содержащий семь элементов. См. Неизменяемые наборы для получения подробностей.

Параметры типа:: E - тип элемента набора
Параметры:: e1 - первый элемент; e2 - второй элемент; e3 - третий элемент; e4 - четвёртый элемент; e5 - пятый элемент; e6 - шестой элемент; e7 - седьмой элемент
Возвращаемое значение:: набор, содержащий указанные элементы
Исключения:: IllegalArgumentException - если есть какие-либо дублируемые элементы; NullPointerException - если элемент является null
С:: 9

of

static <E> Set<E> of(E e1, E e2, E e3, E e4, E e5, E e6, E e7, E e8)

Возвращает неизменяемый набор, содержащий восемь элементов. См. Неизменяемые наборы для получения подробностей.

Параметры типа:: E - тип элемента набора
Параметры:: e1 - первый элемент; e2 - второй элемент; e3 - третий элемент; e4 - четвёртый элемент; e5 - пятый элемент; e6 - шестой элемент; e7 - седьмой элемент; e8 - восьмой элемент
Возвращаемое значение:: набор, содержащий указанные элементы
Исключения:: IllegalArgumentException - если есть какие-либо дублируемые элементы; NullPointerException - если элемент является null
С:: 9

of

static <E> Set<E> of(E e1, E e2, E e3, E e4, E e5, E e6, E e7, E e8, E e9)

Возвращает неизменяемый набор, содержащий девять элементов. См. Неизменяемые наборы для получения подробностей.

Параметры типа:: E - тип элемента набора
Параметры:: e1 - первый элемент; e2 - второй элемент; e3 - третий элемент; e4 - четвёртый элемент; e5 - пятый элемент; e6 - шестой элемент; e7 - седьмой элемент; e8 - восьмой элемент; e9 - девятый элемент
Возвращаемое значение:: набор, содержащий указанные элементы
Исключения:: IllegalArgumentException - если есть какие-либо дублируемые элементы; NullPointerException - если элемент является null
С:: 9

of

static <E> Set<E> of(E e1, E e2, E e3, E e4, E e5, E e6, E e7, E e8, E e9, E e10)

Возвращает неизменяемый набор, содержащий десять элементов. См. Неизменяемые наборы для получения подробностей.

Параметры типа:: E - тип элемента набора
Параметры:: e1 - первый элемент; e2 - второй элемент; e3 - третий элемент; e4 - четвёртый элемент; e5 - пятый элемент; e6 - шестой элемент; e7 - седьмой элемент; e8 - восьмой элемент; e9 - девятый элемент; e10 - десятый элемент
Возвращаемое значение:: набор, содержащий указанные элементы
Исключения:: IllegalArgumentException - если есть какие-либо дублируемые элементы; NullPointerException - если элемент является null
С:: 9

of

@SafeVarargs static <E> Set<E> of(E... elements)

Возвращает неизменяемый набор, содержащий произвольное количество элементов. См. Неизменяемые наборы для получения подробностей.

Примечание API:

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


     String[] array = ... ;
     Set<String[]> list = Set.<String[]>of(array);

Это заставит метод Set.of(E) быть вызванным вместо этого.

Параметры типа:

E - тип элемента набора

Параметры:

elements - элементы, которые должны содержаться в наборе

Возвращаемое значение:

набор, содержащий указанные элементы

Исключения:

IllegalArgumentException - если есть какие-либо дублируемые элементы

NullPointerException - если элемент является null или если массив null

С:

copyOf

static <E> Set<E> copyOf(Collection<? extends E> coll)

Возвращает неизменяемый набор, содержащий элементы заданного набора. Заданный набор не должен быть null, и он не должен содержать каких-либо null-элементов. Если заданный набор содержит дублируемые элементы, произвольный элемент дубликатов сохраняется. Если заданный набор впоследствии будет изменён, возвращённый набор не будет отражать такие изменения.

Примечание по реализации:: Если заданный набор является неизменяемым набором, вызов copyOf обычно не создаёт копию.
Параметры типа:: E - тип элемента набора
Параметры:: coll - набор, из которого берутся элементы, не должен быть null
Возвращаемое значение:: неизменяемый набор, содержащий элементы заданного набора
Исключения:: NullPointerException - если coll null или содержит null-элементы
С:: 10

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Set.html