clang  3.9.0
Namespaces | Classes | Functions | Variables
clang::ast_matchers Namespace Reference

Namespaces

 dynamic
 
 internal
 

Classes

class  BoundNodes
 Maps string IDs to AST nodes matched by parts of a matcher. More...
 
class  MatchFinder
 A class to allow finding matches over the Clang AST. More...
 

Typedefs

typedef internal::Matcher< DeclDeclarationMatcher
 Types of matchers for the top-level classes in the AST class hierarchy. More...
 
typedef internal::Matcher< StmtStatementMatcher
 
typedef internal::Matcher
< QualType
TypeMatcher
 
typedef internal::Matcher
< TypeLoc
TypeLocMatcher
 
typedef internal::Matcher
< NestedNameSpecifier
NestedNameSpecifierMatcher
 
typedef internal::Matcher
< NestedNameSpecifierLoc
NestedNameSpecifierLocMatcher
 

Functions

template<typename T >
internal::Matcher< T > id (StringRef ID, const internal::BindableMatcher< T > &InnerMatcher)
 If the provided matcher matches a node, binds the node to ID. More...
 
internal::TrueMatcher anything ()
 Matches any node. More...
 
 AST_POLYMORPHIC_MATCHER (isExpansionInMainFile, AST_POLYMORPHIC_SUPPORTED_TYPES(Decl, Stmt, TypeLoc))
 Matches AST nodes that were expanded within the main-file. More...
 
 AST_POLYMORPHIC_MATCHER (isExpansionInSystemHeader, AST_POLYMORPHIC_SUPPORTED_TYPES(Decl, Stmt, TypeLoc))
 Matches AST nodes that were expanded within system-header-files. More...
 
 AST_POLYMORPHIC_MATCHER_P (isExpansionInFileMatching, AST_POLYMORPHIC_SUPPORTED_TYPES(Decl, Stmt, TypeLoc), std::string, RegExp)
 Matches AST nodes that were expanded within files whose name is partially matching a given regex. More...
 
 AST_MATCHER (Decl, isPublic)
 Matches public C++ declarations. More...
 
 AST_MATCHER (Decl, isProtected)
 Matches protected C++ declarations. More...
 
 AST_MATCHER (Decl, isPrivate)
 Matches private C++ declarations. More...
 
 AST_MATCHER (FieldDecl, isBitField)
 Matches non-static data members that are bit-fields. More...
 
 AST_MATCHER_P (FieldDecl, hasBitWidth, unsigned, Width)
 Matches non-static data members that are bit-fields. More...
 
 AST_MATCHER (Decl, isImplicit)
 Matches a declaration that has been implicitly added by the compiler (eg. More...
 
 AST_POLYMORPHIC_MATCHER_P (hasAnyTemplateArgument, AST_POLYMORPHIC_SUPPORTED_TYPES(ClassTemplateSpecializationDecl, TemplateSpecializationType), internal::Matcher< TemplateArgument >, InnerMatcher)
 Matches classTemplateSpecializations that have at least one TemplateArgument matching the given InnerMatcher. More...
 
 AST_MATCHER_P (Expr, ignoringImplicit, ast_matchers::internal::Matcher< Expr >, InnerMatcher)
 Matches expressions that match InnerMatcher after any implicit AST nodes are stripped off. More...
 
 AST_MATCHER_P (Expr, ignoringImpCasts, internal::Matcher< Expr >, InnerMatcher)
 Matches expressions that match InnerMatcher after any implicit casts are stripped off. More...
 
 AST_MATCHER_P (Expr, ignoringParenCasts, internal::Matcher< Expr >, InnerMatcher)
 Matches expressions that match InnerMatcher after parentheses and casts are stripped off. More...
 
 AST_MATCHER_P (Expr, ignoringParenImpCasts, internal::Matcher< Expr >, InnerMatcher)
 Matches expressions that match InnerMatcher after implicit casts and parentheses are stripped off. More...
 
 AST_MATCHER_P (QualType, ignoringParens, internal::Matcher< QualType >, InnerMatcher)
 Matches types that match InnerMatcher after any parens are stripped. More...
 
 AST_POLYMORPHIC_MATCHER_P2 (hasTemplateArgument, AST_POLYMORPHIC_SUPPORTED_TYPES(ClassTemplateSpecializationDecl, TemplateSpecializationType), unsigned, N, internal::Matcher< TemplateArgument >, InnerMatcher)
 Matches classTemplateSpecializations where the n'th TemplateArgument matches the given InnerMatcher. More...
 
 AST_POLYMORPHIC_MATCHER_P (templateArgumentCountIs, AST_POLYMORPHIC_SUPPORTED_TYPES(ClassTemplateSpecializationDecl, TemplateSpecializationType), unsigned, N)
 Matches if the number of template arguments equals N. More...
 
 AST_MATCHER_P (TemplateArgument, refersToType, internal::Matcher< QualType >, InnerMatcher)
 Matches a TemplateArgument that refers to a certain type. More...
 
 AST_MATCHER_P (TemplateArgument, refersToDeclaration, internal::Matcher< Decl >, InnerMatcher)
 Matches a canonical TemplateArgument that refers to a certain declaration. More...
 
 AST_MATCHER_P (TemplateArgument, isExpr, internal::Matcher< Expr >, InnerMatcher)
 Matches a sugar TemplateArgument that refers to a certain expression. More...
 
 AST_MATCHER (TemplateArgument, isIntegral)
 Matches a TemplateArgument that is an integral value. More...
 
 AST_MATCHER_P (TemplateArgument, refersToIntegralType, internal::Matcher< QualType >, InnerMatcher)
 Matches a TemplateArgument that referes to an integral type. More...
 
 AST_MATCHER_P (TemplateArgument, equalsIntegralValue, std::string, Value)
 Matches a TemplateArgument of integral type with a given value. More...
 
 AST_MATCHER_P (InitListExpr, hasSyntacticForm, internal::Matcher< Expr >, InnerMatcher)
 Matches the syntactic form of init list expressions (if expression have it). More...
 
 AST_MATCHER_P (ForStmt, hasIncrement, internal::Matcher< Stmt >, InnerMatcher)
 Matches the increment statement of a for loop. More...
 
 AST_MATCHER_P (ForStmt, hasLoopInit, internal::Matcher< Stmt >, InnerMatcher)
 Matches the initialization statement of a for loop. More...
 
 AST_MATCHER_P (CXXForRangeStmt, hasLoopVariable, internal::Matcher< VarDecl >, InnerMatcher)
 Matches the initialization statement of a for loop. More...
 
 AST_MATCHER_P (CXXForRangeStmt, hasRangeInit, internal::Matcher< Expr >, InnerMatcher)
 Matches the range initialization statement of a for loop. More...
 
 AST_MATCHER_P (DesignatedInitExpr, designatorCountIs, unsigned, N)
 Matches designated initializer expressions that contain a specific number of designators. More...
 
 AST_MATCHER_P (UnaryExprOrTypeTraitExpr, hasArgumentOfType, internal::Matcher< QualType >, InnerMatcher)
 Matches unary expressions that have a specific type of argument. More...
 
 AST_MATCHER_P (UnaryExprOrTypeTraitExpr, ofKind, UnaryExprOrTypeTrait, Kind)
 Matches unary expressions of a certain kind. More...
 
internal::Matcher< StmtalignOfExpr (const internal::Matcher< UnaryExprOrTypeTraitExpr > &InnerMatcher)
 Same as unaryExprOrTypeTraitExpr, but only matching alignof. More...
 
internal::Matcher< StmtsizeOfExpr (const internal::Matcher< UnaryExprOrTypeTraitExpr > &InnerMatcher)
 Same as unaryExprOrTypeTraitExpr, but only matching sizeof. More...
 
internal::Matcher< NamedDeclhasName (const std::string &Name)
 Matches NamedDecl nodes that have the specified name. More...
 
 AST_MATCHER_P (NamedDecl, matchesName, std::string, RegExp)
 Matches NamedDecl nodes whose fully qualified names contain a substring matched by the given RegExp. More...
 
internal::PolymorphicMatcherWithParam1
< internal::HasOverloadedOperatorNameMatcher,
StringRef,
AST_POLYMORPHIC_SUPPORTED_TYPES(CXXOperatorCallExpr,
FunctionDecl)> 
hasOverloadedOperatorName (StringRef Name)
 Matches overloaded operator names. More...
 
 AST_MATCHER_P (CXXRecordDecl, isDerivedFrom, internal::Matcher< NamedDecl >, Base)
 Matches C++ classes that are directly or indirectly derived from a class matching Base. More...
 
 AST_MATCHER_P_OVERLOAD (CXXRecordDecl, isDerivedFrom, std::string, BaseName, 1)
 Overloaded method as shortcut for isDerivedFrom(hasName(...)). More...
 
 AST_MATCHER_P_OVERLOAD (CXXRecordDecl, isSameOrDerivedFrom, internal::Matcher< NamedDecl >, Base, 0)
 Similar to isDerivedFrom(), but also matches classes that directly match Base. More...
 
 AST_MATCHER_P_OVERLOAD (CXXRecordDecl, isSameOrDerivedFrom, std::string, BaseName, 1)
 Overloaded method as shortcut for isSameOrDerivedFrom(hasName(...)). More...
 
 AST_MATCHER_P (CXXRecordDecl, hasMethod, internal::Matcher< CXXMethodDecl >, InnerMatcher)
 Matches the first method of a class or struct that satisfies InnerMatcher. More...
 
 AST_MATCHER (CXXRecordDecl, isLambda)
 Matches the generated class of lambda expressions. More...
 
template<typename T >
internal::Matcher< T > findAll (const internal::Matcher< T > &Matcher)
 Matches if the node or any descendant matches. More...
 
internal::PolymorphicMatcherWithParam1
< internal::HasDeclarationMatcher,
internal::Matcher< Decl >
, void(internal::HasDeclarationSupportedTypes)> 
hasDeclaration (const internal::Matcher< Decl > &InnerMatcher)
 Matches a node if the declaration associated with that node matches the given matcher. More...
 
 AST_MATCHER_P (CXXMemberCallExpr, on, internal::Matcher< Expr >, InnerMatcher)
 Matches on the implicit object argument of a member call expression. More...
 
 AST_MATCHER_P (ObjCMessageExpr, hasReceiverType, internal::Matcher< QualType >, InnerMatcher)
 Matches on the receiver of an ObjectiveC Message expression. More...
 
 AST_MATCHER_P (ObjCMessageExpr, hasSelector, std::string, BaseName)
 Matches when BaseName == Selector.getAsString() More...
 
 AST_MATCHER_P (ObjCMessageExpr, matchesSelector, std::string, RegExp)
 Matches ObjC selectors whose name contains a substring matched by the given RegExp. More...
 
 AST_MATCHER (ObjCMessageExpr, hasNullSelector)
 Matches when the selector is the empty selector. More...
 
 AST_MATCHER (ObjCMessageExpr, hasUnarySelector)
 Matches when the selector is a Unary Selector. More...
 
 AST_MATCHER (ObjCMessageExpr, hasKeywordSelector)
 Matches when the selector is a keyword selector. More...
 
 AST_MATCHER_P (ObjCMessageExpr, numSelectorArgs, unsigned, N)
 Matches when the selector has the specified number of arguments. More...
 
 AST_MATCHER_P (CallExpr, callee, internal::Matcher< Stmt >, InnerMatcher)
 Matches if the call expression's callee expression matches. More...
 
 AST_MATCHER_P_OVERLOAD (CallExpr, callee, internal::Matcher< Decl >, InnerMatcher, 1)
 Matches if the call expression's callee's declaration matches the given matcher. More...
 
 AST_POLYMORPHIC_MATCHER_P_OVERLOAD (hasType, AST_POLYMORPHIC_SUPPORTED_TYPES(Expr, TypedefNameDecl, ValueDecl), internal::Matcher< QualType >, InnerMatcher, 0)
 Matches if the expression's or declaration's type matches a type matcher. More...
 
 AST_POLYMORPHIC_MATCHER_P_OVERLOAD (hasType, AST_POLYMORPHIC_SUPPORTED_TYPES(Expr, ValueDecl), internal::Matcher< Decl >, InnerMatcher, 1)
 Overloaded to match the declaration of the expression's or value declaration's type. More...
 
 AST_MATCHER_P (DeclaratorDecl, hasTypeLoc, internal::Matcher< TypeLoc >, Inner)
 Matches if the type location of the declarator decl's type matches the inner matcher. More...
 
 AST_MATCHER_P (QualType, asString, std::string, Name)
 Matches if the matched type is represented by the given string. More...
 
 AST_MATCHER_P (QualType, pointsTo, internal::Matcher< QualType >, InnerMatcher)
 Matches if the matched type is a pointer type and the pointee type matches the specified matcher. More...
 
 AST_MATCHER_P_OVERLOAD (QualType, pointsTo, internal::Matcher< Decl >, InnerMatcher, 1)
 Overloaded to match the pointee type's declaration. More...
 
 AST_MATCHER_P (QualType, references, internal::Matcher< QualType >, InnerMatcher)
 Matches if the matched type is a reference type and the referenced type matches the specified matcher. More...
 
 AST_MATCHER_P (QualType, hasCanonicalType, internal::Matcher< QualType >, InnerMatcher)
 Matches QualTypes whose canonical type matches InnerMatcher. More...
 
 AST_MATCHER_P_OVERLOAD (QualType, references, internal::Matcher< Decl >, InnerMatcher, 1)
 Overloaded to match the referenced type's declaration. More...
 
 AST_MATCHER_P (CXXMemberCallExpr, onImplicitObjectArgument, internal::Matcher< Expr >, InnerMatcher)
 
 AST_MATCHER_P_OVERLOAD (CXXMemberCallExpr, thisPointerType, internal::Matcher< QualType >, InnerMatcher, 0)
 Matches if the expression's type either matches the specified matcher, or is a pointer to a type that matches the InnerMatcher. More...
 
 AST_MATCHER_P_OVERLOAD (CXXMemberCallExpr, thisPointerType, internal::Matcher< Decl >, InnerMatcher, 1)
 Overloaded to match the type's declaration. More...
 
 AST_MATCHER_P (DeclRefExpr, to, internal::Matcher< Decl >, InnerMatcher)
 Matches a DeclRefExpr that refers to a declaration that matches the specified matcher. More...
 
 AST_MATCHER_P (DeclRefExpr, throughUsingDecl, internal::Matcher< UsingShadowDecl >, InnerMatcher)
 Matches a DeclRefExpr that refers to a declaration through a specific using shadow declaration. More...
 
 AST_MATCHER_P (DeclStmt, hasSingleDecl, internal::Matcher< Decl >, InnerMatcher)
 Matches the Decl of a DeclStmt which has a single declaration. More...
 
 AST_MATCHER_P (VarDecl, hasInitializer, internal::Matcher< Expr >, InnerMatcher)
 Matches a variable declaration that has an initializer expression that matches the given matcher. More...
 
 AST_MATCHER (VarDecl, hasLocalStorage)
 Matches a variable declaration that has function scope and is a non-static local variable. More...
 
 AST_MATCHER (VarDecl, hasGlobalStorage)
 Matches a variable declaration that does not have local storage. More...
 
 AST_MATCHER (VarDecl, hasAutomaticStorageDuration)
 Matches a variable declaration that has automatic storage duration. More...
 
 AST_MATCHER (VarDecl, hasStaticStorageDuration)
 Matches a variable declaration that has static storage duration. More...
 
 AST_MATCHER (VarDecl, hasThreadStorageDuration)
 Matches a variable declaration that has thread storage duration. More...
 
 AST_MATCHER (VarDecl, isExceptionVariable)
 Matches a variable declaration that is an exception variable from a C++ catch block, or an Objective-C @catch statement. More...
 
 AST_POLYMORPHIC_MATCHER_P (argumentCountIs, AST_POLYMORPHIC_SUPPORTED_TYPES(CallExpr, CXXConstructExpr, ObjCMessageExpr), unsigned, N)
 Checks that a call expression or a constructor call expression has a specific number of arguments (including absent default arguments). More...
 
 AST_POLYMORPHIC_MATCHER_P2 (hasArgument, AST_POLYMORPHIC_SUPPORTED_TYPES(CallExpr, CXXConstructExpr, ObjCMessageExpr), unsigned, N, internal::Matcher< Expr >, InnerMatcher)
 Matches the n'th argument of a call expression or a constructor call expression. More...
 
 AST_MATCHER_P (DeclStmt, declCountIs, unsigned, N)
 Matches declaration statements that contain a specific number of declarations. More...
 
 AST_MATCHER_P2 (DeclStmt, containsDeclaration, unsigned, N, internal::Matcher< Decl >, InnerMatcher)
 Matches the n'th declaration of a declaration statement. More...
 
 AST_MATCHER_P (CXXConstructorDecl, hasAnyConstructorInitializer, internal::Matcher< CXXCtorInitializer >, InnerMatcher)
 Matches a C++ catch statement that has a catch-all handler. More...
 
 AST_MATCHER_P (CXXCtorInitializer, forField, internal::Matcher< FieldDecl >, InnerMatcher)
 Matches the field declaration of a constructor initializer. More...
 
 AST_MATCHER_P (CXXCtorInitializer, withInitializer, internal::Matcher< Expr >, InnerMatcher)
 Matches the initializer expression of a constructor initializer. More...
 
 AST_MATCHER (CXXCtorInitializer, isWritten)
 Matches a constructor initializer if it is explicitly written in code (as opposed to implicitly added by the compiler). More...
 
 AST_MATCHER (CXXCtorInitializer, isBaseInitializer)
 Matches a constructor initializer if it is initializing a base, as opposed to a member. More...
 
 AST_MATCHER (CXXCtorInitializer, isMemberInitializer)
 Matches a constructor initializer if it is initializing a member, as opposed to a base. More...
 
 AST_POLYMORPHIC_MATCHER_P (hasAnyArgument, AST_POLYMORPHIC_SUPPORTED_TYPES(CallExpr, CXXConstructExpr), internal::Matcher< Expr >, InnerMatcher)
 Matches any argument of a call expression or a constructor call expression. More...
 
 AST_MATCHER (CXXConstructExpr, isListInitialization)
 Matches a constructor call expression which uses list initialization. More...
 
 AST_MATCHER (CXXConstructExpr, requiresZeroInitialization)
 Matches a constructor call expression which requires zero initialization. More...
 
 AST_MATCHER_P2 (FunctionDecl, hasParameter, unsigned, N, internal::Matcher< ParmVarDecl >, InnerMatcher)
 Matches the n'th parameter of a function declaration. More...
 
 AST_POLYMORPHIC_MATCHER_P2 (forEachArgumentWithParam, AST_POLYMORPHIC_SUPPORTED_TYPES(CallExpr, CXXConstructExpr), internal::Matcher< Expr >, ArgMatcher, internal::Matcher< ParmVarDecl >, ParamMatcher)
 Matches all arguments and their respective ParmVarDecl. More...
 
 AST_MATCHER_P (FunctionDecl, hasAnyParameter, internal::Matcher< ParmVarDecl >, InnerMatcher)
 Matches any parameter of a function declaration. More...
 
 AST_POLYMORPHIC_MATCHER_P (parameterCountIs, AST_POLYMORPHIC_SUPPORTED_TYPES(FunctionDecl, FunctionProtoType), unsigned, N)
 Matches FunctionDecls and FunctionProtoTypes that have a specific parameter count. More...
 
 AST_MATCHER_P (FunctionDecl, returns, internal::Matcher< QualType >, InnerMatcher)
 Matches the return type of a function declaration. More...
 
 AST_MATCHER (FunctionDecl, isExternC)
 Matches extern "C" function declarations. More...
 
 AST_MATCHER (FunctionDecl, isDeleted)
 Matches deleted function declarations. More...
 
 AST_MATCHER (FunctionDecl, isDefaulted)
 Matches defaulted function declarations. More...
 
 AST_POLYMORPHIC_MATCHER (hasDynamicExceptionSpec, AST_POLYMORPHIC_SUPPORTED_TYPES(FunctionDecl, FunctionProtoType))
 Matches functions that have a dynamic exception specification. More...
 
 AST_POLYMORPHIC_MATCHER (isNoThrow, AST_POLYMORPHIC_SUPPORTED_TYPES(FunctionDecl, FunctionProtoType))
 Matches functions that have a non-throwing exception specification. More...
 
 AST_POLYMORPHIC_MATCHER (isConstexpr, AST_POLYMORPHIC_SUPPORTED_TYPES(VarDecl, FunctionDecl))
 Matches constexpr variable and function declarations. More...
 
 AST_POLYMORPHIC_MATCHER_P (hasCondition, AST_POLYMORPHIC_SUPPORTED_TYPES(IfStmt, ForStmt, WhileStmt, DoStmt, SwitchStmt, AbstractConditionalOperator), internal::Matcher< Expr >, InnerMatcher)
 Matches the condition expression of an if statement, for loop, switch statement or conditional operator. More...
 
 AST_MATCHER_P (IfStmt, hasThen, internal::Matcher< Stmt >, InnerMatcher)
 Matches the then-statement of an if statement. More...
 
 AST_MATCHER_P (IfStmt, hasElse, internal::Matcher< Stmt >, InnerMatcher)
 Matches the else-statement of an if statement. More...
 
 AST_POLYMORPHIC_MATCHER_P (equalsBoundNode, AST_POLYMORPHIC_SUPPORTED_TYPES(Stmt, Decl, Type, QualType), std::string, ID)
 Matches if a node equals a previously bound node. More...
 
 AST_MATCHER_P (IfStmt, hasConditionVariableStatement, internal::Matcher< DeclStmt >, InnerMatcher)
 Matches the condition variable statement in an if statement. More...
 
 AST_MATCHER_P (ArraySubscriptExpr, hasIndex, internal::Matcher< Expr >, InnerMatcher)
 Matches the index expression of an array subscript expression. More...
 
 AST_MATCHER_P (ArraySubscriptExpr, hasBase, internal::Matcher< Expr >, InnerMatcher)
 Matches the base expression of an array subscript expression. More...
 
 AST_POLYMORPHIC_MATCHER_P (hasBody, AST_POLYMORPHIC_SUPPORTED_TYPES(DoStmt, ForStmt, WhileStmt, CXXForRangeStmt, FunctionDecl), internal::Matcher< Stmt >, InnerMatcher)
 Matches a 'for', 'while', 'do while' statement or a function definition that has a given body. More...
 
 AST_POLYMORPHIC_MATCHER_P (hasAnySubstatement, AST_POLYMORPHIC_SUPPORTED_TYPES(CompoundStmt, StmtExpr), internal::Matcher< Stmt >, InnerMatcher)
 Matches compound statements where at least one substatement matches a given matcher. More...
 
 AST_MATCHER_P (CompoundStmt, statementCountIs, unsigned, N)
 Checks that a compound statement contains a specific number of child statements. More...
 
template<typename ValueT >
internal::PolymorphicMatcherWithParam1
< internal::ValueEqualsMatcher,
ValueT > 
equals (const ValueT &Value)
 Matches literals that are equal to the given value. More...
 
 AST_POLYMORPHIC_MATCHER_P (hasOperatorName, AST_POLYMORPHIC_SUPPORTED_TYPES(BinaryOperator, UnaryOperator), std::string, Name)
 Matches the operator Name of operator expressions (binary or unary). More...
 
 AST_POLYMORPHIC_MATCHER_P (hasLHS, AST_POLYMORPHIC_SUPPORTED_TYPES(BinaryOperator, ArraySubscriptExpr), internal::Matcher< Expr >, InnerMatcher)
 Matches the left hand side of binary operator expressions. More...
 
 AST_POLYMORPHIC_MATCHER_P (hasRHS, AST_POLYMORPHIC_SUPPORTED_TYPES(BinaryOperator, ArraySubscriptExpr), internal::Matcher< Expr >, InnerMatcher)
 Matches the right hand side of binary operator expressions. More...
 
internal::Matcher< BinaryOperatorhasEitherOperand (const internal::Matcher< Expr > &InnerMatcher)
 Matches if either the left hand side or the right hand side of a binary operator matches. More...
 
 AST_MATCHER_P (UnaryOperator, hasUnaryOperand, internal::Matcher< Expr >, InnerMatcher)
 Matches if the operand of a unary operator matches. More...
 
 AST_POLYMORPHIC_MATCHER_P (hasSourceExpression, AST_POLYMORPHIC_SUPPORTED_TYPES(CastExpr, OpaqueValueExpr), internal::Matcher< Expr >, InnerMatcher)
 Matches if the cast's source expression or opaque value's source expression matches the given matcher. More...
 
 AST_MATCHER_P (CastExpr, hasCastKind, CastKind, Kind)
 Matches casts that has a given cast kind. More...
 
 AST_MATCHER_P (ExplicitCastExpr, hasDestinationType, internal::Matcher< QualType >, InnerMatcher)
 Matches casts whose destination type matches a given matcher. More...
 
 AST_MATCHER_P (ImplicitCastExpr, hasImplicitDestinationType, internal::Matcher< QualType >, InnerMatcher)
 Matches implicit casts whose destination type matches a given matcher. More...
 
 AST_MATCHER (RecordDecl, isStruct)
 Matches RecordDecl object that are spelled with "struct.". More...
 
 AST_MATCHER (RecordDecl, isUnion)
 Matches RecordDecl object that are spelled with "union.". More...
 
 AST_MATCHER (RecordDecl, isClass)
 Matches RecordDecl object that are spelled with "class.". More...
 
 AST_MATCHER_P (AbstractConditionalOperator, hasTrueExpression, internal::Matcher< Expr >, InnerMatcher)
 Matches the true branch expression of a conditional operator. More...
 
 AST_MATCHER_P (AbstractConditionalOperator, hasFalseExpression, internal::Matcher< Expr >, InnerMatcher)
 Matches the false branch expression of a conditional operator (binary or ternary). More...
 
 AST_POLYMORPHIC_MATCHER (isDefinition, AST_POLYMORPHIC_SUPPORTED_TYPES(TagDecl, VarDecl, FunctionDecl))
 Matches if a declaration has a body attached. More...
 
 AST_MATCHER (FunctionDecl, isVariadic)
 Matches if a function declaration is variadic. More...
 
 AST_MATCHER_P (CXXMethodDecl, ofClass, internal::Matcher< CXXRecordDecl >, InnerMatcher)
 Matches the class declaration that the given method declaration belongs to. More...
 
 AST_MATCHER_P (CXXMethodDecl, forEachOverridden, internal::Matcher< CXXMethodDecl >, InnerMatcher)
 Matches each method overriden by the given method. More...
 
 AST_MATCHER (CXXMethodDecl, isVirtual)
 Matches if the given method declaration is virtual. More...
 
 AST_MATCHER (CXXMethodDecl, isVirtualAsWritten)
 Matches if the given method declaration has an explicit "virtual". More...
 
 AST_POLYMORPHIC_MATCHER (isFinal, AST_POLYMORPHIC_SUPPORTED_TYPES(CXXRecordDecl, CXXMethodDecl))
 Matches if the given method or class declaration is final. More...
 
 AST_MATCHER (CXXMethodDecl, isPure)
 Matches if the given method declaration is pure. More...
 
 AST_MATCHER (CXXMethodDecl, isConst)
 Matches if the given method declaration is const. More...
 
 AST_MATCHER (CXXMethodDecl, isCopyAssignmentOperator)
 Matches if the given method declaration declares a copy assignment operator. More...
 
 AST_MATCHER (CXXMethodDecl, isMoveAssignmentOperator)
 Matches if the given method declaration declares a move assignment operator. More...
 
 AST_MATCHER (CXXMethodDecl, isOverride)
 Matches if the given method declaration overrides another method. More...
 
 AST_MATCHER (CXXMethodDecl, isUserProvided)
 Matches method declarations that are user-provided. More...
 
 AST_MATCHER (MemberExpr, isArrow)
 Matches member expressions that are called with '->' as opposed to '. More...
 
 AST_MATCHER (QualType, isInteger)
 Matches QualType nodes that are of integer type. More...
 
 AST_MATCHER (QualType, isUnsignedInteger)
 Matches QualType nodes that are of unsigned integer type. More...
 
 AST_MATCHER (QualType, isSignedInteger)
 Matches QualType nodes that are of signed integer type. More...
 
 AST_MATCHER (QualType, isAnyCharacter)
 Matches QualType nodes that are of character type. More...
 
 AST_MATCHER (QualType, isAnyPointer)
 Matches QualType nodes that are of any pointer type; this includes the Objective-C object pointer type, which is different despite being syntactically similar. More...
 
 AST_MATCHER (QualType, isConstQualified)
 Matches QualType nodes that are const-qualified, i.e., that include "top-level" const. More...
 
 AST_MATCHER (QualType, isVolatileQualified)
 Matches QualType nodes that are volatile-qualified, i.e., that include "top-level" volatile. More...
 
 AST_MATCHER (QualType, hasLocalQualifiers)
 Matches QualType nodes that have local CV-qualifiers attached to the node, not hidden within a typedef. More...
 
 AST_MATCHER_P (MemberExpr, member, internal::Matcher< ValueDecl >, InnerMatcher)
 Matches a member expression where the member is matched by a given matcher. More...
 
 AST_MATCHER_P (MemberExpr, hasObjectExpression, internal::Matcher< Expr >, InnerMatcher)
 Matches a member expression where the object expression is matched by a given matcher. More...
 
 AST_MATCHER_P (UsingDecl, hasAnyUsingShadowDecl, internal::Matcher< UsingShadowDecl >, InnerMatcher)
 Matches any using shadow declaration. More...
 
 AST_MATCHER_P (UsingShadowDecl, hasTargetDecl, internal::Matcher< NamedDecl >, InnerMatcher)
 Matches a using shadow declaration where the target declaration is matched by the given matcher. More...
 
 AST_POLYMORPHIC_MATCHER (isTemplateInstantiation, AST_POLYMORPHIC_SUPPORTED_TYPES(FunctionDecl, VarDecl, CXXRecordDecl))
 Matches template instantiations of function, class, or static member variable template instantiations. More...
 
 AST_MATCHER_FUNCTION (internal::Matcher< Decl >, isInstantiated)
 Matches declarations that are template instantiations or are inside template instantiations. More...
 
 AST_MATCHER_FUNCTION (internal::Matcher< Stmt >, isInTemplateInstantiation)
 Matches statements inside of a template instantiation. More...
 
 AST_POLYMORPHIC_MATCHER (isExplicitTemplateSpecialization, AST_POLYMORPHIC_SUPPORTED_TYPES(FunctionDecl, VarDecl, CXXRecordDecl))
 Matches explicit template specializations of function, class, or static member variable template instantiations. More...
 
 AST_MATCHER_FUNCTION_P_OVERLOAD (internal::BindableMatcher< TypeLoc >, loc, internal::Matcher< QualType >, InnerMatcher, 0)
 Matches TypeLocs for which the given inner QualType-matcher matches. More...
 
 AST_MATCHER (Type, booleanType)
 Matches type bool. More...
 
 AST_MATCHER (Type, voidType)
 Matches type void. More...
 
 AST_TYPE_MATCHER (BuiltinType, builtinType)
 Matches builtin Types. More...
 
 AST_TYPE_MATCHER (ArrayType, arrayType)
 Matches all kinds of arrays. More...
 
 AST_TYPE_MATCHER (ComplexType, complexType)
 Matches C99 complex types. More...
 
 AST_MATCHER (Type, realFloatingPointType)
 Matches any real floating-point type (float, double, long double). More...
 
 AST_TYPELOC_TRAVERSE_MATCHER (hasElementType, getElement, AST_POLYMORPHIC_SUPPORTED_TYPES(ArrayType, ComplexType))
 Matches arrays and C99 complex types that have a specific element type. More...
 
 AST_TYPE_MATCHER (ConstantArrayType, constantArrayType)
 Matches C arrays with a specified constant size. More...
 
 AST_POLYMORPHIC_MATCHER_P (hasSize, AST_POLYMORPHIC_SUPPORTED_TYPES(ConstantArrayType, StringLiteral), unsigned, N)
 Matches nodes that have the specified size. More...
 
 AST_TYPE_MATCHER (DependentSizedArrayType, dependentSizedArrayType)
 Matches C++ arrays whose size is a value-dependent expression. More...
 
 AST_TYPE_MATCHER (IncompleteArrayType, incompleteArrayType)
 Matches C arrays with unspecified size. More...
 
 AST_TYPE_MATCHER (VariableArrayType, variableArrayType)
 Matches C arrays with a specified size that is not an integer-constant-expression. More...
 
 AST_MATCHER_P (VariableArrayType, hasSizeExpr, internal::Matcher< Expr >, InnerMatcher)
 Matches VariableArrayType nodes that have a specific size expression. More...
 
 AST_TYPE_MATCHER (AtomicType, atomicType)
 Matches atomic types. More...
 
 AST_TYPELOC_TRAVERSE_MATCHER (hasValueType, getValue, AST_POLYMORPHIC_SUPPORTED_TYPES(AtomicType))
 Matches atomic types with a specific value type. More...
 
 AST_TYPE_MATCHER (AutoType, autoType)
 Matches types nodes representing C++11 auto types. More...
 
 AST_TYPE_TRAVERSE_MATCHER (hasDeducedType, getDeducedType, AST_POLYMORPHIC_SUPPORTED_TYPES(AutoType))
 Matches AutoType nodes where the deduced type is a specific type. More...
 
 AST_TYPE_MATCHER (FunctionType, functionType)
 Matches FunctionType nodes. More...
 
 AST_TYPE_MATCHER (FunctionProtoType, functionProtoType)
 Matches FunctionProtoType nodes. More...
 
 AST_TYPE_MATCHER (ParenType, parenType)
 Matches ParenType nodes. More...
 
 AST_TYPE_TRAVERSE_MATCHER (innerType, getInnerType, AST_POLYMORPHIC_SUPPORTED_TYPES(ParenType))
 Matches ParenType nodes where the inner type is a specific type. More...
 
 AST_TYPE_MATCHER (BlockPointerType, blockPointerType)
 Matches block pointer types, i.e. More...
 
 AST_TYPE_MATCHER (MemberPointerType, memberPointerType)
 Matches member pointer types. More...
 
 AST_TYPE_MATCHER (PointerType, pointerType)
 Matches pointer types, but does not match Objective-C object pointer types. More...
 
 AST_TYPE_MATCHER (ObjCObjectPointerType, objcObjectPointerType)
 Matches an Objective-C object pointer type, which is different from a pointer type, despite being syntactically similar. More...
 
 AST_TYPE_MATCHER (ReferenceType, referenceType)
 Matches both lvalue and rvalue reference types. More...
 
 AST_TYPE_MATCHER (LValueReferenceType, lValueReferenceType)
 Matches lvalue reference types. More...
 
 AST_TYPE_MATCHER (RValueReferenceType, rValueReferenceType)
 Matches rvalue reference types. More...
 
 AST_TYPELOC_TRAVERSE_MATCHER (pointee, getPointee, AST_POLYMORPHIC_SUPPORTED_TYPES(BlockPointerType, MemberPointerType, PointerType, ReferenceType))
 Narrows PointerType (and similar) matchers to those where the pointee matches a given matcher. More...
 
 AST_TYPE_MATCHER (TypedefType, typedefType)
 Matches typedef types. More...
 
 AST_TYPE_MATCHER (EnumType, enumType)
 Matches enum types. More...
 
 AST_TYPE_MATCHER (TemplateSpecializationType, templateSpecializationType)
 Matches template specialization types. More...
 
 AST_TYPE_MATCHER (UnaryTransformType, unaryTransformType)
 Matches types nodes representing unary type transformations. More...
 
 AST_TYPE_MATCHER (RecordType, recordType)
 Matches record types (e.g. More...
 
 AST_TYPE_MATCHER (ElaboratedType, elaboratedType)
 Matches types specified with an elaborated type keyword or with a qualified name. More...
 
 AST_MATCHER_P (ElaboratedType, hasQualifier, internal::Matcher< NestedNameSpecifier >, InnerMatcher)
 Matches ElaboratedTypes whose qualifier, a NestedNameSpecifier, matches InnerMatcher if the qualifier exists. More...
 
 AST_MATCHER_P (ElaboratedType, namesType, internal::Matcher< QualType >, InnerMatcher)
 Matches ElaboratedTypes whose named type matches InnerMatcher. More...
 
 AST_TYPE_MATCHER (SubstTemplateTypeParmType, substTemplateTypeParmType)
 Matches types that represent the result of substituting a type for a template type parameter. More...
 
 AST_TYPE_MATCHER (TemplateTypeParmType, templateTypeParmType)
 Matches template type parameter types. More...
 
 AST_TYPE_MATCHER (InjectedClassNameType, injectedClassNameType)
 Matches injected class name types. More...
 
 AST_TYPE_MATCHER (DecayedType, decayedType)
 Matches decayed type Example matches i[] in declaration of f. More...
 
 AST_MATCHER_P (DecayedType, hasDecayedType, internal::Matcher< QualType >, InnerType)
 Matches the decayed type, whos decayed type matches InnerMatcher. More...
 
 AST_MATCHER_P (Decl, hasDeclContext, internal::Matcher< Decl >, InnerMatcher)
 Matches declarations whose declaration context, interpreted as a Decl, matches InnerMatcher. More...
 
 AST_MATCHER_FUNCTION_P_OVERLOAD (internal::BindableMatcher< NestedNameSpecifierLoc >, loc, internal::Matcher< NestedNameSpecifier >, InnerMatcher, 1)
 Matches NestedNameSpecifierLocs for which the given inner NestedNameSpecifier-matcher matches. More...
 
 AST_MATCHER_P (NestedNameSpecifier, specifiesType, internal::Matcher< QualType >, InnerMatcher)
 Matches nested name specifiers that specify a type matching the given QualType matcher without qualifiers. More...
 
 AST_MATCHER_P (NestedNameSpecifierLoc, specifiesTypeLoc, internal::Matcher< TypeLoc >, InnerMatcher)
 Matches nested name specifier locs that specify a type matching the given TypeLoc. More...
 
 AST_MATCHER_P_OVERLOAD (NestedNameSpecifier, hasPrefix, internal::Matcher< NestedNameSpecifier >, InnerMatcher, 0)
 Matches on the prefix of a NestedNameSpecifier. More...
 
 AST_MATCHER_P_OVERLOAD (NestedNameSpecifierLoc, hasPrefix, internal::Matcher< NestedNameSpecifierLoc >, InnerMatcher, 1)
 Matches on the prefix of a NestedNameSpecifierLoc. More...
 
 AST_MATCHER_P (NestedNameSpecifier, specifiesNamespace, internal::Matcher< NamespaceDecl >, InnerMatcher)
 Matches nested name specifiers that specify a namespace matching the given namespace matcher. More...
 
 AST_MATCHER_P (SwitchStmt, forEachSwitchCase, internal::Matcher< SwitchCase >, InnerMatcher)
 Matches each case or default statement belonging to the given switch statement. More...
 
 AST_MATCHER_P (CXXConstructorDecl, forEachConstructorInitializer, internal::Matcher< CXXCtorInitializer >, InnerMatcher)
 Matches each constructor initializer in a constructor definition. More...
 
 AST_MATCHER (CXXConstructorDecl, isCopyConstructor)
 Matches constructor declarations that are copy constructors. More...
 
 AST_MATCHER (CXXConstructorDecl, isMoveConstructor)
 Matches constructor declarations that are move constructors. More...
 
 AST_MATCHER (CXXConstructorDecl, isDefaultConstructor)
 Matches constructor declarations that are default constructors. More...
 
 AST_MATCHER (CXXConstructorDecl, isDelegatingConstructor)
 Matches constructors that delegate to another constructor. More...
 
 AST_POLYMORPHIC_MATCHER (isExplicit, AST_POLYMORPHIC_SUPPORTED_TYPES(CXXConstructorDecl, CXXConversionDecl))
 Matches constructor and conversion declarations that are marked with the explicit keyword. More...
 
 AST_POLYMORPHIC_MATCHER (isInline, AST_POLYMORPHIC_SUPPORTED_TYPES(NamespaceDecl, FunctionDecl))
 Matches function and namespace declarations that are marked with the inline keyword. More...
 
 AST_MATCHER (NamespaceDecl, isAnonymous)
 Matches anonymous namespace declarations. More...
 
 AST_MATCHER_P (CaseStmt, hasCaseConstant, internal::Matcher< Expr >, InnerMatcher)
 If the given case statement does not use the GNU case range extension, matches the constant given in the statement. More...
 
 AST_MATCHER_P (Decl, hasAttr, attr::Kind, AttrKind)
 Matches declaration that has a given attribute. More...
 
 AST_MATCHER_P (ReturnStmt, hasReturnValue, internal::Matcher< Expr >, InnerMatcher)
 Matches the return value expression of a return statement. More...
 
 AST_MATCHER_FUNCTION (internal::Matcher< Expr >, nullPointerConstant)
 Matches expressions that resolve to a null pointer constant, such as GNU's __null, C++11's nullptr, or C's NULL macro. More...
 
 AST_MATCHER_P (Stmt, forFunction, internal::Matcher< FunctionDecl >, InnerMatcher)
 Matches declaration of the function the statemenet belongs to. More...
 
template<typename MatcherT >
SmallVector< BoundNodes, 1 > match (MatcherT Matcher, ASTContext &Context)
 Returns the results of matching Matcher on the translation unit of Context and collects the BoundNodes of all callback invocations. More...
 
template<typename NodeT >
const NodeT * selectFirst (StringRef BoundTo, const SmallVectorImpl< BoundNodes > &Results)
 Returns the first result of type NodeT bound to BoundTo. More...
 
 AST_MATCHER_P_OVERLOAD (Decl, equalsNode, const Decl *, Other, 0)
 Overloads for the equalsNode matcher. More...
 
 AST_MATCHER_P_OVERLOAD (Stmt, equalsNode, const Stmt *, Other, 1)
 Matches if a node equals another node. More...
 
 AST_MATCHER_P_OVERLOAD (Type, equalsNode, const Type *, Other, 2)
 Matches if a node equals another node. More...
 
template<typename MatcherT , typename NodeT >
SmallVector< BoundNodes, 1 > match (MatcherT Matcher, const NodeT &Node, ASTContext &Context)
 Returns the results of matching Matcher on Node. More...
 
template<typename MatcherT >
SmallVector< BoundNodes, 1 > match (MatcherT Matcher, const ast_type_traits::DynTypedNode &Node, ASTContext &Context)
 

Variables

const
internal::VariadicDynCastAllOfMatcher
< Decl, TranslationUnitDecl
translationUnitDecl
 Matches the top declaration context. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, TypedefDecl
typedefDecl
 Matches typedef declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, TypedefNameDecl
typedefNameDecl
 Matches typedef name declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, TypeAliasDecl
typeAliasDecl
 Matches type alias declarations. More...
 
const
internal::VariadicAllOfMatcher
< Decl
decl
 Matches declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, LinkageSpecDecl
linkageSpecDecl
 Matches a declaration of a linkage specification. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, NamedDecl
namedDecl
 Matches a declaration of anything that could have a name. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, LabelDecl
labelDecl
 Matches a declaration of label. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, NamespaceDecl
namespaceDecl
 Matches a declaration of a namespace. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, NamespaceAliasDecl
namespaceAliasDecl
 Matches a declaration of a namespace alias. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, RecordDecl
recordDecl
 Matches class, struct, and union declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, CXXRecordDecl
cxxRecordDecl
 Matches C++ class declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, ClassTemplateDecl
classTemplateDecl
 Matches C++ class template declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl,
ClassTemplateSpecializationDecl
classTemplateSpecializationDecl
 Matches C++ class template specializations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, DeclaratorDecl
declaratorDecl
 Matches declarator declarations (field, variable, function and non-type template parameter declarations). More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, ParmVarDecl
parmVarDecl
 Matches parameter variable declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, AccessSpecDecl
accessSpecDecl
 Matches C++ access specifier declarations. More...
 
const
internal::VariadicAllOfMatcher
< CXXCtorInitializer
cxxCtorInitializer
 Matches constructor initializers. More...
 
const
internal::VariadicAllOfMatcher
< TemplateArgument
templateArgument
 Matches template arguments. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl,
NonTypeTemplateParmDecl
nonTypeTemplateParmDecl
 Matches non-type template parameter declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, TemplateTypeParmDecl
templateTypeParmDecl
 Matches template type parameter declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, ValueDecl
valueDecl
 Matches any value declaration. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, CXXConstructorDecl
cxxConstructorDecl
 Matches C++ constructor declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, CXXDestructorDecl
cxxDestructorDecl
 Matches explicit C++ destructor declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, EnumDecl
enumDecl
 Matches enum declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, EnumConstantDecl
enumConstantDecl
 Matches enum constants. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, CXXMethodDecl
cxxMethodDecl
 Matches method declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, CXXConversionDecl
cxxConversionDecl
 Matches conversion operator declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, VarDecl
varDecl
 Matches variable declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, FieldDecl
fieldDecl
 Matches field declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, FunctionDecl
functionDecl
 Matches function declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, FunctionTemplateDecl
functionTemplateDecl
 Matches C++ function template declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, FriendDecl
friendDecl
 Matches friend declarations. More...
 
const
internal::VariadicAllOfMatcher
< Stmt
stmt
 Matches statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, DeclStmt
declStmt
 Matches declaration statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, MemberExpr
memberExpr
 Matches member expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CallExpr
callExpr
 Matches call expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, LambdaExpr
lambdaExpr
 Matches lambda expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXMemberCallExpr
cxxMemberCallExpr
 Matches member call expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, ObjCMessageExpr
objcMessageExpr
 Matches ObjectiveC Message invocation expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, ObjCInterfaceDecl
objcInterfaceDecl
 Matches Objective-C interface declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, ExprWithCleanups
exprWithCleanups
 Matches expressions that introduce cleanups to be run at the end of the sub-expression's evaluation. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, InitListExpr
initListExpr
 Matches init list expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, ImplicitValueInitExpr
implicitValueInitExpr
 Matches implicit initializers of init list expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, ParenListExpr
parenListExpr
 Matches paren list expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt,
SubstNonTypeTemplateParmExpr
substNonTypeTemplateParmExpr
 Matches substitutions of non-type template parameters. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, UsingDecl
usingDecl
 Matches using declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, UsingDirectiveDecl
usingDirectiveDecl
 Matches using namespace declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, UnresolvedLookupExpr
unresolvedLookupExpr
 Matches reference to a name that can be looked up during parsing but could not be resolved to a specific declaration. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl,
UnresolvedUsingValueDecl
unresolvedUsingValueDecl
 Matches unresolved using value declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl,
UnresolvedUsingTypenameDecl
unresolvedUsingTypenameDecl
 Matches unresolved using value declarations that involve the typename. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, ParenExpr
parenExpr
 Matches parentheses used in expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXConstructExpr
cxxConstructExpr
 Matches constructor call expressions (including implicit ones). More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt,
CXXUnresolvedConstructExpr
cxxUnresolvedConstructExpr
 Matches unresolved constructor call expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXThisExpr
cxxThisExpr
 Matches implicit and explicit this expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXBindTemporaryExpr
cxxBindTemporaryExpr
 Matches nodes where temporaries are created. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt,
MaterializeTemporaryExpr
materializeTemporaryExpr
 Matches nodes where temporaries are materialized. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXNewExpr
cxxNewExpr
 Matches new expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXDeleteExpr
cxxDeleteExpr
 Matches delete expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, ArraySubscriptExpr
arraySubscriptExpr
 Matches array subscript expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXDefaultArgExpr
cxxDefaultArgExpr
 Matches the value of a default argument at the call site. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXOperatorCallExpr
cxxOperatorCallExpr
 Matches overloaded operator calls. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, Expr
expr
 Matches expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, DeclRefExpr
declRefExpr
 Matches expressions that refer to declarations. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, IfStmt
ifStmt
 Matches if statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, ForStmt
forStmt
 Matches for statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXForRangeStmt
cxxForRangeStmt
 Matches range-based for statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, WhileStmt
whileStmt
 Matches while statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, DoStmt
doStmt
 Matches do statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, BreakStmt
breakStmt
 Matches break statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, ContinueStmt
continueStmt
 Matches continue statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, ReturnStmt
returnStmt
 Matches return statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, GotoStmt
gotoStmt
 Matches goto statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, LabelStmt
labelStmt
 Matches label statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, AddrLabelExpr
addrLabelExpr
 Matches address of label statements (GNU extension). More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, SwitchStmt
switchStmt
 Matches switch statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, SwitchCase
switchCase
 Matches case and default statements inside switch statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CaseStmt
caseStmt
 Matches case statements inside switch statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, DefaultStmt
defaultStmt
 Matches default statements inside switch statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CompoundStmt
compoundStmt
 Matches compound statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXCatchStmt
cxxCatchStmt
 Matches catch statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXTryStmt
cxxTryStmt
 Matches try statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXThrowExpr
cxxThrowExpr
 Matches throw expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, NullStmt
nullStmt
 Matches null statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, AsmStmt
asmStmt
 Matches asm statements. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXBoolLiteralExpr
cxxBoolLiteral
 Matches bool literals. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, StringLiteral
stringLiteral
 Matches string literals (also matches wide string literals). More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CharacterLiteral
characterLiteral
 Matches character literals (also matches wchar_t). More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, IntegerLiteral
integerLiteral
 Matches integer literals of all sizes / encodings, e.g. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, FloatingLiteral
floatLiteral
 Matches float literals of all sizes / encodings, e.g. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, UserDefinedLiteral
userDefinedLiteral
 Matches user defined literal operator call. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CompoundLiteralExpr
compoundLiteralExpr
 Matches compound (i.e. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXNullPtrLiteralExpr
cxxNullPtrLiteralExpr
 Matches nullptr literal. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, GNUNullExpr
gnuNullExpr
 Matches GNU __null expression. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, AtomicExpr
atomicExpr
 Matches atomic builtins. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, StmtExpr
stmtExpr
 Matches statement expression (GNU extension). More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, BinaryOperator
binaryOperator
 Matches binary operator expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, UnaryOperator
unaryOperator
 Matches unary operator expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, ConditionalOperator
conditionalOperator
 Matches conditional operator expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt,
BinaryConditionalOperator
binaryConditionalOperator
 Matches binary conditional operator expressions (GNU extension). More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, OpaqueValueExpr
opaqueValueExpr
 Matches opaque value expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Decl, StaticAssertDecl
staticAssertDecl
 Matches a C++ static_assert declaration. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXReinterpretCastExpr
cxxReinterpretCastExpr
 Matches a reinterpret_cast expression. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXStaticCastExpr
cxxStaticCastExpr
 Matches a C++ static_cast expression. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXDynamicCastExpr
cxxDynamicCastExpr
 Matches a dynamic_cast expression. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXConstCastExpr
cxxConstCastExpr
 Matches a const_cast expression. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CStyleCastExpr
cStyleCastExpr
 Matches a C-style cast expression. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, ExplicitCastExpr
explicitCastExpr
 Matches explicit cast expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, ImplicitCastExpr
implicitCastExpr
 Matches the implicit cast nodes of Clang's AST. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CastExpr
castExpr
 Matches any cast nodes of Clang's AST. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXFunctionalCastExpr
cxxFunctionalCastExpr
 Matches functional cast expressions. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CXXTemporaryObjectExpr
cxxTemporaryObjectExpr
 Matches functional cast expressions having N != 1 arguments. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, PredefinedExpr
predefinedExpr
 Matches predefined identifier expressions [C99 6.4.2.2]. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, DesignatedInitExpr
designatedInitExpr
 Matches C99 designated initializer expressions [C99 6.7.8]. More...
 
const
internal::VariadicAllOfMatcher
< QualType
qualType
 Matches QualTypes in the clang AST. More...
 
const
internal::VariadicAllOfMatcher
< Type
type
 Matches Types in the clang AST. More...
 
const
internal::VariadicAllOfMatcher
< TypeLoc
typeLoc
 Matches TypeLocs in the clang AST. More...
 
const
internal::VariadicOperatorMatcherFunc
< 2, UINT_MAX
eachOf
 Matches if any of the given matchers matches. More...
 
const
internal::VariadicOperatorMatcherFunc
< 2, UINT_MAX
anyOf
 Matches if any of the given matchers matches. More...
 
const
internal::VariadicOperatorMatcherFunc
< 2, UINT_MAX
allOf
 Matches if all given matchers match. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt,
UnaryExprOrTypeTraitExpr
unaryExprOrTypeTraitExpr
 Matches sizeof (C99), alignof (C++11) and vec_step (OpenCL) More...
 
const
internal::VariadicFunction
< internal::Matcher< NamedDecl >
, StringRef,
internal::hasAnyNameFunc
hasAnyName = {}
 Matches NamedDecl nodes that have any of the specified names. More...
 
const
internal::ArgumentAdaptingMatcherFunc
< internal::HasMatcher >
LLVM_ATTRIBUTE_UNUSED 
has = {}
 Matches AST nodes that have child AST nodes that match the provided matcher. More...
 
const
internal::ArgumentAdaptingMatcherFunc
< internal::HasDescendantMatcher >
LLVM_ATTRIBUTE_UNUSED 
hasDescendant = {}
 Matches AST nodes that have descendant AST nodes that match the provided matcher. More...
 
const
internal::ArgumentAdaptingMatcherFunc
< internal::ForEachMatcher >
LLVM_ATTRIBUTE_UNUSED 
forEach = {}
 Matches AST nodes that have child AST nodes that match the provided matcher. More...
 
const
internal::ArgumentAdaptingMatcherFunc
< internal::ForEachDescendantMatcher >
LLVM_ATTRIBUTE_UNUSED 
forEachDescendant = {}
 Matches AST nodes that have descendant AST nodes that match the provided matcher. More...
 
const
internal::ArgumentAdaptingMatcherFunc
< internal::HasParentMatcher,
internal::TypeList< Decl,
NestedNameSpecifierLoc, Stmt,
TypeLoc >, internal::TypeList
< Decl, NestedNameSpecifierLoc,
Stmt, TypeLoc >
> LLVM_ATTRIBUTE_UNUSED 
hasParent = {}
 Matches AST nodes that have a parent that matches the provided matcher. More...
 
const
internal::ArgumentAdaptingMatcherFunc
< internal::HasAncestorMatcher,
internal::TypeList< Decl,
NestedNameSpecifierLoc, Stmt,
TypeLoc >, internal::TypeList
< Decl, NestedNameSpecifierLoc,
Stmt, TypeLoc >
> LLVM_ATTRIBUTE_UNUSED 
hasAncestor = {}
 Matches AST nodes that have an ancestor that matches the provided matcher. More...
 
const
internal::VariadicOperatorMatcherFunc< 1, 1 > 
unless
 Matches if the provided matcher does not match. More...
 
const
internal::VariadicAllOfMatcher
< NestedNameSpecifier
nestedNameSpecifier
 Matches nested name specifiers. More...
 
const
internal::VariadicAllOfMatcher
< NestedNameSpecifierLoc
nestedNameSpecifierLoc
 Same as nestedNameSpecifier but matches NestedNameSpecifierLoc. More...
 
const
internal::VariadicDynCastAllOfMatcher
< Stmt, CUDAKernelCallExpr
cudaKernelCallExpr
 Matches CUDA kernel call expression. More...
 

Typedef Documentation

Types of matchers for the top-level classes in the AST class hierarchy.

Definition at line 123 of file ASTMatchers.h.

Definition at line 128 of file ASTMatchers.h.

Definition at line 127 of file ASTMatchers.h.

Definition at line 124 of file ASTMatchers.h.

Definition at line 126 of file ASTMatchers.h.

Definition at line 125 of file ASTMatchers.h.

Function Documentation

internal::Matcher<Stmt> clang::ast_matchers::alignOfExpr ( const internal::Matcher< UnaryExprOrTypeTraitExpr > &  InnerMatcher)
inline

Same as unaryExprOrTypeTraitExpr, but only matching alignof.

Definition at line 2067 of file ASTMatchers.h.

References allOf, stmt, clang::UETT_AlignOf, and unaryExprOrTypeTraitExpr.

internal::TrueMatcher clang::ast_matchers::anything ( )
inline

Matches any node.

Useful when another matcher requires a child matcher, but there's no additional constraint. This will often be used with an explicit conversion to an internal::Matcher<> type such as TypeMatcher.

Example: DeclarationMatcher(anything()) matches all declarations, e.g.,

"int* p" and "void f()" in
int* p;
void f();

Usable as: Any Matcher

Definition at line 145 of file ASTMatchers.h.

clang::ast_matchers::AST_MATCHER ( Decl  ,
isPublic   
)

Matches public C++ declarations.

Given

class C {
public: int a;
protected: int b;
private: int c;
};

fieldDecl(isPublic()) matches 'int a;'

Definition at line 486 of file ASTMatchers.h.

References clang::AS_public, and Node.

clang::ast_matchers::AST_MATCHER ( Decl  ,
isProtected   
)

Matches protected C++ declarations.

Given

class C {
public: int a;
protected: int b;
private: int c;
};

fieldDecl(isProtected()) matches 'int b;'

Definition at line 502 of file ASTMatchers.h.

References clang::AS_protected, and Node.

clang::ast_matchers::AST_MATCHER ( Decl  ,
isPrivate   
)

Matches private C++ declarations.

Given

class C {
public: int a;
protected: int b;
private: int c;
};

fieldDecl(isPrivate()) matches 'int c;'

Definition at line 518 of file ASTMatchers.h.

References clang::AS_private, and Node.

clang::ast_matchers::AST_MATCHER ( FieldDecl  ,
isBitField   
)

Matches non-static data members that are bit-fields.

Given

class C {
int a : 2;
int b;
};

fieldDecl(isBitField()) matches 'int a;' but not 'int b;'.

Definition at line 533 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( Decl  ,
isImplicit   
)

Matches a declaration that has been implicitly added by the compiler (eg.

implicit default/copy constructors).

Definition at line 556 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( TemplateArgument  ,
isIntegral   
)

Matches a TemplateArgument that is an integral value.

Given

template<int T> struct A {};
C<42> c;

classTemplateSpecializationDecl( hasAnyTemplateArgument(isIntegral())) matches the implicit instantiation of C in C<42> with isIntegral() matching 42.

Definition at line 810 of file ASTMatchers.h.

References clang::TemplateArgument::Integral, and Node.

clang::ast_matchers::AST_MATCHER ( CXXRecordDecl  ,
isLambda   
)

Matches the generated class of lambda expressions.

Given:

auto x = []{};

cxxRecordDecl(isLambda()) matches the implicit class declaration of decltype(x)

Definition at line 2241 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( ObjCMessageExpr  ,
hasNullSelector   
)

Matches when the selector is the empty selector.

Matches only when the selector of the objCMessageExpr is NULL. This may represent an error condition in the tree!

Definition at line 2494 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( ObjCMessageExpr  ,
hasUnarySelector   
)

Matches when the selector is a Unary Selector.

matcher = objCMessageExpr(matchesSelector(hasUnarySelector()); matches self.bodyView in the code below, but NOT the outer message invocation of "loadHTMLString:baseURL:".

[self.bodyView loadHTMLString:html baseURL:NULL];

Definition at line 2506 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( ObjCMessageExpr  ,
hasKeywordSelector   
)

Matches when the selector is a keyword selector.

objCMessageExpr(hasKeywordSelector()) matches the generated setFrame message expression in

UIWebView *webView = ...;
CGRect bodyFrame = webView.frame;
bodyFrame.size.height = self.bodyContentHeight;
webView.frame = bodyFrame;
// ^---- matches here

Definition at line 2522 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( VarDecl  ,
hasLocalStorage   
)

Matches a variable declaration that has function scope and is a non-static local variable.

Example matches x (matcher = varDecl(hasLocalStorage())

void f() {
int x;
static int y;
}
int z;

Definition at line 2825 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( VarDecl  ,
hasGlobalStorage   
)

Matches a variable declaration that does not have local storage.

Example matches y and z (matcher = varDecl(hasGlobalStorage())

void f() {
int x;
static int y;
}
int z;

Definition at line 2839 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( VarDecl  ,
hasAutomaticStorageDuration   
)

Matches a variable declaration that has automatic storage duration.

Example matches x, but not y, z, or a. (matcher = varDecl(hasAutomaticStorageDuration())

void f() {
int x;
static int y;
thread_local int z;
}
int a;

Definition at line 2855 of file ASTMatchers.h.

References Node, and clang::SD_Automatic.

clang::ast_matchers::AST_MATCHER ( VarDecl  ,
hasStaticStorageDuration   
)

Matches a variable declaration that has static storage duration.

Example matches y and a, but not x or z. (matcher = varDecl(hasStaticStorageDuration())

void f() {
int x;
static int y;
thread_local int z;
}
int a;

Definition at line 2871 of file ASTMatchers.h.

References Node, and clang::SD_Static.

clang::ast_matchers::AST_MATCHER ( VarDecl  ,
hasThreadStorageDuration   
)

Matches a variable declaration that has thread storage duration.

Example matches z, but not x, z, or a. (matcher = varDecl(hasThreadStorageDuration())

void f() {
int x;
static int y;
thread_local int z;
}
int a;

Definition at line 2887 of file ASTMatchers.h.

References Node, and clang::SD_Thread.

clang::ast_matchers::AST_MATCHER ( VarDecl  ,
isExceptionVariable   
)

Matches a variable declaration that is an exception variable from a C++ catch block, or an Objective-C @catch statement.

Example matches x (matcher = varDecl(isExceptionVariable())

void f(int y) {
try {
} catch (int x) {
}
}

Definition at line 2902 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXCtorInitializer  ,
isWritten   
)

Matches a constructor initializer if it is explicitly written in code (as opposed to implicitly added by the compiler).

Given

struct Foo {
Foo() { }
Foo(int) : foo_("A") { }
string foo_;
};

cxxConstructorDecl(hasAnyConstructorInitializer(isWritten())) will match Foo(int), but not Foo()

Definition at line 3073 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXCtorInitializer  ,
isBaseInitializer   
)

Matches a constructor initializer if it is initializing a base, as opposed to a member.

Given

struct B {};
struct D : B {
int I;
D(int i) : I(i) {}
};
struct E : B {
E() : B() {}
};

cxxConstructorDecl(hasAnyConstructorInitializer(isBaseInitializer())) will match E(), but not match D(int).

Definition at line 3093 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXCtorInitializer  ,
isMemberInitializer   
)

Matches a constructor initializer if it is initializing a member, as opposed to a base.

Given

struct B {};
struct D : B {
int I;
D(int i) : I(i) {}
};
struct E : B {
E() : B() {}
};

cxxConstructorDecl(hasAnyConstructorInitializer(isMemberInitializer())) will match D(int), but not match E().

Definition at line 3113 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXConstructExpr  ,
isListInitialization   
)

Matches a constructor call expression which uses list initialization.

Definition at line 3143 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXConstructExpr  ,
requiresZeroInitialization   
)

Matches a constructor call expression which requires zero initialization.

Given

void foo() {
struct point { double x; double y; };
point pt[2] = { { 1.0, 2.0 } };
}

initListExpr(has(cxxConstructExpr(requiresZeroInitialization())) will match the implicit array filler for pt[1].

Definition at line 3159 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( FunctionDecl  ,
isExternC   
)

Matches extern "C" function declarations.

Given:

extern "C" void f() {}
extern "C" { void g() {} }
void h() {}

functionDecl(isExternC()) matches the declaration of f and g, but not the declaration h

Definition at line 3300 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( FunctionDecl  ,
isDeleted   
)

Matches deleted function declarations.

Given:

void Func();
void DeletedFunc() = delete;

functionDecl(isDeleted()) matches the declaration of DeletedFunc, but not Func.

Definition at line 3313 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( FunctionDecl  ,
isDefaulted   
)

Matches defaulted function declarations.

Given:

class A { ~A(); };
class B { ~B() = default; };

functionDecl(isDefaulted()) matches the declaration of ~B, but not ~A.

Definition at line 3326 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( RecordDecl  ,
isStruct   
)

Matches RecordDecl object that are spelled with "struct.".

Example matches S, but not C or U.

struct S {};
class C {};
union U {};

Definition at line 3729 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( RecordDecl  ,
isUnion   
)

Matches RecordDecl object that are spelled with "union.".

Example matches U, but not C or S.

struct S {};
class C {};
union U {};

Definition at line 3741 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( RecordDecl  ,
isClass   
)

Matches RecordDecl object that are spelled with "class.".

Example matches C, but not S or U.

struct S {};
class C {};
union U {};

Definition at line 3753 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( FunctionDecl  ,
isVariadic   
)

Matches if a function declaration is variadic.

Example matches f, but not g or h. The function i will not match, even when compiled in C mode.

void f(...);
void g(int);
template <typename... Ts> void h(Ts...);
void i();

Definition at line 3819 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXMethodDecl  ,
isVirtual   
)

Matches if the given method declaration is virtual.

Given

class A {
public:
virtual void x();
};

matches A::x

Definition at line 3898 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXMethodDecl  ,
isVirtualAsWritten   
)

Matches if the given method declaration has an explicit "virtual".

Given

class A {
public:
virtual void x();
};
class B : public A {
public:
void x();
};

matches A::x but not B::x

Definition at line 3916 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXMethodDecl  ,
isPure   
)

Matches if the given method declaration is pure.

Given

class A {
public:
virtual void x() = 0;
};

matches A::x

Definition at line 3951 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXMethodDecl  ,
isConst   
)

Matches if the given method declaration is const.

Given

struct A {
void foo() const;
void bar();
};

cxxMethodDecl(isConst()) matches A::foo() but not A::bar()

Definition at line 3966 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXMethodDecl  ,
isCopyAssignmentOperator   
)

Matches if the given method declaration declares a copy assignment operator.

Given

struct A {
A &operator=(const A &);
A &operator=(A &&);
};

cxxMethodDecl(isCopyAssignmentOperator()) matches the first method but not the second one.

Definition at line 3983 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXMethodDecl  ,
isMoveAssignmentOperator   
)

