ROOT logo
ROOT » MISC » TABLE » TFileIter

class TFileIter: public TListIter


Class to iterate (read / write ) the events written to TFile.
The event is supposed to assign an unique ID in form of

TKey <event Id> ::= eventName "." run_number "." event_number

and stored as the TKey name of the object written



 void TesTFileIter(){
 // This macros tests the various methods of TFileIter class.
   gSystem->Load("libTable");

   //First create simple ROOT file
   TDataSet *ds = new TDataSet("event");
   TObject *nextObject = 0;
   TRandom run;
   TRandom event;
   {
     TFileIter outSet("test.root","RECREATE");
     UInt_t totalEvent = 10;
     UInt_t runNumber  = 20010301;
     Int_t i=0;
     Int_t j=0;
     for (;j < 10;j++) {
       for (i = 1;i<totalEvent;i++) {
         outSet.NextEventPut(ds,UInt_t(i),UInt_t(runNumber+j+10*run.Rndm()-5));
       }
     }
   }
   printf(" ----------------------> TFile has been created <--------------------\n");
   TFile *f = new TFile("test.root");
   TFileIter readObj(f);
   // the number of the object available directly from "MyDataSet.root"
   Int_t size = readObj.TotalKeys();
   printf(" The total number of the objects: %d\n",size);

   //-----------------------------------------------------------------------
   // Loop over all objects, read them in to memory one by one

   printf(" -- > Loop over all objects, read them in to memory one by one < -- \n");
   for( readObj = 0; int(readObj) < size; ++readObj){
       nextObject = *readObj;
       printf(" %d bytes of the object \"%s\" of class \"%s\" written with TKey \"%s\"  has been read from file\n"
                ,readObj.GetObjlen()
                ,nextObject->GetName()
                ,nextObject->IsA()->GetName()
                ,(const char *)readObj
             );
       delete nextObject;
  }
 //-----------------------------------------------------------------------
 //  Now loop over all objects in inverse order
  printf(" -- > Now loop over all objects in inverse order < -- \n");
  for( readObj = size-1; (int)readObj >= 0; --readObj)
  {
       nextObject = *readObj;
       if (nextObject) {
          printf(" Object \"%s\" of class \"%s\" written with TKey \"%s\"  has been read from file\n"
                 ,nextObject->GetName()
                 , nextObject->IsA()->GetName()
                 ,(const char *)readObj
                );
         delete nextObject;
      } else {
        printf("Error reading file by index\n");
      }
  }
 //-----------------------------------------------------------------------
 // Loop over the objects starting from the object with the key name "event.02.01"
   printf(" -- > Loop over the objects starting from the object with the key name \"event.02.01\" < -- \n");
   for( readObj = "event.02.01"; (const char *)readObj != 0; ++readObj){
       nextObject = *readObj;
       printf(" Object \"%s\" of class \"%s\" written with Tkey \"%s\"  has been read from file\n"
               , nextObject->GetName()
               , nextObject->IsA()->GetName()
               , (const char *)readObj
             );
       delete nextObject;
   }

   printf(" -- > Loop over the objects starting from the 86-th object" < -- \n");
   for( readObj = (const char *)(readObj = 86); (const char *)readObj != 0; ++readObj){
       nextObject = *readObj;
       printf(" Object \"%s\" of class \"%s\" written with Tkey \"%s\"  has been read from file\n"
               , nextObject->GetName()
               , nextObject->IsA()->GetName()
               , (const char *)readObj
             );
       delete nextObject;
   }

 }


Function Members (Methods)

public:
TFileIter(TFile* file = 0)
TFileIter(TDirectory* directory)
TFileIter(const TFileIter&)
TFileIter(const char* name, Option_t* option = "", const char* ftitle = "", Int_t compress = 1, Int_t netopt = 0)
virtual~TFileIter()
static TClass*Class()
static TClass*TListIter::Class()
static TClass*TIterator::Class()
Int_tCurrentCursorPosition() const
virtual const TCollection*TListIter::GetCollection() const
virtual const TCollection*TIterator::GetCollection() const
TKey*GetCurrentKey() const
static const char*GetDefaultMapFileName()
virtual Int_tGetDepth() const
static const char*GetForeignFileSystemKey()
const char*GetKeyName() const
static const char*GetLocalFileNameKey()
virtual TObject*GetObject() const
Int_tGetObjlen() const
virtual Option_t*TListIter::GetOption() const
virtual Option_t*TIterator::GetOption() const
static const char*GetResourceName()
virtual const TDirectory*GetTDirectory() const
virtual const TFile*GetTFile() const
virtual TClass*IsA() const
virtual TClass*TListIter::IsA() const
virtual TClass*TIterator::IsA() const
virtual Bool_tIsOpen() const
static TStringMapName(const char* name, const char* localSystemKey = 0, const char* mountedFileSystemKey = 0)
virtual TObject*Next()
virtual TObject*TListIter::Next()
virtual TObject*TIterator::Next()
virtual TObject*Next(Int_t nSkip)
virtual TObject*NextEventGet(UInt_t eventNumber = UInt_t(-1), UInt_t runNumber = UInt_t(-1), const char* name = "*")
virtual Int_tNextEventPut(TObject* obj, UInt_t eventNum, UInt_t runNumber, const char* name = 0)
const char*operator const char*() const
const TDirectory*operator const TDirectory*() const
const TFile*operator const TFile*() const
intoperator int() const
intoperator!=(const char* name) const
virtual boolTListIter::operator!=(const TIterator& aIter) const
boolTListIter::operator!=(const TListIter& aIter) const
virtual boolTIterator::operator!=(const TIterator&) const
TObject*operator()()
TObject*TIterator::operator()()
TObject*operator()(Int_t nSkip)
virtual TObject*operator*() const
virtual TObject*TListIter::operator*() const
virtual TObject*TIterator::operator*() const
TFileIter&operator++()
TFileIter&operator+=(Int_t shift)
TFileIter&operator--()
TFileIter&operator-=(Int_t shift)
TFileIter&operator=(Int_t cursorPosition)
TFileIter&operator=(const char* keyNameToFind)
intoperator==(const char* name) const
static voidPurgeKeys(TList* listOfKeys)
virtual voidReset()
virtual voidTListIter::Reset()
virtual voidTIterator::Reset()
virtual voidRewind()
voidSetCursorPosition(Int_t cursorPosition)
voidSetCursorPosition(const char* keyNameToFind)
voidTListIter::SetOption(Option_t* option)
virtual voidShowMembers(TMemberInspector& insp, char* parent)
virtual voidTListIter::ShowMembers(TMemberInspector& insp, char* parent)
virtual voidTIterator::ShowMembers(TMemberInspector& insp, char* parent)
virtual TKey*SkipObjects(Int_t nSkip = 1)
virtual voidStreamer(TBuffer& b)
virtual voidTListIter::Streamer(TBuffer& b)
virtual voidTIterator::Streamer(TBuffer& b)
voidStreamerNVirtual(TBuffer& b)
voidTListIter::StreamerNVirtual(TBuffer& b)
voidTIterator::StreamerNVirtual(TBuffer& b)
virtual Int_tTotalKeys() const
protected:
voidInitialize()
TKey*NextEventKey(UInt_t eventNumber = UInt_t(-1), UInt_t runNumber = UInt_t(-1), const char* name = "*")
TObject*ReadObj(const TKey* key) const
voidRestoreFileScope()
voidSaveFileScope()
private:
virtual booloperator!=(const TIterator& it) const
virtual TIterator&operator=(const TIterator&)

Data Members

protected:
TObjLink*TListIter::fCurCursorcurrent position in list
TObjLink*TListIter::fCursornext position in list
Int_tfCursorPositionthe position of the current key in the sorted TKey list
Bool_tTListIter::fDirectioniteration direction
TStringfEventNamecurrent key name
UInt_tfEventNumbercurrent "event number"
const TList*TListIter::fListlist being iterated
Bool_tfOwnTFileBit whether this classs creates TFile on its own to delete
TDirectory*fRootFileTDirectory/TFile to be iterated over
UInt_tfRunNumbercurrent "run number"
Bool_tTListIter::fStartediteration started
private:
TDirectory*fDirectoryBackUp! to save/restore TFile/TDirectory global scope
TFile*fFileBackUp! temporary data-members
TFileIter*fNestedIterator! The inner TFidrectory interator;

Class Charts

Inheritance Inherited Members Includes Libraries
Class Charts

Function documentation

TFileIter(TFile *file)
 Create iterator over all objects from the TFile provided
TFileIter(TDirectory *directory)
 Create iterator over all objects from the TDirectory provided
TFileIter(const char* name, Option_t* option = "", const char* ftitle = "", Int_t compress = 1, Int_t netopt = 0)
 Open ROOT TFile by the name provided;
 This TFile is to be deleted by the TFileIter alone
TFileIter(const TFileIter &dst)
 Copy ctor can be used with the "read only" files only.
~TFileIter()
 TFileIter dtor
void Initialize()
to be documented
Bool_t IsOpen() const
 Check whether the associated ROOT TFile was open
 and TFile object is healthy.
TKey * GetCurrentKey() const
 return the pointer to the current TKey
Int_t GetDepth() const
 return the current number of the nested subdirectroies;
      = 0 - means there is no subdirectories
const char * GetKeyName() const
 return the name of the current TKey
TObject * GetObject() const
 read the object from TFile defined by the current TKey

 ATTENTION:  memory leak danger !!!

 This method does create a new object and it is the end-user
 code responsibility to take care about this object
 to avoid memory leak.

Int_t GetObjlen() const
 Returns the uncompressed length of the current object
Int_t TotalKeys() const
 The total number of the TKey keys in the current TDirectory only
 Usually this means the total number of different objects
 those can be read one by one.
 It does NOT count the nested sub-TDirectory.
 It is too costly and it can be abused.
TObject * Next(Int_t nSkip)
 return the pointer to the object defined by next TKey
 This method is not recommended. It was done for the sake
 of the compatibility with TListIter
void PurgeKeys(TList* listOfKeys)
 Remove the TKey duplication,
 leave the keys with highest cycle number only
 Sort if first
void Reset()
 Reset the status of the iterator
void SetCursorPosition(const char *keyNameToFind)
 Find the key by the name provided
TKey * SkipObjects(Int_t nSkip = 1)
 Returns the TKey pointer to the nSkip TKey object from the current one
 nSkip = 0; the state of the iterator is not changed

 nSkip > 0; iterator skips nSkip objects in the container.
            the direction of the iteration is
            sign(nSkip)*kIterForward

 Returns: TKey that can be used to fetch the object from the TDirectory

TKey * NextEventKey(UInt_t eventNumber = UInt_t(-1), UInt_t runNumber = UInt_t(-1), const char* name = "*")
TObject * NextEventGet(UInt_t eventNumber = UInt_t(-1), UInt_t runNumber = UInt_t(-1), const char* name = "*")
 reads, creates and returns the object by TKey name that matches
 the "name" ."runNumber" ." eventNumber" schema
 Attention: This method does create a new TObject and it is the user
 code responsibility to take care (delete) this object to avoid
 memory leak.
TObject * ReadObj(const TKey* key) const
Read the next TObject from for the TDirectory by TKey provided
Int_t NextEventPut(TObject* obj, UInt_t eventNum, UInt_t runNumber, const char* name = 0)
 Create a special TKey name with obj provided and write it out.
TString MapName(const char* name, const char* localSystemKey = 0, const char* mountedFileSystemKey = 0)
 MapName(const char *name, const char *localSystemKey,const char *mountedFileSystemKey)

 Substitute the logical name with the real one if any
 1. add a line into system.rootrc or ~/.rootrc or ./.rootrc

  TFileIter.ForeignFileMap  mapFile // the name of the file
 to map the local name
 to the global file service

  If this line is omitted then TFileIter class seeks for
  the default mapping file in the current directory "io.config"
const char * GetResourceName()
{return "ForeignFileMap";}
const char * GetDefaultMapFileName()
{return "io.config";}
const char * GetLocalFileNameKey()
{return "LocalFileSystem";}
const char * GetForeignFileSystemKey()
{return "MountedFileSystem";}
Int_t CurrentCursorPosition() const
const TFile * GetTFile() const
{ return GetTDirectory()->GetFile(); }
const TDirectory * GetTDirectory() const
{ return fNestedIterator ? fNestedIterator->GetTDirectory() : fRootFile; }
TObject * Next()
void Rewind()
void SetCursorPosition(Int_t cursorPosition)
TFileIter & operator=(const char *keyNameToFind)
TFileIter & operator=(Int_t cursorPosition)
TFileIter & operator+=(Int_t shift)
{ SkipObjects(shift); return *this;}
TFileIter & operator-=(Int_t shift)
{ return operator+=(-shift);}
TFileIter & operator++()
{ SkipObjects( 1); return *this;}
TFileIter & operator--()
{ SkipObjects(-1); return *this;}
TObject * operator*() const
{ return GetObject();}
inline operator int() const
{ return CurrentCursorPosition(); }
int operator==(const char* name) const
{ return name ? !strcmp(name,GetKeyName()):0;}
int operator!=(const char *name)
{ return !(operator==(name)); }
TObject * operator()()
{ return Next(); }
TObject * operator()(Int_t nSkip)
{ return Next(nSkip);}
void SaveFileScope()
void RestoreFileScope()
TIterator & operator=(const TIterator &)
{ return *this; }
bool operator!=(const TIterator &it)
{ return TListIter::operator!=(it);}