Definition at line 238 of file DictSelectionReader.h.

Classes
struct	TemplateInfo

Public Member Functions
	DictSelectionReader (cling::Interpreter &interp, SelectionRules &, const clang::ASTContext &, ROOT::TMetaUtils::TNormalizedCtxt &)
	Take the selection rules as input (for consistency w/ other selector interfaces)

bool	shouldVisitTemplateInstantiations () const

bool	VisitRecordDecl (clang::RecordDecl *)
	Visit the entities that needs to be selected.

Private Member Functions
template<class T >
unsigned int	ExtractTemplateArgValue (const T &, const std::string &)
	Extract the value of the template parameter.

bool	FirstPass (const clang::RecordDecl &)
	First pass on the AST.

void	GetPointeeType (std::string &typeName)
	Get name of the pointee type.

const clang::TemplateArgumentList *	GetTmplArgList (const clang::CXXRecordDecl &)
	Get the template arguments list if any.

bool	InSelectionNamespace (const clang::RecordDecl &, const std::string &str="")
	Check if in the ROOT::Meta::Selection namespace.

void	ManageBaseClasses (const clang::CXXRecordDecl &, const std::string &, bool &)
	Take care of the class bases.

void	ManageFields (const clang::RecordDecl &, const std::string &, ClassSelectionRule &, bool)
	Take care of the class fields.

std::string	PatternifyName (const std::string &className)
	Transform instance name in pattern for selection.

bool	SecondPass (const clang::RecordDecl &)
	Second pass on the AST, using the information of the first one.

Private Attributes
llvm::StringMap< std::set< std::string > >	fAutoSelectedClassFieldNames
	Collect the autoselected classes.

llvm::StringMap< ClassSelectionRule >	fClassNameSelectionRuleMap
	Map of the already built sel rules.

bool	fIsFirstPass
	Keep trance of the number of passes through the AST.

llvm::StringMap< std::set< std::string > >	fNoAutoSelectedClassFieldNames
	Collect the autoexcluded classes.

ROOT::TMetaUtils::TNormalizedCtxt &	fNormCtxt
	The reference to the normalized context.

std::set< const clang::RecordDecl * >	fSelectedRecordDecls
	The pointers of the selected RecordDecls.

SelectionRules &	fSelectionRules
	The selection rules to be filled.

std::set< std::string >	fSpecialNames
	The names of the classes used for the selction syntax.

std::unordered_map< std::string, TemplateInfo >	fTemplateInfoMap
	List template name - properties map.

#include </home/sftnight/build/workspace/root-makedoc-master/rootspi/rdoc/src/master/core/dictgen/res/DictSelectionReader.h>

Inheritance diagram for ROOT::Internal::DictSelectionReader:

[legend]

Constructor & Destructor Documentation

◆ DictSelectionReader()

ROOT::Internal::DictSelectionReader::DictSelectionReader	(	cling::Interpreter &	interp,
		SelectionRules &	selectionRules,
		const clang::ASTContext &	C,
		ROOT::TMetaUtils::TNormalizedCtxt &	normCtxt
	)

Take the selection rules as input (for consistency w/ other selector interfaces)

Definition at line 22 of file DictSelectionReader.cxx.

Member Function Documentation

◆ ExtractTemplateArgValue()

template<class T >

unsigned int ROOT::Internal::DictSelectionReader::ExtractTemplateArgValue	(	const T &	myClass,
		const std::string &	pattern
	)

inlineprivate

Extract the value of the template parameter.

Extract the value of the integral template parameter of a CXXRecordDecl when it has a certain name.

If nothing can be extracted, the value of zero is returned.

Definition at line 121 of file DictSelectionReader.cxx.

◆ FirstPass()

bool ROOT::Internal::DictSelectionReader::FirstPass ( const clang::RecordDecl & recordDecl )

inlineprivate

First pass on the AST.

Manage the first pass over the AST, inspecting only nodes which are within the selection namespace.

