SingleThreadedFlatBitSetFrame (OpenHFT/Chronicle-Algorithms 2.23ea0 API)

java.lang.Object
- net.openhft.chronicle.algo.bitset.SingleThreadedFlatBitSetFrame

All Implemented Interfaces:

BitSetFrame
```
public final class SingleThreadedFlatBitSetFrame
extends Object
implements BitSetFrame
```
DirectBitSet with input validations, This class is not thread safe

Nested Class Summary
- Nested classes/interfaces inherited from interface net.openhft.chronicle.algo.bitset.BitSetFrame
  BitSetFrame.Bits

Field Summary

Fields
Modifier and Type Field and Description

static long ALL_ONES
- Fields inherited from interface net.openhft.chronicle.algo.bitset.BitSetFrame
  NOT_FOUND

Fields
Modifier and Type	Field and Description
`static long`	`ALL_ONES`

Constructor Summary

Constructors
Constructor and Description

SingleThreadedFlatBitSetFrame(long logicalSize)
Creates a new SingleThreadedFlatBitSetFrame of the given logical size

Constructors
Constructor and Description
`SingleThreadedFlatBitSetFrame(long logicalSize)` Creates a new `SingleThreadedFlatBitSetFrame` of the given logical size

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`BitSetAlgorithm`	`algorithm()`
`<T> long`	`cardinality(Access<T> access, T handle, long offset)` Returns the number of bits set to `true` in the bit set.
`<T> void`	`clear(Access<T> access, T handle, long offset, long bitIndex)` Sets the bit specified by the index to `false`.
`<T> void`	`clearAll(Access<T> access, T handle, long offset)` Equivalent to `clearRange(0, logicalSize())`.
`<T> boolean`	`clearIfSet(Access<T> access, T handle, long offset, long bitIndex)` Clears the bit at the specified index (sets it to `false`).
`<T> long`	`clearNextNContinuousSetBits(Access<T> access, T handle, long offset, long fromIndex, int numberOfBits)` Finds the next `numberOfBits` consecutive bits set to `true`, starting from the specified `fromIndex`.
`<T> long`	`clearNextSetBit(Access<T> access, T handle, long offset, long fromIndex)` Finds and clears the first bit that is set to `true` that occurs on or after the specified starting index.
`<T> long`	`clearPreviousNContinuousSetBits(Access<T> access, T handle, long offset, long fromIndex, int numberOfBits)` Finds the previous `numberOfBits` consecutive bits set to `true`, starting from the specified `fromIndex`.
`<T> long`	`clearPreviousSetBit(Access<T> access, T handle, long offset, long fromIndex)` Finds and clears the nearest bit that is set to `true` that occurs on or before the specified starting index.
`<T> void`	`clearRange(Access<T> access, T handle, long offset, long fromIndex, long exclusiveToIndex)` Sets the bits from the specified `fromIndex` (inclusive) to the specified `toIndex` (exclusive) to `false`.
`<T> void`	`flip(Access<T> access, T handle, long offset, long bitIndex)` Sets the bit at the specified index to the complement of its current value.
`<T> void`	`flipRange(Access<T> access, T handle, long offset, long fromIndex, long exclusiveToIndex)` Sets each bit from the specified `fromIndex` (inclusive) to the specified `toIndex` (exclusive) to the complement of its current value.
`<T> boolean`	`get(Access<T> access, T handle, long offset, long bitIndex)` Returns the value of the bit with the specified index.
`<T> boolean`	`isRangeClear(Access<T> access, T handle, long offset, long fromIndex, long exclusiveToIndex)` Checks if each bit from the specified `fromIndex` (inclusive) to the specified `exclusiveToIndex` is set to `false`.
`<T> boolean`	`isRangeSet(Access<T> access, T handle, long offset, long fromIndex, long exclusiveToIndex)` Checks if each bit from the specified `fromIndex` (inclusive) to the specified `exclusiveToIndex` is set to `true`.
`long`	`logicalSize()` Number of bits in this frame.
`<T> long`	`nextClearBit(Access<T> access, T handle, long offset, long fromIndex)` Returns the index of the first bit that is set to `false` that occurs on or after the specified starting index.
`<T> long`	`nextSetBit(Access<T> access, T handle, long offset, long fromIndex)` Returns the index of the first bit that is set to `true` that occurs on or after the specified starting index.
`<T> long`	`previousClearBit(Access<T> access, T handle, long offset, long fromIndex)` Returns the index of the nearest bit that is set to `false` that occurs on or before the specified starting index.
`<T> long`	`previousSetBit(Access<T> access, T handle, long offset, long fromIndex)` Returns the index of the nearest bit that is set to `true` that occurs on or before the specified starting index.
`<T> void`	`set(Access<T> access, T handle, long offset, long bitIndex)` Sets the bit at the specified index to `true`.
`<T> void`	`setAll(Access<T> access, T handle, long offset)` Equivalent to `setRange(0, logicalSize())`.
`BitSetFrame.Bits`	`setBits()` Returns an iteration of set bits in direct order (from 0 to the end of the bit set).
`<T> boolean`	`setIfClear(Access<T> access, T handle, long offset, long bitIndex)` Sets the bit at the specified index to `true`.
`<T> long`	`setNextClearBit(Access<T> access, T handle, long offset, long fromIndex)` Finds and sets to `true` the first bit that is set to `false` that occurs on or after the specified starting index.
`<T> long`	`setNextNContinuousClearBits(Access<T> access, T handle, long offset, long fromIndex, int numberOfBits)` Finds the next `numberOfBits` consecutive bits set to `false`, starting from the specified `fromIndex`.
`<T> long`	`setPreviousClearBit(Access<T> access, T handle, long offset, long fromIndex)` Finds and sets to `true` the nearest bit that is set to `false` that occurs on or before the specified starting index.
`<T> long`	`setPreviousNContinuousClearBits(Access<T> access, T handle, long offset, long fromIndex, int numberOfBits)` Finds the previous `numberOfBits` consecutive bits set to `false`, starting from the specified `fromIndex`.
`<T> void`	`setRange(Access<T> access, T handle, long offset, long fromIndex, long exclusiveToIndex)` Sets the bits from the specified `fromIndex` (inclusive) to the specified `toIndex` (exclusive) to `true`.
`long`	`sizeInBytes()` Number of bytes taken by this frame.

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

