ROSE  0.11.145.0
Public Types | Public Member Functions | List of all members
Sawyer::BitFlags< E, V > Class Template Reference

Description

template<typename E, typename V = int64_t>
class Sawyer::BitFlags< E, V >

Stores a vector of enum bit flags.

This is a more self-documenting and terse way to use bit flags. For example, consider this original code:

class TableCharacter {
enum Corner { NONE = 0, LEFT = 1, RIGHT = 2, TOP = 4, BOTTOM = 8 };
unsigned current; // bit vector of Corner flags for current character
unsigned previous; // bit vector of Corner flags for previous character
TableCharacter(): current(NONE), previous(NONE) {}
void process(unsigned next) { // next is vector of Corner bit flags
if ((current & LEFT) != 0) {
previous |= LEFT;
current &= ~LEFT;
}
if ((next & TOP) == 0) {
current &= ~TOP;
current |= BOTTOM;
}
}
};

Now rewritten to use this class:

class TableCharacter {
enum Corner { NONE = 0, LEFT = 1, RIGHT = 2, TOP = 4, BOTTOM = 8 };
BitFlags<Corner> current;
BitFlags<Corner> previous;
TableCharacters(): current(NONE), previous(NONE) {}
void process(BitFlags<Corner> next) {
if (current.testAndClear(LEFT))
previous.set(LEFT);
if (next.isClear(TOP))
current.clear(TOP).set(BOTTOM);
}
};

Definition at line 66 of file util/Sawyer/BitFlags.h.

#include <util/Sawyer/BitFlags.h>

Inheritance diagram for Sawyer::BitFlags< E, V >:
Inheritance graph
[legend]

Public Types

typedef E Enum
 
typedef V Vector
 

Public Member Functions

 BitFlags ()
 Default constructor with all bits clear. More...
 
 BitFlags (Vector v)
 Construct bit vector from value or bit. More...
 
 BitFlags (E e)
 
 BitFlags (const BitFlags &other)
 Copy constructor. More...
 
Vector vector () const
 Current value of the bit vector. More...
 
bool isSet (Enum e) const
 Test whether a bit is set. More...
 
bool isAllSet (BitFlags other) const
 True if all specified bits are set. More...
 
bool isAnySet (BitFlags other) const
 True if any of the specified bits are set. More...
 
bool isAnySet () const
 True if any bit is set. More...
 
bool isEmpty () const
 True if no bits are set. More...
 
bool isClear (Enum e) const
 Test whether a bit is clear. More...
 
BitFlagsset (Enum e)
 Set the specified bit. More...
 
BitFlagsset (BitFlags other)
 Set all bits that are set in other. More...
 
BitFlagsclear (Enum e)
 Clear the specified bit. More...
 
BitFlagsclear (BitFlags other)
 Clear all bits that are set in other. More...
 
BitFlagsclear ()
 Clear all bits. More...
 
bool testAndClear (Enum e)
 Test whether a bit is set, then clear it. More...
 
bool testAndSet (Enum e)
 Test whether a bit is set, then set it. More...
 
BitFlagsoperator= (Vector v)
 Set the vector to an exact value. More...
 
BitFlagsoperator= (BitFlags other)
 Set the vector to the same as another. More...
 
std::vector< Enum > split (std::vector< int64_t > constants, Vector &leftovers) const
 Split a vector into the individual enum values. More...
 
std::vector< Enum > split () const
 Split a vector into the individual bits values. More...
 
BitFlags operator| (BitFlags other) const
 Create a new vector that's the union of two vectors.
 
BitFlags operator| (Enum e) const
 Create a new vector that's the union of two vectors.
 
BitFlags intersection (BitFlags other) const
 Create a new vector that's the intersection of two vectors.
 
BitFlags intersection (Enum e) const
 Create a new vector that's the intersection of two vectors.
 
BitFlags operator& (BitFlags other) const
 Create a new vector that's the intersection of two vectors.
 
BitFlags operator& (Enum e) const
 Create a new vector that's the intersection of two vectors.
 
bool operator== (BitFlags other) const
 Compare two vectors.
 
bool operator!= (BitFlags other) const
 Compare two vectors.
 
bool operator< (BitFlags other) const
 Compare two vectors.
 
bool operator<= (BitFlags other) const
 Compare two vectors.
 
bool operator> (BitFlags other) const
 Compare two vectors.
 
bool operator>= (BitFlags other) const
 Compare two vectors.
 

Constructor & Destructor Documentation

template<typename E, typename V = int64_t>
Sawyer::BitFlags< E, V >::BitFlags ( )
inline

Default constructor with all bits clear.

Definition at line 84 of file util/Sawyer/BitFlags.h.

template<typename E, typename V = int64_t>
Sawyer::BitFlags< E, V >::BitFlags ( Vector  v)
inline

Construct bit vector from value or bit.

Definition at line 88 of file util/Sawyer/BitFlags.h.

template<typename E, typename V = int64_t>
Sawyer::BitFlags< E, V >::BitFlags ( const BitFlags< E, V > &  other)
inline

