Logo ROOT  
Reference Guide
No Matches
Go to the documentation of this file.
1// @(#)root/io:$Id$
2// Author: Rene Brun 22/01/2007
5 * Copyright (C) 1995-2007, 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_TDirectoryFile
13#define ROOT_TDirectoryFile
17// //
18// TDirectoryFile //
19// //
20// Describe directory structure in a ROOT file. //
21// //
24#include "Compression.h"
25#include "TDirectory.h"
26#include "TDatime.h"
27#include "TList.h"
29class TKey;
30class TFile;
32class TDirectoryFile : public TDirectory {
35 Bool_t fModified{kFALSE}; ///< True if directory has been modified
36 Bool_t fWritable{kFALSE}; ///< True if directory is writable
37 TDatime fDatimeC; ///< Date and time when directory is created
38 TDatime fDatimeM; ///< Date and time of last modification
39 Int_t fNbytesKeys{0}; ///< Number of bytes for the keys
40 Int_t fNbytesName{0}; ///< Number of bytes in TNamed at creation time
41 Int_t fBufferSize{0}; ///< Default buffer size to create new TKeys
42 Long64_t fSeekDir{0}; ///< Location of directory on file
43 Long64_t fSeekParent{0}; ///< Location of parent directory on file
44 Long64_t fSeekKeys{0}; ///< Location of Keys record on file
45 TFile *fFile{nullptr}; ///< Pointer to current file in memory
46 TList *fKeys{nullptr}; ///< Pointer to keys list in memory
48 void CleanTargets();
49 void InitDirectoryFile(TClass *cl = nullptr);
50 void BuildDirectoryFile(TFile* motherFile, TDirectory* motherDir);
53 TDirectoryFile(const TDirectoryFile &directory) = delete; //Directories cannot be copied
54 void operator=(const TDirectoryFile &) = delete; //Directories cannot be copied
57 // TDirectory status bits
58 enum EStatusBits { kCloseDirectory = BIT(7) }; // Unused in ROOT, never set. Maybe only in external code.
61 TDirectoryFile(const char *name, const char *title, Option_t *option="", TDirectory* motherDir = nullptr);
62 ~TDirectoryFile() override;
64 void Append(TObject *obj, Bool_t replace = kFALSE) override;
65 void Add(TObject *obj, Bool_t replace = kFALSE) override { Append(obj,replace); }
66 Int_t AppendKey(TKey *key) override;
67 void Browse(TBrowser *b) override;
68 void Build(TFile* motherFile = nullptr, TDirectory* motherDir = nullptr) override { BuildDirectoryFile(motherFile, motherDir); }
69 TObject *CloneObject(const TObject *obj, Bool_t autoadd = kTRUE) override;
70 void Close(Option_t *option="") override;
71 void Copy(TObject &) const override { MayNotUse("Copy(TObject &)"); }
72 Bool_t cd() override;
73 Bool_t cd(const char *path) override;
74 void Delete(const char *namecycle="") override;
75 void FillBuffer(char *&buffer) override;
76 TKey *FindKey(const char *keyname) const override;
77 TKey *FindKeyAny(const char *keyname) const override;
78 TObject *FindObjectAny(const char *name) const override;
79 TObject *FindObjectAnyFile(const char *name) const override;
80 TObject *Get(const char *namecycle) override;
81 /// See documentation of TDirectoryFile::Get(const char *namecycle)
82 template <class T> inline T* Get(const char* namecycle)
83 {
84 return TDirectory::Get<T>(namecycle);
85 }
86 TDirectory *GetDirectory(const char *apath, Bool_t printError = false, const char *funcname = "GetDirectory") override;
87 void *GetObjectChecked(const char *namecycle, const char* classname) override;
88 void *GetObjectChecked(const char *namecycle, const TClass* cl) override;
89 void *GetObjectUnchecked(const char *namecycle) override;
90 Int_t GetBufferSize() const override;
91 const TDatime &GetCreationDate() const { return fDatimeC; }
92 TFile *GetFile() const override { return fFile; }
93 TKey *GetKey(const char *name, Short_t cycle=9999) const override;
94 TList *GetListOfKeys() const override { return fKeys; }
95 const TDatime &GetModificationDate() const { return fDatimeM; }
96 Int_t GetNbytesKeys() const override { return fNbytesKeys; }
97 Int_t GetNkeys() const override { return fKeys->GetSize(); }
98 Long64_t GetSeekDir() const override { return fSeekDir; }
99 Long64_t GetSeekParent() const override { return fSeekParent; }
100 Long64_t GetSeekKeys() const override { return fSeekKeys; }
101 Bool_t IsModified() const override { return fModified; }
102 Bool_t IsWritable() const override { return fWritable; }
103 void ls(Option_t *option="") const override;
104 TDirectory *mkdir(const char *name, const char *title="", Bool_t returnExistingDirectory = kFALSE) override;
105 TFile *OpenFile(const char *name, Option_t *option= "",
106 const char *ftitle = "", Int_t compress = ROOT::RCompressionSetting::EDefaults::kUseCompiledDefault,
107 Int_t netopt = 0) override;
108 void Purge(Short_t nkeep=1) override;
109 void ReadAll(Option_t *option="") override;
110 Int_t ReadKeys(Bool_t forceRead=kTRUE) override;
111 Int_t ReadTObject(TObject *obj, const char *keyname) override;
112 virtual void ResetAfterMerge(TFileMergeInfo *);
113 void rmdir(const char *name) override;
114 void Save() override;
115 void SaveSelf(Bool_t force = kFALSE) override;
116 Int_t SaveObjectAs(const TObject *obj, const char *filename="", Option_t *option="") const override;
117 void SetBufferSize(Int_t bufsize) override;
118 void SetModified() override {fModified = kTRUE;}
119 void SetSeekDir(Long64_t v) override { fSeekDir = v; }
120 void SetTRefAction(TObject *ref, TObject *parent) override;
121 void SetWritable(Bool_t writable=kTRUE) override;
122 Int_t Sizeof() const override;
123 Int_t Write(const char *name=nullptr, Int_t opt=0, Int_t bufsize=0) override;
124 Int_t Write(const char *name=nullptr, Int_t opt=0, Int_t bufsize=0) const override;
125 Int_t WriteTObject(const TObject *obj, const char *name=nullptr, Option_t *option="", Int_t bufsize=0) override;
126 Int_t WriteObjectAny(const void *obj, const char *classname, const char *name, Option_t *option="", Int_t bufsize=0) override;
127 Int_t WriteObjectAny(const void *obj, const TClass *cl, const char *name, Option_t *option="", Int_t bufsize=0) override;
128 void WriteDirHeader() override;
129 void WriteKeys() override;
131 ClassDefOverride(TDirectoryFile,5) //Describe directory structure in a ROOT file
#define b(i)
Definition RSha256.hxx:100
bool Bool_t
Definition RtypesCore.h:63
int Int_t
Definition RtypesCore.h:45
short Short_t
Definition RtypesCore.h:39
constexpr Bool_t kFALSE
Definition RtypesCore.h:101
long long Long64_t
Definition RtypesCore.h:80
constexpr Bool_t kTRUE
Definition RtypesCore.h:100
const char Option_t
Definition RtypesCore.h:66
#define BIT(n)
Definition Rtypes.h:85
#define ClassDefOverride(name, id)
Definition Rtypes.h:341
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
char name[80]
Definition TGX11.cxx:110
Using a TBrowser one can browse all ROOT objects.
Definition TBrowser.h:37
TClass instances represent classes, structs and namespaces in the ROOT type system.
Definition TClass.h:81
virtual Int_t GetSize() const
Return the capacity of the collection, i.e.
This class stores the date and time with a precision of one second in an unsigned 32 bit word (950130...
Definition TDatime.h:37
A ROOT file is structured in Directories (like a file system).
void SetModified() override
void SetBufferSize(Int_t bufsize) override
Set the default buffer size when creating new TKeys.
void SetTRefAction(TObject *ref, TObject *parent) override
Find the action to be executed in the dictionary of the parent class and store the corresponding exec...
void Close(Option_t *option="") override
Delete all objects from memory and directory structure itself.
Long64_t GetSeekDir() const override
Bool_t cd() override
Change current directory to "this" directory.
TFile * fFile
Pointer to current file in memory.
void Browse(TBrowser *b) override
Browse the content of the directory.
void Append(TObject *obj, Bool_t replace=kFALSE) override
Append object to this directory.
void SaveSelf(Bool_t force=kFALSE) override
Save Directory keys and header.
Bool_t IsWritable() const override
Int_t GetNbytesKeys() const override
void Delete(const char *namecycle="") override
Delete Objects or/and keys in a directory.
Long64_t GetSeekKeys() const override
virtual void ResetAfterMerge(TFileMergeInfo *)
Reset the TDirectory after its content has been merged into another Directory.
T * Get(const char *namecycle)
See documentation of TDirectoryFile::Get(const char *namecycle)
Int_t AppendKey(TKey *key) override
Insert key in the linked list of keys of this directory.
TDirectoryFile(const TDirectoryFile &directory)=delete
Int_t ReadKeys(Bool_t forceRead=kTRUE) override
Read the linked list of keys.
TDatime fDatimeM
Date and time of last modification.
void * GetObjectUnchecked(const char *namecycle) override
Return pointer to object identified by namecycle.
TKey * FindKey(const char *keyname) const override
Find key with name keyname in the current directory.
TKey * GetKey(const char *name, Short_t cycle=9999) const override
Return pointer to key with name,cycle.
void * GetObjectChecked(const char *namecycle, const char *classname) override
See documentation of TDirectoryFile::GetObjectCheck(const char *namecycle, const TClass *cl)
void Add(TObject *obj, Bool_t replace=kFALSE) override
void InitDirectoryFile(TClass *cl=nullptr)
Initialize the key associated with this directory (and the related data members.
void Purge(Short_t nkeep=1) override
Purge lowest key cycles in a directory.
void Save() override
Save recursively all directory keys and headers.
~TDirectoryFile() override
const TDatime & GetCreationDate() const
TObject * FindObjectAnyFile(const char *name) const override
Scan the memory lists of all files for an object with name.
Int_t fNbytesKeys
Number of bytes for the keys.
Int_t GetNkeys() const override
Bool_t IsModified() const override
Long64_t GetSeekParent() const override
void Copy(TObject &) const override
Copy this to obj.
Bool_t fModified
True if directory has been modified.
TDirectory * mkdir(const char *name, const char *title="", Bool_t returnExistingDirectory=kFALSE) override
Create a sub-directory "a" or a hierarchy of sub-directories "a/b/c/...".
TList * GetListOfKeys() const override
void CleanTargets()
Clean the pointers to this object (gDirectory, TContext, etc.)
TObject * FindObjectAny(const char *name) const override
Find object by name in the list of memory objects of the current directory or its sub-directories.
Long64_t fSeekKeys
Location of Keys record on file.
const TDatime & GetModificationDate() const
void WriteKeys() override
Write Keys linked list on the file.
TFile * GetFile() const override
Int_t fBufferSize
Default buffer size to create new TKeys.
Int_t Sizeof() const override
Return the size in bytes of the directory header.
TObject * CloneObject(const TObject *obj, Bool_t autoadd=kTRUE) override
Make a clone of an object using the Streamer facility.
TDirectory * GetDirectory(const char *apath, Bool_t printError=false, const char *funcname="GetDirectory") override
Find a directory named "apath".
Long64_t fSeekParent
Location of parent directory on file.
Int_t WriteObjectAny(const void *obj, const char *classname, const char *name, Option_t *option="", Int_t bufsize=0) override
Write object from pointer of class classname in this directory.
void BuildDirectoryFile(TFile *motherFile, TDirectory *motherDir)
Initialise directory to defaults.
void rmdir(const char *name) override
Removes subdirectory from the directory.
Int_t Write(const char *name=nullptr, Int_t opt=0, Int_t bufsize=0) override
Write all objects in memory to disk.
Long64_t fSeekDir
Location of directory on file.
Int_t fNbytesName
Number of bytes in TNamed at creation time.
TDatime fDatimeC
Date and time when directory is created.
Bool_t fWritable
True if directory is writable.
Int_t WriteTObject(const TObject *obj, const char *name=nullptr, Option_t *option="", Int_t bufsize=0) override
Write object obj to this directory.
void SetSeekDir(Long64_t v) override
Int_t ReadTObject(TObject *obj, const char *keyname) override
Read object with keyname from the current directory.
TFile * OpenFile(const char *name, Option_t *option="", const char *ftitle="", Int_t compress=ROOT::RCompressionSetting::EDefaults::kUseCompiledDefault, Int_t netopt=0) override
Interface to TFile::Open.
Int_t GetBufferSize() const override
Return the buffer size to create new TKeys.
Int_t SaveObjectAs(const TObject *obj, const char *filename="", Option_t *option="") const override
Save object in filename.
TObject * Get(const char *namecycle) override
Return pointer to object identified by namecycle.
Default TDirectoryFile constructor.
void operator=(const TDirectoryFile &)=delete
TKey * FindKeyAny(const char *keyname) const override
Find key with name keyname in the current directory or its subdirectories.
void FillBuffer(char *&buffer) override
Encode directory header into output buffer.
void WriteDirHeader() override
Overwrite the Directory header record.
void SetWritable(Bool_t writable=kTRUE) override
Set the new value of fWritable recursively.
void Build(TFile *motherFile=nullptr, TDirectory *motherDir=nullptr) override
void ReadAll(Option_t *option="") override
Read objects from a ROOT file directory into memory.
TList * fKeys
Pointer to keys list in memory.
void ls(Option_t *option="") const override
List Directory contents.
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
Book space in a file, create I/O buffers, to fill them, (un)compress them.
Definition TKey.h:28
A doubly linked list.
Definition TList.h:38
Mother of all ROOT objects.
Definition TObject.h:41
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:1040
@ kUseCompiledDefault
Use the compile-time default setting.
Definition Compression.h:52