Class LocalVariable

A C/C++ local variable. In other words, any variable that has block scope [N4140 3.3.3], but is not a parameter of a Function or CatchBlock. For example the variables b and c in the following code:

void myFunction(int a) {
  int b;
  static int c;
}

Local variables can be static; use the isStatic member predicate to detect those.

A local variable can be declared by a DeclStmt or a ConditionDeclExpr.

Import path

import cpp

Direct supertypes

Indirect supertypes

Known direct subtypes

StaticLocalVariable

Predicates

getAPrimaryQlClass	Gets the name of a primary CodeQL class to which this element belongs.
getFunction	Gets the function to which this variable belongs.
getName	Gets the name of this variable.
getType	Gets the type of this variable.
isCompilerGenerated	Holds if this is a compiler-generated variable. For example, a range-based for loop typically has three compiler-generated variables, named `__range`, `__begin`, and `__end`:
isStatic	Holds if this declaration is static.

Inherited predicates

declaredUsingAutoType	Holds if the type of this variable is declared using the C++ `auto` keyword.	from Variable
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
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`.	from Variable
getADeclarationLocation	Gets the location of a declaration entry corresponding to this declaration.	from Variable
getAFile	Gets a file where this element occurs.	from Declaration
getASpecifier	Gets a specifier of this variable. This includes `extern`, `static`, `auto`, `private`, `protected`, `public`. Specifiers of the type of this variable, such as `const` and `volatile`, are instead accessed through `this.getType().getASpecifier()`.	from Variable
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.	from Declaration
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.	from Declaration
getAnAccess	Gets an access to this variable.	from Variable
getAnAssignedValue	Gets an expression that is assigned to this variable somewhere in the program.	from Variable
getAnAssignment	Gets an assignment expression that assigns to this variable. For example: `x=...` or `x+=...`.	from Variable
getAnAttribute	Gets an attribute of this variable.	from Variable
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.	from Declaration
getDefinition	Gets the declaration entry corresponding to this declaration that is a definition, if any.	from Variable
getDefinitionLocation	Gets the location of the definition, if any.	from Variable
getDescription	Gets a description of this `Declaration` for display purposes.	from Declaration
getEnclosingElement	Gets the closest `Element` enclosing this one.	from Element
getFile	Gets the primary file where this element occurs.	from Element
getInitializer	Gets the initializer of this variable, if any.	from Variable
getLocation	Gets the preferred location of this declaration, if any.	from Variable
getNamespace	Gets the innermost namespace which contains this declaration.	from Declaration
getNumberOfTemplateArguments	Gets the number of template arguments for this declaration.	from Declaration
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
getQualifiedName	Gets the name of the declaration, fully qualified with its namespace and declaring type.	from Declaration
getTemplateArgument	Gets the `i`th template argument used to instantiate this declaration from a template.	from Declaration
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.	from Declaration
getTypeWithAuto	Gets the type of this variable prior to deduction caused by the C++11 `auto` keyword.	from Variable
getUnderlyingType	Gets the type of this variable, after typedefs have been resolved.	from Variable
getUnspecifiedType	Gets the type of this variable, after specifiers have been deeply stripped and typedefs have been resolved.	from Variable
hasDeclaringType	Holds if this declaration is a member of a class/struct/union.	from Declaration
hasDefinition	Holds if the declaration has a definition.	from Declaration
hasGlobalName	Holds if this declaration has the given name in the global namespace.	from Declaration
hasGlobalOrStdName	Holds if this declaration has the given name in the global namespace or the `std` namespace.	from Declaration
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.	from Declaration
hasInitializer	Holds if this variable has an initializer.	from Variable
hasName	Holds if this declaration has the given name.	from Declaration
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`.	from Declaration
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 `""`.	from Declaration
hasSpecifier	Holds if this declaration has a specifier with the given name.	from Declaration
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
isConst	Holds if this variable is `const`.	from Variable
isConstexpr	Holds if this variable is `constexpr`.	from Variable
isConstinit	Holds if this variable is declared `constinit`.	from Variable
isConstructedFrom	Holds if this variable is constructed from `v` as a result of template instantiation. If so, it originates either from a template variable or from a variable nested in a template class.	from Variable
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
isMember	Holds if this declaration is a member of a class/struct/union.	from Declaration
isStructuredBinding	Holds if this variable is declared as part of a structured binding declaration. For example, `x` in `auto [x, y] = ...`.	from Variable
isThreadLocal	Holds if this variable is `thread_local`.	from Variable
isTopLevel	Holds if this declaration is a top-level declaration.	from Declaration
isVolatile	Holds if this variable is `volatile`.	from Variable
toString	Gets a textual representation of this element.	from Declaration