Класс BitSet

public BitSet()

public BitSet(int nbits)

Параметры:

nbits - начальный размер набора битов

Исключения:

NegativeArraySizeException - если указанный начальный размер отрицателен

public static BitSet valueOf(long[] longs)

Параметры:

longs - массив long, содержащий представление little-endian последовательности битов, которые будут использоваться в качестве начальных битов нового набора битов

Возвращает:

a BitSet containing all the bits in the long array

С версии:

1.7

public static BitSet valueOf(LongBuffer lb)

Параметры:

lb - буфер long, содержащий представление little-endian последовательности битов между его позицией и лимитом, которые будут использоваться в качестве начальных битов нового набора битов

Возвращает:

a BitSet containing all the bits in the buffer in the specified range

С версии:

1.7

public static BitSet valueOf(byte[] bytes)

Параметры:

bytes - массив байтов, содержащий представление little-endian последовательности битов, которые будут использоваться в качестве начальных битов нового набора битов

Возвращает:

a BitSet containing all the bits in the byte array

С версии:

1.7

public static BitSet valueOf(ByteBuffer bb)

Параметры:

bb - буфер байтов, содержащий представление little-endian последовательности битов между его позицией и лимитом, которые будут использоваться в качестве начальных битов нового набора битов

Возвращает:

a BitSet containing all the bits in the buffer in the specified range

С версии:

1.7

public byte[] toByteArray()

Возвращает:

массив байтов, содержащий представление little-endian всех битов в этом наборе битов

С версии:

1.7

public long[] toLongArray()

Возвращает:

массив long, содержащий представление little-endian всех битов в этом наборе битов

С версии:

1.7

public void flip(int bitIndex)

Параметры:

bitIndex - индекс бита для инвертирования

Исключения:

IndexOutOfBoundsException - если указанный индекс отрицателен

С версии:

1.4

public void flip(int fromIndex, int toIndex)

Параметры:

fromIndex - индекс первого бита для инвертирования

toIndex - индекс после последнего бита для инвертирования

Исключения:

IndexOutOfBoundsException - если fromIndex отрицателен, или toIndex отрицателен, или fromIndex больше чем toIndex

С версии:

1.4

public void set(int bitIndex)

Параметры:

bitIndex - индекс бита

Исключения:

IndexOutOfBoundsException - если указанный индекс отрицателен

С версии:

1.0

public void set(int bitIndex, boolean value)

Параметры:

bitIndex - индекс бита

value - булево значение для установки

Исключения:

IndexOutOfBoundsException - если указанный индекс отрицателен

С версии:

1.4

public void set(int fromIndex, int toIndex)

Параметры:

fromIndex - индекс первого бита для установки

toIndex - индекс после последнего бита для установки

Исключения:

IndexOutOfBoundsException - если fromIndex отрицателен, или toIndex отрицателен, или fromIndex больше чем toIndex

С версии:

1.4

public void set(int fromIndex, int toIndex, boolean value)

Параметры:

fromIndex - индекс первого бита для установки

toIndex - индекс после последнего бита для установки

value - значение для установки выбранных битов

Исключения:

IndexOutOfBoundsException - если fromIndex отрицателен, или toIndex отрицателен, или fromIndex больше чем toIndex

С версии:

1.4

public void clear(int bitIndex)

Параметры:

bitIndex - индекс бита для очистки

Исключения:

IndexOutOfBoundsException - если указанный индекс отрицателен

С версии:

1.0

public void clear(int fromIndex, int toIndex)

Параметры:

fromIndex - индекс первого бита для очистки

toIndex - индекс после последнего бита для очистки

Исключения:

IndexOutOfBoundsException - если fromIndex отрицателен, или toIndex отрицателен, или fromIndex больше чем toIndex

С версии:

1.4

public void clear()

С версии:

1.4

public boolean get(int bitIndex)

Параметры:

bitIndex - индекс бита

Возвращает:

