BufferBitSet (tech.bitey:bufferstuff 0.2.2 API)

java.lang.Object
- tech.bitey.bufferstuff.BufferBitSet

```
public class BufferBitSet
extends Object
```
Similar to BitSet, but backed by a ByteBuffer. Differences with BitSet include:
BufferBitSet
- ... is neither Cloneable nor Serializable.
- ... does not hide the backing buffer, and offers copy-free methods for wrapping an existing buffer.
- ... allows for specifying the resize behavior.
This bitset is not thread safe, and concurrent writes could put it into a bad state. External modifications to the backing buffer can do the same.
Author:

Lior Privman, Arthur van Hoff (java.util.BitSet), Michael McCloskey (java.util.BitSet), Martin Buchholz (java.util.BitSet)

See Also:

BitSet, ByteBuffer

Constructor Summary

Constructors
Constructor and Description
`BufferBitSet()` Creates a `BufferBitSet` with `ResizeBehavior` `ALLOCATE`.
`BufferBitSet(ByteBuffer buffer)` Creates a `BufferBitSet` which wraps the provided buffer.
`BufferBitSet(ByteBuffer buffer, ResizeBehavior resizeBehavior)` Creates a `BufferBitSet` which wraps the provided buffer.
`BufferBitSet(ResizeBehavior resizeBehavior)` Creates a `BufferBitSet` with the specified resize behavior.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`and(BufferBitSet set)` Performs a logical AND of this target bitset with the argument bitset.
`void`	`andNot(BufferBitSet set)` Clears all of the bits in this bitset whose corresponding bit is set in the specified bitset.
`int`	`cardinality()` Returns the number of bits set to `true` in this `BufferBitSet`.
`void`	`clear(int bitIndex)` Sets the bit specified by the index to `false`.
`void`	`clear(int fromIndex, int toIndex)` Sets the bits from the specified `fromIndex` (inclusive) to the specified `toIndex` (exclusive) to `false`.
`boolean`	`equals(Object obj)` Compares this object against the specified object.
`void`	`flip(int bitIndex)` Sets the bit at the specified index to the complement of its current value.
`void`	`flip(int fromIndex, int toIndex)` Sets each bit from the specified `fromIndex` (inclusive) to the specified `toIndex` (exclusive) to the complement of its current value.
`boolean`	`get(int bitIndex)` Returns the value of the bit with the specified index.
`BufferBitSet`	`get(int fromIndex, int toIndex)` Returns a new `BufferBitSet` composed of bits from this bitset from `fromIndex` (inclusive) to `toIndex` (exclusive).
`ByteBuffer`	`getBuffer()` Returns the `ByteBuffer` backing this `BufferBitSet`.
`ResizeBehavior`	`getResizeBehavior()` Returns this bitset's `resize` behavior.
`int`	`hashCode()` Returns the hashcode value for this bitset.
`boolean`	`isEmpty()` Returns true if this `BufferBitSet` contains no bits that are set to `true`.
`int`	`length()` Returns the "logical size" of this bitset: the index of the highest set bit in the bitset plus one.
`int`	`nextClearBit(int fromIndex)` Returns the index of the first bit that is set to `false` that occurs on or after the specified starting index.
`int`	`nextSetBit(int fromIndex)` Returns the index of the first bit that is set to `true` that occurs on or after the specified starting index.
`void`	`or(BufferBitSet set)` Performs a logical OR of this bitset with the bitset argument.
`int`	`previousClearBit(int fromIndex)` Returns the index of the nearest bit that is set to `false` that occurs on or before the specified starting index.
`int`	`previousSetBit(int fromIndex)` Returns the index of the nearest bit that is set to `true` that occurs on or before the specified starting index.
`void`	`set(int bitIndex)` Sets the bit at the specified index to `true`.
`void`	`set(int bitIndex, boolean value)` Sets the bit at the specified index to the specified value.
`void`	`set(int fromIndex, int toIndex)` Sets the bits from the specified `fromIndex` (inclusive) to the specified `toIndex` (exclusive) to `true`.
`void`	`set(int fromIndex, int toIndex, boolean value)` Sets the bits from the specified `fromIndex` (inclusive) to the specified `toIndex` (exclusive) to the specified value.
`BufferBitSet`	`shiftRight(int offset)` Returns a copy of this bitset with each bit shifted right by `offset`.
`int`	`size()` Returns the number of bits of space actually in use by this `BufferBitSet` to represent bit values.
`BitSet`	`toBitSet()` Returns a new `BitSet` containing all of the bits in this `BufferBitSet`.
`byte[]`	`toByteArray()` Returns a new byte array containing all the bits in this bit set.
`String`	`toString()` Returns a string representation of this `BufferBitSet` equivalent to the representation of a `SortedSet` containing the indices of the bits which are set in this bitset.
`static BufferBitSet`	`valueOf(BitSet bs)` Returns a new `BufferBitSet` containing all of the bits in the given `BitSet`.
`static BufferBitSet`	`valueOf(byte[] bytes)` Returns a new bit set containing all of the bits in the given byte array.
`BufferBitSet`	`withResizeBehavior(ResizeBehavior resizeBehavior)` Returns a new `BufferBitSet` with the specified `resize` behavior.
`void`	`xor(BufferBitSet set)` Performs a logical XOR of this bitset with the bitset argument.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - BufferBitSet
```
public BufferBitSet()
```
    Creates a BufferBitSet with ResizeBehavior ALLOCATE.
  - BufferBitSet
