diff --git a/clang/docs/LibASTMatchersReference.html b/clang/docs/LibASTMatchersReference.html index 73309fb081f9..9999565f7f26 100644 --- a/clang/docs/LibASTMatchersReference.html +++ b/clang/docs/LibASTMatchersReference.html @@ -1,9448 +1,9448 @@ AST Matcher Reference

AST Matcher Reference

This document shows all currently implemented matchers. The matchers are grouped by category and node type they match. You can click on matcher names to show the matcher's source documentation.

There are three different basic categories of matchers:

Within each category the matchers are ordered by node type they match on. Note that if a matcher can match multiple node types, it will appear multiple times. This means that by searching for Matcher<Stmt> you can find all matchers that can be used to match on Stmt nodes.

The exception to that rule are matchers that can match on any node. Those are marked with a * and are listed in the beginning of each category.

Note that the categorization of matchers is a great help when you combine them into matcher expressions. You will usually want to form matcher expressions that read like english sentences by alternating between node matchers and narrowing or traversal matchers, like this:

 recordDecl(hasDescendant(
     ifStmt(hasTrueExpression(
         expr(hasDescendant(
             ifStmt()))))))
 

Traverse Mode

The default mode of operation of AST Matchers visits all nodes in the AST, even if they are not spelled in the source. This is AsIs mode. This mode requires writing AST matchers that explicitly traverse or ignore implicit nodes, such as parentheses surrounding an expression or expressions with cleanups. These implicit nodes are not always obvious from the syntax of the source code, and so this mode requires careful consideration and testing to get the desired behavior from an AST matcher.

In addition, because template instantiations are matched in the default mode, transformations can be accidentally made to template declarations. Finally, because implicit nodes are matched by default, transformations can be made on entirely incorrect places in the code.

For these reasons, it is possible to ignore AST nodes which are not spelled in the source using the IgnoreUnlessSpelledInSource mode. This is likely to be far less error-prone for users who are not already very familiar with where implicit nodes appear in the AST. It is also likely to be less error-prone for experienced AST users, as difficult cases do not need to be encountered and matcher expressions adjusted for these cases.

In clang-query, the mode can be changed with

 set traversal IgnoreUnlessSpelledInSource
 

This affects both matchers and AST dump output in results.

When using the C++ API such as in clang-tidy checks, the traverse() matcher is used to set the mode:

 Finder->addMatcher(traverse(TK_IgnoreUnlessSpelledInSource,
   returnStmt(hasReturnArgument(integerLiteral(equals(0))))
   ), this);
 

The following table compares the AsIs mode with the IgnoreUnlessSpelledInSource mode:

AsIs IgnoreUnlessSpelledInSource
AST dump of func1:
 struct B {
   B(int);
 };
 
 B func1() { return 42; }
 
C++98 dialect:
 FunctionDecl
 `-CompoundStmt
   `-ReturnStmt
     `-ExprWithCleanups
       `-CXXConstructExpr
         `-MaterializeTemporaryExpr
           `-ImplicitCastExpr
             `-ImplicitCastExpr
               `-CXXConstructExpr
                 `-IntegerLiteral 'int' 42
 
C++11, C++14 dialect:
 FunctionDecl
 `-CompoundStmt
   `-ReturnStmt
     `-ExprWithCleanups
       `-CXXConstructExpr
         `-MaterializeTemporaryExpr
           `-ImplicitCastExpr
             `-CXXConstructExpr
               `-IntegerLiteral 'int' 42
 
C++17, C++20 dialect:
 FunctionDecl
 `-CompoundStmt
   `-ReturnStmt
     `-ImplicitCastExpr
       `-CXXConstructExpr
         `-IntegerLiteral 'int' 42
 
