Quick Links: ROOT Homepage Class Index Class Hierarchy

Source: header file source file viewVC header viewVC source

Sections: class description function members data members class charts

class TProcessID: public TNamed


 TProcessID

 A TProcessID identifies a ROOT job in a unique way in time and space.
 The TProcessID title consists of a TUUID object which provides a globally
 unique identifier (for more see TUUID.h).

 A TProcessID is automatically created by the TROOT constructor.
 When a TFile contains referenced objects (see TRef), the TProcessID
 object is written to the file.
 If a file has been written in multiple sessions (same machine or not),
 a TProcessID is written for each session.
 These objects are used by the class TRef to uniquely identified
 any TObject pointed by a TRef.

 When a referenced object is read from a file (its bit kIsReferenced is set),
 this object is entered into the objects table of the corresponding TProcessID.
 Each TFile has a list of TProcessIDs (see TFile::fProcessIDs) also
 accessible via TProcessID::fgPIDs (for all files).
 When this object is deleted, it is removed from the table via the cleanup
 mechanism invoked by the TObject destructor.

 Each TProcessID has a table (TObjArray *fObjects) that keeps track
 of all referenced objects. If a referenced object has a fUniqueID set,
 a pointer to this unique object may be found via fObjects->At(fUniqueID).
 In the same way, when a TRef::GetObject is called, GetObject uses
 its own fUniqueID to find the pointer to the referenced object.
 See TProcessID::GetObjectWithID and PutObjectWithID.

 When a referenced object is deleted, its slot in fObjects is set to null.

 See also TProcessUUID: a specialized TProcessID to manage the single list
 of TUUIDs.

Function Members (Methods)

public:

	TProcessID()
virtual	~TProcessID()
void	TObject::AbstractMethod(const char* method) const
static TProcessID*	AddProcessID()
virtual void	TObject::AppendPad(Option_t* option = "")
static UInt_t	AssignID(TObject* obj)
virtual void	TObject::Browse(TBrowser* b)
void	CheckInit()
static TClass*	Class()
virtual const char*	TObject::ClassName() const
static void	Cleanup()
virtual void	Clear(Option_t* option = "")
virtual TObject*	TNamed::Clone(const char* newname = "") const
virtual Int_t	TNamed::Compare(const TObject* obj) const
virtual void	TNamed::Copy(TObject& named) const
Int_t	DecrementCount()
virtual void	TObject::Delete(Option_t* option = "")MENU
virtual Int_t	TObject::DistancetoPrimitive(Int_t px, Int_t py)
virtual void	TObject::Draw(Option_t* option = "")
virtual void	TObject::DrawClass() constMENU
virtual TObject*	TObject::DrawClone(Option_t* option = "") constMENU
virtual void	TObject::Dump() constMENU
virtual void	TObject::Error(const char* method, const char* msgfmt) const
virtual void	TObject::Execute(const char* method, const char* params, Int_t* error = 0)
virtual void	TObject::Execute(TMethod* method, TObjArray* params, Int_t* error = 0)
virtual void	TObject::ExecuteEvent(Int_t event, Int_t px, Int_t py)
virtual void	TObject::Fatal(const char* method, const char* msgfmt) const
virtual void	TNamed::FillBuffer(char*& buffer)
virtual TObject*	TObject::FindObject(const char* name) const
virtual TObject*	TObject::FindObject(const TObject* obj) const
Int_t	GetCount() const
virtual Option_t*	TObject::GetDrawOption() const
static Long_t	TObject::GetDtorOnly()
virtual const char*	TObject::GetIconName() const
virtual const char*	TNamed::GetName() const
static UInt_t	GetNProcessIDs()
static UInt_t	GetObjectCount()
virtual char*	TObject::GetObjectInfo(Int_t px, Int_t py) const
TObjArray*	GetObjects() const
static Bool_t	TObject::GetObjectStat()
TObject*	GetObjectWithID(UInt_t uid)
virtual Option_t*	TObject::GetOption() const
static TProcessID*	GetPID()
static TObjArray*	GetPIDs()
static TProcessID*	GetProcessID(UShort_t pid)
static TProcessID*	GetProcessWithUID(const TObject* obj)
static TProcessID*	GetProcessWithUID(UInt_t uid, const void* obj)
static TProcessID*	GetSessionProcessID()
virtual const char*	TNamed::GetTitle() const
virtual UInt_t	TObject::GetUniqueID() const
virtual Bool_t	TObject::HandleTimer(TTimer* timer)
virtual ULong_t	TNamed::Hash() const
Int_t	IncrementCount()
virtual void	TObject::Info(const char* method, const char* msgfmt) const
virtual Bool_t	TObject::InheritsFrom(const char* classname) const
virtual Bool_t	TObject::InheritsFrom(const TClass* cl) const
virtual void	TObject::Inspect() constMENU
void	TObject::InvertBit(UInt_t f)
virtual TClass*	IsA() const
virtual Bool_t	TObject::IsEqual(const TObject* obj) const
virtual Bool_t	TObject::IsFolder() const
Bool_t	TObject::IsOnHeap() const
virtual Bool_t	TNamed::IsSortable() const
static Bool_t	IsValid(TProcessID* pid)
Bool_t	TObject::IsZombie() const
virtual void	TNamed::ls(Option_t* option = "") const
void	TObject::MayNotUse(const char* method) const
virtual Bool_t	TObject::Notify()
static void	TObject::operator delete(void* ptr)
static void	TObject::operator delete(void* ptr, void* vp)
static void	TObject::operator delete[](void* ptr)
static void	TObject::operator delete[](void* ptr, void* vp)
void*	TObject::operator new(size_t sz)
void*	TObject::operator new(size_t sz, void* vp)
void*	TObject::operator new[](size_t sz)
void*	TObject::operator new[](size_t sz, void* vp)
virtual void	TObject::Paint(Option_t* option = "")
virtual void	TObject::Pop()
virtual void	TNamed::Print(Option_t* option = "") const
void	PutObjectWithID(TObject* obj, UInt_t uid = 0)
virtual Int_t	TObject::Read(const char* name)
virtual void	RecursiveRemove(TObject* obj)
void	TObject::ResetBit(UInt_t f)
virtual void	TObject::SaveAs(const char* filename = "", Option_t* option = "") constMENU
virtual void	TObject::SavePrimitive(basic_ostream<char,char_traits<char> >& out, Option_t* option = "")
void	TObject::SetBit(UInt_t f)
void	TObject::SetBit(UInt_t f, Bool_t set)
virtual void	TObject::SetDrawOption(Option_t* option = "")MENU
static void	TObject::SetDtorOnly(void* obj)
virtual void	TNamed::SetName(const char* name)MENU
virtual void	TNamed::SetNameTitle(const char* name, const char* title)
static void	SetObjectCount(UInt_t number)
static void	TObject::SetObjectStat(Bool_t stat)
virtual void	TNamed::SetTitle(const char* title = "")MENU
virtual void	TObject::SetUniqueID(UInt_t uid)
virtual void	ShowMembers(TMemberInspector& insp)
virtual Int_t	TNamed::Sizeof() const
virtual void	Streamer(TBuffer& b)
void	StreamerNVirtual(TBuffer& b)
virtual void	TObject::SysError(const char* method, const char* msgfmt) const
Bool_t	TObject::TestBit(UInt_t f) const
Int_t	TObject::TestBits(UInt_t f) const
virtual void	TObject::UseCurrentStyle()
virtual void	TObject::Warning(const char* method, const char* msgfmt) const
virtual Int_t	TObject::Write(const char* name = 0, Int_t option = 0, Int_t bufsize = 0)
virtual Int_t	TObject::Write(const char* name = 0, Int_t option = 0, Int_t bufsize = 0) const