Selection rules are directly filled as well as data sructures re-used during the second pass.

Definition at line 250 of file DictSelectionReader.cxx.

◆ GetPointeeType()

void ROOT::Internal::DictSelectionReader::GetPointeeType ( std::string & typeName )

inlineprivate

Get name of the pointee type.

Transform the name of the type eliminating the trailing & and *.

Definition at line 410 of file DictSelectionReader.cxx.

◆ GetTmplArgList()

const clang::TemplateArgumentList * ROOT::Internal::DictSelectionReader::GetTmplArgList ( const clang::CXXRecordDecl & cxxRcrdDecl )

inlineprivate

Get the template arguments list if any.

Get the pointer to the template arguments list.

Return zero if not available.

Definition at line 102 of file DictSelectionReader.cxx.

◆ InSelectionNamespace()

bool ROOT::Internal::DictSelectionReader::InSelectionNamespace	(	const clang::RecordDecl &	recordDecl,
		const std::string &	className = `""`
	)

inlineprivate

Check if in the ROOT::Meta::Selection namespace.

If it's not contained by 2 namespaces, drop it.

Check that the recordDecl is enclosed in the ROOT::Meta::Selection namespace, excluding the portion dedicated the definition of the syntax, which is part of ROOT, not of the user code. If performance is needed, an alternative approach to string comparisons could be adopted. One could use for example hashes of strings in first approximation.

Definition at line 63 of file DictSelectionReader.cxx.

◆ ManageBaseClasses()

void ROOT::Internal::DictSelectionReader::ManageBaseClasses	(	const clang::CXXRecordDecl &	cxxRcrdDecl,
		const std::string &	className,
		bool &	autoselect
	)

inlineprivate

Take care of the class bases.

Check the traits of the class.

Useful information may be there extract mothers, make a switchcase: 1) templates args are to be skipped 2) There are properties. Make a loop. make a switch: 2a) Is splittable Manage the loop over the base classes. Initially, the class attributes are identified and selection rules filled if:

The class is not splittable Then we look for the traits pointing to the need of hiding template arguments. This information is stored in the form of a list of pairs, where the first argument is the pattern of the template instance to match and the second one the number of arguments to be skipped. This information is used during the second pass.

Definition at line 217 of file DictSelectionReader.cxx.

◆ ManageFields()

void ROOT::Internal::DictSelectionReader::ManageFields	(	const clang::RecordDecl &	recordDecl,
		const std::string &	className,
		ClassSelectionRule &	csr,
		bool	autoselect
	)

inlineprivate

Take care of the class fields.

Iterate on the members to see if 1) They are transient 2) They imply further selection.

Loop over the class filelds and take actions according to their properties

Insert a field selection rule marking a member transient
Store in a map the name of the field the type of which should be autoselected. The key is the name of the class and the value the name of the field. This information is used in the second pass.

Definition at line 152 of file DictSelectionReader.cxx.

◆ PatternifyName()

std::string ROOT::Internal::DictSelectionReader::PatternifyName ( const std::string & className )

inlineprivate

Transform instance name in pattern for selection.

Transform a name of a class instance into a pattern for selection e.g.

myClass<double, int, ...> in the selection namespace will translate into a pattern of the type myClass<*>

Definition at line 399 of file DictSelectionReader.cxx.

◆ SecondPass()

bool ROOT::Internal::DictSelectionReader::SecondPass ( const clang::RecordDecl & recordDecl )

inlineprivate

Second pass on the AST, using the information of the first one.

Second pass through the AST.

Two operations are performed:

Selection rules for classes to be autoselected are created. The algorithm works as follows: the members of the classes matching the name of the classes which contained autoselected members in the selection namespace are inspected. If a field with the same name of the one which was autoselected a selection rule based on its typename is built.
If a class is found which is a TemplateSpecialisationDecl its name is checked to match one of the patterns identified during the first pass. If a match is found, a property is added to the selection rule with the number of template arguments to keep in order to percolate this information down to the AnnotatedRecordDecl creation which happens in the RScanner .