Methods inherited from interface net.openhft.chronicle.algo.bitset.BitSetFrame
isClear, isSet, set, setRange

- Field Detail
  - ALL_ONES
```
public static final long ALL_ONES
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - SingleThreadedFlatBitSetFrame
```
public SingleThreadedFlatBitSetFrame(long logicalSize)
```
    Creates a new SingleThreadedFlatBitSetFrame of the given logical size
    
    Parameters:
    
    logicalSize - the logical bit set size, should be long-aligned (i. e. a multiple of 8)
    
    Throws:
    
    IllegalArgumentException - is the given logicalSize is not a multiple of 8 or non-positive
- Method Detail
  - flip
```
public <T> void flip(Access<T> access,
                     T handle,
                     long offset,
                     long bitIndex)
```
    Description copied from interface: BitSetFrame
    
    Sets the bit at the specified index to the complement of its current value.
    
    Specified by:
    
    flip in interface BitSetFrame
    
    bitIndex - the index of the bit to flip
  - flipRange
```
public <T> void flipRange(Access<T> access,
                          T handle,
                          long offset,
                          long fromIndex,
                          long exclusiveToIndex)
```
    Description copied from interface: BitSetFrame
    
    Sets each bit from the specified fromIndex (inclusive) to the specified toIndex (exclusive) to the complement of its current value.
    
    Specified by:
    
    flipRange in interface BitSetFrame
    
    fromIndex - index of the first bit to flip
    
    exclusiveToIndex - index after the last bit to flip
  - set
```
public <T> void set(Access<T> access,
                    T handle,
                    long offset,
                    long bitIndex)
