Open CASCADE Technology  6.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
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

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)
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: