Logo ROOT  
Reference Guide
Go to the documentation of this file.
1// @(#)root/base:$Id$
2// Author: Andreas-Joachim Peters 20/9/2005
5 * Copyright (C) 1995-2005, 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_TFileInfo
13#define ROOT_TFileInfo
16// //
17// TFileInfo //
18// //
19// Class describing a generic file including meta information. //
20// //
23#include "TNamed.h"
24#include "TList.h"
27class TUrl;
28class TUUID;
29class TMD5;
31#include "TUrl.h"
32#include "TUUID.h"
33#include "TMD5.h"
36class TFileInfoMeta;
39class TFileInfo : public TNamed {
42 TUrl *fCurrentUrl; //! current URL to access the file, points to URL
43 // in the fUrlList or 0, if the list end is reached
44 TList *fUrlList; // list of file URLs
45 Long64_t fSize; // file size
46 TUUID *fUUID; //-> uuid of the referenced file
47 TMD5 *fMD5; //-> md5 digest of the file
48 TList *fMetaDataList; // generic list of file meta data object(s)
50 Int_t fIndex; // Index to be used when sorting with index
52 void ParseInput(const char *in);
54 TFileInfo& operator=(const TFileInfo&) = delete;
58 kStaged = BIT(15),
60 kSortWithIndex = BIT(17) // Use index when sorting (in Compare)
61 };
63 TFileInfo(const char *url = nullptr, Long64_t size = -1, const char *uuid = nullptr,
64 const char *md5 = nullptr, TObject *meta = nullptr);
65 TFileInfo(const TFileInfo &);
67 virtual ~TFileInfo();
70 TUrl *NextUrl();
71 TUrl *GetCurrentUrl() const;
72 TUrl *GetFirstUrl() const { return (TUrl*)fUrlList->First(); }
73 TUrl *GetUrlAt(Int_t i) const { return (TUrl*)fUrlList->At(i); }
75 Int_t GetNUrls() const { return fUrlList->GetEntries(); }
77 Bool_t SetCurrentUrl(const char *url);
80 Long64_t GetSize() const { return fSize; }
81 TUUID *GetUUID() const { return fUUID; }
82 TMD5 *GetMD5() const { return fMD5; }
83 TList *GetMetaDataList() const { return fMetaDataList; }
84 TFileInfoMeta *GetMetaData(const char *meta = nullptr) const;
87 void SetUUID(const char *uuid);
89 TUrl *FindByUrl(const char *url, Bool_t withDeflt = kFALSE);
91 Bool_t AddUrl(const char *url, Bool_t infront = kFALSE);
92 Bool_t RemoveUrl(const char *url);
94 Bool_t RemoveMetaData(const char *meta = nullptr);
96 Bool_t IsSortable() const override { return kTRUE; }
97 Int_t Compare(const TObject *obj) const override;
99 Int_t GetIndex() const { return fIndex; }
100 void SetIndex(Int_t idx) { fIndex = idx; }
102 void Print(Option_t *options="") const override;
104 ClassDefOverride(TFileInfo,4) // Describes generic file info including meta data information
108class TFileInfoMeta : public TNamed {
111 Long64_t fEntries; // number of entries in tree or number of objects
112 Long64_t fFirst; // first valid tree entry
113 Long64_t fLast; // last valid tree entry
114 Bool_t fIsTree; // true if type is a TTree (or TTree derived)
115 Long64_t fTotBytes; // uncompressed size in bytes
116 Long64_t fZipBytes; // compressed size in bytes
121 enum EStatusBits { kExternal = BIT(15) };
126 TFileInfoMeta(const char *objPath, const char *objClass = "TTree",
127 Long64_t entries = -1, Long64_t first = 0, Long64_t last = -1,
128 Long64_t totbytes = -1, Long64_t zipbytes = -1);
129 TFileInfoMeta(const char *objPath, const char *objDir,
130 const char *objClass, Long64_t entries = -1,
131 Long64_t first = 0, Long64_t last = -1,
132 Long64_t totbytes = -1, Long64_t zipbytes = -1);
135 virtual ~TFileInfoMeta() { }
137 const char *GetObject() const;
138 const char *GetClass() const { return GetTitle(); }
139 const char *GetDirectory() const;
140 Long64_t GetEntries() const { return fEntries; }
141 Long64_t GetFirst() const { return fFirst; }
142 Long64_t GetLast() const { return fLast; }
143 Bool_t IsTree() const { return fIsTree; }
144 Long64_t GetTotBytes() const { return fTotBytes; }
145 Long64_t GetZipBytes() const { return fZipBytes; }
147 void SetEntries(Long64_t entries) { fEntries = entries; }
149 void SetLast(Long64_t last) { fLast = last; }
150 void SetTotBytes(Long64_t tot) { fTotBytes = tot; }
151 void SetZipBytes(Long64_t zip) { fZipBytes = zip; }
153 void Print(Option_t *options="") const override;
155 ClassDefOverride(TFileInfoMeta,2) // Describes TFileInfo meta data
size_t size(const MatrixT &matrix)
retrieve the size of a square matrix
bool Bool_t
Definition: RtypesCore.h:63
int Int_t
Definition: RtypesCore.h:45
const Bool_t kFALSE
Definition: RtypesCore.h:101
long long Long64_t
Definition: RtypesCore.h:80
const 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:339
virtual Int_t GetEntries() const
Definition: TCollection.h:179
Long64_t GetZipBytes() const
Definition: TFileInfo.h:145
Long64_t GetFirst() const
Definition: TFileInfo.h:141
Long64_t GetLast() const
Definition: TFileInfo.h:142
TFileInfoMeta & operator=(const TFileInfoMeta &)=delete
virtual ~TFileInfoMeta()
Definition: TFileInfo.h:135
Bool_t IsTree() const
Definition: TFileInfo.h:143
const char * GetDirectory() const
Get the object's directory in the ROOT file.
Definition: TFileInfo.cxx:581
Long64_t GetTotBytes() const
Definition: TFileInfo.h:144
void SetFirst(Long64_t first)
Definition: TFileInfo.h:148
Bool_t fIsTree
Definition: TFileInfo.h:114
Long64_t fZipBytes
Definition: TFileInfo.h:116
Long64_t fFirst
Definition: TFileInfo.h:112
Long64_t fTotBytes
Definition: TFileInfo.h:115
void SetLast(Long64_t last)
Definition: TFileInfo.h:149
Long64_t fLast
Definition: TFileInfo.h:113
const char * GetObject() const
Get the object name, with path stripped off.
Definition: TFileInfo.cxx:590
void SetTotBytes(Long64_t tot)
Definition: TFileInfo.h:150
Long64_t fEntries
Definition: TFileInfo.h:111
Long64_t GetEntries() const
Definition: TFileInfo.h:140
void Print(Option_t *options="") const override
Print information about this object.
Definition: TFileInfo.cxx:598
void SetZipBytes(Long64_t zip)
Definition: TFileInfo.h:151
const char * GetClass() const
Definition: TFileInfo.h:138
void SetEntries(Long64_t entries)
Definition: TFileInfo.h:147
Class describing a generic file including meta information.
Definition: TFileInfo.h:39
virtual ~TFileInfo()
Definition: TFileInfo.cxx:120
TList * fUrlList
current URL to access the file, points to URL
Definition: TFileInfo.h:44
Int_t GetIndex() const
Definition: TFileInfo.h:99
TUrl * fCurrentUrl
Definition: TFileInfo.h:42
Definition: TFileInfo.h:46
@ kSortWithIndex
Definition: TFileInfo.h:60
@ kCorrupted
Definition: TFileInfo.h:59
TUrl * NextUrl()
Iterator function, start iteration by calling ResetUrl().
Definition: TFileInfo.cxx:261
Bool_t AddUrl(const char *url, Bool_t infront=kFALSE)
Add a new URL.
Definition: TFileInfo.cxx:296
Bool_t RemoveUrlAt(Int_t i)
Remove URL at given position. Returns kTRUE on success, kFALSE on error.
Definition: TFileInfo.cxx:337
Bool_t AddMetaData(TObject *meta)
Add's a meta data object to the file info object.
Definition: TFileInfo.cxx:385
Bool_t RemoveUrl(const char *url)
Remove an URL. Returns kTRUE if successful, kFALSE otherwise.
Definition: TFileInfo.cxx:321
Int_t fIndex
Definition: TFileInfo.h:50
TUrl * GetFirstUrl() const
Definition: TFileInfo.h:72
TList * GetMetaDataList() const
Definition: TFileInfo.h:83
TFileInfoMeta * GetMetaData(const char *meta=nullptr) const
Get meta data object with specified name.
Definition: TFileInfo.cxx:425
Long64_t GetSize() const
Definition: TFileInfo.h:80
TUUID * GetUUID() const
Definition: TFileInfo.h:81
Bool_t RemoveMetaData(const char *meta=nullptr)
Remove the metadata object.
Definition: TFileInfo.cxx:402
Long64_t fSize
Definition: TFileInfo.h:45
Int_t GetNUrls() const
Definition: TFileInfo.h:75
Int_t Compare(const TObject *obj) const override
Compare TFileInfo object by their first urls.
Definition: TFileInfo.cxx:444
TMD5 * GetMD5() const
Definition: TFileInfo.h:82
Bool_t SetCurrentUrl(const char *url)
Set 'url' as current URL, if in the list Return kFALSE if not in the list.
Definition: TFileInfo.cxx:355
TUrl * GetUrlAt(Int_t i) const
Definition: TFileInfo.h:73
TUrl * FindByUrl(const char *url, Bool_t withDeflt=kFALSE)
Find an element from a URL. Returns 0 if not found.
Definition: TFileInfo.cxx:277
void ResetUrl()
Definition: TFileInfo.h:69
TFileInfo & operator=(const TFileInfo &)=delete
void SetIndex(Int_t idx)
Definition: TFileInfo.h:100
TUrl * GetCurrentUrl() const
Return the current url.
Definition: TFileInfo.cxx:249
void SetUUID(const char *uuid)
Set the UUID to the value associated to the string 'uuid'.
Definition: TFileInfo.cxx:238
TList * fMetaDataList
Definition: TFileInfo.h:48
TFileInfo(const char *url=nullptr, Long64_t size=-1, const char *uuid=nullptr, const char *md5=nullptr, TObject *meta=nullptr)
Definition: TFileInfo.cxx:32
Bool_t IsSortable() const override
Definition: TFileInfo.h:96
TMD5 * fMD5
Definition: TFileInfo.h:47
void ParseInput(const char *in)
Parse the input line to extract init information from 'in'; the input string is tokenized on ' '; the...
Definition: TFileInfo.cxx:157
void Print(Option_t *options="") const override
Print information about this object.
Definition: TFileInfo.cxx:478
void SetSize(Long64_t size)
Definition: TFileInfo.h:86
A doubly linked list.
Definition: TList.h:38
TObject * First() const override
Return the first object in the list. Returns 0 when list is empty.
Definition: TList.cxx:659
TObject * At(Int_t idx) const override
Returns the object at position idx. Returns 0 if idx is out of range.
Definition: TList.cxx:357
This code implements the MD5 message-digest algorithm.
Definition: TMD5.h:44
The TNamed class is the base class for all named ROOT classes.
Definition: TNamed.h:29
const char * GetTitle() const override
Returns title of object.
Definition: TNamed.h:48
Mother of all ROOT objects.
Definition: TObject.h:41
void ResetBit(UInt_t f)
Definition: TObject.h:200
This class defines a UUID (Universally Unique IDentifier), also known as GUIDs (Globally Unique IDent...
Definition: TUUID.h:42
This class represents a WWW compatible URL.
Definition: TUrl.h:33
Definition: first.py:1
TMarker m
Definition: textangle.C:8