ROOT::TMetaUtils Namespace Reference

Namespaces
	AST2SourceTools
	propNames

Classes
class	AnnotatedRecordDecl
class	RConstructorType
class	TClingLookupHelper
class	TNormalizedCtxt

Typedefs
typedef void(*	CallWriteStreamer_t) (const AnnotatedRecordDecl &cl, const cling::Interpreter &interp, const TNormalizedCtxt &normCtxt, std::ostream &dictStream, bool isAutoStreamer)
typedef std::list< RConstructorType >	RConstructorTypes

Enumerations
enum	DataMemberInfo__ValidArrayIndex_error_code {   VALID, NOT_INT, NOT_DEF, IS_PRIVATE,   UNKNOWN }
enum	EIOCtorCategory : short { EIOCtorCategory::kAbsent, EIOCtorCategory::kDefault, EIOCtorCategory::kIOPtrType, EIOCtorCategory::kIORefType }

Functions
clang::QualType	AddDefaultParameters (clang::QualType instanceType, const cling::Interpreter &interpret, const TNormalizedCtxt &normCtxt)
	Add any unspecified template parameters to the class template instance, mentioned anywhere in the type. More...
bool	BeginsWith (const std::string &theString, const std::string &theSubstring)
EIOCtorCategory	CheckConstructor (const clang::CXXRecordDecl *, const RConstructorType &, const cling::Interpreter &interp)
bool	CheckPublicFuncWithProto (clang::CXXRecordDecl const *, char const *, char const *, const cling::Interpreter &, bool diagnose)
const clang::FunctionDecl *	ClassInfo__HasMethod (const clang::DeclContext *cl, char const *, const cling::Interpreter &interp)
void	CreateNameTypeMap (clang::CXXRecordDecl const &, std::map< std::string, ROOT::Internal::TSchemaType, std::less< std::string >, std::allocator< std::pair< std::string const, ROOT::Internal::TSchemaType > > > &)
llvm::StringRef	DataMemberInfo__ValidArrayIndex (const clang::DeclaratorDecl &m, int *errnum=0, llvm::StringRef *errstr=0)
	ValidArrayIndex return a static string (so use it or copy it immediatly, do not call GrabIndex twice in the same expression) containing the size of the array data member. More...
clang::Module *	declareModuleMap (clang::CompilerInstance *CI, const char *moduleFileName, const char *headers[])
	Declare a virtual module.map to clang. Returns Module on success. More...
int	ElementStreamer (std::ostream &finalString, const clang::NamedDecl &forcontext, const clang::QualType &qti, const char *t, int rwmode, const cling::Interpreter &interp, const char *tcl=0)
bool	EndsWith (const std::string &theString, const std::string &theSubstring)
void	Error (const char *location, const char *va_(fmt),...)
bool	ExtractAttrIntPropertyFromName (const clang::Decl &decl, const std::string &propName, int &propValue)
	This routine counts on the "propName<separator>propValue" format. More...
bool	ExtractAttrPropertyFromName (const clang::Decl &decl, const std::string &propName, std::string &propValue)
	This routine counts on the "propName<separator>propValue" format. More...
int	extractAttrString (clang::Attr *attribute, std::string &attrString)
	Extract attr string. More...
void	ExtractCtxtEnclosingNameSpaces (const clang::DeclContext &, std::list< std::pair< std::string, bool > > &)
	Extract enclosing namespaces recusrively. More...
void	ExtractEnclosingNameSpaces (const clang::Decl &, std::list< std::pair< std::string, bool > > &)
	Extract the immediately outer namespace and then launch the recursion. More...
const clang::RecordDecl *	ExtractEnclosingScopes (const clang::Decl &decl, std::list< std::pair< std::string, unsigned int > > &enclosingSc)
	Extract the names and types of containing scopes. More...
int	extractPropertyNameVal (clang::Attr *attribute, std::string &attrName, std::string &attrValue)
int	extractPropertyNameValFromString (const std::string attributeStr, std::string &attrName, std::string &attrValue)
clang::TemplateName	ExtractTemplateNameFromQualType (const clang::QualType &qt)
	These manipulations are necessary because a template specialisation type does not inherit from a record type (there is an asymmetry between the decls and the types in the clang interface). More...
