CodeQL library for C/C++
codeql/cpp-all 0.12.11 (changelog, source)
Search

Class Parameter

A C/C++ function parameter or catch block parameter. For example the function parameter p and the catch block parameter e in the following code:

void myFunction(int p) {
  try {
    ...
  } catch (const std::exception &e) {
    ...
  }
}

For catch block parameters, there is a one-to-one correspondence between the Parameter and its ParameterDeclarationEntry.

For function parameters, there is a one-to-many relationship between Parameter and ParameterDeclarationEntry, because one function can have multiple declarations.

Import path

import cpp

Direct supertypes

Indirect supertypes

Known direct subtypes

    Predicates

    getAPrimaryQlClass

    Gets the name of a primary CodeQL class to which this element belongs.

    getCatchBlock

    Gets the catch block to which this parameter belongs, if it is a catch block parameter.

    getFunction

    Gets the function to which this parameter belongs, if it is a function parameter.

    getIndex

    Gets the zero-based index of this parameter.

    getLocation

    Gets the canonical location, or locations, of this parameter.

    getName

    Gets the canonical name, or names, of this parameter.

    getType

    Gets the type of this parameter.

    getTypedName

    Gets the name of this parameter, including it’s type.

    isNamed

    Holds if this parameter has a name.

    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
    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 ith template argument used to instantiate this declaration from a template.

    from Declaration
    getTemplateArgumentKind

    Gets the ith template argument value used to instantiate this declaration from a template. When called on a template, this will return the ith 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

    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().

    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
    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:

    from Variable
    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
    isDefined

    DEPRECATED: Use hasDefinition instead.

    from Declaration
    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
    isStatic

    Holds if this declaration is static.

    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