```
    Description copied from interface: BitSetFrame
    
    Sets the bit at the specified index to true.
    
    Specified by:
    
    set in interface BitSetFrame
    
    bitIndex - the bit index
  - setIfClear
```
public <T> boolean setIfClear(Access<T> access,
                              T handle,
                              long offset,
                              long bitIndex)
```
    Description copied from interface: BitSetFrame
    
    Sets the bit at the specified index to true.
    
    Specified by:
    
    setIfClear in interface BitSetFrame
    
    bitIndex - the bit index
    
    Returns:
    
    true if the bit was zeroOut, or false if the bit was already set
  - setRange
```
public <T> void setRange(Access<T> access,
                         T handle,
                         long offset,
                         long fromIndex,
                         long exclusiveToIndex)
```
    Description copied from interface: BitSetFrame
    
    Sets the bits from the specified fromIndex (inclusive) to the specified toIndex (exclusive) to true.
    
    Specified by:
    
    setRange in interface BitSetFrame
    
    fromIndex - index of the first bit to be set
    
    exclusiveToIndex - index after the last bit to be set
  - setAll
```
public <T> void setAll(Access<T> access,
                       T handle,
                       long offset)
```
    Description copied from interface: BitSetFrame
    
    Equivalent to setRange(0, logicalSize()).
    
    Specified by:
    
    setAll in interface BitSetFrame
  - clear
```
public <T> void clear(Access<T> access,
                      T handle,
                      long offset,
                      long bitIndex)
```
    Description copied from interface: BitSetFrame
    
    Sets the bit specified by the index to false.
    
    Specified by:
    
    clear in interface BitSetFrame
    
    bitIndex - the index of the bit to be cleared
  - clearIfSet
```
public <T> boolean clearIfSet(Access<T> access,
                              T handle,
                              long offset,
                              long bitIndex)
```
    Description copied from interface: BitSetFrame
    
    Clears the bit at the specified index (sets it to false).
    
    Specified by:
    
    clearIfSet in interface BitSetFrame
    
    bitIndex - a bit index
    
    Returns:
    
    the previous value of the bit at the specified index
  - clearRange
```
public <T> void clearRange(Access<T> access,
                           T handle,
                           long offset,
                           long fromIndex,
                           long exclusiveToIndex)
```
    Description copied from interface: BitSetFrame
    
    Sets the bits from the specified fromIndex (inclusive) to the specified toIndex (exclusive) to false.
    
    Specified by:
    
    clearRange in interface BitSetFrame
    
    fromIndex - index of the first bit to be cleared
    
    exclusiveToIndex - index after the last bit to be cleared
  - isRangeSet
```
public <T> boolean isRangeSet(Access<T> access,
                              T handle,
                              long offset,
                              long fromIndex,
                              long exclusiveToIndex)
```
    Description copied from interface: BitSetFrame
    
    Checks if each bit from the specified fromIndex (inclusive) to the specified exclusiveToIndex is set to true.
    
    Specified by:
    
    isRangeSet in interface BitSetFrame
    
    fromIndex - index of the first bit to check
    
    exclusiveToIndex - index after the last bit to check
    
    Returns:
    
    true if all bits in the specified range are set to true, false otherwise
  - isRangeClear
```
public <T> boolean isRangeClear(Access<T> access,
                                T handle,
                                long offset,
                                long fromIndex,
                                long exclusiveToIndex)
```
    Description copied from interface: BitSetFrame
    
    Checks if each bit from the specified fromIndex (inclusive) to the specified exclusiveToIndex is set to false.
    
    Specified by:
    
    isRangeClear in interface BitSetFrame
    
    fromIndex - index of the first bit to check
    
    exclusiveToIndex - index after the last bit to check
    
    Returns:
    
    true if all bits in the specified range are set to false, false otherwise
  - clearAll
```
public <T> void clearAll(Access<T> access,
                         T handle,
                         long offset)
