Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
TBits Class Reference

Container of bits.

This class provides a simple container of bits. Each bit can be set and tested via the functions SetBitNumber and TestBitNumber.

The default value of all bits is kFALSE. The size of the container is automatically extended when a bit number is either set or tested. To reduce the memory size of the container use the Compact function, this will discard the memory occupied by the upper bits that are 0.

Definition at line 26 of file TBits.h.

Classes

class  TReference
 

Public Member Functions

 TBits (const TBits &)
 TBits copy constructor.
 
 TBits (UInt_t nbits=8)
 TBits constructor. All bits set to 0.
 
virtual ~TBits ()
 TBits destructor.
 
void Clear (Option_t *option="") override
 Clear the value.
 
void Compact ()
 Reduce the storage used by the object to a minimun.
 
UInt_t CountBits (UInt_t startBit=0) const
 Return number of bits set to 1 starting at bit startBit.
 
UInt_t FirstNullBit (UInt_t startBit=0) const
 Return position of first null bit (starting from position 0 and up)
 
UInt_t FirstSetBit (UInt_t startBit=0) const
 Return position of first non null bit (starting from position 0 and up)
 
void Get (Char_t *array) const
 Copy all the byes.
 
void Get (Int_t *array) const
 
void Get (Long64_t *array) const
 
void Get (Short_t *array) const
 
void Get (UChar_t *array) const
 
void Get (UInt_t *array) const
 
void Get (ULong64_t *array) const
 
void Get (UShort_t *array) const
 
UInt_t GetNbits () const
 
UInt_t GetNbytes () const
 
TClassIsA () const override
 
UInt_t LastNullBit (UInt_t startBit=999999999) const
 Return position of first null bit (starting from position 0 and up)
 
UInt_t LastSetBit (UInt_t startBit=999999999) const
 Return position of first non null bit (starting from position 0 and up)
 
Bool_t operator!= (const TBits &other) const
 
TBitsoperator&= (const TBits &rhs)
 
TBits operator<< (UInt_t rhs)
 
TBitsoperator<<= (UInt_t rhs)
 
TBitsoperator= (const TBits &)
 TBits assignment operator.
 
Bool_t operator== (const TBits &other) const
 
TBits operator>> (UInt_t rhs)
 
TBitsoperator>>= (UInt_t rhs)
 
TBits::TReference operator[] (UInt_t bitnumber)
 
Bool_t operator[] (UInt_t bitnumber) const
 
TBitsoperator^= (const TBits &rhs)
 
TBitsoperator|= (const TBits &rhs)
 
TBits operator~ () const
 
void Output (std::ostream &) const
 Print the value to the std::ostream.
 
void Paint (Option_t *option="") override
 Once implemented, it will draw the bit field as an histogram.
 
void Print (Option_t *option="") const override
 Print the list of active bits.
 
void ResetAllBits (Bool_t value=kFALSE)
 Reset all bits to 0 (false).
 
void ResetBitNumber (UInt_t bitnumber)
 
void Set (UInt_t nbits, const Char_t *array)
 Set all the bytes.
 
void Set (UInt_t nbits, const Int_t *array)
 
void Set (UInt_t nbits, const Long64_t *array)
 
void Set (UInt_t nbits, const Short_t *array)
 
void Set (UInt_t nbits, const UChar_t *array)
 
void Set (UInt_t nbits, const UInt_t *array)
 
void Set (UInt_t nbits, const ULong64_t *array)
 
void Set (UInt_t nbits, const UShort_t *array)
 
void SetBitNumber (UInt_t bitnumber, Bool_t value=kTRUE)
 
void Streamer (TBuffer &) override
 Stream an object of class TObject.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
Bool_t TestBitNumber (UInt_t bitnumber) const
 
- Public Member Functions inherited from TObject
 TObject ()
 TObject constructor.
 
 TObject (const TObject &object)
 TObject copy ctor.
 
virtual ~TObject ()
 TObject destructor.
 