Definition at line 307 of file DictSelectionReader.cxx.

◆ shouldVisitTemplateInstantiations()

bool ROOT::Internal::DictSelectionReader::shouldVisitTemplateInstantiations ( ) const

inline

Definition at line 248 of file DictSelectionReader.h.

◆ VisitRecordDecl()

bool ROOT::Internal::DictSelectionReader::VisitRecordDecl ( clang::RecordDecl * recordDecl )

Visit the entities that needs to be selected.

Definition at line 384 of file DictSelectionReader.cxx.

Member Data Documentation

◆ fAutoSelectedClassFieldNames

llvm::StringMap<std::set<std::string> > ROOT::Internal::DictSelectionReader::fAutoSelectedClassFieldNames

private

Collect the autoselected classes.

Definition at line 292 of file DictSelectionReader.h.

◆ fClassNameSelectionRuleMap

llvm::StringMap<ClassSelectionRule> ROOT::Internal::DictSelectionReader::fClassNameSelectionRuleMap

private

Map of the already built sel rules.

Definition at line 297 of file DictSelectionReader.h.

◆ fIsFirstPass

bool ROOT::Internal::DictSelectionReader::fIsFirstPass

private

Keep trance of the number of passes through the AST.

Definition at line 298 of file DictSelectionReader.h.

◆ fNoAutoSelectedClassFieldNames

llvm::StringMap<std::set<std::string> > ROOT::Internal::DictSelectionReader::fNoAutoSelectedClassFieldNames

private

Collect the autoexcluded classes.

Definition at line 294 of file DictSelectionReader.h.

◆ fNormCtxt

ROOT::TMetaUtils::TNormalizedCtxt& ROOT::Internal::DictSelectionReader::fNormCtxt

private

The reference to the normalized context.

Definition at line 299 of file DictSelectionReader.h.

◆ fSelectedRecordDecls

std::set<const clang::RecordDecl *> ROOT::Internal::DictSelectionReader::fSelectedRecordDecls

private

The pointers of the selected RecordDecls.

Definition at line 288 of file DictSelectionReader.h.

◆ fSelectionRules

SelectionRules& ROOT::Internal::DictSelectionReader::fSelectionRules

private

The selection rules to be filled.

Definition at line 286 of file DictSelectionReader.h.

◆ fSpecialNames

std::set<std::string> ROOT::Internal::DictSelectionReader::fSpecialNames

private

The names of the classes used for the selction syntax.

Definition at line 290 of file DictSelectionReader.h.

◆ fTemplateInfoMap

std::unordered_map<std::string, TemplateInfo> ROOT::Internal::DictSelectionReader::fTemplateInfoMap

private

List template name - properties map.

Definition at line 295 of file DictSelectionReader.h.

core/dictgen/res/DictSelectionReader.h

core/dictgen/src/DictSelectionReader.cxx

Classes

Public Member Functions

Private Member Functions

Private Attributes

Constructor & Destructor Documentation

◆ DictSelectionReader()

Member Function Documentation

◆ ExtractTemplateArgValue()

◆ FirstPass()

◆ GetPointeeType()

◆ GetTmplArgList()

◆ InSelectionNamespace()

◆ ManageBaseClasses()

◆ ManageFields()

◆ PatternifyName()

◆ SecondPass()

◆ shouldVisitTemplateInstantiations()

◆ VisitRecordDecl()

Member Data Documentation

◆ fAutoSelectedClassFieldNames

◆ fClassNameSelectionRuleMap

◆ fIsFirstPass

◆ fNoAutoSelectedClassFieldNames

◆ fNormCtxt

◆ fSelectedRecordDecls

◆ fSelectionRules

◆ fSpecialNames

◆ fTemplateInfoMap