```
    Description copied from interface: BitSetFrame
    
    Equivalent to clearRange(0, logicalSize()).
    
    Specified by:
    
    clearAll in interface BitSetFrame
  - get
```
public <T> boolean get(Access<T> access,
                       T handle,
                       long offset,
                       long bitIndex)
```
    Description copied from interface: BitSetFrame
    
    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 DirectBitSet; otherwise, the result is false.
    
    Specified by:
    
    get in interface BitSetFrame
    
    bitIndex - the bit index
    
    Returns:
    
    the value of the bit with the specified index
  - nextSetBit
```
public <T> long nextSetBit(Access<T> access,
                           T handle,
                           long offset,
                           long fromIndex)
```
    Description copied from interface: BitSetFrame
    
    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.
    
    Specified by:
    
    nextSetBit in interface BitSetFrame
    
    fromIndex - the index to start checking from (inclusive)
    
    Returns:
    
    the index of the next set bit, or -1 if there is no such bit
    
    See Also:
    
    BitSetFrame.clearNextSetBit(net.openhft.chronicle.algo.bytes.Access<T>, T, long, long)
  - setBits
```
public BitSetFrame.Bits setBits()
```
    Description copied from interface: BitSetFrame
    
    Returns an iteration of set bits in direct order (from 0 to the end of the bit set).
    
    Specified by:
    
    setBits in interface BitSetFrame
    
    Returns:
    
    an iteration of set bits in direct order
  - algorithm
```
public BitSetAlgorithm algorithm()
```
    Specified by:
    
    algorithm in interface BitSetFrame
  - clearNextSetBit
```
public <T> long clearNextSetBit(Access<T> access,
                                T handle,
                                long offset,
                                long fromIndex)
```
    Description copied from interface: BitSetFrame
    
    Finds and clears 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.
    
    Specified by:
    
    clearNextSetBit in interface BitSetFrame
    
    fromIndex - the index to start checking from (inclusive)
    
    Returns:
    
    the index of the next set bit, or -1 if there is no such bit
    
    See Also:
    
    BitSetFrame.nextSetBit(net.openhft.chronicle.algo.bytes.Access<T>, T, long, long)
  - nextClearBit
```
public <T> long nextClearBit(Access<T> access,
                             T handle,
                             long offset,
                             long fromIndex)
```
    Description copied from interface: BitSetFrame
    
    Returns the index of the first bit that is set to false that occurs on or after the specified starting index. If no such bit exists then -1 is returned.
    
    Specified by:
    
    nextClearBit in interface BitSetFrame
    
    fromIndex - the index to start checking from (inclusive)
    
    Returns:
    
    the index of the next zeroOut bit, or -1 if there is no such bit
    
    See Also:
    
    BitSetFrame.setNextClearBit(net.openhft.chronicle.algo.bytes.Access<T>, T, long, long)
  - setNextClearBit
```
public <T> long setNextClearBit(Access<T> access,
                                T handle,
                                long offset,
                                long fromIndex)
```
    Description copied from interface: BitSetFrame
    
    Finds and sets to true the first bit that is set to false that occurs on or after the specified starting index. If no such bit exists then -1 is returned.
    
    Specified by:
    
    setNextClearBit in interface BitSetFrame
    
    fromIndex - the index to start checking from (inclusive)
    
    Returns:
    
    the index of the next zeroOut bit, or -1 if there is no such bit
    
    See Also:
    
    BitSetFrame.nextClearBit(net.openhft.chronicle.algo.bytes.Access<T>, T, long, long)
  - previousSetBit
```
public <T> long previousSetBit(Access<T> access,
                               T handle,
                               long offset,
                               long fromIndex)
