The common base class of all entity definitions found in the sources. More...

#include <definition.h>

Inheritance diagram for Definition:

Public Types
enum	DefType { TypeClass = 0, TypeFile = 1, TypeNamespace = 2, TypeModule = 3, TypeMember = 4, TypeGroup = 5, TypePackage = 6, TypePage = 7, TypeDir = 8, TypeConcept = 9 }

Public Member Functions
virtual DefType	definitionType () const =0

virtual CodeSymbolType	codeSymbolType () const =0

virtual bool	isAlias () const =0

virtual const QCString &	name () const =0

virtual bool	isAnonymous () const =0

virtual QCString	displayName (bool includeScope=TRUE) const =0

virtual const QCString &	localName () const =0

virtual QCString	qualifiedName () const =0

virtual QCString	symbolName () const =0

virtual QCString	getOutputFileBase () const =0

virtual QCString	anchor () const =0

virtual QCString	getSourceFileBase () const =0

virtual QCString	getSourceAnchor () const =0

virtual QCString	documentation () const =0

virtual int	docLine () const =0

virtual QCString	docFile () const =0

virtual QCString	briefDescription (bool abbreviate=FALSE) const =0

virtual QCString	briefDescriptionAsTooltip () const =0

virtual int	briefLine () const =0

virtual QCString	inbodyDocumentation () const =0

virtual QCString	inbodyFile () const =0

virtual int	inbodyLine () const =0

virtual QCString	briefFile () const =0

virtual QCString	getDefFileName () const =0

virtual QCString	getDefFileExtension () const =0

virtual int	getDefLine () const =0

virtual int	getDefColumn () const =0

virtual bool	hasDocumentation () const =0

virtual bool	hasUserDocumentation () const =0

virtual bool	isLinkableInProject () const =0

virtual bool	isLinkable () const =0

virtual bool	isVisibleInProject () const =0

virtual bool	isVisible () const =0

virtual bool	isHidden () const =0

virtual bool	isArtificial () const =0

virtual bool	isExported () const =0

virtual QCString	getReference () const =0

virtual bool	isReference () const =0

virtual QCString	externalReference (const QCString &relPath) const =0

virtual int	getStartDefLine () const =0

virtual int	getStartBodyLine () const =0

virtual int	getEndBodyLine () const =0

virtual const FileDef *	getBodyDef () const =0

virtual SrcLangExt	getLanguage () const =0
	Returns the programming language this definition was written in. More...

virtual const GroupList &	partOfGroups () const =0

virtual bool	isLinkableViaGroup () const =0

virtual const RefItemVector &	xrefListItems () const =0

virtual const Definition *	findInnerCompound (const QCString &name) const =0

virtual Definition *	getOuterScope () const =0

virtual const MemberVector &	getReferencesMembers () const =0

virtual const MemberVector &	getReferencedByMembers () const =0

virtual bool	hasSections () const =0

virtual bool	hasSources () const =0

virtual bool	hasBriefDescription () const =0
	returns TRUE if this class has a brief description

virtual QCString	id () const =0

virtual const SectionRefs &	getSectionRefs () const =0
	returns the section dictionary, only of importance for pagedef

virtual QCString	navigationPathAsString () const =0

virtual QCString	pathFragment () const =0

virtual void	_setSymbolName (const QCString &name)=0

virtual QCString	_symbolName () const =0

Friends
class	DefinitionImpl

DefinitionMutable *	toDefinitionMutable (Definition *)

DefinitionMutable *	toDefinitionMutable (const Definition *)

Detailed Description

The common base class of all entity definitions found in the sources.

This can be a class or a member function, or a file, or a namespace, etc. Use definitionType() to find which type of definition this is.

Member Enumeration Documentation

◆ DefType

enum Definition::DefType

Types of derived classes

Member Function Documentation

◆ anchor()

virtual QCString Definition::anchor ( ) const

pure virtual

Returns the anchor within a page where this item can be found

