Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
TFileMerger.cxx
Go to the documentation of this file.
1// @(#)root/io:$Id$
2// Author: Andreas Peters + Fons Rademakers + Rene Brun 26/5/2005
3
4/*************************************************************************
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 *************************************************************************/
11
12/**
13\class TFileMerger TFileMerger.cxx
14\ingroup IO
15
16This class provides file copy and merging services.
17
18It can be used to copy files (not only ROOT files), using TFile or
19any of its remote file access plugins. It is therefore useful in
20a Grid environment where the files might be accessible only remotely.
21The merging interface allows files containing histograms and trees
22to be merged, like the standalone hadd program.
23*/
24
25#include "TFileMerger.h"
26#include "TDirectory.h"
27#include "TError.h"
28#include "TUrl.h"
29#include "TFile.h"
30#include "TUUID.h"
31#include "TSystem.h"
32#include "TKey.h"
33#include "THashList.h"
34#include "TObjString.h"
35#include "TObjArray.h"
36#include "TClass.h"
37#include "TFileMergeInfo.h"
38#include "TClassRef.h"
39#include "TROOT.h"
40#include "TMemFile.h"
41#include "TVirtualMutex.h"
42
43#ifdef WIN32
44// For _getmaxstdio
45#include <cstdio>
46#else
47// For getrlimit
48#include <sys/time.h>
49#include <sys/resource.h>
50#endif
51
52#include <cstring>
53#include <map>
54
56
59TClassRef R__RNTuple_Class("ROOT::RNTuple");
60
61static const Int_t kCpProgress = BIT(14);
62static const Int_t kCintFileNumber = 100;
63////////////////////////////////////////////////////////////////////////////////
64/// Return the maximum number of allowed opened files minus some wiggle room
65/// for CINT or at least of the standard library (stdio).
66
68{
69 int maxfiles;
70#ifdef WIN32
72#else
75 maxfiles = filelimit.rlim_cur;
76 } else {
77 // We could not get the value from getrlimit, let's return a reasonable default.
78 maxfiles = 512;
79 }
80#endif
83 } else if (maxfiles > 5) {
84 return maxfiles - 5;
85 } else {
86 return maxfiles;
87 }
88}
89
90////////////////////////////////////////////////////////////////////////////////
91/// Create file merger object.
92
94 : fMaxOpenedFiles( R__GetSystemMaxOpenedFiles() ),
95 fLocal(isLocal), fHistoOneGo(histoOneGo)
96{
99
101 gROOT->GetListOfCleanups()->Add(this);
102}
103
104////////////////////////////////////////////////////////////////////////////////
105/// Cleanup.
106
108{
109 {
111 gROOT->GetListOfCleanups()->Remove(this);
112 }
114}
115
116////////////////////////////////////////////////////////////////////////////////
117/// Reset merger file list.
118
126
127////////////////////////////////////////////////////////////////////////////////
128/// Closes output file
129
135
136////////////////////////////////////////////////////////////////////////////////
137/// Add file to file merger.
138
140{
141 if (fPrintLevel > 0) {
142 Printf("%s Source file %d: %s", fMsgPrefix.Data(), fFileList.GetEntries() + fExcessFiles.GetEntries() + 1, url);
143 }
144
145 TFile *newfile = nullptr;
147
148 if (fFileList.GetEntries() >= (fMaxOpenedFiles-1)) {
149
152
153 urlObj = new TObjString(url);
154 urlObj->SetBit(kCpProgress);
156 return kTRUE;
157 }
158
159 // We want gDirectory untouched by anything going on here
161
162 if (fLocal) {
163 TUUID uuid;
164 localcopy.Form("file:%s/ROOTMERGE-%s.root", gSystem->TempDirectory(), uuid.AsString());
166 Error("AddFile", "cannot get a local copy of file %s", url);
167 return kFALSE;
168 }
169 newfile = TFile::Open(localcopy, "READ");
170 } else {
171 newfile = TFile::Open(url, "READ");
172 }
173
174 // Zombie files should also be skipped
175 if (newfile && newfile->IsZombie()) {
176 delete newfile;
177 newfile = nullptr;
178 }
179
180 if (!newfile) {
181 if (fLocal)
182 Error("AddFile", "cannot open local copy %s of URL %s",
183 localcopy.Data(), url);
184 else
185 Error("AddFile", "cannot open file %s", url);
186 return kFALSE;
187 } else {
188 if (fOutputFile && fOutputFile->GetCompressionSettings() != newfile->GetCompressionSettings())
190
191 newfile->SetBit(kCanDelete);
193
196
197 return kTRUE;
198 }
199}
200
201////////////////////////////////////////////////////////////////////////////////
202/// Add the TFile to this file merger and *do not* give ownership of the TFile to this
203/// object.
204///
205/// Return kTRUE if the addition was successful.
206
211
212////////////////////////////////////////////////////////////////////////////////
213/// Add the TFile to this file merger and give ownership of the TFile to this
214/// object (unless kFALSE is returned).
215///
216/// Return kTRUE if the addition was successful.
217
222
223////////////////////////////////////////////////////////////////////////////////
224/// Add the TFile to this file merger and give ownership of the TFile to this
225/// object (unless kFALSE is returned).
226///
227/// Return kTRUE if the addition was successful.
228
230{
231 if (source == 0 || source->IsZombie()) {
232 return kFALSE;
233 }
234
235 if (fPrintLevel > 0) {
236 Printf("%s Source file %d: %s",fMsgPrefix.Data(),fFileList.GetEntries()+1,source->GetName());
237 }
238
239 TFile *newfile = 0;
241
242 // We want gDirectory untouched by anything going on here
244 if (fLocal && !source->InheritsFrom(TMemFile::Class())) {
245 TUUID uuid;
246 localcopy.Form("file:%s/ROOTMERGE-%s.root", gSystem->TempDirectory(), uuid.AsString());
247 if (!source->Cp(localcopy, cpProgress)) {
248 Error("AddFile", "cannot get a local copy of file %s", source->GetName());
249 return kFALSE;
250 }
251 newfile = TFile::Open(localcopy, "READ");
252 // Zombie files should also be skipped
253 if (newfile && newfile->IsZombie()) {
254 delete newfile;
255 newfile = 0;
256 }
257 } else {
258 newfile = source;
259 }
260
261 if (!newfile) {
262 if (fLocal)
263 Error("AddFile", "cannot open local copy %s of URL %s",
264 localcopy.Data(), source->GetName());
265 else
266 Error("AddFile", "cannot open file %s", source->GetName());
267 return kFALSE;
268 } else {
269 if (fOutputFile && fOutputFile->GetCompressionSettings() != newfile->GetCompressionSettings()) fCompressionChange = kTRUE;
270
271 if (own || newfile != source) {
272 newfile->SetBit(kCanDelete);
273 } else {
274 newfile->ResetBit(kCanDelete);
275 }
277
278 TObjString *urlObj = new TObjString(source->GetName());
280
281 if (newfile != source && own) {
282 delete source;
283 }
284 return kTRUE;
285 }
286}
287
288////////////////////////////////////////////////////////////////////////////////
289/// Open merger output file.
290
295
296////////////////////////////////////////////////////////////////////////////////
297/// Open merger output file.
298
300{
301 Bool_t res = OutputFile(outputfile,(force?"RECREATE":"CREATE"),1); // 1 is the same as the default from the TFile constructor.
304 return res;
305}
306
307////////////////////////////////////////////////////////////////////////////////
308/// Open merger output file.
309///
310/// The 'mode' parameter is passed to the TFile constructor as the option, it
311/// should be one of 'NEW','CREATE','RECREATE','UPDATE'
312/// 'UPDATE' is usually used in conjunction with IncrementalMerge.
313
315{
316 // We want gDirectory untouched by anything going on here
319 return OutputFile(std::unique_ptr<TFile>(outputFile));
320
321 Error("OutputFile", "cannot open the MERGER output file %s", fOutputFilename.Data());
322 return kFALSE;
323}
324
325////////////////////////////////////////////////////////////////////////////////
326/// Set an output file opened externally by the users
327
329{
330 if (!outputfile || outputfile->IsZombie()) {
331 Error("OutputFile", "cannot open the MERGER output file %s", (outputfile) ? outputfile->GetName() : "");
332 return kFALSE;
333 }
334
335 if (!outputfile->IsWritable()) {
336 Error("OutputFile", "output file %s is not writable", outputfile->GetName());
337 return kFALSE;
338 }
339
341
343 fOutputFile = 0; // This avoids the complaint from RecursiveRemove about the file being deleted which is here
344 // spurrious. (see RecursiveRemove).
346
347 fOutputFilename = outputfile->GetName();
348 // We want gDirectory untouched by anything going on here
350 fOutputFile = outputfile.release(); // Transfer the ownership of the file.
351
352 return kTRUE;
353}
354
355////////////////////////////////////////////////////////////////////////////////
356/// Open merger output file. 'mode' is passed to the TFile constructor as the option, it should
357/// be one of 'NEW','CREATE','RECREATE','UPDATE'
358/// 'UPDATE' is usually used in conjunction with IncrementalMerge.
359
360Bool_t TFileMerger::OutputFile(const char *outputfile, const char *mode /* = "RECREATE" */)
361{
362 Bool_t res = OutputFile(outputfile,mode,1); // 1 is the same as the default from the TFile constructor.
364 return res;
365}
366
367////////////////////////////////////////////////////////////////////////////////
368/// Print list of files being merged.
369
371{
372 fFileList.Print(options);
373 fExcessFiles.Print(options);
374}
375
376////////////////////////////////////////////////////////////////////////////////
377/// Merge the files.
378///
379/// If no output file was specified it will write into
380/// the file "FileMerger.root" in the working directory. Returns true
381/// on success, false in case of error.
382
387
388namespace {
389
391{
392 return (cl->GetMerge() || cl->InheritsFrom(TDirectory::Class()) ||
393 (cl->IsTObject() && !cl->IsLoaded() &&
394 /* If it has a dictionary and GetMerge() is nullptr then we already know the answer
395 to the next question is 'no, if we were to ask we would useless trigger
396 auto-parsing */
397 (cl->GetMethodWithPrototype("Merge", "TCollection*,TFileMergeInfo*") ||
398 cl->GetMethodWithPrototype("Merge", "TCollection*"))));
399};
400
402{
403 Bool_t status = kTRUE;
404 if (cl->InheritsFrom(TCollection::Class())) {
405 // Don't overwrite, if the object were not merged.
406 if (obj->Write(name, canBeMerged ? TObject::kSingleKey | TObject::kOverwrite : TObject::kSingleKey) <= 0) {
407 status = kFALSE;
408 }
409 ((TCollection *)obj)->SetOwner();
410 if (ownobj)
411 delete obj;
412 } else {
413 // Don't overwrite, if the object were not merged.
414 // NOTE: this is probably wrong for emulated objects.
415 if (cl->IsTObject()) {
416 if (obj->Write(name, canBeMerged ? TObject::kOverwrite : 0) <= 0) {
417 status = kFALSE;
418 }
420 } else {
421 if (target->WriteObjectAny((void *)obj, cl, name, canBeMerged ? "OverWrite" : "") <= 0) {
422 status = kFALSE;
423 }
424 }
425 if (ownobj)
426 cl->Destructor(obj); // just in case the class is not loaded.
427 }
428 return status;
429}
430
432{
433 // Recurse until we find a different name or type appear.
434 TKey *key = (TKey*)peeknextkey();
435 if (!key || name != key->GetName()) {
436 return kTRUE;
437 }
439 if (IsMergeable(cl))
440 return kTRUE;
441 // Now we can advance the real iterator
442 (void)nextkey();
444 TObject *obj = key->ReadObj();
445
446 return WriteOneAndDelete(name, cl, obj, kFALSE, kTRUE, target) && result;
447};
448
449} // anonymous namespace
450
454 TObject *obj, TIter &nextkey)
455{
456 const char *keyname = obj ? obj->GetName() : key->GetName();
457 const char *keyclassname = obj ? obj->IsA()->GetName() : key->GetClassName();
458 const char *keytitle = obj ? obj->GetTitle() : key->GetTitle();
459
460 // Keep only the highest cycle number for each key for mergeable objects. They are stored
461 // in the (hash) list consecutively and in decreasing order of cycles, so we can continue
462 // until the name changes. We flag the case here and we act consequently later.
465
466 // Read in but do not copy directly the processIds.
467 if (strcmp(keyclassname, "TProcessID") == 0 && key) {
468 key->ReadObj();
469 return kTRUE;
470 }
471
472 // If we have already seen this object [name], we already processed
473 // the whole list of files for this objects and we can just skip it
474 // and any related cycles.
475 if (allNames.FindObject(keyname)) {
477 return kTRUE;
478 }
479
481 if (!cl) {
482 Info("MergeRecursive", "cannot indentify object type (%s), name: %s title: %s",
484 return kTRUE;
485 }
486 // For mergeable objects we add the names in a local hashlist handling them
487 // again (see above)
488 if (IsMergeable(cl))
489 allNames.Add(new TObjString(keyname));
490
492 // Skip the TTree objects and any related cycles.
494 return kTRUE;
495 }
496 // Check if only the listed objects are to be merged
497 if (type & kOnlyListed) {
499 oldkeyname += " ";
502 if ((!onlyListed) && (!cl->InheritsFrom(TDirectory::Class()))) return kTRUE;
503 }
504
505 if (!(type&kResetable && type&kNonResetable)) {
506 // If neither or both are requested at the same time, we merger both types.
507 if (!(type&kResetable)) {
508 if (cl->GetResetAfterMerge()) {
509 // Skip the object with a reset after merge routine (TTree and other incrementally mergeable objects)
511 return kTRUE;
512 }
513 }
514 if (!(type&kNonResetable)) {
515 if (!cl->GetResetAfterMerge()) {
516 // Skip the object without a reset after merge routine (Histograms and other non incrementally mergeable objects)
518 return kTRUE;
519 }
520 }
521 }
522 // read object from first source file
523 if (type & kIncremental) {
524 if (!obj)
525 obj = current_sourcedir->GetList()->FindObject(keyname);
526 if (!obj && key) {
527 obj = key->ReadObj();
528 ownobj = kTRUE;
529 } else if (obj && info.fIsFirst && current_sourcedir != target
530 && !cl->InheritsFrom( TDirectory::Class() )) {
531 R__ASSERT(cl->IsTObject());
533 obj = obj->Clone();
534 ownobj = kTRUE;
535 }
536 } else if (key) {
537 obj = key->ReadObj();
538 ownobj = kTRUE;
539 }
540 if (!obj) {
541 Info("MergeRecursive", "could not read object for key {%s, %s}",
543 return kTRUE;
544 }
545 Bool_t canBeFound = (type & kIncremental) && (current_sourcedir->GetList()->FindObject(keyname) != nullptr);
546
547 // if (cl->IsTObject())
548 // obj->ResetBit(kMustCleanup);
549 if (cl->IsTObject() && cl != obj->IsA()) {
550 Error("MergeRecursive", "TKey and object retrieve disagree on type (%s vs %s). Continuing with %s.",
551 keyclassname, obj->IsA()->GetName(), obj->IsA()->GetName());
552 cl = obj->IsA();
553 }
555
556 std::map<std::tuple<std::string, std::string, std::string>, TDirectory*> dirtodelete;
557 auto getDirectory = [&dirtodelete](TDirectory *parent, const char *name, const TString &pathname) {
558 auto mapkey = std::make_tuple(parent->GetName(), name, pathname.Data());
559 auto result = dirtodelete.find(mapkey);
560 if (result != dirtodelete.end()) {
561 return result->second;
562 }
563
564 auto dir = dynamic_cast<TDirectory *>(parent->GetDirectory(pathname));
565 if (dir)
566 dirtodelete[mapkey] = dir;
567
568 return dir;
569 };
570
571 if ( cl->InheritsFrom( TDirectory::Class() ) ) {
572 // it's a subdirectory
573
574 target->cd();
576
577 // For incremental or already seen we may have already a directory created
578 if (type & kIncremental || alreadyseen) {
579 newdir = target->GetDirectory(obj->GetName());
580 if (!newdir) {
581 newdir = target->mkdir( obj->GetName(), obj->GetTitle() );
582 // newdir->ResetBit(kMustCleanup);
583 }
584 } else {
585 newdir = target->mkdir( obj->GetName(), obj->GetTitle() );
586 // newdir->ResetBit(kMustCleanup);
587 }
588
589 // newdir is now the starting point of another round of merging
590 // newdir still knows its depth within the target file via
591 // GetPath(), so we can still figure out where we are in the recursion
592
593 // If this folder is a onlyListed object, merge everything inside.
596 // Delete newdir directory after having written it (merged)
597 if (!(type&kIncremental)) delete newdir;
599 if (!status) return kFALSE;
600 } else if (!cl->IsTObject() && cl->GetMerge()) {
601 // merge objects that don't derive from TObject
603 Warning("MergeRecursive", "Merging RNTuples is experimental");
604
605 // Collect all the data to be passed on to the merger
607 // First entry is the TKey of the ntuple
608 mergeData.Add(key);
609 // Second entry is the output file
610 mergeData.Add(target->GetFile());
611 // Remaining entries are the input files
613 while (const auto &inFile = nextFile()) {
614 mergeData.Add(inFile);
615 }
616 // Get the merge fuction and pass the data
617 ROOT::MergeFunc_t func = cl->GetMerge();
618 Long64_t result = func(obj, &mergeData, &info);
619 mergeData.Clear("nodelete");
620 if (result < 0) {
621 Error("MergeRecursive", "Could NOT merge RNTuples!");
622 return kFALSE;
623 }
624 } else {
626 Error("MergeRecursive", "Merging objects that don't inherit from TObject is unimplemented (key: %s of type %s in file %s)",
627 keyname, keyclassname, nextsource->GetName());
629 }
630 } else if (cl->IsTObject() && cl->GetMerge()) {
631 // Check if already treated
632 if (alreadyseen) return kTRUE;
633
637
638 // Loop over all source files and merge same-name object
640 if (nextsource == 0) {
641 // There is only one file in the list
642 ROOT::MergeFunc_t func = cl->GetMerge();
643 func(obj, &inputs, &info);
644 info.fIsFirst = kFALSE;
645 } else {
646 do {
647 // make sure we are at the correct directory level by cd'ing to path
648 TDirectory *ndir = getDirectory(nextsource, target->GetName(), path);
649 if (ndir) {
650 // For consistency (and persformance), we reset the MustCleanup be also for those
651 // 'key' retrieved indirectly.
652 // ndir->ResetBit(kMustCleanup);
653 ndir->cd();
654 TObject *hobj = ndir->GetList()->FindObject(keyname);
655 if (!hobj) {
656 TKey *key2 = (TKey*)ndir->GetListOfKeys()->FindObject(keyname);
657 if (key2) {
658 hobj = key2->ReadObj();
659 if (!hobj) {
660 switch (fErrBehavior) {
662 Error("MergeRecursive", "could not read object for key {%s, %s}; in file %s", keyname,
663 keytitle, nextsource->GetName());
665 return kFALSE;
667 Warning("MergeRecursive", "could not read object for key {%s, %s}; skipping file %s",
668 keyname, keytitle, nextsource->GetName());
670 return kTRUE;
671 }
672 }
673 todelete.Add(hobj);
674 }
675 }
676 if (hobj) {
677 // Set ownership for collections
678 if (hobj->InheritsFrom(TCollection::Class())) {
679 ((TCollection*)hobj)->SetOwner();
680 }
681 hobj->ResetBit(kMustCleanup);
682 inputs.Add(hobj);
683 if (!oneGo) {
684 ROOT::MergeFunc_t func = cl->GetMerge();
685 Long64_t result = func(obj, &inputs, &info);
686 info.fIsFirst = kFALSE;
687 if (result < 0) {
688 Error("MergeRecursive", "calling Merge() on '%s' with the corresponding object in '%s'",
689 keyname, nextsource->GetName());
690 }
691 inputs.Clear();
692 todelete.Delete();
693 }
694 }
695 }
697 } while (nextsource);
698 // Merge the list, if still to be done
699 if (oneGo || info.fIsFirst) {
700 ROOT::MergeFunc_t func = cl->GetMerge();
701 func(obj, &inputs, &info);
702 info.fIsFirst = kFALSE;
703 inputs.Clear();
704 todelete.Delete();
705 }
706 }
707 } else if (cl->IsTObject()) {
708 // try synthesizing the Merge method call according to the TObject
709 TList listH;
711 if (cl->GetMethodWithPrototype("Merge", "TCollection*,TFileMergeInfo*")) {
712 listHargs.Form("(TCollection*)0x%zx,(TFileMergeInfo*)0x%zx",
713 (size_t)&listH, (size_t)&info);
714 } else if (cl->GetMethodWithPrototype("Merge", "TCollection*")) {
715 listHargs.Form("((TCollection*)0x%zx)", (size_t)&listH);
716 } else {
717 // pass unmergeable objects through to the output file
719 }
720 if (canBeMerged) {
721 if (alreadyseen) {
722 // skip already seen mergeable objects, don't skip unmergeable objects
723 return kTRUE;
724 }
725 // Loop over all source files and merge same-name object
727 if (nextsource == 0) {
728 // There is only one file in the list
729 Int_t error = 0;
730 obj->Execute("Merge", listHargs.Data(), &error);
731 info.fIsFirst = kFALSE;
732 if (error) {
733 Error("MergeRecursive", "calling Merge() on '%s' with the corresponding object in '%s'",
734 obj->GetName(), keyname);
735 }
736 } else {
737 while (nextsource) {
738 // make sure we are at the correct directory level by cd'ing to path
739 TDirectory *ndir = getDirectory(nextsource, target->GetName(), path);
740 if (ndir) {
741 ndir->cd();
742 TKey *key2 = (TKey*)ndir->GetListOfKeys()->FindObject(keyname);
743 if (key2) {
744 TObject *hobj = key2->ReadObj();
745 if (!hobj) {
746 switch (fErrBehavior) {
748 Error("MergeRecursive", "could not read object for key {%s, %s}; in file %s", keyname,
749 keytitle, nextsource->GetName());
751 return kFALSE;
753 Warning("MergeRecursive", "could not read object for key {%s, %s}; skipping file %s",
754 keyname, keytitle, nextsource->GetName());
756 return kTRUE;
757 }
758 }
759 // Set ownership for collections
760 if (hobj->InheritsFrom(TCollection::Class())) {
761 ((TCollection*)hobj)->SetOwner();
762 }
763 hobj->ResetBit(kMustCleanup);
764 listH.Add(hobj);
765 Int_t error = 0;
766 obj->Execute("Merge", listHargs.Data(), &error);
767 info.fIsFirst = kFALSE;
768 if (error) {
769 Error("MergeRecursive", "calling Merge() on '%s' with the corresponding object in '%s'",
770 obj->GetName(), nextsource->GetName());
771 }
772 listH.Delete();
773 }
774 }
776 }
777 // Merge the list, if still to be done
778 if (info.fIsFirst) {
779 Int_t error = 0;
780 obj->Execute("Merge", listHargs.Data(), &error);
781 info.fIsFirst = kFALSE;
782 listH.Delete();
783 }
784 }
785 }
786 } else {
787 // Object is of no type that we can merge
789 }
790
791 // now write the merged histogram (which is "in" obj) to the target file
792 // note that this will just store obj in the current directory level,
793 // which is not persistent until the complete directory itself is stored
794 // by "target->SaveSelf()" below
795 target->cd();
796
798 //!!if the object is a tree, it is stored in globChain...
799 if (cl->InheritsFrom(TDirectory::Class())) {
800 // printf("cas d'une directory\n");
801
802 auto dirobj = dynamic_cast<TDirectory *>(obj);
803 TString dirpath(dirobj->GetPath());
804 // coverity[unchecked_value] 'target' is from a file so GetPath always returns path starting with filename:
805 dirpath.Remove(0, std::strlen(dirobj->GetFile()->GetPath()));
806
807 // Do not delete the directory if it is part of the output
808 // and we are in incremental mode (because it will be reused
809 // and has not been written to disk (for performance reason).
810 // coverity[var_deref_model] the IsA()->InheritsFrom guarantees that the dynamic_cast will succeed.
811 if (ownobj && (!(type & kIncremental) || dirobj->GetFile() != target)) {
812 dirobj->ResetBit(kMustCleanup);
813 delete dirobj;
814 }
815 // Let's also delete the directory from the other source (thanks to the 'allNames'
816 // mechanism above we will not process the directories when tranversing the next
817 // files).
818 for (const auto &[_, ndir] : dirtodelete) {
819 // For consistency (and performance), we reset the MustCleanup be also for those
820 // 'key' retrieved indirectly.
821 ndir->ResetBit(kMustCleanup);
822 delete ndir;
823 }
824 } else if (!canBeFound) { // Don't write the partial result for TTree and TH1
825
826 if (!canBeMerged) {
829 status = WriteOneAndDelete(oldkeyname, cl, obj, kFALSE, ownobj, target) && status;
830 } else {
831 status = WriteOneAndDelete(oldkeyname, cl, obj, kTRUE, ownobj, target) && status;
832 }
833 }
834 info.Reset();
835 return kTRUE;
836}
837
838////////////////////////////////////////////////////////////////////////////////
839/// Merge all objects in a directory
840///
841/// The type is defined by the bit values in TFileMerger::EPartialMergeType.
842
844{
845 Bool_t status = kTRUE;
847 if (fPrintLevel > 0) {
848 Printf("%s Target path: %s",fMsgPrefix.Data(),target->GetPath());
849 }
850
851 // Get the dir name
852 TString path(target->GetPath());
853 // coverity[unchecked_value] 'target' is from a file so GetPath always returns path starting with filename:
854 path.Remove(0, std::strlen(target->GetFile()->GetPath()));
855
856 Int_t nguess = sourcelist->GetSize()+1000;
858 allNames.SetOwner(kTRUE);
859 // If the mode is set to skipping list objects, add names to the allNames list
860 if (type & kSkipListed) {
862 arr->SetOwner(kFALSE);
863 for (Int_t iname=0; iname<arr->GetEntriesFast(); iname++)
864 allNames.Add(arr->At(iname));
865 delete arr;
866 }
867 ((THashList*)target->GetList())->Rehash(nguess);
868 ((THashList*)target->GetListOfKeys())->Rehash(nguess);
869
871 info.fIOFeatures = fIOFeatures;
872 info.fOptions = fMergeOptions;
874 info.fOptions.Append(" fast");
875 }
876
879 if (type & kIncremental) {
880 current_file = 0;
882 } else {
883 current_file = (TFile*)sourcelist->First();
884 current_sourcedir = current_file->GetDirectory(path);
885 }
887 // When current_sourcedir != 0 and current_file == 0 we are going over the target
888 // for an incremental merge.
891
892 // Loop over live objects
893 TIter nextobj( current_sourcedir->GetList() );
894 TObject *obj;
895 while ( (obj = (TKey*)nextobj())) {
897 info, oldkeyname, allNames, status, onlyListed, path,
899 nullptr, obj, nextobj);
900 if (!result)
901 return kFALSE; // Stop completely in case of error.
902 } // while ( (obj = (TKey*)nextobj()))
903
904 // loop over all keys in this directory
905 TIter nextkey( current_sourcedir->GetListOfKeys() );
906 TKey *key;
907
908 while ( (key = (TKey*)nextkey())) {
910 info, oldkeyname, allNames, status, onlyListed, path,
912 key, nullptr, nextkey);
913 if (!result)
914 return kFALSE; // Stop completely in case of error.
915 } // while ( ( TKey *key = (TKey*)nextkey() ) )
916 }
918 if (current_file) {
919 current_sourcedir = current_file->GetDirectory(path);
920 } else {
922 }
923 }
924 // save modifications to the target directory.
925 if (!(type&kIncremental)) {
926 // In case of incremental build, we will call Write on the top directory/file, so we do not need
927 // to call SaveSelf explicilty.
928 target->SaveSelf(kTRUE);
929 }
930
931 return status;
932}
933
934////////////////////////////////////////////////////////////////////////////////
935/// Merge the files. If no output file was specified it will write into
936/// the file "FileMerger.root" in the working directory. Returns true
937/// on success, false in case of error.
938/// The type is defined by the bit values in EPartialMergeType:
939/// kRegular : normal merge, overwritting the output file
940/// kIncremental : merge the input file with the content of the output file (if already exising) (default)
941/// kResetable : merge only the objects with a MergeAfterReset member function.
942/// kNonResetable : merge only the objects without a MergeAfterReset member function.
943/// kDelayWrite : delay the TFile write (to reduce the number of write when reusing the file)
944/// kAll : merge all type of objects (default)
945/// kAllIncremental : merge incrementally all type of objects.
946/// kOnlyListed : merge only the objects specified in fObjectNames list
947/// kSkipListed : skip objects specified in fObjectNames list
948/// kKeepCompression: keep compression level unchanged for each input
949///
950/// If the type is not set to kIncremental, the output file is deleted at the end of this operation.
951
953{
954 if (!fOutputFile) {
956 if (outf.IsNull()) {
957 outf.Form("file:%s/FileMerger.root", gSystem->TempDirectory());
958 Info("PartialMerge", "will merge the results to the file %s\n"
959 "since you didn't specify a merge filename",
960 TUrl(outf).GetFile());
961 }
962 if (!OutputFile(outf.Data())) {
963 return kFALSE;
964 }
965 }
966
967 // Special treatment for the single file case to improve efficiency...
968 if ((fFileList.GetEntries() == 1) && !fExcessFiles.GetEntries() &&
972
973 TFile *file = (TFile *) fFileList.First();
974 if (!file || (file && file->IsZombie())) {
975 Error("PartialMerge", "one-file case: problem attaching to file");
976 return kFALSE;
977 }
979 if (!(result = file->Cp(fOutputFilename))) {
980 Error("PartialMerge", "one-file case: could not copy '%s' to '%s'",
981 file->GetPath(), fOutputFilename.Data());
982 return kFALSE;
983 }
984 if (file->TestBit(kCanDelete)) file->Close();
985
986 // Remove the temporary file
987 if (fLocal && !file->InheritsFrom(TMemFile::Class())) {
988 TUrl u(file->GetPath(), kTRUE);
989 if (gSystem->Unlink(u.GetFile()) != 0)
990 Warning("PartialMerge", "problems removing temporary local file '%s'", u.GetFile());
991 }
993 return result;
994 }
995
998
1000
1002 Int_t type = in_type;
1003 while (result && fFileList.GetEntries()>0) {
1005
1006 // Remove local copies if there are any
1007 TIter next(&fFileList);
1008 TFile *file;
1009 while ((file = (TFile*) next())) {
1010 // close the files
1011 if (file->TestBit(kCanDelete)) file->Close();
1012 // remove the temporary files
1013 if(fLocal && !file->InheritsFrom(TMemFile::Class())) {
1014 TString p(file->GetPath());
1015 // coverity[unchecked_value] Index is return a value with range or NPos to select the whole name.
1016 p = p(0, p.Index(':',0));
1017 gSystem->Unlink(p);
1018 }
1019 }
1020 fFileList.Clear();
1021 if (result && fExcessFiles.GetEntries() > 0) {
1022 // We merge the first set of files in the output,
1023 // we now need to open the next set and make
1024 // sure we accumulate into the output, so we
1025 // switch to incremental merging (if not already set)
1028 }
1029 }
1030 if (!result) {
1031 Error("Merge", "error during merge of your ROOT files");
1032 } else {
1033 // Close or write is required so the file is complete.
1034 if (in_type & kIncremental) {
1035 // In the case of 'kDelayWrite' the caller want to avoid having to
1036 // write the output objects once for every input file and instead
1037 // write it only once at the end of the process.
1038 if (!(in_type & kDelayWrite))
1040 } else {
1041 // If in_type is not incremental but type is incremental we are now in
1042 // the case where the user "explicitly" request a non-incremental merge
1043 // but we still have internally an incremental merge. Because the user
1044 // did not request the incremental merge they also probably do not to a
1045 // final Write of the file and thus not doing the write here would lead
1046 // to data loss ...
1047 if (type & kIncremental)
1049 gROOT->GetListOfFiles()->Remove(fOutputFile);
1050 fOutputFile->Close();
1051 }
1052 }
1053
1054 // Cleanup
1055 if (in_type & kIncremental) {
1056 Clear();
1057 } else {
1061 }
1062 return result;
1063}
1064
1065////////////////////////////////////////////////////////////////////////////////
1066/// Open up to fMaxOpenedFiles of the excess files.
1067
1069{
1070 if (fPrintLevel > 0) {
1071 Printf("%s Opening the next %d files", fMsgPrefix.Data(), TMath::Min(fExcessFiles.GetEntries(), fMaxOpenedFiles - 1));
1072 }
1073 Int_t nfiles = 0;
1074 TIter next(&fExcessFiles);
1075 TObjString *url = 0;
1077 // We want gDirectory untouched by anything going on here
1079 while( nfiles < (fMaxOpenedFiles-1) && ( url = (TObjString*)next() ) ) {
1080 TFile *newfile = 0;
1081 if (fLocal) {
1082 TUUID uuid;
1083 localcopy.Form("file:%s/ROOTMERGE-%s.root", gSystem->TempDirectory(), uuid.AsString());
1084 if (!TFile::Cp(url->GetName(), localcopy, url->TestBit(kCpProgress))) {
1085 Error("OpenExcessFiles", "cannot get a local copy of file %s", url->GetName());
1086 return kFALSE;
1087 }
1088 newfile = TFile::Open(localcopy, "READ");
1089 } else {
1090 newfile = TFile::Open(url->GetName(), "READ");
1091 }
1092
1093 if (!newfile) {
1094 if (fLocal)
1095 Error("OpenExcessFiles", "cannot open local copy %s of URL %s",
1096 localcopy.Data(), url->GetName());
1097 else
1098 Error("OpenExcessFiles", "cannot open file %s", url->GetName());
1099 return kFALSE;
1100 } else {
1101 if (fOutputFile && fOutputFile->GetCompressionLevel() != newfile->GetCompressionLevel()) fCompressionChange = kTRUE;
1102
1103 newfile->SetBit(kCanDelete);
1105 ++nfiles;
1107 }
1108 }
1109 return kTRUE;
1110}
1111
1112////////////////////////////////////////////////////////////////////////////////
1113/// Intercept the case where the output TFile is deleted!
1114
1116{
1118 Fatal("RecursiveRemove","Output file of the TFile Merger (targeting %s) has been deleted (likely due to a TTree larger than 100Gb)", fOutputFilename.Data());
1119 }
1120
1121}
1122
1123////////////////////////////////////////////////////////////////////////////////
1124/// Set a limit to the number of files that TFileMerger will open simultaneously.
1125///
1126/// If the request is higher than the system limit, we reset it to the system limit.
1127/// If the request is less than two, we reset it to 2 (one for the output file and one for the input file).
1128
1130{
1132 if (newmax < sysmax) {
1134 } else {
1136 }
1137 if (fMaxOpenedFiles < 2) {
1138 fMaxOpenedFiles = 2;
1139 }
1140}
1141
1142////////////////////////////////////////////////////////////////////////////////
1143/// Set the prefix to be used when printing informational message.
1144
1145void TFileMerger::SetMsgPrefix(const char *prefix)
1146{
1147 fMsgPrefix = prefix;
1148}
1149
#define SafeDelete(p)
Definition RConfig.hxx:538
bool Bool_t
Definition RtypesCore.h:63
int Int_t
Definition RtypesCore.h:45
constexpr Bool_t kFALSE
Definition RtypesCore.h:94
constexpr Bool_t kTRUE
Definition RtypesCore.h:93
const char Option_t
Definition RtypesCore.h:66
#define BIT(n)
Definition Rtypes.h:90
#define ClassImp(name)
Definition Rtypes.h:374
ROOT::Detail::TRangeCast< T, true > TRangeDynCast
TRangeDynCast is an adapter class that allows the typed iteration through a TCollection.
#define R__ASSERT(e)
Checks condition e and reports a fatal error if it's false.
Definition TError.h:125
TClassRef R__TH1_Class("TH1")
static Int_t R__GetSystemMaxOpenedFiles()
Return the maximum number of allowed opened files minus some wiggle room for CINT or at least of the ...
TClassRef R__RNTuple_Class("ROOT::RNTuple")
TClassRef R__TTree_Class("TTree")
static const Int_t kCpProgress
static const Int_t kCintFileNumber
winID h TVirtualViewer3D TVirtualGLPainter p
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 Pixmap_t Pixmap_t PictureAttributes_t attr const char char ret_data h unsigned char height h Atom_t Int_t ULong_t ULong_t unsigned char prop_list Atom_t Atom_t target
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 result
Option_t Option_t TPoint TPoint const char mode
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 Pixmap_t Pixmap_t PictureAttributes_t attr const char char ret_data h unsigned char height h Atom_t Int_t ULong_t ULong_t unsigned char prop_list Atom_t Atom_t Atom_t Time_t type
char name[80]
Definition TGX11.cxx:110
@ kMustCleanup
Definition TObject.h:374
R__EXTERN TVirtualMutex * gROOTMutex
Definition TROOT.h:63
#define gROOT
Definition TROOT.h:414
void Printf(const char *fmt,...)
Formats a string in a circular formatting buffer and prints the string.
Definition TString.cxx:2503
R__EXTERN TSystem * gSystem
Definition TSystem.h:572
#define R__LOCKGUARD(mutex)
#define _(A, B)
Definition cfortran.h:108
const_iterator end() const
TClassRef is used to implement a permanent reference to a TClass object.
Definition TClassRef.h:29
TClass instances represent classes, structs and namespaces in the ROOT type system.
Definition TClass.h:84
TMethod * GetMethodWithPrototype(const char *method, const char *proto, Bool_t objectIsConst=kFALSE, ROOT::EFunctionMatchMode mode=ROOT::kConversionMatch)
Find the method with a given prototype.
Definition TClass.cxx:4584
void Destructor(void *obj, Bool_t dtorOnly=kFALSE)
Explicitly call destructor for object.
Definition TClass.cxx:5540
ROOT::ResetAfterMergeFunc_t GetResetAfterMerge() const
Return the wrapper around Merge.
Definition TClass.cxx:7629
Bool_t IsLoaded() const
Return true if the shared library of this class is currently in the a process's memory.
Definition TClass.cxx:6055
Bool_t IsTObject() const
Return kTRUE is the class inherits from TObject.
Definition TClass.cxx:6081
Bool_t InheritsFrom(const char *cl) const override
Return kTRUE if this class inherits from a class with name "classname".
Definition TClass.cxx:5002
ROOT::MergeFunc_t GetMerge() const
Return the wrapper around Merge.
Definition TClass.cxx:7621
static TClass * GetClass(const char *name, Bool_t load=kTRUE, Bool_t silent=kFALSE)
Static method returning pointer to TClass of the specified class name.
Definition TClass.cxx:3074
Collection abstract base class.
Definition TCollection.h:65
static TClass * Class()
virtual Int_t GetEntries() const
virtual void SetOwner(Bool_t enable=kTRUE)
Set whether this collection is the owner (enable==true) of its content.
void Print(Option_t *option="") const override
Default print for collections, calls Print(option, 1).
TDirectory::TContext keeps track and restore the current directory.
Definition TDirectory.h:89
Describe directory structure in memory.
Definition TDirectory.h:45
static TClass * Class()
virtual TDirectory * GetDirectory(const char *namecycle, Bool_t printError=false, const char *funcname="GetDirectory")
Find a directory using apath.
virtual const char * GetPath() const
Returns the full path of the directory.
This class provides file copy and merging services.
Definition TFileMerger.h:30
TString fObjectNames
List of object names to be either merged exclusively or skipped.
Definition TFileMerger.h:63
virtual Bool_t OutputFile(const char *url, Bool_t force)
Open merger output file.
TList fMergeList
list of TObjString containing the name of the files need to be merged
Definition TFileMerger.h:64
virtual Bool_t AddFile(TFile *source, Bool_t own, Bool_t cpProgress)
Add the TFile to this file merger and give ownership of the TFile to this object (unless kFALSE is re...
virtual void PrintFiles(Option_t *options)
Print list of files being merged.
Bool_t fHistoOneGo
Merger histos in one go (default is kTRUE)
Definition TFileMerger.h:62
virtual Bool_t MergeRecursive(TDirectory *target, TList *sourcelist, Int_t type=kRegular|kAll)
Merge all objects in a directory.
void RecursiveRemove(TObject *obj) override
Intercept the case where the output TFile is deleted!
TList fFileList
A list the file (TFile*) which shall be merged.
Definition TFileMerger.h:47
virtual Bool_t Merge(Bool_t=kTRUE)
Merge the files.
virtual Bool_t MergeOne(TDirectory *target, TList *sourcelist, Int_t type, TFileMergeInfo &info, TString &oldkeyname, THashList &allNames, Bool_t &status, Bool_t &onlyListed, const TString &path, TDirectory *current_sourcedir, TFile *current_file, TKey *key, TObject *obj, TIter &nextkey)
TString fOutputFilename
The name of the outputfile for merging.
Definition TFileMerger.h:49
TString fMsgPrefix
Prefix to be used when printing informational message (default TFileMerger)
Definition TFileMerger.h:57
TIOFeatures * fIOFeatures
IO features to use in the output file.
Definition TFileMerger.h:56
TFileMerger(const TFileMerger &)=delete
void SetMsgPrefix(const char *prefix)
Set the prefix to be used when printing informational message.
Bool_t fNoTrees
True if Trees should not be merged (default is kFALSE)
Definition TFileMerger.h:51
bool fOutFileWasExplicitlyClosed
! the user has called CloseOutputFile(), so we shouldn't error out in RecursiveRemove
Definition TFileMerger.h:67
@ kAll
Merge all type of objects (default)
Definition TFileMerger.h:87
@ kIncremental
Merge the input file with the content of the output file (if already existing).
Definition TFileMerger.h:82
@ kKeepCompression
Keep compression level unchanged for each input files.
Definition TFileMerger.h:92
@ kSkipListed
Skip objects specified in fObjectNames list.
Definition TFileMerger.h:91
@ kNonResetable
Only the objects without a MergeAfterReset member function.
Definition TFileMerger.h:84
@ kResetable
Only the objects with a MergeAfterReset member function.
Definition TFileMerger.h:83
@ kOnlyListed
Only the objects specified in fObjectNames list.
Definition TFileMerger.h:90
@ kRegular
Normal merge, overwriting the output file.
Definition TFileMerger.h:81
@ kDelayWrite
Delay the TFile write (to reduce the number of write when reusing the file)
Definition TFileMerger.h:85
Bool_t fExplicitCompLevel
True if the user explicitly requested a compression level change (default kFALSE)
Definition TFileMerger.h:52
Bool_t fCompressionChange
True if the output and input have different compression level (default kFALSE)
Definition TFileMerger.h:53
EErrorBehavior fErrBehavior
What to do in case of errors during merging.
Definition TFileMerger.h:58
Int_t fPrintLevel
How much information to print out at run time.
Definition TFileMerger.h:54
void SetMaxOpenedFiles(Int_t newmax)
Set a limit to the number of files that TFileMerger will open simultaneously.
TString fMergeOptions
Options (in string format) to be passed down to the Merge functions.
Definition TFileMerger.h:55
void CloseOutputFile()
Closes output file.
~TFileMerger() override
Cleanup.
@ kFailOnError
The merging process will stop and yield failure when encountering invalid objects.
@ kSkipOnError
The merging process will skip invalid objects and continue.
Bool_t OpenExcessFiles()
Open up to fMaxOpenedFiles of the excess files.
TList fExcessFiles
! List of TObjString containing the name of the files not yet added to fFileList due to user or syste...
Definition TFileMerger.h:65
TFile * fOutputFile
The outputfile for merging.
Definition TFileMerger.h:48
virtual Bool_t PartialMerge(Int_t type=kAll|kIncremental)
Merge the files.
Bool_t fLocal
Makes local copies of merging files if True (default is kTRUE)
Definition TFileMerger.h:61
virtual void Reset()
Reset merger file list.
Int_t fMaxOpenedFiles
Maximum number of files opened at the same time by the TFileMerger.
Definition TFileMerger.h:60
virtual Bool_t AddAdoptFile(TFile *source, Bool_t cpProgress=kTRUE)
Add the TFile to this file merger and give ownership of the TFile to this object (unless kFALSE is re...
Bool_t fFastMethod
True if using Fast merging algorithm (default)
Definition TFileMerger.h:50
A ROOT file is an on-disk file, usually with extension .root, that stores objects in a file-system-li...
Definition TFile.h:131
Int_t GetCompressionSettings() const
Definition TFile.h:484
Int_t GetCompressionLevel() const
Definition TFile.h:478
virtual Bool_t Cp(const char *dst, Bool_t progressbar=kTRUE, UInt_t buffersize=1000000)
Allows to copy this file to the dst URL.
Definition TFile.cxx:5051
static TFile * Open(const char *name, Option_t *option="", const char *ftitle="", Int_t compress=ROOT::RCompressionSetting::EDefaults::kUseCompiledDefault, Int_t netopt=0)
Create / open a file.
Definition TFile.cxx:4131
Int_t Write(const char *name=nullptr, Int_t opt=0, Int_t bufsiz=0) override
Write memory objects to this file.
Definition TFile.cxx:2477
void Close(Option_t *option="") override
Close a file.
Definition TFile.cxx:955
@ kCancelTTreeChangeRequest
Definition TFile.h:280
THashList implements a hybrid collection class consisting of a hash table and a list to store TObject...
Definition THashList.h:34
Book space in a file, create I/O buffers, to fill them, (un)compress them.
Definition TKey.h:28
const char * GetTitle() const override
Returns title (title can contain 32x32 xpm thumbnail/icon).
Definition TKey.cxx:1521
virtual const char * GetClassName() const
Definition TKey.h:75
virtual TObject * ReadObj()
To read a TObject* from the file.
Definition TKey.cxx:758
A doubly linked list.
Definition TList.h:38
void Clear(Option_t *option="") override
Remove all objects from the list.
Definition TList.cxx:400
void Add(TObject *obj) override
Definition TList.h:81
TObject * Remove(TObject *obj) override
Remove object from the list.
Definition TList.cxx:820
TObject * First() const override
Return the first object in the list. Returns 0 when list is empty.
Definition TList.cxx:657
static TClass * Class()
const char * GetName() const override
Returns name of object.
Definition TNamed.h:49
An array of TObjects.
Definition TObjArray.h:31
Collectable string class.
Definition TObjString.h:28
Mother of all ROOT objects.
Definition TObject.h:41
virtual void Clear(Option_t *="")
Definition TObject.h:125
@ kOverwrite
overwrite existing object with same name
Definition TObject.h:98
@ kSingleKey
write collection with single key
Definition TObject.h:97
virtual const char * GetName() const
Returns name of object.
Definition TObject.cxx:457
R__ALWAYS_INLINE Bool_t TestBit(UInt_t f) const
Definition TObject.h:205
virtual TObject * Clone(const char *newname="") const
Make a clone of an object using the Streamer facility.
Definition TObject.cxx:242
virtual void Warning(const char *method, const char *msgfmt,...) const
Issue warning message.
Definition TObject.cxx:1057
virtual void Execute(const char *method, const char *params, Int_t *error=nullptr)
Execute method on this object with the given parameter string, e.g.
Definition TObject.cxx:377
R__ALWAYS_INLINE Bool_t IsZombie() const
Definition TObject.h:159
virtual Int_t Write(const char *name=nullptr, Int_t option=0, Int_t bufsize=0)
Write this object to the current directory.
Definition TObject.cxx:964
void SetBit(UInt_t f, Bool_t set)
Set or unset the user status bits as specified in f.
Definition TObject.cxx:864
virtual Bool_t InheritsFrom(const char *classname) const
Returns kTRUE if object inherits from class "classname".
Definition TObject.cxx:543
virtual void Error(const char *method, const char *msgfmt,...) const
Issue error message.
Definition TObject.cxx:1071
virtual void Fatal(const char *method, const char *msgfmt,...) const
Issue fatal error message.
Definition TObject.cxx:1099
virtual const char * GetTitle() const
Returns title of object.
Definition TObject.cxx:501
virtual TClass * IsA() const
Definition TObject.h:249
void ResetBit(UInt_t f)
Definition TObject.h:204
@ kCanDelete
if object in a list can be deleted
Definition TObject.h:68
@ kMustCleanup
if object destructor must call RecursiveRemove()
Definition TObject.h:70
Basic string class.
Definition TString.h:139
void Clear()
Clear string without changing its capacity.
Definition TString.cxx:1235
const char * Data() const
Definition TString.h:376
TObjArray * Tokenize(const TString &delim) const
This function is used to isolate sequential tokens in a TString.
Definition TString.cxx:2264
TString & Remove(Ssiz_t pos)
Definition TString.h:685
Bool_t Contains(const char *pat, ECaseCompare cmp=kExact) const
Definition TString.h:632
virtual int Unlink(const char *name)
Unlink, i.e.
Definition TSystem.cxx:1393
virtual const char * TempDirectory() const
Return a user configured or systemwide directory to create temporary files in.
Definition TSystem.cxx:1494
This class defines a UUID (Universally Unique IDentifier), also known as GUIDs (Globally Unique IDent...
Definition TUUID.h:42
const char * AsString() const
Return UUID as string. Copy string immediately since it will be reused.
Definition TUUID.cxx:571
This class represents a WWW compatible URL.
Definition TUrl.h:33
std::ostream & Info()
Definition hadd.cxx:171
Long64_t(* MergeFunc_t)(void *, TCollection *, TFileMergeInfo *)
Definition Rtypes.h:120
Short_t Min(Short_t a, Short_t b)
Returns the smallest of a and b.
Definition TMathBase.h:198