значение бита с указанным индексом

Исключения:

IndexOutOfBoundsException - если указанный индекс отрицателен

public BitSet get(int fromIndex, int toIndex)

Parameters:

fromIndex - индекс первого бита для включения

toIndex - индекс после последнего бита для включения

Returns:

новый BitSet из диапазона этого BitSet

Throws:

IndexOutOfBoundsException - если fromIndex отрицательный, или toIndex отрицательный, или fromIndex больше чем toIndex

Since:

1.4

public int nextSetBit(int fromIndex)

 
 for (int i = bs.nextSetBit(0); i >= 0; i = bs.nextSetBit(i+1)) {
     // operate on index i here
     if (i == Integer.MAX_VALUE) {
         break; // or (i+1) would overflow
     }
 }

Parameters:

fromIndex - индекс, с которого начинать проверку (включительно)

Returns:

индекс следующего установленного бита, или -1, если такого бита нет

Throws:

IndexOutOfBoundsException - если указанный индекс отрицательный

Since:

1.4

public int nextClearBit(int fromIndex)

Parameters:

fromIndex - индекс, с которого начинать проверку (включительно)

Returns:

индекс следующего сброшенного бита

Throws:

IndexOutOfBoundsException - если указанный индекс отрицательный

Since:

1.4

public int previousSetBit(int fromIndex)

 
 for (int i = bs.length(); (i = bs.previousSetBit(i-1)) >= 0; ) {
     // operate on index i here
 }

Parameters:

fromIndex - индекс, с которого начинать проверку (включительно)

Returns:

индекс предыдущего установленного бита, или -1, если такого бита нет

Throws:

IndexOutOfBoundsException - если указанный индекс меньше -1

Since:

1.7

public int previousClearBit(int fromIndex)

Parameters:

fromIndex - индекс, с которого начинать проверку (включительно)

Returns:

индекс предыдущего сброшенного бита, или -1, если такого бита нет

Throws:

IndexOutOfBoundsException - если указанный индекс меньше -1

Since:

1.7

public int length()

Returns:

логический размер этого BitSet

Since:

1.2

public boolean isEmpty()

Returns:

булево значение, указывающее, пуст ли этот BitSet

Since:

1.4

public boolean intersects(BitSet set)

Parameters:

set - BitSet для пересечения

Returns:

булево значение, указывающее, пересекается ли этот BitSet с указанным BitSet

Since:

1.4

public int cardinality()

Returns:

количество битов, установленных в true в этом BitSet

Since:

1.4

public void and(BitSet set)

Parameters:

set - набор битов

public void or(BitSet set)

Parameters:

set - набор битов

public void xor(BitSet set)

Parameters:

set - набор битов

public void andNot(BitSet set)

Parameters:

set - набор битов, с которым нужно замаскировать этот BitSet

Since:

1.2

public int hashCode()

 
 public int hashCode() {
     long h = 1234;
     long[] words = toLongArray();
     for (int i = words.length; --i >= 0; )
         h ^= words[i] * (i + 1);
     return (int)((h >> 32) ^ h);
 }

Overrides:

hashCode в классе Object

Returns:

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

See Also:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)

public int size()

Returns:

количество битов в этом наборе битов

public boolean equals(Object obj)

((BitSet)obj).get(k) == this.get(k)

Overrides:

equals в классе Object

Parameters:

obj - объект для сравнения

Returns:

true, если объекты одинаковые; false в противном случае

See Also:

• size()

public Object clone()

Overrides:

clone в классе Object

Returns:

клон этого набора битов

See Also:

• size()

public String toString()

 BitSet drPepper = new BitSet();

 drPepper.set(2);

 drPepper.set(4);
 drPepper.set(10);

Overrides:

toString в классе Object

Возвращает:

строковое представление этого набора битов

public IntStream stream()

Возвращает:

поток целых чисел, представляющих индексы установки

С тех пор:

1.8