Struct NativeBitArray.ReadOnly

A read-only alias for the value of a UnsafeBitArray. Does not have its own allocated storage.

Namespace: Unity.Collections

Syntax

[NativeContainer]
[NativeContainerIsReadOnly]
public struct ReadOnly

Properties

Length

Returns the number of bits.

Declaration

public readonly int Length { get; }

Property Value

Type	Description
Int32	The number of bits.

Methods

CountBits(Int32, Int32)

Returns the number of bits in a range that are 1.

Declaration

public int CountBits(int pos, int numBits = 1)

Parameters

Type	Name	Description
Int32	pos	Index of the bit at which to start searching.
Int32	numBits	Number of bits to test. Defaults to 1.

Returns

Type	Description
Int32	The number of bits in a range of bits that are 1.

Exceptions

Type	Condition
ArgumentException	Thrown if pos is out of bounds or numBits is less than 1.

Find(Int32, Int32)

Finds the first length-N contiguous sequence of 0 bits in this bit array.

Declaration

public int Find(int pos, int numBits)

Parameters

Type	Name	Description
Int32	pos	Index at which to start searching.
Int32	numBits	Number of contiguous 0 bits to look for.

Returns

Type	Description
Int32	The index in this array where the sequence is found. The index will be greater than or equal to pos. Returns -1 if no occurrence is found.

Find(Int32, Int32, Int32)

Finds the first length-N contiguous sequence of 0 bits in this bit array. Searches only a subsection.

Declaration

public int Find(int pos, int count, int numBits)

Parameters

Type	Name	Description
Int32	pos	Index at which to start searching.
Int32	count	Number of bits to search.
Int32	numBits	Number of contiguous 0 bits to look for.

Returns

Type	Description
Int32	The index in this array where the sequence is found. The index will be greater than or equal to pos but less than pos + count. Returns -1 if no occurrence is found.

GetBits(Int32, Int32)

Returns a ulong which has bits copied from this array.

Declaration

public ulong GetBits(int pos, int numBits = 1)

Parameters

Type	Name	Description
Int32	pos	Index of the first bit to get.
Int32	numBits	Number of bits to get (must be between 1 and 64).

Returns

Type	Description
UInt64	A ulong which has bits copied from this array.

Remarks

The source bits in this array run from index pos up to (but not including) pos + numBits. No exception is thrown if pos + numBits exceeds the length.

The first source bit is copied to the lowest bit of the ulong; the second source bit is copied to the second-lowest bit of the ulong; and so forth. Any remaining bits in the ulong will be 0.

Exceptions

Type	Condition
ArgumentException	Thrown if pos is out of bounds or if numBits is not between 1 and 64.

IsSet(Int32)

Returns true if the bit at an index is 1.

Declaration

public bool IsSet(int pos)

Parameters

Type	Name	Description
Int32	pos	Index of the bit to test.

Returns

Type	Description
Boolean	True if the bit at the index is 1.

Exceptions

Type	Condition
ArgumentException	Thrown if pos is out of bounds.