All dialects:
 FunctionDecl
 `-CompoundStmt
   `-ReturnStmt
     `-IntegerLiteral 'int' 42
 
Matcher for returned 42:
 struct B {
   B(int);
 };
 
 B func1() { return 42; }
 
All dialects:
 returnStmt(hasReturnValue(
     ignoringImplicit(
         ignoringElidableConstructorCall(
             ignoringImplicit(
                 cxxConstructExpr(hasArgument(0,
                     ignoringImplicit(
                         integerLiteral().bind("returnVal")
                         )
                     ))
                 )
             )
         )
     ))
 
All dialects:
 returnStmt(hasReturnValue(
     integerLiteral().bind("returnVal")
 ))
 
Match result for
implicitCastExpr()
given:
 struct B {
   B(int);
 };
 
 B func1() { return 42; }
 
Match found. No match.
Match result for:
 cxxConstructorDecl(
   isCopyConstructor()
   ).bind("prepend_explicit")
 
given:
 struct Other {};
 struct Copyable {
   Other m_o;
   Copyable();
 };
 
Match found. Insertion produces incorrect output:
 struct Other {};
 struct explicit Copyable {
   Other m_o;
   Copyable();
 };
 
No match found. Incorrect replacement not possible.
Replacement of begin() with cbegin():
 cxxMemberCallExpr(
   on(ConstContainerExpr),
   callee(cxxMethodDecl(hasName("begin")))
   ).bind("replace_with_cbegin")
 
given:
 void foo() {
   const Container c;
   c.begin();
 
   for (auto i : c) {
   }
 }
 
2 matches found. Replacement produces incorrect output:
 void foo() {
   const Container c;
   c.cbegin();
 
   for (auto i :.cbegin() c) {
   }
 }
 
1 match found. Replacement produces correct output:
 void foo() {
   const Container c;
   c.cbegin();
 
   for (auto i : c) {
   }
 }
 
Replacement of int member with safe_int:
 fieldDecl(
   hasType(asString("int"))
   ).bind("use_safe_int")
 
given:
 struct S {
   int m_i;
 };
 
 template <typename T> struct TemplStruct {
   TemplStruct() {}
   ~TemplStruct() {}
 
 private:
   T m_t;
 };
 
 void instantiate() { TemplStruct<int> ti; }
 
2 matches found. Replacement produces incorrect output:
 struct S {
   safe_int m_i;
 };
 
 template <typename T> struct TemplStruct {
   TemplStruct() {}
   ~TemplStruct() {}
 
 private:
   safe_int m_t;
 };
 
 void instantiate() { TemplStruct<int> ti; }
 
1 match found. Replacement produces correct output:
 struct S {
   safe_int m_i;
 };
 
 template <typename T> struct TemplStruct {
   TemplStruct() {}
   ~TemplStruct() {}
 
 private:
   T m_t;
 };
 
 void instantiate() { TemplStruct<int> ti; }
 
Add prefix to member initializer
 cxxCtorInitializer(
   forField(fieldDecl())
   ).bind("add_prefix")
 
given:
 struct Simple {};
 
 struct Record {
   Record() : i(42) {}
 private:
   int i;
   Simple s;
 };
 
2 matches found. Replacement produces incorrect output:
 struct Simple {};
 
 struct Record {
   m_Record() : m_i(42) {}
 private:
   int i;
   Simple s;
 };
 
1 match found. Replacement produces correct output:
 struct Simple {};
 
 struct Record {
   Record() : m_i(42) {}
 private:
   int i;
   Simple s;
 };
 
Ignored default arguments
 callExpr(
   callee(functionDecl(
     hasName("hasDefaultArg")
     )),
   argumentCountIs(1)
   ).bind("add_prefix")
 
given:
 void hasDefaultArg(int i, int j = 0) {}
 void callDefaultArg() { hasDefaultArg(42); }
 
No match. 1 match found.
Lambda fields
 fieldDecl(
   hasType(asString("int"))
   ).bind("make_safe")
 
given:
 struct S {
   int m_i;
 };
 
 void func() {
   int a = 0;
   int c = 0;
 
   auto l = [a, b = c](int d) { int e = d; };
   l(43);
 }
 
2 matches found. Replacement produces incorrect output:
 struct S {
   safe_int m_i;
 };
 
 void func() {
   int a = 0;
   int c = 0;
 
   auto l = [safe_a, safe_b = c](int d) { int e = d; };
   l(43);
 }
 
1 match found. Replacement produces correct output:
 struct S {
   safe_int m_i;
 };
 
 void func() {
   int a = 0;
   int c = 0;
 
   auto l = [a, b = c](int d) { int e = d; };
   l(43);
 }
 
Rewritten binary operators
 binaryOperator(
   hasOperatorName("<"),
   hasRHS(hasDescendant(integerLiteral(equals(0))))
   )
 
given:
 #include <compare>
 
 class HasSpaceship {
 public:
    int x;
    bool operator==(const HasSpaceship&) const = default;
    std::strong_ordering operator<=>(const HasSpaceship&) const = default;
 };
 
 bool isLess(const HasSpaceship& a, const HasSpaceship& b) {
    return a < b;
 }
 
1 match found.
    return a < b;
           ^~~~~
 
No match found.

Node Matchers

Node matchers are at the core of matcher expressions - they specify the type of node that is expected. Every match expression starts with a node matcher, which can then be further refined with a narrowing or traversal matcher. All traversal matchers take node matchers as their arguments.

For convenience, all node matchers take an arbitrary number of arguments and implicitly act as allOf matchers.

Node matchers are the only matchers that support the bind("id") call to bind the matched node to the given string, to be later retrieved from the match callback.

It is important to remember that the arguments to node matchers are predicates on the same node, just with additional information about the type. This is often useful to make matcher expression more readable by inlining bind calls into redundant node matchers inside another node matcher:

 // This binds the CXXRecordDecl to "id", as the decl() matcher will stay on
 // the same node.
 recordDecl(decl().bind("id"), hasName("::MyClass"))
 

Return typeNameParameters
Matcher<CXXBaseSpecifier>cxxBaseSpecifierMatcher<CXXBaseSpecifier>...
Matches class bases.
 
 Examples matches public virtual B.
   class B {};
   class C : public virtual B {};
 
Matcher<CXXCtorInitializer>cxxCtorInitializerMatcher<CXXCtorInitializer>...
Matches constructor initializers.
 
 Examples matches i(42).
   class C {
     C() : i(42) {}
     int i;
   };
 
Matcher<Decl>accessSpecDeclMatcher<AccessSpecDecl>...
Matches C++ access specifier declarations.
 
 Given
   class C {
   public:
     int a;
   };
 accessSpecDecl()
   matches 'public:'
 
Matcher<Decl>bindingDeclMatcher<BindingDecl>...
Matches binding declarations
 Example matches foo and bar
 (matcher = bindingDecl()
 
   auto [foo, bar] = std::make_pair{42, 42};
 
Matcher<Decl>blockDeclMatcher<BlockDecl>...
Matches block declarations.
 
 Example matches the declaration of the nameless block printing an input
 integer.
 
   myFunc(^(int p) {
     printf("%d", p);
   })
 
Matcher<Decl>classTemplateDeclMatcher<ClassTemplateDecl>...
Matches C++ class template declarations.
 
 Example matches Z
   template<class T> class Z {};
 
Matcher<Decl>classTemplatePartialSpecializationDeclMatcher<ClassTemplatePartialSpecializationDecl>...
Matches C++ class template partial specializations.
 
 Given
   template<class T1, class T2, int I>
   class A {};
 
   template<class T, int I>
   class A<T, T*, I> {};
 
   template<>
   class A<int, int, 1> {};
 classTemplatePartialSpecializationDecl()
   matches the specialization A<T,T*,I> but not A<int,int,1>
 
Matcher<Decl>classTemplateSpecializationDeclMatcher<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>
 
Matcher<Decl>cxxConstructorDeclMatcher<CXXConstructorDecl>...
Matches C++ constructor declarations.
 
 Example matches Foo::Foo() and Foo::Foo(int)
   class Foo {
    public:
     Foo();
     Foo(int);
     int DoSomething();
   };
 
Matcher<Decl>cxxConversionDeclMatcher<CXXConversionDecl>...
Matches conversion operator declarations.
 
 Example matches the operator.
   class X { operator int() const; };
 
Matcher<Decl>cxxDeductionGuideDeclMatcher<CXXDeductionGuideDecl>...
Matches user-defined and implicitly generated deduction guide.
 
 Example matches the deduction guide.
   template<typename T>
   class X { X(int) };
   X(int) -> X<int>;
 
Matcher<Decl>cxxDestructorDeclMatcher<CXXDestructorDecl>...
Matches explicit C++ destructor declarations.
 
 Example matches Foo::~Foo()
   class Foo {
    public:
     virtual ~Foo();
   };
 
Matcher<Decl>cxxMethodDeclMatcher<CXXMethodDecl>...
Matches method declarations.
 
 Example matches y
   class X { void y(); };
 
Matcher<Decl>cxxRecordDeclMatcher<CXXRecordDecl>...
Matches C++ class declarations.
 
 Example matches X, Z
   class X;
   template<class T> class Z {};
 
Matcher<Decl>declMatcher<Decl>...
Matches declarations.
 
 Examples matches X, C, and the friend declaration inside C;
   void X();
   class C {
     friend X;
   };
 
Matcher<Decl>declaratorDeclMatcher<DeclaratorDecl>...
Matches declarator declarations (field, variable, function
 and non-type template parameter declarations).
 
 Given
   class X { int y; };
 declaratorDecl()
   matches int y.
 
Matcher<Decl>decompositionDeclMatcher<DecompositionDecl>...
Matches decomposition-declarations.
 
 Examples matches the declaration node with foo and bar, but not
 number.
 (matcher = declStmt(has(decompositionDecl())))
 
   int number = 42;
   auto [foo, bar] = std::make_pair{42, 42};
 
Matcher<Decl>enumConstantDeclMatcher<EnumConstantDecl>...
Matches enum constants.
 
 Example matches A, B, C
   enum X {
     A, B, C
   };
 
Matcher<Decl>enumDeclMatcher<EnumDecl>...
Matches enum declarations.
 
 Example matches X
   enum X {
     A, B, C
   };
 
Matcher<Decl>fieldDeclMatcher<FieldDecl>...
Matches field declarations.
 
 Given
   class X { int m; };
 fieldDecl()
   matches 'm'.
 
Matcher<Decl>friendDeclMatcher<FriendDecl>...
Matches friend declarations.
 
 Given
   class X { friend void foo(); };
 friendDecl()
   matches 'friend void foo()'.
 
Matcher<Decl>functionDeclMatcher<FunctionDecl>...
Matches function declarations.
 
 Example matches f
   void f();
 
Matcher<Decl>functionTemplateDeclMatcher<FunctionTemplateDecl>...
Matches C++ function template declarations.
 
 Example matches f
   template<class T> void f(T t) {}
 
Matcher<Decl>indirectFieldDeclMatcher<IndirectFieldDecl>...
Matches indirect field declarations.
 
 Given
   struct X { struct { int a; }; };
 indirectFieldDecl()
   matches 'a'.
 
Matcher<Decl>labelDeclMatcher<LabelDecl>...
Matches a declaration of label.
 
 Given
   goto FOO;
   FOO: bar();
 labelDecl()
   matches 'FOO:'
 
Matcher<Decl>linkageSpecDeclMatcher<LinkageSpecDecl>...
Matches a declaration of a linkage specification.
 
 Given
   extern "C" {}
 linkageSpecDecl()
   matches "extern "C" {}"
 
Matcher<Decl>namedDeclMatcher<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;
   };
 
Matcher<Decl>namespaceAliasDeclMatcher<NamespaceAliasDecl>...
Matches a declaration of a namespace alias.
 
 Given
   namespace test {}
   namespace alias = ::test;
 namespaceAliasDecl()
   matches "namespace alias" but not "namespace test"
 
Matcher<Decl>namespaceDeclMatcher<NamespaceDecl>...
Matches a declaration of a namespace.
 
 Given
   namespace {}
   namespace test {}
 namespaceDecl()
   matches "namespace {}" and "namespace test {}"
 
Matcher<Decl>nonTypeTemplateParmDeclMatcher<NonTypeTemplateParmDecl>...
Matches non-type template parameter declarations.
 
 Given
   template <typename T, int N> struct C {};
 nonTypeTemplateParmDecl()
   matches 'N', but not 'T'.
 
Matcher<Decl>objcCategoryDeclMatcher<ObjCCategoryDecl>...
Matches Objective-C category declarations.
 
 Example matches Foo (Additions)
   @interface Foo (Additions)
   @end
 
Matcher<Decl>objcCategoryImplDeclMatcher<ObjCCategoryImplDecl>...
Matches Objective-C category definitions.
 
 Example matches Foo (Additions)
   @implementation Foo (Additions)
   @end
 
Matcher<Decl>objcImplementationDeclMatcher<ObjCImplementationDecl>...
Matches Objective-C implementation declarations.
 
 Example matches Foo
   @implementation Foo
   @end
 
Matcher<Decl>objcInterfaceDeclMatcher<ObjCInterfaceDecl>...
Matches Objective-C interface declarations.
 
 Example matches Foo
   @interface Foo
   @end
 
Matcher<Decl>objcIvarDeclMatcher<ObjCIvarDecl>...
Matches Objective-C instance variable declarations.
 
 Example matches _enabled
   @implementation Foo {
     BOOL _enabled;
   }
   @end
 
Matcher<Decl>objcMethodDeclMatcher<ObjCMethodDecl>...
Matches Objective-C method declarations.
 
 Example matches both declaration and definition of -[Foo method]
   @interface Foo
   - (void)method;
   @end
 
   @implementation Foo
   - (void)method {}
   @end
 
Matcher<Decl>objcPropertyDeclMatcher<ObjCPropertyDecl>...
Matches Objective-C property declarations.
 
 Example matches enabled
   @interface Foo
   @property BOOL enabled;
   @end
 
Matcher<Decl>objcProtocolDeclMatcher<ObjCProtocolDecl>...
Matches Objective-C protocol declarations.
 
 Example matches FooDelegate
   @protocol FooDelegate
   @end
 
Matcher<Decl>parmVarDeclMatcher<ParmVarDecl>...
Matches parameter variable declarations.
 
 Given
   void f(int x);
 parmVarDecl()
   matches int x.
 
Matcher<Decl>recordDeclMatcher<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 {};
 
Matcher<Decl>staticAssertDeclMatcher<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));
 
Matcher<Decl>tagDeclMatcher<TagDecl>...
Matches tag declarations.
 
 Example matches X, Z, U, S, E
   class X;
   template<class T> class Z {};
   struct S {};
   union U {};
   enum E {
     A, B, C
   };
 
Matcher<Decl>templateTemplateParmDeclMatcher<TemplateTemplateParmDecl>...
Matches template template parameter declarations.
 
 Given
   template <template <typename> class Z, int N> struct C {};
 templateTypeParmDecl()
   matches 'Z', but not 'N'.
 
Matcher<Decl>templateTypeParmDeclMatcher<TemplateTypeParmDecl>...
Matches template type parameter declarations.
 
 Given
   template <typename T, int N> struct C {};
 templateTypeParmDecl()
   matches 'T', but not 'N'.
 
Matcher<Decl>translationUnitDeclMatcher<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".
 
Matcher<Decl>typeAliasDeclMatcher<TypeAliasDecl>...
Matches type alias declarations.
 
 Given
   typedef int X;
   using Y = int;
 typeAliasDecl()
   matches "using Y = int", but not "typedef int X"
 
Matcher<Decl>typeAliasTemplateDeclMatcher<TypeAliasTemplateDecl>...
Matches type alias template declarations.
 
 typeAliasTemplateDecl() matches
   template <typename T>
   using Y = X<T>;
 
Matcher<Decl>typedefDeclMatcher<TypedefDecl>...
Matches typedef declarations.
 
 Given
   typedef int X;
   using Y = int;
 typedefDecl()
   matches "typedef int X", but not "using Y = int"
 
Matcher<Decl>typedefNameDeclMatcher<TypedefNameDecl>...
Matches typedef name declarations.
 
 Given
   typedef int X;
   using Y = int;
 typedefNameDecl()
   matches "typedef int X" and "using Y = int"
 
Matcher<Decl>unresolvedUsingTypenameDeclMatcher<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 using Base<T>::Foo 
Matcher<Decl>unresolvedUsingValueDeclMatcher<UnresolvedUsingValueDecl>...
Matches unresolved using value declarations.
 
 Given
   template<typename X>
   class C : private X {
     using X::x;
   };
 unresolvedUsingValueDecl()
   matches using X::x 
Matcher<Decl>usingDeclMatcher<UsingDecl>...
Matches using declarations.
 
 Given
   namespace X { int x; }
   using X::x;
 usingDecl()
   matches using X::x 
Matcher<Decl>usingDirectiveDeclMatcher<UsingDirectiveDecl>...
Matches using namespace declarations.
 
 Given
   namespace X { int x; }
   using namespace X;
 usingDirectiveDecl()
   matches using namespace X 
Matcher<Decl>valueDeclMatcher<ValueDecl>...
Matches any value declaration.
 
 Example matches A, B, C and F
   enum X { A, B, C };
   void F();
 
Matcher<Decl>varDeclMatcher<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;
 
Matcher<NestedNameSpecifierLoc>nestedNameSpecifierLocMatcher<NestedNameSpecifierLoc>...
Same as nestedNameSpecifier but matches NestedNameSpecifierLoc.
 
Matcher<NestedNameSpecifier>nestedNameSpecifierMatcher<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::"
 
Matcher<OMPClause>ompDefaultClauseMatcher<OMPDefaultClause>...
Matches OpenMP ``default`` clause.
 
 Given
 
   #pragma omp parallel default(none)
   #pragma omp parallel default(shared)
   #pragma omp parallel default(firstprivate)
   #pragma omp parallel
 
 ``ompDefaultClause()`` matches ``default(none)``, ``default(shared)``, and
 ``default(firstprivate)``
 
Matcher<QualType>qualTypeMatcher<QualType>...
Matches QualTypes in the clang AST.
 
Matcher<Stmt>addrLabelExprMatcher<AddrLabelExpr>...
Matches address of label statements (GNU extension).
 
 Given
   FOO: bar();
   void *ptr = &&FOO;
   goto *bar;
 addrLabelExpr()
   matches '&&FOO'
 
Matcher<Stmt>arraySubscriptExprMatcher<ArraySubscriptExpr>...
Matches array subscript expressions.
 
 Given
   int i = a[1];
 arraySubscriptExpr()
   matches "a[1]"
 
Matcher<Stmt>asmStmtMatcher<AsmStmt>...
Matches asm statements.
 
  int i = 100;
   __asm("mov al, 2");
 asmStmt()
   matches '__asm("mov al, 2")'
 
Matcher<Stmt>atomicExprMatcher<AtomicExpr>...
Matches atomic builtins.
 Example matches __atomic_load_n(ptr, 1)
   void foo() { int *ptr; __atomic_load_n(ptr, 1); }
 
Matcher<Stmt>autoreleasePoolStmtMatcher<ObjCAutoreleasePoolStmt>...
Matches an Objective-C autorelease pool statement.
 
 Given
   @autoreleasepool {
     int x = 0;
   }
 autoreleasePoolStmt(stmt()) matches the declaration of "x"
 inside the autorelease pool.
 
Matcher<Stmt>binaryConditionalOperatorMatcher<BinaryConditionalOperator>...
Matches binary conditional operator expressions (GNU extension).
 
 Example matches a ?: b
   (a ?: b) + 42;
 
Matcher<Stmt>binaryOperatorMatcher<BinaryOperator>...
Matches binary operator expressions.
 
 Example matches a || b
   !(a || b)
 See also the binaryOperation() matcher for more-general matching.
 
Matcher<Stmt>blockExprMatcher<BlockExpr>...
Matches a reference to a block.
 
 Example: matches "^{}":
   void f() { ^{}(); }
 
Matcher<Stmt>breakStmtMatcher<BreakStmt>...
Matches break statements.
 
 Given
   while (true) { break; }
 breakStmt()
   matches 'break'
 
Matcher<Stmt>cStyleCastExprMatcher<CStyleCastExpr>...
Matches a C-style cast expression.
 
 Example: Matches (int) 2.2f in
   int i = (int) 2.2f;
 
Matcher<Stmt>callExprMatcher<CallExpr>...
Matches call expressions.
 
 Example matches x.y() and y()
   X x;
   x.y();
   y();
 
Matcher<Stmt>caseStmtMatcher<CaseStmt>...
Matches case statements inside switch statements.
 
 Given
   switch(a) { case 42: break; default: break; }
 caseStmt()
   matches 'case 42:'.
 
Matcher<Stmt>castExprMatcher<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;
 
Matcher<Stmt>characterLiteralMatcher<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';
 
Matcher<Stmt>chooseExprMatcher<ChooseExpr>...
Matches GNU __builtin_choose_expr.
 
Matcher<Stmt>coawaitExprMatcher<CoawaitExpr>...
Matches co_await expressions.
 
 Given
   co_await 1;
 coawaitExpr()
   matches 'co_await 1'
 
Matcher<Stmt>compoundLiteralExprMatcher<CompoundLiteralExpr>...
Matches compound (i.e. non-scalar) literals
 
 Example match: {1}, (1, 2)
   int array[4] = {1};
   vector int myvec = (vector int)(1, 2);
 
Matcher<Stmt>compoundStmtMatcher<CompoundStmt>...
Matches compound statements.
 
 Example matches '{}' and '{{}}' in 'for (;;) {{}}'
   for (;;) {{}}
 
Matcher<Stmt>conditionalOperatorMatcher<ConditionalOperator>...
Matches conditional operator expressions.
 
 Example matches a ? b : c
   (a ? b : c) + 42
 
Matcher<Stmt>constantExprMatcher<ConstantExpr>...
Matches a constant expression wrapper.
 
 Example matches the constant in the case statement:
     (matcher = constantExpr())
   switch (a) {
   case 37: break;
   }
 
Matcher<Stmt>continueStmtMatcher<ContinueStmt>...
Matches continue statements.
 
 Given
   while (true) { continue; }
 continueStmt()
   matches 'continue'
 
Matcher<Stmt>coreturnStmtMatcher<CoreturnStmt>...
Matches co_return statements.
 
 Given
   while (true) { co_return; }
 coreturnStmt()
   matches 'co_return'
 
Matcher<Stmt>coyieldExprMatcher<CoyieldExpr>...
Matches co_yield expressions.
 
 Given
   co_yield 1;
 coyieldExpr()
   matches 'co_yield 1'
 
Matcher<Stmt>cudaKernelCallExprMatcher<CUDAKernelCallExpr>...
Matches CUDA kernel call expression.
 
 Example matches,
   kernel<<<i,j>>>();
 
Matcher<Stmt>cxxBindTemporaryExprMatcher<CXXBindTemporaryExpr>...
Matches nodes where temporaries are created.
 
 Example matches FunctionTakesString(GetStringByValue())
     (matcher = cxxBindTemporaryExpr())
   FunctionTakesString(GetStringByValue());
   FunctionTakesStringByPointer(GetStringPointer());
 
Matcher<Stmt>cxxBoolLiteralMatcher<CXXBoolLiteralExpr>...
Matches bool literals.
 
 Example matches true
   true
 
Matcher<Stmt>cxxCatchStmtMatcher<CXXCatchStmt>...
Matches catch statements.
 
   try {} catch(int i) {}
 cxxCatchStmt()
   matches 'catch(int i)'
 
Matcher<Stmt>cxxConstCastExprMatcher<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);
 
Matcher<Stmt>cxxConstructExprMatcher<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);
 
Matcher<Stmt>cxxDefaultArgExprMatcher<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);
 
Matcher<Stmt>cxxDeleteExprMatcher<CXXDeleteExpr>...
Matches delete expressions.
 
 Given
   delete X;
 cxxDeleteExpr()
   matches 'delete X'.
 
Matcher<Stmt>cxxDependentScopeMemberExprMatcher<CXXDependentScopeMemberExpr>...
Matches member expressions where the actual member referenced could not be
 resolved because the base expression or the member name was dependent.
 
 Given
   template <class T> void f() { T t; t.g(); }
 cxxDependentScopeMemberExpr()
   matches t.g
 
Matcher<Stmt>cxxDynamicCastExprMatcher<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);
 
Matcher<Stmt>cxxForRangeStmtMatcher<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);
 
Matcher<Stmt>cxxFunctionalCastExprMatcher<CXXFunctionalCastExpr>...
Matches functional cast expressions
 
 Example: Matches Foo(bar);
   Foo f = bar;
   Foo g = (Foo) bar;
   Foo h = Foo(bar);
 
Matcher<Stmt>cxxMemberCallExprMatcher<CXXMemberCallExpr>...
Matches member call expressions.
 
 Example matches x.y()
   X x;
   x.y();
 
Matcher<Stmt>cxxNewExprMatcher<CXXNewExpr>...
Matches new expressions.
 
 Given
   new X;
 cxxNewExpr()
   matches 'new X'.
 
Matcher<Stmt>cxxNoexceptExprMatcher<CXXNoexceptExpr>...
Matches noexcept expressions.
 
 Given
   bool a() noexcept;
   bool b() noexcept(true);
   bool c() noexcept(false);
   bool d() noexcept(noexcept(a()));
   bool e = noexcept(b()) || noexcept(c());
 cxxNoexceptExpr()
   matches `noexcept(a())`, `noexcept(b())` and `noexcept(c())`.
   doesn't match the noexcept specifier in the declarations a, b, c or d.
 
Matcher<Stmt>cxxNullPtrLiteralExprMatcher<CXXNullPtrLiteralExpr>...
Matches nullptr literal.
 
Matcher<Stmt>cxxOperatorCallExprMatcher<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;
 See also the binaryOperation() matcher for more-general matching of binary
 uses of this AST node.
 
Matcher<Stmt>cxxReinterpretCastExprMatcher<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);
 
Matcher<Stmt>cxxRewrittenBinaryOperatorMatcher<CXXRewrittenBinaryOperator>...
Matches rewritten binary operators
 
 Example matches use of "<":
   #include <compare>
   struct HasSpaceshipMem {
     int a;
     constexpr auto operator<=>(const HasSpaceshipMem&) const = default;
   };
   void compare() {
     HasSpaceshipMem hs1, hs2;
     if (hs1 < hs2)
         return;
   }
 See also the binaryOperation() matcher for more-general matching
 of this AST node.
 
Matcher<Stmt>cxxStaticCastExprMatcher<CXXStaticCastExpr>...
Matches a C++ static_cast expression.
 
 See also: hasDestinationType
 See also: reinterpretCast
 
 Example:
   cxxStaticCastExpr()
 matches
   static_cast<long>(8)
 in
   long eight(static_cast<long>(8));
 
Matcher<Stmt>cxxStdInitializerListExprMatcher<CXXStdInitializerListExpr>...
Matches C++ initializer list expressions.
 
 Given
   std::vector<int> a({ 1, 2, 3 });
   std::vector<int> b = { 4, 5 };
   int c[] = { 6, 7 };
   std::pair<int, int> d = { 8, 9 };
 cxxStdInitializerListExpr()
   matches "{ 1, 2, 3 }" and "{ 4, 5 }"
 
Matcher<Stmt>cxxTemporaryObjectExprMatcher<CXXTemporaryObjectExpr>...
Matches functional cast expressions having N != 1 arguments
 
 Example: Matches Foo(bar, bar)
   Foo h = Foo(bar, bar);
 
Matcher<Stmt>cxxThisExprMatcher<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; }
 };
 
Matcher<Stmt>cxxThrowExprMatcher<CXXThrowExpr>...
Matches throw expressions.
 
   try { throw 5; } catch(int i) {}
 cxxThrowExpr()
   matches 'throw 5'
 
Matcher<Stmt>cxxTryStmtMatcher<CXXTryStmt>...
Matches try statements.
 
   try {} catch(int i) {}
 cxxTryStmt()
   matches 'try {}'
 
Matcher<Stmt>cxxUnresolvedConstructExprMatcher<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); }
 
Matcher<Stmt>declRefExprMatcher<DeclRefExpr>...
Matches expressions that refer to declarations.
 
 Example matches x in if (x)
   bool x;
   if (x) {}
 
Matcher<Stmt>declStmtMatcher<DeclStmt>...
Matches declaration statements.
 
 Given
   int a;
 declStmt()
   matches 'int a'.
 
Matcher<Stmt>defaultStmtMatcher<DefaultStmt>...
Matches default statements inside switch statements.
 
 Given
   switch(a) { case 42: break; default: break; }
 defaultStmt()
   matches 'default:'.
 
Matcher<Stmt>dependentCoawaitExprMatcher<DependentCoawaitExpr>...
Matches co_await expressions where the type of the promise is dependent
 
Matcher<Stmt>designatedInitExprMatcher<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 };
 
Matcher<Stmt>doStmtMatcher<DoStmt>...
Matches do statements.
 
 Given
   do {} while (true);
 doStmt()
   matches 'do {} while(true)'
 
Matcher<Stmt>explicitCastExprMatcher<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;
 
Matcher<Stmt>exprMatcher<Expr>...
Matches expressions.
 
 Example matches x()
   void f() { x(); }
 
Matcher<Stmt>exprWithCleanupsMatcher<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();
 
Matcher<Stmt>fixedPointLiteralMatcher<FixedPointLiteral>...
Matches fixed point literals
 
Matcher<Stmt>floatLiteralMatcher<FloatingLiteral>...
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;
 
Matcher<Stmt>forStmtMatcher<ForStmt>...
Matches for statements.
 
 Example matches 'for (;;) {}'
   for (;;) {}
   int i[] =  {1, 2, 3}; for (auto a : i);
 
Matcher<Stmt>genericSelectionExprMatcher<GenericSelectionExpr>...
Matches C11 _Generic expression.
 
Matcher<Stmt>gnuNullExprMatcher<GNUNullExpr>...
Matches GNU __null expression.
 
Matcher<Stmt>gotoStmtMatcher<GotoStmt>...
Matches goto statements.
 
 Given
   goto FOO;
   FOO: bar();
 gotoStmt()
   matches 'goto FOO'
 
Matcher<Stmt>ifStmtMatcher<IfStmt>...
Matches if statements.
 
 Example matches 'if (x) {}'
   if (x) {}
 
Matcher<Stmt>imaginaryLiteralMatcher<ImaginaryLiteral>...
Matches imaginary literals, which are based on integer and floating
 point literals e.g.: 1i, 1.0i
 
Matcher<Stmt>implicitCastExprMatcher<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.
 
Matcher<Stmt>implicitValueInitExprMatcher<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)
 
Matcher<Stmt>initListExprMatcher<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 }"
 
Matcher<Stmt>integerLiteralMatcher<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'.
 
Matcher<Stmt>labelStmtMatcher<LabelStmt>...
Matches label statements.
 
 Given
   goto FOO;
   FOO: bar();
 labelStmt()
   matches 'FOO:'
 
Matcher<Stmt>lambdaExprMatcher<LambdaExpr>...
Matches lambda expressions.
 
 Example matches [&](){return 5;}
   [&](){return 5;}
 
Matcher<Stmt>materializeTemporaryExprMatcher<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());
   f().func();
 but does not match
   f();
 
Matcher<Stmt>memberExprMatcher<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
 
Matcher<Stmt>nullStmtMatcher<NullStmt>...
Matches null statements.
 
   foo();;
 nullStmt()
   matches the second ';'
 
Matcher<Stmt>objcCatchStmtMatcher<ObjCAtCatchStmt>...
Matches Objective-C @catch statements.
 
 Example matches @catch
   @try {}
   @catch (...) {}
 
Matcher<Stmt>objcFinallyStmtMatcher<ObjCAtFinallyStmt>...
Matches Objective-C @finally statements.
 
 Example matches @finally
   @try {}
   @finally {}
 
Matcher<Stmt>objcIvarRefExprMatcher<ObjCIvarRefExpr>...
Matches a reference to an ObjCIvar.
 
 Example: matches "a" in "init" method:
 @implementation A {
   NSString *a;
 }
 - (void) init {
   a = @"hello";
 }
 
Matcher<Stmt>objcMessageExprMatcher<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"]
 
Matcher<Stmt>objcThrowStmtMatcher<ObjCAtThrowStmt>...
Matches Objective-C statements.
 
 Example matches @throw obj;
 
Matcher<Stmt>objcTryStmtMatcher<ObjCAtTryStmt>...
Matches Objective-C @try statements.
 
 Example matches @try
   @try {}
   @catch (...) {}
 
Matcher<Stmt>ompExecutableDirectiveMatcher<OMPExecutableDirective>...
Matches any ``#pragma omp`` executable directive.
 
 Given
 
   #pragma omp parallel
   #pragma omp parallel default(none)
   #pragma omp taskyield
 
 ``ompExecutableDirective()`` matches ``omp parallel``,
 ``omp parallel default(none)`` and ``omp taskyield``.
 
Matcher<Stmt>opaqueValueExprMatcher<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;
 
Matcher<Stmt>parenExprMatcher<ParenExpr>...
Matches parentheses used in expressions.
 
 Example matches (foo() + 1)
   int foo() { return 1; }
   int a = (foo() + 1);
 
Matcher<Stmt>parenListExprMatcher<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.
 
Matcher<Stmt>predefinedExprMatcher<PredefinedExpr>...
Matches predefined identifier expressions [C99 6.4.2.2].
 
 Example: Matches __func__
   printf("%s", __func__);
 
Matcher<Stmt>returnStmtMatcher<ReturnStmt>...
Matches return statements.
 
 Given
   return 1;
 returnStmt()
   matches 'return 1'
 
Matcher<Stmt>stmtMatcher<Stmt>...
Matches statements.
 
 Given
   { ++a; }
 stmt()
   matches both the compound statement '{ ++a; }' and '++a'.
 
Matcher<Stmt>stmtExprMatcher<StmtExpr>...
Matches statement expression (GNU extension).
 
 Example match: ({ int X = 4; X; })
   int C = ({ int X = 4; X; });
 
Matcher<Stmt>stringLiteralMatcher<StringLiteral>...
Matches string literals (also matches wide string literals).
 
 Example matches "abcd", L"abcd"
   char *s = "abcd";
   wchar_t *ws = L"abcd";
 
Matcher<Stmt>substNonTypeTemplateParmExprMatcher<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;"
 
Matcher<Stmt>switchCaseMatcher<SwitchCase>...
Matches case and default statements inside switch statements.
 
 Given
   switch(a) { case 42: break; default: break; }
 switchCase()
   matches 'case 42:' and 'default:'.
 
Matcher<Stmt>switchStmtMatcher<SwitchStmt>...
Matches switch statements.
 
 Given
   switch(a) { case 42: break; default: break; }
 switchStmt()
   matches 'switch(a)'.
 
Matcher<Stmt>unaryExprOrTypeTraitExprMatcher<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)
 
Matcher<Stmt>unaryOperatorMatcher<UnaryOperator>...
Matches unary operator expressions.
 
 Example matches !a
   !a || b
 
Matcher<Stmt>unresolvedLookupExprMatcher<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>() 
Matcher<Stmt>unresolvedMemberExprMatcher<UnresolvedMemberExpr>...
Matches unresolved member expressions.
 
 Given
   struct X {
     template <class T> void f();
     void g();
   };
   template <class T> void h() { X x; x.f<T>(); x.g(); }
 unresolvedMemberExpr()
   matches x.f<T>
 
Matcher<Stmt>userDefinedLiteralMatcher<UserDefinedLiteral>...
Matches user defined literal operator call.
 
 Example match: "foo"_suffix
 
Matcher<Stmt>whileStmtMatcher<WhileStmt>...
Matches while statements.
 
 Given
   while (true) {}
 whileStmt()
   matches 'while (true) {}'.
 
Matcher<TemplateArgumentLoc>templateArgumentLocMatcher<TemplateArgumentLoc>...
Matches template arguments (with location info).
 
 Given
   template <typename T> struct C {};
   C<int> c;
 templateArgumentLoc()
   matches 'int' in C<int>.
 
Matcher<TemplateArgument>templateArgumentMatcher<TemplateArgument>...
Matches template arguments.
 
 Given
   template <typename T> struct C {};
   C<int> c;
 templateArgument()
   matches 'int' in C<int>.
 
Matcher<TemplateName>templateNameMatcher<TemplateName>...
Matches template name.
 
 Given
   template <typename T> class X { };
   X<int> xi;
 templateName()
   matches 'X' in X<int>.
 
Matcher<TypeLoc>typeLocMatcher<TypeLoc>...
Matches TypeLocs in the clang AST.
 
Matcher<Type>arrayTypeMatcher<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]]";
 
Matcher<Type>atomicTypeMatcher<AtomicType>...
Matches atomic types.
 
 Given
   _Atomic(int) i;
 atomicType()
   matches "_Atomic(int) i"
 
Matcher<Type>autoTypeMatcher<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"
 
Matcher<Type>blockPointerTypeMatcher<BlockPointerType>...
Matches block pointer types, i.e. types syntactically represented as
 "void (^)(int)".
 
 The pointee is always required to be a FunctionType.
 
Matcher<Type>builtinTypeMatcher<BuiltinType>...
Matches builtin Types.
 
 Given
   struct A {};
   A a;
   int b;
   float c;
   bool d;
 builtinType()
   matches "int b", "float c" and "bool d"
 
Matcher<Type>complexTypeMatcher<ComplexType>...
Matches C99 complex types.
 
 Given
   _Complex float f;
 complexType()
   matches "_Complex float f"
 
Matcher<Type>constantArrayTypeMatcher<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]"
 
Matcher<Type>decayedTypeMatcher<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;
   }
 
Matcher<Type>decltypeTypeMatcher<DecltypeType>...
Matches types nodes representing C++11 decltype(<expr>) types.
 
 Given:
   short i = 1;
   int j = 42;
   decltype(i + j) result = i + j;
 decltypeType()
   matches "decltype(i + j)"
 
Matcher<Type>deducedTemplateSpecializationTypeMatcher<DeducedTemplateSpecializationType>...
Matches C++17 deduced template specialization types, e.g. deduced class
 template types.
 
 Given
   template <typename T>
   class C { public: C(T); };
 
   C c(123);
 deducedTemplateSpecializationType() matches the type in the declaration
 of the variable c.
 
Matcher<Type>dependentSizedArrayTypeMatcher<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]"
 
Matcher<Type>elaboratedTypeMatcher<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.
 
Matcher<Type>enumTypeMatcher<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.
 
Matcher<Type>functionProtoTypeMatcher<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.
 
Matcher<Type>functionTypeMatcher<FunctionType>...
Matches FunctionType nodes.
 
 Given
   int (*f)(int);
   void g();
 functionType()
   matches "int (*f)(int)" and the type of "g".
 
Matcher<Type>incompleteArrayTypeMatcher<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[]"
 
Matcher<Type>injectedClassNameTypeMatcher<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);
   };
 
Matcher<Type>lValueReferenceTypeMatcher<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.
 
Matcher<Type>memberPointerTypeMatcher<MemberPointerType>...
Matches member pointer types.
 Given
   struct A { int i; }
   A::* ptr = A::i;
 memberPointerType()
   matches "A::* ptr"
 
Matcher<Type>objcObjectPointerTypeMatcher<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".
 
Matcher<Type>parenTypeMatcher<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.
 
Matcher<Type>pointerTypeMatcher<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".
 
Matcher<Type>rValueReferenceTypeMatcher<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.
 
Matcher<Type>recordTypeMatcher<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.
 
Matcher<Type>referenceTypeMatcher<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.
 
Matcher<Type>substTemplateTypeParmTypeMatcher<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'
 
Matcher<Type>tagTypeMatcher<TagType>...
Matches tag types (record and enum types).
 
 Given
   enum E {};
   class C {};
 
   E e;
   C c;
 
 tagType() matches the type of the variable declarations of both e
 and c.
 
Matcher<Type>templateSpecializationTypeMatcher<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.
 
Matcher<Type>templateTypeParmTypeMatcher<TemplateTypeParmType>...
Matches template type parameter types.
 
 Example matches T, but not int.
     (matcher = templateTypeParmType())
   template <typename T> void f(int i);
 
Matcher<Type>typeMatcher<Type>...
Matches Types in the clang AST.
 
Matcher<Type>typedefTypeMatcher<TypedefType>...
Matches typedef types.
 
 Given
   typedef int X;
 typedefType()
   matches "typedef int X"
 
Matcher<Type>unaryTransformTypeMatcher<UnaryTransformType>...
Matches types nodes representing unary type transformations.
 
 Given:
   typedef __underlying_type(T) type;
 unaryTransformType()
   matches "__underlying_type(T)"
 
Matcher<Type>variableArrayTypeMatcher<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]]"
 

Narrowing Matchers

Narrowing matchers match certain attributes on the current node, thus narrowing down the set of nodes of the current type to match on.

There are special logical narrowing matchers (allOf, anyOf, anything and unless) which allow users to create more powerful match expressions.

Return typeNameParameters
Matcher<*>allOfMatcher<*>, ..., Matcher<*>
Matches if all given matchers match.
 
 Usable as: Any Matcher
 
Matcher<*>anyOfMatcher<*>, ..., Matcher<*>
Matches if any of the given matchers matches.
 
 Usable as: Any Matcher
 
Matcher<*>anything
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
 
unspecifiedmapAnyOfnodeMatcherFunction...
Matches any of the NodeMatchers with InnerMatchers nested within
 
 Given
   if (true);
   for (; true; );
 with the matcher
   mapAnyOf(ifStmt, forStmt).with(
     hasCondition(cxxBoolLiteralExpr(equals(true)))
     ).bind("trueCond")
 matches the if and the for. It is equivalent to:
   auto trueCond = hasCondition(cxxBoolLiteralExpr(equals(true)));
   anyOf(
     ifStmt(trueCond).bind("trueCond"),
     forStmt(trueCond).bind("trueCond")
     );
 
 The with() chain-call accepts zero or more matchers which are combined
 as-if with allOf() in each of the node matchers.
 Usable as: Any Matcher
 
Matcher<*>unlessMatcher<*>
Matches if the provided matcher does not match.
 
 Example matches Y (matcher = cxxRecordDecl(unless(hasName("X"))))
   class X {};
   class Y {};
 
 Usable as: Any Matcher
 
Matcher<BinaryOperator>hasAnyOperatorNameStringRef, ..., StringRef
Matches operator expressions (binary or unary) that have any of the
 specified names.
 
    hasAnyOperatorName("+", "-")
  Is equivalent to
    anyOf(hasOperatorName("+"), hasOperatorName("-"))
 
Matcher<BinaryOperator>hasOperatorNamestd::string Name
Matches the operator Name of operator expressions (binary or
 unary).
 
 Example matches a || b (matcher = binaryOperator(hasOperatorName("||")))
   !(a || b)
 
Matcher<BinaryOperator>isAssignmentOperator
Matches all kinds of assignment operators.
 
 Example 1: matches a += b (matcher = binaryOperator(isAssignmentOperator()))
   if (a == b)
     a += b;
 
 Example 2: matches s1 = s2
            (matcher = cxxOperatorCallExpr(isAssignmentOperator()))
   struct S { S& operator=(const S&); };
   void x() { S s1, s2; s1 = s2; }
 
Matcher<BinaryOperator>isComparisonOperator
Matches comparison operators.
 
 Example 1: matches a == b (matcher = binaryOperator(isComparisonOperator()))
   if (a == b)
     a += b;
 
 Example 2: matches s1 < s2
            (matcher = cxxOperatorCallExpr(isComparisonOperator()))
   struct S { bool operator<(const S& other); };
   void x(S s1, S s2) { bool b1 = s1 < s2; }
 
Matcher<CXXBaseSpecifier>isPrivate
Matches private C++ declarations and C++ base specifers that specify private
 inheritance.
 
 Examples:
   class C {
   public:    int a;
   protected: int b;
   private:   int c; // fieldDecl(isPrivate()) matches 'c'
   };
 
   struct Base {};
   struct Derived1 : private Base {}; // matches 'Base'
   class Derived2 : Base {}; // matches 'Base'
 
Matcher<CXXBaseSpecifier>isProtected
Matches protected C++ declarations and C++ base specifers that specify
 protected inheritance.
 
 Examples:
   class C {
   public:    int a;
   protected: int b; // fieldDecl(isProtected()) matches 'b'
   private:   int c;
   };
 
   class Base {};
   class Derived : protected Base {}; // matches 'Base'
 
Matcher<CXXBaseSpecifier>isPublic
Matches public C++ declarations and C++ base specifers that specify public
 inheritance.
 
 Examples:
   class C {
   public:    int a; // fieldDecl(isPublic()) matches 'a'
   protected: int b;
   private:   int c;
   };
 
   class Base {};
   class Derived1 : public Base {}; // matches 'Base'
   struct Derived2 : Base {}; // matches 'Base'
 
Matcher<CXXBaseSpecifier>isVirtual
Matches declarations of virtual methods and C++ base specifers that specify
 virtual inheritance.
 
 Example:
   class A {
    public:
     virtual void x(); // matches x
   };
 
 Example:
   class Base {};
   class DirectlyDerived : virtual Base {}; // matches Base
   class IndirectlyDerived : DirectlyDerived, Base {}; // matches Base
 
 Usable as: Matcher<CXXMethodDecl>, Matcher<CXXBaseSpecifier>
 
Matcher<CXXBoolLiteralExpr>equalsbool Value
Matcher<CXXBoolLiteralExpr>equalsconst ValueT Value
Matches literals that are equal to the given value of type ValueT.
 
 Given
   f('false, 3.14, 42);
 characterLiteral(equals(0))
   matches 'cxxBoolLiteral(equals(false)) and cxxBoolLiteral(equals(0))
   match false
 floatLiteral(equals(3.14)) and floatLiteral(equals(314e-2))
   match 3.14
 integerLiteral(equals(42))
   matches 42
 
 Note that you cannot directly match a negative numeric literal because the
 minus sign is not part of the literal: It is a unary operator whose operand
 is the positive numeric literal. Instead, you must use a unaryOperator()
 matcher to match the minus sign:
 
 unaryOperator(hasOperatorName("-"),
               hasUnaryOperand(integerLiteral(equals(13))))
 
 Usable as: Matcher<CharacterLiteral>, Matcher<CXXBoolLiteralExpr>,
            Matcher<FloatingLiteral>, Matcher<IntegerLiteral>
 
Matcher<CXXBoolLiteralExpr>equalsdouble Value
Matcher<CXXBoolLiteralExpr>equalsunsigned Value
Matcher<CXXCatchStmt>isCatchAll
Matches a C++ catch statement that has a catch-all handler.
 
 Given
   try {
     // ...
   } catch (int) {
     // ...
   } catch (...) {
     // ...
   }
 cxxCatchStmt(isCatchAll()) matches catch(...) but not catch(int).
 
Matcher<CXXConstructExpr>argumentCountIsunsigned N
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);
 
Matcher<CXXConstructExpr>isListInitialization
Matches a constructor call expression which uses list initialization.
 
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].
 
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.
 
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.
 
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.
 
Matcher<CXXConstructorDecl>isExplicit
Matches constructor, conversion function, and deduction guide declarations
 that have an explicit specifier if this explicit specifier is resolved to
 true.
 
 Given
   template<bool b>
   struct S {
     S(int); // #1
     explicit S(double); // #2
     operator int(); // #3
     explicit operator bool(); // #4
     explicit(false) S(bool) // # 7
     explicit(true) S(char) // # 8
     explicit(b) S(S) // # 9
   };
   S(int) -> S<true> // #5
   explicit S(double) -> S<false> // #6
 cxxConstructorDecl(isExplicit()) will match #2 and #8, but not #1, #7 or #9.
 cxxConversionDecl(isExplicit()) will match #4, but not #3.
 cxxDeductionGuideDecl(isExplicit()) will match #6, but not #5.
 
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.
 
Matcher<CXXConversionDecl>isExplicit
Matches constructor, conversion function, and deduction guide declarations
 that have an explicit specifier if this explicit specifier is resolved to
 true.
 
 Given
   template<bool b>
   struct S {
     S(int); // #1
     explicit S(double); // #2
     operator int(); // #3
     explicit operator bool(); // #4
     explicit(false) S(bool) // # 7
     explicit(true) S(char) // # 8
     explicit(b) S(S) // # 9
   };
   S(int) -> S<true> // #5
   explicit S(double) -> S<false> // #6
 cxxConstructorDecl(isExplicit()) will match #2 and #8, but not #1, #7 or #9.
 cxxConversionDecl(isExplicit()) will match #4, but not #3.
 cxxDeductionGuideDecl(isExplicit()) will match #6, but not #5.
 
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).
 
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().
 
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()
 
Matcher<CXXDeductionGuideDecl>isExplicit
Matches constructor, conversion function, and deduction guide declarations
 that have an explicit specifier if this explicit specifier is resolved to
 true.
 
 Given
   template<bool b>
   struct S {
     S(int); // #1
     explicit S(double); // #2
     operator int(); // #3
     explicit operator bool(); // #4
     explicit(false) S(bool) // # 7
     explicit(true) S(char) // # 8
     explicit(b) S(S) // # 9
   };
   S(int) -> S<true> // #5
   explicit S(double) -> S<false> // #6
 cxxConstructorDecl(isExplicit()) will match #2 and #8, but not #1, #7 or #9.
 cxxConversionDecl(isExplicit()) will match #4, but not #3.
 cxxDeductionGuideDecl(isExplicit()) will match #6, but not #5.
 
Matcher<CXXDependentScopeMemberExpr>hasMemberNamestd::string N
Matches template-dependent, but known, member names.
 
 In template declarations, dependent members are not resolved and so can
 not be matched to particular named declarations.
 
 This matcher allows to match on the known name of members.
 
 Given
   template <typename T>
   struct S {
       void mem();
   };
   template <typename T>
   void x() {
       S<T> s;
       s.mem();
   }
 cxxDependentScopeMemberExpr(hasMemberName("mem")) matches `s.mem()`
 
Matcher<CXXDependentScopeMemberExpr>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; }
     template <class T> void f() { this->f<T>(); f<T>(); }
     int a;
     static int b;
   };
   template <class T>
   class Z {
     void x() { this->m; }
   };
 memberExpr(isArrow())
   matches this->x, x, y.x, a, this->b
 cxxDependentScopeMemberExpr(isArrow())
   matches this->m
 unresolvedMemberExpr(isArrow())
   matches this->f<T>, f<T>
 
Matcher<CXXDependentScopeMemberExpr>memberHasSameNameAsBoundNodestd::string BindingID
Matches template-dependent, but known, member names against an already-bound
 node
 
 In template declarations, dependent members are not resolved and so can
 not be matched to particular named declarations.
 
 This matcher allows to match on the name of already-bound VarDecl, FieldDecl
 and CXXMethodDecl nodes.
 
 Given
   template <typename T>
   struct S {
       void mem();
   };
   template <typename T>
   void x() {
       S<T> s;
       s.mem();
   }
 The matcher
 @code
 cxxDependentScopeMemberExpr(
   hasObjectExpression(declRefExpr(hasType(templateSpecializationType(
       hasDeclaration(classTemplateDecl(has(cxxRecordDecl(has(
           cxxMethodDecl(hasName("mem")).bind("templMem")
           )))))
       )))),
   memberHasSameNameAsBoundNode("templMem")
   )
 @endcode
 first matches and binds the @c mem member of the @c S template, then
 compares its name to the usage in @c s.mem() in the @c x function template
 
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()
 
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.
 
Matcher<CXXMethodDecl>isFinal
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
 
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.
 
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
 
Matcher<CXXMethodDecl>isPure
Matches if the given method declaration is pure.
 
 Given
   class A {
    public:
     virtual void x() = 0;
   };
   matches A::x
 
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.
 
Matcher<CXXMethodDecl>isVirtual
Matches declarations of virtual methods and C++ base specifers that specify
 virtual inheritance.
 
 Example:
   class A {
    public:
     virtual void x(); // matches x
   };
 
 Example:
   class Base {};
   class DirectlyDerived : virtual Base {}; // matches Base
   class IndirectlyDerived : DirectlyDerived, Base {}; // matches Base
 
 Usable as: Matcher<CXXMethodDecl>, Matcher<CXXBaseSpecifier>
 
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
 
Matcher<CXXNewExpr>isArray
Matches array new expressions.
 
 Given:
   MyClass *p1 = new MyClass[10];
 cxxNewExpr(isArray())
   matches the expression 'new MyClass[10]'.
 
Matcher<CXXOperatorCallExpr>hasAnyOperatorNameStringRef, ..., StringRef
Matches operator expressions (binary or unary) that have any of the
 specified names.
 
    hasAnyOperatorName("+", "-")
  Is equivalent to
    anyOf(hasOperatorName("+"), hasOperatorName("-"))
 
Matcher<CXXOperatorCallExpr>hasAnyOverloadedOperatorNameStringRef, ..., StringRef
Matches overloaded operator names.
 
 Matches overloaded operator names specified in strings without the
 "operator" prefix: e.g. "<<".
 
   hasAnyOverloadedOperatorName("+", "-")
 Is equivalent to
   anyOf(hasOverloadedOperatorName("+"), hasOverloadedOperatorName("-"))
 
Matcher<CXXOperatorCallExpr>hasOperatorNamestd::string Name
Matches the operator Name of operator expressions (binary or
 unary).
 
 Example matches a || b (matcher = binaryOperator(hasOperatorName("||")))
   !(a || b)
 
Matcher<CXXOperatorCallExpr>hasOverloadedOperatorNameStringRef Name
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>
 
Matcher<CXXOperatorCallExpr>isAssignmentOperator
Matches all kinds of assignment operators.
 
 Example 1: matches a += b (matcher = binaryOperator(isAssignmentOperator()))
   if (a == b)
     a += b;
 
 Example 2: matches s1 = s2
            (matcher = cxxOperatorCallExpr(isAssignmentOperator()))
   struct S { S& operator=(const S&); };
   void x() { S s1, s2; s1 = s2; }
 
Matcher<CXXOperatorCallExpr>isComparisonOperator
Matches comparison operators.
 
 Example 1: matches a == b (matcher = binaryOperator(isComparisonOperator()))
   if (a == b)
     a += b;
 
 Example 2: matches s1 < s2
            (matcher = cxxOperatorCallExpr(isComparisonOperator()))
   struct S { bool operator<(const S& other); };
   void x(S s1, S s2) { bool b1 = s1 < s2; }
 
Matcher<CXXRecordDecl>hasDefinition
Matches a class declaration that is defined.
 
 Example matches x (matcher = cxxRecordDecl(hasDefinition()))
 class x {};
 class y;
 
Matcher<CXXRecordDecl>isDerivedFromstd::string BaseName
Overloaded method as shortcut for isDerivedFrom(hasName(...)).
 
Matcher<CXXRecordDecl>isDirectlyDerivedFromstd::string BaseName
Overloaded method as shortcut for isDirectlyDerivedFrom(hasName(...)).
 
Matcher<CXXRecordDecl>isExplicitTemplateSpecialization
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>
 
Matcher<CXXRecordDecl>isFinal
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
 
Matcher<CXXRecordDecl>isLambda
Matches the generated class of lambda expressions.
 
 Given:
   auto x = []{};
 
 cxxRecordDecl(isLambda()) matches the implicit class declaration of
 decltype(x)
 
Matcher<CXXRecordDecl>isSameOrDerivedFromstd::string BaseName
Overloaded method as shortcut for
 isSameOrDerivedFrom(hasName(...)).
 
Matcher<CXXRecordDecl>isTemplateInstantiation
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>;
 or
   template <typename T> class X {}; class A {}; extern template class X<A>;
 cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
   matches the template instantiation of X<A>.
 
 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<A> is an explicit template specialization.
 
 Usable as: Matcher<FunctionDecl>, Matcher<VarDecl>, Matcher<CXXRecordDecl>
 
Matcher<CXXRewrittenBinaryOperator>hasAnyOperatorNameStringRef, ..., StringRef
Matches operator expressions (binary or unary) that have any of the
 specified names.
 
    hasAnyOperatorName("+", "-")
  Is equivalent to
    anyOf(hasOperatorName("+"), hasOperatorName("-"))
 
Matcher<CXXRewrittenBinaryOperator>hasOperatorNamestd::string Name
Matches the operator Name of operator expressions (binary or
 unary).
 
 Example matches a || b (matcher = binaryOperator(hasOperatorName("||")))
   !(a || b)
 
Matcher<CXXRewrittenBinaryOperator>isAssignmentOperator
Matches all kinds of assignment operators.
 
 Example 1: matches a += b (matcher = binaryOperator(isAssignmentOperator()))
   if (a == b)
     a += b;
 
 Example 2: matches s1 = s2
            (matcher = cxxOperatorCallExpr(isAssignmentOperator()))
   struct S { S& operator=(const S&); };
   void x() { S s1, s2; s1 = s2; }
 
Matcher<CXXRewrittenBinaryOperator>isComparisonOperator
Matches comparison operators.
 
 Example 1: matches a == b (matcher = binaryOperator(isComparisonOperator()))
   if (a == b)
     a += b;
 
 Example 2: matches s1 < s2
            (matcher = cxxOperatorCallExpr(isComparisonOperator()))
   struct S { bool operator<(const S& other); };
   void x(S s1, S s2) { bool b1 = s1 < s2; }
 
Matcher<CXXUnresolvedConstructExpr>argumentCountIsunsigned N
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);
 
Matcher<CallExpr>argumentCountIsunsigned N
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);
 
Matcher<CallExpr>usesADL
Matches call expressions which were resolved using ADL.
 
 Example matches y(x) but not y(42) or NS::y(x).
   namespace NS {
     struct X {};
     void y(X);
   }
 
   void y(...);
 
   void test() {
     NS::X x;
     y(x); // Matches
     NS::y(x); // Doesn't match
     y(42); // Doesn't match
     using NS::y;
     y(x); // Found by both unqualified lookup and ADL, doesn't match
    }
 
Matcher<CastExpr>hasCastKindCastKind Kind
Matches casts that has a given cast kind.
 
 Example: matches the implicit cast around 0
 (matcher = castExpr(hasCastKind(CK_NullToPointer)))
   int *p = 0;
 
 If the matcher is use from clang-query, CastKind parameter
 should be passed as a quoted string. e.g., hasCastKind("CK_NullToPointer").
 
Matcher<CharacterLiteral>equalsbool Value
Matcher<CharacterLiteral>equalsconst ValueT Value
Matches literals that are equal to the given value of type ValueT.
 
 Given
   f('false, 3.14, 42);
 characterLiteral(equals(0))
   matches 'cxxBoolLiteral(equals(false)) and cxxBoolLiteral(equals(0))
   match false
 floatLiteral(equals(3.14)) and floatLiteral(equals(314e-2))
   match 3.14
 integerLiteral(equals(42))
   matches 42
 
 Note that you cannot directly match a negative numeric literal because the
 minus sign is not part of the literal: It is a unary operator whose operand
 is the positive numeric literal. Instead, you must use a unaryOperator()
 matcher to match the minus sign:
 
 unaryOperator(hasOperatorName("-"),
               hasUnaryOperand(integerLiteral(equals(13))))
 
 Usable as: Matcher<CharacterLiteral>, Matcher<CXXBoolLiteralExpr>,
            Matcher<FloatingLiteral>, Matcher<IntegerLiteral>
 
Matcher<CharacterLiteral>equalsdouble Value
Matcher<CharacterLiteral>equalsunsigned Value
Matcher<ClassTemplateSpecializationDecl>templateArgumentCountIsunsigned N
Matches if the number of template arguments equals N.
 
 Given
   template<typename T> struct C {};
   C<int> c;
 classTemplateSpecializationDecl(templateArgumentCountIs(1))
   matches C<int>.
 
Matcher<CompoundStmt>statementCountIsunsigned N
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.
 
Matcher<ConstantArrayType>hasSizeunsigned N
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"
 
Matcher<DeclStmt>declCountIsunsigned N
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;'.
 
Matcher<Decl>equalsBoundNodestd::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.
 
Matcher<Decl>equalsNodeconst Decl* Other
Matches if a node equals another node.
 
 Decl has pointer identity in the AST.
 
Matcher<Decl>hasAttrattr::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 used from clang-query, attr::Kind parameter should be
 passed as a quoted string. e.g., hasAttr("attr::CUDADevice").
 
Matcher<Decl>isExpandedFromMacrostd::string MacroName
Matches statements that are (transitively) expanded from the named macro.
 Does not match if only part of the statement is expanded from that macro or
 if different parts of the the statement are expanded from different
 appearances of the macro.
 
Matcher<Decl>isExpansionInFileMatchingStringRef RegExp, Regex::RegexFlags Flags = NoFlags
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>
 
 If the matcher is used in clang-query, RegexFlags parameter
 should be passed as a quoted string. e.g: "NoFlags".
 Flags can be combined with '|' example "IgnoreCase | BasicRegex"
 
Matcher<Decl>isExpansionInMainFile
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>
 
Matcher<Decl>isExpansionInSystemHeader
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>
 
Matcher<Decl>isImplicit
Matches a declaration that has been implicitly added
 by the compiler (eg. implicit default/copy constructors).
 
Matcher<Decl>isInStdNamespace
Matches declarations in the namespace `std`, but not in nested namespaces.
 
 Given
   class vector {};
   namespace foo {
     class vector {};
     namespace std {
       class vector {};
     }
   }
   namespace std {
     inline namespace __1 {
       class vector {}; // #1
       namespace experimental {
         class vector {};
       }
     }
   }
 cxxRecordDecl(hasName("vector"), isInStdNamespace()) will match only #1.
 
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) {...}'.
 
Matcher<Decl>isPrivate
Matches private C++ declarations and C++ base specifers that specify private
 inheritance.
 
 Examples:
   class C {
   public:    int a;
   protected: int b;
   private:   int c; // fieldDecl(isPrivate()) matches 'c'
   };
 
   struct Base {};
   struct Derived1 : private Base {}; // matches 'Base'
   class Derived2 : Base {}; // matches 'Base'
 
Matcher<Decl>isProtected
Matches protected C++ declarations and C++ base specifers that specify
 protected inheritance.
 
 Examples:
   class C {
   public:    int a;
   protected: int b; // fieldDecl(isProtected()) matches 'b'
   private:   int c;
   };
 
   class Base {};
   class Derived : protected Base {}; // matches 'Base'
 
Matcher<Decl>isPublic
Matches public C++ declarations and C++ base specifers that specify public
 inheritance.
 
 Examples:
   class C {
   public:    int a; // fieldDecl(isPublic()) matches 'a'
   protected: int b;
   private:   int c;
   };
 
   class Base {};
   class Derived1 : public Base {}; // matches 'Base'
   struct Derived2 : Base {}; // matches 'Base'
 
Matcher<DesignatedInitExpr>designatorCountIsunsigned N
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 }'.
 
Matcher<EnumDecl>isScoped
Matches C++11 scoped enum declaration.
 
 Example matches Y (matcher = enumDecl(isScoped()))
 enum X {};
 enum class Y {};
 
Matcher<Expr>isInstantiationDependent
Matches expressions that are instantiation-dependent even if it is
 neither type- nor value-dependent.
 
 In the following example, the expression sizeof(sizeof(T() + T()))
 is instantiation-dependent (since it involves a template parameter T),
 but is neither type- nor value-dependent, since the type of the inner
 sizeof is known (std::size_t) and therefore the size of the outer
 sizeof is known.
   template<typename T>
   void f(T x, T y) { sizeof(sizeof(T() + T()); }
 expr(isInstantiationDependent()) matches sizeof(sizeof(T() + T())
 
Matcher<Expr>isTypeDependent
Matches expressions that are type-dependent because the template type
 is not yet instantiated.
 
 For example, the expressions "x" and "x + y" are type-dependent in
 the following code, but "y" is not type-dependent:
   template<typename T>
   void add(T x, int y) {
     x + y;
   }
 expr(isTypeDependent()) matches x + y
 
Matcher<Expr>isValueDependent
Matches expression that are value-dependent because they contain a
 non-type template parameter.
 
 For example, the array bound of "Chars" in the following example is
 value-dependent.
   template<int Size> int f() { return Size; }
 expr(isValueDependent()) matches return Size
 
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.
 
Matcher<FieldDecl>hasBitWidthunsigned Width
Matches non-static data members that are bit-fields of the specified
 bit width.
 
 Given
   class C {
     int a : 2;
     int b : 4;
     int c : 2;
   };
 fieldDecl(hasBitWidth(2))
   matches 'int a;' and 'int c;' but not 'int b;'.
 
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;'.
 
Matcher<FloatingLiteral>equalsconst ValueT Value
Matches literals that are equal to the given value of type ValueT.
 
 Given
   f('false, 3.14, 42);
 characterLiteral(equals(0))
   matches 'cxxBoolLiteral(equals(false)) and cxxBoolLiteral(equals(0))
   match false
 floatLiteral(equals(3.14)) and floatLiteral(equals(314e-2))
   match 3.14
 integerLiteral(equals(42))
   matches 42
 
 Note that you cannot directly match a negative numeric literal because the
 minus sign is not part of the literal: It is a unary operator whose operand
 is the positive numeric literal. Instead, you must use a unaryOperator()
 matcher to match the minus sign:
 
 unaryOperator(hasOperatorName("-"),
               hasUnaryOperand(integerLiteral(equals(13))))
 
 Usable as: Matcher<CharacterLiteral>, Matcher<CXXBoolLiteralExpr>,
            Matcher<FloatingLiteral>, Matcher<IntegerLiteral>
 
Matcher<FloatingLiteral>equalsdouble Value
Matcher<FunctionDecl>hasAnyOverloadedOperatorNameStringRef, ..., StringRef
Matches overloaded operator names.
 
 Matches overloaded operator names specified in strings without the
 "operator" prefix: e.g. "<<".
 
   hasAnyOverloadedOperatorName("+", "-")
 Is equivalent to
   anyOf(hasOverloadedOperatorName("+"), hasOverloadedOperatorName("-"))
 
Matcher<FunctionDecl>hasDynamicExceptionSpec
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.
 
Matcher<FunctionDecl>hasOverloadedOperatorNameStringRef Name
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>
 
Matcher<FunctionDecl>hasTrailingReturn
Matches a function declared with a trailing return type.
 
 Example matches Y (matcher = functionDecl(hasTrailingReturn()))
 int X() {}
 auto Y() -> int {}
 
Matcher<FunctionDecl>isConstexpr
Matches constexpr variable and function declarations,
        and if constexpr.
 
 Given:
   constexpr int foo = 42;
   constexpr int bar();
   void baz() { if constexpr(1 > 0) {} }
 varDecl(isConstexpr())
   matches the declaration of foo.
 functionDecl(isConstexpr())
   matches the declaration of bar.
 ifStmt(isConstexpr())
   matches the if statement in baz.
 
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.
 
Matcher<FunctionDecl>isDefinition
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.
   @interface X
   - (void)ma; // Doesn't match, interface is declaration.
   @end
   @implementation X
   - (void)ma {}
   @end
 
 Usable as: Matcher<TagDecl>, Matcher<VarDecl>, Matcher<FunctionDecl>,
   Matcher<ObjCMethodDecl>
 
Matcher<FunctionDecl>isDeleted
Matches deleted function declarations.
 
 Given:
   void Func();
   void DeletedFunc() = delete;
 functionDecl(isDeleted())
   matches the declaration of DeletedFunc, but not Func.
 
Matcher<FunctionDecl>isExplicitTemplateSpecialization
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>
 
Matcher<FunctionDecl>isExternC
Matches extern "C" function or variable declarations.
 
 Given:
   extern "C" void f() {}
   extern "C" { void g() {} }
   void h() {}
   extern "C" int x = 1;
   extern "C" int y = 2;
   int z = 3;
 functionDecl(isExternC())
   matches the declaration of f and g, but not the declaration of h.
 varDecl(isExternC())
   matches the declaration of x and y, but not the declaration of z.
 
Matcher<FunctionDecl>isInline
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.
 
Matcher<FunctionDecl>isMain
Determines whether the function is "main", which is the entry point
 into an executable program.
 
Matcher<FunctionDecl>isNoReturn
Matches FunctionDecls that have a noreturn attribute.
 
 Given
   void nope();
   [[noreturn]] void a();
   __attribute__((noreturn)) void b();
   struct c { [[noreturn]] c(); };
 functionDecl(isNoReturn())
   matches all of those except
   void nope();
 
Matcher<FunctionDecl>isNoThrow
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.
 
Matcher<FunctionDecl>isStaticStorageClass
Matches variable/function declarations that have "static" storage
 class specifier ("static" keyword) written in the source.
 
 Given:
   static void f() {}
   static int i = 0;
   extern int j;
   int k;
 functionDecl(isStaticStorageClass())
   matches the function declaration f.
 varDecl(isStaticStorageClass())
   matches the variable declaration i.
 
Matcher<FunctionDecl>isTemplateInstantiation
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>;
 or
   template <typename T> class X {}; class A {}; extern template class X<A>;
 cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
   matches the template instantiation of X<A>.
 
 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<A> is an explicit template specialization.
 
 Usable as: Matcher<FunctionDecl>, Matcher<VarDecl>, Matcher<CXXRecordDecl>
 
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();
 
Matcher<FunctionDecl>isWeak
Matches weak function declarations.
 
 Given:
   void foo() __attribute__((__weakref__("__foo")));
   void bar();
 functionDecl(isWeak())
   matches the weak declaration "foo", but not "bar".
 
Matcher<FunctionDecl>parameterCountIsunsigned N
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 g and h
 functionProtoType(parameterCountIs(2))
   matches g and h
 functionProtoType(parameterCountIs(3))
   matches k
 
Matcher<FunctionProtoType>hasDynamicExceptionSpec
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.
 
Matcher<FunctionProtoType>isNoThrow
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.
 
Matcher<FunctionProtoType>parameterCountIsunsigned N
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 g and h
 functionProtoType(parameterCountIs(2))
   matches g and h
 functionProtoType(parameterCountIs(3))
   matches k
 
Matcher<IfStmt>isConstexpr
Matches constexpr variable and function declarations,
        and if constexpr.
 
 Given:
   constexpr int foo = 42;
   constexpr int bar();
   void baz() { if constexpr(1 > 0) {} }
 varDecl(isConstexpr())
   matches the declaration of foo.
 functionDecl(isConstexpr())
   matches the declaration of bar.
 ifStmt(isConstexpr())
   matches the if statement in baz.
 
Matcher<IntegerLiteral>equalsbool Value
Matcher<IntegerLiteral>equalsconst ValueT Value
Matches literals that are equal to the given value of type ValueT.
 
 Given
   f('false, 3.14, 42);
 characterLiteral(equals(0))
   matches 'cxxBoolLiteral(equals(false)) and cxxBoolLiteral(equals(0))
   match false
 floatLiteral(equals(3.14)) and floatLiteral(equals(314e-2))
   match 3.14
 integerLiteral(equals(42))
   matches 42
 
 Note that you cannot directly match a negative numeric literal because the
 minus sign is not part of the literal: It is a unary operator whose operand
 is the positive numeric literal. Instead, you must use a unaryOperator()
 matcher to match the minus sign:
 
 unaryOperator(hasOperatorName("-"),
               hasUnaryOperand(integerLiteral(equals(13))))
 
 Usable as: Matcher<CharacterLiteral>, Matcher<CXXBoolLiteralExpr>,
            Matcher<FloatingLiteral>, Matcher<IntegerLiteral>
 
Matcher<IntegerLiteral>equalsdouble Value
Matcher<IntegerLiteral>equalsunsigned Value
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; }
     template <class T> void f() { this->f<T>(); f<T>(); }
     int a;
     static int b;
   };
   template <class T>
   class Z {
     void x() { this->m; }
   };
 memberExpr(isArrow())
   matches this->x, x, y.x, a, this->b
 cxxDependentScopeMemberExpr(isArrow())
   matches this->m
 unresolvedMemberExpr(isArrow())
   matches this->f<T>, f<T>
 
Matcher<NamedDecl>hasAnyNameStringRef, ..., StringRef
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
     anyOf(hasName(a), hasName(b), hasName(c))
 
Matcher<NamedDecl>hasExternalFormalLinkage
Matches a declaration that has external formal linkage.
 
 Example matches only z (matcher = varDecl(hasExternalFormalLinkage()))
 void f() {
   int x;
   static int y;
 }
 int z;
 
 Example matches f() because it has external formal linkage despite being
 unique to the translation unit as though it has internal likage
 (matcher = functionDecl(hasExternalFormalLinkage()))
 
 namespace {
 void f() {}
 }
 
Matcher<NamedDecl>hasNameStringRef Name
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; } }
 
Matcher<NamedDecl>matchesNameStringRef RegExp, Regex::RegexFlags Flags = NoFlags
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; } }
 
 If the matcher is used in clang-query, RegexFlags parameter
 should be passed as a quoted string. e.g: "NoFlags".
 Flags can be combined with '|' example "IgnoreCase | BasicRegex"
 
Matcher<NamespaceDecl>isAnonymous
Matches anonymous namespace declarations.
 
 Given
   namespace n {
   namespace {} // #1
   }
 namespaceDecl(isAnonymous()) will match #1 but not ::n.
 
Matcher<NamespaceDecl>isInline
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.
 
Matcher<OMPDefaultClause>isFirstPrivateKind
Matches if the OpenMP ``default`` clause has ``firstprivate`` kind
 specified.
 
 Given
 
   #pragma omp parallel
   #pragma omp parallel default(none)
   #pragma omp parallel default(shared)
   #pragma omp parallel default(firstprivate)
 
 ``ompDefaultClause(isFirstPrivateKind())`` matches only
 ``default(firstprivate)``.
 
Matcher<OMPDefaultClause>isNoneKind
Matches if the OpenMP ``default`` clause has ``none`` kind specified.
 
 Given
 
   #pragma omp parallel
   #pragma omp parallel default(none)
   #pragma omp parallel default(shared)
   #pragma omp parallel default(firstprivate)
 
 ``ompDefaultClause(isNoneKind())`` matches only ``default(none)``.
 
Matcher<OMPDefaultClause>isSharedKind
Matches if the OpenMP ``default`` clause has ``shared`` kind specified.
 
 Given
 
   #pragma omp parallel
   #pragma omp parallel default(none)
   #pragma omp parallel default(shared)
   #pragma omp parallel default(firstprivate)
 
 ``ompDefaultClause(isSharedKind())`` matches only ``default(shared)``.
 
Matcher<OMPExecutableDirective>isAllowedToContainClauseKindOpenMPClauseKind CKind
Matches if the OpenMP directive is allowed to contain the specified OpenMP
 clause kind.
 
 Given
 
   #pragma omp parallel
   #pragma omp parallel for
   #pragma omp          for
 
 `ompExecutableDirective(isAllowedToContainClause(OMPC_default))`` matches
 ``omp parallel`` and ``omp parallel for``.
 
 If the matcher is use from clang-query, ``OpenMPClauseKind`` parameter
 should be passed as a quoted string. e.g.,
 ``isAllowedToContainClauseKind("OMPC_default").``
 