void AbstractMethod (const char *method) const
 Use this method to implement an "abstract" method that you don't want to leave purely abstract.
 
virtual void AppendPad (Option_t *option="")
 Append graphics object to current pad.
 
virtual void Browse (TBrowser *b)
 Browse object. May be overridden for another default action.
 
ULong_t CheckedHash ()
 Check and record whether this class has a consistent Hash/RecursiveRemove setup (*) and then return the regular Hash value for this object.
 
virtual const char * ClassName () const
 Returns name of class to which the object belongs.
 
virtual TObjectClone (const char *newname="") const
 Make a clone of an object using the Streamer facility.
 
virtual Int_t Compare (const TObject *obj) const
 Compare abstract method.
 
virtual void Copy (TObject &object) const
 Copy this to obj.
 
virtual void Delete (Option_t *option="")
 Delete this object.
 
virtual Int_t DistancetoPrimitive (Int_t px, Int_t py)
 Computes distance from point (px,py) to the object.
 
virtual void Draw (Option_t *option="")
 Default Draw method for all objects.
 
virtual void DrawClass () const
 Draw class inheritance tree of the class to which this object belongs.
 
virtual TObjectDrawClone (Option_t *option="") const
 Draw a clone of this object in the current selected pad with: gROOT->SetSelectedPad(c1).
 
virtual void Dump () const
 Dump contents of object on stdout.
 
virtual void Error (const char *method, const char *msgfmt,...) const
 Issue error message.
 
virtual void Execute (const char *method, const char *params, Int_t *error=nullptr)
 Execute method on this object with the given parameter string, e.g.
 
virtual void Execute (TMethod *method, TObjArray *params, Int_t *error=nullptr)
 Execute method on this object with parameters stored in the TObjArray.
 
virtual void ExecuteEvent (Int_t event, Int_t px, Int_t py)
 Execute action corresponding to an event at (px,py).
 
virtual void Fatal (const char *method, const char *msgfmt,...) const
 Issue fatal error message.
 
virtual TObjectFindObject (const char *name) const
 Must be redefined in derived classes.
 
virtual TObjectFindObject (const TObject *obj) const
 Must be redefined in derived classes.
 
virtual Option_tGetDrawOption () const
 Get option used by the graphics system to draw this object.
 
virtual const char * GetIconName () const
 Returns mime type name of object.
 
virtual const char * GetName () const
 Returns name of object.
 
virtual char * GetObjectInfo (Int_t px, Int_t py) const
 Returns string containing info about the object at position (px,py).
 
virtual Option_tGetOption () const
 
virtual const char * GetTitle () const
 Returns title of object.
 
virtual UInt_t GetUniqueID () const
 Return the unique object id.
 
virtual Bool_t HandleTimer (TTimer *timer)
 Execute action in response of a timer timing out.
 
virtual ULong_t Hash () const
 Return hash value for this object.
 