Implemented in MemberDefAliasImpl, ClassDefAliasImpl, ClassDef, ClassDefImpl, NamespaceDefAliasImpl, FileDefImpl, ConceptDefAliasImpl, DirDef, FileDef, MemberDefImpl, MemberDef, NamespaceDefImpl, GroupDefImpl, ModuleDefImpl, NamespaceDef, GroupDef, ConceptDefImpl, DirDefImpl, PageDefImpl, PageDef, and ConceptDef.

◆ briefDescription()

virtual QCString Definition::briefDescription ( bool abbreviate = FALSE ) const

pure virtual

Returns the brief description of this definition. This can include commands.

Implemented in MemberDefAliasImpl, MemberDef, and MemberDefImpl.

◆ briefDescriptionAsTooltip()

virtual QCString Definition::briefDescriptionAsTooltip ( ) const

pure virtual

Returns a plain text version of the brief description suitable for use as a tool tip.

◆ briefFile()

virtual QCString Definition::briefFile ( ) const

pure virtual

Returns the file in which the brief description was found. This can differ from getDefFileName().

◆ briefLine()

virtual int Definition::briefLine ( ) const

pure virtual

Returns the line number at which the brief description was found.

◆ codeSymbolType()

virtual CodeSymbolType Definition::codeSymbolType ( ) const

pure virtual

Used for syntax highlighting symbol class

Implemented in MemberDefAliasImpl, ClassDefAliasImpl, ClassDefImpl, NamespaceDefAliasImpl, FileDefImpl, ConceptDefAliasImpl, MemberDefImpl, NamespaceDefImpl, GroupDefImpl, ModuleDefImpl, DirDefImpl, ConceptDefImpl, and PageDefImpl.

◆ definitionType()

virtual DefType Definition::definitionType ( ) const

pure virtual

Use this for dynamic inspection of the type of the derived class

Implemented in MemberDefAliasImpl, ClassDefAliasImpl, ClassDefImpl, NamespaceDefAliasImpl, FileDefImpl, ClassDef, DirDef, ConceptDefAliasImpl, FileDef, MemberDefImpl, NamespaceDefImpl, GroupDefImpl, ModuleDefImpl, NamespaceDef, GroupDef, MemberDef, DirDefImpl, ConceptDefImpl, PageDefImpl, PageDef, and ConceptDef.

◆ displayName()

virtual QCString Definition::displayName ( bool includeScope = TRUE ) const

pure virtual

Returns the name of the definition as it appears in the output

Implemented in MemberDefAliasImpl, ClassDefAliasImpl, MemberDef, MemberDefImpl, ClassDefImpl, NamespaceDefAliasImpl, ClassDef, FileDefImpl, ConceptDefAliasImpl, DirDef, FileDef, NamespaceDefImpl, NamespaceDef, GroupDefImpl, ModuleDefImpl, PageDefImpl, GroupDef, PageDef, DirDefImpl, ConceptDefImpl, and ConceptDef.

◆ docFile()

virtual QCString Definition::docFile ( ) const

pure virtual

Returns the file in which the detailed documentation block was found. This can differ from getDefFileName().

◆ docLine()

virtual int Definition::docLine ( ) const

pure virtual

Returns the line number at which the detailed documentation was found.

◆ documentation()

virtual QCString Definition::documentation ( ) const

pure virtual

Returns the detailed description of this definition

Implemented in MemberDefAliasImpl, MemberDef, and MemberDefImpl.

◆ externalReference()

virtual QCString Definition::externalReference ( const QCString & relPath ) const

pure virtual

Convenience method to return a resolved external link

◆ getBodyDef()

virtual const FileDef* Definition::getBodyDef ( ) const

pure virtual

Returns the file in which the body of this item is located or 0 if no body is available.

◆ getDefColumn()

virtual int Definition::getDefColumn ( ) const

pure virtual

returns the column number at which the definition was found

◆ getDefFileExtension()

virtual QCString Definition::getDefFileExtension ( ) const

pure virtual

returns the extension of the file in which this definition was found

◆ getDefFileName()

virtual QCString Definition::getDefFileName ( ) const

pure virtual