Matcher<OMPExecutableDirective>isStandaloneDirective
Matches standalone OpenMP directives,
 i.e., directives that can't have a structured block.
 
 Given
 
   #pragma omp parallel
   {}
   #pragma omp taskyield
 
 ``ompExecutableDirective(isStandaloneDirective()))`` matches
 ``omp taskyield``.
 
Matcher<ObjCInterfaceDecl>isDerivedFromstd::string BaseName
Overloaded method as shortcut for isDerivedFrom(hasName(...)).
 
Matcher<ObjCInterfaceDecl>isDirectlyDerivedFromstd::string BaseName
Overloaded method as shortcut for isDirectlyDerivedFrom(hasName(...)).
 
Matcher<ObjCInterfaceDecl>isSameOrDerivedFromstd::string BaseName
Overloaded method as shortcut for
 isSameOrDerivedFrom(hasName(...)).
 
Matcher<ObjCMessageExpr>argumentCountIsunsigned N
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);
 
Matcher<ObjCMessageExpr>hasAnySelectorStringRef, ..., StringRef
Matches when at least one of the supplied string equals to the
 Selector.getAsString()
 
  matcher = objCMessageExpr(hasSelector("methodA:", "methodB:"));
  matches both of the expressions below:
     [myObj methodA:argA];
     [myObj methodB:argB];
 
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
 
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!
 
