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 SaveContext();
317 /// Set the "Batch mode". If the argument evaluates to `true`, the session does not use interactive graphics.
318 void SetBatch(Bool_t batch = kTRUE) { fIsWebDisplayBatch = fBatch = batch; }
319 void SetWebDisplay(const char *webdisplay = "");
320 void SetCutClassName(const char *name = "TCutG");
321 void SetDefCanvasName(const char *name = "c1") { fDefCanvasName = name; }
323 void SetEditorMode(const char *mode = "");
325 void SetFromPopUp(Bool_t flag = kTRUE) { fFromPopUp = flag; }
326 void SetInterrupt(Bool_t flag = kTRUE) { fInterrupt = flag; }
327 void SetEscape(Bool_t flag = kTRUE) { fEscape = flag; }
330 void SetReadingObject(Bool_t flag = kTRUE);
331 void SetMustClean(Bool_t flag = kTRUE) { fMustClean=flag; }
332 void SetSelectedPrimitive(const TObject *obj) { fPrimitive = obj; }
334 void SetStyle(const char *stylename = "Default");
335 void Time(Int_t casetime=1) { fTimer = casetime; }
336 Int_t Timer() const { return fTimer; }
338 //---- static functions
339 static Int_t DecreaseDirLevel();
340 static Int_t GetDirLevel();
341 static const char *GetMacroPath();
342 static void SetMacroPath(const char *newpath);
343 static Int_t IncreaseDirLevel();
344 static void IndentLevel();
345 static void Initialize();
346 static Bool_t Initialized();
347 static void SetDirLevel(Int_t level = 0);
350 static Int_t RootVersionCode();
351 static const std::vector<std::string> &AddExtraInterpreterArgs(const std::vector<std::string> &args);
352 static const char**&GetExtraInterpreterArgs();
354 static const TString& GetRootSys();
355 static const TString& GetBinDir();
356 static const TString& GetLibDir();
357 static const TString& GetIncludeDir();
358 static const TString& GetEtcDir();
359 static const TString& GetDataDir();
360 static const TString& GetDocDir();
361 static const TString& GetMacroDir();
362 static const TString& GetTutorialDir();
363 static const TString& GetSourceDir();
364 static const TString& GetIconPath();
365 static const TString& GetTTFFontDir();
367 // Backward compatibility function - do not use for new code
368 static const char *GetTutorialsDir();
369 static void ShutDown();
371 ClassDefOverride(TROOT,0) //Top level (or root) structure for all classes
375namespace ROOT {
376 TROOT *GetROOT();
377 namespace Internal {
380 inline void SetRequireCleanup(TObject &obj) {
382 obj.SetUniqueID(0);
383 }
386 return obj.TestBit(kIsReferenced) && obj.GetUniqueID() == 0;
387 }
388 }
390 /// \brief call RecursiveRemove for obj if gROOT is valid
391 /// and obj.TestBit(kMustCleanup) is true.
392 /// Note: this reset the kMustCleanup bit to allow
393 /// harmless multiple call to this function.
395 {
396 if (obj.TestBit(kMustCleanup)) {
398 if (root && root != &obj && (root->MustClean() || Internal::RequiresCleanup(obj))) {
399 root->RecursiveRemove(&obj);
401 }
402 }
403 }
405#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:386
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
@ kIsReferenced
Definition TObject.h:372
@ kMustCleanup
Definition TObject.h:370
R__EXTERN TVirtualMutex * gROOTMutex
Definition TROOT.h:63
const char * proto
Definition civetweb.c:17502
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
const char * name
Definition TDirectory.h:308
A ROOT file is a suite of consecutive data records (TKey instances) with a well defined format.
Definition TFile.h:51
<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:201
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:774
virtual void SetUniqueID(UInt_t uid)
Set the unique object id.
Definition TObject.cxx:785
void ResetBit(UInt_t f)
Definition TObject.h:200
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:316
static Int_t IncreaseDirLevel()
Increase the indentation level for ls().
Definition TROOT.cxx:2826
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:335
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:1889
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:2311
void RemoveClass(TClass *)
Remove a class from the list and map of classes.
Definition TROOT.cxx:2595
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:593
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:2650
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:1408
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:2779
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:1026
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:325
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:328
void SetMustClean(Bool_t flag=kTRUE)
Definition TROOT.h:331
void EndOfProcessCleanups()
Execute the cleanups necessary at the end of the process, in particular those that must be executed b...
Definition TROOT.cxx:1220
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:2932
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:2974
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:1853
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:2211
Bool_t IsEscaped() const
Definition TROOT.h:283
static const char * GetMacroPath()
Get macro search path. Static utility function.
Definition TROOT.cxx:2729
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:2638
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:1534
static void Initialize()
Initialize ROOT explicitly.
Definition TROOT.cxx:2842
static void ShutDown()
Shut down ROOT.
Definition TROOT.cxx:3068
TObject * GetFunction(const char *name) const
Return pointer to function with name.
Definition TROOT.cxx:1559
static Int_t ConvertVersionCode2Int(Int_t code)
Convert version code to an integer, i.e. 331527 -> 51507.
Definition TROOT.cxx:2865
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:2697
TSeqCollection * GetListOfMappedFiles() const
Definition TROOT.h:238
void SetEditHistograms(Bool_t flag=kTRUE)
Definition TROOT.h:322
AListOfEnums_t fEnums
List of enum types.
Definition TROOT.h:165
void ReadGitInfo()
Read Git commit SHA1 and branch name.
Definition TROOT.cxx:2390
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:2479
void CloseFiles()
Close any files and sockets that gROOT knows about.
Definition TROOT.cxx:1140
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:1445
static Int_t ConvertVersionInt2Code(Int_t v)
Convert version as an integer to version code as used in RVersion.h.
Definition TROOT.cxx:2873
static const TString & GetTTFFontDir()
Get the fonts directory in the installation. Static utility function.
Definition TROOT.cxx:3121
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:1526
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:1508
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:1592
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:1456
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:1038
static const TString & GetIconPath()
Get the icon path in the installation. Static utility function.
Definition TROOT.cxx:3100
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:1787
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:1732
void SetExecutingMacro(Bool_t flag=kTRUE)
Definition TROOT.h:324
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:2502
TObject * FindObject(const char *name) const override
Returns address of a ROOT object if it exists.
Definition TROOT.cxx:1285
TCollection * fClasses
List of classes definition.
Definition TROOT.h:140
void SetInterrupt(Bool_t flag=kTRUE)
Definition TROOT.h:326
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:1551
TCollection * GetListOfEnums(Bool_t load=kFALSE)
Definition TROOT.cxx:1715
Longptr_t ProcessLineSync(const char *line, Int_t *error=nullptr)
Process interpreter command via TApplication::ProcessLine().
Definition TROOT.cxx:2351
void InitInterpreter()
Initialize interpreter (cling)
Definition TROOT.cxx:2025
TCollection * GetListOfGlobals(Bool_t load=kFALSE)
Return list containing the TGlobals currently defined.
Definition TROOT.cxx:1749
TVirtualPad * GetSelectedPad() const
Definition TROOT.h:271
static void SetDirLevel(Int_t level=0)
Return Indentation level for ls().
Definition TROOT.cxx:2857
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:3143
TCollection * GetListOfFunctionOverloads(const char *name) const
Return the collection of functions named "name".
Definition TROOT.cxx:1633
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:2849
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:318
Int_t fLineIsProcessing
To synchronize multi-threads.
Definition TROOT.h:100
Int_t Timer() const
Definition TROOT.h:336
static const TString & GetSourceDir()
Get the source directory in the installation. Static utility function.
Definition TROOT.cxx:3079
static const TString & GetMacroDir()
Get the macro directory in the installation. Static utility function.
Definition TROOT.cxx:3026
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:2331
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:2441
TProcessUUID * GetUUIDs() const
Definition TROOT.h:275
void SetEditorMode(const char *mode="")
Set editor mode.
Definition TROOT.cxx:2671
TSeqCollection * GetListOfStreamerInfo() const
Definition TROOT.h:249
static const TString & GetTutorialDir()
Get the tutorials directory in the installation. Static utility function.
Definition TROOT.cxx:3047
virtual ~TROOT()
Clean up and free resources used by ROOT (files, network sockets, shared memory segments,...
Definition TROOT.cxx:865
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:1679
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:2427
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:2277
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:2895
void SetLineHasBeenProcessed()
Definition TROOT.h:329
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:1490
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:1047
static const TString & GetRootSys()
Get the rootsys directory in the installation. Static utility function.
Definition TROOT.cxx:2922
TListOfFunctions * GetGlobalFunctions()
Internal routine returning, and creating if necessary, the list of global function.
Definition TROOT.cxx:1624
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:2144
TFunction * GetGlobalFunction(const char *name, const char *params=nullptr, Bool_t load=kFALSE)
Return pointer to global function by name.
Definition TROOT.cxx:1646
void AddClass(TClass *cl)
Add a class to the list and map of classes.
Definition TROOT.cxx:1016
static Int_t RootVersionCode()
Return ROOT version code as defined in RVersion.h.
Definition TROOT.cxx:2884
TObject * FindSpecialObject(const char *name, void *&where)
Returns address and folder of a ROOT object if it exists.
Definition TROOT.cxx:1339
TObject * Remove(TObject *) override
Remove an object from the in-memory list.
Definition TROOT.cxx:2585
void InitSystem()
Operating System interface.
Definition TROOT.cxx:1939
Longptr_t ProcessLineFast(const char *line, Int_t *error=nullptr)
Process interpreter command directly via CINT interpreter.
Definition TROOT.cxx:2368
Int_t GetEditorMode() const
Definition TROOT.h:219
Bool_t ClassSaved(TClass *cl)
return class status bit kClassSaved for class cl This function is called by the SavePrimitive functio...
Definition TROOT.cxx:1066
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:1826
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:2191
Bool_t IsWebDisplay() const
Definition TROOT.h:287
static void IndentLevel()
Functions used by ls() to indent an object hierarchy.
Definition TROOT.cxx:2834
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:3010
static const TString & GetEtcDir()
Get the sysconfig directory in the installation. Static utility function.
Definition TROOT.cxx:2984
TROOT(const TROOT &)=delete
Int_t GetNclasses() const
Get number of classes.
Definition TROOT.cxx:1837
static const char **& GetExtraInterpreterArgs()
INTERNAL function! Used by rootcling to inject interpreter arguments through a C-interface layer.
Definition TROOT.cxx:2905
static void SetMacroPath(const char *newpath)
Set or extend the macro search path.
Definition TROOT.cxx:2755
void SetSelectedPad(TVirtualPad *pad)
Definition TROOT.h:333
void InitThreads()
Initialize threads library.
Definition TROOT.cxx:2014
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:1579
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:1708
void RecursiveRemove(TObject *obj) override
Recursively remove this object from the list of Cleanups.
Definition TROOT.cxx:2465
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
void SetEscape(Bool_t flag=kTRUE)
Definition TROOT.h:327
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:1845
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:2229
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:2953
void SetDefCanvasName(const char *name="c1")
Definition TROOT.h:321
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:1398
static Int_t DecreaseDirLevel()
Decrease the indentation level for ls().
Definition TROOT.cxx:2713
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:332
void Reset(Option_t *option="")
Delete all global interpreter objects created since the last call to Reset.
Definition TROOT.cxx:2618
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:1425
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:2994
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:2721
void SetReadingObject(Bool_t flag=kTRUE)
Definition TROOT.cxx:2432
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:380
Definition TROOT.h:378
void DisableParBranchProcessing()
Globally disables the IMT use case of parallel branch processing, deactivating the corresponding lock...
Definition TROOT.cxx:426
void EnableParBranchProcessing()
Globally enables the parallel branch processing, which is a case of implicit multi-threading (IMT) in...
Definition TROOT.cxx:412
Bool_t IsParBranchProcessingEnabled()
Returns true if parallel branch processing is enabled.
Definition TROOT.cxx:439
Definition TROOT.cxx:379
Bool_t RequiresCleanup(TObject &obj)
Definition TROOT.h:385
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:527
Bool_t IsImplicitMTEnabled()
Returns true if the implicit multi-threading in ROOT is enabled.
Definition TROOT.cxx:558
UInt_t GetThreadPoolSize()
Returns the size of ROOT's thread pool.
Definition TROOT.cxx:565
void EnableThreadSafety()
Enable support for multi-threading within the ROOT code in particular, enables the global mutex to ma...
Definition TROOT.cxx:493
void CallRecursiveRemoveIfNeeded(TObject &obj)
call RecursiveRemove for obj if gROOT is valid and obj.TestBit(kMustCleanup) is true.
Definition TROOT.h:394
Definition TROOT.cxx:464
void DisableImplicitMT()
Disables the implicit multi-threading in ROOT (see EnableImplicitMT).
Definition TROOT.cxx:544
TLine l
Definition textangle.C:4