Blame - clang/docs/LibASTMatchersReference.html - toolchain/llvm-project

blob: 8775314afc9cf974c00b538f3a45564735b82d92 [file] [log] [blame]

Benjamin Kramer	7d0cc23	2015-11-20 07:57:46 +0000	[diff] [blame]	1	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
				2	"http://www.w3.org/TR/html4/strict.dtd">
				3	<html>
				4	<head>
				5	<title>AST Matcher Reference</title>
				6	<link type="text/css" rel="stylesheet" href="../menu.css" />
				7	<link type="text/css" rel="stylesheet" href="../content.css" />
				8	<style type="text/css">
				9	td {
				10	padding: .33em;
				11	}
				12	td.doc {
				13	display: none;
				14	border-bottom: 1px solid black;
				15	}
				16	td.name:hover {
				17	color: blue;
				18	cursor: pointer;
				19	}
				20	</style>
				21	<script type="text/javascript">
				22	function toggle(id) {
				23	if (!id) return;
				24	row = document.getElementById(id);
				25	if (row.style.display != 'table-cell')
				26	row.style.display = 'table-cell';
				27	else
				28	row.style.display = 'none';
				29	}
				30	</script>
				31	</head>
				32	<body onLoad="toggle(location.hash.substring(1, location.hash.length - 6))">
				33
				34	<!--#include virtual="../menu.html.incl"-->
				35
				36	<div id="content">
				37
				38	<h1>AST Matcher Reference</h1>
				39
				40	<p>This document shows all currently implemented matchers. The matchers are grouped
				41	by category and node type they match. You can click on matcher names to show the
				42	matcher's source documentation.</p>
				43
				44	<p>There are three different basic categories of matchers:
				45	<ul>
				46	<li><a href="#decl-matchers">Node Matchers:</a> Matchers that match a specific type of AST node.</li>
				47	<li><a href="#narrowing-matchers">Narrowing Matchers:</a> Matchers that match attributes on AST nodes.</li>
				48	<li><a href="#traversal-matchers">Traversal Matchers:</a> Matchers that allow traversal between AST nodes.</li>
				49	</ul>
				50	</p>
				51
				52	<p>Within each category the matchers are ordered by node type they match on.
				53	Note that if a matcher can match multiple node types, it will it will appear
				54	multiple times. This means that by searching for Matcher<Stmt> you can
				55	find all matchers that can be used to match on Stmt nodes.</p>
				56
				57	<p>The exception to that rule are matchers that can match on any node. Those
				58	are marked with a * and are listed in the beginning of each category.</p>
				59
				60	<p>Note that the categorization of matchers is a great help when you combine
				61	them into matcher expressions. You will usually want to form matcher expressions
				62	that read like english sentences by alternating between node matchers and
				63	narrowing or traversal matchers, like this:
				64	<pre>
				65	recordDecl(hasDescendant(
				66	ifStmt(hasTrueExpression(
				67	expr(hasDescendant(
				68	ifStmt()))))))
				69	</pre>
				70	</p>
				71
				72	<!-- ======================================================================= -->
				73	<h2 id="decl-matchers">Node Matchers</h2>
				74	<!-- ======================================================================= -->
				75
				76	<p>Node matchers are at the core of matcher expressions - they specify the type
				77	of node that is expected. Every match expression starts with a node matcher,
				78	which can then be further refined with a narrowing or traversal matcher. All
				79	traversal matchers take node matchers as their arguments.</p>
				80
				81	<p>For convenience, all node matchers take an arbitrary number of arguments
				82	and implicitly act as allOf matchers.</p>
				83
				84	<p>Node matchers are the only matchers that support the bind("id") call to
				85	bind the matched node to the given string, to be later retrieved from the
				86	match callback.</p>
				87
				88	<p>It is important to remember that the arguments to node matchers are
				89	predicates on the same node, just with additional information about the type.
				90	This is often useful to make matcher expression more readable by inlining bind
				91	calls into redundant node matchers inside another node matcher:
				92	<pre>
				93	// This binds the CXXRecordDecl to "id", as the decl() matcher will stay on
				94	// the same node.
				95	recordDecl(decl().bind("id"), hasName("::MyClass"))
				96	</pre>
				97	</p>
				98
				99	<table>
				100	<tr style="text-align:left"><th>Return type</th><th>Name</th><th>Parameters</th></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	101	<!-- START_DECL_MATCHERS -->
				102
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	103	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	104	<tr><td colspan="4" class="doc" id="cxxCtorInitializer0"><pre>Matches constructor initializers.
				105
				106	Examples matches i(42).
				107	class C {
				108	C() : i(42) {}
				109	int i;
				110	};
				111	</pre></td></tr>
				112
				113
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	114	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	115	<tr><td colspan="4" class="doc" id="accessSpecDecl0"><pre>Matches C++ access specifier declarations.
				116
				117	Given
				118	class C {
				119	public:
				120	int a;
				121	};
				122	accessSpecDecl()
				123	matches 'public:'
				124	</pre></td></tr>
				125
				126
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	127	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	128	<tr><td colspan="4" class="doc" id="classTemplateDecl0"><pre>Matches C++ class template declarations.
				129
				130	Example matches Z
				131	template<class T> class Z {};
				132	</pre></td></tr>
				133
				134
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	135	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	136	<tr><td colspan="4" class="doc" id="classTemplateSpecializationDecl0"><pre>Matches C++ class template specializations.
				137
				138	Given
				139	template<typename T> class A {};
				140	template<> class A<double> {};
				141	A<int> a;
				142	classTemplateSpecializationDecl()
				143	matches the specializations A<int> and A<double>
				144	</pre></td></tr>
				145
				146
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	147	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	148	<tr><td colspan="4" class="doc" id="cxxConstructorDecl0"><pre>Matches C++ constructor declarations.
				149
				150	Example matches Foo::Foo() and Foo::Foo(int)
				151	class Foo {
				152	public:
				153	Foo();
				154	Foo(int);
				155	int DoSomething();
				156	};
				157	</pre></td></tr>
				158
				159
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	160	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	161	<tr><td colspan="4" class="doc" id="cxxConversionDecl0"><pre>Matches conversion operator declarations.
				162
				163	Example matches the operator.
				164	class X { operator int() const; };
				165	</pre></td></tr>
				166
				167
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	168	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	169	<tr><td colspan="4" class="doc" id="cxxDestructorDecl0"><pre>Matches explicit C++ destructor declarations.
				170
				171	Example matches Foo::~Foo()
				172	class Foo {
				173	public:
				174	virtual ~Foo();
				175	};
				176	</pre></td></tr>
				177
				178
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	179	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	180	<tr><td colspan="4" class="doc" id="cxxMethodDecl0"><pre>Matches method declarations.
				181
				182	Example matches y
				183	class X { void y(); };
				184	</pre></td></tr>
				185
				186
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	187	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	188	<tr><td colspan="4" class="doc" id="cxxRecordDecl0"><pre>Matches C++ class declarations.
				189
				190	Example matches X, Z
				191	class X;
				192	template<class T> class Z {};
				193	</pre></td></tr>
				194
				195
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	196	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	197	<tr><td colspan="4" class="doc" id="decl0"><pre>Matches declarations.
				198
				199	Examples matches X, C, and the friend declaration inside C;
				200	void X();
				201	class C {
				202	friend X;
				203	};
				204	</pre></td></tr>
				205
				206
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	207	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	208	<tr><td colspan="4" class="doc" id="declaratorDecl0"><pre>Matches declarator declarations (field, variable, function
				209	and non-type template parameter declarations).
				210
				211	Given
				212	class X { int y; };
				213	declaratorDecl()
				214	matches int y.
				215	</pre></td></tr>
				216
				217
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	218	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	219	<tr><td colspan="4" class="doc" id="enumConstantDecl0"><pre>Matches enum constants.
				220
				221	Example matches A, B, C
				222	enum X {
				223	A, B, C
				224	};
				225	</pre></td></tr>
				226
				227
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	228	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	229	<tr><td colspan="4" class="doc" id="enumDecl0"><pre>Matches enum declarations.
				230
				231	Example matches X
				232	enum X {
				233	A, B, C
				234	};
				235	</pre></td></tr>
				236
				237
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	238	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	239	<tr><td colspan="4" class="doc" id="fieldDecl0"><pre>Matches field declarations.
				240
				241	Given
				242	class X { int m; };
				243	fieldDecl()
				244	matches 'm'.
				245	</pre></td></tr>
				246
				247
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	248	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	249	<tr><td colspan="4" class="doc" id="friendDecl0"><pre>Matches friend declarations.
				250
				251	Given
				252	class X { friend void foo(); };
				253	friendDecl()
				254	matches 'friend void foo()'.
				255	</pre></td></tr>
				256
				257
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	258	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	259	<tr><td colspan="4" class="doc" id="functionDecl0"><pre>Matches function declarations.
				260
				261	Example matches f
				262	void f();
				263	</pre></td></tr>
				264
				265
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	266	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	267	<tr><td colspan="4" class="doc" id="functionTemplateDecl0"><pre>Matches C++ function template declarations.
				268
				269	Example matches f
				270	template<class T> void f(T t) {}
				271	</pre></td></tr>
				272
				273
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	274	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('labelDecl0')"><a name="labelDecl0Anchor">labelDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1LabelDecl.html">LabelDecl</a>>...</td></tr>
				275	<tr><td colspan="4" class="doc" id="labelDecl0"><pre>Matches a declaration of label.
				276
				277	Given
				278	goto FOO;
				279	FOO: bar();
				280	labelDecl()
				281	matches 'FOO:'
				282	</pre></td></tr>
				283
				284
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	285	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	286	<tr><td colspan="4" class="doc" id="linkageSpecDecl0"><pre>Matches a declaration of a linkage specification.
				287
				288	Given
				289	extern "C" {}
				290	linkageSpecDecl()
				291	matches "extern "C" {}"
				292	</pre></td></tr>
				293
				294
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	295	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	296	<tr><td colspan="4" class="doc" id="namedDecl0"><pre>Matches a declaration of anything that could have a name.
				297
				298	Example matches X, S, the anonymous union type, i, and U;
				299	typedef int X;
				300	struct S {
				301	union {
				302	int i;
				303	} U;
				304	};
				305	</pre></td></tr>
				306
				307
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	308	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	309	<tr><td colspan="4" class="doc" id="namespaceAliasDecl0"><pre>Matches a declaration of a namespace alias.
				310
				311	Given
				312	namespace test {}
				313	namespace alias = ::test;
				314	namespaceAliasDecl()
				315	matches "namespace alias" but not "namespace test"
				316	</pre></td></tr>
				317
				318
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	319	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	320	<tr><td colspan="4" class="doc" id="namespaceDecl0"><pre>Matches a declaration of a namespace.
				321
				322	Given
				323	namespace {}
				324	namespace test {}
				325	namespaceDecl()
				326	matches "namespace {}" and "namespace test {}"
				327	</pre></td></tr>
				328
				329
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	330	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	331	<tr><td colspan="4" class="doc" id="nonTypeTemplateParmDecl0"><pre>Matches non-type template parameter declarations.
				332
				333	Given
				334	template <typename T, int N> struct C {};
				335	nonTypeTemplateParmDecl()
				336	matches 'N', but not 'T'.
				337	</pre></td></tr>
				338
				339
Aaron Ballman	9fd6ee6	2017-03-15 20:14:25 +0000	[diff] [blame]	340	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('objcCategoryDecl0')"><a name="objcCategoryDecl0Anchor">objcCategoryDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCCategoryDecl.html">ObjCCategoryDecl</a>>...</td></tr>
				341	<tr><td colspan="4" class="doc" id="objcCategoryDecl0"><pre>Matches Objective-C category declarations.
				342
				343	Example matches Foo (Additions)
				344	@interface Foo (Additions)
				345	@end
				346	</pre></td></tr>
				347
				348
Dave Lee	55540a0	2017-10-26 15:53:37 +0000	[diff] [blame]	349	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('objcCategoryImplDecl0')"><a name="objcCategoryImplDecl0Anchor">objcCategoryImplDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCCategoryImplDecl.html">ObjCCategoryImplDecl</a>>...</td></tr>
				350	<tr><td colspan="4" class="doc" id="objcCategoryImplDecl0"><pre>Matches Objective-C category definitions.
				351
				352	Example matches Foo (Additions)
				353	@implementation Foo (Additions)
				354	@end
				355	</pre></td></tr>
				356
				357
Dave Lee	e6d362c	2017-09-10 21:00:15 +0000	[diff] [blame]	358	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('objcImplementationDecl0')"><a name="objcImplementationDecl0Anchor">objcImplementationDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCImplementationDecl.html">ObjCImplementationDecl</a>>...</td></tr>
				359	<tr><td colspan="4" class="doc" id="objcImplementationDecl0"><pre>Matches Objective-C implementation declarations.
				360
				361	Example matches Foo
				362	@implementation Foo
				363	@end
				364	</pre></td></tr>
				365
				366
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	367	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	368	<tr><td colspan="4" class="doc" id="objcInterfaceDecl0"><pre>Matches Objective-C interface declarations.
				369
				370	Example matches Foo
				371	@interface Foo
				372	@end
				373	</pre></td></tr>
				374
				375
Aaron Ballman	9fd6ee6	2017-03-15 20:14:25 +0000	[diff] [blame]	376	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('objcIvarDecl0')"><a name="objcIvarDecl0Anchor">objcIvarDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCIvarDecl.html">ObjCIvarDecl</a>>...</td></tr>
				377	<tr><td colspan="4" class="doc" id="objcIvarDecl0"><pre>Matches Objective-C instance variable declarations.
				378
				379	Example matches _enabled
				380	@implementation Foo {
				381	BOOL _enabled;
				382	}
				383	@end
				384	</pre></td></tr>
				385
				386
				387	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('objcMethodDecl0')"><a name="objcMethodDecl0Anchor">objcMethodDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMethodDecl.html">ObjCMethodDecl</a>>...</td></tr>
				388	<tr><td colspan="4" class="doc" id="objcMethodDecl0"><pre>Matches Objective-C method declarations.
				389
				390	Example matches both declaration and definition of -[Foo method]
				391	@interface Foo
				392	- (void)method;
				393	@end
				394
				395	@implementation Foo
				396	- (void)method {}
				397	@end
				398	</pre></td></tr>
				399
				400
				401	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('objcPropertyDecl0')"><a name="objcPropertyDecl0Anchor">objcPropertyDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCPropertyDecl.html">ObjCPropertyDecl</a>>...</td></tr>
				402	<tr><td colspan="4" class="doc" id="objcPropertyDecl0"><pre>Matches Objective-C property declarations.
				403
				404	Example matches enabled
				405	@interface Foo
				406	@property BOOL enabled;
				407	@end
				408	</pre></td></tr>
				409
				410
				411	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('objcProtocolDecl0')"><a name="objcProtocolDecl0Anchor">objcProtocolDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCProtocolDecl.html">ObjCProtocolDecl</a>>...</td></tr>
				412	<tr><td colspan="4" class="doc" id="objcProtocolDecl0"><pre>Matches Objective-C protocol declarations.
				413
				414	Example matches FooDelegate
				415	@protocol FooDelegate
				416	@end
				417	</pre></td></tr>
				418
				419
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	420	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	421	<tr><td colspan="4" class="doc" id="parmVarDecl0"><pre>Matches parameter variable declarations.
				422
				423	Given
				424	void f(int x);
				425	parmVarDecl()
				426	matches int x.
				427	</pre></td></tr>
				428
				429
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	430	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	431	<tr><td colspan="4" class="doc" id="recordDecl0"><pre>Matches class, struct, and union declarations.
				432
				433	Example matches X, Z, U, and S
				434	class X;
				435	template<class T> class Z {};
				436	struct S {};
				437	union U {};
				438	</pre></td></tr>
				439
				440
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	441	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	442	<tr><td colspan="4" class="doc" id="staticAssertDecl0"><pre>Matches a C++ static_assert declaration.
				443
				444	Example:
				445	staticAssertExpr()
				446	matches
				447	static_assert(sizeof(S) == sizeof(int))
				448	in
				449	struct S {
				450	int x;
				451	};
				452	static_assert(sizeof(S) == sizeof(int));
				453	</pre></td></tr>
				454
				455
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	456	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	457	<tr><td colspan="4" class="doc" id="templateTypeParmDecl0"><pre>Matches template type parameter declarations.
				458
				459	Given
				460	template <typename T, int N> struct C {};
				461	templateTypeParmDecl()
				462	matches 'T', but not 'N'.
				463	</pre></td></tr>
				464
				465
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	466	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	467	<tr><td colspan="4" class="doc" id="translationUnitDecl0"><pre>Matches the top declaration context.
				468
				469	Given
				470	int X;
				471	namespace NS {
				472	int Y;
				473	} namespace NS
				474	decl(hasDeclContext(translationUnitDecl()))
				475	matches "int X", but not "int Y".
				476	</pre></td></tr>
				477
				478
Aaron Ballman	66eb58a	2016-04-14 16:05:45 +0000	[diff] [blame]	479	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('typeAliasDecl0')"><a name="typeAliasDecl0Anchor">typeAliasDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeAliasDecl.html">TypeAliasDecl</a>>...</td></tr>
				480	<tr><td colspan="4" class="doc" id="typeAliasDecl0"><pre>Matches type alias declarations.
				481
				482	Given
				483	typedef int X;
Samuel Benzaquen	a4076ea	2016-05-04 20:45:00 +0000	[diff] [blame]	484	using Y = int;
Aaron Ballman	66eb58a	2016-04-14 16:05:45 +0000	[diff] [blame]	485	typeAliasDecl()
				486	matches "using Y = int", but not "typedef int X"
				487	</pre></td></tr>
				488
				489
Eric Liu	285f804	2017-03-28 12:56:47 +0000	[diff] [blame]	490	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('typeAliasTemplateDecl0')"><a name="typeAliasTemplateDecl0Anchor">typeAliasTemplateDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypeAliasTemplateDecl.html">TypeAliasTemplateDecl</a>>...</td></tr>
				491	<tr><td colspan="4" class="doc" id="typeAliasTemplateDecl0"><pre>Matches type alias template declarations.
				492
				493	typeAliasTemplateDecl() matches
				494	template <typename T>
				495	using Y = X<T>;
				496	</pre></td></tr>
				497
				498
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	499	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	500	<tr><td colspan="4" class="doc" id="typedefDecl0"><pre>Matches typedef declarations.
				501
				502	Given
				503	typedef int X;
Samuel Benzaquen	a4076ea	2016-05-04 20:45:00 +0000	[diff] [blame]	504	using Y = int;
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	505	typedefDecl()
Aaron Ballman	66eb58a	2016-04-14 16:05:45 +0000	[diff] [blame]	506	matches "typedef int X", but not "using Y = int"
				507	</pre></td></tr>
				508
				509
				510	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('typedefNameDecl0')"><a name="typedefNameDecl0Anchor">typedefNameDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefNameDecl.html">TypedefNameDecl</a>>...</td></tr>
				511	<tr><td colspan="4" class="doc" id="typedefNameDecl0"><pre>Matches typedef name declarations.
				512
				513	Given
				514	typedef int X;
Samuel Benzaquen	a4076ea	2016-05-04 20:45:00 +0000	[diff] [blame]	515	using Y = int;
Aaron Ballman	66eb58a	2016-04-14 16:05:45 +0000	[diff] [blame]	516	typedefNameDecl()
				517	matches "typedef int X" and "using Y = int"
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	518	</pre></td></tr>
				519
				520
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	521	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	522	<tr><td colspan="4" class="doc" id="unresolvedUsingTypenameDecl0"><pre>Matches unresolved using value declarations that involve the
				523	typename.
				524
				525	Given
				526	template <typename T>
				527	struct Base { typedef T Foo; };
				528
				529	template<typename T>
				530	struct S : private Base<T> {
				531	using typename Base<T>::Foo;
				532	};
				533	unresolvedUsingTypenameDecl()
				534	matches using Base<T>::Foo </pre></td></tr>
				535
				536
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	537	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	538	<tr><td colspan="4" class="doc" id="unresolvedUsingValueDecl0"><pre>Matches unresolved using value declarations.
				539
				540	Given
				541	template<typename X>
				542	class C : private X {
				543	using X::x;
				544	};
				545	unresolvedUsingValueDecl()
				546	matches using X::x </pre></td></tr>
				547
				548
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	549	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	550	<tr><td colspan="4" class="doc" id="usingDecl0"><pre>Matches using declarations.
				551
				552	Given
				553	namespace X { int x; }
				554	using X::x;
				555	usingDecl()
				556	matches using X::x </pre></td></tr>
				557
				558
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	559	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	560	<tr><td colspan="4" class="doc" id="usingDirectiveDecl0"><pre>Matches using namespace declarations.
				561
				562	Given
				563	namespace X { int x; }
				564	using namespace X;
				565	usingDirectiveDecl()
				566	matches using namespace X </pre></td></tr>
				567
				568
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	569	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	570	<tr><td colspan="4" class="doc" id="valueDecl0"><pre>Matches any value declaration.
				571
				572	Example matches A, B, C and F
				573	enum X { A, B, C };
				574	void F();
				575	</pre></td></tr>
				576
				577
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	578	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	579	<tr><td colspan="4" class="doc" id="varDecl0"><pre>Matches variable declarations.
				580
				581	Note: this does not match declarations of member variables, which are
				582	"field" declarations in Clang parlance.
				583
				584	Example matches a
				585	int a;
				586	</pre></td></tr>
				587
				588
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	589	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	590	<tr><td colspan="4" class="doc" id="nestedNameSpecifierLoc0"><pre>Same as nestedNameSpecifier but matches NestedNameSpecifierLoc.
				591	</pre></td></tr>
				592
				593
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	594	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	595	<tr><td colspan="4" class="doc" id="nestedNameSpecifier0"><pre>Matches nested name specifiers.
				596
				597	Given
				598	namespace ns {
				599	struct A { static void f(); };
				600	void A::f() {}
				601	void g() { A::f(); }
				602	}
				603	ns::A a;
				604	nestedNameSpecifier()
				605	matches "ns::" and both "A::"
				606	</pre></td></tr>
				607
				608
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	609	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	610	<tr><td colspan="4" class="doc" id="qualType0"><pre>Matches QualTypes in the clang AST.
				611	</pre></td></tr>
				612
				613
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	614	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('addrLabelExpr0')"><a name="addrLabelExpr0Anchor">addrLabelExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>...</td></tr>
				615	<tr><td colspan="4" class="doc" id="addrLabelExpr0"><pre>Matches address of label statements (GNU extension).
				616
				617	Given
				618	FOO: bar();
				619	void *ptr = &&FOO;
				620	goto *bar;
				621	addrLabelExpr()
				622	matches '&&FOO'
				623	</pre></td></tr>
				624
				625
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	626	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	627	<tr><td colspan="4" class="doc" id="arraySubscriptExpr0"><pre>Matches array subscript expressions.
				628
				629	Given
				630	int i = a[1];
				631	arraySubscriptExpr()
				632	matches "a[1]"
				633	</pre></td></tr>
				634
				635
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	636	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	637	<tr><td colspan="4" class="doc" id="asmStmt0"><pre>Matches asm statements.
				638
				639	int i = 100;
				640	__asm("mov al, 2");
				641	asmStmt()
				642	matches '__asm("mov al, 2")'
				643	</pre></td></tr>
				644
				645
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	646	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('atomicExpr0')"><a name="atomicExpr0Anchor">atomicExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AtomicExpr.html">AtomicExpr</a>>...</td></tr>
				647	<tr><td colspan="4" class="doc" id="atomicExpr0"><pre>Matches atomic builtins.
				648	Example matches __atomic_load_n(ptr, 1)
				649	void foo() { int *ptr; __atomic_load_n(ptr, 1); }
				650	</pre></td></tr>
				651
				652
				653	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('binaryConditionalOperator0')"><a name="binaryConditionalOperator0Anchor">binaryConditionalOperator</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BinaryConditionalOperator.html">BinaryConditionalOperator</a>>...</td></tr>
				654	<tr><td colspan="4" class="doc" id="binaryConditionalOperator0"><pre>Matches binary conditional operator expressions (GNU extension).
				655
				656	Example matches a ?: b
				657	(a ?: b) + 42;
				658	</pre></td></tr>
				659
				660
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	661	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	662	<tr><td colspan="4" class="doc" id="binaryOperator0"><pre>Matches binary operator expressions.
				663
				664	Example matches a \|\| b
				665	!(a \|\| b)
				666	</pre></td></tr>
				667
				668
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	669	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	670	<tr><td colspan="4" class="doc" id="breakStmt0"><pre>Matches break statements.
				671
				672	Given
				673	while (true) { break; }
				674	breakStmt()
				675	matches 'break'
				676	</pre></td></tr>
				677
				678
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	679	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	680	<tr><td colspan="4" class="doc" id="cStyleCastExpr0"><pre>Matches a C-style cast expression.
				681
Artem Dergachev	ded92a9	2016-11-11 22:34:53 +0000	[diff] [blame]	682	Example: Matches (int) 2.2f in
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	683	int i = (int) 2.2f;
				684	</pre></td></tr>
				685
				686
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	687	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	688	<tr><td colspan="4" class="doc" id="callExpr0"><pre>Matches call expressions.
				689
				690	Example matches x.y() and y()
				691	X x;
				692	x.y();
				693	y();
				694	</pre></td></tr>
				695
				696
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	697	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	698	<tr><td colspan="4" class="doc" id="caseStmt0"><pre>Matches case statements inside switch statements.
				699
				700	Given
				701	switch(a) { case 42: break; default: break; }
				702	caseStmt()
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	703	matches 'case 42:'.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	704	</pre></td></tr>
				705
				706
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	707	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	708	<tr><td colspan="4" class="doc" id="castExpr0"><pre>Matches any cast nodes of Clang's AST.
				709
				710	Example: castExpr() matches each of the following:
				711	(int) 3;
				712	const_cast<Expr *>(SubExpr);
				713	char c = 0;
				714	but does not match
				715	int i = (0);
				716	int k = 0;
				717	</pre></td></tr>
				718
				719
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	720	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	721	<tr><td colspan="4" class="doc" id="characterLiteral0"><pre>Matches character literals (also matches wchar_t).
				722
				723	Not matching Hex-encoded chars (e.g. 0x1234, which is a IntegerLiteral),
				724	though.
				725
				726	Example matches 'a', L'a'
Etienne Bergeron	3588be7	2016-05-12 04:20:04 +0000	[diff] [blame]	727	char ch = 'a';
				728	wchar_t chw = L'a';
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	729	</pre></td></tr>
				730
				731
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	732	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	733	<tr><td colspan="4" class="doc" id="compoundLiteralExpr0"><pre>Matches compound (i.e. non-scalar) literals
				734
				735	Example match: {1}, (1, 2)
Etienne Bergeron	3588be7	2016-05-12 04:20:04 +0000	[diff] [blame]	736	int array[4] = {1};
				737	vector int myvec = (vector int)(1, 2);
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	738	</pre></td></tr>
				739
				740
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	741	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	742	<tr><td colspan="4" class="doc" id="compoundStmt0"><pre>Matches compound statements.
				743
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	744	Example matches '{}' and '{{}}' in 'for (;;) {{}}'
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	745	for (;;) {{}}
				746	</pre></td></tr>
				747
				748
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	749	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	750	<tr><td colspan="4" class="doc" id="conditionalOperator0"><pre>Matches conditional operator expressions.
				751
				752	Example matches a ? b : c
				753	(a ? b : c) + 42
				754	</pre></td></tr>
				755
				756
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	757	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	758	<tr><td colspan="4" class="doc" id="continueStmt0"><pre>Matches continue statements.
				759
				760	Given
				761	while (true) { continue; }
				762	continueStmt()
				763	matches 'continue'
				764	</pre></td></tr>
				765
				766
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	767	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	768	<tr><td colspan="4" class="doc" id="cudaKernelCallExpr0"><pre>Matches CUDA kernel call expression.
				769
				770	Example matches,
				771	kernel<<<i,j>>>();
				772	</pre></td></tr>
				773
				774
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	775	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	776	<tr><td colspan="4" class="doc" id="cxxBindTemporaryExpr0"><pre>Matches nodes where temporaries are created.
				777
				778	Example matches FunctionTakesString(GetStringByValue())
				779	(matcher = cxxBindTemporaryExpr())
				780	FunctionTakesString(GetStringByValue());
				781	FunctionTakesStringByPointer(GetStringPointer());
				782	</pre></td></tr>
				783
				784
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	785	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	786	<tr><td colspan="4" class="doc" id="cxxBoolLiteral0"><pre>Matches bool literals.
				787
				788	Example matches true
				789	true
				790	</pre></td></tr>
				791
				792
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	793	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	794	<tr><td colspan="4" class="doc" id="cxxCatchStmt0"><pre>Matches catch statements.
				795
				796	try {} catch(int i) {}
				797	cxxCatchStmt()
				798	matches 'catch(int i)'
				799	</pre></td></tr>
				800
				801
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	802	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	803	<tr><td colspan="4" class="doc" id="cxxConstCastExpr0"><pre>Matches a const_cast expression.
				804
				805	Example: Matches const_cast<int*>(&r) in
				806	int n = 42;
				807	const int &r(n);
				808	int* p = const_cast<int*>(&r);
				809	</pre></td></tr>
				810
				811
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	812	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	813	<tr><td colspan="4" class="doc" id="cxxConstructExpr0"><pre>Matches constructor call expressions (including implicit ones).
				814
				815	Example matches string(ptr, n) and ptr within arguments of f
				816	(matcher = cxxConstructExpr())
				817	void f(const string &a, const string &b);
				818	char *ptr;
				819	int n;
				820	f(string(ptr, n), ptr);
				821	</pre></td></tr>
				822
				823
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	824	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	825	<tr><td colspan="4" class="doc" id="cxxDefaultArgExpr0"><pre>Matches the value of a default argument at the call site.
				826
				827	Example matches the CXXDefaultArgExpr placeholder inserted for the
				828	default value of the second parameter in the call expression f(42)
				829	(matcher = cxxDefaultArgExpr())
				830	void f(int x, int y = 0);
				831	f(42);
				832	</pre></td></tr>
				833
				834
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	835	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	836	<tr><td colspan="4" class="doc" id="cxxDeleteExpr0"><pre>Matches delete expressions.
				837
				838	Given
				839	delete X;
				840	cxxDeleteExpr()
				841	matches 'delete X'.
				842	</pre></td></tr>
				843
				844
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	845	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	846	<tr><td colspan="4" class="doc" id="cxxDynamicCastExpr0"><pre>Matches a dynamic_cast expression.
				847
				848	Example:
				849	cxxDynamicCastExpr()
				850	matches
				851	dynamic_cast<D*>(&b);
				852	in
				853	struct B { virtual ~B() {} }; struct D : B {};
				854	B b;
				855	D* p = dynamic_cast<D*>(&b);
				856	</pre></td></tr>
				857
				858
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	859	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	860	<tr><td colspan="4" class="doc" id="cxxForRangeStmt0"><pre>Matches range-based for statements.
				861
				862	cxxForRangeStmt() matches 'for (auto a : i)'
				863	int i[] = {1, 2, 3}; for (auto a : i);
				864	for(int j = 0; j < 5; ++j);
				865	</pre></td></tr>
				866
				867
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	868	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	869	<tr><td colspan="4" class="doc" id="cxxFunctionalCastExpr0"><pre>Matches functional cast expressions
				870
				871	Example: Matches Foo(bar);
				872	Foo f = bar;
				873	Foo g = (Foo) bar;
				874	Foo h = Foo(bar);
				875	</pre></td></tr>
				876
				877
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	878	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	879	<tr><td colspan="4" class="doc" id="cxxMemberCallExpr0"><pre>Matches member call expressions.
				880
				881	Example matches x.y()
				882	X x;
				883	x.y();
				884	</pre></td></tr>
				885
				886
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	887	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	888	<tr><td colspan="4" class="doc" id="cxxNewExpr0"><pre>Matches new expressions.
				889
				890	Given
				891	new X;
				892	cxxNewExpr()
				893	matches 'new X'.
				894	</pre></td></tr>
				895
				896
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	897	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	898	<tr><td colspan="4" class="doc" id="cxxNullPtrLiteralExpr0"><pre>Matches nullptr literal.
				899	</pre></td></tr>
				900
				901
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	902	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	903	<tr><td colspan="4" class="doc" id="cxxOperatorCallExpr0"><pre>Matches overloaded operator calls.
				904
				905	Note that if an operator isn't overloaded, it won't match. Instead, use
				906	binaryOperator matcher.
				907	Currently it does not match operators such as new delete.
				908	FIXME: figure out why these do not match?
				909
				910	Example matches both operator<<((o << b), c) and operator<<(o, b)
				911	(matcher = cxxOperatorCallExpr())
				912	ostream &operator<< (ostream &out, int i) { };
				913	ostream &o; int b = 1, c = 1;
				914	o << b << c;
				915	</pre></td></tr>
				916
				917
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	918	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	919	<tr><td colspan="4" class="doc" id="cxxReinterpretCastExpr0"><pre>Matches a reinterpret_cast expression.
				920
				921	Either the source expression or the destination type can be matched
				922	using has(), but hasDestinationType() is more specific and can be
				923	more readable.
				924
				925	Example matches reinterpret_cast<char*>(&p) in
				926	void* p = reinterpret_cast<char*>(&p);
				927	</pre></td></tr>
				928
				929
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	930	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	931	<tr><td colspan="4" class="doc" id="cxxStaticCastExpr0"><pre>Matches a C++ static_cast expression.
				932