Copy constructor.

Definition at line 95 of file util/Sawyer/BitFlags.h.

Member Function Documentation

template<typename E, typename V = int64_t>
Vector Sawyer::BitFlags< E, V >::vector ( ) const
inline

Current value of the bit vector.

Definition at line 99 of file util/Sawyer/BitFlags.h.

Referenced by Rose::BitFlags< Reason, uint32_t >::toString().

template<typename E, typename V = int64_t>
bool Sawyer::BitFlags< E, V >::isSet ( Enum  e) const
inline
template<typename E, typename V = int64_t>
bool Sawyer::BitFlags< E, V >::isAllSet ( BitFlags< E, V >  other) const
inline

True if all specified bits are set.

Definition at line 109 of file util/Sawyer/BitFlags.h.

template<typename E, typename V = int64_t>
bool Sawyer::BitFlags< E, V >::isAnySet ( BitFlags< E, V >  other) const
inline

True if any of the specified bits are set.

Definition at line 114 of file util/Sawyer/BitFlags.h.

template<typename E, typename V = int64_t>
bool Sawyer::BitFlags< E, V >::isAnySet ( ) const
inline

True if any bit is set.

Definition at line 119 of file util/Sawyer/BitFlags.h.

template<typename E, typename V = int64_t>
bool Sawyer::BitFlags< E, V >::isEmpty ( ) const
inline

True if no bits are set.

Definition at line 124 of file util/Sawyer/BitFlags.h.

template<typename E, typename V = int64_t>
bool Sawyer::BitFlags< E, V >::isClear ( Enum  e) const
inline

Test whether a bit is clear.

Definition at line 129 of file util/Sawyer/BitFlags.h.

Referenced by Rose::BinaryAnalysis::Debugger::Base::trace().

template<typename E, typename V = int64_t>
BitFlags& Sawyer::BitFlags< E, V >::set ( Enum  e)
inline

Set the specified bit.

Definition at line 134 of file util/Sawyer/BitFlags.h.

Referenced by Sawyer::BitFlags< Reason, uint32_t >::testAndSet().

template<typename E, typename V = int64_t>
BitFlags& Sawyer::BitFlags< E, V >::set ( BitFlags< E, V >  other)
inline

Set all bits that are set in other.

Definition at line 140 of file util/Sawyer/BitFlags.h.

template<typename E, typename V = int64_t>
BitFlags& Sawyer::BitFlags< E, V >::clear ( Enum  e)
inline

Clear the specified bit.

Definition at line 146 of file util/Sawyer/BitFlags.h.

template<typename E, typename V = int64_t>
BitFlags& Sawyer::BitFlags< E, V >::clear ( BitFlags< E, V >  other)
inline

Clear all bits that are set in other.

Definition at line 152 of file util/Sawyer/BitFlags.h.

template<typename E, typename V = int64_t>
BitFlags& Sawyer::BitFlags< E, V >::clear ( )
inline

Clear all bits.

Definition at line 158 of file util/Sawyer/BitFlags.h.

Referenced by Sawyer::BitFlags< Reason, uint32_t >::testAndClear().

template<typename E, typename V = int64_t>
bool Sawyer::BitFlags< E, V >::testAndClear ( Enum  e)
inline

Test whether a bit is set, then clear it.

Definition at line 164 of file util/Sawyer/BitFlags.h.

template<typename E, typename V = int64_t>
bool Sawyer::BitFlags< E, V >::testAndSet ( Enum  e)
inline

Test whether a bit is set, then set it.

Definition at line 171 of file util/Sawyer/BitFlags.h.

template<typename E, typename V = int64_t>
BitFlags& Sawyer::BitFlags< E, V >::operator= ( Vector  v)
inline

Set the vector to an exact value.

Definition at line 178 of file util/Sawyer/BitFlags.h.

template<typename E, typename V = int64_t>
BitFlags& Sawyer::BitFlags< E, V >::operator= ( BitFlags< E, V >  other)
inline

Set the vector to the same as another.

Definition at line 184 of file util/Sawyer/BitFlags.h.

template<typename E, typename V = int64_t>
std::vector<Enum> Sawyer::BitFlags< E, V >::split ( std::vector< int64_t >  constants,
Vector &  leftovers 
) const
inline

Split a vector into the individual enum values.

The enum constants are first sorted so that those with more set bits appear before those with fewer bits. Then each constant is searched in the bit vector and those bits are removed. This continues until either no bits remain or no matching constant is found. The leftovers is set to those bits that could not be matched by this process.

Definition at line 245 of file util/Sawyer/BitFlags.h.

template<typename E, typename V = int64_t>
std::vector<Enum> Sawyer::BitFlags< E, V >::split ( ) const
inline

Split a vector into the individual bits values.

Definition at line 268 of file util/Sawyer/BitFlags.h.

Referenced by Rose::BitFlags< Reason, uint32_t >::toString().


The documentation for this class was generated from the following file: