java.util

Класс EnumSet <E расширяет Перечисление <E>>

java.lang. Объект

java.util. AbstractCollection<E>

java.util. AbstractSet <E>

java.util. EnumSet <E>

Все Реализованные Интерфейсы:

Сериализуемый, Cloneable, Повторяемый <E>, Набор <E>, Набор <E>

public abstract class EnumSet<E extends Enum<E>>
extends AbstractSet<E>
implements Cloneable, Serializable

Специализированное Set реализация для использования с перечислимыми типами. Все элементы в перечислимом наборе должны прибыть из единственного перечислимого типа, который определяется, явно или неявно, когда набор создается. Перечислимые наборы представляются внутренне как битовый векторы. Это представление чрезвычайно компактно и эффективно. Производительность пространства и времени этого класса должна быть достаточно хорошей, чтобы позволить его использование в качестве высококачественной, безопасной с точки зрения типов альтернативы традиционному int на основе "битовые флаги." Даже объемные операции (такие как containsAll и retainAll) должны работать очень быстро, если их параметром является также перечислимый набор.

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

Нулевые элементы не разрешаются. Попытки вставить нулевой элемент бросят NullPointerException. Попытки протестировать на присутствие нулевого элемента или удалить каждый будет, однако, функционировать должным образом.

Как большинство реализаций набора, не синхронизируется EnumSet. Если многократные потоки получают доступ к перечислимому набору одновременно, и по крайней мере один из потоков изменяет набор, он должен синхронизироваться внешне. Это обычно выполняется, синхронизируясь на некотором объекте, который естественно инкапсулирует перечислимый набор. Если никакой такой объект не существует, набор должен быть "обернут", используя Collections.synchronizedSet(java.util.Set<T>) метод. Это лучше всего делается во время создания, чтобы предотвратить случайный несинхронизируемый доступ:

 Set<MyEnum> s = Collections.synchronizedSet(EnumSet.noneOf(MyEnum.class));
 

Примечание реализации: В постоянное время выполняются все основные операции. Они вероятны (хотя не гарантируемый) быть намного быстрее чем их HashSet дубликаты. Даже объемные операции выполняются в постоянное время, если их параметром является также перечислимый набор.

Этот класс является элементом Платформы Наборов Java.

С тех пор:

1.5

См. Также:

EnumMap

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
static <E extends Enum<E>> EnumSet<E>	allOf(Class<E> elementType) Создает перечислимый набор, содержащий все элементы в указанном типе элемента.
EnumSet<E>	clone() Возвращает копию этого набора.
static <E extends Enum<E>> EnumSet<E>	complementOf(EnumSet<E> s) Создает перечислимый набор с тем же самым типом элемента как указанный перечислимый набор, первоначально содержащий все элементы этого типа, которые не содержатся в указанном наборе.
static <E extends Enum<E>> EnumSet<E>	copyOf(Collection<E> c) Создает перечислимый набор, инициализированный из указанного набора.
static <E extends Enum<E>> EnumSet<E>	copyOf(EnumSet<E> s) Создает перечислимый набор с тем же самым типом элемента как указанный перечислимый набор, первоначально содержащий те же самые элементы (если любой).
static <E extends Enum<E>> EnumSet<E>	noneOf(Class<E> elementType) Создает пустой перечислимый набор с указанным типом элемента.
static <E extends Enum<E>> EnumSet<E>	of(E e) Создает перечислимый набор, первоначально содержащий указанный элемент.
static <E extends Enum<E>> EnumSet<E>	of(E first, E... rest) Создает перечислимый набор, первоначально содержащий указанные элементы.
static <E extends Enum<E>> EnumSet<E>	of(E e1, E e2) Создает перечислимый набор, первоначально содержащий указанные элементы.
static <E extends Enum<E>> EnumSet<E>	of(E e1, E e2, E e3) Создает перечислимый набор, первоначально содержащий указанные элементы.
static <E extends Enum<E>> EnumSet<E>	of(E e1, E e2, E e3, E e4) Создает перечислимый набор, первоначально содержащий указанные элементы.
static <E extends Enum<E>> EnumSet<E>	of(E e1, E e2, E e3, E e4, E e5) Создает перечислимый набор, первоначально содержащий указанные элементы.
static <E extends Enum<E>> EnumSet<E>	range(E from, E to) Создает перечислимый набор, первоначально содержащий все элементы в диапазоне, определенном двумя указанными конечными точками.

Методы java.util унаследованный от класса. AbstractSet

equals, hashCode, removeAll

Методы java.util унаследованный от класса. AbstractCollection

add, addAll, clear, contains, containsAll, isEmpty, iterator, remove, retainAll, size, toArray, toArray, toString

Методы java.lang унаследованный от класса. Объект

finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, наследованные от интерфейса java.util. Набор

add, addAll, clear, contains, containsAll, isEmpty, iterator, remove, retainAll, size, toArray, toArray

Деталь метода

noneOf

public static <E extends Enum<E>> EnumSet<E> noneOf(Class<E> elementType)

Создает пустой перечислимый набор с указанным типом элемента.

Параметры:

elementType - объект класса элемента вводит для этого перечислимого набора

Броски:

NullPointerException - если elementType является нулем

allOf

public static <E extends Enum<E>> EnumSet<E> allOf(Class<E> elementType)

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

Параметры:

elementType - объект класса элемента вводит для этого перечислимого набора

Броски:

NullPointerException - если elementType является нулем

copyOf

public static <E extends Enum<E>> EnumSet<E> copyOf(EnumSet<E> s)

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

Параметры:

s - перечислимый набор, от которого можно инициализировать этот перечислимый набор