Aaron Ballman	c35724c	2016-01-21 15:18:25 +0000	[diff] [blame]	933	See also: hasDestinationType
				934	See also: reinterpretCast
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	935
				936	Example:
				937	cxxStaticCastExpr()
				938	matches
				939	static_cast<long>(8)
				940	in
				941	long eight(static_cast<long>(8));
				942	</pre></td></tr>
				943
				944
Jakub Kuderski	64b6c78	2017-05-05 21:01:12 +0000	[diff] [blame]	945	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('cxxStdInitializerListExpr0')"><a name="cxxStdInitializerListExpr0Anchor">cxxStdInitializerListExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXStdInitializerListExpr.html">CXXStdInitializerListExpr</a>>...</td></tr>
				946	<tr><td colspan="4" class="doc" id="cxxStdInitializerListExpr0"><pre>Matches C++ initializer list expressions.
				947
				948	Given
				949	std::vector<int> a({ 1, 2, 3 });
				950	std::vector<int> b = { 4, 5 };
				951	int c[] = { 6, 7 };
				952	std::pair<int, int> d = { 8, 9 };
				953	cxxStdInitializerListExpr()
				954	matches "{ 1, 2, 3 }" and "{ 4, 5 }"
				955	</pre></td></tr>
				956
				957
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	958	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	959	<tr><td colspan="4" class="doc" id="cxxTemporaryObjectExpr0"><pre>Matches functional cast expressions having N != 1 arguments
				960
				961	Example: Matches Foo(bar, bar)
				962	Foo h = Foo(bar, bar);
				963	</pre></td></tr>
				964
				965
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	966	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	967	<tr><td colspan="4" class="doc" id="cxxThisExpr0"><pre>Matches implicit and explicit this expressions.
				968
				969	Example matches the implicit this expression in "return i".
				970	(matcher = cxxThisExpr())
				971	struct foo {
				972	int i;
				973	int f() { return i; }
				974	};
				975	</pre></td></tr>
				976
				977
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	978	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	979	<tr><td colspan="4" class="doc" id="cxxThrowExpr0"><pre>Matches throw expressions.
				980
				981	try { throw 5; } catch(int i) {}
				982	cxxThrowExpr()
				983	matches 'throw 5'
				984	</pre></td></tr>
				985
				986
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	987	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	988	<tr><td colspan="4" class="doc" id="cxxTryStmt0"><pre>Matches try statements.
				989
				990	try {} catch(int i) {}
				991	cxxTryStmt()
				992	matches 'try {}'
				993	</pre></td></tr>
				994
				995
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	996	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	997	<tr><td colspan="4" class="doc" id="cxxUnresolvedConstructExpr0"><pre>Matches unresolved constructor call expressions.
				998
				999	Example matches T(t) in return statement of f
				1000	(matcher = cxxUnresolvedConstructExpr())
				1001	template <typename T>
				1002	void f(const T& t) { return T(t); }
				1003	</pre></td></tr>
				1004
				1005
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1006	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1007	<tr><td colspan="4" class="doc" id="declRefExpr0"><pre>Matches expressions that refer to declarations.
				1008
				1009	Example matches x in if (x)
				1010	bool x;
				1011	if (x) {}
				1012	</pre></td></tr>
				1013
				1014
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1015	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1016	<tr><td colspan="4" class="doc" id="declStmt0"><pre>Matches declaration statements.
				1017
				1018	Given
				1019	int a;
				1020	declStmt()
				1021	matches 'int a'.
				1022	</pre></td></tr>
				1023
				1024
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1025	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1026	<tr><td colspan="4" class="doc" id="defaultStmt0"><pre>Matches default statements inside switch statements.
				1027
				1028	Given
				1029	switch(a) { case 42: break; default: break; }
				1030	defaultStmt()
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	1031	matches 'default:'.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1032	</pre></td></tr>
				1033
				1034
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	1035	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('designatedInitExpr0')"><a name="designatedInitExpr0Anchor">designatedInitExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DesignatedInitExpr.html">DesignatedInitExpr</a>>...</td></tr>
				1036	<tr><td colspan="4" class="doc" id="designatedInitExpr0"><pre>Matches C99 designated initializer expressions [C99 6.7.8].
				1037
				1038	Example: Matches { [2].y = 1.0, [0].x = 1.0 }
				1039	point ptarray[10] = { [2].y = 1.0, [0].x = 1.0 };
				1040	</pre></td></tr>
				1041
				1042
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1043	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1044	<tr><td colspan="4" class="doc" id="doStmt0"><pre>Matches do statements.
				1045
				1046	Given
				1047	do {} while (true);
				1048	doStmt()
				1049	matches 'do {} while(true)'
				1050	</pre></td></tr>
				1051
				1052
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1053	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1054	<tr><td colspan="4" class="doc" id="explicitCastExpr0"><pre>Matches explicit cast expressions.
				1055
				1056	Matches any cast expression written in user code, whether it be a
				1057	C-style cast, a functional-style cast, or a keyword cast.
				1058
				1059	Does not match implicit conversions.
				1060
				1061	Note: the name "explicitCast" is chosen to match Clang's terminology, as
				1062	Clang uses the term "cast" to apply to implicit conversions as well as to
				1063	actual cast expressions.
				1064
Aaron Ballman	c35724c	2016-01-21 15:18:25 +0000	[diff] [blame]	1065	See also: hasDestinationType.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1066
				1067	Example: matches all five of the casts in
				1068	int((int)(reinterpret_cast<int>(static_cast<int>(const_cast<int>(42)))))
				1069	but does not match the implicit conversion in
				1070	long ell = 42;
				1071	</pre></td></tr>
				1072
				1073
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1074	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1075	<tr><td colspan="4" class="doc" id="expr0"><pre>Matches expressions.
				1076
				1077	Example matches x()
				1078	void f() { x(); }
				1079	</pre></td></tr>
				1080
				1081
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1082	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1083	<tr><td colspan="4" class="doc" id="exprWithCleanups0"><pre>Matches expressions that introduce cleanups to be run at the end
				1084	of the sub-expression's evaluation.
				1085
				1086	Example matches std::string()
				1087	const std::string str = std::string();
				1088	</pre></td></tr>
				1089
				1090
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1091	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1092	<tr><td colspan="4" class="doc" id="floatLiteral0"><pre>Matches float literals of all sizes encodings, e.g.
				1093	1.0, 1.0f, 1.0L and 1e10.
				1094
				1095	Does not match implicit conversions such as
				1096	float a = 10;
				1097	</pre></td></tr>
				1098
				1099
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1100	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1101	<tr><td colspan="4" class="doc" id="forStmt0"><pre>Matches for statements.
				1102
				1103	Example matches 'for (;;) {}'
				1104	for (;;) {}
				1105	int i[] = {1, 2, 3}; for (auto a : i);
				1106	</pre></td></tr>
				1107
				1108
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1109	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1110	<tr><td colspan="4" class="doc" id="gnuNullExpr0"><pre>Matches GNU __null expression.
				1111	</pre></td></tr>
				1112
				1113
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1114	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1115	<tr><td colspan="4" class="doc" id="gotoStmt0"><pre>Matches goto statements.
				1116
				1117	Given
				1118	goto FOO;
				1119	FOO: bar();
				1120	gotoStmt()
				1121	matches 'goto FOO'
				1122	</pre></td></tr>
				1123
				1124
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1125	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1126	<tr><td colspan="4" class="doc" id="ifStmt0"><pre>Matches if statements.
				1127
				1128	Example matches 'if (x) {}'
				1129	if (x) {}
				1130	</pre></td></tr>
				1131
				1132
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1133	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1134	<tr><td colspan="4" class="doc" id="implicitCastExpr0"><pre>Matches the implicit cast nodes of Clang's AST.
				1135
				1136	This matches many different places, including function call return value
				1137	eliding, as well as any type conversions.
				1138	</pre></td></tr>
				1139
				1140
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	1141	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('implicitValueInitExpr0')"><a name="implicitValueInitExpr0Anchor">implicitValueInitExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ImplicitValueInitExpr.html">ImplicitValueInitExpr</a>>...</td></tr>
				1142	<tr><td colspan="4" class="doc" id="implicitValueInitExpr0"><pre>Matches implicit initializers of init list expressions.
				1143
				1144	Given
				1145	point ptarray[10] = { [2].y = 1.0, [2].x = 2.0, [0].x = 1.0 };
				1146	implicitValueInitExpr()
				1147	matches "[0].y" (implicitly)
				1148	</pre></td></tr>
				1149
				1150
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1151	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1152	<tr><td colspan="4" class="doc" id="initListExpr0"><pre>Matches init list expressions.
				1153
				1154	Given
				1155	int a[] = { 1, 2 };
				1156	struct B { int x, y; };
				1157	B b = { 5, 6 };
				1158	initListExpr()
				1159	matches "{ 1, 2 }" and "{ 5, 6 }"
				1160	</pre></td></tr>
				1161
				1162
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1163	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1164	<tr><td colspan="4" class="doc" id="integerLiteral0"><pre>Matches integer literals of all sizes encodings, e.g.
				1165	1, 1L, 0x1 and 1U.
				1166
				1167	Does not match character-encoded integers such as L'a'.
				1168	</pre></td></tr>
				1169
				1170
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1171	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1172	<tr><td colspan="4" class="doc" id="labelStmt0"><pre>Matches label statements.
				1173
				1174	Given
				1175	goto FOO;
				1176	FOO: bar();
				1177	labelStmt()
				1178	matches 'FOO:'
				1179	</pre></td></tr>
				1180
				1181
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1182	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1183	<tr><td colspan="4" class="doc" id="lambdaExpr0"><pre>Matches lambda expressions.
				1184
				1185	Example matches [&](){return 5;}
				1186	[&](){return 5;}
				1187	</pre></td></tr>
				1188
				1189
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1190	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1191	<tr><td colspan="4" class="doc" id="materializeTemporaryExpr0"><pre>Matches nodes where temporaries are materialized.
				1192
				1193	Example: Given
Jakub Kuderski	64b6c78	2017-05-05 21:01:12 +0000	[diff] [blame]	1194	struct T {void func();};
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1195	T f();
				1196	void g(T);
				1197	materializeTemporaryExpr() matches 'f()' in these statements
				1198	T u(f());
				1199	g(f());
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	1200	f().func();
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1201	but does not match
				1202	f();
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1203	</pre></td></tr>
				1204
				1205
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1206	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1207	<tr><td colspan="4" class="doc" id="memberExpr0"><pre>Matches member expressions.
				1208
				1209	Given
				1210	class Y {
				1211	void x() { this->x(); x(); Y y; y.x(); a; this->b; Y::b; }
				1212	int a; static int b;
				1213	};
				1214	memberExpr()
				1215	matches this->x, x, y.x, a, this->b
				1216	</pre></td></tr>
				1217
				1218
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1219	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1220	<tr><td colspan="4" class="doc" id="nullStmt0"><pre>Matches null statements.
				1221
				1222	foo();;
				1223	nullStmt()
				1224	matches the second ';'
				1225	</pre></td></tr>
				1226
				1227
Dave Lee	0934fdc	2017-11-11 22:46:15 +0000	[diff] [blame]	1228	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('objcCatchStmt0')"><a name="objcCatchStmt0Anchor">objcCatchStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCAtCatchStmt.html">ObjCAtCatchStmt</a>>...</td></tr>
				1229	<tr><td colspan="4" class="doc" id="objcCatchStmt0"><pre>Matches Objective-C @catch statements.
				1230
				1231	Example matches @catch
				1232	@try {}
				1233	@catch (...) {}
				1234	</pre></td></tr>
				1235
				1236
				1237	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('objcFinallyStmt0')"><a name="objcFinallyStmt0Anchor">objcFinallyStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCAtFinallyStmt.html">ObjCAtFinallyStmt</a>>...</td></tr>
				1238	<tr><td colspan="4" class="doc" id="objcFinallyStmt0"><pre>Matches Objective-C @finally statements.
				1239
				1240	Example matches @finally
				1241	@try {}
				1242	@finally {}
				1243	</pre></td></tr>
				1244
				1245
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1246	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1247	<tr><td colspan="4" class="doc" id="objcMessageExpr0"><pre>Matches ObjectiveC Message invocation expressions.
				1248
				1249	The innermost message send invokes the "alloc" class method on the
				1250	NSString class, while the outermost message send invokes the
				1251	"initWithString" instance method on the object returned from
				1252	NSString's "alloc". This matcher should match both message sends.
				1253	[[NSString alloc] initWithString:@"Hello"]
				1254	</pre></td></tr>
				1255
Aaron Ballman	c35724c	2016-01-21 15:18:25 +0000	[diff] [blame]	1256
Dave Lee	0934fdc	2017-11-11 22:46:15 +0000	[diff] [blame]	1257	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('objcThrowStmt0')"><a name="objcThrowStmt0Anchor">objcThrowStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCAtThrowStmt.html">ObjCAtThrowStmt</a>>...</td></tr>
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	1258	<tr><td colspan="4" class="doc" id="objcThrowStmt0"><pre>Matches Objective-C statements.
Dave Lee	0934fdc	2017-11-11 22:46:15 +0000	[diff] [blame]	1259
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	1260	Example matches @throw obj;
Dave Lee	0934fdc	2017-11-11 22:46:15 +0000	[diff] [blame]	1261	</pre></td></tr>
				1262
				1263
				1264	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('objcTryStmt0')"><a name="objcTryStmt0Anchor">objcTryStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCAtTryStmt.html">ObjCAtTryStmt</a>>...</td></tr>
				1265	<tr><td colspan="4" class="doc" id="objcTryStmt0"><pre>Matches Objective-C @try statements.
				1266
				1267	Example matches @try
				1268	@try {}
				1269	@catch (...) {}
				1270	</pre></td></tr>
				1271
				1272
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	1273	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('opaqueValueExpr0')"><a name="opaqueValueExpr0Anchor">opaqueValueExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1OpaqueValueExpr.html">OpaqueValueExpr</a>>...</td></tr>
				1274	<tr><td colspan="4" class="doc" id="opaqueValueExpr0"><pre>Matches opaque value expressions. They are used as helpers
				1275	to reference another expressions and can be met
				1276	in BinaryConditionalOperators, for example.
				1277
				1278	Example matches 'a'
				1279	(a ?: c) + 42;
				1280	</pre></td></tr>
				1281
				1282
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1283	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('parenExpr0')"><a name="parenExpr0Anchor">parenExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParenExpr.html">ParenExpr</a>>...</td></tr>
Aaron Ballman	e8295d7	2016-01-20 16:17:39 +0000	[diff] [blame]	1284	<tr><td colspan="4" class="doc" id="parenExpr0"><pre>Matches parentheses used in expressions.
				1285
Aaron Ballman	c35724c	2016-01-21 15:18:25 +0000	[diff] [blame]	1286	Example matches (foo() + 1)
Aaron Ballman	e8295d7	2016-01-20 16:17:39 +0000	[diff] [blame]	1287	int foo() { return 1; }
				1288	int a = (foo() + 1);
Aaron Ballman	e8295d7	2016-01-20 16:17:39 +0000	[diff] [blame]	1289	</pre></td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1290
Aaron Ballman	c35724c	2016-01-21 15:18:25 +0000	[diff] [blame]	1291
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	1292	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('parenListExpr0')"><a name="parenListExpr0Anchor">parenListExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParenListExpr.html">ParenListExpr</a>>...</td></tr>
				1293	<tr><td colspan="4" class="doc" id="parenListExpr0"><pre>Matches paren list expressions.
				1294	ParenListExprs don't have a predefined type and are used for late parsing.
				1295	In the final AST, they can be met in template declarations.
				1296
				1297	Given
				1298	template<typename T> class X {
				1299	void f() {
				1300	X x(*this);
				1301	int a = 0, b = 1; int i = (a, b);
				1302	}
				1303	};
				1304	parenListExpr() matches "*this" but NOT matches (a, b) because (a, b)
				1305	has a predefined type and is a ParenExpr, not a ParenListExpr.
				1306	</pre></td></tr>
				1307
				1308
				1309	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('predefinedExpr0')"><a name="predefinedExpr0Anchor">predefinedExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1PredefinedExpr.html">PredefinedExpr</a>>...</td></tr>
				1310	<tr><td colspan="4" class="doc" id="predefinedExpr0"><pre>Matches predefined identifier expressions [C99 6.4.2.2].
				1311
				1312	Example: Matches __func__
				1313	printf("%s", __func__);
				1314	</pre></td></tr>
				1315
				1316
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1317	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1318	<tr><td colspan="4" class="doc" id="returnStmt0"><pre>Matches return statements.
				1319
				1320	Given
				1321	return 1;
				1322	returnStmt()
				1323	matches 'return 1'
				1324	</pre></td></tr>
				1325
				1326
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1327	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1328	<tr><td colspan="4" class="doc" id="stmt0"><pre>Matches statements.
				1329
				1330	Given
				1331	{ ++a; }
				1332	stmt()
				1333	matches both the compound statement '{ ++a; }' and '++a'.
				1334	</pre></td></tr>
				1335
				1336
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	1337	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('stmtExpr0')"><a name="stmtExpr0Anchor">stmtExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1StmtExpr.html">StmtExpr</a>>...</td></tr>
				1338	<tr><td colspan="4" class="doc" id="stmtExpr0"><pre>Matches statement expression (GNU extension).
				1339
				1340	Example match: ({ int X = 4; X; })
				1341	int C = ({ int X = 4; X; });
				1342	</pre></td></tr>
				1343
				1344
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1345	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1346	<tr><td colspan="4" class="doc" id="stringLiteral0"><pre>Matches string literals (also matches wide string literals).
				1347
				1348	Example matches "abcd", L"abcd"
Etienne Bergeron	3588be7	2016-05-12 04:20:04 +0000	[diff] [blame]	1349	char *s = "abcd";
				1350	wchar_t *ws = L"abcd";
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1351	</pre></td></tr>
				1352
				1353
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1354	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1355	<tr><td colspan="4" class="doc" id="substNonTypeTemplateParmExpr0"><pre>Matches substitutions of non-type template parameters.
				1356
				1357	Given
				1358	template <int N>
				1359	struct A { static const int n = N; };
				1360	struct B : public A<42> {};
				1361	substNonTypeTemplateParmExpr()
				1362	matches "N" in the right-hand side of "static const int n = N;"
				1363	</pre></td></tr>
				1364
				1365
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1366	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1367	<tr><td colspan="4" class="doc" id="switchCase0"><pre>Matches case and default statements inside switch statements.
				1368
				1369	Given
				1370	switch(a) { case 42: break; default: break; }
				1371	switchCase()
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	1372	matches 'case 42:' and 'default:'.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1373	</pre></td></tr>
				1374
				1375
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1376	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1377	<tr><td colspan="4" class="doc" id="switchStmt0"><pre>Matches switch statements.
				1378
				1379	Given
				1380	switch(a) { case 42: break; default: break; }
				1381	switchStmt()
				1382	matches 'switch(a)'.
				1383	</pre></td></tr>
				1384
				1385
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1386	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1387	<tr><td colspan="4" class="doc" id="unaryExprOrTypeTraitExpr0"><pre>Matches sizeof (C99), alignof (C++11) and vec_step (OpenCL)
				1388
				1389	Given
				1390	Foo x = bar;
				1391	int y = sizeof(x) + alignof(x);
				1392	unaryExprOrTypeTraitExpr()
				1393	matches sizeof(x) and alignof(x)
				1394	</pre></td></tr>
				1395
				1396
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1397	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1398	<tr><td colspan="4" class="doc" id="unaryOperator0"><pre>Matches unary operator expressions.
				1399
				1400	Example matches !a
				1401	!a \|\| b
				1402	</pre></td></tr>
				1403
				1404
Haojian Wu	7751c92	2016-05-18 12:53:59 +0000	[diff] [blame]	1405	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('unresolvedLookupExpr0')"><a name="unresolvedLookupExpr0Anchor">unresolvedLookupExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedLookupExpr.html">UnresolvedLookupExpr</a>>...</td></tr>
				1406	<tr><td colspan="4" class="doc" id="unresolvedLookupExpr0"><pre>Matches reference to a name that can be looked up during parsing
				1407	but could not be resolved to a specific declaration.
				1408
				1409	Given
				1410	template<typename T>
				1411	T foo() { T a; return a; }
				1412	template<typename T>
				1413	void bar() {
				1414	foo<T>();
				1415	}
				1416	unresolvedLookupExpr()
				1417	matches foo<T>() </pre></td></tr>
				1418
				1419
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1420	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1421	<tr><td colspan="4" class="doc" id="userDefinedLiteral0"><pre>Matches user defined literal operator call.
				1422
				1423	Example match: "foo"_suffix
				1424	</pre></td></tr>
				1425
				1426
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1427	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1428	<tr><td colspan="4" class="doc" id="whileStmt0"><pre>Matches while statements.
				1429
				1430	Given
				1431	while (true) {}
				1432	whileStmt()
				1433	matches 'while (true) {}'.
				1434	</pre></td></tr>
				1435
				1436
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1437	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1438	<tr><td colspan="4" class="doc" id="templateArgument0"><pre>Matches template arguments.
				1439
				1440	Given
				1441	template <typename T> struct C {};
				1442	C<int> c;
				1443	templateArgument()
				1444	matches 'int' in C<int>.
				1445	</pre></td></tr>
				1446
				1447
Haojian Wu	b33b02e	2016-07-29 15:45:11 +0000	[diff] [blame]	1448	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateName.html">TemplateName</a>></td><td class="name" onclick="toggle('templateName0')"><a name="templateName0Anchor">templateName</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateName.html">TemplateName</a>>...</td></tr>
				1449	<tr><td colspan="4" class="doc" id="templateName0"><pre>Matches template name.
				1450
				1451	Given
				1452	template <typename T> class X { };
				1453	X<int> xi;
				1454	templateName()
				1455	matches 'X' in X<int>.
				1456	</pre></td></tr>
				1457
				1458
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1459	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1460	<tr><td colspan="4" class="doc" id="typeLoc0"><pre>Matches TypeLocs in the clang AST.
				1461	</pre></td></tr>
				1462
				1463
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1464	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1465	<tr><td colspan="4" class="doc" id="arrayType0"><pre>Matches all kinds of arrays.
				1466
				1467	Given
				1468	int a[] = { 2, 3 };
				1469	int b[4];
				1470	void f() { int c[a[0]]; }
				1471	arrayType()
				1472	matches "int a[]", "int b[4]" and "int c[a[0]]";
				1473	</pre></td></tr>
				1474
				1475
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1476	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1477	<tr><td colspan="4" class="doc" id="atomicType0"><pre>Matches atomic types.
				1478
				1479	Given
				1480	_Atomic(int) i;
				1481	atomicType()
				1482	matches "_Atomic(int) i"
				1483	</pre></td></tr>
				1484
				1485
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1486	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1487	<tr><td colspan="4" class="doc" id="autoType0"><pre>Matches types nodes representing C++11 auto types.
				1488
				1489	Given:
				1490	auto n = 4;
				1491	int v[] = { 2, 3 }
				1492	for (auto i : v) { }
				1493	autoType()
				1494	matches "auto n" and "auto i"
				1495	</pre></td></tr>
				1496
				1497
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1498	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1499	<tr><td colspan="4" class="doc" id="blockPointerType0"><pre>Matches block pointer types, i.e. types syntactically represented as
				1500	"void (^)(int)".
				1501
				1502	The pointee is always required to be a FunctionType.
				1503	</pre></td></tr>
				1504
				1505
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1506	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1507	<tr><td colspan="4" class="doc" id="builtinType0"><pre>Matches builtin Types.
				1508
				1509	Given
				1510	struct A {};
				1511	A a;
				1512	int b;
				1513	float c;
				1514	bool d;
				1515	builtinType()
				1516	matches "int b", "float c" and "bool d"
				1517	</pre></td></tr>
				1518
				1519
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1520	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1521	<tr><td colspan="4" class="doc" id="complexType0"><pre>Matches C99 complex types.
				1522
				1523	Given
				1524	_Complex float f;
				1525	complexType()
				1526	matches "_Complex float f"
				1527	</pre></td></tr>
				1528
				1529
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1530	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1531	<tr><td colspan="4" class="doc" id="constantArrayType0"><pre>Matches C arrays with a specified constant size.
				1532
				1533	Given
				1534	void() {
				1535	int a[2];
				1536	int b[] = { 2, 3 };
				1537	int c[b[0]];
				1538	}
				1539	constantArrayType()
				1540	matches "int a[2]"
				1541	</pre></td></tr>
				1542
				1543
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1544	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1545	<tr><td colspan="4" class="doc" id="decayedType0"><pre>Matches decayed type
				1546	Example matches i[] in declaration of f.
				1547	(matcher = valueDecl(hasType(decayedType(hasDecayedType(pointerType())))))
				1548	Example matches i[1].
				1549	(matcher = expr(hasType(decayedType(hasDecayedType(pointerType())))))
				1550	void f(int i[]) {
				1551	i[1] = 0;
				1552	}
				1553	</pre></td></tr>
				1554
				1555
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1556	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1557	<tr><td colspan="4" class="doc" id="dependentSizedArrayType0"><pre>Matches C++ arrays whose size is a value-dependent expression.
				1558
				1559	Given
				1560	template<typename T, int Size>
				1561	class array {
				1562	T data[Size];
				1563	};
				1564	dependentSizedArrayType
				1565	matches "T data[Size]"
				1566	</pre></td></tr>
				1567
				1568
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1569	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1570	<tr><td colspan="4" class="doc" id="elaboratedType0"><pre>Matches types specified with an elaborated type keyword or with a
				1571	qualified name.
				1572
				1573	Given
				1574	namespace N {
				1575	namespace M {
				1576	class D {};
				1577	}
				1578	}
				1579	class C {};
				1580
				1581	class C c;
				1582	N::M::D d;
				1583
				1584	elaboratedType() matches the type of the variable declarations of both
				1585	c and d.
				1586	</pre></td></tr>
				1587
				1588
Haojian Wu	e775de8	2016-06-30 07:50:01 +0000	[diff] [blame]	1589	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('enumType0')"><a name="enumType0Anchor">enumType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumType.html">EnumType</a>>...</td></tr>
				1590	<tr><td colspan="4" class="doc" id="enumType0"><pre>Matches enum types.
				1591
				1592	Given
				1593	enum C { Green };
Aaron Ballman	5c57434	2016-07-06 18:25:16 +0000	[diff] [blame]	1594	enum class S { Red };
Haojian Wu	e775de8	2016-06-30 07:50:01 +0000	[diff] [blame]	1595
				1596	C c;
				1597	S s;
				1598
				1599	enumType() matches the type of the variable declarations of both c and
				1600	s.
				1601	</pre></td></tr>
				1602
				1603
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	1604	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('functionProtoType0')"><a name="functionProtoType0Anchor">functionProtoType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionProtoType.html">FunctionProtoType</a>>...</td></tr>
				1605	<tr><td colspan="4" class="doc" id="functionProtoType0"><pre>Matches FunctionProtoType nodes.
				1606
				1607	Given
				1608	int (*f)(int);
				1609	void g();
				1610	functionProtoType()
				1611	matches "int (*f)(int)" and the type of "g" in C++ mode.
				1612	In C mode, "g" is not matched because it does not contain a prototype.
				1613	</pre></td></tr>
				1614
				1615
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1616	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1617	<tr><td colspan="4" class="doc" id="functionType0"><pre>Matches FunctionType nodes.
				1618
				1619	Given
				1620	int (*f)(int);
				1621	void g();
				1622	functionType()
				1623	matches "int (*f)(int)" and the type of "g".
				1624	</pre></td></tr>
				1625
				1626
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1627	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1628	<tr><td colspan="4" class="doc" id="incompleteArrayType0"><pre>Matches C arrays with unspecified size.
				1629
				1630	Given
				1631	int a[] = { 2, 3 };
				1632	int b[42];
				1633	void f(int c[]) { int d[a[0]]; };
				1634	incompleteArrayType()
				1635	matches "int a[]" and "int c[]"
				1636	</pre></td></tr>
				1637
				1638
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1639	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1640	<tr><td colspan="4" class="doc" id="injectedClassNameType0"><pre>Matches injected class name types.
				1641
				1642	Example matches S s, but not S<T> s.
				1643	(matcher = parmVarDecl(hasType(injectedClassNameType())))
				1644	template <typename T> struct S {
				1645	void f(S s);
				1646	void g(S<T> s);
				1647	};
				1648	</pre></td></tr>
				1649
				1650
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1651	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1652	<tr><td colspan="4" class="doc" id="lValueReferenceType0"><pre>Matches lvalue reference types.
				1653
				1654	Given:
				1655	int *a;
				1656	int &b = *a;
				1657	int &&c = 1;
				1658	auto &d = b;
				1659	auto &&e = c;
				1660	auto &&f = 2;
				1661	int g = 5;
				1662
				1663	lValueReferenceType() matches the types of b, d, and e. e is
				1664	matched since the type is deduced as int& by reference collapsing rules.
				1665	</pre></td></tr>
				1666
				1667
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1668	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1669	<tr><td colspan="4" class="doc" id="memberPointerType0"><pre>Matches member pointer types.
				1670	Given
				1671	struct A { int i; }
				1672	A::* ptr = A::i;
				1673	memberPointerType()
				1674	matches "A::* ptr"
				1675	</pre></td></tr>
				1676
				1677
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1678	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1679	<tr><td colspan="4" class="doc" id="objcObjectPointerType0"><pre>Matches an Objective-C object pointer type, which is different from
				1680	a pointer type, despite being syntactically similar.
				1681
				1682	Given
				1683	int *a;
				1684
				1685	@interface Foo
				1686	@end
				1687	Foo *f;
				1688	pointerType()
				1689	matches "Foo f", but does not match "int a".
				1690	</pre></td></tr>
				1691
				1692
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1693	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1694	<tr><td colspan="4" class="doc" id="parenType0"><pre>Matches ParenType nodes.
				1695
				1696	Given
				1697	int (*ptr_to_array)[4];
				1698	int *array_of_ptrs[4];
				1699
				1700	varDecl(hasType(pointsTo(parenType()))) matches ptr_to_array but not
				1701	array_of_ptrs.
				1702	</pre></td></tr>
				1703
				1704
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1705	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1706	<tr><td colspan="4" class="doc" id="pointerType0"><pre>Matches pointer types, but does not match Objective-C object pointer
				1707	types.
				1708
				1709	Given
				1710	int *a;
				1711	int &b = *a;
				1712	int c = 5;
				1713
				1714	@interface Foo
				1715	@end
				1716	Foo *f;
				1717	pointerType()
				1718	matches "int a", but does not match "Foo f".
				1719	</pre></td></tr>
				1720
				1721
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1722	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1723	<tr><td colspan="4" class="doc" id="rValueReferenceType0"><pre>Matches rvalue reference types.
				1724
				1725	Given:
				1726	int *a;
				1727	int &b = *a;
				1728	int &&c = 1;
				1729	auto &d = b;
				1730	auto &&e = c;
				1731	auto &&f = 2;
				1732	int g = 5;
				1733
				1734	rValueReferenceType() matches the types of c and f. e is not
				1735	matched as it is deduced to int& by reference collapsing rules.
				1736	</pre></td></tr>
				1737
				1738
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1739	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1740	<tr><td colspan="4" class="doc" id="recordType0"><pre>Matches record types (e.g. structs, classes).
				1741
				1742	Given
				1743	class C {};
				1744	struct S {};
				1745
				1746	C c;
				1747	S s;
				1748
				1749	recordType() matches the type of the variable declarations of both c
				1750	and s.
				1751	</pre></td></tr>
				1752
				1753
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1754	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1755	<tr><td colspan="4" class="doc" id="referenceType0"><pre>Matches both lvalue and rvalue reference types.
				1756
				1757	Given
				1758	int *a;
				1759	int &b = *a;
				1760	int &&c = 1;
				1761	auto &d = b;
				1762	auto &&e = c;
				1763	auto &&f = 2;
				1764	int g = 5;
				1765
				1766	referenceType() matches the types of b, c, d, e, and f.
				1767	</pre></td></tr>
				1768
				1769
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1770	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1771	<tr><td colspan="4" class="doc" id="substTemplateTypeParmType0"><pre>Matches types that represent the result of substituting a type for a
				1772	template type parameter.
				1773
				1774	Given
				1775	template <typename T>
				1776	void F(T t) {
				1777	int i = 1 + t;
				1778	}
				1779
				1780	substTemplateTypeParmType() matches the type of 't' but not '1'
				1781	</pre></td></tr>
				1782
				1783
