Logo ROOT  
Reference Guide
No Matches
Go to the documentation of this file.
1// @(#)root/base:$Id$
2// Author: Rene Brun 08/12/94
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 *************************************************************************/
12#ifndef ROOT_TROOT
13#define ROOT_TROOT
17// //
18// TROOT //
19// //
20// The TROOT object is the entry point to the system. //
21// The single instance of TROOT is accessible via the global gROOT. //
22// Using the gROOT pointer one has access to basically every object //
23// created in a ROOT based program. The TROOT object is essentially a //
24// container of several lists pointing to the main ROOT objects. //
25// //
28#include "TDirectory.h"
29// #include "TList.h" // included in TDirectory.h
30// #include "RConfigure.h" // included via Rtypes.h
32#include <atomic>
33#include <string>
34#include <vector>
35#include <utility>
37class TClass;
38class TCanvas;
39class TColor;
40class TDataType;
41class TFile;
42class TStyle;
43class TVirtualPad;
44class TApplication;
45class TInterpreter;
46class TBrowser;
47class TGlobal;
48class TFunction;
49class TFolder;
50class TPluginManager;
51class TProcessUUID;
52class TClassGenerator;
53class TVirtualMutex;
54class TROOT;
56class TListOfEnums;
59class TSeqCollection;
65namespace ROOT {
66namespace Internal {
67 class TROOTAllocator;
69 TROOT *GetROOT2();
71 // Manage parallel branch processing
76 public:
79 };
80} } // End ROOT::Internal
82namespace ROOT {
83 /// \brief Enable support for multi-threading within the ROOT code
84 /// in particular, enables the global mutex to make ROOT thread safe/aware.
85 void EnableThreadSafety();
86 /// \brief Enable ROOT's implicit multi-threading for all objects and methods that provide an internal
87 /// parallelisation mechanism.
88 void EnableImplicitMT(UInt_t numthreads = 0);
89 void DisableImplicitMT();
94class TROOT : public TDirectory {
96friend class TCling;
100 Int_t fLineIsProcessing; ///< To synchronize multi-threads
102 static Int_t fgDirLevel; ///< Indentation level for ls()
103 static Bool_t fgRootInit; ///< Singleton initialization flag
105 TROOT(const TROOT&) = delete;
106 TROOT& operator=(const TROOT&) = delete;
109 typedef std::atomic<TListOfEnums*> AListOfEnums_t;
111 TString fConfigOptions; ///< ROOT ./configure set build options
112 TString fConfigFeatures; ///< ROOT ./configure detected build features
113 TString fVersion; ///< ROOT version (from CMZ VERSQQ) ex 0.05/01
114 Int_t fVersionInt; ///< ROOT version in integer format (501)
115 Int_t fVersionCode; ///< ROOT version code as used in RVersion.h
116 Int_t fVersionDate; ///< Date of ROOT version (ex 951226)
117 Int_t fVersionTime; ///< Time of ROOT version (ex 1152)
118 Int_t fBuiltDate; ///< Date of ROOT built
119 Int_t fBuiltTime; ///< Time of ROOT built
120 TString fGitCommit; ///< Git commit SHA1 of built
121 TString fGitBranch; ///< Git branch
122 TString fGitDate; ///< Date and time when make was run
123 Int_t fTimer; ///< Timer flag
124 std::atomic<TApplication*> fApplication; ///< Pointer to current application
125 TInterpreter *fInterpreter; ///< Command interpreter
126 Bool_t fBatch = kTRUE; ///< True if session without graphics
127 TString fWebDisplay; ///< If not empty it defines where web graphics should be rendered (cef, qt5, browser...)
128 Bool_t fIsWebDisplay = kFALSE; ///< True if session with graphics on web
129 Bool_t fIsWebDisplayBatch = kFALSE; ///< True if session with graphics on web and batch mode
130 Bool_t fEditHistograms; ///< True if histograms can be edited with the mouse
131 Bool_t fFromPopUp; ///< True if command executed from a popup menu
132 Bool_t fMustClean; ///< True if object destructor scans canvases
133 Bool_t fForceStyle; ///< Force setting of current style when reading objects
134 Bool_t fInterrupt; ///< True if macro should be interrupted
135 Bool_t fEscape; ///< True if ESC has been pressed
136 Bool_t fExecutingMacro; ///< True while executing a TMacro
137 Int_t fEditorMode; ///< Current Editor mode
138 const TObject *fPrimitive; ///< Currently selected primitive
139 TVirtualPad *fSelectPad; ///< Currently selected pad
140 TCollection *fClasses; ///< List of classes definition
141 TCollection *fTypes; ///< List of data types definition
142 TListOfFunctionTemplates *fFuncTemplate; ///< List of global function templates
143 TListOfDataMembers*fGlobals; ///< List of global variables
144 TListOfFunctions*fGlobalFunctions; ///< List of global functions
145 TSeqCollection *fClosedObjects; ///< List of closed objects from the list of files and sockets, so we can delete them if neededCl.
146 TSeqCollection *fFiles; ///< List of files
147 TSeqCollection *fMappedFiles; ///< List of memory mapped files
148 TSeqCollection *fSockets; ///< List of network sockets
149 TSeqCollection *fCanvases; ///< List of canvases
150 TSeqCollection *fStyles; ///< List of styles
151 TCollection *fFunctions; ///< List of analytic functions
152 TSeqCollection *fTasks; ///< List of tasks
153 TSeqCollection *fColors; ///< List of colors
154 TSeqCollection *fGeometries; ///< List of geometries
155 TSeqCollection *fBrowsers; ///< List of browsers
156 TSeqCollection *fSpecials; ///< List of special objects
157 TSeqCollection *fCleanups; ///< List of recursiveRemove collections
158 TSeqCollection *fMessageHandlers; ///< List of message handlers
159 TSeqCollection *fStreamerInfo; ///< List of active StreamerInfo classes
160 TCollection *fClassGenerators; ///< List of user defined class generators;
161 TSeqCollection *fSecContexts; ///< List of security contexts (TSecContext)
162 TSeqCollection *fProofs; ///< List of proof sessions
163 TSeqCollection *fClipboard; ///< List of clipboard objects
164 TSeqCollection *fDataSets; ///< List of data sets (TDSet or TChain)
165 AListOfEnums_t fEnums; ///< List of enum types
166 TProcessUUID *fUUIDs; ///< Pointer to TProcessID managing TUUIDs
167 TFolder *fRootFolder; ///< top level folder //root
168 TList *fBrowsables; ///< List of browsables
169 TPluginManager *fPluginManager; ///< Keeps track of plugin library handlers
170 TString fCutClassName; ///< Name of default CutG class in graphics editor
171 TString fDefCanvasName; ///< Name of default canvas
173 TROOT(); ///< Only used by Dictionary
174 void InitSystem(); ///< Operating System interface
175 void InitThreads(); ///< Initialize threads library
176 void InitInterpreter(); ///< Initialize interpreter (cling)
177 void ReadGitInfo(); ///< Read Git commit SHA1 and branch name
178 void *operator new(size_t l) { return TObject::operator new(l); }
179 void *operator new(size_t l, void *ptr) { return TObject::operator new(l,ptr); }
181 friend class ::ROOT::Internal::TROOTAllocator;
187 typedef std::vector<std::pair<std::string, int> > FwdDeclArgsToKeepCollection_t;
189 TROOT(const char *name, const char *title, VoidFuncPtr_t *initfunc = nullptr);
190 virtual ~TROOT();
191 void AddClass(TClass *cl);
193 void Append(TObject *obj, Bool_t replace = kFALSE) override;
194 void Browse(TBrowser *b) override;
196 void CloseFiles();
198 TObject *FindObject(const char *name) const override;
199 TObject *FindObject(const TObject *obj) const override;
200 TObject *FindObjectAny(const char *name) const override;
201 TObject *FindObjectAnyFile(const char *name) const override;
202 TObject *FindSpecialObject(const char *name, void *&where);
203 const char *FindObjectClassName(const char *name) const;
204 const char *FindObjectPathName(const TObject *obj) const;
205 TClass *FindSTLClass(const char *name, Bool_t load, Bool_t silent = kFALSE) const;
206 void ForceStyle(Bool_t force = kTRUE) { fForceStyle = force; }
207 Bool_t FromPopUp() const { return fFromPopUp; }
211 TClass *GetClass(const char *name, Bool_t load = kTRUE, Bool_t silent = kFALSE) const;
212 TClass *GetClass(const std::type_info &typeinfo, Bool_t load = kTRUE, Bool_t silent = kFALSE) const;
213 TColor *GetColor(Int_t color) const;
214 const char *GetConfigOptions() const { return fConfigOptions; }
215 const char *GetConfigFeatures() const { return fConfigFeatures; }
216 const char *GetCutClassName() const { return fCutClassName; }
217 const char *GetDefCanvasName() const { return fDefCanvasName; }
219 Int_t GetEditorMode() const { return fEditorMode; }
220 Bool_t GetForceStyle() const { return fForceStyle; }
221 Int_t GetBuiltDate() const { return fBuiltDate; }
222 Int_t GetBuiltTime() const { return fBuiltTime; }
223 const char *GetGitCommit() const { return fGitCommit; }
224 const char *GetGitBranch() const { return fGitBranch; }
225 const char *GetGitDate();
228 Int_t GetVersionInt() const { return fVersionInt; }
230 const char *GetVersion() const { return fVersion; }
243 TCollection *GetListOfFunctionOverloads(const char* name) const;
259 TDataType *GetType(const char *name, Bool_t load = kFALSE) const;
260 TFile *GetFile() const override { if (gDirectory && gDirectory != this) return gDirectory->GetFile(); else return nullptr;}
261 TFile *GetFile(const char *name) const;
263 TStyle *GetStyle(const char *name) const;
264 TObject *GetFunction(const char *name) const;
265 TGlobal *GetGlobal(const char *name, Bool_t load = kFALSE) const;
266 TGlobal *GetGlobal(const TObject *obj, Bool_t load = kFALSE) const;
267 TFunction *GetGlobalFunction(const char *name, const char *params = nullptr, Bool_t load = kFALSE);
268 TFunction *GetGlobalFunctionWithPrototype(const char *name, const char *proto = nullptr, Bool_t load = kFALSE);
269 TObject *GetGeometry(const char *name) const;
270 const TObject *GetSelectedPrimitive() const { return fPrimitive; }
272 Int_t GetNclasses() const;
273 Int_t GetNtypes() const;
274 TFolder *GetRootFolder() const { return fRootFolder; }
275 TProcessUUID *GetUUIDs() const { return fUUIDs; }
276 const TString &GetWebDisplay() const { return fWebDisplay; }
277 void Idle(UInt_t idleTimeInSec, const char *command = nullptr);
278 Int_t IgnoreInclude(const char *fname, const char *expandedfname);
279 Bool_t IsBatch() const { return fBatch; }
281 Bool_t IsFolder() const override { return kTRUE; }
282 Bool_t IsInterrupted() const { return fInterrupt; }
283 Bool_t IsEscaped() const { return fEscape; }
285 Bool_t IsProofServ() const { return fName == "proofserv" ? kTRUE : kFALSE; }
286 Bool_t IsRootFile(const char *filename) const;
289 void ls(Option_t *option = "") const override;
290 Int_t LoadClass(const char *classname, const char *libname, Bool_t check = kFALSE);
291 TClass *LoadClass(const char *name, Bool_t silent = kFALSE) const;
292 Int_t LoadMacro(const char *filename, Int_t *error = nullptr, Bool_t check = kFALSE);
293 Longptr_t Macro(const char *filename, Int_t *error = nullptr, Bool_t padUpdate = kTRUE);
294 TCanvas *MakeDefCanvas() const;
295 void Message(Int_t id, const TObject *obj);
296 Bool_t MustClean() const { return fMustClean; }
297 Longptr_t ProcessLine(const char *line, Int_t *error = nullptr);
298 Longptr_t ProcessLineSync(const char *line, Int_t *error = nullptr);
299 Longptr_t ProcessLineFast(const char *line, Int_t *error = nullptr);
300 Bool_t ReadingObject() const;
301 void RecursiveRemove(TObject *obj) override;
302 void RefreshBrowsers();
303 static void RegisterModule(const char* modulename,
304 const char** headers,
305 const char** includePaths,
306 const char* payLoadCode,
307 const char* fwdDeclCode,
308 void (*triggerFunc)(),
309 const FwdDeclArgsToKeepCollection_t& fwdDeclsArgToSkip,
310 const char** classesHeaders,
311 bool hasCxxModule = false);
312 TObject *Remove(TObject*) override;
313 void RemoveClass(TClass *);
314 void Reset(Option_t *option="");
315 void ResetClassSaved();
316 void SaveContext();
318 /// Set the "Batch mode". If the argument evaluates to `true`, the session does not use interactive graphics.
319 void SetBatch(Bool_t batch = kTRUE) { fIsWebDisplayBatch = fBatch = batch; }
320 void SetWebDisplay(const char *webdisplay = "");
321 void SetCutClassName(const char *name = "TCutG");
322 void SetDefCanvasName(const char *name = "c1") { fDefCanvasName = name; }
324 void SetEditorMode(const char *mode = "");
326 void SetFromPopUp(Bool_t flag = kTRUE) { fFromPopUp = flag; }
327 void SetInterrupt(Bool_t flag = kTRUE) { fInterrupt = flag; }
328 void SetEscape(Bool_t flag = kTRUE) { fEscape = flag; }
331 void SetReadingObject(Bool_t flag = kTRUE);
332 void SetMustClean(Bool_t flag = kTRUE) { fMustClean=flag; }
333 void SetSelectedPrimitive(const TObject *obj) { fPrimitive = obj; }
335 void SetStyle(const char *stylename = "Default");
336 void Time(Int_t casetime=1) { fTimer = casetime; }
337 Int_t Timer() const { return fTimer; }
339 //---- static functions
340 static Int_t DecreaseDirLevel();
341 static Int_t GetDirLevel();
342 static const char *GetMacroPath();
343 static void SetMacroPath(const char *newpath);
344 static Int_t IncreaseDirLevel();
345 static void IndentLevel();
346 static void Initialize();
347 static Bool_t Initialized();
348 static void SetDirLevel(Int_t level = 0);
351 static Int_t RootVersionCode();
352 static const std::vector<std::string> &AddExtraInterpreterArgs(const std::vector<std::string> &args);
353 static const char**&GetExtraInterpreterArgs();
355 static const TString& GetRootSys();
356 static const TString& GetBinDir();
357 static const TString& GetLibDir();
358 static const TString& GetSharedLibDir();
359 static const TString& GetIncludeDir();
360 static const TString& GetEtcDir();
361 static const TString& GetDataDir();
362 static const TString& GetDocDir();
363 static const TString& GetMacroDir();
364 static const TString& GetTutorialDir();
365 static const TString& GetSourceDir();
366 static const TString& GetIconPath();
367 static const TString& GetTTFFontDir();
369 // Backward compatibility function - do not use for new code
370 static const char *GetTutorialsDir();
371 static void ShutDown();
373 ClassDefOverride(TROOT,0) //Top level (or root) structure for all classes
377namespace ROOT {
378 TROOT *GetROOT();
379 namespace Internal {
382 inline void SetRequireCleanup(TObject &obj) {
384 obj.SetUniqueID(0);
385 }
388 return obj.TestBit(kIsReferenced) && obj.GetUniqueID() == 0;
389 }
390 }
392 /// \brief call RecursiveRemove for obj if gROOT is valid
393 /// and obj.TestBit(kMustCleanup) is true.
394 /// Note: this reset the kMustCleanup bit to allow
395 /// harmless multiple call to this function.
397 {
398 if (obj.TestBit(kMustCleanup)) {
400 if (root && root != &obj && (root->MustClean() || Internal::RequiresCleanup(obj))) {
401 root->RecursiveRemove(&obj);
403 }
404 }
405 }
407#define gROOT (ROOT::GetROOT())
#define R__EXTERN
Definition DllImport.h:27
#define b(i)
Definition RSha256.hxx:100
bool Bool_t
Definition RtypesCore.h:63
int Int_t
Definition RtypesCore.h:45
long Longptr_t
Definition RtypesCore.h:82
unsigned int UInt_t
Definition RtypesCore.h:46
constexpr Bool_t kFALSE
Definition RtypesCore.h:101
constexpr Bool_t kTRUE
Definition RtypesCore.h:100
const char Option_t
Definition RtypesCore.h:66
void(* VoidFuncPtr_t)()
Definition Rtypes.h:79
#define ClassDefOverride(name, id)
Definition Rtypes.h:341
#define gDirectory
Definition TDirectory.h:384
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 mode
char name[80]
Definition TGX11.cxx:110
@ kIsReferenced
Definition TObject.h:370
@ kMustCleanup
Definition TObject.h:368
R__EXTERN TVirtualMutex * gROOTMutex
Definition TROOT.h:63
const char * proto
Definition civetweb.c:17536
This class creates the ROOT Application Environment that interfaces to the windowing system eventloop...
Using a TBrowser one can browse all ROOT objects.
Definition TBrowser.h:37
The Canvas class.
Definition TCanvas.h:23
Objects following this interface can be passed onto the TROOT object to implement a user customized w...
TClass instances represent classes, structs and namespaces in the ROOT type system.
Definition TClass.h:81
This class defines an interface to the cling C++ interpreter.
Definition TCling.h:102
Collection abstract base class.
Definition TCollection.h:65
The color creation and management class.
Definition TColor.h:19
Basic data type descriptor (datatype information is obtained from CINT).
Definition TDataType.h:44
TFile * GetFile() const override
Describe directory structure in memory.
Definition TDirectory.h:45
A ROOT file is composed of a header, followed by consecutive data records (TKey instances) with a wel...
Definition TFile.h:53
<div class="legacybox"><h2>Legacy Code</h2> TFolder is a legacy interface: there will be no bug fixes...
Definition TFolder.h:30
Dictionary for function template This class describes one single function template.
Global functions class (global functions are obtained from CINT).
Definition TFunction.h:30
Global variables class (global variables are obtained from CINT).
Definition TGlobal.h:28
This class defines an abstract interface to a generic command line interpreter.
A collection of TDataMember objects designed for fast access given a DeclId_t and for keep track of T...
A collection of TEnum objects designed for fast access given a DeclId_t and for keep track of TEnum t...
A collection of TFunction objects designed for fast access given a DeclId_t and for keep track of TFu...
A collection of TFunction objects designed for fast access given a DeclId_t and for keep track of TFu...
A doubly linked list.
Definition TList.h:38
TString fName
Definition TNamed.h:32
Mother of all ROOT objects.
Definition TObject.h:41
R__ALWAYS_INLINE Bool_t TestBit(UInt_t f) const
Definition TObject.h:199
virtual UInt_t GetUniqueID() const
Return the unique object id.
Definition TObject.cxx:457
void SetBit(UInt_t f, Bool_t set)
Set or unset the user status bits as specified in f.
Definition TObject.cxx:780
virtual void SetUniqueID(UInt_t uid)
Set the unique object id.
Definition TObject.cxx:791
void ResetBit(UInt_t f)
Definition TObject.h:198
This class implements a plugin library manager.
This class is a specialized TProcessID managing the list of UUIDs.
ROOT top level object description.
Definition TROOT.h:94
void SetApplication(TApplication *app)
Definition TROOT.h:317
static Int_t IncreaseDirLevel()
Increase the indentation level for ls().
Definition TROOT.cxx:2862
Int_t GetVersionInt() const
Definition TROOT.h:228
const char * GetConfigFeatures() const
Definition TROOT.h:215
TSeqCollection * GetListOfCleanups() const
Definition TROOT.h:248
void Time(Int_t casetime=1)
Definition TROOT.h:336
Int_t IgnoreInclude(const char *fname, const char *expandedfname)
Return 1 if the name of the given include file corresponds to a class that is known to ROOT,...
Definition TROOT.cxx:1927
Int_t fVersionCode
ROOT version code as used in RVersion.h.
Definition TROOT.h:115
const char * GetDefCanvasName() const
Definition TROOT.h:217
Bool_t IsInterrupted() const
Definition TROOT.h:282
const TString & GetWebDisplay() const
Definition TROOT.h:276
TCollection * GetListOfClasses() const
Definition TROOT.h:231
void Message(Int_t id, const TObject *obj)
Process message id called by obj.
Definition TROOT.cxx:2349
void RemoveClass(TClass *)
Remove a class from the list and map of classes.
Definition TROOT.cxx:2627
TSeqCollection * fProofs
List of proof sessions.
Definition TROOT.h:162
TCollection * fClassGenerators
List of user defined class generators;.
Definition TROOT.h:160
Only used by Dictionary.
Definition TROOT.cxx:605
void SetCutClassName(const char *name="TCutG")
Set the default graphical cut class name for the graphics editor By default the graphics editor creat...
Definition TROOT.cxx:2682
TSeqCollection * fCanvases
List of canvases.
Definition TROOT.h:149
TObject * FindObjectAnyFile(const char *name) const override
Scan the memory lists of all files for an object with name.
Definition TROOT.cxx:1446
const TObject * fPrimitive
Currently selected primitive.
Definition TROOT.h:138
void SetWebDisplay(const char *webdisplay="")
Specify where web graphics shall be rendered.
Definition TROOT.cxx:2811
Bool_t fIsWebDisplay
True if session with graphics on web.
Definition TROOT.h:128
TFolder * fRootFolder
top level folder //root
Definition TROOT.h:167
void AddClassGenerator(TClassGenerator *gen)
Add a class generator.
Definition TROOT.cxx:1045
const char * GetCutClassName() const
Definition TROOT.h:216
Int_t GetBuiltTime() const
Definition TROOT.h:222
void SetFromPopUp(Bool_t flag=kTRUE)
Definition TROOT.h:326
TSeqCollection * fGeometries
List of geometries.
Definition TROOT.h:154
TString fCutClassName
Name of default CutG class in graphics editor.
Definition TROOT.h:170
TInterpreter * fInterpreter
Command interpreter.
Definition TROOT.h:125
Bool_t IsProofServ() const
Definition TROOT.h:285
TSeqCollection * GetListOfMessageHandlers() const
Definition TROOT.h:250
std::vector< std::pair< std::string, int > > FwdDeclArgsToKeepCollection_t
Definition TROOT.h:187
Int_t fVersionTime
Time of ROOT version (ex 1152)
Definition TROOT.h:117
void SetLineIsProcessing()
Definition TROOT.h:329
void SetMustClean(Bool_t flag=kTRUE)
Definition TROOT.h:332
void EndOfProcessCleanups()
Execute the cleanups necessary at the end of the process, in particular those that must be executed b...
Definition TROOT.cxx:1258
Bool_t fBatch
True if session without graphics.
Definition TROOT.h:126
Bool_t IsWebDisplayBatch() const
Definition TROOT.h:288
TSeqCollection * GetListOfFiles() const
Definition TROOT.h:237
Bool_t fEscape
True if ESC has been pressed.
Definition TROOT.h:135
static const TString & GetBinDir()
Get the binary directory in the installation. Static utility function.
Definition TROOT.cxx:2968
TSeqCollection * GetListOfSockets() const
Definition TROOT.h:239
Int_t fVersionInt
ROOT version in integer format (501)
Definition TROOT.h:114
static const TString & GetIncludeDir()
Get the include directory in the installation. Static utility function.
Definition TROOT.cxx:3021
Bool_t fFromPopUp
True if command executed from a popup menu.
Definition TROOT.h:131
void Idle(UInt_t idleTimeInSec, const char *command=nullptr)
Execute command when system has been idle for idleTimeInSec seconds.
Definition TROOT.cxx:1891
TSeqCollection * fSockets
List of network sockets.
Definition TROOT.h:148
void ls(Option_t *option="") const override
To list all objects of the application.
Definition TROOT.cxx:2249
Bool_t IsEscaped() const
Definition TROOT.h:283
static const char * GetMacroPath()
Get macro search path. Static utility function.
Definition TROOT.cxx:2761
TCollection * fFunctions
List of analytic functions.
Definition TROOT.h:151
Int_t GetVersionDate() const
Definition TROOT.h:226
void SaveContext()
Save the current interpreter context.
Definition TROOT.cxx:2670
TCollection * GetListOfClassGenerators() const
Definition TROOT.h:251
Bool_t IsExecutingMacro() const
Definition TROOT.h:280
TDataType * GetType(const char *name, Bool_t load=kFALSE) const
Return pointer to type with name.
Definition TROOT.cxx:1572
static void Initialize()
Initialize ROOT explicitly.
Definition TROOT.cxx:2878
static void ShutDown()
Shut down ROOT.
Definition TROOT.cxx:3115
TObject * GetFunction(const char *name) const
Return pointer to function with name.
Definition TROOT.cxx:1597
static Int_t ConvertVersionCode2Int(Int_t code)
Convert version code to an integer, i.e. 331527 -> 51507.
Definition TROOT.cxx:2901
TSeqCollection * fMessageHandlers
List of message handlers.
Definition TROOT.h:158
void SetStyle(const char *stylename="Default")
Change current style to style with name stylename.
Definition TROOT.cxx:2729
TSeqCollection * GetListOfMappedFiles() const
Definition TROOT.h:238
void SetEditHistograms(Bool_t flag=kTRUE)
Definition TROOT.h:323
AListOfEnums_t fEnums
List of enum types.
Definition TROOT.h:165
void ReadGitInfo()
Read Git commit SHA1 and branch name.
Definition TROOT.cxx:2428
void ForceStyle(Bool_t force=kTRUE)
Definition TROOT.h:206
static Bool_t fgRootInit
Singleton initialization flag.
Definition TROOT.h:103
void RefreshBrowsers()
Refresh all browsers.
Definition TROOT.cxx:2511
void CloseFiles()
Close any files and sockets that gROOT knows about.
Definition TROOT.cxx:1178
const char * GetVersion() const
Definition TROOT.h:230
std::atomic< TApplication * > fApplication
Pointer to current application.
Definition TROOT.h:124
const char * FindObjectPathName(const TObject *obj) const
Return path name of obj somewhere in the //root/... path.
Definition TROOT.cxx:1483
static Int_t ConvertVersionInt2Code(Int_t v)
Convert version as an integer to version code as used in RVersion.h.
Definition TROOT.cxx:2909
void ResetClassSaved()
Reset the ClassSaved status of all classes.
Definition TROOT.cxx:1106
static const TString & GetTTFFontDir()
Get the fonts directory in the installation. Static utility function.
Definition TROOT.cxx:3168
const char * GetGitBranch() const
Definition TROOT.h:224
Bool_t fForceStyle
Force setting of current style when reading objects.
Definition TROOT.h:133
Bool_t FromPopUp() const
Definition TROOT.h:207
const TObject * GetSelectedPrimitive() const
Definition TROOT.h:270
TCanvas * MakeDefCanvas() const
Return a default canvas.
Definition TROOT.cxx:1564
TCollection * fTypes
List of data types definition.
Definition TROOT.h:141
TColor * GetColor(Int_t color) const
Return address of color with index color.
Definition TROOT.cxx:1546
Bool_t IsLineProcessing() const
Definition TROOT.h:284
TGlobal * GetGlobal(const char *name, Bool_t load=kFALSE) const
Return pointer to global variable by name.
Definition TROOT.cxx:1630
TClass * FindSTLClass(const char *name, Bool_t load, Bool_t silent=kFALSE) const
return a TClass object corresponding to 'name' assuming it is an STL container.
Definition TROOT.cxx:1494
TSeqCollection * fStreamerInfo
List of active StreamerInfo classes.
Definition TROOT.h:159
void Append(TObject *obj, Bool_t replace=kFALSE) override
Append object to this directory.
Definition TROOT.cxx:1057
static const TString & GetIconPath()
Get the icon path in the installation. Static utility function.
Definition TROOT.cxx:3147
TSeqCollection * GetListOfCanvases() const
Definition TROOT.h:240
std::atomic< TListOfEnums * > AListOfEnums_t
Definition TROOT.h:109
TCollection * GetListOfGlobalFunctions(Bool_t load=kFALSE)
Return list containing the TFunctions currently defined.
Definition TROOT.cxx:1825
TString fGitDate
Date and time when make was run.
Definition TROOT.h:122
TSeqCollection * fSpecials
List of special objects.
Definition TROOT.h:156
TCollection * GetListOfFunctionTemplates()
Definition TROOT.cxx:1770
void SetExecutingMacro(Bool_t flag=kTRUE)
Definition TROOT.h:325
static void RegisterModule(const char *modulename, const char **headers, const char **includePaths, const char *payLoadCode, const char *fwdDeclCode, void(*triggerFunc)(), const FwdDeclArgsToKeepCollection_t &fwdDeclsArgToSkip, const char **classesHeaders, bool hasCxxModule=false)
Called by static dictionary initialization to register clang modules for headers.
Definition TROOT.cxx:2534
TObject * FindObject(const char *name) const override
Returns address of a ROOT object if it exists.
Definition TROOT.cxx:1323
TCollection * fClasses
List of classes definition.
Definition TROOT.h:140
void SetInterrupt(Bool_t flag=kTRUE)
Definition TROOT.h:327
Bool_t fEditHistograms
True if histograms can be edited with the mouse.
Definition TROOT.h:130
TListOfDataMembers * fGlobals
List of global variables.
Definition TROOT.h:143
TListOfFunctionTemplates * fFuncTemplate
List of global function templates.
Definition TROOT.h:142
TSeqCollection * GetClipboard() const
Definition TROOT.h:254
Int_t fTimer
Timer flag.
Definition TROOT.h:123
TSeqCollection * fDataSets
List of data sets (TDSet or TChain)
Definition TROOT.h:164
TString fConfigOptions
ROOT ./configure set build options.
Definition TROOT.h:111
TStyle * GetStyle(const char *name) const
Return pointer to style with name.
Definition TROOT.cxx:1589
TCollection * GetListOfEnums(Bool_t load=kFALSE)
Definition TROOT.cxx:1753
Longptr_t ProcessLineSync(const char *line, Int_t *error=nullptr)
Process interpreter command via TApplication::ProcessLine().
Definition TROOT.cxx:2389
void InitInterpreter()
Initialize interpreter (cling)
Definition TROOT.cxx:2063
TCollection * GetListOfGlobals(Bool_t load=kFALSE)
Return list containing the TGlobals currently defined.
Definition TROOT.cxx:1787
TVirtualPad * GetSelectedPad() const
Definition TROOT.h:271
static void SetDirLevel(Int_t level=0)
Return Indentation level for ls().
Definition TROOT.cxx:2893
TSeqCollection * fSecContexts
List of security contexts (TSecContext)
Definition TROOT.h:161
TString fWebDisplay
If not empty it defines where web graphics should be rendered (cef, qt5, browser.....
Definition TROOT.h:127
static const char * GetTutorialsDir()
Get the tutorials directory in the installation.
Definition TROOT.cxx:3190
TCollection * GetListOfFunctionOverloads(const char *name) const
Return the collection of functions named "name".
Definition TROOT.cxx:1671
TSeqCollection * fCleanups
List of recursiveRemove collections.
Definition TROOT.h:157
static Bool_t Initialized()
Return kTRUE if the TROOT object has been initialized.
Definition TROOT.cxx:2885
TApplication * GetApplication() const
Definition TROOT.h:209
void SetBatch(Bool_t batch=kTRUE)
Set the "Batch mode". If the argument evaluates to true, the session does not use interactive graphic...
Definition TROOT.h:319
Int_t fLineIsProcessing
To synchronize multi-threads.
Definition TROOT.h:100
Int_t Timer() const
Definition TROOT.h:337
static const TString & GetSourceDir()
Get the source directory in the installation. Static utility function.
Definition TROOT.cxx:3126
static const TString & GetMacroDir()
Get the macro directory in the installation. Static utility function.
Definition TROOT.cxx:3073
TString fGitCommit
Git commit SHA1 of built.
Definition TROOT.h:120
Longptr_t ProcessLine(const char *line, Int_t *error=nullptr)
Process interpreter command via TApplication::ProcessLine().
Definition TROOT.cxx:2369
TSeqCollection * fClosedObjects
List of closed objects from the list of files and sockets, so we can delete them if neededCl.
Definition TROOT.h:145
TSeqCollection * fTasks
List of tasks.
Definition TROOT.h:152
TSeqCollection * fClipboard
List of clipboard objects.
Definition TROOT.h:163
const char * GetGitDate()
Return date/time make was run.
Definition TROOT.cxx:2473
TProcessUUID * GetUUIDs() const
Definition TROOT.h:275
void SetEditorMode(const char *mode="")
Set editor mode.
Definition TROOT.cxx:2703
TSeqCollection * GetListOfStreamerInfo() const
Definition TROOT.h:249
static const TString & GetTutorialDir()
Get the tutorials directory in the installation. Static utility function.
Definition TROOT.cxx:3094
virtual ~TROOT()
Clean up and free resources used by ROOT (files, network sockets, shared memory segments,...
Definition TROOT.cxx:877
TSeqCollection * fColors
List of colors.
Definition TROOT.h:153
Int_t GetBuiltDate() const
Definition TROOT.h:221
TCollection * GetListOfFunctions() const
Definition TROOT.h:242
TFunction * GetGlobalFunctionWithPrototype(const char *name, const char *proto=nullptr, Bool_t load=kFALSE)
Return pointer to global function by name.
Definition TROOT.cxx:1717
Bool_t GetForceStyle() const
Definition TROOT.h:220
TFolder * GetRootFolder() const
Definition TROOT.h:274
TSeqCollection * GetListOfBrowsers() const
Definition TROOT.h:245
Bool_t ReadingObject() const
Deprecated (will be removed in next release).
Definition TROOT.cxx:2459
TSeqCollection * fStyles
List of styles.
Definition TROOT.h:150
TSeqCollection * GetListOfProofs() const
Definition TROOT.h:253
Bool_t GetEditHistograms() const
Definition TROOT.h:218
Int_t fVersionDate
Date of ROOT version (ex 951226)
Definition TROOT.h:116
TSeqCollection * GetListOfColors() const
Definition TROOT.h:232
Longptr_t Macro(const char *filename, Int_t *error=nullptr, Bool_t padUpdate=kTRUE)
Execute a macro in the interpreter.
Definition TROOT.cxx:2315
Int_t fBuiltTime
Time of ROOT built.
Definition TROOT.h:119
static const std::vector< std::string > & AddExtraInterpreterArgs(const std::vector< std::string > &args)
Provide command line arguments to the interpreter construction.
Definition TROOT.cxx:2931
void SetLineHasBeenProcessed()
Definition TROOT.h:330
TClass * GetClass(const char *name, Bool_t load=kTRUE, Bool_t silent=kFALSE) const
Return pointer to class with name. Obsolete, use TClass::GetClass directly.
Definition TROOT.cxx:1528
TVirtualPad * fSelectPad
Currently selected pad.
Definition TROOT.h:139
TSeqCollection * fFiles
List of files.
Definition TROOT.h:146
void Browse(TBrowser *b) override
Add browsable objects to TBrowser.
Definition TROOT.cxx:1066
static const TString & GetRootSys()
Get the rootsys directory in the installation. Static utility function.
Definition TROOT.cxx:2958
TListOfFunctions * GetGlobalFunctions()
Internal routine returning, and creating if necessary, the list of global function.
Definition TROOT.cxx:1662
Bool_t fInterrupt
True if macro should be interrupted.
Definition TROOT.h:134
Bool_t fMustClean
True if object destructor scans canvases.
Definition TROOT.h:132
Int_t LoadClass(const char *classname, const char *libname, Bool_t check=kFALSE)
Check if class "classname" is known to the interpreter (in fact, this check is not needed anymore,...
Definition TROOT.cxx:2182
TFunction * GetGlobalFunction(const char *name, const char *params=nullptr, Bool_t load=kFALSE)
Return pointer to global function by name.
Definition TROOT.cxx:1684
void AddClass(TClass *cl)
Add a class to the list and map of classes.
Definition TROOT.cxx:1035
static Int_t RootVersionCode()
Return ROOT version code as defined in RVersion.h.
Definition TROOT.cxx:2920
TObject * FindSpecialObject(const char *name, void *&where)
Returns address and folder of a ROOT object if it exists.
Definition TROOT.cxx:1377
TObject * Remove(TObject *) override
Remove an object from the in-memory list.
Definition TROOT.cxx:2617
void InitSystem()
Operating System interface.
Definition TROOT.cxx:1977
Longptr_t ProcessLineFast(const char *line, Int_t *error=nullptr)
Process interpreter command directly via CINT interpreter.
Definition TROOT.cxx:2406
Int_t GetEditorMode() const
Definition TROOT.h:219
Bool_t ClassSaved(TClass *cl)
return class status 'ClassSaved' for class cl This function is called by the SavePrimitive functions ...
Definition TROOT.cxx:1093
const char * GetGitCommit() const
Definition TROOT.h:223
TString fGitBranch
Git branch.
Definition TROOT.h:121
TCollection * GetListOfTypes(Bool_t load=kFALSE)
Return a dynamic list giving access to all TDataTypes (typedefs) currently defined.
Definition TROOT.cxx:1864
static Int_t fgDirLevel
Indentation level for ls()
Definition TROOT.h:102
TSeqCollection * GetListOfTasks() const
Definition TROOT.h:247
Bool_t IsBatch() const
Definition TROOT.h:279
Bool_t IsRootFile(const char *filename) const
Return true if the file is local and is (likely) to be a ROOT file.
Definition TROOT.cxx:2229
Bool_t IsWebDisplay() const
Definition TROOT.h:287
static void IndentLevel()
Functions used by ls() to indent an object hierarchy.
Definition TROOT.cxx:2870
Int_t GetVersionTime() const
Definition TROOT.h:227
static const TString & GetDocDir()
Get the documentation directory in the installation. Static utility function.
Definition TROOT.cxx:3057
static const TString & GetEtcDir()
Get the sysconfig directory in the installation. Static utility function.
Definition TROOT.cxx:3031
TROOT(const TROOT &)=delete
Int_t GetNclasses() const
Get number of classes.
Definition TROOT.cxx:1875
static const char **& GetExtraInterpreterArgs()
INTERNAL function! Used by rootcling to inject interpreter arguments through a C-interface layer.
Definition TROOT.cxx:2941
static void SetMacroPath(const char *newpath)
Set or extend the macro search path.
Definition TROOT.cxx:2787
void SetSelectedPad(TVirtualPad *pad)
Definition TROOT.h:334
void InitThreads()
Initialize threads library.
Definition TROOT.cxx:2052
TProcessUUID * fUUIDs
Pointer to TProcessID managing TUUIDs.
Definition TROOT.h:166
TString fConfigFeatures
ROOT ./configure detected build features.
Definition TROOT.h:112
TFunctionTemplate * GetFunctionTemplate(const char *name)
Definition TROOT.cxx:1617
TPluginManager * fPluginManager
Keeps track of plugin library handlers.
Definition TROOT.h:169
TObject * GetGeometry(const char *name) const
Return pointer to Geometry with name.
Definition TROOT.cxx:1746
void RecursiveRemove(TObject *obj) override
Recursively remove this object from the list of Cleanups.
Definition TROOT.cxx:2497
Bool_t fExecutingMacro
True while executing a TMacro.
Definition TROOT.h:136
TList * GetListOfBrowsables() const
Definition TROOT.h:258
Int_t fBuiltDate
Date of ROOT built.
Definition TROOT.h:118
Bool_t fIsWebDisplayBatch
True if session with graphics on web and batch mode.
Definition TROOT.h:129
static const TString & GetSharedLibDir()
Get the shared libraries directory in the installation. Static utility function.
Definition TROOT.cxx:3010
void SetEscape(Bool_t flag=kTRUE)
Definition TROOT.h:328
Int_t GetVersionCode() const
Definition TROOT.h:229
TSeqCollection * fMappedFiles
List of memory mapped files.
Definition TROOT.h:147
Int_t GetNtypes() const
Get number of types.
Definition TROOT.cxx:1883
TSeqCollection * GetListOfSpecials() const
Definition TROOT.h:246
Int_t LoadMacro(const char *filename, Int_t *error=nullptr, Bool_t check=kFALSE)
Load a macro in the interpreter's memory.
Definition TROOT.cxx:2267
TFile * GetFile() const override
Definition TROOT.h:260
static const TString & GetLibDir()
Get the library directory in the installation. Static utility function.
Definition TROOT.cxx:2989
void SetDefCanvasName(const char *name="c1")
Definition TROOT.h:322
TSeqCollection * fBrowsers
List of browsers.
Definition TROOT.h:155
TString fDefCanvasName
Name of default canvas.
Definition TROOT.h:171
TListOfFunctions * fGlobalFunctions
List of global functions.
Definition TROOT.h:144
TList * fBrowsables
List of browsables.
Definition TROOT.h:168
TObject * FindObjectAny(const char *name) const override
Return a pointer to the first object with name starting at //root.
Definition TROOT.cxx:1436
static Int_t DecreaseDirLevel()
Decrease the indentation level for ls().
Definition TROOT.cxx:2745
Bool_t IsFolder() const override
Returns kTRUE in case object contains browsable objects (like containers or lists of other objects).
Definition TROOT.h:281
void SetSelectedPrimitive(const TObject *obj)
Definition TROOT.h:333
void Reset(Option_t *option="")
Delete all global interpreter objects created since the last call to Reset.
Definition TROOT.cxx:2650
Int_t fEditorMode
Current Editor mode.
Definition TROOT.h:137
const char * FindObjectClassName(const char *name) const
Returns class name of a ROOT object including CINT globals.
Definition TROOT.cxx:1463
TSeqCollection * GetListOfDataSets() const
Definition TROOT.h:255
Bool_t MustClean() const
Definition TROOT.h:296
TSeqCollection * GetListOfClosedObjects() const
Definition TROOT.h:236
const char * GetConfigOptions() const
Definition TROOT.h:214
static const TString & GetDataDir()
Get the data directory in the installation. Static utility function.
Definition TROOT.cxx:3041
TROOT & operator=(const TROOT &)=delete
TSeqCollection * GetListOfSecContexts() const
Definition TROOT.h:252
TSeqCollection * GetListOfGeometries() const
Definition TROOT.h:244
TSeqCollection * GetListOfStyles() const
Definition TROOT.h:241
TString fVersion
ROOT version (from CMZ VERSQQ) ex 0.05/01.
Definition TROOT.h:113
static Int_t GetDirLevel()
return directory level
Definition TROOT.cxx:2753
void SetReadingObject(Bool_t flag=kTRUE)
Definition TROOT.cxx:2464
TInterpreter * GetInterpreter() const
Definition TROOT.h:210
TPluginManager * GetPluginManager() const
Definition TROOT.h:208
Sequenceable collection abstract base class.
Basic string class.
Definition TString.h:139
TStyle objects may be created to define special styles.
Definition TStyle.h:29
This class implements a mutex interface.
TVirtualPad is an abstract base class for the Pad and Canvas classes.
Definition TVirtualPad.h:51
TLine * line
void SetRequireCleanup(TObject &obj)
Definition TROOT.h:382
Definition TROOT.h:380
void DisableParBranchProcessing()
Globally disables the IMT use case of parallel branch processing, deactivating the corresponding lock...
Definition TROOT.cxx:434
void EnableParBranchProcessing()
Globally enables the parallel branch processing, which is a case of implicit multi-threading (IMT) in...
Definition TROOT.cxx:420
Bool_t IsParBranchProcessingEnabled()
Returns true if parallel branch processing is enabled.
Definition TROOT.cxx:447
Definition TROOT.cxx:387
Bool_t RequiresCleanup(TObject &obj)
Definition TROOT.h:387
This file contains a specialised ROOT message handler to test for diagnostic in unit tests.
void EnableImplicitMT(UInt_t numthreads=0)
Enable ROOT's implicit multi-threading for all objects and methods that provide an internal paralleli...
Definition TROOT.cxx:539
Bool_t IsImplicitMTEnabled()
Returns true if the implicit multi-threading in ROOT is enabled.
Definition TROOT.cxx:570
UInt_t GetThreadPoolSize()
Returns the size of ROOT's thread pool.
Definition TROOT.cxx:577
void EnableThreadSafety()
Enable support for multi-threading within the ROOT code in particular, enables the global mutex to ma...
Definition TROOT.cxx:501
void CallRecursiveRemoveIfNeeded(TObject &obj)
call RecursiveRemove for obj if gROOT is valid and obj.TestBit(kMustCleanup) is true.
Definition TROOT.h:396
Definition TROOT.cxx:472
void DisableImplicitMT()
Disables the implicit multi-threading in ROOT (see EnableImplicitMT).
Definition TROOT.cxx:556
TLine l
Definition textangle.C:4