Matches if the given method declaration declares a move assignment operator.

Given

struct A {
A &operator=(const A &);
A &operator=(A &&);
};

cxxMethodDecl(isMoveAssignmentOperator()) matches the second method but not the first one.

Definition at line 4000 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXMethodDecl  ,
isOverride   
)

Matches if the given method declaration overrides another method.

Given

class A {
public:
virtual void x();
};
class B : public A {
public:
virtual void x();
};

matches B::x

Definition at line 4018 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXMethodDecl  ,
isUserProvided   
)

Matches method declarations that are user-provided.

Given

struct S {
S(); // #1
S(const S &) = default; // #2
S(S &&) = delete; // #3
};

cxxConstructorDecl(isUserProvided()) will match #1, but not #2 or #3.

Definition at line 4033 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( MemberExpr  ,
isArrow   
)

Matches member expressions that are called with '->' as opposed to '.

'.

Member calls on the implicit this pointer match as called with '->'.

Given

class Y {
void x() { this->x(); x(); Y y; y.x(); a; this->b; Y::b; }
int a;
static int b;
};

memberExpr(isArrow()) matches this->x, x, y.x, a, this->b

Definition at line 4052 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( QualType  ,
isInteger   
)

Matches QualType nodes that are of integer type.

Given

void a(int);
void b(long);
void c(double);