Bool_t HasInconsistentHash () const
 Return true is the type of this object is known to have an inconsistent setup for Hash and RecursiveRemove (i.e.
 
virtual void Info (const char *method, const char *msgfmt,...) const
 Issue info message.
 
virtual Bool_t InheritsFrom (const char *classname) const
 Returns kTRUE if object inherits from class "classname".
 
virtual Bool_t InheritsFrom (const TClass *cl) const
 Returns kTRUE if object inherits from TClass cl.
 
virtual void Inspect () const
 Dump contents of this object in a graphics canvas.
 
void InvertBit (UInt_t f)
 
Bool_t IsDestructed () const
 IsDestructed.
 
virtual Bool_t IsEqual (const TObject *obj) const
 Default equal comparison (objects are equal if they have the same address in memory).
 
virtual Bool_t IsFolder () const
 Returns kTRUE in case object contains browsable objects (like containers or lists of other objects).
 
R__ALWAYS_INLINE Bool_t IsOnHeap () const
 
virtual Bool_t IsSortable () const
 
R__ALWAYS_INLINE Bool_t IsZombie () const
 
virtual void ls (Option_t *option="") const
 The ls function lists the contents of a class on stdout.
 
void MayNotUse (const char *method) const
 Use this method to signal that a method (defined in a base class) may not be called in a derived class (in principle against good design since a child class should not provide less functionality than its parent, however, sometimes it is necessary).
 
virtual Bool_t Notify ()
 This method must be overridden to handle object notification.
 
void Obsolete (const char *method, const char *asOfVers, const char *removedFromVers) const
 Use this method to declare a method obsolete.
 
void operator delete (void *ptr)
 Operator delete.
 
void operator delete[] (void *ptr)
 Operator delete [].
 
void * operator new (size_t sz)
 
void * operator new (size_t sz, void *vp)
 
void * operator new[] (size_t sz)
 
void * operator new[] (size_t sz, void *vp)
 
TObjectoperator= (const TObject &rhs)
 TObject assignment operator.
 
virtual void Pop ()
 Pop on object drawn in a pad to the top of the display list.
 
virtual Int_t Read (const char *name)
 Read contents of object with specified name from the current directory.
 
virtual void RecursiveRemove (TObject *obj)
 Recursively remove this object from a list.
 
void ResetBit (UInt_t f)
 
virtual void SaveAs (const char *filename="", Option_t *option="") const
 Save this object in the file specified by filename.
 
virtual void SavePrimitive (std::ostream &out, Option_t *option="")
 Save a primitive as a C++ statement(s) on output stream "out".
 
void SetBit (UInt_t f)
 
void SetBit (UInt_t f, Bool_t set)
 Set or unset the user status bits as specified in f.
 
virtual void SetDrawOption (Option_t *option="")
 Set drawing option for object.
 
virtual void SetUniqueID (UInt_t uid)
 Set the unique object id.
 
void StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)
 
virtual void SysError (const char *method, const char *msgfmt,...) const
 Issue system error message.
 
R__ALWAYS_INLINE Bool_t TestBit (UInt_t f) const
 
Int_t TestBits (UInt_t f) const
 
virtual void UseCurrentStyle ()
 Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked.
 
virtual void Warning (const char *method, const char *msgfmt,...) const
 Issue warning message.
 
virtual Int_t Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0)
 Write this object to the current directory.
 
virtual Int_t Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0) const
 Write this object to the current directory.
 

Static Public Member Functions

static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
- Static Public Member Functions inherited from TObject
static TClassClass ()
 
static const char * Class_Name ()
 
static constexpr Version_t Class_Version ()
 
static const char * DeclFileName ()
 
static Longptr_t GetDtorOnly ()
 Return destructor only flag.
 
static Bool_t GetObjectStat ()
 Get status of object stat flag.
 
static void SetDtorOnly (void *obj)
 Set destructor only flag.
 
static void SetObjectStat (Bool_t stat)
 Turn on/off tracking of objects in the TObjectTable.
 

Protected Member Functions

void DoAndEqual (const TBits &rhs)
 Execute (*this) &= rhs; Extra bits in rhs are ignored Missing bits in rhs are assumed to be zero.
 
void DoFlip ()
 Execute ~(*this)
 
void DoLeftShift (UInt_t shift)
 Execute the left shift operation.
 
void DoOrEqual (const TBits &rhs)
 Execute (*this) &= rhs; Extra bits in rhs are ignored Missing bits in rhs are assumed to be zero.
 
void DoRightShift (UInt_t shift)
 Execute the left shift operation.
 
void DoXorEqual (const TBits &rhs)
 Execute (*this) ^= rhs; Extra bits in rhs are ignored Missing bits in rhs are assumed to be zero.
 
void ReserveBytes (UInt_t nbytes)
 Reverse each bytes.
 
void Resize (UInt_t newlen)
 
- Protected Member Functions inherited from TObject
virtual void DoError (int level, const char *location, const char *fmt, va_list va) const
 Interface to ErrorHandler (protected).
 
void MakeZombie ()
 

Protected Attributes