```
public BufferBitSet(ResizeBehavior resizeBehavior)
```
    Creates a BufferBitSet with the specified resize behavior.
    
    Parameters:
    
    resizeBehavior - - the ResizeBehavior. If NO_RESIZE is specified then this bitset will always be empty.
    
    Throws:
    
    NullPointerException - if resizeBehavior is null
  - BufferBitSet
```
public BufferBitSet(ByteBuffer buffer)
```
    Creates a BufferBitSet which wraps the provided buffer. This bitset will only make use of the space demarked by Buffer.position() and Buffer.limit(). The provided buffer object will not itself be modified, though the buffer's content can be via writes to this bitset.
    The resize behavior defaults to NO_RESIZE.
    
    Parameters:
    
    buffer - - the ByteBuffer to be wrapped by this bitset. Writes to this bitset will modify the buffer's content.
    
    Throws:
    
    NullPointerException - if the provided buffer is null
  - BufferBitSet
```
public BufferBitSet(ByteBuffer buffer,
                    ResizeBehavior resizeBehavior)
```
    Creates a BufferBitSet which wraps the provided buffer. This bitset will only make use of the space demarked by Buffer.position() and Buffer.limit(). The provided buffer object will not itself be modified, though the buffer's content can be via writes to this bitset.
    
    Parameters:
    
    buffer - - the ByteBuffer to be wrapped by this bitset. Writes to this bitset will modify the buffer's content.
    
    resizeBehavior - - the ResizeBehavior
    
    Throws:
    
    NullPointerException - if the provided buffer or resizeBehavior is null
- Method Detail
  - getBuffer
```
public ByteBuffer getBuffer()
```
    Returns the ByteBuffer backing this BufferBitSet.
    
    Returns:
    
    the ByteBuffer backing this BufferBitSet.
  - getResizeBehavior
```
public ResizeBehavior getResizeBehavior()
```
    Returns this bitset's resize behavior.
    
    Returns:
    
    this bitset's resize behavior.
  - valueOf
```
public static BufferBitSet valueOf(byte[] bytes)
```
    Returns a new bit set containing all of the bits in the given byte array.
    More precisely,
    BufferBitSet.valueOf(bytes).get(n) == ((bytes[n/8] & (1<<(n%8))) != 0)
    for all n < 8 * bytes.length.
    The provided array is wrapped, it is not copied. Writes to this bitset can modify the array.
    
    Parameters:
    
    bytes - - a byte array containing a sequence of bits to be used as the initial bits of the new bit set
    
    Returns:
    
    a BufferBitSet containing all the bits in the byte array, and with resize behavior ALLOCATE.
  - valueOf
```
public static BufferBitSet valueOf(BitSet bs)
```
    Returns a new BufferBitSet containing all of the bits in the given BitSet.
    
    Parameters:
    
    bs - - the bitset to copy
    
    Returns:
    
    a BufferBitSet containing all the bits in the given bitset, with resize behavior ALLOCATE.
  - withResizeBehavior
```
public BufferBitSet withResizeBehavior(ResizeBehavior resizeBehavior)
```
    Returns a new BufferBitSet with the specified resize behavior. The buffer object itself will be duplicated, but will share the underlying space.
    Concurrent modifications to this bitset and the returned bitset can put both into a bad state.
    
    Parameters:
    
    resizeBehavior - - ResizeBehavior
    
    Returns:
    
    a new bitset with the specified resize behavior
  - toByteArray
```
public byte[] toByteArray()
```
    Returns a new byte array containing all the bits in this bit set.
    
    Returns:
    
    a new byte array containing all the bits in this bit set.
  - toBitSet
```
public BitSet toBitSet()
```
    Returns a new BitSet containing all of the bits in this BufferBitSet.
    
    Returns:
    
    a new BitSet containing all of the bits in this BufferBitSet.
  - get