```
    Description copied from interface: BitSetFrame
    
    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.
    
    Specified by:
    
    previousSetBit in interface BitSetFrame
    
    fromIndex - the index to start checking from (inclusive)
    
    Returns:
    
    the index of the previous set bit, or -1 if there is no such bit
    
    See Also:
    
    BitSetFrame.clearPreviousSetBit(net.openhft.chronicle.algo.bytes.Access<T>, T, long, long)
  - clearPreviousSetBit
```
public <T> long clearPreviousSetBit(Access<T> access,
                                    T handle,
                                    long offset,
                                    long fromIndex)
```
    Description copied from interface: BitSetFrame
    
    Finds and clears 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.
    
    Specified by:
    
    clearPreviousSetBit in interface BitSetFrame
    
    fromIndex - the index to start checking from (inclusive)
    
    Returns:
    
    the index of the previous set bit, or -1 if there is no such bit
    
    See Also:
    
    BitSetFrame.previousSetBit(net.openhft.chronicle.algo.bytes.Access<T>, T, long, long)
  - previousClearBit
```
public <T> long previousClearBit(Access<T> access,
                                 T handle,
                                 long offset,
                                 long fromIndex)
```
    Description copied from interface: BitSetFrame
    
    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.
    
    Specified by:
    
    previousClearBit in interface BitSetFrame
    
    fromIndex - the index to start checking from (inclusive)
    
    Returns:
    
    the index of the previous zeroOut bit, or -1 if there is no such bit
    
    See Also:
    
    BitSetFrame.setPreviousClearBit(net.openhft.chronicle.algo.bytes.Access<T>, T, long, long)
  - setPreviousClearBit
```
public <T> long setPreviousClearBit(Access<T> access,
                                    T handle,
                                    long offset,
                                    long fromIndex)
```
    Description copied from interface: BitSetFrame
    
    Finds and sets to true 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.
    
    Specified by:
    
    setPreviousClearBit in interface BitSetFrame
    
    fromIndex - the index to start checking from (inclusive)
    
    Returns:
    
    the index of the previous zeroOut bit, or -1 if there is no such bit
    
    See Also:
    
    BitSetFrame.previousClearBit(net.openhft.chronicle.algo.bytes.Access<T>, T, long, long)
  - logicalSize
```
public long logicalSize()
```
    Description copied from interface: BitSetFrame
    
    Number of bits in this frame. The index of the last bit in the set eligible to be set or zeroOut is logicalSize() - 1.
    
    Specified by:
    
    logicalSize in interface BitSetFrame
    
    Returns:
    
    the number of bits in this bit set
  - sizeInBytes
```
public long sizeInBytes()
```
    Description copied from interface: BitSetFrame
    
    Number of bytes taken by this frame.
    
    Specified by:
    
    sizeInBytes in interface BitSetFrame
  - cardinality
```
public <T> long cardinality(Access<T> access,
                            T handle,
                            long offset)
```
    Description copied from interface: BitSetFrame
    
    Returns the number of bits set to true in the bit set.
    
    Specified by:
    
    cardinality in interface BitSetFrame
  - setNextNContinuousClearBits
```
public <T> long setNextNContinuousClearBits(Access<T> access,
                                            T handle,
                                            long offset,
                                            long fromIndex,
                                            int numberOfBits)
```
    Description copied from interface: BitSetFrame
    
    Finds the next numberOfBits consecutive bits set to false, starting from the specified fromIndex. Then all bits of the found range are set to true. The first index of the found block is returned. If there is no such range of clear bits, -1 is returned.
    fromIndex could be the first index of the found range, thus setNextNContinuousClearBits(i, 1) is exact equivalent of setNextClearBit(i).
    
    Specified by:
    
    setNextNContinuousClearBits in interface BitSetFrame
    
    fromIndex - the index to start checking from (inclusive)
    
    numberOfBits - how many continuous clear bits to search and set
    
    Returns:
    
    the index of the first bit in the found range of clear bits, or -1 if there is no such range
    
    Throws:
    
    IllegalArgumentException - if numberOfBits is negative
  - clearNextNContinuousSetBits
```
public <T> long clearNextNContinuousSetBits(Access<T> access,
                                            T handle,
                                            long offset,
                                            long fromIndex,
                                            int numberOfBits)