protected:

virtual void	TObject::DoError(int level, const char* location, const char* fmt, va_list va) const
void	TObject::MakeZombie()

private:

	TProcessID(const TProcessID& ref)
TProcessID&	operator=(const TProcessID& ref)

Data Members

public:

enum TObject::EStatusBits {	kCanDelete
	kMustCleanup
	kObjInCanvas
	kIsReferenced
	kHasUUID
	kCannotPick
	kNoContextMenu
	kInvalidObject
};
enum TObject::[unnamed] {	kIsOnHeap
	kNotDeleted
	kZombie
	kBitMask
	kSingleKey
	kOverwrite
	kWriteDelete
};

protected:

Int_t	fCount	!Reference count to this object (from TFile)
TString	TNamed::fName	object identifier
TObjArray*	fObjects	!Array pointing to the referenced objects
TString	TNamed::fTitle	object title
static UInt_t	fgNumber	Referenced objects count
static TExMap*	fgObjPIDs	Table pointer to pids
static TProcessID*	fgPID	Pointer to current session ProcessID
static TObjArray*	fgPIDs	Table of ProcessIDs

Class Charts

Inheritance Inherited Members Includes Libraries

Function documentation

TProcessID()

 Default constructor.

~TProcessID()

 Destructor.

TProcessID * AddProcessID()

 Static function to add a new TProcessID to the list of PIDs.

UInt_t AssignID(TObject* obj)

 static function returning the ID assigned to obj
 If the object is not yet referenced, its kIsReferenced bit is set
 and its fUniqueID set to the current number of referenced objects so far.

void CheckInit()

 Initialize fObjects.

void Cleanup()

 static function (called by TROOT destructor) to delete all TProcessIDs

void Clear(Option_t* option = "")

 delete the TObjArray pointing to referenced objects
 this function is called by TFile::Close("R")

Int_t DecrementCount()

TProcessID * GetProcessID(UShort_t pid)

 static function returning a pointer to TProcessID number pid in fgPIDs

UInt_t GetNProcessIDs()

 Return the (static) number of process IDs.

TProcessID * GetProcessWithUID(UInt_t uid, const void* obj)

 static function returning a pointer to TProcessID with its pid
 encoded in the highest byte of uid

TProcessID * GetProcessWithUID(const TObject* obj)

 static function returning a pointer to TProcessID with its pid
 encoded in the highest byte of obj->GetUniqueID()

TProcessID * GetSessionProcessID()

 static function returning the pointer to the session TProcessID

Int_t IncrementCount()

 Increase the reference count to this object.

UInt_t GetObjectCount()

 Return the current referenced object count
 fgNumber is incremented everytime a new object is referenced

TObject * GetObjectWithID(UInt_t uid)

returns the TObject with unique identifier uid in the table of objects

TProcessID * GetPID()

static: returns pointer to current TProcessID

TObjArray * GetPIDs()

static: returns array of TProcessIDs

Bool_t IsValid(TProcessID* pid)

 static function. return kTRUE if pid is a valid TProcessID

void PutObjectWithID(TObject* obj, UInt_t uid = 0)

stores the object at the uid th slot in the table of objects
The object uniqueid is set as well as its kMustCleanup bit

void RecursiveRemove(TObject* obj)

 called by the object destructor
 remove reference to obj from the current table if it is referenced

void SetObjectCount(UInt_t number)

 static function to set the current referenced object count
 fgNumber is incremented everytime a new object is referenced

TProcessID(const TProcessID& ref)

TProcessID& operator=(const TProcessID& ref)

Int_t GetCount() const

{return fCount;}

TObjArray * GetObjects() const

{return fObjects;}