```
public boolean get(int bitIndex)
```
    Returns the value of the bit with the specified index. The value is true if the bit with the index bitIndex is currently set in this bitset; otherwise, the result is false.
    
    Parameters:
    
    bitIndex - the bit index
    
    Returns:
    
    the value of the bit with the specified index
    
    Throws:
    
    IndexOutOfBoundsException - if the specified index is negative
  - get
```
public BufferBitSet get(int fromIndex,
                        int toIndex)
```
    Returns a new BufferBitSet composed of bits from this bitset from fromIndex (inclusive) to toIndex (exclusive).
    The resulting bitset will always be stored in newly allocated space, and will have the same ResizeBehavior as this bitset.
    
    Parameters:
    
    fromIndex - - index of the first bit to include
    
    toIndex - - index after the last bit to include
    
    Returns:
    
    a new bitset from a range of this bitset
    
    Throws:
    
    IndexOutOfBoundsException - if fromIndex is negative, or toIndex is negative, or fromIndex is larger than toIndex
  - set
```
public void set(int bitIndex)
```
    Sets the bit at the specified index to true.
    
    Parameters:
    
    bitIndex - a bit index
    
    Throws:
    
    IndexOutOfBoundsException - if the specified index is negative
  - set
```
public void set(int bitIndex,
                boolean value)
```
    Sets the bit at the specified index to the specified value.
    
    Parameters:
    
    bitIndex - a bit index
    
    value - a boolean value to set
    
    Throws:
    
    IndexOutOfBoundsException - if the specified index is negative
  - set
```
public void set(int fromIndex,
                int toIndex)
```
    Sets the bits from the specified fromIndex (inclusive) to the specified toIndex (exclusive) to true.
    
    Parameters:
    
    fromIndex - index of the first bit to be set
    
    toIndex - index after the last bit to be set
    
    Throws:
    
    IndexOutOfBoundsException - if fromIndex is negative, or toIndex is negative, or fromIndex is larger than toIndex
  - set
```
public void set(int fromIndex,
                int toIndex,
                boolean value)
```
    Sets the bits from the specified fromIndex (inclusive) to the specified toIndex (exclusive) to the specified value.
    
    Parameters:
    
    fromIndex - index of the first bit to be set
    
    toIndex - index after the last bit to be set
    
    value - value to set the selected bits to
    
    Throws:
    
    IndexOutOfBoundsException - if fromIndex is negative, or toIndex is negative, or fromIndex is larger than toIndex
  - flip
```
public void flip(int bitIndex)
```
    Sets the bit at the specified index to the complement of its current value.
    
    Parameters:
    
    bitIndex - the index of the bit to flip
    
    Throws:
    
    IndexOutOfBoundsException - if the specified index is negative
  - flip
```
public void flip(int fromIndex,
                 int toIndex)
```
    Sets each bit from the specified fromIndex (inclusive) to the specified toIndex (exclusive) to the complement of its current value.
    
    Parameters:
    
    fromIndex - index of the first bit to flip
    
    toIndex - index after the last bit to flip
    
    Throws:
    
    IndexOutOfBoundsException - if fromIndex is negative, or toIndex is negative, or fromIndex is larger than toIndex
  - clear
```
public void clear(int bitIndex)
```
    Sets the bit specified by the index to false.
    
    Parameters:
    
    bitIndex - the index of the bit to be cleared
    
    Throws:
    
    IndexOutOfBoundsException - if the specified index is negative
  - clear
```
public void clear(int fromIndex,
                  int toIndex)
```
    Sets the bits from the specified fromIndex (inclusive) to the specified toIndex (exclusive) to false.
    
    Parameters:
    
    fromIndex - index of the first bit to be cleared
    
    toIndex - index after the last bit to be cleared
    
    Throws:
    
    IndexOutOfBoundsException - if fromIndex is negative, or toIndex is negative, or fromIndex is larger than toIndex
  - nextSetBit
```
public int nextSetBit(int fromIndex)
```
    Returns the index of the first bit that is set to true that occurs on or after the specified starting index. If no such bit exists then -1 is returned.
    
    Parameters:
    
    fromIndex - the index to start checking from (inclusive)
    
    Returns:
    
    the index of the next set bit, or -1 if there is no such bit
    
    Throws:
    
    IndexOutOfBoundsException - if the specified index is negative
  - nextClearBit
```
public int nextClearBit(int fromIndex)
```
    Returns the index of the first bit that is set to false that occurs on or after the specified starting index.
    
    Parameters:
    
    fromIndex - the index to start checking from (inclusive)
    
    Returns:
    
    the index of the next clear bit
    
    Throws:
    
    IndexOutOfBoundsException - if the specified index is negative
  - previousSetBit