```
    Description copied from interface: BitSetFrame
    
    Finds the next numberOfBits consecutive bits set to true, starting from the specified fromIndex. Then all bits of the found range are set to false. The first index of the found block is returned. If there is no such range of true bits, -1 is returned.
    fromIndex could be the first index of the found range, thus clearNextNContinuousSetBits(i, 1) is exact equivalent of clearNextSetBit(i).
    
    Specified by:
    
    clearNextNContinuousSetBits in interface BitSetFrame
    
    fromIndex - the index to start checking from (inclusive)
    
    numberOfBits - how many continuous set bits to search and clear
    
    Returns:
    
    the index of the first bit in the found range of true bits, or -1 if there is no such range
    
    Throws:
    
    IllegalArgumentException - if numberOfBits is out of range 0 < numberOfBits && numberOfBits <= 64
  - setPreviousNContinuousClearBits
```
public <T> long setPreviousNContinuousClearBits(Access<T> access,
                                                T handle,
                                                long offset,
                                                long fromIndex,
                                                int numberOfBits)
```
    Description copied from interface: BitSetFrame
    
    Finds the previous numberOfBits consecutive bits set to false, starting from the specified fromIndex. Then all bits of the found range are set to true. The first index of the found block is returned. If there is no such range of clear bits, or if -1 is given as the starting index, -1 is returned.
    fromIndex could be the last index of the found range, thus setPreviousNContinuousClearBits(i, 1) is exact equivalent of setPreviousClearBit(i).
    
    Specified by:
    
    setPreviousNContinuousClearBits in interface BitSetFrame
    
    fromIndex - the index to start checking from (inclusive)
    
    numberOfBits - how many continuous clear bits to search and set
    
    Returns:
    
    the index of the first bit in the found range of clear bits, or -1 if there is no such range
  - clearPreviousNContinuousSetBits
```
public <T> long clearPreviousNContinuousSetBits(Access<T> access,
                                                T handle,
                                                long offset,
                                                long fromIndex,
                                                int numberOfBits)
```
    Description copied from interface: BitSetFrame
    
    Finds the previous numberOfBits consecutive bits set to true, starting from the specified fromIndex. Then all bits of the found range are set to false. The first index of the found block is returned. If there is no such range of true bits, or if -1 is given as the starting index, -1 is returned.
    fromIndex could be the last index of the found range, thus clearPreviousNContinuousSetBits(i, 1) is exact equivalent of clearPreviousSetBit(i).
    
    Specified by:
    
    clearPreviousNContinuousSetBits in interface BitSetFrame
    
    fromIndex - the index to start checking from (inclusive)
    
    numberOfBits - how many continuous set bits to search and clear
    
    Returns:
    
    the index of the first bit in the found range of true bits, or -1 if there is no such range

Class SingleThreadedFlatBitSetFrame

Nested Class Summary

Nested classes/interfaces inherited from interface net.openhft.chronicle.algo.bitset.BitSetFrame

Field Summary

Fields inherited from interface net.openhft.chronicle.algo.bitset.BitSetFrame

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface net.openhft.chronicle.algo.bitset.BitSetFrame

Field Detail

ALL_ONES

Constructor Detail

SingleThreadedFlatBitSetFrame

Method Detail

flip

flipRange

set

setIfClear

setRange

setAll

clear

clearIfSet

clearRange

isRangeSet

isRangeClear

clearAll

get

nextSetBit

setBits

algorithm

clearNextSetBit

nextClearBit

setNextClearBit

previousSetBit

clearPreviousSetBit

previousClearBit

setPreviousClearBit

logicalSize

sizeInBytes

cardinality

setNextNContinuousClearBits

clearNextNContinuousSetBits

setPreviousNContinuousClearBits

clearPreviousNContinuousSetBits