functionDecl(hasAnyParameter(hasType(isInteger()))) matches "a(int)", "b(long)", but not "c(double)".

Definition at line 4066 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( QualType  ,
isUnsignedInteger   
)

Matches QualType nodes that are of unsigned integer type.

Given

void a(int);
void b(unsigned long);
void c(double);

functionDecl(hasAnyParameter(hasType(isInteger()))) matches "b(unsigned long)", but not "a(int)" and "c(double)".

Definition at line 4080 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( QualType  ,
isSignedInteger   
)

Matches QualType nodes that are of signed integer type.

Given

void a(int);
void b(unsigned long);
void c(double);

functionDecl(hasAnyParameter(hasType(isInteger()))) matches "a(int)", but not "b(unsigned long)" and "c(double)".

Definition at line 4094 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( QualType  ,
isAnyCharacter   
)

Matches QualType nodes that are of character type.

Given

void a(char);
void b(wchar_t);
void c(double);

functionDecl(hasAnyParameter(hasType(isAnyCharacter()))) matches "a(char)", "b(wchar_t)", but not "c(double)".

Definition at line 4108 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( QualType  ,
isAnyPointer   
)

Matches QualType nodes that are of any pointer type; this includes the Objective-C object pointer type, which is different despite being syntactically similar.

Given

int *i = nullptr;
@interface Foo
@end
Foo *f;
int j;

varDecl(hasType(isAnyPointer())) matches "int *i" and "Foo *f", but not "int j".

Definition at line 4128 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( QualType  ,
isConstQualified   
)

Matches QualType nodes that are const-qualified, i.e., that include "top-level" const.

Given

void a(int);
void b(int const);
void c(const int);
void d(const int*);
void e(int const) {};

functionDecl(hasAnyParameter(hasType(isConstQualified()))) matches "void b(int const)", "void c(const int)" and "void e(int const) {}". It does not match d as there is no top-level const on the parameter type "const int *".

Definition at line 4147 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( QualType  ,
isVolatileQualified   
)

Matches QualType nodes that are volatile-qualified, i.e., that include "top-level" volatile.

Given

void a(int);
void b(int volatile);
void c(volatile int);
void d(volatile int*);
void e(int volatile) {};

functionDecl(hasAnyParameter(hasType(isVolatileQualified()))) matches "void b(int volatile)", "void c(volatile int)" and "void e(int volatile) {}". It does not match d as there is no top-level volatile on the parameter type "volatile int *".

Definition at line 4166 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( QualType  ,
hasLocalQualifiers   
)

Matches QualType nodes that have local CV-qualifiers attached to the node, not hidden within a typedef.

Given

typedef const int const_int;
const_int i;
int *const j;
int *volatile k;
int m;

varDecl(hasType(hasLocalQualifiers())) matches only j and k. i is const-qualified but the qualifier is not local.

Definition at line 4183 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( Type  ,
booleanType   
)

Matches type bool.

Given

struct S { bool func(); };

functionDecl(returns(booleanType())) matches "bool func();"

Definition at line 4355 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( Type  ,
voidType   
)

Matches type void.

Given

struct S { void func(); };

functionDecl(returns(voidType())) matches "void func();"

Definition at line 4367 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( Type  ,
realFloatingPointType   
)

Matches any real floating-point type (float, double, long double).

Given

int i;
float f;

realFloatingPointType() matches "float f" but not "int i"

Definition at line 4416 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXConstructorDecl  ,
isCopyConstructor   
)

Matches constructor declarations that are copy constructors.

Given

struct S {
S(); // #1
S(const S &); // #2
S(S &&); // #3
};

