Класс BitSet

public BitSet()

public BitSet(int nbits)

Параметры:

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

Исключения:

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

public static BitSet valueOf(long[] longs)

Параметры:

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

Возвращает:

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

С версии:

1.7

public static BitSet valueOf(LongBuffer lb)

Параметры:

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

Возвращает:

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

С версии:

1.7

public static BitSet valueOf(byte[] bytes)

Параметры:

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

Возвращает:

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

С версии:

1.7

public static BitSet valueOf(ByteBuffer bb)

Параметры:

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

Возвращает:

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

С версии:

1.7

public byte[] toByteArray()

Возвращает:

массив byte, содержащий представление всех битов этого набора битов в порядке от младшего к старшему

С версии:

1.7

public long[] toLongArray()

Возвращает:

массив long, содержащий представление всех битов этого набора битов в порядке от младшего к старшему

С версии:

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)

Параметры:

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

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

Возвращает:

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

Исключения:

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

С версии:

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
    }
}

Параметры:

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

Возвращает:

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

Исключения:

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

С версии:

1.4

public int nextClearBit(int fromIndex)

Параметры:

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

Возвращает:

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

Исключения:

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

С версии:

1.4

public int previousSetBit(int fromIndex)

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

Параметры:

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

Возвращает:

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

Исключения:

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

С версии:

1.7

public int previousClearBit(int fromIndex)

Параметры:

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

Возвращает:

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

Исключения:

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

С версии:

1.7

public int length()

Возвращает:

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

С версии:

1.2

public boolean isEmpty()

Возвращает:

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

С версии:

1.4

public boolean intersects(BitSet set)

Параметры:

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

Возвращает:

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

С версии:

1.4

public int cardinality()

Возвращает:

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

С версии:

1.4

public void and(BitSet set)

Параметры:

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

public void or(BitSet set)

Параметры:

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

public void xor(BitSet set)

Параметры:

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

public void andNot(BitSet set)

Параметры:

set — BitSet, с помощью которого нужно замаскировать этот BitSet

С версии:

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);
}

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

hashCode в классе Object

Возвращает:

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

См. также:

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

public int size()

Возвращает:

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

public boolean equals(Object obj)

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

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

equals в классе Object

Параметры:

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

Возвращает:

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

См. также:

• size()

public Object clone()

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

clone в классе Object

Возвращает:

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

См. также:

• size()

public String toString()

BitSet drPepper = new BitSet();

drPepper.set(2);

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

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

toString в классе Object

Возвращает:

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

public IntStream stream()

Возвращает:

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

С версии:

1.8