<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" | |
"http://www.w3.org/TR/html4/strict.dtd"> | |
<html> | |
<head> | |
<title>AST Matcher Reference</title> | |
<link type="text/css" rel="stylesheet" href="../menu.css" /> | |
<link type="text/css" rel="stylesheet" href="../content.css" /> | |
<style type="text/css"> | |
td { | |
padding: .33em; | |
} | |
td.doc { | |
display: none; | |
border-bottom: 1px solid black; | |
} | |
td.name:hover { | |
color: blue; | |
cursor: pointer; | |
} | |
</style> | |
<script type="text/javascript"> | |
function toggle(id) { | |
if (!id) return; | |
row = document.getElementById(id); | |
if (row.style.display != 'table-cell') | |
row.style.display = 'table-cell'; | |
else | |
row.style.display = 'none'; | |
} | |
</script> | |
</head> | |
<body onLoad="toggle(location.hash.substring(1, location.hash.length - 6))"> | |
<!--#include virtual="../menu.html.incl"--> | |
<div id="content"> | |
<h1>AST Matcher Reference</h1> | |
<p>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.</p> | |
<p>There are three different basic categories of matchers: | |
<ul> | |
<li><a href="#decl-matchers">Node Matchers:</a> Matchers that match a specific type of AST node.</li> | |
<li><a href="#narrowing-matchers">Narrowing Matchers:</a> Matchers that match attributes on AST nodes.</li> | |
<li><a href="#traversal-matchers">Traversal Matchers:</a> Matchers that allow traversal between AST nodes.</li> | |
</ul> | |
</p> | |
<p>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 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.</p> | |
<p>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.</p> | |
<p>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: | |
<pre> | |
recordDecl(hasDescendant( | |
ifStmt(hasTrueExpression( | |
expr(hasDescendant( | |
ifStmt())))))) | |
</pre> | |
</p> | |
<!-- ======================================================================= --> | |
<h2 id="decl-matchers">Node Matchers</h2> | |
<!-- ======================================================================= --> | |
<p>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.</p> | |
<p>For convenience, all node matchers take an arbitrary number of arguments | |
and implicitly act as allOf matchers.</p> | |
<p>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.</p> | |
<p>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: | |
<pre> | |
// This binds the CXXRecordDecl to "id", as the decl() matcher will stay on | |
// the same node. | |
recordDecl(decl().bind("id"), hasName("::MyClass")) | |
</pre> | |
</p> | |
<table> | |
<tr style="text-align:left"><th>Return type</th><th>Name</th><th>Parameters</th></tr> | |
<!-- START_DECL_MATCHERS --> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXCtorInitializer.html">CXXCtorInitializer</a>></td><td class="name" onclick="toggle('cxxCtorInitializer0')"><a name="cxxCtorInitializer0Anchor">cxxCtorInitializer</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXCtorInitializer.html">CXXCtorInitializer</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxCtorInitializer0"><pre>Matches constructor initializers. | |
Examples matches i(42). | |
class C { | |
C() : i(42) {} | |
int i; | |
}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('accessSpecDecl0')"><a name="accessSpecDecl0Anchor">accessSpecDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AccessSpecDecl.html">AccessSpecDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="accessSpecDecl0"><pre>Matches C++ access specifier declarations. | |
Given | |
class C { | |
public: | |
int a; | |
}; | |
accessSpecDecl() | |
matches 'public:' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('classTemplateDecl0')"><a name="classTemplateDecl0Anchor">classTemplateDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ClassTemplateDecl.html">ClassTemplateDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="classTemplateDecl0"><pre>Matches C++ class template declarations. | |
Example matches Z | |
template<class T> class Z {}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('classTemplateSpecializationDecl0')"><a name="classTemplateSpecializationDecl0Anchor">classTemplateSpecializationDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ClassTemplateSpecializationDecl.html">ClassTemplateSpecializationDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="classTemplateSpecializationDecl0"><pre>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> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('cxxConstructorDecl0')"><a name="cxxConstructorDecl0Anchor">cxxConstructorDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructorDecl.html">CXXConstructorDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxConstructorDecl0"><pre>Matches C++ constructor declarations. | |
Example matches Foo::Foo() and Foo::Foo(int) | |
class Foo { | |
public: | |
Foo(); | |
Foo(int); | |
int DoSomething(); | |
}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('cxxConversionDecl0')"><a name="cxxConversionDecl0Anchor">cxxConversionDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConversionDecl.html">CXXConversionDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxConversionDecl0"><pre>Matches conversion operator declarations. | |
Example matches the operator. | |
class X { operator int() const; }; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('cxxDestructorDecl0')"><a name="cxxDestructorDecl0Anchor">cxxDestructorDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXDestructorDecl.html">CXXDestructorDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxDestructorDecl0"><pre>Matches explicit C++ destructor declarations. | |
Example matches Foo::~Foo() | |
class Foo { | |
public: | |
virtual ~Foo(); | |
}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('cxxMethodDecl0')"><a name="cxxMethodDecl0Anchor">cxxMethodDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMethodDecl.html">CXXMethodDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxMethodDecl0"><pre>Matches method declarations. | |
Example matches y | |
class X { void y(); }; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('cxxRecordDecl0')"><a name="cxxRecordDecl0Anchor">cxxRecordDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxRecordDecl0"><pre>Matches C++ class declarations. | |
Example matches X, Z | |
class X; | |
template<class T> class Z {}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('decl0')"><a name="decl0Anchor">decl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="decl0"><pre>Matches declarations. | |
Examples matches X, C, and the friend declaration inside C; | |
void X(); | |
class C { | |
friend X; | |
}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('declaratorDecl0')"><a name="declaratorDecl0Anchor">declaratorDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclaratorDecl.html">DeclaratorDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="declaratorDecl0"><pre>Matches declarator declarations (field, variable, function | |
and non-type template parameter declarations). | |
Given | |
class X { int y; }; | |
declaratorDecl() | |
matches int y. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('enumConstantDecl0')"><a name="enumConstantDecl0Anchor">enumConstantDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumConstantDecl.html">EnumConstantDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="enumConstantDecl0"><pre>Matches enum constants. | |
Example matches A, B, C | |
enum X { | |
A, B, C | |
}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('enumDecl0')"><a name="enumDecl0Anchor">enumDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumDecl.html">EnumDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="enumDecl0"><pre>Matches enum declarations. | |
Example matches X | |
enum X { | |
A, B, C | |
}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('fieldDecl0')"><a name="fieldDecl0Anchor">fieldDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FieldDecl.html">FieldDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="fieldDecl0"><pre>Matches field declarations. | |
Given | |
class X { int m; }; | |
fieldDecl() | |
matches 'm'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('friendDecl0')"><a name="friendDecl0Anchor">friendDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FriendDecl.html">FriendDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="friendDecl0"><pre>Matches friend declarations. | |
Given | |
class X { friend void foo(); }; | |
friendDecl() | |
matches 'friend void foo()'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('functionDecl0')"><a name="functionDecl0Anchor">functionDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="functionDecl0"><pre>Matches function declarations. | |
Example matches f | |
void f(); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('functionTemplateDecl0')"><a name="functionTemplateDecl0Anchor">functionTemplateDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionTemplateDecl.html">FunctionTemplateDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="functionTemplateDecl0"><pre>Matches C++ function template declarations. | |
Example matches f | |
template<class T> void f(T t) {} | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('linkageSpecDecl0')"><a name="linkageSpecDecl0Anchor">linkageSpecDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LinkageSpecDecl.html">LinkageSpecDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="linkageSpecDecl0"><pre>Matches a declaration of a linkage specification. | |
Given | |
extern "C" {} | |
linkageSpecDecl() | |
matches "extern "C" {}" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('namedDecl0')"><a name="namedDecl0Anchor">namedDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamedDecl.html">NamedDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="namedDecl0"><pre>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; | |
}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('namespaceAliasDecl0')"><a name="namespaceAliasDecl0Anchor">namespaceAliasDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamespaceAliasDecl.html">NamespaceAliasDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="namespaceAliasDecl0"><pre>Matches a declaration of a namespace alias. | |
Given | |
namespace test {} | |
namespace alias = ::test; | |
namespaceAliasDecl() | |
matches "namespace alias" but not "namespace test" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('namespaceDecl0')"><a name="namespaceDecl0Anchor">namespaceDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamespaceDecl.html">NamespaceDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="namespaceDecl0"><pre>Matches a declaration of a namespace. | |
Given | |
namespace {} | |
namespace test {} | |
namespaceDecl() | |
matches "namespace {}" and "namespace test {}" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('nonTypeTemplateParmDecl0')"><a name="nonTypeTemplateParmDecl0Anchor">nonTypeTemplateParmDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NonTypeTemplateParmDecl.html">NonTypeTemplateParmDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="nonTypeTemplateParmDecl0"><pre>Matches non-type template parameter declarations. | |
Given | |
template <typename T, int N> struct C {}; | |
nonTypeTemplateParmDecl() | |
matches 'N', but not 'T'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('objcInterfaceDecl0')"><a name="objcInterfaceDecl0Anchor">objcInterfaceDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCInterfaceDecl.html">ObjCInterfaceDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="objcInterfaceDecl0"><pre>Matches Objective-C interface declarations. | |
Example matches Foo | |
@interface Foo | |
@end | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('parmVarDecl0')"><a name="parmVarDecl0Anchor">parmVarDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParmVarDecl.html">ParmVarDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="parmVarDecl0"><pre>Matches parameter variable declarations. | |
Given | |
void f(int x); | |
parmVarDecl() | |
matches int x. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('recordDecl0')"><a name="recordDecl0Anchor">recordDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordDecl.html">RecordDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="recordDecl0"><pre>Matches class, struct, and union declarations. | |
Example matches X, Z, U, and S | |
class X; | |
template<class T> class Z {}; | |
struct S {}; | |
union U {}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('staticAssertDecl0')"><a name="staticAssertDecl0Anchor">staticAssertDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1StaticAssertDecl.html">StaticAssertDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="staticAssertDecl0"><pre>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)); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('templateTypeParmDecl0')"><a name="templateTypeParmDecl0Anchor">templateTypeParmDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmDecl.html">TemplateTypeParmDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="templateTypeParmDecl0"><pre>Matches template type parameter declarations. | |
Given | |
template <typename T, int N> struct C {}; | |
templateTypeParmDecl() | |
matches 'T', but not 'N'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('translationUnitDecl0')"><a name="translationUnitDecl0Anchor">translationUnitDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TranslationUnitDecl.html">TranslationUnitDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="translationUnitDecl0"><pre>Matches the top declaration context. | |
Given | |
int X; | |
namespace NS { | |
int Y; | |
} namespace NS | |
decl(hasDeclContext(translationUnitDecl())) | |
matches "int X", but not "int Y". | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('typedefDecl0')"><a name="typedefDecl0Anchor">typedefDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefDecl.html">TypedefDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="typedefDecl0"><pre>Matches typedef declarations. | |
Given | |
typedef int X; | |
typedefDecl() | |
matches "typedef int X" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('unresolvedUsingTypenameDecl0')"><a name="unresolvedUsingTypenameDecl0Anchor">unresolvedUsingTypenameDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingTypenameDecl.html">UnresolvedUsingTypenameDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="unresolvedUsingTypenameDecl0"><pre>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 </pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('unresolvedUsingValueDecl0')"><a name="unresolvedUsingValueDecl0Anchor">unresolvedUsingValueDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingValueDecl.html">UnresolvedUsingValueDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="unresolvedUsingValueDecl0"><pre>Matches unresolved using value declarations. | |
Given | |
template<typename X> | |
class C : private X { | |
using X::x; | |
}; | |
unresolvedUsingValueDecl() | |
matches using X::x </pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('usingDecl0')"><a name="usingDecl0Anchor">usingDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UsingDecl.html">UsingDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="usingDecl0"><pre>Matches using declarations. | |
Given | |
namespace X { int x; } | |
using X::x; | |
usingDecl() | |
matches using X::x </pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('usingDirectiveDecl0')"><a name="usingDirectiveDecl0Anchor">usingDirectiveDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UsingDirectiveDecl.html">UsingDirectiveDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="usingDirectiveDecl0"><pre>Matches using namespace declarations. | |
Given | |
namespace X { int x; } | |
using namespace X; | |
usingDirectiveDecl() | |
matches using namespace X </pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('valueDecl0')"><a name="valueDecl0Anchor">valueDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ValueDecl.html">ValueDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="valueDecl0"><pre>Matches any value declaration. | |
Example matches A, B, C and F | |
enum X { A, B, C }; | |
void F(); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('varDecl0')"><a name="varDecl0Anchor">varDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="varDecl0"><pre>Matches variable declarations. | |
Note: this does not match declarations of member variables, which are | |
"field" declarations in Clang parlance. | |
Example matches a | |
int a; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NestedNameSpecifierLoc.html">NestedNameSpecifierLoc</a>></td><td class="name" onclick="toggle('nestedNameSpecifierLoc0')"><a name="nestedNameSpecifierLoc0Anchor">nestedNameSpecifierLoc</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NestedNameSpecifierLoc.html">NestedNameSpecifierLoc</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="nestedNameSpecifierLoc0"><pre>Same as nestedNameSpecifier but matches NestedNameSpecifierLoc. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NestedNameSpecifier.html">NestedNameSpecifier</a>></td><td class="name" onclick="toggle('nestedNameSpecifier0')"><a name="nestedNameSpecifier0Anchor">nestedNameSpecifier</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NestedNameSpecifier.html">NestedNameSpecifier</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="nestedNameSpecifier0"><pre>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::" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('qualType0')"><a name="qualType0Anchor">qualType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="qualType0"><pre>Matches QualTypes in the clang AST. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('arraySubscriptExpr0')"><a name="arraySubscriptExpr0Anchor">arraySubscriptExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ArraySubscriptExpr.html">ArraySubscriptExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="arraySubscriptExpr0"><pre>Matches array subscript expressions. | |
Given | |
int i = a[1]; | |
arraySubscriptExpr() | |
matches "a[1]" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('asmStmt0')"><a name="asmStmt0Anchor">asmStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AsmStmt.html">AsmStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="asmStmt0"><pre>Matches asm statements. | |
int i = 100; | |
__asm("mov al, 2"); | |
asmStmt() | |
matches '__asm("mov al, 2")' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('binaryOperator0')"><a name="binaryOperator0Anchor">binaryOperator</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BinaryOperator.html">BinaryOperator</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="binaryOperator0"><pre>Matches binary operator expressions. | |
Example matches a || b | |
!(a || b) | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('breakStmt0')"><a name="breakStmt0Anchor">breakStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BreakStmt.html">BreakStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="breakStmt0"><pre>Matches break statements. | |
Given | |
while (true) { break; } | |
breakStmt() | |
matches 'break' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cStyleCastExpr0')"><a name="cStyleCastExpr0Anchor">cStyleCastExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CStyleCastExpr.html">CStyleCastExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cStyleCastExpr0"><pre>Matches a C-style cast expression. | |
Example: Matches (int*) 2.2f in | |
int i = (int) 2.2f; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('callExpr0')"><a name="callExpr0Anchor">callExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="callExpr0"><pre>Matches call expressions. | |
Example matches x.y() and y() | |
X x; | |
x.y(); | |
y(); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('caseStmt0')"><a name="caseStmt0Anchor">caseStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CaseStmt.html">CaseStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="caseStmt0"><pre>Matches case statements inside switch statements. | |
Given | |
switch(a) { case 42: break; default: break; } | |
caseStmt() | |
matches 'case 42: break;'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('castExpr0')"><a name="castExpr0Anchor">castExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CastExpr.html">CastExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="castExpr0"><pre>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; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('characterLiteral0')"><a name="characterLiteral0Anchor">characterLiteral</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CharacterLiteral.html">CharacterLiteral</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="characterLiteral0"><pre>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'; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('compoundLiteralExpr0')"><a name="compoundLiteralExpr0Anchor">compoundLiteralExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CompoundLiteralExpr.html">CompoundLiteralExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="compoundLiteralExpr0"><pre>Matches compound (i.e. non-scalar) literals | |
Example match: {1}, (1, 2) | |
int array[4] = {1}; vector int myvec = (vector int)(1, 2); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('compoundStmt0')"><a name="compoundStmt0Anchor">compoundStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CompoundStmt.html">CompoundStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="compoundStmt0"><pre>Matches compound statements. | |
Example matches '{}' and '{{}}'in 'for (;;) {{}}' | |
for (;;) {{}} | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('conditionalOperator0')"><a name="conditionalOperator0Anchor">conditionalOperator</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ConditionalOperator.html">ConditionalOperator</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="conditionalOperator0"><pre>Matches conditional operator expressions. | |
Example matches a ? b : c | |
(a ? b : c) + 42 | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('continueStmt0')"><a name="continueStmt0Anchor">continueStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ContinueStmt.html">ContinueStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="continueStmt0"><pre>Matches continue statements. | |
Given | |
while (true) { continue; } | |
continueStmt() | |
matches 'continue' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cudaKernelCallExpr0')"><a name="cudaKernelCallExpr0Anchor">cudaKernelCallExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CUDAKernelCallExpr.html">CUDAKernelCallExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cudaKernelCallExpr0"><pre>Matches CUDA kernel call expression. | |
Example matches, | |
kernel<<<i,j>>>(); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxBindTemporaryExpr0')"><a name="cxxBindTemporaryExpr0Anchor">cxxBindTemporaryExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXBindTemporaryExpr.html">CXXBindTemporaryExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxBindTemporaryExpr0"><pre>Matches nodes where temporaries are created. | |
Example matches FunctionTakesString(GetStringByValue()) | |
(matcher = cxxBindTemporaryExpr()) | |
FunctionTakesString(GetStringByValue()); | |
FunctionTakesStringByPointer(GetStringPointer()); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxBoolLiteral0')"><a name="cxxBoolLiteral0Anchor">cxxBoolLiteral</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXBoolLiteralExpr.html">CXXBoolLiteralExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxBoolLiteral0"><pre>Matches bool literals. | |
Example matches true | |
true | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxCatchStmt0')"><a name="cxxCatchStmt0Anchor">cxxCatchStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXCatchStmt.html">CXXCatchStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxCatchStmt0"><pre>Matches catch statements. | |
try {} catch(int i) {} | |
cxxCatchStmt() | |
matches 'catch(int i)' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxConstCastExpr0')"><a name="cxxConstCastExpr0Anchor">cxxConstCastExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstCastExpr.html">CXXConstCastExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxConstCastExpr0"><pre>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); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxConstructExpr0')"><a name="cxxConstructExpr0Anchor">cxxConstructExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxConstructExpr0"><pre>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); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxDefaultArgExpr0')"><a name="cxxDefaultArgExpr0Anchor">cxxDefaultArgExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXDefaultArgExpr.html">CXXDefaultArgExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxDefaultArgExpr0"><pre>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); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxDeleteExpr0')"><a name="cxxDeleteExpr0Anchor">cxxDeleteExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXDeleteExpr.html">CXXDeleteExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxDeleteExpr0"><pre>Matches delete expressions. | |
Given | |
delete X; | |
cxxDeleteExpr() | |
matches 'delete X'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxDynamicCastExpr0')"><a name="cxxDynamicCastExpr0Anchor">cxxDynamicCastExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXDynamicCastExpr.html">CXXDynamicCastExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxDynamicCastExpr0"><pre>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); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxForRangeStmt0')"><a name="cxxForRangeStmt0Anchor">cxxForRangeStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXForRangeStmt.html">CXXForRangeStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxForRangeStmt0"><pre>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); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxFunctionalCastExpr0')"><a name="cxxFunctionalCastExpr0Anchor">cxxFunctionalCastExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXFunctionalCastExpr.html">CXXFunctionalCastExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxFunctionalCastExpr0"><pre>Matches functional cast expressions | |
Example: Matches Foo(bar); | |
Foo f = bar; | |
Foo g = (Foo) bar; | |
Foo h = Foo(bar); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxMemberCallExpr0')"><a name="cxxMemberCallExpr0Anchor">cxxMemberCallExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMemberCallExpr.html">CXXMemberCallExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxMemberCallExpr0"><pre>Matches member call expressions. | |
Example matches x.y() | |
X x; | |
x.y(); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxNewExpr0')"><a name="cxxNewExpr0Anchor">cxxNewExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxNewExpr0"><pre>Matches new expressions. | |
Given | |
new X; | |
cxxNewExpr() | |
matches 'new X'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxNullPtrLiteralExpr0')"><a name="cxxNullPtrLiteralExpr0Anchor">cxxNullPtrLiteralExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNullPtrLiteralExpr.html">CXXNullPtrLiteralExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxNullPtrLiteralExpr0"><pre>Matches nullptr literal. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxOperatorCallExpr0')"><a name="cxxOperatorCallExpr0Anchor">cxxOperatorCallExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXOperatorCallExpr.html">CXXOperatorCallExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxOperatorCallExpr0"><pre>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; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxReinterpretCastExpr0')"><a name="cxxReinterpretCastExpr0Anchor">cxxReinterpretCastExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXReinterpretCastExpr.html">CXXReinterpretCastExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxReinterpretCastExpr0"><pre>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); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxStaticCastExpr0')"><a name="cxxStaticCastExpr0Anchor">cxxStaticCastExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXStaticCastExpr.html">CXXStaticCastExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxStaticCastExpr0"><pre>Matches a C++ static_cast expression. | |
hasDestinationType | |
reinterpretCast | |
Example: | |
cxxStaticCastExpr() | |
matches | |
static_cast<long>(8) | |
in | |
long eight(static_cast<long>(8)); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxTemporaryObjectExpr0')"><a name="cxxTemporaryObjectExpr0Anchor">cxxTemporaryObjectExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXTemporaryObjectExpr.html">CXXTemporaryObjectExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxTemporaryObjectExpr0"><pre>Matches functional cast expressions having N != 1 arguments | |
Example: Matches Foo(bar, bar) | |
Foo h = Foo(bar, bar); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxThisExpr0')"><a name="cxxThisExpr0Anchor">cxxThisExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXThisExpr.html">CXXThisExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxThisExpr0"><pre>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; } | |
}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxThrowExpr0')"><a name="cxxThrowExpr0Anchor">cxxThrowExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXThrowExpr.html">CXXThrowExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxThrowExpr0"><pre>Matches throw expressions. | |
try { throw 5; } catch(int i) {} | |
cxxThrowExpr() | |
matches 'throw 5' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxTryStmt0')"><a name="cxxTryStmt0Anchor">cxxTryStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXTryStmt.html">CXXTryStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxTryStmt0"><pre>Matches try statements. | |
try {} catch(int i) {} | |
cxxTryStmt() | |
matches 'try {}' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxUnresolvedConstructExpr0')"><a name="cxxUnresolvedConstructExpr0Anchor">cxxUnresolvedConstructExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXUnresolvedConstructExpr.html">CXXUnresolvedConstructExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="cxxUnresolvedConstructExpr0"><pre>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); } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('declRefExpr0')"><a name="declRefExpr0Anchor">declRefExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="declRefExpr0"><pre>Matches expressions that refer to declarations. | |
Example matches x in if (x) | |
bool x; | |
if (x) {} | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('declStmt0')"><a name="declStmt0Anchor">declStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclStmt.html">DeclStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="declStmt0"><pre>Matches declaration statements. | |
Given | |
int a; | |
declStmt() | |
matches 'int a'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('defaultStmt0')"><a name="defaultStmt0Anchor">defaultStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DefaultStmt.html">DefaultStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="defaultStmt0"><pre>Matches default statements inside switch statements. | |
Given | |
switch(a) { case 42: break; default: break; } | |
defaultStmt() | |
matches 'default: break;'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('doStmt0')"><a name="doStmt0Anchor">doStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DoStmt.html">DoStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="doStmt0"><pre>Matches do statements. | |
Given | |
do {} while (true); | |
doStmt() | |
matches 'do {} while(true)' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('explicitCastExpr0')"><a name="explicitCastExpr0Anchor">explicitCastExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ExplicitCastExpr.html">ExplicitCastExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="explicitCastExpr0"><pre>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. | |
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; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('expr0')"><a name="expr0Anchor">expr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="expr0"><pre>Matches expressions. | |
Example matches x() | |
void f() { x(); } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('exprWithCleanups0')"><a name="exprWithCleanups0Anchor">exprWithCleanups</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ExprWithCleanups.html">ExprWithCleanups</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="exprWithCleanups0"><pre>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(); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('floatLiteral0')"><a name="floatLiteral0Anchor">floatLiteral</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FloatingLiteral.html">FloatingLiteral</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="floatLiteral0"><pre>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; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('forStmt0')"><a name="forStmt0Anchor">forStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ForStmt.html">ForStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="forStmt0"><pre>Matches for statements. | |
Example matches 'for (;;) {}' | |
for (;;) {} | |
int i[] = {1, 2, 3}; for (auto a : i); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('gnuNullExpr0')"><a name="gnuNullExpr0Anchor">gnuNullExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1GNUNullExpr.html">GNUNullExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="gnuNullExpr0"><pre>Matches GNU __null expression. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('gotoStmt0')"><a name="gotoStmt0Anchor">gotoStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1GotoStmt.html">GotoStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="gotoStmt0"><pre>Matches goto statements. | |
Given | |
goto FOO; | |
FOO: bar(); | |
gotoStmt() | |
matches 'goto FOO' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('ifStmt0')"><a name="ifStmt0Anchor">ifStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IfStmt.html">IfStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="ifStmt0"><pre>Matches if statements. | |
Example matches 'if (x) {}' | |
if (x) {} | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('implicitCastExpr0')"><a name="implicitCastExpr0Anchor">implicitCastExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ImplicitCastExpr.html">ImplicitCastExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="implicitCastExpr0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('initListExpr0')"><a name="initListExpr0Anchor">initListExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InitListExpr.html">InitListExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="initListExpr0"><pre>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 }" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('integerLiteral0')"><a name="integerLiteral0Anchor">integerLiteral</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IntegerLiteral.html">IntegerLiteral</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="integerLiteral0"><pre>Matches integer literals of all sizes encodings, e.g. | |
1, 1L, 0x1 and 1U. | |
Does not match character-encoded integers such as L'a'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('labelStmt0')"><a name="labelStmt0Anchor">labelStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="labelStmt0"><pre>Matches label statements. | |
Given | |
goto FOO; | |
FOO: bar(); | |
labelStmt() | |
matches 'FOO:' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('lambdaExpr0')"><a name="lambdaExpr0Anchor">lambdaExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LambdaExpr.html">LambdaExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="lambdaExpr0"><pre>Matches lambda expressions. | |
Example matches [&](){return 5;} | |
[&](){return 5;} | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('materializeTemporaryExpr0')"><a name="materializeTemporaryExpr0Anchor">materializeTemporaryExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MaterializeTemporaryExpr.html">MaterializeTemporaryExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="materializeTemporaryExpr0"><pre>Matches nodes where temporaries are materialized. | |
Example: Given | |
struct T {void func()}; | |
T f(); | |
void g(T); | |
materializeTemporaryExpr() matches 'f()' in these statements | |
T u(f()); | |
g(f()); | |
but does not match | |
f(); | |
f().func(); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('memberExpr0')"><a name="memberExpr0Anchor">memberExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="memberExpr0"><pre>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 | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('nullStmt0')"><a name="nullStmt0Anchor">nullStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NullStmt.html">NullStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="nullStmt0"><pre>Matches null statements. | |
foo();; | |
nullStmt() | |
matches the second ';' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('objcMessageExpr0')"><a name="objcMessageExpr0Anchor">objcMessageExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMessageExpr.html">ObjCMessageExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="objcMessageExpr0"><pre>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"] | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('returnStmt0')"><a name="returnStmt0Anchor">returnStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ReturnStmt.html">ReturnStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="returnStmt0"><pre>Matches return statements. | |
Given | |
return 1; | |
returnStmt() | |
matches 'return 1' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('stmt0')"><a name="stmt0Anchor">stmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="stmt0"><pre>Matches statements. | |
Given | |
{ ++a; } | |
stmt() | |
matches both the compound statement '{ ++a; }' and '++a'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('stringLiteral0')"><a name="stringLiteral0Anchor">stringLiteral</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1StringLiteral.html">StringLiteral</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="stringLiteral0"><pre>Matches string literals (also matches wide string literals). | |
Example matches "abcd", L"abcd" | |
char *s = "abcd"; wchar_t *ws = L"abcd" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('substNonTypeTemplateParmExpr0')"><a name="substNonTypeTemplateParmExpr0Anchor">substNonTypeTemplateParmExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1SubstNonTypeTemplateParmExpr.html">SubstNonTypeTemplateParmExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="substNonTypeTemplateParmExpr0"><pre>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;" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('switchCase0')"><a name="switchCase0Anchor">switchCase</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1SwitchCase.html">SwitchCase</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="switchCase0"><pre>Matches case and default statements inside switch statements. | |
Given | |
switch(a) { case 42: break; default: break; } | |
switchCase() | |
matches 'case 42: break;' and 'default: break;'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('switchStmt0')"><a name="switchStmt0Anchor">switchStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1SwitchStmt.html">SwitchStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="switchStmt0"><pre>Matches switch statements. | |
Given | |
switch(a) { case 42: break; default: break; } | |
switchStmt() | |
matches 'switch(a)'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('unaryExprOrTypeTraitExpr0')"><a name="unaryExprOrTypeTraitExpr0Anchor">unaryExprOrTypeTraitExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnaryExprOrTypeTraitExpr.html">UnaryExprOrTypeTraitExpr</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="unaryExprOrTypeTraitExpr0"><pre>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) | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('unaryOperator0')"><a name="unaryOperator0Anchor">unaryOperator</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnaryOperator.html">UnaryOperator</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="unaryOperator0"><pre>Matches unary operator expressions. | |
Example matches !a | |
!a || b | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('userDefinedLiteral0')"><a name="userDefinedLiteral0Anchor">userDefinedLiteral</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UserDefinedLiteral.html">UserDefinedLiteral</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="userDefinedLiteral0"><pre>Matches user defined literal operator call. | |
Example match: "foo"_suffix | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('whileStmt0')"><a name="whileStmt0Anchor">whileStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1WhileStmt.html">WhileStmt</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="whileStmt0"><pre>Matches while statements. | |
Given | |
while (true) {} | |
whileStmt() | |
matches 'while (true) {}'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>></td><td class="name" onclick="toggle('templateArgument0')"><a name="templateArgument0Anchor">templateArgument</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="templateArgument0"><pre>Matches template arguments. | |
Given | |
template <typename T> struct C {}; | |
C<int> c; | |
templateArgument() | |
matches 'int' in C<int>. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>></td><td class="name" onclick="toggle('typeLoc0')"><a name="typeLoc0Anchor">typeLoc</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="typeLoc0"><pre>Matches TypeLocs in the clang AST. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('arrayType0')"><a name="arrayType0Anchor">arrayType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ArrayType.html">ArrayType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="arrayType0"><pre>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]]"; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('atomicType0')"><a name="atomicType0Anchor">atomicType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AtomicType.html">AtomicType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="atomicType0"><pre>Matches atomic types. | |
Given | |
_Atomic(int) i; | |
atomicType() | |
matches "_Atomic(int) i" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('autoType0')"><a name="autoType0Anchor">autoType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AutoType.html">AutoType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="autoType0"><pre>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" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('blockPointerType0')"><a name="blockPointerType0Anchor">blockPointerType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BlockPointerType.html">BlockPointerType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="blockPointerType0"><pre>Matches block pointer types, i.e. types syntactically represented as | |
"void (^)(int)". | |
The pointee is always required to be a FunctionType. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('builtinType0')"><a name="builtinType0Anchor">builtinType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BuiltinType.html">BuiltinType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="builtinType0"><pre>Matches builtin Types. | |
Given | |
struct A {}; | |
A a; | |
int b; | |
float c; | |
bool d; | |
builtinType() | |
matches "int b", "float c" and "bool d" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('complexType0')"><a name="complexType0Anchor">complexType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ComplexType.html">ComplexType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="complexType0"><pre>Matches C99 complex types. | |
Given | |
_Complex float f; | |
complexType() | |
matches "_Complex float f" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('constantArrayType0')"><a name="constantArrayType0Anchor">constantArrayType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ConstantArrayType.html">ConstantArrayType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="constantArrayType0"><pre>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]" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('decayedType0')"><a name="decayedType0Anchor">decayedType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DecayedType.html">DecayedType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="decayedType0"><pre>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; | |
} | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('dependentSizedArrayType0')"><a name="dependentSizedArrayType0Anchor">dependentSizedArrayType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DependentSizedArrayType.html">DependentSizedArrayType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="dependentSizedArrayType0"><pre>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]" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('elaboratedType0')"><a name="elaboratedType0Anchor">elaboratedType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ElaboratedType.html">ElaboratedType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="elaboratedType0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('functionType0')"><a name="functionType0Anchor">functionType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionType.html">FunctionType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="functionType0"><pre>Matches FunctionType nodes. | |
Given | |
int (*f)(int); | |
void g(); | |
functionType() | |
matches "int (*f)(int)" and the type of "g". | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('incompleteArrayType0')"><a name="incompleteArrayType0Anchor">incompleteArrayType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IncompleteArrayType.html">IncompleteArrayType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="incompleteArrayType0"><pre>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[]" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('injectedClassNameType0')"><a name="injectedClassNameType0Anchor">injectedClassNameType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="injectedClassNameType0"><pre>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); | |
}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('lValueReferenceType0')"><a name="lValueReferenceType0Anchor">lValueReferenceType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LValueReferenceType.html">LValueReferenceType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="lValueReferenceType0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('memberPointerType0')"><a name="memberPointerType0Anchor">memberPointerType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberPointerType.html">MemberPointerType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="memberPointerType0"><pre>Matches member pointer types. | |
Given | |
struct A { int i; } | |
A::* ptr = A::i; | |
memberPointerType() | |
matches "A::* ptr" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('objcObjectPointerType0')"><a name="objcObjectPointerType0Anchor">objcObjectPointerType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCObjectPointerType.html">ObjCObjectPointerType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="objcObjectPointerType0"><pre>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". | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('parenType0')"><a name="parenType0Anchor">parenType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParenType.html">ParenType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="parenType0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('pointerType0')"><a name="pointerType0Anchor">pointerType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1PointerType.html">PointerType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="pointerType0"><pre>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". | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('rValueReferenceType0')"><a name="rValueReferenceType0Anchor">rValueReferenceType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RValueReferenceType.html">RValueReferenceType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="rValueReferenceType0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('recordType0')"><a name="recordType0Anchor">recordType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="recordType0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('referenceType0')"><a name="referenceType0Anchor">referenceType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ReferenceType.html">ReferenceType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="referenceType0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('substTemplateTypeParmType0')"><a name="substTemplateTypeParmType0Anchor">substTemplateTypeParmType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1SubstTemplateTypeParmType.html">SubstTemplateTypeParmType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="substTemplateTypeParmType0"><pre>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' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('templateSpecializationType0')"><a name="templateSpecializationType0Anchor">templateSpecializationType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="templateSpecializationType0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('templateTypeParmType0')"><a name="templateTypeParmType0Anchor">templateTypeParmType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="templateTypeParmType0"><pre>Matches template type parameter types. | |
Example matches T, but not int. | |
(matcher = templateTypeParmType()) | |
template <typename T> void f(int i); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('type0')"><a name="type0Anchor">type</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="type0"><pre>Matches Types in the clang AST. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('typedefType0')"><a name="typedefType0Anchor">typedefType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="typedefType0"><pre>Matches typedef types. | |
Given | |
typedef int X; | |
typedefType() | |
matches "typedef int X" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('unaryTransformType0')"><a name="unaryTransformType0Anchor">unaryTransformType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnaryTransformType.html">UnaryTransformType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="unaryTransformType0"><pre>Matches types nodes representing unary type transformations. | |
Given: | |
typedef __underlying_type(T) type; | |
unaryTransformType() | |
matches "__underlying_type(T)" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('variableArrayType0')"><a name="variableArrayType0Anchor">variableArrayType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VariableArrayType.html">VariableArrayType</a>>...</td></tr> | |
<tr><td colspan="4" class="doc" id="variableArrayType0"><pre>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]]" | |
</pre></td></tr> | |
<!--END_DECL_MATCHERS --> | |
</table> | |
<!-- ======================================================================= --> | |
<h2 id="narrowing-matchers">Narrowing Matchers</h2> | |
<!-- ======================================================================= --> | |
<p>Narrowing matchers match certain attributes on the current node, thus | |
narrowing down the set of nodes of the current type to match on.</p> | |
<p>There are special logical narrowing matchers (allOf, anyOf, anything and unless) | |
which allow users to create more powerful match expressions.</p> | |
<table> | |
<tr style="text-align:left"><th>Return type</th><th>Name</th><th>Parameters</th></tr> | |
<!-- START_NARROWING_MATCHERS --> | |
<tr><td>Matcher<*></td><td class="name" onclick="toggle('allOf0')"><a name="allOf0Anchor">allOf</a></td><td>Matcher<*>, ..., Matcher<*></td></tr> | |
<tr><td colspan="4" class="doc" id="allOf0"><pre>Matches if all given matchers match. | |
Usable as: Any Matcher | |
</pre></td></tr> | |
<tr><td>Matcher<*></td><td class="name" onclick="toggle('anyOf0')"><a name="anyOf0Anchor">anyOf</a></td><td>Matcher<*>, ..., Matcher<*></td></tr> | |
<tr><td colspan="4" class="doc" id="anyOf0"><pre>Matches if any of the given matchers matches. | |
Usable as: Any Matcher | |
</pre></td></tr> | |
<tr><td>Matcher<*></td><td class="name" onclick="toggle('anything0')"><a name="anything0Anchor">anything</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="anything0"><pre>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 | |
</pre></td></tr> | |
<tr><td>Matcher<*></td><td class="name" onclick="toggle('unless0')"><a name="unless0Anchor">unless</a></td><td>Matcher<*></td></tr> | |
<tr><td colspan="4" class="doc" id="unless0"><pre>Matches if the provided matcher does not match. | |
Example matches Y (matcher = cxxRecordDecl(unless(hasName("X")))) | |
class X {}; | |
class Y {}; | |
Usable as: Any Matcher | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BinaryOperator.html">BinaryOperator</a>></td><td class="name" onclick="toggle('hasOperatorName0')"><a name="hasOperatorName0Anchor">hasOperatorName</a></td><td>std::string Name</td></tr> | |
<tr><td colspan="4" class="doc" id="hasOperatorName0"><pre>Matches the operator Name of operator expressions (binary or | |
unary). | |
Example matches a || b (matcher = binaryOperator(hasOperatorName("||"))) | |
!(a || b) | |
</pre></td></tr> | |
<tr><td>Matcher<CXXBoolLiteral></td><td class="name" onclick="toggle('equals2')"><a name="equals2Anchor">equals</a></td><td>ValueT Value</td></tr> | |
<tr><td colspan="4" class="doc" id="equals2"><pre>Matches literals that are equal to the given value. | |
Example matches true (matcher = cxxBoolLiteral(equals(true))) | |
true | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CharacterLiteral.html">CharacterLiteral</a>>, Matcher<CXXBoolLiteral>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FloatingLiteral.html">FloatingLiteral</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IntegerLiteral.html">IntegerLiteral</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXCatchStmt.html">CXXCatchStmt</a>></td><td class="name" onclick="toggle('isCatchAll0')"><a name="isCatchAll0Anchor">isCatchAll</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isCatchAll0"><pre>Matches a C++ catch statement that has a catch-all handler. | |
Given | |
try { | |
... | |
} catch (int) { | |
... | |
} catch (...) { | |
... | |
} | |
endcode | |
cxxCatchStmt(isCatchAll()) matches catch(...) but not catch(int). | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>></td><td class="name" onclick="toggle('argumentCountIs1')"><a name="argumentCountIs1Anchor">argumentCountIs</a></td><td>unsigned N</td></tr> | |
<tr><td colspan="4" class="doc" id="argumentCountIs1"><pre>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); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>></td><td class="name" onclick="toggle('isListInitialization0')"><a name="isListInitialization0Anchor">isListInitialization</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isListInitialization0"><pre>Matches a constructor call expression which uses list initialization. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructorDecl.html">CXXConstructorDecl</a>></td><td class="name" onclick="toggle('isCopyConstructor0')"><a name="isCopyConstructor0Anchor">isCopyConstructor</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isCopyConstructor0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructorDecl.html">CXXConstructorDecl</a>></td><td class="name" onclick="toggle('isDefaultConstructor0')"><a name="isDefaultConstructor0Anchor">isDefaultConstructor</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isDefaultConstructor0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructorDecl.html">CXXConstructorDecl</a>></td><td class="name" onclick="toggle('isExplicit0')"><a name="isExplicit0Anchor">isExplicit</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isExplicit0"><pre>Matches constructor and conversion declarations that are marked with | |
the explicit keyword. | |
Given | |
struct S { | |
S(int); #1 | |
explicit S(double); #2 | |
operator int(); #3 | |
explicit operator bool(); #4 | |
}; | |
cxxConstructorDecl(isExplicit()) will match #2, but not #1. | |
cxxConversionDecl(isExplicit()) will match #4, but not #3. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructorDecl.html">CXXConstructorDecl</a>></td><td class="name" onclick="toggle('isMoveConstructor0')"><a name="isMoveConstructor0Anchor">isMoveConstructor</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isMoveConstructor0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConversionDecl.html">CXXConversionDecl</a>></td><td class="name" onclick="toggle('isExplicit1')"><a name="isExplicit1Anchor">isExplicit</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isExplicit1"><pre>Matches constructor and conversion declarations that are marked with | |
the explicit keyword. | |
Given | |
struct S { | |
S(int); #1 | |
explicit S(double); #2 | |
operator int(); #3 | |
explicit operator bool(); #4 | |
}; | |
cxxConstructorDecl(isExplicit()) will match #2, but not #1. | |
cxxConversionDecl(isExplicit()) will match #4, but not #3. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXCtorInitializer.html">CXXCtorInitializer</a>></td><td class="name" onclick="toggle('isBaseInitializer0')"><a name="isBaseInitializer0Anchor">isBaseInitializer</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isBaseInitializer0"><pre>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). | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXCtorInitializer.html">CXXCtorInitializer</a>></td><td class="name" onclick="toggle('isMemberInitializer0')"><a name="isMemberInitializer0Anchor">isMemberInitializer</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isMemberInitializer0"><pre>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(). | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXCtorInitializer.html">CXXCtorInitializer</a>></td><td class="name" onclick="toggle('isWritten0')"><a name="isWritten0Anchor">isWritten</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isWritten0"><pre>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() | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMethodDecl.html">CXXMethodDecl</a>></td><td class="name" onclick="toggle('isConst0')"><a name="isConst0Anchor">isConst</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isConst0"><pre>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() | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMethodDecl.html">CXXMethodDecl</a>></td><td class="name" onclick="toggle('isFinal1')"><a name="isFinal1Anchor">isFinal</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isFinal1"><pre>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 | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMethodDecl.html">CXXMethodDecl</a>></td><td class="name" onclick="toggle('isOverride0')"><a name="isOverride0Anchor">isOverride</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isOverride0"><pre>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 | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMethodDecl.html">CXXMethodDecl</a>></td><td class="name" onclick="toggle('isPure0')"><a name="isPure0Anchor">isPure</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isPure0"><pre>Matches if the given method declaration is pure. | |
Given | |
class A { | |
public: | |
virtual void x() = 0; | |
}; | |
matches A::x | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMethodDecl.html">CXXMethodDecl</a>></td><td class="name" onclick="toggle('isVirtual0')"><a name="isVirtual0Anchor">isVirtual</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isVirtual0"><pre>Matches if the given method declaration is virtual. | |
Given | |
class A { | |
public: | |
virtual void x(); | |
}; | |
matches A::x | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXOperatorCallExpr.html">CXXOperatorCallExpr</a>></td><td class="name" onclick="toggle('hasOverloadedOperatorName1')"><a name="hasOverloadedOperatorName1Anchor">hasOverloadedOperatorName</a></td><td>StringRef Name</td></tr> | |
<tr><td colspan="4" class="doc" id="hasOverloadedOperatorName1"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXOperatorCallExpr.html">CXXOperatorCallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>></td><td class="name" onclick="toggle('isDerivedFrom1')"><a name="isDerivedFrom1Anchor">isDerivedFrom</a></td><td>std::string BaseName</td></tr> | |
<tr><td colspan="4" class="doc" id="isDerivedFrom1"><pre>Overloaded method as shortcut for isDerivedFrom(hasName(...)). | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>></td><td class="name" onclick="toggle('isExplicitTemplateSpecialization2')"><a name="isExplicitTemplateSpecialization2Anchor">isExplicitTemplateSpecialization</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isExplicitTemplateSpecialization2"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>></td><td class="name" onclick="toggle('isFinal0')"><a name="isFinal0Anchor">isFinal</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isFinal0"><pre>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 | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>></td><td class="name" onclick="toggle('isSameOrDerivedFrom1')"><a name="isSameOrDerivedFrom1Anchor">isSameOrDerivedFrom</a></td><td>std::string BaseName</td></tr> | |
<tr><td colspan="4" class="doc" id="isSameOrDerivedFrom1"><pre>Overloaded method as shortcut for | |
isSameOrDerivedFrom(hasName(...)). | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>></td><td class="name" onclick="toggle('isTemplateInstantiation2')"><a name="isTemplateInstantiation2Anchor">isTemplateInstantiation</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isTemplateInstantiation2"><pre>Matches template instantiations of function, class, or static | |
member variable template instantiations. | |
Given | |
template <typename T> class X {}; class A {}; X<A> x; | |
or | |
template <typename T> class X {}; class A {}; template class X<A>; | |
cxxRecordDecl(hasName("::X"), isTemplateInstantiation()) | |
matches the template instantiation of X<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<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>></td><td class="name" onclick="toggle('argumentCountIs0')"><a name="argumentCountIs0Anchor">argumentCountIs</a></td><td>unsigned N</td></tr> | |
<tr><td colspan="4" class="doc" id="argumentCountIs0"><pre>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); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CharacterLiteral.html">CharacterLiteral</a>></td><td class="name" onclick="toggle('equals3')"><a name="equals3Anchor">equals</a></td><td>ValueT Value</td></tr> | |
<tr><td colspan="4" class="doc" id="equals3"><pre>Matches literals that are equal to the given value. | |
Example matches true (matcher = cxxBoolLiteral(equals(true))) | |
true | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CharacterLiteral.html">CharacterLiteral</a>>, Matcher<CXXBoolLiteral>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FloatingLiteral.html">FloatingLiteral</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IntegerLiteral.html">IntegerLiteral</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ClassTemplateSpecializationDecl.html">ClassTemplateSpecializationDecl</a>></td><td class="name" onclick="toggle('templateArgumentCountIs0')"><a name="templateArgumentCountIs0Anchor">templateArgumentCountIs</a></td><td>unsigned N</td></tr> | |
<tr><td colspan="4" class="doc" id="templateArgumentCountIs0"><pre>Matches if the number of template arguments equals N. | |
Given | |
template<typename T> struct C {}; | |
C<int> c; | |
classTemplateSpecializationDecl(templateArgumentCountIs(1)) | |
matches C<int>. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CompoundStmt.html">CompoundStmt</a>></td><td class="name" onclick="toggle('statementCountIs0')"><a name="statementCountIs0Anchor">statementCountIs</a></td><td>unsigned N</td></tr> | |
<tr><td colspan="4" class="doc" id="statementCountIs0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ConstantArrayType.html">ConstantArrayType</a>></td><td class="name" onclick="toggle('hasSize0')"><a name="hasSize0Anchor">hasSize</a></td><td>unsigned N</td></tr> | |
<tr><td colspan="4" class="doc" id="hasSize0"><pre>Matches ConstantArrayType nodes that have the specified size. | |
Given | |
int a[42]; | |
int b[2 * 21]; | |
int c[41], d[43]; | |
constantArrayType(hasSize(42)) | |
matches "int a[42]" and "int b[2 * 21]" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclStmt.html">DeclStmt</a>></td><td class="name" onclick="toggle('declCountIs0')"><a name="declCountIs0Anchor">declCountIs</a></td><td>unsigned N</td></tr> | |
<tr><td colspan="4" class="doc" id="declCountIs0"><pre>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;'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('equalsBoundNode1')"><a name="equalsBoundNode1Anchor">equalsBoundNode</a></td><td>std::string ID</td></tr> | |
<tr><td colspan="4" class="doc" id="equalsBoundNode1"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('hasAttr0')"><a name="hasAttr0Anchor">hasAttr</a></td><td>attr::Kind AttrKind</td></tr> | |
<tr><td colspan="4" class="doc" id="hasAttr0"><pre>Matches declaration that has a given attribute. | |
Given | |
__attribute__((device)) void f() { ... } | |
decl(hasAttr(clang::attr::CUDADevice)) matches the function declaration of | |
f. If the matcher is use from clang-query, attr::Kind parameter should be | |
passed as a quoted string. e.g., hasAttr("attr::CUDADevice"). | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('isExpansionInFileMatching0')"><a name="isExpansionInFileMatching0Anchor">isExpansionInFileMatching</a></td><td>std::string RegExp</td></tr> | |
<tr><td colspan="4" class="doc" id="isExpansionInFileMatching0"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('isExpansionInMainFile0')"><a name="isExpansionInMainFile0Anchor">isExpansionInMainFile</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isExpansionInMainFile0"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('isExpansionInSystemHeader0')"><a name="isExpansionInSystemHeader0Anchor">isExpansionInSystemHeader</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isExpansionInSystemHeader0"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('isImplicit0')"><a name="isImplicit0Anchor">isImplicit</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isImplicit0"><pre>Matches a declaration that has been implicitly added | |
by the compiler (eg. implicit defaultcopy constructors). | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('isPrivate0')"><a name="isPrivate0Anchor">isPrivate</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isPrivate0"><pre>Matches private C++ declarations. | |
Given | |
class C { | |
public: int a; | |
protected: int b; | |
private: int c; | |
}; | |
fieldDecl(isPrivate()) | |
matches 'int c;' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('isProtected0')"><a name="isProtected0Anchor">isProtected</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isProtected0"><pre>Matches protected C++ declarations. | |
Given | |
class C { | |
public: int a; | |
protected: int b; | |
private: int c; | |
}; | |
fieldDecl(isProtected()) | |
matches 'int b;' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('isPublic0')"><a name="isPublic0Anchor">isPublic</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isPublic0"><pre>Matches public C++ declarations. | |
Given | |
class C { | |
public: int a; | |
protected: int b; | |
private: int c; | |
}; | |
fieldDecl(isPublic()) | |
matches 'int a;' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FloatingLiteral.html">FloatingLiteral</a>></td><td class="name" onclick="toggle('equals1')"><a name="equals1Anchor">equals</a></td><td>ValueT Value</td></tr> | |
<tr><td colspan="4" class="doc" id="equals1"><pre>Matches literals that are equal to the given value. | |
Example matches true (matcher = cxxBoolLiteral(equals(true))) | |
true | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CharacterLiteral.html">CharacterLiteral</a>>, Matcher<CXXBoolLiteral>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FloatingLiteral.html">FloatingLiteral</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IntegerLiteral.html">IntegerLiteral</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('hasOverloadedOperatorName0')"><a name="hasOverloadedOperatorName0Anchor">hasOverloadedOperatorName</a></td><td>StringRef Name</td></tr> | |
<tr><td colspan="4" class="doc" id="hasOverloadedOperatorName0"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXOperatorCallExpr.html">CXXOperatorCallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('isConstexpr1')"><a name="isConstexpr1Anchor">isConstexpr</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isConstexpr1"><pre>Matches constexpr variable and function declarations. | |
Given: | |
constexpr int foo = 42; | |
constexpr int bar(); | |
varDecl(isConstexpr()) | |
matches the declaration of foo. | |
functionDecl(isConstexpr()) | |
matches the declaration of bar. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('isDefinition2')"><a name="isDefinition2Anchor">isDefinition</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isDefinition2"><pre>Matches if a declaration has a body attached. | |
Example matches A, va, fa | |
class A {}; | |
class B; Doesn't match, as it has no body. | |
int va; | |
extern int vb; Doesn't match, as it doesn't define the variable. | |
void fa() {} | |
void fb(); Doesn't match, as it has no body. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagDecl.html">TagDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('isDeleted0')"><a name="isDeleted0Anchor">isDeleted</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isDeleted0"><pre>Matches deleted function declarations. | |
Given: | |
void Func(); | |
void DeletedFunc() = delete; | |
functionDecl(isDeleted()) | |
matches the declaration of DeletedFunc, but not Func. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('isExplicitTemplateSpecialization0')"><a name="isExplicitTemplateSpecialization0Anchor">isExplicitTemplateSpecialization</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isExplicitTemplateSpecialization0"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('isExternC0')"><a name="isExternC0Anchor">isExternC</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isExternC0"><pre>Matches extern "C" function declarations. | |
Given: | |
extern "C" void f() {} | |
extern "C" { void g() {} } | |
void h() {} | |
functionDecl(isExternC()) | |
matches the declaration of f and g, but not the declaration h | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('isInline1')"><a name="isInline1Anchor">isInline</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isInline1"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('isTemplateInstantiation0')"><a name="isTemplateInstantiation0Anchor">isTemplateInstantiation</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isTemplateInstantiation0"><pre>Matches template instantiations of function, class, or static | |
member variable template instantiations. | |
Given | |
template <typename T> class X {}; class A {}; X<A> x; | |
or | |
template <typename T> class X {}; class A {}; template class X<A>; | |
cxxRecordDecl(hasName("::X"), isTemplateInstantiation()) | |
matches the template instantiation of X<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<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('isVariadic0')"><a name="isVariadic0Anchor">isVariadic</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isVariadic0"><pre>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(); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('parameterCountIs0')"><a name="parameterCountIs0Anchor">parameterCountIs</a></td><td>unsigned N</td></tr> | |
<tr><td colspan="4" class="doc" id="parameterCountIs0"><pre>Matches FunctionDecls that have a specific parameter count. | |
Given | |
void f(int i) {} | |
void g(int i, int j) {} | |
functionDecl(parameterCountIs(2)) | |
matches g(int i, int j) {} | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IntegerLiteral.html">IntegerLiteral</a>></td><td class="name" onclick="toggle('equals0')"><a name="equals0Anchor">equals</a></td><td>ValueT Value</td></tr> | |
<tr><td colspan="4" class="doc" id="equals0"><pre>Matches literals that are equal to the given value. | |
Example matches true (matcher = cxxBoolLiteral(equals(true))) | |
true | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CharacterLiteral.html">CharacterLiteral</a>>, Matcher<CXXBoolLiteral>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FloatingLiteral.html">FloatingLiteral</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IntegerLiteral.html">IntegerLiteral</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>></td><td class="name" onclick="toggle('isArrow0')"><a name="isArrow0Anchor">isArrow</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isArrow0"><pre>Matches member expressions that are called with '->' as opposed | |
to '.'. | |
Member calls on the implicit this pointer match as called with '->'. | |
Given | |
class Y { | |
void x() { this->x(); x(); Y y; y.x(); a; this->b; Y::b; } | |
int a; | |
static int b; | |
}; | |
memberExpr(isArrow()) | |
matches this->x, x, y.x, a, this->b | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamedDecl.html">NamedDecl</a>></td><td class="name" onclick="toggle('hasName0')"><a name="hasName0Anchor">hasName</a></td><td>std::string Name</td></tr> | |
<tr><td colspan="4" class="doc" id="hasName0"><pre>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; } } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamedDecl.html">NamedDecl</a>></td><td class="name" onclick="toggle('matchesName0')"><a name="matchesName0Anchor">matchesName</a></td><td>std::string RegExp</td></tr> | |
<tr><td colspan="4" class="doc" id="matchesName0"><pre>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; } } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamespaceDecl.html">NamespaceDecl</a>></td><td class="name" onclick="toggle('isAnonymous0')"><a name="isAnonymous0Anchor">isAnonymous</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isAnonymous0"><pre>Matches anonymous namespace declarations. | |
Given | |
namespace n { | |
namespace {} #1 | |
} | |
namespaceDecl(isAnonymous()) will match #1 but not ::n. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamespaceDecl.html">NamespaceDecl</a>></td><td class="name" onclick="toggle('isInline0')"><a name="isInline0Anchor">isInline</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isInline0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMessageExpr.html">ObjCMessageExpr</a>></td><td class="name" onclick="toggle('argumentCountIs2')"><a name="argumentCountIs2Anchor">argumentCountIs</a></td><td>unsigned N</td></tr> | |
<tr><td colspan="4" class="doc" id="argumentCountIs2"><pre>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); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMessageExpr.html">ObjCMessageExpr</a>></td><td class="name" onclick="toggle('hasKeywordSelector0')"><a name="hasKeywordSelector0Anchor">hasKeywordSelector</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="hasKeywordSelector0"><pre>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 | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMessageExpr.html">ObjCMessageExpr</a>></td><td class="name" onclick="toggle('hasNullSelector0')"><a name="hasNullSelector0Anchor">hasNullSelector</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="hasNullSelector0"><pre>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! | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMessageExpr.html">ObjCMessageExpr</a>></td><td class="name" onclick="toggle('hasSelector0')"><a name="hasSelector0Anchor">hasSelector</a></td><td>std::string BaseName</td></tr> | |
<tr><td colspan="4" class="doc" id="hasSelector0"><pre>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]; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMessageExpr.html">ObjCMessageExpr</a>></td><td class="name" onclick="toggle('hasUnarySelector0')"><a name="hasUnarySelector0Anchor">hasUnarySelector</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="hasUnarySelector0"><pre>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]; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMessageExpr.html">ObjCMessageExpr</a>></td><td class="name" onclick="toggle('matchesSelector0')"><a name="matchesSelector0Anchor">matchesSelector</a></td><td>std::string RegExp</td></tr> | |
<tr><td colspan="4" class="doc" id="matchesSelector0"><pre>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]; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMessageExpr.html">ObjCMessageExpr</a>></td><td class="name" onclick="toggle('numSelectorArgs0')"><a name="numSelectorArgs0Anchor">numSelectorArgs</a></td><td>unsigned N</td></tr> | |
<tr><td colspan="4" class="doc" id="numSelectorArgs0"><pre>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]; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('asString0')"><a name="asString0Anchor">asString</a></td><td>std::string Name</td></tr> | |
<tr><td colspan="4" class="doc" id="asString0"><pre>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() | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('equalsBoundNode3')"><a name="equalsBoundNode3Anchor">equalsBoundNode</a></td><td>std::string ID</td></tr> | |
<tr><td colspan="4" class="doc" id="equalsBoundNode3"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('hasLocalQualifiers0')"><a name="hasLocalQualifiers0Anchor">hasLocalQualifiers</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="hasLocalQualifiers0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('isConstQualified0')"><a name="isConstQualified0Anchor">isConstQualified</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isConstQualified0"><pre>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 *". | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('isInteger0')"><a name="isInteger0Anchor">isInteger</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isInteger0"><pre>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)". | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordDecl.html">RecordDecl</a>></td><td class="name" onclick="toggle('isClass0')"><a name="isClass0Anchor">isClass</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isClass0"><pre>Matches RecordDecl object that are spelled with "class." | |
Example matches C, but not S or U. | |
struct S {}; | |
class C {}; | |
union U {}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordDecl.html">RecordDecl</a>></td><td class="name" onclick="toggle('isStruct0')"><a name="isStruct0Anchor">isStruct</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isStruct0"><pre>Matches RecordDecl object that are spelled with "struct." | |
Example matches S, but not C or U. | |
struct S {}; | |
class C {}; | |
union U {}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordDecl.html">RecordDecl</a>></td><td class="name" onclick="toggle('isUnion0')"><a name="isUnion0Anchor">isUnion</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isUnion0"><pre>Matches RecordDecl object that are spelled with "union." | |
Example matches U, but not C or S. | |
struct S {}; | |
class C {}; | |
union U {}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('equalsBoundNode0')"><a name="equalsBoundNode0Anchor">equalsBoundNode</a></td><td>std::string ID</td></tr> | |
<tr><td colspan="4" class="doc" id="equalsBoundNode0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('isExpansionInFileMatching1')"><a name="isExpansionInFileMatching1Anchor">isExpansionInFileMatching</a></td><td>std::string RegExp</td></tr> | |
<tr><td colspan="4" class="doc" id="isExpansionInFileMatching1"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('isExpansionInMainFile1')"><a name="isExpansionInMainFile1Anchor">isExpansionInMainFile</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isExpansionInMainFile1"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('isExpansionInSystemHeader1')"><a name="isExpansionInSystemHeader1Anchor">isExpansionInSystemHeader</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isExpansionInSystemHeader1"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagDecl.html">TagDecl</a>></td><td class="name" onclick="toggle('isDefinition0')"><a name="isDefinition0Anchor">isDefinition</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isDefinition0"><pre>Matches if a declaration has a body attached. | |
Example matches A, va, fa | |
class A {}; | |
class B; Doesn't match, as it has no body. | |
int va; | |
extern int vb; Doesn't match, as it doesn't define the variable. | |
void fa() {} | |
void fb(); Doesn't match, as it has no body. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagDecl.html">TagDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>></td><td class="name" onclick="toggle('equalsIntegralValue0')"><a name="equalsIntegralValue0Anchor">equalsIntegralValue</a></td><td>std::string Value</td></tr> | |
<tr><td colspan="4" class="doc" id="equalsIntegralValue0"><pre>Matches a TemplateArgument of integral type with a given value. | |
Note that 'Value' is a string as the template argument's value is | |
an arbitrary precision integer. 'Value' must be euqal to the canonical | |
representation of that integral value in base 10. | |
Given | |
template<int T> struct A {}; | |
C<42> c; | |
classTemplateSpecializationDecl( | |
hasAnyTemplateArgument(equalsIntegralValue("42"))) | |
matches the implicit instantiation of C in C<42>. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>></td><td class="name" onclick="toggle('isIntegral0')"><a name="isIntegral0Anchor">isIntegral</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isIntegral0"><pre>Matches a TemplateArgument that is an integral value. | |
Given | |
template<int T> struct A {}; | |
C<42> c; | |
classTemplateSpecializationDecl( | |
hasAnyTemplateArgument(isIntegral())) | |
matches the implicit instantiation of C in C<42> | |
with isIntegral() matching 42. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>></td><td class="name" onclick="toggle('templateArgumentCountIs1')"><a name="templateArgumentCountIs1Anchor">templateArgumentCountIs</a></td><td>unsigned N</td></tr> | |
<tr><td colspan="4" class="doc" id="templateArgumentCountIs1"><pre>Matches if the number of template arguments equals N. | |
Given | |
template<typename T> struct C {}; | |
C<int> c; | |
classTemplateSpecializationDecl(templateArgumentCountIs(1)) | |
matches C<int>. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>></td><td class="name" onclick="toggle('isExpansionInFileMatching2')"><a name="isExpansionInFileMatching2Anchor">isExpansionInFileMatching</a></td><td>std::string RegExp</td></tr> | |
<tr><td colspan="4" class="doc" id="isExpansionInFileMatching2"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>></td><td class="name" onclick="toggle('isExpansionInMainFile2')"><a name="isExpansionInMainFile2Anchor">isExpansionInMainFile</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isExpansionInMainFile2"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>></td><td class="name" onclick="toggle('isExpansionInSystemHeader2')"><a name="isExpansionInSystemHeader2Anchor">isExpansionInSystemHeader</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isExpansionInSystemHeader2"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('equalsBoundNode2')"><a name="equalsBoundNode2Anchor">equalsBoundNode</a></td><td>std::string ID</td></tr> | |
<tr><td colspan="4" class="doc" id="equalsBoundNode2"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('voidType0')"><a name="voidType0Anchor">voidType</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="voidType0"><pre>Matches type void. | |
Given | |
struct S { void func(); }; | |
functionDecl(returns(voidType())) | |
matches "void func();" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnaryExprOrTypeTraitExpr.html">UnaryExprOrTypeTraitExpr</a>></td><td class="name" onclick="toggle('ofKind0')"><a name="ofKind0Anchor">ofKind</a></td><td>UnaryExprOrTypeTrait Kind</td></tr> | |
<tr><td colspan="4" class="doc" id="ofKind0"><pre>Matches unary expressions of a certain kind. | |
Given | |
int x; | |
int s = sizeof(x) + alignof(x) | |
unaryExprOrTypeTraitExpr(ofKind(UETT_SizeOf)) | |
matches sizeof(x) | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnaryOperator.html">UnaryOperator</a>></td><td class="name" onclick="toggle('hasOperatorName1')"><a name="hasOperatorName1Anchor">hasOperatorName</a></td><td>std::string Name</td></tr> | |
<tr><td colspan="4" class="doc" id="hasOperatorName1"><pre>Matches the operator Name of operator expressions (binary or | |
unary). | |
Example matches a || b (matcher = binaryOperator(hasOperatorName("||"))) | |
!(a || b) | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>></td><td class="name" onclick="toggle('hasGlobalStorage0')"><a name="hasGlobalStorage0Anchor">hasGlobalStorage</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="hasGlobalStorage0"><pre>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; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>></td><td class="name" onclick="toggle('hasLocalStorage0')"><a name="hasLocalStorage0Anchor">hasLocalStorage</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="hasLocalStorage0"><pre>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; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>></td><td class="name" onclick="toggle('isConstexpr0')"><a name="isConstexpr0Anchor">isConstexpr</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isConstexpr0"><pre>Matches constexpr variable and function declarations. | |
Given: | |
constexpr int foo = 42; | |
constexpr int bar(); | |
varDecl(isConstexpr()) | |
matches the declaration of foo. | |
functionDecl(isConstexpr()) | |
matches the declaration of bar. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>></td><td class="name" onclick="toggle('isDefinition1')"><a name="isDefinition1Anchor">isDefinition</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isDefinition1"><pre>Matches if a declaration has a body attached. | |
Example matches A, va, fa | |
class A {}; | |
class B; Doesn't match, as it has no body. | |
int va; | |
extern int vb; Doesn't match, as it doesn't define the variable. | |
void fa() {} | |
void fb(); Doesn't match, as it has no body. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagDecl.html">TagDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>></td><td class="name" onclick="toggle('isExceptionVariable0')"><a name="isExceptionVariable0Anchor">isExceptionVariable</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isExceptionVariable0"><pre>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) { | |
} | |
} | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>></td><td class="name" onclick="toggle('isExplicitTemplateSpecialization1')"><a name="isExplicitTemplateSpecialization1Anchor">isExplicitTemplateSpecialization</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isExplicitTemplateSpecialization1"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>></td><td class="name" onclick="toggle('isTemplateInstantiation1')"><a name="isTemplateInstantiation1Anchor">isTemplateInstantiation</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isTemplateInstantiation1"><pre>Matches template instantiations of function, class, or static | |
member variable template instantiations. | |
Given | |
template <typename T> class X {}; class A {}; X<A> x; | |
or | |
template <typename T> class X {}; class A {}; template class X<A>; | |
cxxRecordDecl(hasName("::X"), isTemplateInstantiation()) | |
matches the template instantiation of X<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<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<internal::Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>>></td><td class="name" onclick="toggle('isInstantiated0')"><a name="isInstantiated0Anchor">isInstantiated</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isInstantiated0"><pre>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) {...}'. | |
</pre></td></tr> | |
<tr><td>Matcher<internal::Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>>></td><td class="name" onclick="toggle('isInTemplateInstantiation0')"><a name="isInTemplateInstantiation0Anchor">isInTemplateInstantiation</a></td><td></td></tr> | |
<tr><td colspan="4" class="doc" id="isInTemplateInstantiation0"><pre>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. | |
</pre></td></tr> | |
<!--END_NARROWING_MATCHERS --> | |
</table> | |
<!-- ======================================================================= --> | |
<h2 id="traversal-matchers">AST Traversal Matchers</h2> | |
<!-- ======================================================================= --> | |
<p>Traversal matchers specify the relationship to other nodes that are | |
reachable from the current node.</p> | |
<p>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.</p> | |
<table> | |
<tr style="text-align:left"><th>Return type</th><th>Name</th><th>Parameters</th></tr> | |
<!-- START_TRAVERSAL_MATCHERS --> | |
<tr><td>Matcher<*></td><td class="name" onclick="toggle('eachOf0')"><a name="eachOf0Anchor">eachOf</a></td><td>Matcher<*>, ..., Matcher<*></td></tr> | |
<tr><td colspan="4" class="doc" id="eachOf0"><pre>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 | |
</pre></td></tr> | |
<tr><td>Matcher<*></td><td class="name" onclick="toggle('forEachDescendant0')"><a name="forEachDescendant0Anchor">forEachDescendant</a></td><td>Matcher<*></td></tr> | |
<tr><td colspan="4" class="doc" id="forEachDescendant0"><pre>Matches AST nodes that have descendant AST nodes that match the | |
provided matcher. | |
Example matches X, A, B, C | |
(matcher = cxxRecordDecl(forEachDescendant(cxxRecordDecl(hasName("X"))))) | |
class X {}; Matches X, because X::X is a class of name X inside X. | |
class A { class X {}; }; | |
class B { class C { class X {}; }; }; | |
DescendantT must be an AST base type. | |
As opposed to 'hasDescendant', 'forEachDescendant' will cause a match for | |
each result that matches instead of only on the first one. | |
Note: Recursively combined ForEachDescendant can cause many matches: | |
cxxRecordDecl(forEachDescendant(cxxRecordDecl( | |
forEachDescendant(cxxRecordDecl()) | |
))) | |
will match 10 times (plus injected class name matches) on: | |
class A { class B { class C { class D { class E {}; }; }; }; }; | |
Usable as: Any Matcher | |
</pre></td></tr> | |
<tr><td>Matcher<*></td><td class="name" onclick="toggle('forEach0')"><a name="forEach0Anchor">forEach</a></td><td>Matcher<*></td></tr> | |
<tr><td colspan="4" class="doc" id="forEach0"><pre>Matches AST nodes that have child AST nodes that match the | |
provided matcher. | |
Example matches X, Y | |
(matcher = cxxRecordDecl(forEach(cxxRecordDecl(hasName("X"))) | |
class X {}; Matches X, because X::X is a class of name X inside X. | |
class Y { class X {}; }; | |
class Z { class Y { class X {}; }; }; Does not match Z. | |
ChildT must be an AST base type. | |
As opposed to 'has', 'forEach' will cause a match for each result that | |
matches instead of only on the first one. | |
Usable as: Any Matcher | |
</pre></td></tr> | |
<tr><td>Matcher<*></td><td class="name" onclick="toggle('hasAncestor0')"><a name="hasAncestor0Anchor">hasAncestor</a></td><td>Matcher<*></td></tr> | |
<tr><td colspan="4" class="doc" id="hasAncestor0"><pre>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 | |
</pre></td></tr> | |
<tr><td>Matcher<*></td><td class="name" onclick="toggle('hasDescendant0')"><a name="hasDescendant0Anchor">hasDescendant</a></td><td>Matcher<*></td></tr> | |
<tr><td colspan="4" class="doc" id="hasDescendant0"><pre>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 | |
</pre></td></tr> | |
<tr><td>Matcher<*></td><td class="name" onclick="toggle('has0')"><a name="has0Anchor">has</a></td><td>Matcher<*></td></tr> | |
<tr><td colspan="4" class="doc" id="has0"><pre>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 | |
</pre></td></tr> | |
<tr><td>Matcher<*></td><td class="name" onclick="toggle('hasParent0')"><a name="hasParent0Anchor">hasParent</a></td><td>Matcher<*></td></tr> | |
<tr><td colspan="4" class="doc" id="hasParent0"><pre>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 | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ArraySubscriptExpr.html">ArraySubscriptExpr</a>></td><td class="name" onclick="toggle('hasBase0')"><a name="hasBase0Anchor">hasBase</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasBase0"><pre>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 | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ArraySubscriptExpr.html">ArraySubscriptExpr</a>></td><td class="name" onclick="toggle('hasIndex0')"><a name="hasIndex0Anchor">hasIndex</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasIndex0"><pre>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 | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ArrayTypeLoc.html">ArrayTypeLoc</a>></td><td class="name" onclick="toggle('hasElementTypeLoc0')"><a name="hasElementTypeLoc0Anchor">hasElementTypeLoc</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="hasElementTypeLoc0"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1ArrayType.html">ArrayType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ComplexType.html">ComplexType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ArrayType.html">ArrayType</a>></td><td class="name" onclick="toggle('hasElementType0')"><a name="hasElementType0Anchor">hasElementType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="hasElementType0"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1ArrayType.html">ArrayType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ComplexType.html">ComplexType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AtomicTypeLoc.html">AtomicTypeLoc</a>></td><td class="name" onclick="toggle('hasValueTypeLoc0')"><a name="hasValueTypeLoc0Anchor">hasValueTypeLoc</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="hasValueTypeLoc0"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1AtomicType.html">AtomicType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AtomicType.html">AtomicType</a>></td><td class="name" onclick="toggle('hasValueType0')"><a name="hasValueType0Anchor">hasValueType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="hasValueType0"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1AtomicType.html">AtomicType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AutoType.html">AutoType</a>></td><td class="name" onclick="toggle('hasDeducedType0')"><a name="hasDeducedType0Anchor">hasDeducedType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeducedType0"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1AutoType.html">AutoType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BinaryOperator.html">BinaryOperator</a>></td><td class="name" onclick="toggle('hasEitherOperand0')"><a name="hasEitherOperand0Anchor">hasEitherOperand</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasEitherOperand0"><pre>Matches if either the left hand side or the right hand side of a | |
binary operator matches. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BinaryOperator.html">BinaryOperator</a>></td><td class="name" onclick="toggle('hasLHS0')"><a name="hasLHS0Anchor">hasLHS</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasLHS0"><pre>Matches the left hand side of binary operator expressions. | |
Example matches a (matcher = binaryOperator(hasLHS())) | |
a || b | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BinaryOperator.html">BinaryOperator</a>></td><td class="name" onclick="toggle('hasRHS0')"><a name="hasRHS0Anchor">hasRHS</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasRHS0"><pre>Matches the right hand side of binary operator expressions. | |
Example matches b (matcher = binaryOperator(hasRHS())) | |
a || b | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BlockPointerTypeLoc.html">BlockPointerTypeLoc</a>></td><td class="name" onclick="toggle('pointeeLoc0')"><a name="pointeeLoc0Anchor">pointeeLoc</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="pointeeLoc0"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1BlockPointerType.html">BlockPointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberPointerType.html">MemberPointerType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1PointerType.html">PointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ReferenceType.html">ReferenceType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BlockPointerType.html">BlockPointerType</a>></td><td class="name" onclick="toggle('pointee0')"><a name="pointee0Anchor">pointee</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="pointee0"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1BlockPointerType.html">BlockPointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberPointerType.html">MemberPointerType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1PointerType.html">PointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ReferenceType.html">ReferenceType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>></td><td class="name" onclick="toggle('hasAnyArgument1')"><a name="hasAnyArgument1Anchor">hasAnyArgument</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasAnyArgument1"><pre>Matches any argument of a call expression or a constructor call | |
expression. | |
Given | |
void x(int, int, int) { int y; x(1, y, 42); } | |
callExpr(hasAnyArgument(declRefExpr())) | |
matches x(1, y, 42) | |
with hasAnyArgument(...) | |
matching y | |
FIXME: Currently this will ignore parentheses and implicit casts on | |
the argument before applying the inner matcher. We'll want to remove | |
this to allow for greater control by the user once ignoreImplicit() | |
has been implemented. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>></td><td class="name" onclick="toggle('hasArgument1')"><a name="hasArgument1Anchor">hasArgument</a></td><td>unsigned N, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasArgument1"><pre>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); } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>></td><td class="name" onclick="toggle('hasDeclaration12')"><a name="hasDeclaration12Anchor">hasDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclaration12"><pre>Matches a node if the declaration associated with that node | |
matches the given matcher. | |
The associated declaration is: | |
- for type nodes, the declaration of the underlying type | |
- for CallExpr, the declaration of the callee | |
- for MemberExpr, the declaration of the referenced member | |
- for CXXConstructExpr, the declaration of the constructor | |
Also usable as Matcher<T> for any T supporting the getDecl() member | |
function. e.g. various subtypes of clang::Type and various expressions. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructorDecl.html">CXXConstructorDecl</a>></td><td class="name" onclick="toggle('forEachConstructorInitializer0')"><a name="forEachConstructorInitializer0Anchor">forEachConstructorInitializer</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXCtorInitializer.html">CXXCtorInitializer</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="forEachConstructorInitializer0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructorDecl.html">CXXConstructorDecl</a>></td><td class="name" onclick="toggle('hasAnyConstructorInitializer0')"><a name="hasAnyConstructorInitializer0Anchor">hasAnyConstructorInitializer</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXCtorInitializer.html">CXXCtorInitializer</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasAnyConstructorInitializer0"><pre>Matches a constructor initializer. | |
Given | |
struct Foo { | |
Foo() : foo_(1) { } | |
int foo_; | |
}; | |
cxxRecordDecl(has(cxxConstructorDecl( | |
hasAnyConstructorInitializer(anything()) | |
))) | |
record matches Foo, hasAnyConstructorInitializer matches foo_(1) | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXCtorInitializer.html">CXXCtorInitializer</a>></td><td class="name" onclick="toggle('forField0')"><a name="forField0Anchor">forField</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FieldDecl.html">FieldDecl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="forField0"><pre>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_ | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXCtorInitializer.html">CXXCtorInitializer</a>></td><td class="name" onclick="toggle('withInitializer0')"><a name="withInitializer0Anchor">withInitializer</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="withInitializer0"><pre>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) | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXForRangeStmt.html">CXXForRangeStmt</a>></td><td class="name" onclick="toggle('hasBody3')"><a name="hasBody3Anchor">hasBody</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasBody3"><pre>Matches a 'for', 'while', or 'do while' statement that has | |
a given body. | |
Given | |
for (;;) {} | |
hasBody(compoundStmt()) | |
matches 'for (;;) {}' | |
with compoundStmt() | |
matching '{}' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXForRangeStmt.html">CXXForRangeStmt</a>></td><td class="name" onclick="toggle('hasLoopVariable0')"><a name="hasLoopVariable0Anchor">hasLoopVariable</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasLoopVariable0"><pre>Matches the initialization statement of a for loop. | |
Example: | |
forStmt(hasLoopVariable(anything())) | |
matches 'int x' in | |
for (int x : a) { } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXForRangeStmt.html">CXXForRangeStmt</a>></td><td class="name" onclick="toggle('hasRangeInit0')"><a name="hasRangeInit0Anchor">hasRangeInit</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasRangeInit0"><pre>Matches the range initialization statement of a for loop. | |
Example: | |
forStmt(hasRangeInit(anything())) | |
matches 'a' in | |
for (int x : a) { } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMemberCallExpr.html">CXXMemberCallExpr</a>></td><td class="name" onclick="toggle('onImplicitObjectArgument0')"><a name="onImplicitObjectArgument0Anchor">onImplicitObjectArgument</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="onImplicitObjectArgument0"><pre></pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMemberCallExpr.html">CXXMemberCallExpr</a>></td><td class="name" onclick="toggle('on0')"><a name="on0Anchor">on</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="on0"><pre>Matches on the implicit object argument of a member call expression. | |
Example matches y.x() | |
(matcher = cxxMemberCallExpr(on(hasType(cxxRecordDecl(hasName("Y")))))) | |
class Y { public: void x(); }; | |
void z() { Y y; y.x(); }", | |
FIXME: Overload to allow directly matching types? | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMemberCallExpr.html">CXXMemberCallExpr</a>></td><td class="name" onclick="toggle('thisPointerType1')"><a name="thisPointerType1Anchor">thisPointerType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="thisPointerType1"><pre>Overloaded to match the type's declaration. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMemberCallExpr.html">CXXMemberCallExpr</a>></td><td class="name" onclick="toggle('thisPointerType0')"><a name="thisPointerType0Anchor">thisPointerType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="thisPointerType0"><pre>Matches if the expression's type either matches the specified | |
matcher, or is a pointer to a type that matches the InnerMatcher. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMethodDecl.html">CXXMethodDecl</a>></td><td class="name" onclick="toggle('ofClass0')"><a name="ofClass0Anchor">ofClass</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="ofClass0"><pre>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(); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>></td><td class="name" onclick="toggle('hasMethod0')"><a name="hasMethod0Anchor">hasMethod</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMethodDecl.html">CXXMethodDecl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasMethod0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>></td><td class="name" onclick="toggle('isDerivedFrom0')"><a name="isDerivedFrom0Anchor">isDerivedFrom</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamedDecl.html">NamedDecl</a>> Base</td></tr> | |
<tr><td colspan="4" class="doc" id="isDerivedFrom0"><pre>Matches C++ classes that are directly or indirectly derived from | |
a class matching Base. | |
Note that a class is not considered to be derived from itself. | |
Example matches Y, Z, C (Base == hasName("X")) | |
class X; | |
class Y : public X {}; directly derived | |
class Z : public Y {}; indirectly derived | |
typedef X A; | |
typedef A B; | |
class C : public B {}; derived from a typedef of X | |
In the following example, Bar matches isDerivedFrom(hasName("X")): | |
class Foo; | |
typedef Foo X; | |
class Bar : public Foo {}; derived from a type that X is a typedef of | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>></td><td class="name" onclick="toggle('isSameOrDerivedFrom0')"><a name="isSameOrDerivedFrom0Anchor">isSameOrDerivedFrom</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamedDecl.html">NamedDecl</a>> Base</td></tr> | |
<tr><td colspan="4" class="doc" id="isSameOrDerivedFrom0"><pre>Similar to isDerivedFrom(), but also matches classes that directly | |
match Base. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>></td><td class="name" onclick="toggle('callee1')"><a name="callee1Anchor">callee</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="callee1"><pre>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(); } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>></td><td class="name" onclick="toggle('callee0')"><a name="callee0Anchor">callee</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="callee0"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> | |
because this introduces ambiguous overloads with calls to Callee taking a | |
internal::Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>>, as the matcher hierarchy is purely | |
implemented in terms of implicit casts. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>></td><td class="name" onclick="toggle('hasAnyArgument0')"><a name="hasAnyArgument0Anchor">hasAnyArgument</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasAnyArgument0"><pre>Matches any argument of a call expression or a constructor call | |
expression. | |
Given | |
void x(int, int, int) { int y; x(1, y, 42); } | |
callExpr(hasAnyArgument(declRefExpr())) | |
matches x(1, y, 42) | |
with hasAnyArgument(...) | |
matching y | |
FIXME: Currently this will ignore parentheses and implicit casts on | |
the argument before applying the inner matcher. We'll want to remove | |
this to allow for greater control by the user once ignoreImplicit() | |
has been implemented. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>></td><td class="name" onclick="toggle('hasArgument0')"><a name="hasArgument0Anchor">hasArgument</a></td><td>unsigned N, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasArgument0"><pre>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); } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>></td><td class="name" onclick="toggle('hasDeclaration13')"><a name="hasDeclaration13Anchor">hasDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclaration13"><pre>Matches a node if the declaration associated with that node | |
matches the given matcher. | |
The associated declaration is: | |
- for type nodes, the declaration of the underlying type | |
- for CallExpr, the declaration of the callee | |
- for MemberExpr, the declaration of the referenced member | |
- for CXXConstructExpr, the declaration of the constructor | |
Also usable as Matcher<T> for any T supporting the getDecl() member | |
function. e.g. various subtypes of clang::Type and various expressions. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CaseStmt.html">CaseStmt</a>></td><td class="name" onclick="toggle('hasCaseConstant0')"><a name="hasCaseConstant0Anchor">hasCaseConstant</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasCaseConstant0"><pre>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:" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CastExpr.html">CastExpr</a>></td><td class="name" onclick="toggle('hasSourceExpression0')"><a name="hasSourceExpression0Anchor">hasSourceExpression</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasSourceExpression0"><pre>Matches if the cast's source expression matches the given matcher. | |
Example: matches "a string" (matcher = | |
hasSourceExpression(cxxConstructExpr())) | |
class URL { URL(string); }; | |
URL url = "a string"; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ClassTemplateSpecializationDecl.html">ClassTemplateSpecializationDecl</a>></td><td class="name" onclick="toggle('hasAnyTemplateArgument0')"><a name="hasAnyTemplateArgument0Anchor">hasAnyTemplateArgument</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasAnyTemplateArgument0"><pre>Matches classTemplateSpecializations that have at least one | |
TemplateArgument matching the given InnerMatcher. | |
Given | |
template<typename T> class A {}; | |
template<> class A<double> {}; | |
A<int> a; | |
classTemplateSpecializationDecl(hasAnyTemplateArgument( | |
refersToType(asString("int")))) | |
matches the specialization A<int> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ClassTemplateSpecializationDecl.html">ClassTemplateSpecializationDecl</a>></td><td class="name" onclick="toggle('hasTemplateArgument0')"><a name="hasTemplateArgument0Anchor">hasTemplateArgument</a></td><td>unsigned N, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasTemplateArgument0"><pre>Matches classTemplateSpecializations where the n'th TemplateArgument | |
matches the given InnerMatcher. | |
Given | |
template<typename T, typename U> class A {}; | |
A<bool, int> b; | |
A<int, bool> c; | |
classTemplateSpecializationDecl(hasTemplateArgument( | |
1, refersToType(asString("int")))) | |
matches the specialization A<bool, int> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ComplexTypeLoc.html">ComplexTypeLoc</a>></td><td class="name" onclick="toggle('hasElementTypeLoc1')"><a name="hasElementTypeLoc1Anchor">hasElementTypeLoc</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="hasElementTypeLoc1"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1ArrayType.html">ArrayType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ComplexType.html">ComplexType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ComplexType.html">ComplexType</a>></td><td class="name" onclick="toggle('hasElementType1')"><a name="hasElementType1Anchor">hasElementType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="hasElementType1"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1ArrayType.html">ArrayType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ComplexType.html">ComplexType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CompoundStmt.html">CompoundStmt</a>></td><td class="name" onclick="toggle('hasAnySubstatement0')"><a name="hasAnySubstatement0Anchor">hasAnySubstatement</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasAnySubstatement0"><pre>Matches compound statements where at least one substatement matches | |
a given matcher. | |
Given | |
{ {}; 1+2; } | |
hasAnySubstatement(compoundStmt()) | |
matches '{ {}; 1+2; }' | |
with compoundStmt() | |
matching '{}' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ConditionalOperator.html">ConditionalOperator</a>></td><td class="name" onclick="toggle('hasCondition4')"><a name="hasCondition4Anchor">hasCondition</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasCondition4"><pre>Matches the condition expression of an if statement, for loop, | |
or conditional operator. | |
Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true)))) | |
if (true) {} | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ConditionalOperator.html">ConditionalOperator</a>></td><td class="name" onclick="toggle('hasFalseExpression0')"><a name="hasFalseExpression0Anchor">hasFalseExpression</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasFalseExpression0"><pre>Matches the false branch expression of a conditional operator. | |
Example matches b | |
condition ? a : b | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ConditionalOperator.html">ConditionalOperator</a>></td><td class="name" onclick="toggle('hasTrueExpression0')"><a name="hasTrueExpression0Anchor">hasTrueExpression</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasTrueExpression0"><pre>Matches the true branch expression of a conditional operator. | |
Example matches a | |
condition ? a : b | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DecayedType.html">DecayedType</a>></td><td class="name" onclick="toggle('hasDecayedType0')"><a name="hasDecayedType0Anchor">hasDecayedType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerType</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDecayedType0"><pre>Matches the decayed type, whos decayed type matches InnerMatcher | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>></td><td class="name" onclick="toggle('hasDeclaration11')"><a name="hasDeclaration11Anchor">hasDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclaration11"><pre>Matches a node if the declaration associated with that node | |
matches the given matcher. | |
The associated declaration is: | |
- for type nodes, the declaration of the underlying type | |
- for CallExpr, the declaration of the callee | |
- for MemberExpr, the declaration of the referenced member | |
- for CXXConstructExpr, the declaration of the constructor | |
Also usable as Matcher<T> for any T supporting the getDecl() member | |
function. e.g. various subtypes of clang::Type and various expressions. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>></td><td class="name" onclick="toggle('throughUsingDecl0')"><a name="throughUsingDecl0Anchor">throughUsingDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UsingShadowDecl.html">UsingShadowDecl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="throughUsingDecl0"><pre>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() | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>></td><td class="name" onclick="toggle('to0')"><a name="to0Anchor">to</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="to0"><pre>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) {} | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclStmt.html">DeclStmt</a>></td><td class="name" onclick="toggle('containsDeclaration0')"><a name="containsDeclaration0Anchor">containsDeclaration</a></td><td>unsigned N, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="containsDeclaration0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclStmt.html">DeclStmt</a>></td><td class="name" onclick="toggle('hasSingleDecl0')"><a name="hasSingleDecl0Anchor">hasSingleDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasSingleDecl0"><pre>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;'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclaratorDecl.html">DeclaratorDecl</a>></td><td class="name" onclick="toggle('hasTypeLoc0')"><a name="hasTypeLoc0Anchor">hasTypeLoc</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>> Inner</td></tr> | |
<tr><td colspan="4" class="doc" id="hasTypeLoc0"><pre>Matches if the type location of the declarator decl's type matches | |
the inner matcher. | |
Given | |
int x; | |
declaratorDecl(hasTypeLoc(loc(asString("int")))) | |
matches int x | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('hasDeclContext0')"><a name="hasDeclContext0Anchor">hasDeclContext</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclContext0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DoStmt.html">DoStmt</a>></td><td class="name" onclick="toggle('hasBody0')"><a name="hasBody0Anchor">hasBody</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasBody0"><pre>Matches a 'for', 'while', or 'do while' statement that has | |
a given body. | |
Given | |
for (;;) {} | |
hasBody(compoundStmt()) | |
matches 'for (;;) {}' | |
with compoundStmt() | |
matching '{}' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DoStmt.html">DoStmt</a>></td><td class="name" onclick="toggle('hasCondition3')"><a name="hasCondition3Anchor">hasCondition</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasCondition3"><pre>Matches the condition expression of an if statement, for loop, | |
or conditional operator. | |
Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true)))) | |
if (true) {} | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ElaboratedType.html">ElaboratedType</a>></td><td class="name" onclick="toggle('hasQualifier0')"><a name="hasQualifier0Anchor">hasQualifier</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NestedNameSpecifier.html">NestedNameSpecifier</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasQualifier0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ElaboratedType.html">ElaboratedType</a>></td><td class="name" onclick="toggle('namesType0')"><a name="namesType0Anchor">namesType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="namesType0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>></td><td class="name" onclick="toggle('hasDeclaration10')"><a name="hasDeclaration10Anchor">hasDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclaration10"><pre>Matches a node if the declaration associated with that node | |
matches the given matcher. | |
The associated declaration is: | |
- for type nodes, the declaration of the underlying type | |
- for CallExpr, the declaration of the callee | |
- for MemberExpr, the declaration of the referenced member | |
- for CXXConstructExpr, the declaration of the constructor | |
Also usable as Matcher<T> for any T supporting the getDecl() member | |
function. e.g. various subtypes of clang::Type and various expressions. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ExplicitCastExpr.html">ExplicitCastExpr</a>></td><td class="name" onclick="toggle('hasDestinationType0')"><a name="hasDestinationType0Anchor">hasDestinationType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDestinationType0"><pre>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.) | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>></td><td class="name" onclick="toggle('hasType2')"><a name="hasType2Anchor">hasType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasType2"><pre>Overloaded to match the declaration of the expression's or value | |
declaration's type. | |
In case of a value declaration (for example a variable declaration), | |
this resolves one layer of indirection. For example, in the value | |
declaration "X x;", cxxRecordDecl(hasName("X")) matches the declaration of | |
X, while varDecl(hasType(cxxRecordDecl(hasName("X")))) matches the | |
declaration of x. | |
Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X"))))) | |
and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X"))))) | |
class X {}; | |
void y(X &x) { x; X z; } | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ValueDecl.html">ValueDecl</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>></td><td class="name" onclick="toggle('hasType0')"><a name="hasType0Anchor">hasType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasType0"><pre>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"))))) | |
class X {}; | |
void y(X &x) { x; X z; } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>></td><td class="name" onclick="toggle('ignoringImpCasts0')"><a name="ignoringImpCasts0Anchor">ignoringImpCasts</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="ignoringImpCasts0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>></td><td class="name" onclick="toggle('ignoringParenCasts0')"><a name="ignoringParenCasts0Anchor">ignoringParenCasts</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="ignoringParenCasts0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>></td><td class="name" onclick="toggle('ignoringParenImpCasts0')"><a name="ignoringParenImpCasts0Anchor">ignoringParenImpCasts</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="ignoringParenImpCasts0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ForStmt.html">ForStmt</a>></td><td class="name" onclick="toggle('hasBody1')"><a name="hasBody1Anchor">hasBody</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasBody1"><pre>Matches a 'for', 'while', or 'do while' statement that has | |
a given body. | |
Given | |
for (;;) {} | |
hasBody(compoundStmt()) | |
matches 'for (;;) {}' | |
with compoundStmt() | |
matching '{}' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ForStmt.html">ForStmt</a>></td><td class="name" onclick="toggle('hasCondition1')"><a name="hasCondition1Anchor">hasCondition</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasCondition1"><pre>Matches the condition expression of an if statement, for loop, | |
or conditional operator. | |
Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true)))) | |
if (true) {} | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ForStmt.html">ForStmt</a>></td><td class="name" onclick="toggle('hasIncrement0')"><a name="hasIncrement0Anchor">hasIncrement</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasIncrement0"><pre>Matches the increment statement of a for loop. | |
Example: | |
forStmt(hasIncrement(unaryOperator(hasOperatorName("++")))) | |
matches '++x' in | |
for (x; x < N; ++x) { } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ForStmt.html">ForStmt</a>></td><td class="name" onclick="toggle('hasLoopInit0')"><a name="hasLoopInit0Anchor">hasLoopInit</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasLoopInit0"><pre>Matches the initialization statement of a for loop. | |
Example: | |
forStmt(hasLoopInit(declStmt())) | |
matches 'int x = 0' in | |
for (int x = 0; x < N; ++x) { } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('hasAnyParameter0')"><a name="hasAnyParameter0Anchor">hasAnyParameter</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParmVarDecl.html">ParmVarDecl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasAnyParameter0"><pre>Matches any parameter of a function declaration. | |
Does not match the 'this' parameter of a method. | |
Given | |
class X { void f(int x, int y, int z) {} }; | |
cxxMethodDecl(hasAnyParameter(hasName("y"))) | |
matches f(int x, int y, int z) {} | |
with hasAnyParameter(...) | |
matching int y | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('hasParameter0')"><a name="hasParameter0Anchor">hasParameter</a></td><td>unsigned N, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParmVarDecl.html">ParmVarDecl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasParameter0"><pre>Matches the n'th parameter of a function declaration. | |
Given | |
class X { void f(int x) {} }; | |
cxxMethodDecl(hasParameter(0, hasType(varDecl()))) | |
matches f(int x) {} | |
with hasParameter(...) | |
matching int x | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('returns0')"><a name="returns0Anchor">returns</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="returns0"><pre>Matches the return type of a function declaration. | |
Given: | |
class X { int f() { return 1; } }; | |
cxxMethodDecl(returns(asString("int"))) | |
matches int f() { return 1; } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IfStmt.html">IfStmt</a>></td><td class="name" onclick="toggle('hasCondition0')"><a name="hasCondition0Anchor">hasCondition</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasCondition0"><pre>Matches the condition expression of an if statement, for loop, | |
or conditional operator. | |
Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true)))) | |
if (true) {} | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IfStmt.html">IfStmt</a>></td><td class="name" onclick="toggle('hasConditionVariableStatement0')"><a name="hasConditionVariableStatement0Anchor">hasConditionVariableStatement</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclStmt.html">DeclStmt</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasConditionVariableStatement0"><pre>Matches the condition variable statement in an if statement. | |
Given | |
if (A* a = GetAPointer()) {} | |
hasConditionVariableStatement(...) | |
matches 'A* a = GetAPointer()'. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IfStmt.html">IfStmt</a>></td><td class="name" onclick="toggle('hasElse0')"><a name="hasElse0Anchor">hasElse</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasElse0"><pre>Matches the else-statement of an if statement. | |
Examples matches the if statement | |
(matcher = ifStmt(hasElse(cxxBoolLiteral(equals(true))))) | |
if (false) false; else true; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IfStmt.html">IfStmt</a>></td><td class="name" onclick="toggle('hasThen0')"><a name="hasThen0Anchor">hasThen</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasThen0"><pre>Matches the then-statement of an if statement. | |
Examples matches the if statement | |
(matcher = ifStmt(hasThen(cxxBoolLiteral(equals(true))))) | |
if (false) true; else false; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ImplicitCastExpr.html">ImplicitCastExpr</a>></td><td class="name" onclick="toggle('hasImplicitDestinationType0')"><a name="hasImplicitDestinationType0Anchor">hasImplicitDestinationType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasImplicitDestinationType0"><pre>Matches implicit casts whose destination type matches a given | |
matcher. | |
FIXME: Unit test this matcher | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>></td><td class="name" onclick="toggle('hasDeclaration9')"><a name="hasDeclaration9Anchor">hasDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclaration9"><pre>Matches a node if the declaration associated with that node | |
matches the given matcher. | |
The associated declaration is: | |
- for type nodes, the declaration of the underlying type | |
- for CallExpr, the declaration of the callee | |
- for MemberExpr, the declaration of the referenced member | |
- for CXXConstructExpr, the declaration of the constructor | |
Also usable as Matcher<T> for any T supporting the getDecl() member | |
function. e.g. various subtypes of clang::Type and various expressions. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>></td><td class="name" onclick="toggle('hasDeclaration8')"><a name="hasDeclaration8Anchor">hasDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclaration8"><pre>Matches a node if the declaration associated with that node | |
matches the given matcher. | |
The associated declaration is: | |
- for type nodes, the declaration of the underlying type | |
- for CallExpr, the declaration of the callee | |
- for MemberExpr, the declaration of the referenced member | |
- for CXXConstructExpr, the declaration of the constructor | |
Also usable as Matcher<T> for any T supporting the getDecl() member | |
function. e.g. various subtypes of clang::Type and various expressions. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>></td><td class="name" onclick="toggle('hasDeclaration7')"><a name="hasDeclaration7Anchor">hasDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclaration7"><pre>Matches a node if the declaration associated with that node | |
matches the given matcher. | |
The associated declaration is: | |
- for type nodes, the declaration of the underlying type | |
- for CallExpr, the declaration of the callee | |
- for MemberExpr, the declaration of the referenced member | |
- for CXXConstructExpr, the declaration of the constructor | |
Also usable as Matcher<T> for any T supporting the getDecl() member | |
function. e.g. various subtypes of clang::Type and various expressions. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>></td><td class="name" onclick="toggle('hasObjectExpression0')"><a name="hasObjectExpression0Anchor">hasObjectExpression</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasObjectExpression0"><pre>Matches a member expression where the object expression is | |
matched by a given matcher. | |
Given | |
struct X { int m; }; | |
void f(X x) { x.m; m; } | |
memberExpr(hasObjectExpression(hasType(cxxRecordDecl(hasName("X"))))))) | |
matches "x.m" and "m" | |
with hasObjectExpression(...) | |
matching "x" and the implicit object expression of "m" which has type X*. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>></td><td class="name" onclick="toggle('member0')"><a name="member0Anchor">member</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ValueDecl.html">ValueDecl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="member0"><pre>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"). | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberPointerTypeLoc.html">MemberPointerTypeLoc</a>></td><td class="name" onclick="toggle('pointeeLoc1')"><a name="pointeeLoc1Anchor">pointeeLoc</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="pointeeLoc1"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1BlockPointerType.html">BlockPointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberPointerType.html">MemberPointerType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1PointerType.html">PointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ReferenceType.html">ReferenceType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberPointerType.html">MemberPointerType</a>></td><td class="name" onclick="toggle('pointee1')"><a name="pointee1Anchor">pointee</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="pointee1"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1BlockPointerType.html">BlockPointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberPointerType.html">MemberPointerType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1PointerType.html">PointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ReferenceType.html">ReferenceType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NestedNameSpecifierLoc.html">NestedNameSpecifierLoc</a>></td><td class="name" onclick="toggle('hasPrefix1')"><a name="hasPrefix1Anchor">hasPrefix</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NestedNameSpecifierLoc.html">NestedNameSpecifierLoc</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasPrefix1"><pre>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::" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NestedNameSpecifierLoc.html">NestedNameSpecifierLoc</a>></td><td class="name" onclick="toggle('specifiesTypeLoc0')"><a name="specifiesTypeLoc0Anchor">specifiesTypeLoc</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="specifiesTypeLoc0"><pre>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::" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NestedNameSpecifier.html">NestedNameSpecifier</a>></td><td class="name" onclick="toggle('hasPrefix0')"><a name="hasPrefix0Anchor">hasPrefix</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NestedNameSpecifier.html">NestedNameSpecifier</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasPrefix0"><pre>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::" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NestedNameSpecifier.html">NestedNameSpecifier</a>></td><td class="name" onclick="toggle('specifiesNamespace0')"><a name="specifiesNamespace0Anchor">specifiesNamespace</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamespaceDecl.html">NamespaceDecl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="specifiesNamespace0"><pre>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::" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NestedNameSpecifier.html">NestedNameSpecifier</a>></td><td class="name" onclick="toggle('specifiesType0')"><a name="specifiesType0Anchor">specifiesType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="specifiesType0"><pre>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::" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMessageExpr.html">ObjCMessageExpr</a>></td><td class="name" onclick="toggle('hasArgument2')"><a name="hasArgument2Anchor">hasArgument</a></td><td>unsigned N, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasArgument2"><pre>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); } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMessageExpr.html">ObjCMessageExpr</a>></td><td class="name" onclick="toggle('hasReceiverType0')"><a name="hasReceiverType0Anchor">hasReceiverType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasReceiverType0"><pre>Matches on the receiver of an ObjectiveC Message expression. | |
Example | |
matcher = objCMessageExpr(hasRecieverType(asString("UIWebView *"))); | |
matches the [webView ...] message invocation. | |
NSString *webViewJavaScript = ... | |
UIWebView *webView = ... | |
[webView stringByEvaluatingJavaScriptFromString:webViewJavascript]; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParenType.html">ParenType</a>></td><td class="name" onclick="toggle('innerType0')"><a name="innerType0Anchor">innerType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="innerType0"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParenType.html">ParenType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1PointerTypeLoc.html">PointerTypeLoc</a>></td><td class="name" onclick="toggle('pointeeLoc2')"><a name="pointeeLoc2Anchor">pointeeLoc</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="pointeeLoc2"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1BlockPointerType.html">BlockPointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberPointerType.html">MemberPointerType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1PointerType.html">PointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ReferenceType.html">ReferenceType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1PointerType.html">PointerType</a>></td><td class="name" onclick="toggle('pointee2')"><a name="pointee2Anchor">pointee</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="pointee2"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1BlockPointerType.html">BlockPointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberPointerType.html">MemberPointerType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1PointerType.html">PointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ReferenceType.html">ReferenceType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('hasCanonicalType0')"><a name="hasCanonicalType0Anchor">hasCanonicalType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasCanonicalType0"><pre>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. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('hasDeclaration6')"><a name="hasDeclaration6Anchor">hasDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclaration6"><pre>Matches a node if the declaration associated with that node | |
matches the given matcher. | |
The associated declaration is: | |
- for type nodes, the declaration of the underlying type | |
- for CallExpr, the declaration of the callee | |
- for MemberExpr, the declaration of the referenced member | |
- for CXXConstructExpr, the declaration of the constructor | |
Also usable as Matcher<T> for any T supporting the getDecl() member | |
function. e.g. various subtypes of clang::Type and various expressions. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('pointsTo1')"><a name="pointsTo1Anchor">pointsTo</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="pointsTo1"><pre>Overloaded to match the pointee type's declaration. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('pointsTo0')"><a name="pointsTo0Anchor">pointsTo</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="pointsTo0"><pre>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(); } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('references1')"><a name="references1Anchor">references</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="references1"><pre>Overloaded to match the referenced type's declaration. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('references0')"><a name="references0Anchor">references</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="references0"><pre>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; | |
} | |
}; | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>></td><td class="name" onclick="toggle('hasDeclaration5')"><a name="hasDeclaration5Anchor">hasDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclaration5"><pre>Matches a node if the declaration associated with that node | |
matches the given matcher. | |
The associated declaration is: | |
- for type nodes, the declaration of the underlying type | |
- for CallExpr, the declaration of the callee | |
- for MemberExpr, the declaration of the referenced member | |
- for CXXConstructExpr, the declaration of the constructor | |
Also usable as Matcher<T> for any T supporting the getDecl() member | |
function. e.g. various subtypes of clang::Type and various expressions. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ReferenceTypeLoc.html">ReferenceTypeLoc</a>></td><td class="name" onclick="toggle('pointeeLoc3')"><a name="pointeeLoc3Anchor">pointeeLoc</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="pointeeLoc3"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1BlockPointerType.html">BlockPointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberPointerType.html">MemberPointerType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1PointerType.html">PointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ReferenceType.html">ReferenceType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ReferenceType.html">ReferenceType</a>></td><td class="name" onclick="toggle('pointee3')"><a name="pointee3Anchor">pointee</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td></tr> | |
<tr><td colspan="4" class="doc" id="pointee3"><pre>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<<a href="http://clang.llvm.org/doxygen/classclang_1_1BlockPointerType.html">BlockPointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberPointerType.html">MemberPointerType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1PointerType.html">PointerType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ReferenceType.html">ReferenceType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('alignOfExpr0')"><a name="alignOfExpr0Anchor">alignOfExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnaryExprOrTypeTraitExpr.html">UnaryExprOrTypeTraitExpr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="alignOfExpr0"><pre>Same as unaryExprOrTypeTraitExpr, but only matching | |
alignof. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('sizeOfExpr0')"><a name="sizeOfExpr0Anchor">sizeOfExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnaryExprOrTypeTraitExpr.html">UnaryExprOrTypeTraitExpr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="sizeOfExpr0"><pre>Same as unaryExprOrTypeTraitExpr, but only matching | |
sizeof. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1SwitchStmt.html">SwitchStmt</a>></td><td class="name" onclick="toggle('forEachSwitchCase0')"><a name="forEachSwitchCase0Anchor">forEachSwitchCase</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1SwitchCase.html">SwitchCase</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="forEachSwitchCase0"><pre>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)". | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>></td><td class="name" onclick="toggle('hasDeclaration4')"><a name="hasDeclaration4Anchor">hasDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclaration4"><pre>Matches a node if the declaration associated with that node | |
matches the given matcher. | |
The associated declaration is: | |
- for type nodes, the declaration of the underlying type | |
- for CallExpr, the declaration of the callee | |
- for MemberExpr, the declaration of the referenced member | |
- for CXXConstructExpr, the declaration of the constructor | |
Also usable as Matcher<T> for any T supporting the getDecl() member | |
function. e.g. various subtypes of clang::Type and various expressions. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>></td><td class="name" onclick="toggle('isExpr0')"><a name="isExpr0Anchor">isExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="isExpr0"><pre>Matches a sugar TemplateArgument that refers to a certain expression. | |
Given | |
template<typename T> struct A {}; | |
struct B { B* next; }; | |
A<&B::next> a; | |
templateSpecializationType(hasAnyTemplateArgument( | |
isExpr(hasDescendant(declRefExpr(to(fieldDecl(hasName("next")))))))) | |
matches the specialization A<&B::next> with fieldDecl(...) matching | |
B::next | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>></td><td class="name" onclick="toggle('refersToDeclaration0')"><a name="refersToDeclaration0Anchor">refersToDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="refersToDeclaration0"><pre>Matches a canonical TemplateArgument that refers to a certain | |
declaration. | |
Given | |
template<typename T> struct A {}; | |
struct B { B* next; }; | |
A<&B::next> a; | |
classTemplateSpecializationDecl(hasAnyTemplateArgument( | |
refersToDeclaration(fieldDecl(hasName("next")))) | |
matches the specialization A<&B::next> with fieldDecl(...) matching | |
B::next | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>></td><td class="name" onclick="toggle('refersToIntegralType0')"><a name="refersToIntegralType0Anchor">refersToIntegralType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="refersToIntegralType0"><pre>Matches a TemplateArgument that referes to an integral type. | |
Given | |
template<int T> struct A {}; | |
C<42> c; | |
classTemplateSpecializationDecl( | |
hasAnyTemplateArgument(refersToIntegralType(asString("int")))) | |
matches the implicit instantiation of C in C<42>. | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>></td><td class="name" onclick="toggle('refersToType0')"><a name="refersToType0Anchor">refersToType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="refersToType0"><pre>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> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>></td><td class="name" onclick="toggle('hasAnyTemplateArgument1')"><a name="hasAnyTemplateArgument1Anchor">hasAnyTemplateArgument</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasAnyTemplateArgument1"><pre>Matches classTemplateSpecializations that have at least one | |
TemplateArgument matching the given InnerMatcher. | |
Given | |
template<typename T> class A {}; | |
template<> class A<double> {}; | |
A<int> a; | |
classTemplateSpecializationDecl(hasAnyTemplateArgument( | |
refersToType(asString("int")))) | |
matches the specialization A<int> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>></td><td class="name" onclick="toggle('hasDeclaration3')"><a name="hasDeclaration3Anchor">hasDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclaration3"><pre>Matches a node if the declaration associated with that node | |
matches the given matcher. | |
The associated declaration is: | |
- for type nodes, the declaration of the underlying type | |
- for CallExpr, the declaration of the callee | |
- for MemberExpr, the declaration of the referenced member | |
- for CXXConstructExpr, the declaration of the constructor | |
Also usable as Matcher<T> for any T supporting the getDecl() member | |
function. e.g. various subtypes of clang::Type and various expressions. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>></td><td class="name" onclick="toggle('hasTemplateArgument1')"><a name="hasTemplateArgument1Anchor">hasTemplateArgument</a></td><td>unsigned N, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasTemplateArgument1"><pre>Matches classTemplateSpecializations where the n'th TemplateArgument | |
matches the given InnerMatcher. | |
Given | |
template<typename T, typename U> class A {}; | |
A<bool, int> b; | |
A<int, bool> c; | |
classTemplateSpecializationDecl(hasTemplateArgument( | |
1, refersToType(asString("int")))) | |
matches the specialization A<bool, int> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>></td><td class="name" onclick="toggle('hasDeclaration2')"><a name="hasDeclaration2Anchor">hasDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclaration2"><pre>Matches a node if the declaration associated with that node | |
matches the given matcher. | |
The associated declaration is: | |
- for type nodes, the declaration of the underlying type | |
- for CallExpr, the declaration of the callee | |
- for MemberExpr, the declaration of the referenced member | |
- for CXXConstructExpr, the declaration of the constructor | |
Also usable as Matcher<T> for any T supporting the getDecl() member | |
function. e.g. various subtypes of clang::Type and various expressions. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<T></td><td class="name" onclick="toggle('findAll0')"><a name="findAll0Anchor">findAll</a></td><td>Matcher<T> Matcher</td></tr> | |
<tr><td colspan="4" class="doc" id="findAll0"><pre>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 | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>></td><td class="name" onclick="toggle('hasDeclaration1')"><a name="hasDeclaration1Anchor">hasDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclaration1"><pre>Matches a node if the declaration associated with that node | |
matches the given matcher. | |
The associated declaration is: | |
- for type nodes, the declaration of the underlying type | |
- for CallExpr, the declaration of the callee | |
- for MemberExpr, the declaration of the referenced member | |
- for CXXConstructExpr, the declaration of the constructor | |
Also usable as Matcher<T> for any T supporting the getDecl() member | |
function. e.g. various subtypes of clang::Type and various expressions. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnaryExprOrTypeTraitExpr.html">UnaryExprOrTypeTraitExpr</a>></td><td class="name" onclick="toggle('hasArgumentOfType0')"><a name="hasArgumentOfType0Anchor">hasArgumentOfType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasArgumentOfType0"><pre>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) | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnaryOperator.html">UnaryOperator</a>></td><td class="name" onclick="toggle('hasUnaryOperand0')"><a name="hasUnaryOperand0Anchor">hasUnaryOperand</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasUnaryOperand0"><pre>Matches if the operand of a unary operator matches. | |
Example matches true (matcher = hasUnaryOperand( | |
cxxBoolLiteral(equals(true)))) | |
!true | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>></td><td class="name" onclick="toggle('hasDeclaration0')"><a name="hasDeclaration0Anchor">hasDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasDeclaration0"><pre>Matches a node if the declaration associated with that node | |
matches the given matcher. | |
The associated declaration is: | |
- for type nodes, the declaration of the underlying type | |
- for CallExpr, the declaration of the callee | |
- for MemberExpr, the declaration of the referenced member | |
- for CXXConstructExpr, the declaration of the constructor | |
Also usable as Matcher<T> for any T supporting the getDecl() member | |
function. e.g. various subtypes of clang::Type and various expressions. | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InjectedClassNameType.html">InjectedClassNameType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelStmt.html">LabelStmt</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1MemberExpr.html">MemberExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1RecordType.html">RecordType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateSpecializationType.html">TemplateSpecializationType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateTypeParmType.html">TemplateTypeParmType</a>>, | |
Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefType.html">TypedefType</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UsingDecl.html">UsingDecl</a>></td><td class="name" onclick="toggle('hasAnyUsingShadowDecl0')"><a name="hasAnyUsingShadowDecl0Anchor">hasAnyUsingShadowDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UsingShadowDecl.html">UsingShadowDecl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasAnyUsingShadowDecl0"><pre>Matches any using shadow declaration. | |
Given | |
namespace X { void b(); } | |
using X::b; | |
usingDecl(hasAnyUsingShadowDecl(hasName("b")))) | |
matches using X::b </pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UsingShadowDecl.html">UsingShadowDecl</a>></td><td class="name" onclick="toggle('hasTargetDecl0')"><a name="hasTargetDecl0Anchor">hasTargetDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamedDecl.html">NamedDecl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasTargetDecl0"><pre>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 </pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ValueDecl.html">ValueDecl</a>></td><td class="name" onclick="toggle('hasType3')"><a name="hasType3Anchor">hasType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasType3"><pre>Overloaded to match the declaration of the expression's or value | |
declaration's type. | |
In case of a value declaration (for example a variable declaration), | |
this resolves one layer of indirection. For example, in the value | |
declaration "X x;", cxxRecordDecl(hasName("X")) matches the declaration of | |
X, while varDecl(hasType(cxxRecordDecl(hasName("X")))) matches the | |
declaration of x. | |
Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X"))))) | |
and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X"))))) | |
class X {}; | |
void y(X &x) { x; X z; } | |
Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ValueDecl.html">ValueDecl</a>> | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ValueDecl.html">ValueDecl</a>></td><td class="name" onclick="toggle('hasType1')"><a name="hasType1Anchor">hasType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasType1"><pre>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"))))) | |
class X {}; | |
void y(X &x) { x; X z; } | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>></td><td class="name" onclick="toggle('hasInitializer0')"><a name="hasInitializer0Anchor">hasInitializer</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasInitializer0"><pre>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(); | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VariableArrayType.html">VariableArrayType</a>></td><td class="name" onclick="toggle('hasSizeExpr0')"><a name="hasSizeExpr0Anchor">hasSizeExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasSizeExpr0"><pre>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]" | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1WhileStmt.html">WhileStmt</a>></td><td class="name" onclick="toggle('hasBody2')"><a name="hasBody2Anchor">hasBody</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasBody2"><pre>Matches a 'for', 'while', or 'do while' statement that has | |
a given body. | |
Given | |
for (;;) {} | |
hasBody(compoundStmt()) | |
matches 'for (;;) {}' | |
with compoundStmt() | |
matching '{}' | |
</pre></td></tr> | |
<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1WhileStmt.html">WhileStmt</a>></td><td class="name" onclick="toggle('hasCondition2')"><a name="hasCondition2Anchor">hasCondition</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="hasCondition2"><pre>Matches the condition expression of an if statement, for loop, | |
or conditional operator. | |
Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true)))) | |
if (true) {} | |
</pre></td></tr> | |
<tr><td>Matcher<internal::BindableMatcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NestedNameSpecifierLoc.html">NestedNameSpecifierLoc</a>>></td><td class="name" onclick="toggle('loc1')"><a name="loc1Anchor">loc</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NestedNameSpecifier.html">NestedNameSpecifier</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="loc1"><pre>Matches NestedNameSpecifierLocs for which the given inner | |
NestedNameSpecifier-matcher matches. | |
</pre></td></tr> | |
<tr><td>Matcher<internal::BindableMatcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeLoc.html">TypeLoc</a>>></td><td class="name" onclick="toggle('loc0')"><a name="loc0Anchor">loc</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr> | |
<tr><td colspan="4" class="doc" id="loc0"><pre>Matches TypeLocs for which the given inner | |
QualType-matcher matches. | |
</pre></td></tr> | |
<!--END_TRAVERSAL_MATCHERS --> | |
</table> | |
</div> | |
</body> | |
</html> | |