Manuel Klimek	696e505	2017-08-02 13:04:44 +0000	[diff] [blame]	1784	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('tagType0')"><a name="tagType0Anchor">tagType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TagType.html">TagType</a>>...</td></tr>
				1785	<tr><td colspan="4" class="doc" id="tagType0"><pre>Matches tag types (record and enum types).
				1786
				1787	Given
				1788	enum E {};
				1789	class C {};
				1790
				1791	E e;
				1792	C c;
				1793
				1794	tagType() matches the type of the variable declarations of both e
				1795	and c.
				1796	</pre></td></tr>
				1797
				1798
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1799	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1800	<tr><td colspan="4" class="doc" id="templateSpecializationType0"><pre>Matches template specialization types.
				1801
				1802	Given
				1803	template <typename T>
				1804	class C { };
				1805
				1806	template class C<int>; A
				1807	C<char> var; B
				1808
				1809	templateSpecializationType() matches the type of the explicit
				1810	instantiation in A and the type of the variable declaration in B.
				1811	</pre></td></tr>
				1812
				1813
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1814	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1815	<tr><td colspan="4" class="doc" id="templateTypeParmType0"><pre>Matches template type parameter types.
				1816
				1817	Example matches T, but not int.
				1818	(matcher = templateTypeParmType())
				1819	template <typename T> void f(int i);
				1820	</pre></td></tr>
				1821
				1822
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1823	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1824	<tr><td colspan="4" class="doc" id="type0"><pre>Matches Types in the clang AST.
				1825	</pre></td></tr>
				1826
				1827
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1828	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1829	<tr><td colspan="4" class="doc" id="typedefType0"><pre>Matches typedef types.
				1830
				1831	Given
				1832	typedef int X;
				1833	typedefType()
				1834	matches "typedef int X"
				1835	</pre></td></tr>
				1836
				1837
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1838	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1839	<tr><td colspan="4" class="doc" id="unaryTransformType0"><pre>Matches types nodes representing unary type transformations.
				1840
				1841	Given:
				1842	typedef __underlying_type(T) type;
				1843	unaryTransformType()
				1844	matches "__underlying_type(T)"
				1845	</pre></td></tr>
				1846
				1847
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1848	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1849	<tr><td colspan="4" class="doc" id="variableArrayType0"><pre>Matches C arrays with a specified size that is not an
				1850	integer-constant-expression.
				1851
				1852	Given
				1853	void f() {
				1854	int a[] = { 2, 3 }
				1855	int b[42];
				1856	int c[a[0]];
				1857	}
				1858	variableArrayType()
				1859	matches "int c[a[0]]"
				1860	</pre></td></tr>
				1861