Matcher<ObjCMessageExpr>hasSelectorstd::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];
 
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];
 
Matcher<ObjCMessageExpr>isClassMessage
Returns true when the Objective-C message is sent to a class.
 
 Example
 matcher = objcMessageExpr(isClassMessage())
 matches
   [NSString stringWithFormat:@"format"];
 but not
   NSString *x = @"hello";
   [x containsString:@"h"];
 
Matcher<ObjCMessageExpr>isInstanceMessage
Returns true when the Objective-C message is sent to an instance.
 
 Example
 matcher = objcMessageExpr(isInstanceMessage())
 matches
   NSString *x = @"hello";
   [x containsString:@"h"];
 but not
   [NSString stringWithFormat:@"format"];
 
Matcher<ObjCMessageExpr>matchesSelectorStringRef RegExp, Regex::RegexFlags Flags = NoFlags
Matches ObjC selectors whose name contains
 a substring matched by the given RegExp.
  matcher = objCMessageExpr(matchesSelector("loadHTMLStringmatches the outer message expr in the code below, but NOT the message
  invocation for self.bodyView.
     [self.bodyView loadHTMLString:html baseURL:NULL];
 
 If the matcher is used in clang-query, RegexFlags parameter
 should be passed as a quoted string. e.g: "NoFlags".
 Flags can be combined with '|' example "IgnoreCase | BasicRegex"
 
Matcher<ObjCMessageExpr>numSelectorArgsunsigned N
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];
 
Matcher<ObjCMethodDecl>isClassMethod
Returns true when the Objective-C method declaration is a class method.
 
 Example
 matcher = objcMethodDecl(isClassMethod())
 matches
 @interface I + (void)foo; @end
 but not
 @interface I - (void)bar; @end
 
Matcher<ObjCMethodDecl>isDefinition
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.
   @interface X
   - (void)ma; // Doesn't match, interface is declaration.
   @end
   @implementation X
   - (void)ma {}
   @end
 
 Usable as: Matcher<TagDecl>, Matcher<VarDecl>, Matcher<FunctionDecl>,
   Matcher<ObjCMethodDecl>
 
Matcher<ObjCMethodDecl>isInstanceMethod
Returns true when the Objective-C method declaration is an instance method.
 
 Example
 matcher = objcMethodDecl(isInstanceMethod())
 matches
 @interface I - (void)bar; @end
 but not
 @interface I + (void)foo; @end
 
Matcher<ParmVarDecl>hasDefaultArgument
Matches a declaration that has default arguments.
 
 Example matches y (matcher = parmVarDecl(hasDefaultArgument()))
 void x(int val) {}
 void y(int val = 0) {}
 
 Deprecated. Use hasInitializer() instead to be able to
 match on the contents of the default argument.  For example:
 
 void x(int val = 7) {}
 void y(int val = 42) {}
 parmVarDecl(hasInitializer(integerLiteral(equals(42))))
   matches the parameter of y
 
 A matcher such as
   parmVarDecl(hasInitializer(anything()))
 is equivalent to parmVarDecl(hasDefaultArgument()).
 
Matcher<ParmVarDecl>isAtPositionunsigned N
Matches the ParmVarDecl nodes that are at the N'th position in the parameter
 list. The parameter list could be that of either a block, function, or
 objc-method.
 
 
 Given
 
 void f(int a, int b, int c) {
 }
 
 ``parmVarDecl(isAtPosition(0))`` matches ``int a``.
 
 ``parmVarDecl(isAtPosition(1))`` matches ``int b``.
 
Matcher<QualType>asStringstd::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()
 
Matcher<QualType>equalsBoundNodestd::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.
 
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.
 
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)".
 
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".
 
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 *".
 
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)".
 
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(isSignedInteger())))
 matches "a(int)", but not "b(unsigned long)" and "c(double)".
 
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(isUnsignedInteger())))
 matches "b(unsigned long)", but not "a(int)" and "c(double)".
 
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 *".
 
Matcher<Stmt>equalsBoundNodestd::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.
 
Matcher<Stmt>equalsNodeconst Stmt* Other
Matches if a node equals another node.
 
 Stmt has pointer identity in the AST.
 
Matcher<Stmt>isExpandedFromMacrostd::string MacroName
Matches statements that are (transitively) expanded from the named macro.
 Does not match if only part of the statement is expanded from that macro or
 if different parts of the the statement are expanded from different
 appearances of the macro.
 
Matcher<Stmt>isExpansionInFileMatchingStringRef RegExp, Regex::RegexFlags Flags = NoFlags
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>
 
 If the matcher is used in clang-query, RegexFlags parameter
 should be passed as a quoted string. e.g: "NoFlags".
 Flags can be combined with '|' example "IgnoreCase | BasicRegex"
 
Matcher<Stmt>isExpansionInMainFile
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>
 
Matcher<Stmt>isExpansionInSystemHeader
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>
 
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.
 
Matcher<StringLiteral>hasSizeunsigned N
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"
 
Matcher<TagDecl>isClass
Matches TagDecl object that are spelled with "class."
 
 Example matches C, but not S, U or E.
   struct S {};
   class C {};
   union U {};
   enum E {};
 
Matcher<TagDecl>isDefinition
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.
   @interface X
   - (void)ma; // Doesn't match, interface is declaration.
   @end
   @implementation X
   - (void)ma {}
   @end
 
 Usable as: Matcher<TagDecl>, Matcher<VarDecl>, Matcher<FunctionDecl>,
   Matcher<ObjCMethodDecl>
 
Matcher<TagDecl>isEnum
Matches TagDecl object that are spelled with "enum."
 
 Example matches E, but not C, S or U.
   struct S {};
   class C {};
   union U {};
   enum E {};
 
Matcher<TagDecl>isStruct
Matches TagDecl object that are spelled with "struct."
 
 Example matches S, but not C, U or E.
   struct S {};
   class C {};
   union U {};
   enum E {};
 
Matcher<TagDecl>isUnion
Matches TagDecl object that are spelled with "union."
 
 Example matches U, but not C, S or E.
   struct S {};
   class C {};
   union U {};
   enum E {};
 
Matcher<TemplateArgument>equalsIntegralValuestd::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 C {};
   C<42> c;
 classTemplateSpecializationDecl(
   hasAnyTemplateArgument(equalsIntegralValue("42")))
   matches the implicit instantiation of C in C<42>.
 
Matcher<TemplateArgument>isIntegral
Matches a TemplateArgument that is an integral value.
 
 Given
   template<int T> struct C {};
   C<42> c;
 classTemplateSpecializationDecl(
   hasAnyTemplateArgument(isIntegral()))
   matches the implicit instantiation of C in C<42>
   with isIntegral() matching 42.
 
Matcher<TemplateSpecializationType>templateArgumentCountIsunsigned N
Matches if the number of template arguments equals N.
 
 Given
   template<typename T> struct C {};
   C<int> c;
 classTemplateSpecializationDecl(templateArgumentCountIs(1))
   matches C<int>.
 
Matcher<TypeLoc>isExpandedFromMacrostd::string MacroName
Matches statements that are (transitively) expanded from the named macro.
 Does not match if only part of the statement is expanded from that macro or
 if different parts of the the statement are expanded from different
 appearances of the macro.
 
Matcher<TypeLoc>isExpansionInFileMatchingStringRef RegExp, Regex::RegexFlags Flags = NoFlags
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>
 
 If the matcher is used in clang-query, RegexFlags parameter
 should be passed as a quoted string. e.g: "NoFlags".
 Flags can be combined with '|' example "IgnoreCase | BasicRegex"
 
Matcher<TypeLoc>isExpansionInMainFile
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>
 
Matcher<TypeLoc>isExpansionInSystemHeader
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>
 
Matcher<Type>booleanType
Matches type bool.
 
 Given
  struct S { bool func(); };
 functionDecl(returns(booleanType()))
   matches "bool func();"
 
Matcher<Type>equalsBoundNodestd::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.
 
Matcher<Type>equalsNodeconst Type* Other
Matches if a node equals another node.
 
 Type has pointer identity in the 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"
 
Matcher<Type>voidType
Matches type void.
 
 Given
  struct S { void func(); };
 functionDecl(returns(voidType()))
   matches "void func();"
 
Matcher<UnaryExprOrTypeTraitExpr>ofKindUnaryExprOrTypeTrait Kind
Matches unary expressions of a certain kind.
 
 Given
   int x;
   int s = sizeof(x) + alignof(x)
 unaryExprOrTypeTraitExpr(ofKind(UETT_SizeOf))
   matches sizeof(x)
 
 If the matcher is use from clang-query, UnaryExprOrTypeTrait parameter
 should be passed as a quoted string. e.g., ofKind("UETT_SizeOf").
 
Matcher<UnaryOperator>hasAnyOperatorNameStringRef, ..., StringRef
Matches operator expressions (binary or unary) that have any of the
 specified names.
 
    hasAnyOperatorName("+", "-")
  Is equivalent to
    anyOf(hasOperatorName("+"), hasOperatorName("-"))
 
Matcher<UnaryOperator>hasOperatorNamestd::string Name
Matches the operator Name of operator expressions (binary or
 unary).
 
 Example matches a || b (matcher = binaryOperator(hasOperatorName("||")))
   !(a || b)
 
Matcher<UnresolvedMemberExpr>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; }
     template <class T> void f() { this->f<T>(); f<T>(); }
     int a;
     static int b;
   };
   template <class T>
   class Z {
     void x() { this->m; }
   };
 memberExpr(isArrow())
   matches this->x, x, y.x, a, this->b
 cxxDependentScopeMemberExpr(isArrow())
   matches this->m
 unresolvedMemberExpr(isArrow())
   matches this->f<T>, f<T>
 
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;
 
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;
 
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;
 
Matcher<VarDecl>hasStaticStorageDuration
Matches a variable declaration that has static storage duration.
 It includes the variable declared at namespace scope and those declared
 with "static" and "extern" storage class specifiers.
 
 void f() {
   int x;
   static int y;
   thread_local int z;
 }
 int a;
 static int b;
 extern int c;
 varDecl(hasStaticStorageDuration())
   matches the function declaration y, a, b and c.
 
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;
 
Matcher<VarDecl>isConstexpr
Matches constexpr variable and function declarations,
        and if constexpr.
 
 Given:
   constexpr int foo = 42;
   constexpr int bar();
   void baz() { if constexpr(1 > 0) {} }
 varDecl(isConstexpr())
   matches the declaration of foo.
 functionDecl(isConstexpr())
   matches the declaration of bar.
 ifStmt(isConstexpr())
   matches the if statement in baz.
 
Matcher<VarDecl>isDefinition
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.
   @interface X
   - (void)ma; // Doesn't match, interface is declaration.
   @end
   @implementation X
   - (void)ma {}
   @end
 
 Usable as: Matcher<TagDecl>, Matcher<VarDecl>, Matcher<FunctionDecl>,
   Matcher<ObjCMethodDecl>
 
