Logo ROOT  
Reference Guide
TClass.cxx
Go to the documentation of this file.
1// @(#)root/meta:$Id: 7109cb45f1219c2aae6be19906ae5a63e31972ef $
2// Author: Rene Brun 07/01/95
3
4/*************************************************************************
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 *************************************************************************/
11
12/** \class TClass
13TClass instances represent classes, structs and namespaces in the ROOT type system.
14
15TClass instances are created starting from different sources of information:
161. TStreamerInfo instances saved in a ROOT file which is opened. This is called in jargon an *emulated TClass*.
172. From TProtoClass instances saved in a ROOT pcm file created by the dictionary generator and the dictionary itself.
183. From a lookup in the AST built by cling.
19
20If a TClass instance is built through the mechanisms 1. and 2., it does not contain information about methods of the
21class/struct/namespace it represents. Conversely, if built through 3. or 1., it does not carry the information which is necessary
22to ROOT to perform I/O of instances of the class/struct it represents.
23The mechanisms 1., 2. and 3. are not mutually exclusive: it can happen that during the execution of the program, all
24the three are triggered, modifying the state of the TClass instance.
25
26In order to retrieve a TClass instance from the type system, a query can be executed as follows through the static
27TClass::GetClass method:
28
29~~~ {.cpp}
30auto myClassTClass_0 = TClass::GetClass("myClass");
31auto myClassTClass_1 = TClass::GetClass<myClass>();
32auto myClassTClass_2 = TClass::GetClass(myClassTypeInfo);
33~~~
34
35The name of classes is crucial for ROOT. A careful procedure of *name normalization* is carried out for
36each and every class. A *normalized name* is a valid C++ class name.
37In order to access the name of a class within the ROOT type system, the method TClass::GetName() can be used.
38*/
39
40//*-*x7.5 macros/layout_class
41
42#include "TClass.h"
43
44#include "strlcpy.h"
45#include "snprintf.h"
46#include "TBaseClass.h"
47#include "TBrowser.h"
48#include "TBuffer.h"
49#include "TClassGenerator.h"
50#include "TClassEdit.h"
51#include "TClassMenuItem.h"
52#include "TClassRef.h"
53#include "TClassTable.h"
54#include "TDataMember.h"
55#include "TDataType.h"
56#include "TDatime.h"
57#include "TEnum.h"
58#include "TError.h"
59#include "TExMap.h"
60#include "TFunctionTemplate.h"
61#include "THashList.h"
62#include "TInterpreter.h"
63#include "TMemberInspector.h"
64#include "TMethod.h"
65#include "TMethodArg.h"
66#include "TMethodCall.h"
67#include "TObjArray.h"
68#include "TObjString.h"
69#include "TProtoClass.h"
70#include "TROOT.h"
71#include "TRealData.h"
72#include "TCheckHashRecursiveRemoveConsistency.h" // Private header
73#include "TStreamer.h"
74#include "TStreamerElement.h"
77#include "TVirtualIsAProxy.h"
78#include "TVirtualRefProxy.h"
79#include "TVirtualMutex.h"
80#include "TVirtualPad.h"
81#include "THashTable.h"
82#include "TSchemaRuleSet.h"
83#include "TGenericClassInfo.h"
84#include "TIsAProxy.h"
85#include "TSchemaRule.h"
86#include "TSystem.h"
87#include "TThreadSlots.h"
88#include "ThreadLocalStorage.h"
89
90#include <cstdio>
91#include <cctype>
92#include <set>
93#include <iostream>
94#include <sstream>
95#include <string>
96#include <map>
97#include <typeinfo>
98#include <cmath>
99#include <cassert>
100#include <vector>
101#include <memory>
102
103#include "TSpinLockGuard.h"
104
105#ifdef WIN32
106#include <io.h>
107#include "Windows4Root.h"
108#include <Psapi.h>
109#define RTLD_DEFAULT ((void *)::GetModuleHandle(NULL))
110#define dlsym(library, function_name) ::GetProcAddress((HMODULE)library, function_name)
111#else
112#include <dlfcn.h>
113#endif
114
115#include "TListOfDataMembers.h"
116#include "TListOfFunctions.h"
118#include "TListOfEnums.h"
119#include "TListOfEnumsWithLock.h"
120#include "TViewPubDataMembers.h"
121#include "TViewPubFunctions.h"
122#include "TArray.h"
123#include "TClonesArray.h"
124#include "TRef.h"
125#include "TRefArray.h"
126
127using namespace std;
128
129// Mutex to protect CINT and META operations
130// (exported to be used for similar cases in related classes)
131
133
134namespace {
135
136 static constexpr const char kUndeterminedClassInfoName[] = "<NOT YET DETERMINED FROM fClassInfo>";
137
138 class TMmallocDescTemp {
139 private:
140 void *fSave;
141 public:
142 TMmallocDescTemp(void *value = nullptr) :
144 ~TMmallocDescTemp() { ROOT::Internal::gMmallocDesc = fSave; }
145 };
146
147 // When a new class is created, we need to be able to find
148 // if there are any existing classes that have the same name
149 // after any typedefs are expanded. (This only really affects
150 // template arguments.) To avoid having to search through all classes
151 // in that case, we keep a hash table mapping from the fully
152 // typedef-expanded names to the original class names.
153 // An entry is made in the table only if they are actually different.
154 //
155 // In these objects, the TObjString base holds the typedef-expanded
156 // name (the hash key), and fOrigName holds the original class name
157 // (the value to which the key maps).
158 //
159 class TNameMapNode : public TObjString {
160 public:
161 TString fOrigName;
162
163 TNameMapNode(const char *typedf, const char *orig) :
164 TObjString (typedf),
165 fOrigName (orig)
166 {
167 }
168 };
169
170}
171
172std::atomic<Int_t> TClass::fgClassCount;
173
174static bool IsFromRootCling() {
175 // rootcling also uses TCling for generating the dictionary ROOT files.
176 const static bool foundSymbol = dlsym(RTLD_DEFAULT, "usedToIdentifyRootClingByDlSym");
177 return foundSymbol;
178}
179
180// Implementation of the TDeclNameRegistry
181
182////////////////////////////////////////////////////////////////////////////////
183/// TDeclNameRegistry class constructor.
184
186{
187 // MSVC doesn't support fSpinLock=ATOMIC_FLAG_INIT; in the class definition
188 std::atomic_flag_clear( &fSpinLock );
189}
190
191////////////////////////////////////////////////////////////////////////////////
192/// Extract this part of the name
193/// 1. Templates `ns::%ns2::,,,::%THISPART<...`
194/// 2. Namespaces,classes `ns::%ns2::,,,::%THISPART`
195
197{
198 // Sanity check
199 auto strLen = name ? strlen(name) : 0;
200 if (strLen == 0) return;
201 // find <. If none, put end of string
202 const char* endCharPtr = strchr(name, '<');
203 endCharPtr = !endCharPtr ? &name[strLen] : endCharPtr;
204 // find last : before the <. If not found, put begin of string
205 const char* beginCharPtr = endCharPtr;
206 while (beginCharPtr!=name){
207 if (*beginCharPtr==':'){
208 beginCharPtr++;
209 break;
210 }
211 beginCharPtr--;
212 }
213 beginCharPtr = beginCharPtr!=endCharPtr ? beginCharPtr : name;
214 std::string s(beginCharPtr, endCharPtr);
215 if (fVerbLevel>1)
216 printf("TDeclNameRegistry::AddQualifiedName Adding key %s for class/namespace %s\n", s.c_str(), name);
217 ROOT::Internal::TSpinLockGuard slg(fSpinLock);
218 fClassNamesSet.insert(s);
219}
220
221////////////////////////////////////////////////////////////////////////////////
222
224{
225 Bool_t found = false;
226 {
227 ROOT::Internal::TSpinLockGuard slg(fSpinLock);
228 found = fClassNamesSet.find(name) != fClassNamesSet.end();
229 }
230 return found;
231}
232
233////////////////////////////////////////////////////////////////////////////////
234
236{
237 if (fVerbLevel > 1) {
238 printf("TDeclNameRegistry Destructor. List of %lu names:\n",
239 (long unsigned int)fClassNamesSet.size());
240 for (auto const & key: fClassNamesSet) {
241 printf(" - %s\n", key.c_str());
242 }
243 }
244}
245
246////////////////////////////////////////////////////////////////////////////////
247
249 const char *name,
250 TDeclNameRegistry &emuRegistry): fState(state),fName(name), fNoInfoOrEmuOrFwdDeclNameRegistry(emuRegistry) {}
251
252////////////////////////////////////////////////////////////////////////////////
253
255 if (fState == TClass::kNoInfo ||
259 }
260 }
261
262// Initialise the global member of TClass
264
265//Intent of why/how TClass::New() is called
266//[Not a static data member because MacOS does not support static thread local data member ... who knows why]
268 TTHREAD_TLS(TClass::ENewType) fgCallingNew = TClass::kRealNew;
269 return fgCallingNew;
270}
271
273{
276
278 fCurrentValue(TClass__GetCallingNew()),
279 fOldValue(fCurrentValue)
280 {
281 fCurrentValue = newvalue;
282 }
283
285 {
286 fCurrentValue = fOldValue;
287 }
288};
289
290void TClass::RegisterAddressInRepository(const char * /*where*/, void *location, const TClass *what) const
291{
292 // Register the object for special handling in the destructor.
293
294 Version_t version = what->GetClassVersion();
295// if (!fObjectVersionRepository.count(location)) {
296// Info(where, "Registering address %p of class '%s' version %d", location, what->GetName(), version);
297// } else {
298// Warning(where, "Registering address %p again of class '%s' version %d", location, what->GetName(), version);
299// }
300 {
302 fObjectVersionRepository.insert(RepoCont_t::value_type(location, version));
303 }
304#if 0
305 // This code could be used to prevent an address to be registered twice.
306 std::pair<RepoCont_t::iterator, Bool_t> tmp = fObjectVersionRepository.insert(RepoCont_t::value_type>(location, version));
307 if (!tmp.second) {
308 Warning(where, "Reregistering an object of class '%s' version %d at address %p", what->GetName(), version, p);
309 fObjectVersionRepository.erase(tmp.first);
310 tmp = fObjectVersionRepository.insert(RepoCont_t::value_type>(location, version));
311 if (!tmp.second) {
312 Warning(where, "Failed to reregister an object of class '%s' version %d at address %p", what->GetName(), version, location);
313 }
314 }
315#endif
316}
317
318void TClass::UnregisterAddressInRepository(const char * /*where*/, void *location, const TClass *what) const
319{
320 // Remove an address from the repository of address/object.
321
323 RepoCont_t::iterator cur = fObjectVersionRepository.find(location);
324 for (; cur != fObjectVersionRepository.end();) {
325 RepoCont_t::iterator tmp = cur++;
326 if ((tmp->first == location) && (tmp->second == what->GetClassVersion())) {
327 // -- We still have an address, version match.
328 // Info(where, "Unregistering address %p of class '%s' version %d", location, what->GetName(), what->GetClassVersion());
329 fObjectVersionRepository.erase(tmp);
330 } else {
331 // -- No address, version match, we've reached the end.
332 break;
333 }
334 }
335}
336
337void TClass::MoveAddressInRepository(const char * /*where*/, void *oldadd, void *newadd, const TClass *what) const
338{
339 // Register in the repository that an object has moved.
340
341 // Move not only the object itself but also any base classes or sub-objects.
342 size_t objsize = what->Size();
343 long delta = (char*)newadd - (char*)oldadd;
345 RepoCont_t::iterator cur = fObjectVersionRepository.find(oldadd);
346 for (; cur != fObjectVersionRepository.end();) {
347 RepoCont_t::iterator tmp = cur++;
348 if (oldadd <= tmp->first && tmp->first < ( ((char*)oldadd) + objsize) ) {
349 // The location is within the object, let's move it.
350
351 fObjectVersionRepository.insert(RepoCont_t::value_type(((char*)tmp->first)+delta, tmp->second));
352 fObjectVersionRepository.erase(tmp);
353
354 } else {
355 // -- No address, version match, we've reached the end.
356 break;
357 }
358 }
359}
360
361//______________________________________________________________________________
362//______________________________________________________________________________
363namespace ROOT {
364#define R__USE_STD_MAP
366#if defined R__USE_STD_MAP
367 // This wrapper class allow to avoid putting #include <map> in the
368 // TROOT.h header file.
369 public:
370 typedef std::map<std::string,TClass*> IdMap_t;
374#ifdef R__WIN32
375 // Window's std::map does NOT defined mapped_type
376 typedef TClass* mapped_type;
377#else
379#endif
380
381 private:
383
384 public:
385 void Add(const key_type &key, mapped_type &obj)
386 {
387 // Add the <key,obj> pair to the map.
388 fMap[key] = obj;
389 }
390 mapped_type Find(const key_type &key) const
391 {
392 // Find the type corresponding to the key.
393 IdMap_t::const_iterator iter = fMap.find(key);
394 mapped_type cl = nullptr;
395 if (iter != fMap.end()) cl = iter->second;
396 return cl;
397 }
398 void Remove(const key_type &key) {
399 // Remove the type corresponding to the key.
400 fMap.erase(key);
401 }
402#else
403 private:
404 TMap fMap;
405
406 public:
407#ifdef R__COMPLETE_MEM_TERMINATION
409 TIter next(&fMap);
410 TObjString *key;
411 while((key = (TObjString*)next())) {
412 delete key;
413 }
414 }
415#endif
416 void Add(const char *key, TClass *&obj) {
417 TObjString *realkey = new TObjString(key);
418 fMap.Add(realkey, obj);
419 }
420 TClass* Find(const char *key) const {
421 const TPair *a = (const TPair *)fMap.FindObject(key);
422 if (a) return (TClass*) a->Value();
423 return 0;
424 }
425 void Remove(const char *key) {
426 TObjString realkey(key);
427 TObject *actual = fMap.Remove(&realkey);
428 delete actual;
429 }
430#endif
431 };
432
434 // Wrapper class for the multimap of DeclId_t and TClass.
435 public:
436 typedef multimap<TDictionary::DeclId_t, TClass*> DeclIdMap_t;
440 typedef std::pair <const_iterator, const_iterator> equal_range;
442
443 private:
445
446 public:
447 void Add(const key_type &key, mapped_type obj)
448 {
449 // Add the <key,obj> pair to the map.
450 std::pair<const key_type, mapped_type> pair = make_pair(key, obj);
451 fMap.insert(pair);
452 }
454 {
455 return fMap.count(key);
456 }
457 equal_range Find(const key_type &key) const
458 {
459 // Find the type corresponding to the key.
460 return fMap.equal_range(key);
461 }
462 void Remove(const key_type &key) {
463 // Remove the type corresponding to the key.
464 fMap.erase(key);
465 }
466 };
467}
468
470
471#ifdef R__COMPLETE_MEM_TERMINATION
472 static IdMap_t gIdMapObject;
473 return &gIdMapObject;
474#else
475 static IdMap_t *gIdMap = new IdMap_t;
476 return gIdMap;
477#endif
478}
479
481
482#ifdef R__COMPLETE_MEM_TERMINATION
483 static DeclIdMap_t gDeclIdMapObject;
484 return &gDeclIdMapObject;
485#else
486 static DeclIdMap_t *gDeclIdMap = new DeclIdMap_t;
487 return gDeclIdMap;
488#endif
489}
490
491////////////////////////////////////////////////////////////////////////////////
492/// static: Add a class to the list and map of classes.
493
495{
496 if (!cl) return;
497
499 gROOT->GetListOfClasses()->Add(cl);
500 if (cl->GetTypeInfo()) {
501 GetIdMap()->Add(cl->GetTypeInfo()->name(),cl);
502 }
503 if (cl->fClassInfo) {
504 GetDeclIdMap()->Add((void*)(cl->fClassInfo), cl);
505 }
506}
507
508////////////////////////////////////////////////////////////////////////////////
509/// static: Add a TClass* to the map of classes.
510
512{
513 if (!cl || !id) return;
514 GetDeclIdMap()->Add(id, cl);
515}
516
517////////////////////////////////////////////////////////////////////////////////
518/// static: Remove a class from the list and map of classes
519
521{
522 if (!oldcl) return;
523
525 gROOT->GetListOfClasses()->Remove(oldcl);
526 if (oldcl->GetTypeInfo()) {
527 GetIdMap()->Remove(oldcl->GetTypeInfo()->name());
528 }
529 if (oldcl->fClassInfo) {
530 //GetDeclIdMap()->Remove((void*)(oldcl->fClassInfo));
531 }
532}
533
534////////////////////////////////////////////////////////////////////////////////
535
537{
538 if (!id) return;
539 GetDeclIdMap()->Remove(id);
540}
541
542////////////////////////////////////////////////////////////////////////////////
543/// Indirect call to the implementation of ShowMember allowing [forward]
544/// declaration with out a full definition of the TClass class.
545
546void ROOT::Class_ShowMembers(TClass *cl, const void *obj, TMemberInspector&insp)
547{
548 gInterpreter->InspectMembers(insp, obj, cl, kFALSE);
549}
550
551//______________________________________________________________________________
552//______________________________________________________________________________
553
556public:
557 TDumpMembers(bool noAddr): fNoAddr(noAddr) { }
558
560 void Inspect(TClass *cl, const char *parent, const char *name, const void *addr, Bool_t isTransient) override;
561};
562
563////////////////////////////////////////////////////////////////////////////////
564/// Print value of member mname.
565///
566/// This method is called by the ShowMembers() method for each
567/// data member when object.Dump() is invoked.
568///
569/// - cl is the pointer to the current class
570/// - pname is the parent name (in case of composed objects)
571/// - mname is the data member name
572/// - add is the data member address
573
574void TDumpMembers::Inspect(TClass *cl, const char *pname, const char *mname, const void *add, Bool_t /* isTransient */)
575{
576 const Int_t kvalue = 30;
577#ifdef R__B64
578 const Int_t ktitle = 50;
579#else
580 const Int_t ktitle = 42;
581#endif
582 const Int_t kline = 1024;
583 Int_t cdate = 0;
584 Int_t ctime = 0;
585 UInt_t *cdatime = nullptr;
586 char line[kline];
587
588 TDataType *membertype;
589 EDataType memberDataType = kNoType_t;
590 const char *memberName;
591 const char *memberFullTypeName;
592 const char *memberTitle;
593 Bool_t isapointer;
594 Bool_t isbasic;
595 Bool_t isarray;
596
597 if (TDataMember *member = cl->GetDataMember(mname)) {
598 if (member->GetDataType()) {
599 memberDataType = (EDataType)member->GetDataType()->GetType();
600 }
601 memberName = member->GetName();
602 memberFullTypeName = member->GetFullTypeName();
603 memberTitle = member->GetTitle();
604 isapointer = member->IsaPointer();
605 isbasic = member->IsBasic();
606 membertype = member->GetDataType();
607 isarray = member->GetArrayDim();
608 } else if (!cl->IsLoaded()) {
609 // The class is not loaded, hence it is 'emulated' and the main source of
610 // information is the StreamerInfo.
612 if (!info) return;
613 const char *cursor = mname;
614 while ( (*cursor)=='*' ) ++cursor;
615 TString elname( cursor );
616 Ssiz_t pos = elname.Index("[");
617 if ( pos != kNPOS ) {
618 elname.Remove( pos );
619 }
620 TStreamerElement *element = (TStreamerElement*)info->GetElements()->FindObject(elname.Data());
621 if (!element) return;
622 memberFullTypeName = element->GetTypeName();
623
624 memberDataType = (EDataType)element->GetType();
625
626 memberName = element->GetName();
627 memberTitle = element->GetTitle();
628 isapointer = element->IsaPointer() || element->GetType() == TVirtualStreamerInfo::kCharStar;
629 membertype = gROOT->GetType(memberFullTypeName);
630
631 isbasic = membertype !=nullptr;
632 isarray = element->GetArrayDim();
633 } else {
634 return;
635 }
636
637
638 Bool_t isdate = kFALSE;
639 if (strcmp(memberName,"fDatime") == 0 && memberDataType == kUInt_t) {
640 isdate = kTRUE;
641 }
642 Bool_t isbits = kFALSE;
643 if (strcmp(memberName,"fBits") == 0 && memberDataType == kUInt_t) {
644 isbits = kTRUE;
645 }
646 TClass * dataClass = TClass::GetClass(memberFullTypeName);
647 Bool_t isTString = (dataClass == TString::Class());
648 static TClassRef stdClass("std::string");
649 Bool_t isStdString = (dataClass == stdClass);
650
651 Int_t i;
652 for (i = 0;i < kline; i++) line[i] = ' ';
653 line[kline-1] = 0;
654 snprintf(line,kline,"%s%s ",pname,mname);
655 i = strlen(line); line[i] = ' ';
656
657 // Encode data value or pointer value
658 char *pointer = (char*)add;
659 char **ppointer = (char**)(pointer);
660
661 if (isapointer) {
662 char **p3pointer = (char**)(*ppointer);
663 if (!p3pointer)
664 snprintf(&line[kvalue],kline-kvalue,"->0");
665 else if (!isbasic) {
666 if (!fNoAddr) {
667 snprintf(&line[kvalue],kline-kvalue,"->%zx ", (size_t)p3pointer);
668 }
669 } else if (membertype) {
670 if (!strcmp(membertype->GetTypeName(), "char")) {
671 i = strlen(*ppointer);
672 if (kvalue+i > kline) i=kline-1-kvalue;
673 Bool_t isPrintable = kTRUE;
674 for (Int_t j = 0; j < i; j++) {
675 if (!std::isprint((*ppointer)[j])) {
676 isPrintable = kFALSE;
677 break;
678 }
679 }
680 if (isPrintable) {
681 strncpy(line + kvalue, *ppointer, i);
682 line[kvalue+i] = 0;
683 } else {
684 line[kvalue] = 0;
685 }
686 } else {
687 strncpy(&line[kvalue], membertype->AsString(p3pointer), TMath::Min(kline-1-kvalue,(int)strlen(membertype->AsString(p3pointer))));
688 }
689 } else if (!strcmp(memberFullTypeName, "char*") ||
690 !strcmp(memberFullTypeName, "const char*")) {
691 i = strlen(*ppointer);
692 if (kvalue+i >= kline) i=kline-1-kvalue;
693 Bool_t isPrintable = kTRUE;
694 for (Int_t j = 0; j < i; j++) {
695 if (!std::isprint((*ppointer)[j])) {
696 isPrintable = kFALSE;
697 break;
698 }
699 }
700 if (isPrintable) {
701 strncpy(line + kvalue, *ppointer, std::min( i, kline - kvalue));
702 line[kvalue+i] = 0;
703 } else {
704 line[kvalue] = 0;
705 }
706 } else {
707 if (!fNoAddr) {
708 snprintf(&line[kvalue],kline-kvalue,"->%zx ", (size_t)p3pointer);
709 }
710 }
711 } else if (membertype) {
712 if (isdate) {
713 cdatime = (UInt_t*)pointer;
714 TDatime::GetDateTime(cdatime[0],cdate,ctime);
715 snprintf(&line[kvalue],kline-kvalue,"%d/%d",cdate,ctime);
716 } else if (isbits) {
717 snprintf(&line[kvalue],kline-kvalue,"0x%08x", *(UInt_t*)pointer);
718 } else {
719 strncpy(&line[kvalue], membertype->AsString(pointer), TMath::Min(kline-1-kvalue,(int)strlen(membertype->AsString(pointer))));
720 }
721 } else {
722 if (isStdString) {
723 std::string *str = (std::string*)pointer;
724 snprintf(&line[kvalue],kline-kvalue,"%s",str->c_str());
725 } else if (isTString) {
726 TString *str = (TString*)pointer;
727 snprintf(&line[kvalue],kline-kvalue,"%s",str->Data());
728 } else {
729 if (!fNoAddr) {
730 snprintf(&line[kvalue],kline-kvalue,"->%zx ", (size_t)pointer);
731 }
732 }
733 }
734 // Encode data member title
735 if (isdate == kFALSE && strcmp(memberFullTypeName, "char*") && strcmp(memberFullTypeName, "const char*")) {
736 i = strlen(&line[0]); line[i] = ' ';
737 assert(250 > ktitle);
738 strlcpy(&line[ktitle],memberTitle,250-ktitle+1); // strlcpy copy 'size-1' characters.
739 }
740 if (isarray) {
741 // Should iterate over the element
742 strncat(line, " ...", kline-strlen(line)-1);
743 }
744 Printf("%s", line);
745}
746
748
749//______________________________________________________________________________
750
752
753private:
756
757public:
758 TBuildRealData(void *obj, TClass *cl) {
759 // Main constructor.
760 fRealDataObject = obj;
761 fRealDataClass = cl;
762 }
764 void Inspect(TClass *cl, const char *parent, const char *name, const void *addr, Bool_t isTransient) override;
765
766};
767
768////////////////////////////////////////////////////////////////////////////////
769/// This method is called from ShowMembers() via BuildRealdata().
770
771void TBuildRealData::Inspect(TClass* cl, const char* pname, const char* mname, const void* add, Bool_t isTransient)
772{
773 TDataMember* dm = cl->GetDataMember(mname);
774 if (!dm) {
775 return;
776 }
777
778 Bool_t isTransientMember = kFALSE;
779
780 if (!dm->IsPersistent()) {
781 // For the DataModelEvolution we need access to the transient member.
782 // so we now record them in the list of RealData.
783 isTransientMember = kTRUE;
784 isTransient = kTRUE;
785 }
786
787 TString rname( pname );
788 // Take into account cases like TPaveStats->TPaveText->TPave->TBox.
789 // Check that member is in a derived class or an object in the class.
790 if (cl != fRealDataClass) {
791 if (!fRealDataClass->InheritsFrom(cl)) {
792 Ssiz_t dot = rname.Index('.');
793 if (dot == kNPOS) {
794 return;
795 }
796 rname[dot] = '\0';
797 if (!fRealDataClass->GetDataMember(rname)) {
798 //could be a data member in a base class like in this example
799 // class Event : public Data {
800 // class Data : public TObject {
801 // EventHeader fEvtHdr;
802 // class EventHeader {
803 // Int_t fEvtNum;
804 // Int_t fRun;
805 // Int_t fDate;
806 // EventVertex fVertex;
807 // class EventVertex {
808 // EventTime fTime;
809 // class EventTime {
810 // Int_t fSec;
811 // Int_t fNanoSec;
812 if (!fRealDataClass->GetBaseDataMember(rname)) {
813 return;
814 }
815 }
816 rname[dot] = '.';
817 }
818 }
819
820 Longptr_t offset = Longptr_t(((Longptr_t) add) - ((Longptr_t) fRealDataObject));
821
822 if (TClassEdit::IsStdArray(dm->GetTypeName())){ // We tackle the std array case
823 TString rdName;
824 TRealData::GetName(rdName,dm);
825 rname += rdName;
826 TRealData* rd = new TRealData(rname.Data(), offset, dm);
827 fRealDataClass->GetListOfRealData()->Add(rd);
828 return;
829 }
830
831 rname += mname;
832
833 if (dm->IsaPointer()) {
834 // Data member is a pointer.
835 TRealData* rd = new TRealData(rname, offset, dm);
836 if (isTransientMember) { rd->SetBit(TRealData::kTransient); };
837 fRealDataClass->GetListOfRealData()->Add(rd);
838 } else {
839 // Data Member is a basic data type.
840 TRealData* rd = new TRealData(rname, offset, dm);
841 if (isTransientMember) { rd->SetBit(TRealData::kTransient); };
842 if (!dm->IsBasic()) {
843 rd->SetIsObject(kTRUE);
844
845 // Make sure that BuildReadData is called for any abstract
846 // bases classes involved in this object, i.e for all the
847 // classes composing this object (base classes, type of
848 // embedded object and same for their data members).
849 //
850 TClass* dmclass = TClass::GetClass(dm->GetTypeName(), kTRUE, isTransient);
851 if (!dmclass) {
852 dmclass = TClass::GetClass(dm->GetTrueTypeName(), kTRUE, isTransient);
853 }
854 if (dmclass) {
855 if ((dmclass != cl) && !dm->IsaPointer()) {
856 if (dmclass->GetCollectionProxy()) {
857 TClass* valcl = dmclass->GetCollectionProxy()->GetValueClass();
858 // We create the real data for the content of the collection to help the case
859 // of split branches in a TTree (where the node for the data member itself
860 // might have been elided). However, in some cases, like transient members
861 // and/or classes, the content might not be create-able. An example is the
862 // case of a map<A,B> where either A or B does not have default constructor
863 // and thus the compilation of the default constructor for pair<A,B> will
864 // fail (noisily) [This could also apply to any template instance, where it
865 // might have a default constructor definition that can not be compiled due
866 // to the template parameter]
867 if (valcl) {
868 Bool_t wantBuild = kTRUE;
869 if (valcl->Property() & kIsAbstract) wantBuild = kFALSE;
870 if ( (isTransient)
872 && (!valcl->IsLoaded()) ) {
873 // Case where the collection dictionary was not requested and
874 // the content's dictionary was also not requested.
875 // [This is a super set of what we need, but we can't really detect it :(]
876 wantBuild = kFALSE;
877 }
878
879 if (wantBuild) valcl->BuildRealData(nullptr, isTransient);
880 }
881 } else {
882 void* addrForRecursion = nullptr;
883 if (GetObjectValidity() == kValidObjectGiven)
884 addrForRecursion = const_cast<void*>(add);
885
886 dmclass->BuildRealData(addrForRecursion, isTransient);
887 }
888 }
889 }
890 }
891 fRealDataClass->GetListOfRealData()->Add(rd);
892 }
893}
894
895//______________________________________________________________________________
896//______________________________________________________________________________
897//______________________________________________________________________________
898
899////////////////////////////////////////////////////////////////////////////////
900
902public:
905
907 {
908 // main constructor.
909 fBrowser = b; fCount = 0;
910 }
911 virtual ~TAutoInspector() {}
913 void Inspect(TClass *cl, const char *parent, const char *name, const void *addr, Bool_t isTransient) override;
915};
916
917////////////////////////////////////////////////////////////////////////////////
918/// This method is called from ShowMembers() via AutoBrowse().
919
920void TAutoInspector::Inspect(TClass *cl, const char *tit, const char *name,
921 const void *addr, Bool_t /* isTransient */)
922{
923 if(tit && strchr(tit,'.')) return ;
924 if (fCount && !fBrowser) return;
925
926 TString ts;
927
928 if (!cl) return;
929 //if (*(cl->GetName()) == 'T') return;
930 if (*name == '*') name++;
931 int ln = strcspn(name,"[ ");
932 TString iname(name,ln);
933
934 ClassInfo_t *classInfo = cl->GetClassInfo();
935 if (!classInfo) return;
936
937 // Browse data members
939 TString mname;
940
941 int found=0;
942 while (gCling->DataMemberInfo_Next(m)) { // MemberLoop
943 mname = gCling->DataMemberInfo_Name(m);
944 mname.ReplaceAll("*","");
945 if ((found = (iname==mname))) break;
946 }
947 assert(found);
948
949 // we skip: non static members and non objects
950 // - the member G__virtualinfo inserted by the CINT RTTI system
951
952 //Long_t prop = m.Property() | m.Type()->Property();
954 if (prop & kIsStatic) return;
955 if (prop & kIsFundamental) return;
956 if (prop & kIsEnum) return;
957 if (mname == "G__virtualinfo") return;
958
959 int size = sizeof(void*);
960
961 int nmax = 1;
962 if (prop & kIsArray) {
963 for (int dim = 0; dim < gCling->DataMemberInfo_ArrayDim(m); dim++) nmax *= gCling->DataMemberInfo_MaxIndex(m,dim);
964 }
965
968 TClass * clm = TClass::GetClass(clmName.c_str());
969 R__ASSERT(clm);
970 if (!(prop & kIsPointer)) {
971 size = clm->Size();
973 }
974
975
978
979 for(int i=0; i<nmax; i++) {
980
981 char *ptr = (char*)addr + i*size;
982
983 void *obj = (prop & kIsPointer) ? *((void**)ptr) : (TObject*)ptr;
984
985 if (!obj) continue;
986
987 fCount++;
988 if (!fBrowser) return;
989
990 TString bwname;
991 TClass *actualClass = clm->GetActualClass(obj);
992 if (clm->IsTObject()) {
993 TObject *tobj = (TObject*)clm->DynamicCast(TObject::Class(),obj);
994 bwname = tobj->GetName();
995 } else {
996 bwname = actualClass->GetName();
997 bwname += "::";
998 bwname += mname;
999 }
1000
1001 if (!clm->IsTObject() ||
1002 bwname.Length()==0 ||
1003 strcmp(bwname.Data(),actualClass->GetName())==0) {
1004 bwname = name;
1005 int l = strcspn(bwname.Data(),"[ ");
1006 if (l<bwname.Length() && bwname[l]=='[') {
1007 char cbuf[13]; snprintf(cbuf,13,"[%02d]",i);
1008 ts.Replace(0,999,bwname,l);
1009 ts += cbuf;
1010 bwname = (const char*)ts;
1011 }
1012 }
1013
1014 if (proxy==nullptr) {
1015
1016 fBrowser->Add(obj,clm,bwname);
1017
1018 } else {
1019 TClass *valueCl = proxy->GetValueClass();
1020
1021 if (valueCl==nullptr) {
1022
1023 fBrowser->Add( obj, clm, bwname );
1024
1025 } else {
1026 TVirtualCollectionProxy::TPushPop env(proxy, obj);
1027 TClass *actualCl = nullptr;
1028
1029 int sz = proxy->Size();
1030
1031 char fmt[] = {"#%09d"};
1032 fmt[3] = '0'+(int)log10(double(sz))+1;
1033 char buf[20];
1034 for (int ii=0;ii<sz;ii++) {
1035 void *p = proxy->At(ii);
1036
1037 if (proxy->HasPointers()) {
1038 p = *((void**)p);
1039 if(!p) continue;
1040 actualCl = valueCl->GetActualClass(p);
1041 p = actualCl->DynamicCast(valueCl,p,0);
1042 }
1043 fCount++;
1044 snprintf(buf,20,fmt,ii);
1045 ts = bwname;
1046 ts += buf;
1047 fBrowser->Add( p, actualCl, ts );
1048 }
1049 }
1050 }
1051 }
1052}
1053
1054//______________________________________________________________________________
1055//______________________________________________________________________________
1056//______________________________________________________________________________
1057
1059
1060////////////////////////////////////////////////////////////////////////////////
1061/// Internal, default constructor.
1062///
1063/// \note Use `TClass::GetClass("ClassName")` to get access to a TClass object for a certain class!
1064
1066 TDictionary(),
1067 fPersistentRef(nullptr),
1068 fStreamerInfo(nullptr), fConversionStreamerInfo(nullptr), fRealData(nullptr),
1069 fBase(nullptr), fData(nullptr), fUsingData(nullptr), fEnums(nullptr), fFuncTemplate(nullptr), fMethod(nullptr), fAllPubData(nullptr),
1070 fAllPubMethod(nullptr), fClassMenuList(nullptr),
1072 fInstanceCount(0), fOnHeap(0),
1073 fCheckSum(0), fCollectionProxy(nullptr), fClassVersion(0), fClassInfo(nullptr),
1074 fTypeInfo(nullptr), fShowMembers(nullptr),
1075 fStreamer(nullptr), fIsA(nullptr), fGlobalIsA(nullptr), fIsAMethod(nullptr),
1076 fMerge(nullptr), fResetAfterMerge(nullptr), fNew(nullptr), fNewArray(nullptr), fDelete(nullptr), fDeleteArray(nullptr),
1077 fDestructor(nullptr), fDirAutoAdd(nullptr), fStreamerFunc(nullptr), fConvStreamerFunc(nullptr), fSizeof(-1),
1080 fState(kNoInfo),
1081 fCurrentInfo(nullptr), fLastReadInfo(nullptr), fRefProxy(nullptr),
1083
1084{
1085 // Default ctor.
1086
1088 {
1089 TMmallocDescTemp setreset;
1090 fStreamerInfo = new TObjArray(1, -2);
1091 }
1092 fDeclFileLine = -2; // -2 for standalone TClass (checked in dtor)
1093}
1094
1095////////////////////////////////////////////////////////////////////////////////
1096/// Create a TClass object. This object contains the full dictionary
1097/// of a class. It has list to baseclasses, datamembers and methods.
1098/// Use this ctor to create a standalone TClass object. Only useful
1099/// to get a temporary TClass interface to an interpreted class. Used by TTabCom.
1100///
1101/// \note Use `TClass::GetClass("ClassName")` to get access to a TClass object for a certain class!
1102
1103TClass::TClass(const char *name, Bool_t silent) :
1105 fPersistentRef(nullptr),
1106 fStreamerInfo(nullptr), fConversionStreamerInfo(nullptr), fRealData(nullptr),
1107 fBase(nullptr), fData(nullptr), fUsingData(nullptr), fEnums(nullptr), fFuncTemplate(nullptr), fMethod(nullptr), fAllPubData(nullptr),
1108 fAllPubMethod(nullptr), fClassMenuList(nullptr),
1109 fDeclFileName(""), fImplFileName(""), fDeclFileLine(0), fImplFileLine(0),
1110 fInstanceCount(0), fOnHeap(0),
1111 fCheckSum(0), fCollectionProxy(nullptr), fClassVersion(0), fClassInfo(nullptr),
1112 fTypeInfo(nullptr), fShowMembers(nullptr),
1113 fStreamer(nullptr), fIsA(nullptr), fGlobalIsA(nullptr), fIsAMethod(nullptr),
1114 fMerge(nullptr), fResetAfterMerge(nullptr), fNew(nullptr), fNewArray(nullptr), fDelete(nullptr), fDeleteArray(nullptr),
1115 fDestructor(nullptr), fDirAutoAdd(nullptr), fStreamerFunc(nullptr), fConvStreamerFunc(nullptr), fSizeof(-1),
1116 fCanSplit(-1), fIsSyntheticPair(kFALSE), fProperty(0), fClassProperty(0), fHasRootPcmInfo(kFALSE), fCanLoadClassInfo(kFALSE),
1117 fIsOffsetStreamerSet(kFALSE), fVersionUsed(kFALSE), fRuntimeProperties(0), fOffsetStreamer(0), fStreamerType(TClass::kDefault),
1118 fState(kNoInfo),
1119 fCurrentInfo(nullptr), fLastReadInfo(nullptr), fRefProxy(nullptr),
1120 fSchemaRules(nullptr), fStreamerImpl(&TClass::StreamerDefault)
1121{
1123
1124 if (!gROOT)
1125 ::Fatal("TClass::TClass", "ROOT system not initialized");
1126
1127 {
1128 TMmallocDescTemp setreset;
1129 fStreamerInfo = new TObjArray(1, -2);
1130 }
1131 fDeclFileLine = -2; // -2 for standalone TClass (checked in dtor)
1132
1134 if (!gInterpreter)
1135 ::Fatal("TClass::TClass", "gInterpreter not initialized");
1136
1137 gInterpreter->SetClassInfo(this); // sets fClassInfo pointer
1138 if (!silent && !fClassInfo && !TClassEdit::IsArtificial(name))
1139 ::Warning("TClass::TClass", "no dictionary for class %s is available", name);
1141
1143 fConversionStreamerInfo = nullptr;
1144}
1145
1146////////////////////////////////////////////////////////////////////////////////
1147/// Internal constructor.
1148///
1149/// \note Use `TClass::GetClass("ClassName")` to get access to a TClass object for a certain class!
1150
1151TClass::TClass(const char *name, Version_t cversion, Bool_t silent) :
1153 fPersistentRef(nullptr),
1154 fStreamerInfo(nullptr), fConversionStreamerInfo(nullptr), fRealData(nullptr),
1155 fBase(nullptr), fData(nullptr), fUsingData(nullptr), fEnums(nullptr), fFuncTemplate(nullptr), fMethod(nullptr), fAllPubData(nullptr),
1156 fAllPubMethod(nullptr), fClassMenuList(nullptr),
1157 fDeclFileName(""), fImplFileName(""), fDeclFileLine(0), fImplFileLine(0),
1158 fInstanceCount(0), fOnHeap(0),
1159 fCheckSum(0), fCollectionProxy(nullptr), fClassVersion(0), fClassInfo(nullptr),
1160 fTypeInfo(nullptr), fShowMembers(nullptr),
1161 fStreamer(nullptr), fIsA(nullptr), fGlobalIsA(nullptr), fIsAMethod(nullptr),
1162 fMerge(nullptr), fResetAfterMerge(nullptr), fNew(nullptr), fNewArray(nullptr), fDelete(nullptr), fDeleteArray(nullptr),
1163 fDestructor(nullptr), fDirAutoAdd(nullptr), fStreamerFunc(nullptr), fConvStreamerFunc(nullptr), fSizeof(-1),
1164 fCanSplit(-1), fIsSyntheticPair(kFALSE), fProperty(0), fClassProperty(0), fHasRootPcmInfo(kFALSE), fCanLoadClassInfo(kFALSE),
1165 fIsOffsetStreamerSet(kFALSE), fVersionUsed(kFALSE), fRuntimeProperties(0), fOffsetStreamer(0), fStreamerType(TClass::kDefault),
1166 fState(kNoInfo),
1167 fCurrentInfo(nullptr), fLastReadInfo(nullptr), fRefProxy(nullptr),
1168 fSchemaRules(nullptr), fStreamerImpl(&TClass::StreamerDefault)
1169{
1171 Init(name, cversion, nullptr, nullptr, nullptr, nullptr, -1, -1, nullptr, silent);
1172}
1173
1174////////////////////////////////////////////////////////////////////////////////
1175/// Internal constructor, mimicing the case of a class fwd declared in the interpreter.
1176///
1177/// \note Use `TClass::GetClass("ClassName")` to get access to a TClass object for a certain class!
1178
1179TClass::TClass(const char *name, Version_t cversion, EState theState, Bool_t silent) :
1181 fPersistentRef(nullptr),
1182 fStreamerInfo(nullptr), fConversionStreamerInfo(nullptr), fRealData(nullptr),
1183 fBase(nullptr), fData(nullptr), fUsingData(nullptr), fEnums(nullptr), fFuncTemplate(nullptr), fMethod(nullptr), fAllPubData(nullptr),
1184 fAllPubMethod(nullptr), fClassMenuList(nullptr),
1185 fDeclFileName(""), fImplFileName(""), fDeclFileLine(0), fImplFileLine(0),
1186 fInstanceCount(0), fOnHeap(0),
1187 fCheckSum(0), fCollectionProxy(nullptr), fClassVersion(0), fClassInfo(nullptr),
1188 fTypeInfo(nullptr), fShowMembers(nullptr),
1189 fStreamer(nullptr), fIsA(nullptr), fGlobalIsA(nullptr), fIsAMethod(nullptr),
1190 fMerge(nullptr), fResetAfterMerge(nullptr), fNew(nullptr), fNewArray(nullptr), fDelete(nullptr), fDeleteArray(nullptr),
1191 fDestructor(nullptr), fDirAutoAdd(nullptr), fStreamerFunc(nullptr), fConvStreamerFunc(nullptr), fSizeof(-1),
1192 fCanSplit(-1), fIsSyntheticPair(kFALSE), fProperty(0), fClassProperty(0), fHasRootPcmInfo(kFALSE), fCanLoadClassInfo(kFALSE),
1193 fIsOffsetStreamerSet(kFALSE), fVersionUsed(kFALSE), fRuntimeProperties(0), fOffsetStreamer(0), fStreamerType(TClass::kDefault),
1194 fState(theState),
1195 fCurrentInfo(nullptr), fLastReadInfo(nullptr), fRefProxy(nullptr),
1196 fSchemaRules(nullptr), fStreamerImpl(&TClass::StreamerDefault)
1197{
1199
1200 // Treat the case in which a TClass instance is created for a namespace
1201 if (theState == kNamespaceForMeta){
1203 theState = kForwardDeclared; // it immediately decays in kForwardDeclared
1204 }
1205
1206 if (theState != kForwardDeclared && theState != kEmulated)
1207 ::Fatal("TClass::TClass",
1208 "A TClass entry cannot be initialized in a state different from kForwardDeclared or kEmulated.");
1209 Init(name, cversion, nullptr, nullptr, nullptr, nullptr, -1, -1, nullptr, silent);
1210}
1211
1212////////////////////////////////////////////////////////////////////////////////
1213/// Internal constructor.
1214///
1215/// Create a TClass object. This object contains the full dictionary
1216/// of a class. It has list to baseclasses, datamembers and methods.
1217/// Use this ctor to create a standalone TClass object. Most useful
1218/// to get a TClass interface to an interpreted class. Used by TTabCom.
1219///
1220/// This copies the ClassInfo (i.e. does *not* take ownership of it).
1221///
1222/// \note Use `TClass::GetClass("class")` to get access to a TClass object for a certain class!
1223
1224TClass::TClass(ClassInfo_t *classInfo, Version_t cversion,
1225 const char *dfil, const char *ifil, Int_t dl, Int_t il, Bool_t silent) :
1226 TDictionary(""),
1227 fPersistentRef(nullptr),
1228 fStreamerInfo(nullptr), fConversionStreamerInfo(nullptr), fRealData(nullptr),
1229 fBase(nullptr), fData(nullptr), fUsingData(nullptr), fEnums(nullptr), fFuncTemplate(nullptr), fMethod(nullptr), fAllPubData(nullptr),
1230 fAllPubMethod(nullptr), fClassMenuList(nullptr),
1231 fDeclFileName(""), fImplFileName(""), fDeclFileLine(0), fImplFileLine(0),
1232 fInstanceCount(0), fOnHeap(0),
1233 fCheckSum(0), fCollectionProxy(nullptr), fClassVersion(0), fClassInfo(nullptr),
1234 fTypeInfo(nullptr), fShowMembers(nullptr),
1235 fStreamer(nullptr), fIsA(nullptr), fGlobalIsA(nullptr), fIsAMethod(nullptr),
1236 fMerge(nullptr), fResetAfterMerge(nullptr), fNew(nullptr), fNewArray(nullptr), fDelete(nullptr), fDeleteArray(nullptr),
1237 fDestructor(nullptr), fDirAutoAdd(nullptr), fStreamerFunc(nullptr), fConvStreamerFunc(nullptr), fSizeof(-1),
1238 fCanSplit(-1), fIsSyntheticPair(kFALSE), fProperty(0), fClassProperty(0), fHasRootPcmInfo(kFALSE), fCanLoadClassInfo(kFALSE),
1239 fIsOffsetStreamerSet(kFALSE), fVersionUsed(kFALSE), fRuntimeProperties(0), fOffsetStreamer(0), fStreamerType(TClass::kDefault),
1240 fState(kNoInfo),
1241 fCurrentInfo(nullptr), fLastReadInfo(nullptr), fRefProxy(nullptr),
1242 fSchemaRules(nullptr), fStreamerImpl(&TClass::StreamerDefault)
1243{
1245
1246 if (!gROOT)
1247 ::Fatal("TClass::TClass", "ROOT system not initialized");
1248
1249 fDeclFileLine = -2; // -2 for standalone TClass (checked in dtor)
1250
1252 if (!gInterpreter)
1253 ::Fatal("TClass::TClass", "gInterpreter not initialized");
1254
1255 if (!classInfo || !gInterpreter->ClassInfo_IsValid(classInfo)) {
1256 MakeZombie();
1257 fState = kNoInfo;
1258 } else {
1259 fName = gInterpreter->ClassInfo_FullName(classInfo);
1260
1262 Init(fName, cversion, nullptr, nullptr, dfil, ifil, dl, il, classInfo, silent);
1263 }
1265
1266 fConversionStreamerInfo = nullptr;
1267}
1268
1269
1270////////////////////////////////////////////////////////////////////////////////
1271/// Internal constructor.
1272///
1273/// \note Use `TClass::GetClass("class")` to get access to a TClass object for a certain class!
1274
1275TClass::TClass(const char *name, Version_t cversion,
1276 const char *dfil, const char *ifil, Int_t dl, Int_t il, Bool_t silent) :
1278 fPersistentRef(nullptr),
1279 fStreamerInfo(nullptr), fConversionStreamerInfo(nullptr), fRealData(nullptr),
1280 fBase(nullptr), fData(nullptr), fUsingData(nullptr), fEnums(nullptr), fFuncTemplate(nullptr), fMethod(nullptr), fAllPubData(nullptr),
1281 fAllPubMethod(nullptr), fClassMenuList(nullptr),
1282 fDeclFileName(""), fImplFileName(""), fDeclFileLine(0), fImplFileLine(0),
1283 fInstanceCount(0), fOnHeap(0),
1284 fCheckSum(0), fCollectionProxy(nullptr), fClassVersion(0), fClassInfo(nullptr),
1285 fTypeInfo(nullptr), fShowMembers(nullptr),
1286 fStreamer(nullptr), fIsA(nullptr), fGlobalIsA(nullptr), fIsAMethod(nullptr),
1287 fMerge(nullptr), fResetAfterMerge(nullptr), fNew(nullptr), fNewArray(nullptr), fDelete(nullptr), fDeleteArray(nullptr),
1288 fDestructor(nullptr), fDirAutoAdd(nullptr), fStreamerFunc(nullptr), fConvStreamerFunc(nullptr), fSizeof(-1),
1289 fCanSplit(-1), fIsSyntheticPair(kFALSE), fProperty(0), fClassProperty(0), fHasRootPcmInfo(kFALSE), fCanLoadClassInfo(kFALSE),
1290 fIsOffsetStreamerSet(kFALSE), fVersionUsed(kFALSE), fRuntimeProperties(0), fOffsetStreamer(0), fStreamerType(TClass::kDefault),
1291 fState(kNoInfo),
1292 fCurrentInfo(nullptr), fLastReadInfo(nullptr), fRefProxy(nullptr),
1293 fSchemaRules(nullptr), fStreamerImpl(&TClass::StreamerDefault)
1294{
1296 Init(name,cversion, nullptr, nullptr, dfil, ifil, dl, il, nullptr, silent);
1297}
1298
1299////////////////////////////////////////////////////////////////////////////////
1300/// Internal constructor.
1301///
1302/// \note Use `TClass::GetClass("class")` to get access to a TClass object for a certain class!
1303
1304TClass::TClass(const char *name, Version_t cversion,
1305 const std::type_info &info, TVirtualIsAProxy *isa,
1306 const char *dfil, const char *ifil, Int_t dl, Int_t il,
1307 Bool_t silent) :
1309 fPersistentRef(nullptr),
1310 fStreamerInfo(nullptr), fConversionStreamerInfo(nullptr), fRealData(nullptr),
1311 fBase(nullptr), fData(nullptr), fUsingData(nullptr), fEnums(nullptr), fFuncTemplate(nullptr), fMethod(nullptr), fAllPubData(nullptr),
1312 fAllPubMethod(nullptr),
1313 fClassMenuList(nullptr),
1314 fDeclFileName(""), fImplFileName(""), fDeclFileLine(0), fImplFileLine(0),
1315 fInstanceCount(0), fOnHeap(0),
1316 fCheckSum(0), fCollectionProxy(nullptr), fClassVersion(0), fClassInfo(nullptr),
1317 fTypeInfo(nullptr), fShowMembers(nullptr),
1318 fStreamer(nullptr), fIsA(nullptr), fGlobalIsA(nullptr), fIsAMethod(nullptr),
1319 fMerge(nullptr), fResetAfterMerge(nullptr), fNew(nullptr), fNewArray(nullptr), fDelete(nullptr), fDeleteArray(nullptr),
1320 fDestructor(nullptr), fDirAutoAdd(nullptr), fStreamerFunc(nullptr), fConvStreamerFunc(nullptr), fSizeof(-1),
1321 fCanSplit(-1), fIsSyntheticPair(kFALSE), fProperty(0), fClassProperty(0), fHasRootPcmInfo(kFALSE), fCanLoadClassInfo(kFALSE),
1322 fIsOffsetStreamerSet(kFALSE), fVersionUsed(kFALSE), fRuntimeProperties(0), fOffsetStreamer(0), fStreamerType(TClass::kDefault),
1323 fState(kHasTClassInit),
1324 fCurrentInfo(nullptr), fLastReadInfo(nullptr), fRefProxy(nullptr),
1325 fSchemaRules(nullptr), fStreamerImpl(&TClass::StreamerDefault)
1326{
1328 // use info
1329 Init(name, cversion, &info, isa, dfil, ifil, dl, il, nullptr, silent);
1330}
1331
1332////////////////////////////////////////////////////////////////////////////////
1333/// we found at least one equivalent.
1334/// let's force a reload
1335
1337{
1338 TClass::RemoveClass(oldcl);
1339
1340 if (oldcl->CanIgnoreTObjectStreamer()) {
1342 }
1343
1345 TIter next(oldcl->GetStreamerInfos());
1346 while ((info = (TVirtualStreamerInfo*)next())) {
1347 info->Clear("build");
1348 info->SetClass(this);
1349 if (IsSyntheticPair()) {
1350 // Some pair's StreamerInfo were inappropriately marked as versioned
1351 info->SetClassVersion(1);
1352 // There is already a TStreamerInfo put there by the synthetic
1353 // creation.
1354 fStreamerInfo->Add(info);
1355 } else {
1357 }
1358 }
1359 oldcl->fStreamerInfo->Clear();
1360
1361 oldcl->ReplaceWith(this);
1362 delete oldcl;
1363}
1364
1365////////////////////////////////////////////////////////////////////////////////
1366/// Initialize a TClass object. This object contains the full dictionary
1367/// of a class. It has list to baseclasses, datamembers and methods.
1368
1369void TClass::Init(const char *name, Version_t cversion,
1370 const std::type_info *typeinfo, TVirtualIsAProxy *isa,
1371 const char *dfil, const char *ifil, Int_t dl, Int_t il,
1372 ClassInfo_t *givenInfo,
1373 Bool_t silent)
1374{
1375 if (!gROOT)
1376 ::Fatal("TClass::TClass", "ROOT system not initialized");
1377 if (!name || !name[0]) {
1378 ::Error("TClass::Init", "The name parameter is invalid (null or empty)");
1379 MakeZombie();
1380 return;
1381 }
1382 // Always strip the default STL template arguments (from any template argument or the class name)
1384 fName = name; // We can assume that the artificial class name is already normalized.
1385 else
1387
1388 fClassVersion = cversion;
1389 fDeclFileName = dfil ? dfil : "";
1390 fImplFileName = ifil ? ifil : "";
1391 fDeclFileLine = dl;
1392 fImplFileLine = il;
1393 fTypeInfo = typeinfo;
1394 fIsA = isa;
1395 if ( fIsA ) fIsA->SetClass(this);
1396 // See also TCling::GenerateTClass() which will update fClassVersion after creation!
1397 fStreamerInfo = new TObjArray(fClassVersion+2+10,-1); // +10 to read new data by old
1398 fProperty = -1;
1399 fClassProperty = 0;
1400 const bool ispair = TClassEdit::IsStdPair(fName);
1401 if (ispair)
1403
1405
1406 TClass *oldcl = (TClass*)gROOT->GetListOfClasses()->FindObject(fName.Data());
1407
1409
1410 if (oldcl && oldcl->TestBit(kLoading)) {
1411 // Do not recreate a class while it is already being created!
1412
1413 // We can no longer reproduce this case, to check whether we are, we use
1414 // this code:
1415 // Fatal("Init","A bad replacement for %s was requested\n",name);
1416 return;
1417 }
1418
1419 TClass **persistentRef = nullptr;
1420 if (oldcl) {
1421
1422 persistentRef = oldcl->fPersistentRef.exchange(nullptr);
1423
1424 // The code from here is also in ForceReload.
1425 TClass::RemoveClass(oldcl);
1426 // move the StreamerInfo immediately so that there are
1427 // properly updated!
1428
1429 if (oldcl->CanIgnoreTObjectStreamer()) {
1431 }
1433
1434 TIter next(oldcl->GetStreamerInfos());
1435 while ((info = (TVirtualStreamerInfo*)next())) {
1436 // We need to force a call to BuildOld
1437 info->Clear("build");
1438 info->SetClass(this);
1440 }
1441 oldcl->fStreamerInfo->Clear();
1442 // The code diverges here from ForceReload.
1443
1444 // Move the Schema Rules too.
1445 fSchemaRules = oldcl->fSchemaRules;
1446 oldcl->fSchemaRules = nullptr;
1447
1448 // Move the TFunctions.
1450 if (fFuncTemplate)
1451 fFuncTemplate->fClass = this;
1452 oldcl->fFuncTemplate = nullptr;
1453 fMethod.store( oldcl->fMethod );
1454 if (fMethod)
1455 (*fMethod).fClass = this;
1456 oldcl->fMethod = nullptr;
1457
1458 }
1459
1461 // Advertise ourself as the loading class for this class name
1462 TClass::AddClass(this);
1463
1465
1466 if (!gInterpreter)
1467 ::Fatal("TClass::Init", "gInterpreter not initialized");
1468
1469 if (givenInfo) {
1470 bool invalid = !gInterpreter->ClassInfo_IsValid(givenInfo);
1471 bool notloaded = !gInterpreter->ClassInfo_IsLoaded(givenInfo);
1472 auto property = gInterpreter->ClassInfo_Property(givenInfo);
1473
1474 if (invalid || (notloaded && (property & kIsNamespace)) ||
1477 MakeZombie();
1478 fState = kNoInfo;
1479 TClass::RemoveClass(this);
1480 return;
1481 }
1482 }
1483
1484 if (!invalid) {
1485 fClassInfo = gInterpreter->ClassInfo_Factory(givenInfo);
1486 fCanLoadClassInfo = false; // avoids calls to LoadClassInfo() if info is already loaded
1487 if (fState <= kEmulated)
1489 }
1490 }
1491
1492 // We need to check if the class it is not fwd declared for the cases where we
1493 // created a TClass directly in the kForwardDeclared state. Indeed in those cases
1494 // fClassInfo will always be nullptr.
1496
1497 if (fState == kHasTClassInit) {
1498 // If the TClass is being generated from a ROOT dictionary,
1499 // even though we do not seem to have a CINT dictionary for
1500 // the class, we will will try to load it anyway UNLESS
1501 // the class is an STL container (or string).
1502 // This is because we do not expect the CINT dictionary
1503 // to be present for all STL classes (and we can handle
1504 // the lack of CINT dictionary in that cases).
1505 // However, the cling the dictionary no longer carries
1506 // an instantiation with it, unless we request the loading
1507 // here *or* the user explicitly instantiate the template
1508 // we would not have a ClassInfo for the template
1509 // instantiation.
1511 // Here we check and grab the info from the rootpcm.
1513 if (proto)
1514 proto->FillTClass(this);
1515 }
1516 if (!fHasRootPcmInfo && gInterpreter->CheckClassInfo(fName, /* autoload = */ kTRUE)) {
1517 gInterpreter->SetClassInfo(this); // sets fClassInfo pointer
1518 if (fClassInfo) {
1519 // This should be moved out of GetCheckSum itself however the last time
1520 // we tried this cause problem, in particular in the end-of-process operation.
1521 // fCheckSum = GetCheckSum(kLatestCheckSum);
1522 } else {
1523 if (!fClassInfo) {
1524 if (IsZombie()) {
1525 TClass::RemoveClass(this);
1526 return;
1527 }
1528 }
1529 }
1530 }
1531 }
1532 if (!silent && (!fClassInfo && !fCanLoadClassInfo) && !isStl && !TClassEdit::IsArtificial(fName) &&
1534 if (fState == kHasTClassInit) {
1535 if (fImplFileLine == -1 && fClassVersion == 0) {
1536 // We have a 'transient' class with a ClassDefInline and apparently no interpreter
1537 // information. Since it is transient, it is more than likely that the lack
1538 // will be harmles.
1539 } else {
1540 ::Error("TClass::Init", "no interpreter information for class %s is available even though it has a TClass "
1541 "initialization routine.",
1542 fName.Data());
1543 }
1544 } else {
1545 const bool ispairbase = TClassEdit::IsStdPairBase(fName.Data()) && !IsFromRootCling();
1546 if (!ispairbase)
1547 ::Warning("TClass::Init", "no dictionary for class %s is available", fName.Data());
1548 }
1549 }
1550
1551 fgClassCount++;
1553
1554 // Make the typedef-expanded -> original hash table entries.
1555 // There may be several entries for any given key.
1556 // We only make entries if the typedef-expanded name
1557 // is different from the original name.
1558 TString resolvedThis;
1559 if (!givenInfo && strchr (name, '<')) {
1560 if ( fName != name) {
1561 if (!fgClassTypedefHash) {
1562 fgClassTypedefHash = new THashTable (100, 5);
1564 }
1565
1566 fgClassTypedefHash->Add (new TNameMapNode (name, fName));
1568
1569 }
1570 resolvedThis = TClassEdit::ResolveTypedef (name, kTRUE);
1571 if (resolvedThis != name) {
1572 if (!fgClassTypedefHash) {
1573 fgClassTypedefHash = new THashTable (100, 5);
1575 }
1576
1577 fgClassTypedefHash->Add (new TNameMapNode (resolvedThis, fName));
1579 }
1580
1581 }
1582
1583 //In case a class with the same name had been created by TVirtualStreamerInfo
1584 //we must delete the old class, importing only the StreamerInfo structure
1585 //from the old dummy class.
1586 if (oldcl) {
1587
1588 oldcl->ReplaceWith(this);
1589 delete oldcl;
1590
1591 } else if (!givenInfo && resolvedThis.Length() > 0 && fgClassTypedefHash) {
1592
1593 // Check for existing equivalent.
1594
1595 if (resolvedThis != fName) {
1596 oldcl = (TClass*)gROOT->GetListOfClasses()->FindObject(resolvedThis);
1597 if (oldcl && oldcl != this) {
1598 persistentRef = oldcl->fPersistentRef.exchange(nullptr);
1599 ForceReload (oldcl);
1600 }
1601 }
1602 TIter next( fgClassTypedefHash->GetListForObject(resolvedThis) );
1603 while ( TNameMapNode* htmp = static_cast<TNameMapNode*> (next()) ) {
1604 if (resolvedThis != htmp->String()) continue;
1605 oldcl = (TClass*)gROOT->GetListOfClasses()->FindObject(htmp->fOrigName); // gROOT->GetClass (htmp->fOrigName, kFALSE);
1606 if (oldcl && oldcl != this) {
1607 persistentRef = oldcl->fPersistentRef.exchange(nullptr);
1608 ForceReload (oldcl);
1609 }
1610 }
1611 }
1612 if (fClassInfo) {
1614 if ( fDeclFileName == nullptr || fDeclFileName[0] == '\0' ) {
1615 fDeclFileName = kUndeterminedClassInfoName;
1616 // Missing interface:
1617 // fDeclFileLine = gInterpreter->ClassInfo_FileLine( fClassInfo );
1618
1619 // But really do not want to set ImplFileLine as it is currently the
1620 // marker of being 'loaded' or not (reminder loaded == has a TClass bootstrap).
1621 }
1622 }
1623
1624 if (persistentRef) {
1625 fPersistentRef = persistentRef;
1626 } else {
1627 fPersistentRef = new TClass*;
1628 }
1629 *fPersistentRef = this;
1630
1631 if ( isStl || !strncmp(GetName(),"stdext::hash_",13) || !strncmp(GetName(),"__gnu_cxx::hash_",16) ) {
1632 if (fState != kHasTClassInit) {
1633 // If we have a TClass compiled initialization, we can safely assume that
1634 // there will also be a collection proxy.
1636 if (fCollectionProxy) {
1638
1639 // Numeric Collections have implicit conversions:
1641
1642 } else if (!silent) {
1643 Warning("Init","Collection proxy for %s was not properly initialized!",GetName());
1644 }
1645 if (fStreamer==nullptr) {
1647 }
1648 }
1649 } else if (TClassEdit::IsStdPair(GetName())) {
1650 // std::pairs have implicit conversions
1652 }
1653
1655}
1656
1657////////////////////////////////////////////////////////////////////////////////
1658/// TClass dtor. Deletes all list that might have been created.
1659
1661{
1663
1664 // Remove from the typedef hashtables.
1666 TString resolvedThis = TClassEdit::ResolveTypedef (GetName(), kTRUE);
1667 TIter next (fgClassTypedefHash->GetListForObject (resolvedThis));
1668 while ( TNameMapNode* htmp = static_cast<TNameMapNode*> (next()) ) {
1669 if (resolvedThis == htmp->String() && htmp->fOrigName == GetName()) {
1670 fgClassTypedefHash->Remove (htmp);
1671 delete htmp;
1672 break;
1673 }
1674 }
1675 }
1676
1677 // Not owning lists, don't call Delete()
1678 // But this still need to be done first because the TList destructor
1679 // does access the object contained (via GetObject()->TestBit(kCanDelete))
1680 delete fStreamer; fStreamer =nullptr;
1681 delete fAllPubData; fAllPubData =nullptr;
1682 delete fAllPubMethod; fAllPubMethod=nullptr;
1683
1684 delete fPersistentRef.load();
1685
1686 if (fBase.load())
1687 (*fBase).Delete();
1688 delete fBase.load(); fBase = nullptr;
1689
1690 if (fData.load())
1691 (*fData).Delete();
1692 delete fData.load(); fData = nullptr;
1693
1694 if (fUsingData.load())
1695 (*fUsingData).Delete();
1696 delete fUsingData.load(); fUsingData = nullptr;
1697
1698 if (fEnums.load())
1699 (*fEnums).Delete();
1700 delete fEnums.load(); fEnums = nullptr;
1701
1702 if (fFuncTemplate)
1704 delete fFuncTemplate; fFuncTemplate = nullptr;
1705
1706 if (fMethod.load())
1707 (*fMethod).Delete();
1708 delete fMethod.load(); fMethod=nullptr;
1709
1710 if (fRealData)
1711 fRealData->Delete();
1712 delete fRealData; fRealData=nullptr;
1713
1714 if (fStreamerInfo)
1716 delete fStreamerInfo; fStreamerInfo = nullptr;
1717
1718 if (fDeclFileLine >= -1)
1719 TClass::RemoveClass(this);
1720
1722 fClassInfo=nullptr;
1723
1724 if (fClassMenuList)
1726 delete fClassMenuList; fClassMenuList=nullptr;
1727
1729
1730 if ( fIsA ) delete fIsA;
1731
1732 if ( fRefProxy ) fRefProxy->Release();
1733 fRefProxy = nullptr;
1734
1735 delete fStreamer;
1736 delete fCollectionProxy;
1737 delete fIsAMethod.load();
1738 delete fSchemaRules;
1739 if (fConversionStreamerInfo.load()) {
1740 std::map<std::string, TObjArray*>::iterator it;
1741 std::map<std::string, TObjArray*>::iterator end = (*fConversionStreamerInfo).end();
1742 for( it = (*fConversionStreamerInfo).begin(); it != end; ++it ) {
1743 delete it->second;
1744 }
1745 delete fConversionStreamerInfo.load();
1746 }
1747}
1748
1749////////////////////////////////////////////////////////////////////////////////
1750
1751namespace {
1752 Int_t ReadRulesContent(FILE *f)
1753 {
1754 // Read a class.rules file which contains one rule per line with comment
1755 // starting with a #
1756 // Returns the number of rules loaded.
1757 // Returns -1 in case of error.
1758
1759 R__ASSERT(f!=nullptr);
1760 TString rule(1024);
1761 int c, state = 0;
1762 Int_t count = 0;
1763
1764 while ((c = fgetc(f)) != EOF) {
1765 if (c == 13) // ignore CR
1766 continue;
1767 if (c == '\n') {
1768 if (state != 3) {
1769 state = 0;
1770 if (rule.Length() > 0) {
1771 if (TClass::AddRule(rule)) {
1772 ++count;
1773 }
1774 rule.Clear();
1775 }
1776 }
1777 continue;
1778 }
1779 switch (state) {
1780 case 0: // start of line
1781 switch (c) {
1782 case ' ':
1783 case '\t':
1784 break;
1785 case '#':
1786 state = 1;
1787 break;
1788 default:
1789 state = 2;
1790 break;
1791 }
1792 break;
1793
1794 case 1: // comment
1795 break;
1796
1797 case 2: // rule
1798 switch (c) {
1799 case '\\':
1800 state = 3; // Continuation request
1801 default:
1802 break;
1803 }
1804 break;
1805 }
1806 switch (state) {
1807 case 2:
1808 rule.Append(c);
1809 break;
1810 }
1811 }
1812 return count;
1813 }
1814}
1815
1816////////////////////////////////////////////////////////////////////////////////
1817/// Read the class.rules files from the default location:.
1818/// $ROOTSYS/etc/class.rules (or ROOTETCDIR/class.rules)
1819
1821{
1822 static const char *suffix = "class.rules";
1823 TString sname = suffix;
1825
1826 Int_t res = -1;
1827
1828 FILE * f = fopen(sname,"r");
1829 if (f != nullptr) {
1830 res = ReadRulesContent(f);
1831 fclose(f);
1832 } else {
1833 ::Error("TClass::ReadRules()", "Cannot find rules file %s", sname.Data());
1834 }
1835 return res;
1836}
1837
1838////////////////////////////////////////////////////////////////////////////////
1839/// Read a class.rules file which contains one rule per line with comment
1840/// starting with a #
1841/// - Returns the number of rules loaded.
1842/// - Returns -1 in case of error.
1843
1845{
1846 if (!filename || !filename[0]) {
1847 ::Error("TClass::ReadRules", "no file name specified");
1848 return -1;
1849 }
1850
1851 FILE * f = fopen(filename,"r");
1852 if (f == nullptr) {
1853 ::Error("TClass::ReadRules","Failed to open %s\n",filename);
1854 return -1;
1855 }
1856 Int_t count = ReadRulesContent(f);
1857
1858 fclose(f);
1859 return count;
1860
1861}
1862
1863////////////////////////////////////////////////////////////////////////////////
1864/// Add a schema evolution customization rule.
1865/// The syntax of the rule can be either the short form:
1866/// ~~~ {.cpp}
1867/// [type=Read] classname membername [attributes=... ] [version=[...] ] [checksum=[...] ] [oldtype=...] [code={...}]
1868/// ~~~
1869/// or the long form
1870/// ~~~ {.cpp}
1871/// [type=Read] sourceClass=classname [targetclass=newClassname] [ source="type membername; [type2 membername2]" ]
1872/// [target="membername3;membername4"] [attributes=... ] [version=...] [checksum=...] [code={...}|functionname]
1873/// ~~~
1874///
1875/// For example to set HepMC::GenVertex::m_event to _not_ owned the object it is pointing to:
1876/// HepMC::GenVertex m_event attributes=NotOwner
1877///
1878/// Semantic of the tags:
1879/// - type : the type of the rule, valid values: Read, ReadRaw, Write, WriteRaw, the default is 'Read'.
1880/// - sourceClass : the name of the class as it is on the rule file
1881/// - targetClass : the name of the class as it is in the current code ; defaults to the value of sourceClass
1882/// - source : the types and names of the data members from the class on file that are needed, the list is separated by semi-colons ';'
1883/// - oldtype: in the short form only, indicates the type on disk of the data member.
1884/// - target : the names of the data members updated by this rule, the list is separated by semi-colons ';'
1885/// - attributes : list of possible qualifiers among: Owner, NotOwner
1886/// - version : list of the version of the class layout that this rule applies to. The syntax can be [1,4,5] or [2-] or [1-3] or [-3]
1887/// - checksum : comma delimited list of the checksums of the class layout that this rule applies to.
1888/// - code={...} : code to be executed for the rule or name of the function implementing it.
1889
1890Bool_t TClass::AddRule( const char *rule )
1891{
1892 ROOT::TSchemaRule *ruleobj = new ROOT::TSchemaRule();
1893 if (! ruleobj->SetFromRule( rule ) ) {
1894 delete ruleobj;
1895 return kFALSE;
1896 }
1897
1899
1900 TClass *cl = TClass::GetClass( ruleobj->GetTargetClass() );
1901 if (!cl) {
1902 // Create an empty emulated class for now.
1903 cl = gInterpreter->GenerateTClass(ruleobj->GetTargetClass(), /* emulation = */ kTRUE, /*silent = */ kTRUE);
1904 }
1906
1907 TString errmsg;
1908 if( !rset->AddRule( ruleobj, ROOT::Detail::TSchemaRuleSet::kCheckConflict, &errmsg ) ) {
1909 ::Warning( "TClass::AddRule", "The rule for class: \"%s\": version, \"%s\" and data members: \"%s\" has been skipped because it conflicts with one of the other rules (%s).",
1910 ruleobj->GetTargetClass(), ruleobj->GetVersion(), ruleobj->GetTargetString(), errmsg.Data() );
1911 delete ruleobj;
1912 return kFALSE;
1913 }
1914 return kTRUE;
1915}
1916
1917////////////////////////////////////////////////////////////////////////////////
1918/// Adopt a new set of Data Model Evolution rules.
1919
1921{
1923
1924 delete fSchemaRules;
1925 fSchemaRules = rules;
1926 fSchemaRules->SetClass( this );
1927}
1928
1929////////////////////////////////////////////////////////////////////////////////
1930/// Return the set of the schema rules if any.
1931
1933{
1934 return fSchemaRules;
1935}
1936
1937////////////////////////////////////////////////////////////////////////////////
1938/// Return the set of the schema rules if any.
1939/// If create is true, create an empty set
1940
1942{
1943 if (create && fSchemaRules == nullptr) {
1945 fSchemaRules->SetClass( this );
1946 }
1947 return fSchemaRules;
1948}
1949
1950////////////////////////////////////////////////////////////////////////////////
1951
1952void TClass::AddImplFile(const char* filename, int line) {
1953 // Currently reset the implementation file and line.
1954 // In the close future, it will actually add this file and line
1955 // to a "list" of implementation files.
1956
1959}
1960
1961////////////////////////////////////////////////////////////////////////////////
1962/// Browse external object inherited from TObject.
1963/// It passes through inheritance tree and calls TBrowser::Add
1964/// in appropriate cases. Static function.
1965
1967{
1968 if (!obj) return 0;
1969
1970 TAutoInspector insp(b);
1971 obj->ShowMembers(insp);
1972 return insp.fCount;
1973}
1974
1975////////////////////////////////////////////////////////////////////////////////
1976/// Browse objects of of the class described by this TClass object.
1977
1978Int_t TClass::Browse(void *obj, TBrowser *b) const
1979{
1980 if (!obj) return 0;
1981
1982 TClass *actual = GetActualClass(obj);
1983 if (IsTObject()) {
1984 // Call TObject::Browse.
1985
1986 if (!fIsOffsetStreamerSet) {
1988 }
1989 TObject* realTObject = (TObject*)((size_t)obj + fOffsetStreamer);
1990 realTObject->Browse(b);
1991 return 1;
1992 } else if (actual != this) {
1993 return actual->Browse(obj, b);
1994 } else if (GetCollectionProxy()) {
1995
1996 // do something useful.
1997
1998 } else {
1999 TAutoInspector insp(b);
2000 CallShowMembers(obj,insp,kFALSE);
2001 return insp.fCount;
2002 }
2003
2004 return 0;
2005}
2006
2007////////////////////////////////////////////////////////////////////////////////
2008/// This method is called by a browser to get the class information.
2009
2011{
2012 if (!HasInterpreterInfo()) return;
2013
2014 if (b) {
2015 if (!fRealData) BuildRealData();
2016
2017 b->Add(GetListOfDataMembers(), "Data Members");
2018 b->Add(GetListOfRealData(), "Real Data Members");
2019 b->Add(GetListOfMethods(), "Methods");
2020 b->Add(GetListOfBases(), "Base Classes");
2021 }
2022}
2023
2024////////////////////////////////////////////////////////////////////////////////
2025/// Build a full list of persistent data members.
2026/// Scans the list of all data members in the class itself and also
2027/// in all base classes. For each persistent data member, inserts a
2028/// TRealData object in the list fRealData.
2029///
2030
2031void TClass::BuildRealData(void* pointer, Bool_t isTransient)
2032{
2033
2035
2036 // Only do this once.
2037 if (fRealData) {
2038 return;
2039 }
2040
2041 if (fClassVersion == 0) {
2042 isTransient = kTRUE;
2043 }
2044
2045 // When called via TMapFile (e.g. Update()) make sure that the dictionary
2046 // gets allocated on the heap and not in the mapped file.
2047 TMmallocDescTemp setreset;
2048
2049 // Handle emulated classes and STL containers specially.
2051 // We are an emulated class or an STL container.
2052 fRealData = new TList;
2053 BuildEmulatedRealData("", 0, this, isTransient);
2054 return;
2055 }
2056
2057 // return early on string
2058 static TClassRef clRefString("std::string");
2059 if (clRefString == this) {
2060 return;
2061 }
2062
2063 // Complain about stl classes ending up here (unique_ptr etc) - except for
2064 // pair where we will build .first, .second just fine
2065 // and those for which the user explicitly requested a dictionary.
2066 if (!isTransient && GetState() != kHasTClassInit
2069 Error("BuildRealData", "Inspection for %s not supported!", GetName());
2070 }
2071
2072 // The following statement will recursively call
2073 // all the subclasses of this class.
2074 fRealData = new TList;
2075 TBuildRealData brd(pointer, this);
2076
2077 // CallShowMember will force a call to InheritsFrom, which indirectly
2078 // calls TClass::GetClass. It forces the loading of new typedefs in
2079 // case some of them were not yet loaded.
2080 if ( ! CallShowMembers(pointer, brd, isTransient) ) {
2081 if ( isTransient ) {
2082 // This is a transient data member, so it is probably fine to not have
2083 // access to its content. However let's no mark it as definitively setup,
2084 // since another class might use this class for a persistent data member and
2085 // in this case we really want the error message.
2086 delete fRealData;
2087 fRealData = nullptr;
2088 } else {
2089 Error("BuildRealData", "Cannot find any ShowMembers function for %s!", GetName());
2090 }
2091 }
2092
2093 // Take this opportunity to build the real data for base classes.
2094 // In case one base class is abstract, it would not be possible later
2095 // to create the list of real data for this abstract class.
2096 TBaseClass* base = nullptr;
2097 TIter next(GetListOfBases());
2098 while ((base = (TBaseClass*) next())) {
2099 if (base->IsSTLContainer()) {
2100 continue;
2101 }
2102 TClass* c = base->GetClassPointer();
2103 if (c) {
2104 c->BuildRealData(nullptr, isTransient);
2105 }
2106 }
2107}
2108
2109////////////////////////////////////////////////////////////////////////////////
2110/// Build the list of real data for an emulated class
2111
2113{
2115
2117 if (Property() & kIsAbstract) {
2119 } else {
2120 info = GetStreamerInfoImpl(fClassVersion, isTransient);
2121 }
2122 if (!info) {
2123 // This class is abstract, but we don't yet have a SteamerInfo for it ...
2124 Error("BuildEmulatedRealData","Missing StreamerInfo for %s",GetName());
2125 // Humm .. no information ... let's bail out
2126 return;
2127 }
2128
2129 TIter next(info->GetElements());
2130 TStreamerElement *element;
2131 while ((element = (TStreamerElement*)next())) {
2132 Int_t etype = element->GetType();
2133 Longptr_t eoffset = element->GetOffset();
2134 TClass *cle = element->GetClassPointer();
2135 if (element->IsBase() || etype == TVirtualStreamerInfo::kBase) {
2136 //base class are skipped in this loop, they will be added at the end.
2137 continue;
2138 } else if (etype == TVirtualStreamerInfo::kTObject ||
2141 etype == TVirtualStreamerInfo::kAny) {
2142 //member class
2143 TString rdname; rdname.Form("%s%s",name,element->GetFullName());
2144 TRealData *rd = new TRealData(rdname,offset+eoffset,nullptr);
2145 if (gDebug > 0) printf(" Class: %s, adding TRealData=%s, offset=%ld\n",cl->GetName(),rd->GetName(),rd->GetThisOffset());
2146 cl->GetListOfRealData()->Add(rd);
2147 // Now we a dot
2148 rdname.Form("%s%s.",name,element->GetFullName());
2149 if (cle) cle->BuildEmulatedRealData(rdname,offset+eoffset,cl, isTransient);
2150 } else {
2151 //others
2152 TString rdname; rdname.Form("%s%s",name,element->GetFullName());
2153 TRealData *rd = new TRealData(rdname,offset+eoffset,nullptr);
2154 if (gDebug > 0) printf(" Class: %s, adding TRealData=%s, offset=%ld\n",cl->GetName(),rd->GetName(),rd->GetThisOffset());
2155 cl->GetListOfRealData()->Add(rd);
2156 }
2157 //if (fClassInfo==0 && element->IsBase()) {
2158 // if (fBase==0) fBase = new TList;
2159 // TClass *base = element->GetClassPointer();
2160 // fBase->Add(new TBaseClass(this, cl, eoffset));
2161 //}
2162 }
2163 // The base classes must added last on the list of real data (to help with ambiguous data member names)
2164 next.Reset();
2165 while ((element = (TStreamerElement*)next())) {
2166 Int_t etype = element->GetType();
2167 if (element->IsBase() || etype == TVirtualStreamerInfo::kBase) {
2168 //base class
2169 Longptr_t eoffset = element->GetOffset();
2170 TClass *cle = element->GetClassPointer();
2171 if (cle) cle->BuildEmulatedRealData(name,offset+eoffset,cl, isTransient);
2172 }
2173 }
2174}
2175
2176
2177////////////////////////////////////////////////////////////////////////////////
2178/// Calculate the offset between an object of this class to
2179/// its base class TObject. The pointer can be adjusted by
2180/// that offset to access any virtual method of TObject like
2181/// Streamer() and ShowMembers().
2182
2184{
2187 // When called via TMapFile (e.g. Update()) make sure that the dictionary
2188 // gets allocated on the heap and not in the mapped file.
2189
2190 TMmallocDescTemp setreset;
2192 if (fStreamerType == kTObject) {
2194 }
2196 }
2197}
2198
2199
2200////////////////////////////////////////////////////////////////////////////////
2201/// Call ShowMembers() on the obj of this class type, passing insp and parent.
2202/// isATObject is -1 if unknown, 0 if it is not a TObject, and 1 if it is a TObject.
2203/// The function returns whether it was able to call ShowMembers().
2204
2205Bool_t TClass::CallShowMembers(const void* obj, TMemberInspector &insp, Bool_t isTransient) const
2206{
2207 if (fShowMembers) {
2208 // This should always works since 'pointer' should be pointing
2209 // to an object of the actual type of this TClass object.
2210 fShowMembers(obj, insp, isTransient);
2211 return kTRUE;
2212 } else {
2213
2215 if (fClassInfo) {
2216
2217 if (strcmp(GetName(), "string") == 0) {
2218 // For std::string we know that we do not have a ShowMembers
2219 // function and that it's okay.
2220 return kTRUE;
2221 }
2222 // Since we do have some dictionary information, let's
2223 // call the interpreter's ShowMember.
2224 // This works with Cling to support interpreted classes.
2225 gInterpreter->InspectMembers(insp, obj, this, isTransient);
2226 return kTRUE;
2227
2228 } else if (TVirtualStreamerInfo* sinfo = GetStreamerInfo()) {
2229 sinfo->CallShowMembers(obj, insp, isTransient);
2230 return kTRUE;
2231 } // isATObject
2232 } // fShowMembers is set
2233
2234 return kFALSE;
2235}
2236
2237////////////////////////////////////////////////////////////////////////////////
2238/// Do a ShowMembers() traversal of all members and base classes' members
2239/// using the reflection information from the interpreter. Works also for
2240/// interpreted objects.
2241
2242void TClass::InterpretedShowMembers(void* obj, TMemberInspector &insp, Bool_t isTransient)
2243{
2244 return gInterpreter->InspectMembers(insp, obj, this, isTransient);
2245}
2246
2248{
2249 if (fCanSplit >= 0) {
2250 return ! ( fCanSplit & 0x2 );
2251 }
2252
2254
2255 if (GetCollectionProxy() != nullptr) {
2256 // A collection can never affect its derived class 'splittability'
2257 return kTRUE;
2258 }
2259
2260 if (this == TRef::Class()) { fCanSplit = 2; return kFALSE; }
2261 if (this == TRefArray::Class()) { fCanSplit = 2; return kFALSE; }
2262 if (this == TArray::Class()) { fCanSplit = 2; return kFALSE; }
2263 if (this == TClonesArray::Class()) { fCanSplit = 1; return kTRUE; }
2264 if (this == TCollection::Class()) { fCanSplit = 2; return kFALSE; }
2265
2266 // TTree is not always available (for example in rootcling), so we need
2267 // to grab it silently.
2268 auto refTreeClass( TClass::GetClass("TTree",kTRUE,kTRUE) );
2269 if (this == refTreeClass) { fCanSplit = 2; return kFALSE; }
2270
2271 if (!HasDataMemberInfo()) {
2272 TVirtualStreamerInfo *sinfo = ((TClass *)this)->GetCurrentStreamerInfo();
2273 if (sinfo==nullptr) sinfo = GetStreamerInfo();
2274 TIter next(sinfo->GetElements());
2275 TStreamerElement *element;
2276 while ((element = (TStreamerElement*)next())) {
2277 if (element->IsA() == TStreamerBase::Class()) {
2278 TClass *clbase = element->GetClassPointer();
2279 if (!clbase) {
2280 // If there is a missing base class, we can't split the immediate
2281 // derived class.
2282 fCanSplit = 0;
2283 return kFALSE;
2284 } else if (!clbase->CanSplitBaseAllow()) {
2285 fCanSplit = 2;
2286 return kFALSE;
2287 }
2288 }
2289 }
2290 }
2291
2292 // If we don't have data member info there is no more information
2293 // we can find out.
2294 if (!HasDataMemberInfo()) return kTRUE;
2295
2296 TObjLink *lnk = GetListOfBases() ? fBase.load()->FirstLink() : nullptr;
2297
2298 // Look at inheritance tree
2299 while (lnk) {
2300 TBaseClass *base = (TBaseClass*) lnk->GetObject();
2301 TClass *c = base->GetClassPointer();
2302 if(!c) {
2303 // If there is a missing base class, we can't split the immediate
2304 // derived class.
2305 fCanSplit = 0;
2306 return kFALSE;
2307 } else if (!c->CanSplitBaseAllow()) {
2308 fCanSplit = 2;
2309 return kFALSE;
2310 }
2311 lnk = lnk->Next();
2312 }
2313 return kTRUE;
2314}
2315
2316////////////////////////////////////////////////////////////////////////////////
2317/// Return true if the data member of this TClass can be saved separately.
2318
2320{
2321 // Note: add the possibility to set it for the class and the derived class.
2322 // save the info in TVirtualStreamerInfo
2323 // deal with the info in MakeProject
2324 if (fCanSplit >= 0) {
2325 // The user explicitly set the value
2326 return (fCanSplit & 0x1) == 1;
2327 }
2328
2330 TClass *This = const_cast<TClass*>(this);
2331
2332 if (this == TObject::Class()) { This->fCanSplit = 1; return kTRUE; }
2333 if (fName == "TClonesArray") { This->fCanSplit = 1; return kTRUE; }
2334 if (fRefProxy) { This->fCanSplit = 0; return kFALSE; }
2335 if (fName.BeginsWith("TVectorT<")) { This->fCanSplit = 0; return kFALSE; }
2336 if (fName.BeginsWith("TMatrixT<")) { This->fCanSplit = 0; return kFALSE; }
2337 if (fName == "string") { This->fCanSplit = 0; return kFALSE; }
2338 if (fName == "std::string") { This->fCanSplit = 0; return kFALSE; }
2339
2340 if (GetCollectionProxy()!=nullptr) {
2341 // For STL collection we need to look inside.
2342
2343 // However we do not split collections of collections
2344 // nor collections of strings
2345 // nor collections of pointers (unless explicit request (see TBranchSTL)).
2346
2347 if (GetCollectionProxy()->HasPointers()) { This->fCanSplit = 0; return kFALSE; }
2348
2349 TClass *valueClass = GetCollectionProxy()->GetValueClass();
2350 if (valueClass == nullptr) { This->fCanSplit = 0; return kFALSE; }
2351 static TClassRef stdStringClass("std::string");
2352 if (valueClass==TString::Class() || valueClass==stdStringClass)
2353 { This->fCanSplit = 0; return kFALSE; }
2354 if (!valueClass->CanSplit()) { This->fCanSplit = 0; return kFALSE; }
2355 if (valueClass->GetCollectionProxy() != nullptr) { This->fCanSplit = 0; return kFALSE; }
2356
2357 This->fCanSplit = 1;
2358 return kTRUE;
2359
2360 }
2361
2362 if (GetStreamer() != nullptr || fStreamerFunc != nullptr) {
2363
2364 // We have an external custom streamer provided by the user, we must not
2365 // split it.
2366 This->fCanSplit = 0;
2367 return kFALSE;
2368
2370
2371 // We have a custom member function streamer or
2372 // an older (not StreamerInfo based) automatic streamer.
2373 This->fCanSplit = 0;
2374 return kFALSE;
2375 }
2376
2377 if (Size()==1) {
2378 // 'Empty' class there is nothing to split!.
2379 This->fCanSplit = 0;
2380 return kFALSE;
2381 }
2382
2383
2384 if ( !This->CanSplitBaseAllow() ) {
2385 return kFALSE;
2386 }
2387
2388 This->fCanSplit = 1;
2389 return kTRUE;
2390}
2391
2392////////////////////////////////////////////////////////////////////////////////
2393/// Return the C++ property of this class, eg. is abstract, has virtual base
2394/// class, see EClassProperty in TDictionary.h
2395
2397{
2398 if (fProperty == -1) Property();
2399 return fClassProperty;
2400}
2401
2402////////////////////////////////////////////////////////////////////////////////
2403/// Create a Clone of this TClass object using a different name but using the same 'dictionary'.
2404/// This effectively creates a hard alias for the class name.
2405
2406TObject *TClass::Clone(const char *new_name) const
2407{
2408 if (new_name == nullptr || new_name[0]=='\0' || fName == new_name) {
2409 Error("Clone","The name of the class must be changed when cloning a TClass object.");
2410 return nullptr;
2411 }
2412
2413 // Need to lock access to TROOT::GetListOfClasses so the cloning happens atomically
2415 // Temporarily remove the original from the list of classes.
2416 TClass::RemoveClass(const_cast<TClass*>(this));
2417
2418 TClass *copy;
2419 if (fTypeInfo) {
2420 copy = new TClass(GetName(),
2422 *fTypeInfo,
2423 new TIsAProxy(*fTypeInfo),
2427 GetImplFileLine());
2428 } else {
2429 copy = new TClass(GetName(),
2434 GetImplFileLine());
2435 }
2436 copy->fShowMembers = fShowMembers;
2437 // Remove the copy before renaming it
2438 TClass::RemoveClass(copy);
2439 copy->fName = new_name;
2440 TClass::AddClass(copy);
2441
2442 copy->SetNew(fNew);
2443 copy->SetNewArray(fNewArray);
2444 copy->SetDelete(fDelete);
2450 if (fStreamer) {
2452 }
2453 // If IsZombie is true, something went wrong and we will not be
2454 // able to properly copy the collection proxy
2455 if (fCollectionProxy && !copy->IsZombie()) {
2457 }
2458 copy->SetClassSize(fSizeof);
2459 if (fRefProxy) {
2461 }
2462 TClass::AddClass(const_cast<TClass*>(this));
2463 return copy;
2464}
2465
2466////////////////////////////////////////////////////////////////////////////////
2467/// Replaces the collection proxy for this class. The provided object is cloned
2468/// and the copy is then owned by `TClass`.
2469
2471{
2472// // This code was used too quickly test the STL Emulation layer
2473// Int_t k = TClassEdit::IsSTLCont(GetName());
2474// if (k==1||k==-1) return;
2475
2476 delete fCollectionProxy;
2477 fCollectionProxy = orig.Generate();
2478}
2479
2480////////////////////////////////////////////////////////////////////////////////
2481/// Draw detailed class inheritance structure.
2482/// If a class B inherits from a class A, the description of B is drawn
2483/// on the right side of the description of A.
2484/// Member functions overridden by B are shown in class A with a blue line
2485/// erasing the corresponding member function
2486
2488{
2489 if (!HasInterpreterInfo()) return;
2490
2492
2493 // Should we create a new canvas?
2494 TString opt = option;
2495 if (!ctxt.GetSaved() || !opt.Contains("same")) {
2496 TVirtualPad *padclass = (TVirtualPad*)(gROOT->GetListOfCanvases())->FindObject("R__class");
2497 if (!padclass) {
2498 gROOT->ProcessLine("new TCanvas(\"R__class\",\"class\",20,20,1000,750);");
2499 } else {
2500 padclass->cd();
2501 }
2502 }
2503
2504 if (gPad)
2505 gPad->DrawClassObject(this,option);
2506}
2507
2508////////////////////////////////////////////////////////////////////////////////
2509/// Dump contents of object on stdout.
2510/// Using the information in the object dictionary
2511/// each data member is interpreted.
2512/// If a data member is a pointer, the pointer value is printed
2513/// 'obj' is assume to point to an object of the class describe by this TClass
2514///
2515/// The following output is the Dump of a TArrow object:
2516/// ~~~ {.cpp}
2517/// fAngle 0 Arrow opening angle (degrees)
2518/// fArrowSize 0.2 Arrow Size
2519/// fOption.*fData
2520/// fX1 0.1 X of 1st point
2521/// fY1 0.15 Y of 1st point
2522/// fX2 0.67 X of 2nd point
2523/// fY2 0.83 Y of 2nd point
2524/// fUniqueID 0 object unique identifier
2525/// fBits 50331648 bit field status word
2526/// fLineColor 1 line color
2527/// fLineStyle 1 line style
2528/// fLineWidth 1 line width
2529/// fFillColor 19 fill area color
2530/// fFillStyle 1001 fill area style
2531/// ~~~
2532///
2533/// If noAddr is true, printout of all pointer values is skipped.
2534
2535void TClass::Dump(const void *obj, Bool_t noAddr /*=kFALSE*/) const
2536{
2537
2538 Longptr_t prObj = noAddr ? 0 : (Longptr_t)obj;
2539 if (IsTObject()) {
2540 if (!fIsOffsetStreamerSet) {
2542 }
2543 TObject *tobj = (TObject*)((Longptr_t)obj + fOffsetStreamer);
2544
2545
2546 if (sizeof(this) == 4)
2547 Printf("==> Dumping object at: 0x%08lx, name=%s, class=%s\n",prObj,tobj->GetName(),GetName());
2548 else
2549 Printf("==> Dumping object at: 0x%016lx, name=%s, class=%s\n",prObj,tobj->GetName(),GetName());
2550 } else {
2551
2552 if (sizeof(this) == 4)
2553 Printf("==> Dumping object at: 0x%08lx, class=%s\n",prObj,GetName());
2554 else
2555 Printf("==> Dumping object at: 0x%016lx, class=%s\n",prObj,GetName());
2556 }
2557
2558 TDumpMembers dm(noAddr);
2559 if (!CallShowMembers(obj, dm, kFALSE)) {
2560 Info("Dump", "No ShowMembers function, dumping disabled");
2561 }
2562}
2563
2564////////////////////////////////////////////////////////////////////////////////
2565/// Introduce an escape character (@) in front of a special chars.
2566/// You need to use the result immediately before it is being overwritten.
2567
2568char *TClass::EscapeChars(const char *text) const
2569{
2570 static const UInt_t maxsize = 255;
2571 static char name[maxsize+2]; //One extra if last char needs to be escaped
2572
2573 UInt_t nch = text ? strlen(text) : 0;
2574 UInt_t icur = 0;
2575 for (UInt_t i = 0; i < nch && icur < maxsize; ++i, ++icur) {
2576 if (text[i] == '\"' || text[i] == '[' || text[i] == '~' ||
2577 text[i] == ']' || text[i] == '&' || text[i] == '#' ||
2578 text[i] == '!' || text[i] == '^' || text[i] == '<' ||
2579 text[i] == '?' || text[i] == '>') {
2580 name[icur] = '@';
2581 ++icur;
2582 }
2583 name[icur] = text[i];
2584 }
2585 name[icur] = 0;
2586 return name;
2587}
2588
2589////////////////////////////////////////////////////////////////////////////////
2590/// Return a pointer to the real class of the object.
2591/// This is equivalent to object->IsA() when the class has a ClassDef.
2592/// It is REQUIRED that object is coming from a proper pointer to the
2593/// class represented by 'this'.
2594/// Example: Special case:
2595/// ~~~ {.cpp}
2596/// class MyClass : public AnotherClass, public TObject
2597/// ~~~
2598/// then on return, one must do:
2599/// ~~~ {.cpp}
2600/// TObject *obj = (TObject*)((void*)myobject)directory->Get("some object of MyClass");
2601/// MyClass::Class()->GetActualClass(obj); // this would be wrong!!!
2602/// ~~~
2603/// Also if the class represented by 'this' and NONE of its parents classes
2604/// have a virtual ptr table, the result will be 'this' and NOT the actual
2605/// class.
2606
2607TClass *TClass::GetActualClass(const void *object) const
2608{
2609 if (!object)
2610 return (TClass*)this;
2611 if (fIsA) {
2612 return (*fIsA)(object); // ROOT::IsA((ThisClass*)object);
2613 } else if (fGlobalIsA) {
2614 return fGlobalIsA(this,object);
2615 } else {
2616 if (IsTObject()) {
2617
2618 if (!fIsOffsetStreamerSet) {
2620 }
2621 TObject* realTObject = (TObject*)((size_t)object + fOffsetStreamer);
2622
2623 return realTObject->IsA();
2624 }
2625
2626 if (HasInterpreterInfo()) {
2627
2628 TVirtualIsAProxy *isa = nullptr;
2630 isa = (TVirtualIsAProxy*)gROOT->ProcessLineFast(TString::Format("new ::TInstrumentedIsAProxy<%s>(0);",GetName()));
2631 }
2632 else {
2633 isa = (TVirtualIsAProxy*)gROOT->ProcessLineFast(TString::Format("new ::TIsAProxy(typeid(%s));",GetName()));
2634 }
2635 if (isa) {
2637 const_cast<TClass*>(this)->fIsA = isa;
2638 }
2639 if (fIsA) {
2640 return (*fIsA)(object); // ROOT::IsA((ThisClass*)object);
2641 }
2642 }
2644 if (sinfo) {
2645 return sinfo->GetActualClass(object);
2646 }
2647 return (TClass*)this;
2648 }
2649}
2650
2651////////////////////////////////////////////////////////////////////////////////
2652/// Return pointer to the base class "classname". Returns 0 in case
2653/// "classname" is not a base class. Takes care of multiple inheritance.
2654
2655TClass *TClass::GetBaseClass(const char *classname)
2656{
2657 // check if class name itself is equal to classname
2658 if (strcmp(GetName(), classname) == 0) return this;
2659
2660 if (!HasDataMemberInfo()) return nullptr;
2661
2662 // Make sure we deal with possible aliases, we could also have normalized
2663 // the name.
2664 TClass *search = TClass::GetClass(classname,kTRUE,kTRUE);
2665
2666 if (search) return GetBaseClass(search);
2667 else return nullptr;
2668}
2669
2670////////////////////////////////////////////////////////////////////////////////
2671/// Return pointer to the base class "cl". Returns 0 in case "cl"
2672/// is not a base class. Takes care of multiple inheritance.
2673
2675{
2676 // check if class name itself is equal to classname
2677 if (cl == this) return this;
2678
2679 if (!HasDataMemberInfo()) return nullptr;
2680
2681 TObjLink *lnk = GetListOfBases() ? fBase.load()->FirstLink() : nullptr;
2682
2683 // otherwise look at inheritance tree
2684 while (lnk) {
2685 TClass *c, *c1;
2686 TBaseClass *base = (TBaseClass*) lnk->GetObject();
2687 c = base->GetClassPointer();
2688 if (c) {
2689 if (cl == c) return c;
2690 c1 = c->GetBaseClass(cl);
2691 if (c1) return c1;
2692 }
2693 lnk = lnk->Next();
2694 }
2695 return nullptr;
2696}
2697
2698////////////////////////////////////////////////////////////////////////////////
2699/// Return data member offset to the base class "cl".
2700/// - Returns -1 in case "cl" is not a base class.
2701/// - Returns -2 if cl is a base class, but we can't find the offset
2702/// because it's virtual.
2703/// Takes care of multiple inheritance.
2704
2706{
2707 // check if class name itself is equal to classname
2708 if (cl == this) return 0;
2709
2710 if (!fBase.load()) {
2712 // If the information was not provided by the root pcm files and
2713 // if we can not find the ClassInfo, we have to fall back to the
2714 // StreamerInfo
2715 if (!fClassInfo) {
2717 if (!sinfo) return -1;
2718 TStreamerElement *element;
2719 Int_t offset = 0;
2720
2721 TObjArray &elems = *(sinfo->GetElements());
2722 Int_t size = elems.GetLast()+1;
2723 for(Int_t i=0; i<size; i++) {
2724 element = (TStreamerElement*)elems[i];
2725 if (element->IsBase()) {
2726 if (element->IsA() == TStreamerBase::Class()) {
2727 TStreamerBase *base = (TStreamerBase*)element;
2728 TClass *baseclass = base->GetClassPointer();
2729 if (!baseclass) return -1;
2730 Int_t subOffset = baseclass->GetBaseClassOffsetRecurse(cl);
2731 if (subOffset == -2) return -2;
2732 if (subOffset != -1) return offset+subOffset;
2733 offset += baseclass->Size();
2734 } else if (element->IsA() == TStreamerSTL::Class()) {
2735 TStreamerSTL *base = (TStreamerSTL*)element;
2736 TClass *baseclass = base->GetClassPointer();
2737 if (!baseclass) return -1;
2738 Int_t subOffset = baseclass->GetBaseClassOffsetRecurse(cl);
2739 if (subOffset == -2) return -2;
2740 if (subOffset != -1) return offset+subOffset;
2741 offset += baseclass->Size();
2742
2743 } else {
2744 Error("GetBaseClassOffsetRecurse","Unexpected element type for base class: %s\n",element->IsA()->GetName());
2745 }
2746 }
2747 }
2748 return -1;
2749 }
2750 }
2751
2752 TClass *c;
2753 Int_t off;
2754 TBaseClass *inh;
2755 TObjLink *lnk = nullptr;
2756 if (fBase.load() == nullptr)
2757 lnk = GetListOfBases()->FirstLink();
2758 else
2759 lnk = fBase.load()->FirstLink();
2760
2761 // otherwise look at inheritance tree
2762 while (lnk) {
2763 inh = (TBaseClass *)lnk->GetObject();
2764 //use option load=kFALSE to avoid a warning like:
2765 //"Warning in <TClass::TClass>: no dictionary for class TRefCnt is available"
2766 //We can not afford to not have the class if it exist, so we
2767 //use kTRUE.
2768 c = inh->GetClassPointer(kTRUE); // kFALSE);
2769 if (c) {
2770 if (cl == c) {
2771 if ((inh->Property() & kIsVirtualBase) != 0)
2772 return -2;
2773 return inh->GetDelta();
2774 }
2775 off = c->GetBaseClassOffsetRecurse(cl);
2776 if (off == -2) return -2;
2777 if (off != -1) {
2778 return off + inh->GetDelta();
2779 }
2780 }
2781 lnk = lnk->Next();
2782 }
2783 return -1;
2784}
2785
2786////////////////////////////////////////////////////////////////////////////////
2787/// - Return data member offset to the base class "cl".
2788/// - Returns -1 in case "cl" is not a base class.
2789/// Takes care of multiple inheritance.
2790
2791Int_t TClass::GetBaseClassOffset(const TClass *toBase, void *address, bool isDerivedObject)
2792{
2793 // Warning("GetBaseClassOffset","Requires the use of fClassInfo for %s to %s",GetName(),toBase->GetName());
2794
2795 if (this == toBase) return 0;
2796
2797 if ((!address /* || !has_virtual_base */) &&
2799 // At least of the ClassInfo have not been loaded in memory yet and
2800 // since there is no virtual base class (or we don't have enough so it
2801 // would not make a difference) we can use the 'static' information
2803 if (offset != -2) {
2804 return offset;
2805 }
2806 return offset;
2807 }
2808
2809 ClassInfo_t* derived = GetClassInfo();
2810 ClassInfo_t* base = toBase->GetClassInfo();
2811 if(derived && base) {
2812 // TClingClassInfo::GetBaseOffset takes the lock.
2813 return gCling->ClassInfo_GetBaseOffset(derived, base, address, isDerivedObject);
2814 }
2815 else {
2817 if (offset != -2) {
2818 return offset;
2819 }
2820 }
2821 return -1;
2822}
2823
2824////////////////////////////////////////////////////////////////////////////////
2825/// Return pointer to (base) class that contains datamember.
2826
2827TClass *TClass::GetBaseDataMember(const char *datamember)
2828{
2829 if (!HasDataMemberInfo()) return nullptr;
2830
2831 // Check if data member exists in class itself
2832 TDataMember *dm = GetDataMember(datamember);
2833 if (dm) return this;
2834
2835 // if datamember not found in class, search in next base classes
2836 TBaseClass *inh;
2837 TIter next(GetListOfBases());
2838 while ((inh = (TBaseClass *) next())) {
2839 TClass *c = inh->GetClassPointer();
2840 if (c) {
2841 TClass *cdm = c->GetBaseDataMember(datamember);
2842 if (cdm) return cdm;
2843 }
2844 }
2845
2846 return nullptr;
2847}
2848
2849namespace {
2850 // A local Helper class used to keep 2 pointer (the collection proxy
2851 // and the class streamer) in the thread local storage.
2852
2853 struct TClassLocalStorage {
2854 TClassLocalStorage() : fCollectionProxy(nullptr), fStreamer(nullptr) {};
2855
2856 TVirtualCollectionProxy *fCollectionProxy;
2857 TClassStreamer *fStreamer;
2858
2859 static TClassLocalStorage *GetStorage(const TClass *cl)
2860 {
2861 // Return the thread storage for the TClass.
2862
2863 void **thread_ptr = (*gThreadTsd)(nullptr,ROOT::kClassThreadSlot);
2864 if (thread_ptr) {
2865 if (*thread_ptr==nullptr) *thread_ptr = new TExMap();
2866 TExMap *lmap = (TExMap*)(*thread_ptr);
2867 ULong_t hash = TString::Hash(&cl, sizeof(void*));
2868 ULongptr_t local = 0;
2869 UInt_t slot;
2870 if ((local = (ULongptr_t)lmap->GetValue(hash, (Longptr_t)cl, slot)) != 0) {
2871 } else {
2872 local = (ULongptr_t) new TClassLocalStorage();
2873 lmap->AddAt(slot, hash, (Longptr_t)cl, local);
2874 }
2875 return (TClassLocalStorage*)local;
2876 }
2877 return nullptr;
2878 }
2879 };
2880}
2881
2882////////////////////////////////////////////////////////////////////////////////
2883/// Return the 'type' of the STL the TClass is representing.
2884/// and return ROOT::kNotSTL if it is not representing an STL collection.
2885
2887{
2888 auto proxy = GetCollectionProxy();
2889 if (proxy) return (ROOT::ESTLType)proxy->GetCollectionType();
2890 return ROOT::kNotSTL;
2891}
2892
2893
2894////////////////////////////////////////////////////////////////////////////////
2895/// Return the proxy describing the collection (if any).
2896
2898{
2899 // Use assert, so that this line (slow because of the TClassEdit) is completely
2900 // removed in optimized code.
2901 //assert(TestBit(kLoading) || !TClassEdit::IsSTLCont(fName) || fCollectionProxy || 0 == "The TClass for the STL collection has no collection proxy!");
2903 TClassLocalStorage *local = TClassLocalStorage::GetStorage(this);
2904 if (local == nullptr) return fCollectionProxy;
2905 if (local->fCollectionProxy==nullptr) local->fCollectionProxy = fCollectionProxy->Generate();
2906 return local->fCollectionProxy;
2907 }
2908 return fCollectionProxy;
2909}
2910
2911////////////////////////////////////////////////////////////////////////////////
2912/// Return the Streamer Class allowing streaming (if any).
2913
2915{
2916 if (gThreadTsd && fStreamer) {
2917 TClassLocalStorage *local = TClassLocalStorage::GetStorage(this);
2918 if (local==nullptr) return fStreamer;
2919 if (local->fStreamer==nullptr) {
2920 local->fStreamer = fStreamer->Generate();
2921 const std::type_info &orig = ( typeid(*fStreamer) );
2922 if (!local->fStreamer) {
2923 Warning("GetStreamer","For %s, the TClassStreamer (%s) passed's call to Generate failed!",GetName(),orig.name());
2924 } else {
2925 const std::type_info &copy = ( typeid(*local->fStreamer) );
2926 if (strcmp(orig.name(),copy.name())!=0) {
2927 Warning("GetStreamer","For %s, the TClassStreamer passed does not properly implement the Generate method (%s vs %s)\n",GetName(),orig.name(),copy.name());
2928 }
2929 }
2930 }
2931 return local->fStreamer;
2932 }
2933 return fStreamer;
2934}
2935
2936////////////////////////////////////////////////////////////////////////////////
2937/// Get a wrapper/accessor function around this class custom streamer (member function).
2938
2940{
2941 return fStreamerFunc;
2942}
2943
2944////////////////////////////////////////////////////////////////////////////////
2945/// Get a wrapper/accessor function around this class custom conversion streamer (member function).
2946
2948{
2949 return fConvStreamerFunc;
2950}
2951
2952////////////////////////////////////////////////////////////////////////////////
2953/// Return the proxy implementing the IsA functionality.
2954
2956{
2957 return fIsA;
2958}
2959
2960////////////////////////////////////////////////////////////////////////////////
2961/// Static method returning pointer to TClass of the specified class name.
2962/// If load is true an attempt is made to obtain the class by loading
2963/// the appropriate shared library (directed by the rootmap file).
2964/// If silent is 'true', do not warn about missing dictionary for the class.
2965/// (typically used for class that are used only for transient members)
2966/// Returns 0 in case class is not found.
2967
2968TClass *TClass::GetClass(const char *name, Bool_t load, Bool_t silent)
2969{
2970 return TClass::GetClass(name, load, silent, 0, 0);
2971}
2972
2973TClass *TClass::GetClass(const char *name, Bool_t load, Bool_t silent, size_t hint_pair_offset, size_t hint_pair_size)
2974{
2975 if (!name || !name[0]) return nullptr;
2976
2977 if (strstr(name, "(anonymous)")) return nullptr;
2978 if (strstr(name, "(unnamed)")) return nullptr;
2979 if (strncmp(name,"class ",6)==0) name += 6;
2980 if (strncmp(name,"struct ",7)==0) name += 7;
2981
2982 if (!gROOT->GetListOfClasses()) return nullptr;
2983
2984 // FindObject will take the read lock before actually getting the
2985 // TClass pointer so we will need not get a partially initialized
2986 // object.
2987 TClass *cl = (TClass*)gROOT->GetListOfClasses()->FindObject(name);
2988
2989 // Early return to release the lock without having to execute the
2990 // long-ish normalization.
2991 if (cl && (cl->IsLoaded() || cl->TestBit(kUnloading))) return cl;
2992
2994
2995 // Now that we got the write lock, another thread may have constructed the
2996 // TClass while we were waiting, so we need to do the checks again.
2997
2998 cl = (TClass*)gROOT->GetListOfClasses()->FindObject(name);
2999 if (cl) {
3000 if (cl->IsLoaded() || cl->TestBit(kUnloading)) return cl;
3001
3002 // We could speed-up some of the search by adding (the equivalent of)
3003 //
3004 // if (cl->GetState() == kInterpreter) return cl
3005 //
3006 // In this case, if a ROOT dictionary was available when the TClass
3007 // was first requested it would have been used and if a ROOT dictionary is
3008 // loaded later on TClassTable::Add will take care of updating the TClass.
3009 // So as far as ROOT dictionary are concerned, if the current TClass is
3010 // in interpreted state, we are sure there is nothing to load.
3011 //
3012 // However (see TROOT::LoadClass), the TClass can also be loaded/provided
3013 // by a user provided TClassGenerator. We have no way of knowing whether
3014 // those do (or even can) behave the same way as the ROOT dictionary and
3015 // have the 'dictionary is now available for use' step informs the existing
3016 // TClass that their dictionary is now available.
3017
3018 //we may pass here in case of a dummy class created by TVirtualStreamerInfo
3019 load = kTRUE;
3020 }
3021
3023 // If there is a @ symbol (followed by a version number) then this is a synthetic class name created
3024 // from an already normalized name for the purpose of supporting schema evolution.
3025 // There is no dictionary or interpreter information about this kind of class, the only
3026 // (undesirable) side-effect of doing the search would be a waste of CPU time and potential
3027 // auto-loading or auto-parsing based on the scope of the name.
3028 return cl;
3029 }
3030
3031 // To avoid spurious auto parsing, let's check if the name as-is is
3032 // known in the TClassTable.
3034 if (dict) {
3035 // The name is normalized, so the result of the first search is
3036 // authoritative.
3037 if (!cl && !load) return nullptr;
3038
3039 TClass *loadedcl = (dict)();
3040 if (loadedcl) {
3041 loadedcl->PostLoadCheck();
3042 return loadedcl;
3043 }
3044
3045 // We should really not fall through to here, but if we do, let's just
3046 // continue as before ...
3047 }
3048
3049 std::string normalizedName;
3050 Bool_t checkTable = kFALSE;
3051
3052 if (!cl) {
3053 {
3055 TClassEdit::GetNormalizedName(normalizedName, name);
3056 }
3057 // Try the normalized name.
3058 if (normalizedName != name) {
3059 cl = (TClass*)gROOT->GetListOfClasses()->FindObject(normalizedName.c_str());
3060
3061 if (cl) {
3062 if (cl->IsLoaded() || cl->TestBit(kUnloading)) return cl;
3063
3064 //we may pass here in case of a dummy class created by TVirtualStreamerInfo
3065 load = kTRUE;
3066 }
3067 checkTable = kTRUE;
3068 }
3069 } else {
3070 normalizedName = cl->GetName(); // Use the fact that all TClass names are normalized.
3071 checkTable = load && (normalizedName != name);
3072 }
3073
3074 if (!load) return nullptr;
3075
3076// This assertion currently fails because of
3077// TClass *c1 = TClass::GetClass("basic_iostream<char,char_traits<char> >");
3078// TClass *c2 = TClass::GetClass("std::iostream");
3079// where the TClassEdit normalized name of iostream is basic_iostream<char>
3080// i.e missing the addition of the default parameter. This is because TClingLookupHelper
3081// uses only 'part' of TMetaUtils::GetNormalizedName.
3082
3083// if (!cl) {
3084// TDataType* dataType = (TDataType*)gROOT->GetListOfTypes()->FindObject(name);
3085// TClass *altcl = dataType ? (TClass*)gROOT->GetListOfClasses()->FindObject(dataType->GetFullTypeName()) : 0;
3086// if (altcl && normalizedName != altcl->GetName())
3087// ::Fatal("TClass::GetClass","The existing name (%s) for %s is different from the normalized name: %s\n",
3088// altcl->GetName(), name, normalizedName.c_str());
3089// }
3090
3091 // We want to avoid auto-parsing due to intentionally missing dictionary for std::pair.
3092 // However, we don't need this special treatement in rootcling (there is no auto-parsing)
3093 // and we want to make that the TClass for the pair goes through the regular creation
3094 // mechanism (i.e. in rootcling they should be in kInterpreted state and never in
3095 // kEmulated state) so that they have proper interpreter (ClassInfo) information which
3096 // will be used to create the TProtoClass (if one is requested for the pair).
3097 const bool ispair = TClassEdit::IsStdPair(normalizedName) && !IsFromRootCling();
3098 const bool ispairbase = TClassEdit::IsStdPairBase(normalizedName) && !IsFromRootCling();
3099
3100 TClass *loadedcl = nullptr;
3101 if (checkTable) {
3102 loadedcl = LoadClassDefault(normalizedName.c_str(),silent);
3103 } else {
3104 if (gInterpreter->AutoLoad(normalizedName.c_str(),kTRUE)) {
3105 loadedcl = LoadClassDefault(normalizedName.c_str(),silent);
3106 }
3107 auto e = TEnum::GetEnum(normalizedName.c_str(), TEnum::kNone);
3108 if (e)
3109 return nullptr;
3110 // Maybe this was a typedef: let's try to see if this is the case
3111 if (!loadedcl && !ispair && !ispairbase) {
3112 if (TDataType* theDataType = gROOT->GetType(normalizedName.c_str())){
3113 // We have a typedef: we get the name of the underlying type
3114 auto underlyingTypeName = theDataType->GetTypeName();
3115 // We see if we can bootstrap a class with it
3116 auto underlyingTypeDict = TClassTable::GetDictNorm(underlyingTypeName.Data());
3117 if (underlyingTypeDict){
3118 loadedcl = underlyingTypeDict();
3119 }
3120
3121 }
3122 }
3123 }
3124 if (loadedcl) return loadedcl;
3125
3126 // See if the TClassGenerator can produce the TClass we need.
3127 loadedcl = LoadClassCustom(normalizedName.c_str(),silent);
3128 if (loadedcl) return loadedcl;
3129
3130 // We have not been able to find a loaded TClass, return the Emulated
3131 // TClass if we have one.
3132 if (cl) return cl;
3133
3134 if (ispair) {
3135 if (hint_pair_offset && hint_pair_size) {
3136 auto pairinfo = TVirtualStreamerInfo::Factory()->GenerateInfoForPair(normalizedName, silent, hint_pair_offset, hint_pair_size);
3137 // Fall-through to allow TClass to be created when known by the interpreter
3138 // This is used in the case where TStreamerInfo can not handle them.
3139 if (pairinfo)
3140 return pairinfo->GetClass();
3141 } else {
3142 // Check if we have an STL container that might provide it.
3143 static const size_t slen = strlen("pair");
3144 static const char *associativeContainer[] = { "map", "unordered_map", "multimap",
3145 "unordered_multimap", "set", "unordered_set", "multiset", "unordered_multiset" };
3146 for(auto contname : associativeContainer) {
3147 std::string collname = contname;
3148 collname.append( normalizedName.c_str() + slen );
3149 TClass *collcl = TClass::GetClass(collname.c_str(), false, silent);
3150 if (!collcl)
3151 collcl = LoadClassDefault(collname.c_str(), silent);
3152 if (collcl) {
3153 auto p = collcl->GetCollectionProxy();
3154 if (p)
3155 cl = p->GetValueClass();
3156 if (cl)
3157 return cl;
3158 }
3159 }
3160 }
3161 } else if (TClassEdit::IsSTLCont( normalizedName.c_str() )) {
3162
3163 return gInterpreter->GenerateTClass(normalizedName.c_str(), kTRUE, silent);
3164 }
3165
3166 // Check the interpreter only after autoparsing the template if any.
3167 if (!ispairbase) {
3168 std::string::size_type posLess = normalizedName.find('<');
3169 if (posLess != std::string::npos) {
3170 gCling->AutoParse(normalizedName.substr(0, posLess).c_str());
3171 }
3172 }
3173
3174 //last attempt. Look in CINT list of all (compiled+interpreted) classes
3175 if (gDebug>0){
3176 printf("TClass::GetClass: Header Parsing - The representation of %s was not found in the type system. A lookup in the interpreter is about to be tried: this can cause parsing. This can be avoided selecting %s in the linkdef/selection file.\n",normalizedName.c_str(), normalizedName.c_str());
3177 }
3178 if (normalizedName.length()) {
3179 auto cci = gInterpreter->CheckClassInfo(normalizedName.c_str(), kTRUE /* autoload */,
3180 kTRUE /*Only class, structs and ns*/);
3181
3182 // We could have an interpreted class with an inline ClassDef, in this case we do not
3183 // want to create an 'interpreted' TClass but we want the one triggered via the call to
3184 // the Dictionary member. If we go ahead and generate the 'interpreted' version it will
3185 // replace if/when there is a call to IsA on an object of this type.
3186
3188 auto ci = gInterpreter->ClassInfo_Factory(normalizedName.c_str());
3189 auto funcDecl = gInterpreter->GetFunctionWithPrototype(ci, "Dictionary", "", false, ROOT::kExactMatch);
3190 auto method = gInterpreter->MethodInfo_Factory(funcDecl);
3191 typedef void (*tcling_callfunc_Wrapper_t)(void *, int, void **, void *);
3192 auto funcPtr = (tcling_callfunc_Wrapper_t)gInterpreter->MethodInfo_InterfaceMethod(method);
3193
3194 TClass *res = nullptr;
3195 if (funcPtr)
3196 funcPtr(nullptr, 0, nullptr, &res);
3197 // else
3198 // We could fallback to the interpreted case ...
3199 // For now just 'fail' (return nullptr)
3200
3201 gInterpreter->MethodInfo_Delete(method);
3202 gInterpreter->ClassInfo_Delete(ci);
3203
3204 return res;
3205 } else if (cci) {
3206 // Get the normalized name based on the decl (currently the only way
3207 // to get the part to add or drop the default arguments as requested by the user)
3208 std::string alternative;
3209 gInterpreter->GetInterpreterTypeName(normalizedName.c_str(), alternative, kTRUE);
3210 if (alternative.empty())
3211 return nullptr;
3212 const char *altname = alternative.c_str();
3213 if (strncmp(altname, "std::", 5) == 0) {
3214 // For namespace (for example std::__1), GetInterpreterTypeName does
3215 // not strip std::, so we must do it explicitly here.
3216 altname += 5;
3217 }
3218 if (altname != normalizedName && strcmp(altname, name) != 0) {
3219 // altname now contains the full name of the class including a possible
3220 // namespace if there has been a using namespace statement.
3221
3222 // At least in the case C<string [2]> (normalized) vs C<string[2]> (altname)
3223 // the TClassEdit normalization and the TMetaUtils normalization leads to
3224 // two different space layout. To avoid an infinite recursion, we also
3225 // add the test on (altname != name)
3226
3227 return GetClass(altname, load);
3228 }
3229
3230 TClass *ncl = gInterpreter->GenerateTClass(normalizedName.c_str(), /* emulation = */ kFALSE, silent);
3231 if (!ncl->IsZombie()) {
3232 return ncl;
3233 }
3234 delete ncl;
3235 }
3236 }
3237 return nullptr;
3238}
3239
3240////////////////////////////////////////////////////////////////////////////////
3241/// Return pointer to class with name.
3242
3243TClass *TClass::GetClass(const std::type_info& typeinfo, Bool_t load, Bool_t /* silent */, size_t hint_pair_offset, size_t hint_pair_size)
3244{
3245 if (!gROOT->GetListOfClasses())
3246 return nullptr;
3247
3248 //protect access to TROOT::GetIdMap
3250
3251 TClass* cl = GetIdMap()->Find(typeinfo.name());
3252
3253 if (cl && cl->IsLoaded()) return cl;
3254
3256
3257 // Now that we got the write lock, another thread may have constructed the
3258 // TClass while we were waiting, so we need to do the checks again.
3259
3260 cl = GetIdMap()->Find(typeinfo.name());
3261
3262 if (cl) {
3263 if (cl->IsLoaded()) return cl;
3264 //we may pass here in case of a dummy class created by TVirtualStreamerInfo
3265 load = kTRUE;
3266 } else {
3267 // Note we might need support for typedefs and simple types!
3268
3269 // TDataType *objType = GetType(name, load);
3270 //if (objType) {
3271 // const char *typdfName = objType->GetTypeName();
3272 // if (typdfName && strcmp(typdfName, name)) {
3273 // cl = GetClass(typdfName, load);
3274 // return cl;
3275 // }
3276 // }
3277 }
3278
3279 if (!load) return nullptr;
3280
3281 DictFuncPtr_t dict = TClassTable::GetDict(typeinfo);
3282 if (dict) {
3283 cl = (dict)();
3284 if (cl) cl->PostLoadCheck();
3285 return cl;
3286 }
3287 if (cl) return cl;
3288
3289 TIter next(gROOT->GetListOfClassGenerators());
3290 TClassGenerator *gen;
3291 while( (gen = (TClassGenerator*) next()) ) {
3292 cl = gen->GetClass(typeinfo,load);
3293 if (cl) {
3294 cl->PostLoadCheck();
3295 return cl;
3296 }
3297 }
3298
3299 // try AutoLoading the typeinfo
3300 int autoload_old = gCling->SetClassAutoLoading(1);
3301 if (!autoload_old) {
3302 // Re-disable, we just meant to test
3304 }
3305 if (autoload_old && gInterpreter->AutoLoad(typeinfo,kTRUE)) {
3306 // Disable autoload to avoid potential infinite recursion
3308 cl = GetClass(typeinfo, load, hint_pair_offset, hint_pair_size);
3309 if (cl) {
3310 return cl;
3311 }
3312 }
3313
3314 if (hint_pair_offset) {
3315 int err = 0;
3316 char* demangled_name = TClassEdit::DemangleTypeIdName(typeinfo, err);
3317 if (!err) {
3318 cl = TClass::GetClass(demangled_name, load, kTRUE, hint_pair_offset, hint_pair_size);
3319 free(demangled_name);
3320 if (cl)
3321 return cl;
3322 }
3323 }
3324
3325 // last attempt. Look in the interpreter list of all (compiled+interpreted)
3326 // classes
3327 cl = gInterpreter->GetClass(typeinfo, load);
3328
3329 return cl; // Can be zero.
3330}
3331
3332////////////////////////////////////////////////////////////////////////////////
3333/// Static method returning pointer to TClass of the specified ClassInfo.
3334/// If load is true an attempt is made to obtain the class by loading
3335/// the appropriate shared library (directed by the rootmap file).
3336/// If silent is 'true', do not warn about missing dictionary for the class.
3337/// (typically used for class that are used only for transient members)
3338/// Returns 0 in case class is not found.
3339
3340TClass *TClass::GetClass(ClassInfo_t *info, Bool_t load, Bool_t silent)
3341{
3342 if (!info || !gCling->ClassInfo_IsValid(info)) return nullptr;
3343 if (!gROOT->GetListOfClasses()) return nullptr;
3344
3345 // Technically we need the write lock only for the call to ClassInfo_FullName
3346 // and GenerateTClass but FindObject will take the read lock (and LoadClass will
3347 // take the write lock). Since taking/releasing the lock is expensive, let just
3348 // take the write guard and keep it.
3350
3351 // Get the normalized name.
3353
3354 TClass *cl = (TClass*)gROOT->GetListOfClasses()->FindObject(name);
3355
3356 if (cl) {
3357 if (cl->IsLoaded()) return cl;
3358
3359 //we may pass here in case of a dummy class created by TVirtualStreamerInfo
3360 load = kTRUE;
3361
3362 }
3363
3364 if (!load) return nullptr;
3365
3366 TClass *loadedcl = nullptr;
3367 if (cl) loadedcl = gROOT->LoadClass(cl->GetName(),silent);
3368 else loadedcl = gROOT->LoadClass(name,silent);
3369
3370 if (loadedcl) return loadedcl;
3371
3372 if (cl) return cl; // If we found the class but we already have a dummy class use it.
3373
3374 // We did not find a proper TClass but we do know (we have a valid
3375 // ClassInfo) that the class is known to the interpreter.
3376 TClass *ncl = gInterpreter->GenerateTClass(info, silent);
3377 if (!ncl->IsZombie()) {
3378 return ncl;
3379 } else {
3380 delete ncl;
3381 return nullptr;
3382 }
3383}
3384
3385////////////////////////////////////////////////////////////////////////////////
3386
3389}
3390
3391////////////////////////////////////////////////////////////////////////////////
3392
3393Bool_t TClass::GetClass(DeclId_t id, std::vector<TClass*> &classes)
3394{
3395 if (!gROOT->GetListOfClasses()) return 0;
3396
3397 DeclIdMap_t* map = GetDeclIdMap();
3398 // Get all the TClass pointer that have the same DeclId.
3399 DeclIdMap_t::equal_range iter = map->Find(id);
3400 if (iter.first == iter.second) return false;
3401 std::vector<TClass*>::iterator vectIt = classes.begin();
3402 for (DeclIdMap_t::const_iterator it = iter.first; it != iter.second; ++it)
3403 vectIt = classes.insert(vectIt, it->second);
3404 return true;
3405}
3406
3407////////////////////////////////////////////////////////////////////////////////
3408/// Return a pointer to the dictionary loading function generated by
3409/// rootcint
3410
3412{
3414}
3415
3416////////////////////////////////////////////////////////////////////////////////
3417/// Return a pointer to the dictionary loading function generated by
3418/// rootcint
3419
3420DictFuncPtr_t TClass::GetDict (const std::type_info& info)
3421{
3422 return TClassTable::GetDict(info);
3423}
3424
3425////////////////////////////////////////////////////////////////////////////////
3426/// Return pointer to datamember object with name "datamember".
3427
3428TDataMember *TClass::GetDataMember(const char *datamember) const
3429{
3430 if ((!(fData.load() && (*fData).IsLoaded()) && !HasInterpreterInfo())
3431 || datamember == nullptr) return nullptr;
3432
3433 // Strip off leading *'s and trailing [
3434 const char *start_name = datamember;
3435 while (*start_name == '*') ++start_name;
3436
3437 // Empty name are 'legal', they represent anonymous unions.
3438 // if (*start_name == 0) return 0;
3439
3440 if (const char *s = strchr(start_name, '[')){
3441 UInt_t len = s-start_name;
3442 TString name(start_name,len);
3443 return (TDataMember *)((TClass*)this)->GetListOfDataMembers(kFALSE)->FindObject(name.Data());
3444 } else {
3445 return (TDataMember *)((TClass*)this)->GetListOfDataMembers(kFALSE)->FindObject(start_name);
3446 }
3447}
3448
3449////////////////////////////////////////////////////////////////////////////////
3450/// Return name of the file containing the declaration of this class.
3451
3452const char *TClass::GetDeclFileName() const
3453{
3454 if (fDeclFileName == kUndeterminedClassInfoName)
3455 return gInterpreter->ClassInfo_FileName( fClassInfo );
3456 return fDeclFileName;
3457}
3458
3459////////////////////////////////////////////////////////////////////////////////
3460/// return offset for member name. name can be a data member in
3461/// the class itself, one of its base classes, or one member in
3462/// one of the aggregated classes.
3463///
3464/// In case of an emulated class, the list of emulated TRealData is built
3465
3467{
3468 TRealData *rd = GetRealData(name);
3469 if (rd) return rd->GetThisOffset();
3470 if (strchr(name,'[')==nullptr) {
3471 // If this is a simple name there is a chance to find it in the
3472 // StreamerInfo even if we did not find it in the RealData.
3473 // For example an array name would be fArray[3] in RealData but
3474 // just fArray in the streamerInfo.
3475 TVirtualStreamerInfo *info = const_cast<TClass*>(this)->GetCurrentStreamerInfo();
3476 if (info) {
3477 return info->GetOffset(name);
3478 }
3479 }
3480 return 0;
3481}
3482
3483////////////////////////////////////////////////////////////////////////////////
3484/// Return pointer to TRealData element with name "name".
3485///
3486/// Name can be a data member in the class itself,
3487/// one of its base classes, or a member in
3488/// one of the aggregated classes.
3489///
3490/// In case of an emulated class, the list of emulated TRealData is built.
3491
3493{
3494 if (!fRealData) {
3495 const_cast<TClass*>(this)->BuildRealData();
3496 }
3497
3498 if (!fRealData) {
3499 return nullptr;
3500 }
3501
3502 if (!name) {
3503 return nullptr;
3504 }
3505
3506 // First try just the whole name.
3508 if (rd) {
3509 return rd;
3510 }
3511
3512 std::string givenName(name);
3513
3514 // Try ignoring the array dimensions.
3515 std::string::size_type firstBracket = givenName.find_first_of("[");
3516 if (firstBracket != std::string::npos) {
3517 // -- We are looking for an array data member.
3518 std::string nameNoDim(givenName.substr(0, firstBracket));
3519 TObjLink* lnk = fRealData->FirstLink();
3520 while (lnk) {
3521 TObject* obj = lnk->GetObject();
3522 std::string objName(obj->GetName());
3523 std::string::size_type pos = objName.find_first_of("[");
3524 // Only match arrays to arrays for now.
3525 if (pos != std::string::npos) {
3526 objName.erase(pos);
3527 if (objName == nameNoDim) {
3528 return static_cast<TRealData*>(obj);
3529 }
3530 }
3531 lnk = lnk->Next();
3532 }
3533 }
3534
3535 // Now try it as a pointer.
3536 std::ostringstream ptrname;
3537 ptrname << "*" << givenName;
3538 rd = (TRealData*) fRealData->FindObject(ptrname.str().c_str());
3539 if (rd) {
3540 return rd;
3541 }
3542
3543 // Check for a dot in the name.
3544 std::string::size_type firstDot = givenName.find_first_of(".");
3545 if (firstDot == std::string::npos) {
3546 // -- Not found, a simple name, all done.
3547 return nullptr;
3548 }
3549
3550 //
3551 // At this point the name has a dot in it, so it is the name
3552 // of some contained sub-object.
3553 //
3554
3555 // May be a pointer like in TH1: fXaxis.fLabels (in TRealdata is named fXaxis.*fLabels)
3556 std::string::size_type lastDot = givenName.find_last_of(".");
3557 std::ostringstream starname;
3558 starname << givenName.substr(0, lastDot) << ".*" << givenName.substr(lastDot + 1);
3559 rd = (TRealData*) fRealData->FindObject(starname.str().c_str());
3560 if (rd) {
3561 return rd;
3562 }
3563
3564 // Last attempt in case a member has been changed from
3565 // a static array to a pointer, for example the member
3566 // was arr[20] and is now *arr.
3567 //
3568 // Note: In principle, one could also take into account
3569 // the opposite situation where a member like *arr has
3570 // been converted to arr[20].
3571 //
3572 // FIXME: What about checking after the first dot as well?
3573 //
3574 std::string::size_type bracket = starname.str().find_first_of("[");
3575 if (bracket != std::string::npos) {
3576 rd = (TRealData*) fRealData->FindObject(starname.str().substr(0, bracket).c_str());
3577 if (rd) {
3578 return rd;
3579 }
3580 }
3581
3582 // Strip the first component, it may be the name of
3583 // the branch (old TBranchElement code), and try again.
3584 std::string firstDotName(givenName.substr(firstDot + 1));
3585
3586 rd = GetRealData(firstDotName.c_str());
3587 if (rd)
3588 return rd;
3589
3590 // Not found;
3591 return nullptr;
3592}
3593
3594////////////////////////////////////////////////////////////////////////////////
3595
3597{
3598 if (!gInterpreter || !HasInterpreterInfo()) return nullptr;
3599
3600 // The following
3602
3604}
3605
3606////////////////////////////////////////////////////////////////////////////////
3607/// Get the list of shared libraries containing the code for class cls.
3608/// The first library in the list is the one containing the class, the
3609/// others are the libraries the first one depends on. Returns 0
3610/// in case the library is not found.
3611
3613{
3614 if (!gInterpreter) return nullptr;
3615
3616 if (fSharedLibs.IsNull())
3617 fSharedLibs = gInterpreter->GetClassSharedLibs(fName);
3618
3619 return !fSharedLibs.IsNull() ? fSharedLibs.Data() : nullptr;
3620}
3621
3622////////////////////////////////////////////////////////////////////////////////
3623/// Return list containing the TBaseClass(es) of a class.
3624
3626{
3627 if (!fBase.load()) {
3628 if (fCanLoadClassInfo) {
3629 if (fState == kHasTClassInit) {
3630
3632 if (!fHasRootPcmInfo) {
3633 // The bases are in our ProtoClass; we don't need the class info.
3635 if (proto && proto->FillTClass(this))
3636 return fBase;
3637 }
3638 }
3639 // We test again on fCanLoadClassInfo has another thread may have executed it.
3641 LoadClassInfo();
3642 }
3643 }
3644 if (!fClassInfo)
3645 return nullptr;
3646
3647 if (!gInterpreter)
3648 Fatal("GetListOfBases", "gInterpreter not initialized");
3649
3651 if (!fBase.load()) {
3652 gInterpreter->CreateListOfBaseClasses(this);
3653 }
3654 }
3655 return fBase;
3656}
3657
3658////////////////////////////////////////////////////////////////////////////////
3659/// Return a list containing the TEnums of a class.
3660///
3661/// The list returned is safe to use from multiple thread without explicitly
3662/// taking the ROOT global lock.
3663///
3664/// In the case the TClass represents a namespace, the returned list will
3665/// implicit take the ROOT global lock upon any access (see TListOfEnumsWithLock)
3666///
3667/// In the case the TClass represents a class or struct and requestListLoading
3668/// is true, the list is immutable (and thus safe to access from multiple thread
3669/// without taking the global lock at all).
3670///
3671/// In the case the TClass represents a class or struct and requestListLoading
3672/// is false, the list is mutable and thus we return a TListOfEnumsWithLock
3673/// which will implicit take the ROOT global lock upon any access.
3674
3675TList *TClass::GetListOfEnums(Bool_t requestListLoading /* = kTRUE */)
3676{
3677 auto temp = fEnums.load();
3678 if (temp) {
3679 if (requestListLoading) {
3680 if (fProperty == -1) Property();
3681 if (! ((kIsClass | kIsStruct | kIsUnion) & fProperty) ) {
3683 temp->Load();
3684 } else if ( temp->IsA() == TListOfEnumsWithLock::Class() ) {
3685 // We have a class for which the list was not loaded fully at
3686 // first use.
3688 temp->Load();
3689 }
3690 }
3691 return temp;
3692 }
3693
3694 if (!requestListLoading) {
3695 if (fProperty == -1) Property();
3697 if (fEnums.load()) {
3698 return fEnums.load();
3699 }
3700
3701 if (IsFromRootCling()) // rootcling is single thread (this save some space in the rootpcm).
3702 fEnums = new TListOfEnums(this);
3703 else
3704 fEnums = new TListOfEnumsWithLock(this);
3705 return fEnums;
3706 }
3707
3709 if (fEnums.load()) {
3710 (*fEnums).Load();
3711 return fEnums.load();
3712 }
3713 if (fProperty == -1) Property();
3714 if ( (kIsClass | kIsStruct | kIsUnion) & fProperty) {
3715 // For this case, the list will be immutable
3716 temp = new TListOfEnums(this);
3717 } else {
3718 //namespaces can have enums added to them
3719 temp = new TListOfEnumsWithLock(this);
3720 }
3721 temp->Load();
3722 fEnums = temp;
3723 return temp;
3724}
3725
3726////////////////////////////////////////////////////////////////////////////////
3727/// Create the list containing the TDataMembers (of actual data members or members
3728/// pulled in through using declarations) of a class.
3729
3730TList *TClass::CreateListOfDataMembers(std::atomic<TListOfDataMembers*> &data, TDictionary::EMemberSelection selection, bool load)
3731{
3733
3734 if (!data) {
3736 // The members are in our ProtoClass; we don't need the class info.
3738 if (proto && proto->FillTClass(this))
3739 return data;
3740 }
3741
3742 data = new TListOfDataMembers(this, selection);
3743 }
3744 if (IsClassStructOrUnion()) {
3745 // If the we have a class or struct or union, the order
3746 // of data members is the list is essential since it determines their
3747 // order on file. So we must always load. Also, the list is fixed
3748 // since the language does not allow to add members.
3749 if (!(*data).IsLoaded())
3750 (*data).Load();
3751
3752 } else if (load) (*data).Load();
3753 return data;
3754}
3755
3756////////////////////////////////////////////////////////////////////////////////
3757/// Return list containing the TDataMembers of a class.
3758
3760{
3761 // Fast path, no lock? Classes load at creation time.
3762 if (IsClassStructOrUnion()) {
3763 auto data = fData.load();
3764 if (data && data->IsLoaded())
3765 return data;
3766 } else if (!load && fData)
3767 return fData;
3768
3770}
3771
3772////////////////////////////////////////////////////////////////////////////////
3773/// Return list containing the TDataMembers of using declarations of a class.
3774
3776{
3777 // Fast path, no lock? Classes load at creation time.
3778 if ((!load || IsClassStructOrUnion()) && fUsingData)
3779 return fUsingData;
3780
3782}
3783
3784////////////////////////////////////////////////////////////////////////////////
3785/// Return TListOfFunctionTemplates for a class.
3786
3788{
3790
3792 if (load) fFuncTemplate->Load();
3793 return fFuncTemplate;
3794}
3795
3796////////////////////////////////////////////////////////////////////////////////
3797/// Return list containing the TMethods of a class.
3798/// If load is true, the list is populated with all the defined function
3799/// and currently instantiated function template.
3800
3802{
3804
3805 if (!fMethod.load()) GetMethodList();
3806 if (load) {
3807 if (gDebug>0) Info("GetListOfMethods","Header Parsing - Asking for all the methods of class %s: this can involve parsing.",GetName());
3808 (*fMethod).Load();
3809 }
3810 return fMethod;
3811}
3812
3813////////////////////////////////////////////////////////////////////////////////
3814/// Return the collection of functions named "name".
3815
3817{
3818 return const_cast<TClass*>(this)->GetMethodList()->GetListForObject(name);
3819}
3820
3821
3822////////////////////////////////////////////////////////////////////////////////
3823/// Returns a list of all public methods of this class and its base classes.
3824/// Refers to a subset of the methods in GetListOfMethods() so don't do
3825/// GetListOfAllPublicMethods()->Delete().
3826/// Algorithm used to get the list is:
3827/// - put all methods of the class in the list (also protected and private
3828/// ones).
3829/// - loop over all base classes and add only those methods not already in the
3830/// list (also protected and private ones).
3831/// - once finished, loop over resulting list and remove all private and
3832/// protected methods.
3833
3835{
3837
3839 if (load) {
3840 if (gDebug>0) Info("GetListOfAllPublicMethods","Header Parsing - Asking for all the methods of class %s: this can involve parsing.",GetName());
3842 }
3843 return fAllPubMethod;
3844}
3845
3846////////////////////////////////////////////////////////////////////////////////
3847/// Returns a list of all public data members of this class and its base
3848/// classes. Refers to a subset of the data members in GetListOfDatamembers()
3849/// so don't do GetListOfAllPublicDataMembers()->Delete().
3850
3852{
3854
3856 if (load) fAllPubData->Load();
3857 return fAllPubData;
3858}
3859
3860////////////////////////////////////////////////////////////////////////////////
3861/// Returns list of methods accessible by context menu.
3862
3864{
3865 if (!HasInterpreterInfo()) return;
3866
3867 // get the base class
3868 TIter nextBase(GetListOfBases(), kIterBackward);
3869 TBaseClass *baseClass;
3870 while ((baseClass = (TBaseClass *) nextBase())) {
3871 TClass *base = baseClass->GetClassPointer();
3872 if (base) base->GetMenuItems(list);
3873 }
3874
3875 // remove methods redefined in this class with no menu
3876 TMethod *method, *m;
3878 while ((method = (TMethod*)next())) {
3879 m = (TMethod*)list->FindObject(method->GetName());
3880 if (method->IsMenuItem() != kMenuNoMenu) {
3881 if (!m)
3882 list->AddFirst(method);
3883 } else {
3884 if (m && m->GetNargs() == method->GetNargs())
3885 list->Remove(m);
3886 }
3887 }
3888}
3889
3890////////////////////////////////////////////////////////////////////////////////
3891/// Check whether a class has a dictionary or not.
3892/// This is equivalent to ask if a class is coming from a bootstrapping
3893/// procedure initiated during the loading of a library.
3894
3896{
3897 return IsLoaded();
3898}
3899
3900////////////////////////////////////////////////////////////////////////////////
3901/// Check whether a class has a dictionary or ROOT can load one.
3902/// This is equivalent to ask HasDictionary() or whether a library is known
3903/// where it can be loaded from, or whether a Dictionary function is
3904/// available because the class's dictionary library was already loaded.
3905
3907{
3908 if (TClass* cl = (TClass*)gROOT->GetListOfClasses()->FindObject(clname))
3909 return cl->IsLoaded();
3910 return gClassTable->GetDict(clname) || gInterpreter->GetClassSharedLibs(clname);
3911}
3912
3913////////////////////////////////////////////////////////////////////////////////
3914/// Verify the base classes always.
3915
3917{
3918 TList* lb = GetListOfBases();
3919 if (!lb) return;
3920 TIter nextBase(lb);
3921 TBaseClass* base = nullptr;
3922 while ((base = (TBaseClass*)nextBase())) {
3923 TClass* baseCl = base->GetClassPointer();
3924 if (baseCl) {
3925 baseCl->GetMissingDictionariesWithRecursionCheck(result, visited, recurse);
3926 }
3927 }
3928}
3929
3930////////////////////////////////////////////////////////////////////////////////
3931/// Verify the Data Members.
3932
3934{
3936 if (!ldm) return ;
3937 TIter nextMemb(ldm);
3938 TDataMember * dm = nullptr;
3939 while ((dm = (TDataMember*)nextMemb())) {
3940 // If it is a transient
3941 if(!dm->IsPersistent()) {
3942 continue;
3943 }
3944 if (dm->Property() & kIsStatic) {
3945 continue;
3946 }
3947 // If it is a built-in data type.
3948 TClass* dmTClass = nullptr;
3949 if (dm->GetDataType()) {
3950 // We have a basic datatype.
3951 dmTClass = nullptr;
3952 // Otherwise get the string representing the type.
3953 } else if (dm->GetTypeName()) {
3954 dmTClass = TClass::GetClass(dm->GetTypeName());
3955 }
3956 if (dmTClass) {
3957 dmTClass->GetMissingDictionariesWithRecursionCheck(result, visited, recurse);
3958 }
3959 }
3960}
3961
3963{
3964 // Pair is a special case and we have to check its elements for missing dictionaries
3965 // Pair is a transparent container so we should always look at its.
3966
3968 for (int i = 0; i < 2; i++) {
3969 TClass* pairElement = ((TStreamerElement*)SI->GetElements()->At(i))->GetClass();
3970 if (pairElement) {
3971 pairElement->GetMissingDictionariesWithRecursionCheck(result, visited, recurse);
3972 }
3973 }
3974}
3975
3976////////////////////////////////////////////////////////////////////////////////
3977/// From the second level of recursion onwards it is different state check.
3978
3980{
3981 if (result.FindObject(this) || visited.FindObject(this)) return;
3982
3983 static TClassRef sCIString("string");
3984 if (this == sCIString) return;
3985
3986 TClassEdit::TSplitType splitType(fName);
3987 if (splitType.IsTemplate()) {
3988 // We now treat special cases:
3989 // - pair
3990 // - unique_ptr
3991 // - array
3992 // - tuple
3993
3994 // Small helper to get the TClass instance from a classname and recursively
3995 // investigate it
3996 auto checkDicts = [&](const string &clName){
3997 auto cl = TClass::GetClass(clName.c_str());
3998 if (!cl) {
3999 // We try to remove * and const from the type name if any
4000 const auto clNameShortType = TClassEdit::ShortType(clName.c_str(), 1);
4001 cl = TClass::GetClass(clNameShortType.c_str());
4002 }
4003 if (cl && !cl->HasDictionary()) {
4004 cl->GetMissingDictionariesWithRecursionCheck(result, visited, recurse);
4005 }
4006 };
4007
4008 const auto &elements = splitType.fElements;
4009 const auto &templName = elements[0];
4010
4011 // Special treatment for pair.
4012 if (templName == "pair") {
4014 return;
4015 }
4016
4017 // Special treatment of unique_ptr or array
4018 // They are treated together since they have 1 single template argument
4019 // which is interesting when checking for missing dictionaries.
4020 if (templName == "unique_ptr" || templName == "array") {
4021 checkDicts(elements[1]);
4022 return;
4023 }
4024
4025 // Special treatment of tuple
4026 // This type must be treated separately since it can have N template
4027 // arguments which are interesting, unlike unique_ptr or array.
4028 if (templName == "tuple") {
4029 // -1 because the elements end with a list of the "stars", i.e. number of
4030 // * after the type name
4031 const auto nTemplArgs = elements.size() - 1;
4032 // loop starts at 1 because the first element is the template name
4033 for (auto iTemplArg = 1U; iTemplArg < nTemplArgs; ++iTemplArg) {
4034 checkDicts(elements[iTemplArg]);
4035 }
4036 return;
4037 }
4038 } // this is not a template
4039
4040 if (!HasDictionary()) {
4041 result.Add(this);
4042 }
4043
4044 visited.Add(this);
4045 //Check whether a custom streamer
4047 if (GetCollectionProxy()) {
4048 // We need to look at the collection's content
4049 // The collection has different kind of elements the check would be required.
4050 TClass* t = nullptr;
4051 if ((t = GetCollectionProxy()->GetValueClass())) {
4052 if (!t->HasDictionary()) {
4054 }
4055 }
4056 } else {
4057 if (recurse) {
4058 GetMissingDictionariesForMembers(result, visited, recurse);
4059 }
4061 }
4062 }
4063}
4064
4065////////////////////////////////////////////////////////////////////////////////
4066/// Get the classes that have a missing dictionary starting from this one.
4067/// - With recurse = false the classes checked for missing dictionaries are:
4068/// the class itself, all base classes, direct data members,
4069/// and for collection proxies the container's
4070/// elements without iterating over the element's data members;
4071/// - With recurse = true the classes checked for missing dictionaries are:
4072/// the class itself, all base classes, recursing on the data members,
4073/// and for the collection proxies recursion on the elements of the
4074/// collection and iterating over the element's data members.
4075
4077{
4078 // Top level recursion it different from the following levels of recursion.
4079
4080 if (result.FindObject(this)) return;
4081
4082 static TClassRef sCIString("string");
4083 if (this == sCIString) return;
4084
4085 THashTable visited;
4086
4089 return;
4090 }
4091
4092 if (strncmp(fName, "unique_ptr<", 11) == 0 || strncmp(fName, "array<", 6) == 0 || strncmp(fName, "tuple<", 6) == 0) {
4094 return;
4095 }
4096
4097 if (!HasDictionary()) {
4098 result.Add(this);
4099 }
4100
4101 visited.Add(this);
4102
4103 //Check whether a custom streamer
4105 if (GetCollectionProxy()) {
4106 // We need to look at the collection's content
4107 // The collection has different kind of elements the check would be required.
4108 TClass* t = nullptr;
4109 if ((t = GetCollectionProxy()->GetValueClass())) {
4110 if (!t->HasDictionary()) {
4112 }
4113 }
4114 } else {
4115 GetMissingDictionariesForMembers(result, visited, recurse);
4117 }
4118 }
4119}
4120
4121////////////////////////////////////////////////////////////////////////////////
4122/// Return kTRUE if the class has elements.
4123
4124Bool_t TClass::IsFolder(void *obj) const
4125{
4126 return Browse(obj,(TBrowser*)nullptr);
4127}
4128
4129//______________________________________________________________________________
4130//______________________________________________________________________________
4131void TClass::ReplaceWith(TClass *newcl) const
4132{
4133 // Inform the other objects to replace this object by the new TClass (newcl)
4134
4136 //we must update the class pointers pointing to 'this' in all TStreamerElements
4137 TIter nextClass(gROOT->GetListOfClasses());
4138 TClass *acl;
4140
4141 // Since we are in the process of replacing a TClass by a TClass
4142 // coming from a dictionary, there is no point in loading any
4143 // libraries during this search.
4145 while ((acl = (TClass*)nextClass())) {
4146 if (acl == newcl) continue;
4147
4148 TIter nextInfo(acl->GetStreamerInfos());
4149 while ((info = (TVirtualStreamerInfo*)nextInfo())) {
4150
4151 info->Update(this, newcl);
4152 }
4153 }
4154
4155 gInterpreter->UnRegisterTClassUpdate(this);
4156}
4157
4158////////////////////////////////////////////////////////////////////////////////
4159/// Make sure that the current ClassInfo is up to date.
4160
4162{
4163 Warning("ResetClassInfo(Long_t tagnum)","Call to deprecated interface (does nothing)");
4164}
4165
4166////////////////////////////////////////////////////////////////////////////////
4167/// Make sure that the current ClassInfo is up to date.
4168
4170{
4172
4174
4175 if (fClassInfo) {
4177 gInterpreter->ClassInfo_Delete(fClassInfo);
4178 fClassInfo = nullptr;
4179 }
4180 // We can not check at this point whether after the unload there will
4181 // still be interpreter information about this class (as v5 was doing),
4182 // instead this function must only be called if the definition is (about)
4183 // to be unloaded.
4184
4185 ResetCaches();
4186
4187 // We got here because the definition Decl is about to be unloaded.
4189 if (fStreamerInfo->GetEntries() != 0) {
4191 } else {
4193 }
4194 } else {
4195 // if the ClassInfo was loaded for a class with a TClass Init and it
4196 // gets unloaded, should we guess it can be reloaded?
4198 }
4199}
4200
4201////////////////////////////////////////////////////////////////////////////////
4202/// To clean out all caches.
4203
4205{
4206 R__ASSERT(!TestBit(kLoading) && "Resetting the caches does not make sense during loading!" );
4207
4208 // Not owning lists, don't call Delete(), but unload
4209 if (fData.load())
4210 (*fData).Unload();
4211 if (fUsingData.load())
4212 (*fUsingData).Unload();
4213 if (fEnums.load())
4214 (*fEnums).Unload();
4215 if (fMethod.load())
4216 (*fMethod).Unload();
4217
4218 delete fAllPubData; fAllPubData = nullptr;
4219
4220 if (fBase.load())
4221 (*fBase).Delete();
4222 delete fBase.load(); fBase = nullptr;
4223
4224 if (fRealData)
4225 fRealData->Delete();
4226 delete fRealData; fRealData=nullptr;
4227}
4228
4229////////////////////////////////////////////////////////////////////////////////
4230/// Resets the menu list to it's standard value.
4231
4233{
4234 if (fClassMenuList)
4236 else
4237 fClassMenuList = new TList();
4239}
4240
4241////////////////////////////////////////////////////////////////////////////////
4242/// The ls function lists the contents of a class on stdout. Ls output
4243/// is typically much less verbose then Dump().
4244/// If options contains 'streamerinfo', run ls on the list of streamerInfos
4245/// and the list of conversion streamerInfos.
4246
4247void TClass::ls(Option_t *options) const
4248{
4249 TNamed::ls(options);
4250 if (options==nullptr || options[0]==0) return;
4251
4252 if (strstr(options,"streamerinfo")!=nullptr) {
4253 GetStreamerInfos()->ls(options);
4254
4255 if (fConversionStreamerInfo.load()) {
4256 std::map<std::string, TObjArray*>::iterator it;
4257 std::map<std::string, TObjArray*>::iterator end = (*fConversionStreamerInfo).end();
4258 for( it = (*fConversionStreamerInfo).begin(); it != end; ++it ) {
4259 it->second->ls(options);
4260 }
4261 }
4262 }
4263}
4264
4265////////////////////////////////////////////////////////////////////////////////
4266/// Makes a customizable version of the popup menu list, i.e. makes a list
4267/// of TClassMenuItem objects of methods accessible by context menu.
4268/// The standard (and different) way consists in having just one element
4269/// in this list, corresponding to the whole standard list.
4270/// Once the customizable version is done, one can remove or add elements.
4271
4273{
4275 TClassMenuItem *menuItem;
4276
4277 // Make sure fClassMenuList is initialized and empty.
4278 GetMenuList()->Delete();
4279
4280 TList* methodList = new TList;
4281 GetMenuItems(methodList);
4282
4283 TMethod *method;
4284 TMethodArg *methodArg;
4285 TClass *classPtr = nullptr;
4286 TIter next(methodList);
4287
4288 while ((method = (TMethod*) next())) {
4289 // if go to a mother class method, add separator
4290 if (classPtr != method->GetClass()) {
4291 menuItem = new TClassMenuItem(TClassMenuItem::kPopupSeparator, this);
4292 fClassMenuList->AddLast(menuItem);
4293 classPtr = method->GetClass();
4294 }
4295 // Build the signature of the method
4296 TString sig;
4297 TList* margsList = method->GetListOfMethodArgs();
4298 TIter nextarg(margsList);
4299 while ((methodArg = (TMethodArg*)nextarg())) {
4300 sig = sig+","+methodArg->GetFullTypeName();
4301 }
4302 if (sig.Length()!=0) sig.Remove(0,1); // remove first comma
4304 method->GetName(), method->GetName(),nullptr,
4305 sig.Data(),-1,TClassMenuItem::kIsSelf);
4306 if (method->IsMenuItem() == kMenuToggle) menuItem->SetToggle();
4307 fClassMenuList->Add(menuItem);
4308 }
4309 delete methodList;
4310}
4311
4312////////////////////////////////////////////////////////////////////////////////
4313/// Register the fact that an object was moved from the memory location
4314/// 'arenaFrom' to the memory location 'arenaTo'.
4315
4316void TClass::Move(void *arenaFrom, void *arenaTo) const
4317{
4318 // If/when we have access to a copy constructor (or better to a move
4319 // constructor), this function should also perform the data move.
4320 // For now we just information the repository.
4321
4322 if ((GetState() <= kEmulated) && !fCollectionProxy) {
4323 MoveAddressInRepository("TClass::Move",arenaFrom,arenaTo,this);
4324 }
4325}
4326
4327////////////////////////////////////////////////////////////////////////////////
4328/// Return the list of menu items associated with the class.
4329
4331 if (!fClassMenuList) {
4332 fClassMenuList = new TList();
4334 }
4335 return fClassMenuList;
4336}
4337
4338////////////////////////////////////////////////////////////////////////////////
4339/// Return (create an empty one if needed) the list of functions.
4340/// The major difference with GetListOfMethod is that this returns
4341/// the internal type of fMethod and thus can not be made public.
4342/// It also never 'loads' the content of the list.
4343
4345{
4346 if (!fMethod.load()) {
4347 std::unique_ptr<TListOfFunctions> temp{ new TListOfFunctions(this) };
4348 TListOfFunctions* expected = nullptr;
4349 if(fMethod.compare_exchange_strong(expected, temp.get()) ) {
4350 temp.release();
4351 }
4352 }
4353 return fMethod;
4354}
4355
4356
4357////////////////////////////////////////////////////////////////////////////////
4358/// Return pointer to method without looking at parameters.
4359/// Does not look in (possible) base classes.
4360/// Has the side effect of loading all the TMethod object in the list
4361/// of the class.
4362
4363TMethod *TClass::GetMethodAny(const char *method)
4364{
4365 if (!HasInterpreterInfo()) return nullptr;
4366 return (TMethod*) GetMethodList()->FindObject(method);
4367}
4368
4369////////////////////////////////////////////////////////////////////////////////
4370/// Return pointer to method without looking at parameters.
4371/// Does look in all base classes.
4372
4374{
4375 if (!HasInterpreterInfo()) return nullptr;
4376
4377 TMethod* m = GetMethodAny(method);
4378 if (m) return m;
4379
4380 TBaseClass *base;
4381 TIter nextb(GetListOfBases());
4382 while ((base = (TBaseClass *) nextb())) {
4383 TClass *c = base->GetClassPointer();
4384 if (c) {
4385 m = c->GetMethodAllAny(method);
4386 if (m) return m;
4387 }
4388 }
4389
4390 return nullptr;
4391}
4392
4393////////////////////////////////////////////////////////////////////////////////
4394/// Find the best method (if there is one) matching the parameters.
4395/// The params string must contain argument values, like "3189, \"aap\", 1.3".
4396/// The function invokes GetClassMethod to search for a possible method
4397/// in the class itself or in its base classes. Returns 0 in case method
4398/// is not found.
4399
4400TMethod *TClass::GetMethod(const char *method, const char *params,
4401 Bool_t objectIsConst /* = kFALSE */)
4402{
4404 if (!fClassInfo) return nullptr;
4405
4406 if (!gInterpreter)
4407 Fatal("GetMethod", "gInterpreter not initialized");
4408
4409 TInterpreter::DeclId_t decl = gInterpreter->GetFunctionWithValues(fClassInfo,
4410 method, params,
4411 objectIsConst);
4412
4413 if (!decl) return nullptr;
4414
4415 // search recursively in this class or its base classes
4417 if (f) return f;
4418
4419 Error("GetMethod",
4420 "\nDid not find matching TMethod <%s> with \"%s\" %sfor %s",
4421 method,params,objectIsConst ? "const " : "", GetName());
4422 return nullptr;
4423}
4424
4425
4426////////////////////////////////////////////////////////////////////////////////
4427/// Find a method with decl id in this class or its bases.
4428
4430 if (TFunction* method = GetMethodList()->Get(declId))
4431 return static_cast<TMethod *>(method);
4432
4433 for (auto item : *GetListOfBases())
4434 if (auto base = static_cast<TBaseClass *>(item)->GetClassPointer())
4435 if (TFunction* method = base->FindClassOrBaseMethodWithId(declId))
4436 return static_cast<TMethod *>(method);
4437
4438 return nullptr;
4439}
4440
4441////////////////////////////////////////////////////////////////////////////////
4442/// Find the method with a given prototype. The proto string must be of the
4443/// form: "char*,int,double". Returns 0 in case method is not found.
4444
4445TMethod *TClass::GetMethodWithPrototype(const char *method, const char *proto,
4446 Bool_t objectIsConst /* = kFALSE */,
4447 ROOT::EFunctionMatchMode mode /* = ROOT::kConversionMatch */)
4448{
4450 if (!fClassInfo) return nullptr;
4451
4452 if (!gInterpreter)
4453 Fatal("GetMethodWithPrototype", "gInterpreter not initialized");
4454
4455 TInterpreter::DeclId_t decl = gInterpreter->GetFunctionWithPrototype(fClassInfo,
4456 method, proto,
4457 objectIsConst, mode);
4458
4459 if (!decl) return nullptr;
4461 if (f) return f;
4462 Error("GetMethodWithPrototype",
4463 "\nDid not find matching TMethod <%s> with \"%s\" %sfor %s",
4464 method,proto,objectIsConst ? "const " : "", GetName());
4465 return nullptr;
4466}
4467
4468////////////////////////////////////////////////////////////////////////////////
4469/// Look for a method in this class that has the interface function
4470/// address faddr.
4471
4473{
4474 if (!HasInterpreterInfo()) return nullptr;
4475
4476 TMethod *m;
4477 TIter next(GetListOfMethods());
4478 while ((m = (TMethod *) next())) {
4479 if (faddr == (Longptr_t)m->InterfaceMethod())
4480 return m;
4481 }
4482 return nullptr;
4483}
4484
4485////////////////////////////////////////////////////////////////////////////////
4486/// Look for a method in this class that has the name and matches the parameters.
4487/// The params string must contain argument values, like "3189, \"aap\", 1.3".
4488/// Returns 0 in case method is not found.
4489/// See TClass::GetMethod to also search the base classes.
4490
4491TMethod *TClass::GetClassMethod(const char *name, const char* params,
4492 Bool_t objectIsConst /* = kFALSE */)
4493{
4495 if (!fClassInfo) return nullptr;
4496
4497 if (!gInterpreter)
4498 Fatal("GetClassMethod", "gInterpreter not initialized");
4499
4500 TInterpreter::DeclId_t decl = gInterpreter->GetFunctionWithValues(fClassInfo,
4501 name, params,
4502 objectIsConst);
4503
4504 if (!decl) return nullptr;
4505
4506 TFunction *f = GetMethodList()->Get(decl);
4507
4508 return (TMethod*)f; // Could be zero if the decl is actually in a base class.
4509}
4510
4511////////////////////////////////////////////////////////////////////////////////
4512/// Find the method with a given prototype. The proto string must be of the
4513/// form: "char*,int,double". Returns 0 in case method is not found.
4514/// See TClass::GetMethodWithPrototype to also search the base classes.
4515
4517 Bool_t objectIsConst /* = kFALSE */,
4518 ROOT::EFunctionMatchMode mode /* = ROOT::kConversionMatch */)
4519{
4521 if (!fClassInfo) return nullptr;
4522
4523 if (!gInterpreter)
4524 Fatal("GetClassMethodWithPrototype", "gInterpreter not initialized");
4525
4526 TInterpreter::DeclId_t decl = gInterpreter->GetFunctionWithPrototype(fClassInfo,
4527 name, proto,
4528 objectIsConst,
4529 mode);
4530
4531 if (!decl) return nullptr;
4532
4533 TFunction *f = GetMethodList()->Get(decl);
4534
4535 return (TMethod*)f; // Could be zero if the decl is actually in a base class.
4536}
4537
4538////////////////////////////////////////////////////////////////////////////////
4539/// Return the number of data members of this class
4540/// Note that in case the list of data members is not yet created, it will be done
4541/// by GetListOfDataMembers().
4542
4544{
4545 if (!HasDataMemberInfo()) return 0;
4546
4548 if (lm)
4549 return lm->GetSize();
4550 else
4551 return 0;
4552}
4553
4554////////////////////////////////////////////////////////////////////////////////
4555/// Return the number of methods of this class
4556/// Note that in case the list of methods is not yet created, it will be done
4557/// by GetListOfMethods().
4558/// This will also load/populate the list of methods, to get 'just' the
4559/// number of currently loaded methods use:
4560/// cl->GetListOfMethods(false)->GetSize();
4561
4563{
4564 if (!HasInterpreterInfo()) return 0;
4565
4566 TList *lm = GetListOfMethods();
4567 if (lm)
4568 return lm->GetSize();
4569 else
4570 return 0;
4571}
4572
4573////////////////////////////////////////////////////////////////////////////////
4574/// returns a pointer to the TVirtualStreamerInfo object for version
4575/// If the object does not exist, it is created
4576///
4577/// Note: There are two special version numbers:
4578///
4579/// - 0: Use the class version from the currently loaded class library.
4580/// - -1: Assume no class library loaded (emulated class).
4581///
4582/// Warning: If we create a new streamer info, whether or not the build
4583/// optimizes is controlled externally to us by a global variable!
4584/// Don't call us unless you have set that variable properly
4585/// with TStreamer::Optimize()!
4586///
4587
4588TVirtualStreamerInfo* TClass::GetStreamerInfo(Int_t version /* = 0 */, Bool_t isTransient /* = false */) const
4589{
4591
4592 // Version 0 is special, it means the currently loaded version.
4593 // We need to set it at the beginning to be able to guess it correctly.
4594
4595 if (version == 0)
4596 version = fClassVersion;
4597
4598 // If the StreamerInfo is assigned to the fLastReadInfo, we are
4599 // guaranteed it was built and compiled.
4600 if (sinfo && sinfo->GetClassVersion() == version)
4601 return sinfo;
4602
4603 // Note that the access to fClassVersion above is technically not thread-safe with a low probably of problems.
4604 // fClassVersion is not an atomic and is modified TClass::SetClassVersion (called from RootClassVersion via
4605 // ROOT::ResetClassVersion) and is 'somewhat' protected by the atomic fVersionUsed.
4606 // However, direct access to fClassVersion should be replaced by calls to GetClassVersion to set fVersionUsed.
4607 // Even with such a change the code here and in these functions need to be reviewed as a cursory look seem
4608 // to indicates they are not yet properly protection against mutli-thread access.
4609 //
4610 // However, the use of these functions is rare and mostly done at library loading time which should
4611 // in almost all cases preceeds the possibility of GetStreamerInfo being called from multiple thread
4612 // on that same TClass object.
4613 //
4614 // Summary: need careful review but risk of problem is extremely low.
4615
4617
4618 return GetStreamerInfoImpl(version, isTransient);
4619};
4620
4621// Implementation of/for TStreamerInfo::GetStreamerInfo.
4622// This routine assumes the global lock has been taken.
4624{
4625 // Warning: version may be -1 for an emulated class, or -2 if the
4626 // user requested the emulated streamerInfo for an abstract
4627 // base class, even though we have a dictionary for it.
4628
4629 if ((version < -1) || (version >= (fStreamerInfo->GetSize()-1))) {
4630 Error("GetStreamerInfo", "class: %s, attempting to access a wrong version: %d", GetName(), version);
4631 // FIXME: Shouldn't we go to -1 here, or better just abort?
4632 version = fClassVersion;
4633 }
4634
4636
4637 if (!sinfo && (version != fClassVersion)) {
4638 // When the requested version does not exist we return
4639 // the TVirtualStreamerInfo for the currently loaded class version.
4640 // FIXME: This arguably makes no sense, we should warn and return nothing instead.
4641 // Note: This is done for STL collections
4642 // Note: fClassVersion could be -1 here (for an emulated class).
4643 // This is also the code path take for unversioned classes.
4645 }
4646
4647 if (!sinfo) {
4648 // We just were not able to find a streamer info, we have to make a new one.
4649 TMmallocDescTemp setreset;
4650 sinfo = TVirtualStreamerInfo::Factory()->NewInfo(const_cast<TClass*>(this));
4652 if (gDebug > 0) {
4653 printf("Creating StreamerInfo for class: %s, version: %d\n", GetName(), fClassVersion);
4654 }
4656 // If we do not have a StreamerInfo for this version and we do not
4657 // have dictionary information nor a proxy, there is nothing to build!
4658 sinfo->Build(silent);
4659 }
4660 } else {
4661 if (!sinfo->IsCompiled()) {
4662 // Streamer info has not been compiled, but exists.
4663 // Therefore it was read in from a file and we have to do schema evolution?
4664 // Or it didn't have a dictionary before, but does now?
4665 sinfo->BuildOld();
4666 }
4667 }
4668
4669 // Cache the current info if we now have it.
4670 if (version == fClassVersion)
4671 fCurrentInfo = sinfo;
4672
4673 // If the compilation succeeded, remember this StreamerInfo.
4674 if (sinfo->IsCompiled())
4675 fLastReadInfo = sinfo;
4676
4677 return sinfo;
4678}
4679
4680////////////////////////////////////////////////////////////////////////////////
4681/// For the case where the requestor class is emulated and this class is abstract,
4682/// returns a pointer to the TVirtualStreamerInfo object for version with an emulated
4683/// representation whether or not the class is loaded.
4684///
4685/// If the object does not exist, it is created
4686///
4687/// Note: There are two special version numbers:
4688///
4689/// - 0: Use the class version from the currently loaded class library.
4690/// - -1: Assume no class library loaded (emulated class).
4691///
4692/// Warning: If we create a new streamer info, whether or not the build
4693/// optimizes is controlled externally to us by a global variable!
4694/// Don't call us unless you have set that variable properly
4695/// with TStreamer::Optimize()!
4696///
4697
4699{
4700 TVirtualStreamerInfo *sinfo = nullptr;
4701
4702 TString newname(GetName());
4703 newname += "@@emulated";
4704
4706
4707 TClass *emulated = TClass::GetClass(newname);
4708
4709 if (emulated)
4710 sinfo = emulated->GetStreamerInfo(version);
4711
4712 if (!sinfo) {
4713 // The emulated version of the streamerInfo is explicitly requested and has
4714 // not been built yet.
4715
4716 sinfo = (TVirtualStreamerInfo*) fStreamerInfo->At(version);
4717
4718 if (!sinfo && (version != fClassVersion)) {
4719 // When the requested version does not exist we return
4720 // the TVirtualStreamerInfo for the currently loaded class version.
4721 // FIXME: This arguably makes no sense, we should warn and return nothing instead.
4723 }
4724
4725 if (!sinfo) {
4726 // Let's take the first available StreamerInfo as a start
4727 Int_t ninfos = fStreamerInfo->GetEntriesFast() - 1;
4728 for (Int_t i = -1; sinfo == nullptr && i < ninfos; ++i)
4730 }
4731
4732 if (sinfo) {
4733 sinfo = dynamic_cast<TVirtualStreamerInfo *>(sinfo->Clone());
4734 if (sinfo) {
4735 sinfo->SetClass(nullptr);
4736 sinfo->SetName(newname);
4737 sinfo->BuildCheck();
4738 sinfo->BuildOld();
4739 sinfo->GetClass()->AddRule(TString::Format("sourceClass=%s targetClass=%s",GetName(),newname.Data()));
4740 } else {
4741 Error("GetStreamerInfoAbstractEmulated", "could not create TVirtualStreamerInfo");
4742 }
4743 }
4744 }
4745 return sinfo;
4746}
4747
4748////////////////////////////////////////////////////////////////////////////////
4749/// For the case where the requestor class is emulated and this class is abstract,
4750/// returns a pointer to the TVirtualStreamerInfo object for version with an emulated
4751/// representation whether or not the class is loaded.
4752///
4753/// If the object does not exist, it is created
4754///
4755/// Warning: If we create a new streamer info, whether or not the build
4756/// optimizes is controlled externally to us by a global variable!
4757/// Don't call us unless you have set that variable properly
4758/// with TStreamer::Optimize()!
4759///
4760
4762{
4763 TVirtualStreamerInfo *sinfo = nullptr;
4764
4765 TString newname(GetName());
4766 newname += "@@emulated";
4767
4769
4770 TClass *emulated = TClass::GetClass(newname);
4771
4772 if (emulated)
4773 sinfo = emulated->FindStreamerInfo(checksum);
4774
4775 if (!sinfo) {
4776 // The emulated version of the streamerInfo is explicitly requested and has
4777 // not been built yet.
4778
4779 sinfo = (TVirtualStreamerInfo*) FindStreamerInfo(checksum);
4780
4781 if (!sinfo && (checksum != fCheckSum)) {
4782 // When the requested version does not exist we return
4783 // the TVirtualStreamerInfo for the currently loaded class version.
4784 // FIXME: This arguably makes no sense, we should warn and return nothing instead.
4786 }
4787
4788 if (!sinfo) {
4789 // Let's take the first available StreamerInfo as a start
4790 Int_t ninfos = fStreamerInfo->GetEntriesFast() - 1;
4791 for (Int_t i = -1; sinfo == nullptr && i < ninfos; ++i)
4793 }
4794
4795 if (sinfo) {
4796 sinfo = dynamic_cast<TVirtualStreamerInfo*>( sinfo->Clone() );
4797 if (sinfo) {
4798 sinfo->SetClass(nullptr);
4799 sinfo->SetName( newname );
4800 sinfo->BuildCheck();
4801 sinfo->BuildOld();
4802 sinfo->GetClass()->AddRule(TString::Format("sourceClass=%s targetClass=%s",GetName(),newname.Data()));
4803 } else {
4804 Error("GetStreamerInfoAbstractEmulated", "could not create TVirtualStreamerInfo");
4805 }
4806 }
4807 }
4808 return sinfo;
4809}
4810
4811////////////////////////////////////////////////////////////////////////////////
4812/// When the class kIgnoreTObjectStreamer bit is set, the automatically
4813/// generated Streamer will not call TObject::Streamer.
4814/// This option saves the TObject space overhead on the file.
4815/// However, the information (fBits, fUniqueID) of TObject is lost.
4816///
4817/// Note that to be effective for objects streamed object-wise this function
4818/// must be called for the class deriving directly from TObject, eg, assuming
4819/// that BigTrack derives from Track and Track derives from TObject, one must do:
4820/// ~~~ {.cpp}
4821/// Track::Class()->IgnoreTObjectStreamer();
4822/// ~~~
4823/// and not:
4824/// ~~~ {.cpp}
4825/// BigTrack::Class()->IgnoreTObjectStreamer();
4826/// ~~~
4827/// To be effective for object streamed member-wise or split in a TTree,
4828/// this function must be called for the most derived class (i.e. BigTrack).
4829
4831{
4832 // We need to tak the lock since we are test and then setting fBits
4833 // and TStreamerInfo::fBits (and the StreamerInfo state in general)
4834 // which can also be modified by another thread.
4836
4837 if ( doIgnore && TestBit(kIgnoreTObjectStreamer)) return;
4838 if (!doIgnore && !TestBit(kIgnoreTObjectStreamer)) return;
4840 if (sinfo) {
4841 if (sinfo->IsCompiled()) {
4842 // -- Warn the user that what they are doing cannot work.
4843 // Note: The reason is that TVirtualStreamerInfo::Build() examines
4844 // the kIgnoreTObjectStreamer bit and sets the TStreamerElement
4845 // type for the TObject base class streamer element it creates
4846 // to -1 as a flag. Later on the TStreamerInfo::Compile()
4847 // member function sees the flag and does not insert the base
4848 // class element into the compiled streamer info. None of this
4849 // machinery works correctly if we are called after the streamer
4850 // info has already been built and compiled.
4851 Error("IgnoreTObjectStreamer","Must be called before the creation of StreamerInfo");
4852 return;
4853 }
4854 }
4855 if (doIgnore) SetBit (kIgnoreTObjectStreamer);
4857}
4858
4859////////////////////////////////////////////////////////////////////////////////
4860/// Return kTRUE if this class inherits from a class with name "classname".
4861/// note that the function returns kTRUE in case classname is the class itself
4862
4863Bool_t TClass::InheritsFrom(const char *classname) const
4864{
4865 if (strcmp(GetName(), classname) == 0) return kTRUE;
4866
4867 return InheritsFrom(TClass::GetClass(classname,kTRUE,kTRUE));
4868}
4869
4870////////////////////////////////////////////////////////////////////////////////
4871/// Return kTRUE if this class inherits from class cl.
4872/// note that the function returns KTRUE in case cl is the class itself
4873
4875{
4876 if (!cl) return kFALSE;
4877 if (cl == this) return kTRUE;
4878
4879 if (!HasDataMemberInfo()) {
4880 TVirtualStreamerInfo *sinfo = ((TClass *)this)->GetCurrentStreamerInfo();
4881 if (sinfo==nullptr) sinfo = GetStreamerInfo();
4882 TIter next(sinfo->GetElements());
4883 TStreamerElement *element;
4884 while ((element = (TStreamerElement*)next())) {
4885 if (element->IsA() == TStreamerBase::Class()) {
4886 TClass *clbase = element->GetClassPointer();
4887 if (!clbase) return kFALSE; //missing class
4888 if (clbase->InheritsFrom(cl)) return kTRUE;
4889 }
4890 }
4891 return kFALSE;
4892 }
4893 // cast const away (only for member fBase which can be set in GetListOfBases())
4894 if (((TClass *)this)->GetBaseClass(cl)) return kTRUE;
4895 return kFALSE;
4896}
4897
4898////////////////////////////////////////////////////////////////////////////////
4899/// Cast obj of this class type up to baseclass cl if up is true.
4900/// Cast obj of this class type down from baseclass cl if up is false.
4901/// If this class is not a baseclass of cl return 0, else the pointer
4902/// to the cl part of this (up) or to this (down).
4903
4904void *TClass::DynamicCast(const TClass *cl, void *obj, Bool_t up)
4905{
4906 if (cl == this) return obj;
4907
4908 if (!HasDataMemberInfo()) return nullptr;
4909
4910 Int_t off;
4911 if ((off = GetBaseClassOffset(cl, obj)) != -1) {
4912 if (up)
4913 return (void*)((Longptr_t)obj+off);
4914 else
4915 return (void*)((Longptr_t)obj-off);
4916 }
4917 return nullptr;
4918}
4919
4920////////////////////////////////////////////////////////////////////////////////
4921/// Cast obj of this class type up to baseclass cl if up is true.
4922/// Cast obj of this class type down from baseclass cl if up is false.
4923/// If this class is not a baseclass of cl return 0, else the pointer
4924/// to the cl part of this (up) or to this (down).
4925
4926const void *TClass::DynamicCast(const TClass *cl, const void *obj, Bool_t up)
4927{
4928 return DynamicCast(cl,const_cast<void*>(obj),up);
4929}
4930
4931////////////////////////////////////////////////////////////////////////////////
4932/// Return a pointer to a newly allocated object of this class.
4933/// The class must have a default constructor. For meaning of
4934/// defConstructor, see TClass::IsCallingNew().
4935///
4936/// If quiet is true, do no issue a message via Error on case
4937/// of problems, just return 0.
4938///
4939/// The constructor actually called here can be customized by
4940/// using the rootcint pragma:
4941/// ~~~ {.cpp}
4942/// #pragma link C++ ioctortype UserClass;
4943/// ~~~
4944/// For example, with this pragma and a class named MyClass,
4945/// this method will called the first of the following 3
4946/// constructors which exists and is public:
4947/// ~~~ {.cpp}
4948/// MyClass(UserClass*);
4949/// MyClass(TRootIOCtor*);
4950/// MyClass(); // Or a constructor with all its arguments defaulted.
4951/// ~~~
4952///
4953/// When more than one pragma ioctortype is used, the first seen as priority
4954/// For example with:
4955/// ~~~ {.cpp}
4956/// #pragma link C++ ioctortype UserClass1;
4957/// #pragma link C++ ioctortype UserClass2;
4958/// ~~~
4959/// We look in the following order:
4960/// ~~~ {.cpp}
4961/// MyClass(UserClass1*);
4962/// MyClass(UserClass2*);
4963/// MyClass(TRootIOCtor*);
4964/// MyClass(); // Or a constructor with all its arguments defaulted.
4965/// ~~~
4966
4967void *TClass::New(ENewType defConstructor, Bool_t quiet) const
4968{
4969 auto obj = NewObject(defConstructor, quiet);
4970 if (obj.GetPtr() && obj.GetAllocator()) {
4971 // Register the object for special handling in the destructor.
4972 RegisterAddressInRepository("TClass::New", obj.GetPtr(), this);
4973 }
4974 return obj.GetPtr();
4975}
4976
4977// See TClass:New
4978// returns a TClass::ObjectPtr which remembers if the object was allocated
4979// via a TStreamerInfo.
4980
4982{
4983 ObjectPtr p;
4984
4985 if (fNew) {
4986 // We have the new operator wrapper function,
4987 // so there is a dictionary and it was generated
4988 // by rootcint, so there should be a default
4989 // constructor we can call through the wrapper.
4990 {
4991 TClass__GetCallingNewRAII callingNew(defConstructor);
4992 p = fNew(nullptr);
4993 }
4994 if (!p && !quiet) {
4995 //Error("New", "cannot create object of class %s version %d", GetName(), fClassVersion);
4996 Error("New", "cannot create object of class %s", GetName());
4997 }
4998 } else if (Ha