Benjamin Kramer	7d0cc23	2015-11-20 07:57:46 +0000	[diff] [blame]	1862	<!--END_DECL_MATCHERS -->
				1863	</table>
				1864
				1865	<!-- ======================================================================= -->
				1866	<h2 id="narrowing-matchers">Narrowing Matchers</h2>
				1867	<!-- ======================================================================= -->
				1868
				1869	<p>Narrowing matchers match certain attributes on the current node, thus
				1870	narrowing down the set of nodes of the current type to match on.</p>
				1871
				1872	<p>There are special logical narrowing matchers (allOf, anyOf, anything and unless)
				1873	which allow users to create more powerful match expressions.</p>
				1874
				1875	<table>
				1876	<tr style="text-align:left"><th>Return type</th><th>Name</th><th>Parameters</th></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1877	<!-- START_NARROWING_MATCHERS -->
				1878
				1879	<tr><td>Matcher<></td><td class="name" onclick="toggle('allOf0')"><a name="allOf0Anchor">allOf</a></td><td>Matcher<>, ..., Matcher<*></td></tr>
				1880	<tr><td colspan="4" class="doc" id="allOf0"><pre>Matches if all given matchers match.
				1881
				1882	Usable as: Any Matcher
				1883	</pre></td></tr>
				1884
				1885
				1886	<tr><td>Matcher<></td><td class="name" onclick="toggle('anyOf0')"><a name="anyOf0Anchor">anyOf</a></td><td>Matcher<>, ..., Matcher<*></td></tr>
				1887	<tr><td colspan="4" class="doc" id="anyOf0"><pre>Matches if any of the given matchers matches.
				1888
				1889	Usable as: Any Matcher
				1890	</pre></td></tr>
				1891
				1892
				1893	<tr><td>Matcher<*></td><td class="name" onclick="toggle('anything0')"><a name="anything0Anchor">anything</a></td><td></td></tr>
				1894	<tr><td colspan="4" class="doc" id="anything0"><pre>Matches any node.
				1895
				1896	Useful when another matcher requires a child matcher, but there's no
				1897	additional constraint. This will often be used with an explicit conversion
				1898	to an internal::Matcher<> type such as TypeMatcher.
				1899
				1900	Example: DeclarationMatcher(anything()) matches all declarations, e.g.,
				1901	"int* p" and "void f()" in
				1902	int* p;
				1903	void f();
				1904
				1905	Usable as: Any Matcher
				1906	</pre></td></tr>
				1907
				1908
				1909	<tr><td>Matcher<></td><td class="name" onclick="toggle('unless0')"><a name="unless0Anchor">unless</a></td><td>Matcher<></td></tr>
				1910	<tr><td colspan="4" class="doc" id="unless0"><pre>Matches if the provided matcher does not match.
				1911
				1912	Example matches Y (matcher = cxxRecordDecl(unless(hasName("X"))))
				1913	class X {};
				1914	class Y {};
				1915
				1916	Usable as: Any Matcher
				1917	</pre></td></tr>
				1918
				1919
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1920	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1921	<tr><td colspan="4" class="doc" id="hasOperatorName0"><pre>Matches the operator Name of operator expressions (binary or
				1922	unary).
				1923
				1924	Example matches a \|\| b (matcher = binaryOperator(hasOperatorName("\|\|")))
				1925	!(a \|\| b)
				1926	</pre></td></tr>
				1927
				1928
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	1929	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXBoolLiteralExpr.html">CXXBoolLiteralExpr</a>></td><td class="name" onclick="toggle('equals5')"><a name="equals5Anchor">equals</a></td><td>bool Value</td></tr>
				1930	<tr><td colspan="4" class="doc" id="equals5"><pre></pre></td></tr>
				1931
				1932
				1933	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXBoolLiteralExpr.html">CXXBoolLiteralExpr</a>></td><td class="name" onclick="toggle('equals2')"><a name="equals2Anchor">equals</a></td><td>const ValueT Value</td></tr>
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	1934	<tr><td colspan="4" class="doc" id="equals2"><pre>Matches literals that are equal to the given value of type ValueT.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1935
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	1936	Given
				1937	f('false, 3.14, 42);
				1938	characterLiteral(equals(0))
				1939	matches 'cxxBoolLiteral(equals(false)) and cxxBoolLiteral(equals(0))
				1940	match false
				1941	floatLiteral(equals(3.14)) and floatLiteral(equals(314e-2))
				1942	match 3.14
				1943	integerLiteral(equals(42))
				1944	matches 42
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1945
Clement Courbet	43bdba4	2017-07-11 15:45:22 +0000	[diff] [blame]	1946	Note that you cannot directly match a negative numeric literal because the
				1947	minus sign is not part of the literal: It is a unary operator whose operand
				1948	is the positive numeric literal. Instead, you must use a unaryOperator()
				1949	matcher to match the minus sign:
				1950
				1951	unaryOperator(hasOperatorName("-"),
				1952	hasUnaryOperand(integerLiteral(equals(13))))
				1953
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	1954	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CharacterLiteral.html">CharacterLiteral</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXBoolLiteralExpr.html">CXXBoolLiteralExpr</a>>,
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1955	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1956	</pre></td></tr>
				1957
				1958
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	1959	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXBoolLiteralExpr.html">CXXBoolLiteralExpr</a>></td><td class="name" onclick="toggle('equals11')"><a name="equals11Anchor">equals</a></td><td>double Value</td></tr>
				1960	<tr><td colspan="4" class="doc" id="equals11"><pre></pre></td></tr>
				1961
				1962
				1963	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXBoolLiteralExpr.html">CXXBoolLiteralExpr</a>></td><td class="name" onclick="toggle('equals8')"><a name="equals8Anchor">equals</a></td><td>unsigned Value</td></tr>
				1964	<tr><td colspan="4" class="doc" id="equals8"><pre></pre></td></tr>
				1965
				1966
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1967	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1968	<tr><td colspan="4" class="doc" id="isCatchAll0"><pre>Matches a C++ catch statement that has a catch-all handler.
				1969
				1970	Given
				1971	try {
				1972	...
				1973	} catch (int) {
				1974	...
				1975	} catch (...) {
				1976	...
				1977	}
				1978	endcode
				1979	cxxCatchStmt(isCatchAll()) matches catch(...) but not catch(int).
				1980	</pre></td></tr>
				1981
				1982
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1983	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1984	<tr><td colspan="4" class="doc" id="argumentCountIs1"><pre>Checks that a call expression or a constructor call expression has
				1985	a specific number of arguments (including absent default arguments).
				1986
				1987	Example matches f(0, 0) (matcher = callExpr(argumentCountIs(2)))
				1988	void f(int x, int y);
				1989	f(0, 0);
				1990	</pre></td></tr>
				1991
				1992
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1993	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1994	<tr><td colspan="4" class="doc" id="isListInitialization0"><pre>Matches a constructor call expression which uses list initialization.
				1995	</pre></td></tr>
				1996
				1997
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	1998	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>></td><td class="name" onclick="toggle('requiresZeroInitialization0')"><a name="requiresZeroInitialization0Anchor">requiresZeroInitialization</a></td><td></td></tr>
				1999	<tr><td colspan="4" class="doc" id="requiresZeroInitialization0"><pre>Matches a constructor call expression which requires
				2000	zero initialization.
				2001
				2002	Given
				2003	void foo() {
				2004	struct point { double x; double y; };
				2005	point pt[2] = { { 1.0, 2.0 } };
				2006	}
				2007	initListExpr(has(cxxConstructExpr(requiresZeroInitialization()))
				2008	will match the implicit array filler for pt[1].
				2009	</pre></td></tr>
				2010
				2011
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2012	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2013	<tr><td colspan="4" class="doc" id="isCopyConstructor0"><pre>Matches constructor declarations that are copy constructors.
				2014
				2015	Given
				2016	struct S {
				2017	S(); #1
				2018	S(const S &); #2
				2019	S(S &&); #3
				2020	};
				2021	cxxConstructorDecl(isCopyConstructor()) will match #2, but not #1 or #3.
				2022	</pre></td></tr>
				2023
				2024
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2025	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2026	<tr><td colspan="4" class="doc" id="isDefaultConstructor0"><pre>Matches constructor declarations that are default constructors.
				2027
				2028	Given
				2029	struct S {
				2030	S(); #1
				2031	S(const S &); #2
				2032	S(S &&); #3
				2033	};
				2034	cxxConstructorDecl(isDefaultConstructor()) will match #1, but not #2 or #3.
				2035	</pre></td></tr>
				2036
				2037
Alexander Kornienko	7d20a5a	2016-04-13 11:13:08 +0000	[diff] [blame]	2038	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructorDecl.html">CXXConstructorDecl</a>></td><td class="name" onclick="toggle('isDelegatingConstructor0')"><a name="isDelegatingConstructor0Anchor">isDelegatingConstructor</a></td><td></td></tr>
				2039	<tr><td colspan="4" class="doc" id="isDelegatingConstructor0"><pre>Matches constructors that delegate to another constructor.
				2040
				2041	Given
				2042	struct S {
				2043	S(); #1
				2044	S(int) {} #2
				2045	S(S &&) : S() {} #3
				2046	};
				2047	S::S() : S(0) {} #4
				2048	cxxConstructorDecl(isDelegatingConstructor()) will match #3 and #4, but not
				2049	#1 or #2.
				2050	</pre></td></tr>
				2051
				2052
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2053	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2054	<tr><td colspan="4" class="doc" id="isExplicit0"><pre>Matches constructor and conversion declarations that are marked with
				2055	the explicit keyword.
				2056
				2057	Given
				2058	struct S {
				2059	S(int); #1
				2060	explicit S(double); #2
				2061	operator int(); #3
				2062	explicit operator bool(); #4
				2063	};
				2064	cxxConstructorDecl(isExplicit()) will match #2, but not #1.
				2065	cxxConversionDecl(isExplicit()) will match #4, but not #3.
				2066	</pre></td></tr>
				2067
				2068
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2069	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2070	<tr><td colspan="4" class="doc" id="isMoveConstructor0"><pre>Matches constructor declarations that are move constructors.
				2071
				2072	Given
				2073	struct S {
				2074	S(); #1
				2075	S(const S &); #2
				2076	S(S &&); #3
				2077	};
				2078	cxxConstructorDecl(isMoveConstructor()) will match #3, but not #1 or #2.
				2079	</pre></td></tr>
				2080
				2081
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2082	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2083	<tr><td colspan="4" class="doc" id="isExplicit1"><pre>Matches constructor and conversion declarations that are marked with
				2084	the explicit keyword.
				2085
				2086	Given
				2087	struct S {
				2088	S(int); #1
				2089	explicit S(double); #2
				2090	operator int(); #3
				2091	explicit operator bool(); #4
				2092	};
				2093	cxxConstructorDecl(isExplicit()) will match #2, but not #1.
				2094	cxxConversionDecl(isExplicit()) will match #4, but not #3.
				2095	</pre></td></tr>
				2096
				2097
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2098	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2099	<tr><td colspan="4" class="doc" id="isBaseInitializer0"><pre>Matches a constructor initializer if it is initializing a base, as
				2100	opposed to a member.
				2101
				2102	Given
				2103	struct B {};
				2104	struct D : B {
				2105	int I;
				2106	D(int i) : I(i) {}
				2107	};
				2108	struct E : B {
				2109	E() : B() {}
				2110	};
				2111	cxxConstructorDecl(hasAnyConstructorInitializer(isBaseInitializer()))
				2112	will match E(), but not match D(int).
				2113	</pre></td></tr>
				2114
				2115
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2116	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2117	<tr><td colspan="4" class="doc" id="isMemberInitializer0"><pre>Matches a constructor initializer if it is initializing a member, as
				2118	opposed to a base.
				2119
				2120	Given
				2121	struct B {};
				2122	struct D : B {
				2123	int I;
				2124	D(int i) : I(i) {}
				2125	};
				2126	struct E : B {
				2127	E() : B() {}
				2128	};
				2129	cxxConstructorDecl(hasAnyConstructorInitializer(isMemberInitializer()))
				2130	will match D(int), but not match E().
				2131	</pre></td></tr>
				2132
				2133
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2134	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2135	<tr><td colspan="4" class="doc" id="isWritten0"><pre>Matches a constructor initializer if it is explicitly written in
				2136	code (as opposed to implicitly added by the compiler).
				2137
				2138	Given
				2139	struct Foo {
				2140	Foo() { }
				2141	Foo(int) : foo_("A") { }
				2142	string foo_;
				2143	};
				2144	cxxConstructorDecl(hasAnyConstructorInitializer(isWritten()))
				2145	will match Foo(int), but not Foo()
				2146	</pre></td></tr>
				2147
				2148
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2149	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2150	<tr><td colspan="4" class="doc" id="isConst0"><pre>Matches if the given method declaration is const.
				2151
				2152	Given
				2153	struct A {
				2154	void foo() const;
				2155	void bar();
				2156	};
				2157
				2158	cxxMethodDecl(isConst()) matches A::foo() but not A::bar()
				2159	</pre></td></tr>
				2160
				2161
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2162	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMethodDecl.html">CXXMethodDecl</a>></td><td class="name" onclick="toggle('isCopyAssignmentOperator0')"><a name="isCopyAssignmentOperator0Anchor">isCopyAssignmentOperator</a></td><td></td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2163	<tr><td colspan="4" class="doc" id="isCopyAssignmentOperator0"><pre>Matches if the given method declaration declares a copy assignment
				2164	operator.
				2165
				2166	Given
				2167	struct A {
				2168	A &operator=(const A &);
				2169	A &operator=(A &&);
				2170	};
				2171
				2172	cxxMethodDecl(isCopyAssignmentOperator()) matches the first method but not
				2173	the second one.
				2174	</pre></td></tr>
				2175
				2176
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2177	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2178	<tr><td colspan="4" class="doc" id="isFinal1"><pre>Matches if the given method or class declaration is final.
				2179
				2180	Given:
				2181	class A final {};
				2182
				2183	struct B {
				2184	virtual void f();
				2185	};
				2186
				2187	struct C : B {
				2188	void f() final;
				2189	};
				2190	matches A and C::f, but not B, C, or B::f
				2191	</pre></td></tr>
				2192
				2193
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2194	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMethodDecl.html">CXXMethodDecl</a>></td><td class="name" onclick="toggle('isMoveAssignmentOperator0')"><a name="isMoveAssignmentOperator0Anchor">isMoveAssignmentOperator</a></td><td></td></tr>
Aaron Ballman	31bde87	2016-01-22 22:37:09 +0000	[diff] [blame]	2195	<tr><td colspan="4" class="doc" id="isMoveAssignmentOperator0"><pre>Matches if the given method declaration declares a move assignment
				2196	operator.
				2197
				2198	Given
Aaron Ballman	a681151	2016-01-23 17:49:18 +0000	[diff] [blame]	2199	struct A {
				2200	A &operator=(const A &);
				2201	A &operator=(A &&);
				2202	};
				2203
				2204	cxxMethodDecl(isMoveAssignmentOperator()) matches the second method but not
				2205	the first one.
Aaron Ballman	31bde87	2016-01-22 22:37:09 +0000	[diff] [blame]	2206	</pre></td></tr>
				2207
				2208
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2209	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2210	<tr><td colspan="4" class="doc" id="isOverride0"><pre>Matches if the given method declaration overrides another method.
				2211
				2212	Given
				2213	class A {
				2214	public:
				2215	virtual void x();
				2216	};
				2217	class B : public A {
				2218	public:
				2219	virtual void x();
				2220	};
				2221	matches B::x
				2222	</pre></td></tr>
				2223
				2224
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2225	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2226	<tr><td colspan="4" class="doc" id="isPure0"><pre>Matches if the given method declaration is pure.
				2227
				2228	Given
				2229	class A {
				2230	public:
				2231	virtual void x() = 0;
				2232	};
				2233	matches A::x
				2234	</pre></td></tr>
				2235
				2236
Alexander Kornienko	7d20a5a	2016-04-13 11:13:08 +0000	[diff] [blame]	2237	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMethodDecl.html">CXXMethodDecl</a>></td><td class="name" onclick="toggle('isUserProvided0')"><a name="isUserProvided0Anchor">isUserProvided</a></td><td></td></tr>
				2238	<tr><td colspan="4" class="doc" id="isUserProvided0"><pre>Matches method declarations that are user-provided.
				2239
				2240	Given
				2241	struct S {
				2242	S(); #1
				2243	S(const S &) = default; #2
				2244	S(S &&) = delete; #3
				2245	};
				2246	cxxConstructorDecl(isUserProvided()) will match #1, but not #2 or #3.
				2247	</pre></td></tr>
				2248
				2249
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2250	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2251	<tr><td colspan="4" class="doc" id="isVirtual0"><pre>Matches if the given method declaration is virtual.
				2252
				2253	Given
				2254	class A {
				2255	public:
				2256	virtual void x();
				2257	};
				2258	matches A::x
				2259	</pre></td></tr>
				2260
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2261
				2262	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMethodDecl.html">CXXMethodDecl</a>></td><td class="name" onclick="toggle('isVirtualAsWritten0')"><a name="isVirtualAsWritten0Anchor">isVirtualAsWritten</a></td><td></td></tr>
Nico Weber	a415a1d	2016-01-21 17:56:24 +0000	[diff] [blame]	2263	<tr><td colspan="4" class="doc" id="isVirtualAsWritten0"><pre>Matches if the given method declaration has an explicit "virtual".
				2264
				2265	Given
				2266	class A {
				2267	public:
				2268	virtual void x();
				2269	};
				2270	class B : public A {
				2271	public:
				2272	void x();
				2273	};
				2274	matches A::x but not B::x
				2275	</pre></td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2276
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2277
Adam Balogh	da488a6	2017-11-23 12:43:20 +0000	[diff] [blame]	2278	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>></td><td class="name" onclick="toggle('isArray0')"><a name="isArray0Anchor">isArray</a></td><td></td></tr>
				2279	<tr><td colspan="4" class="doc" id="isArray0"><pre>Matches array new expressions.
				2280
				2281	Given:
				2282	MyClass *p1 = new MyClass[10];
				2283	cxxNewExpr(isArray())
				2284	matches the expression 'new MyClass[10]'.
				2285	</pre></td></tr>
				2286
				2287
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2288	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2289	<tr><td colspan="4" class="doc" id="hasOverloadedOperatorName1"><pre>Matches overloaded operator names.
				2290
				2291	Matches overloaded operator names specified in strings without the
				2292	"operator" prefix: e.g. "<<".
				2293
				2294	Given:
				2295	class A { int operator*(); };
				2296	const A &operator<<(const A &a, const A &b);
				2297	A a;
				2298	a << a; <-- This matches
				2299
				2300	cxxOperatorCallExpr(hasOverloadedOperatorName("<<"))) matches the
				2301	specified line and
				2302	cxxRecordDecl(hasMethod(hasOverloadedOperatorName("*")))
				2303	matches the declaration of A.
				2304
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2305	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2306	</pre></td></tr>
				2307
				2308
Aaron Ballman	813e36c	2017-11-29 21:21:51 +0000	[diff] [blame]	2309	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>></td><td class="name" onclick="toggle('hasDefinition0')"><a name="hasDefinition0Anchor">hasDefinition</a></td><td></td></tr>
				2310	<tr><td colspan="4" class="doc" id="hasDefinition0"><pre>Matches a class declaration that is defined.
				2311
				2312	Example matches x (matcher = cxxRecordDecl(hasDefinition()))
				2313	class x {};
				2314	class y;
				2315	</pre></td></tr>
				2316
				2317
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2318	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2319	<tr><td colspan="4" class="doc" id="isDerivedFrom1"><pre>Overloaded method as shortcut for isDerivedFrom(hasName(...)).
				2320	</pre></td></tr>
				2321
				2322
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2323	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2324	<tr><td colspan="4" class="doc" id="isExplicitTemplateSpecialization2"><pre>Matches explicit template specializations of function, class, or
				2325	static member variable template instantiations.
				2326
				2327	Given
				2328	template<typename T> void A(T t) { }
				2329	template<> void A(int N) { }
				2330	functionDecl(isExplicitTemplateSpecialization())
				2331	matches the specialization A<int>().
				2332
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2333	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2334	</pre></td></tr>
				2335
				2336
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2337	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2338	<tr><td colspan="4" class="doc" id="isFinal0"><pre>Matches if the given method or class declaration is final.
				2339
				2340	Given:
				2341	class A final {};
				2342
				2343	struct B {
				2344	virtual void f();
				2345	};
				2346
				2347	struct C : B {
				2348	void f() final;
				2349	};
				2350	matches A and C::f, but not B, C, or B::f
				2351	</pre></td></tr>
				2352
				2353
Samuel Benzaquen	49385c7	2016-06-28 14:08:56 +0000	[diff] [blame]	2354	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXRecordDecl.html">CXXRecordDecl</a>></td><td class="name" onclick="toggle('isLambda0')"><a name="isLambda0Anchor">isLambda</a></td><td></td></tr>
				2355	<tr><td colspan="4" class="doc" id="isLambda0"><pre>Matches the generated class of lambda expressions.
				2356
				2357	Given:
				2358	auto x = []{};
				2359
				2360	cxxRecordDecl(isLambda()) matches the implicit class declaration of
				2361	decltype(x)
				2362	</pre></td></tr>
				2363
				2364
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2365	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2366	<tr><td colspan="4" class="doc" id="isSameOrDerivedFrom1"><pre>Overloaded method as shortcut for
				2367	isSameOrDerivedFrom(hasName(...)).
				2368	</pre></td></tr>
				2369
				2370
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2371	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2372	<tr><td colspan="4" class="doc" id="isTemplateInstantiation2"><pre>Matches template instantiations of function, class, or static
				2373	member variable template instantiations.
				2374
				2375	Given
				2376	template <typename T> class X {}; class A {}; X<A> x;
				2377	or
				2378	template <typename T> class X {}; class A {}; template class X<A>;
Eric Liu	09ee48e	2018-02-21 14:22:42 +0000	[diff] [blame]	2379	or
				2380	template <typename T> class X {}; class A {}; extern template class X<A>;
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2381	cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
				2382	matches the template instantiation of X<A>.
				2383
				2384	But given
				2385	template <typename T> class X {}; class A {};
				2386	template <> class X<A> {}; X<A> x;
				2387	cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
				2388	does not match, as X<A> is an explicit template specialization.
				2389
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2390	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2391	</pre></td></tr>
				2392
				2393
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2394	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2395	<tr><td colspan="4" class="doc" id="argumentCountIs0"><pre>Checks that a call expression or a constructor call expression has
				2396	a specific number of arguments (including absent default arguments).
				2397
				2398	Example matches f(0, 0) (matcher = callExpr(argumentCountIs(2)))
				2399	void f(int x, int y);
				2400	f(0, 0);
				2401	</pre></td></tr>
				2402
				2403
Etienne Bergeron	75e5272	2016-05-13 19:36:55 +0000	[diff] [blame]	2404	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CastExpr.html">CastExpr</a>></td><td class="name" onclick="toggle('hasCastKind0')"><a name="hasCastKind0Anchor">hasCastKind</a></td><td>CastKind Kind</td></tr>
				2405	<tr><td colspan="4" class="doc" id="hasCastKind0"><pre>Matches casts that has a given cast kind.
				2406
				2407	Example: matches the implicit cast around 0
				2408	(matcher = castExpr(hasCastKind(CK_NullToPointer)))
				2409	int *p = 0;
				2410	</pre></td></tr>
				2411
				2412
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	2413	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CharacterLiteral.html">CharacterLiteral</a>></td><td class="name" onclick="toggle('equals4')"><a name="equals4Anchor">equals</a></td><td>bool Value</td></tr>
				2414	<tr><td colspan="4" class="doc" id="equals4"><pre></pre></td></tr>
				2415
				2416
				2417	<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>const ValueT Value</td></tr>
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2418	<tr><td colspan="4" class="doc" id="equals3"><pre>Matches literals that are equal to the given value of type ValueT.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2419
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2420	Given
				2421	f('false, 3.14, 42);
				2422	characterLiteral(equals(0))
				2423	matches 'cxxBoolLiteral(equals(false)) and cxxBoolLiteral(equals(0))
				2424	match false
				2425	floatLiteral(equals(3.14)) and floatLiteral(equals(314e-2))
				2426	match 3.14
				2427	integerLiteral(equals(42))
				2428	matches 42
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2429
Clement Courbet	43bdba4	2017-07-11 15:45:22 +0000	[diff] [blame]	2430	Note that you cannot directly match a negative numeric literal because the
				2431	minus sign is not part of the literal: It is a unary operator whose operand
				2432	is the positive numeric literal. Instead, you must use a unaryOperator()
				2433	matcher to match the minus sign:
				2434
				2435	unaryOperator(hasOperatorName("-"),
				2436	hasUnaryOperand(integerLiteral(equals(13))))
				2437
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2438	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CharacterLiteral.html">CharacterLiteral</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXBoolLiteralExpr.html">CXXBoolLiteralExpr</a>>,
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2439	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2440	</pre></td></tr>
				2441
				2442
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2443	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CharacterLiteral.html">CharacterLiteral</a>></td><td class="name" onclick="toggle('equals10')"><a name="equals10Anchor">equals</a></td><td>double Value</td></tr>
				2444	<tr><td colspan="4" class="doc" id="equals10"><pre></pre></td></tr>
				2445
				2446
				2447	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CharacterLiteral.html">CharacterLiteral</a>></td><td class="name" onclick="toggle('equals7')"><a name="equals7Anchor">equals</a></td><td>unsigned Value</td></tr>
				2448	<tr><td colspan="4" class="doc" id="equals7"><pre></pre></td></tr>
				2449
				2450
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2451	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2452	<tr><td colspan="4" class="doc" id="templateArgumentCountIs0"><pre>Matches if the number of template arguments equals N.
				2453
				2454	Given
				2455	template<typename T> struct C {};
				2456	C<int> c;
				2457	classTemplateSpecializationDecl(templateArgumentCountIs(1))
				2458	matches C<int>.
				2459	</pre></td></tr>
				2460
				2461
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2462	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2463	<tr><td colspan="4" class="doc" id="statementCountIs0"><pre>Checks that a compound statement contains a specific number of
				2464	child statements.
				2465
				2466	Example: Given
				2467	{ for (;;) {} }
				2468	compoundStmt(statementCountIs(0)))
				2469	matches '{}'
				2470	but does not match the outer compound statement.
				2471	</pre></td></tr>
				2472
				2473
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2474	<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>
Etienne Bergeron	3588be7	2016-05-12 04:20:04 +0000	[diff] [blame]	2475	<tr><td colspan="4" class="doc" id="hasSize0"><pre>Matches nodes that have the specified size.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2476
				2477	Given
				2478	int a[42];
				2479	int b[2 * 21];
				2480	int c[41], d[43];
Etienne Bergeron	3588be7	2016-05-12 04:20:04 +0000	[diff] [blame]	2481	char *s = "abcd";
				2482	wchar_t *ws = L"abcd";
				2483	char *w = "a";
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2484	constantArrayType(hasSize(42))
				2485	matches "int a[42]" and "int b[2 * 21]"
Etienne Bergeron	3588be7	2016-05-12 04:20:04 +0000	[diff] [blame]	2486	stringLiteral(hasSize(4))
				2487	matches "abcd", L"abcd"
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2488	</pre></td></tr>
				2489
				2490
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2491	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2492	<tr><td colspan="4" class="doc" id="declCountIs0"><pre>Matches declaration statements that contain a specific number of
				2493	declarations.
				2494
				2495	Example: Given
				2496	int a, b;
				2497	int c;
				2498	int d = 2, e;
				2499	declCountIs(2)
				2500	matches 'int a, b;' and 'int d = 2, e;', but not 'int c;'.
				2501	</pre></td></tr>
				2502
				2503
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2504	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2505	<tr><td colspan="4" class="doc" id="equalsBoundNode1"><pre>Matches if a node equals a previously bound node.
				2506
				2507	Matches a node if it equals the node previously bound to ID.
				2508
				2509	Given
				2510	class X { int a; int b; };
				2511	cxxRecordDecl(
				2512	has(fieldDecl(hasName("a"), hasType(type().bind("t")))),
				2513	has(fieldDecl(hasName("b"), hasType(type(equalsBoundNode("t"))))))
				2514	matches the class X, as a and b have the same type.
				2515
				2516	Note that when multiple matches are involved via forEach* matchers,
				2517	equalsBoundNodes acts as a filter.
				2518	For example:
				2519	compoundStmt(
				2520	forEachDescendant(varDecl().bind("d")),
				2521	forEachDescendant(declRefExpr(to(decl(equalsBoundNode("d"))))))
				2522	will trigger a match for each combination of variable declaration
				2523	and reference to that variable declaration within a compound statement.
				2524	</pre></td></tr>
				2525
				2526
Samuel Benzaquen	a4076ea	2016-05-04 20:45:00 +0000	[diff] [blame]	2527	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>></td><td class="name" onclick="toggle('equalsNode0')"><a name="equalsNode0Anchor">equalsNode</a></td><td>const Decl* Other</td></tr>
				2528	<tr><td colspan="4" class="doc" id="equalsNode0"><pre>Matches if a node equals another node.
				2529
				2530	Decl has pointer identity in the AST.
				2531	</pre></td></tr>
				2532
				2533
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2534	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2535	<tr><td colspan="4" class="doc" id="hasAttr0"><pre>Matches declaration that has a given attribute.
				2536
				2537	Given
				2538	__attribute__((device)) void f() { ... }
				2539	decl(hasAttr(clang::attr::CUDADevice)) matches the function declaration of
				2540	f. If the matcher is use from clang-query, attr::Kind parameter should be
				2541	passed as a quoted string. e.g., hasAttr("attr::CUDADevice").
				2542	</pre></td></tr>
				2543
				2544
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2545	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2546	<tr><td colspan="4" class="doc" id="isExpansionInFileMatching0"><pre>Matches AST nodes that were expanded within files whose name is
				2547	partially matching a given regex.
				2548
				2549	Example matches Y but not X
				2550	(matcher = cxxRecordDecl(isExpansionInFileMatching("AST.*"))
				2551	#include "ASTMatcher.h"
				2552	class X {};
				2553	ASTMatcher.h:
				2554	class Y {};
				2555
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2556	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2557	</pre></td></tr>
				2558
				2559
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2560	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2561	<tr><td colspan="4" class="doc" id="isExpansionInMainFile0"><pre>Matches AST nodes that were expanded within the main-file.
				2562
				2563	Example matches X but not Y
				2564	(matcher = cxxRecordDecl(isExpansionInMainFile())
				2565	#include <Y.h>
				2566	class X {};
				2567	Y.h:
				2568	class Y {};
				2569
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2570	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2571	</pre></td></tr>
				2572
				2573
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2574	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2575	<tr><td colspan="4" class="doc" id="isExpansionInSystemHeader0"><pre>Matches AST nodes that were expanded within system-header-files.
				2576
				2577	Example matches Y but not X
				2578	(matcher = cxxRecordDecl(isExpansionInSystemHeader())
				2579	#include <SystemHeader.h>
				2580	class X {};
				2581	SystemHeader.h:
				2582	class Y {};
				2583
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2584	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2585	</pre></td></tr>
				2586
				2587
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2588	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2589	<tr><td colspan="4" class="doc" id="isImplicit0"><pre>Matches a declaration that has been implicitly added
				2590	by the compiler (eg. implicit defaultcopy constructors).
				2591	</pre></td></tr>
				2592
				2593
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2594	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2595	<tr><td colspan="4" class="doc" id="isPrivate0"><pre>Matches private C++ declarations.
				2596
				2597	Given
				2598	class C {
				2599	public: int a;
				2600	protected: int b;
				2601	private: int c;
				2602	};
				2603	fieldDecl(isPrivate())
Cong Liu	8a02efb	2016-06-24 09:38:03 +0000	[diff] [blame]	2604	matches 'int c;'
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2605	</pre></td></tr>
				2606
				2607
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2608	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2609	<tr><td colspan="4" class="doc" id="isProtected0"><pre>Matches protected C++ declarations.
				2610
				2611	Given
				2612	class C {
				2613	public: int a;
				2614	protected: int b;
				2615	private: int c;
				2616	};
				2617	fieldDecl(isProtected())
Cong Liu	8a02efb	2016-06-24 09:38:03 +0000	[diff] [blame]	2618	matches 'int b;'
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2619	</pre></td></tr>
				2620
				2621
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2622	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2623	<tr><td colspan="4" class="doc" id="isPublic0"><pre>Matches public C++ declarations.
				2624
				2625	Given
				2626	class C {
				2627	public: int a;
				2628	protected: int b;
				2629	private: int c;
				2630	};
				2631	fieldDecl(isPublic())
Cong Liu	8a02efb	2016-06-24 09:38:03 +0000	[diff] [blame]	2632	matches 'int a;'
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2633	</pre></td></tr>
				2634
				2635
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	2636	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DesignatedInitExpr.html">DesignatedInitExpr</a>></td><td class="name" onclick="toggle('designatorCountIs0')"><a name="designatorCountIs0Anchor">designatorCountIs</a></td><td>unsigned N</td></tr>
				2637	<tr><td colspan="4" class="doc" id="designatorCountIs0"><pre>Matches designated initializer expressions that contain
				2638	a specific number of designators.
				2639
				2640	Example: Given
				2641	point ptarray[10] = { [2].y = 1.0, [0].x = 1.0 };
				2642	point ptarray2[10] = { [2].y = 1.0, [2].x = 0.0, [0].x = 1.0 };
				2643	designatorCountIs(2)
				2644	matches '{ [2].y = 1.0, [0].x = 1.0 }',
				2645	but not '{ [2].y = 1.0, [2].x = 0.0, [0].x = 1.0 }'.
				2646	</pre></td></tr>
				2647
				2648
Haojian Wu	9c3be3a	2018-01-18 09:47:57 +0000	[diff] [blame]	2649	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1EnumDecl.html">EnumDecl</a>></td><td class="name" onclick="toggle('isScoped0')"><a name="isScoped0Anchor">isScoped</a></td><td></td></tr>
				2650	<tr><td colspan="4" class="doc" id="isScoped0"><pre>Matches C++11 scoped enum declaration.
				2651
				2652	Example matches Y (matcher = enumDecl(isScoped()))
				2653	enum X {};
				2654	enum class Y {};
				2655	</pre></td></tr>
				2656
				2657
Aaron Ballman	5c57434	2016-07-06 18:25:16 +0000	[diff] [blame]	2658	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FieldDecl.html">FieldDecl</a>></td><td class="name" onclick="toggle('hasBitWidth0')"><a name="hasBitWidth0Anchor">hasBitWidth</a></td><td>unsigned Width</td></tr>
Malcolm Parsons	81e48b2	2016-12-24 13:22:26 +0000	[diff] [blame]	2659	<tr><td colspan="4" class="doc" id="hasBitWidth0"><pre>Matches non-static data members that are bit-fields of the specified
				2660	bit width.
Aaron Ballman	5c57434	2016-07-06 18:25:16 +0000	[diff] [blame]	2661
				2662	Given
				2663	class C {
				2664	int a : 2;
				2665	int b : 4;
				2666	int c : 2;
				2667	};
Malcolm Parsons	81e48b2	2016-12-24 13:22:26 +0000	[diff] [blame]	2668	fieldDecl(hasBitWidth(2))
Aaron Ballman	5c57434	2016-07-06 18:25:16 +0000	[diff] [blame]	2669	matches 'int a;' and 'int c;' but not 'int b;'.
				2670	</pre></td></tr>
				2671
				2672
				2673	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FieldDecl.html">FieldDecl</a>></td><td class="name" onclick="toggle('isBitField0')"><a name="isBitField0Anchor">isBitField</a></td><td></td></tr>
				2674	<tr><td colspan="4" class="doc" id="isBitField0"><pre>Matches non-static data members that are bit-fields.
				2675
				2676	Given
				2677	class C {
				2678	int a : 2;
				2679	int b;
				2680	};
				2681	fieldDecl(isBitField())
				2682	matches 'int a;' but not 'int b;'.
				2683	</pre></td></tr>
				2684
				2685
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	2686	<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>const ValueT Value</td></tr>
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2687	<tr><td colspan="4" class="doc" id="equals1"><pre>Matches literals that are equal to the given value of type ValueT.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2688
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2689	Given
				2690	f('false, 3.14, 42);
				2691	characterLiteral(equals(0))
				2692	matches 'cxxBoolLiteral(equals(false)) and cxxBoolLiteral(equals(0))
				2693	match false
				2694	floatLiteral(equals(3.14)) and floatLiteral(equals(314e-2))
				2695	match 3.14
				2696	integerLiteral(equals(42))
				2697	matches 42
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2698
Clement Courbet	43bdba4	2017-07-11 15:45:22 +0000	[diff] [blame]	2699	Note that you cannot directly match a negative numeric literal because the
				2700	minus sign is not part of the literal: It is a unary operator whose operand
				2701	is the positive numeric literal. Instead, you must use a unaryOperator()
				2702	matcher to match the minus sign:
				2703
				2704	unaryOperator(hasOperatorName("-"),
				2705	hasUnaryOperand(integerLiteral(equals(13))))
				2706
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2707	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CharacterLiteral.html">CharacterLiteral</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXBoolLiteralExpr.html">CXXBoolLiteralExpr</a>>,
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2708	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2709	</pre></td></tr>
				2710
				2711
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2712	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FloatingLiteral.html">FloatingLiteral</a>></td><td class="name" onclick="toggle('equals12')"><a name="equals12Anchor">equals</a></td><td>double Value</td></tr>
				2713	<tr><td colspan="4" class="doc" id="equals12"><pre></pre></td></tr>
				2714
				2715
Aaron Ballman	abdbbbc	2016-05-16 16:49:01 +0000	[diff] [blame]	2716	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('hasDynamicExceptionSpec0')"><a name="hasDynamicExceptionSpec0Anchor">hasDynamicExceptionSpec</a></td><td></td></tr>
				2717	<tr><td colspan="4" class="doc" id="hasDynamicExceptionSpec0"><pre>Matches functions that have a dynamic exception specification.
				2718
				2719	Given:
				2720	void f();
				2721	void g() noexcept;
				2722	void h() noexcept(true);
				2723	void i() noexcept(false);
				2724	void j() throw();
				2725	void k() throw(int);
				2726	void l() throw(...);
Aaron Ballman	230ad97	2016-06-07 17:34:45 +0000	[diff] [blame]	2727	functionDecl(hasDynamicExceptionSpec()) and
				2728	functionProtoType(hasDynamicExceptionSpec())
				2729	match the declarations of j, k, and l, but not f, g, h, or i.
Aaron Ballman	abdbbbc	2016-05-16 16:49:01 +0000	[diff] [blame]	2730	</pre></td></tr>
				2731
				2732
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2733	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2734	<tr><td colspan="4" class="doc" id="hasOverloadedOperatorName0"><pre>Matches overloaded operator names.
				2735
				2736	Matches overloaded operator names specified in strings without the
				2737	"operator" prefix: e.g. "<<".
				2738
				2739	Given:
				2740	class A { int operator*(); };
				2741	const A &operator<<(const A &a, const A &b);
				2742	A a;
				2743	a << a; <-- This matches
				2744
				2745	cxxOperatorCallExpr(hasOverloadedOperatorName("<<"))) matches the
				2746	specified line and
				2747	cxxRecordDecl(hasMethod(hasOverloadedOperatorName("*")))
				2748	matches the declaration of A.
				2749
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2750	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2751	</pre></td></tr>
				2752
				2753
Julie Hockett	239d25a	2018-01-22 22:45:23 +0000	[diff] [blame]	2754	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('hasTrailingReturn0')"><a name="hasTrailingReturn0Anchor">hasTrailingReturn</a></td><td></td></tr>
				2755	<tr><td colspan="4" class="doc" id="hasTrailingReturn0"><pre>Matches a function declared with a trailing return type.
				2756
				2757	Example matches Y (matcher = functionDecl(hasTrailingReturn()))
				2758	int X() {}
				2759	auto Y() -> int {}
				2760	</pre></td></tr>
				2761
				2762
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2763	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2764	<tr><td colspan="4" class="doc" id="isConstexpr1"><pre>Matches constexpr variable and function declarations.
				2765
				2766	Given:
				2767	constexpr int foo = 42;
				2768	constexpr int bar();
				2769	varDecl(isConstexpr())
				2770	matches the declaration of foo.
				2771	functionDecl(isConstexpr())
				2772	matches the declaration of bar.
				2773	</pre></td></tr>
				2774
				2775
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2776	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('isDefaulted0')"><a name="isDefaulted0Anchor">isDefaulted</a></td><td></td></tr>
Aaron Ballman	c35724c	2016-01-21 15:18:25 +0000	[diff] [blame]	2777	<tr><td colspan="4" class="doc" id="isDefaulted0"><pre>Matches defaulted function declarations.
				2778
				2779	Given:
				2780	class A { ~A(); };
				2781	class B { ~B() = default; };
				2782	functionDecl(isDefaulted())
				2783	matches the declaration of ~B, but not ~A.
				2784	</pre></td></tr>
				2785
				2786
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	2787	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('isDefinition3')"><a name="isDefinition3Anchor">isDefinition</a></td><td></td></tr>
				2788	<tr><td colspan="4" class="doc" id="isDefinition3"><pre>Matches if a declaration has a body attached.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2789
				2790	Example matches A, va, fa
				2791	class A {};
				2792	class B; Doesn't match, as it has no body.
				2793	int va;
				2794	extern int vb; Doesn't match, as it doesn't define the variable.
				2795	void fa() {}
				2796	void fb(); Doesn't match, as it has no body.
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	2797	@interface X
				2798	- (void)ma; Doesn't match, interface is declaration.
				2799	@end
				2800	@implementation X
				2801	- (void)ma {}
				2802	@end
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2803
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	2804	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>>,
				2805	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMethodDecl.html">ObjCMethodDecl</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2806	</pre></td></tr>
				2807
				2808
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2809	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2810	<tr><td colspan="4" class="doc" id="isDeleted0"><pre>Matches deleted function declarations.
				2811
				2812	Given:
				2813	void Func();
				2814	void DeletedFunc() = delete;
				2815	functionDecl(isDeleted())
				2816	matches the declaration of DeletedFunc, but not Func.
				2817	</pre></td></tr>
				2818
				2819
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2820	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2821	<tr><td colspan="4" class="doc" id="isExplicitTemplateSpecialization0"><pre>Matches explicit template specializations of function, class, or
				2822	static member variable template instantiations.
				2823
				2824	Given
				2825	template<typename T> void A(T t) { }
				2826	template<> void A(int N) { }
				2827	functionDecl(isExplicitTemplateSpecialization())
				2828	matches the specialization A<int>().
				2829
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2830	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2831	</pre></td></tr>
				2832
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	2833
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2834	<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>
Alexander Shaposhnikov	f681c4e	2017-09-22 19:29:38 +0000	[diff] [blame]	2835	<tr><td colspan="4" class="doc" id="isExternC0"><pre>Matches extern "C" function or variable declarations.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2836
				2837	Given:
				2838	extern "C" void f() {}
				2839	extern "C" { void g() {} }
				2840	void h() {}
Alexander Shaposhnikov	f681c4e	2017-09-22 19:29:38 +0000	[diff] [blame]	2841	extern "C" int x = 1;
				2842	extern "C" int y = 2;
				2843	int z = 3;
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2844	functionDecl(isExternC())
Alexander Shaposhnikov	f681c4e	2017-09-22 19:29:38 +0000	[diff] [blame]	2845	matches the declaration of f and g, but not the declaration of h.
				2846	varDecl(isExternC())
				2847	matches the declaration of x and y, but not the declaration of z.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2848	</pre></td></tr>
				2849
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	2850
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2851	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2852	<tr><td colspan="4" class="doc" id="isInline1"><pre>Matches function and namespace declarations that are marked with
				2853	the inline keyword.
				2854
				2855	Given
				2856	inline void f();
				2857	void g();
				2858	namespace n {
				2859	inline namespace m {}
				2860	}
				2861	functionDecl(isInline()) will match ::f().
				2862	namespaceDecl(isInline()) will match n::m.
				2863	</pre></td></tr>
				2864
				2865
Roman Lebedev	6c3871b	2018-01-17 19:40:55 +0000	[diff] [blame]	2866	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('isNoReturn0')"><a name="isNoReturn0Anchor">isNoReturn</a></td><td></td></tr>
				2867	<tr><td colspan="4" class="doc" id="isNoReturn0"><pre>Matches FunctionDecls that have a noreturn attribute.
				2868
				2869	Given
				2870	void nope();
				2871	[[noreturn]] void a();
				2872	__attribute__((noreturn)) void b();
				2873	struct c { [[noreturn]] c(); };
				2874	functionDecl(isNoReturn())
				2875	matches all of those except
				2876	void nope();
				2877	</pre></td></tr>
				2878
				2879
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2880	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('isNoThrow0')"><a name="isNoThrow0Anchor">isNoThrow</a></td><td></td></tr>
Aaron Ballman	a60bcda	2015-12-02 15:23:59 +0000	[diff] [blame]	2881	<tr><td colspan="4" class="doc" id="isNoThrow0"><pre>Matches functions that have a non-throwing exception specification.
				2882
				2883	Given:
				2884	void f();
				2885	void g() noexcept;
				2886	void h() throw();
				2887	void i() throw(int);
				2888	void j() noexcept(false);
Aaron Ballman	230ad97	2016-06-07 17:34:45 +0000	[diff] [blame]	2889	functionDecl(isNoThrow()) and functionProtoType(isNoThrow())
				2890	match the declarations of g, and h, but not f, i or j.
Aaron Ballman	a60bcda	2015-12-02 15:23:59 +0000	[diff] [blame]	2891	</pre></td></tr>
				2892
				2893
Haojian Wu	b3d2546	2016-09-26 16:01:52 +0000	[diff] [blame]	2894	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('isStaticStorageClass0')"><a name="isStaticStorageClass0Anchor">isStaticStorageClass</a></td><td></td></tr>
Haojian Wu	398a8ea	2016-09-27 07:53:20 +0000	[diff] [blame]	2895	<tr><td colspan="4" class="doc" id="isStaticStorageClass0"><pre>Matches variablefunction declarations that have "static" storage
				2896	class specifier ("static" keyword) written in the source.
Haojian Wu	b3d2546	2016-09-26 16:01:52 +0000	[diff] [blame]	2897
				2898	Given:
				2899	static void f() {}
				2900	static int i = 0;
Haojian Wu	398a8ea	2016-09-27 07:53:20 +0000	[diff] [blame]	2901	extern int j;
				2902	int k;
Haojian Wu	b3d2546	2016-09-26 16:01:52 +0000	[diff] [blame]	2903	functionDecl(isStaticStorageClass())
				2904	matches the function declaration f.
				2905	varDecl(isStaticStorageClass())
				2906	matches the variable declaration i.
				2907	</pre></td></tr>
				2908
				2909
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2910	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2911	<tr><td colspan="4" class="doc" id="isTemplateInstantiation0"><pre>Matches template instantiations of function, class, or static
				2912	member variable template instantiations.
				2913
				2914	Given
				2915	template <typename T> class X {}; class A {}; X<A> x;
				2916	or
				2917	template <typename T> class X {}; class A {}; template class X<A>;
Eric Liu	09ee48e	2018-02-21 14:22:42 +0000	[diff] [blame]	2918	or
				2919	template <typename T> class X {}; class A {}; extern template class X<A>;
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2920	cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
				2921	matches the template instantiation of X<A>.
				2922
				2923	But given
				2924	template <typename T> class X {}; class A {};
				2925	template <> class X<A> {}; X<A> x;
				2926	cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
				2927	does not match, as X<A> is an explicit template specialization.
				2928
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2929	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2930	</pre></td></tr>
				2931
				2932
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2933	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2934	<tr><td colspan="4" class="doc" id="isVariadic0"><pre>Matches if a function declaration is variadic.
				2935
				2936	Example matches f, but not g or h. The function i will not match, even when
				2937	compiled in C mode.
				2938	void f(...);
				2939	void g(int);
				2940	template <typename... Ts> void h(Ts...);
				2941	void i();
				2942	</pre></td></tr>
				2943
				2944
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2945	<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>
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	2946	<tr><td colspan="4" class="doc" id="parameterCountIs0"><pre>Matches FunctionDecls and FunctionProtoTypes that have a
				2947	specific parameter count.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2948
				2949	Given
				2950	void f(int i) {}
				2951	void g(int i, int j) {}
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	2952	void h(int i, int j);
				2953	void j(int i);
				2954	void k(int x, int y, int z, ...);
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2955	functionDecl(parameterCountIs(2))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	2956	matches g and h
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	2957	functionProtoType(parameterCountIs(2))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	2958	matches g and h
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	2959	functionProtoType(parameterCountIs(3))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	2960	matches k
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	2961	</pre></td></tr>
				2962
				2963
Aaron Ballman	230ad97	2016-06-07 17:34:45 +0000	[diff] [blame]	2964	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionProtoType.html">FunctionProtoType</a>></td><td class="name" onclick="toggle('hasDynamicExceptionSpec1')"><a name="hasDynamicExceptionSpec1Anchor">hasDynamicExceptionSpec</a></td><td></td></tr>
				2965	<tr><td colspan="4" class="doc" id="hasDynamicExceptionSpec1"><pre>Matches functions that have a dynamic exception specification.
				2966
				2967	Given:
				2968	void f();
				2969	void g() noexcept;
				2970	void h() noexcept(true);
				2971	void i() noexcept(false);
				2972	void j() throw();
				2973	void k() throw(int);
				2974	void l() throw(...);
				2975	functionDecl(hasDynamicExceptionSpec()) and
				2976	functionProtoType(hasDynamicExceptionSpec())
				2977	match the declarations of j, k, and l, but not f, g, h, or i.
				2978	</pre></td></tr>
				2979
				2980
				2981	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionProtoType.html">FunctionProtoType</a>></td><td class="name" onclick="toggle('isNoThrow1')"><a name="isNoThrow1Anchor">isNoThrow</a></td><td></td></tr>
				2982	<tr><td colspan="4" class="doc" id="isNoThrow1"><pre>Matches functions that have a non-throwing exception specification.
				2983
				2984	Given:
				2985	void f();
				2986	void g() noexcept;
				2987	void h() throw();
				2988	void i() throw(int);
				2989	void j() noexcept(false);
				2990	functionDecl(isNoThrow()) and functionProtoType(isNoThrow())
				2991	match the declarations of g, and h, but not f, i or j.
				2992	</pre></td></tr>
				2993
				2994
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	2995	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionProtoType.html">FunctionProtoType</a>></td><td class="name" onclick="toggle('parameterCountIs1')"><a name="parameterCountIs1Anchor">parameterCountIs</a></td><td>unsigned N</td></tr>
				2996	<tr><td colspan="4" class="doc" id="parameterCountIs1"><pre>Matches FunctionDecls and FunctionProtoTypes that have a
				2997	specific parameter count.
				2998
				2999	Given
				3000	void f(int i) {}
				3001	void g(int i, int j) {}
				3002	void h(int i, int j);
				3003	void j(int i);
				3004	void k(int x, int y, int z, ...);
				3005	functionDecl(parameterCountIs(2))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3006	matches g and h
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	3007	functionProtoType(parameterCountIs(2))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3008	matches g and h
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	3009	functionProtoType(parameterCountIs(3))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3010	matches k
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3011	</pre></td></tr>
				3012
				3013
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	3014	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IntegerLiteral.html">IntegerLiteral</a>></td><td class="name" onclick="toggle('equals6')"><a name="equals6Anchor">equals</a></td><td>bool Value</td></tr>
				3015	<tr><td colspan="4" class="doc" id="equals6"><pre></pre></td></tr>
				3016
				3017
				3018	<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>const ValueT Value</td></tr>
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	3019	<tr><td colspan="4" class="doc" id="equals0"><pre>Matches literals that are equal to the given value of type ValueT.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3020
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	3021	Given
				3022	f('false, 3.14, 42);
				3023	characterLiteral(equals(0))
				3024	matches 'cxxBoolLiteral(equals(false)) and cxxBoolLiteral(equals(0))
				3025	match false
				3026	floatLiteral(equals(3.14)) and floatLiteral(equals(314e-2))
				3027	match 3.14
				3028	integerLiteral(equals(42))
				3029	matches 42
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3030
Clement Courbet	43bdba4	2017-07-11 15:45:22 +0000	[diff] [blame]	3031	Note that you cannot directly match a negative numeric literal because the
				3032	minus sign is not part of the literal: It is a unary operator whose operand
				3033	is the positive numeric literal. Instead, you must use a unaryOperator()
				3034	matcher to match the minus sign:
				3035
				3036	unaryOperator(hasOperatorName("-"),
				3037	hasUnaryOperand(integerLiteral(equals(13))))
				3038
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	3039	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CharacterLiteral.html">CharacterLiteral</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXBoolLiteralExpr.html">CXXBoolLiteralExpr</a>>,
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3040	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3041	</pre></td></tr>
				3042
				3043
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	3044	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IntegerLiteral.html">IntegerLiteral</a>></td><td class="name" onclick="toggle('equals13')"><a name="equals13Anchor">equals</a></td><td>double Value</td></tr>
				3045	<tr><td colspan="4" class="doc" id="equals13"><pre></pre></td></tr>
				3046
				3047
				3048	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IntegerLiteral.html">IntegerLiteral</a>></td><td class="name" onclick="toggle('equals9')"><a name="equals9Anchor">equals</a></td><td>unsigned Value</td></tr>
				3049	<tr><td colspan="4" class="doc" id="equals9"><pre></pre></td></tr>
				3050
				3051
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3052	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3053	<tr><td colspan="4" class="doc" id="isArrow0"><pre>Matches member expressions that are called with '->' as opposed
				3054	to '.'.
				3055
				3056	Member calls on the implicit this pointer match as called with '->'.
				3057
				3058	Given
				3059	class Y {
				3060	void x() { this->x(); x(); Y y; y.x(); a; this->b; Y::b; }
				3061	int a;
				3062	static int b;
				3063	};
				3064	memberExpr(isArrow())
				3065	matches this->x, x, y.x, a, this->b
				3066	</pre></td></tr>
				3067
				3068
Aaron Ballman	a086b9f	2016-08-17 13:10:42 +0000	[diff] [blame]	3069	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamedDecl.html">NamedDecl</a>></td><td class="name" onclick="toggle('hasExternalFormalLinkage0')"><a name="hasExternalFormalLinkage0Anchor">hasExternalFormalLinkage</a></td><td></td></tr>
				3070	<tr><td colspan="4" class="doc" id="hasExternalFormalLinkage0"><pre>Matches a declaration that has external formal linkage.
				3071
				3072	Example matches only z (matcher = varDecl(hasExternalFormalLinkage()))
				3073	void f() {
				3074	int x;
				3075	static int y;
				3076	}
				3077	int z;
				3078
				3079	Example matches f() because it has external formal linkage despite being
				3080	unique to the translation unit as though it has internal likage
				3081	(matcher = functionDecl(hasExternalFormalLinkage()))
				3082
				3083	namespace {
				3084	void f() {}
				3085	}
				3086	</pre></td></tr>
				3087
				3088
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	3089	<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>const std::string Name</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3090	<tr><td colspan="4" class="doc" id="hasName0"><pre>Matches NamedDecl nodes that have the specified name.
				3091
				3092	Supports specifying enclosing namespaces or classes by prefixing the name
				3093	with '<enclosing>::'.
				3094	Does not match typedefs of an underlying type with the given name.
				3095
				3096	Example matches X (Name == "X")
				3097	class X;
				3098
				3099	Example matches X (Name is one of "::a::b::X", "a::b::X", "b::X", "X")
				3100	namespace a { namespace b { class X; } }
				3101	</pre></td></tr>
				3102
				3103
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3104	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3105	<tr><td colspan="4" class="doc" id="matchesName0"><pre>Matches NamedDecl nodes whose fully qualified names contain
				3106	a substring matched by the given RegExp.
				3107
				3108	Supports specifying enclosing namespaces or classes by
				3109	prefixing the name with '<enclosing>::'. Does not match typedefs
				3110	of an underlying type with the given name.
				3111
				3112	Example matches X (regexp == "::X")
				3113	class X;
				3114
				3115	Example matches X (regexp is one of "::X", "^foo::.*X", among others)
				3116	namespace foo { namespace bar { class X; } }
				3117	</pre></td></tr>
				3118
				3119
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3120	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3121	<tr><td colspan="4" class="doc" id="isAnonymous0"><pre>Matches anonymous namespace declarations.
				3122
				3123	Given
				3124	namespace n {
				3125	namespace {} #1
				3126	}
				3127	namespaceDecl(isAnonymous()) will match #1 but not ::n.
				3128	</pre></td></tr>
				3129
				3130
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3131	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3132	<tr><td colspan="4" class="doc" id="isInline0"><pre>Matches function and namespace declarations that are marked with
				3133	the inline keyword.
				3134
				3135	Given
				3136	inline void f();
				3137	void g();
				3138	namespace n {
				3139	inline namespace m {}
				3140	}
				3141	functionDecl(isInline()) will match ::f().
				3142	namespaceDecl(isInline()) will match n::m.
				3143	</pre></td></tr>
				3144
				3145
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3146	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3147	<tr><td colspan="4" class="doc" id="argumentCountIs2"><pre>Checks that a call expression or a constructor call expression has
				3148	a specific number of arguments (including absent default arguments).
				3149
				3150	Example matches f(0, 0) (matcher = callExpr(argumentCountIs(2)))
				3151	void f(int x, int y);
				3152	f(0, 0);
				3153	</pre></td></tr>
				3154
				3155
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3156	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3157	<tr><td colspan="4" class="doc" id="hasKeywordSelector0"><pre>Matches when the selector is a keyword selector
				3158
				3159	objCMessageExpr(hasKeywordSelector()) matches the generated setFrame
				3160	message expression in
				3161
				3162	UIWebView *webView = ...;
				3163	CGRect bodyFrame = webView.frame;
				3164	bodyFrame.size.height = self.bodyContentHeight;
				3165	webView.frame = bodyFrame;
				3166	^---- matches here
				3167	</pre></td></tr>
				3168
				3169
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3170	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3171	<tr><td colspan="4" class="doc" id="hasNullSelector0"><pre>Matches when the selector is the empty selector
				3172
				3173	Matches only when the selector of the objCMessageExpr is NULL. This may
				3174	represent an error condition in the tree!
				3175	</pre></td></tr>
				3176
				3177
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3178	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3179	<tr><td colspan="4" class="doc" id="hasSelector0"><pre>Matches when BaseName == Selector.getAsString()
				3180
				3181	matcher = objCMessageExpr(hasSelector("loadHTMLString:baseURL:"));
				3182	matches the outer message expr in the code below, but NOT the message
				3183	invocation for self.bodyView.
				3184	[self.bodyView loadHTMLString:html baseURL:NULL];
				3185	</pre></td></tr>
				3186
				3187
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3188	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3189	<tr><td colspan="4" class="doc" id="hasUnarySelector0"><pre>Matches when the selector is a Unary Selector
				3190
				3191	matcher = objCMessageExpr(matchesSelector(hasUnarySelector());
				3192	matches self.bodyView in the code below, but NOT the outer message
				3193	invocation of "loadHTMLString:baseURL:".
				3194	[self.bodyView loadHTMLString:html baseURL:NULL];
				3195	</pre></td></tr>
				3196
				3197
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3198	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3199	<tr><td colspan="4" class="doc" id="matchesSelector0"><pre>Matches ObjC selectors whose name contains
				3200	a substring matched by the given RegExp.
				3201	matcher = objCMessageExpr(matchesSelector("loadHTMLStringmatches the outer message expr in the code below, but NOT the message
				3202	invocation for self.bodyView.
				3203	[self.bodyView loadHTMLString:html baseURL:NULL];
				3204	</pre></td></tr>
				3205
				3206
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3207	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3208	<tr><td colspan="4" class="doc" id="numSelectorArgs0"><pre>Matches when the selector has the specified number of arguments
				3209
				3210	matcher = objCMessageExpr(numSelectorArgs(0));
				3211	matches self.bodyView in the code below
				3212
				3213	matcher = objCMessageExpr(numSelectorArgs(2));
				3214	matches the invocation of "loadHTMLString:baseURL:" but not that
				3215	of self.bodyView
				3216	[self.bodyView loadHTMLString:html baseURL:NULL];
				3217	</pre></td></tr>
				3218
				3219
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	3220	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMethodDecl.html">ObjCMethodDecl</a>></td><td class="name" onclick="toggle('isDefinition2')"><a name="isDefinition2Anchor">isDefinition</a></td><td></td></tr>
				3221	<tr><td colspan="4" class="doc" id="isDefinition2"><pre>Matches if a declaration has a body attached.
				3222
				3223	Example matches A, va, fa
				3224	class A {};
				3225	class B; Doesn't match, as it has no body.
				3226	int va;
				3227	extern int vb; Doesn't match, as it doesn't define the variable.
				3228	void fa() {}
				3229	void fb(); Doesn't match, as it has no body.
				3230	@interface X
				3231	- (void)ma; Doesn't match, interface is declaration.
				3232	@end
				3233	@implementation X
				3234	- (void)ma {}
				3235	@end
				3236
				3237	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>>,
				3238	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMethodDecl.html">ObjCMethodDecl</a>>
				3239	</pre></td></tr>
				3240
				3241
Aaron Ballman	5f8980a	2017-11-21 19:22:34 +0000	[diff] [blame]	3242	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParmVarDecl.html">ParmVarDecl</a>></td><td class="name" onclick="toggle('hasDefaultArgument0')"><a name="hasDefaultArgument0Anchor">hasDefaultArgument</a></td><td></td></tr>
				3243	<tr><td colspan="4" class="doc" id="hasDefaultArgument0"><pre>Matches a declaration that has default arguments.
				3244
				3245	Example matches y (matcher = parmVarDecl(hasDefaultArgument()))
				3246	void x(int val) {}
				3247	void y(int val = 0) {}
				3248	</pre></td></tr>
				3249
				3250
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3251	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3252	<tr><td colspan="4" class="doc" id="asString0"><pre>Matches if the matched type is represented by the given string.
				3253
				3254	Given
				3255	class Y { public: void x(); };
				3256	void z() { Y* y; y->x(); }
				3257	cxxMemberCallExpr(on(hasType(asString("class Y *"))))
				3258	matches y->x()
				3259	</pre></td></tr>
				3260
				3261
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3262	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3263	<tr><td colspan="4" class="doc" id="equalsBoundNode3"><pre>Matches if a node equals a previously bound node.
				3264
				3265	Matches a node if it equals the node previously bound to ID.
				3266
				3267	Given
				3268	class X { int a; int b; };
				3269	cxxRecordDecl(
				3270	has(fieldDecl(hasName("a"), hasType(type().bind("t")))),
				3271	has(fieldDecl(hasName("b"), hasType(type(equalsBoundNode("t"))))))
				3272	matches the class X, as a and b have the same type.
				3273
				3274	Note that when multiple matches are involved via forEach* matchers,
				3275	equalsBoundNodes acts as a filter.
				3276	For example:
				3277	compoundStmt(
				3278	forEachDescendant(varDecl().bind("d")),
				3279	forEachDescendant(declRefExpr(to(decl(equalsBoundNode("d"))))))
				3280	will trigger a match for each combination of variable declaration
				3281	and reference to that variable declaration within a compound statement.
				3282	</pre></td></tr>
				3283
				3284
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3285	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3286	<tr><td colspan="4" class="doc" id="hasLocalQualifiers0"><pre>Matches QualType nodes that have local CV-qualifiers attached to
				3287	the node, not hidden within a typedef.
				3288
				3289	Given
				3290	typedef const int const_int;
				3291	const_int i;
				3292	int *const j;
				3293	int *volatile k;
				3294	int m;
				3295	varDecl(hasType(hasLocalQualifiers())) matches only j and k.
				3296	i is const-qualified but the qualifier is not local.
				3297	</pre></td></tr>
				3298
				3299
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3300	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('isAnyCharacter0')"><a name="isAnyCharacter0Anchor">isAnyCharacter</a></td><td></td></tr>
Samuel Benzaquen	30747f7	2015-12-22 21:06:36 +0000	[diff] [blame]	3301	<tr><td colspan="4" class="doc" id="isAnyCharacter0"><pre>Matches QualType nodes that are of character type.
				3302
				3303	Given
				3304	void a(char);
				3305	void b(wchar_t);
				3306	void c(double);
				3307	functionDecl(hasAnyParameter(hasType(isAnyCharacter())))
				3308	matches "a(char)", "b(wchar_t)", but not "c(double)".
				3309	</pre></td></tr>
				3310
				3311
Aaron Ballman	eb7e5d9	2016-02-18 16:36:01 +0000	[diff] [blame]	3312	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('isAnyPointer0')"><a name="isAnyPointer0Anchor">isAnyPointer</a></td><td></td></tr>
Alexander Kornienko	7d20a5a	2016-04-13 11:13:08 +0000	[diff] [blame]	3313	<tr><td colspan="4" class="doc" id="isAnyPointer0"><pre>Matches QualType nodes that are of any pointer type; this includes
				3314	the Objective-C object pointer type, which is different despite being
				3315	syntactically similar.
Aaron Ballman	eb7e5d9	2016-02-18 16:36:01 +0000	[diff] [blame]	3316
				3317	Given
				3318	int *i = nullptr;
Alexander Kornienko	7d20a5a	2016-04-13 11:13:08 +0000	[diff] [blame]	3319
				3320	@interface Foo
				3321	@end
				3322	Foo *f;
				3323
Aaron Ballman	eb7e5d9	2016-02-18 16:36:01 +0000	[diff] [blame]	3324	int j;
				3325	varDecl(hasType(isAnyPointer()))
Alexander Kornienko	7d20a5a	2016-04-13 11:13:08 +0000	[diff] [blame]	3326	matches "int i" and "Foo f", but not "int j".
Aaron Ballman	eb7e5d9	2016-02-18 16:36:01 +0000	[diff] [blame]	3327	</pre></td></tr>
				3328
				3329
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3330	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3331	<tr><td colspan="4" class="doc" id="isConstQualified0"><pre>Matches QualType nodes that are const-qualified, i.e., that
				3332	include "top-level" const.
				3333
				3334	Given
				3335	void a(int);
				3336	void b(int const);
				3337	void c(const int);
				3338	void d(const int*);
				3339	void e(int const) {};
				3340	functionDecl(hasAnyParameter(hasType(isConstQualified())))
				3341	matches "void b(int const)", "void c(const int)" and
				3342	"void e(int const) {}". It does not match d as there
				3343	is no top-level const on the parameter type "const int *".
				3344	</pre></td></tr>
				3345
				3346
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3347	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3348	<tr><td colspan="4" class="doc" id="isInteger0"><pre>Matches QualType nodes that are of integer type.
				3349
				3350	Given
				3351	void a(int);
				3352	void b(long);
				3353	void c(double);
				3354	functionDecl(hasAnyParameter(hasType(isInteger())))
				3355	matches "a(int)", "b(long)", but not "c(double)".
				3356	</pre></td></tr>
				3357
				3358
Clement Courbet	4251759	2016-07-12 06:36:00 +0000	[diff] [blame]	3359	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('isSignedInteger0')"><a name="isSignedInteger0Anchor">isSignedInteger</a></td><td></td></tr>
				3360	<tr><td colspan="4" class="doc" id="isSignedInteger0"><pre>Matches QualType nodes that are of signed integer type.
				3361
				3362	Given
				3363	void a(int);
				3364	void b(unsigned long);
				3365	void c(double);
Aaron Ballman	75de707	2016-08-18 12:26:17 +0000	[diff] [blame]	3366	functionDecl(hasAnyParameter(hasType(isSignedInteger())))
Clement Courbet	4251759	2016-07-12 06:36:00 +0000	[diff] [blame]	3367	matches "a(int)", but not "b(unsigned long)" and "c(double)".
				3368	</pre></td></tr>
				3369
				3370
				3371	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('isUnsignedInteger0')"><a name="isUnsignedInteger0Anchor">isUnsignedInteger</a></td><td></td></tr>
				3372	<tr><td colspan="4" class="doc" id="isUnsignedInteger0"><pre>Matches QualType nodes that are of unsigned integer type.
				3373
				3374	Given
				3375	void a(int);
				3376	void b(unsigned long);
				3377	void c(double);
Aaron Ballman	75de707	2016-08-18 12:26:17 +0000	[diff] [blame]	3378	functionDecl(hasAnyParameter(hasType(isUnsignedInteger())))
Clement Courbet	4251759	2016-07-12 06:36:00 +0000	[diff] [blame]	3379	matches "b(unsigned long)", but not "a(int)" and "c(double)".
				3380	</pre></td></tr>
				3381
				3382
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3383	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('isVolatileQualified0')"><a name="isVolatileQualified0Anchor">isVolatileQualified</a></td><td></td></tr>
Aaron Ballman	6290fc9	2015-11-23 17:09:24 +0000	[diff] [blame]	3384	<tr><td colspan="4" class="doc" id="isVolatileQualified0"><pre>Matches QualType nodes that are volatile-qualified, i.e., that
				3385	include "top-level" volatile.
				3386
				3387	Given
				3388	void a(int);
				3389	void b(int volatile);
				3390	void c(volatile int);
				3391	void d(volatile int*);
				3392	void e(int volatile) {};
				3393	functionDecl(hasAnyParameter(hasType(isVolatileQualified())))
				3394	matches "void b(int volatile)", "void c(volatile int)" and
				3395	"void e(int volatile) {}". It does not match d as there
				3396	is no top-level volatile on the parameter type "volatile int *".
				3397	</pre></td></tr>
				3398
				3399
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3400	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3401	<tr><td colspan="4" class="doc" id="isClass0"><pre>Matches RecordDecl object that are spelled with "class."
				3402
				3403	Example matches C, but not S or U.
				3404	struct S {};
				3405	class C {};
				3406	union U {};
				3407	</pre></td></tr>
				3408
				3409
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3410	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3411	<tr><td colspan="4" class="doc" id="isStruct0"><pre>Matches RecordDecl object that are spelled with "struct."
				3412
				3413	Example matches S, but not C or U.
				3414	struct S {};
				3415	class C {};
				3416	union U {};
				3417	</pre></td></tr>
				3418
				3419
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3420	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3421	<tr><td colspan="4" class="doc" id="isUnion0"><pre>Matches RecordDecl object that are spelled with "union."
				3422
				3423	Example matches U, but not C or S.
				3424	struct S {};
				3425	class C {};
				3426	union U {};
				3427	</pre></td></tr>
				3428
				3429
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3430	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3431	<tr><td colspan="4" class="doc" id="equalsBoundNode0"><pre>Matches if a node equals a previously bound node.
				3432
				3433	Matches a node if it equals the node previously bound to ID.
				3434
				3435	Given
				3436	class X { int a; int b; };
				3437	cxxRecordDecl(
				3438	has(fieldDecl(hasName("a"), hasType(type().bind("t")))),
				3439	has(fieldDecl(hasName("b"), hasType(type(equalsBoundNode("t"))))))
				3440	matches the class X, as a and b have the same type.
				3441
				3442	Note that when multiple matches are involved via forEach* matchers,
				3443	equalsBoundNodes acts as a filter.
				3444	For example:
				3445	compoundStmt(
				3446	forEachDescendant(varDecl().bind("d")),
				3447	forEachDescendant(declRefExpr(to(decl(equalsBoundNode("d"))))))
				3448	will trigger a match for each combination of variable declaration
				3449	and reference to that variable declaration within a compound statement.
				3450	</pre></td></tr>
				3451
				3452
Samuel Benzaquen	a4076ea	2016-05-04 20:45:00 +0000	[diff] [blame]	3453	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('equalsNode1')"><a name="equalsNode1Anchor">equalsNode</a></td><td>const Stmt* Other</td></tr>
				3454	<tr><td colspan="4" class="doc" id="equalsNode1"><pre>Matches if a node equals another node.
				3455
				3456	Stmt has pointer identity in the AST.
				3457	</pre></td></tr>
				3458
				3459
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3460	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3461	<tr><td colspan="4" class="doc" id="isExpansionInFileMatching1"><pre>Matches AST nodes that were expanded within files whose name is
				3462	partially matching a given regex.
				3463
				3464	Example matches Y but not X
				3465	(matcher = cxxRecordDecl(isExpansionInFileMatching("AST.*"))
				3466	#include "ASTMatcher.h"
				3467	class X {};
				3468	ASTMatcher.h:
				3469	class Y {};
				3470
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3471	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3472	</pre></td></tr>
				3473
				3474
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3475	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3476	<tr><td colspan="4" class="doc" id="isExpansionInMainFile1"><pre>Matches AST nodes that were expanded within the main-file.
				3477
				3478	Example matches X but not Y
				3479	(matcher = cxxRecordDecl(isExpansionInMainFile())
				3480	#include <Y.h>
				3481	class X {};
				3482	Y.h:
				3483	class Y {};
				3484
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3485	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3486	</pre></td></tr>
				3487
				3488
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3489	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3490	<tr><td colspan="4" class="doc" id="isExpansionInSystemHeader1"><pre>Matches AST nodes that were expanded within system-header-files.
				3491
				3492	Example matches Y but not X
				3493	(matcher = cxxRecordDecl(isExpansionInSystemHeader())
				3494	#include <SystemHeader.h>
				3495	class X {};
				3496	SystemHeader.h:
				3497	class Y {};
				3498
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3499	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3500	</pre></td></tr>
				3501
				3502
Etienne Bergeron	3588be7	2016-05-12 04:20:04 +0000	[diff] [blame]	3503	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1StringLiteral.html">StringLiteral</a>></td><td class="name" onclick="toggle('hasSize1')"><a name="hasSize1Anchor">hasSize</a></td><td>unsigned N</td></tr>
				3504	<tr><td colspan="4" class="doc" id="hasSize1"><pre>Matches nodes that have the specified size.
				3505
				3506	Given
				3507	int a[42];
				3508	int b[2 * 21];
				3509	int c[41], d[43];
				3510	char *s = "abcd";
				3511	wchar_t *ws = L"abcd";
				3512	char *w = "a";
				3513	constantArrayType(hasSize(42))
				3514	matches "int a[42]" and "int b[2 * 21]"
				3515	stringLiteral(hasSize(4))
				3516	matches "abcd", L"abcd"
				3517	</pre></td></tr>
				3518
				3519
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3520	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3521	<tr><td colspan="4" class="doc" id="isDefinition0"><pre>Matches if a declaration has a body attached.
				3522
				3523	Example matches A, va, fa
				3524	class A {};
				3525	class B; Doesn't match, as it has no body.
				3526	int va;
				3527	extern int vb; Doesn't match, as it doesn't define the variable.
				3528	void fa() {}
				3529	void fb(); Doesn't match, as it has no body.
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	3530	@interface X
				3531	- (void)ma; Doesn't match, interface is declaration.
				3532	@end
				3533	@implementation X
				3534	- (void)ma {}
				3535	@end
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3536
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	3537	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>>,
				3538	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMethodDecl.html">ObjCMethodDecl</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3539	</pre></td></tr>
				3540
				3541
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3542	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3543	<tr><td colspan="4" class="doc" id="equalsIntegralValue0"><pre>Matches a TemplateArgument of integral type with a given value.
				3544
				3545	Note that 'Value' is a string as the template argument's value is
				3546	an arbitrary precision integer. 'Value' must be euqal to the canonical
				3547	representation of that integral value in base 10.
				3548
				3549	Given
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3550	template<int T> struct C {};
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3551	C<42> c;
				3552	classTemplateSpecializationDecl(
				3553	hasAnyTemplateArgument(equalsIntegralValue("42")))
				3554	matches the implicit instantiation of C in C<42>.
				3555	</pre></td></tr>
				3556
				3557
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3558	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3559	<tr><td colspan="4" class="doc" id="isIntegral0"><pre>Matches a TemplateArgument that is an integral value.
				3560
				3561	Given
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3562	template<int T> struct C {};
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3563	C<42> c;
				3564	classTemplateSpecializationDecl(
				3565	hasAnyTemplateArgument(isIntegral()))
				3566	matches the implicit instantiation of C in C<42>
				3567	with isIntegral() matching 42.
				3568	</pre></td></tr>
				3569
				3570
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3571	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3572	<tr><td colspan="4" class="doc" id="templateArgumentCountIs1"><pre>Matches if the number of template arguments equals N.
				3573
				3574	Given
				3575	template<typename T> struct C {};
				3576	C<int> c;
				3577	classTemplateSpecializationDecl(templateArgumentCountIs(1))
				3578	matches C<int>.
				3579	</pre></td></tr>
				3580
				3581
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3582	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3583	<tr><td colspan="4" class="doc" id="isExpansionInFileMatching2"><pre>Matches AST nodes that were expanded within files whose name is
				3584	partially matching a given regex.
				3585
				3586	Example matches Y but not X
				3587	(matcher = cxxRecordDecl(isExpansionInFileMatching("AST.*"))
				3588	#include "ASTMatcher.h"
				3589	class X {};
				3590	ASTMatcher.h:
				3591	class Y {};
				3592
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3593	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3594	</pre></td></tr>
				3595
				3596
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3597	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3598	<tr><td colspan="4" class="doc" id="isExpansionInMainFile2"><pre>Matches AST nodes that were expanded within the main-file.
				3599
				3600	Example matches X but not Y
				3601	(matcher = cxxRecordDecl(isExpansionInMainFile())
				3602	#include <Y.h>
				3603	class X {};
				3604	Y.h:
				3605	class Y {};
				3606
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3607	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3608	</pre></td></tr>
				3609
				3610
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3611	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3612	<tr><td colspan="4" class="doc" id="isExpansionInSystemHeader2"><pre>Matches AST nodes that were expanded within system-header-files.
				3613
				3614	Example matches Y but not X
				3615	(matcher = cxxRecordDecl(isExpansionInSystemHeader())
				3616	#include <SystemHeader.h>
				3617	class X {};
				3618	SystemHeader.h:
				3619	class Y {};
				3620
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3621	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3622	</pre></td></tr>
				3623
				3624
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3625	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('booleanType0')"><a name="booleanType0Anchor">booleanType</a></td><td></td></tr>
Samuel Benzaquen	30747f7	2015-12-22 21:06:36 +0000	[diff] [blame]	3626	<tr><td colspan="4" class="doc" id="booleanType0"><pre>Matches type bool.
				3627
				3628	Given
				3629	struct S { bool func(); };
				3630	functionDecl(returns(booleanType()))
				3631	matches "bool func();"
				3632	</pre></td></tr>
				3633
				3634
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3635	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3636	<tr><td colspan="4" class="doc" id="equalsBoundNode2"><pre>Matches if a node equals a previously bound node.
				3637
				3638	Matches a node if it equals the node previously bound to ID.
				3639
				3640	Given
				3641	class X { int a; int b; };
				3642	cxxRecordDecl(
				3643	has(fieldDecl(hasName("a"), hasType(type().bind("t")))),
				3644	has(fieldDecl(hasName("b"), hasType(type(equalsBoundNode("t"))))))
				3645	matches the class X, as a and b have the same type.
				3646
				3647	Note that when multiple matches are involved via forEach* matchers,
				3648	equalsBoundNodes acts as a filter.
				3649	For example:
				3650	compoundStmt(
				3651	forEachDescendant(varDecl().bind("d")),
				3652	forEachDescendant(declRefExpr(to(decl(equalsBoundNode("d"))))))
				3653	will trigger a match for each combination of variable declaration
				3654	and reference to that variable declaration within a compound statement.
				3655	</pre></td></tr>
				3656
				3657
Samuel Benzaquen	a4076ea	2016-05-04 20:45:00 +0000	[diff] [blame]	3658	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('equalsNode2')"><a name="equalsNode2Anchor">equalsNode</a></td><td>const Type* Other</td></tr>
				3659	<tr><td colspan="4" class="doc" id="equalsNode2"><pre>Matches if a node equals another node.
				3660
				3661	Type has pointer identity in the AST.
				3662	</pre></td></tr>
				3663
				3664
Aaron Ballman	eb7e5d9	2016-02-18 16:36:01 +0000	[diff] [blame]	3665	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('realFloatingPointType0')"><a name="realFloatingPointType0Anchor">realFloatingPointType</a></td><td></td></tr>
				3666	<tr><td colspan="4" class="doc" id="realFloatingPointType0"><pre>Matches any real floating-point type (float, double, long double).
				3667
				3668	Given
				3669	int i;
				3670	float f;
				3671	realFloatingPointType()
				3672	matches "float f" but not "int i"
				3673	</pre></td></tr>
				3674
				3675
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3676	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3677	<tr><td colspan="4" class="doc" id="voidType0"><pre>Matches type void.
				3678
				3679	Given
				3680	struct S { void func(); };
				3681	functionDecl(returns(voidType()))
				3682	matches "void func();"
				3683	</pre></td></tr>
				3684
				3685
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3686	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3687	<tr><td colspan="4" class="doc" id="ofKind0"><pre>Matches unary expressions of a certain kind.
				3688
				3689	Given
				3690	int x;
				3691	int s = sizeof(x) + alignof(x)
				3692	unaryExprOrTypeTraitExpr(ofKind(UETT_SizeOf))
				3693	matches sizeof(x)
				3694	</pre></td></tr>
				3695
				3696
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3697	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3698	<tr><td colspan="4" class="doc" id="hasOperatorName1"><pre>Matches the operator Name of operator expressions (binary or
				3699	unary).
				3700
				3701	Example matches a \|\| b (matcher = binaryOperator(hasOperatorName("\|\|")))
				3702	!(a \|\| b)
				3703	</pre></td></tr>
				3704
				3705
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3706	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>></td><td class="name" onclick="toggle('hasAutomaticStorageDuration0')"><a name="hasAutomaticStorageDuration0Anchor">hasAutomaticStorageDuration</a></td><td></td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3707	<tr><td colspan="4" class="doc" id="hasAutomaticStorageDuration0"><pre>Matches a variable declaration that has automatic storage duration.
				3708
				3709	Example matches x, but not y, z, or a.
				3710	(matcher = varDecl(hasAutomaticStorageDuration())
				3711	void f() {
				3712	int x;
				3713	static int y;
				3714	thread_local int z;
				3715	}
				3716	int a;
				3717	</pre></td></tr>
				3718
				3719
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3720	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3721	<tr><td colspan="4" class="doc" id="hasGlobalStorage0"><pre>Matches a variable declaration that does not have local storage.
				3722
				3723	Example matches y and z (matcher = varDecl(hasGlobalStorage())
				3724	void f() {
				3725	int x;
				3726	static int y;
				3727	}
				3728	int z;
				3729	</pre></td></tr>
				3730
				3731
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3732	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3733	<tr><td colspan="4" class="doc" id="hasLocalStorage0"><pre>Matches a variable declaration that has function scope and is a
				3734	non-static local variable.
				3735
				3736	Example matches x (matcher = varDecl(hasLocalStorage())
				3737	void f() {
				3738	int x;
				3739	static int y;
				3740	}
				3741	int z;
				3742	</pre></td></tr>
				3743
				3744
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3745	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>></td><td class="name" onclick="toggle('hasStaticStorageDuration0')"><a name="hasStaticStorageDuration0Anchor">hasStaticStorageDuration</a></td><td></td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3746	<tr><td colspan="4" class="doc" id="hasStaticStorageDuration0"><pre>Matches a variable declaration that has static storage duration.
Haojian Wu	398a8ea	2016-09-27 07:53:20 +0000	[diff] [blame]	3747	It includes the variable declared at namespace scope and those declared
				3748	with "static" and "extern" storage class specifiers.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3749
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3750	void f() {
				3751	int x;
				3752	static int y;
				3753	thread_local int z;
				3754	}
				3755	int a;
Haojian Wu	398a8ea	2016-09-27 07:53:20 +0000	[diff] [blame]	3756	static int b;
				3757	extern int c;
				3758	varDecl(hasStaticStorageDuration())
				3759	matches the function declaration y, a, b and c.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3760	</pre></td></tr>
				3761
				3762
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3763	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>></td><td class="name" onclick="toggle('hasThreadStorageDuration0')"><a name="hasThreadStorageDuration0Anchor">hasThreadStorageDuration</a></td><td></td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3764	<tr><td colspan="4" class="doc" id="hasThreadStorageDuration0"><pre>Matches a variable declaration that has thread storage duration.
				3765
				3766	Example matches z, but not x, z, or a.
				3767	(matcher = varDecl(hasThreadStorageDuration())
				3768	void f() {
				3769	int x;
				3770	static int y;
				3771	thread_local int z;
				3772	}
				3773	int a;
				3774	</pre></td></tr>
				3775
				3776
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3777	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3778	<tr><td colspan="4" class="doc" id="isConstexpr0"><pre>Matches constexpr variable and function declarations.
				3779
				3780	Given:
				3781	constexpr int foo = 42;
				3782	constexpr int bar();
				3783	varDecl(isConstexpr())
				3784	matches the declaration of foo.
				3785	functionDecl(isConstexpr())
				3786	matches the declaration of bar.
				3787	</pre></td></tr>
				3788
				3789
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3790	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3791	<tr><td colspan="4" class="doc" id="isDefinition1"><pre>Matches if a declaration has a body attached.
				3792
				3793	Example matches A, va, fa
				3794	class A {};
				3795	class B; Doesn't match, as it has no body.
				3796	int va;
				3797	extern int vb; Doesn't match, as it doesn't define the variable.
				3798	void fa() {}
				3799	void fb(); Doesn't match, as it has no body.
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	3800	@interface X
				3801	- (void)ma; Doesn't match, interface is declaration.
				3802	@end
				3803	@implementation X
				3804	- (void)ma {}
				3805	@end
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3806
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	3807	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>>,
				3808	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMethodDecl.html">ObjCMethodDecl</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3809	</pre></td></tr>
				3810
				3811
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3812	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3813	<tr><td colspan="4" class="doc" id="isExceptionVariable0"><pre>Matches a variable declaration that is an exception variable from
				3814	a C++ catch block, or an Objective-C statement.
				3815
				3816	Example matches x (matcher = varDecl(isExceptionVariable())
				3817	void f(int y) {
				3818	try {
				3819	} catch (int x) {
				3820	}
				3821	}
				3822	</pre></td></tr>
				3823
				3824
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3825	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3826	<tr><td colspan="4" class="doc" id="isExplicitTemplateSpecialization1"><pre>Matches explicit template specializations of function, class, or
				3827	static member variable template instantiations.
				3828
				3829	Given
				3830	template<typename T> void A(T t) { }
				3831	template<> void A(int N) { }
				3832	functionDecl(isExplicitTemplateSpecialization())
				3833	matches the specialization A<int>().
				3834
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3835	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3836	</pre></td></tr>
				3837
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	3838
Benjamin Kramer	87e6d99	2016-08-04 10:02:03 +0000	[diff] [blame]	3839	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>></td><td class="name" onclick="toggle('isExternC1')"><a name="isExternC1Anchor">isExternC</a></td><td></td></tr>
Alexander Shaposhnikov	f681c4e	2017-09-22 19:29:38 +0000	[diff] [blame]	3840	<tr><td colspan="4" class="doc" id="isExternC1"><pre>Matches extern "C" function or variable declarations.
Benjamin Kramer	87e6d99	2016-08-04 10:02:03 +0000	[diff] [blame]	3841
				3842	Given:
				3843	extern "C" void f() {}
				3844	extern "C" { void g() {} }
				3845	void h() {}
Alexander Shaposhnikov	f681c4e	2017-09-22 19:29:38 +0000	[diff] [blame]	3846	extern "C" int x = 1;
				3847	extern "C" int y = 2;
				3848	int z = 3;
Benjamin Kramer	87e6d99	2016-08-04 10:02:03 +0000	[diff] [blame]	3849	functionDecl(isExternC())
Alexander Shaposhnikov	f681c4e	2017-09-22 19:29:38 +0000	[diff] [blame]	3850	matches the declaration of f and g, but not the declaration of h.
				3851	varDecl(isExternC())
				3852	matches the declaration of x and y, but not the declaration of z.
Benjamin Kramer	87e6d99	2016-08-04 10:02:03 +0000	[diff] [blame]	3853	</pre></td></tr>
				3854
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	3855
Haojian Wu	b3d2546	2016-09-26 16:01:52 +0000	[diff] [blame]	3856	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1VarDecl.html">VarDecl</a>></td><td class="name" onclick="toggle('isStaticStorageClass1')"><a name="isStaticStorageClass1Anchor">isStaticStorageClass</a></td><td></td></tr>
Haojian Wu	398a8ea	2016-09-27 07:53:20 +0000	[diff] [blame]	3857	<tr><td colspan="4" class="doc" id="isStaticStorageClass1"><pre>Matches variablefunction declarations that have "static" storage
				3858	class specifier ("static" keyword) written in the source.
Haojian Wu	b3d2546	2016-09-26 16:01:52 +0000	[diff] [blame]	3859
				3860	Given:
				3861	static void f() {}
				3862	static int i = 0;
Haojian Wu	398a8ea	2016-09-27 07:53:20 +0000	[diff] [blame]	3863	extern int j;
				3864	int k;
Haojian Wu	b3d2546	2016-09-26 16:01:52 +0000	[diff] [blame]	3865	functionDecl(isStaticStorageClass())
				3866	matches the function declaration f.
				3867	varDecl(isStaticStorageClass())
				3868	matches the variable declaration i.
				3869	</pre></td></tr>
				3870
				3871
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3872	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3873	<tr><td colspan="4" class="doc" id="isTemplateInstantiation1"><pre>Matches template instantiations of function, class, or static
				3874	member variable template instantiations.
				3875
				3876	Given
				3877	template <typename T> class X {}; class A {}; X<A> x;
				3878	or
				3879	template <typename T> class X {}; class A {}; template class X<A>;
Eric Liu	09ee48e	2018-02-21 14:22:42 +0000	[diff] [blame]	3880	or
				3881	template <typename T> class X {}; class A {}; extern template class X<A>;
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3882	cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
				3883	matches the template instantiation of X<A>.
				3884
				3885	But given
				3886	template <typename T> class X {}; class A {};
				3887	template <> class X<A> {}; X<A> x;
				3888	cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
				3889	does not match, as X<A> is an explicit template specialization.
				3890
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3891	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3892	</pre></td></tr>
				3893
				3894
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3895	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3896	<tr><td colspan="4" class="doc" id="isInstantiated0"><pre>Matches declarations that are template instantiations or are inside
				3897	template instantiations.
				3898
				3899	Given
				3900	template<typename T> void A(T t) { T i; }
				3901	A(0);
				3902	A(0U);
				3903	functionDecl(isInstantiated())
				3904	matches 'A(int) {...};' and 'A(unsigned) {...}'.
				3905	</pre></td></tr>
				3906
				3907
Aaron Ballman	eb7e5d9	2016-02-18 16:36:01 +0000	[diff] [blame]	3908	<tr><td>Matcher<internal::Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>>></td><td class="name" onclick="toggle('nullPointerConstant0')"><a name="nullPointerConstant0Anchor">nullPointerConstant</a></td><td></td></tr>
				3909	<tr><td colspan="4" class="doc" id="nullPointerConstant0"><pre>Matches expressions that resolve to a null pointer constant, such as
				3910	GNU's __null, C++11's nullptr, or C's NULL macro.
				3911
				3912	Given:
				3913	void *v1 = NULL;
				3914	void *v2 = nullptr;
				3915	void *v3 = __null; GNU extension
				3916	char cp = (char )0;
				3917	int *ip = 0;
				3918	int i = 0;
				3919	expr(nullPointerConstant())
				3920	matches the initializer for v1, v2, v3, cp, and ip. Does not match the
				3921	initializer for i.
				3922	</pre></td></tr>
				3923
				3924
Samuel Benzaquen	a4076ea	2016-05-04 20:45:00 +0000	[diff] [blame]	3925	<tr><td>Matcher<internal::Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamedDecl.html">NamedDecl</a>>></td><td class="name" onclick="toggle('hasAnyName0')"><a name="hasAnyName0Anchor">hasAnyName</a></td><td>StringRef, ..., StringRef</td></tr>
				3926	<tr><td colspan="4" class="doc" id="hasAnyName0"><pre>Matches NamedDecl nodes that have any of the specified names.
				3927
				3928	This matcher is only provided as a performance optimization of hasName.
				3929	hasAnyName(a, b, c)
				3930	is equivalent to, but faster than
				3931	anyOf(hasName(a), hasName(b), hasName(c))
				3932	</pre></td></tr>
				3933
				3934
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3935	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3936	<tr><td colspan="4" class="doc" id="isInTemplateInstantiation0"><pre>Matches statements inside of a template instantiation.
				3937
				3938	Given
				3939	int j;
				3940	template<typename T> void A(T t) { T i; j += 42;}
				3941	A(0);
				3942	A(0U);
				3943	declStmt(isInTemplateInstantiation())
				3944	matches 'int i;' and 'unsigned i'.
				3945	unless(stmt(isInTemplateInstantiation()))
				3946	will NOT match j += 42; as it's shared between the template definition and
				3947	instantiation.
				3948	</pre></td></tr>
				3949
Benjamin Kramer	7d0cc23	2015-11-20 07:57:46 +0000	[diff] [blame]	3950	<!--END_NARROWING_MATCHERS -->
				3951	</table>
				3952
				3953	<!-- ======================================================================= -->
				3954	<h2 id="traversal-matchers">AST Traversal Matchers</h2>
				3955	<!-- ======================================================================= -->
				3956
				3957	<p>Traversal matchers specify the relationship to other nodes that are
				3958	reachable from the current node.</p>
				3959
				3960	<p>Note that there are special traversal matchers (has, hasDescendant, forEach and
				3961	forEachDescendant) which work on all nodes and allow users to write more generic
				3962	match expressions.</p>
				3963
				3964	<table>
				3965	<tr style="text-align:left"><th>Return type</th><th>Name</th><th>Parameters</th></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3966	<!-- START_TRAVERSAL_MATCHERS -->
				3967
				3968	<tr><td>Matcher<></td><td class="name" onclick="toggle('eachOf0')"><a name="eachOf0Anchor">eachOf</a></td><td>Matcher<>, ..., Matcher<*></td></tr>
				3969	<tr><td colspan="4" class="doc" id="eachOf0"><pre>Matches if any of the given matchers matches.
				3970
				3971	Unlike anyOf, eachOf will generate a match result for each
				3972	matching submatcher.
				3973
				3974	For example, in:
				3975	class A { int a; int b; };
				3976	The matcher:
				3977	cxxRecordDecl(eachOf(has(fieldDecl(hasName("a")).bind("v")),
				3978	has(fieldDecl(hasName("b")).bind("v"))))
				3979	will generate two results binding "v", the first of which binds
				3980	the field declaration of a, the second the field declaration of
				3981	b.
				3982
				3983	Usable as: Any Matcher
				3984	</pre></td></tr>
				3985
				3986
				3987	<tr><td>Matcher<></td><td class="name" onclick="toggle('forEachDescendant0')"><a name="forEachDescendant0Anchor">forEachDescendant</a></td><td>Matcher<></td></tr>
				3988	<tr><td colspan="4" class="doc" id="forEachDescendant0"><pre>Matches AST nodes that have descendant AST nodes that match the
				3989	provided matcher.
				3990
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3991	Example matches X, A, A::X, B, B::C, B::C::X
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3992	(matcher = cxxRecordDecl(forEachDescendant(cxxRecordDecl(hasName("X")))))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3993	class X {};
				3994	class A { class X {}; }; Matches A, because A::X is a class of name
				3995	X inside A.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3996	class B { class C { class X {}; }; };
				3997
				3998	DescendantT must be an AST base type.
				3999
				4000	As opposed to 'hasDescendant', 'forEachDescendant' will cause a match for
				4001	each result that matches instead of only on the first one.
				4002
				4003	Note: Recursively combined ForEachDescendant can cause many matches:
				4004	cxxRecordDecl(forEachDescendant(cxxRecordDecl(
				4005	forEachDescendant(cxxRecordDecl())
				4006	)))
				4007	will match 10 times (plus injected class name matches) on:
				4008	class A { class B { class C { class D { class E {}; }; }; }; };
				4009
				4010	Usable as: Any Matcher
				4011	</pre></td></tr>
				4012
				4013
				4014	<tr><td>Matcher<></td><td class="name" onclick="toggle('forEach0')"><a name="forEach0Anchor">forEach</a></td><td>Matcher<></td></tr>
				4015	<tr><td colspan="4" class="doc" id="forEach0"><pre>Matches AST nodes that have child AST nodes that match the
				4016	provided matcher.
				4017
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	4018	Example matches X, Y, Y::X, Z::Y, Z::Y::X
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4019	(matcher = cxxRecordDecl(forEach(cxxRecordDecl(hasName("X")))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	4020	class X {};
				4021	class Y { class X {}; }; Matches Y, because Y::X is a class of name X
				4022	inside Y.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4023	class Z { class Y { class X {}; }; }; Does not match Z.
				4024
				4025	ChildT must be an AST base type.
				4026
				4027	As opposed to 'has', 'forEach' will cause a match for each result that
				4028	matches instead of only on the first one.
				4029
				4030	Usable as: Any Matcher
				4031	</pre></td></tr>
				4032
				4033
				4034	<tr><td>Matcher<></td><td class="name" onclick="toggle('hasAncestor0')"><a name="hasAncestor0Anchor">hasAncestor</a></td><td>Matcher<></td></tr>
				4035	<tr><td colspan="4" class="doc" id="hasAncestor0"><pre>Matches AST nodes that have an ancestor that matches the provided
				4036	matcher.
				4037
				4038	Given
				4039	void f() { if (true) { int x = 42; } }
				4040	void g() { for (;;) { int x = 43; } }
				4041	expr(integerLiteral(hasAncestor(ifStmt()))) matches 42, but not 43.
				4042
				4043	Usable as: Any Matcher
				4044	</pre></td></tr>
				4045
				4046
				4047	<tr><td>Matcher<></td><td class="name" onclick="toggle('hasDescendant0')"><a name="hasDescendant0Anchor">hasDescendant</a></td><td>Matcher<></td></tr>
				4048	<tr><td colspan="4" class="doc" id="hasDescendant0"><pre>Matches AST nodes that have descendant AST nodes that match the
				4049	provided matcher.
				4050
				4051	Example matches X, Y, Z
				4052	(matcher = cxxRecordDecl(hasDescendant(cxxRecordDecl(hasName("X")))))
				4053	class X {}; Matches X, because X::X is a class of name X inside X.
				4054	class Y { class X {}; };
				4055	class Z { class Y { class X {}; }; };
				4056
				4057	DescendantT must be an AST base type.
				4058
				4059	Usable as: Any Matcher
				4060	</pre></td></tr>
				4061
				4062
				4063	<tr><td>Matcher<></td><td class="name" onclick="toggle('has0')"><a name="has0Anchor">has</a></td><td>Matcher<></td></tr>
				4064	<tr><td colspan="4" class="doc" id="has0"><pre>Matches AST nodes that have child AST nodes that match the
				4065	provided matcher.
				4066
				4067	Example matches X, Y
				4068	(matcher = cxxRecordDecl(has(cxxRecordDecl(hasName("X")))
				4069	class X {}; Matches X, because X::X is a class of name X inside X.
				4070	class Y { class X {}; };
				4071	class Z { class Y { class X {}; }; }; Does not match Z.
				4072
				4073	ChildT must be an AST base type.
				4074
				4075	Usable as: Any Matcher
Aaron Ballman	ba8dbbe	2016-06-06 18:52:17 +0000	[diff] [blame]	4076	Note that has is direct matcher, so it also matches things like implicit
				4077	casts and paren casts. If you are matching with expr then you should
				4078	probably consider using ignoringParenImpCasts like:
				4079	has(ignoringParenImpCasts(expr())).
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4080	</pre></td></tr>
				4081
				4082
				4083	<tr><td>Matcher<></td><td class="name" onclick="toggle('hasParent0')"><a name="hasParent0Anchor">hasParent</a></td><td>Matcher<></td></tr>
				4084	<tr><td colspan="4" class="doc" id="hasParent0"><pre>Matches AST nodes that have a parent that matches the provided
				4085	matcher.
				4086
				4087	Given
				4088	void f() { for (;;) { int x = 42; if (true) { int x = 43; } } }
				4089	compoundStmt(hasParent(ifStmt())) matches "{ int x = 43; }".
				4090
				4091	Usable as: Any Matcher
				4092	</pre></td></tr>
				4093
				4094
Etienne Bergeron	5500f95	2016-05-30 15:25:25 +0000	[diff] [blame]	4095	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AbstractConditionalOperator.html">AbstractConditionalOperator</a>></td><td class="name" onclick="toggle('hasCondition5')"><a name="hasCondition5Anchor">hasCondition</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr>
				4096	<tr><td colspan="4" class="doc" id="hasCondition5"><pre>Matches the condition expression of an if statement, for loop,
				4097	switch statement or conditional operator.
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	4098
				4099	Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true))))
				4100	if (true) {}
				4101	</pre></td></tr>
				4102
				4103
				4104	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AbstractConditionalOperator.html">AbstractConditionalOperator</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>
				4105	<tr><td colspan="4" class="doc" id="hasFalseExpression0"><pre>Matches the false branch expression of a conditional operator
				4106	(binary or ternary).
				4107
				4108	Example matches b
				4109	condition ? a : b
				4110	condition ?: b
				4111	</pre></td></tr>
				4112
				4113
				4114	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AbstractConditionalOperator.html">AbstractConditionalOperator</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>
				4115	<tr><td colspan="4" class="doc" id="hasTrueExpression0"><pre>Matches the true branch expression of a conditional operator.
				4116
				4117	Example 1 (conditional ternary operator): matches a
				4118	condition ? a : b
				4119
				4120	Example 2 (conditional binary operator): matches opaqueValueExpr(condition)
				4121	condition ?: b
				4122	</pre></td></tr>
				4123
				4124
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4125	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>></td><td class="name" onclick="toggle('hasDeclaration15')"><a name="hasDeclaration15Anchor">hasDeclaration</a></td><td>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	4126	<tr><td colspan="4" class="doc" id="hasDeclaration15"><pre>Matches a node if the declaration associated with that node
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	4127	matches the given matcher.
				4128
				4129	The associated declaration is:
				4130	- for type nodes, the declaration of the underlying type
				4131	- for CallExpr, the declaration of the callee
				4132	- for MemberExpr, the declaration of the referenced member
				4133	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	4134	- for CXXNewExpr, the declaration of the operator new
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	4135
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4136	For type nodes, hasDeclaration will generally match the declaration of the
				4137	sugared type. Given
				4138	class X {};
				4139	typedef X Y;
				4140	Y y;
				4141	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				4142	typedefDecl. A common use case is to match the underlying, desugared type.
				4143	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				4144	varDecl(hasType(hasUnqualifiedDesugaredType(
				4145	recordType(hasDeclaration(decl())))))
				4146	In this matcher, the decl will match the CXXRecordDecl of class X.
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	4147
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	4148	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				4149	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				4150	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>>,
				4151	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>>,
				4152	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>>,
				4153	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>>,
				4154	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	4155	</pre></td></tr>
				4156
				4157
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4158	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4159	<tr><td colspan="4" class="doc" id="hasBase0"><pre>Matches the base expression of an array subscript expression.
				4160
				4161	Given
				4162	int i[5];
				4163	void f() { i[1] = 42; }
				4164	arraySubscriptExpression(hasBase(implicitCastExpr(
				4165	hasSourceExpression(declRefExpr()))))
				4166	matches i[1] with the declRefExpr() matching i
				4167	</pre></td></tr>
				4168
				4169
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4170	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4171	<tr><td colspan="4" class="doc" id="hasIndex0"><pre>Matches the index expression of an array subscript expression.
				4172
				4173	Given
				4174	int i[5];
				4175	void f() { i[1] = 42; }
				4176	arraySubscriptExpression(hasIndex(integerLiteral()))
				4177	matches i[1] with the integerLiteral() matching 1
				4178	</pre></td></tr>
				4179
				4180
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4181	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ArraySubscriptExpr.html">ArraySubscriptExpr</a>></td><td class="name" onclick="toggle('hasLHS1')"><a name="hasLHS1Anchor">hasLHS</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4182	<tr><td colspan="4" class="doc" id="hasLHS1"><pre>Matches the left hand side of binary operator expressions.
				4183
				4184	Example matches a (matcher = binaryOperator(hasLHS()))
				4185	a \|\| b
				4186	</pre></td></tr>
				4187
				4188
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4189	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ArraySubscriptExpr.html">ArraySubscriptExpr</a>></td><td class="name" onclick="toggle('hasRHS1')"><a name="hasRHS1Anchor">hasRHS</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4190	<tr><td colspan="4" class="doc" id="hasRHS1"><pre>Matches the right hand side of binary operator expressions.
				4191
				4192	Example matches b (matcher = binaryOperator(hasRHS()))
				4193	a \|\| b
				4194	</pre></td></tr>
				4195
				4196
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4197	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4198	<tr><td colspan="4" class="doc" id="hasElementTypeLoc0"><pre>Matches arrays and C99 complex types that have a specific element
				4199	type.
				4200
				4201	Given
				4202	struct A {};
				4203	A a[7];
				4204	int b[7];
				4205	arrayType(hasElementType(builtinType()))
				4206	matches "int b[7]"
				4207
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4208	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4209	</pre></td></tr>
				4210
				4211
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4212	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4213	<tr><td colspan="4" class="doc" id="hasElementType0"><pre>Matches arrays and C99 complex types that have a specific element
				4214	type.
				4215
				4216	Given
				4217	struct A {};
				4218	A a[7];
				4219	int b[7];
				4220	arrayType(hasElementType(builtinType()))
				4221	matches "int b[7]"
				4222
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4223	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4224	</pre></td></tr>
				4225
				4226
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4227	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4228	<tr><td colspan="4" class="doc" id="hasValueTypeLoc0"><pre>Matches atomic types with a specific value type.
				4229
				4230	Given
				4231	_Atomic(int) i;
				4232	_Atomic(float) f;
				4233	atomicType(hasValueType(isInteger()))
				4234	matches "_Atomic(int) i"
				4235
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4236	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AtomicType.html">AtomicType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4237	</pre></td></tr>
				4238
				4239
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4240	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4241	<tr><td colspan="4" class="doc" id="hasValueType0"><pre>Matches atomic types with a specific value type.
				4242
				4243	Given
				4244	_Atomic(int) i;
				4245	_Atomic(float) f;
				4246	atomicType(hasValueType(isInteger()))
				4247	matches "_Atomic(int) i"
				4248
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4249	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AtomicType.html">AtomicType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4250	</pre></td></tr>
				4251
				4252
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4253	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4254	<tr><td colspan="4" class="doc" id="hasDeducedType0"><pre>Matches AutoType nodes where the deduced type is a specific type.
				4255
				4256	Note: There is no TypeLoc for the deduced type and thus no
				4257	getDeducedLoc() matcher.
				4258
				4259	Given
				4260	auto a = 1;
				4261	auto b = 2.0;
				4262	autoType(hasDeducedType(isInteger()))
				4263	matches "auto a"
				4264
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4265	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AutoType.html">AutoType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4266	</pre></td></tr>
				4267
				4268
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4269	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4270	<tr><td colspan="4" class="doc" id="hasEitherOperand0"><pre>Matches if either the left hand side or the right hand side of a
				4271	binary operator matches.
				4272	</pre></td></tr>
				4273
				4274
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4275	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4276	<tr><td colspan="4" class="doc" id="hasLHS0"><pre>Matches the left hand side of binary operator expressions.
				4277
				4278	Example matches a (matcher = binaryOperator(hasLHS()))
				4279	a \|\| b
				4280	</pre></td></tr>
				4281
				4282
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4283	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4284	<tr><td colspan="4" class="doc" id="hasRHS0"><pre>Matches the right hand side of binary operator expressions.
				4285
				4286	Example matches b (matcher = binaryOperator(hasRHS()))
				4287	a \|\| b
				4288	</pre></td></tr>
				4289
				4290
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4291	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4292	<tr><td colspan="4" class="doc" id="pointeeLoc0"><pre>Narrows PointerType (and similar) matchers to those where the
				4293	pointee matches a given matcher.
				4294
				4295	Given
				4296	int *a;
				4297	int const *b;
				4298	float const *f;
				4299	pointerType(pointee(isConstQualified(), isInteger()))
				4300	matches "int const *b"
				4301
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4302	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>>,
				4303	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4304	</pre></td></tr>
				4305
				4306
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4307	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4308	<tr><td colspan="4" class="doc" id="pointee0"><pre>Narrows PointerType (and similar) matchers to those where the
				4309	pointee matches a given matcher.
				4310
				4311	Given
				4312	int *a;
				4313	int const *b;
				4314	float const *f;
				4315	pointerType(pointee(isConstQualified(), isInteger()))
				4316	matches "int const *b"
				4317
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4318	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>>,
				4319	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4320	</pre></td></tr>
				4321
				4322
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4323	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>></td><td class="name" onclick="toggle('forEachArgumentWithParam1')"><a name="forEachArgumentWithParam1Anchor">forEachArgumentWithParam</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> ArgMatcher, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParmVarDecl.html">ParmVarDecl</a>> ParamMatcher</td></tr>
Aaron Ballman	d7b18b9	2016-01-18 20:28:57 +0000	[diff] [blame]	4324	<tr><td colspan="4" class="doc" id="forEachArgumentWithParam1"><pre>Matches all arguments and their respective ParmVarDecl.
				4325
				4326	Given
				4327	void f(int i);
				4328	int y;
				4329	f(y);
Clement Courbet	4251759	2016-07-12 06:36:00 +0000	[diff] [blame]	4330	callExpr(
				4331	forEachArgumentWithParam(
				4332	declRefExpr(to(varDecl(hasName("y")))),
				4333	parmVarDecl(hasType(isInteger()))
				4334	))
Aaron Ballman	d7b18b9	2016-01-18 20:28:57 +0000	[diff] [blame]	4335	matches f(y);
				4336	with declRefExpr(...)
				4337	matching int y
				4338	and parmVarDecl(...)
				4339	matching int i
				4340	</pre></td></tr>
				4341
				4342
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4343	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4344	<tr><td colspan="4" class="doc" id="hasAnyArgument1"><pre>Matches any argument of a call expression or a constructor call
George Karpenkov	a763fdf	2018-03-07 02:32:44 +0000	[diff] [blame]	4345	expression, or an ObjC-message-send expression.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4346
				4347	Given
				4348	void x(int, int, int) { int y; x(1, y, 42); }
				4349	callExpr(hasAnyArgument(declRefExpr()))
				4350	matches x(1, y, 42)
				4351	with hasAnyArgument(...)
				4352	matching y
George Karpenkov	a763fdf	2018-03-07 02:32:44 +0000	[diff] [blame]	4353
				4354	For ObjectiveC, given
				4355	@interface I - (void) f:(int) y; @end
Clement Courbet	2513aa0	2018-03-21 10:48:00 +0000	[diff] [blame]	4356	void foo(I *i) { [i f:12]; }
George Karpenkov	a763fdf	2018-03-07 02:32:44 +0000	[diff] [blame]	4357	objcMessageExpr(hasAnyArgument(integerLiteral(equals(12))))
				4358	matches [i f:12]
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4359	</pre></td></tr>
				4360
				4361
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4362	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4363	<tr><td colspan="4" class="doc" id="hasArgument1"><pre>Matches the n'th argument of a call expression or a constructor
				4364	call expression.
				4365
				4366	Example matches y in x(y)
				4367	(matcher = callExpr(hasArgument(0, declRefExpr())))
				4368	void x(int) { int y; x(y); }
				4369	</pre></td></tr>
				4370
				4371
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4372	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>></td><td class="name" onclick="toggle('hasDeclaration13')"><a name="hasDeclaration13Anchor">hasDeclaration</a></td><td>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	4373	<tr><td colspan="4" class="doc" id="hasDeclaration13"><pre>Matches a node if the declaration associated with that node
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4374	matches the given matcher.
				4375
				4376	The associated declaration is:
				4377	- for type nodes, the declaration of the underlying type
				4378	- for CallExpr, the declaration of the callee
				4379	- for MemberExpr, the declaration of the referenced member
				4380	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	4381	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4382
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4383	For type nodes, hasDeclaration will generally match the declaration of the
				4384	sugared type. Given
				4385	class X {};
				4386	typedef X Y;
				4387	Y y;
				4388	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				4389	typedefDecl. A common use case is to match the underlying, desugared type.
				4390	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				4391	varDecl(hasType(hasUnqualifiedDesugaredType(
				4392	recordType(hasDeclaration(decl())))))
				4393	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4394
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	4395	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				4396	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				4397	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>>,
				4398	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>>,
				4399	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>>,
				4400	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>>,
				4401	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4402	</pre></td></tr>
				4403
				4404
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4405	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4406	<tr><td colspan="4" class="doc" id="forEachConstructorInitializer0"><pre>Matches each constructor initializer in a constructor definition.
				4407
				4408	Given
				4409	class A { A() : i(42), j(42) {} int i; int j; };
				4410	cxxConstructorDecl(forEachConstructorInitializer(
				4411	forField(decl().bind("x"))
				4412	))
				4413	will trigger two matches, binding for 'i' and 'j' respectively.
				4414	</pre></td></tr>
				4415
				4416
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4417	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4418	<tr><td colspan="4" class="doc" id="hasAnyConstructorInitializer0"><pre>Matches a constructor initializer.
				4419
				4420	Given
				4421	struct Foo {
				4422	Foo() : foo_(1) { }
				4423	int foo_;
				4424	};
				4425	cxxRecordDecl(has(cxxConstructorDecl(
				4426	hasAnyConstructorInitializer(anything())
				4427	)))
				4428	record matches Foo, hasAnyConstructorInitializer matches foo_(1)
				4429	</pre></td></tr>
				4430
				4431
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4432	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4433	<tr><td colspan="4" class="doc" id="forField0"><pre>Matches the field declaration of a constructor initializer.
				4434
				4435	Given
				4436	struct Foo {
				4437	Foo() : foo_(1) { }
				4438	int foo_;
				4439	};
				4440	cxxRecordDecl(has(cxxConstructorDecl(hasAnyConstructorInitializer(
				4441	forField(hasName("foo_"))))))
				4442	matches Foo
				4443	with forField matching foo_
				4444	</pre></td></tr>
				4445
				4446
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4447	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4448	<tr><td colspan="4" class="doc" id="withInitializer0"><pre>Matches the initializer expression of a constructor initializer.
				4449
				4450	Given
				4451	struct Foo {
				4452	Foo() : foo_(1) { }
				4453	int foo_;
				4454	};
				4455	cxxRecordDecl(has(cxxConstructorDecl(hasAnyConstructorInitializer(
				4456	withInitializer(integerLiteral(equals(1)))))))
				4457	matches Foo
				4458	with withInitializer matching (1)
				4459	</pre></td></tr>
				4460
				4461
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4462	<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>
Aaron Ballman	2b6963f	2016-01-20 16:26:48 +0000	[diff] [blame]	4463	<tr><td colspan="4" class="doc" id="hasBody3"><pre>Matches a 'for', 'while', 'do while' statement or a function
				4464	definition that has a given body.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4465
				4466	Given
				4467	for (;;) {}
				4468	hasBody(compoundStmt())
				4469	matches 'for (;;) {}'
				4470	with compoundStmt()
				4471	matching '{}'
				4472	</pre></td></tr>
				4473
				4474
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4475	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4476	<tr><td colspan="4" class="doc" id="hasLoopVariable0"><pre>Matches the initialization statement of a for loop.
				4477
				4478	Example:
				4479	forStmt(hasLoopVariable(anything()))
				4480	matches 'int x' in
				4481	for (int x : a) { }
				4482	</pre></td></tr>
				4483
				4484
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4485	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4486	<tr><td colspan="4" class="doc" id="hasRangeInit0"><pre>Matches the range initialization statement of a for loop.
				4487
				4488	Example:
				4489	forStmt(hasRangeInit(anything()))
				4490	matches 'a' in
				4491	for (int x : a) { }
				4492	</pre></td></tr>
				4493
				4494
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4495	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4496	<tr><td colspan="4" class="doc" id="onImplicitObjectArgument0"><pre></pre></td></tr>
				4497
				4498
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4499	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4500	<tr><td colspan="4" class="doc" id="on0"><pre>Matches on the implicit object argument of a member call expression.
				4501
				4502	Example matches y.x()
				4503	(matcher = cxxMemberCallExpr(on(hasType(cxxRecordDecl(hasName("Y"))))))
				4504	class Y { public: void x(); };
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	4505	void z() { Y y; y.x(); }
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4506
				4507	FIXME: Overload to allow directly matching types?
				4508	</pre></td></tr>
				4509
				4510
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4511	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4512	<tr><td colspan="4" class="doc" id="thisPointerType1"><pre>Overloaded to match the type's declaration.
				4513	</pre></td></tr>
				4514
				4515
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4516	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4517	<tr><td colspan="4" class="doc" id="thisPointerType0"><pre>Matches if the expression's type either matches the specified
				4518	matcher, or is a pointer to a type that matches the InnerMatcher.
				4519	</pre></td></tr>
				4520
				4521
Clement Courbet	6ecaec8	2016-07-05 07:49:31 +0000	[diff] [blame]	4522	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMethodDecl.html">CXXMethodDecl</a>></td><td class="name" onclick="toggle('forEachOverridden0')"><a name="forEachOverridden0Anchor">forEachOverridden</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXMethodDecl.html">CXXMethodDecl</a>> InnerMatcher</td></tr>
Haojian Wu	b3d2546	2016-09-26 16:01:52 +0000	[diff] [blame]	4523	<tr><td colspan="4" class="doc" id="forEachOverridden0"><pre>Matches each method overriden by the given method. This matcher may
Clement Courbet	6ecaec8	2016-07-05 07:49:31 +0000	[diff] [blame]	4524	produce multiple matches.
				4525
				4526	Given
				4527	class A { virtual void f(); };
				4528	class B : public A { void f(); };
				4529	class C : public B { void f(); };
				4530	cxxMethodDecl(ofClass(hasName("C")),
				4531	forEachOverridden(cxxMethodDecl().bind("b"))).bind("d")
				4532	matches once, with "b" binding "A::f" and "d" binding "C::f" (Note
				4533	that B::f is not overridden by C::f).
				4534
				4535	The check can produce multiple matches in case of multiple inheritance, e.g.
				4536	class A1 { virtual void f(); };
				4537	class A2 { virtual void f(); };
				4538	class C : public A1, public A2 { void f(); };
				4539	cxxMethodDecl(ofClass(hasName("C")),
				4540	forEachOverridden(cxxMethodDecl().bind("b"))).bind("d")
				4541	matches twice, once with "b" binding "A1::f" and "d" binding "C::f", and
				4542	once with "b" binding "A2::f" and "d" binding "C::f".
				4543	</pre></td></tr>
				4544
				4545
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4546	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4547	<tr><td colspan="4" class="doc" id="ofClass0"><pre>Matches the class declaration that the given method declaration
				4548	belongs to.
				4549
				4550	FIXME: Generalize this for other kinds of declarations.
				4551	FIXME: What other kind of declarations would we need to generalize
				4552	this to?
				4553
				4554	Example matches A() in the last line
				4555	(matcher = cxxConstructExpr(hasDeclaration(cxxMethodDecl(
				4556	ofClass(hasName("A"))))))
				4557	class A {
				4558	public:
				4559	A();
				4560	};
				4561	A a = A();
				4562	</pre></td></tr>
				4563
				4564
Adam Balogh	da488a6	2017-11-23 12:43:20 +0000	[diff] [blame]	4565	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>></td><td class="name" onclick="toggle('hasArraySize0')"><a name="hasArraySize0Anchor">hasArraySize</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr>
				4566	<tr><td colspan="4" class="doc" id="hasArraySize0"><pre>Matches array new expressions with a given array size.
				4567
				4568	Given:
				4569	MyClass *p1 = new MyClass[10];
				4570	cxxNewExpr(hasArraySize(intgerLiteral(equals(10))))
				4571	matches the expression 'new MyClass[10]'.
				4572	</pre></td></tr>
				4573
				4574
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4575	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>></td><td class="name" onclick="toggle('hasDeclaration12')"><a name="hasDeclaration12Anchor">hasDeclaration</a></td><td>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	4576	<tr><td colspan="4" class="doc" id="hasDeclaration12"><pre>Matches a node if the declaration associated with that node
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	4577	matches the given matcher.
				4578
				4579	The associated declaration is:
				4580	- for type nodes, the declaration of the underlying type
				4581	- for CallExpr, the declaration of the callee
				4582	- for MemberExpr, the declaration of the referenced member
				4583	- for CXXConstructExpr, the declaration of the constructor
				4584	- for CXXNewExpr, the declaration of the operator new
				4585
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4586	For type nodes, hasDeclaration will generally match the declaration of the
				4587	sugared type. Given
				4588	class X {};
				4589	typedef X Y;
				4590	Y y;
				4591	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				4592	typedefDecl. A common use case is to match the underlying, desugared type.
				4593	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				4594	varDecl(hasType(hasUnqualifiedDesugaredType(
				4595	recordType(hasDeclaration(decl())))))
				4596	In this matcher, the decl will match the CXXRecordDecl of class X.
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	4597
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	4598	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				4599	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				4600	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>>,
				4601	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>>,
				4602	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>>,
				4603	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>>,
				4604	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	4605	</pre></td></tr>
				4606
				4607
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4608	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4609	<tr><td colspan="4" class="doc" id="hasMethod0"><pre>Matches the first method of a class or struct that satisfies InnerMatcher.
				4610
				4611	Given:
				4612	class A { void func(); };
				4613	class B { void member(); };
				4614
				4615	cxxRecordDecl(hasMethod(hasName("func"))) matches the declaration of
				4616	A but not B.
				4617	</pre></td></tr>
				4618
				4619
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4620	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4621	<tr><td colspan="4" class="doc" id="isDerivedFrom0"><pre>Matches C++ classes that are directly or indirectly derived from
				4622	a class matching Base.
				4623
				4624	Note that a class is not considered to be derived from itself.
				4625
				4626	Example matches Y, Z, C (Base == hasName("X"))
				4627	class X;
				4628	class Y : public X {}; directly derived
				4629	class Z : public Y {}; indirectly derived
				4630	typedef X A;
				4631	typedef A B;
				4632	class C : public B {}; derived from a typedef of X
				4633
				4634	In the following example, Bar matches isDerivedFrom(hasName("X")):
				4635	class Foo;
				4636	typedef Foo X;
				4637	class Bar : public Foo {}; derived from a type that X is a typedef of
				4638	</pre></td></tr>
				4639
				4640
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4641	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4642	<tr><td colspan="4" class="doc" id="isSameOrDerivedFrom0"><pre>Similar to isDerivedFrom(), but also matches classes that directly
				4643	match Base.
				4644	</pre></td></tr>
				4645
				4646
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4647	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4648	<tr><td colspan="4" class="doc" id="callee1"><pre>Matches if the call expression's callee's declaration matches the
				4649	given matcher.
				4650
				4651	Example matches y.x() (matcher = callExpr(callee(
				4652	cxxMethodDecl(hasName("x")))))
				4653	class Y { public: void x(); };
				4654	void z() { Y y; y.x(); }
				4655	</pre></td></tr>
				4656
				4657
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4658	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4659	<tr><td colspan="4" class="doc" id="callee0"><pre>Matches if the call expression's callee expression matches.
				4660
				4661	Given
				4662	class Y { void x() { this->x(); x(); Y y; y.x(); } };
				4663	void f() { f(); }
				4664	callExpr(callee(expr()))
				4665	matches this->x(), x(), y.x(), f()
				4666	with callee(...)
				4667	matching this->x, x, y.x, f respectively
				4668
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4669	Note: Callee cannot take the more general internal::Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4670	because this introduces ambiguous overloads with calls to Callee taking a
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4671	internal::Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>>, as the matcher hierarchy is purely
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4672	implemented in terms of implicit casts.
				4673	</pre></td></tr>
				4674
				4675
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4676	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>></td><td class="name" onclick="toggle('forEachArgumentWithParam0')"><a name="forEachArgumentWithParam0Anchor">forEachArgumentWithParam</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> ArgMatcher, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParmVarDecl.html">ParmVarDecl</a>> ParamMatcher</td></tr>
Aaron Ballman	d7b18b9	2016-01-18 20:28:57 +0000	[diff] [blame]	4677	<tr><td colspan="4" class="doc" id="forEachArgumentWithParam0"><pre>Matches all arguments and their respective ParmVarDecl.
				4678
				4679	Given
				4680	void f(int i);
				4681	int y;
				4682	f(y);
Clement Courbet	4251759	2016-07-12 06:36:00 +0000	[diff] [blame]	4683	callExpr(
				4684	forEachArgumentWithParam(
				4685	declRefExpr(to(varDecl(hasName("y")))),
				4686	parmVarDecl(hasType(isInteger()))
				4687	))
Aaron Ballman	d7b18b9	2016-01-18 20:28:57 +0000	[diff] [blame]	4688	matches f(y);
				4689	with declRefExpr(...)
				4690	matching int y
				4691	and parmVarDecl(...)
				4692	matching int i
				4693	</pre></td></tr>
				4694
				4695
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4696	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4697	<tr><td colspan="4" class="doc" id="hasAnyArgument0"><pre>Matches any argument of a call expression or a constructor call
George Karpenkov	a763fdf	2018-03-07 02:32:44 +0000	[diff] [blame]	4698	expression, or an ObjC-message-send expression.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4699
				4700	Given
				4701	void x(int, int, int) { int y; x(1, y, 42); }
				4702	callExpr(hasAnyArgument(declRefExpr()))
				4703	matches x(1, y, 42)
				4704	with hasAnyArgument(...)
				4705	matching y
George Karpenkov	a763fdf	2018-03-07 02:32:44 +0000	[diff] [blame]	4706
				4707	For ObjectiveC, given
				4708	@interface I - (void) f:(int) y; @end
Clement Courbet	2513aa0	2018-03-21 10:48:00 +0000	[diff] [blame]	4709	void foo(I *i) { [i f:12]; }
George Karpenkov	a763fdf	2018-03-07 02:32:44 +0000	[diff] [blame]	4710	objcMessageExpr(hasAnyArgument(integerLiteral(equals(12))))
				4711	matches [i f:12]
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4712	</pre></td></tr>
				4713
				4714
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4715	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4716	<tr><td colspan="4" class="doc" id="hasArgument0"><pre>Matches the n'th argument of a call expression or a constructor
				4717	call expression.
				4718
				4719	Example matches y in x(y)
				4720	(matcher = callExpr(hasArgument(0, declRefExpr())))
				4721	void x(int) { int y; x(y); }
				4722	</pre></td></tr>
				4723
				4724
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4725	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>></td><td class="name" onclick="toggle('hasDeclaration14')"><a name="hasDeclaration14Anchor">hasDeclaration</a></td><td>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	4726	<tr><td colspan="4" class="doc" id="hasDeclaration14"><pre>Matches a node if the declaration associated with that node
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4727	matches the given matcher.
				4728
				4729	The associated declaration is:
				4730	- for type nodes, the declaration of the underlying type
				4731	- for CallExpr, the declaration of the callee
				4732	- for MemberExpr, the declaration of the referenced member
				4733	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	4734	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4735
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4736	For type nodes, hasDeclaration will generally match the declaration of the
				4737	sugared type. Given
				4738	class X {};
				4739	typedef X Y;
				4740	Y y;
				4741	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				4742	typedefDecl. A common use case is to match the underlying, desugared type.
				4743	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				4744	varDecl(hasType(hasUnqualifiedDesugaredType(
				4745	recordType(hasDeclaration(decl())))))
				4746	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4747
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	4748	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				4749	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				4750	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>>,
				4751	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>>,
				4752	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>>,
				4753	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>>,
				4754	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4755	</pre></td></tr>
				4756
				4757
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4758	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4759	<tr><td colspan="4" class="doc" id="hasCaseConstant0"><pre>If the given case statement does not use the GNU case range
				4760	extension, matches the constant given in the statement.
				4761
				4762	Given
				4763	switch (1) { case 1: case 1+1: case 3 ... 4: ; }
				4764	caseStmt(hasCaseConstant(integerLiteral()))
				4765	matches "case 1:"
				4766	</pre></td></tr>
				4767
				4768
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4769	<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>
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4770	<tr><td colspan="4" class="doc" id="hasSourceExpression0"><pre>Matches if the cast's source expression
				4771	or opaque value's source expression matches the given matcher.
				4772
				4773	Example 1: matches "a string"
				4774	(matcher = castExpr(hasSourceExpression(cxxConstructExpr())))
				4775	class URL { URL(string); };
				4776	URL url = "a string";
				4777
				4778	Example 2: matches 'b' (matcher =
				4779	opaqueValueExpr(hasSourceExpression(implicitCastExpr(declRefExpr())))
				4780	int a = b ?: 1;
				4781	</pre></td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4782
				4783
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4784	<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>
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	4785	<tr><td colspan="4" class="doc" id="hasAnyTemplateArgument0"><pre>Matches classTemplateSpecializations, templateSpecializationType and
				4786	functionDecl that have at least one TemplateArgument matching the given
				4787	InnerMatcher.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4788
				4789	Given
				4790	template<typename T> class A {};
				4791	template<> class A<double> {};
				4792	A<int> a;
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	4793
Haojian Wu	99e39a7	2016-07-29 17:30:13 +0000	[diff] [blame]	4794	template<typename T> f() {};
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	4795	void func() { f<int>(); };
				4796
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4797	classTemplateSpecializationDecl(hasAnyTemplateArgument(
				4798	refersToType(asString("int"))))
				4799	matches the specialization A<int>
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	4800
				4801	functionDecl(hasAnyTemplateArgument(refersToType(asString("int"))))
				4802	matches the specialization f<int>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4803	</pre></td></tr>
				4804
				4805
Manuel Klimek	696e505	2017-08-02 13:04:44 +0000	[diff] [blame]	4806	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ClassTemplateSpecializationDecl.html">ClassTemplateSpecializationDecl</a>></td><td class="name" onclick="toggle('hasSpecializedTemplate0')"><a name="hasSpecializedTemplate0Anchor">hasSpecializedTemplate</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ClassTemplateDecl.html">ClassTemplateDecl</a>> InnerMatcher</td></tr>
				4807	<tr><td colspan="4" class="doc" id="hasSpecializedTemplate0"><pre>Matches the specialized template of a specialization declaration.
				4808
				4809	Given
				4810	tempalate<typename T> class A {};
				4811	typedef A<int> B;
				4812	classTemplateSpecializationDecl(hasSpecializedTemplate(classTemplateDecl()))
				4813	matches 'B' with classTemplateDecl() matching the class template
				4814	declaration of 'A'.
				4815	</pre></td></tr>
				4816
				4817
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4818	<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>
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	4819	<tr><td colspan="4" class="doc" id="hasTemplateArgument0"><pre>Matches classTemplateSpecializations, templateSpecializationType and
				4820	functionDecl where the n'th TemplateArgument matches the given InnerMatcher.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4821
				4822	Given
				4823	template<typename T, typename U> class A {};
				4824	A<bool, int> b;
				4825	A<int, bool> c;
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	4826
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	4827	template<typename T> void f() {}
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	4828	void func() { f<int>(); };
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4829	classTemplateSpecializationDecl(hasTemplateArgument(
				4830	1, refersToType(asString("int"))))
				4831	matches the specialization A<bool, int>
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	4832
				4833	functionDecl(hasTemplateArgument(0, refersToType(asString("int"))))
				4834	matches the specialization f<int>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4835	</pre></td></tr>
				4836
				4837
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4838	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4839	<tr><td colspan="4" class="doc" id="hasElementTypeLoc1"><pre>Matches arrays and C99 complex types that have a specific element
				4840	type.
				4841
				4842	Given
				4843	struct A {};
				4844	A a[7];
				4845	int b[7];
				4846	arrayType(hasElementType(builtinType()))
				4847	matches "int b[7]"
				4848
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4849	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4850	</pre></td></tr>
				4851
				4852
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4853	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4854	<tr><td colspan="4" class="doc" id="hasElementType1"><pre>Matches arrays and C99 complex types that have a specific element
				4855	type.
				4856
				4857	Given
				4858	struct A {};
				4859	A a[7];
				4860	int b[7];
				4861	arrayType(hasElementType(builtinType()))
				4862	matches "int b[7]"
				4863
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4864	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4865	</pre></td></tr>
				4866
				4867
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4868	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4869	<tr><td colspan="4" class="doc" id="hasAnySubstatement0"><pre>Matches compound statements where at least one substatement matches
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	4870	a given matcher. Also matches StmtExprs that have CompoundStmt as children.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4871
				4872	Given
				4873	{ {}; 1+2; }
				4874	hasAnySubstatement(compoundStmt())
				4875	matches '{ {}; 1+2; }'
				4876	with compoundStmt()
				4877	matching '{}'
				4878	</pre></td></tr>
				4879
				4880
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4881	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4882	<tr><td colspan="4" class="doc" id="hasDecayedType0"><pre>Matches the decayed type, whos decayed type matches InnerMatcher
				4883	</pre></td></tr>
				4884
				4885
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4886	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	4887	<tr><td colspan="4" class="doc" id="hasDeclaration11"><pre>Matches a node if the declaration associated with that node
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4888	matches the given matcher.
				4889
				4890	The associated declaration is:
				4891	- for type nodes, the declaration of the underlying type
				4892	- for CallExpr, the declaration of the callee
				4893	- for MemberExpr, the declaration of the referenced member
				4894	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	4895	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4896
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4897	For type nodes, hasDeclaration will generally match the declaration of the
				4898	sugared type. Given
				4899	class X {};
				4900	typedef X Y;
				4901	Y y;
				4902	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				4903	typedefDecl. A common use case is to match the underlying, desugared type.
				4904	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				4905	varDecl(hasType(hasUnqualifiedDesugaredType(
				4906	recordType(hasDeclaration(decl())))))
				4907	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4908
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	4909	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				4910	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				4911	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>>,
				4912	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>>,
				4913	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>>,
				4914	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>>,
				4915	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4916	</pre></td></tr>
				4917
				4918
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4919	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4920	<tr><td colspan="4" class="doc" id="throughUsingDecl0"><pre>Matches a DeclRefExpr that refers to a declaration through a
				4921	specific using shadow declaration.
				4922
				4923	Given
				4924	namespace a { void f() {} }
				4925	using a::f;
				4926	void g() {
				4927	f(); Matches this ..
				4928	a::f(); .. but not this.
				4929	}
				4930	declRefExpr(throughUsingDecl(anything()))
				4931	matches f()
				4932	</pre></td></tr>
				4933
				4934
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4935	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4936	<tr><td colspan="4" class="doc" id="to0"><pre>Matches a DeclRefExpr that refers to a declaration that matches the
				4937	specified matcher.
				4938
				4939	Example matches x in if(x)
				4940	(matcher = declRefExpr(to(varDecl(hasName("x")))))
				4941	bool x;
				4942	if (x) {}
				4943	</pre></td></tr>
				4944
				4945
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4946	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4947	<tr><td colspan="4" class="doc" id="containsDeclaration0"><pre>Matches the n'th declaration of a declaration statement.
				4948
				4949	Note that this does not work for global declarations because the AST
				4950	breaks up multiple-declaration DeclStmt's into multiple single-declaration
				4951	DeclStmt's.
				4952	Example: Given non-global declarations
				4953	int a, b = 0;
				4954	int c;
				4955	int d = 2, e;
				4956	declStmt(containsDeclaration(
				4957	0, varDecl(hasInitializer(anything()))))
				4958	matches only 'int d = 2, e;', and
				4959	declStmt(containsDeclaration(1, varDecl()))
				4960	matches 'int a, b = 0' as well as 'int d = 2, e;'
				4961	but 'int c;' is not matched.
				4962	</pre></td></tr>
				4963
				4964
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4965	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4966	<tr><td colspan="4" class="doc" id="hasSingleDecl0"><pre>Matches the Decl of a DeclStmt which has a single declaration.
				4967
				4968	Given
				4969	int a, b;
				4970	int c;
				4971	declStmt(hasSingleDecl(anything()))
				4972	matches 'int c;' but not 'int a, b;'.
				4973	</pre></td></tr>
				4974
				4975
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4976	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4977	<tr><td colspan="4" class="doc" id="hasTypeLoc0"><pre>Matches if the type location of the declarator decl's type matches
				4978	the inner matcher.
				4979
				4980	Given
				4981	int x;
				4982	declaratorDecl(hasTypeLoc(loc(asString("int"))))
				4983	matches int x
				4984	</pre></td></tr>
				4985
				4986
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4987	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4988	<tr><td colspan="4" class="doc" id="hasDeclContext0"><pre>Matches declarations whose declaration context, interpreted as a
				4989	Decl, matches InnerMatcher.
				4990
				4991	Given
				4992	namespace N {
				4993	namespace M {
				4994	class D {};
				4995	}
				4996	}
				4997
				4998	cxxRcordDecl(hasDeclContext(namedDecl(hasName("M")))) matches the
				4999	declaration of class D.
				5000	</pre></td></tr>
				5001
				5002
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5003	<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>
Aaron Ballman	2b6963f	2016-01-20 16:26:48 +0000	[diff] [blame]	5004	<tr><td colspan="4" class="doc" id="hasBody0"><pre>Matches a 'for', 'while', 'do while' statement or a function
				5005	definition that has a given body.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5006
				5007	Given
				5008	for (;;) {}
				5009	hasBody(compoundStmt())
				5010	matches 'for (;;) {}'
				5011	with compoundStmt()
				5012	matching '{}'
				5013	</pre></td></tr>
				5014
				5015
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5016	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5017	<tr><td colspan="4" class="doc" id="hasCondition3"><pre>Matches the condition expression of an if statement, for loop,
Etienne Bergeron	5500f95	2016-05-30 15:25:25 +0000	[diff] [blame]	5018	switch statement or conditional operator.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5019
				5020	Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true))))
				5021	if (true) {}
				5022	</pre></td></tr>
				5023
				5024
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5025	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5026	<tr><td colspan="4" class="doc" id="hasQualifier0"><pre>Matches ElaboratedTypes whose qualifier, a NestedNameSpecifier,
				5027	matches InnerMatcher if the qualifier exists.
				5028
				5029	Given
				5030	namespace N {
				5031	namespace M {
				5032	class D {};
				5033	}
				5034	}
				5035	N::M::D d;
				5036
				5037	elaboratedType(hasQualifier(hasPrefix(specifiesNamespace(hasName("N"))))
				5038	matches the type of the variable declaration of d.
				5039	</pre></td></tr>
				5040
				5041
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5042	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5043	<tr><td colspan="4" class="doc" id="namesType0"><pre>Matches ElaboratedTypes whose named type matches InnerMatcher.
				5044
				5045	Given
				5046	namespace N {
				5047	namespace M {
				5048	class D {};
				5049	}
				5050	}
				5051	N::M::D d;
				5052
				5053	elaboratedType(namesType(recordType(
				5054	hasDeclaration(namedDecl(hasName("D")))))) matches the type of the variable
				5055	declaration of d.
				5056	</pre></td></tr>
				5057
				5058
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5059	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	5060	<tr><td colspan="4" class="doc" id="hasDeclaration10"><pre>Matches a node if the declaration associated with that node
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5061	matches the given matcher.
				5062
				5063	The associated declaration is:
				5064	- for type nodes, the declaration of the underlying type
				5065	- for CallExpr, the declaration of the callee
				5066	- for MemberExpr, the declaration of the referenced member
				5067	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	5068	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5069
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5070	For type nodes, hasDeclaration will generally match the declaration of the
				5071	sugared type. Given
				5072	class X {};
				5073	typedef X Y;
				5074	Y y;
				5075	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				5076	typedefDecl. A common use case is to match the underlying, desugared type.
				5077	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				5078	varDecl(hasType(hasUnqualifiedDesugaredType(
				5079	recordType(hasDeclaration(decl())))))
				5080	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5081
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	5082	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				5083	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				5084	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>>,
				5085	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>>,
				5086	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>>,
				5087	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>>,
				5088	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5089	</pre></td></tr>
				5090
				5091
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5092	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5093	<tr><td colspan="4" class="doc" id="hasDestinationType0"><pre>Matches casts whose destination type matches a given matcher.
				5094
				5095	(Note: Clang's AST refers to other conversions as "casts" too, and calls
				5096	actual casts "explicit" casts.)
				5097	</pre></td></tr>
				5098
				5099
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	5100	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</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>
				5101	<tr><td colspan="4" class="doc" id="hasType3"><pre>Overloaded to match the declaration of the expression's or value
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5102	declaration's type.
				5103
				5104	In case of a value declaration (for example a variable declaration),
				5105	this resolves one layer of indirection. For example, in the value
				5106	declaration "X x;", cxxRecordDecl(hasName("X")) matches the declaration of
				5107	X, while varDecl(hasType(cxxRecordDecl(hasName("X")))) matches the
				5108	declaration of x.
				5109
				5110	Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X")))))
				5111	and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X")))))
				5112	class X {};
				5113	void y(X &x) { x; X z; }
				5114
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5115	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5116	</pre></td></tr>
				5117
				5118
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5119	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5120	<tr><td colspan="4" class="doc" id="hasType0"><pre>Matches if the expression's or declaration's type matches a type
				5121	matcher.
				5122
				5123	Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X")))))
				5124	and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X")))))
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	5125	and U (matcher = typedefDecl(hasType(asString("int")))
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5126	class X {};
				5127	void y(X &x) { x; X z; }
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	5128	typedef int U;
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5129	</pre></td></tr>
				5130
				5131
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5132	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5133	<tr><td colspan="4" class="doc" id="ignoringImpCasts0"><pre>Matches expressions that match InnerMatcher after any implicit casts
				5134	are stripped off.
				5135
				5136	Parentheses and explicit casts are not discarded.
				5137	Given
				5138	int arr[5];
				5139	int a = 0;
				5140	char b = 0;
				5141	const int c = a;
				5142	int *d = arr;
				5143	long e = (long) 0l;
				5144	The matchers
				5145	varDecl(hasInitializer(ignoringImpCasts(integerLiteral())))
				5146	varDecl(hasInitializer(ignoringImpCasts(declRefExpr())))
				5147	would match the declarations for a, b, c, and d, but not e.
				5148	While
				5149	varDecl(hasInitializer(integerLiteral()))
				5150	varDecl(hasInitializer(declRefExpr()))
				5151	only match the declarations for b, c, and d.
				5152	</pre></td></tr>
				5153
				5154
Clement Courbet	369e975	2018-03-21 10:54:29 +0000	[diff] [blame]	5155	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>></td><td class="name" onclick="toggle('ignoringImplicit0')"><a name="ignoringImplicit0Anchor">ignoringImplicit</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr>
Cong Liu	8a02efb	2016-06-24 09:38:03 +0000	[diff] [blame]	5156	<tr><td colspan="4" class="doc" id="ignoringImplicit0"><pre>Matches expressions that match InnerMatcher after any implicit AST
				5157	nodes are stripped off.
				5158
				5159	Parentheses and explicit casts are not discarded.
				5160	Given
				5161	class C {};
				5162	C a = C();
				5163	C b;
				5164	C c = b;
				5165	The matchers
				5166	varDecl(hasInitializer(ignoringImplicit(cxxConstructExpr())))
				5167	would match the declarations for a, b, and c.
				5168	While
				5169	varDecl(hasInitializer(cxxConstructExpr()))
				5170	only match the declarations for b and c.
				5171	</pre></td></tr>
				5172
				5173
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5174	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5175	<tr><td colspan="4" class="doc" id="ignoringParenCasts0"><pre>Matches expressions that match InnerMatcher after parentheses and
				5176	casts are stripped off.
				5177
				5178	Implicit and non-C Style casts are also discarded.
				5179	Given
				5180	int a = 0;
				5181	char b = (0);
				5182	void* c = reinterpret_cast<char*>(0);
				5183	char d = char(0);
				5184	The matcher
				5185	varDecl(hasInitializer(ignoringParenCasts(integerLiteral())))
				5186	would match the declarations for a, b, c, and d.
				5187	while
				5188	varDecl(hasInitializer(integerLiteral()))
				5189	only match the declaration for a.
				5190	</pre></td></tr>
				5191
				5192
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5193	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5194	<tr><td colspan="4" class="doc" id="ignoringParenImpCasts0"><pre>Matches expressions that match InnerMatcher after implicit casts and
				5195	parentheses are stripped off.
				5196
				5197	Explicit casts are not discarded.
				5198	Given
				5199	int arr[5];
				5200	int a = 0;
				5201	char b = (0);
				5202	const int c = a;
				5203	int *d = (arr);
				5204	long e = ((long) 0l);
				5205	The matchers
				5206	varDecl(hasInitializer(ignoringParenImpCasts(integerLiteral())))
				5207	varDecl(hasInitializer(ignoringParenImpCasts(declRefExpr())))
				5208	would match the declarations for a, b, c, and d, but not e.
				5209	while
				5210	varDecl(hasInitializer(integerLiteral()))
				5211	varDecl(hasInitializer(declRefExpr()))
				5212	would only match the declaration for a.
				5213	</pre></td></tr>
				5214
				5215
Malcolm Parsons	4ca3d18	2016-12-24 13:35:14 +0000	[diff] [blame]	5216	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FieldDecl.html">FieldDecl</a>></td><td class="name" onclick="toggle('hasInClassInitializer0')"><a name="hasInClassInitializer0Anchor">hasInClassInitializer</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr>
				5217	<tr><td colspan="4" class="doc" id="hasInClassInitializer0"><pre>Matches non-static data members that have an in-class initializer.
				5218
				5219	Given
				5220	class C {
				5221	int a = 2;
				5222	int b = 3;
				5223	int c;
				5224	};
				5225	fieldDecl(hasInClassInitializer(integerLiteral(equals(2))))
				5226	matches 'int a;' but not 'int b;'.
				5227	fieldDecl(hasInClassInitializer(anything()))
				5228	matches 'int a;' and 'int b;' but not 'int c;'.
				5229	</pre></td></tr>
				5230
				5231
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5232	<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>
Aaron Ballman	2b6963f	2016-01-20 16:26:48 +0000	[diff] [blame]	5233	<tr><td colspan="4" class="doc" id="hasBody1"><pre>Matches a 'for', 'while', 'do while' statement or a function
				5234	definition that has a given body.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5235
				5236	Given
				5237	for (;;) {}
				5238	hasBody(compoundStmt())
				5239	matches 'for (;;) {}'
				5240	with compoundStmt()
				5241	matching '{}'
				5242	</pre></td></tr>
				5243
				5244
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5245	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5246	<tr><td colspan="4" class="doc" id="hasCondition1"><pre>Matches the condition expression of an if statement, for loop,
Etienne Bergeron	5500f95	2016-05-30 15:25:25 +0000	[diff] [blame]	5247	switch statement or conditional operator.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5248
				5249	Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true))))
				5250	if (true) {}
				5251	</pre></td></tr>
				5252
				5253
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5254	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5255	<tr><td colspan="4" class="doc" id="hasIncrement0"><pre>Matches the increment statement of a for loop.
				5256
				5257	Example:
				5258	forStmt(hasIncrement(unaryOperator(hasOperatorName("++"))))
				5259	matches '++x' in
				5260	for (x; x < N; ++x) { }
				5261	</pre></td></tr>
				5262
				5263
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5264	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5265	<tr><td colspan="4" class="doc" id="hasLoopInit0"><pre>Matches the initialization statement of a for loop.
				5266
				5267	Example:
				5268	forStmt(hasLoopInit(declStmt()))
				5269	matches 'int x = 0' in
				5270	for (int x = 0; x < N; ++x) { }
				5271	</pre></td></tr>
				5272
				5273
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5274	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5275	<tr><td colspan="4" class="doc" id="hasAnyParameter0"><pre>Matches any parameter of a function declaration.
				5276
				5277	Does not match the 'this' parameter of a method.
				5278
				5279	Given
				5280	class X { void f(int x, int y, int z) {} };
				5281	cxxMethodDecl(hasAnyParameter(hasName("y")))
				5282	matches f(int x, int y, int z) {}
				5283	with hasAnyParameter(...)
				5284	matching int y
				5285	</pre></td></tr>
				5286
				5287
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	5288	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('hasAnyTemplateArgument2')"><a name="hasAnyTemplateArgument2Anchor">hasAnyTemplateArgument</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>> InnerMatcher</td></tr>
				5289	<tr><td colspan="4" class="doc" id="hasAnyTemplateArgument2"><pre>Matches classTemplateSpecializations, templateSpecializationType and
				5290	functionDecl that have at least one TemplateArgument matching the given
				5291	InnerMatcher.
				5292
				5293	Given
				5294	template<typename T> class A {};
				5295	template<> class A<double> {};
				5296	A<int> a;
				5297
Haojian Wu	99e39a7	2016-07-29 17:30:13 +0000	[diff] [blame]	5298	template<typename T> f() {};
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	5299	void func() { f<int>(); };
				5300
				5301	classTemplateSpecializationDecl(hasAnyTemplateArgument(
				5302	refersToType(asString("int"))))
				5303	matches the specialization A<int>
				5304
				5305	functionDecl(hasAnyTemplateArgument(refersToType(asString("int"))))
				5306	matches the specialization f<int>
				5307	</pre></td></tr>
				5308
				5309
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5310	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('hasBody4')"><a name="hasBody4Anchor">hasBody</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>> InnerMatcher</td></tr>
Aaron Ballman	2b6963f	2016-01-20 16:26:48 +0000	[diff] [blame]	5311	<tr><td colspan="4" class="doc" id="hasBody4"><pre>Matches a 'for', 'while', 'do while' statement or a function
				5312	definition that has a given body.
				5313
				5314	Given
				5315	for (;;) {}
				5316	hasBody(compoundStmt())
				5317	matches 'for (;;) {}'
				5318	with compoundStmt()
				5319	matching '{}'
				5320	</pre></td></tr>
				5321
				5322
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5323	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5324	<tr><td colspan="4" class="doc" id="hasParameter0"><pre>Matches the n'th parameter of a function declaration.
				5325
				5326	Given
				5327	class X { void f(int x) {} };
				5328	cxxMethodDecl(hasParameter(0, hasType(varDecl())))
				5329	matches f(int x) {}
				5330	with hasParameter(...)
				5331	matching int x
				5332	</pre></td></tr>
				5333
				5334
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	5335	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('hasTemplateArgument2')"><a name="hasTemplateArgument2Anchor">hasTemplateArgument</a></td><td>unsigned N, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>> InnerMatcher</td></tr>
				5336	<tr><td colspan="4" class="doc" id="hasTemplateArgument2"><pre>Matches classTemplateSpecializations, templateSpecializationType and
				5337	functionDecl where the n'th TemplateArgument matches the given InnerMatcher.
				5338
				5339	Given
				5340	template<typename T, typename U> class A {};
				5341	A<bool, int> b;
				5342	A<int, bool> c;
				5343
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	5344	template<typename T> void f() {}
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	5345	void func() { f<int>(); };
				5346	classTemplateSpecializationDecl(hasTemplateArgument(
				5347	1, refersToType(asString("int"))))
				5348	matches the specialization A<bool, int>
				5349
				5350	functionDecl(hasTemplateArgument(0, refersToType(asString("int"))))
				5351	matches the specialization f<int>
				5352	</pre></td></tr>
				5353
				5354
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5355	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5356	<tr><td colspan="4" class="doc" id="returns0"><pre>Matches the return type of a function declaration.
				5357
				5358	Given:
				5359	class X { int f() { return 1; } };
				5360	cxxMethodDecl(returns(asString("int")))
				5361	matches int f() { return 1; }
				5362	</pre></td></tr>
				5363
				5364
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5365	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5366	<tr><td colspan="4" class="doc" id="hasCondition0"><pre>Matches the condition expression of an if statement, for loop,
Etienne Bergeron	5500f95	2016-05-30 15:25:25 +0000	[diff] [blame]	5367	switch statement or conditional operator.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5368
				5369	Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true))))
				5370	if (true) {}
				5371	</pre></td></tr>
				5372
				5373
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5374	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5375	<tr><td colspan="4" class="doc" id="hasConditionVariableStatement0"><pre>Matches the condition variable statement in an if statement.
				5376
				5377	Given
				5378	if (A* a = GetAPointer()) {}
				5379	hasConditionVariableStatement(...)
				5380	matches 'A* a = GetAPointer()'.
				5381	</pre></td></tr>
				5382
				5383
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5384	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5385	<tr><td colspan="4" class="doc" id="hasElse0"><pre>Matches the else-statement of an if statement.
				5386
				5387	Examples matches the if statement
				5388	(matcher = ifStmt(hasElse(cxxBoolLiteral(equals(true)))))
				5389	if (false) false; else true;
				5390	</pre></td></tr>
				5391
				5392
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5393	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5394	<tr><td colspan="4" class="doc" id="hasThen0"><pre>Matches the then-statement of an if statement.
				5395
				5396	Examples matches the if statement
				5397	(matcher = ifStmt(hasThen(cxxBoolLiteral(equals(true)))))
				5398	if (false) true; else false;
				5399	</pre></td></tr>
				5400
				5401
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5402	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5403	<tr><td colspan="4" class="doc" id="hasImplicitDestinationType0"><pre>Matches implicit casts whose destination type matches a given
				5404	matcher.
				5405
				5406	FIXME: Unit test this matcher
				5407	</pre></td></tr>
				5408
				5409
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	5410	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1InitListExpr.html">InitListExpr</a>></td><td class="name" onclick="toggle('hasSyntacticForm0')"><a name="hasSyntacticForm0Anchor">hasSyntacticForm</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr>
				5411	<tr><td colspan="4" class="doc" id="hasSyntacticForm0"><pre>Matches the syntactic form of init list expressions
				5412	(if expression have it).
				5413	</pre></td></tr>
				5414
				5415
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5416	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5417	<tr><td colspan="4" class="doc" id="hasDeclaration9"><pre>Matches a node if the declaration associated with that node
				5418	matches the given matcher.
				5419
				5420	The associated declaration is:
				5421	- for type nodes, the declaration of the underlying type
				5422	- for CallExpr, the declaration of the callee
				5423	- for MemberExpr, the declaration of the referenced member
				5424	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	5425	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5426
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5427	For type nodes, hasDeclaration will generally match the declaration of the
				5428	sugared type. Given
				5429	class X {};
				5430	typedef X Y;
				5431	Y y;
				5432	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				5433	typedefDecl. A common use case is to match the underlying, desugared type.
				5434	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				5435	varDecl(hasType(hasUnqualifiedDesugaredType(
				5436	recordType(hasDeclaration(decl())))))
				5437	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5438
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	5439	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				5440	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				5441	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>>,
				5442	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>>,
				5443	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>>,
				5444	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>>,
				5445	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
				5446	</pre></td></tr>
				5447
				5448
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5449	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	5450	<tr><td colspan="4" class="doc" id="hasDeclaration8"><pre>Matches a node if the declaration associated with that node
				5451	matches the given matcher.
				5452
				5453	The associated declaration is:
				5454	- for type nodes, the declaration of the underlying type
				5455	- for CallExpr, the declaration of the callee
				5456	- for MemberExpr, the declaration of the referenced member
				5457	- for CXXConstructExpr, the declaration of the constructor
				5458	- for CXXNewExpr, the declaration of the operator new
				5459
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5460	For type nodes, hasDeclaration will generally match the declaration of the
				5461	sugared type. Given
				5462	class X {};
				5463	typedef X Y;
				5464	Y y;
				5465	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				5466	typedefDecl. A common use case is to match the underlying, desugared type.
				5467	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				5468	varDecl(hasType(hasUnqualifiedDesugaredType(
				5469	recordType(hasDeclaration(decl())))))
				5470	In this matcher, the decl will match the CXXRecordDecl of class X.
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	5471
				5472	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				5473	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				5474	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>>,
				5475	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>>,
				5476	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>>,
				5477	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>>,
				5478	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5479	</pre></td></tr>
				5480
				5481
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5482	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5483	<tr><td colspan="4" class="doc" id="hasDeclaration7"><pre>Matches a node if the declaration associated with that node
				5484	matches the given matcher.
				5485
				5486	The associated declaration is:
				5487	- for type nodes, the declaration of the underlying type
				5488	- for CallExpr, the declaration of the callee
				5489	- for MemberExpr, the declaration of the referenced member
				5490	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	5491	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5492
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5493	For type nodes, hasDeclaration will generally match the declaration of the
				5494	sugared type. Given
				5495	class X {};
				5496	typedef X Y;
				5497	Y y;
				5498	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				5499	typedefDecl. A common use case is to match the underlying, desugared type.
				5500	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				5501	varDecl(hasType(hasUnqualifiedDesugaredType(
				5502	recordType(hasDeclaration(decl())))))
				5503	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5504
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	5505	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				5506	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				5507	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>>,
				5508	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>>,
				5509	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>>,
				5510	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>>,
				5511	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5512	</pre></td></tr>
				5513
				5514
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5515	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5516	<tr><td colspan="4" class="doc" id="hasObjectExpression0"><pre>Matches a member expression where the object expression is
				5517	matched by a given matcher.
				5518
				5519	Given
				5520	struct X { int m; };
				5521	void f(X x) { x.m; m; }
				5522	memberExpr(hasObjectExpression(hasType(cxxRecordDecl(hasName("X")))))))
				5523	matches "x.m" and "m"
				5524	with hasObjectExpression(...)
				5525	matching "x" and the implicit object expression of "m" which has type X*.
				5526	</pre></td></tr>
				5527
				5528
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5529	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5530	<tr><td colspan="4" class="doc" id="member0"><pre>Matches a member expression where the member is matched by a
				5531	given matcher.
				5532
				5533	Given
				5534	struct { int first, second; } first, second;
				5535	int i(second.first);
				5536	int j(first.second);
				5537	memberExpr(member(hasName("first")))
				5538	matches second.first
				5539	but not first.second (because the member name there is "second").
				5540	</pre></td></tr>
				5541
				5542
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5543	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5544	<tr><td colspan="4" class="doc" id="pointeeLoc1"><pre>Narrows PointerType (and similar) matchers to those where the
				5545	pointee matches a given matcher.
				5546
				5547	Given
				5548	int *a;
				5549	int const *b;
				5550	float const *f;
				5551	pointerType(pointee(isConstQualified(), isInteger()))
				5552	matches "int const *b"
				5553
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5554	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>>,
				5555	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5556	</pre></td></tr>
				5557
				5558
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5559	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5560	<tr><td colspan="4" class="doc" id="pointee1"><pre>Narrows PointerType (and similar) matchers to those where the
				5561	pointee matches a given matcher.
				5562
				5563	Given
				5564	int *a;
				5565	int const *b;
				5566	float const *f;
				5567	pointerType(pointee(isConstQualified(), isInteger()))
				5568	matches "int const *b"
				5569
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5570	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>>,
				5571	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5572	</pre></td></tr>
				5573
				5574
Martin Bohme	8cef2c2	2016-08-09 15:07:52 +0000	[diff] [blame]	5575	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamedDecl.html">NamedDecl</a>></td><td class="name" onclick="toggle('hasUnderlyingDecl0')"><a name="hasUnderlyingDecl0Anchor">hasUnderlyingDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1NamedDecl.html">NamedDecl</a>> InnerMatcher</td></tr>
				5576	<tr><td colspan="4" class="doc" id="hasUnderlyingDecl0"><pre>Matches a NamedDecl whose underlying declaration matches the given
				5577	matcher.
				5578
				5579	Given
				5580	namespace N { template<class T> void f(T t); }
				5581	template <class T> void g() { using N::f; f(T()); }
				5582	unresolvedLookupExpr(hasAnyDeclaration(
				5583	namedDecl(hasUnderlyingDecl(hasName("::N::f")))))
				5584	matches the use of f in g() .
				5585	</pre></td></tr>
				5586
				5587
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5588	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5589	<tr><td colspan="4" class="doc" id="hasPrefix1"><pre>Matches on the prefix of a NestedNameSpecifierLoc.
				5590
				5591	Given
				5592	struct A { struct B { struct C {}; }; };
				5593	A::B::C c;
				5594	nestedNameSpecifierLoc(hasPrefix(loc(specifiesType(asString("struct A")))))
				5595	matches "A::"
				5596	</pre></td></tr>
				5597
				5598
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5599	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5600	<tr><td colspan="4" class="doc" id="specifiesTypeLoc0"><pre>Matches nested name specifier locs that specify a type matching the
				5601	given TypeLoc.
				5602
				5603	Given
				5604	struct A { struct B { struct C {}; }; };
				5605	A::B::C c;
				5606	nestedNameSpecifierLoc(specifiesTypeLoc(loc(type(
				5607	hasDeclaration(cxxRecordDecl(hasName("A")))))))
				5608	matches "A::"
				5609	</pre></td></tr>
				5610
				5611
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5612	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5613	<tr><td colspan="4" class="doc" id="hasPrefix0"><pre>Matches on the prefix of a NestedNameSpecifier.
				5614
				5615	Given
				5616	struct A { struct B { struct C {}; }; };
				5617	A::B::C c;
				5618	nestedNameSpecifier(hasPrefix(specifiesType(asString("struct A")))) and
				5619	matches "A::"
				5620	</pre></td></tr>
				5621
				5622
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5623	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5624	<tr><td colspan="4" class="doc" id="specifiesNamespace0"><pre>Matches nested name specifiers that specify a namespace matching the
				5625	given namespace matcher.
				5626
				5627	Given
				5628	namespace ns { struct A {}; }
				5629	ns::A a;
				5630	nestedNameSpecifier(specifiesNamespace(hasName("ns")))
				5631	matches "ns::"
				5632	</pre></td></tr>
				5633
				5634
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5635	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5636	<tr><td colspan="4" class="doc" id="specifiesType0"><pre>Matches nested name specifiers that specify a type matching the
				5637	given QualType matcher without qualifiers.
				5638
				5639	Given
				5640	struct A { struct B { struct C {}; }; };
				5641	A::B::C c;
				5642	nestedNameSpecifier(specifiesType(
				5643	hasDeclaration(cxxRecordDecl(hasName("A")))
				5644	))
				5645	matches "A::"
				5646	</pre></td></tr>
				5647
				5648
George Karpenkov	a763fdf	2018-03-07 02:32:44 +0000	[diff] [blame]	5649	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMessageExpr.html">ObjCMessageExpr</a>></td><td class="name" onclick="toggle('hasAnyArgument2')"><a name="hasAnyArgument2Anchor">hasAnyArgument</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr>
				5650	<tr><td colspan="4" class="doc" id="hasAnyArgument2"><pre>Matches any argument of a call expression or a constructor call
				5651	expression, or an ObjC-message-send expression.
				5652
				5653	Given
				5654	void x(int, int, int) { int y; x(1, y, 42); }
				5655	callExpr(hasAnyArgument(declRefExpr()))
				5656	matches x(1, y, 42)
				5657	with hasAnyArgument(...)
				5658	matching y
				5659
				5660	For ObjectiveC, given
				5661	@interface I - (void) f:(int) y; @end
Clement Courbet	2513aa0	2018-03-21 10:48:00 +0000	[diff] [blame]	5662	void foo(I *i) { [i f:12]; }
George Karpenkov	a763fdf	2018-03-07 02:32:44 +0000	[diff] [blame]	5663	objcMessageExpr(hasAnyArgument(integerLiteral(equals(12))))
				5664	matches [i f:12]
				5665	</pre></td></tr>
				5666
				5667
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5668	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5669	<tr><td colspan="4" class="doc" id="hasArgument2"><pre>Matches the n'th argument of a call expression or a constructor
				5670	call expression.
				5671
				5672	Example matches y in x(y)
				5673	(matcher = callExpr(hasArgument(0, declRefExpr())))
				5674	void x(int) { int y; x(y); }
				5675	</pre></td></tr>
				5676
				5677
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5678	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5679	<tr><td colspan="4" class="doc" id="hasReceiverType0"><pre>Matches on the receiver of an ObjectiveC Message expression.
				5680
				5681	Example
Jakub Kuderski	64b6c78	2017-05-05 21:01:12 +0000	[diff] [blame]	5682	matcher = objCMessageExpr(hasReceiverType(asString("UIWebView *")));
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5683	matches the [webView ...] message invocation.
				5684	NSString *webViewJavaScript = ...
				5685	UIWebView *webView = ...
				5686	[webView stringByEvaluatingJavaScriptFromString:webViewJavascript];
				5687	</pre></td></tr>
				5688
				5689
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	5690	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1OpaqueValueExpr.html">OpaqueValueExpr</a>></td><td class="name" onclick="toggle('hasSourceExpression1')"><a name="hasSourceExpression1Anchor">hasSourceExpression</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr>
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5691	<tr><td colspan="4" class="doc" id="hasSourceExpression1"><pre>Matches if the cast's source expression
				5692	or opaque value's source expression matches the given matcher.
				5693
				5694	Example 1: matches "a string"
				5695	(matcher = castExpr(hasSourceExpression(cxxConstructExpr())))
				5696	class URL { URL(string); };
				5697	URL url = "a string";
				5698
				5699	Example 2: matches 'b' (matcher =
				5700	opaqueValueExpr(hasSourceExpression(implicitCastExpr(declRefExpr())))
				5701	int a = b ?: 1;
				5702	</pre></td></tr>
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	5703
				5704
Martin Bohme	8cef2c2	2016-08-09 15:07:52 +0000	[diff] [blame]	5705	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1OverloadExpr.html">OverloadExpr</a>></td><td class="name" onclick="toggle('hasAnyDeclaration0')"><a name="hasAnyDeclaration0Anchor">hasAnyDeclaration</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
				5706	<tr><td colspan="4" class="doc" id="hasAnyDeclaration0"><pre>Matches an OverloadExpr if any of the declarations in the set of
				5707	overloads matches the given matcher.
				5708
				5709	Given
				5710	template <typename T> void foo(T);
				5711	template <typename T> void bar(T);
				5712	template <typename T> void baz(T t) {
				5713	foo(t);
				5714	bar(t);
				5715	}
				5716	unresolvedLookupExpr(hasAnyDeclaration(
				5717	functionTemplateDecl(hasName("foo"))))
				5718	matches foo in foo(t); but not bar in bar(t);
				5719	</pre></td></tr>
				5720
				5721
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5722	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5723	<tr><td colspan="4" class="doc" id="innerType0"><pre>Matches ParenType nodes where the inner type is a specific type.
				5724
				5725	Given
				5726	int (*ptr_to_array)[4];
				5727	int (*ptr_to_func)(int);
				5728
				5729	varDecl(hasType(pointsTo(parenType(innerType(functionType()))))) matches
				5730	ptr_to_func but not ptr_to_array.
				5731
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5732	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParenType.html">ParenType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5733	</pre></td></tr>
				5734
				5735
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5736	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5737	<tr><td colspan="4" class="doc" id="pointeeLoc2"><pre>Narrows PointerType (and similar) matchers to those where the
				5738	pointee matches a given matcher.
				5739
				5740	Given
				5741	int *a;
				5742	int const *b;
				5743	float const *f;
				5744	pointerType(pointee(isConstQualified(), isInteger()))
				5745	matches "int const *b"
				5746
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5747	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>>,
				5748	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5749	</pre></td></tr>
				5750
				5751
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5752	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5753	<tr><td colspan="4" class="doc" id="pointee2"><pre>Narrows PointerType (and similar) matchers to those where the
				5754	pointee matches a given matcher.
				5755
				5756	Given
				5757	int *a;
				5758	int const *b;
				5759	float const *f;
				5760	pointerType(pointee(isConstQualified(), isInteger()))
				5761	matches "int const *b"
				5762
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5763	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>>,
				5764	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5765	</pre></td></tr>
				5766
				5767
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5768	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5769	<tr><td colspan="4" class="doc" id="hasCanonicalType0"><pre>Matches QualTypes whose canonical type matches InnerMatcher.
				5770
				5771	Given:
				5772	typedef int &int_ref;
				5773	int a;
				5774	int_ref b = a;
				5775
				5776	varDecl(hasType(qualType(referenceType()))))) will not match the
				5777	declaration of b but varDecl(hasType(qualType(hasCanonicalType(referenceType())))))) does.
				5778	</pre></td></tr>
				5779
				5780
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5781	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5782	<tr><td colspan="4" class="doc" id="hasDeclaration6"><pre>Matches a node if the declaration associated with that node
				5783	matches the given matcher.
				5784
				5785	The associated declaration is:
				5786	- for type nodes, the declaration of the underlying type
				5787	- for CallExpr, the declaration of the callee
				5788	- for MemberExpr, the declaration of the referenced member
				5789	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	5790	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5791
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5792	For type nodes, hasDeclaration will generally match the declaration of the
				5793	sugared type. Given
				5794	class X {};
				5795	typedef X Y;
				5796	Y y;
				5797	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				5798	typedefDecl. A common use case is to match the underlying, desugared type.
				5799	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				5800	varDecl(hasType(hasUnqualifiedDesugaredType(
				5801	recordType(hasDeclaration(decl())))))
				5802	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5803
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	5804	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				5805	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				5806	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>>,
				5807	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>>,
				5808	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>>,
				5809	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>>,
				5810	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5811	</pre></td></tr>
				5812
				5813
Aaron Ballman	ba8dbbe	2016-06-06 18:52:17 +0000	[diff] [blame]	5814	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>></td><td class="name" onclick="toggle('ignoringParens0')"><a name="ignoringParens0Anchor">ignoringParens</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr>
				5815	<tr><td colspan="4" class="doc" id="ignoringParens0"><pre>Matches types that match InnerMatcher after any parens are stripped.
				5816
				5817	Given
				5818	void (*fp)(void);
				5819	The matcher
				5820	varDecl(hasType(pointerType(pointee(ignoringParens(functionType())))))
				5821	would match the declaration for fp.
				5822	</pre></td></tr>
				5823
				5824
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5825	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5826	<tr><td colspan="4" class="doc" id="pointsTo1"><pre>Overloaded to match the pointee type's declaration.
				5827	</pre></td></tr>
				5828
				5829
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5830	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5831	<tr><td colspan="4" class="doc" id="pointsTo0"><pre>Matches if the matched type is a pointer type and the pointee type
				5832	matches the specified matcher.
				5833
				5834	Example matches y->x()
				5835	(matcher = cxxMemberCallExpr(on(hasType(pointsTo
				5836	cxxRecordDecl(hasName("Y")))))))
				5837	class Y { public: void x(); };
				5838	void z() { Y *y; y->x(); }
				5839	</pre></td></tr>
				5840
				5841
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5842	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5843	<tr><td colspan="4" class="doc" id="references1"><pre>Overloaded to match the referenced type's declaration.
				5844	</pre></td></tr>
				5845
				5846
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5847	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5848	<tr><td colspan="4" class="doc" id="references0"><pre>Matches if the matched type is a reference type and the referenced
				5849	type matches the specified matcher.
				5850
				5851	Example matches X &x and const X &y
				5852	(matcher = varDecl(hasType(references(cxxRecordDecl(hasName("X"))))))
				5853	class X {
				5854	void a(X b) {
				5855	X &x = b;
				5856	const X &y = b;
				5857	}
				5858	};
				5859	</pre></td></tr>
				5860
				5861
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5862	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5863	<tr><td colspan="4" class="doc" id="hasDeclaration5"><pre>Matches a node if the declaration associated with that node
				5864	matches the given matcher.
				5865
				5866	The associated declaration is:
				5867	- for type nodes, the declaration of the underlying type
				5868	- for CallExpr, the declaration of the callee
				5869	- for MemberExpr, the declaration of the referenced member
				5870	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	5871	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5872
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5873	For type nodes, hasDeclaration will generally match the declaration of the
				5874	sugared type. Given
				5875	class X {};
				5876	typedef X Y;
				5877	Y y;
				5878	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				5879	typedefDecl. A common use case is to match the underlying, desugared type.
				5880	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				5881	varDecl(hasType(hasUnqualifiedDesugaredType(
				5882	recordType(hasDeclaration(decl())))))
				5883	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5884
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	5885	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				5886	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				5887	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>>,
				5888	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>>,
				5889	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>>,
				5890	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>>,
				5891	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5892	</pre></td></tr>
				5893
				5894
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5895	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5896	<tr><td colspan="4" class="doc" id="pointeeLoc3"><pre>Narrows PointerType (and similar) matchers to those where the
				5897	pointee matches a given matcher.
				5898
				5899	Given
				5900	int *a;
				5901	int const *b;
				5902	float const *f;
				5903	pointerType(pointee(isConstQualified(), isInteger()))
				5904	matches "int const *b"
				5905
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5906	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>>,
				5907	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5908	</pre></td></tr>
				5909
				5910
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5911	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5912	<tr><td colspan="4" class="doc" id="pointee3"><pre>Narrows PointerType (and similar) matchers to those where the
				5913	pointee matches a given matcher.
				5914
				5915	Given
				5916	int *a;
				5917	int const *b;
				5918	float const *f;
				5919	pointerType(pointee(isConstQualified(), isInteger()))
				5920	matches "int const *b"
				5921
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5922	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>>,
				5923	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5924	</pre></td></tr>
				5925
				5926
Alexander Kornienko	976921d	2016-03-22 11:03:03 +0000	[diff] [blame]	5927	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ReturnStmt.html">ReturnStmt</a>></td><td class="name" onclick="toggle('hasReturnValue0')"><a name="hasReturnValue0Anchor">hasReturnValue</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr>
				5928	<tr><td colspan="4" class="doc" id="hasReturnValue0"><pre>Matches the return value expression of a return statement
				5929
				5930	Given
				5931	return a + b;
				5932	hasReturnValue(binaryOperator())
				5933	matches 'return a + b'
				5934	with binaryOperator()
				5935	matching 'a + b'
				5936	</pre></td></tr>
				5937
				5938
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	5939	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1StmtExpr.html">StmtExpr</a>></td><td class="name" onclick="toggle('hasAnySubstatement1')"><a name="hasAnySubstatement1Anchor">hasAnySubstatement</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>> InnerMatcher</td></tr>
				5940	<tr><td colspan="4" class="doc" id="hasAnySubstatement1"><pre>Matches compound statements where at least one substatement matches
				5941	a given matcher. Also matches StmtExprs that have CompoundStmt as children.
				5942
				5943	Given
				5944	{ {}; 1+2; }
				5945	hasAnySubstatement(compoundStmt())
				5946	matches '{ {}; 1+2; }'
				5947	with compoundStmt()
				5948	matching '{}'
				5949	</pre></td></tr>
				5950
				5951
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5952	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnaryExprOrTypeTraitExpr.html">UnaryExprOrTypeTraitExpr</a>> InnerMatcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5953	<tr><td colspan="4" class="doc" id="alignOfExpr0"><pre>Same as unaryExprOrTypeTraitExpr, but only matching
				5954	alignof.
				5955	</pre></td></tr>
				5956
				5957
Gabor Horvath	1b3f8db	2016-05-04 11:59:39 +0000	[diff] [blame]	5958	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('forFunction0')"><a name="forFunction0Anchor">forFunction</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>> InnerMatcher</td></tr>
Malcolm Parsons	def8f90	2017-01-20 09:54:26 +0000	[diff] [blame]	5959	<tr><td colspan="4" class="doc" id="forFunction0"><pre>Matches declaration of the function the statement belongs to
Gabor Horvath	1b3f8db	2016-05-04 11:59:39 +0000	[diff] [blame]	5960
				5961	Given:
				5962	F& operator=(const F& o) {
				5963	std::copy_if(o.begin(), o.end(), begin(), [](V v) { return v > 0; });
				5964	return *this;
				5965	}
				5966	returnStmt(forFunction(hasName("operator=")))
				5967	matches 'return *this'
				5968	but does match 'return > 0'
				5969	</pre></td></tr>
				5970
				5971
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5972	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnaryExprOrTypeTraitExpr.html">UnaryExprOrTypeTraitExpr</a>> InnerMatcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5973	<tr><td colspan="4" class="doc" id="sizeOfExpr0"><pre>Same as unaryExprOrTypeTraitExpr, but only matching
				5974	sizeof.
				5975	</pre></td></tr>
				5976
				5977
Malcolm Parsons	77f039b	2016-12-08 11:46:22 +0000	[diff] [blame]	5978	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1SubstTemplateTypeParmType.html">SubstTemplateTypeParmType</a>></td><td class="name" onclick="toggle('hasReplacementType0')"><a name="hasReplacementType0Anchor">hasReplacementType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td></tr>
				5979	<tr><td colspan="4" class="doc" id="hasReplacementType0"><pre>Matches template type parameter substitutions that have a replacement
				5980	type that matches the provided matcher.
				5981
				5982	Given
				5983	template <typename T>
				5984	double F(T t);
				5985	int i;
				5986	double j = F(i);
				5987
				5988	substTemplateTypeParmType(hasReplacementType(type())) matches int
				5989	</pre></td></tr>
				5990
				5991
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5992	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5993	<tr><td colspan="4" class="doc" id="forEachSwitchCase0"><pre>Matches each case or default statement belonging to the given switch
				5994	statement. This matcher may produce multiple matches.
				5995
				5996	Given
				5997	switch (1) { case 1: case 2: default: switch (2) { case 3: case 4: ; } }
				5998	switchStmt(forEachSwitchCase(caseStmt().bind("c"))).bind("s")
				5999	matches four times, with "c" binding each of "case 1:", "case 2:",
				6000	"case 3:" and "case 4:", and "s" respectively binding "switch (1)",
				6001	"switch (1)", "switch (2)" and "switch (2)".
				6002	</pre></td></tr>
				6003
				6004
Etienne Bergeron	5500f95	2016-05-30 15:25:25 +0000	[diff] [blame]	6005	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1SwitchStmt.html">SwitchStmt</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>
				6006	<tr><td colspan="4" class="doc" id="hasCondition4"><pre>Matches the condition expression of an if statement, for loop,
				6007	switch statement or conditional operator.
				6008
				6009	Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true))))
				6010	if (true) {}
				6011	</pre></td></tr>
				6012
				6013
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6014	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6015	<tr><td colspan="4" class="doc" id="hasDeclaration4"><pre>Matches a node if the declaration associated with that node
				6016	matches the given matcher.
				6017
				6018	The associated declaration is:
				6019	- for type nodes, the declaration of the underlying type
				6020	- for CallExpr, the declaration of the callee
				6021	- for MemberExpr, the declaration of the referenced member
				6022	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	6023	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6024
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6025	For type nodes, hasDeclaration will generally match the declaration of the
				6026	sugared type. Given
				6027	class X {};
				6028	typedef X Y;
				6029	Y y;
				6030	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				6031	typedefDecl. A common use case is to match the underlying, desugared type.
				6032	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				6033	varDecl(hasType(hasUnqualifiedDesugaredType(
				6034	recordType(hasDeclaration(decl())))))
				6035	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6036
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	6037	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				6038	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				6039	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>>,
				6040	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>>,
				6041	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>>,
				6042	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>>,
				6043	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6044	</pre></td></tr>
				6045
				6046
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6047	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6048	<tr><td colspan="4" class="doc" id="isExpr0"><pre>Matches a sugar TemplateArgument that refers to a certain expression.
				6049
				6050	Given
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	6051	struct B { int next; };
				6052	template<int(B::*next_ptr)> struct A {};
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6053	A<&B::next> a;
				6054	templateSpecializationType(hasAnyTemplateArgument(
				6055	isExpr(hasDescendant(declRefExpr(to(fieldDecl(hasName("next"))))))))
				6056	matches the specialization A<&B::next> with fieldDecl(...) matching
				6057	B::next
				6058	</pre></td></tr>
				6059
				6060
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6061	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6062	<tr><td colspan="4" class="doc" id="refersToDeclaration0"><pre>Matches a canonical TemplateArgument that refers to a certain
				6063	declaration.
				6064
				6065	Given
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	6066	struct B { int next; };
				6067	template<int(B::*next_ptr)> struct A {};
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6068	A<&B::next> a;
				6069	classTemplateSpecializationDecl(hasAnyTemplateArgument(
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	6070	refersToDeclaration(fieldDecl(hasName("next")))))
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6071	matches the specialization A<&B::next> with fieldDecl(...) matching
				6072	B::next
				6073	</pre></td></tr>
				6074
				6075
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6076	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6077	<tr><td colspan="4" class="doc" id="refersToIntegralType0"><pre>Matches a TemplateArgument that referes to an integral type.
				6078
				6079	Given
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	6080	template<int T> struct C {};
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6081	C<42> c;
				6082	classTemplateSpecializationDecl(
				6083	hasAnyTemplateArgument(refersToIntegralType(asString("int"))))
				6084	matches the implicit instantiation of C in C<42>.
				6085	</pre></td></tr>
				6086
				6087