Броски:

NullPointerException - если s является нулем

copyOf

public static <E extends Enum<E>> EnumSet<E> copyOf(Collection<E> c)

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

Параметры:

c - набор, от которого можно инициализировать этот перечислимый набор

Броски:

IllegalArgumentException - если c не является экземпляром EnumSet и не содержит элементов

NullPointerException - если c является нулем

complementOf

public static <E extends Enum<E>> EnumSet<E> complementOf(EnumSet<E> s)

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

Параметры:

s - перечислимый набор тот, от чей дополнения, чтобы инициализировать этот перечислимый набор

Броски:

NullPointerException - если s является нулем

из

public static <E extends Enum<E>> EnumSet<E> of(E e)

Создает перечислимый набор, первоначально содержащий указанный элемент. Перегрузки этого метода существуют, чтобы инициализировать перечислимый набор с одним - пятью элементами. Шестая перегрузка состоит в том при условии, что использует varargs функцию. Эта перегрузка может использоваться, чтобы создать перечислимый набор, первоначально содержащий произвольное число элементов, но, вероятно, будет работать медленнее чем перегрузки, которые не используют varargs.

Параметры:

e - элемент, который этот набор должен содержать первоначально

Возвраты:

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

Броски:

NullPointerException - если e является нулем

из

public static <E extends Enum<E>> EnumSet<E> of(E e1,
                                E e2)

Создает перечислимый набор, первоначально содержащий указанные элементы. Перегрузки этого метода существуют, чтобы инициализировать перечислимый набор с одним - пятью элементами. Шестая перегрузка состоит в том при условии, что использует varargs функцию. Эта перегрузка может использоваться, чтобы создать перечислимый набор, первоначально содержащий произвольное число элементов, но, вероятно, будет работать медленнее чем перегрузки, которые не используют varargs.

Параметры:

e1 - элемент, который этот набор должен содержать первоначально

e2 - другой элемент, который этот набор должен содержать первоначально

Возвраты:

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

Броски:

NullPointerException - если какие-либо параметры являются нулем

из

public static <E extends Enum<E>> EnumSet<E> of(E e1,
                                E e2,
                                E e3)

Создает перечислимый набор, первоначально содержащий указанные элементы. Перегрузки этого метода существуют, чтобы инициализировать перечислимый набор с одним - пятью элементами. Шестая перегрузка состоит в том при условии, что использует varargs функцию. Эта перегрузка может использоваться, чтобы создать перечислимый набор, первоначально содержащий произвольное число элементов, но, вероятно, будет работать медленнее чем перегрузки, которые не используют varargs.

Параметры:

e1 - элемент, который этот набор должен содержать первоначально

e2 - другой элемент, который этот набор должен содержать первоначально

e3 - другой элемент, который этот набор должен содержать первоначально

Возвраты:

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

Броски:

NullPointerException - если какие-либо параметры являются нулем

из

public static <E extends Enum<E>> EnumSet<E> of(E e1,
                                E e2,
                                E e3,
                                E e4)

Создает перечислимый набор, первоначально содержащий указанные элементы. Перегрузки этого метода существуют, чтобы инициализировать перечислимый набор с одним - пятью элементами. Шестая перегрузка состоит в том при условии, что использует varargs функцию. Эта перегрузка может использоваться, чтобы создать перечислимый набор, первоначально содержащий произвольное число элементов, но, вероятно, будет работать медленнее чем перегрузки, которые не используют varargs.

Параметры:

e1 - элемент, который этот набор должен содержать первоначально

e2 - другой элемент, который этот набор должен содержать первоначально

e3 - другой элемент, который этот набор должен содержать первоначально

e4 - другой элемент, который этот набор должен содержать первоначально

Возвраты:

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

Броски:

NullPointerException - если какие-либо параметры являются нулем

из

public static <E extends Enum<E>> EnumSet<E> of(E e1,
                                E e2,
                                E e3,
                                E e4,
                                E e5)

Создает перечислимый набор, первоначально содержащий указанные элементы. Перегрузки этого метода существуют, чтобы инициализировать перечислимый набор с одним - пятью элементами. Шестая перегрузка состоит в том при условии, что использует varargs функцию. Эта перегрузка может использоваться, чтобы создать перечислимый набор, первоначально содержащий произвольное число элементов, но, вероятно, будет работать медленнее чем перегрузки, которые не используют varargs.

Параметры:

e1 - элемент, который этот набор должен содержать первоначально

e2 - другой элемент, который этот набор должен содержать первоначально

e3 - другой элемент, который этот набор должен содержать первоначально

e4 - другой элемент, который этот набор должен содержать первоначально

e5 - другой элемент, который этот набор должен содержать первоначально

Возвраты:

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

Броски:

NullPointerException - если какие-либо параметры являются нулем

из

@SafeVarargs
public static <E extends Enum<E>> EnumSet<E> of(E first,
                                            E... rest)

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

Параметры:

first - элемент, который набор должен содержать первоначально

rest - остающиеся элементы набор должны содержать первоначально

Возвраты:

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

Броски:

NullPointerException - если какой-либо из указанных элементов является нулем, или если rest является нулем

диапазон

public static <E extends Enum<E>> EnumSet<E> range(E from,
                                   E to)

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

Параметры:

from - первый элемент в диапазоне

to - последний элемент в диапазоне

Возвраты:

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

Броски:

NullPointerException - если from или to нуль

IllegalArgumentException - если from.compareTo(to) > 0

клон

public EnumSet<E> clone()

Возвращает копию этого набора.

Переопределения:

clone в классе Object

Возвраты:

копия этого набора

См. Также:

Cloneable