returns the file in which this definition was found

◆ getDefLine()

virtual int Definition::getDefLine ( ) const

pure virtual

returns the line number at which the definition was found (can be the declaration)

◆ getEndBodyLine()

virtual int Definition::getEndBodyLine ( ) const

pure virtual

Returns the last line of the body of this item (applicable to classes and functions).

◆ getLanguage()

virtual SrcLangExt Definition::getLanguage ( ) const

pure virtual

Returns the programming language this definition was written in.

◆ getOutputFileBase()

virtual QCString Definition::getOutputFileBase ( ) const

pure virtual

Returns the base file name (without extension) of this definition. as it is referenced to/written to disk.

Implemented in MemberDefAliasImpl, ClassDefAliasImpl, ClassDefImpl, NamespaceDefAliasImpl, FileDefImpl, ClassDef, DirDef, ConceptDefAliasImpl, FileDef, MemberDefImpl, MemberDef, NamespaceDefImpl, GroupDefImpl, ModuleDefImpl, NamespaceDef, GroupDef, DirDefImpl, ConceptDefImpl, PageDefImpl, PageDef, and ConceptDef.

◆ getReference()

virtual QCString Definition::getReference ( ) const

pure virtual

If this definition was imported via a tag file, this function returns the tagfile for the external project. This can be translated into an external link target via Doxygen::tagDestinationDict

Implemented in MemberDefAliasImpl, ClassDefAliasImpl, ClassDefImpl, ClassDef, ConceptDefAliasImpl, MemberDefImpl, and MemberDef.

◆ getSourceAnchor()

virtual QCString Definition::getSourceAnchor ( ) const

pure virtual

Returns the anchor of the source listing of this definition.

◆ getSourceFileBase()

virtual QCString Definition::getSourceFileBase ( ) const

pure virtual

Returns the name of the source listing of this definition.

Implemented in ClassDefAliasImpl, ClassDefImpl, FileDefImpl, ClassDef, and FileDef.

◆ getStartBodyLine()

virtual int Definition::getStartBodyLine ( ) const

pure virtual

Returns the first line of the body of this item (applicable to classes and functions).

◆ getStartDefLine()

virtual int Definition::getStartDefLine ( ) const

pure virtual

Returns the first line of the implementation of this item. See also getDefLine()

◆ hasDocumentation()

virtual bool Definition::hasDocumentation ( ) const

pure virtual

Returns TRUE iff the definition is documented (which could be generated documentation)

See also: hasUserDocumentation()

Implemented in MemberDefAliasImpl, ClassDefAliasImpl, ClassDefImpl, MemberDef, MemberDefImpl, and ClassDef.

◆ hasUserDocumentation()

virtual bool Definition::hasUserDocumentation ( ) const

pure virtual

Returns TRUE iff the definition is documented by the user.

◆ inbodyDocumentation()

virtual QCString Definition::inbodyDocumentation ( ) const

pure virtual

Returns the documentation found inside the body of a member

◆ inbodyFile()

virtual QCString Definition::inbodyFile ( ) const

pure virtual

Returns the file in which the in body documentation was found

◆ inbodyLine()

virtual int Definition::inbodyLine ( ) const

pure virtual

Returns the line at which the first in body documentation part was found

◆ isAlias()

virtual bool Definition::isAlias ( ) const

pure virtual

Returns TRUE if this is an alias of another definition

◆ isAnonymous()

virtual bool Definition::isAnonymous ( ) const

pure virtual

Returns TRUE iff this definition has an artificially generated name (typically starting with a @) that is used for nameless definitions

◆ isArtificial()

virtual bool Definition::isArtificial ( ) const

pure virtual

Returns TRUE if this entity was artificially introduced, for instance because it is used to show a template instantiation relation.

◆ isExported()

virtual bool Definition::isExported ( ) const

pure virtual

Returns TRUE iff this entity was exported from a C++20 module.

◆ isHidden()

virtual bool Definition::isHidden ( ) const

pure virtual

Returns TRUE iff this item is supposed to be hidden from the output.

