Open CASCADE Technology  7.1.0.beta
Public Member Functions

Interface_BitMap Class Reference

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...
 

Detailed Description

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)

Constructor & Destructor Documentation

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.

Member Function Documentation

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 :

  • the number of the item
  • the flag number, by default 0

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