Haojian Wu	b33b02e	2016-07-29 15:45:11 +0000	[diff] [blame]	6088	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateArgument.html">TemplateArgument</a>></td><td class="name" onclick="toggle('refersToTemplate0')"><a name="refersToTemplate0Anchor">refersToTemplate</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TemplateName.html">TemplateName</a>> InnerMatcher</td></tr>
				6089	<tr><td colspan="4" class="doc" id="refersToTemplate0"><pre>Matches a TemplateArgument that refers to a certain template.
				6090
				6091	Given
				6092	template<template <typename> class S> class X {};
				6093	template<typename T> class Y {};"
				6094	X<Y> xi;
				6095	classTemplateSpecializationDecl(hasAnyTemplateArgument(
				6096	refersToTemplate(templateName())))
				6097	matches the specialization X<Y>
				6098	</pre></td></tr>
				6099
				6100
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6101	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6102	<tr><td colspan="4" class="doc" id="refersToType0"><pre>Matches a TemplateArgument that refers to a certain type.
				6103
				6104	Given
				6105	struct X {};
				6106	template<typename T> struct A {};
				6107	A<X> a;
				6108	classTemplateSpecializationDecl(hasAnyTemplateArgument(
				6109	refersToType(class(hasName("X")))))
				6110	matches the specialization A<X>
				6111	</pre></td></tr>
				6112
				6113
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6114	<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>
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	6115	<tr><td colspan="4" class="doc" id="hasAnyTemplateArgument1"><pre>Matches classTemplateSpecializations, templateSpecializationType and
				6116	functionDecl that have at least one TemplateArgument matching the given
				6117	InnerMatcher.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6118
				6119	Given
				6120	template<typename T> class A {};
				6121	template<> class A<double> {};
				6122	A<int> a;
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	6123
Haojian Wu	99e39a7	2016-07-29 17:30:13 +0000	[diff] [blame]	6124	template<typename T> f() {};
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	6125	void func() { f<int>(); };
				6126
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6127	classTemplateSpecializationDecl(hasAnyTemplateArgument(
				6128	refersToType(asString("int"))))
				6129	matches the specialization A<int>
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	6130
				6131	functionDecl(hasAnyTemplateArgument(refersToType(asString("int"))))
				6132	matches the specialization f<int>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6133	</pre></td></tr>
				6134
				6135
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6136	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6137	<tr><td colspan="4" class="doc" id="hasDeclaration3"><pre>Matches a node if the declaration associated with that node
				6138	matches the given matcher.
				6139
				6140	The associated declaration is:
				6141	- for type nodes, the declaration of the underlying type
				6142	- for CallExpr, the declaration of the callee
				6143	- for MemberExpr, the declaration of the referenced member
				6144	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	6145	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6146
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6147	For type nodes, hasDeclaration will generally match the declaration of the
				6148	sugared type. Given
				6149	class X {};
				6150	typedef X Y;
				6151	Y y;
				6152	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				6153	typedefDecl. A common use case is to match the underlying, desugared type.
				6154	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				6155	varDecl(hasType(hasUnqualifiedDesugaredType(
				6156	recordType(hasDeclaration(decl())))))
				6157	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6158
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	6159	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				6160	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				6161	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>>,
				6162	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>>,
				6163	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>>,
				6164	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>>,
				6165	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6166	</pre></td></tr>
				6167
				6168
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6169	<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>
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	6170	<tr><td colspan="4" class="doc" id="hasTemplateArgument1"><pre>Matches classTemplateSpecializations, templateSpecializationType and
				6171	functionDecl where the n'th TemplateArgument matches the given InnerMatcher.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6172
				6173	Given
				6174	template<typename T, typename U> class A {};
				6175	A<bool, int> b;
				6176	A<int, bool> c;
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	6177
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	6178	template<typename T> void f() {}
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	6179	void func() { f<int>(); };
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6180	classTemplateSpecializationDecl(hasTemplateArgument(
				6181	1, refersToType(asString("int"))))
				6182	matches the specialization A<bool, int>
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	6183
				6184	functionDecl(hasTemplateArgument(0, refersToType(asString("int"))))
				6185	matches the specialization f<int>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6186	</pre></td></tr>
				6187
				6188
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6189	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6190	<tr><td colspan="4" class="doc" id="hasDeclaration2"><pre>Matches a node if the declaration associated with that node
				6191	matches the given matcher.
				6192
				6193	The associated declaration is:
				6194	- for type nodes, the declaration of the underlying type
				6195	- for CallExpr, the declaration of the callee
				6196	- for MemberExpr, the declaration of the referenced member
				6197	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	6198	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6199
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6200	For type nodes, hasDeclaration will generally match the declaration of the
				6201	sugared type. Given
				6202	class X {};
				6203	typedef X Y;
				6204	Y y;
				6205	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				6206	typedefDecl. A common use case is to match the underlying, desugared type.
				6207	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				6208	varDecl(hasType(hasUnqualifiedDesugaredType(
				6209	recordType(hasDeclaration(decl())))))
				6210	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6211
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	6212	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				6213	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				6214	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>>,
				6215	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>>,
				6216	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>>,
				6217	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>>,
				6218	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6219	</pre></td></tr>
				6220
				6221
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6222	<tr><td>Matcher<T></td><td class="name" onclick="toggle('findAll0')"><a name="findAll0Anchor">findAll</a></td><td>const Matcher<T> Matcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6223	<tr><td colspan="4" class="doc" id="findAll0"><pre>Matches if the node or any descendant matches.
				6224
				6225	Generates results for each match.
				6226
				6227	For example, in:
				6228	class A { class B {}; class C {}; };
				6229	The matcher:
				6230	cxxRecordDecl(hasName("::A"),
				6231	findAll(cxxRecordDecl(isDefinition()).bind("m")))
				6232	will generate results for A, B and C.
				6233
				6234	Usable as: Any Matcher
				6235	</pre></td></tr>
				6236
				6237