◆ isLinkable()

virtual bool Definition::isLinkable ( ) const

pure virtual

Returns TRUE iff it is possible to link to this item. This can be a link to another project imported via a tag file.

Implemented in MemberDefAliasImpl, ClassDefAliasImpl, ClassDefImpl, NamespaceDefAliasImpl, MemberDef, ClassDef, MemberDefImpl, FileDefImpl, FileDef, ConceptDefAliasImpl, DirDef, NamespaceDefImpl, GroupDefImpl, GroupDef, NamespaceDef, ModuleDefImpl, ConceptDefImpl, DirDefImpl, PageDefImpl, ConceptDef, and PageDef.

◆ isLinkableInProject()

virtual bool Definition::isLinkableInProject ( ) const

pure virtual

Returns TRUE iff it is possible to link to this item within this project.

Implemented in MemberDefAliasImpl, ClassDefAliasImpl, ClassDefImpl, NamespaceDefAliasImpl, MemberDef, ClassDef, MemberDefImpl, FileDefImpl, FileDef, ConceptDefAliasImpl, DirDef, NamespaceDefImpl, GroupDefImpl, GroupDef, NamespaceDef, ModuleDefImpl, ConceptDefImpl, DirDefImpl, PageDefImpl, ConceptDef, and PageDef.

◆ isReference()

virtual bool Definition::isReference ( ) const

pure virtual

Returns TRUE if this definition is imported via a tag file.

Implemented in MemberDefAliasImpl, ClassDefAliasImpl, MemberDef, MemberDefImpl, ClassDefImpl, ClassDef, and ConceptDefAliasImpl.

◆ isVisible()

virtual bool Definition::isVisible ( ) const

pure virtual

Returns TRUE iff the name may appear in the output

◆ isVisibleInProject()

virtual bool Definition::isVisibleInProject ( ) const

pure virtual

Returns TRUE iff the name is part of this project and may appear in the output

◆ localName()

virtual const QCString& Definition::localName ( ) const

pure virtual

Returns the local name without any scope qualifiers.

Implemented in NamespaceDefAliasImpl.

◆ name()

virtual const QCString& Definition::name ( ) const

pure virtual

Returns the name of the definition

Implemented in MemberDefAliasImpl, FileDefImpl, and FileDef.

◆ qualifiedName()

virtual QCString Definition::qualifiedName ( ) const

pure virtual

Returns the fully qualified name of this definition

Implemented in MemberDefAliasImpl, MemberDef, MemberDefImpl, and ModuleDefImpl.

◆ symbolName()

virtual QCString Definition::symbolName ( ) const

pure virtual

Returns the name of this definition as it appears in the symbol map.

The documentation for this class was generated from the following file:

src/definition.h

Public Types

Public Member Functions

Friends

Detailed Description

Member Enumeration Documentation

◆ DefType

Member Function Documentation

◆ anchor()

◆ briefDescription()

◆ briefDescriptionAsTooltip()

◆ briefFile()

◆ briefLine()

◆ codeSymbolType()

◆ definitionType()

◆ displayName()

◆ docFile()

◆ docLine()

◆ documentation()

◆ externalReference()

◆ getBodyDef()

◆ getDefColumn()

◆ getDefFileExtension()

◆ getDefFileName()

◆ getDefLine()

◆ getEndBodyLine()

◆ getLanguage()

◆ getOutputFileBase()

◆ getReference()

◆ getSourceAnchor()

◆ getSourceFileBase()

◆ getStartBodyLine()

◆ getStartDefLine()

◆ hasDocumentation()

◆ hasUserDocumentation()

◆ inbodyDocumentation()

◆ inbodyFile()

◆ inbodyLine()

◆ isAlias()

◆ isAnonymous()

◆ isArtificial()

◆ isExported()

◆ isHidden()

◆ isLinkable()

◆ isLinkableInProject()

◆ isReference()

◆ isVisible()

◆ isVisibleInProject()

◆ localName()

◆ name()

◆ qualifiedName()

◆ symbolName()