UChar_tfAllBits
 
UInt_t fNbits
 
UInt_t fNbytes
 

Additional Inherited Members

- Public Types inherited from TObject
enum  {
  kIsOnHeap = 0x01000000 , kNotDeleted = 0x02000000 , kZombie = 0x04000000 , kInconsistent = 0x08000000 ,
  kBitMask = 0x00ffffff
}
 
enum  { kSingleKey = (1ULL << ( 0 )) , kOverwrite = (1ULL << ( 1 )) , kWriteDelete = (1ULL << ( 2 )) }
 
enum  EDeprecatedStatusBits { kObjInCanvas = (1ULL << ( 3 )) }
 
enum  EStatusBits {
  kCanDelete = (1ULL << ( 0 )) , kMustCleanup = (1ULL << ( 3 )) , kIsReferenced = (1ULL << ( 4 )) , kHasUUID = (1ULL << ( 5 )) ,
  kCannotPick = (1ULL << ( 6 )) , kNoContextMenu = (1ULL << ( 8 )) , kInvalidObject = (1ULL << ( 13 ))
}
 
- Protected Types inherited from TObject
enum  { kOnlyPrepStep = (1ULL << ( 3 )) }
 

#include <TBits.h>

Inheritance diagram for TBits:
[legend]

Constructor & Destructor Documentation

◆ TBits() [1/2]

TBits::TBits ( UInt_t  nbits = 8)

TBits constructor. All bits set to 0.

Definition at line 33 of file TBits.cxx.

◆ TBits() [2/2]

TBits::TBits ( const TBits original)

TBits copy constructor.

Definition at line 45 of file TBits.cxx.

◆ ~TBits()

TBits::~TBits ( )
virtual

TBits destructor.

Definition at line 76 of file TBits.cxx.

Member Function Documentation

◆ Class()

static TClass * TBits::Class ( )
static
Returns
TClass describing this class

◆ Class_Name()

static const char * TBits::Class_Name ( )
static
Returns
Name of this class

◆ Class_Version()

static constexpr Version_t TBits::Class_Version ( )
inlinestaticconstexpr
Returns
Version of this class

Definition at line 144 of file TBits.h.

◆ Clear()

void TBits::Clear ( Option_t option = "")
overridevirtual

Clear the value.

Reimplemented from TObject.

Definition at line 84 of file TBits.cxx.

◆ Compact()

void TBits::Compact ( )

Reduce the storage used by the object to a minimun.

Definition at line 95 of file TBits.cxx.

◆ CountBits()

UInt_t TBits::CountBits ( UInt_t  startBit = 0) const

Return number of bits set to 1 starting at bit startBit.

Definition at line 118 of file TBits.cxx.

◆ DeclFileName()

static const char * TBits::DeclFileName ( )
inlinestatic
Returns
Name of the file containing the class declaration

Definition at line 144 of file TBits.h.

◆ DoAndEqual()

void TBits::DoAndEqual ( const TBits rhs)
protected

Execute (*this) &= rhs; Extra bits in rhs are ignored Missing bits in rhs are assumed to be zero.

Definition at line 165 of file TBits.cxx.

◆ DoFlip()

void TBits::DoFlip ( )
protected

Execute ~(*this)

Definition at line 205 of file TBits.cxx.

◆ DoLeftShift()

void TBits::DoLeftShift ( UInt_t  shift)
protected

Execute the left shift operation.

Note: This does extent the number of bits (i.e. no data loss)

Definition at line 217 of file TBits.cxx.

◆ DoOrEqual()

void TBits::DoOrEqual ( const TBits rhs)
protected

Execute (*this) &= rhs; Extra bits in rhs are ignored Missing bits in rhs are assumed to be zero.

Definition at line 181 of file TBits.cxx.

◆ DoRightShift()

void TBits::DoRightShift ( UInt_t  shift)
protected

Execute the left shift operation.

Definition at line 242 of file TBits.cxx.

◆ DoXorEqual()

void TBits::DoXorEqual ( const TBits rhs)
protected

