SECBitArray Class

class SECBitArray

The SECBitArray class implements a boolean array utilizing the individual bits of a DWORD array to represent each boolean value in the array.

Defined in: SECBitmapArray.h

Comments

To use the SECBitArray class, create an instance of the class, passing the number of bit elements in the array to the constructor. All of the elements are initially set to FALSE. To set or get the value of a particular bit, call  SetBit and  GetBit.

Developer Notes

SECBitArray is not a growable array class. The size of the array is set at construction and remains fixed throughout the lifetime of the object.

Class Template Arguments

ArraySize_T

The maximum number of bits for the array.

DataType_T

The data type used to make up the array (e.g., DWORD, etc.)

Class Members

Creation / initialization

SECBitArray()

Constructor.

Public attributes

static unsigned int  GetUpperBound()

The upper bound of the bit array.

static unsigned int  GetBitStorageElementCount()

The number of elements in the array of data elements that house the bits.

static unsigned int  GetBitsPerDataType()

The number of bits per DataType element.

virtual BOOL  GetBit(unsigned int nBit) const

Retrieves the value of a specific bit in the array.

virtual void  SetBit(unsigned int nBit, BOOL bSet = TRUE)

Sets the state of a specific bit in the array.

BOOL  GetArrayBitStates(BOOL bAllSet = FALSE) const

Tests if all bits in the array are set identically.

void  ConvertFromChars(LPCTSTR lpszChars)

Set bits that correspond to the given set of characters.

void  ConvertToChars(CString& strChars) const

Interpret the bit array as character set flags.

void  SetBits(BOOL bSet)

Clears or sets all bits in the array.

Protected attributes

DataType_T  BitArray[SECBITARRAY_ELEMENTS(ArraySize_T,DataType_T)]

The array of data elements that house the bits for the bit array