Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
TObject.h
Go to the documentation of this file.
1// @(#)root/base:$Id$
2// Author: Rene Brun 26/12/94
3
4/*************************************************************************
5 * Copyright (C) 1995-2000, Rene Brun and Fons Rademakers. *
6 * All rights reserved. *
7 * *
8 * For the licensing terms see $ROOTSYS/LICENSE. *
9 * For the list of contributors see $ROOTSYS/README/CREDITS. *
10 *************************************************************************/
11
12#ifndef ROOT_TObject
13#define ROOT_TObject
14
15
16// #include "RConfigure.h" // included via Rtypes.h
17#include "Rtypes.h"
18#include "TStorage.h"
19#include "TVersionCheck.h"
20
21#include <stdarg.h>
22#include <string>
23#include <iosfwd>
24
25#ifdef WIN32
26#undef RemoveDirectory
27#endif
28
29class TList;
30class TBrowser;
31class TBuffer;
32class TObjArray;
33class TMethod;
34class TTimer;
35
36namespace ROOT {
37namespace Internal {
39}}
40
41class TObject {
42
43private:
44 UInt_t fUniqueID; ///< object unique identifier
45 UInt_t fBits; ///< bit field status word
46
47 static Longptr_t fgDtorOnly; ///< object for which to call dtor only (i.e. no delete)
48 static Bool_t fgObjectStat; ///< if true keep track of objects in TObjectTable
49
50 static void AddToTObjectTable(TObject *);
51
52protected:
53 void MakeZombie() { fBits |= kZombie; }
54 virtual void DoError(int level, const char *location, const char *fmt, va_list va) const;
55
56 static void SavePrimitiveConstructor(std::ostream &out, TClass *cl, const char *variable_name, const char *constructor_agrs = "", Bool_t empty_line = kTRUE);
57
58 static TString SavePrimitiveVector(std::ostream &out, const char *prefix, Int_t len, Double_t *arr, Bool_t empty_line = kFALSE);
59
60 static void SavePrimitiveDraw(std::ostream &out, const char *variable_name, Option_t *option = nullptr);
61
62public:
63 //----- Global bits (can be set for any object and should not be reused).
64 //----- Bits 0 - 13 are reserved as global bits. Bits 14 - 23 can be used
65 //----- in different class hierarchies (make sure there is no overlap in
66 //----- any given hierarchy).
68 kCanDelete = BIT(0), ///< if object in a list can be deleted
69 // 2 is taken by TDataMember
70 kMustCleanup = BIT(3), ///< if object destructor must call RecursiveRemove()
71 kIsReferenced = BIT(4), ///< if object is referenced by a TRef or TRefArray
72 kHasUUID = BIT(5), ///< if object has a TUUID (its fUniqueID=UUIDNumber)
73 kCannotPick = BIT(6), ///< if object in a pad cannot be picked
74 // 7 is taken by TAxis and TClass.
75 kNoContextMenu = BIT(8), ///< if object does not want context menu
76 // 9, 10 are taken by TH1, TF1, TAxis and a few others
77 // 12 is taken by TAxis
78 kInvalidObject = BIT(13) ///< if object ctor succeeded but object should not be used
79 };
80
82 kObjInCanvas = BIT(3) ///< for backward compatibility only, use kMustCleanup
83 };
84
85 //----- Private bits, clients can only test but not change them
86 enum {
87 kIsOnHeap = 0x01000000, ///< object is on heap
88 kNotDeleted = 0x02000000, ///< object has not been deleted
89 kZombie = 0x04000000, ///< object ctor failed
90 kInconsistent = 0x08000000, ///< class overload Hash but does call RecursiveRemove in destructor
91 // kCheckedHash = 0x10000000, ///< CheckedHash has check for the consistency of Hash/RecursiveRemove
92 kBitMask = 0x00ffffff
93 };
94
95 //----- Write() options
96 enum {
97 kSingleKey = BIT(0), ///< write collection with single key
98 kOverwrite = BIT(1), ///< overwrite existing object with same name
99 kWriteDelete = BIT(2), ///< write object, then delete previous key with same name
100 };
101
102protected:
103 enum { // DeprectatedWriteOptions
104 ///< Used to request that the class specific implementation of `TObject::Write`
105 ///< just prepare the objects to be ready to be written but do not actually write
106 ///< them into the TBuffer. This is just for example by TBufferMerger to request
107 ///< that the TTree inside the file calls `TTree::FlushBaskets` (outside of the merging lock)
108 ///< and TBufferMerger will later ask for the write (inside the merging lock).
109 ///< To take advantage of this feature the class needs to overload `TObject::Write`
110 ///< and use this enum value accordingly. (See `TTree::Write` and `TObject::Write`)
111 ///< Do not use, this feature will be migrate to the Merge function (See TClass and TTree::Merge)
112 kOnlyPrepStep = BIT(3)
113 };
114
115public:
116
117 TObject();
118 TObject(const TObject &object) noexcept;
119 TObject &operator=(const TObject &rhs) noexcept;
120 virtual ~TObject();
121
122 virtual void AppendPad(Option_t *option="");
123 virtual void Browse(TBrowser *b);
124 virtual const char *ClassName() const;
125 virtual void Clear(Option_t * /*option*/ ="") { }
126 ULong_t CheckedHash(); // Not virtual
127 virtual TObject *Clone(const char *newname="") const;
128 virtual Int_t Compare(const TObject *obj) const;
129 virtual void Copy(TObject &object) const;
130 virtual void Delete(Option_t *option=""); // *MENU*
131 virtual Int_t DistancetoPrimitive(Int_t px, Int_t py);
132 virtual void Draw(Option_t *option="");
133 virtual void DrawClass() const; // *MENU*
134 virtual TObject *DrawClone(Option_t *option="") const; // *MENU*
135 virtual void Dump() const; // *MENU*
136 virtual void Execute(const char *method, const char *params, Int_t *error = nullptr);
137 virtual void Execute(TMethod *method, TObjArray *params, Int_t *error = nullptr);
138 virtual void ExecuteEvent(Int_t event, Int_t px, Int_t py);
139 virtual TObject *FindObject(const char *name) const;
140 virtual TObject *FindObject(const TObject *obj) const;
141 virtual Option_t *GetDrawOption() const;
142 virtual UInt_t GetUniqueID() const;
143 virtual const char *GetName() const;
144 virtual const char *GetIconName() const;
145 virtual Option_t *GetOption() const { return ""; }
146 virtual char *GetObjectInfo(Int_t px, Int_t py) const;
147 virtual const char *GetTitle() const;
148 virtual Bool_t HandleTimer(TTimer *timer);
150 virtual ULong_t Hash() const;
151 virtual Bool_t InheritsFrom(const char *classname) const;
152 virtual Bool_t InheritsFrom(const TClass *cl) const;
153 virtual void Inspect() const; // *MENU*
154 virtual Bool_t IsFolder() const;
155 virtual Bool_t IsEqual(const TObject *obj) const;
156 virtual Bool_t IsSortable() const { return kFALSE; }
157
160
161 virtual Bool_t Notify();
162 virtual void ls(Option_t *option="") const;
163 virtual void Paint(Option_t *option="");
164 virtual void Pop();
165 virtual void Print(Option_t *option="") const;
166 virtual Int_t Read(const char *name);
167 virtual void RecursiveRemove(TObject *obj);
168 virtual void SaveAs(const char *filename="",Option_t *option="") const; // *MENU*
169 virtual void SavePrimitive(std::ostream &out, Option_t *option = "");
170 virtual void SetDrawOption(Option_t *option=""); // *MENU*
171 virtual void SetUniqueID(UInt_t uid);
172 virtual void UseCurrentStyle();
173 virtual Int_t Write(const char *name = nullptr, Int_t option = 0, Int_t bufsize = 0);
174 virtual Int_t Write(const char *name = nullptr, Int_t option = 0, Int_t bufsize = 0) const;
175
176 /// IsDestructed
177 ///
178 /// \note This function must be non-virtual as it can be used on destructed (but
179 /// not yet modified) memory. This is used for example in TClonesArray to record
180 /// the element that have been destructed but not deleted and thus are ready for
181 /// re-use (by operator new with placement).
182 ///
183 /// \return true if this object's destructor has been run.
185
186 //----- operators
187 void *operator new(size_t sz) { return TStorage::ObjectAlloc(sz); }
188 void *operator new[](size_t sz) { return TStorage::ObjectAllocArray(sz); }
189 void *operator new(size_t sz, void *vp) { return TStorage::ObjectAlloc(sz, vp); }
190 void *operator new[](size_t sz, void *vp) { return TStorage::ObjectAlloc(sz, vp); }
191 void operator delete(void *ptr);
192 void operator delete[](void *ptr);
193 void operator delete(void*, size_t);
194 void operator delete[](void*, size_t);
195 void operator delete(void *ptr, void *vp);
196 void operator delete[](void *ptr, void *vp);
197
198 //----- bit manipulation
199 void SetBit(UInt_t f, Bool_t set);
200 void SetBit(UInt_t f) { fBits |= f & kBitMask; }
201 void ResetBit(UInt_t f) { fBits &= ~(f & kBitMask); }
202 R__ALWAYS_INLINE Bool_t TestBit(UInt_t f) const { return (Bool_t) ((fBits & f) != 0); }
203 Int_t TestBits(UInt_t f) const { return (Int_t) (fBits & f); }
205
206 //---- error handling
207 virtual void Info(const char *method, const char *msgfmt, ...) const
208#if defined(__GNUC__)
209 __attribute__((format(printf, 3, 4))) /* 1 is the this pointer */
210#endif
211 ;
212 virtual void Warning(const char *method, const char *msgfmt, ...) const
213#if defined(__GNUC__)
214 __attribute__((format(printf, 3, 4))) /* 1 is the this pointer */
215#endif
216 ;
217 virtual void Error(const char *method, const char *msgfmt, ...) const
218#if defined(__GNUC__)
219 __attribute__((format(printf, 3, 4))) /* 1 is the this pointer */
220#endif
221 ;
222 virtual void SysError(const char *method, const char *msgfmt, ...) const
223#if defined(__GNUC__)
224 __attribute__((format(printf, 3, 4))) /* 1 is the this pointer */
225#endif
226 ;
227 virtual void Fatal(const char *method, const char *msgfmt, ...) const
228#if defined(__GNUC__)
229 __attribute__((format(printf, 3, 4))) /* 1 is the this pointer */
230#endif
231 ;
232
233 void AbstractMethod(const char *method) const;
234 void MayNotUse(const char *method) const;
235 void Obsolete(const char *method, const char *asOfVers, const char *removedFromVers) const;
236
237 //---- static functions
238 static Longptr_t GetDtorOnly();
239 static void SetDtorOnly(void *obj);
240 static Bool_t GetObjectStat();
241 static void SetObjectStat(Bool_t stat);
242
243 friend class TClonesArray; // needs to reset kNotDeleted in fBits
245
246 ClassDef(TObject,1) //Basic ROOT object
247};
248
249////////////////////////////////////////////////////////////////////////////////
250/// TObject constructor. It sets the two data words of TObject to their
251/// initial values. The unique ID is set to 0 and the status word is
252/// set depending if the object is created on the stack or allocated
253/// on the heap. Depending on the ROOT environment variable "Root.ObjStat"
254/// (see TEnv) the object is added to the global TObjectTable for
255/// bookkeeping.
256
257inline TObject::TObject() : fBits(kNotDeleted) // Need to leave fUniqueID unset
258{
259 // This will be reported by valgrind as uninitialized memory reads for
260 // object created on the stack, use $ROOTSYS/etc/valgrind-root.supp
262
263 fUniqueID = 0;
264
265#ifdef R__WIN32
267#else
269#endif
270}
271
272////////////////////////////////////////////////////////////////////////////////
273/// TObject copy ctor.
274
275inline TObject::TObject(const TObject &obj) noexcept
276{
277 fBits = obj.fBits;
278
279 // This will be reported by valgrind as uninitialized memory reads for
280 // object created on the stack, use $ROOTSYS/etc/valgrind-root.supp
282
285
286 // Set only after used in above call
287 fUniqueID = obj.fUniqueID; // when really unique don't copy
288
289#ifdef R__WIN32
291#else
293#endif
294}
295
296////////////////////////////////////////////////////////////////////////////////
297/// TObject assignment operator.
298
299inline TObject &TObject::operator=(const TObject &rhs) noexcept
300{
301 if (R__likely(this != &rhs)) {
302 fUniqueID = rhs.fUniqueID; // when really unique don't copy
303 if (IsOnHeap()) { // test uses fBits so don't move next line
304 fBits = rhs.fBits;
305 fBits |= kIsOnHeap;
306 } else {
307 fBits = rhs.fBits;
308 fBits &= ~kIsOnHeap;
309 }
312 }
313 return *this;
314}
315
316
317////////////////////////////////////////////////////////////////////////////////
318/// @brief Check and record whether this class has a consistent
319/// Hash/RecursiveRemove setup (*) and then return the regular Hash value for
320/// this object. The intent is for this routine to be called instead of directly
321/// calling the function Hash during "insert" operations. See TObject::HasInconsistenTObjectHash();
322///
323/// (*) The setup is consistent when all classes in the class hierarchy that overload
324/// TObject::Hash do call ROOT::CallRecursiveRemoveIfNeeded in their destructor.
325/// i.e. it is safe to call the Hash virtual function during the RecursiveRemove operation.
326
328{
329 // Testing and recording whether we already called HasInconstistentTObjectHash
330 // for this object could save some cpu cycles in some circuntances (at the cost
331 // of reserving yet another bit).
332 // For each insert (CheckedHash is called only for insert in THashList/THashTable), it
333 // cost one memory fetch, one arithmetic operation and one branching.
334 // This save a virtual function call which itself contains a static variable memory
335 // fetch, a branching (of whether the static was already set or not).
336 // Given that a virtual function call is essentially 2 memory fetches (virtual table
337 // location and then content), one arithmetic operation and one function call/jump),
338 // we guess-estimate that the version recording-then-testing-prior-check would start
339 // saving cpu cycle when each object is inserted in average 1.5 times in a THashList/THashTable.
340
341 // if ( !fBits & kCheckedHash) {
344 // fBits &= kChecked;
345 //}
346 return Hash();
347}
348
349////////////////////////////////////////////////////////////////////////////////
350/// @brief Return true is the type of this object is *known* to have an
351/// inconsistent setup for Hash and RecursiveRemove (i.e. missing call to
352/// RecursiveRemove in destructor).
353///
354/// Note: Since the consistency is only tested for during inserts, this
355/// routine will return true for object that have never been inserted
356/// whether or not they have a consistent setup. This has no negative
357/// side-effect as searching for the object with the right or wrong
358/// Hash will always yield a not-found answer (Since anyway no hash
359/// can be guaranteed unique, there is always a check)
360
362{
363 return fBits & kInconsistent;
364}
365
366// Global bits (can be set for any object and should not be reused).
367// Only here for backward compatibility reasons.
368// For detailed description see TObject::EStatusBits above.
379
380namespace cling {
381 std::string printValue(TObject *val);
382}
383
384namespace ROOT {
385
386namespace Internal {
387 bool DeleteChangesMemory();
388} // Internal
389
390namespace Detail {
391
392
393/// @brief Check if the TObject's memory has been deleted.
394/// @warning This should be only used for error mitigation as the answer is only
395/// sometimes correct. It actually just checks whether the object has been
396/// deleted, so this will falsely return true for an object that has
397/// been destructed but its memory has not been deleted. This will return an
398/// undefined value if the memory is re-used between the deletion and the check.
399/// i.e. This is useful to prevent a segmentation fault in case where the problem
400/// can be detected when the deletion and the usage are 'close-by'
401/// @warning In enviroment where delete taints (changes) the memory, this function
402/// always returns false as the marker left by ~TObject will be overwritten.
403/// @param obj The memory to check
404/// @return true if the object has been destructed and it can be inferred that it has been deleted
408
409}} // ROOT::Details
410
411#endif
#define R__ALWAYS_INLINE
Definition RConfig.hxx:552
#define R__likely(expr)
Definition RConfig.hxx:587
#define R__unlikely(expr)
Definition RConfig.hxx:586
#define b(i)
Definition RSha256.hxx:100
#define f(i)
Definition RSha256.hxx:104
bool Bool_t
Definition RtypesCore.h:63
int Int_t
Definition RtypesCore.h:45
long Longptr_t
Definition RtypesCore.h:75
unsigned long ULong_t
Definition RtypesCore.h:55
unsigned int UInt_t
Definition RtypesCore.h:46
constexpr Bool_t kFALSE
Definition RtypesCore.h:94
double Double_t
Definition RtypesCore.h:59
constexpr Bool_t kTRUE
Definition RtypesCore.h:93
const char Option_t
Definition RtypesCore.h:66
#define ClassDef(name, id)
Definition Rtypes.h:342
#define BIT(n)
Definition Rtypes.h:90
ROOT::Detail::TRangeCast< T, true > TRangeDynCast
TRangeDynCast is an adapter class that allows the typed iteration through a TCollection.
Option_t Option_t option
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t Float_t Float_t Float_t Int_t Int_t UInt_t UInt_t Rectangle_t Int_t Int_t Window_t TString Int_t GCValues_t GetPrimarySelectionOwner GetDisplay GetScreen GetColormap GetNativeEvent const char const char dpyName wid window const char font_name cursor keysym reg const char only_if_exist regb h Point_t winding char text const char depth char const char Int_t count const char ColorStruct_t color const char filename
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t Float_t Float_t Float_t Int_t Int_t UInt_t UInt_t Rectangle_t Int_t Int_t Window_t TString Int_t GCValues_t GetPrimarySelectionOwner GetDisplay GetScreen GetColormap GetNativeEvent const char const char dpyName wid window const char font_name cursor keysym reg const char only_if_exist regb h Point_t winding char text const char depth char const char Int_t count const char ColorStruct_t color const char Pixmap_t Pixmap_t PictureAttributes_t attr const char char ret_data h unsigned char height h Atom_t Int_t ULong_t ULong_t unsigned char prop_list Atom_t Atom_t Atom_t Time_t UChar_t len
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t Float_t Float_t Float_t Int_t Int_t UInt_t UInt_t Rectangle_t Int_t Int_t Window_t TString Int_t GCValues_t GetPrimarySelectionOwner GetDisplay GetScreen GetColormap GetNativeEvent const char const char dpyName wid window const char font_name cursor keysym reg const char only_if_exist regb h Point_t winding char text const char depth char const char Int_t count const char ColorStruct_t color const char Pixmap_t Pixmap_t PictureAttributes_t attr const char char ret_data h unsigned char height h Atom_t Int_t ULong_t ULong_t unsigned char prop_list Atom_t Atom_t Atom_t Time_t format
char name[80]
Definition TGX11.cxx:110
EObjBits
Definition TObject.h:369
@ kCanDelete
Definition TObject.h:370
@ kIsReferenced
Definition TObject.h:373
@ kCannotPick
Definition TObject.h:375
@ kInvalidObject
Definition TObject.h:377
@ kObjInCanvas
Definition TObject.h:372
@ kNoContextMenu
Definition TObject.h:376
@ kMustCleanup
Definition TObject.h:371
@ kHasUUID
Definition TObject.h:374
Using a TBrowser one can browse all ROOT objects.
Definition TBrowser.h:37
Buffer base class used for serializing objects.
Definition TBuffer.h:43
TClass instances represent classes, structs and namespaces in the ROOT type system.
Definition TClass.h:84
An array of clone (identical) objects.
A doubly linked list.
Definition TList.h:38
Each ROOT class (see TClass) has a linked list of methods.
Definition TMethod.h:38
An array of TObjects.
Definition TObjArray.h:31
Mother of all ROOT objects.
Definition TObject.h:41
void AbstractMethod(const char *method) const
Call this function within a function that you don't want to define as purely virtual,...
Definition TObject.cxx:1122
virtual Bool_t IsFolder() const
Returns kTRUE in case object contains browsable objects (like containers or lists of other objects).
Definition TObject.cxx:573
virtual void Inspect() const
Dump contents of this object in a graphics canvas.
Definition TObject.cxx:564
virtual void Clear(Option_t *="")
Definition TObject.h:125
virtual Int_t DistancetoPrimitive(Int_t px, Int_t py)
Computes distance from point (px,py) to the object.
Definition TObject.cxx:284
TObject & operator=(const TObject &rhs) noexcept
TObject assignment operator.
Definition TObject.h:299
Bool_t HasInconsistentHash() const
Return true is the type of this object is known to have an inconsistent setup for Hash and RecursiveR...
Definition TObject.h:361
static void SetObjectStat(Bool_t stat)
Turn on/off tracking of objects in the TObjectTable.
Definition TObject.cxx:1161
virtual Bool_t Notify()
This method must be overridden to handle object notification (the base implementation is no-op).
Definition TObject.cxx:612
Bool_t IsDestructed() const
IsDestructed.
Definition TObject.h:184
ULong_t CheckedHash()
Check and record whether this class has a consistent Hash/RecursiveRemove setup (*) and then return t...
Definition TObject.h:327
virtual Bool_t IsEqual(const TObject *obj) const
Default equal comparison (objects are equal if they have the same address in memory).
Definition TObject.cxx:583
@ kOverwrite
overwrite existing object with same name
Definition TObject.h:98
@ kSingleKey
write collection with single key
Definition TObject.h:97
@ kWriteDelete
write object, then delete previous key with same name
Definition TObject.h:99
virtual const char * GetName() const
Returns name of object.
Definition TObject.cxx:457
virtual void Browse(TBrowser *b)
Browse object. May be overridden for another default action.
Definition TObject.cxx:217
void SetBit(UInt_t f)
Definition TObject.h:200
virtual void Dump() const
Dump contents of object on stdout.
Definition TObject.cxx:366
UInt_t fUniqueID
object unique identifier
Definition TObject.h:44
R__ALWAYS_INLINE Bool_t TestBit(UInt_t f) const
Definition TObject.h:202
virtual const char * GetIconName() const
Returns mime type name of object.
Definition TObject.cxx:467
virtual void RecursiveRemove(TObject *obj)
Recursively remove this object from a list.
Definition TObject.cxx:678
virtual void DoError(int level, const char *location, const char *fmt, va_list va) const
Interface to ErrorHandler (protected).
Definition TObject.cxx:1032
virtual Bool_t HandleTimer(TTimer *timer)
Execute action in response of a timer timing out.
Definition TObject.cxx:511
virtual TObject * Clone(const char *newname="") const
Make a clone of an object using the Streamer facility.
Definition TObject.cxx:242
virtual UInt_t GetUniqueID() const
Return the unique object id.
Definition TObject.cxx:475
@ kIsOnHeap
object is on heap
Definition TObject.h:87
@ kNotDeleted
object has not been deleted
Definition TObject.h:88
@ kBitMask
Definition TObject.h:92
@ kZombie
object ctor failed
Definition TObject.h:89
@ kInconsistent
class overload Hash but does call RecursiveRemove in destructor
Definition TObject.h:90
UInt_t fBits
bit field status word
Definition TObject.h:45
static TString SavePrimitiveVector(std::ostream &out, const char *prefix, Int_t len, Double_t *arr, Bool_t empty_line=kFALSE)
Save array in the output stream "out" as vector.
Definition TObject.cxx:788
virtual Bool_t IsSortable() const
Definition TObject.h:156
virtual Option_t * GetOption() const
Definition TObject.h:145
static Longptr_t fgDtorOnly
object for which to call dtor only (i.e. no delete)
Definition TObject.h:47
void InvertBit(UInt_t f)
Definition TObject.h:204
virtual void SysError(const char *method, const char *msgfmt,...) const
Issue system error message.
Definition TObject.cxx:1085
R__ALWAYS_INLINE Bool_t IsOnHeap() const
Definition TObject.h:158
virtual const char * ClassName() const
Returns name of class to which the object belongs.
Definition TObject.cxx:226
virtual void UseCurrentStyle()
Set current style settings in this object This function is called when either TCanvas::UseCurrentStyl...
Definition TObject.cxx:885
virtual Option_t * GetDrawOption() const
Get option used by the graphics system to draw this object.
Definition TObject.cxx:441
virtual void Warning(const char *method, const char *msgfmt,...) const
Issue warning message.
Definition TObject.cxx:1057
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 clas...
Definition TObject.cxx:1133
virtual TObject * DrawClone(Option_t *option="") const
Draw a clone of this object in the current selected pad with: gROOT->SetSelectedPad(c1).
Definition TObject.cxx:318
virtual void ExecuteEvent(Int_t event, Int_t px, Int_t py)
Execute action corresponding to an event at (px,py).
Definition TObject.cxx:411
virtual TObject * FindObject(const char *name) const
Must be redefined in derived classes.
Definition TObject.cxx:421
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.
Definition TObject.cxx:377
virtual void AppendPad(Option_t *option="")
Append graphics object to current pad.
Definition TObject.cxx:203
virtual char * GetObjectInfo(Int_t px, Int_t py) const
Returns string containing info about the object at position (px,py).
Definition TObject.cxx:486
virtual void SavePrimitive(std::ostream &out, Option_t *option="")
Save a primitive as a C++ statement(s) on output stream "out".
Definition TObject.cxx:835
R__ALWAYS_INLINE Bool_t IsZombie() const
Definition TObject.h:159
virtual Int_t Write(const char *name=nullptr, Int_t option=0, Int_t bufsize=0)
Write this object to the current directory.
Definition TObject.cxx:964
@ kOnlyPrepStep
Used to request that the class specific implementation of TObject::Write just prepare the objects to ...
Definition TObject.h:112
virtual void SaveAs(const char *filename="", Option_t *option="") const
Save this object in the file specified by filename.
Definition TObject.cxx:705
virtual void Delete(Option_t *option="")
Delete this object.
Definition TObject.cxx:267
static Longptr_t GetDtorOnly()
Return destructor only flag.
Definition TObject.cxx:1169
void SetBit(UInt_t f, Bool_t set)
Set or unset the user status bits as specified in f.
Definition TObject.cxx:864
virtual Bool_t InheritsFrom(const char *classname) const
Returns kTRUE if object inherits from class "classname".
Definition TObject.cxx:543
static Bool_t GetObjectStat()
Get status of object stat flag.
Definition TObject.cxx:1154
virtual void Copy(TObject &object) const
Copy this to obj.
Definition TObject.cxx:159
virtual void Error(const char *method, const char *msgfmt,...) const
Issue error message.
Definition TObject.cxx:1071
virtual void SetDrawOption(Option_t *option="")
Set drawing option for object.
Definition TObject.cxx:848
virtual void Fatal(const char *method, const char *msgfmt,...) const
Issue fatal error message.
Definition TObject.cxx:1099
static void SetDtorOnly(void *obj)
Set destructor only flag.
Definition TObject.cxx:1177
virtual void SetUniqueID(UInt_t uid)
Set the unique object id.
Definition TObject.cxx:875
virtual const char * GetTitle() const
Returns title of object.
Definition TObject.cxx:501
EDeprecatedStatusBits
Definition TObject.h:81
@ kObjInCanvas
for backward compatibility only, use kMustCleanup
Definition TObject.h:82
virtual void DrawClass() const
Draw class inheritance tree of the class to which this object belongs.
Definition TObject.cxx:308
Int_t TestBits(UInt_t f) const
Definition TObject.h:203
virtual Int_t Compare(const TObject *obj) const
Compare abstract method.
Definition TObject.cxx:257
void MakeZombie()
Definition TObject.h:53
virtual ~TObject()
TObject destructor.
Definition TObject.cxx:177
static void SavePrimitiveDraw(std::ostream &out, const char *variable_name, Option_t *option=nullptr)
Save invocation of primitive Draw() method Skipped if option contains "nodraw" string.
Definition TObject.cxx:822
virtual void Paint(Option_t *option="")
This method must be overridden if a class wants to paint itself.
Definition TObject.cxx:625
virtual void Print(Option_t *option="") const
This method must be overridden when a class wants to print itself.
Definition TObject.cxx:655
virtual void Pop()
Pop on object drawn in a pad to the top of the display list.
Definition TObject.cxx:634
TObject()
TObject constructor.
Definition TObject.h:257
virtual ULong_t Hash() const
Return hash value for this object.
Definition TObject.cxx:533
virtual void ls(Option_t *option="") const
The ls function lists the contents of a class on stdout.
Definition TObject.cxx:592
static void SavePrimitiveConstructor(std::ostream &out, TClass *cl, const char *variable_name, const char *constructor_agrs="", Bool_t empty_line=kTRUE)
Save object constructor in the output stream "out".
Definition TObject.cxx:771
static Bool_t fgObjectStat
if true keep track of objects in TObjectTable
Definition TObject.h:48
void ResetBit(UInt_t f)
Definition TObject.h:201
EStatusBits
Definition TObject.h:67
@ kCannotPick
if object in a pad cannot be picked
Definition TObject.h:73
@ kNoContextMenu
if object does not want context menu
Definition TObject.h:75
@ kCanDelete
if object in a list can be deleted
Definition TObject.h:68
@ kHasUUID
if object has a TUUID (its fUniqueID=UUIDNumber)
Definition TObject.h:72
@ kInvalidObject
if object ctor succeeded but object should not be used
Definition TObject.h:78
@ kIsReferenced
if object is referenced by a TRef or TRefArray
Definition TObject.h:71
@ kMustCleanup
if object destructor must call RecursiveRemove()
Definition TObject.h:70
virtual Int_t Read(const char *name)
Read contents of object with specified name from the current directory.
Definition TObject.cxx:667
static void AddToTObjectTable(TObject *)
Private helper function which will dispatch to TObjectTable::AddObj.
Definition TObject.cxx:194
void Obsolete(const char *method, const char *asOfVers, const char *removedFromVers) const
Use this method to declare a method obsolete.
Definition TObject.cxx:1142
static void UpdateIsOnHeap(volatile const UInt_t &uniqueID, volatile UInt_t &bits)
Definition TStorage.h:121
static void * ObjectAllocArray(size_t size)
Used to allocate array of TObject on the heap (via TObject::operator new[]()).
Definition TStorage.cxx:303
static void * ObjectAlloc(size_t size)
Used to allocate a TObject on the heap (via TObject::operator new()).
Definition TStorage.cxx:291
Basic string class.
Definition TString.h:139
Handles synchronous and a-synchronous timer events.
Definition TTimer.h:51
std::ostream & Info()
Definition hadd.cxx:177
R__ALWAYS_INLINE bool HasBeenDeleted(const TObject *obj)
Check if the TObject's memory has been deleted.
Definition TObject.h:405
bool DeleteChangesMemory()
Definition TObject.cxx:146
bool DeleteChangesMemoryImpl()
Definition TObject.cxx:89
tbb::task_arena is an alias of tbb::interface7::task_arena, which doesn't allow to forward declare tb...
th1 Draw()