Execute (*this) ^= rhs; Extra bits in rhs are ignored Missing bits in rhs are assumed to be zero.

Definition at line 194 of file TBits.cxx.

◆ FirstNullBit()

UInt_t TBits::FirstNullBit ( UInt_t  startBit = 0) const

Return position of first null bit (starting from position 0 and up)

Definition at line 275 of file TBits.cxx.

◆ FirstSetBit()

UInt_t TBits::FirstSetBit ( UInt_t  startBit = 0) const

Return position of first non null bit (starting from position 0 and up)

Definition at line 359 of file TBits.cxx.

◆ Get() [1/8]

void TBits::Get ( Char_t array) const

Copy all the byes.

Definition at line 516 of file TBits.cxx.

◆ Get() [2/8]

void TBits::Get ( Int_t array) const

Definition at line 651 of file TBits.cxx.

◆ Get() [3/8]

void TBits::Get ( Long64_t array) const

Definition at line 672 of file TBits.cxx.

◆ Get() [4/8]

void TBits::Get ( Short_t array) const

Definition at line 633 of file TBits.cxx.

◆ Get() [5/8]

void TBits::Get ( UChar_t array) const
inline

Definition at line 118 of file TBits.h.

◆ Get() [6/8]

void TBits::Get ( UInt_t array) const
inline

Definition at line 122 of file TBits.h.

◆ Get() [7/8]

void TBits::Get ( ULong64_t array) const
inline

Definition at line 124 of file TBits.h.

◆ Get() [8/8]

void TBits::Get ( UShort_t array) const
inline

Definition at line 120 of file TBits.h.

◆ GetNbits()

UInt_t TBits::GetNbits ( ) const
inline

Definition at line 134 of file TBits.h.

◆ GetNbytes()

UInt_t TBits::GetNbytes ( ) const
inline

Definition at line 135 of file TBits.h.

◆ IsA()

TClass * TBits::IsA ( ) const
inlineoverridevirtual
Returns
TClass describing current object

Reimplemented from TObject.

Definition at line 144 of file TBits.h.

◆ LastNullBit()

UInt_t TBits::LastNullBit ( UInt_t  startBit = 999999999) const

Return position of first null bit (starting from position 0 and up)

Definition at line 320 of file TBits.cxx.

◆ LastSetBit()

UInt_t TBits::LastSetBit ( UInt_t  startBit = 999999999) const

Return position of first non null bit (starting from position 0 and up)

Definition at line 404 of file TBits.cxx.

◆ operator!=()

Bool_t TBits::operator!= ( const TBits other) const
inline

Definition at line 138 of file TBits.h.

◆ operator&=()

TBits & TBits::operator&= ( const TBits rhs)
inline

Definition at line 86 of file TBits.h.

◆ operator<<()

TBits TBits::operator<< ( UInt_t  rhs)
inline

Definition at line 91 of file TBits.h.

◆ operator<<=()

TBits & TBits::operator<<= ( UInt_t  rhs)
inline

Definition at line 89 of file TBits.h.

◆ operator=()

TBits & TBits::operator= ( const TBits rhs)

TBits assignment operator.

Definition at line 56 of file TBits.cxx.

◆ operator==()

Bool_t TBits::operator== ( const TBits other) const

Definition at line 699 of file TBits.cxx.

◆ operator>>()

TBits TBits::operator>> ( UInt_t  rhs)
inline

Definition at line 92 of file TBits.h.

◆ operator>>=()

TBits & TBits::operator>>= ( UInt_t  rhs)
inline

Definition at line 90 of file TBits.h.

◆ operator[]() [1/2]

TBits::TReference TBits::operator[] ( UInt_t  bitnumber)
inline

Definition at line 83 of file TBits.h.

◆ operator[]() [2/2]

Bool_t TBits::operator[] ( UInt_t  bitnumber) const
inline

Definition at line 240 of file TBits.h.

◆ operator^=()