Matcher<VarDecl>isExceptionVariable
Matches a variable declaration that is an exception variable from
 a C++ catch block, or an Objective-C statement.
 
 Example matches x (matcher = varDecl(isExceptionVariable())
 void f(int y) {
   try {
   } catch (int x) {
   }
 }
 
Matcher<VarDecl>isExplicitTemplateSpecialization
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>
 
Matcher<VarDecl>isExternC
Matches extern "C" function or variable declarations.
 
 Given:
   extern "C" void f() {}
   extern "C" { void g() {} }
   void h() {}
   extern "C" int x = 1;
   extern "C" int y = 2;
   int z = 3;
 functionDecl(isExternC())
   matches the declaration of f and g, but not the declaration of h.
 varDecl(isExternC())
   matches the declaration of x and y, but not the declaration of z.
 
Matcher<VarDecl>isStaticLocal
Matches a static variable with local scope.
 
 Example matches y (matcher = varDecl(isStaticLocal()))
 void f() {
   int x;
   static int y;
 }
 static int z;
 
Matcher<VarDecl>isStaticStorageClass
Matches variable/function declarations that have "static" storage
 class specifier ("static" keyword) written in the source.
 
 Given:
   static void f() {}
   static int i = 0;
   extern int j;
   int k;
 functionDecl(isStaticStorageClass())
   matches the function declaration f.
 varDecl(isStaticStorageClass())
   matches the variable declaration i.
 
Matcher<VarDecl>isTemplateInstantiation
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>;
 or
   template <typename T> class X {}; class A {}; extern template class X<A>;
 cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
   matches the template instantiation of X<A>.
 
 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<A> is an explicit template specialization.
 
 Usable as: Matcher<FunctionDecl>, Matcher<VarDecl>, Matcher<CXXRecordDecl>
 

AST Traversal Matchers

Traversal matchers specify the relationship to other nodes that are reachable from the current node.

Note that there are special traversal matchers (has, hasDescendant, forEach and forEachDescendant) which work on all nodes and allow users to write more generic match expressions.

Return typeNameParameters
Matcher<*>binaryOperationMatcher<*>...Matcher<*>
Matches nodes which can be used with binary operators.
 
 The code
   var1 != var2;
 might be represented in the clang AST as a binaryOperator, a
 cxxOperatorCallExpr or a cxxRewrittenBinaryOperator, depending on
 
 * whether the types of var1 and var2 are fundamental (binaryOperator) or at
   least one is a class type (cxxOperatorCallExpr)
 * whether the code appears in a template declaration, if at least one of the
   vars is a dependent-type (binaryOperator)
 * whether the code relies on a rewritten binary operator, such as a
 spaceship operator or an inverted equality operator
 (cxxRewrittenBinaryOperator)
 
 This matcher elides details in places where the matchers for the nodes are
 compatible.
 
 Given
   binaryOperation(
     hasOperatorName("!="),
     hasLHS(expr().bind("lhs")),
     hasRHS(expr().bind("rhs"))
   )
 matches each use of "!=" in:
   struct S{
       bool operator!=(const S&) const;
   };
 
   void foo()
   {
      1 != 2;
      S() != S();
   }
 
   template<typename T>
   void templ()
   {
      1 != 2;
      T() != S();
   }
   struct HasOpEq
   {
       bool operator==(const HasOpEq &) const;
   };
 
   void inverse()
   {
       HasOpEq s1;
       HasOpEq s2;
       if (s1 != s2)
           return;
   }
 
   struct HasSpaceship
   {
       bool operator<=>(const HasOpEq &) const;
   };
 
   void use_spaceship()
   {
       HasSpaceship s1;
       HasSpaceship s2;
       if (s1 != s2)
           return;
   }
 
Matcher<*>eachOfMatcher<*>, ..., Matcher<*>
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:
   cxxRecordDecl(eachOf(has(fieldDecl(hasName("a")).bind("v")),
                        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
 
Matcher<*>findAllMatcher<*> 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:
   cxxRecordDecl(hasName("::A"),
                 findAll(cxxRecordDecl(isDefinition()).bind("m")))
 will generate results for A, B and C.
 
 Usable as: Any Matcher
 
Matcher<*>forEachDescendantMatcher<*>
Matches AST nodes that have descendant AST nodes that match the
 provided matcher.
 
 Example matches X, A, A::X, B, B::C, B::C::X
   (matcher = cxxRecordDecl(forEachDescendant(cxxRecordDecl(hasName("X")))))
   class X {};
   class A { class X {}; };  // Matches A, because A::X is a class of name
                             // X inside A.
   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
 
Matcher<*>forEachMatcher<*>
Matches AST nodes that have child AST nodes that match the
 provided matcher.
 
 Example matches X, Y, Y::X, Z::Y, Z::Y::X
   (matcher = cxxRecordDecl(forEach(cxxRecordDecl(hasName("X")))
   class X {};
   class Y { class X {}; };  // Matches Y, because Y::X is a class of name X
                             // inside Y.
   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
 
Matcher<*>hasAncestorMatcher<*>
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
 
Matcher<*>hasDescendantMatcher<*>
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
 
Matcher<*>hasMatcher<*>
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())).
 
Matcher<*>hasParentMatcher<*>
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
 
Matcher<*>invocationMatcher<*>...Matcher<*>
Matches function calls and constructor calls
 
 Because CallExpr and CXXConstructExpr do not share a common
 base class with API accessing arguments etc, AST Matchers for code
 which should match both are typically duplicated. This matcher
 removes the need for duplication.
 
 Given code
 struct ConstructorTakesInt
 {
   ConstructorTakesInt(int i) {}
 };
 
 void callTakesInt(int i)
 {
 }
 
 void doCall()
 {
   callTakesInt(42);
 }
 
 void doConstruct()
 {
   ConstructorTakesInt cti(42);
 }
 
 The matcher
 invocation(hasArgument(0, integerLiteral(equals(42))))
 matches the expression in both doCall and doConstruct
 
Matcher<*>optionallyMatcher<*>
Matches any node regardless of the submatcher.
 
 However, optionally will retain any bindings generated by the submatcher.
 Useful when additional information which may or may not present about a main
 matching node is desired.
 
 For example, in:
   class Foo {
     int bar;
   }
 The matcher:
   cxxRecordDecl(
     optionally(has(
       fieldDecl(hasName("bar")).bind("var")
   ))).bind("record")
 will produce a result binding for both "record" and "var".
 The matcher will produce a "record" binding for even if there is no data
 member named "bar" in that class.
 
 Usable as: Any Matcher
 
Matcher<*>traverseTraversalKind TK, Matcher<*> InnerMatcher
Causes all nested matchers to be matched with the specified traversal kind.
 
 Given
   void foo()
   {
       int i = 3.0;
   }
 The matcher
   traverse(TK_IgnoreUnlessSpelledInSource,
     varDecl(hasInitializer(floatLiteral().bind("init")))
   )
 matches the variable declaration with "init" bound to the "3.0".
 
Matcher<AbstractConditionalOperator>hasConditionMatcher<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) {}
 
Matcher<AbstractConditionalOperator>hasFalseExpressionMatcher<Expr> InnerMatcher
Matches the false branch expression of a conditional operator
 (binary or ternary).
 
 Example matches b
   condition ? a : b
   condition ?: b
 
Matcher<AbstractConditionalOperator>hasTrueExpressionMatcher<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
 
Matcher<AddrLabelExpr>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<ArraySubscriptExpr>hasBaseMatcher<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
 
Matcher<ArraySubscriptExpr>hasIndexMatcher<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
 
Matcher<ArraySubscriptExpr>hasLHSMatcher<Expr> InnerMatcher
Matches the left hand side of binary operator expressions.
 
 Example matches a (matcher = binaryOperator(hasLHS()))
   a || b
 
Matcher<ArraySubscriptExpr>hasRHSMatcher<Expr> InnerMatcher
Matches the right hand side of binary operator expressions.
 
 Example matches b (matcher = binaryOperator(hasRHS()))
   a || b
 
Matcher<ArrayType>hasElementTypeMatcher<Type>
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>
 
Matcher<AtomicType>hasValueTypeMatcher<Type>
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>
 
Matcher<AutoType>hasDeducedTypeMatcher<Type>
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>
 
Matcher<BinaryOperator>hasEitherOperandMatcher<Expr> InnerMatcher
Matches if either the left hand side or the right hand side of a
 binary operator matches.
 
Matcher<BinaryOperator>hasLHSMatcher<Expr> InnerMatcher
Matches the left hand side of binary operator expressions.
 
 Example matches a (matcher = binaryOperator(hasLHS()))
   a || b
 
Matcher<BinaryOperator>hasOperandsMatcher<Expr> Matcher1, Matcher<Expr> Matcher2
Matches if both matchers match with opposite sides of the binary operator.
 
 Example matcher = binaryOperator(hasOperands(integerLiteral(equals(1),
                                              integerLiteral(equals(2)))
   1 + 2 // Match
   2 + 1 // Match
   1 + 1 // No match
   2 + 2 // No match
 
Matcher<BinaryOperator>hasRHSMatcher<Expr> InnerMatcher
Matches the right hand side of binary operator expressions.
 
 Example matches b (matcher = binaryOperator(hasRHS()))
   a || b
 
Matcher<BindingDecl>forDecompositionMatcher<ValueDecl> InnerMatcher
Matches the DecompositionDecl the binding belongs to.
 
 For example, in:
 void foo()
 {
     int arr[3];
     auto &[f, s, t] = arr;
 
     f = 42;
 }
 The matcher:
   bindingDecl(hasName("f"),
                 forDecomposition(decompositionDecl())
 matches 'f' in 'auto &[f, s, t]'.
 
Matcher<BlockDecl>hasAnyParameterMatcher<ParmVarDecl> InnerMatcher
Matches any parameter of a function or an ObjC method declaration or a
 block.
 
 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
 
 For ObjectiveC, given
   @interface I - (void) f:(int) y; @end
 
 the matcher objcMethodDecl(hasAnyParameter(hasName("y")))
 matches the declaration of method f with hasParameter
 matching y.
 
 For blocks, given
   b = ^(int y) { printf("%d", y) };
 
 the matcher blockDecl(hasAnyParameter(hasName("y")))
 matches the declaration of the block b with hasParameter
 matching y.
 
Matcher<BlockDecl>hasParameterunsigned N, Matcher<ParmVarDecl> InnerMatcher
Matches the n'th parameter of a function or an ObjC method
 declaration or a block.
 
 Given
   class X { void f(int x) {} };
 cxxMethodDecl(hasParameter(0, hasType(varDecl())))
   matches f(int x) {}
 with hasParameter(...)
   matching int x
 
 For ObjectiveC, given
   @interface I - (void) f:(int) y; @end
 
 the matcher objcMethodDecl(hasParameter(0, hasName("y")))
 matches the declaration of method f with hasParameter
 matching y.
 
Matcher<BlockDecl>hasTypeLocMatcher<TypeLoc> Inner
Matches if the type location of a node matches the inner matcher.
 
 Examples:
   int x;
 declaratorDecl(hasTypeLoc(loc(asString("int"))))
   matches int x
 
 auto x = int(3);
 cxxTemporaryObjectExpr(hasTypeLoc(loc(asString("int"))))
   matches int(3)
 
 struct Foo { Foo(int, int); };
 auto x = Foo(1, 2);
 cxxFunctionalCastExpr(hasTypeLoc(loc(asString("struct Foo"))))
   matches Foo(1, 2)
 
 Usable as: Matcher<BlockDecl>, Matcher<CXXBaseSpecifier>,
   Matcher<CXXCtorInitializer>, Matcher<CXXFunctionalCastExpr>,
   Matcher<CXXNewExpr>, Matcher<CXXTemporaryObjectExpr>,
   Matcher<CXXUnresolvedConstructExpr>,
   Matcher<ClassTemplateSpecializationDecl>, Matcher<CompoundLiteralExpr>,
   Matcher<DeclaratorDecl>, Matcher<ExplicitCastExpr>,
   Matcher<ObjCPropertyDecl>, Matcher<TemplateArgumentLoc>,
   Matcher<TypedefNameDecl>
 
Matcher<BlockPointerType>pointeeMatcher<Type>
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>
 
Matcher<CXXBaseSpecifier>hasTypeLocMatcher<TypeLoc> Inner
Matches if the type location of a node matches the inner matcher.
 
 Examples:
   int x;
 declaratorDecl(hasTypeLoc(loc(asString("int"))))
   matches int x
 
 auto x = int(3);
 cxxTemporaryObjectExpr(hasTypeLoc(loc(asString("int"))))
   matches int(3)
 
 struct Foo { Foo(int, int); };
 auto x = Foo(1, 2);
 cxxFunctionalCastExpr(hasTypeLoc(loc(asString("struct Foo"))))
   matches Foo(1, 2)
 
 Usable as: Matcher<BlockDecl>, Matcher<CXXBaseSpecifier>,
   Matcher<CXXCtorInitializer>, Matcher<CXXFunctionalCastExpr>,
   Matcher<CXXNewExpr>, Matcher<CXXTemporaryObjectExpr>,
   Matcher<CXXUnresolvedConstructExpr>,
   Matcher<ClassTemplateSpecializationDecl>, Matcher<CompoundLiteralExpr>,
   Matcher<DeclaratorDecl>, Matcher<ExplicitCastExpr>,
   Matcher<ObjCPropertyDecl>, Matcher<TemplateArgumentLoc>,
   Matcher<TypedefNameDecl>
 
Matcher<CXXBaseSpecifier>hasTypeMatcher<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")))))
             and friend class X (matcher = friendDecl(hasType("X"))
             and public virtual X (matcher = cxxBaseSpecifier(hasType(
                                               cxxRecordDecl(hasName("X"))))
  class X {};
  void y(X &x) { x; X z; }
  class Y { friend class X; };
  class Z : public virtual X {};
 
 Example matches class Derived
 (matcher = cxxRecordDecl(hasAnyBase(hasType(cxxRecordDecl(hasName("Base"))))))
 class Base {};
 class Derived : Base {};
 
 Usable as: Matcher<Expr>, Matcher<FriendDecl>, Matcher<ValueDecl>,
 Matcher<CXXBaseSpecifier>
 
Matcher<CXXBaseSpecifier>hasTypeMatcher<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")))
             and friend class X (matcher = friendDecl(hasType("X"))
             and public virtual X (matcher = cxxBaseSpecifier(hasType(
                                               asString("class X")))
  class X {};
  void y(X &x) { x; X z; }
  typedef int U;
  class Y { friend class X; };
  class Z : public virtual X {};
 
Matcher<CXXConstructExpr>forEachArgumentWithParamMatcher<Expr> ArgMatcher, 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
 
Matcher<CXXConstructExpr>forEachArgumentWithParamTypeMatcher<Expr> ArgMatcher, Matcher<QualType> ParamMatcher
Matches all arguments and their respective types for a CallExpr or
 CXXConstructExpr. It is very similar to forEachArgumentWithParam but
 it works on calls through function pointers as well.
 
 The difference is, that function pointers do not provide access to a
 ParmVarDecl, but only the QualType for each argument.
 
 Given
   void f(int i);
   int y;
   f(y);
   void (*f_ptr)(int) = f;
   f_ptr(y);
 callExpr(
   forEachArgumentWithParamType(
     declRefExpr(to(varDecl(hasName("y")))),
     qualType(isInteger()).bind("type)
 ))
   matches f(y) and f_ptr(y)
 with declRefExpr(...)
   matching int y
 and qualType(...)
   matching int
 
Matcher<CXXConstructExpr>hasAnyArgumentMatcher<Expr> InnerMatcher
Matches any argument of a call expression or a constructor call
 expression, or an ObjC-message-send 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
 
 For ObjectiveC, given
   @interface I - (void) f:(int) y; @end
   void foo(I *i) { [i f:12]; }
 objcMessageExpr(hasAnyArgument(integerLiteral(equals(12))))
   matches [i f:12]
 
Matcher<CXXConstructExpr>hasArgumentunsigned N, 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); }
 
Matcher<CXXConstructExpr>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<CXXConstructorDecl>forEachConstructorInitializerMatcher<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.
 
Matcher<CXXConstructorDecl>hasAnyConstructorInitializerMatcher<CXXCtorInitializer> InnerMatcher
Matches a constructor initializer.
 
 Given
   struct Foo {
     Foo() : foo_(1) { }
     int foo_;
   };
 cxxRecordDecl(has(cxxConstructorDecl(
   hasAnyConstructorInitializer(anything())
 )))
   record matches Foo, hasAnyConstructorInitializer matches foo_(1)
 
Matcher<CXXCtorInitializer>forFieldMatcher<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_
 
Matcher<CXXCtorInitializer>hasTypeLocMatcher<TypeLoc> Inner
Matches if the type location of a node matches the inner matcher.
 
 Examples:
   int x;
 declaratorDecl(hasTypeLoc(loc(asString("int"))))
   matches int x
 
 auto x = int(3);
 cxxTemporaryObjectExpr(hasTypeLoc(loc(asString("int"))))
   matches int(3)
 
 struct Foo { Foo(int, int); };
 auto x = Foo(1, 2);
 cxxFunctionalCastExpr(hasTypeLoc(loc(asString("struct Foo"))))
   matches Foo(1, 2)
 
 Usable as: Matcher<BlockDecl>, Matcher<CXXBaseSpecifier>,
   Matcher<CXXCtorInitializer>, Matcher<CXXFunctionalCastExpr>,
   Matcher<CXXNewExpr>, Matcher<CXXTemporaryObjectExpr>,
   Matcher<CXXUnresolvedConstructExpr>,
   Matcher<ClassTemplateSpecializationDecl>, Matcher<CompoundLiteralExpr>,
   Matcher<DeclaratorDecl>, Matcher<ExplicitCastExpr>,
   Matcher<ObjCPropertyDecl>, Matcher<TemplateArgumentLoc>,
   Matcher<TypedefNameDecl>
 
Matcher<CXXCtorInitializer>withInitializerMatcher<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)
 
Matcher<CXXDependentScopeMemberExpr>hasObjectExpressionMatcher<Expr> InnerMatcher
Matches a member expression where the object expression is matched by a
 given matcher. Implicit object expressions are included; that is, it matches
 use of implicit `this`.
 
 Given
   struct X {
     int m;
     int f(X x) { x.m; return m; }
   };
 memberExpr(hasObjectExpression(hasType(cxxRecordDecl(hasName("X")))))
   matches `x.m`, but not `m`; however,
 memberExpr(hasObjectExpression(hasType(pointsTo(
      cxxRecordDecl(hasName("X"))))))
   matches `m` (aka. `this->m`), but not `x.m`.
 
Matcher<CXXForRangeStmt>hasBodyMatcher<Stmt> InnerMatcher
Matcher<CXXForRangeStmt>hasInitStatementMatcher<Stmt> InnerMatcher
Matches selection statements with initializer.
 
 Given:
  void foo() {
    if (int i = foobar(); i > 0) {}
    switch (int i = foobar(); i) {}
    for (auto& a = get_range(); auto& x : a) {}
  }
  void bar() {
    if (foobar() > 0) {}
    switch (foobar()) {}
    for (auto& x : get_range()) {}
  }
 ifStmt(hasInitStatement(anything()))
   matches the if statement in foo but not in bar.
 switchStmt(hasInitStatement(anything()))
   matches the switch statement in foo but not in bar.
 cxxForRangeStmt(hasInitStatement(anything()))
   matches the range for statement in foo but not in bar.
 
Matcher<CXXForRangeStmt>hasLoopVariableMatcher<VarDecl> InnerMatcher
Matches the initialization statement of a for loop.
 
 Example:
     forStmt(hasLoopVariable(anything()))
 matches 'int x' in
     for (int x : a) { }
 
Matcher<CXXForRangeStmt>hasRangeInitMatcher<Expr> InnerMatcher
Matches the range initialization statement of a for loop.
 
 Example:
     forStmt(hasRangeInit(anything()))
 matches 'a' in
     for (int x : a) { }
 
Matcher<CXXFunctionalCastExpr>hasTypeLocMatcher<TypeLoc> Inner
Matches if the type location of a node matches the inner matcher.
 
 Examples:
   int x;
 declaratorDecl(hasTypeLoc(loc(asString("int"))))
   matches int x
 
 auto x = int(3);
 cxxTemporaryObjectExpr(hasTypeLoc(loc(asString("int"))))
   matches int(3)
 
 struct Foo { Foo(int, int); };
 auto x = Foo(1, 2);
 cxxFunctionalCastExpr(hasTypeLoc(loc(asString("struct Foo"))))
   matches Foo(1, 2)
 
 Usable as: Matcher<BlockDecl>, Matcher<CXXBaseSpecifier>,
   Matcher<CXXCtorInitializer>, Matcher<CXXFunctionalCastExpr>,
   Matcher<CXXNewExpr>, Matcher<CXXTemporaryObjectExpr>,
   Matcher<CXXUnresolvedConstructExpr>,
   Matcher<ClassTemplateSpecializationDecl>, Matcher<CompoundLiteralExpr>,
   Matcher<DeclaratorDecl>, Matcher<ExplicitCastExpr>,
   Matcher<ObjCPropertyDecl>, Matcher<TemplateArgumentLoc>,
   Matcher<TypedefNameDecl>
 
Matcher<CXXMemberCallExpr>onImplicitObjectArgumentMatcher<Expr> InnerMatcher
Matches on the implicit object argument of a member call expression. Unlike
 `on`, matches the argument directly without stripping away anything.
 
 Given
   class Y { public: void m(); };
   Y g();
   class X : public Y { void g(); };
   void z(Y y, X x) { y.m(); x.m(); x.g(); (g()).m(); }
 cxxMemberCallExpr(onImplicitObjectArgument(hasType(
     cxxRecordDecl(hasName("Y")))))
   matches `y.m()`, `x.m()` and (g()).m(), but not `x.g()`.
 cxxMemberCallExpr(on(callExpr()))
   does not match `(g()).m()`, because the parens are not ignored.
 
 FIXME: Overload to allow directly matching types?
 
Matcher<CXXMemberCallExpr>onMatcher<Expr> InnerMatcher
Matches on the implicit object argument of a member call expression, after
 stripping off any parentheses or implicit casts.
 
 Given
   class Y { public: void m(); };
   Y g();
   class X : public Y {};
   void z(Y y, X x) { y.m(); (g()).m(); x.m(); }
 cxxMemberCallExpr(on(hasType(cxxRecordDecl(hasName("Y")))))
   matches `y.m()` and `(g()).m()`.
 cxxMemberCallExpr(on(hasType(cxxRecordDecl(hasName("X")))))
   matches `x.m()`.
 cxxMemberCallExpr(on(callExpr()))
   matches `(g()).m()`.
 
 FIXME: Overload to allow directly matching types?
 
Matcher<CXXMemberCallExpr>thisPointerTypeMatcher<Decl> InnerMatcher
Overloaded to match the type's declaration.
 
Matcher<CXXMemberCallExpr>thisPointerTypeMatcher<QualType> InnerMatcher
Matches if the type of the expression's implicit object argument either
 matches the InnerMatcher, or is a pointer to a type that matches the
 InnerMatcher.
 
 Given
   class Y { public: void m(); };
   class X : public Y { void g(); };
   void z() { Y y; y.m(); Y *p; p->m(); X x; x.m(); x.g(); }
 cxxMemberCallExpr(thisPointerType(hasDeclaration(
     cxxRecordDecl(hasName("Y")))))
   matches `y.m()`, `p->m()` and `x.m()`.
 cxxMemberCallExpr(thisPointerType(hasDeclaration(
     cxxRecordDecl(hasName("X")))))
   matches `x.g()`.
 
Matcher<CXXMethodDecl>forEachOverriddenMatcher<CXXMethodDecl> InnerMatcher
Matches each method overridden 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".
 
Matcher<CXXMethodDecl>ofClassMatcher<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();
 
Matcher<CXXNewExpr>hasAnyPlacementArgMatcher<Expr> InnerMatcher
Matches any placement new expression arguments.
 
 Given:
   MyClass *p1 = new (Storage) MyClass();
 cxxNewExpr(hasAnyPlacementArg(anything()))
   matches the expression 'new (Storage, 16) MyClass()'.
 
Matcher<CXXNewExpr>hasArraySizeMatcher<Expr> InnerMatcher
Matches array new expressions with a given array size.
 
 Given:
   MyClass *p1 = new MyClass[10];
 cxxNewExpr(hasArraySize(integerLiteral(equals(10))))
   matches the expression 'new MyClass[10]'.
 
Matcher<CXXNewExpr>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<CXXNewExpr>hasPlacementArgunsigned Index, Matcher<Expr> InnerMatcher
Matches placement new expression arguments.
 
 Given:
   MyClass *p1 = new (Storage, 16) MyClass();
 cxxNewExpr(hasPlacementArg(1, integerLiteral(equals(16))))
   matches the expression 'new (Storage, 16) MyClass()'.
 
Matcher<CXXNewExpr>hasTypeLocMatcher<TypeLoc> Inner
Matches if the type location of a node matches the inner matcher.
 
 Examples:
   int x;
 declaratorDecl(hasTypeLoc(loc(asString("int"))))
   matches int x
 
 auto x = int(3);
 cxxTemporaryObjectExpr(hasTypeLoc(loc(asString("int"))))
   matches int(3)
 
 struct Foo { Foo(int, int); };
 auto x = Foo(1, 2);
 cxxFunctionalCastExpr(hasTypeLoc(loc(asString("struct Foo"))))
   matches Foo(1, 2)
 
 Usable as: Matcher<BlockDecl>, Matcher<CXXBaseSpecifier>,
   Matcher<CXXCtorInitializer>, Matcher<CXXFunctionalCastExpr>,
   Matcher<CXXNewExpr>, Matcher<CXXTemporaryObjectExpr>,
   Matcher<CXXUnresolvedConstructExpr>,
   Matcher<ClassTemplateSpecializationDecl>, Matcher<CompoundLiteralExpr>,
   Matcher<DeclaratorDecl>, Matcher<ExplicitCastExpr>,
   Matcher<ObjCPropertyDecl>, Matcher<TemplateArgumentLoc>,
   Matcher<TypedefNameDecl>
 
Matcher<CXXOperatorCallExpr>hasEitherOperandMatcher<Expr> InnerMatcher
Matches if either the left hand side or the right hand side of a
 binary operator matches.
 
Matcher<CXXOperatorCallExpr>hasLHSMatcher<Expr> InnerMatcher
Matches the left hand side of binary operator expressions.
 
 Example matches a (matcher = binaryOperator(hasLHS()))
   a || b
 
Matcher<CXXOperatorCallExpr>hasOperandsMatcher<Expr> Matcher1, Matcher<Expr> Matcher2
Matches if both matchers match with opposite sides of the binary operator.
 
 Example matcher = binaryOperator(hasOperands(integerLiteral(equals(1),
                                              integerLiteral(equals(2)))
   1 + 2 // Match
   2 + 1 // Match
   1 + 1 // No match
   2 + 2 // No match
 
Matcher<CXXOperatorCallExpr>hasRHSMatcher<Expr> InnerMatcher
Matches the right hand side of binary operator expressions.
 
 Example matches b (matcher = binaryOperator(hasRHS()))
   a || b
 
Matcher<CXXOperatorCallExpr>hasUnaryOperandMatcher<Expr> InnerMatcher
Matches if the operand of a unary operator matches.
 
 Example matches true (matcher = hasUnaryOperand(
                                   cxxBoolLiteral(equals(true))))
   !true
 
Matcher<CXXRecordDecl>hasAnyBaseMatcher<CXXBaseSpecifier> BaseSpecMatcher
Matches C++ classes that have a direct or indirect base matching BaseSpecMatcher.
 
 Example:
 matcher hasAnyBase(hasType(cxxRecordDecl(hasName("SpecialBase"))))
   class Foo;
   class Bar : Foo {};
   class Baz : Bar {};
   class SpecialBase;
   class Proxy : SpecialBase {};  // matches Proxy
   class IndirectlyDerived : Proxy {};  //matches IndirectlyDerived
 
 FIXME: Refactor this and isDerivedFrom to reuse implementation.
 
Matcher<CXXRecordDecl>hasDirectBaseMatcher<CXXBaseSpecifier> BaseSpecMatcher
Matches C++ classes that have a direct base matching BaseSpecMatcher.
 
 Example:
 matcher hasDirectBase(hasType(cxxRecordDecl(hasName("SpecialBase"))))
   class Foo;
   class Bar : Foo {};
   class Baz : Bar {};
   class SpecialBase;
   class Proxy : SpecialBase {};  // matches Proxy
   class IndirectlyDerived : Proxy {};  // doesn't match
 
Matcher<CXXRecordDecl>hasMethodMatcher<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.
 
Matcher<CXXRecordDecl>isDerivedFromMatcher<NamedDecl> Base
Matches C++ classes that are directly or indirectly derived from a class
 matching Base, or Objective-C classes that directly or indirectly
 subclass 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
 
 In the following example, Bar matches isDerivedFrom(hasName("NSObject"))
   @interface NSObject @end
   @interface Bar : NSObject @end
 
 Usable as: Matcher<CXXRecordDecl>, Matcher<ObjCInterfaceDecl>
 
Matcher<CXXRecordDecl>isDirectlyDerivedFromMatcher<NamedDecl> Base
Matches C++ or Objective-C classes that are directly derived from a class
 matching Base.
 
 Note that a class is not considered to be derived from itself.
 
 Example matches Y, 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
 
Matcher<CXXRecordDecl>isSameOrDerivedFromMatcher<NamedDecl> Base
Similar to isDerivedFrom(), but also matches classes that directly
 match Base.
 
Matcher<CXXRewrittenBinaryOperator>hasEitherOperandMatcher<Expr> InnerMatcher
Matches if either the left hand side or the right hand side of a
 binary operator matches.
 
Matcher<CXXRewrittenBinaryOperator>hasLHSMatcher<Expr> InnerMatcher
Matches the left hand side of binary operator expressions.
 
 Example matches a (matcher = binaryOperator(hasLHS()))
   a || b
 
Matcher<CXXRewrittenBinaryOperator>hasOperandsMatcher<Expr> Matcher1, Matcher<Expr> Matcher2
Matches if both matchers match with opposite sides of the binary operator.
 
 Example matcher = binaryOperator(hasOperands(integerLiteral(equals(1),
                                              integerLiteral(equals(2)))
   1 + 2 // Match
   2 + 1 // Match
   1 + 1 // No match
   2 + 2 // No match
 
Matcher<CXXRewrittenBinaryOperator>hasRHSMatcher<Expr> InnerMatcher
Matches the right hand side of binary operator expressions.
 
 Example matches b (matcher = binaryOperator(hasRHS()))
   a || b
 
Matcher<CXXTemporaryObjectExpr>hasTypeLocMatcher<TypeLoc> Inner
Matches if the type location of a node matches the inner matcher.
 
 Examples:
   int x;
 declaratorDecl(hasTypeLoc(loc(asString("int"))))
   matches int x
 
 auto x = int(3);
 cxxTemporaryObjectExpr(hasTypeLoc(loc(asString("int"))))
   matches int(3)
 
 struct Foo { Foo(int, int); };
 auto x = Foo(1, 2);
 cxxFunctionalCastExpr(hasTypeLoc(loc(asString("struct Foo"))))
   matches Foo(1, 2)
 
 Usable as: Matcher<BlockDecl>, Matcher<CXXBaseSpecifier>,
   Matcher<CXXCtorInitializer>, Matcher<CXXFunctionalCastExpr>,
   Matcher<CXXNewExpr>, Matcher<CXXTemporaryObjectExpr>,
   Matcher<CXXUnresolvedConstructExpr>,
   Matcher<ClassTemplateSpecializationDecl>, Matcher<CompoundLiteralExpr>,
   Matcher<DeclaratorDecl>, Matcher<ExplicitCastExpr>,
   Matcher<ObjCPropertyDecl>, Matcher<TemplateArgumentLoc>,
   Matcher<TypedefNameDecl>
 
Matcher<CXXUnresolvedConstructExpr>hasAnyArgumentMatcher<Expr> InnerMatcher
Matches any argument of a call expression or a constructor call
 expression, or an ObjC-message-send 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
 
 For ObjectiveC, given
   @interface I - (void) f:(int) y; @end
   void foo(I *i) { [i f:12]; }
 objcMessageExpr(hasAnyArgument(integerLiteral(equals(12))))
   matches [i f:12]
 
Matcher<CXXUnresolvedConstructExpr>hasArgumentunsigned N, 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); }
 
Matcher<CXXUnresolvedConstructExpr>hasTypeLocMatcher<TypeLoc> Inner
Matches if the type location of a node matches the inner matcher.
 
 Examples:
   int x;
 declaratorDecl(hasTypeLoc(loc(asString("int"))))
   matches int x
 
 auto x = int(3);
 cxxTemporaryObjectExpr(hasTypeLoc(loc(asString("int"))))
   matches int(3)
 
 struct Foo { Foo(int, int); };
 auto x = Foo(1, 2);
 cxxFunctionalCastExpr(hasTypeLoc(loc(asString("struct Foo"))))
   matches Foo(1, 2)
 
 Usable as: Matcher<BlockDecl>, Matcher<CXXBaseSpecifier>,
   Matcher<CXXCtorInitializer>, Matcher<CXXFunctionalCastExpr>,
   Matcher<CXXNewExpr>, Matcher<CXXTemporaryObjectExpr>,
   Matcher<CXXUnresolvedConstructExpr>,
   Matcher<ClassTemplateSpecializationDecl>, Matcher<CompoundLiteralExpr>,
   Matcher<DeclaratorDecl>, Matcher<ExplicitCastExpr>,
   Matcher<ObjCPropertyDecl>, Matcher<TemplateArgumentLoc>,
   Matcher<TypedefNameDecl>
 
Matcher<CallExpr>calleeMatcher<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(); }
 
Matcher<CallExpr>calleeMatcher<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.
 
Matcher<CallExpr>forEachArgumentWithParamMatcher<Expr> ArgMatcher, 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
 
Matcher<CallExpr>forEachArgumentWithParamTypeMatcher<Expr> ArgMatcher, Matcher<QualType> ParamMatcher
Matches all arguments and their respective types for a CallExpr or
 CXXConstructExpr. It is very similar to forEachArgumentWithParam but
 it works on calls through function pointers as well.
 
 The difference is, that function pointers do not provide access to a
 ParmVarDecl, but only the QualType for each argument.
 
 Given
   void f(int i);
   int y;
   f(y);
   void (*f_ptr)(int) = f;
   f_ptr(y);
 callExpr(
   forEachArgumentWithParamType(
     declRefExpr(to(varDecl(hasName("y")))),
     qualType(isInteger()).bind("type)
 ))
   matches f(y) and f_ptr(y)
 with declRefExpr(...)
   matching int y
 and qualType(...)
   matching int
 
Matcher<CallExpr>hasAnyArgumentMatcher<Expr> InnerMatcher
Matches any argument of a call expression or a constructor call
 expression, or an ObjC-message-send 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
 
 For ObjectiveC, given
   @interface I - (void) f:(int) y; @end
   void foo(I *i) { [i f:12]; }
 objcMessageExpr(hasAnyArgument(integerLiteral(equals(12))))
   matches [i f:12]
 
Matcher<CallExpr>hasArgumentunsigned N, 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); }
 
Matcher<CallExpr>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<CaseStmt>hasCaseConstantMatcher<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:"
 
Matcher<CastExpr>hasSourceExpressionMatcher<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;
 
Matcher<ClassTemplateSpecializationDecl>hasAnyTemplateArgumentMatcher<TemplateArgument> InnerMatcher
Matches classTemplateSpecializations, templateSpecializationType and
 functionDecl that have at least one TemplateArgument matching the given
 InnerMatcher.
 
 Given
   template<typename T> class A {};
   template<> class A<double> {};
   A<int> a;
 
   template<typename T> f() {};
   void func() { f<int>(); };
 
 classTemplateSpecializationDecl(hasAnyTemplateArgument(
     refersToType(asString("int"))))
   matches the specialization A<int>
 
 functionDecl(hasAnyTemplateArgument(refersToType(asString("int"))))
   matches the specialization f<int>
 
Matcher<ClassTemplateSpecializationDecl>hasSpecializedTemplateMatcher<ClassTemplateDecl> InnerMatcher
Matches the specialized template of a specialization declaration.
 
 Given
   template<typename T> class A {}; #1
   template<> class A<int> {}; #2
 classTemplateSpecializationDecl(hasSpecializedTemplate(classTemplateDecl()))
   matches '#2' with classTemplateDecl() matching the class template
   declaration of 'A' at #1.
 
Matcher<ClassTemplateSpecializationDecl>hasTemplateArgumentunsigned N, Matcher<TemplateArgument> InnerMatcher
Matches classTemplateSpecializations, templateSpecializationType and
 functionDecl 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;
 
   template<typename T> void f() {}
   void func() { f<int>(); };
 classTemplateSpecializationDecl(hasTemplateArgument(
     1, refersToType(asString("int"))))
   matches the specialization A<bool, int>
 
 functionDecl(hasTemplateArgument(0, refersToType(asString("int"))))
   matches the specialization f<int>
 
Matcher<ClassTemplateSpecializationDecl>hasTypeLocMatcher<TypeLoc> Inner
Matches if the type location of a node matches the inner matcher.
 
 Examples:
   int x;
 declaratorDecl(hasTypeLoc(loc(asString("int"))))
   matches int x
 
 auto x = int(3);
 cxxTemporaryObjectExpr(hasTypeLoc(loc(asString("int"))))
   matches int(3)
 
 struct Foo { Foo(int, int); };
 auto x = Foo(1, 2);
 cxxFunctionalCastExpr(hasTypeLoc(loc(asString("struct Foo"))))
   matches Foo(1, 2)
 
 Usable as: Matcher<BlockDecl>, Matcher<CXXBaseSpecifier>,
   Matcher<CXXCtorInitializer>, Matcher<CXXFunctionalCastExpr>,
   Matcher<CXXNewExpr>, Matcher<CXXTemporaryObjectExpr>,
   Matcher<CXXUnresolvedConstructExpr>,
   Matcher<ClassTemplateSpecializationDecl>, Matcher<CompoundLiteralExpr>,
   Matcher<DeclaratorDecl>, Matcher<ExplicitCastExpr>,
   Matcher<ObjCPropertyDecl>, Matcher<TemplateArgumentLoc>,
   Matcher<TypedefNameDecl>
 
Matcher<ComplexType>hasElementTypeMatcher<Type>
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>
 
Matcher<CompoundLiteralExpr>hasTypeLocMatcher<TypeLoc> Inner
Matches if the type location of a node matches the inner matcher.
 
 Examples:
   int x;
 declaratorDecl(hasTypeLoc(loc(asString("int"))))
   matches int x
 
 auto x = int(3);
 cxxTemporaryObjectExpr(hasTypeLoc(loc(asString("int"))))
   matches int(3)
 
 struct Foo { Foo(int, int); };
 auto x = Foo(1, 2);
 cxxFunctionalCastExpr(hasTypeLoc(loc(asString("struct Foo"))))
   matches Foo(1, 2)
 
 Usable as: Matcher<BlockDecl>, Matcher<CXXBaseSpecifier>,
   Matcher<CXXCtorInitializer>, Matcher<CXXFunctionalCastExpr>,
   Matcher<CXXNewExpr>, Matcher<CXXTemporaryObjectExpr>,
   Matcher<CXXUnresolvedConstructExpr>,
   Matcher<ClassTemplateSpecializationDecl>, Matcher<CompoundLiteralExpr>,
   Matcher<DeclaratorDecl>, Matcher<ExplicitCastExpr>,
   Matcher<ObjCPropertyDecl>, Matcher<TemplateArgumentLoc>,
   Matcher<TypedefNameDecl>
 
Matcher<CompoundStmt>hasAnySubstatementMatcher<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 '{}'
 
Matcher<DecayedType>hasDecayedTypeMatcher<QualType> InnerType
Matches the decayed type, whoes decayed type matches InnerMatcher
 
Matcher<DeclRefExpr>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<DeclRefExpr>throughUsingDeclMatcher<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()
 
Matcher<DeclRefExpr>toMatcher<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) {}
 
Matcher<DeclStmt>containsDeclarationunsigned N, 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.
 
Matcher<DeclStmt>hasSingleDeclMatcher<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;'.
 
Matcher<DeclaratorDecl>hasTypeLocMatcher<TypeLoc> Inner
Matches if the type location of a node matches the inner matcher.
 
 Examples:
   int x;
 declaratorDecl(hasTypeLoc(loc(asString("int"))))
   matches int x
 
 auto x = int(3);
 cxxTemporaryObjectExpr(hasTypeLoc(loc(asString("int"))))
   matches int(3)
 
 struct Foo { Foo(int, int); };
 auto x = Foo(1, 2);
 cxxFunctionalCastExpr(hasTypeLoc(loc(asString("struct Foo"))))
   matches Foo(1, 2)
 
 Usable as: Matcher<BlockDecl>, Matcher<CXXBaseSpecifier>,
   Matcher<CXXCtorInitializer>, Matcher<CXXFunctionalCastExpr>,
   Matcher<CXXNewExpr>, Matcher<CXXTemporaryObjectExpr>,
   Matcher<CXXUnresolvedConstructExpr>,
   Matcher<ClassTemplateSpecializationDecl>, Matcher<CompoundLiteralExpr>,
   Matcher<DeclaratorDecl>, Matcher<ExplicitCastExpr>,
   Matcher<ObjCPropertyDecl>, Matcher<TemplateArgumentLoc>,
   Matcher<TypedefNameDecl>
 
Matcher<Decl>hasDeclContextMatcher<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.
 
Matcher<DecltypeType>hasUnderlyingTypeMatcher<Type>
Matches DecltypeType nodes to find out the underlying type.
 
 Given
   decltype(1) a = 1;
   decltype(2.0) b = 2.0;
 decltypeType(hasUnderlyingType(isInteger()))
   matches the type of "a"
 
 Usable as: Matcher<DecltypeType>
 
Matcher<DecompositionDecl>hasAnyBindingMatcher<BindingDecl> InnerMatcher
Matches any binding of a DecompositionDecl.
 
 For example, in:
 void foo()
 {
     int arr[3];
     auto &[f, s, t] = arr;
 
     f = 42;
 }
 The matcher:
   decompositionDecl(hasAnyBinding(bindingDecl(hasName("f").bind("fBinding"))))
 matches the decomposition decl with 'f' bound to "fBinding".
 
Matcher<DecompositionDecl>hasBindingunsigned N, Matcher<BindingDecl> InnerMatcher
Matches the Nth binding of a DecompositionDecl.
 
 For example, in:
 void foo()
 {
     int arr[3];
     auto &[f, s, t] = arr;
 
     f = 42;
 }
 The matcher:
   decompositionDecl(hasBinding(0,
   bindingDecl(hasName("f").bind("fBinding"))))
 matches the decomposition decl with 'f' bound to "fBinding".
 
Matcher<DoStmt>hasBodyMatcher<Stmt> InnerMatcher
Matcher<DoStmt>hasConditionMatcher<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) {}
 
Matcher<ElaboratedType>hasQualifierMatcher<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.
 
Matcher<ElaboratedType>namesTypeMatcher<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.
 
Matcher<EnumType>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<ExplicitCastExpr>hasDestinationTypeMatcher<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.)
 
Matcher<ExplicitCastExpr>hasTypeLocMatcher<TypeLoc> Inner
Matches if the type location of a node matches the inner matcher.
 
 Examples:
   int x;
 declaratorDecl(hasTypeLoc(loc(asString("int"))))
   matches int x
 
 auto x = int(3);
 cxxTemporaryObjectExpr(hasTypeLoc(loc(asString("int"))))
   matches int(3)
 
 struct Foo { Foo(int, int); };
 auto x = Foo(1, 2);
 cxxFunctionalCastExpr(hasTypeLoc(loc(asString("struct Foo"))))
   matches Foo(1, 2)
 
 Usable as: Matcher<BlockDecl>, Matcher<CXXBaseSpecifier>,
   Matcher<CXXCtorInitializer>, Matcher<CXXFunctionalCastExpr>,
   Matcher<CXXNewExpr>, Matcher<CXXTemporaryObjectExpr>,
   Matcher<CXXUnresolvedConstructExpr>,
   Matcher<ClassTemplateSpecializationDecl>, Matcher<CompoundLiteralExpr>,
   Matcher<DeclaratorDecl>, Matcher<ExplicitCastExpr>,
   Matcher<ObjCPropertyDecl>, Matcher<TemplateArgumentLoc>,
   Matcher<TypedefNameDecl>
 
Matcher<Expr>hasTypeMatcher<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")))))
             and friend class X (matcher = friendDecl(hasType("X"))
             and public virtual X (matcher = cxxBaseSpecifier(hasType(
                                               cxxRecordDecl(hasName("X"))))
  class X {};
  void y(X &x) { x; X z; }
  class Y { friend class X; };
  class Z : public virtual X {};
 
 Example matches class Derived
 (matcher = cxxRecordDecl(hasAnyBase(hasType(cxxRecordDecl(hasName("Base"))))))
 class Base {};
 class Derived : Base {};
 
 Usable as: Matcher<Expr>, Matcher<FriendDecl>, Matcher<ValueDecl>,
 Matcher<CXXBaseSpecifier>
 
Matcher<Expr>hasTypeMatcher<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")))
             and friend class X (matcher = friendDecl(hasType("X"))
             and public virtual X (matcher = cxxBaseSpecifier(hasType(
                                               asString("class X")))
  class X {};
  void y(X &x) { x; X z; }
  typedef int U;
  class Y { friend class X; };
  class Z : public virtual X {};
 
Matcher<Expr>ignoringElidableConstructorCallast_matchers::Matcher<Expr> InnerMatcher
Matches expressions that match InnerMatcher that are possibly wrapped in an
 elidable constructor and other corresponding bookkeeping nodes.
 
 In C++17, elidable copy constructors are no longer being generated in the
 AST as it is not permitted by the standard. They are, however, part of the
 AST in C++14 and earlier. So, a matcher must abstract over these differences
 to work in all language modes. This matcher skips elidable constructor-call
 AST nodes, `ExprWithCleanups` nodes wrapping elidable constructor-calls and
 various implicit nodes inside the constructor calls, all of which will not
 appear in the C++17 AST.
 
 Given
 
 struct H {};
 H G();
 void f() {
   H D = G();
 }
 
 ``varDecl(hasInitializer(ignoringElidableConstructorCall(callExpr())))``
 matches ``H D = G()`` in C++11 through C++17 (and beyond).
 
Matcher<Expr>ignoringImpCastsMatcher<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.
+only match the declarations for a.
 
Matcher<Expr>ignoringImplicitMatcher<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.
 
Matcher<Expr>ignoringParenCastsMatcher<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.
 
Matcher<Expr>ignoringParenImpCastsMatcher<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.
 
Matcher<Expr>ignoringParensMatcher<Expr> InnerMatcher
Overload ignoringParens for Expr.
 
 Given
   const char* str = ("my-string");
 The matcher
   implicitCastExpr(hasSourceExpression(ignoringParens(stringLiteral())))
 would match the implicit cast resulting from the assignment.
 
Matcher<FieldDecl>hasInClassInitializerMatcher<Expr> InnerMatcher
Matches non-static data members that have an in-class initializer.
 
 Given
   class C {
     int a = 2;
     int b = 3;
     int c;
   };
 fieldDecl(hasInClassInitializer(integerLiteral(equals(2))))
   matches 'int a;' but not 'int b;'.
 fieldDecl(hasInClassInitializer(anything()))
   matches 'int a;' and 'int b;' but not 'int c;'.
 
Matcher<ForStmt>hasBodyMatcher<Stmt> InnerMatcher
Matcher<ForStmt>hasConditionMatcher<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) {}
 
Matcher<ForStmt>hasIncrementMatcher<Stmt> InnerMatcher
Matches the increment statement of a for loop.
 
 Example:
     forStmt(hasIncrement(unaryOperator(hasOperatorName("++"))))
 matches '++x' in
     for (x; x < N; ++x) { }
 
Matcher<ForStmt>hasLoopInitMatcher<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) { }
 
Matcher<FriendDecl>hasTypeMatcher<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")))))
             and friend class X (matcher = friendDecl(hasType("X"))
             and public virtual X (matcher = cxxBaseSpecifier(hasType(
                                               cxxRecordDecl(hasName("X"))))
  class X {};
  void y(X &x) { x; X z; }
  class Y { friend class X; };
  class Z : public virtual X {};
 
 Example matches class Derived
 (matcher = cxxRecordDecl(hasAnyBase(hasType(cxxRecordDecl(hasName("Base"))))))
 class Base {};
 class Derived : Base {};
 
 Usable as: Matcher<Expr>, Matcher<FriendDecl>, Matcher<ValueDecl>,
 Matcher<CXXBaseSpecifier>
 
Matcher<FriendDecl>hasTypeMatcher<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")))
             and friend class X (matcher = friendDecl(hasType("X"))
             and public virtual X (matcher = cxxBaseSpecifier(hasType(
                                               asString("class X")))
  class X {};
  void y(X &x) { x; X z; }
  typedef int U;
  class Y { friend class X; };
  class Z : public virtual X {};
 
Matcher<FunctionDecl>hasAnyBodyMatcher<Stmt> InnerMatcher
Matches a function declaration that has a given body present in the AST.
 Note that this matcher matches all the declarations of a function whose
 body is present in the AST.
 
 Given
   void f();
   void f() {}
   void g();
 functionDecl(hasAnyBody(compoundStmt()))
   matches both 'void f();'
   and 'void f() {}'
 with compoundStmt()
   matching '{}'
   but does not match 'void g();'
 
Matcher<FunctionDecl>hasAnyParameterMatcher<ParmVarDecl> InnerMatcher
Matches any parameter of a function or an ObjC method declaration or a
 block.
 
 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
 
 For ObjectiveC, given
   @interface I - (void) f:(int) y; @end
 
 the matcher objcMethodDecl(hasAnyParameter(hasName("y")))
 matches the declaration of method f with hasParameter
 matching y.
 
 For blocks, given
   b = ^(int y) { printf("%d", y) };
 
 the matcher blockDecl(hasAnyParameter(hasName("y")))
 matches the declaration of the block b with hasParameter
 matching y.
 
Matcher<FunctionDecl>hasAnyTemplateArgumentMatcher<TemplateArgument> InnerMatcher
Matches classTemplateSpecializations, templateSpecializationType and
 functionDecl that have at least one TemplateArgument matching the given
 InnerMatcher.
 
 Given
   template<typename T> class A {};
   template<> class A<double> {};
   A<int> a;
 
   template<typename T> f() {};
   void func() { f<int>(); };
 
 classTemplateSpecializationDecl(hasAnyTemplateArgument(
     refersToType(asString("int"))))
   matches the specialization A<int>
 
 functionDecl(hasAnyTemplateArgument(refersToType(asString("int"))))
   matches the specialization f<int>
 
Matcher<FunctionDecl>hasBodyMatcher<Stmt> InnerMatcher
Matcher<FunctionDecl>hasExplicitSpecifierMatcher<Expr> InnerMatcher
Matches the expression in an explicit specifier if present in the given
 declaration.
 
 Given
   template<bool b>
   struct S {
     S(int); // #1
     explicit S(double); // #2
     operator int(); // #3
     explicit operator bool(); // #4
     explicit(false) S(bool) // # 7
     explicit(true) S(char) // # 8
     explicit(b) S(S) // # 9
   };
   S(int) -> S<true> // #5
   explicit S(double) -> S<false> // #6
 cxxConstructorDecl(hasExplicitSpecifier(constantExpr())) will match #7, #8 and #9, but not #1 or #2.
 cxxConversionDecl(hasExplicitSpecifier(constantExpr())) will not match #3 or #4.
 cxxDeductionGuideDecl(hasExplicitSpecifier(constantExpr())) will not match #5 or #6.
 
Matcher<FunctionDecl>hasParameterunsigned N, Matcher<ParmVarDecl> InnerMatcher
Matches the n'th parameter of a function or an ObjC method
 declaration or a block.
 
 Given
   class X { void f(int x) {} };
 cxxMethodDecl(hasParameter(0, hasType(varDecl())))
   matches f(int x) {}
 with hasParameter(...)
   matching int x
 
 For ObjectiveC, given
   @interface I - (void) f:(int) y; @end
 
 the matcher objcMethodDecl(hasParameter(0, hasName("y")))
 matches the declaration of method f with hasParameter
 matching y.
 
Matcher<FunctionDecl>hasTemplateArgumentunsigned N, Matcher<TemplateArgument> InnerMatcher
Matches classTemplateSpecializations, templateSpecializationType and
 functionDecl 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;
 
   template<typename T> void f() {}
   void func() { f<int>(); };
 classTemplateSpecializationDecl(hasTemplateArgument(
     1, refersToType(asString("int"))))
   matches the specialization A<bool, int>
 
 functionDecl(hasTemplateArgument(0, refersToType(asString("int"))))
   matches the specialization f<int>
 
Matcher<FunctionDecl>returnsMatcher<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; }
 
Matcher<IfStmt>hasConditionMatcher<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) {}
 
Matcher<IfStmt>hasConditionVariableStatementMatcher<DeclStmt> InnerMatcher
Matches the condition variable statement in an if statement.
 
 Given
   if (A* a = GetAPointer()) {}
 hasConditionVariableStatement(...)
   matches 'A* a = GetAPointer()'.
 
Matcher<IfStmt>hasElseMatcher<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;
 
Matcher<IfStmt>hasInitStatementMatcher<Stmt> InnerMatcher
Matches selection statements with initializer.
 
 Given:
  void foo() {
    if (int i = foobar(); i > 0) {}
    switch (int i = foobar(); i) {}
    for (auto& a = get_range(); auto& x : a) {}
  }
  void bar() {
    if (foobar() > 0) {}
    switch (foobar()) {}
    for (auto& x : get_range()) {}
  }
 ifStmt(hasInitStatement(anything()))
   matches the if statement in foo but not in bar.
 switchStmt(hasInitStatement(anything()))
   matches the switch statement in foo but not in bar.
 cxxForRangeStmt(hasInitStatement(anything()))
   matches the range for statement in foo but not in bar.
 
Matcher<IfStmt>hasThenMatcher<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;
 
Matcher<ImplicitCastExpr>hasImplicitDestinationTypeMatcher<QualType> InnerMatcher
Matches implicit casts whose destination type matches a given
 matcher.
 
 FIXME: Unit test this matcher
 
Matcher<InitListExpr>hasInitunsigned N, ast_matchers::Matcher<Expr> InnerMatcher
Matches the n'th item of an initializer list expression.
 
 Example matches y.
     (matcher = initListExpr(hasInit(0, expr())))
   int x{y}.
 
Matcher<InitListExpr>hasSyntacticFormMatcher<Expr> InnerMatcher
Matches the syntactic form of init list expressions
 (if expression have it).
 
Matcher<InjectedClassNameType>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<LabelStmt>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<LambdaExpr>hasAnyCaptureMatcher<CXXThisExpr> InnerMatcher
Matches any capture of 'this' in a lambda expression.
 
 Given
   struct foo {
     void bar() {
       auto f = [this](){};
     }
   }
 lambdaExpr(hasAnyCapture(cxxThisExpr()))
   matches [this](){};
 
Matcher<LambdaExpr>hasAnyCaptureMatcher<VarDecl> InnerMatcher
Matches any capture of a lambda expression.
 
 Given
   void foo() {
     int x;
     auto f = [x](){};
   }
 lambdaExpr(hasAnyCapture(anything()))
   matches [x](){};
 
Matcher<MemberExpr>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<MemberExpr>hasObjectExpressionMatcher<Expr> InnerMatcher
Matches a member expression where the object expression is matched by a
 given matcher. Implicit object expressions are included; that is, it matches
 use of implicit `this`.
 
 Given
   struct X {
     int m;
     int f(X x) { x.m; return m; }
   };
 memberExpr(hasObjectExpression(hasType(cxxRecordDecl(hasName("X")))))
   matches `x.m`, but not `m`; however,
 memberExpr(hasObjectExpression(hasType(pointsTo(
      cxxRecordDecl(hasName("X"))))))
   matches `m` (aka. `this->m`), but not `x.m`.
 
Matcher<MemberExpr>memberMatcher<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").
 
Matcher<MemberPointerType>pointeeMatcher<Type>
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>
 
Matcher<NamedDecl>hasUnderlyingDeclMatcher<NamedDecl> InnerMatcher
Matches a NamedDecl whose underlying declaration matches the given
 matcher.
 
 Given
   namespace N { template<class T> void f(T t); }
   template <class T> void g() { using N::f; f(T()); }
 unresolvedLookupExpr(hasAnyDeclaration(
     namedDecl(hasUnderlyingDecl(hasName("::N::f")))))
   matches the use of f in g() .
 
Matcher<NestedNameSpecifierLoc>hasPrefixMatcher<NestedNameSpecifierLoc> InnerMatcher
Matches on the prefix of a NestedNameSpecifierLoc.
 
 Given
   struct A { struct B { struct C {}; }; };
   A::B::C c;
 nestedNameSpecifierLoc(hasPrefix(loc(specifiesType(asString("struct A")))))
   matches "A::"
 
Matcher<NestedNameSpecifierLoc>locMatcher<NestedNameSpecifier> InnerMatcher
Matches NestedNameSpecifierLocs for which the given inner
 NestedNameSpecifier-matcher matches.
 
Matcher<NestedNameSpecifierLoc>specifiesTypeLocMatcher<TypeLoc> InnerMatcher
Matches nested name specifier locs that specify a type matching the
 given TypeLoc.
 
 Given
   struct A { struct B { struct C {}; }; };
   A::B::C c;
 nestedNameSpecifierLoc(specifiesTypeLoc(loc(type(
   hasDeclaration(cxxRecordDecl(hasName("A")))))))
   matches "A::"
 
Matcher<NestedNameSpecifier>hasPrefixMatcher<NestedNameSpecifier> InnerMatcher
Matches on the prefix of a NestedNameSpecifier.
 
 Given
   struct A { struct B { struct C {}; }; };
   A::B::C c;
 nestedNameSpecifier(hasPrefix(specifiesType(asString("struct A")))) and
   matches "A::"
 
Matcher<NestedNameSpecifier>specifiesNamespaceMatcher<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::"
 
Matcher<NestedNameSpecifier>specifiesTypeMatcher<QualType> InnerMatcher
Matches nested name specifiers that specify a type matching the
 given QualType matcher without qualifiers.
 
 Given
   struct A { struct B { struct C {}; }; };
   A::B::C c;
 nestedNameSpecifier(specifiesType(
   hasDeclaration(cxxRecordDecl(hasName("A")))
 ))
   matches "A::"
 
Matcher<OMPExecutableDirective>hasAnyClauseMatcher<OMPClause> InnerMatcher
Matches any clause in an OpenMP directive.
 
 Given
 
   #pragma omp parallel
   #pragma omp parallel default(none)
 
 ``ompExecutableDirective(hasAnyClause(anything()))`` matches
 ``omp parallel default(none)``.
 
Matcher<OMPExecutableDirective>hasStructuredBlockMatcher<Stmt> InnerMatcher
Matches the structured-block of the OpenMP executable directive
 
 Prerequisite: the executable directive must not be standalone directive.
 If it is, it will never match.
 
 Given
 
    #pragma omp parallel
    ;
    #pragma omp parallel
    {}
 
 ``ompExecutableDirective(hasStructuredBlock(nullStmt()))`` will match ``;``
 
Matcher<ObjCInterfaceDecl>isDerivedFromMatcher<NamedDecl> Base
Matches C++ classes that are directly or indirectly derived from a class
 matching Base, or Objective-C classes that directly or indirectly
 subclass 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
 
 In the following example, Bar matches isDerivedFrom(hasName("NSObject"))
   @interface NSObject @end
   @interface Bar : NSObject @end
 
 Usable as: Matcher<CXXRecordDecl>, Matcher<ObjCInterfaceDecl>
 
Matcher<ObjCInterfaceDecl>isDirectlyDerivedFromMatcher<NamedDecl> Base
Matches C++ or Objective-C classes that are directly derived from a class
 matching Base.
 
 Note that a class is not considered to be derived from itself.
 
 Example matches Y, 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
 
Matcher<ObjCInterfaceDecl>isSameOrDerivedFromMatcher<NamedDecl> Base
Similar to isDerivedFrom(), but also matches classes that directly
 match Base.
 
Matcher<ObjCMessageExpr>hasAnyArgumentMatcher<Expr> InnerMatcher
Matches any argument of a call expression or a constructor call
 expression, or an ObjC-message-send 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
 
 For ObjectiveC, given
   @interface I - (void) f:(int) y; @end
   void foo(I *i) { [i f:12]; }
 objcMessageExpr(hasAnyArgument(integerLiteral(equals(12))))
   matches [i f:12]
 
Matcher<ObjCMessageExpr>hasArgumentunsigned N, 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); }
 
Matcher<ObjCMessageExpr>hasReceiverMatcher<Expr> InnerMatcher
Matches if the Objective-C message is sent to an instance,
 and the inner matcher matches on that instance.
 
 For example the method call in
   NSString *x = @"hello";
   [x containsString:@"h"];
 is matched by
 objcMessageExpr(hasReceiver(declRefExpr(to(varDecl(hasName("x"))))))
 
Matcher<ObjCMessageExpr>hasReceiverTypeMatcher<QualType> InnerMatcher
Matches on the receiver of an ObjectiveC Message expression.
 
 Example
 matcher = objCMessageExpr(hasReceiverType(asString("UIWebView *")));
 matches the [webView ...] message invocation.
   NSString *webViewJavaScript = ...
   UIWebView *webView = ...
   [webView stringByEvaluatingJavaScriptFromString:webViewJavascript];
 
Matcher<ObjCMethodDecl>hasAnyParameterMatcher<ParmVarDecl> InnerMatcher
Matches any parameter of a function or an ObjC method declaration or a
 block.
 
 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
 
 For ObjectiveC, given
   @interface I - (void) f:(int) y; @end
 
 the matcher objcMethodDecl(hasAnyParameter(hasName("y")))
 matches the declaration of method f with hasParameter
 matching y.
 
 For blocks, given
   b = ^(int y) { printf("%d", y) };
 
 the matcher blockDecl(hasAnyParameter(hasName("y")))
 matches the declaration of the block b with hasParameter
 matching y.
 
Matcher<ObjCMethodDecl>hasParameterunsigned N, Matcher<ParmVarDecl> InnerMatcher
Matches the n'th parameter of a function or an ObjC method
 declaration or a block.
 
 Given
   class X { void f(int x) {} };
 cxxMethodDecl(hasParameter(0, hasType(varDecl())))
   matches f(int x) {}
 with hasParameter(...)
   matching int x
 
 For ObjectiveC, given
   @interface I - (void) f:(int) y; @end
 
 the matcher objcMethodDecl(hasParameter(0, hasName("y")))
 matches the declaration of method f with hasParameter
 matching y.
 
Matcher<ObjCPropertyDecl>hasTypeLocMatcher<TypeLoc> Inner
Matches if the type location of a node matches the inner matcher.
 
 Examples:
   int x;
 declaratorDecl(hasTypeLoc(loc(asString("int"))))
   matches int x
 
 auto x = int(3);
 cxxTemporaryObjectExpr(hasTypeLoc(loc(asString("int"))))
   matches int(3)
 
 struct Foo { Foo(int, int); };
 auto x = Foo(1, 2);
 cxxFunctionalCastExpr(hasTypeLoc(loc(asString("struct Foo"))))
   matches Foo(1, 2)
 
 Usable as: Matcher<BlockDecl>, Matcher<CXXBaseSpecifier>,
   Matcher<CXXCtorInitializer>, Matcher<CXXFunctionalCastExpr>,
   Matcher<CXXNewExpr>, Matcher<CXXTemporaryObjectExpr>,
   Matcher<CXXUnresolvedConstructExpr>,
   Matcher<ClassTemplateSpecializationDecl>, Matcher<CompoundLiteralExpr>,
   Matcher<DeclaratorDecl>, Matcher<ExplicitCastExpr>,
   Matcher<ObjCPropertyDecl>, Matcher<TemplateArgumentLoc>,
   Matcher<TypedefNameDecl>
 
Matcher<OpaqueValueExpr>hasSourceExpressionMatcher<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;
 
Matcher<OverloadExpr>hasAnyDeclarationMatcher<Decl> InnerMatcher
Matches an OverloadExpr if any of the declarations in the set of
 overloads matches the given matcher.
 
 Given
   template <typename T> void foo(T);
   template <typename T> void bar(T);
   template <typename T> void baz(T t) {
     foo(t);
     bar(t);
   }
 unresolvedLookupExpr(hasAnyDeclaration(
     functionTemplateDecl(hasName("foo"))))
   matches foo in foo(t); but not bar in bar(t);
 
Matcher<ParenType>innerTypeMatcher<Type>
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>
 
Matcher<PointerType>pointeeMatcher<Type>
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>
 
Matcher<QualType>hasCanonicalTypeMatcher<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.
 
Matcher<QualType>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<QualType>ignoringParensMatcher<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.
 
Matcher<QualType>pointsToMatcher<Decl> InnerMatcher
Overloaded to match the pointee type's declaration.
 
Matcher<QualType>pointsToMatcher<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(); }
 
Matcher<QualType>referencesMatcher<Decl> InnerMatcher
Overloaded to match the referenced type's declaration.
 
Matcher<QualType>referencesMatcher<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;
     }
   };
 
Matcher<RecordType>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<ReferenceType>pointeeMatcher<Type>
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>
 
Matcher<ReturnStmt>hasReturnValueMatcher<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'
 
Matcher<StmtExpr>hasAnySubstatementMatcher<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 '{}'
 
Matcher<Stmt>alignOfExprMatcher<UnaryExprOrTypeTraitExpr> InnerMatcher
Same as unaryExprOrTypeTraitExpr, but only matching
 alignof.
 
Matcher<Stmt>forCallableMatcher<Decl> InnerMatcher
Matches declaration of the function, method, or block the statement
 belongs to.
 
 Given:
 F& operator=(const F& o) {
   std::copy_if(o.begin(), o.end(), begin(), [](V v) { return v > 0; });
   return *this;
 }
 returnStmt(forCallable(functionDecl(hasName("operator="))))
   matches 'return *this'
   but does not match 'return v > 0'
 
 Given:
 -(void) foo {
   int x = 1;
   dispatch_sync(queue, ^{ int y = 2; });
 }
 declStmt(forCallable(objcMethodDecl()))
   matches 'int x = 1'
   but does not match 'int y = 2'.
 whereas declStmt(forCallable(blockDecl()))
   matches 'int y = 2'
   but does not match 'int x = 1'.
 
Matcher<Stmt>forFunctionMatcher<FunctionDecl> InnerMatcher
Matches declaration of the function the statement belongs to.
 
 Deprecated. Use forCallable() to correctly handle the situation when
 the declaration is not a function (but a block or an Objective-C method).
 forFunction() not only fails to take non-functions into account but also
 may match the wrong declaration in their presence.
 
 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 not match 'return v > 0'
 
Matcher<Stmt>sizeOfExprMatcher<UnaryExprOrTypeTraitExpr> InnerMatcher
Same as unaryExprOrTypeTraitExpr, but only matching
 sizeof.
 
Matcher<SubstTemplateTypeParmType>hasReplacementTypeMatcher<Type>
Matches template type parameter substitutions that have a replacement
 type that matches the provided matcher.
 
 Given
   template <typename T>
   double F(T t);
   int i;
   double j = F(i);
 
 substTemplateTypeParmType(hasReplacementType(type())) matches int
 
Matcher<SwitchStmt>forEachSwitchCaseMatcher<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)".
 
Matcher<SwitchStmt>hasConditionMatcher<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) {}
 
Matcher<SwitchStmt>hasInitStatementMatcher<Stmt> InnerMatcher
Matches selection statements with initializer.
 
 Given:
  void foo() {
    if (int i = foobar(); i > 0) {}
    switch (int i = foobar(); i) {}
    for (auto& a = get_range(); auto& x : a) {}
  }
  void bar() {
    if (foobar() > 0) {}
    switch (foobar()) {}
    for (auto& x : get_range()) {}
  }
 ifStmt(hasInitStatement(anything()))
   matches the if statement in foo but not in bar.
 switchStmt(hasInitStatement(anything()))
   matches the switch statement in foo but not in bar.
 cxxForRangeStmt(hasInitStatement(anything()))
   matches the range for statement in foo but not in bar.
 
Matcher<TagType>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<TemplateArgumentLoc>hasTypeLocMatcher<TypeLoc> Inner
Matches if the type location of a node matches the inner matcher.
 
 Examples:
   int x;
 declaratorDecl(hasTypeLoc(loc(asString("int"))))
   matches int x
 
 auto x = int(3);
 cxxTemporaryObjectExpr(hasTypeLoc(loc(asString("int"))))
   matches int(3)
 
 struct Foo { Foo(int, int); };
 auto x = Foo(1, 2);
 cxxFunctionalCastExpr(hasTypeLoc(loc(asString("struct Foo"))))
   matches Foo(1, 2)
 
 Usable as: Matcher<BlockDecl>, Matcher<CXXBaseSpecifier>,
   Matcher<CXXCtorInitializer>, Matcher<CXXFunctionalCastExpr>,
   Matcher<CXXNewExpr>, Matcher<CXXTemporaryObjectExpr>,
   Matcher<CXXUnresolvedConstructExpr>,
   Matcher<ClassTemplateSpecializationDecl>, Matcher<CompoundLiteralExpr>,
   Matcher<DeclaratorDecl>, Matcher<ExplicitCastExpr>,
   Matcher<ObjCPropertyDecl>, Matcher<TemplateArgumentLoc>,
   Matcher<TypedefNameDecl>
 
Matcher<TemplateArgument>isExprMatcher<Expr> InnerMatcher
Matches a sugar TemplateArgument that refers to a certain expression.
 
 Given
   struct B { int next; };
   template<int(B::*next_ptr)> struct A {};
   A<&B::next> a;
 templateSpecializationType(hasAnyTemplateArgument(
   isExpr(hasDescendant(declRefExpr(to(fieldDecl(hasName("next"))))))))
   matches the specialization A<&B::next> with fieldDecl(...) matching
     B::next
 
Matcher<TemplateArgument>refersToDeclarationMatcher<Decl> InnerMatcher
Matches a canonical TemplateArgument that refers to a certain
 declaration.
 
 Given
   struct B { int next; };
   template<int(B::*next_ptr)> struct A {};
   A<&B::next> a;
 classTemplateSpecializationDecl(hasAnyTemplateArgument(
     refersToDeclaration(fieldDecl(hasName("next")))))
   matches the specialization A<&B::next> with fieldDecl(...) matching
     B::next
 
Matcher<TemplateArgument>refersToIntegralTypeMatcher<QualType> InnerMatcher
Matches a TemplateArgument that refers to an integral type.
 
 Given
   template<int T> struct C {};
   C<42> c;
 classTemplateSpecializationDecl(
   hasAnyTemplateArgument(refersToIntegralType(asString("int"))))
   matches the implicit instantiation of C in C<42>.
 
Matcher<TemplateArgument>refersToTemplateMatcher<TemplateName> InnerMatcher
Matches a TemplateArgument that refers to a certain template.
 
 Given
   template<template <typename> class S> class X {};
   template<typename T> class Y {};
   X<Y> xi;
 classTemplateSpecializationDecl(hasAnyTemplateArgument(
     refersToTemplate(templateName())))
   matches the specialization X<Y>
 
Matcher<TemplateArgument>refersToTypeMatcher<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>
 
Matcher<TemplateSpecializationType>hasAnyTemplateArgumentMatcher<TemplateArgument> InnerMatcher
Matches classTemplateSpecializations, templateSpecializationType and
 functionDecl that have at least one TemplateArgument matching the given
 InnerMatcher.
 
 Given
   template<typename T> class A {};
   template<> class A<double> {};
   A<int> a;
 
   template<typename T> f() {};
   void func() { f<int>(); };
 
 classTemplateSpecializationDecl(hasAnyTemplateArgument(
     refersToType(asString("int"))))
   matches the specialization A<int>
 
 functionDecl(hasAnyTemplateArgument(refersToType(asString("int"))))
   matches the specialization f<int>
 
Matcher<TemplateSpecializationType>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<TemplateSpecializationType>hasTemplateArgumentunsigned N, Matcher<TemplateArgument> InnerMatcher
Matches classTemplateSpecializations, templateSpecializationType and
 functionDecl 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;
 
   template<typename T> void f() {}
   void func() { f<int>(); };
 classTemplateSpecializationDecl(hasTemplateArgument(
     1, refersToType(asString("int"))))
   matches the specialization A<bool, int>
 
 functionDecl(hasTemplateArgument(0, refersToType(asString("int"))))
   matches the specialization f<int>
 
Matcher<TemplateTypeParmType>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<TypeLoc>locMatcher<QualType> InnerMatcher
Matches TypeLocs for which the given inner
 QualType-matcher matches.
 
Matcher<TypedefNameDecl>hasTypeLocMatcher<TypeLoc> Inner
Matches if the type location of a node matches the inner matcher.
 
 Examples:
   int x;
 declaratorDecl(hasTypeLoc(loc(asString("int"))))
   matches int x
 
 auto x = int(3);
 cxxTemporaryObjectExpr(hasTypeLoc(loc(asString("int"))))
   matches int(3)
 
 struct Foo { Foo(int, int); };
 auto x = Foo(1, 2);
 cxxFunctionalCastExpr(hasTypeLoc(loc(asString("struct Foo"))))
   matches Foo(1, 2)
 
 Usable as: Matcher<BlockDecl>, Matcher<CXXBaseSpecifier>,
   Matcher<CXXCtorInitializer>, Matcher<CXXFunctionalCastExpr>,
   Matcher<CXXNewExpr>, Matcher<CXXTemporaryObjectExpr>,
   Matcher<CXXUnresolvedConstructExpr>,
   Matcher<ClassTemplateSpecializationDecl>, Matcher<CompoundLiteralExpr>,
   Matcher<DeclaratorDecl>, Matcher<ExplicitCastExpr>,
   Matcher<ObjCPropertyDecl>, Matcher<TemplateArgumentLoc>,
   Matcher<TypedefNameDecl>
 
Matcher<TypedefNameDecl>hasTypeMatcher<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")))
             and friend class X (matcher = friendDecl(hasType("X"))
             and public virtual X (matcher = cxxBaseSpecifier(hasType(
                                               asString("class X")))
  class X {};
  void y(X &x) { x; X z; }
  typedef int U;
  class Y { friend class X; };
  class Z : public virtual X {};
 
Matcher<TypedefType>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<Type>hasUnqualifiedDesugaredTypeMatcher<Type> InnerMatcher
Matches if the matched type matches the unqualified desugared
 type of the matched node.
 
 For example, in:
   class A {};
   using B = A;
 The matcher type(hasUnqualifiedDesugaredType(recordType())) matches
 both B and A.
 
Matcher<UnaryExprOrTypeTraitExpr>hasArgumentOfTypeMatcher<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)
 
Matcher<UnaryOperator>hasUnaryOperandMatcher<Expr> InnerMatcher
Matches if the operand of a unary operator matches.
 
 Example matches true (matcher = hasUnaryOperand(
                                   cxxBoolLiteral(equals(true))))
   !true
 
Matcher<UnresolvedMemberExpr>hasObjectExpressionMatcher<Expr> InnerMatcher
Matches a member expression where the object expression is matched by a
 given matcher. Implicit object expressions are included; that is, it matches
 use of implicit `this`.
 
 Given
   struct X {
     int m;
     int f(X x) { x.m; return m; }
   };
 memberExpr(hasObjectExpression(hasType(cxxRecordDecl(hasName("X")))))
   matches `x.m`, but not `m`; however,
 memberExpr(hasObjectExpression(hasType(pointsTo(
      cxxRecordDecl(hasName("X"))))))
   matches `m` (aka. `this->m`), but not `x.m`.
 
Matcher<UnresolvedUsingType>hasDeclarationMatcher<Decl> InnerMatcher
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
 - for CXXNewExpr, the declaration of the operator new
 - for ObjCIvarExpr, the declaration of the ivar
 
 For type nodes, hasDeclaration will generally match the declaration of the
 sugared type. Given
   class X {};
   typedef X Y;
   Y y;
 in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
 typedefDecl. A common use case is to match the underlying, desugared type.
 This can be achieved by using the hasUnqualifiedDesugaredType matcher:
   varDecl(hasType(hasUnqualifiedDesugaredType(
       recordType(hasDeclaration(decl())))))
 In this matcher, the decl will match the CXXRecordDecl of class X.
 
 Usable as: Matcher<AddrLabelExpr>, Matcher<CallExpr>,
   Matcher<CXXConstructExpr>, Matcher<CXXNewExpr>, Matcher<DeclRefExpr>,
   Matcher<EnumType>, Matcher<InjectedClassNameType>, Matcher<LabelStmt>,
   Matcher<MemberExpr>, Matcher<QualType>, Matcher<RecordType>,
   Matcher<TagType>, Matcher<TemplateSpecializationType>,
   Matcher<TemplateTypeParmType>, Matcher<TypedefType>,
   Matcher<UnresolvedUsingType>
 
Matcher<UsingDecl>hasAnyUsingShadowDeclMatcher<UsingShadowDecl> InnerMatcher
Matches any using shadow declaration.
 
 Given
   namespace X { void b(); }
   using X::b;
 usingDecl(hasAnyUsingShadowDecl(hasName("b"))))
   matches using X::b 
Matcher<UsingShadowDecl>hasTargetDeclMatcher<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 
Matcher<ValueDecl>hasTypeMatcher<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")))))
             and friend class X (matcher = friendDecl(hasType("X"))
             and public virtual X (matcher = cxxBaseSpecifier(hasType(
                                               cxxRecordDecl(hasName("X"))))
  class X {};
  void y(X &x) { x; X z; }
  class Y { friend class X; };
  class Z : public virtual X {};
 
 Example matches class Derived
 (matcher = cxxRecordDecl(hasAnyBase(hasType(cxxRecordDecl(hasName("Base"))))))
 class Base {};
 class Derived : Base {};
 
 Usable as: Matcher<Expr>, Matcher<FriendDecl>, Matcher<ValueDecl>,
 Matcher<CXXBaseSpecifier>
 
Matcher<ValueDecl>hasTypeMatcher<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")))
             and friend class X (matcher = friendDecl(hasType("X"))
             and public virtual X (matcher = cxxBaseSpecifier(hasType(
                                               asString("class X")))
  class X {};
  void y(X &x) { x; X z; }
  typedef int U;
  class Y { friend class X; };
  class Z : public virtual X {};
 
Matcher<VarDecl>hasInitializerMatcher<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();
 
Matcher<VariableArrayType>hasSizeExprMatcher<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]"
 
Matcher<WhileStmt>hasBodyMatcher<Stmt> InnerMatcher
Matcher<WhileStmt>hasConditionMatcher<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) {}
 
diff --git a/clang/include/clang/ASTMatchers/ASTMatchers.h b/clang/include/clang/ASTMatchers/ASTMatchers.h index a13827df4405..8e3ee6cb9e7e 100644 --- a/clang/include/clang/ASTMatchers/ASTMatchers.h +++ b/clang/include/clang/ASTMatchers/ASTMatchers.h @@ -1,8017 +1,8017 @@ //===- ASTMatchers.h - Structural query framework ---------------*- C++ -*-===// // // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. // See https://llvm.org/LICENSE.txt for license information. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception // //===----------------------------------------------------------------------===// // // This file implements matchers to be used together with the MatchFinder to // match AST nodes. // // Matchers are created by generator functions, which can be combined in // a functional in-language DSL to express queries over the C++ AST. // // For example, to match a class with a certain name, one would call: // cxxRecordDecl(hasName("MyClass")) // which returns a matcher that can be used to find all AST nodes that declare // a class named 'MyClass'. // // For more complicated match expressions we're often interested in accessing // multiple parts of the matched AST nodes once a match is found. In that case, // call `.bind("name")` on match expressions that match the nodes you want to // access. // // For example, when we're interested in child classes of a certain class, we // would write: // cxxRecordDecl(hasName("MyClass"), has(recordDecl().bind("child"))) // When the match is found via the MatchFinder, a user provided callback will // be called with a BoundNodes instance that contains a mapping from the // strings that we provided for the `.bind()` calls to the nodes that were // matched. // In the given example, each time our matcher finds a match we get a callback // where "child" is bound to the RecordDecl node of the matching child // class declaration. // // See ASTMatchersInternal.h for a more in-depth explanation of the // implementation details of the matcher framework. // // See ASTMatchFinder.h for how to use the generated matchers to run over // an AST. // //===----------------------------------------------------------------------===// #ifndef LLVM_CLANG_ASTMATCHERS_ASTMATCHERS_H #define LLVM_CLANG_ASTMATCHERS_ASTMATCHERS_H #include "clang/AST/ASTContext.h" #include "clang/AST/ASTTypeTraits.h" #include "clang/AST/Attr.h" #include "clang/AST/CXXInheritance.h" #include "clang/AST/Decl.h" #include "clang/AST/DeclCXX.h" #include "clang/AST/DeclFriend.h" #include "clang/AST/DeclObjC.h" #include "clang/AST/DeclTemplate.h" #include "clang/AST/Expr.h" #include "clang/AST/ExprCXX.h" #include "clang/AST/ExprObjC.h" #include "clang/AST/LambdaCapture.h" #include "clang/AST/NestedNameSpecifier.h" #include "clang/AST/OpenMPClause.h" #include "clang/AST/OperationKinds.h" #include "clang/AST/ParentMapContext.h" #include "clang/AST/Stmt.h" #include "clang/AST/StmtCXX.h" #include "clang/AST/StmtObjC.h" #include "clang/AST/StmtOpenMP.h" #include "clang/AST/TemplateBase.h" #include "clang/AST/TemplateName.h" #include "clang/AST/Type.h" #include "clang/AST/TypeLoc.h" #include "clang/ASTMatchers/ASTMatchersInternal.h" #include "clang/ASTMatchers/ASTMatchersMacros.h" #include "clang/Basic/AttrKinds.h" #include "clang/Basic/ExceptionSpecificationType.h" #include "clang/Basic/FileManager.h" #include "clang/Basic/IdentifierTable.h" #include "clang/Basic/LLVM.h" #include "clang/Basic/SourceManager.h" #include "clang/Basic/Specifiers.h" #include "clang/Basic/TypeTraits.h" #include "llvm/ADT/ArrayRef.h" #include "llvm/ADT/SmallVector.h" #include "llvm/ADT/StringRef.h" #include "llvm/Support/Casting.h" #include "llvm/Support/Compiler.h" #include "llvm/Support/ErrorHandling.h" #include "llvm/Support/Regex.h" #include #include #include #include #include #include #include namespace clang { namespace ast_matchers { /// Maps string IDs to AST nodes matched by parts of a matcher. /// /// The bound nodes are generated by calling \c bind("id") on the node matchers /// of the nodes we want to access later. /// /// The instances of BoundNodes are created by \c MatchFinder when the user's /// callbacks are executed every time a match is found. class BoundNodes { public: /// Returns the AST node bound to \c ID. /// /// Returns NULL if there was no node bound to \c ID or if there is a node but /// it cannot be converted to the specified type. template const T *getNodeAs(StringRef ID) const { return MyBoundNodes.getNodeAs(ID); } /// Type of mapping from binding identifiers to bound nodes. This type /// is an associative container with a key type of \c std::string and a value /// type of \c clang::DynTypedNode using IDToNodeMap = internal::BoundNodesMap::IDToNodeMap; /// Retrieve mapping from binding identifiers to bound nodes. const IDToNodeMap &getMap() const { return MyBoundNodes.getMap(); } private: friend class internal::BoundNodesTreeBuilder; /// Create BoundNodes from a pre-filled map of bindings. BoundNodes(internal::BoundNodesMap &MyBoundNodes) : MyBoundNodes(MyBoundNodes) {} internal::BoundNodesMap MyBoundNodes; }; /// Types of matchers for the top-level classes in the AST class /// hierarchy. /// @{ using DeclarationMatcher = internal::Matcher; using StatementMatcher = internal::Matcher; using TypeMatcher = internal::Matcher; using TypeLocMatcher = internal::Matcher; using NestedNameSpecifierMatcher = internal::Matcher; using NestedNameSpecifierLocMatcher = internal::Matcher; using CXXBaseSpecifierMatcher = internal::Matcher; using CXXCtorInitializerMatcher = internal::Matcher; using TemplateArgumentMatcher = internal::Matcher; using TemplateArgumentLocMatcher = internal::Matcher; /// @} /// 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 \c internal::Matcher<> type such as \c TypeMatcher. /// /// Example: \c DeclarationMatcher(anything()) matches all declarations, e.g., /// \code /// "int* p" and "void f()" in /// int* p; /// void f(); /// \endcode /// /// Usable as: Any Matcher inline internal::TrueMatcher anything() { return internal::TrueMatcher(); } /// Matches the top declaration context. /// /// Given /// \code /// int X; /// namespace NS { /// int Y; /// } // namespace NS /// \endcode /// decl(hasDeclContext(translationUnitDecl())) /// matches "int X", but not "int Y". extern const internal::VariadicDynCastAllOfMatcher translationUnitDecl; /// Matches typedef declarations. /// /// Given /// \code /// typedef int X; /// using Y = int; /// \endcode /// typedefDecl() /// matches "typedef int X", but not "using Y = int" extern const internal::VariadicDynCastAllOfMatcher typedefDecl; /// Matches typedef name declarations. /// /// Given /// \code /// typedef int X; /// using Y = int; /// \endcode /// typedefNameDecl() /// matches "typedef int X" and "using Y = int" extern const internal::VariadicDynCastAllOfMatcher typedefNameDecl; /// Matches type alias declarations. /// /// Given /// \code /// typedef int X; /// using Y = int; /// \endcode /// typeAliasDecl() /// matches "using Y = int", but not "typedef int X" extern const internal::VariadicDynCastAllOfMatcher typeAliasDecl; /// Matches type alias template declarations. /// /// typeAliasTemplateDecl() matches /// \code /// template /// using Y = X; /// \endcode extern const internal::VariadicDynCastAllOfMatcher typeAliasTemplateDecl; /// Matches AST nodes that were expanded within the main-file. /// /// Example matches X but not Y /// (matcher = cxxRecordDecl(isExpansionInMainFile()) /// \code /// #include /// class X {}; /// \endcode /// Y.h: /// \code /// class Y {}; /// \endcode /// /// Usable as: Matcher, Matcher, Matcher AST_POLYMORPHIC_MATCHER(isExpansionInMainFile, AST_POLYMORPHIC_SUPPORTED_TYPES(Decl, Stmt, TypeLoc)) { auto &SourceManager = Finder->getASTContext().getSourceManager(); return SourceManager.isInMainFile( SourceManager.getExpansionLoc(Node.getBeginLoc())); } /// Matches AST nodes that were expanded within system-header-files. /// /// Example matches Y but not X /// (matcher = cxxRecordDecl(isExpansionInSystemHeader()) /// \code /// #include /// class X {}; /// \endcode /// SystemHeader.h: /// \code /// class Y {}; /// \endcode /// /// Usable as: Matcher, Matcher, Matcher AST_POLYMORPHIC_MATCHER(isExpansionInSystemHeader, AST_POLYMORPHIC_SUPPORTED_TYPES(Decl, Stmt, TypeLoc)) { auto &SourceManager = Finder->getASTContext().getSourceManager(); auto ExpansionLoc = SourceManager.getExpansionLoc(Node.getBeginLoc()); if (ExpansionLoc.isInvalid()) { return false; } return SourceManager.isInSystemHeader(ExpansionLoc); } /// 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.*")) /// \code /// #include "ASTMatcher.h" /// class X {}; /// \endcode /// ASTMatcher.h: /// \code /// class Y {}; /// \endcode /// /// Usable as: Matcher, Matcher, Matcher AST_POLYMORPHIC_MATCHER_REGEX(isExpansionInFileMatching, AST_POLYMORPHIC_SUPPORTED_TYPES(Decl, Stmt, TypeLoc), RegExp) { auto &SourceManager = Finder->getASTContext().getSourceManager(); auto ExpansionLoc = SourceManager.getExpansionLoc(Node.getBeginLoc()); if (ExpansionLoc.isInvalid()) { return false; } auto FileEntry = SourceManager.getFileEntryForID(SourceManager.getFileID(ExpansionLoc)); if (!FileEntry) { return false; } auto Filename = FileEntry->getName(); return RegExp->match(Filename); } /// Matches statements that are (transitively) expanded from the named macro. /// Does not match if only part of the statement is expanded from that macro or /// if different parts of the the statement are expanded from different /// appearances of the macro. AST_POLYMORPHIC_MATCHER_P(isExpandedFromMacro, AST_POLYMORPHIC_SUPPORTED_TYPES(Decl, Stmt, TypeLoc), std::string, MacroName) { // Verifies that the statement' beginning and ending are both expanded from // the same instance of the given macro. auto& Context = Finder->getASTContext(); llvm::Optional B = internal::getExpansionLocOfMacro(MacroName, Node.getBeginLoc(), Context); if (!B) return false; llvm::Optional E = internal::getExpansionLocOfMacro(MacroName, Node.getEndLoc(), Context); if (!E) return false; return *B == *E; } /// Matches declarations. /// /// Examples matches \c X, \c C, and the friend declaration inside \c C; /// \code /// void X(); /// class C { /// friend X; /// }; /// \endcode extern const internal::VariadicAllOfMatcher decl; /// Matches decomposition-declarations. /// /// Examples matches the declaration node with \c foo and \c bar, but not /// \c number. /// (matcher = declStmt(has(decompositionDecl()))) /// /// \code /// int number = 42; /// auto [foo, bar] = std::make_pair{42, 42}; /// \endcode extern const internal::VariadicDynCastAllOfMatcher decompositionDecl; /// Matches binding declarations /// Example matches \c foo and \c bar /// (matcher = bindingDecl() /// /// \code /// auto [foo, bar] = std::make_pair{42, 42}; /// \endcode extern const internal::VariadicDynCastAllOfMatcher bindingDecl; /// Matches a declaration of a linkage specification. /// /// Given /// \code /// extern "C" {} /// \endcode /// linkageSpecDecl() /// matches "extern "C" {}" extern const internal::VariadicDynCastAllOfMatcher linkageSpecDecl; /// Matches a declaration of anything that could have a name. /// /// Example matches \c X, \c S, the anonymous union type, \c i, and \c U; /// \code /// typedef int X; /// struct S { /// union { /// int i; /// } U; /// }; /// \endcode extern const internal::VariadicDynCastAllOfMatcher namedDecl; /// Matches a declaration of label. /// /// Given /// \code /// goto FOO; /// FOO: bar(); /// \endcode /// labelDecl() /// matches 'FOO:' extern const internal::VariadicDynCastAllOfMatcher labelDecl; /// Matches a declaration of a namespace. /// /// Given /// \code /// namespace {} /// namespace test {} /// \endcode /// namespaceDecl() /// matches "namespace {}" and "namespace test {}" extern const internal::VariadicDynCastAllOfMatcher namespaceDecl; /// Matches a declaration of a namespace alias. /// /// Given /// \code /// namespace test {} /// namespace alias = ::test; /// \endcode /// namespaceAliasDecl() /// matches "namespace alias" but not "namespace test" extern const internal::VariadicDynCastAllOfMatcher namespaceAliasDecl; /// Matches class, struct, and union declarations. /// /// Example matches \c X, \c Z, \c U, and \c S /// \code /// class X; /// template class Z {}; /// struct S {}; /// union U {}; /// \endcode extern const internal::VariadicDynCastAllOfMatcher recordDecl; /// Matches C++ class declarations. /// /// Example matches \c X, \c Z /// \code /// class X; /// template class Z {}; /// \endcode extern const internal::VariadicDynCastAllOfMatcher cxxRecordDecl; /// Matches C++ class template declarations. /// /// Example matches \c Z /// \code /// template class Z {}; /// \endcode extern const internal::VariadicDynCastAllOfMatcher classTemplateDecl; /// Matches C++ class template specializations. /// /// Given /// \code /// template class A {}; /// template<> class A {}; /// A a; /// \endcode /// classTemplateSpecializationDecl() /// matches the specializations \c A and \c A extern const internal::VariadicDynCastAllOfMatcher< Decl, ClassTemplateSpecializationDecl> classTemplateSpecializationDecl; /// Matches C++ class template partial specializations. /// /// Given /// \code /// template /// class A {}; /// /// template /// class A {}; /// /// template<> /// class A {}; /// \endcode /// classTemplatePartialSpecializationDecl() /// matches the specialization \c A but not \c A extern const internal::VariadicDynCastAllOfMatcher< Decl, ClassTemplatePartialSpecializationDecl> classTemplatePartialSpecializationDecl; /// Matches declarator declarations (field, variable, function /// and non-type template parameter declarations). /// /// Given /// \code /// class X { int y; }; /// \endcode /// declaratorDecl() /// matches \c int y. extern const internal::VariadicDynCastAllOfMatcher declaratorDecl; /// Matches parameter variable declarations. /// /// Given /// \code /// void f(int x); /// \endcode /// parmVarDecl() /// matches \c int x. extern const internal::VariadicDynCastAllOfMatcher parmVarDecl; /// Matches C++ access specifier declarations. /// /// Given /// \code /// class C { /// public: /// int a; /// }; /// \endcode /// accessSpecDecl() /// matches 'public:' extern const internal::VariadicDynCastAllOfMatcher accessSpecDecl; /// Matches class bases. /// /// Examples matches \c public virtual B. /// \code /// class B {}; /// class C : public virtual B {}; /// \endcode extern const internal::VariadicAllOfMatcher cxxBaseSpecifier; /// Matches constructor initializers. /// /// Examples matches \c i(42). /// \code /// class C { /// C() : i(42) {} /// int i; /// }; /// \endcode extern const internal::VariadicAllOfMatcher cxxCtorInitializer; /// Matches template arguments. /// /// Given /// \code /// template struct C {}; /// C c; /// \endcode /// templateArgument() /// matches 'int' in C. extern const internal::VariadicAllOfMatcher templateArgument; /// Matches template arguments (with location info). /// /// Given /// \code /// template struct C {}; /// C c; /// \endcode /// templateArgumentLoc() /// matches 'int' in C. extern const internal::VariadicAllOfMatcher templateArgumentLoc; /// Matches template name. /// /// Given /// \code /// template class X { }; /// X xi; /// \endcode /// templateName() /// matches 'X' in X. extern const internal::VariadicAllOfMatcher templateName; /// Matches non-type template parameter declarations. /// /// Given /// \code /// template struct C {}; /// \endcode /// nonTypeTemplateParmDecl() /// matches 'N', but not 'T'. extern const internal::VariadicDynCastAllOfMatcher nonTypeTemplateParmDecl; /// Matches template type parameter declarations. /// /// Given /// \code /// template struct C {}; /// \endcode /// templateTypeParmDecl() /// matches 'T', but not 'N'. extern const internal::VariadicDynCastAllOfMatcher templateTypeParmDecl; /// Matches template template parameter declarations. /// /// Given /// \code /// template