```
public int previousSetBit(int fromIndex)
```
    Returns the index of the nearest bit that is set to true that occurs on or before the specified starting index. If no such bit exists, or if -1 is given as the starting index, then -1 is returned.
    
    Parameters:
    
    fromIndex - the index to start checking from (inclusive)
    
    Returns:
    
    the index of the previous set bit, or -1 if there is no such bit
    
    Throws:
    
    IndexOutOfBoundsException - if the specified index is less than -1
  - previousClearBit
```
public int previousClearBit(int fromIndex)
```
    Returns the index of the nearest bit that is set to false that occurs on or before the specified starting index. If no such bit exists, or if -1 is given as the starting index, then -1 is returned.
    
    Parameters:
    
    fromIndex - the index to start checking from (inclusive)
    
    Returns:
    
    the index of the previous clear bit, or -1 if there is no such bit
    
    Throws:
    
    IndexOutOfBoundsException - if the specified index is less than -1
  - and
```
public void and(BufferBitSet set)
```
    Performs a logical AND of this target bitset with the argument bitset. This bitset is modified so that each bit in it has the value true if and only if it both initially had the value true and the corresponding bit in the bitset argument also had the value true.
    
    Parameters:
    
    set - - a BufferBitSet
  - or
```
public void or(BufferBitSet set)
```
    Performs a logical OR of this bitset with the bitset argument. This bitset is modified so that a bit in it has the value true if and only if it either already had the value true or the corresponding bit in the bitset argument has the value true.
    
    Parameters:
    
    set - - a BufferBitSet
  - xor
```
public void xor(BufferBitSet set)
```
    Performs a logical XOR of this bitset with the bitset argument. This bitset is modified so that a bit in it has the value true if and only if one of the following statements holds:
    - The bit initially has the value true, and the corresponding bit in the argument has the value false.
    - The bit initially has the value false, and the corresponding bit in the argument has the value true.
    Parameters:
    
    set - - a BufferBitSet
  - andNot
```
public void andNot(BufferBitSet set)
```
    Clears all of the bits in this bitset whose corresponding bit is set in the specified bitset.
    
    Parameters:
    
    set - - the BufferBitSet with which to mask this bitset
  - shiftRight
```
public BufferBitSet shiftRight(int offset)
```
    Returns a copy of this bitset with each bit shifted right by offset. The resulting bitset will always be stored in newly allocated space, and will have the same ResizeBehavior as this bitset.
    
    Parameters:
    
    offset - - number of bits to shift by
    
    Returns:
    
    a new bitset with shifted right by offset
    
    Throws:
    
    IllegalArgumentException - if offset is negative
  - toString
```
public String toString()
```
    Returns a string representation of this BufferBitSet equivalent to the representation of a SortedSet containing the indices of the bits which are set in this bitset.
    
    Overrides:
    
    toString in class Object
  - length
```
public int length()
```
    Returns the "logical size" of this bitset: the index of the highest set bit in the bitset plus one. Returns zero if the bitset contains no set bits.
    
    Returns:
    
    the logical size of this bitset
  - size
```
public int size()
```
    Returns the number of bits of space actually in use by this BufferBitSet to represent bit values. The maximum element that can be set without resizing is size()-1
    
    Returns:
    
    the number of bits of space currently in this bit set
  - isEmpty
```
public boolean isEmpty()
```
    Returns true if this BufferBitSet contains no bits that are set to true.
    
    Returns:
    
    boolean indicating whether this bitset is empty
  - cardinality
```
public int cardinality()
```
    Returns the number of bits set to true in this BufferBitSet.
    
    Returns:
    
    the number of bits set to true in this BufferBitSet
  - hashCode
```
public int hashCode()
```
    Returns the hashcode value for this bitset. The hashcode depends only on which bits are set within this BufferBitSet.
    Hashcode is computed using formula from Arrays.hashCode(byte[])
    
    Overrides:
    
    hashCode in class Object
    
    Returns:
    
    the hashcode value for this bitset
  - equals
```
public boolean equals(Object obj)
```
    Compares this object against the specified object. The result is true if and only if the argument is not null and is a BufferBitset object that has exactly the same set of bits set to true as this bit set. That is, for every nonnegative int index k,
```
 ((BitBufferSet) obj).get(k) == this.get(k)
 
```
    must be true. The current sizes of the two bit sets are not compared.
    Overrides:
    
    equals in class Object
    
    Parameters:
    
    obj - the object to compare with
    
    Returns:
    
    true if the objects are the same; false otherwise

Class BufferBitSet

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

BufferBitSet

BufferBitSet

BufferBitSet

BufferBitSet

Method Detail

getBuffer

getResizeBehavior

valueOf

valueOf

withResizeBehavior

toByteArray

toBitSet

get

get

set

set

set

set

flip

flip

clear

clear

nextSetBit

nextClearBit

previousSetBit

previousClearBit

and

or

xor

andNot

shiftRight

toString

length

size

isEmpty

cardinality

hashCode

equals