cxxConstructorDecl(isCopyConstructor()) will match #2, but not #1 or #3.

Definition at line 5162 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXConstructorDecl  ,
isMoveConstructor   
)

Matches constructor declarations that are move constructors.

Given

struct S {
S(); // #1
S(const S &); // #2
S(S &&); // #3
};

cxxConstructorDecl(isMoveConstructor()) will match #3, but not #1 or #2.

Definition at line 5177 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXConstructorDecl  ,
isDefaultConstructor   
)

Matches constructor declarations that are default constructors.

Given

struct S {
S(); // #1
S(const S &); // #2
S(S &&); // #3
};

cxxConstructorDecl(isDefaultConstructor()) will match #1, but not #2 or #3.

Definition at line 5192 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( CXXConstructorDecl  ,
isDelegatingConstructor   
)

Matches constructors that delegate to another constructor.

Given

struct S {
S(); // #1
S(int) {} // #2
S(S &&) : S() {} // #3
};
S::S() : S(0) {} // #4

cxxConstructorDecl(isDelegatingConstructor()) will match #3 and #4, but not #1 or #2.

Definition at line 5209 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER ( NamespaceDecl  ,
isAnonymous   
)

Matches anonymous namespace declarations.

Given

namespace n {
namespace {} // #1
}

namespaceDecl(isAnonymous()) will match #1 but not ::n.

Definition at line 5267 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER_FUNCTION ( internal::Matcher< Decl ,
isInstantiated   
)

Matches declarations that are template instantiations or are inside template instantiations.

Given

template<typename T> void A(T t) { T i; }
A(0);
A(0U);

functionDecl(isInstantiated()) matches 'A(int) {...};' and 'A(unsigned) {...}'.

Definition at line 4295 of file ASTMatchers.h.

References anyOf, cxxRecordDecl, decl, functionDecl, hasAncestor, and clang::isTemplateInstantiation().

clang::ast_matchers::AST_MATCHER_FUNCTION ( internal::Matcher< Stmt ,
isInTemplateInstantiation   
)

Matches statements inside of a template instantiation.

Given

int j;
template<typename T> void A(T t) { T i; j += 42;}
A(0);
A(0U);

declStmt(isInTemplateInstantiation()) matches 'int i;' and 'unsigned i'. unless(stmt(isInTemplateInstantiation())) will NOT match j += 42; as it's shared between the template definition and instantiation.

Definition at line 4315 of file ASTMatchers.h.

References anyOf, cxxRecordDecl, decl, functionDecl, hasAncestor, clang::isTemplateInstantiation(), and stmt.

clang::ast_matchers::AST_MATCHER_FUNCTION ( internal::Matcher< Expr >  ,
nullPointerConstant   
)

Matches expressions that resolve to a null pointer constant, such as GNU's __null, C++11's nullptr, or C's NULL macro.

Given:

void *v1 = NULL;
void *v2 = nullptr;
void *v3 = __null; // GNU extension
char *cp = (char *)0;
int *ip = 0;
int i = 0;

expr(nullPointerConstant()) matches the initializer for v1, v2, v3, cp, and ip. Does not match the initializer for i.

Definition at line 5349 of file ASTMatchers.h.

References anyOf, cxxNullPtrLiteralExpr, equals(), expr, gnuNullExpr, hasParent, and integerLiteral.

clang::ast_matchers::AST_MATCHER_FUNCTION_P_OVERLOAD ( internal::BindableMatcher< TypeLoc >  ,
loc  ,
internal::Matcher< QualType >  ,
InnerMatcher  ,
 
)

Matches TypeLocs for which the given inner QualType-matcher matches.

Definition at line 4341 of file ASTMatchers.h.

References InnerMatcher.

clang::ast_matchers::AST_MATCHER_FUNCTION_P_OVERLOAD ( internal::BindableMatcher< NestedNameSpecifierLoc >  ,
loc  ,
internal::Matcher< NestedNameSpecifier >  ,
InnerMatcher  ,
 
)

Matches NestedNameSpecifierLocs for which the given inner NestedNameSpecifier-matcher matches.

Definition at line 4973 of file ASTMatchers.h.

References InnerMatcher.

clang::ast_matchers::AST_MATCHER_P ( FieldDecl  ,
hasBitWidth  ,
unsigned  ,
Width   
)

Matches non-static data members that are bit-fields.

Given

class C {
int a : 2;
int b : 4;
int c : 2;
};

fieldDecl(isBitField()) matches 'int a;' and 'int c;' but not 'int b;'.

Definition at line 549 of file ASTMatchers.h.

References Finder, and Node.

