Class Declaration

A C/C++ declaration: for example, a variable declaration, a type declaration, or a function declaration.

This file defines two closely related classes: Declaration and DeclarationEntry. Some declarations do not correspond to a unique location in the source code. For example, a global variable might be declared in multiple source files:

  extern int myglobal;

and defined in one:

  int myglobal;

Each of these declarations (including the definition) is given its own distinct DeclarationEntry, but they all share the same Declaration.

Some derived class of Declaration do not have a corresponding DeclarationEntry, because they always have a unique source location. EnumConstant and FriendDecl are both examples of this.

Import path

import cpp

Direct supertypes

Indirect supertypes

Known direct subtypes

Predicates

getADeclarationEntry	Gets a declaration entry corresponding to this declaration. See the comment above this class for an explanation of the relationship between `Declaration` and `DeclarationEntry`.
getADeclarationLocation	Gets the location of a declaration entry corresponding to this declaration.
getAFile	Gets a file where this element occurs.
getASpecifier	Gets a specifier of this declaration.
getATemplateArgument	Gets a template argument used to instantiate this declaration from a template. When called on a template, this will return a template parameter type for both typed and non-typed parameters.
getATemplateArgumentKind	Gets a template argument used to instantiate this declaration from a template. When called on a template, this will return a non-typed template parameter value.
getDeclaringType	Gets the class where this member is declared, if it is a member. For templates, both the template itself and all instantiations of the template are considered to have the same declaring class.
getDefinition	Gets the declaration entry corresponding to this declaration that is a definition, if any.
getDefinitionLocation	Gets the location of the definition, if any.
getDescription	Gets a description of this `Declaration` for display purposes.
getLocation	Gets the preferred location of this declaration, if any.
getName	Gets the name of this declaration.
getNamespace	Gets the innermost namespace which contains this declaration.
getNumberOfTemplateArguments	Gets the number of template arguments for this declaration.
getQualifiedName	Gets the name of the declaration, fully qualified with its namespace and declaring type.
getTemplateArgument	Gets the `i`th template argument used to instantiate this declaration from a template.
getTemplateArgumentKind	Gets the `i`th template argument value used to instantiate this declaration from a template. When called on a template, this will return the `i`th template parameter value if it exists.
hasDeclaringType	Holds if this declaration is a member of a class/struct/union.
hasDefinition	Holds if the declaration has a definition.
hasGlobalName	Holds if this declaration has the given name in the global namespace.
hasGlobalOrStdName	Holds if this declaration has the given name in the global namespace or the `std` namespace.
hasGlobalOrStdOrBslName	Holds if this declaration has the given name in the global namespace, the `std` namespace or the `bsl` namespace. We treat `std` and `bsl` as the same in some of our models.
hasName	Holds if this declaration has the given name.
hasQualifiedName	DEPRECATED: Prefer `hasGlobalName` or the 2-argument or 3-argument `hasQualifiedName` predicates. To get the exact same results as this predicate in all edge cases, use `getQualifiedName()`.
hasQualifiedName	Holds if this declaration has a fully-qualified name with a name-space component of `namespaceQualifier`, no declaring type, and a base name of `baseName`.
hasQualifiedName	Holds if this declaration has a fully-qualified name with a name-space component of `namespaceQualifier`, a declaring type of `typeQualifier`, and a base name of `baseName`. Template parameters and arguments are stripped from all components. Missing components are `""`.
hasSpecifier	Holds if this declaration has a specifier with the given name.
isDefined	DEPRECATED: Use `hasDefinition` instead.
isMember	Holds if this declaration is a member of a class/struct/union.
isStatic	Holds if this declaration is static.
isTopLevel	Holds if this declaration is a top-level declaration.
toString	Gets a textual representation of this element.

Inherited predicates

findRootCause	Gets the source of this element: either itself or a macro that expanded to this element.	from Element
fromSource	Holds if this element may be from source. This predicate holds for all elements, except for those in the dummy file, whose name is the empty string. The dummy file contains declarations that are built directly into the compiler.	from Element
getAPrimaryQlClass	Gets the name of a primary CodeQL class to which this element belongs.	from ElementBase
getEnclosingElement	Gets the closest `Element` enclosing this one.	from Element
getFile	Gets the primary file where this element occurs.	from Element
getParentScope	Gets the parent scope of this `Element`, if any. A scope is a `Type` (`Class` / `Enum`), a `Namespace`, a `BlockStmt`, a `Function`, or certain kinds of `Statement`.	from Element
getPrimaryQlClasses	Gets a comma-separated list of the names of the primary CodeQL classes to which this element belongs.	from ElementBase
isAffectedByMacro	Holds if this element is affected in any way by a macro. All elements that are totally or partially generated by a macro are included, so this is a super-set of `isInMacroExpansion`.	from Element
isFromTemplateInstantiation	Holds if this `Element` is a part of a template instantiation (but not the template itself).	from Element
isFromUninstantiatedTemplate	Holds if this `Element` is part of a template `template` (not if it is part of an instantiation of `template`). This means it is represented in the database purely as syntax and without guarantees on the presence or correctness of type-based operations such as implicit conversions.	from Element
isInMacroExpansion	Holds if this element comes from a macro expansion. Only elements that are entirely generated by a macro are included - for elements that partially come from a macro, see `isAffectedByMacro`.	from Element