Класс BitSet

BitSet

public BitSet()

BitSet

public BitSet(int nbits)

Параметры:

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

Исключения:

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

valueOf

public static BitSet valueOf(long[] longs)

Параметры:

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

Возвращает:

набор битов BitSet содержащий все биты в массиве long

С:

1.7

valueOf

public static BitSet valueOf(LongBuffer lb)

Параметры:

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

Возвращает:

набор битов BitSet содержащий все биты в буфере в указанном диапазоне

С:

1.7

valueOf

public static BitSet valueOf(byte[] bytes)

Параметры:

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

Возвращает:

набор битов BitSet содержащий все биты в массиве байт

С:

1.7

valueOf

public static BitSet valueOf(ByteBuffer bb)

Параметры:

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

Возвращает:

набор битов BitSet содержащий все биты в буфере в указанном диапазоне

С:

1.7

toByteArray

public byte[] toByteArray()

Возвращает:

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

С:

1.7

toLongArray

public long[] toLongArray()

Возвращает:

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

С:

1.7

flip

public void flip(int bitIndex)

Параметры:

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

Исключения:

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

С:

1.4

flip

public void flip(int fromIndex, int toIndex)

Параметры:

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

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

Исключения:

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

С:

1.4

set

public void set(int bitIndex)

Параметры:

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

Исключения:

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

С:

1.0

set

public void set(int bitIndex, boolean value)

Параметры:

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

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

Исключения:

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

С:

1.4

set

public void set(int fromIndex, int toIndex)

Параметры:

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

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

Исключения:

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

С:

1.4

set

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

Параметры:

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

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

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

Исключения:

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

С:

1.4

clear

public void clear(int bitIndex)

Параметры:

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

Исключения:

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

С:

1.0

clear

public void clear(int fromIndex, int toIndex)

Параметры:

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

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

Исключения:

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

С:

1.4

clear

public void clear()

С:

1.4

get

public boolean get(int bitIndex)

Параметры:

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

Возвращает:

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

Исключения:

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

get

public BitSet get(int fromIndex, int toIndex)

Параметры:

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

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

Возвращает:

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

Исключения:

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

С:

1.4

nextSetBit

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

nextClearBit

public int nextClearBit(int fromIndex)

Parameters:

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

Returns:

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

Throws:

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

Since:

1.4

previousSetBit

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

previousClearBit

public int previousClearBit(int fromIndex)

Parameters:

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

Returns:

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

Throws:

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

Since:

1.7

length

public int length()

Returns:

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

Since:

1.2

isEmpty

public boolean isEmpty()

Returns:

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

Since:

1.4

intersects

public boolean intersects(BitSet set)

Parameters:

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

Returns:

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

Since:

1.4

cardinality

public int cardinality()

Returns:

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

Since:

1.4

and

public void and(BitSet set)

Parameters:

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

or

public void or(BitSet set)

Parameters:

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

xor

public void xor(BitSet set)

Parameters:

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

andNot

public void andNot(BitSet set)

Parameters:

set - набор битов для маскирования данного набора битов

Since:

1.2

hashCode

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)

size

public int size()

Returns:

количество битов, в данный момент в этом наборе битов

equals

public boolean equals(Object obj)

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

Overrides:

equals в классе Object

Parameters:

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

Returns:

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

See Also:

• size()

clone

public Object clone()

Overrides:

clone в классе Object

Returns:

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

See Also:

• size()

toString

public String toString()

 BitSet drPepper = new BitSet();

 drPepper.set(2);

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

Overrides:

toString в классе Object

Returns:

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

stream

public IntStream stream()

Возвращает:

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

С:

1.8