clang::ast_matchers::AST_MATCHER_P ( Expr  ,
ignoringImplicit  ,
ast_matchers::internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches expressions that match InnerMatcher after any implicit AST nodes are stripped off.

Parentheses and explicit casts are not discarded. Given

class C {};
C a = C();
C b;
C c = b;

The matchers

varDecl(hasInitializer(ignoringImplicit(cxxConstructExpr())))

would match the declarations for a, b, and c. While

varDecl(hasInitializer(cxxConstructExpr()))

only match the declarations for b and c.

Definition at line 604 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( Expr  ,
ignoringImpCasts  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches expressions that match InnerMatcher after any implicit casts are stripped off.

Parentheses and explicit casts are not discarded. Given

int arr[5];
int a = 0;
char b = 0;
const int c = a;
int *d = arr;
long e = (long) 0l;

The matchers

varDecl(hasInitializer(ignoringImpCasts(integerLiteral())))
varDecl(hasInitializer(ignoringImpCasts(declRefExpr())))

would match the declarations for a, b, c, and d, but not e. While

varDecl(hasInitializer(integerLiteral()))
varDecl(hasInitializer(declRefExpr()))

only match the declarations for b, c, and d.

Definition at line 634 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( Expr  ,
ignoringParenCasts  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches expressions that match InnerMatcher after parentheses and casts are stripped off.

Implicit and non-C Style casts are also discarded. Given

int a = 0;
char b = (0);
void* c = reinterpret_cast<char*>(0);
char d = char(0);

The matcher varDecl(hasInitializer(ignoringParenCasts(integerLiteral()))) would match the declarations for a, b, c, and d. while varDecl(hasInitializer(integerLiteral())) only match the declaration for a.

Definition at line 656 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( Expr  ,
ignoringParenImpCasts  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches expressions that match InnerMatcher after implicit casts and parentheses are stripped off.

Explicit casts are not discarded. Given

int arr[5];
int a = 0;
char b = (0);
const int c = a;
int *d = (arr);
long e = ((long) 0l);

The matchers varDecl(hasInitializer(ignoringParenImpCasts(integerLiteral()))) varDecl(hasInitializer(ignoringParenImpCasts(declRefExpr()))) would match the declarations for a, b, c, and d, but not e. while varDecl(hasInitializer(integerLiteral())) varDecl(hasInitializer(declRefExpr())) would only match the declaration for a.

Definition at line 681 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( QualType  ,
ignoringParens  ,
internal::Matcher< QualType >  ,
InnerMatcher   
)

Matches types that match InnerMatcher after any parens are stripped.

Given

void (*fp)(void);

The matcher

varDecl(hasType(pointerType(pointee(ignoringParens(functionType())))))

would match the declaration for fp.

Definition at line 697 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( TemplateArgument  ,
refersToType  ,
internal::Matcher< QualType >  ,
InnerMatcher   
)

Matches a TemplateArgument that refers to a certain type.

Given

struct X {};
template<typename T> struct A {};
A<X> a;

classTemplateSpecializationDecl(hasAnyTemplateArgument( refersToType(class(hasName("X"))))) matches the specialization A<X>

Definition at line 754 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, Node, and clang::TemplateArgument::Type.

clang::ast_matchers::AST_MATCHER_P ( TemplateArgument  ,
refersToDeclaration  ,
internal::Matcher< Decl ,
InnerMatcher   
)

Matches a canonical TemplateArgument that refers to a certain declaration.

Given

template<typename T> struct A {};
struct B { B* next; };
A<&B::next> a;

classTemplateSpecializationDecl(hasAnyTemplateArgument( refersToDeclaration(fieldDecl(hasName("next")))) matches the specialization A<&B::next> with fieldDecl(...) matching B::next

Definition at line 774 of file ASTMatchers.h.

References Builder, clang::TemplateArgument::Declaration, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( TemplateArgument  ,
isExpr  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches a sugar TemplateArgument that refers to a certain expression.

Given

template<typename T> struct A {};
struct B { B* next; };
A<&B::next> a;

templateSpecializationType(hasAnyTemplateArgument( isExpr(hasDescendant(declRefExpr(to(fieldDecl(hasName("next")))))))) matches the specialization A<&B::next> with fieldDecl(...) matching B::next

Definition at line 793 of file ASTMatchers.h.

References Builder, clang::TemplateArgument::Expression, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( TemplateArgument  ,
refersToIntegralType  ,
internal::Matcher< QualType >  ,
InnerMatcher   
)

Matches a TemplateArgument that referes to an integral type.

Given

template<int T> struct A {};
C<42> c;

classTemplateSpecializationDecl( hasAnyTemplateArgument(refersToIntegralType(asString("int")))) matches the implicit instantiation of C in C<42>.

Definition at line 824 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, clang::TemplateArgument::Integral, and Node.

clang::ast_matchers::AST_MATCHER_P ( TemplateArgument  ,
equalsIntegralValue  ,
std::string  ,
Value   
)

Matches a TemplateArgument of integral type with a given value.

Note that 'Value' is a string as the template argument's value is an arbitrary precision integer. 'Value' must be euqal to the canonical representation of that integral value in base 10.

Given

template<int T> struct A {};
C<42> c;

classTemplateSpecializationDecl( hasAnyTemplateArgument(equalsIntegralValue("42"))) matches the implicit instantiation of C in C<42>.

Definition at line 845 of file ASTMatchers.h.

References clang::TemplateArgument::Integral, and Node.

clang::ast_matchers::AST_MATCHER_P ( InitListExpr  ,
hasSyntacticForm  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches the syntactic form of init list expressions (if expression have it).

Definition at line 1090 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( ForStmt  ,
hasIncrement  ,
internal::Matcher< Stmt ,
InnerMatcher   
)

Matches the increment statement of a for loop.

Example: forStmt(hasIncrement(unaryOperator(hasOperatorName("++")))) matches '++x' in

for (x; x < N; ++x) { }

Definition at line 1403 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( ForStmt  ,
hasLoopInit  ,
internal::Matcher< Stmt ,
InnerMatcher   
)

Matches the initialization statement of a for loop.

Example: forStmt(hasLoopInit(declStmt())) matches 'int x = 0' in

for (int x = 0; x < N; ++x) { }

Definition at line 1418 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( CXXForRangeStmt  ,
hasLoopVariable  ,
internal::Matcher< VarDecl >  ,
InnerMatcher   
)

Matches the initialization statement of a for loop.

Example: forStmt(hasLoopVariable(anything())) matches 'int x' in

for (int x : a) { }

Definition at line 1443 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( CXXForRangeStmt  ,
hasRangeInit  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches the range initialization statement of a for loop.

Example: forStmt(hasRangeInit(anything())) matches 'a' in

for (int x : a) { }

Definition at line 1457 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( DesignatedInitExpr  ,
designatorCountIs  ,
unsigned  ,
 
)

Matches designated initializer expressions that contain a specific number of designators.

Example: Given

point ptarray[10] = { [2].y = 1.0, [0].x = 1.0 };
point ptarray2[10] = { [2].y = 1.0, [2].x = 0.0, [0].x = 1.0 };

designatorCountIs(2) matches '{ [2].y = 1.0, [0].x = 1.0 }', but not '{ [2].y = 1.0, [2].x = 0.0, [0].x = 1.0 }'.

Definition at line 1975 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER_P ( UnaryExprOrTypeTraitExpr  ,
hasArgumentOfType  ,
internal::Matcher< QualType >  ,
InnerMatcher   
)

Matches unary expressions that have a specific type of argument.

Given

int a, c; float b; int s = sizeof(a) + sizeof(b) + alignof(c);

unaryExprOrTypeTraitExpr(hasArgumentOfType(asString("int")) matches sizeof(a) and alignof(c)

Definition at line 2046 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( UnaryExprOrTypeTraitExpr  ,
ofKind  ,
UnaryExprOrTypeTrait  ,
Kind   
)

Matches unary expressions of a certain kind.

Given

int x;
int s = sizeof(x) + alignof(x)

unaryExprOrTypeTraitExpr(ofKind(UETT_SizeOf)) matches sizeof(x)

Definition at line 2061 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER_P ( NamedDecl  ,
matchesName  ,
std::string  ,
RegExp   
)

Matches NamedDecl nodes whose fully qualified names contain a substring matched by the given RegExp.

Supports specifying enclosing namespaces or classes by prefixing the name with '<enclosing>::'. Does not match typedefs of an underlying type with the given name.

Example matches X (regexp == "::X")

class X;

Example matches X (regexp is one of "::X", "^foo::.*X", among others)

namespace foo { namespace bar { class X; } }

Definition at line 2132 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER_P ( CXXRecordDecl  ,
isDerivedFrom  ,
internal::Matcher< NamedDecl >  ,
Base   
)

Matches C++ classes that are directly or indirectly derived from a class matching Base.

Note that a class is not considered to be derived from itself.

Example matches Y, Z, C (Base == hasName("X"))

class X;
class Y : public X {}; // directly derived
class Z : public Y {}; // indirectly derived
typedef X A;
typedef A B;
class C : public B {}; // derived from a typedef of X

In the following example, Bar matches isDerivedFrom(hasName("X")):

class Foo;
typedef Foo X;
class Bar : public Foo {}; // derived from a type that X is a typedef of

Definition at line 2188 of file ASTMatchers.h.

References Builder, Finder, and Node.

clang::ast_matchers::AST_MATCHER_P ( CXXRecordDecl  ,
hasMethod  ,
internal::Matcher< CXXMethodDecl >  ,
InnerMatcher   
)

Matches the first method of a class or struct that satisfies InnerMatcher.

Given:

class A { void func(); };
class B { void member(); };

cxxRecordDecl(hasMethod(hasName("func"))) matches the declaration of A but not B.

Definition at line 2226 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( CXXMemberCallExpr  ,
on  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches on the implicit object argument of a member call expression.

Example matches y.x() (matcher = cxxMemberCallExpr(on(hasType(cxxRecordDecl(hasName("Y"))))))

class Y { public: void x(); };
void z() { Y y; y.x(); }",

FIXME: Overload to allow directly matching types?

Definition at line 2436 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( ObjCMessageExpr  ,
hasReceiverType  ,
internal::Matcher< QualType >  ,
InnerMatcher   
)

Matches on the receiver of an ObjectiveC Message expression.

Example matcher = objCMessageExpr(hasRecieverType(asString("UIWebView *"))); matches the [webView ...] message invocation.

NSString *webViewJavaScript = ...
UIWebView *webView = ...
[webView stringByEvaluatingJavaScriptFromString:webViewJavascript];

Definition at line 2455 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( ObjCMessageExpr  ,
hasSelector  ,
std::string  ,
BaseName   
)

Matches when BaseName == Selector.getAsString()

matcher = objCMessageExpr(hasSelector("loadHTMLString:baseURL:")); matches the outer message expr in the code below, but NOT the message invocation for self.bodyView.

[self.bodyView loadHTMLString:html baseURL:NULL];

Definition at line 2469 of file ASTMatchers.h.

References clang::Selector::getAsString(), and Node.

clang::ast_matchers::AST_MATCHER_P ( ObjCMessageExpr  ,
matchesSelector  ,
std::string  ,
RegExp   
)

Matches ObjC selectors whose name contains a substring matched by the given RegExp.

matcher = objCMessageExpr(matchesSelector("loadHTMLString\:baseURL?")); matches the outer message expr in the code below, but NOT the message invocation for self.bodyView.

[self.bodyView loadHTMLString:html baseURL:NULL];

Definition at line 2483 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER_P ( ObjCMessageExpr  ,
numSelectorArgs  ,
unsigned  ,
 
)

Matches when the selector has the specified number of arguments.

matcher = objCMessageExpr(numSelectorArgs(0)); matches self.bodyView in the code below

matcher = objCMessageExpr(numSelectorArgs(2)); matches the invocation of "loadHTMLString:baseURL:" but not that of self.bodyView

[self.bodyView loadHTMLString:html baseURL:NULL];

Definition at line 2537 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER_P ( CallExpr  ,
callee  ,
internal::Matcher< Stmt ,
InnerMatcher   
)

Matches if the call expression's callee expression matches.

Given

class Y { void x() { this->x(); x(); Y y; y.x(); } };
void f() { f(); }

callExpr(callee(expr())) matches this->x(), x(), y.x(), f() with callee(...) matching this->x, x, y.x, f respectively

Note: Callee cannot take the more general internal::Matcher<Expr> because this introduces ambiguous overloads with calls to Callee taking a internal::Matcher<Decl>, as the matcher hierarchy is purely implemented in terms of implicit casts.

Definition at line 2557 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( DeclaratorDecl  ,
hasTypeLoc  ,
internal::Matcher< TypeLoc >  ,
Inner   
)

Matches if the type location of the declarator decl's type matches the inner matcher.

Given

int x;

declaratorDecl(hasTypeLoc(loc(asString("int")))) matches int x

Definition at line 2630 of file ASTMatchers.h.

References Builder, Finder, and Node.

clang::ast_matchers::AST_MATCHER_P ( QualType  ,
asString  ,
std::string  ,
Name   
)

Matches if the matched type is represented by the given string.

Given

class Y { public: void x(); };
void z() { Y* y; y->x(); }

cxxMemberCallExpr(on(hasType(asString("class Y *")))) matches y->x()

Definition at line 2646 of file ASTMatchers.h.

References clang::Name, and Node.

clang::ast_matchers::AST_MATCHER_P ( QualType  ,
pointsTo  ,
internal::Matcher< QualType >  ,
InnerMatcher   
)

Matches if the matched type is a pointer type and the pointee type matches the specified matcher.

Example matches y->x() (matcher = cxxMemberCallExpr(on(hasType(pointsTo cxxRecordDecl(hasName("Y")))))))

class Y { public: void x(); };
void z() { Y *y; y->x(); }

Definition at line 2660 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( QualType  ,
references  ,
internal::Matcher< QualType >  ,
InnerMatcher   
)

Matches if the matched type is a reference type and the referenced type matches the specified matcher.

Example matches X &x and const X &y (matcher = varDecl(hasType(references(cxxRecordDecl(hasName("X"))))))

class X {
void a(X b) {
X &x = b;
const X &y = b;
}
};

Definition at line 2687 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( QualType  ,
hasCanonicalType  ,
internal::Matcher< QualType >  ,
InnerMatcher   
)

Matches QualTypes whose canonical type matches InnerMatcher.

Given:

typedef int &int_ref;
int a;
int_ref b = a;

varDecl(hasType(qualType(referenceType()))))) will not match the declaration of b but varDecl(hasType(qualType(hasCanonicalType(referenceType())))))) does.

Definition at line 2705 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( CXXMemberCallExpr  ,
onImplicitObjectArgument  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Definition at line 2719 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( DeclRefExpr  ,
to  ,
internal::Matcher< Decl ,
InnerMatcher   
)

Matches a DeclRefExpr that refers to a declaration that matches the specified matcher.

Example matches x in if(x) (matcher = declRefExpr(to(varDecl(hasName("x")))))

bool x;
if (x) {}

Definition at line 2752 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( DeclRefExpr  ,
throughUsingDecl  ,
internal::Matcher< UsingShadowDecl >  ,
InnerMatcher   
)

Matches a DeclRefExpr that refers to a declaration through a specific using shadow declaration.

Given

namespace a { void f() {} }
using a::f;
void g() {
f(); // Matches this ..
a::f(); // .. but not this.
}

declRefExpr(throughUsingDecl(anything())) matches f()

Definition at line 2773 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( DeclStmt  ,
hasSingleDecl  ,
internal::Matcher< Decl ,
InnerMatcher   
)

Matches the Decl of a DeclStmt which has a single declaration.

Given

int a, b;
int c;

declStmt(hasSingleDecl(anything())) matches 'int c;' but not 'int a, b;'.

Definition at line 2790 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( VarDecl  ,
hasInitializer  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches a variable declaration that has an initializer expression that matches the given matcher.

Example matches x (matcher = varDecl(hasInitializer(callExpr())))

bool y() { return true; }
bool x = y();

Definition at line 2806 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( DeclStmt  ,
declCountIs  ,
unsigned  ,
 
)

Matches declaration statements that contain a specific number of declarations.

Example: Given

int a, b;
int c;
int d = 2, e;

declCountIs(2) matches 'int a, b;' and 'int d = 2, e;', but not 'int c;'.

Definition at line 2951 of file ASTMatchers.h.

References distance(), and Node.

clang::ast_matchers::AST_MATCHER_P ( CXXConstructorDecl  ,
hasAnyConstructorInitializer  ,
internal::Matcher< CXXCtorInitializer >  ,
InnerMatcher   
)

Matches a C++ catch statement that has a catch-all handler.

Given

try {
// ...
} catch (int) {
// ...
} catch (...) {
// ...
}
/endcode
cxxCatchStmt(isCatchAll()) matches catch(...) but not catch(int).
AST_MATCHER(CXXCatchStmt, isCatchAll) {
return Node.getExceptionDecl() == nullptr;
}
\brief Matches a constructor initializer.
Given
\code
struct Foo {
Foo() : foo_(1) { }
int foo_;
};

cxxRecordDecl(has(cxxConstructorDecl( hasAnyConstructorInitializer(anything()) ))) record matches Foo, hasAnyConstructorInitializer matches foo_(1)

Definition at line 3014 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( CXXCtorInitializer  ,
forField  ,
internal::Matcher< FieldDecl >  ,
InnerMatcher   
)

Matches the field declaration of a constructor initializer.

Given

struct Foo {
Foo() : foo_(1) { }
int foo_;
};

cxxRecordDecl(has(cxxConstructorDecl(hasAnyConstructorInitializer( forField(hasName("foo_")))))) matches Foo with forField matching foo_

Definition at line 3033 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( CXXCtorInitializer  ,
withInitializer  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches the initializer expression of a constructor initializer.

Given

struct Foo {
Foo() : foo_(1) { }
int foo_;
};

cxxRecordDecl(has(cxxConstructorDecl(hasAnyConstructorInitializer( withInitializer(integerLiteral(equals(1))))))) matches Foo with withInitializer matching (1)

Definition at line 3053 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( FunctionDecl  ,
hasAnyParameter  ,
internal::Matcher< ParmVarDecl >  ,
InnerMatcher   
)

Matches any parameter of a function declaration.

Does not match the 'this' parameter of a method.

Given

class X { void f(int x, int y, int z) {} };

cxxMethodDecl(hasAnyParameter(hasName("y"))) matches f(int x, int y, int z) {} with hasAnyParameter(...) matching int y

Definition at line 3247 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( FunctionDecl  ,
returns  ,
internal::Matcher< QualType >  ,
InnerMatcher   
)

Matches the return type of a function declaration.

Given:

class X { int f() { return 1; } };

cxxMethodDecl(returns(asString("int"))) matches int f() { return 1; }

Definition at line 3285 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( IfStmt  ,
hasThen  ,
internal::Matcher< Stmt ,
InnerMatcher   
)

Matches the then-statement of an if statement.

Examples matches the if statement (matcher = ifStmt(hasThen(cxxBoolLiteral(equals(true)))))

if (false) true; else false;

Definition at line 3424 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( IfStmt  ,
hasElse  ,
internal::Matcher< Stmt ,
InnerMatcher   
)

Matches the else-statement of an if statement.

Examples matches the if statement (matcher = ifStmt(hasElse(cxxBoolLiteral(equals(true)))))

if (false) false; else true;

Definition at line 3436 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( IfStmt  ,
hasConditionVariableStatement  ,
internal::Matcher< DeclStmt >  ,
InnerMatcher   
)

Matches the condition variable statement in an if statement.

Given

if (A* a = GetAPointer()) {}

hasConditionVariableStatement(...) matches 'A* a = GetAPointer()'.

Definition at line 3486 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( ArraySubscriptExpr  ,
hasIndex  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches the index expression of an array subscript expression.

Given

int i[5];
void f() { i[1] = 42; }

arraySubscriptExpression(hasIndex(integerLiteral())) matches i[1] with the integerLiteral() matching 1

Definition at line 3503 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( ArraySubscriptExpr  ,
hasBase  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches the base expression of an array subscript expression.

Given

int i[5];
void f() { i[1] = 42; }

arraySubscriptExpression(hasBase(implicitCastExpr( hasSourceExpression(declRefExpr())))) matches i[1] with the declRefExpr() matching i

Definition at line 3520 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( CompoundStmt  ,
statementCountIs  ,
unsigned  ,
 
)

Checks that a compound statement contains a specific number of child statements.

Example: Given

{ for (;;) {} }

compoundStmt(statementCountIs(0))) matches '{}' but does not match the outer compound statement.

Definition at line 3579 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER_P ( UnaryOperator  ,
hasUnaryOperand  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches if the operand of a unary operator matches.

Example matches true (matcher = hasUnaryOperand( cxxBoolLiteral(equals(true))))

!true

Definition at line 3658 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( CastExpr  ,
hasCastKind  ,
CastKind  ,
Kind   
)

Matches casts that has a given cast kind.

Example: matches the implicit cast around 0 (matcher = castExpr(hasCastKind(CK_NullToPointer)))

int *p = 0;

Definition at line 3698 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER_P ( ExplicitCastExpr  ,
hasDestinationType  ,
internal::Matcher< QualType >  ,
InnerMatcher   
)

Matches casts whose destination type matches a given matcher.

(Note: Clang's AST refers to other conversions as "casts" too, and calls actual casts "explicit" casts.)

Definition at line 3706 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( ImplicitCastExpr  ,
hasImplicitDestinationType  ,
internal::Matcher< QualType >  ,
InnerMatcher   
)

Matches implicit casts whose destination type matches a given matcher.

FIXME: Unit test this matcher

Definition at line 3716 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( AbstractConditionalOperator  ,
hasTrueExpression  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches the true branch expression of a conditional operator.

Example 1 (conditional ternary operator): matches a

condition ? a : b

Example 2 (conditional binary operator): matches opaqueValueExpr(condition)

condition ?: b

Definition at line 3768 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( AbstractConditionalOperator  ,
hasFalseExpression  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches the false branch expression of a conditional operator (binary or ternary).

Example matches b

condition ? a : b
condition ?: b

Definition at line 3783 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( CXXMethodDecl  ,
ofClass  ,
internal::Matcher< CXXRecordDecl >  ,
InnerMatcher   
)

Matches the class declaration that the given method declaration belongs to.

FIXME: Generalize this for other kinds of declarations. FIXME: What other kind of declarations would we need to generalize this to?

Example matches A() in the last line (matcher = cxxConstructExpr(hasDeclaration(cxxMethodDecl( ofClass(hasName("A"))))))

class A {
public:
A();
};
A a = A();

Definition at line 3840 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( CXXMethodDecl  ,
forEachOverridden  ,
internal::Matcher< CXXMethodDecl >  ,
InnerMatcher   
)

Matches each method overriden by the given method.

This matcher may produce multiple matches.

Given

class A { virtual void f(); };
class B : public A { void f(); };
class C : public B { void f(); };

cxxMethodDecl(ofClass(hasName("C")), forEachOverridden(cxxMethodDecl().bind("b"))).bind("d") matches once, with "b" binding "A::f" and "d" binding "C::f" (Note that B::f is not overridden by C::f).

The check can produce multiple matches in case of multiple inheritance, e.g.

class A1 { virtual void f(); };
class A2 { virtual void f(); };
class C : public A1, public A2 { void f(); };

cxxMethodDecl(ofClass(hasName("C")), forEachOverridden(cxxMethodDecl().bind("b"))).bind("d") matches twice, once with "b" binding "A1::f" and "d" binding "C::f", and once with "b" binding "A2::f" and "d" binding "C::f".

Definition at line 3871 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, Node, and clang::Result.

clang::ast_matchers::AST_MATCHER_P ( MemberExpr  ,
member  ,
internal::Matcher< ValueDecl >  ,
InnerMatcher   
)

Matches a member expression where the member is matched by a given matcher.

Given

struct { int first, second; } first, second;
int i(second.first);
int j(first.second);

memberExpr(member(hasName("first"))) matches second.first but not first.second (because the member name there is "second").

Definition at line 4199 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( MemberExpr  ,
hasObjectExpression  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches a member expression where the object expression is matched by a given matcher.

Given

struct X { int m; };
void f(X x) { x.m; m; }

memberExpr(hasObjectExpression(hasType(cxxRecordDecl(hasName("X"))))))) matches "x.m" and "m" with hasObjectExpression(...) matching "x" and the implicit object expression of "m" which has type X*.

Definition at line 4216 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( UsingDecl  ,
hasAnyUsingShadowDecl  ,
internal::Matcher< UsingShadowDecl >  ,
InnerMatcher   
)

Matches any using shadow declaration.

Given

namespace X { void b(); }
using X::b;

usingDecl(hasAnyUsingShadowDecl(hasName("b")))) matches

using X::b

Definition at line 4230 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( UsingShadowDecl  ,
hasTargetDecl  ,
internal::Matcher< NamedDecl >  ,
InnerMatcher   
)

Matches a using shadow declaration where the target declaration is matched by the given matcher.

Given

namespace X { int a; void b(); }
using X::a;
using X::b;

usingDecl(hasAnyUsingShadowDecl(hasTargetDecl(functionDecl()))) matches

using X::b

but not

using X::a

Definition at line 4248 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( VariableArrayType  ,
hasSizeExpr  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches VariableArrayType nodes that have a specific size expression.

Given

void f(int b) {
int a[b];
}

variableArrayType(hasSizeExpr(ignoringImpCasts(declRefExpr(to( varDecl(hasName("b"))))))) matches "int a[b]"

Definition at line 4525 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( ElaboratedType  ,
hasQualifier  ,
internal::Matcher< NestedNameSpecifier >  ,
InnerMatcher   
)

Matches ElaboratedTypes whose qualifier, a NestedNameSpecifier, matches InnerMatcher if the qualifier exists.

Given

namespace N {
namespace M {
class D {};
}
}
N::M::D d;

elaboratedType(hasQualifier(hasPrefix(specifiesNamespace(hasName("N")))) matches the type of the variable declaration of d.

Definition at line 4851 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( ElaboratedType  ,
namesType  ,
internal::Matcher< QualType >  ,
InnerMatcher   
)

Matches ElaboratedTypes whose named type matches InnerMatcher.

Given

namespace N {
namespace M {
class D {};
}
}
N::M::D d;

elaboratedType(namesType(recordType( hasDeclaration(namedDecl(hasName("D")))))) matches the type of the variable declaration of d.

Definition at line 4874 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( DecayedType  ,
hasDecayedType  ,
internal::Matcher< QualType >  ,
InnerType   
)

Matches the decayed type, whos decayed type matches InnerMatcher.

Definition at line 4927 of file ASTMatchers.h.

References Builder, Finder, and Node.

clang::ast_matchers::AST_MATCHER_P ( Decl  ,
hasDeclContext  ,
internal::Matcher< Decl ,
InnerMatcher   
)

Matches declarations whose declaration context, interpreted as a Decl, matches InnerMatcher.

Given

namespace N {
namespace M {
class D {};
}
}

cxxRcordDecl(hasDeclContext(namedDecl(hasName("M")))) matches the declaration of class D.

Definition at line 4946 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( NestedNameSpecifier  ,
specifiesType  ,
internal::Matcher< QualType >  ,
InnerMatcher   
)

Matches nested name specifiers that specify a type matching the given QualType matcher without qualifiers.

Given

struct A { struct B { struct C {}; }; };

nestedNameSpecifier(specifiesType( hasDeclaration(cxxRecordDecl(hasName("A"))) )) matches "A::"

Definition at line 4993 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( NestedNameSpecifierLoc  ,
specifiesTypeLoc  ,
internal::Matcher< TypeLoc >  ,
InnerMatcher   
)

Matches nested name specifier locs that specify a type matching the given TypeLoc.

Given

struct A { struct B { struct C {}; }; };

nestedNameSpecifierLoc(specifiesTypeLoc(loc(type( hasDeclaration(cxxRecordDecl(hasName("A"))))))) matches "A::"

Definition at line 5011 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( NestedNameSpecifier  ,
specifiesNamespace  ,
internal::Matcher< NamespaceDecl >  ,
InnerMatcher   
)

Matches nested name specifiers that specify a namespace matching the given namespace matcher.

Given

namespace ns { struct A {}; }
ns::A a;

nestedNameSpecifier(specifiesNamespace(hasName("ns"))) matches "ns::"

Definition at line 5062 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( SwitchStmt  ,
forEachSwitchCase  ,
internal::Matcher< SwitchCase >  ,
InnerMatcher   
)

Matches each case or default statement belonging to the given switch statement.

This matcher may produce multiple matches.

Given

switch (1) { case 1: case 2: default: switch (2) { case 3: case 4: ; } }

switchStmt(forEachSwitchCase(caseStmt().bind("c"))).bind("s") matches four times, with "c" binding each of "case 1:", "case 2:", "case 3:" and "case 4:", and "s" respectively binding "switch (1)", "switch (1)", "switch (2)" and "switch (2)".

Definition at line 5105 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, Node, and clang::Result.

clang::ast_matchers::AST_MATCHER_P ( CXXConstructorDecl  ,
forEachConstructorInitializer  ,
internal::Matcher< CXXCtorInitializer >  ,
InnerMatcher   
)

Matches each constructor initializer in a constructor definition.

Given

class A { A() : i(42), j(42) {} int i; int j; };

cxxConstructorDecl(forEachConstructorInitializer( forField(decl().bind("x")) )) will trigger two matches, binding for 'i' and 'j' respectively.

Definition at line 5136 of file ASTMatchers.h.

References Builder, Finder, I, InnerMatcher, Node, and clang::Result.

clang::ast_matchers::AST_MATCHER_P ( CaseStmt  ,
hasCaseConstant  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

If the given case statement does not use the GNU case range extension, matches the constant given in the statement.

Given

switch (1) { case 1: case 1+1: case 3 ... 4: ; }

caseStmt(hasCaseConstant(integerLiteral())) matches "case 1:"

Definition at line 5280 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( Decl  ,
hasAttr  ,
attr::Kind  ,
AttrKind   
)

Matches declaration that has a given attribute.

Given

__attribute__((device)) void f() { ... }

decl(hasAttr(clang::attr::CUDADevice)) matches the function declaration of f. If the matcher is use from clang-query, attr::Kind parameter should be passed as a quoted string. e.g., hasAttr("attr::CUDADevice").

Definition at line 5297 of file ASTMatchers.h.

References clang::Attr::getKind(), and Node.

clang::ast_matchers::AST_MATCHER_P ( ReturnStmt  ,
hasReturnValue  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches the return value expression of a return statement.

Given

return a + b;

hasReturnValue(binaryOperator()) matches 'return a + b' with binaryOperator() matching 'a + b'

Definition at line 5315 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P ( Stmt  ,
forFunction  ,
internal::Matcher< FunctionDecl >  ,
InnerMatcher   
)

Matches declaration of the function the statemenet belongs to.

Given:

F& operator=(const F& o) {
std::copy_if(o.begin(), o.end(), begin(), [](V v) { return v > 0; });
return *this;
}

returnStmt(forFunction(hasName("operator="))) matches 'return *this' but does match 'return > 0'

Definition at line 5367 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, Node, and Stack.

clang::ast_matchers::AST_MATCHER_P2 ( DeclStmt  ,
containsDeclaration  ,
unsigned  ,
,
internal::Matcher< Decl ,
InnerMatcher   
)

Matches the n'th declaration of a declaration statement.

Note that this does not work for global declarations because the AST breaks up multiple-declaration DeclStmt's into multiple single-declaration DeclStmt's. Example: Given non-global declarations

int a, b = 0;
int c;
int d = 2, e;

declStmt(containsDeclaration( 0, varDecl(hasInitializer(anything())))) matches only 'int d = 2, e;', and declStmt(containsDeclaration(1, varDecl()))

matches 'int a, b = 0' as well as 'int d = 2, e;'
but 'int c;' is not matched.

Definition at line 2974 of file ASTMatchers.h.

References Builder, distance(), Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P2 ( FunctionDecl  ,
hasParameter  ,
unsigned  ,
,
internal::Matcher< ParmVarDecl >  ,
InnerMatcher   
)

Matches the n'th parameter of a function declaration.

Given

class X { void f(int x) {} };

cxxMethodDecl(hasParameter(0, hasType(varDecl()))) matches f(int x) {} with hasParameter(...) matching int x

Definition at line 3173 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P_OVERLOAD ( CXXRecordDecl  ,
isDerivedFrom  ,
std::string  ,
BaseName  ,
 
)

Overloaded method as shortcut for isDerivedFrom(hasName(...)).

Definition at line 2194 of file ASTMatchers.h.

References Builder, Finder, hasName(), and Node.

clang::ast_matchers::AST_MATCHER_P_OVERLOAD ( CXXRecordDecl  ,
isSameOrDerivedFrom  ,
internal::Matcher< NamedDecl >  ,
Base  ,
 
)

Similar to isDerivedFrom(), but also matches classes that directly match Base.

Definition at line 2201 of file ASTMatchers.h.

References anyOf, Builder, Finder, clang::threadSafety::sx::matches(), and Node.

clang::ast_matchers::AST_MATCHER_P_OVERLOAD ( CXXRecordDecl  ,
isSameOrDerivedFrom  ,
std::string  ,
BaseName  ,
 
)

Overloaded method as shortcut for isSameOrDerivedFrom(hasName(...)).

Definition at line 2209 of file ASTMatchers.h.

References Builder, Finder, hasName(), and Node.

clang::ast_matchers::AST_MATCHER_P_OVERLOAD ( CallExpr  ,
callee  ,
internal::Matcher< Decl ,
InnerMatcher  ,
 
)

Matches if the call expression's callee's declaration matches the given matcher.

Example matches y.x() (matcher = callExpr(callee( cxxMethodDecl(hasName("x")))))

class Y { public: void x(); };
void z() { Y y; y.x(); }

Definition at line 2573 of file ASTMatchers.h.

References Builder, callExpr, Finder, hasDeclaration(), InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P_OVERLOAD ( QualType  ,
pointsTo  ,
internal::Matcher< Decl ,
InnerMatcher  ,
 
)

Overloaded to match the pointee type's declaration.

Definition at line 2668 of file ASTMatchers.h.

References Builder, Finder, hasDeclaration(), InnerMatcher, Node, and qualType.

clang::ast_matchers::AST_MATCHER_P_OVERLOAD ( QualType  ,
references  ,
internal::Matcher< Decl ,
InnerMatcher  ,
 
)

Overloaded to match the referenced type's declaration.

Definition at line 2713 of file ASTMatchers.h.

References Builder, Finder, hasDeclaration(), InnerMatcher, Node, and qualType.

clang::ast_matchers::AST_MATCHER_P_OVERLOAD ( CXXMemberCallExpr  ,
thisPointerType  ,
internal::Matcher< QualType >  ,
InnerMatcher  ,
 
)

Matches if the expression's type either matches the specified matcher, or is a pointer to a type that matches the InnerMatcher.

Definition at line 2728 of file ASTMatchers.h.

References anyOf, Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P_OVERLOAD ( CXXMemberCallExpr  ,
thisPointerType  ,
internal::Matcher< Decl ,
InnerMatcher  ,
 
)

Overloaded to match the type's declaration.

Definition at line 2736 of file ASTMatchers.h.

References anyOf, Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P_OVERLOAD ( NestedNameSpecifier  ,
hasPrefix  ,
internal::Matcher< NestedNameSpecifier >  ,
InnerMatcher  ,
 
)

Matches on the prefix of a NestedNameSpecifier.

Given

struct A { struct B { struct C {}; }; };

nestedNameSpecifier(hasPrefix(specifiesType(asString("struct A")))) and matches "A::"

Definition at line 5025 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P_OVERLOAD ( NestedNameSpecifierLoc  ,
hasPrefix  ,
internal::Matcher< NestedNameSpecifierLoc >  ,
InnerMatcher  ,
 
)

Matches on the prefix of a NestedNameSpecifierLoc.

Given

struct A { struct B { struct C {}; }; };

nestedNameSpecifierLoc(hasPrefix(loc(specifiesType(asString("struct A"))))) matches "A::"

Definition at line 5043 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_MATCHER_P_OVERLOAD ( Decl  ,
equalsNode  ,
const Decl ,
Other  ,
 
)

Overloads for the equalsNode matcher.

FIXME: Implement for other node types.Matches if a node equals another node.

Decl has pointer identity in the AST.

Definition at line 5076 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER_P_OVERLOAD ( Stmt  ,
equalsNode  ,
const Stmt ,
Other  ,
 
)

Matches if a node equals another node.

Stmt has pointer identity in the AST.

Definition at line 5082 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_MATCHER_P_OVERLOAD ( Type  ,
equalsNode  ,
const Type *  ,
Other  ,
 
)

Matches if a node equals another node.

Type has pointer identity in the AST.

Definition at line 5088 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER ( isExpansionInMainFile  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(Decl, Stmt, TypeLoc)   
)

Matches AST nodes that were expanded within the main-file.

Example matches X but not Y (matcher = cxxRecordDecl(isExpansionInMainFile())

#include <Y.h>
class X {};

Y.h:

class Y {};

Usable as: Matcher<Decl>, Matcher<Stmt>, Matcher<TypeLoc>

Definition at line 209 of file ASTMatchers.h.

References Finder, clang::SourceManager::getExpansionLoc(), clang::SourceManager::isInMainFile(), and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER ( isExpansionInSystemHeader  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(Decl, Stmt, TypeLoc)   
)

Matches AST nodes that were expanded within system-header-files.

Example matches Y but not X (matcher = cxxRecordDecl(isExpansionInSystemHeader())

#include <SystemHeader.h>
class X {};

SystemHeader.h:

class Y {};

Usable as: Matcher<Decl>, Matcher<Stmt>, Matcher<TypeLoc>

Definition at line 230 of file ASTMatchers.h.

References Finder, clang::SourceManager::getExpansionLoc(), clang::SourceManager::isInSystemHeader(), and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER ( hasDynamicExceptionSpec  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(FunctionDecl,FunctionProtoType)   
)

Matches functions that have a dynamic exception specification.

Given:

void f();
void g() noexcept;
void h() noexcept(true);
void i() noexcept(false);
void j() throw();
void k() throw(int);
void l() throw(...);

functionDecl(hasDynamicExceptionSpec()) and functionProtoType(hasDynamicExceptionSpec()) match the declarations of j, k, and l, but not f, g, h, or i.

Definition at line 3345 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER ( isNoThrow  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(FunctionDecl,FunctionProtoType)   
)

Matches functions that have a non-throwing exception specification.

Given:

void f();
void g() noexcept;
void h() throw();
void i() throw(int);
void j() noexcept(false);

functionDecl(isNoThrow()) and functionProtoType(isNoThrow()) match the declarations of g, and h, but not f, i or j.

Definition at line 3365 of file ASTMatchers.h.

References Finder, clang::FunctionProtoType::getExceptionSpecType(), clang::FunctionProtoType::isNothrow(), clang::isUnresolvedExceptionSpec(), and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER ( isConstexpr  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(VarDecl,FunctionDecl)   
)

Matches constexpr variable and function declarations.

Given:

constexpr int foo = 42;
constexpr int bar();

varDecl(isConstexpr()) matches the declaration of foo. functionDecl(isConstexpr()) matches the declaration of bar.

Definition at line 3394 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER ( isDefinition  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(TagDecl, VarDecl,FunctionDecl)   
)

Matches if a declaration has a body attached.

Example matches A, va, fa

class A {};
class B; // Doesn't match, as it has no body.
int va;
extern int vb; // Doesn't match, as it doesn't define the variable.
void fa() {}
void fb(); // Doesn't match, as it has no body.

Usable as: Matcher<TagDecl>, Matcher<VarDecl>, Matcher<FunctionDecl>

Definition at line 3803 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER ( isFinal  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(CXXRecordDecl,CXXMethodDecl)   
)

Matches if the given method or class declaration is final.

Given:

class A final {};
struct B {
virtual void f();
};
struct C : B {
void f() final;
};

matches A and C::f, but not B, C, or B::f

Definition at line 3935 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER ( isTemplateInstantiation  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(FunctionDecl, VarDecl,CXXRecordDecl)   
)

Matches template instantiations of function, class, or static member variable template instantiations.

Given

template <typename T> class X {}; class A {}; X<A> x;

or

template <typename T> class X {}; class A {}; template class X<A>;

cxxRecordDecl(hasName("::X"), isTemplateInstantiation()) matches the template instantiation of X.

But given

template <typename T> class X {}; class A {};
template <> class X<A> {}; X<A> x;

cxxRecordDecl(hasName("::X"), isTemplateInstantiation()) does not match, as X is an explicit template specialization.

Usable as: Matcher<FunctionDecl>, Matcher<VarDecl>, Matcher<CXXRecordDecl>

Definition at line 4276 of file ASTMatchers.h.

References Node, clang::TSK_ExplicitInstantiationDefinition, and clang::TSK_ImplicitInstantiation.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER ( isExplicitTemplateSpecialization  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(FunctionDecl, VarDecl,CXXRecordDecl)   
)

Matches explicit template specializations of function, class, or static member variable template instantiations.

Given

template<typename T> void A(T t) { }
template<> void A(int N) { }

functionDecl(isExplicitTemplateSpecialization()) matches the specialization A<int>().

Usable as: Matcher<FunctionDecl>, Matcher<VarDecl>, Matcher<CXXRecordDecl>

Definition at line 4333 of file ASTMatchers.h.

References Node, and clang::TSK_ExplicitSpecialization.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER ( isExplicit  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(CXXConstructorDecl,CXXConversionDecl)   
)

Matches constructor and conversion declarations that are marked with the explicit keyword.

Given

struct S {
S(int); // #1
explicit S(double); // #2
operator int(); // #3
explicit operator bool(); // #4
};

cxxConstructorDecl(isExplicit()) will match #2, but not #1. cxxConversionDecl(isExplicit()) will match #4, but not #3.

Definition at line 5227 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER ( isInline  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(NamespaceDecl,FunctionDecl)   
)

Matches function and namespace declarations that are marked with the inline keyword.

Given

inline void f();
void g();
namespace n {
inline namespace m {}
}

functionDecl(isInline()) will match ::f(). namespaceDecl(isInline()) will match n::m.

Definition at line 5246 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( isExpansionInFileMatching  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(Decl, Stmt, TypeLoc)  ,
std::string  ,
RegExp   
)

Matches AST nodes that were expanded within files whose name is partially matching a given regex.

Example matches Y but not X (matcher = cxxRecordDecl(isExpansionInFileMatching("AST.*"))

#include "ASTMatcher.h"
class X {};

ASTMatcher.h:

class Y {};

Usable as: Matcher<Decl>, Matcher<Stmt>, Matcher<TypeLoc>

Definition at line 255 of file ASTMatchers.h.

References Filename, Finder, clang::SourceManager::getExpansionLoc(), clang::SourceManager::getFileEntryForID(), clang::SourceManager::getFileID(), clang::FileEntry::getName(), and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( hasAnyTemplateArgument  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(ClassTemplateSpecializationDecl,TemplateSpecializationType)  ,
internal::Matcher< TemplateArgument >  ,
InnerMatcher   
)

Matches classTemplateSpecializations that have at least one TemplateArgument matching the given InnerMatcher.

Given

template<typename T> class A {};
template<> class A<double> {};
A<int> a;

classTemplateSpecializationDecl(hasAnyTemplateArgument( refersToType(asString("int")))) matches the specialization A<int>

Definition at line 572 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( templateArgumentCountIs  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(ClassTemplateSpecializationDecl,TemplateSpecializationType)  ,
unsigned  ,
 
)

Matches if the number of template arguments equals N.

Given

template<typename T> struct C {};
C<int> c;

classTemplateSpecializationDecl(templateArgumentCountIs(1)) matches C<int>.

Definition at line 735 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( argumentCountIs  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(CallExpr,CXXConstructExpr,ObjCMessageExpr)  ,
unsigned  ,
 
)

Checks that a call expression or a constructor call expression has a specific number of arguments (including absent default arguments).

Example matches f(0, 0) (matcher = callExpr(argumentCountIs(2)))

void f(int x, int y);
f(0, 0);

Definition at line 2914 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( hasAnyArgument  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(CallExpr,CXXConstructExpr)  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches any argument of a call expression or a constructor call expression.

Given

void x(int, int, int) { int y; x(1, y, 42); }

callExpr(hasAnyArgument(declRefExpr())) matches x(1, y, 42) with hasAnyArgument(...) matching y

Definition at line 3128 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, Node, and clang::Result.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( parameterCountIs  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(FunctionDecl,FunctionProtoType)  ,
unsigned  ,
 
)

Matches FunctionDecls and FunctionProtoTypes that have a specific parameter count.

Given

void f(int i) {}
void g(int i, int j) {}
void h(int i, int j);
void j(int i);
void k(int x, int y, int z, ...);

functionDecl(parameterCountIs(2)) matches void g(int i, int j) {} functionProtoType(parameterCountIs(2)) matches void h(int i, int j) functionProtoType(parameterCountIs(3)) matches void k(int x, int y, int z, ...);

Definition at line 3270 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( hasCondition  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(IfStmt, ForStmt, WhileStmt, DoStmt,SwitchStmt, AbstractConditionalOperator)  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches the condition expression of an if statement, for loop, switch statement or conditional operator.

Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true))))

if (true) {}

Definition at line 3407 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( equalsBoundNode  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(Stmt, Decl, Type,QualType)  ,
std::string  ,
ID   
)

Matches if a node equals a previously bound node.

Matches a node if it equals the node previously bound to ID.

Given

class X { int a; int b; };

cxxRecordDecl( has(fieldDecl(hasName("a"), hasType(type().bind("t")))), has(fieldDecl(hasName("b"), hasType(type(equalsBoundNode("t")))))) matches the class X, as a and b have the same type.

Note that when multiple matches are involved via forEach* matchers, equalsBoundNodes acts as a filter. For example: compoundStmt( forEachDescendant(varDecl().bind("d")), forEachDescendant(declRefExpr(to(decl(equalsBoundNode("d")))))) will trigger a match for each combination of variable declaration and reference to that variable declaration within a compound statement.

Definition at line 3462 of file ASTMatchers.h.

References Builder, clang::ast_type_traits::DynTypedNode::create(), ID, and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( hasBody  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(DoStmt, ForStmt,WhileStmt,CXXForRangeStmt,FunctionDecl)  ,
internal::Matcher< Stmt ,
InnerMatcher   
)

Matches a 'for', 'while', 'do while' statement or a function definition that has a given body.

Given

for (;;) {}

hasBody(compoundStmt()) matches 'for (;;) {}' with compoundStmt() matching '{}'

Definition at line 3538 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( hasAnySubstatement  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(CompoundStmt,StmtExpr)  ,
internal::Matcher< Stmt ,
InnerMatcher   
)

Matches compound statements where at least one substatement matches a given matcher.

Also matches StmtExprs that have CompoundStmt as children.

Given

{ {}; 1+2; }

hasAnySubstatement(compoundStmt()) matches '{ {}; 1+2; }' with compoundStmt() matching '{}'

Definition at line 3560 of file ASTMatchers.h.

References clang::CompoundStmt::body_begin(), clang::CompoundStmt::body_end(), Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( hasOperatorName  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(BinaryOperator,UnaryOperator)  ,
std::string  ,
Name   
)

Matches the operator Name of operator expressions (binary or unary).

Example matches a || b (matcher = binaryOperator(hasOperatorName("||")))

!(a || b)

Definition at line 3607 of file ASTMatchers.h.

References clang::Name, and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( hasLHS  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(BinaryOperator,ArraySubscriptExpr)  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches the left hand side of binary operator expressions.

Example matches a (matcher = binaryOperator(hasLHS()))

a || b

Definition at line 3620 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( hasRHS  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(BinaryOperator,ArraySubscriptExpr)  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches the right hand side of binary operator expressions.

Example matches b (matcher = binaryOperator(hasRHS()))

a || b

Definition at line 3635 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( hasSourceExpression  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(CastExpr,OpaqueValueExpr)  ,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches if the cast's source expression or opaque value's source expression matches the given matcher.

Example 1: matches "a string" (matcher = castExpr(hasSourceExpression(cxxConstructExpr())))

class URL { URL(string); };
URL url = "a string";

Example 2: matches 'b' (matcher = opaqueValueExpr(hasSourceExpression(implicitCastExpr(declRefExpr())))

int a = b ?: 1;

Definition at line 3681 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P ( hasSize  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(ConstantArrayType,StringLiteral)  ,
unsigned  ,
 
)

Matches nodes that have the specified size.

Given

int a[42];
int b[2 * 21];
int c[41], d[43];
char *s = "abcd";
wchar_t *ws = L"abcd";
char *w = "a";

constantArrayType(hasSize(42)) matches "int a[42]" and "int b[2 * 21]" stringLiteral(hasSize(4)) matches "abcd", L"abcd"

Definition at line 4466 of file ASTMatchers.h.

References Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P2 ( hasTemplateArgument  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(ClassTemplateSpecializationDecl,TemplateSpecializationType)  ,
unsigned  ,
,
internal::Matcher< TemplateArgument >  ,
InnerMatcher   
)

Matches classTemplateSpecializations where the n'th TemplateArgument matches the given InnerMatcher.

Given

template<typename T, typename U> class A {};
A<bool, int> b;
A<int, bool> c;

classTemplateSpecializationDecl(hasTemplateArgument( 1, refersToType(asString("int")))) matches the specialization A<bool, int>

Definition at line 714 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P2 ( hasArgument  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(CallExpr,CXXConstructExpr,ObjCMessageExpr)  ,
unsigned  ,
,
internal::Matcher< Expr >  ,
InnerMatcher   
)

Matches the n'th argument of a call expression or a constructor call expression.

Example matches y in x(y) (matcher = callExpr(hasArgument(0, declRefExpr())))

void x(int) { int y; x(y); }

Definition at line 2930 of file ASTMatchers.h.

References Builder, Finder, InnerMatcher, and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P2 ( forEachArgumentWithParam  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(CallExpr,CXXConstructExpr)  ,
internal::Matcher< Expr >  ,
ArgMatcher  ,
internal::Matcher< ParmVarDecl >  ,
ParamMatcher   
)

Matches all arguments and their respective ParmVarDecl.

Given

void f(int i);
int y;
f(y);

callExpr( forEachArgumentWithParam( declRefExpr(to(varDecl(hasName("y")))), parmVarDecl(hasType(isInteger())) )) matches f(y); with declRefExpr(...) matching int y and parmVarDecl(...) matching int i

Definition at line 3199 of file ASTMatchers.h.

References anyOf, Builder, callExpr, cxxConstructExpr, cxxConstructorDecl, cxxMethodDecl, cxxOperatorCallExpr, expr, Finder, functionDecl, hasDeclaration(), clang::threadSafety::sx::matches(), Matches, Node, and clang::Result.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P_OVERLOAD ( hasType  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(Expr, TypedefNameDecl, ValueDecl)  ,
internal::Matcher< QualType >  ,
InnerMatcher  ,
 
)

Matches if the expression's or declaration's type matches a type matcher.

Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X"))))) and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X"))))) and U (matcher = typedefDecl(hasType(asString("int")))

class X {};
void y(X &x) { x; X z; }
typedef int U;

Definition at line 2589 of file ASTMatchers.h.

References Builder, Finder, getUnderlyingType(), InnerMatcher, and Node.

clang::ast_matchers::AST_POLYMORPHIC_MATCHER_P_OVERLOAD ( hasType  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(Expr,ValueDecl)  ,
internal::Matcher< Decl ,
InnerMatcher  ,
 
)

Overloaded to match the declaration of the expression's or value declaration's type.

In case of a value declaration (for example a variable declaration), this resolves one layer of indirection. For example, in the value declaration "X x;", cxxRecordDecl(hasName("X")) matches the declaration of X, while varDecl(hasType(cxxRecordDecl(hasName("X")))) matches the declaration of x.

Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X"))))) and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X")))))

class X {};
void y(X &x) { x; X z; }

Usable as: Matcher<Expr>, Matcher<ValueDecl>

Definition at line 2613 of file ASTMatchers.h.

References Builder, Finder, hasDeclaration(), InnerMatcher, Node, and qualType.

clang::ast_matchers::AST_TYPE_MATCHER ( BuiltinType  ,
builtinType   
)

Matches builtin Types.

Given

struct A {};
A a;
int b;
float c;
bool d;

builtinType() matches "int b", "float c" and "bool d"

clang::ast_matchers::AST_TYPE_MATCHER ( ArrayType  ,
arrayType   
)

Matches all kinds of arrays.

Given

int a[] = { 2, 3 };
int b[4];
void f() { int c[a[0]]; }

arrayType() matches "int a[]", "int b[4]" and "int c[a[0]]";

clang::ast_matchers::AST_TYPE_MATCHER ( ComplexType  ,
complexType   
)

Matches C99 complex types.

Given

_Complex float f;

complexType() matches "_Complex float f"

clang::ast_matchers::AST_TYPE_MATCHER ( ConstantArrayType  ,
constantArrayType   
)

Matches C arrays with a specified constant size.

Given

void() {
int a[2];
int b[] = { 2, 3 };
int c[b[0]];
}

constantArrayType() matches "int a[2]"

clang::ast_matchers::AST_TYPE_MATCHER ( DependentSizedArrayType  ,
dependentSizedArrayType   
)

Matches C++ arrays whose size is a value-dependent expression.

Given

template<typename T, int Size>
class array {
T data[Size];
};

dependentSizedArrayType matches "T data[Size]"

clang::ast_matchers::AST_TYPE_MATCHER ( IncompleteArrayType  ,
incompleteArrayType   
)

Matches C arrays with unspecified size.

Given

int a[] = { 2, 3 };
int b[42];
void f(int c[]) { int d[a[0]]; };

incompleteArrayType() matches "int a[]" and "int c[]"

clang::ast_matchers::AST_TYPE_MATCHER ( VariableArrayType  ,
variableArrayType   
)

Matches C arrays with a specified size that is not an integer-constant-expression.

Given

void f() {
int a[] = { 2, 3 }
int b[42];
int c[a[0]];
}

variableArrayType() matches "int c[a[0]]"

clang::ast_matchers::AST_TYPE_MATCHER ( AtomicType  ,
atomicType   
)

Matches atomic types.

Given

_Atomic(int) i;

atomicType() matches "_Atomic(int) i"

clang::ast_matchers::AST_TYPE_MATCHER ( AutoType  ,
autoType   
)

Matches types nodes representing C++11 auto types.

Given:

auto n = 4;
int v[] = { 2, 3 }
for (auto i : v) { }

autoType() matches "auto n" and "auto i"

clang::ast_matchers::AST_TYPE_MATCHER ( FunctionType  ,
functionType   
)

Matches FunctionType nodes.

Given

int (*f)(int);
void g();

functionType() matches "int (*f)(int)" and the type of "g".

clang::ast_matchers::AST_TYPE_MATCHER ( FunctionProtoType  ,
functionProtoType   
)

Matches FunctionProtoType nodes.

Given

int (*f)(int);
void g();

functionProtoType() matches "int (*f)(int)" and the type of "g" in C++ mode. In C mode, "g" is not matched because it does not contain a prototype.

clang::ast_matchers::AST_TYPE_MATCHER ( ParenType  ,
parenType   
)

Matches ParenType nodes.

Given

int (*ptr_to_array)[4];
int *array_of_ptrs[4];

varDecl(hasType(pointsTo(parenType()))) matches ptr_to_array but not array_of_ptrs.

clang::ast_matchers::AST_TYPE_MATCHER ( BlockPointerType  ,
blockPointerType   
)

Matches block pointer types, i.e.

types syntactically represented as "void (^)(int)".

The pointee is always required to be a FunctionType.

clang::ast_matchers::AST_TYPE_MATCHER ( MemberPointerType  ,
memberPointerType   
)

Matches member pointer types.

Given

struct A { int i; }
A::* ptr = A::i;

memberPointerType() matches "A::* ptr"

clang::ast_matchers::AST_TYPE_MATCHER ( PointerType  ,
pointerType   
)

Matches pointer types, but does not match Objective-C object pointer types.

Given

int *a;
int &b = *a;
int c = 5;
@interface Foo
@end
Foo *f;

pointerType() matches "int *a", but does not match "Foo *f".

clang::ast_matchers::AST_TYPE_MATCHER ( ObjCObjectPointerType  ,
objcObjectPointerType   
)

Matches an Objective-C object pointer type, which is different from a pointer type, despite being syntactically similar.

Given

int *a;
@interface Foo
@end
Foo *f;

pointerType() matches "Foo *f", but does not match "int *a".

clang::ast_matchers::AST_TYPE_MATCHER ( ReferenceType  ,
referenceType   
)

Matches both lvalue and rvalue reference types.

Given

int *a;
int &b = *a;
int &&c = 1;
auto &d = b;
auto &&e = c;
auto &&f = 2;
int g = 5;

referenceType() matches the types of b, c, d, e, and f.

clang::ast_matchers::AST_TYPE_MATCHER ( LValueReferenceType  ,
lValueReferenceType   
)

Matches lvalue reference types.

Given:

int *a;
int &b = *a;
int &&c = 1;
auto &d = b;
auto &&e = c;
auto &&f = 2;
int g = 5;

lValueReferenceType() matches the types of b, d, and e. e is matched since the type is deduced as int& by reference collapsing rules.

clang::ast_matchers::AST_TYPE_MATCHER ( RValueReferenceType  ,
rValueReferenceType   
)

Matches rvalue reference types.

Given:

int *a;
int &b = *a;
int &&c = 1;
auto &d = b;
auto &&e = c;
auto &&f = 2;
int g = 5;

rValueReferenceType() matches the types of c and f. e is not matched as it is deduced to int& by reference collapsing rules.

clang::ast_matchers::AST_TYPE_MATCHER ( TypedefType  ,
typedefType   
)

Matches typedef types.

Given

typedef int X;

typedefType() matches "typedef int X"

clang::ast_matchers::AST_TYPE_MATCHER ( EnumType  ,
enumType   
)

Matches enum types.

Given

enum C { Green };
enum class S { Red };
C c;
S s;

enumType() matches the type of the variable declarations of both c and s.

clang::ast_matchers::AST_TYPE_MATCHER ( TemplateSpecializationType  ,
templateSpecializationType   
)

Matches template specialization types.

Given

template <typename T>
class C { };
template class C<int>; // A
C<char> var; // B

templateSpecializationType() matches the type of the explicit instantiation in A and the type of the variable declaration in B.

clang::ast_matchers::AST_TYPE_MATCHER ( UnaryTransformType  ,
unaryTransformType   
)

Matches types nodes representing unary type transformations.

Given:

typedef __underlying_type(T) type;

unaryTransformType() matches "__underlying_type(T)"

clang::ast_matchers::AST_TYPE_MATCHER ( RecordType  ,
recordType   
)

Matches record types (e.g.

structs, classes).

Given

class C {};
struct S {};
C c;
S s;

recordType() matches the type of the variable declarations of both c and s.

clang::ast_matchers::AST_TYPE_MATCHER ( ElaboratedType  ,
elaboratedType   
)

Matches types specified with an elaborated type keyword or with a qualified name.

Given

namespace N {
namespace M {
class D {};
}
}
class C {};
class C c;
N::M::D d;

elaboratedType() matches the type of the variable declarations of both c and d.

clang::ast_matchers::AST_TYPE_MATCHER ( SubstTemplateTypeParmType  ,
substTemplateTypeParmType   
)

Matches types that represent the result of substituting a type for a template type parameter.

Given

template <typename T>
void F(T t) {
int i = 1 + t;
}

substTemplateTypeParmType() matches the type of 't' but not '1'

clang::ast_matchers::AST_TYPE_MATCHER ( TemplateTypeParmType  ,
templateTypeParmType   
)

Matches template type parameter types.

Example matches T, but not int. (matcher = templateTypeParmType())

template <typename T> void f(int i);
clang::ast_matchers::AST_TYPE_MATCHER ( InjectedClassNameType  ,
injectedClassNameType   
)

Matches injected class name types.

Example matches S s, but not S<T> s. (matcher = parmVarDecl(hasType(injectedClassNameType())))

template <typename T> struct S {
void f(S s);
void g(S<T> s);
};
clang::ast_matchers::AST_TYPE_MATCHER ( DecayedType  ,
decayedType   
)

Matches decayed type Example matches i[] in declaration of f.

(matcher = valueDecl(hasType(decayedType(hasDecayedType(pointerType()))))) Example matches i[1]. (matcher = expr(hasType(decayedType(hasDecayedType(pointerType())))))

void f(int i[]) {
i[1] = 0;
}
clang::ast_matchers::AST_TYPE_TRAVERSE_MATCHER ( hasDeducedType  ,
getDeducedType  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(AutoType)   
)

Matches AutoType nodes where the deduced type is a specific type.

Note: There is no TypeLoc for the deduced type and thus no getDeducedLoc() matcher.

Given

auto a = 1;
auto b = 2.0;

autoType(hasDeducedType(isInteger())) matches "auto a"

Usable as: Matcher<AutoType>

clang::ast_matchers::AST_TYPE_TRAVERSE_MATCHER ( innerType  ,
getInnerType  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(ParenType)   
)

Matches ParenType nodes where the inner type is a specific type.

Given

int (*ptr_to_array)[4];
int (*ptr_to_func)(int);

varDecl(hasType(pointsTo(parenType(innerType(functionType()))))) matches ptr_to_func but not ptr_to_array.

Usable as: Matcher<ParenType>

clang::ast_matchers::AST_TYPELOC_TRAVERSE_MATCHER ( hasElementType  ,
getElement  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(ArrayType, ComplexType)   
)

Matches arrays and C99 complex types that have a specific element type.

Given

struct A {};
A a[7];
int b[7];

arrayType(hasElementType(builtinType())) matches "int b[7]"

Usable as: Matcher<ArrayType>, Matcher<ComplexType>

clang::ast_matchers::AST_TYPELOC_TRAVERSE_MATCHER ( hasValueType  ,
getValue  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(AtomicType)   
)

Matches atomic types with a specific value type.

Given

_Atomic(int) i;
_Atomic(float) f;

atomicType(hasValueType(isInteger())) matches "_Atomic(int) i"

Usable as: Matcher<AtomicType>

clang::ast_matchers::AST_TYPELOC_TRAVERSE_MATCHER ( pointee  ,
getPointee  ,
AST_POLYMORPHIC_SUPPORTED_TYPES(BlockPointerType, MemberPointerType, PointerType, ReferenceType)   
)

Narrows PointerType (and similar) matchers to those where the pointee matches a given matcher.

Given

int *a;
int const *b;
float const *f;

pointerType(pointee(isConstQualified(), isInteger())) matches "int const *b"

Usable as: Matcher<BlockPointerType>, Matcher<MemberPointerType>, Matcher<PointerType>, Matcher<ReferenceType>

template<typename ValueT >
internal::PolymorphicMatcherWithParam1<internal::ValueEqualsMatcher, ValueT> clang::ast_matchers::equals ( const ValueT &  Value)

Matches literals that are equal to the given value.

Example matches true (matcher = cxxBoolLiteral(equals(true)))

true

Usable as: Matcher<CharacterLiteral>, Matcher<CXXBoolLiteral>, Matcher<FloatingLiteral>, Matcher<IntegerLiteral>

Definition at line 3594 of file ASTMatchers.h.

Referenced by AST_MATCHER_FUNCTION().

template<typename T >
internal::Matcher<T> clang::ast_matchers::findAll ( const internal::Matcher< T > &  Matcher)

Matches if the node or any descendant matches.

Generates results for each match.

For example, in:

class A { class B {}; class C {}; };

The matcher:

findAll(cxxRecordDecl(isDefinition()).bind("m")))

will generate results for A, B and C.

Usable as: Any Matcher

Definition at line 2349 of file ASTMatchers.h.

References eachOf, and forEachDescendant.

internal::PolymorphicMatcherWithParam1< internal::HasDeclarationMatcher, internal::Matcher<Decl>, void(internal::HasDeclarationSupportedTypes)> clang::ast_matchers::hasDeclaration ( const internal::Matcher< Decl > &  InnerMatcher)
inline

Matches a node if the declaration associated with that node matches the given matcher.

The associated declaration is:

  • for type nodes, the declaration of the underlying type
  • for CallExpr, the declaration of the callee
  • for MemberExpr, the declaration of the referenced member
  • for CXXConstructExpr, the declaration of the constructor

Also usable as Matcher<T> for any T supporting the getDecl() member function. e.g. various subtypes of clang::Type and various expressions.

Usable as: Matcher<CallExpr>, Matcher<CXXConstructExpr>, Matcher<DeclRefExpr>, Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>, Matcher<AddrLabelExpr>, Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>, Matcher<TagType>, Matcher<TemplateSpecializationType>, Matcher<TemplateTypeParmType>, Matcher<TypedefType>, Matcher<UnresolvedUsingType>

Definition at line 2420 of file ASTMatchers.h.

References InnerMatcher.

Referenced by AST_MATCHER_P_OVERLOAD(), AST_POLYMORPHIC_MATCHER_P2(), and AST_POLYMORPHIC_MATCHER_P_OVERLOAD().

internal::Matcher<BinaryOperator> clang::ast_matchers::hasEitherOperand ( const internal::Matcher< Expr > &  InnerMatcher)
inline

Matches if either the left hand side or the right hand side of a binary operator matches.

Definition at line 3646 of file ASTMatchers.h.

References anyOf.

internal::Matcher<NamedDecl> clang::ast_matchers::hasName ( const std::string &  Name)
inline

Matches NamedDecl nodes that have the specified name.

Supports specifying enclosing namespaces or classes by prefixing the name with '<enclosing>::'. Does not match typedefs of an underlying type with the given name.

Example matches X (Name == "X")

class X;

Example matches X (Name is one of "::a::b::X", "a::b::X", "b::X", "X")

namespace a { namespace b { class X; } }

Definition at line 2096 of file ASTMatchers.h.

References clang::ast_matchers::internal::Names().

Referenced by AST_MATCHER_P_OVERLOAD().

internal::PolymorphicMatcherWithParam1< internal::HasOverloadedOperatorNameMatcher, StringRef, AST_POLYMORPHIC_SUPPORTED_TYPES(CXXOperatorCallExpr, FunctionDecl)> clang::ast_matchers::hasOverloadedOperatorName ( StringRef  Name)
inline

Matches overloaded operator names.

Matches overloaded operator names specified in strings without the "operator" prefix: e.g. "<<".

Given:

class A { int operator*(); };
const A &operator<<(const A &a, const A &b);
A a;
a << a; // <-- This matches

cxxOperatorCallExpr(hasOverloadedOperatorName("<<"))) matches the specified line and cxxRecordDecl(hasMethod(hasOverloadedOperatorName("*"))) matches the declaration of A.

Usable as: Matcher<CXXOperatorCallExpr>, Matcher<FunctionDecl>

Definition at line 2161 of file ASTMatchers.h.

References AST_POLYMORPHIC_SUPPORTED_TYPES, and clang::Name.

template<typename T >
internal::Matcher<T> clang::ast_matchers::id ( StringRef  ID,
const internal::BindableMatcher< T > &  InnerMatcher 
)

If the provided matcher matches a node, binds the node to ID.

FIXME: Do we want to support this now that we have bind()?

Definition at line 115 of file ASTMatchers.h.

Referenced by buildByrefHelpers(), clang::Sema::CodeCompleteObjCSuperMessage(), clang::ASTContext::getAttributedType(), clang::MicrosoftVTableContext::getVFTableLayout(), and HandleExtVectorTypeAttr().

template<typename MatcherT , typename NodeT >
SmallVector< BoundNodes, 1 > clang::ast_matchers::match ( MatcherT  Matcher,
const NodeT &  Node,
ASTContext &  Context 
)

Returns the results of matching Matcher on Node.

Collects the BoundNodes of all callback invocations when matching Matcher on Node and returns the collected results.

Multiple results occur when using matchers like forEachDescendant, which generate a result for each sub-match.

See Also
selectFirst

Definition at line 292 of file ASTMatchFinder.h.

References clang::ast_type_traits::DynTypedNode::create().

Referenced by clang::Sema::ActOnAtEnd(), clang::Sema::ActOnCXXDelete(), AttributesMatch(), ClassImplementsAllMethodsAndProperties(), MatchTwoAttributeLists(), clang::ASTContext::ObjCQualifiedClassTypesAreCompatible(), clang::ASTContext::ObjCQualifiedIdTypesAreCompatible(), and clang::Sema::WarnExactTypedMethods().

template<typename MatcherT >
SmallVector< BoundNodes, 1 > clang::ast_matchers::match ( MatcherT  Matcher,
const ast_type_traits::DynTypedNode &  Node,
ASTContext &  Context 
)
template<typename MatcherT >
SmallVector< BoundNodes, 1 > clang::ast_matchers::match ( MatcherT  Matcher,
ASTContext &  Context 
)

Returns the results of matching Matcher on the translation unit of Context and collects the BoundNodes of all callback invocations.

Definition at line 298 of file ASTMatchFinder.h.

References clang::ast_matchers::MatchFinder::addMatcher(), Callback, Finder, clang::ast_matchers::MatchFinder::matchAST(), and clang::ast_matchers::internal::CollectMatchesCallback::Nodes.

template<typename NodeT >
const NodeT* clang::ast_matchers::selectFirst ( StringRef  BoundTo,
const SmallVectorImpl< BoundNodes > &  Results 
)

Returns the first result of type NodeT bound to BoundTo.

Returns NULL if there is no match, or if the matching node cannot be casted to NodeT.

This is useful in combanation with match():

const Decl *D = selectFirst<Decl>("id", match(Matcher.bind("id"),

Definition at line 261 of file ASTMatchFinder.h.

References Node.

internal::Matcher<Stmt> clang::ast_matchers::sizeOfExpr ( const internal::Matcher< UnaryExprOrTypeTraitExpr > &  InnerMatcher)
inline

Same as unaryExprOrTypeTraitExpr, but only matching sizeof.

Definition at line 2075 of file ASTMatchers.h.

References allOf, stmt, clang::UETT_SizeOf, and unaryExprOrTypeTraitExpr.

Variable Documentation

const internal::VariadicDynCastAllOfMatcher< Decl, AccessSpecDecl> clang::ast_matchers::accessSpecDecl

Matches C++ access specifier declarations.

Given

class C {
public:
int a;
};

accessSpecDecl() matches 'public:'

Definition at line 426 of file ASTMatchers.h.

Referenced by clang::ASTNodeImporter::VisitAccessSpecDecl().

const internal::VariadicDynCastAllOfMatcher<Stmt, AddrLabelExpr> clang::ast_matchers::addrLabelExpr

Matches address of label statements (GNU extension).

Given

FOO: bar();
void *ptr = &&FOO;
goto *bar;

addrLabelExpr() matches '&&FOO'

Definition at line 1545 of file ASTMatchers.h.

const internal::VariadicOperatorMatcherFunc<2, UINT_MAX> clang::ast_matchers::allOf
Initial value:
= {
internal::DynTypedMatcher::VO_AllOf
}

Matches if all given matchers match.

Usable as: Any Matcher

Definition at line 2021 of file ASTMatchers.h.

Referenced by alignOfExpr(), and sizeOfExpr().

const internal::VariadicOperatorMatcherFunc<2, UINT_MAX> clang::ast_matchers::anyOf
Initial value:
= {
internal::DynTypedMatcher::VO_AnyOf
}

Matches if any of the given matchers matches.

Usable as: Any Matcher

Definition at line 2014 of file ASTMatchers.h.

Referenced by AST_MATCHER_FUNCTION(), AST_MATCHER_P_OVERLOAD(), AST_POLYMORPHIC_MATCHER_P2(), and hasEitherOperand().

const internal::VariadicDynCastAllOfMatcher< Stmt, ArraySubscriptExpr> clang::ast_matchers::arraySubscriptExpr

Matches array subscript expressions.

Given

int i = a[1];

arraySubscriptExpr() matches "a[1]"

Definition at line 1328 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, AsmStmt> clang::ast_matchers::asmStmt

Matches asm statements.

int i = 100;
__asm("mov al, 2");

asmStmt() matches '__asm("mov al, 2")'

Definition at line 1639 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, AtomicExpr> clang::ast_matchers::atomicExpr

Matches atomic builtins.

Example matches __atomic_load_n(ptr, 1)

void foo() { int *ptr; __atomic_load_n(ptr, 1); }

Definition at line 1726 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, BinaryConditionalOperator> clang::ast_matchers::binaryConditionalOperator

Matches binary conditional operator expressions (GNU extension).

Example matches a ?: b

(a ?: b) + 42;

Definition at line 1774 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, BinaryOperator> clang::ast_matchers::binaryOperator

Matches binary operator expressions.

Example matches a || b

!(a || b)

Definition at line 1744 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, BreakStmt> clang::ast_matchers::breakStmt

Matches break statements.

Given

while (true) { break; }

breakStmt() matches 'break'

Definition at line 1491 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, CallExpr> clang::ast_matchers::callExpr

Matches call expressions.

Example matches x.y() and y()

X x;
x.y();
y();

Definition at line 1020 of file ASTMatchers.h.

Referenced by clang::Sema::ActOnPropertyImplDecl(), AST_MATCHER_P_OVERLOAD(), and AST_POLYMORPHIC_MATCHER_P2().

const internal::VariadicDynCastAllOfMatcher<Stmt, CaseStmt> clang::ast_matchers::caseStmt

Matches case statements inside switch statements.

Given

switch(a) { case 42: break; default: break; }

caseStmt() matches 'case 42: break;'.

Definition at line 1575 of file ASTMatchers.h.

Referenced by clang::Sema::ActOnCaseStmtBody().

const internal::VariadicDynCastAllOfMatcher<Stmt, CastExpr> clang::ast_matchers::castExpr

Matches any cast nodes of Clang's AST.

Example: castExpr() matches each of the following:

(int) 3;
const_cast<Expr *>(SubExpr);
char c = 0;

but does not match

int i = (0);
int k = 0;

Definition at line 1920 of file ASTMatchers.h.

Referenced by addFixitForObjCARCConversion(), clang::Sema::CheckObjCARCConversion(), clang::Sema::CheckObjCBridgeRelatedCast(), clang::Sema::CheckTollFreeBridgeCast(), clang::Sema::diagnoseARCUnbridgedCast(), and tryEmitARCCopyWeakInit().

const internal::VariadicDynCastAllOfMatcher< Stmt, CharacterLiteral> clang::ast_matchers::characterLiteral

Matches character literals (also matches wchar_t).

Not matching Hex-encoded chars (e.g. 0x1234, which is a IntegerLiteral), though.

Example matches 'a', L'a'

char ch = 'a';
wchar_t chw = L'a';

Definition at line 1674 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Decl, ClassTemplateDecl> clang::ast_matchers::classTemplateDecl

Matches C++ class template declarations.

Example matches Z

template<class T> class Z {};

Definition at line 375 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Decl, ClassTemplateSpecializationDecl> clang::ast_matchers::classTemplateSpecializationDecl

Matches C++ class template specializations.

Given

template<typename T> class A {};
template<> class A<double> {};
A<int> a;

classTemplateSpecializationDecl() matches the specializations A<int> and A<double>

Definition at line 389 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CompoundLiteralExpr> clang::ast_matchers::compoundLiteralExpr

Matches compound (i.e.

non-scalar) literals

Example match: {1}, (1, 2)

int array[4] = {1};
vector int myvec = (vector int)(1, 2);

Definition at line 1711 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, CompoundStmt> clang::ast_matchers::compoundStmt

Matches compound statements.

Example matches '{}' and '{{}}'in 'for (;;) {{}}'

for (;;) {{}}

Definition at line 1593 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, ConditionalOperator> clang::ast_matchers::conditionalOperator

Matches conditional operator expressions.

Example matches a ? b : c

(a ? b : c) + 42

Definition at line 1764 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, ContinueStmt> clang::ast_matchers::continueStmt

Matches continue statements.

Given

while (true) { continue; }

continueStmt() matches 'continue'

Definition at line 1501 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CStyleCastExpr> clang::ast_matchers::cStyleCastExpr

Matches a C-style cast expression.

Example: Matches (int*) 2.2f in

int i = (int) 2.2f;

Definition at line 1872 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CUDAKernelCallExpr> clang::ast_matchers::cudaKernelCallExpr

Matches CUDA kernel call expression.

Example matches,

kernel<<<i,j>>>();

Definition at line 5331 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXBindTemporaryExpr> clang::ast_matchers::cxxBindTemporaryExpr

Matches nodes where temporaries are created.

Example matches FunctionTakesString(GetStringByValue()) (matcher = cxxBindTemporaryExpr())

FunctionTakesString(GetStringByValue());
FunctionTakesStringByPointer(GetStringPointer());

Definition at line 1274 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXBoolLiteralExpr> clang::ast_matchers::cxxBoolLiteral

Matches bool literals.

Example matches true

true

Definition at line 1649 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, CXXCatchStmt> clang::ast_matchers::cxxCatchStmt

Matches catch statements.

try {} catch(int i) {}

cxxCatchStmt() matches 'catch(int i)'

Definition at line 1602 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXConstCastExpr> clang::ast_matchers::cxxConstCastExpr

Matches a const_cast expression.

Example: Matches const_cast<int*>(&r) in

int n = 42;
const int &r(n);
int* p = const_cast<int*>(&r);

Definition at line 1862 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXConstructExpr> clang::ast_matchers::cxxConstructExpr

Matches constructor call expressions (including implicit ones).

Example matches string(ptr, n) and ptr within arguments of f (matcher = cxxConstructExpr())

void f(const string &a, const string &b);
char *ptr;
int n;
f(string(ptr, n), ptr);

Definition at line 1238 of file ASTMatchers.h.

Referenced by AST_POLYMORPHIC_MATCHER_P2().

const internal::VariadicDynCastAllOfMatcher< Decl, CXXConstructorDecl> clang::ast_matchers::cxxConstructorDecl

Matches C++ constructor declarations.

Example matches Foo::Foo() and Foo::Foo(int)

class Foo {
public:
Foo();
Foo(int);
int DoSomething();
};

Definition at line 874 of file ASTMatchers.h.

Referenced by AST_POLYMORPHIC_MATCHER_P2().

const internal::VariadicDynCastAllOfMatcher<Decl, CXXConversionDecl> clang::ast_matchers::cxxConversionDecl

Matches conversion operator declarations.

Example matches the operator.

class X { operator int() const; };

Definition at line 926 of file ASTMatchers.h.

const internal::VariadicAllOfMatcher<CXXCtorInitializer> clang::ast_matchers::cxxCtorInitializer

Matches constructor initializers.

Examples matches i(42).

class C {
C() : i(42) {}
int i;
};

Definition at line 437 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXDefaultArgExpr> clang::ast_matchers::cxxDefaultArgExpr

Matches the value of a default argument at the call site.

Example matches the CXXDefaultArgExpr placeholder inserted for the default value of the second parameter in the call expression f(42) (matcher = cxxDefaultArgExpr())

void f(int x, int y = 0);
f(42);

Definition at line 1341 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, CXXDeleteExpr> clang::ast_matchers::cxxDeleteExpr

Matches delete expressions.

Given

delete X;

cxxDeleteExpr() matches 'delete X'.

Definition at line 1316 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Decl, CXXDestructorDecl> clang::ast_matchers::cxxDestructorDecl

Matches explicit C++ destructor declarations.

Example matches Foo::~Foo()

class Foo {
public:
virtual ~Foo();
};

Definition at line 887 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXDynamicCastExpr> clang::ast_matchers::cxxDynamicCastExpr

Matches a dynamic_cast expression.

Example: cxxDynamicCastExpr() matches dynamic_cast<D*>(&b); in

struct B { virtual ~B() {} }; struct D : B {};
B b;
D* p = dynamic_cast<D*>(&b);

Definition at line 1850 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXForRangeStmt> clang::ast_matchers::cxxForRangeStmt

Matches range-based for statements.

cxxForRangeStmt() matches 'for (auto a : i)'

int i[] = {1, 2, 3}; for (auto a : i);
for(int j = 0; j < 5; ++j);

Definition at line 1433 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXFunctionalCastExpr> clang::ast_matchers::cxxFunctionalCastExpr

Matches functional cast expressions.

Example: Matches Foo(bar);

Foo f = bar;
Foo g = (Foo) bar;
Foo h = Foo(bar);

Definition at line 1932 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXMemberCallExpr> clang::ast_matchers::cxxMemberCallExpr

Matches member call expressions.

Example matches x.y()

X x;
x.y();

Definition at line 1039 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, CXXMethodDecl> clang::ast_matchers::cxxMethodDecl

Matches method declarations.

Example matches y

class X { void y(); };

Definition at line 917 of file ASTMatchers.h.

Referenced by AST_POLYMORPHIC_MATCHER_P2().

const internal::VariadicDynCastAllOfMatcher<Stmt, CXXNewExpr> clang::ast_matchers::cxxNewExpr

Matches new expressions.

Given

new X;

cxxNewExpr() matches 'new X'.

Definition at line 1306 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXNullPtrLiteralExpr> clang::ast_matchers::cxxNullPtrLiteralExpr

Matches nullptr literal.

Definition at line 1716 of file ASTMatchers.h.

Referenced by AST_MATCHER_FUNCTION().

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXOperatorCallExpr> clang::ast_matchers::cxxOperatorCallExpr

Matches overloaded operator calls.

Note that if an operator isn't overloaded, it won't match. Instead, use binaryOperator matcher. Currently it does not match operators such as new delete. FIXME: figure out why these do not match?

Example matches both operator<<((o << b), c) and operator<<(o, b) (matcher = cxxOperatorCallExpr())

ostream &operator<< (ostream &out, int i) { };
ostream &o; int b = 1, c = 1;
o << b << c;

Definition at line 1359 of file ASTMatchers.h.

Referenced by AST_POLYMORPHIC_MATCHER_P2().

const internal::VariadicDynCastAllOfMatcher< Decl, CXXRecordDecl> clang::ast_matchers::cxxRecordDecl

Matches C++ class declarations.

Example matches X, Z

class X;
template<class T> class Z {};

Definition at line 365 of file ASTMatchers.h.

Referenced by AST_MATCHER_FUNCTION().

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXReinterpretCastExpr> clang::ast_matchers::cxxReinterpretCastExpr

Matches a reinterpret_cast expression.

Either the source expression or the destination type can be matched using has(), but hasDestinationType() is more specific and can be more readable.

Example matches reinterpret_cast<char*>(&p) in

void* p = reinterpret_cast<char*>(&p);

Definition at line 1817 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXStaticCastExpr> clang::ast_matchers::cxxStaticCastExpr

Matches a C++ static_cast expression.

See Also
hasDestinationType
reinterpretCast

Example: cxxStaticCastExpr() matches static_cast<long>(8) in

long eight(static_cast<long>(8));

Definition at line 1834 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXTemporaryObjectExpr> clang::ast_matchers::cxxTemporaryObjectExpr

Matches functional cast expressions having N != 1 arguments.

Example: Matches Foo(bar, bar)

Foo h = Foo(bar, bar);

Definition at line 1942 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, CXXThisExpr> clang::ast_matchers::cxxThisExpr

Matches implicit and explicit this expressions.

Example matches the implicit this expression in "return i". (matcher = cxxThisExpr())

struct foo {
int i;
int f() { return i; }
};

Definition at line 1262 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, CXXThrowExpr> clang::ast_matchers::cxxThrowExpr

Matches throw expressions.

try { throw 5; } catch(int i) {}

cxxThrowExpr() matches 'throw 5'

Definition at line 1620 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, CXXTryStmt> clang::ast_matchers::cxxTryStmt

Matches try statements.

try {} catch(int i) {}

cxxTryStmt() matches 'try {}'

Definition at line 1611 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, CXXUnresolvedConstructExpr> clang::ast_matchers::cxxUnresolvedConstructExpr

Matches unresolved constructor call expressions.

Example matches T(t) in return statement of f (matcher = cxxUnresolvedConstructExpr())

template <typename T>
void f(const T& t) { return T(t); }

Definition at line 1250 of file ASTMatchers.h.

const internal::VariadicAllOfMatcher<Decl> clang::ast_matchers::decl
const internal::VariadicDynCastAllOfMatcher<Decl, DeclaratorDecl> clang::ast_matchers::declaratorDecl

Matches declarator declarations (field, variable, function and non-type template parameter declarations).

Given

class X { int y; };

declaratorDecl() matches int y.

Definition at line 401 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, DeclRefExpr> clang::ast_matchers::declRefExpr

Matches expressions that refer to declarations.

Example matches x in if (x)

bool x;
if (x) {}

Definition at line 1376 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, DeclStmt> clang::ast_matchers::declStmt

Matches declaration statements.

Given

int a;

declStmt() matches 'int a'.

Definition at line 997 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, DefaultStmt> clang::ast_matchers::defaultStmt

Matches default statements inside switch statements.

Given

switch(a) { case 42: break; default: break; }

defaultStmt() matches 'default: break;'.

Definition at line 1585 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, DesignatedInitExpr> clang::ast_matchers::designatedInitExpr

Matches C99 designated initializer expressions [C99 6.7.8].

Example: Matches { [2].y = 1.0, [0].x = 1.0 }

point ptarray[10] = { [2].y = 1.0, [0].x = 1.0 };

Definition at line 1962 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, DoStmt> clang::ast_matchers::doStmt

Matches do statements.

Given

do {} while (true);

doStmt() matches 'do {} while(true)'

Definition at line 1481 of file ASTMatchers.h.

const internal::VariadicOperatorMatcherFunc<2, UINT_MAX> clang::ast_matchers::eachOf
Initial value:
= {
internal::DynTypedMatcher::VO_EachOf
}

Matches if any of the given matchers matches.

Unlike anyOf, eachOf will generate a match result for each matching submatcher.

For example, in:

class A { int a; int b; };

The matcher:

has(fieldDecl(hasName("b")).bind("v"))))

will generate two results binding "v", the first of which binds the field declaration of a, the second the field declaration of b.

Usable as: Any Matcher

Definition at line 2007 of file ASTMatchers.h.

Referenced by findAll().

const internal::VariadicDynCastAllOfMatcher< Decl, EnumConstantDecl> clang::ast_matchers::enumConstantDecl

Matches enum constants.

Example matches A, B, C

enum X {
A, B, C
};

Definition at line 909 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, EnumDecl> clang::ast_matchers::enumDecl

Matches enum declarations.

Example matches X

enum X {
A, B, C
};

Definition at line 897 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, ExplicitCastExpr> clang::ast_matchers::explicitCastExpr

Matches explicit cast expressions.

Matches any cast expression written in user code, whether it be a C-style cast, a functional-style cast, or a keyword cast.

Does not match implicit conversions.

Note: the name "explicitCast" is chosen to match Clang's terminology, as Clang uses the term "cast" to apply to implicit conversions as well as to actual cast expressions.

See Also
hasDestinationType.

Example: matches all five of the casts in

int((int)(reinterpret_cast<int>(static_cast<int>(const_cast<int>(42)))))

but does not match the implicit conversion in

long ell = 42;

Definition at line 1897 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, Expr> clang::ast_matchers::expr
const internal::VariadicDynCastAllOfMatcher< Stmt, ExprWithCleanups> clang::ast_matchers::exprWithCleanups

Matches expressions that introduce cleanups to be run at the end of the sub-expression's evaluation.

Example matches std::string()

const std::string str = std::string();

Definition at line 1074 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, FieldDecl> clang::ast_matchers::fieldDecl

Matches field declarations.

Given

class X { int m; };

fieldDecl() matches 'm'.

Definition at line 947 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, FloatingLiteral> clang::ast_matchers::floatLiteral

Matches float literals of all sizes / encodings, e.g.

1.0, 1.0f, 1.0L and 1e10.

Does not match implicit conversions such as

float a = 10;

Definition at line 1693 of file ASTMatchers.h.

const internal::ArgumentAdaptingMatcherFunc<internal::ForEachMatcher> LLVM_ATTRIBUTE_UNUSED clang::ast_matchers::forEach = {}

Matches AST nodes that have child AST nodes that match the provided matcher.

Example matches X, Y (matcher = cxxRecordDecl(forEach(cxxRecordDecl(hasName("X")))

class X {}; // Matches X, because X::X is a class of name X inside X.
class Y { class X {}; };
class Z { class Y { class X {}; }; }; // Does not match Z.

ChildT must be an AST base type.

As opposed to 'has', 'forEach' will cause a match for each result that matches instead of only on the first one.

Usable as: Any Matcher

Definition at line 2301 of file ASTMatchers.h.

const internal::ArgumentAdaptingMatcherFunc<internal::ForEachDescendantMatcher> LLVM_ATTRIBUTE_UNUSED clang::ast_matchers::forEachDescendant = {}

Matches AST nodes that have descendant AST nodes that match the provided matcher.

Example matches X, A, B, C (matcher = cxxRecordDecl(forEachDescendant(cxxRecordDecl(hasName("X")))))

class X {}; // Matches X, because X::X is a class of name X inside X.
class A { class X {}; };
class B { class C { class X {}; }; };

DescendantT must be an AST base type.

As opposed to 'hasDescendant', 'forEachDescendant' will cause a match for each result that matches instead of only on the first one.

Note: Recursively combined ForEachDescendant can cause many matches: cxxRecordDecl(forEachDescendant(cxxRecordDecl( forEachDescendant(cxxRecordDecl()) ))) will match 10 times (plus injected class name matches) on:

class A { class B { class C { class D { class E {}; }; }; }; };

Usable as: Any Matcher

Definition at line 2330 of file ASTMatchers.h.

Referenced by findAll().

const internal::VariadicDynCastAllOfMatcher<Stmt, ForStmt> clang::ast_matchers::forStmt

Matches for statements.

Example matches 'for (;;) {}'

for (;;) {}
int i[] = {1, 2, 3}; for (auto a : i);

Definition at line 1393 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, FriendDecl> clang::ast_matchers::friendDecl

Matches friend declarations.

Given

class X { friend void foo(); };

friendDecl() matches 'friend void foo()'.

Definition at line 975 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, FunctionDecl> clang::ast_matchers::functionDecl

Matches function declarations.

Example matches f

void f();

Definition at line 955 of file ASTMatchers.h.

Referenced by AST_MATCHER_FUNCTION(), and AST_POLYMORPHIC_MATCHER_P2().

const internal::VariadicDynCastAllOfMatcher< Decl, FunctionTemplateDecl> clang::ast_matchers::functionTemplateDecl

Matches C++ function template declarations.

Example matches f

template<class T> void f(T t) {}

Definition at line 965 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, GNUNullExpr> clang::ast_matchers::gnuNullExpr

Matches GNU __null expression.

Definition at line 1719 of file ASTMatchers.h.

Referenced by AST_MATCHER_FUNCTION().

const internal::VariadicDynCastAllOfMatcher<Stmt, GotoStmt> clang::ast_matchers::gotoStmt

Matches goto statements.

Given

goto FOO;
FOO: bar();

gotoStmt() matches 'goto FOO'

Definition at line 1522 of file ASTMatchers.h.

const internal::ArgumentAdaptingMatcherFunc<internal::HasMatcher> LLVM_ATTRIBUTE_UNUSED clang::ast_matchers::has = {}

Matches AST nodes that have child AST nodes that match the provided matcher.

Example matches X, Y (matcher = cxxRecordDecl(has(cxxRecordDecl(hasName("X")))

class X {}; // Matches X, because X::X is a class of name X inside X.
class Y { class X {}; };
class Z { class Y { class X {}; }; }; // Does not match Z.

ChildT must be an AST base type.

Usable as: Any Matcher Note that has is direct matcher, so it also matches things like implicit casts and paren casts. If you are matching with expr then you should probably consider using ignoringParenImpCasts like: has(ignoringParenImpCasts(expr())).

Definition at line 2264 of file ASTMatchers.h.

Referenced by getLiteralInfo().

const internal::ArgumentAdaptingMatcherFunc< internal::HasAncestorMatcher, internal::TypeList<Decl, NestedNameSpecifierLoc, Stmt, TypeLoc>, internal::TypeList<Decl, NestedNameSpecifierLoc, Stmt, TypeLoc> > LLVM_ATTRIBUTE_UNUSED clang::ast_matchers::hasAncestor = {}

Matches AST nodes that have an ancestor that matches the provided matcher.

Given

void f() { if (true) { int x = 42; } }
void g() { for (;;) { int x = 43; } }

expr(integerLiteral(hasAncestor(ifStmt()))) matches 42, but not 43.

Usable as: Any Matcher

Definition at line 2384 of file ASTMatchers.h.

Referenced by AST_MATCHER_FUNCTION().

const internal::VariadicFunction<internal::Matcher<NamedDecl>, StringRef, internal::hasAnyNameFunc> clang::ast_matchers::hasAnyName = {}

Matches NamedDecl nodes that have any of the specified names.

This matcher is only provided as a performance optimization of hasName.

hasAnyName(a, b, c)

is equivalent to, but faster than

Definition at line 2114 of file ASTMatchers.h.

const internal::ArgumentAdaptingMatcherFunc<internal::HasDescendantMatcher> LLVM_ATTRIBUTE_UNUSED clang::ast_matchers::hasDescendant = {}

Matches AST nodes that have descendant AST nodes that match the provided matcher.

Example matches X, Y, Z (matcher = cxxRecordDecl(hasDescendant(cxxRecordDecl(hasName("X")))))

class X {}; // Matches X, because X::X is a class of name X inside X.
class Y { class X {}; };
class Z { class Y { class X {}; }; };

DescendantT must be an AST base type.

Usable as: Any Matcher

Definition at line 2281 of file ASTMatchers.h.

const internal::ArgumentAdaptingMatcherFunc< internal::HasParentMatcher, internal::TypeList<Decl, NestedNameSpecifierLoc, Stmt, TypeLoc>, internal::TypeList<Decl, NestedNameSpecifierLoc, Stmt, TypeLoc> > LLVM_ATTRIBUTE_UNUSED clang::ast_matchers::hasParent = {}

Matches AST nodes that have a parent that matches the provided matcher.

Given

void f() { for (;;) { int x = 42; if (true) { int x = 43; } } }

compoundStmt(hasParent(ifStmt())) matches "{ int x = 43; }".

Usable as: Any Matcher

Definition at line 2367 of file ASTMatchers.h.

Referenced by AST_MATCHER_FUNCTION().

const internal::VariadicDynCastAllOfMatcher<Stmt, IfStmt> clang::ast_matchers::ifStmt

Matches if statements.

Example matches 'if (x) {}'

if (x) {}

Definition at line 1384 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, ImplicitCastExpr> clang::ast_matchers::implicitCastExpr

Matches the implicit cast nodes of Clang's AST.

This matches many different places, including function call return value eliding, as well as any type conversions.

Definition at line 1905 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, ImplicitValueInitExpr> clang::ast_matchers::implicitValueInitExpr

Matches implicit initializers of init list expressions.

Given

point ptarray[10] = { [2].y = 1.0, [2].x = 2.0, [0].x = 1.0 };

implicitValueInitExpr() matches "[0].y" (implicitly)

Definition at line 1106 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, InitListExpr> clang::ast_matchers::initListExpr

Matches init list expressions.

Given

int a[] = { 1, 2 };
struct B { int x, y; };
B b = { 5, 6 };

initListExpr() matches "{ 1, 2 }" and "{ 5, 6 }"

Definition at line 1086 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, IntegerLiteral> clang::ast_matchers::integerLiteral

Matches integer literals of all sizes / encodings, e.g.

1, 1L, 0x1 and 1U.

Does not match character-encoded integers such as L'a'.

Definition at line 1682 of file ASTMatchers.h.

Referenced by AST_MATCHER_FUNCTION().

const internal::VariadicDynCastAllOfMatcher<Decl, LabelDecl> clang::ast_matchers::labelDecl

Matches a declaration of label.

Given

goto FOO;
FOO: bar();

labelDecl() matches 'FOO:'

Definition at line 318 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, LabelStmt> clang::ast_matchers::labelStmt

Matches label statements.

Given

goto FOO;
FOO: bar();

labelStmt() matches 'FOO:'

Definition at line 1533 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, LambdaExpr> clang::ast_matchers::lambdaExpr

Matches lambda expressions.

Example matches [&](){return 5;}

[&](){return 5;}

Definition at line 1028 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, LinkageSpecDecl> clang::ast_matchers::linkageSpecDecl

Matches a declaration of a linkage specification.

Given

extern "C" {}

linkageSpecDecl() matches "extern "C" {}"

Definition at line 294 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, MaterializeTemporaryExpr> clang::ast_matchers::materializeTemporaryExpr

Matches nodes where temporaries are materialized.

Example: Given

struct T {void func()};
T f();
void g(T);

materializeTemporaryExpr() matches 'f()' in these statements

T u(f());
g(f());

but does not match

f();
f().func();

Definition at line 1296 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, MemberExpr> clang::ast_matchers::memberExpr

Matches member expressions.

Given

class Y {
void x() { this->x(); x(); Y y; y.x(); a; this->b; Y::b; }
int a; static int b;
};

memberExpr() matches this->x, x, y.x, a, this->b

Definition at line 1010 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, NamedDecl> clang::ast_matchers::namedDecl

Matches a declaration of anything that could have a name.

Example matches X, S, the anonymous union type, i, and U;

typedef int X;
struct S {
union {
int i;
} U;
};

Definition at line 307 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, NamespaceAliasDecl> clang::ast_matchers::namespaceAliasDecl

Matches a declaration of a namespace alias.

Given

namespace test {}
namespace alias = ::test;

namespaceAliasDecl() matches "namespace alias" but not "namespace test"

Definition at line 341 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, NamespaceDecl> clang::ast_matchers::namespaceDecl

Matches a declaration of a namespace.

Given

namespace {}
namespace test {}

namespaceDecl() matches "namespace {}" and "namespace test {}"

Definition at line 329 of file ASTMatchers.h.

const internal::VariadicAllOfMatcher<NestedNameSpecifier> clang::ast_matchers::nestedNameSpecifier

Matches nested name specifiers.

Given

namespace ns {
struct A { static void f(); };
void A::f() {}
void g() { A::f(); }
}
ns::A a;

nestedNameSpecifier() matches "ns::" and both "A::"

Definition at line 4965 of file ASTMatchers.h.

const internal::VariadicAllOfMatcher< NestedNameSpecifierLoc> clang::ast_matchers::nestedNameSpecifierLoc

Same as nestedNameSpecifier but matches NestedNameSpecifierLoc.

Definition at line 4969 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Decl, NonTypeTemplateParmDecl> clang::ast_matchers::nonTypeTemplateParmDecl

Matches non-type template parameter declarations.

Given

template <typename T, int N> struct C {};

nonTypeTemplateParmDecl() matches 'N', but not 'T'.

Definition at line 460 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, NullStmt> clang::ast_matchers::nullStmt

Matches null statements.

foo();;

nullStmt() matches the second ';'

Definition at line 1629 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Decl, ObjCInterfaceDecl> clang::ast_matchers::objcInterfaceDecl

Matches Objective-C interface declarations.

Example matches Foo

@interface Foo
@end

Definition at line 1063 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, ObjCMessageExpr> clang::ast_matchers::objcMessageExpr

Matches ObjectiveC Message invocation expressions.

The innermost message send invokes the "alloc" class method on the NSString class, while the outermost message send invokes the "initWithString" instance method on the object returned from NSString's "alloc". This matcher should match both message sends.

[[NSString alloc] initWithString:@"Hello"]

Definition at line 1052 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, OpaqueValueExpr> clang::ast_matchers::opaqueValueExpr

Matches opaque value expressions.

They are used as helpers to reference another expressions and can be met in BinaryConditionalOperators, for example.

Example matches 'a'

(a ?: c) + 42;

Definition at line 1786 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, ParenExpr> clang::ast_matchers::parenExpr

Matches parentheses used in expressions.

Example matches (foo() + 1)

int foo() { return 1; }
int a = (foo() + 1);

Definition at line 1224 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, ParenListExpr> clang::ast_matchers::parenListExpr

Matches paren list expressions.

ParenListExprs don't have a predefined type and are used for late parsing. In the final AST, they can be met in template declarations.

Given

template<typename T> class X {
void f() {
X x(*this);
int a = 0, b = 1; int i = (a, b);
}
};

parenListExpr() matches "*this" but NOT matches (a, b) because (a, b) has a predefined type and is a ParenExpr, not a ParenListExpr.

Definition at line 1123 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, ParmVarDecl> clang::ast_matchers::parmVarDecl

Matches parameter variable declarations.

Given

void f(int x);

parmVarDecl() matches int x.

Definition at line 411 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, PredefinedExpr> clang::ast_matchers::predefinedExpr

Matches predefined identifier expressions [C99 6.4.2.2].

Example: Matches func

printf("%s", __func__);

Definition at line 1952 of file ASTMatchers.h.

const internal::VariadicAllOfMatcher<QualType> clang::ast_matchers::qualType

Matches QualTypes in the clang AST.

Definition at line 1980 of file ASTMatchers.h.

Referenced by AST_MATCHER_P_OVERLOAD(), and AST_POLYMORPHIC_MATCHER_P_OVERLOAD().

const internal::VariadicDynCastAllOfMatcher< Decl, RecordDecl> clang::ast_matchers::recordDecl

Matches class, struct, and union declarations.

Example matches X, Z, U, and S

class X;
template<class T> class Z {};
struct S {};
union U {};

Definition at line 354 of file ASTMatchers.h.

Referenced by classifyPointerDeclarator().

const internal::VariadicDynCastAllOfMatcher<Stmt, ReturnStmt> clang::ast_matchers::returnStmt

Matches return statements.

Given

return 1;

returnStmt() matches 'return 1'

Definition at line 1511 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Decl, StaticAssertDecl> clang::ast_matchers::staticAssertDecl

Matches a C++ static_assert declaration.

Example: staticAssertExpr() matches static_assert(sizeof(S) == sizeof(int)) in

struct S {
int x;
};
static_assert(sizeof(S) == sizeof(int));

Definition at line 1803 of file ASTMatchers.h.

const internal::VariadicAllOfMatcher<Stmt> clang::ast_matchers::stmt

Matches statements.

Given

{ ++a; }

stmt() matches both the compound statement '{ ++a; }' and '++a'.

Definition at line 985 of file ASTMatchers.h.

Referenced by alignOfExpr(), AST_MATCHER_FUNCTION(), GenerateExtensivePathDiagnostic(), clang::AnalysisDeclContext::registerForcedBlockExpression(), sizeOfExpr(), and clang::CFG::VisitBlockStmts().

const internal::VariadicDynCastAllOfMatcher<Stmt, StmtExpr> clang::ast_matchers::stmtExpr

Matches statement expression (GNU extension).

Example match: ({ int X = 4; X; })

int C = ({ int X = 4; X; });

Definition at line 1734 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, StringLiteral> clang::ast_matchers::stringLiteral

Matches string literals (also matches wide string literals).

Example matches "abcd", L"abcd"

char *s = "abcd";
wchar_t *ws = L"abcd";

Definition at line 1660 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, SubstNonTypeTemplateParmExpr> clang::ast_matchers::substNonTypeTemplateParmExpr

Matches substitutions of non-type template parameters.

Given

template <int N>
struct A { static const int n = N; };
struct B : public A<42> {};

substNonTypeTemplateParmExpr() matches "N" in the right-hand side of "static const int n = N;"

Definition at line 1137 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, SwitchCase> clang::ast_matchers::switchCase

Matches case and default statements inside switch statements.

Given

switch(a) { case 42: break; default: break; }

switchCase() matches 'case 42: break;' and 'default: break;'.

Definition at line 1565 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Stmt, SwitchStmt> clang::ast_matchers::switchStmt

Matches switch statements.

Given

switch(a) { case 42: break; default: break; }

switchStmt() matches 'switch(a)'.

Definition at line 1555 of file ASTMatchers.h.

const internal::VariadicAllOfMatcher<TemplateArgument> clang::ast_matchers::templateArgument

Matches template arguments.

Given

template <typename T> struct C {};
C<int> c;

templateArgument() matches 'int' in C<int>.

Definition at line 448 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Decl, TemplateTypeParmDecl> clang::ast_matchers::templateTypeParmDecl

Matches template type parameter declarations.

Given

template <typename T, int N> struct C {};

templateTypeParmDecl() matches 'T', but not 'N'.

Definition at line 472 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, TranslationUnitDecl> clang::ast_matchers::translationUnitDecl

Matches the top declaration context.

Given

int X;
namespace NS {
int Y;
} // namespace NS

decl(hasDeclContext(translationUnitDecl())) matches "int X", but not "int Y".

Definition at line 159 of file ASTMatchers.h.

const internal::VariadicAllOfMatcher<Type> clang::ast_matchers::type

Matches Types in the clang AST.

Definition at line 1983 of file ASTMatchers.h.

Referenced by clang::Sema::ActOnForEachDeclStmt(), clang::Sema::ActOnObjCAtSynchronizedOperand(), clang::Sema::actOnObjCTypeArgsOrProtocolQualifiers(), clang::Sema::AddParameterABIAttr(), clang::InitializationSequence::AddPassByIndirectCopyRestoreStep(), clang::Sema::AddPushedVisibilityAttribute(), applyObjCTypeArgs(), breakDownVectorType(), clang::Sema::BuildDeclarationNameExpr(), clang::Sema::BuildMemberReferenceExpr(), clang::Sema::BuildObjCBoxedExpr(), clang::arcmt::trans::canApplyWeak(), clang::Sema::CheckCompleteVariableDeclaration(), CheckNonNullArguments(), clang::Sema::checkNullabilityTypeSpecifier(), clang::Sema::checkObjCKindOfType(), clang::Sema::CodeCompleteCase(), clang::PseudoObjectExpr::Create(), diagnoseBadTypeAttribute(), clang::Sema::DiagnoseSentinelCalls(), distributeFunctionTypeAttr(), distributeObjCPointerTypeAttr(), clang::CodeGen::CodeGenFunction::EmitARCStoreStrong(), emitAutoreleasedReturnValueMarker(), clang::CodeGen::CodeGenFunction::EmitAutoVarInit(), clang::CodeGen::CodeGenFunction::emitAutoVarTypeCleanup(), clang::CodeGen::CodeGenFunction::EmitBlockLiteral(), clang::CodeGen::CodeGenFunction::EmitCallArg(), clang::CodeGen::CodeGenFunction::EmitCXXAggrConstructorCall(), emitCXXDestructMethod(), EmitCXXNewAllocSize(), clang::CodeGen::CGDebugInfo::EmitDeclareOfBlockLiteralArgVariable(), EmitDeclDestroy(), EmitDeclInit(), clang::CodeGen::CodeGenFunction::EmitDelegateCallArg(), clang::CodeGen::CodeGenFunction::EmitExprAsInit(), clang::CodeGen::CodeGenFunction::EmitExtVectorElementExpr(), clang::CodeGen::CodeGenFunction::EmitLValueForField(), clang::CodeGen::CodeGenFunction::EnterDtorCleanups(), clang::Expr::findBoundMemberType(), clang::Sema::FixOverloadedFunctionReference(), clang::CodeGen::CodeGenFunction::GenerateCopyHelperFunction(), clang::CodeGen::CodeGenFunction::GenerateDestroyHelperFunction(), clang::ASTContext::getAttributedType(), clang::Type::getBaseElementTypeUnsafe(), getBaseMessageSendResultType(), clang::CodeGen::swiftcall::SwiftAggLowering::getCoerceAndExpandTypes(), getComplexType(), clang::CodeGen::CodeGenFunction::getEvaluationKind(), getLVForTemplateParameterList(), clang::CodeGen::CodeGenModule::getMemberPointerConstant(), clang::Type::getNullability(), getNullForVariable(), clang::ASTContext::getObjCObjectType(), clang::Type::getPointeeOrArrayElementType(), clang::ASTContext::getVariableArrayDecayedType(), handleBlocksAttr(), handleFunctionTypeAttr(), handleObjCGCTypeAttr(), handleObjCOwnershipTypeAttr(), handleObjCPreciseLifetimeAttr(), handleVisibilityAttr(), clang::ASTNodeImporter::ImportArray(), clang::ASTNodeImporter::ImportArrayChecked(), inferARCLifetimeForPointee(), clang::Sema::inferObjCARCLifetime(), isPlaceholderToRemoveAsArg(), mergeTypeNullabilityForRedecl(), occupiesMoreThan(), clang::operator&(), clang::operator<<(), clang::operator|(), clang::operator~(), clang::Sema::PrepareCastToObjCObjectPointer(), clang::CodeGen::CodeGenFunction::pushDestroy(), clang::CodeGen::CodeGenFunction::pushLifetimeExtendedDestroy(), clang::Sema::RequireCompleteDeclContext(), clang::QualType::stripObjCKindOfType(), clang::QualType::substObjCTypeArgs(), tryCaptureAsConstant(), and tryEmitARCRetainLoadOfScalar().

const internal::VariadicDynCastAllOfMatcher<Decl, TypeAliasDecl> clang::ast_matchers::typeAliasDecl

Matches type alias declarations.

Given

typedef int X;
using Y = int;

typeAliasDecl() matches "using Y = int", but not "typedef int X"

Definition at line 193 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, TypedefDecl> clang::ast_matchers::typedefDecl

Matches typedef declarations.

Given

typedef int X;
using Y = int;

typedefDecl() matches "typedef int X", but not "using Y = int"

Definition at line 170 of file ASTMatchers.h.

Referenced by clang::Sema::checkNullabilityTypeSpecifier().

const internal::VariadicDynCastAllOfMatcher<Decl, TypedefNameDecl> clang::ast_matchers::typedefNameDecl

Matches typedef name declarations.

Given

typedef int X;
using Y = int;

typedefNameDecl() matches "typedef int X" and "using Y = int"

Definition at line 182 of file ASTMatchers.h.

const internal::VariadicAllOfMatcher<TypeLoc> clang::ast_matchers::typeLoc

Matches TypeLocs in the clang AST.

Definition at line 1986 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, UnaryExprOrTypeTraitExpr> clang::ast_matchers::unaryExprOrTypeTraitExpr

Matches sizeof (C99), alignof (C++11) and vec_step (OpenCL)

Given

Foo x = bar;
int y = sizeof(x) + alignof(x);

unaryExprOrTypeTraitExpr() matches sizeof(x) and alignof(x)

Definition at line 2036 of file ASTMatchers.h.

Referenced by alignOfExpr(), and sizeOfExpr().

const internal::VariadicDynCastAllOfMatcher< Stmt, UnaryOperator> clang::ast_matchers::unaryOperator

Matches unary operator expressions.

Example matches !a

!a || b

Definition at line 1754 of file ASTMatchers.h.

const internal::VariadicOperatorMatcherFunc<1, 1> clang::ast_matchers::unless
Initial value:
= {
internal::DynTypedMatcher::VO_UnaryNot
}

Matches if the provided matcher does not match.

Example matches Y (matcher = cxxRecordDecl(unless(hasName("X"))))

class X {};
class Y {};

Usable as: Any Matcher

Definition at line 2395 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, UnresolvedLookupExpr> clang::ast_matchers::unresolvedLookupExpr

Matches reference to a name that can be looked up during parsing but could not be resolved to a specific declaration.

Given

template<typename T>
T foo() { T a; return a; }
template<typename T>
void bar() {
foo<T>();
}

unresolvedLookupExpr() matches

foo<T>()

Definition at line 1179 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Decl, UnresolvedUsingTypenameDecl> clang::ast_matchers::unresolvedUsingTypenameDecl

Matches unresolved using value declarations that involve the typename.

Given

template <typename T>
struct Base { typedef T Foo; };
template<typename T>
struct S : private Base<T> {
using typename Base<T>::Foo;
};

unresolvedUsingTypenameDecl() matches

Definition at line 1213 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Decl, UnresolvedUsingValueDecl> clang::ast_matchers::unresolvedUsingValueDecl

Matches unresolved using value declarations.

Given

template<typename X>
class C : private X {
using X::x;
};

unresolvedUsingValueDecl() matches

using X::x

Definition at line 1194 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Stmt, UserDefinedLiteral> clang::ast_matchers::userDefinedLiteral

Matches user defined literal operator call.

Example match: "foo"_suffix

Definition at line 1700 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, UsingDecl> clang::ast_matchers::usingDecl

Matches using declarations.

Given

namespace X { int x; }
using X::x;

usingDecl() matches

using X::x

Definition at line 1148 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher< Decl, UsingDirectiveDecl> clang::ast_matchers::usingDirectiveDecl

Matches using namespace declarations.

Given

namespace X { int x; }
using namespace X;

usingDirectiveDecl() matches

using namespace X

Definition at line 1161 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, ValueDecl> clang::ast_matchers::valueDecl

Matches any value declaration.

Example matches A, B, C and F

enum X { A, B, C };
void F();

Definition at line 859 of file ASTMatchers.h.

const internal::VariadicDynCastAllOfMatcher<Decl, VarDecl> clang::ast_matchers::varDecl

Matches variable declarations.

Note: this does not match declarations of member variables, which are "field" declarations in Clang parlance.

Example matches a

int a;

Definition at line 937 of file ASTMatchers.h.

Referenced by clang::ento::ExprEngine::ProcessAutomaticObjDtor().

const internal::VariadicDynCastAllOfMatcher<Stmt, WhileStmt> clang::ast_matchers::whileStmt

Matches while statements.

Given

while (true) {}

whileStmt() matches 'while (true) {}'.

Definition at line 1471 of file ASTMatchers.h.