class TRefTable: public TObject
A TRefTable maintains the association between a referenced object and the parent object supporting this referenced object. The parent object is typically a branch of a TTree. For each object referenced in a TTree entry, the corresponding entry in the TTree's TBranchRef::fRefTable contains the index of the branch that needs to be loaded to bring the object into memory. Persistency of a TRefTable is split into two parts: * entry specific information is stored (read) by FillBuffer (ReadBuffer). For each referenced object the object's fUniqueID and the referencing TRef::fPID is stored (to allow the TRefTable to autoload references created by different processes). * non-entry specific, i.e. global information is stored (read) by the Streamer function. This comprises all members marked as persistent. As TObject::fUniqueID is only unique for a given TProcessID, a table of unique IDs is kept for each used TProcessID. There is no natural order of TProcessIDs, so TRefTable stores a vector of the TGUID of all known TProcessIDs in fProcessGUIDs; the index of a TProcessID in this vector defines the index of the auto-loading info in fParentIDs for that TProcessID. The mapping of TProcessID* to index is cached for quick non-persistent lookup.
Function Members (Methods)
public:
| TRefTable() | |
| TRefTable(const TRefTable&) | |
| TRefTable(TObject* owner, Int_t size) | |
| virtual | ~TRefTable() |
| void | TObject::AbstractMethod(const char* method) const |
| virtual Int_t | Add(Int_t uid, TProcessID* context = 0) |
| virtual void | TObject::AppendPad(Option_t* option = "") |
| virtual void | TObject::Browse(TBrowser* b) |
| static TClass* | Class() |
| virtual const char* | TObject::ClassName() const |
| virtual void | Clear(Option_t* = "") |
| virtual TObject* | TObject::Clone(const char* newname = "") const |
| virtual Int_t | TObject::Compare(const TObject* obj) const |
| virtual void | TObject::Copy(TObject& object) const |
| 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 Int_t | Expand(Int_t pid, Int_t newsize) |
| virtual void | TObject::Fatal(const char* method, const char* msgfmt) const |
| virtual void | FillBuffer(TBuffer& b) |
| virtual TObject* | TObject::FindObject(const char* name) const |
| virtual TObject* | TObject::FindObject(const TObject* obj) const |
| virtual Option_t* | TObject::GetDrawOption() const |
| static Long_t | TObject::GetDtorOnly() |
| virtual const char* | TObject::GetIconName() const |
| Int_t | GetN(Int_t pid) const |
| virtual const char* | TObject::GetName() const |
| Int_t | GetNumPIDs() const |
| virtual char* | TObject::GetObjectInfo(Int_t px, Int_t py) const |
| static Bool_t | TObject::GetObjectStat() |
| virtual Option_t* | TObject::GetOption() const |
| TObject* | GetOwner() const |
| TObject* | GetParent(Int_t uid, TProcessID* context = 0) const |
| TObjArray* | GetParents() const |
| static TRefTable* | GetRefTable() |
| Int_t | GetSize(Int_t pid) const |
| virtual const char* | TObject::GetTitle() const |
| UInt_t | GetUID() const |
| TProcessID* | GetUIDContext() const |
| virtual UInt_t | TObject::GetUniqueID() const |
| virtual Bool_t | TObject::HandleTimer(TTimer* timer) |
| virtual ULong_t | TObject::Hash() const |
| 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 | TObject::IsSortable() const |
| Bool_t | TObject::IsZombie() const |
| virtual void | TObject::ls(Option_t* option = "") const |
| void | TObject::MayNotUse(const char* method) const |
| virtual Bool_t | Notify() |
| void | TObject::Obsolete(const char* method, const char* asOfVers, const char* removedFromVers) const |
| 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) |
| TRefTable& | operator=(const TRefTable&) |
| virtual void | TObject::Paint(Option_t* option = "") |
| virtual void | TObject::Pop() |
| virtual void | TObject::Print(Option_t* option = "") const |
| virtual Int_t | TObject::Read(const char* name) |
| virtual void | ReadBuffer(TBuffer& b) |
| virtual void | TObject::RecursiveRemove(TObject* obj) |
| virtual void | Reset(Option_t* = "") |
| void | TObject::ResetBit(UInt_t f) |
| virtual void | TObject::SaveAs(const char* filename = "", Option_t* option = "") constMENU |
| virtual void | TObject::SavePrimitive(ostream& 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) |
| static void | TObject::SetObjectStat(Bool_t stat) |
| virtual Int_t | SetParent(const TObject* parent, Int_t branchID) |
| static void | SetRefTable(TRefTable* table) |
| virtual void | SetUID(UInt_t uid, TProcessID* context = 0) |
| virtual void | TObject::SetUniqueID(UInt_t uid) |
| virtual void | ShowMembers(TMemberInspector&) |
| virtual void | Streamer(TBuffer&) |
| void | StreamerNVirtual(TBuffer& ClassDef_StreamerNVirtual_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:
| Int_t | AddInternalIdxForPID(TProcessID* procid) |
| virtual void | TObject::DoError(int level, const char* location, const char* fmt, va_list va) const |
| virtual Int_t | ExpandForIID(Int_t iid, Int_t newsize) |
| void | ExpandPIDs(Int_t numpids) |
| Int_t | FindPIDGUID(const char* guid) const |
| Int_t | GetInternalIdxForPID(TProcessID* procid) const |
| Int_t | GetInternalIdxForPID(Int_t pid) const |
| void | TObject::MakeZombie() |
Data Members
public:
| enum { | kHaveWarnedReadingOld | |
| }; | ||
| enum TObject::EStatusBits { | kCanDelete | |
| kMustCleanup | ||
| kObjInCanvas | ||
| kIsReferenced | ||
| kHasUUID | ||
| kCannotPick | ||
| kNoContextMenu | ||
| kInvalidObject | ||
| }; | ||
| enum TObject::[unnamed] { | kIsOnHeap | |
| kNotDeleted | ||
| kZombie | ||
| kBitMask | ||
| kSingleKey | ||
| kOverwrite | ||
| kWriteDelete | ||
| }; |
protected:
| Int_t* | fAllocSize | ![fNumPIDs] allocated size of array fParentIDs for each ProcessID |
| Int_t | fDefaultSize | !default size for a new PID array |
| vector<Int_t> | fMapPIDtoInternal | ! cache of pid to index in fProcessGUIDs |
| Int_t* | fN | ![fNumPIDs] current maximum number of IDs in array fParentIDs for each ProcessID |
| Int_t | fNumPIDs | !number of known ProcessIDs |
| TObject* | fOwner | Object owning this TRefTable |
| Int_t | fParentID | !current parent ID in fParents (latest call to SetParent) |
| Int_t** | fParentIDs | ![fNumPIDs][fAllocSize] array of Parent IDs |
| TObjArray* | fParents | array of Parent objects (eg TTree branch) holding the referenced objects |
| vector<std::string> | fProcessGUIDs | UUIDs of TProcessIDs used in fParentIDs |
| Int_t | fSize | dummy for backward compatibility |
| UInt_t | fUID | !Current uid (set by TRef::GetObject) |
| TProcessID* | fUIDContext | !TProcessID the current uid is referring to |
| static TRefTable* | fgRefTable | Pointer to current TRefTable |
Class Charts
Function documentation
Int_t Add(Int_t uid, TProcessID* context = 0)
Add a new uid to the table. we add a new pair (uid,fparent) to the map This function is called by TObject::Streamer or TStreamerInfo::WriteBuffer
Int_t AddInternalIdxForPID(TProcessID* procid)
Add the internal index for fProcessIDs, fAllocSize, etc given a PID.
Int_t ExpandForIID(Int_t iid, Int_t newsize)
Expand fParentIDs to newsize for internel ProcessID index iid.
void FillBuffer(TBuffer& b)
Fill buffer b with the fN elements in fParentdIDs. This function is called by TBranchRef::FillLeaves.
Int_t GetInternalIdxForPID(TProcessID* procid) const
Get the index for fProcessIDs, fAllocSize, etc given a PID. Uses fMapPIDtoInternal and the pid's GUID / fProcessGUID
Int_t GetInternalIdxForPID(Int_t pid) const
Get the index for fProcessIDs, fAllocSize, etc given a PID. Uses fMapPIDtoInternal and the pid's GUID / fProcessGUID
Bool_t Notify()
This function is called by TRef::Streamer or TStreamerInfo::ReadBuffer when reading a reference. This function, in turns, notifies the TRefTable owner for action. eg, when the owner is a TBranchRef, TBranchRef::Notify is called to read the branch containing the referenced object.
void ReadBuffer(TBuffer& b)
Fill buffer b with the fN elements in fParentdIDs. This function is called by TBranchRef::ReadLeaves
Int_t SetParent(const TObject* parent, Int_t branchID)
-- Set current parent object, typically a branch of a tree. This function is called by TBranchElement::Fill() and by TBranchElement::GetEntry().