Aaron Ballman	66eb58a	2016-04-14 16:05:45 +0000	[diff] [blame]	6238	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefNameDecl.html">TypedefNameDecl</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>
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	6239	<tr><td colspan="4" class="doc" id="hasType1"><pre>Matches if the expression's or declaration's type matches a type
				6240	matcher.
				6241
				6242	Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X")))))
				6243	and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X")))))
				6244	and U (matcher = typedefDecl(hasType(asString("int")))
				6245	class X {};
				6246	void y(X &x) { x; X z; }
				6247	typedef int U;
				6248	</pre></td></tr>
				6249
				6250
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6251	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6252	<tr><td colspan="4" class="doc" id="hasDeclaration1"><pre>Matches a node if the declaration associated with that node
				6253	matches the given matcher.
				6254
				6255	The associated declaration is:
				6256	- for type nodes, the declaration of the underlying type
				6257	- for CallExpr, the declaration of the callee
				6258	- for MemberExpr, the declaration of the referenced member
				6259	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	6260	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6261
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6262	For type nodes, hasDeclaration will generally match the declaration of the
				6263	sugared type. Given
				6264	class X {};
				6265	typedef X Y;
				6266	Y y;
				6267	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				6268	typedefDecl. A common use case is to match the underlying, desugared type.
				6269	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				6270	varDecl(hasType(hasUnqualifiedDesugaredType(
				6271	recordType(hasDeclaration(decl())))))
				6272	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6273
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	6274	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				6275	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				6276	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>>,
				6277	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>>,
				6278	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>>,
				6279	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>>,
				6280	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
				6281	</pre></td></tr>
				6282
				6283
				6284	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('hasUnqualifiedDesugaredType0')"><a name="hasUnqualifiedDesugaredType0Anchor">hasUnqualifiedDesugaredType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>> InnerMatcher</td></tr>
				6285	<tr><td colspan="4" class="doc" id="hasUnqualifiedDesugaredType0"><pre>Matches if the matched type matches the unqualified desugared
				6286	type of the matched node.
				6287
				6288	For example, in:
				6289	class A {};
				6290	using B = A;
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6291	The matcher type(hasUnqualifeidDesugaredType(recordType())) matches
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	6292	both B and A.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6293	</pre></td></tr>
				6294
				6295
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6296	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6297	<tr><td colspan="4" class="doc" id="hasArgumentOfType0"><pre>Matches unary expressions that have a specific type of argument.
				6298
				6299	Given
				6300	int a, c; float b; int s = sizeof(a) + sizeof(b) + alignof(c);
				6301	unaryExprOrTypeTraitExpr(hasArgumentOfType(asString("int"))
				6302	matches sizeof(a) and alignof(c)
				6303	</pre></td></tr>
				6304
				6305
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6306	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6307	<tr><td colspan="4" class="doc" id="hasUnaryOperand0"><pre>Matches if the operand of a unary operator matches.
				6308
				6309	Example matches true (matcher = hasUnaryOperand(
				6310	cxxBoolLiteral(equals(true))))
				6311	!true
				6312	</pre></td></tr>
				6313
				6314
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6315	<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>const Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6316	<tr><td colspan="4" class="doc" id="hasDeclaration0"><pre>Matches a node if the declaration associated with that node
				6317	matches the given matcher.
				6318
				6319	The associated declaration is:
				6320	- for type nodes, the declaration of the underlying type
				6321	- for CallExpr, the declaration of the callee
				6322	- for MemberExpr, the declaration of the referenced member
				6323	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	6324	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6325
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6326	For type nodes, hasDeclaration will generally match the declaration of the
				6327	sugared type. Given
				6328	class X {};
				6329	typedef X Y;
				6330	Y y;
				6331	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				6332	typedefDecl. A common use case is to match the underlying, desugared type.
				6333	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				6334	varDecl(hasType(hasUnqualifiedDesugaredType(
				6335	recordType(hasDeclaration(decl())))))
				6336	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6337
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	6338	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CallExpr.html">CallExpr</a>>,
				6339	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXConstructExpr.html">CXXConstructExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXNewExpr.html">CXXNewExpr</a>>, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DeclRefExpr.html">DeclRefExpr</a>>,
				6340	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>>,
				6341	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>>,
				6342	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>>,
				6343	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>>,
				6344	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6345	</pre></td></tr>
				6346
				6347
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6348	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6349	<tr><td colspan="4" class="doc" id="hasAnyUsingShadowDecl0"><pre>Matches any using shadow declaration.
				6350
				6351	Given
				6352	namespace X { void b(); }
				6353	using X::b;
				6354	usingDecl(hasAnyUsingShadowDecl(hasName("b"))))
				6355	matches using X::b </pre></td></tr>
				6356
				6357
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6358	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6359	<tr><td colspan="4" class="doc" id="hasTargetDecl0"><pre>Matches a using shadow declaration where the target declaration is
				6360	matched by the given matcher.
				6361
				6362	Given
				6363	namespace X { int a; void b(); }
				6364	using X::a;
				6365	using X::b;
				6366	usingDecl(hasAnyUsingShadowDecl(hasTargetDecl(functionDecl())))
				6367	matches using X::b but not using X::a </pre></td></tr>
				6368
				6369
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	6370	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ValueDecl.html">ValueDecl</a>></td><td class="name" onclick="toggle('hasType4')"><a name="hasType4Anchor">hasType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
				6371	<tr><td colspan="4" class="doc" id="hasType4"><pre>Overloaded to match the declaration of the expression's or value
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6372	declaration's type.
				6373
				6374	In case of a value declaration (for example a variable declaration),
				6375	this resolves one layer of indirection. For example, in the value
				6376	declaration "X x;", cxxRecordDecl(hasName("X")) matches the declaration of
				6377	X, while varDecl(hasType(cxxRecordDecl(hasName("X")))) matches the
				6378	declaration of x.
				6379
				6380	Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X")))))
				6381	and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X")))))
				6382	class X {};
				6383	void y(X &x) { x; X z; }
				6384
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6385	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>>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6386	</pre></td></tr>
				6387
				6388
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	6389	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ValueDecl.html">ValueDecl</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_1QualType.html">QualType</a>> InnerMatcher</td></tr>
				6390	<tr><td colspan="4" class="doc" id="hasType2"><pre>Matches if the expression's or declaration's type matches a type
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6391	matcher.
				6392
				6393	Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X")))))
				6394	and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X")))))
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	6395	and U (matcher = typedefDecl(hasType(asString("int")))
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6396	class X {};
				6397	void y(X &x) { x; X z; }
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	6398	typedef int U;
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6399	</pre></td></tr>
				6400
				6401
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6402	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6403	<tr><td colspan="4" class="doc" id="hasInitializer0"><pre>Matches a variable declaration that has an initializer expression
				6404	that matches the given matcher.
				6405
				6406	Example matches x (matcher = varDecl(hasInitializer(callExpr())))
				6407	bool y() { return true; }
				6408	bool x = y();
				6409	</pre></td></tr>
				6410
				6411
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6412	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6413	<tr><td colspan="4" class="doc" id="hasSizeExpr0"><pre>Matches VariableArrayType nodes that have a specific size
				6414	expression.
				6415
				6416	Given
				6417	void f(int b) {
				6418	int a[b];
				6419	}
				6420	variableArrayType(hasSizeExpr(ignoringImpCasts(declRefExpr(to(
				6421	varDecl(hasName("b")))))))
				6422	matches "int a[b]"
				6423	</pre></td></tr>
				6424
				6425
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6426	<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>
Aaron Ballman	2b6963f	2016-01-20 16:26:48 +0000	[diff] [blame]	6427	<tr><td colspan="4" class="doc" id="hasBody2"><pre>Matches a 'for', 'while', 'do while' statement or a function
				6428	definition that has a given body.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6429
				6430	Given
				6431	for (;;) {}
				6432	hasBody(compoundStmt())
				6433	matches 'for (;;) {}'
				6434	with compoundStmt()
				6435	matching '{}'
				6436	</pre></td></tr>
				6437
				6438
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6439	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6440	<tr><td colspan="4" class="doc" id="hasCondition2"><pre>Matches the condition expression of an if statement, for loop,
Etienne Bergeron	5500f95	2016-05-30 15:25:25 +0000	[diff] [blame]	6441	switch statement or conditional operator.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6442
				6443	Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true))))
				6444	if (true) {}
				6445	</pre></td></tr>
				6446
				6447
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6448	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6449	<tr><td colspan="4" class="doc" id="loc1"><pre>Matches NestedNameSpecifierLocs for which the given inner
				6450	NestedNameSpecifier-matcher matches.
				6451	</pre></td></tr>
				6452
				6453
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6454	<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>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6455	<tr><td colspan="4" class="doc" id="loc0"><pre>Matches TypeLocs for which the given inner
				6456	QualType-matcher matches.
				6457	</pre></td></tr>
				6458
Benjamin Kramer	7d0cc23	2015-11-20 07:57:46 +0000	[diff] [blame]	6459	<!--END_TRAVERSAL_MATCHERS -->
				6460	</table>
				6461
				6462	</div>
				6463	</body>
				6464	</html>
				6465
				6466