void	Fatal (const char *location, const char *va_(fmt),...)
template<typename T >
const T *	GetAnnotatedRedeclarable (const T *Redecl)
const clang::TypedefNameDecl *	GetAnnotatedRedeclarable (const clang::TypedefNameDecl *TND)
const clang::TagDecl *	GetAnnotatedRedeclarable (const clang::TagDecl *TND)
llvm::StringRef	GetClassComment (const clang::CXXRecordDecl &decl, clang::SourceLocation *loc, const cling::Interpreter &interpreter)
	Return the class comment after the ClassDef: class MyClass { ... More...
int	GetClassVersion (const clang::RecordDecl *cl, const cling::Interpreter &interp)
	Return the version number of the class or -1 if the function Class_Version does not exist. More...
llvm::StringRef	GetComment (const clang::Decl &decl, clang::SourceLocation *loc=0)
	Returns the comment (// striped away), annotating declaration in a meaningful for ROOT IO way. More...
void	GetCppName (std::string &output, const char *input)
	Return (in the argument 'output') a mangled version of the C++ symbol/type (pass as 'input') that can be used in C++ as a variable name. More...
int &	GetErrorIgnoreLevel ()
llvm::StringRef	GetFileName (const clang::Decl &decl, const cling::Interpreter &interp)
	Return the header file to be included to declare the Decl. More...
void	GetFullyQualifiedTypeName (std::string &name, const clang::QualType &type, const cling::Interpreter &interpreter)
void	GetFullyQualifiedTypeName (std::string &name, const clang::QualType &type, const clang::ASTContext &)
const clang::FunctionDecl *	GetFuncWithProto (const clang::Decl *cinfo, const char *method, const char *proto, const cling::Interpreter &gInterp, bool diagnose)
std::string	GetInterpreterExtraIncludePath (bool rootbuild)
	Return the -I needed to find RuntimeUniverse.h. More...
long	GetLineNumber (clang::Decl const *)
std::string	GetLLVMResourceDir (bool rootbuild)
	Return the LLVM / clang resource directory. More...
std::string	GetModuleFileName (const char *moduleName)
	Return the dictionary file name for a module. More...
std::pair< std::string, clang::QualType >	GetNameTypeForIO (const clang::QualType &templateInstanceType, const cling::Interpreter &interpreter, const TNormalizedCtxt &normCtxt, TClassEdit::EModType mode=TClassEdit::kNone)
bool	GetNameWithinNamespace (std::string &, std::string &, std::string &, clang::CXXRecordDecl const *)
void	GetNormalizedName (std::string &norm_name, const clang::QualType &type, const cling::Interpreter &interpreter, const TNormalizedCtxt &normCtxt)
	Return the type name normalized for ROOT, keeping only the ROOT opaque typedef (Double32_t, etc.) and adding default template argument for all types except the STL collections where we remove the default template argument if any. More...
void	GetNormalizedName (std::string &norm_name, const clang::TypeDecl *typeDecl, const cling::Interpreter &interpreter)
clang::QualType	GetNormalizedType (const clang::QualType &type, const cling::Interpreter &interpreter, const TNormalizedCtxt &normCtxt)
	Return the type normalized for ROOT, keeping only the ROOT opaque typedef (Double32_t, etc.) and adding default template argument for all types except those explicitly requested to be drop by the user. More...
unsigned int &	GetNumberOfWarningsAndErrors ()
const std::string &	GetPathSeparator ()
	Return the separator suitable for this platform. More...
void	GetQualifiedName (std::string &qual_name, const clang::QualType &type, const clang::NamedDecl &forcontext)
	Main implementation relying on GetFullyQualifiedTypeName All other GetQualifiedName functions leverage this one except the one for namespaces. More...
std::string	GetQualifiedName (const clang::QualType &type, const clang::NamedDecl &forcontext)
void	GetQualifiedName (std::string &qual_name, const clang::Type &type, const clang::NamedDecl &forcontext)
std::string	GetQualifiedName (const clang::Type &type, const clang::NamedDecl &forcontext)
void	GetQualifiedName (std::string &qual_name, const clang::NamedDecl &nd)
	This implementation does not rely on GetFullyQualifiedTypeName. More...
std::string	GetQualifiedName (const clang::NamedDecl &nd)
void	GetQualifiedName (std::string &qual_name, const AnnotatedRecordDecl &annotated)
std::string	GetQualifiedName (const AnnotatedRecordDecl &annotated)
void	GetQualifiedName (std::string &qual_name, const clang::RecordDecl &recordDecl)
std::string	GetQualifiedName (const clang::RecordDecl &recordDecl)
std::string	GetROOTIncludeDir (bool rootbuild)
clang::QualType	GetTypeForIO (const clang::QualType &templateInstanceType, const cling::Interpreter &interpreter, const TNormalizedCtxt &normCtxt, TClassEdit::EModType mode=TClassEdit::kNone)
clang::RecordDecl *	GetUnderlyingRecordDecl (clang::QualType type)
const clang::Type *	GetUnderlyingType (clang::QualType type)
	Return the base/underlying type of a chain of array or pointers type. More...
bool	HasCustomConvStreamerMemberFunction (const AnnotatedRecordDecl &cl, const clang::CXXRecordDecl *clxx, const cling::Interpreter &interp, const TNormalizedCtxt &normCtxt)
	Return true if the class has a custom member function streamer. More...
bool	HasCustomOperatorNewArrayPlacement (clang::RecordDecl const &, const cling::Interpreter &interp)
bool	HasCustomOperatorNewPlacement (char const *, clang::RecordDecl const &, const cling::Interpreter &)
bool	HasCustomOperatorNewPlacement (clang::RecordDecl const &, const cling::Interpreter &)
bool	HasCustomStreamerMemberFunction (const AnnotatedRecordDecl &cl, const clang::CXXRecordDecl *clxx, const cling::Interpreter &interp, const TNormalizedCtxt &normCtxt)
	Return true if the class has a custom member function streamer. More...
bool	HasDirectoryAutoAdd (clang::CXXRecordDecl const *, const cling::Interpreter &)
bool	HasIOConstructor (clang::CXXRecordDecl const *, std::string &, const RConstructorTypes &, const cling::Interpreter &)
bool	HasNewMerge (clang::CXXRecordDecl const *, const cling::Interpreter &)
bool	HasOldMerge (clang::CXXRecordDecl const *, const cling::Interpreter &)
bool	hasOpaqueTypedef (clang::QualType instanceType, const TNormalizedCtxt &normCtxt)
	Return true if the type is a Double32_t or Float16_t or is a instance template that depends on Double32_t or Float16_t. More...
bool	hasOpaqueTypedef (const AnnotatedRecordDecl &cl, const cling::Interpreter &interp, const TNormalizedCtxt &normCtxt)
	Return true if any of the argument is or contains a double32. More...
bool	HasResetAfterMerge (clang::CXXRecordDecl const *, const cling::Interpreter &)
void	Info (const char *location, const char *va_(fmt),...)
bool	IsBase (const clang::CXXRecordDecl *cl, const clang::CXXRecordDecl *base, const clang::CXXRecordDecl *context, const cling::Interpreter &interp)
bool	IsBase (const clang::FieldDecl &m, const char *basename, const cling::Interpreter &interp)
bool	IsOfType (const clang::CXXRecordDecl &cl, const std::string &type, const cling::LookupHelper &lh)
bool	IsStdClass (const clang::RecordDecl &cl)
	Return true, if the decl is part of the std namespace. More...
bool	IsStdDropDefaultClass (const clang::RecordDecl &cl)
	Return true, if the decl is part of the std namespace and we want its default parameter dropped. More...
ROOT::ESTLType	IsSTLCont (const clang::RecordDecl &cl)
	type : type name: vector<list<classA,allocator>,allocator> result: 0 : not stl container abs(result): code of container 1=vector,2=list,3=deque,4=map 5=multimap,6=set,7=multiset More...
int	IsSTLContainer (const AnnotatedRecordDecl &annotated)
	Is this an STL container. More...
ROOT::ESTLType	IsSTLContainer (const clang::FieldDecl &m)
	Is this an STL container? More...
int	IsSTLContainer (const clang::CXXBaseSpecifier &base)
	Is this an STL container? More...
bool	IsStreamableObject (const clang::FieldDecl &m, const cling::Interpreter &interp)
void	LevelPrint (bool prefix, int level, const char *location, const char *fmt, va_list ap)
bool	MatchWithDeclOrAnyOfPrevious (const clang::CXXRecordDecl &cl, const clang::CXXRecordDecl &currentCl)
	This is a recursive function. More...
bool	NeedDestructor (clang::CXXRecordDecl const *)
bool	NeedTemplateKeyword (clang::CXXRecordDecl const *)
clang::ClassTemplateDecl *	QualType2ClassTemplateDecl (const clang::QualType &qt)
	Extract from a qualtype the class template if this makes sense. More...
bool	QualType2Template (const clang::QualType &qt, clang::ClassTemplateDecl *&ctd, clang::ClassTemplateSpecializationDecl *&ctsd)
	Get the template specialisation decl and template decl behind the qualtype Returns true if successfully found, false otherwise. More...
int	RemoveTemplateArgsFromName (std::string &name, unsigned int)
	Remove the last n template arguments from the name. More...
void	ReplaceAll (std::string &str, const std::string &from, const std::string &to, bool recurse=false)
bool	RequireCompleteType (const cling::Interpreter &interp, const clang::CXXRecordDecl *cl)
bool	RequireCompleteType (const cling::Interpreter &interp, clang::SourceLocation Loc, clang::QualType Type)
clang::QualType	ReSubstTemplateArg (clang::QualType input, const clang::Type *instance)
	Check if 'input' or any of its template parameter was substituted when instantiating the class template instance and replace it with the partially sugared types we have from 'instance'. More...
const clang::CXXRecordDecl *	ScopeSearch (const char *name, const cling::Interpreter &gInterp, bool diagnose, const clang::Type **resultType)
	Return the scope corresponding to 'name' or std::'name'. More...
void	SetPathsForRelocatability (std::vector< std::string > &clingArgs)
	Organise the parameters for cling in order to guarantee relocatability It treats the gcc toolchain and the root include path FIXME: enables relocatability for experiments' framework headers until PCMs are available. More...
const char *	ShortTypeName (const char *typeDesc)
	Return the absolute type of typeDesc. More...
std::string	ShortTypeName (const clang::FieldDecl &m)
	Return the absolute type of typeDesc. More...
ROOT::ESTLType	STLKind (const llvm::StringRef type)
	Converts STL container name to number. vector -> 1, etc.. More...
void	SysError (const char *location, const char *va_(fmt),...)
std::string	TrueName (const clang::FieldDecl &m)
	TrueName strips the typedefs and array dimensions. More...
void	Warning (const char *location, const char *va_(fmt),...)
void	WriteAuxFunctions (std::ostream &finalString, const AnnotatedRecordDecl &cl, const clang::CXXRecordDecl *decl, const cling::Interpreter &interp, const RConstructorTypes &ctorTypes, const TNormalizedCtxt &normCtxt)
	std::string NormalizedName; GetNormalizedName(NormalizedName, decl->getASTContext().getTypeDeclType(decl), interp, normCtxt); More...
void	WriteClassCode (CallWriteStreamer_t WriteStreamerFunc, const AnnotatedRecordDecl &cl, const cling::Interpreter &interp, const TNormalizedCtxt &normCtxt, std::ostream &finalString, const RConstructorTypes &ctorTypes, bool isGenreflex)
	Generate the code of the class If the requestor is genreflex, request the new streamer format. More...
void	WriteClassInit (std::ostream &finalString, const AnnotatedRecordDecl &cl, const clang::CXXRecordDecl *decl, const cling::Interpreter &interp, const TNormalizedCtxt &normCtxt, const RConstructorTypes &ctorTypes, bool &needCollectionProxy)
	FIXME: a function of ~300 lines! More...
int	WriteNamespaceHeader (std::ostream &, const clang::RecordDecl *)
int	WriteNamespaceHeader (std::ostream &, const clang::DeclContext *)
	Write all the necessary opening part of the namespace and return the number of closing brackets needed For example for Space1::Space2 we write: namespace Space1 { namespace Space2 { and return 2. More...
void	WritePointersSTL (const AnnotatedRecordDecl &cl, const cling::Interpreter &interp, const TNormalizedCtxt &normCtxt)
	Write interface function for STL members. More...

Variables
const int	kError = 2000
const int	kFatal = 4000
const int	kInfo = 0
const int	kMaxLen = 1024
const int	kNote = 500
const int	kSysError = 3000
const int	kThrowOnWarning = 999
const int	kWarning = 1000

Typedef Documentation

typedef void(* ROOT::TMetaUtils::CallWriteStreamer_t) (const AnnotatedRecordDecl &cl, const cling::Interpreter &interp, const TNormalizedCtxt &normCtxt, std::ostream &dictStream, bool isAutoStreamer)

Definition at line 104 of file TMetaUtils.h.

typedef std::list<RConstructorType> ROOT::TMetaUtils::RConstructorTypes

Definition at line 299 of file TMetaUtils.h.

Enumeration Type Documentation

enum ROOT::TMetaUtils::DataMemberInfo__ValidArrayIndex_error_code

Enumerator
VALID
NOT_INT
NOT_DEF
IS_PRIVATE
UNKNOWN

Definition at line 102 of file TMetaUtils.h.

enum ROOT::TMetaUtils::EIOCtorCategory : short

strong

Enumerator
kAbsent
kDefault
kIOPtrType
kIORefType

Definition at line 341 of file TMetaUtils.h.

Function Documentation

clang::QualType ROOT::TMetaUtils::AddDefaultParameters	(	clang::QualType	instanceType,
		const cling::Interpreter &	interpreter,
		const TNormalizedCtxt &	normCtxt
	)

Add any unspecified template parameters to the class template instance, mentioned anywhere in the type.

Note: this does not strip any typedef but could be merged with cling::utils::Transform::GetPartiallyDesugaredType if we can safely replace TClassEdit::IsStd with a test on the declaring scope and if we can resolve the fact that the added parameter do not take into account possible use/dependences on Double32_t and if we decide that adding the default is the right long term solution or not. Whether it is or not depend on the I/O on whether the default template argument might change or not and whether they (should) affect the on disk layout (for STL containers, we do know they do not).

Definition at line 2707 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::BeginsWith	(	const std::string &	theString,
		const std::string &	theSubstring
	)

Definition at line 4966 of file TMetaUtils.cxx.

ROOT::TMetaUtils::EIOCtorCategory ROOT::TMetaUtils::CheckConstructor	(	const clang::CXXRecordDecl *	cl,
		const RConstructorType &	ioctortype,
		const cling::Interpreter &	interp
	)

Definition at line 963 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::CheckPublicFuncWithProto	(	clang::CXXRecordDecl const *	,
		char const *	,
		char const *	,
		const cling::Interpreter &	,
		bool	diagnose
	)

const clang::FunctionDecl* ROOT::TMetaUtils::ClassInfo__HasMethod	(	const clang::DeclContext *	cl,
		char const *	,
		const cling::Interpreter &	interp
	)

void ROOT::TMetaUtils::CreateNameTypeMap	(	clang::CXXRecordDecl const &	,
		std::map< std::string, ROOT::Internal::TSchemaType, std::less< std::string >, std::allocator< std::pair< std::string const, ROOT::Internal::TSchemaType > > > &
	)

llvm::StringRef ROOT::TMetaUtils::DataMemberInfo__ValidArrayIndex	(	const clang::DeclaratorDecl &	m,
		int *	errnum = 0,
		llvm::StringRef *	errstr = 0
	)

ValidArrayIndex return a static string (so use it or copy it immediatly, do not call GrabIndex twice in the same expression) containing the size of the array data member.

In case of error, or if the size is not specified, GrabIndex returns 0. If errnum is not null, *errnum updated with the error number: Cint::G__DataMemberInfo::G__VALID : valid array index Cint::G__DataMemberInfo::G__NOT_INT : array index is not an int Cint::G__DataMemberInfo::G__NOT_DEF : index not defined before array (this IS an error for streaming to disk) Cint::G__DataMemberInfo::G__IS_PRIVATE: index exist in a parent class but is private Cint::G__DataMemberInfo::G__UNKNOWN : index is not known If errstr is not null, *errstr is updated with the address of a static string containing the part of the index with is invalid.

Definition at line 2933 of file TMetaUtils.cxx.

clang::Module * ROOT::TMetaUtils::declareModuleMap	(	clang::CompilerInstance *	CI,
		const char *	moduleFileName,
		const char *	headers[]
	)

Declare a virtual module.map to clang. Returns Module on success.

Definition at line 4002 of file TMetaUtils.cxx.

int ROOT::TMetaUtils::ElementStreamer	(	std::ostream &	finalString,
		const clang::NamedDecl &	forcontext,
		const clang::QualType &	qti,
		const char *	t,
		int	rwmode,
		const cling::Interpreter &	interp,
		const char *	tcl = 0
	)

Definition at line 785 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::EndsWith	(	const std::string &	theString,
		const std::string &	theSubstring
	)

Definition at line 4955 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::Error ( const char *  location, const char *  va_fmt,   ...  )

inline

Definition at line 767 of file TMetaUtils.h.

bool ROOT::TMetaUtils::ExtractAttrIntPropertyFromName	(	const clang::Decl &	decl,
		const std::string &	propName,
		int &	propValue
	)

This routine counts on the "propName<separator>propValue" format.

Definition at line 1610 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::ExtractAttrPropertyFromName	(	const clang::Decl &	decl,
		const std::string &	propName,
		std::string &	propValue
	)

This routine counts on the "propName<separator>propValue" format.

Definition at line 1587 of file TMetaUtils.cxx.

int ROOT::TMetaUtils::extractAttrString	(	clang::Attr *	attribute,
		std::string &	attrString
	)

Extract attr string.

Definition at line 1546 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::ExtractCtxtEnclosingNameSpaces	(	const clang::DeclContext &	ctxt,
		std::list< std::pair< std::string, bool > > &	enclosingNamespaces
	)

Extract enclosing namespaces recusrively.

Definition at line 4799 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::ExtractEnclosingNameSpaces	(	const clang::Decl &	decl,
		std::list< std::pair< std::string, bool > > &	enclosingNamespaces
	)

Extract the immediately outer namespace and then launch the recursion.

Definition at line 4779 of file TMetaUtils.cxx.

const clang::RecordDecl * ROOT::TMetaUtils::ExtractEnclosingScopes	(	const clang::Decl &	decl,
		std::list< std::pair< std::string, unsigned int > > &	enclosingSc
	)

Extract the names and types of containing scopes.

Stop if a class is met and return its pointer.

Definition at line 4826 of file TMetaUtils.cxx.

int ROOT::TMetaUtils::extractPropertyNameVal	(	clang::Attr *	attribute,
		std::string &	attrName,
		std::string &	attrValue
	)

Definition at line 1576 of file TMetaUtils.cxx.

int ROOT::TMetaUtils::extractPropertyNameValFromString	(	const std::string	attributeStr,
		std::string &	attrName,
		std::string &	attrValue
	)

Definition at line 1559 of file TMetaUtils.cxx.

clang::TemplateName ROOT::TMetaUtils::ExtractTemplateNameFromQualType

(

const clang::QualType &

qt

)

These manipulations are necessary because a template specialisation type does not inherit from a record type (there is an asymmetry between the decls and the types in the clang interface).

We may need therefore to step into the "Decl dimension" to then get back to the "type dimension".

Definition at line 3400 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::Fatal ( const char *  location, const char *  va_fmt,   ...  )

inline

Definition at line 807 of file TMetaUtils.h.

template<typename T >

const T* ROOT::TMetaUtils::GetAnnotatedRedeclarable

(

const T *

Redecl

)

Definition at line 628 of file TMetaUtils.h.

const clang::TypedefNameDecl * ROOT::TMetaUtils::GetAnnotatedRedeclarable

(

const clang::TypedefNameDecl *

TND

)

Definition at line 4750 of file TMetaUtils.cxx.

const clang::TagDecl * ROOT::TMetaUtils::GetAnnotatedRedeclarable

(

const clang::TagDecl *

TND

)

Definition at line 4764 of file TMetaUtils.cxx.

llvm::StringRef ROOT::TMetaUtils::GetClassComment	(	const clang::CXXRecordDecl &	decl,
		clang::SourceLocation *	loc,
		const cling::Interpreter &	interpreter
	)

Return the class comment after the ClassDef: class MyClass { ...

ClassDef(MyClass, 1) // class comment

Definition at line 4219 of file TMetaUtils.cxx.

int ROOT::TMetaUtils::GetClassVersion	(	const clang::RecordDecl *	cl,
		const cling::Interpreter &	interp
	)

Return the version number of the class or -1 if the function Class_Version does not exist.

Definition at line 2455 of file TMetaUtils.cxx.

llvm::StringRef ROOT::TMetaUtils::GetComment	(	const clang::Decl &	decl,
		clang::SourceLocation *	loc = 0
	)

Returns the comment (// striped away), annotating declaration in a meaningful for ROOT IO way.

Takes optional out parameter clang::SourceLocation returning the source location of the comment.

CXXMethodDecls, FieldDecls and TagDecls are annotated. CXXMethodDecls declarations and FieldDecls are annotated as follows: Eg. void f(); // comment1 int member; // comment2 Inline definitions of CXXMethodDecls after the closing }
. Eg: void f() {...} // comment3 TagDecls are annotated in the end of the ClassDef macro. Eg. class MyClass { ... ClassDef(MyClass, 1) // comment4

Definition at line 4093 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::GetCppName	(	std::string &	out,
		const char *	in
	)

Return (in the argument 'output') a mangled version of the C++ symbol/type (pass as 'input') that can be used in C++ as a variable name.

Definition at line 3082 of file TMetaUtils.cxx.

int& ROOT::TMetaUtils::GetErrorIgnoreLevel ( )

inline

Definition at line 721 of file TMetaUtils.h.

llvm::StringRef ROOT::TMetaUtils::GetFileName	(	const clang::Decl &	decl,
		const cling::Interpreter &	interp
	)

Return the header file to be included to declare the Decl.

Definition at line 3143 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::GetFullyQualifiedTypeName	(	std::string &	name,
		const clang::QualType &	type,
		const cling::Interpreter &	interpreter
	)

Definition at line 3293 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::GetFullyQualifiedTypeName	(	std::string &	name,
		const clang::QualType &	type,
		const clang::ASTContext &	astContext
	)

Definition at line 3281 of file TMetaUtils.cxx.

const clang::FunctionDecl * ROOT::TMetaUtils::GetFuncWithProto	(	const clang::Decl *	cinfo,
		const char *	method,
		const char *	proto,
		const cling::Interpreter &	gInterp,
		bool	diagnose
	)

Definition at line 1408 of file TMetaUtils.cxx.

std::string ROOT::TMetaUtils::GetInterpreterExtraIncludePath

(

bool

rootbuild

)

Return the -I needed to find RuntimeUniverse.h.

Definition at line 3305 of file TMetaUtils.cxx.

long ROOT::TMetaUtils::GetLineNumber

(

clang::Decl const *

)

std::string ROOT::TMetaUtils::GetLLVMResourceDir

(

bool

rootbuild

)

Return the LLVM / clang resource directory.

Definition at line 3326 of file TMetaUtils.cxx.

std::string ROOT::TMetaUtils::GetModuleFileName

(

const char *

moduleName

)

Return the dictionary file name for a module.

Definition at line 3992 of file TMetaUtils.cxx.

std::pair< std::string, clang::QualType > ROOT::TMetaUtils::GetNameTypeForIO	(	const clang::QualType &	templateInstanceType,
		const cling::Interpreter &	interpreter,
		const TNormalizedCtxt &	normCtxt,
		TClassEdit::EModType	mode = TClassEdit::kNone
	)

Definition at line 3910 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::GetNameWithinNamespace	(	std::string &	,
		std::string &	,
		std::string &	,
		clang::CXXRecordDecl const *
	)

void ROOT::TMetaUtils::GetNormalizedName	(	std::string &	norm_name,
		const clang::QualType &	type,
		const cling::Interpreter &	interpreter,
		const TNormalizedCtxt &	normCtxt
	)

Return the type name normalized for ROOT, keeping only the ROOT opaque typedef (Double32_t, etc.) and adding default template argument for all types except the STL collections where we remove the default template argument if any.

This routine might actually belong in the interpreter because cache the clang::Type might be intepreter specific.

Definition at line 3856 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::GetNormalizedName	(	std::string &	norm_name,
		const clang::TypeDecl *	typeDecl,
		const cling::Interpreter &	interpreter
	)

Definition at line 3893 of file TMetaUtils.cxx.

clang::QualType ROOT::TMetaUtils::GetNormalizedType	(	const clang::QualType &	type,
		const cling::Interpreter &	interpreter,
		const TNormalizedCtxt &	normCtxt
	)

Return the type normalized for ROOT, keeping only the ROOT opaque typedef (Double32_t, etc.) and adding default template argument for all types except those explicitly requested to be drop by the user.

Default template for STL collections are not yet removed by this routine.

Definition at line 3832 of file TMetaUtils.cxx.

unsigned int& ROOT::TMetaUtils::GetNumberOfWarningsAndErrors ( )

inline

Definition at line 715 of file TMetaUtils.h.

const std::string & ROOT::TMetaUtils::GetPathSeparator

(

)

Return the separator suitable for this platform.

To be replaced at the next llvm upgrade by const StringRef llvm::sys::path::get_separator()

Definition at line 4943 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::GetQualifiedName	(	std::string &	qual_name,
		const clang::QualType &	type,
		const clang::NamedDecl &	forcontext
	)

Main implementation relying on GetFullyQualifiedTypeName All other GetQualifiedName functions leverage this one except the one for namespaces.

Definition at line 1251 of file TMetaUtils.cxx.

std::string ROOT::TMetaUtils::GetQualifiedName	(	const clang::QualType &	type,
		const clang::NamedDecl &	forcontext
	)

Definition at line 1257 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::GetQualifiedName	(	std::string &	qual_name,
		const clang::Type &	type,
		const clang::NamedDecl &	forcontext
	)

Definition at line 1269 of file TMetaUtils.cxx.

std::string ROOT::TMetaUtils::GetQualifiedName	(	const clang::Type &	type,
		const clang::NamedDecl &	forcontext
	)

Definition at line 1278 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::GetQualifiedName	(	std::string &	qual_name,
		const clang::NamedDecl &	nd
	)

This implementation does not rely on GetFullyQualifiedTypeName.

Definition at line 1301 of file TMetaUtils.cxx.

std::string ROOT::TMetaUtils::GetQualifiedName

(

const clang::NamedDecl &

nd

)

Definition at line 1318 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::GetQualifiedName	(	std::string &	qual_name,
		const AnnotatedRecordDecl &	annotated
	)

Definition at line 1346 of file TMetaUtils.cxx.

std::string ROOT::TMetaUtils::GetQualifiedName

(

const AnnotatedRecordDecl &

annotated

)

Definition at line 1352 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::GetQualifiedName	(	std::string &	qual_name,
		const clang::RecordDecl &	recordDecl
	)

Definition at line 1327 of file TMetaUtils.cxx.

std::string ROOT::TMetaUtils::GetQualifiedName

(

const clang::RecordDecl &

recordDecl

)

Definition at line 1337 of file TMetaUtils.cxx.

std::string ROOT::TMetaUtils::GetROOTIncludeDir

(

bool

rootbuild

)

Definition at line 3968 of file TMetaUtils.cxx.

clang::QualType ROOT::TMetaUtils::GetTypeForIO	(	const clang::QualType &	templateInstanceType,
		const cling::Interpreter &	interpreter,
		const TNormalizedCtxt &	normCtxt,
		TClassEdit::EModType	mode = TClassEdit::kNone
	)

Definition at line 3958 of file TMetaUtils.cxx.

clang::RecordDecl * ROOT::TMetaUtils::GetUnderlyingRecordDecl

(

clang::QualType

type

)

Definition at line 2643 of file TMetaUtils.cxx.

const clang::Type * ROOT::TMetaUtils::GetUnderlyingType

(

clang::QualType

type

)

Return the base/underlying type of a chain of array or pointers type.

Does not yet support the array and pointer part being intermixed.

Definition at line 4253 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::HasCustomConvStreamerMemberFunction	(	const AnnotatedRecordDecl &	cl,
		const clang::CXXRecordDecl *	clxx,
		const cling::Interpreter &	interp,
		const TNormalizedCtxt &	normCtxt
	)

Return true if the class has a custom member function streamer.

Definition at line 1229 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::HasCustomOperatorNewArrayPlacement	(	clang::RecordDecl const &	,
		const cling::Interpreter &	interp
	)

bool ROOT::TMetaUtils::HasCustomOperatorNewPlacement	(	char const *	,
		clang::RecordDecl const &	,
		const cling::Interpreter &
	)

bool ROOT::TMetaUtils::HasCustomOperatorNewPlacement	(	clang::RecordDecl const &	,
		const cling::Interpreter &
	)

bool ROOT::TMetaUtils::HasCustomStreamerMemberFunction	(	const AnnotatedRecordDecl &	cl,
		const clang::CXXRecordDecl *	clxx,
		const cling::Interpreter &	interp,
		const TNormalizedCtxt &	normCtxt
	)

Return true if the class has a custom member function streamer.

Definition at line 1210 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::HasDirectoryAutoAdd	(	clang::CXXRecordDecl const *	,
		const cling::Interpreter &
	)

bool ROOT::TMetaUtils::HasIOConstructor	(	clang::CXXRecordDecl const *	,
		std::string &	,
		const RConstructorTypes &	,
		const cling::Interpreter &
	)

bool ROOT::TMetaUtils::HasNewMerge	(	clang::CXXRecordDecl const *	,
		const cling::Interpreter &
	)

bool ROOT::TMetaUtils::HasOldMerge	(	clang::CXXRecordDecl const *	,
		const cling::Interpreter &
	)

bool ROOT::TMetaUtils::hasOpaqueTypedef	(	clang::QualType	instanceType,
		const TNormalizedCtxt &	normCtxt
	)

Return true if the type is a Double32_t or Float16_t or is a instance template that depends on Double32_t or Float16_t.

Definition at line 1473 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::hasOpaqueTypedef	(	const AnnotatedRecordDecl &	cl,
		const cling::Interpreter &	interp,
		const TNormalizedCtxt &	normCtxt
	)

Return true if any of the argument is or contains a double32.

Definition at line 1526 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::HasResetAfterMerge	(	clang::CXXRecordDecl const *	,
		const cling::Interpreter &
	)

void ROOT::TMetaUtils::Info ( const char *  location, const char *  va_fmt,   ...  )

inline

Definition at line 787 of file TMetaUtils.h.

bool ROOT::TMetaUtils::IsBase	(	const clang::CXXRecordDecl *	cl,
		const clang::CXXRecordDecl *	base,
		const clang::CXXRecordDecl *	context,
		const cling::Interpreter &	interp
	)

Definition at line 742 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::IsBase	(	const clang::FieldDecl &	m,
		const char *	basename,
		const cling::Interpreter &	interp
	)

Definition at line 766 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::IsOfType	(	const clang::CXXRecordDecl &	cl,
		const std::string &	type,
		const cling::LookupHelper &	lh
	)

Definition at line 4335 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::IsStdClass

(

const clang::RecordDecl &

cl

)

Return true, if the decl is part of the std namespace.

Definition at line 4288 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::IsStdDropDefaultClass

(

const clang::RecordDecl &

cl

)

Return true, if the decl is part of the std namespace and we want its default parameter dropped.

Definition at line 4297 of file TMetaUtils.cxx.

ROOT::ESTLType ROOT::TMetaUtils::IsSTLCont

(

const clang::RecordDecl &

cl

)

type : type name: vector<list<classA,allocator>,allocator> result: 0 : not stl container abs(result): code of container 1=vector,2=list,3=deque,4=map 5=multimap,6=set,7=multiset

Definition at line 4365 of file TMetaUtils.cxx.

int ROOT::TMetaUtils::IsSTLContainer

(

const AnnotatedRecordDecl &

annotated

)

Is this an STL container.

Definition at line 2500 of file TMetaUtils.cxx.

ROOT::ESTLType ROOT::TMetaUtils::IsSTLContainer

(

const clang::FieldDecl &

m

)

Is this an STL container?

Definition at line 2508 of file TMetaUtils.cxx.

int ROOT::TMetaUtils::IsSTLContainer

(

const clang::CXXBaseSpecifier &

base

)

Is this an STL container?

Definition at line 2520 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::IsStreamableObject	(	const clang::FieldDecl &	m,
		const cling::Interpreter &	interp
	)

Definition at line 2567 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::LevelPrint ( bool  prefix, int  level, const char *  location, const char *  fmt, va_list  ap  )

inline

Definition at line 727 of file TMetaUtils.h.

bool ROOT::TMetaUtils::MatchWithDeclOrAnyOfPrevious	(	const clang::CXXRecordDecl &	cl,
		const clang::CXXRecordDecl &	currentCl
	)

This is a recursive function.

Definition at line 4315 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::NeedDestructor

(

clang::CXXRecordDecl const *

)

bool ROOT::TMetaUtils::NeedTemplateKeyword

(

clang::CXXRecordDecl const *

)

clang::ClassTemplateDecl * ROOT::TMetaUtils::QualType2ClassTemplateDecl

(

const clang::QualType &

qt

)

Extract from a qualtype the class template if this makes sense.

Retuns the ClassTemplateDecl or nullptr otherwise.

Definition at line 3384 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::QualType2Template	(	const clang::QualType &	qt,
		clang::ClassTemplateDecl *&	ctd,
		clang::ClassTemplateSpecializationDecl *&	ctsd
	)

Get the template specialisation decl and template decl behind the qualtype Returns true if successfully found, false otherwise.

Definition at line 3340 of file TMetaUtils.cxx.

int ROOT::TMetaUtils::RemoveTemplateArgsFromName	(	std::string &	name,
		unsigned int	nArgsToRemove
	)

Remove the last n template arguments from the name.

Definition at line 4699 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::ReplaceAll	(	std::string &	str,
		const std::string &	from,
		const std::string &	to,
		bool	recurse = false
	)

Definition at line 4921 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::RequireCompleteType	(	const cling::Interpreter &	interp,
		const clang::CXXRecordDecl *	cl
	)

Definition at line 723 of file TMetaUtils.cxx.

bool ROOT::TMetaUtils::RequireCompleteType	(	const cling::Interpreter &	interp,
		clang::SourceLocation	Loc,
		clang::QualType	Type
	)

Definition at line 731 of file TMetaUtils.cxx.

clang::QualType ROOT::TMetaUtils::ReSubstTemplateArg	(	clang::QualType	input,
		const clang::Type *	instance
	)

Check if 'input' or any of its template parameter was substituted when instantiating the class template instance and replace it with the partially sugared types we have from 'instance'.

Definition at line 4443 of file TMetaUtils.cxx.

const clang::CXXRecordDecl * ROOT::TMetaUtils::ScopeSearch	(	const char *	name,
		const cling::Interpreter &	gInterp,
		bool	diagnose,
		const clang::Type **	resultType
	)

Return the scope corresponding to 'name' or std::'name'.

Definition at line 700 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::SetPathsForRelocatability

(

std::vector< std::string > &

clingArgs

)

Organise the parameters for cling in order to guarantee relocatability It treats the gcc toolchain and the root include path FIXME: enables relocatability for experiments' framework headers until PCMs are available.

Definition at line 4901 of file TMetaUtils.cxx.

const char * ROOT::TMetaUtils::ShortTypeName

(

const char *

typeDesc

)

Return the absolute type of typeDesc.

E.g.: typeDesc = "class TNamed**", returns "TNamed". we remove * and const keywords. (we do not want to remove & ). You need to use the result immediately before it is being overwritten.

Definition at line 2535 of file TMetaUtils.cxx.

std::string ROOT::TMetaUtils::ShortTypeName

(

const clang::FieldDecl &

m

)

Return the absolute type of typeDesc.

E.g.: typeDesc = "class TNamed**", returns "TNamed". we remove * and const keywords. (we do not want to remove & ). You need to use the result immediately before it is being overwritten.

Definition at line 2625 of file TMetaUtils.cxx.

ROOT::ESTLType ROOT::TMetaUtils::STLKind

(

const llvm::StringRef

type

)

Converts STL container name to number. vector -> 1, etc..

Definition at line 4727 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::SysError ( const char *  location, const char *  va_fmt,   ...  )

inline

Definition at line 777 of file TMetaUtils.h.

std::string ROOT::TMetaUtils::TrueName

(

const clang::FieldDecl &

m

)

TrueName strips the typedefs and array dimensions.

Definition at line 2439 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::Warning ( const char *  location, const char *  va_fmt,   ...  )

inline

Definition at line 797 of file TMetaUtils.h.

void ROOT::TMetaUtils::WriteAuxFunctions	(	std::ostream &	finalString,
		const AnnotatedRecordDecl &	cl,
		const clang::CXXRecordDecl *	decl,
		const cling::Interpreter &	interp,
		const RConstructorTypes &	ctorTypes,
		const TNormalizedCtxt &	normCtxt
	)

std::string NormalizedName; GetNormalizedName(NormalizedName, decl->getASTContext().getTypeDeclType(decl), interp, normCtxt);

Definition at line 2275 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::WriteClassCode	(	CallWriteStreamer_t	WriteStreamerFunc,
		const AnnotatedRecordDecl &	cl,
		const cling::Interpreter &	interp,
		const TNormalizedCtxt &	normCtxt,
		std::ostream &	finalString,
		const RConstructorTypes &	ctorTypes,
		bool	isGenreflex = false
	)

Generate the code of the class If the requestor is genreflex, request the new streamer format.

Definition at line 2658 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::WriteClassInit	(	std::ostream &	finalString,
		const AnnotatedRecordDecl &	cl,
		const clang::CXXRecordDecl *	decl,
		const cling::Interpreter &	interp,
		const TNormalizedCtxt &	normCtxt,
		const RConstructorTypes &	ctorTypes,
		bool &	needCollectionProxy
	)

FIXME: a function of ~300 lines!

Definition at line 1632 of file TMetaUtils.cxx.

int ROOT::TMetaUtils::WriteNamespaceHeader	(	std::ostream &	out,
		const clang::RecordDecl *	cl
	)

Definition at line 2153 of file TMetaUtils.cxx.

int ROOT::TMetaUtils::WriteNamespaceHeader	(	std::ostream &	out,
		const clang::DeclContext *	ctxt
	)

Write all the necessary opening part of the namespace and return the number of closing brackets needed For example for Space1::Space2 we write: namespace Space1 { namespace Space2 { and return 2.

Definition at line 2130 of file TMetaUtils.cxx.

void ROOT::TMetaUtils::WritePointersSTL	(	const AnnotatedRecordDecl &	cl,
		const cling::Interpreter &	interp,
		const TNormalizedCtxt &	normCtxt
	)

Write interface function for STL members.

Definition at line 2382 of file TMetaUtils.cxx.

Variable Documentation

const int ROOT::TMetaUtils::kError = 2000

Definition at line 114 of file TMetaUtils.h.

const int ROOT::TMetaUtils::kFatal = 4000

Definition at line 116 of file TMetaUtils.h.

const int ROOT::TMetaUtils::kInfo = 0

Definition at line 110 of file TMetaUtils.h.

const int ROOT::TMetaUtils::kMaxLen = 1024

Definition at line 117 of file TMetaUtils.h.

const int ROOT::TMetaUtils::kNote = 500

Definition at line 111 of file TMetaUtils.h.

const int ROOT::TMetaUtils::kSysError = 3000

Definition at line 115 of file TMetaUtils.h.

const int ROOT::TMetaUtils::kThrowOnWarning = 999

Definition at line 112 of file TMetaUtils.h.

const int ROOT::TMetaUtils::kWarning = 1000

Definition at line 113 of file TMetaUtils.h.