TBits & TBits::operator^= ( const TBits rhs)
inline

Definition at line 88 of file TBits.h.

◆ operator|=()

TBits & TBits::operator|= ( const TBits rhs)
inline

Definition at line 87 of file TBits.h.

◆ operator~()

TBits TBits::operator~ ( ) const
inline

Definition at line 93 of file TBits.h.

◆ Output()

void TBits::Output ( std::ostream &  os) const

Print the value to the std::ostream.

Definition at line 443 of file TBits.cxx.

◆ Paint()

void TBits::Paint ( Option_t option = "")
overridevirtual

Once implemented, it will draw the bit field as an histogram.

use the TVirtualPainter as the usual trick

Reimplemented from TObject.

Definition at line 458 of file TBits.cxx.

◆ Print()

void TBits::Print ( Option_t option = "") const
overridevirtual

Print the list of active bits.

Reimplemented from TObject.

Definition at line 465 of file TBits.cxx.

◆ ReserveBytes()

void TBits::ReserveBytes ( UInt_t  nbytes)
protected

Reverse each bytes.

Definition at line 489 of file TBits.cxx.

◆ ResetAllBits()

void TBits::ResetAllBits ( Bool_t  value = kFALSE)

Reset all bits to 0 (false).

Definition at line 481 of file TBits.cxx.

◆ ResetBitNumber()

void TBits::ResetBitNumber ( UInt_t  bitnumber)
inline

Definition at line 235 of file TBits.h.

◆ Resize()

void TBits::Resize ( UInt_t  newlen)
inlineprotected

Definition at line 191 of file TBits.h.

◆ Set() [1/8]

void TBits::Set ( UInt_t  nbits,
const Char_t array 
)

Set all the bytes.

Definition at line 503 of file TBits.cxx.

◆ Set() [2/8]

void TBits::Set ( UInt_t  nbits,
const Int_t array 
)

Definition at line 593 of file TBits.cxx.

◆ Set() [3/8]

void TBits::Set ( UInt_t  nbits,
const Long64_t array 
)

Definition at line 611 of file TBits.cxx.

◆ Set() [4/8]

void TBits::Set ( UInt_t  nbits,
const Short_t array 
)

Definition at line 577 of file TBits.cxx.

◆ Set() [5/8]

void TBits::Set ( UInt_t  nbits,
const UChar_t array 
)
inline

Definition at line 100 of file TBits.h.

◆ Set() [6/8]

void TBits::Set ( UInt_t  nbits,
const UInt_t array 
)
inline

Definition at line 104 of file TBits.h.

◆ Set() [7/8]

void TBits::Set ( UInt_t  nbits,
const ULong64_t array 
)
inline

Definition at line 106 of file TBits.h.

◆ Set() [8/8]

void TBits::Set ( UInt_t  nbits,
const UShort_t array 
)
inline

Definition at line 102 of file TBits.h.

◆ SetBitNumber()

void TBits::SetBitNumber ( UInt_t  bitnumber,
Bool_t  value = kTRUE 
)
inline

Definition at line 206 of file TBits.h.

◆ Streamer()

void TBits::Streamer ( TBuffer R__b)
overridevirtual

Stream an object of class TObject.

Reimplemented from TObject.

◆ StreamerNVirtual()

void TBits::StreamerNVirtual ( TBuffer ClassDef_StreamerNVirtual_b)
inline

Definition at line 144 of file TBits.h.

◆ TestBitNumber()

Bool_t TBits::TestBitNumber ( UInt_t  bitnumber) const
inline

Definition at line 222 of file TBits.h.

Member Data Documentation

◆ fAllBits

UChar_t* TBits::fAllBits
protected

Definition at line 32 of file TBits.h.

◆ fNbits

UInt_t TBits::fNbits
protected

Definition at line 30 of file TBits.h.

◆ fNbytes

UInt_t TBits::fNbytes
protected

Definition at line 31 of file TBits.h.

  • core/cont/inc/TBits.h
  • core/cont/src/TBits.cxx