Open CASCADE Technology
6.9.0
|
A bit map simply allows to associate a boolean flag to each item of a list, such as a list of entities, etc... numbered between 1 and a positive count nbitems. More...
#include <Interface_BitMap.hxx>
Public Member Functions | |
Interface_BitMap () | |
Creates a empty BitMap. More... | |
Interface_BitMap (const Standard_Integer nbitems, const Standard_Integer resflags=0) | |
Creates a BitMap for <nbitems> items One flag is defined, n0 0 <resflags> prepares allocation for <resflags> more flags Flags values start at false. More... | |
void | Initialize (const Standard_Integer nbitems, const Standard_Integer resflags=0) |
Initialize empty bit by <nbitems> items One flag is defined, n0 0 <resflags> prepares allocation for <resflags> more flags Flags values start at false. More... | |
Interface_BitMap (const Interface_BitMap &other, const Standard_Boolean copied=Standard_False) | |
Creates a BitMap from another one if <copied> is True, copies data else, data are not copied, only the header object is. More... | |
void | Initialize (const Interface_BitMap &other, const Standard_Boolean copied=Standard_False) |
Initialize a BitMap from another one. More... | |
void | Internals (Standard_Integer &nbitems, Standard_Integer &nbwords, Standard_Integer &nbflags, Handle< TColStd_HArray1OfInteger > &flags, Handle< TColStd_HSequenceOfAsciiString > &names) const |
Returns internal values, used for copying Flags values start at false. More... | |
void | Reservate (const Standard_Integer moreflags) |
Reservates for a count of more flags. More... | |
void | SetLength (const Standard_Integer nbitems) |
Sets for a new count of items, which can be either less or greater than the former one For new items, their flags start at false. More... | |
Standard_Integer | AddFlag (const Standard_CString name="") |
Adds a flag, a name can be attached to it Returns its flag number Makes required reservation. More... | |
Standard_Integer | AddSomeFlags (const Standard_Integer more) |
Adds several flags (<more>) with no name Returns the number of last added flag. More... | |
Standard_Boolean | RemoveFlag (const Standard_Integer num) |
Removes a flag given its number. Returns True if done, false if num is out of range. More... | |
Standard_Boolean | SetFlagName (const Standard_Integer num, const Standard_CString name) |
Sets a name for a flag, given its number name can be empty (to erase the name of a flag) Returns True if done, false if : num is out of range, or name non-empty already set to another flag. More... | |
Standard_Integer | NbFlags () const |
Returns the count of flags (flag 0 not included) More... | |
Standard_Integer | Length () const |
Returns the count of items (i.e. the length of the bitmap) More... | |
Standard_CString | FlagName (const Standard_Integer num) const |
Returns the name recorded for a flag, or an empty string. More... | |
Standard_Integer | FlagNumber (const Standard_CString name) const |
Returns the number or a flag given its name, or zero. More... | |
Standard_Boolean | Value (const Standard_Integer item, const Standard_Integer flag=0) const |
Returns the value (true/false) of a flag, from : More... | |
void | SetValue (const Standard_Integer item, const Standard_Boolean val, const Standard_Integer flag=0) const |
Sets a new value for a flag. More... | |
void | SetTrue (const Standard_Integer item, const Standard_Integer flag=0) const |
Sets a flag to True. More... | |
void | SetFalse (const Standard_Integer item, const Standard_Integer flag=0) const |
Sets a flag to False. More... | |
Standard_Boolean | CTrue (const Standard_Integer item, const Standard_Integer flag=0) const |
Returns the former value for a flag and sets it to True (before : value returned; after : True) More... | |
Standard_Boolean | CFalse (const Standard_Integer item, const Standard_Integer flag=0) const |
Returns the former value for a flag and sets it to False (before : value returned; after : False) More... | |
void | Init (const Standard_Boolean val, const Standard_Integer flag=0) const |
Initialises all the values of Flag Number <flag> to a given value <val> More... | |
void | Clear () |
Clear all field of bit map. More... | |
A bit map simply allows to associate a boolean flag to each item of a list, such as a list of entities, etc... numbered between 1 and a positive count nbitems.
The BitMap class allows to associate several binary flags, each of one is identified by a number from 0 to a count which can remain at zero or be positive : nbflags
Flags lists over than numflag=0 are added after creation Each of one can be named, hence the user can identify it either by its flag number or by a name which gives a flag n0 (flag n0 0 has no name)
Interface_BitMap::Interface_BitMap | ( | ) |
Creates a empty BitMap.
Interface_BitMap::Interface_BitMap | ( | const Standard_Integer | nbitems, |
const Standard_Integer | resflags = 0 |
||
) |
Creates a BitMap for <nbitems> items One flag is defined, n0 0 <resflags> prepares allocation for <resflags> more flags Flags values start at false.
Interface_BitMap::Interface_BitMap | ( | const Interface_BitMap & | other, |
const Standard_Boolean | copied = Standard_False |
||
) |
Creates a BitMap from another one if <copied> is True, copies data else, data are not copied, only the header object is.
Standard_Integer Interface_BitMap::AddFlag | ( | const Standard_CString | name = "" | ) |
Adds a flag, a name can be attached to it Returns its flag number Makes required reservation.
Standard_Integer Interface_BitMap::AddSomeFlags | ( | const Standard_Integer | more | ) |
Adds several flags (<more>) with no name Returns the number of last added flag.
Standard_Boolean Interface_BitMap::CFalse | ( | const Standard_Integer | item, |
const Standard_Integer | flag = 0 |
||
) | const |
Returns the former value for a flag and sets it to False (before : value returned; after : False)
void Interface_BitMap::Clear | ( | ) |
Clear all field of bit map.
Standard_Boolean Interface_BitMap::CTrue | ( | const Standard_Integer | item, |
const Standard_Integer | flag = 0 |
||
) | const |
Returns the former value for a flag and sets it to True (before : value returned; after : True)
Standard_CString Interface_BitMap::FlagName | ( | const Standard_Integer | num | ) | const |
Returns the name recorded for a flag, or an empty string.
Standard_Integer Interface_BitMap::FlagNumber | ( | const Standard_CString | name | ) | const |
Returns the number or a flag given its name, or zero.
void Interface_BitMap::Init | ( | const Standard_Boolean | val, |
const Standard_Integer | flag = 0 |
||
) | const |
Initialises all the values of Flag Number <flag> to a given value <val>
void Interface_BitMap::Initialize | ( | const Standard_Integer | nbitems, |
const Standard_Integer | resflags = 0 |
||
) |
Initialize empty bit by <nbitems> items One flag is defined, n0 0 <resflags> prepares allocation for <resflags> more flags Flags values start at false.
void Interface_BitMap::Initialize | ( | const Interface_BitMap & | other, |
const Standard_Boolean | copied = Standard_False |
||
) |
Initialize a BitMap from another one.
void Interface_BitMap::Internals | ( | Standard_Integer & | nbitems, |
Standard_Integer & | nbwords, | ||
Standard_Integer & | nbflags, | ||
Handle< TColStd_HArray1OfInteger > & | flags, | ||
Handle< TColStd_HSequenceOfAsciiString > & | names | ||
) | const |
Returns internal values, used for copying Flags values start at false.
Standard_Integer Interface_BitMap::Length | ( | ) | const |
Returns the count of items (i.e. the length of the bitmap)
Standard_Integer Interface_BitMap::NbFlags | ( | ) | const |
Returns the count of flags (flag 0 not included)
Standard_Boolean Interface_BitMap::RemoveFlag | ( | const Standard_Integer | num | ) |
Removes a flag given its number. Returns True if done, false if num is out of range.
void Interface_BitMap::Reservate | ( | const Standard_Integer | moreflags | ) |
Reservates for a count of more flags.
void Interface_BitMap::SetFalse | ( | const Standard_Integer | item, |
const Standard_Integer | flag = 0 |
||
) | const |
Sets a flag to False.
Standard_Boolean Interface_BitMap::SetFlagName | ( | const Standard_Integer | num, |
const Standard_CString | name | ||
) |
Sets a name for a flag, given its number name can be empty (to erase the name of a flag) Returns True if done, false if : num is out of range, or name non-empty already set to another flag.
void Interface_BitMap::SetLength | ( | const Standard_Integer | nbitems | ) |
Sets for a new count of items, which can be either less or greater than the former one For new items, their flags start at false.
void Interface_BitMap::SetTrue | ( | const Standard_Integer | item, |
const Standard_Integer | flag = 0 |
||
) | const |
Sets a flag to True.
void Interface_BitMap::SetValue | ( | const Standard_Integer | item, |
const Standard_Boolean | val, | ||
const Standard_Integer | flag = 0 |
||
) | const |
Sets a new value for a flag.
Standard_Boolean Interface_BitMap::Value | ( | const Standard_Integer | item, |
const Standard_Integer | flag = 0 |
||
) | const |
Returns the value (true/false) of a flag, from :