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

blob: e8335d95e1ba52fb82af380c9b8f4c6ea57fa58c [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
George Karpenkov	b4c0cbd	2018-05-16 22:47:03 +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('blockDecl0')"><a name="blockDecl0Anchor">blockDecl</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BlockDecl.html">BlockDecl</a>>...</td></tr>
				128	<tr><td colspan="4" class="doc" id="blockDecl0"><pre>Matches block declarations.
				129
				130	Example matches the declaration of the nameless block printing an input
				131	integer.
				132
				133	myFunc(^(int p) {
				134	printf("%d", p);
				135	})
				136	</pre></td></tr>
				137
				138
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	139	<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]	140	<tr><td colspan="4" class="doc" id="classTemplateDecl0"><pre>Matches C++ class template declarations.
				141
				142	Example matches Z
				143	template<class T> class Z {};
				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('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]	148	<tr><td colspan="4" class="doc" id="classTemplateSpecializationDecl0"><pre>Matches C++ class template specializations.
				149
				150	Given
				151	template<typename T> class A {};
				152	template<> class A<double> {};
				153	A<int> a;
				154	classTemplateSpecializationDecl()
				155	matches the specializations A<int> and A<double>
				156	</pre></td></tr>
				157
				158
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	159	<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]	160	<tr><td colspan="4" class="doc" id="cxxConstructorDecl0"><pre>Matches C++ constructor declarations.
				161
				162	Example matches Foo::Foo() and Foo::Foo(int)
				163	class Foo {
				164	public:
				165	Foo();
				166	Foo(int);
				167	int DoSomething();
				168	};
				169	</pre></td></tr>
				170
				171
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	172	<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]	173	<tr><td colspan="4" class="doc" id="cxxConversionDecl0"><pre>Matches conversion operator declarations.
				174
				175	Example matches the operator.
				176	class X { operator int() const; };
				177	</pre></td></tr>
				178
				179
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	180	<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]	181	<tr><td colspan="4" class="doc" id="cxxDestructorDecl0"><pre>Matches explicit C++ destructor declarations.
				182
				183	Example matches Foo::~Foo()
				184	class Foo {
				185	public:
				186	virtual ~Foo();
				187	};
				188	</pre></td></tr>
				189
				190
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	191	<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]	192	<tr><td colspan="4" class="doc" id="cxxMethodDecl0"><pre>Matches method declarations.
				193
				194	Example matches y
				195	class X { void y(); };
				196	</pre></td></tr>
				197
				198
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	199	<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]	200	<tr><td colspan="4" class="doc" id="cxxRecordDecl0"><pre>Matches C++ class declarations.
				201
				202	Example matches X, Z
				203	class X;
				204	template<class T> class Z {};
				205	</pre></td></tr>
				206
				207
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	208	<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]	209	<tr><td colspan="4" class="doc" id="decl0"><pre>Matches declarations.
				210
				211	Examples matches X, C, and the friend declaration inside C;
				212	void X();
				213	class C {
				214	friend X;
				215	};
				216	</pre></td></tr>
				217
				218
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	219	<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]	220	<tr><td colspan="4" class="doc" id="declaratorDecl0"><pre>Matches declarator declarations (field, variable, function
				221	and non-type template parameter declarations).
				222
				223	Given
				224	class X { int y; };
				225	declaratorDecl()
				226	matches int y.
				227	</pre></td></tr>
				228
				229
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	230	<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]	231	<tr><td colspan="4" class="doc" id="enumConstantDecl0"><pre>Matches enum constants.
				232
				233	Example matches A, B, C
				234	enum X {
				235	A, B, C
				236	};
				237	</pre></td></tr>
				238
				239
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	240	<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]	241	<tr><td colspan="4" class="doc" id="enumDecl0"><pre>Matches enum declarations.
				242
				243	Example matches X
				244	enum X {
				245	A, B, C
				246	};
				247	</pre></td></tr>
				248
				249
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	250	<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]	251	<tr><td colspan="4" class="doc" id="fieldDecl0"><pre>Matches field declarations.
				252
				253	Given
				254	class X { int m; };
				255	fieldDecl()
				256	matches 'm'.
				257	</pre></td></tr>
				258
				259
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	260	<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]	261	<tr><td colspan="4" class="doc" id="friendDecl0"><pre>Matches friend declarations.
				262
				263	Given
				264	class X { friend void foo(); };
				265	friendDecl()
				266	matches 'friend void foo()'.
				267	</pre></td></tr>
				268
				269
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	270	<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]	271	<tr><td colspan="4" class="doc" id="functionDecl0"><pre>Matches function declarations.
				272
				273	Example matches f
				274	void f();
				275	</pre></td></tr>
				276
				277
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	278	<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]	279	<tr><td colspan="4" class="doc" id="functionTemplateDecl0"><pre>Matches C++ function template declarations.
				280
				281	Example matches f
				282	template<class T> void f(T t) {}
				283	</pre></td></tr>
				284
				285
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	286	<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>
				287	<tr><td colspan="4" class="doc" id="labelDecl0"><pre>Matches a declaration of label.
				288
				289	Given
				290	goto FOO;
				291	FOO: bar();
				292	labelDecl()
				293	matches 'FOO:'
				294	</pre></td></tr>
				295
				296
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	297	<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]	298	<tr><td colspan="4" class="doc" id="linkageSpecDecl0"><pre>Matches a declaration of a linkage specification.
				299
				300	Given
				301	extern "C" {}
				302	linkageSpecDecl()
				303	matches "extern "C" {}"
				304	</pre></td></tr>
				305
				306
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	307	<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]	308	<tr><td colspan="4" class="doc" id="namedDecl0"><pre>Matches a declaration of anything that could have a name.
				309
				310	Example matches X, S, the anonymous union type, i, and U;
				311	typedef int X;
				312	struct S {
				313	union {
				314	int i;
				315	} U;
				316	};
				317	</pre></td></tr>
				318
				319
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	320	<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]	321	<tr><td colspan="4" class="doc" id="namespaceAliasDecl0"><pre>Matches a declaration of a namespace alias.
				322
				323	Given
				324	namespace test {}
				325	namespace alias = ::test;
				326	namespaceAliasDecl()
				327	matches "namespace alias" but not "namespace test"
				328	</pre></td></tr>
				329
				330
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	331	<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]	332	<tr><td colspan="4" class="doc" id="namespaceDecl0"><pre>Matches a declaration of a namespace.
				333
				334	Given
				335	namespace {}
				336	namespace test {}
				337	namespaceDecl()
				338	matches "namespace {}" and "namespace test {}"
				339	</pre></td></tr>
				340
				341
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	342	<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]	343	<tr><td colspan="4" class="doc" id="nonTypeTemplateParmDecl0"><pre>Matches non-type template parameter declarations.
				344
				345	Given
				346	template <typename T, int N> struct C {};
				347	nonTypeTemplateParmDecl()
				348	matches 'N', but not 'T'.
				349	</pre></td></tr>
				350
				351
Aaron Ballman	9fd6ee6	2017-03-15 20:14:25 +0000	[diff] [blame]	352	<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>
				353	<tr><td colspan="4" class="doc" id="objcCategoryDecl0"><pre>Matches Objective-C category declarations.
				354
				355	Example matches Foo (Additions)
				356	@interface Foo (Additions)
				357	@end
				358	</pre></td></tr>
				359
				360
Dave Lee	55540a0	2017-10-26 15:53:37 +0000	[diff] [blame]	361	<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>
				362	<tr><td colspan="4" class="doc" id="objcCategoryImplDecl0"><pre>Matches Objective-C category definitions.
				363
				364	Example matches Foo (Additions)
				365	@implementation Foo (Additions)
				366	@end
				367	</pre></td></tr>
				368
				369
Dave Lee	e6d362c	2017-09-10 21:00:15 +0000	[diff] [blame]	370	<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>
				371	<tr><td colspan="4" class="doc" id="objcImplementationDecl0"><pre>Matches Objective-C implementation declarations.
				372
				373	Example matches Foo
				374	@implementation Foo
				375	@end
				376	</pre></td></tr>
				377
				378
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	379	<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]	380	<tr><td colspan="4" class="doc" id="objcInterfaceDecl0"><pre>Matches Objective-C interface declarations.
				381
				382	Example matches Foo
				383	@interface Foo
				384	@end
				385	</pre></td></tr>
				386
				387
Aaron Ballman	9fd6ee6	2017-03-15 20:14:25 +0000	[diff] [blame]	388	<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>
				389	<tr><td colspan="4" class="doc" id="objcIvarDecl0"><pre>Matches Objective-C instance variable declarations.
				390
				391	Example matches _enabled
				392	@implementation Foo {
				393	BOOL _enabled;
				394	}
				395	@end
				396	</pre></td></tr>
				397
				398
				399	<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>
				400	<tr><td colspan="4" class="doc" id="objcMethodDecl0"><pre>Matches Objective-C method declarations.
				401
				402	Example matches both declaration and definition of -[Foo method]
				403	@interface Foo
				404	- (void)method;
				405	@end
				406
				407	@implementation Foo
				408	- (void)method {}
				409	@end
				410	</pre></td></tr>
				411
				412
				413	<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>
				414	<tr><td colspan="4" class="doc" id="objcPropertyDecl0"><pre>Matches Objective-C property declarations.
				415
				416	Example matches enabled
				417	@interface Foo
				418	@property BOOL enabled;
				419	@end
				420	</pre></td></tr>
				421
				422
				423	<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>
				424	<tr><td colspan="4" class="doc" id="objcProtocolDecl0"><pre>Matches Objective-C protocol declarations.
				425
				426	Example matches FooDelegate
				427	@protocol FooDelegate
				428	@end
				429	</pre></td></tr>
				430
				431
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	432	<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]	433	<tr><td colspan="4" class="doc" id="parmVarDecl0"><pre>Matches parameter variable declarations.
				434
				435	Given
				436	void f(int x);
				437	parmVarDecl()
				438	matches int x.
				439	</pre></td></tr>
				440
				441
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	442	<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]	443	<tr><td colspan="4" class="doc" id="recordDecl0"><pre>Matches class, struct, and union declarations.
				444
				445	Example matches X, Z, U, and S
				446	class X;
				447	template<class T> class Z {};
				448	struct S {};
				449	union U {};
				450	</pre></td></tr>
				451
				452
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	453	<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]	454	<tr><td colspan="4" class="doc" id="staticAssertDecl0"><pre>Matches a C++ static_assert declaration.
				455
				456	Example:
				457	staticAssertExpr()
				458	matches
				459	static_assert(sizeof(S) == sizeof(int))
				460	in
				461	struct S {
				462	int x;
				463	};
				464	static_assert(sizeof(S) == sizeof(int));
				465	</pre></td></tr>
				466
				467
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	468	<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]	469	<tr><td colspan="4" class="doc" id="templateTypeParmDecl0"><pre>Matches template type parameter declarations.
				470
				471	Given
				472	template <typename T, int N> struct C {};
				473	templateTypeParmDecl()
				474	matches 'T', but not 'N'.
				475	</pre></td></tr>
				476
				477
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	478	<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]	479	<tr><td colspan="4" class="doc" id="translationUnitDecl0"><pre>Matches the top declaration context.
				480
				481	Given
				482	int X;
				483	namespace NS {
				484	int Y;
				485	} namespace NS
				486	decl(hasDeclContext(translationUnitDecl()))
				487	matches "int X", but not "int Y".
				488	</pre></td></tr>
				489
				490
Aaron Ballman	66eb58a	2016-04-14 16:05:45 +0000	[diff] [blame]	491	<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>
				492	<tr><td colspan="4" class="doc" id="typeAliasDecl0"><pre>Matches type alias declarations.
				493
				494	Given
				495	typedef int X;
Samuel Benzaquen	a4076ea	2016-05-04 20:45:00 +0000	[diff] [blame]	496	using Y = int;
Aaron Ballman	66eb58a	2016-04-14 16:05:45 +0000	[diff] [blame]	497	typeAliasDecl()
				498	matches "using Y = int", but not "typedef int X"
				499	</pre></td></tr>
				500
				501
Eric Liu	285f804	2017-03-28 12:56:47 +0000	[diff] [blame]	502	<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>
				503	<tr><td colspan="4" class="doc" id="typeAliasTemplateDecl0"><pre>Matches type alias template declarations.
				504
				505	typeAliasTemplateDecl() matches
				506	template <typename T>
				507	using Y = X<T>;
				508	</pre></td></tr>
				509
				510
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	511	<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]	512	<tr><td colspan="4" class="doc" id="typedefDecl0"><pre>Matches typedef declarations.
				513
				514	Given
				515	typedef int X;
Samuel Benzaquen	a4076ea	2016-05-04 20:45:00 +0000	[diff] [blame]	516	using Y = int;
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	517	typedefDecl()
Aaron Ballman	66eb58a	2016-04-14 16:05:45 +0000	[diff] [blame]	518	matches "typedef int X", but not "using Y = int"
				519	</pre></td></tr>
				520
				521
				522	<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>
				523	<tr><td colspan="4" class="doc" id="typedefNameDecl0"><pre>Matches typedef name declarations.
				524
				525	Given
				526	typedef int X;
Samuel Benzaquen	a4076ea	2016-05-04 20:45:00 +0000	[diff] [blame]	527	using Y = int;
Aaron Ballman	66eb58a	2016-04-14 16:05:45 +0000	[diff] [blame]	528	typedefNameDecl()
				529	matches "typedef int X" and "using Y = int"
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	530	</pre></td></tr>
				531
				532
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	533	<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]	534	<tr><td colspan="4" class="doc" id="unresolvedUsingTypenameDecl0"><pre>Matches unresolved using value declarations that involve the
				535	typename.
				536
				537	Given
				538	template <typename T>
				539	struct Base { typedef T Foo; };
				540
				541	template<typename T>
				542	struct S : private Base<T> {
				543	using typename Base<T>::Foo;
				544	};
				545	unresolvedUsingTypenameDecl()
				546	matches using Base<T>::Foo </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('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]	550	<tr><td colspan="4" class="doc" id="unresolvedUsingValueDecl0"><pre>Matches unresolved using value declarations.
				551
				552	Given
				553	template<typename X>
				554	class C : private X {
				555	using X::x;
				556	};
				557	unresolvedUsingValueDecl()
				558	matches using X::x </pre></td></tr>
				559
				560
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	561	<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]	562	<tr><td colspan="4" class="doc" id="usingDecl0"><pre>Matches using declarations.
				563
				564	Given
				565	namespace X { int x; }
				566	using X::x;
				567	usingDecl()
				568	matches using X::x </pre></td></tr>
				569
				570
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	571	<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]	572	<tr><td colspan="4" class="doc" id="usingDirectiveDecl0"><pre>Matches using namespace declarations.
				573
				574	Given
				575	namespace X { int x; }
				576	using namespace X;
				577	usingDirectiveDecl()
				578	matches using namespace X </pre></td></tr>
				579
				580
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	581	<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]	582	<tr><td colspan="4" class="doc" id="valueDecl0"><pre>Matches any value declaration.
				583
				584	Example matches A, B, C and F
				585	enum X { A, B, C };
				586	void F();
				587	</pre></td></tr>
				588
				589
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	590	<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]	591	<tr><td colspan="4" class="doc" id="varDecl0"><pre>Matches variable declarations.
				592
				593	Note: this does not match declarations of member variables, which are
				594	"field" declarations in Clang parlance.
				595
				596	Example matches a
				597	int a;
				598	</pre></td></tr>
				599
				600
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	601	<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]	602	<tr><td colspan="4" class="doc" id="nestedNameSpecifierLoc0"><pre>Same as nestedNameSpecifier but matches NestedNameSpecifierLoc.
				603	</pre></td></tr>
				604
				605
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	606	<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]	607	<tr><td colspan="4" class="doc" id="nestedNameSpecifier0"><pre>Matches nested name specifiers.
				608
				609	Given
				610	namespace ns {
				611	struct A { static void f(); };
				612	void A::f() {}
				613	void g() { A::f(); }
				614	}
				615	ns::A a;
				616	nestedNameSpecifier()
				617	matches "ns::" and both "A::"
				618	</pre></td></tr>
				619
				620
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	621	<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]	622	<tr><td colspan="4" class="doc" id="qualType0"><pre>Matches QualTypes in the clang AST.
				623	</pre></td></tr>
				624
				625
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +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('addrLabelExpr0')"><a name="addrLabelExpr0Anchor">addrLabelExpr</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1AddrLabelExpr.html">AddrLabelExpr</a>>...</td></tr>
				627	<tr><td colspan="4" class="doc" id="addrLabelExpr0"><pre>Matches address of label statements (GNU extension).
				628
				629	Given
				630	FOO: bar();
				631	void *ptr = &&FOO;
				632	goto *bar;
				633	addrLabelExpr()
				634	matches '&&FOO'
				635	</pre></td></tr>
				636
				637
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	638	<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]	639	<tr><td colspan="4" class="doc" id="arraySubscriptExpr0"><pre>Matches array subscript expressions.
				640
				641	Given
				642	int i = a[1];
				643	arraySubscriptExpr()
				644	matches "a[1]"
				645	</pre></td></tr>
				646
				647
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	648	<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]	649	<tr><td colspan="4" class="doc" id="asmStmt0"><pre>Matches asm statements.
				650
				651	int i = 100;
				652	__asm("mov al, 2");
				653	asmStmt()
				654	matches '__asm("mov al, 2")'
				655	</pre></td></tr>
				656
				657
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	658	<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>
				659	<tr><td colspan="4" class="doc" id="atomicExpr0"><pre>Matches atomic builtins.
				660	Example matches __atomic_load_n(ptr, 1)
				661	void foo() { int *ptr; __atomic_load_n(ptr, 1); }
				662	</pre></td></tr>
				663
				664
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	665	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Stmt.html">Stmt</a>></td><td class="name" onclick="toggle('autoreleasePoolStmt0')"><a name="autoreleasePoolStmt0Anchor">autoreleasePoolStmt</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCAutoreleasePoolStmt.html">ObjCAutoreleasePoolStmt</a>>...</td></tr>
				666	<tr><td colspan="4" class="doc" id="autoreleasePoolStmt0"><pre>Matches an Objective-C autorelease pool statement.
				667
				668	Given
				669	@autoreleasepool {
				670	int x = 0;
				671	}
				672	autoreleasePoolStmt(stmt()) matches the declaration of "x"
				673	inside the autorelease pool.
				674	</pre></td></tr>
				675
				676
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	677	<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>
				678	<tr><td colspan="4" class="doc" id="binaryConditionalOperator0"><pre>Matches binary conditional operator expressions (GNU extension).
				679
				680	Example matches a ?: b
				681	(a ?: b) + 42;
				682	</pre></td></tr>
				683
				684
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	685	<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]	686	<tr><td colspan="4" class="doc" id="binaryOperator0"><pre>Matches binary operator expressions.
				687
				688	Example matches a \|\| b
				689	!(a \|\| b)
				690	</pre></td></tr>
				691
				692
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	693	<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]	694	<tr><td colspan="4" class="doc" id="breakStmt0"><pre>Matches break statements.
				695
				696	Given
				697	while (true) { break; }
				698	breakStmt()
				699	matches 'break'
				700	</pre></td></tr>
				701
				702
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	703	<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]	704	<tr><td colspan="4" class="doc" id="cStyleCastExpr0"><pre>Matches a C-style cast expression.
				705
Artem Dergachev	ded92a9	2016-11-11 22:34:53 +0000	[diff] [blame]	706	Example: Matches (int) 2.2f in
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	707	int i = (int) 2.2f;
				708	</pre></td></tr>
				709
				710
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	711	<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]	712	<tr><td colspan="4" class="doc" id="callExpr0"><pre>Matches call expressions.
				713
				714	Example matches x.y() and y()
				715	X x;
				716	x.y();
				717	y();
				718	</pre></td></tr>
				719
				720
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	721	<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]	722	<tr><td colspan="4" class="doc" id="caseStmt0"><pre>Matches case statements inside switch statements.
				723
				724	Given
				725	switch(a) { case 42: break; default: break; }
				726	caseStmt()
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	727	matches 'case 42:'.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	728	</pre></td></tr>
				729
				730
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	731	<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]	732	<tr><td colspan="4" class="doc" id="castExpr0"><pre>Matches any cast nodes of Clang's AST.
				733
				734	Example: castExpr() matches each of the following:
				735	(int) 3;
				736	const_cast<Expr *>(SubExpr);
				737	char c = 0;
				738	but does not match
				739	int i = (0);
				740	int k = 0;
				741	</pre></td></tr>
				742
				743
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	744	<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]	745	<tr><td colspan="4" class="doc" id="characterLiteral0"><pre>Matches character literals (also matches wchar_t).
				746
				747	Not matching Hex-encoded chars (e.g. 0x1234, which is a IntegerLiteral),
				748	though.
				749
				750	Example matches 'a', L'a'
Etienne Bergeron	3588be7	2016-05-12 04:20:04 +0000	[diff] [blame]	751	char ch = 'a';
				752	wchar_t chw = L'a';
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	753	</pre></td></tr>
				754
				755
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	756	<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]	757	<tr><td colspan="4" class="doc" id="compoundLiteralExpr0"><pre>Matches compound (i.e. non-scalar) literals
				758
				759	Example match: {1}, (1, 2)
Etienne Bergeron	3588be7	2016-05-12 04:20:04 +0000	[diff] [blame]	760	int array[4] = {1};
				761	vector int myvec = (vector int)(1, 2);
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	762	</pre></td></tr>
				763
				764
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	765	<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]	766	<tr><td colspan="4" class="doc" id="compoundStmt0"><pre>Matches compound statements.
				767
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	768	Example matches '{}' and '{{}}' in 'for (;;) {{}}'
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	769	for (;;) {{}}
				770	</pre></td></tr>
				771
				772
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	773	<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]	774	<tr><td colspan="4" class="doc" id="conditionalOperator0"><pre>Matches conditional operator expressions.
				775
				776	Example matches a ? b : c
				777	(a ? b : c) + 42
				778	</pre></td></tr>
				779
				780
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	781	<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]	782	<tr><td colspan="4" class="doc" id="continueStmt0"><pre>Matches continue statements.
				783
				784	Given
				785	while (true) { continue; }
				786	continueStmt()
				787	matches 'continue'
				788	</pre></td></tr>
				789
				790
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	791	<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]	792	<tr><td colspan="4" class="doc" id="cudaKernelCallExpr0"><pre>Matches CUDA kernel call expression.
				793
				794	Example matches,
				795	kernel<<<i,j>>>();
				796	</pre></td></tr>
				797
				798
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	799	<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]	800	<tr><td colspan="4" class="doc" id="cxxBindTemporaryExpr0"><pre>Matches nodes where temporaries are created.
				801
				802	Example matches FunctionTakesString(GetStringByValue())
				803	(matcher = cxxBindTemporaryExpr())
				804	FunctionTakesString(GetStringByValue());
				805	FunctionTakesStringByPointer(GetStringPointer());
				806	</pre></td></tr>
				807
				808
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	809	<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]	810	<tr><td colspan="4" class="doc" id="cxxBoolLiteral0"><pre>Matches bool literals.
				811
				812	Example matches true
				813	true
				814	</pre></td></tr>
				815
				816
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	817	<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]	818	<tr><td colspan="4" class="doc" id="cxxCatchStmt0"><pre>Matches catch statements.
				819
				820	try {} catch(int i) {}
				821	cxxCatchStmt()
				822	matches 'catch(int i)'
				823	</pre></td></tr>
				824
				825
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	826	<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]	827	<tr><td colspan="4" class="doc" id="cxxConstCastExpr0"><pre>Matches a const_cast expression.
				828
				829	Example: Matches const_cast<int*>(&r) in
				830	int n = 42;
				831	const int &r(n);
				832	int* p = const_cast<int*>(&r);
				833	</pre></td></tr>
				834
				835
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	836	<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]	837	<tr><td colspan="4" class="doc" id="cxxConstructExpr0"><pre>Matches constructor call expressions (including implicit ones).
				838
				839	Example matches string(ptr, n) and ptr within arguments of f
				840	(matcher = cxxConstructExpr())
				841	void f(const string &a, const string &b);
				842	char *ptr;
				843	int n;
				844	f(string(ptr, n), ptr);
				845	</pre></td></tr>
				846
				847
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	848	<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]	849	<tr><td colspan="4" class="doc" id="cxxDefaultArgExpr0"><pre>Matches the value of a default argument at the call site.
				850
				851	Example matches the CXXDefaultArgExpr placeholder inserted for the
				852	default value of the second parameter in the call expression f(42)
				853	(matcher = cxxDefaultArgExpr())
				854	void f(int x, int y = 0);
				855	f(42);
				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('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]	860	<tr><td colspan="4" class="doc" id="cxxDeleteExpr0"><pre>Matches delete expressions.
				861
				862	Given
				863	delete X;
				864	cxxDeleteExpr()
				865	matches 'delete X'.
				866	</pre></td></tr>
				867
				868
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	869	<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]	870	<tr><td colspan="4" class="doc" id="cxxDynamicCastExpr0"><pre>Matches a dynamic_cast expression.
				871
				872	Example:
				873	cxxDynamicCastExpr()
				874	matches
				875	dynamic_cast<D*>(&b);
				876	in
				877	struct B { virtual ~B() {} }; struct D : B {};
				878	B b;
				879	D* p = dynamic_cast<D*>(&b);
				880	</pre></td></tr>
				881
				882
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	883	<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]	884	<tr><td colspan="4" class="doc" id="cxxForRangeStmt0"><pre>Matches range-based for statements.
				885
				886	cxxForRangeStmt() matches 'for (auto a : i)'
				887	int i[] = {1, 2, 3}; for (auto a : i);
				888	for(int j = 0; j < 5; ++j);
				889	</pre></td></tr>
				890
				891
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	892	<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]	893	<tr><td colspan="4" class="doc" id="cxxFunctionalCastExpr0"><pre>Matches functional cast expressions
				894
				895	Example: Matches Foo(bar);
				896	Foo f = bar;
				897	Foo g = (Foo) bar;
				898	Foo h = Foo(bar);
				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('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]	903	<tr><td colspan="4" class="doc" id="cxxMemberCallExpr0"><pre>Matches member call expressions.
				904
				905	Example matches x.y()
				906	X x;
				907	x.y();
				908	</pre></td></tr>
				909
				910
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	911	<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]	912	<tr><td colspan="4" class="doc" id="cxxNewExpr0"><pre>Matches new expressions.
				913
				914	Given
				915	new X;
				916	cxxNewExpr()
				917	matches 'new X'.
				918	</pre></td></tr>
				919
				920
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	921	<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]	922	<tr><td colspan="4" class="doc" id="cxxNullPtrLiteralExpr0"><pre>Matches nullptr literal.
				923	</pre></td></tr>
				924
				925
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	926	<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]	927	<tr><td colspan="4" class="doc" id="cxxOperatorCallExpr0"><pre>Matches overloaded operator calls.
				928
				929	Note that if an operator isn't overloaded, it won't match. Instead, use
				930	binaryOperator matcher.
				931	Currently it does not match operators such as new delete.
				932	FIXME: figure out why these do not match?
				933
				934	Example matches both operator<<((o << b), c) and operator<<(o, b)
				935	(matcher = cxxOperatorCallExpr())
				936	ostream &operator<< (ostream &out, int i) { };
				937	ostream &o; int b = 1, c = 1;
				938	o << b << c;
				939	</pre></td></tr>
				940
				941
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	942	<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]	943	<tr><td colspan="4" class="doc" id="cxxReinterpretCastExpr0"><pre>Matches a reinterpret_cast expression.
				944
				945	Either the source expression or the destination type can be matched
				946	using has(), but hasDestinationType() is more specific and can be
				947	more readable.
				948
				949	Example matches reinterpret_cast<char*>(&p) in
				950	void* p = reinterpret_cast<char*>(&p);
				951	</pre></td></tr>
				952
				953
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	954	<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]	955	<tr><td colspan="4" class="doc" id="cxxStaticCastExpr0"><pre>Matches a C++ static_cast expression.
				956
Aaron Ballman	c35724c	2016-01-21 15:18:25 +0000	[diff] [blame]	957	See also: hasDestinationType
				958	See also: reinterpretCast
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	959
				960	Example:
				961	cxxStaticCastExpr()
				962	matches
				963	static_cast<long>(8)
				964	in
				965	long eight(static_cast<long>(8));
				966	</pre></td></tr>
				967
				968
Jakub Kuderski	64b6c78	2017-05-05 21:01:12 +0000	[diff] [blame]	969	<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>
				970	<tr><td colspan="4" class="doc" id="cxxStdInitializerListExpr0"><pre>Matches C++ initializer list expressions.
				971
				972	Given
				973	std::vector<int> a({ 1, 2, 3 });
				974	std::vector<int> b = { 4, 5 };
				975	int c[] = { 6, 7 };
				976	std::pair<int, int> d = { 8, 9 };
				977	cxxStdInitializerListExpr()
				978	matches "{ 1, 2, 3 }" and "{ 4, 5 }"
				979	</pre></td></tr>
				980
				981
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	982	<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]	983	<tr><td colspan="4" class="doc" id="cxxTemporaryObjectExpr0"><pre>Matches functional cast expressions having N != 1 arguments
				984
				985	Example: Matches Foo(bar, bar)
				986	Foo h = Foo(bar, bar);
				987	</pre></td></tr>
				988
				989
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	990	<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]	991	<tr><td colspan="4" class="doc" id="cxxThisExpr0"><pre>Matches implicit and explicit this expressions.
				992
				993	Example matches the implicit this expression in "return i".
				994	(matcher = cxxThisExpr())
				995	struct foo {
				996	int i;
				997	int f() { return i; }
				998	};
				999	</pre></td></tr>
				1000
				1001
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1002	<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]	1003	<tr><td colspan="4" class="doc" id="cxxThrowExpr0"><pre>Matches throw expressions.
				1004
				1005	try { throw 5; } catch(int i) {}
				1006	cxxThrowExpr()
				1007	matches 'throw 5'
				1008	</pre></td></tr>
				1009
				1010
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1011	<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]	1012	<tr><td colspan="4" class="doc" id="cxxTryStmt0"><pre>Matches try statements.
				1013
				1014	try {} catch(int i) {}
				1015	cxxTryStmt()
				1016	matches 'try {}'
				1017	</pre></td></tr>
				1018
				1019
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1020	<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]	1021	<tr><td colspan="4" class="doc" id="cxxUnresolvedConstructExpr0"><pre>Matches unresolved constructor call expressions.
				1022
				1023	Example matches T(t) in return statement of f
				1024	(matcher = cxxUnresolvedConstructExpr())
				1025	template <typename T>
				1026	void f(const T& t) { return T(t); }
				1027	</pre></td></tr>
				1028
				1029
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1030	<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]	1031	<tr><td colspan="4" class="doc" id="declRefExpr0"><pre>Matches expressions that refer to declarations.
				1032
				1033	Example matches x in if (x)
				1034	bool x;
				1035	if (x) {}
				1036	</pre></td></tr>
				1037
				1038
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1039	<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]	1040	<tr><td colspan="4" class="doc" id="declStmt0"><pre>Matches declaration statements.
				1041
				1042	Given
				1043	int a;
				1044	declStmt()
				1045	matches 'int a'.
				1046	</pre></td></tr>
				1047
				1048
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1049	<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]	1050	<tr><td colspan="4" class="doc" id="defaultStmt0"><pre>Matches default statements inside switch statements.
				1051
				1052	Given
				1053	switch(a) { case 42: break; default: break; }
				1054	defaultStmt()
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	1055	matches 'default:'.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1056	</pre></td></tr>
				1057
				1058
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	1059	<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>
				1060	<tr><td colspan="4" class="doc" id="designatedInitExpr0"><pre>Matches C99 designated initializer expressions [C99 6.7.8].
				1061
				1062	Example: Matches { [2].y = 1.0, [0].x = 1.0 }
				1063	point ptarray[10] = { [2].y = 1.0, [0].x = 1.0 };
				1064	</pre></td></tr>
				1065
				1066
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1067	<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]	1068	<tr><td colspan="4" class="doc" id="doStmt0"><pre>Matches do statements.
				1069
				1070	Given
				1071	do {} while (true);
				1072	doStmt()
				1073	matches 'do {} while(true)'
				1074	</pre></td></tr>
				1075
				1076
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1077	<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]	1078	<tr><td colspan="4" class="doc" id="explicitCastExpr0"><pre>Matches explicit cast expressions.
				1079
				1080	Matches any cast expression written in user code, whether it be a
				1081	C-style cast, a functional-style cast, or a keyword cast.
				1082
				1083	Does not match implicit conversions.
				1084
				1085	Note: the name "explicitCast" is chosen to match Clang's terminology, as
				1086	Clang uses the term "cast" to apply to implicit conversions as well as to
				1087	actual cast expressions.
				1088
Aaron Ballman	c35724c	2016-01-21 15:18:25 +0000	[diff] [blame]	1089	See also: hasDestinationType.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1090
				1091	Example: matches all five of the casts in
				1092	int((int)(reinterpret_cast<int>(static_cast<int>(const_cast<int>(42)))))
				1093	but does not match the implicit conversion in
				1094	long ell = 42;
				1095	</pre></td></tr>
				1096
				1097
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1098	<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]	1099	<tr><td colspan="4" class="doc" id="expr0"><pre>Matches expressions.
				1100
				1101	Example matches x()
				1102	void f() { x(); }
				1103	</pre></td></tr>
				1104
				1105
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1106	<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]	1107	<tr><td colspan="4" class="doc" id="exprWithCleanups0"><pre>Matches expressions that introduce cleanups to be run at the end
				1108	of the sub-expression's evaluation.
				1109
				1110	Example matches std::string()
				1111	const std::string str = std::string();
				1112	</pre></td></tr>
				1113
				1114
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1115	<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]	1116	<tr><td colspan="4" class="doc" id="floatLiteral0"><pre>Matches float literals of all sizes encodings, e.g.
				1117	1.0, 1.0f, 1.0L and 1e10.
				1118
				1119	Does not match implicit conversions such as
				1120	float a = 10;
				1121	</pre></td></tr>
				1122
				1123
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1124	<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]	1125	<tr><td colspan="4" class="doc" id="forStmt0"><pre>Matches for statements.
				1126
				1127	Example matches 'for (;;) {}'
				1128	for (;;) {}
				1129	int i[] = {1, 2, 3}; for (auto a : i);
				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('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]	1134	<tr><td colspan="4" class="doc" id="gnuNullExpr0"><pre>Matches GNU __null expression.
				1135	</pre></td></tr>
				1136
				1137
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1138	<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]	1139	<tr><td colspan="4" class="doc" id="gotoStmt0"><pre>Matches goto statements.
				1140
				1141	Given
				1142	goto FOO;
				1143	FOO: bar();
				1144	gotoStmt()
				1145	matches 'goto FOO'
				1146	</pre></td></tr>
				1147
				1148
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1149	<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]	1150	<tr><td colspan="4" class="doc" id="ifStmt0"><pre>Matches if statements.
				1151
				1152	Example matches 'if (x) {}'
				1153	if (x) {}
				1154	</pre></td></tr>
				1155
				1156
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1157	<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]	1158	<tr><td colspan="4" class="doc" id="implicitCastExpr0"><pre>Matches the implicit cast nodes of Clang's AST.
				1159
				1160	This matches many different places, including function call return value
				1161	eliding, as well as any type conversions.
				1162	</pre></td></tr>
				1163
				1164
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	1165	<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>
				1166	<tr><td colspan="4" class="doc" id="implicitValueInitExpr0"><pre>Matches implicit initializers of init list expressions.
				1167
				1168	Given
				1169	point ptarray[10] = { [2].y = 1.0, [2].x = 2.0, [0].x = 1.0 };
				1170	implicitValueInitExpr()
				1171	matches "[0].y" (implicitly)
				1172	</pre></td></tr>
				1173
				1174
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1175	<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]	1176	<tr><td colspan="4" class="doc" id="initListExpr0"><pre>Matches init list expressions.
				1177
				1178	Given
				1179	int a[] = { 1, 2 };
				1180	struct B { int x, y; };
				1181	B b = { 5, 6 };
				1182	initListExpr()
				1183	matches "{ 1, 2 }" and "{ 5, 6 }"
				1184	</pre></td></tr>
				1185
				1186
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1187	<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]	1188	<tr><td colspan="4" class="doc" id="integerLiteral0"><pre>Matches integer literals of all sizes encodings, e.g.
				1189	1, 1L, 0x1 and 1U.
				1190
				1191	Does not match character-encoded integers such as L'a'.
				1192	</pre></td></tr>
				1193
				1194
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1195	<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]	1196	<tr><td colspan="4" class="doc" id="labelStmt0"><pre>Matches label statements.
				1197
				1198	Given
				1199	goto FOO;
				1200	FOO: bar();
				1201	labelStmt()
				1202	matches 'FOO:'
				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('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]	1207	<tr><td colspan="4" class="doc" id="lambdaExpr0"><pre>Matches lambda expressions.
				1208
				1209	Example matches [&](){return 5;}
				1210	[&](){return 5;}
				1211	</pre></td></tr>
				1212
				1213
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1214	<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]	1215	<tr><td colspan="4" class="doc" id="materializeTemporaryExpr0"><pre>Matches nodes where temporaries are materialized.
				1216
				1217	Example: Given
Jakub Kuderski	64b6c78	2017-05-05 21:01:12 +0000	[diff] [blame]	1218	struct T {void func();};
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1219	T f();
				1220	void g(T);
				1221	materializeTemporaryExpr() matches 'f()' in these statements
				1222	T u(f());
				1223	g(f());
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	1224	f().func();
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1225	but does not match
				1226	f();
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1227	</pre></td></tr>
				1228
				1229
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1230	<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]	1231	<tr><td colspan="4" class="doc" id="memberExpr0"><pre>Matches member expressions.
				1232
				1233	Given
				1234	class Y {
				1235	void x() { this->x(); x(); Y y; y.x(); a; this->b; Y::b; }
				1236	int a; static int b;
				1237	};
				1238	memberExpr()
				1239	matches this->x, x, y.x, a, this->b
				1240	</pre></td></tr>
				1241
				1242
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1243	<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]	1244	<tr><td colspan="4" class="doc" id="nullStmt0"><pre>Matches null statements.
				1245
				1246	foo();;
				1247	nullStmt()
				1248	matches the second ';'
				1249	</pre></td></tr>
				1250
				1251
Dave Lee	0934fdc	2017-11-11 22:46:15 +0000	[diff] [blame]	1252	<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>
				1253	<tr><td colspan="4" class="doc" id="objcCatchStmt0"><pre>Matches Objective-C @catch statements.
				1254
				1255	Example matches @catch
				1256	@try {}
				1257	@catch (...) {}
				1258	</pre></td></tr>
				1259
				1260
				1261	<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>
				1262	<tr><td colspan="4" class="doc" id="objcFinallyStmt0"><pre>Matches Objective-C @finally statements.
				1263
				1264	Example matches @finally
				1265	@try {}
				1266	@finally {}
				1267	</pre></td></tr>
				1268
				1269
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1270	<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]	1271	<tr><td colspan="4" class="doc" id="objcMessageExpr0"><pre>Matches ObjectiveC Message invocation expressions.
				1272
				1273	The innermost message send invokes the "alloc" class method on the
				1274	NSString class, while the outermost message send invokes the
				1275	"initWithString" instance method on the object returned from
				1276	NSString's "alloc". This matcher should match both message sends.
				1277	[[NSString alloc] initWithString:@"Hello"]
				1278	</pre></td></tr>
				1279
Aaron Ballman	c35724c	2016-01-21 15:18:25 +0000	[diff] [blame]	1280
Dave Lee	0934fdc	2017-11-11 22:46:15 +0000	[diff] [blame]	1281	<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]	1282	<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]	1283
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	1284	Example matches @throw obj;
Dave Lee	0934fdc	2017-11-11 22:46:15 +0000	[diff] [blame]	1285	</pre></td></tr>
				1286
				1287
				1288	<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>
				1289	<tr><td colspan="4" class="doc" id="objcTryStmt0"><pre>Matches Objective-C @try statements.
				1290
				1291	Example matches @try
				1292	@try {}
				1293	@catch (...) {}
				1294	</pre></td></tr>
				1295
				1296
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	1297	<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>
				1298	<tr><td colspan="4" class="doc" id="opaqueValueExpr0"><pre>Matches opaque value expressions. They are used as helpers
				1299	to reference another expressions and can be met
				1300	in BinaryConditionalOperators, for example.
				1301
				1302	Example matches 'a'
				1303	(a ?: c) + 42;
				1304	</pre></td></tr>
				1305
				1306
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1307	<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]	1308	<tr><td colspan="4" class="doc" id="parenExpr0"><pre>Matches parentheses used in expressions.
				1309
Aaron Ballman	c35724c	2016-01-21 15:18:25 +0000	[diff] [blame]	1310	Example matches (foo() + 1)
Aaron Ballman	e8295d7	2016-01-20 16:17:39 +0000	[diff] [blame]	1311	int foo() { return 1; }
				1312	int a = (foo() + 1);
Aaron Ballman	e8295d7	2016-01-20 16:17:39 +0000	[diff] [blame]	1313	</pre></td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1314
Aaron Ballman	c35724c	2016-01-21 15:18:25 +0000	[diff] [blame]	1315
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	1316	<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>
				1317	<tr><td colspan="4" class="doc" id="parenListExpr0"><pre>Matches paren list expressions.
				1318	ParenListExprs don't have a predefined type and are used for late parsing.
				1319	In the final AST, they can be met in template declarations.
				1320
				1321	Given
				1322	template<typename T> class X {
				1323	void f() {
				1324	X x(*this);
				1325	int a = 0, b = 1; int i = (a, b);
				1326	}
				1327	};
				1328	parenListExpr() matches "*this" but NOT matches (a, b) because (a, b)
				1329	has a predefined type and is a ParenExpr, not a ParenListExpr.
				1330	</pre></td></tr>
				1331
				1332
				1333	<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>
				1334	<tr><td colspan="4" class="doc" id="predefinedExpr0"><pre>Matches predefined identifier expressions [C99 6.4.2.2].
				1335
				1336	Example: Matches __func__
				1337	printf("%s", __func__);
				1338	</pre></td></tr>
				1339
				1340
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1341	<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]	1342	<tr><td colspan="4" class="doc" id="returnStmt0"><pre>Matches return statements.
				1343
				1344	Given
				1345	return 1;
				1346	returnStmt()
				1347	matches 'return 1'
				1348	</pre></td></tr>
				1349
				1350
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1351	<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]	1352	<tr><td colspan="4" class="doc" id="stmt0"><pre>Matches statements.
				1353
				1354	Given
				1355	{ ++a; }
				1356	stmt()
				1357	matches both the compound statement '{ ++a; }' and '++a'.
				1358	</pre></td></tr>
				1359
				1360
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	1361	<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>
				1362	<tr><td colspan="4" class="doc" id="stmtExpr0"><pre>Matches statement expression (GNU extension).
				1363
				1364	Example match: ({ int X = 4; X; })
				1365	int C = ({ int X = 4; X; });
				1366	</pre></td></tr>
				1367
				1368
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1369	<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]	1370	<tr><td colspan="4" class="doc" id="stringLiteral0"><pre>Matches string literals (also matches wide string literals).
				1371
				1372	Example matches "abcd", L"abcd"
Etienne Bergeron	3588be7	2016-05-12 04:20:04 +0000	[diff] [blame]	1373	char *s = "abcd";
				1374	wchar_t *ws = L"abcd";
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1375	</pre></td></tr>
				1376
				1377
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1378	<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]	1379	<tr><td colspan="4" class="doc" id="substNonTypeTemplateParmExpr0"><pre>Matches substitutions of non-type template parameters.
				1380
				1381	Given
				1382	template <int N>
				1383	struct A { static const int n = N; };
				1384	struct B : public A<42> {};
				1385	substNonTypeTemplateParmExpr()
				1386	matches "N" in the right-hand side of "static const int n = N;"
				1387	</pre></td></tr>
				1388
				1389
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1390	<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]	1391	<tr><td colspan="4" class="doc" id="switchCase0"><pre>Matches case and default statements inside switch statements.
				1392
				1393	Given
				1394	switch(a) { case 42: break; default: break; }
				1395	switchCase()
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	1396	matches 'case 42:' and 'default:'.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1397	</pre></td></tr>
				1398
				1399
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1400	<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]	1401	<tr><td colspan="4" class="doc" id="switchStmt0"><pre>Matches switch statements.
				1402
				1403	Given
				1404	switch(a) { case 42: break; default: break; }
				1405	switchStmt()
				1406	matches 'switch(a)'.
				1407	</pre></td></tr>
				1408
				1409
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1410	<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]	1411	<tr><td colspan="4" class="doc" id="unaryExprOrTypeTraitExpr0"><pre>Matches sizeof (C99), alignof (C++11) and vec_step (OpenCL)
				1412
				1413	Given
				1414	Foo x = bar;
				1415	int y = sizeof(x) + alignof(x);
				1416	unaryExprOrTypeTraitExpr()
				1417	matches sizeof(x) and alignof(x)
				1418	</pre></td></tr>
				1419
				1420
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1421	<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]	1422	<tr><td colspan="4" class="doc" id="unaryOperator0"><pre>Matches unary operator expressions.
				1423
				1424	Example matches !a
				1425	!a \|\| b
				1426	</pre></td></tr>
				1427
				1428
Haojian Wu	7751c92	2016-05-18 12:53:59 +0000	[diff] [blame]	1429	<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>
				1430	<tr><td colspan="4" class="doc" id="unresolvedLookupExpr0"><pre>Matches reference to a name that can be looked up during parsing
				1431	but could not be resolved to a specific declaration.
				1432
				1433	Given
				1434	template<typename T>
				1435	T foo() { T a; return a; }
				1436	template<typename T>
				1437	void bar() {
				1438	foo<T>();
				1439	}
				1440	unresolvedLookupExpr()
				1441	matches foo<T>() </pre></td></tr>
				1442
				1443
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1444	<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]	1445	<tr><td colspan="4" class="doc" id="userDefinedLiteral0"><pre>Matches user defined literal operator call.
				1446
				1447	Example match: "foo"_suffix
				1448	</pre></td></tr>
				1449
				1450
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1451	<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]	1452	<tr><td colspan="4" class="doc" id="whileStmt0"><pre>Matches while statements.
				1453
				1454	Given
				1455	while (true) {}
				1456	whileStmt()
				1457	matches 'while (true) {}'.
				1458	</pre></td></tr>
				1459
				1460
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1461	<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]	1462	<tr><td colspan="4" class="doc" id="templateArgument0"><pre>Matches template arguments.
				1463
				1464	Given
				1465	template <typename T> struct C {};
				1466	C<int> c;
				1467	templateArgument()
				1468	matches 'int' in C<int>.
				1469	</pre></td></tr>
				1470
				1471
Haojian Wu	b33b02e	2016-07-29 15:45:11 +0000	[diff] [blame]	1472	<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>
				1473	<tr><td colspan="4" class="doc" id="templateName0"><pre>Matches template name.
				1474
				1475	Given
				1476	template <typename T> class X { };
				1477	X<int> xi;
				1478	templateName()
				1479	matches 'X' in X<int>.
				1480	</pre></td></tr>
				1481
				1482
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1483	<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]	1484	<tr><td colspan="4" class="doc" id="typeLoc0"><pre>Matches TypeLocs in the clang AST.
				1485	</pre></td></tr>
				1486
				1487
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1488	<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]	1489	<tr><td colspan="4" class="doc" id="arrayType0"><pre>Matches all kinds of arrays.
				1490
				1491	Given
				1492	int a[] = { 2, 3 };
				1493	int b[4];
				1494	void f() { int c[a[0]]; }
				1495	arrayType()
				1496	matches "int a[]", "int b[4]" and "int c[a[0]]";
				1497	</pre></td></tr>
				1498
				1499
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1500	<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]	1501	<tr><td colspan="4" class="doc" id="atomicType0"><pre>Matches atomic types.
				1502
				1503	Given
				1504	_Atomic(int) i;
				1505	atomicType()
				1506	matches "_Atomic(int) i"
				1507	</pre></td></tr>
				1508
				1509
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1510	<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]	1511	<tr><td colspan="4" class="doc" id="autoType0"><pre>Matches types nodes representing C++11 auto types.
				1512
				1513	Given:
				1514	auto n = 4;
				1515	int v[] = { 2, 3 }
				1516	for (auto i : v) { }
				1517	autoType()
				1518	matches "auto n" and "auto i"
				1519	</pre></td></tr>
				1520
				1521
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1522	<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]	1523	<tr><td colspan="4" class="doc" id="blockPointerType0"><pre>Matches block pointer types, i.e. types syntactically represented as
				1524	"void (^)(int)".
				1525
				1526	The pointee is always required to be a FunctionType.
				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('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]	1531	<tr><td colspan="4" class="doc" id="builtinType0"><pre>Matches builtin Types.
				1532
				1533	Given
				1534	struct A {};
				1535	A a;
				1536	int b;
				1537	float c;
				1538	bool d;
				1539	builtinType()
				1540	matches "int b", "float c" and "bool d"
				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('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]	1545	<tr><td colspan="4" class="doc" id="complexType0"><pre>Matches C99 complex types.
				1546
				1547	Given
				1548	_Complex float f;
				1549	complexType()
				1550	matches "_Complex float f"
				1551	</pre></td></tr>
				1552
				1553
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1554	<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]	1555	<tr><td colspan="4" class="doc" id="constantArrayType0"><pre>Matches C arrays with a specified constant size.
				1556
				1557	Given
				1558	void() {
				1559	int a[2];
				1560	int b[] = { 2, 3 };
				1561	int c[b[0]];
				1562	}
				1563	constantArrayType()
				1564	matches "int a[2]"
				1565	</pre></td></tr>
				1566
				1567
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1568	<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]	1569	<tr><td colspan="4" class="doc" id="decayedType0"><pre>Matches decayed type
				1570	Example matches i[] in declaration of f.
				1571	(matcher = valueDecl(hasType(decayedType(hasDecayedType(pointerType())))))
				1572	Example matches i[1].
				1573	(matcher = expr(hasType(decayedType(hasDecayedType(pointerType())))))
				1574	void f(int i[]) {
				1575	i[1] = 0;
				1576	}
				1577	</pre></td></tr>
				1578
				1579
Jonas Toth	acf8367	2018-07-26 13:02:05 +0000	[diff] [blame]	1580	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td><td class="name" onclick="toggle('decltypeType0')"><a name="decltypeType0Anchor">decltypeType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DecltypeType.html">DecltypeType</a>>...</td></tr>
				1581	<tr><td colspan="4" class="doc" id="decltypeType0"><pre>Matches types nodes representing C++11 decltype(<expr>) types.
				1582
				1583	Given:
				1584	short i = 1;
				1585	int j = 42;
				1586	decltype(i + j) result = i + j;
				1587	decltypeType()
				1588	matches "decltype(i + j)"
				1589	</pre></td></tr>
				1590
				1591
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1592	<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]	1593	<tr><td colspan="4" class="doc" id="dependentSizedArrayType0"><pre>Matches C++ arrays whose size is a value-dependent expression.
				1594
				1595	Given
				1596	template<typename T, int Size>
				1597	class array {
				1598	T data[Size];
				1599	};
				1600	dependentSizedArrayType
				1601	matches "T data[Size]"
				1602	</pre></td></tr>
				1603
				1604
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1605	<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]	1606	<tr><td colspan="4" class="doc" id="elaboratedType0"><pre>Matches types specified with an elaborated type keyword or with a
				1607	qualified name.
				1608
				1609	Given
				1610	namespace N {
				1611	namespace M {
				1612	class D {};
				1613	}
				1614	}
				1615	class C {};
				1616
				1617	class C c;
				1618	N::M::D d;
				1619
				1620	elaboratedType() matches the type of the variable declarations of both
				1621	c and d.
				1622	</pre></td></tr>
				1623
				1624
Haojian Wu	e775de8	2016-06-30 07:50:01 +0000	[diff] [blame]	1625	<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>
				1626	<tr><td colspan="4" class="doc" id="enumType0"><pre>Matches enum types.
				1627
				1628	Given
				1629	enum C { Green };
Aaron Ballman	5c57434	2016-07-06 18:25:16 +0000	[diff] [blame]	1630	enum class S { Red };
Haojian Wu	e775de8	2016-06-30 07:50:01 +0000	[diff] [blame]	1631
				1632	C c;
				1633	S s;
				1634
				1635	enumType() matches the type of the variable declarations of both c and
				1636	s.
				1637	</pre></td></tr>
				1638
				1639
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	1640	<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>
				1641	<tr><td colspan="4" class="doc" id="functionProtoType0"><pre>Matches FunctionProtoType nodes.
				1642
				1643	Given
				1644	int (*f)(int);
				1645	void g();
				1646	functionProtoType()
				1647	matches "int (*f)(int)" and the type of "g" in C++ mode.
				1648	In C mode, "g" is not matched because it does not contain a prototype.
				1649	</pre></td></tr>
				1650
				1651
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1652	<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]	1653	<tr><td colspan="4" class="doc" id="functionType0"><pre>Matches FunctionType nodes.
				1654
				1655	Given
				1656	int (*f)(int);
				1657	void g();
				1658	functionType()
				1659	matches "int (*f)(int)" and the type of "g".
				1660	</pre></td></tr>
				1661
				1662
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1663	<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]	1664	<tr><td colspan="4" class="doc" id="incompleteArrayType0"><pre>Matches C arrays with unspecified size.
				1665
				1666	Given
				1667	int a[] = { 2, 3 };
				1668	int b[42];
				1669	void f(int c[]) { int d[a[0]]; };
				1670	incompleteArrayType()
				1671	matches "int a[]" and "int c[]"
				1672	</pre></td></tr>
				1673
				1674
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1675	<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]	1676	<tr><td colspan="4" class="doc" id="injectedClassNameType0"><pre>Matches injected class name types.
				1677
				1678	Example matches S s, but not S<T> s.
				1679	(matcher = parmVarDecl(hasType(injectedClassNameType())))
				1680	template <typename T> struct S {
				1681	void f(S s);
				1682	void g(S<T> s);
				1683	};
				1684	</pre></td></tr>
				1685
				1686
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1687	<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]	1688	<tr><td colspan="4" class="doc" id="lValueReferenceType0"><pre>Matches lvalue reference types.
				1689
				1690	Given:
				1691	int *a;
				1692	int &b = *a;
				1693	int &&c = 1;
				1694	auto &d = b;
				1695	auto &&e = c;
				1696	auto &&f = 2;
				1697	int g = 5;
				1698
				1699	lValueReferenceType() matches the types of b, d, and e. e is
				1700	matched since the type is deduced as int& by reference collapsing rules.
				1701	</pre></td></tr>
				1702
				1703
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1704	<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]	1705	<tr><td colspan="4" class="doc" id="memberPointerType0"><pre>Matches member pointer types.
				1706	Given
				1707	struct A { int i; }
				1708	A::* ptr = A::i;
				1709	memberPointerType()
				1710	matches "A::* ptr"
				1711	</pre></td></tr>
				1712
				1713
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1714	<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]	1715	<tr><td colspan="4" class="doc" id="objcObjectPointerType0"><pre>Matches an Objective-C object pointer type, which is different from
				1716	a pointer type, despite being syntactically similar.
				1717
				1718	Given
				1719	int *a;
				1720
				1721	@interface Foo
				1722	@end
				1723	Foo *f;
				1724	pointerType()
				1725	matches "Foo f", but does not match "int a".
				1726	</pre></td></tr>
				1727
				1728
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1729	<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]	1730	<tr><td colspan="4" class="doc" id="parenType0"><pre>Matches ParenType nodes.
				1731
				1732	Given
				1733	int (*ptr_to_array)[4];
				1734	int *array_of_ptrs[4];
				1735
				1736	varDecl(hasType(pointsTo(parenType()))) matches ptr_to_array but not
				1737	array_of_ptrs.
				1738	</pre></td></tr>
				1739
				1740
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1741	<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]	1742	<tr><td colspan="4" class="doc" id="pointerType0"><pre>Matches pointer types, but does not match Objective-C object pointer
				1743	types.
				1744
				1745	Given
				1746	int *a;
				1747	int &b = *a;
				1748	int c = 5;
				1749
				1750	@interface Foo
				1751	@end
				1752	Foo *f;
				1753	pointerType()
				1754	matches "int a", but does not match "Foo f".
				1755	</pre></td></tr>
				1756
				1757
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1758	<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]	1759	<tr><td colspan="4" class="doc" id="rValueReferenceType0"><pre>Matches rvalue reference types.
				1760
				1761	Given:
				1762	int *a;
				1763	int &b = *a;
				1764	int &&c = 1;
				1765	auto &d = b;
				1766	auto &&e = c;
				1767	auto &&f = 2;
				1768	int g = 5;
				1769
				1770	rValueReferenceType() matches the types of c and f. e is not
				1771	matched as it is deduced to int& by reference collapsing rules.
				1772	</pre></td></tr>
				1773
				1774
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1775	<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]	1776	<tr><td colspan="4" class="doc" id="recordType0"><pre>Matches record types (e.g. structs, classes).
				1777
				1778	Given
				1779	class C {};
				1780	struct S {};
				1781
				1782	C c;
				1783	S s;
				1784
				1785	recordType() matches the type of the variable declarations of both c
				1786	and s.
				1787	</pre></td></tr>
				1788
				1789
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1790	<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]	1791	<tr><td colspan="4" class="doc" id="referenceType0"><pre>Matches both lvalue and rvalue reference types.
				1792
				1793	Given
				1794	int *a;
				1795	int &b = *a;
				1796	int &&c = 1;
				1797	auto &d = b;
				1798	auto &&e = c;
				1799	auto &&f = 2;
				1800	int g = 5;
				1801
				1802	referenceType() matches the types of b, c, d, e, and f.
				1803	</pre></td></tr>
				1804
				1805
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1806	<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]	1807	<tr><td colspan="4" class="doc" id="substTemplateTypeParmType0"><pre>Matches types that represent the result of substituting a type for a
				1808	template type parameter.
				1809
				1810	Given
				1811	template <typename T>
				1812	void F(T t) {
				1813	int i = 1 + t;
				1814	}
				1815
				1816	substTemplateTypeParmType() matches the type of 't' but not '1'
				1817	</pre></td></tr>
				1818
				1819
Manuel Klimek	696e505	2017-08-02 13:04:44 +0000	[diff] [blame]	1820	<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>
				1821	<tr><td colspan="4" class="doc" id="tagType0"><pre>Matches tag types (record and enum types).
				1822
				1823	Given
				1824	enum E {};
				1825	class C {};
				1826
				1827	E e;
				1828	C c;
				1829
				1830	tagType() matches the type of the variable declarations of both e
				1831	and c.
				1832	</pre></td></tr>
				1833
				1834
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1835	<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]	1836	<tr><td colspan="4" class="doc" id="templateSpecializationType0"><pre>Matches template specialization types.
				1837
				1838	Given
				1839	template <typename T>
				1840	class C { };
				1841
				1842	template class C<int>; A
				1843	C<char> var; B
				1844
				1845	templateSpecializationType() matches the type of the explicit
				1846	instantiation in A and the type of the variable declaration in B.
				1847	</pre></td></tr>
				1848
				1849
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1850	<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]	1851	<tr><td colspan="4" class="doc" id="templateTypeParmType0"><pre>Matches template type parameter types.
				1852
				1853	Example matches T, but not int.
				1854	(matcher = templateTypeParmType())
				1855	template <typename T> void f(int i);
				1856	</pre></td></tr>
				1857
				1858
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1859	<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]	1860	<tr><td colspan="4" class="doc" id="type0"><pre>Matches Types in the clang AST.
				1861	</pre></td></tr>
				1862
				1863
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1864	<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]	1865	<tr><td colspan="4" class="doc" id="typedefType0"><pre>Matches typedef types.
				1866
				1867	Given
				1868	typedef int X;
				1869	typedefType()
				1870	matches "typedef int X"
				1871	</pre></td></tr>
				1872
				1873
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1874	<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]	1875	<tr><td colspan="4" class="doc" id="unaryTransformType0"><pre>Matches types nodes representing unary type transformations.
				1876
				1877	Given:
				1878	typedef __underlying_type(T) type;
				1879	unaryTransformType()
				1880	matches "__underlying_type(T)"
				1881	</pre></td></tr>
				1882
				1883
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1884	<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]	1885	<tr><td colspan="4" class="doc" id="variableArrayType0"><pre>Matches C arrays with a specified size that is not an
				1886	integer-constant-expression.
				1887
				1888	Given
				1889	void f() {
				1890	int a[] = { 2, 3 }
				1891	int b[42];
				1892	int c[a[0]];
				1893	}
				1894	variableArrayType()
				1895	matches "int c[a[0]]"
				1896	</pre></td></tr>
				1897
Benjamin Kramer	7d0cc23	2015-11-20 07:57:46 +0000	[diff] [blame]	1898	<!--END_DECL_MATCHERS -->
				1899	</table>
				1900
				1901	<!-- ======================================================================= -->
				1902	<h2 id="narrowing-matchers">Narrowing Matchers</h2>
				1903	<!-- ======================================================================= -->
				1904
				1905	<p>Narrowing matchers match certain attributes on the current node, thus
				1906	narrowing down the set of nodes of the current type to match on.</p>
				1907
				1908	<p>There are special logical narrowing matchers (allOf, anyOf, anything and unless)
				1909	which allow users to create more powerful match expressions.</p>
				1910
				1911	<table>
				1912	<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]	1913	<!-- START_NARROWING_MATCHERS -->
				1914
				1915	<tr><td>Matcher<></td><td class="name" onclick="toggle('allOf0')"><a name="allOf0Anchor">allOf</a></td><td>Matcher<>, ..., Matcher<*></td></tr>
				1916	<tr><td colspan="4" class="doc" id="allOf0"><pre>Matches if all given matchers match.
				1917
				1918	Usable as: Any Matcher
				1919	</pre></td></tr>
				1920
				1921
				1922	<tr><td>Matcher<></td><td class="name" onclick="toggle('anyOf0')"><a name="anyOf0Anchor">anyOf</a></td><td>Matcher<>, ..., Matcher<*></td></tr>
				1923	<tr><td colspan="4" class="doc" id="anyOf0"><pre>Matches if any of the given matchers matches.
				1924
				1925	Usable as: Any Matcher
				1926	</pre></td></tr>
				1927
				1928
				1929	<tr><td>Matcher<*></td><td class="name" onclick="toggle('anything0')"><a name="anything0Anchor">anything</a></td><td></td></tr>
				1930	<tr><td colspan="4" class="doc" id="anything0"><pre>Matches any node.
				1931
				1932	Useful when another matcher requires a child matcher, but there's no
				1933	additional constraint. This will often be used with an explicit conversion
				1934	to an internal::Matcher<> type such as TypeMatcher.
				1935
				1936	Example: DeclarationMatcher(anything()) matches all declarations, e.g.,
				1937	"int* p" and "void f()" in
				1938	int* p;
				1939	void f();
				1940
				1941	Usable as: Any Matcher
				1942	</pre></td></tr>
				1943
				1944
				1945	<tr><td>Matcher<></td><td class="name" onclick="toggle('unless0')"><a name="unless0Anchor">unless</a></td><td>Matcher<></td></tr>
				1946	<tr><td colspan="4" class="doc" id="unless0"><pre>Matches if the provided matcher does not match.
				1947
				1948	Example matches Y (matcher = cxxRecordDecl(unless(hasName("X"))))
				1949	class X {};
				1950	class Y {};
				1951
				1952	Usable as: Any Matcher
				1953	</pre></td></tr>
				1954
				1955
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	1956	<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]	1957	<tr><td colspan="4" class="doc" id="hasOperatorName0"><pre>Matches the operator Name of operator expressions (binary or
				1958	unary).
				1959
				1960	Example matches a \|\| b (matcher = binaryOperator(hasOperatorName("\|\|")))
				1961	!(a \|\| b)
				1962	</pre></td></tr>
				1963
				1964
Alexander Kornienko	395ab2e	2018-04-30 18:12:15 +0000	[diff] [blame]	1965	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BinaryOperator.html">BinaryOperator</a>></td><td class="name" onclick="toggle('isAssignmentOperator0')"><a name="isAssignmentOperator0Anchor">isAssignmentOperator</a></td><td></td></tr>
Peter Szecsi	fff11db	2018-03-27 12:11:46 +0000	[diff] [blame]	1966	<tr><td colspan="4" class="doc" id="isAssignmentOperator0"><pre>Matches all kinds of assignment operators.
				1967
				1968	Example 1: matches a += b (matcher = binaryOperator(isAssignmentOperator()))
				1969	if (a == b)
				1970	a += b;
				1971
Alexander Kornienko	395ab2e	2018-04-30 18:12:15 +0000	[diff] [blame]	1972	Example 2: matches s1 = s2
				1973	(matcher = cxxOperatorCallExpr(isAssignmentOperator()))
				1974	struct S { S& operator=(const S&); };
Peter Szecsi	fff11db	2018-03-27 12:11:46 +0000	[diff] [blame]	1975	void x() { S s1, s2; s1 = s2; })
				1976	</pre></td></tr>
				1977
				1978
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	1979	<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>
				1980	<tr><td colspan="4" class="doc" id="equals5"><pre></pre></td></tr>
				1981
				1982
				1983	<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]	1984	<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]	1985
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	1986	Given
				1987	f('false, 3.14, 42);
				1988	characterLiteral(equals(0))
				1989	matches 'cxxBoolLiteral(equals(false)) and cxxBoolLiteral(equals(0))
				1990	match false
				1991	floatLiteral(equals(3.14)) and floatLiteral(equals(314e-2))
				1992	match 3.14
				1993	integerLiteral(equals(42))
				1994	matches 42
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	1995
Clement Courbet	43bdba4	2017-07-11 15:45:22 +0000	[diff] [blame]	1996	Note that you cannot directly match a negative numeric literal because the
				1997	minus sign is not part of the literal: It is a unary operator whose operand
				1998	is the positive numeric literal. Instead, you must use a unaryOperator()
				1999	matcher to match the minus sign:
				2000
				2001	unaryOperator(hasOperatorName("-"),
				2002	hasUnaryOperand(integerLiteral(equals(13))))
				2003
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2004	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]	2005	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]	2006	</pre></td></tr>
				2007
				2008
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2009	<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>
				2010	<tr><td colspan="4" class="doc" id="equals11"><pre></pre></td></tr>
				2011
				2012
				2013	<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>
				2014	<tr><td colspan="4" class="doc" id="equals8"><pre></pre></td></tr>
				2015
				2016
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2017	<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]	2018	<tr><td colspan="4" class="doc" id="isCatchAll0"><pre>Matches a C++ catch statement that has a catch-all handler.
				2019
				2020	Given
				2021	try {
				2022	...
				2023	} catch (int) {
				2024	...
				2025	} catch (...) {
				2026	...
				2027	}
				2028	endcode
				2029	cxxCatchStmt(isCatchAll()) matches catch(...) but not catch(int).
				2030	</pre></td></tr>
				2031
				2032
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2033	<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]	2034	<tr><td colspan="4" class="doc" id="argumentCountIs1"><pre>Checks that a call expression or a constructor call expression has
				2035	a specific number of arguments (including absent default arguments).
				2036
				2037	Example matches f(0, 0) (matcher = callExpr(argumentCountIs(2)))
				2038	void f(int x, int y);
				2039	f(0, 0);
				2040	</pre></td></tr>
				2041
				2042
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2043	<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]	2044	<tr><td colspan="4" class="doc" id="isListInitialization0"><pre>Matches a constructor call expression which uses list initialization.
				2045	</pre></td></tr>
				2046
				2047
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	2048	<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>
				2049	<tr><td colspan="4" class="doc" id="requiresZeroInitialization0"><pre>Matches a constructor call expression which requires
				2050	zero initialization.
				2051
				2052	Given
				2053	void foo() {
				2054	struct point { double x; double y; };
				2055	point pt[2] = { { 1.0, 2.0 } };
				2056	}
				2057	initListExpr(has(cxxConstructExpr(requiresZeroInitialization()))
				2058	will match the implicit array filler for pt[1].
				2059	</pre></td></tr>
				2060
				2061
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2062	<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]	2063	<tr><td colspan="4" class="doc" id="isCopyConstructor0"><pre>Matches constructor declarations that are copy constructors.
				2064
				2065	Given
				2066	struct S {
				2067	S(); #1
				2068	S(const S &); #2
				2069	S(S &&); #3
				2070	};
				2071	cxxConstructorDecl(isCopyConstructor()) will match #2, but not #1 or #3.
				2072	</pre></td></tr>
				2073
				2074
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2075	<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]	2076	<tr><td colspan="4" class="doc" id="isDefaultConstructor0"><pre>Matches constructor declarations that are default constructors.
				2077
				2078	Given
				2079	struct S {
				2080	S(); #1
				2081	S(const S &); #2
				2082	S(S &&); #3
				2083	};
				2084	cxxConstructorDecl(isDefaultConstructor()) will match #1, but not #2 or #3.
				2085	</pre></td></tr>
				2086
				2087
Alexander Kornienko	7d20a5a	2016-04-13 11:13:08 +0000	[diff] [blame]	2088	<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>
				2089	<tr><td colspan="4" class="doc" id="isDelegatingConstructor0"><pre>Matches constructors that delegate to another constructor.
				2090
				2091	Given
				2092	struct S {
				2093	S(); #1
				2094	S(int) {} #2
				2095	S(S &&) : S() {} #3
				2096	};
				2097	S::S() : S(0) {} #4
				2098	cxxConstructorDecl(isDelegatingConstructor()) will match #3 and #4, but not
				2099	#1 or #2.
				2100	</pre></td></tr>
				2101
				2102
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2103	<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]	2104	<tr><td colspan="4" class="doc" id="isExplicit0"><pre>Matches constructor and conversion declarations that are marked with
				2105	the explicit keyword.
				2106
				2107	Given
				2108	struct S {
				2109	S(int); #1
				2110	explicit S(double); #2
				2111	operator int(); #3
				2112	explicit operator bool(); #4
				2113	};
				2114	cxxConstructorDecl(isExplicit()) will match #2, but not #1.
				2115	cxxConversionDecl(isExplicit()) will match #4, but not #3.
				2116	</pre></td></tr>
				2117
				2118
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2119	<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]	2120	<tr><td colspan="4" class="doc" id="isMoveConstructor0"><pre>Matches constructor declarations that are move constructors.
				2121
				2122	Given
				2123	struct S {
				2124	S(); #1
				2125	S(const S &); #2
				2126	S(S &&); #3
				2127	};
				2128	cxxConstructorDecl(isMoveConstructor()) will match #3, but not #1 or #2.
				2129	</pre></td></tr>
				2130
				2131
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2132	<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]	2133	<tr><td colspan="4" class="doc" id="isExplicit1"><pre>Matches constructor and conversion declarations that are marked with
				2134	the explicit keyword.
				2135
				2136	Given
				2137	struct S {
				2138	S(int); #1
				2139	explicit S(double); #2
				2140	operator int(); #3
				2141	explicit operator bool(); #4
				2142	};
				2143	cxxConstructorDecl(isExplicit()) will match #2, but not #1.
				2144	cxxConversionDecl(isExplicit()) will match #4, but not #3.
				2145	</pre></td></tr>
				2146
				2147
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2148	<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]	2149	<tr><td colspan="4" class="doc" id="isBaseInitializer0"><pre>Matches a constructor initializer if it is initializing a base, as
				2150	opposed to a member.
				2151
				2152	Given
				2153	struct B {};
				2154	struct D : B {
				2155	int I;
				2156	D(int i) : I(i) {}
				2157	};
				2158	struct E : B {
				2159	E() : B() {}
				2160	};
				2161	cxxConstructorDecl(hasAnyConstructorInitializer(isBaseInitializer()))
				2162	will match E(), but not match D(int).
				2163	</pre></td></tr>
				2164
				2165
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2166	<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]	2167	<tr><td colspan="4" class="doc" id="isMemberInitializer0"><pre>Matches a constructor initializer if it is initializing a member, as
				2168	opposed to a base.
				2169
				2170	Given
				2171	struct B {};
				2172	struct D : B {
				2173	int I;
				2174	D(int i) : I(i) {}
				2175	};
				2176	struct E : B {
				2177	E() : B() {}
				2178	};
				2179	cxxConstructorDecl(hasAnyConstructorInitializer(isMemberInitializer()))
				2180	will match D(int), but not match E().
				2181	</pre></td></tr>
				2182
				2183
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2184	<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]	2185	<tr><td colspan="4" class="doc" id="isWritten0"><pre>Matches a constructor initializer if it is explicitly written in
				2186	code (as opposed to implicitly added by the compiler).
				2187
				2188	Given
				2189	struct Foo {
				2190	Foo() { }
				2191	Foo(int) : foo_("A") { }
				2192	string foo_;
				2193	};
				2194	cxxConstructorDecl(hasAnyConstructorInitializer(isWritten()))
				2195	will match Foo(int), but not Foo()
				2196	</pre></td></tr>
				2197
				2198
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2199	<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]	2200	<tr><td colspan="4" class="doc" id="isConst0"><pre>Matches if the given method declaration is const.
				2201
				2202	Given
				2203	struct A {
				2204	void foo() const;
				2205	void bar();
				2206	};
				2207
				2208	cxxMethodDecl(isConst()) matches A::foo() but not A::bar()
				2209	</pre></td></tr>
				2210
				2211
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2212	<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]	2213	<tr><td colspan="4" class="doc" id="isCopyAssignmentOperator0"><pre>Matches if the given method declaration declares a copy assignment
				2214	operator.
				2215
				2216	Given
				2217	struct A {
				2218	A &operator=(const A &);
				2219	A &operator=(A &&);
				2220	};
				2221
				2222	cxxMethodDecl(isCopyAssignmentOperator()) matches the first method but not
				2223	the second one.
				2224	</pre></td></tr>
				2225
				2226
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2227	<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]	2228	<tr><td colspan="4" class="doc" id="isFinal1"><pre>Matches if the given method or class declaration is final.
				2229
				2230	Given:
				2231	class A final {};
				2232
				2233	struct B {
				2234	virtual void f();
				2235	};
				2236
				2237	struct C : B {
				2238	void f() final;
				2239	};
				2240	matches A and C::f, but not B, C, or B::f
				2241	</pre></td></tr>
				2242
				2243
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2244	<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]	2245	<tr><td colspan="4" class="doc" id="isMoveAssignmentOperator0"><pre>Matches if the given method declaration declares a move assignment
				2246	operator.
				2247
				2248	Given
Aaron Ballman	a681151	2016-01-23 17:49:18 +0000	[diff] [blame]	2249	struct A {
				2250	A &operator=(const A &);
				2251	A &operator=(A &&);
				2252	};
				2253
				2254	cxxMethodDecl(isMoveAssignmentOperator()) matches the second method but not
				2255	the first one.
Aaron Ballman	31bde87	2016-01-22 22:37:09 +0000	[diff] [blame]	2256	</pre></td></tr>
				2257
				2258
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2259	<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]	2260	<tr><td colspan="4" class="doc" id="isOverride0"><pre>Matches if the given method declaration overrides another method.
				2261
				2262	Given
				2263	class A {
				2264	public:
				2265	virtual void x();
				2266	};
				2267	class B : public A {
				2268	public:
				2269	virtual void x();
				2270	};
				2271	matches B::x
				2272	</pre></td></tr>
				2273
				2274
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2275	<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]	2276	<tr><td colspan="4" class="doc" id="isPure0"><pre>Matches if the given method declaration is pure.
				2277
				2278	Given
				2279	class A {
				2280	public:
				2281	virtual void x() = 0;
				2282	};
				2283	matches A::x
				2284	</pre></td></tr>
				2285
				2286
Alexander Kornienko	7d20a5a	2016-04-13 11:13:08 +0000	[diff] [blame]	2287	<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>
				2288	<tr><td colspan="4" class="doc" id="isUserProvided0"><pre>Matches method declarations that are user-provided.
				2289
				2290	Given
				2291	struct S {
				2292	S(); #1
				2293	S(const S &) = default; #2
				2294	S(S &&) = delete; #3
				2295	};
				2296	cxxConstructorDecl(isUserProvided()) will match #1, but not #2 or #3.
				2297	</pre></td></tr>
				2298
				2299
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2300	<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]	2301	<tr><td colspan="4" class="doc" id="isVirtual0"><pre>Matches if the given method declaration is virtual.
				2302
				2303	Given
				2304	class A {
				2305	public:
				2306	virtual void x();
				2307	};
				2308	matches A::x
				2309	</pre></td></tr>
				2310
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2311
				2312	<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]	2313	<tr><td colspan="4" class="doc" id="isVirtualAsWritten0"><pre>Matches if the given method declaration has an explicit "virtual".
				2314
				2315	Given
				2316	class A {
				2317	public:
				2318	virtual void x();
				2319	};
				2320	class B : public A {
				2321	public:
				2322	void x();
				2323	};
				2324	matches A::x but not B::x
				2325	</pre></td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2326
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2327
Adam Balogh	da488a6	2017-11-23 12:43:20 +0000	[diff] [blame]	2328	<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>
				2329	<tr><td colspan="4" class="doc" id="isArray0"><pre>Matches array new expressions.
				2330
				2331	Given:
				2332	MyClass *p1 = new MyClass[10];
				2333	cxxNewExpr(isArray())
				2334	matches the expression 'new MyClass[10]'.
				2335	</pre></td></tr>
				2336
				2337
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2338	<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]	2339	<tr><td colspan="4" class="doc" id="hasOverloadedOperatorName1"><pre>Matches overloaded operator names.
				2340
				2341	Matches overloaded operator names specified in strings without the
				2342	"operator" prefix: e.g. "<<".
				2343
				2344	Given:
				2345	class A { int operator*(); };
				2346	const A &operator<<(const A &a, const A &b);
				2347	A a;
				2348	a << a; <-- This matches
				2349
				2350	cxxOperatorCallExpr(hasOverloadedOperatorName("<<"))) matches the
				2351	specified line and
				2352	cxxRecordDecl(hasMethod(hasOverloadedOperatorName("*")))
				2353	matches the declaration of A.
				2354
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2355	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]	2356	</pre></td></tr>
				2357
				2358
Alexander Kornienko	395ab2e	2018-04-30 18:12:15 +0000	[diff] [blame]	2359	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1CXXOperatorCallExpr.html">CXXOperatorCallExpr</a>></td><td class="name" onclick="toggle('isAssignmentOperator1')"><a name="isAssignmentOperator1Anchor">isAssignmentOperator</a></td><td></td></tr>
Peter Szecsi	fff11db	2018-03-27 12:11:46 +0000	[diff] [blame]	2360	<tr><td colspan="4" class="doc" id="isAssignmentOperator1"><pre>Matches all kinds of assignment operators.
				2361
				2362	Example 1: matches a += b (matcher = binaryOperator(isAssignmentOperator()))
				2363	if (a == b)
				2364	a += b;
				2365
Alexander Kornienko	395ab2e	2018-04-30 18:12:15 +0000	[diff] [blame]	2366	Example 2: matches s1 = s2
				2367	(matcher = cxxOperatorCallExpr(isAssignmentOperator()))
				2368	struct S { S& operator=(const S&); };
Peter Szecsi	fff11db	2018-03-27 12:11:46 +0000	[diff] [blame]	2369	void x() { S s1, s2; s1 = s2; })
				2370	</pre></td></tr>
				2371
				2372
Aaron Ballman	813e36c	2017-11-29 21:21:51 +0000	[diff] [blame]	2373	<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>
				2374	<tr><td colspan="4" class="doc" id="hasDefinition0"><pre>Matches a class declaration that is defined.
				2375
				2376	Example matches x (matcher = cxxRecordDecl(hasDefinition()))
				2377	class x {};
				2378	class y;
				2379	</pre></td></tr>
				2380
				2381
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2382	<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]	2383	<tr><td colspan="4" class="doc" id="isDerivedFrom1"><pre>Overloaded method as shortcut for isDerivedFrom(hasName(...)).
				2384	</pre></td></tr>
				2385
				2386
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2387	<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]	2388	<tr><td colspan="4" class="doc" id="isExplicitTemplateSpecialization2"><pre>Matches explicit template specializations of function, class, or
				2389	static member variable template instantiations.
				2390
				2391	Given
				2392	template<typename T> void A(T t) { }
				2393	template<> void A(int N) { }
				2394	functionDecl(isExplicitTemplateSpecialization())
				2395	matches the specialization A<int>().
				2396
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2397	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]	2398	</pre></td></tr>
				2399
				2400
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2401	<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]	2402	<tr><td colspan="4" class="doc" id="isFinal0"><pre>Matches if the given method or class declaration is final.
				2403
				2404	Given:
				2405	class A final {};
				2406
				2407	struct B {
				2408	virtual void f();
				2409	};
				2410
				2411	struct C : B {
				2412	void f() final;
				2413	};
				2414	matches A and C::f, but not B, C, or B::f
				2415	</pre></td></tr>
				2416
				2417
Samuel Benzaquen	49385c7	2016-06-28 14:08:56 +0000	[diff] [blame]	2418	<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>
				2419	<tr><td colspan="4" class="doc" id="isLambda0"><pre>Matches the generated class of lambda expressions.
				2420
				2421	Given:
				2422	auto x = []{};
				2423
				2424	cxxRecordDecl(isLambda()) matches the implicit class declaration of
				2425	decltype(x)
				2426	</pre></td></tr>
				2427
				2428
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2429	<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]	2430	<tr><td colspan="4" class="doc" id="isSameOrDerivedFrom1"><pre>Overloaded method as shortcut for
				2431	isSameOrDerivedFrom(hasName(...)).
				2432	</pre></td></tr>
				2433
				2434
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2435	<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]	2436	<tr><td colspan="4" class="doc" id="isTemplateInstantiation2"><pre>Matches template instantiations of function, class, or static
				2437	member variable template instantiations.
				2438
				2439	Given
				2440	template <typename T> class X {}; class A {}; X<A> x;
				2441	or
				2442	template <typename T> class X {}; class A {}; template class X<A>;
Eric Liu	09ee48e	2018-02-21 14:22:42 +0000	[diff] [blame]	2443	or
				2444	template <typename T> class X {}; class A {}; extern template class X<A>;
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2445	cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
				2446	matches the template instantiation of X<A>.
				2447
				2448	But given
				2449	template <typename T> class X {}; class A {};
				2450	template <> class X<A> {}; X<A> x;
				2451	cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
				2452	does not match, as X<A> is an explicit template specialization.
				2453
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2454	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]	2455	</pre></td></tr>
				2456
				2457
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2458	<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]	2459	<tr><td colspan="4" class="doc" id="argumentCountIs0"><pre>Checks that a call expression or a constructor call expression has
				2460	a specific number of arguments (including absent default arguments).
				2461
				2462	Example matches f(0, 0) (matcher = callExpr(argumentCountIs(2)))
				2463	void f(int x, int y);
				2464	f(0, 0);
				2465	</pre></td></tr>
				2466
				2467
Etienne Bergeron	75e5272	2016-05-13 19:36:55 +0000	[diff] [blame]	2468	<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>
				2469	<tr><td colspan="4" class="doc" id="hasCastKind0"><pre>Matches casts that has a given cast kind.
				2470
				2471	Example: matches the implicit cast around 0
				2472	(matcher = castExpr(hasCastKind(CK_NullToPointer)))
				2473	int *p = 0;
				2474	</pre></td></tr>
				2475
				2476
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	2477	<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>
				2478	<tr><td colspan="4" class="doc" id="equals4"><pre></pre></td></tr>
				2479
				2480
				2481	<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]	2482	<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]	2483
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2484	Given
				2485	f('false, 3.14, 42);
				2486	characterLiteral(equals(0))
				2487	matches 'cxxBoolLiteral(equals(false)) and cxxBoolLiteral(equals(0))
				2488	match false
				2489	floatLiteral(equals(3.14)) and floatLiteral(equals(314e-2))
				2490	match 3.14
				2491	integerLiteral(equals(42))
				2492	matches 42
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2493
Clement Courbet	43bdba4	2017-07-11 15:45:22 +0000	[diff] [blame]	2494	Note that you cannot directly match a negative numeric literal because the
				2495	minus sign is not part of the literal: It is a unary operator whose operand
				2496	is the positive numeric literal. Instead, you must use a unaryOperator()
				2497	matcher to match the minus sign:
				2498
				2499	unaryOperator(hasOperatorName("-"),
				2500	hasUnaryOperand(integerLiteral(equals(13))))
				2501
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2502	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]	2503	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]	2504	</pre></td></tr>
				2505
				2506
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2507	<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>
				2508	<tr><td colspan="4" class="doc" id="equals10"><pre></pre></td></tr>
				2509
				2510
				2511	<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>
				2512	<tr><td colspan="4" class="doc" id="equals7"><pre></pre></td></tr>
				2513
				2514
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2515	<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]	2516	<tr><td colspan="4" class="doc" id="templateArgumentCountIs0"><pre>Matches if the number of template arguments equals N.
				2517
				2518	Given
				2519	template<typename T> struct C {};
				2520	C<int> c;
				2521	classTemplateSpecializationDecl(templateArgumentCountIs(1))
				2522	matches C<int>.
				2523	</pre></td></tr>
				2524
				2525
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2526	<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]	2527	<tr><td colspan="4" class="doc" id="statementCountIs0"><pre>Checks that a compound statement contains a specific number of
				2528	child statements.
				2529
				2530	Example: Given
				2531	{ for (;;) {} }
				2532	compoundStmt(statementCountIs(0)))
				2533	matches '{}'
				2534	but does not match the outer compound statement.
				2535	</pre></td></tr>
				2536
				2537
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2538	<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]	2539	<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]	2540
				2541	Given
				2542	int a[42];
				2543	int b[2 * 21];
				2544	int c[41], d[43];
Etienne Bergeron	3588be7	2016-05-12 04:20:04 +0000	[diff] [blame]	2545	char *s = "abcd";
				2546	wchar_t *ws = L"abcd";
				2547	char *w = "a";
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2548	constantArrayType(hasSize(42))
				2549	matches "int a[42]" and "int b[2 * 21]"
Etienne Bergeron	3588be7	2016-05-12 04:20:04 +0000	[diff] [blame]	2550	stringLiteral(hasSize(4))
				2551	matches "abcd", L"abcd"
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2552	</pre></td></tr>
				2553
				2554
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2555	<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]	2556	<tr><td colspan="4" class="doc" id="declCountIs0"><pre>Matches declaration statements that contain a specific number of
				2557	declarations.
				2558
				2559	Example: Given
				2560	int a, b;
				2561	int c;
				2562	int d = 2, e;
				2563	declCountIs(2)
				2564	matches 'int a, b;' and 'int d = 2, e;', but not 'int c;'.
				2565	</pre></td></tr>
				2566
				2567
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2568	<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]	2569	<tr><td colspan="4" class="doc" id="equalsBoundNode1"><pre>Matches if a node equals a previously bound node.
				2570
				2571	Matches a node if it equals the node previously bound to ID.
				2572
				2573	Given
				2574	class X { int a; int b; };
				2575	cxxRecordDecl(
				2576	has(fieldDecl(hasName("a"), hasType(type().bind("t")))),
				2577	has(fieldDecl(hasName("b"), hasType(type(equalsBoundNode("t"))))))
				2578	matches the class X, as a and b have the same type.
				2579
				2580	Note that when multiple matches are involved via forEach* matchers,
				2581	equalsBoundNodes acts as a filter.
				2582	For example:
				2583	compoundStmt(
				2584	forEachDescendant(varDecl().bind("d")),
				2585	forEachDescendant(declRefExpr(to(decl(equalsBoundNode("d"))))))
				2586	will trigger a match for each combination of variable declaration
				2587	and reference to that variable declaration within a compound statement.
				2588	</pre></td></tr>
				2589
				2590
Samuel Benzaquen	a4076ea	2016-05-04 20:45:00 +0000	[diff] [blame]	2591	<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>
				2592	<tr><td colspan="4" class="doc" id="equalsNode0"><pre>Matches if a node equals another node.
				2593
				2594	Decl has pointer identity in the AST.
				2595	</pre></td></tr>
				2596
				2597
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2598	<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]	2599	<tr><td colspan="4" class="doc" id="hasAttr0"><pre>Matches declaration that has a given attribute.
				2600
				2601	Given
				2602	__attribute__((device)) void f() { ... }
				2603	decl(hasAttr(clang::attr::CUDADevice)) matches the function declaration of
				2604	f. If the matcher is use from clang-query, attr::Kind parameter should be
				2605	passed as a quoted string. e.g., hasAttr("attr::CUDADevice").
				2606	</pre></td></tr>
				2607
				2608
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2609	<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]	2610	<tr><td colspan="4" class="doc" id="isExpansionInFileMatching0"><pre>Matches AST nodes that were expanded within files whose name is
				2611	partially matching a given regex.
				2612
				2613	Example matches Y but not X
				2614	(matcher = cxxRecordDecl(isExpansionInFileMatching("AST.*"))
				2615	#include "ASTMatcher.h"
				2616	class X {};
				2617	ASTMatcher.h:
				2618	class Y {};
				2619
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2620	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]	2621	</pre></td></tr>
				2622
				2623
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2624	<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]	2625	<tr><td colspan="4" class="doc" id="isExpansionInMainFile0"><pre>Matches AST nodes that were expanded within the main-file.
				2626
				2627	Example matches X but not Y
				2628	(matcher = cxxRecordDecl(isExpansionInMainFile())
				2629	#include <Y.h>
				2630	class X {};
				2631	Y.h:
				2632	class Y {};
				2633
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2634	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]	2635	</pre></td></tr>
				2636
				2637
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2638	<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]	2639	<tr><td colspan="4" class="doc" id="isExpansionInSystemHeader0"><pre>Matches AST nodes that were expanded within system-header-files.
				2640
				2641	Example matches Y but not X
				2642	(matcher = cxxRecordDecl(isExpansionInSystemHeader())
				2643	#include <SystemHeader.h>
				2644	class X {};
				2645	SystemHeader.h:
				2646	class Y {};
				2647
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2648	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]	2649	</pre></td></tr>
				2650
				2651
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2652	<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]	2653	<tr><td colspan="4" class="doc" id="isImplicit0"><pre>Matches a declaration that has been implicitly added
				2654	by the compiler (eg. implicit defaultcopy constructors).
				2655	</pre></td></tr>
				2656
				2657
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2658	<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]	2659	<tr><td colspan="4" class="doc" id="isPrivate0"><pre>Matches private C++ declarations.
				2660
				2661	Given
				2662	class C {
				2663	public: int a;
				2664	protected: int b;
				2665	private: int c;
				2666	};
				2667	fieldDecl(isPrivate())
Cong Liu	8a02efb	2016-06-24 09:38:03 +0000	[diff] [blame]	2668	matches 'int c;'
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2669	</pre></td></tr>
				2670
				2671
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2672	<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]	2673	<tr><td colspan="4" class="doc" id="isProtected0"><pre>Matches protected C++ declarations.
				2674
				2675	Given
				2676	class C {
				2677	public: int a;
				2678	protected: int b;
				2679	private: int c;
				2680	};
				2681	fieldDecl(isProtected())
Cong Liu	8a02efb	2016-06-24 09:38:03 +0000	[diff] [blame]	2682	matches 'int b;'
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2683	</pre></td></tr>
				2684
				2685
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2686	<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]	2687	<tr><td colspan="4" class="doc" id="isPublic0"><pre>Matches public C++ declarations.
				2688
				2689	Given
				2690	class C {
				2691	public: int a;
				2692	protected: int b;
				2693	private: int c;
				2694	};
				2695	fieldDecl(isPublic())
Cong Liu	8a02efb	2016-06-24 09:38:03 +0000	[diff] [blame]	2696	matches 'int a;'
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2697	</pre></td></tr>
				2698
				2699
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	2700	<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>
				2701	<tr><td colspan="4" class="doc" id="designatorCountIs0"><pre>Matches designated initializer expressions that contain
				2702	a specific number of designators.
				2703
				2704	Example: Given
				2705	point ptarray[10] = { [2].y = 1.0, [0].x = 1.0 };
				2706	point ptarray2[10] = { [2].y = 1.0, [2].x = 0.0, [0].x = 1.0 };
				2707	designatorCountIs(2)
				2708	matches '{ [2].y = 1.0, [0].x = 1.0 }',
				2709	but not '{ [2].y = 1.0, [2].x = 0.0, [0].x = 1.0 }'.
				2710	</pre></td></tr>
				2711
				2712
Haojian Wu	9c3be3a	2018-01-18 09:47:57 +0000	[diff] [blame]	2713	<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>
				2714	<tr><td colspan="4" class="doc" id="isScoped0"><pre>Matches C++11 scoped enum declaration.
				2715
				2716	Example matches Y (matcher = enumDecl(isScoped()))
				2717	enum X {};
				2718	enum class Y {};
				2719	</pre></td></tr>
				2720
				2721
Aaron Ballman	5c57434	2016-07-06 18:25:16 +0000	[diff] [blame]	2722	<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]	2723	<tr><td colspan="4" class="doc" id="hasBitWidth0"><pre>Matches non-static data members that are bit-fields of the specified
				2724	bit width.
Aaron Ballman	5c57434	2016-07-06 18:25:16 +0000	[diff] [blame]	2725
				2726	Given
				2727	class C {
				2728	int a : 2;
				2729	int b : 4;
				2730	int c : 2;
				2731	};
Malcolm Parsons	81e48b2	2016-12-24 13:22:26 +0000	[diff] [blame]	2732	fieldDecl(hasBitWidth(2))
Aaron Ballman	5c57434	2016-07-06 18:25:16 +0000	[diff] [blame]	2733	matches 'int a;' and 'int c;' but not 'int b;'.
				2734	</pre></td></tr>
				2735
				2736
				2737	<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>
				2738	<tr><td colspan="4" class="doc" id="isBitField0"><pre>Matches non-static data members that are bit-fields.
				2739
				2740	Given
				2741	class C {
				2742	int a : 2;
				2743	int b;
				2744	};
				2745	fieldDecl(isBitField())
				2746	matches 'int a;' but not 'int b;'.
				2747	</pre></td></tr>
				2748
				2749
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	2750	<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]	2751	<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]	2752
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2753	Given
				2754	f('false, 3.14, 42);
				2755	characterLiteral(equals(0))
				2756	matches 'cxxBoolLiteral(equals(false)) and cxxBoolLiteral(equals(0))
				2757	match false
				2758	floatLiteral(equals(3.14)) and floatLiteral(equals(314e-2))
				2759	match 3.14
				2760	integerLiteral(equals(42))
				2761	matches 42
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2762
Clement Courbet	43bdba4	2017-07-11 15:45:22 +0000	[diff] [blame]	2763	Note that you cannot directly match a negative numeric literal because the
				2764	minus sign is not part of the literal: It is a unary operator whose operand
				2765	is the positive numeric literal. Instead, you must use a unaryOperator()
				2766	matcher to match the minus sign:
				2767
				2768	unaryOperator(hasOperatorName("-"),
				2769	hasUnaryOperand(integerLiteral(equals(13))))
				2770
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2771	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]	2772	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]	2773	</pre></td></tr>
				2774
				2775
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	2776	<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>
				2777	<tr><td colspan="4" class="doc" id="equals12"><pre></pre></td></tr>
				2778
				2779
Aaron Ballman	abdbbbc	2016-05-16 16:49:01 +0000	[diff] [blame]	2780	<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>
				2781	<tr><td colspan="4" class="doc" id="hasDynamicExceptionSpec0"><pre>Matches functions that have a dynamic exception specification.
				2782
				2783	Given:
				2784	void f();
				2785	void g() noexcept;
				2786	void h() noexcept(true);
				2787	void i() noexcept(false);
				2788	void j() throw();
				2789	void k() throw(int);
				2790	void l() throw(...);
Aaron Ballman	230ad97	2016-06-07 17:34:45 +0000	[diff] [blame]	2791	functionDecl(hasDynamicExceptionSpec()) and
				2792	functionProtoType(hasDynamicExceptionSpec())
				2793	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]	2794	</pre></td></tr>
				2795
				2796
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2797	<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]	2798	<tr><td colspan="4" class="doc" id="hasOverloadedOperatorName0"><pre>Matches overloaded operator names.
				2799
				2800	Matches overloaded operator names specified in strings without the
				2801	"operator" prefix: e.g. "<<".
				2802
				2803	Given:
				2804	class A { int operator*(); };
				2805	const A &operator<<(const A &a, const A &b);
				2806	A a;
				2807	a << a; <-- This matches
				2808
				2809	cxxOperatorCallExpr(hasOverloadedOperatorName("<<"))) matches the
				2810	specified line and
				2811	cxxRecordDecl(hasMethod(hasOverloadedOperatorName("*")))
				2812	matches the declaration of A.
				2813
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2814	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]	2815	</pre></td></tr>
				2816
				2817
Julie Hockett	239d25a	2018-01-22 22:45:23 +0000	[diff] [blame]	2818	<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>
				2819	<tr><td colspan="4" class="doc" id="hasTrailingReturn0"><pre>Matches a function declared with a trailing return type.
				2820
				2821	Example matches Y (matcher = functionDecl(hasTrailingReturn()))
				2822	int X() {}
				2823	auto Y() -> int {}
				2824	</pre></td></tr>
				2825
				2826
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2827	<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>
Gabor Horvath	3cd0aa3	2018-05-08 11:53:32 +0000	[diff] [blame]	2828	<tr><td colspan="4" class="doc" id="isConstexpr1"><pre>Matches constexpr variable and function declarations,
				2829	and if constexpr.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2830
				2831	Given:
				2832	constexpr int foo = 42;
				2833	constexpr int bar();
Gabor Horvath	3cd0aa3	2018-05-08 11:53:32 +0000	[diff] [blame]	2834	void baz() { if constexpr(1 > 0) {} }
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2835	varDecl(isConstexpr())
				2836	matches the declaration of foo.
				2837	functionDecl(isConstexpr())
				2838	matches the declaration of bar.
Gabor Horvath	3cd0aa3	2018-05-08 11:53:32 +0000	[diff] [blame]	2839	ifStmt(isConstexpr())
				2840	matches the if statement in baz.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2841	</pre></td></tr>
				2842
				2843
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2844	<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]	2845	<tr><td colspan="4" class="doc" id="isDefaulted0"><pre>Matches defaulted function declarations.
				2846
				2847	Given:
				2848	class A { ~A(); };
				2849	class B { ~B() = default; };
				2850	functionDecl(isDefaulted())
				2851	matches the declaration of ~B, but not ~A.
				2852	</pre></td></tr>
				2853
				2854
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	2855	<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>
				2856	<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]	2857
				2858	Example matches A, va, fa
				2859	class A {};
				2860	class B; Doesn't match, as it has no body.
				2861	int va;
				2862	extern int vb; Doesn't match, as it doesn't define the variable.
				2863	void fa() {}
				2864	void fb(); Doesn't match, as it has no body.
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	2865	@interface X
				2866	- (void)ma; Doesn't match, interface is declaration.
				2867	@end
				2868	@implementation X
				2869	- (void)ma {}
				2870	@end
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2871
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	2872	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>>,
				2873	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]	2874	</pre></td></tr>
				2875
				2876
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2877	<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]	2878	<tr><td colspan="4" class="doc" id="isDeleted0"><pre>Matches deleted function declarations.
				2879
				2880	Given:
				2881	void Func();
				2882	void DeletedFunc() = delete;
				2883	functionDecl(isDeleted())
				2884	matches the declaration of DeletedFunc, but not Func.
				2885	</pre></td></tr>
				2886
				2887
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2888	<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]	2889	<tr><td colspan="4" class="doc" id="isExplicitTemplateSpecialization0"><pre>Matches explicit template specializations of function, class, or
				2890	static member variable template instantiations.
				2891
				2892	Given
				2893	template<typename T> void A(T t) { }
				2894	template<> void A(int N) { }
				2895	functionDecl(isExplicitTemplateSpecialization())
				2896	matches the specialization A<int>().
				2897
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2898	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]	2899	</pre></td></tr>
				2900
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	2901
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2902	<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]	2903	<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]	2904
				2905	Given:
				2906	extern "C" void f() {}
				2907	extern "C" { void g() {} }
				2908	void h() {}
Alexander Shaposhnikov	f681c4e	2017-09-22 19:29:38 +0000	[diff] [blame]	2909	extern "C" int x = 1;
				2910	extern "C" int y = 2;
				2911	int z = 3;
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2912	functionDecl(isExternC())
Alexander Shaposhnikov	f681c4e	2017-09-22 19:29:38 +0000	[diff] [blame]	2913	matches the declaration of f and g, but not the declaration of h.
				2914	varDecl(isExternC())
				2915	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]	2916	</pre></td></tr>
				2917
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	2918
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2919	<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]	2920	<tr><td colspan="4" class="doc" id="isInline1"><pre>Matches function and namespace declarations that are marked with
				2921	the inline keyword.
				2922
				2923	Given
				2924	inline void f();
				2925	void g();
				2926	namespace n {
				2927	inline namespace m {}
				2928	}
				2929	functionDecl(isInline()) will match ::f().
				2930	namespaceDecl(isInline()) will match n::m.
				2931	</pre></td></tr>
				2932
				2933
George Karpenkov	fc3d72e	2018-07-23 22:29:35 +0000	[diff] [blame]	2934	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FunctionDecl.html">FunctionDecl</a>></td><td class="name" onclick="toggle('isMain0')"><a name="isMain0Anchor">isMain</a></td><td></td></tr>
				2935	<tr><td colspan="4" class="doc" id="isMain0"><pre>Determines whether the function is "main", which is the entry point
				2936	into an executable program.
				2937	</pre></td></tr>
				2938
				2939
Roman Lebedev	6c3871b	2018-01-17 19:40:55 +0000	[diff] [blame]	2940	<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>
				2941	<tr><td colspan="4" class="doc" id="isNoReturn0"><pre>Matches FunctionDecls that have a noreturn attribute.
				2942
				2943	Given
				2944	void nope();
				2945	[[noreturn]] void a();
				2946	__attribute__((noreturn)) void b();
				2947	struct c { [[noreturn]] c(); };
				2948	functionDecl(isNoReturn())
				2949	matches all of those except
				2950	void nope();
				2951	</pre></td></tr>
				2952
				2953
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2954	<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]	2955	<tr><td colspan="4" class="doc" id="isNoThrow0"><pre>Matches functions that have a non-throwing exception specification.
				2956
				2957	Given:
				2958	void f();
				2959	void g() noexcept;
				2960	void h() throw();
				2961	void i() throw(int);
				2962	void j() noexcept(false);
Aaron Ballman	230ad97	2016-06-07 17:34:45 +0000	[diff] [blame]	2963	functionDecl(isNoThrow()) and functionProtoType(isNoThrow())
				2964	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]	2965	</pre></td></tr>
				2966
				2967
Haojian Wu	b3d2546	2016-09-26 16:01:52 +0000	[diff] [blame]	2968	<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]	2969	<tr><td colspan="4" class="doc" id="isStaticStorageClass0"><pre>Matches variablefunction declarations that have "static" storage
				2970	class specifier ("static" keyword) written in the source.
Haojian Wu	b3d2546	2016-09-26 16:01:52 +0000	[diff] [blame]	2971
				2972	Given:
				2973	static void f() {}
				2974	static int i = 0;
Haojian Wu	398a8ea	2016-09-27 07:53:20 +0000	[diff] [blame]	2975	extern int j;
				2976	int k;
Haojian Wu	b3d2546	2016-09-26 16:01:52 +0000	[diff] [blame]	2977	functionDecl(isStaticStorageClass())
				2978	matches the function declaration f.
				2979	varDecl(isStaticStorageClass())
				2980	matches the variable declaration i.
				2981	</pre></td></tr>
				2982
				2983
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	2984	<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]	2985	<tr><td colspan="4" class="doc" id="isTemplateInstantiation0"><pre>Matches template instantiations of function, class, or static
				2986	member variable template instantiations.
				2987
				2988	Given
				2989	template <typename T> class X {}; class A {}; X<A> x;
				2990	or
				2991	template <typename T> class X {}; class A {}; template class X<A>;
Eric Liu	09ee48e	2018-02-21 14:22:42 +0000	[diff] [blame]	2992	or
				2993	template <typename T> class X {}; class A {}; extern template class X<A>;
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	2994	cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
				2995	matches the template instantiation of X<A>.
				2996
				2997	But given
				2998	template <typename T> class X {}; class A {};
				2999	template <> class X<A> {}; X<A> x;
				3000	cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
				3001	does not match, as X<A> is an explicit template specialization.
				3002
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3003	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]	3004	</pre></td></tr>
				3005
				3006
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3007	<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]	3008	<tr><td colspan="4" class="doc" id="isVariadic0"><pre>Matches if a function declaration is variadic.
				3009
				3010	Example matches f, but not g or h. The function i will not match, even when
				3011	compiled in C mode.
				3012	void f(...);
				3013	void g(int);
				3014	template <typename... Ts> void h(Ts...);
				3015	void i();
				3016	</pre></td></tr>
				3017
				3018
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3019	<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]	3020	<tr><td colspan="4" class="doc" id="parameterCountIs0"><pre>Matches FunctionDecls and FunctionProtoTypes that have a
				3021	specific parameter count.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3022
				3023	Given
				3024	void f(int i) {}
				3025	void g(int i, int j) {}
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	3026	void h(int i, int j);
				3027	void j(int i);
				3028	void k(int x, int y, int z, ...);
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3029	functionDecl(parameterCountIs(2))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3030	matches g and h
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	3031	functionProtoType(parameterCountIs(2))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3032	matches g and h
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	3033	functionProtoType(parameterCountIs(3))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3034	matches k
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	3035	</pre></td></tr>
				3036
				3037
Aaron Ballman	230ad97	2016-06-07 17:34:45 +0000	[diff] [blame]	3038	<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>
				3039	<tr><td colspan="4" class="doc" id="hasDynamicExceptionSpec1"><pre>Matches functions that have a dynamic exception specification.
				3040
				3041	Given:
				3042	void f();
				3043	void g() noexcept;
				3044	void h() noexcept(true);
				3045	void i() noexcept(false);
				3046	void j() throw();
				3047	void k() throw(int);
				3048	void l() throw(...);
				3049	functionDecl(hasDynamicExceptionSpec()) and
				3050	functionProtoType(hasDynamicExceptionSpec())
				3051	match the declarations of j, k, and l, but not f, g, h, or i.
				3052	</pre></td></tr>
				3053
				3054
				3055	<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>
				3056	<tr><td colspan="4" class="doc" id="isNoThrow1"><pre>Matches functions that have a non-throwing exception specification.
				3057
				3058	Given:
				3059	void f();
				3060	void g() noexcept;
				3061	void h() throw();
				3062	void i() throw(int);
				3063	void j() noexcept(false);
				3064	functionDecl(isNoThrow()) and functionProtoType(isNoThrow())
				3065	match the declarations of g, and h, but not f, i or j.
				3066	</pre></td></tr>
				3067
				3068
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	3069	<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>
				3070	<tr><td colspan="4" class="doc" id="parameterCountIs1"><pre>Matches FunctionDecls and FunctionProtoTypes that have a
				3071	specific parameter count.
				3072
				3073	Given
				3074	void f(int i) {}
				3075	void g(int i, int j) {}
				3076	void h(int i, int j);
				3077	void j(int i);
				3078	void k(int x, int y, int z, ...);
				3079	functionDecl(parameterCountIs(2))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3080	matches g and h
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	3081	functionProtoType(parameterCountIs(2))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3082	matches g and h
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	3083	functionProtoType(parameterCountIs(3))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3084	matches k
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3085	</pre></td></tr>
				3086
				3087
Gabor Horvath	3cd0aa3	2018-05-08 11:53:32 +0000	[diff] [blame]	3088	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1IfStmt.html">IfStmt</a>></td><td class="name" onclick="toggle('isConstexpr2')"><a name="isConstexpr2Anchor">isConstexpr</a></td><td></td></tr>
				3089	<tr><td colspan="4" class="doc" id="isConstexpr2"><pre>Matches constexpr variable and function declarations,
				3090	and if constexpr.
				3091
				3092	Given:
				3093	constexpr int foo = 42;
				3094	constexpr int bar();
				3095	void baz() { if constexpr(1 > 0) {} }
				3096	varDecl(isConstexpr())
				3097	matches the declaration of foo.
				3098	functionDecl(isConstexpr())
				3099	matches the declaration of bar.
				3100	ifStmt(isConstexpr())
				3101	matches the if statement in baz.
				3102	</pre></td></tr>
				3103
				3104
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	3105	<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>
				3106	<tr><td colspan="4" class="doc" id="equals6"><pre></pre></td></tr>
				3107
				3108
				3109	<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]	3110	<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]	3111
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	3112	Given
				3113	f('false, 3.14, 42);
				3114	characterLiteral(equals(0))
				3115	matches 'cxxBoolLiteral(equals(false)) and cxxBoolLiteral(equals(0))
				3116	match false
				3117	floatLiteral(equals(3.14)) and floatLiteral(equals(314e-2))
				3118	match 3.14
				3119	integerLiteral(equals(42))
				3120	matches 42
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3121
Clement Courbet	43bdba4	2017-07-11 15:45:22 +0000	[diff] [blame]	3122	Note that you cannot directly match a negative numeric literal because the
				3123	minus sign is not part of the literal: It is a unary operator whose operand
				3124	is the positive numeric literal. Instead, you must use a unaryOperator()
				3125	matcher to match the minus sign:
				3126
				3127	unaryOperator(hasOperatorName("-"),
				3128	hasUnaryOperand(integerLiteral(equals(13))))
				3129
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	3130	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]	3131	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]	3132	</pre></td></tr>
				3133
				3134
Peter Wu	a9244b5	2017-06-08 22:00:58 +0000	[diff] [blame]	3135	<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>
				3136	<tr><td colspan="4" class="doc" id="equals13"><pre></pre></td></tr>
				3137
				3138
				3139	<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>
				3140	<tr><td colspan="4" class="doc" id="equals9"><pre></pre></td></tr>
				3141
				3142
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3143	<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]	3144	<tr><td colspan="4" class="doc" id="isArrow0"><pre>Matches member expressions that are called with '->' as opposed
				3145	to '.'.
				3146
				3147	Member calls on the implicit this pointer match as called with '->'.
				3148
				3149	Given
				3150	class Y {
				3151	void x() { this->x(); x(); Y y; y.x(); a; this->b; Y::b; }
				3152	int a;
				3153	static int b;
				3154	};
				3155	memberExpr(isArrow())
				3156	matches this->x, x, y.x, a, this->b
				3157	</pre></td></tr>
				3158
				3159
Aaron Ballman	a086b9f	2016-08-17 13:10:42 +0000	[diff] [blame]	3160	<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>
				3161	<tr><td colspan="4" class="doc" id="hasExternalFormalLinkage0"><pre>Matches a declaration that has external formal linkage.
				3162
				3163	Example matches only z (matcher = varDecl(hasExternalFormalLinkage()))
				3164	void f() {
				3165	int x;
				3166	static int y;
				3167	}
				3168	int z;
				3169
				3170	Example matches f() because it has external formal linkage despite being
				3171	unique to the translation unit as though it has internal likage
				3172	(matcher = functionDecl(hasExternalFormalLinkage()))
				3173
				3174	namespace {
				3175	void f() {}
				3176	}
				3177	</pre></td></tr>
				3178
				3179
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	3180	<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]	3181	<tr><td colspan="4" class="doc" id="hasName0"><pre>Matches NamedDecl nodes that have the specified name.
				3182
				3183	Supports specifying enclosing namespaces or classes by prefixing the name
				3184	with '<enclosing>::'.
				3185	Does not match typedefs of an underlying type with the given name.
				3186
				3187	Example matches X (Name == "X")
				3188	class X;
				3189
				3190	Example matches X (Name is one of "::a::b::X", "a::b::X", "b::X", "X")
				3191	namespace a { namespace b { class X; } }
				3192	</pre></td></tr>
				3193
				3194
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3195	<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]	3196	<tr><td colspan="4" class="doc" id="matchesName0"><pre>Matches NamedDecl nodes whose fully qualified names contain
				3197	a substring matched by the given RegExp.
				3198
				3199	Supports specifying enclosing namespaces or classes by
				3200	prefixing the name with '<enclosing>::'. Does not match typedefs
				3201	of an underlying type with the given name.
				3202
				3203	Example matches X (regexp == "::X")
				3204	class X;
				3205
				3206	Example matches X (regexp is one of "::X", "^foo::.*X", among others)
				3207	namespace foo { namespace bar { class X; } }
				3208	</pre></td></tr>
				3209
				3210
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3211	<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]	3212	<tr><td colspan="4" class="doc" id="isAnonymous0"><pre>Matches anonymous namespace declarations.
				3213
				3214	Given
				3215	namespace n {
				3216	namespace {} #1
				3217	}
				3218	namespaceDecl(isAnonymous()) will match #1 but not ::n.
				3219	</pre></td></tr>
				3220
				3221
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3222	<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]	3223	<tr><td colspan="4" class="doc" id="isInline0"><pre>Matches function and namespace declarations that are marked with
				3224	the inline keyword.
				3225
				3226	Given
				3227	inline void f();
				3228	void g();
				3229	namespace n {
				3230	inline namespace m {}
				3231	}
				3232	functionDecl(isInline()) will match ::f().
				3233	namespaceDecl(isInline()) will match n::m.
				3234	</pre></td></tr>
				3235
				3236
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3237	<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]	3238	<tr><td colspan="4" class="doc" id="argumentCountIs2"><pre>Checks that a call expression or a constructor call expression has
				3239	a specific number of arguments (including absent default arguments).
				3240
				3241	Example matches f(0, 0) (matcher = callExpr(argumentCountIs(2)))
				3242	void f(int x, int y);
				3243	f(0, 0);
				3244	</pre></td></tr>
				3245
				3246
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3247	<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]	3248	<tr><td colspan="4" class="doc" id="hasKeywordSelector0"><pre>Matches when the selector is a keyword selector
				3249
				3250	objCMessageExpr(hasKeywordSelector()) matches the generated setFrame
				3251	message expression in
				3252
				3253	UIWebView *webView = ...;
				3254	CGRect bodyFrame = webView.frame;
				3255	bodyFrame.size.height = self.bodyContentHeight;
				3256	webView.frame = bodyFrame;
				3257	^---- matches here
				3258	</pre></td></tr>
				3259
				3260
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3261	<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]	3262	<tr><td colspan="4" class="doc" id="hasNullSelector0"><pre>Matches when the selector is the empty selector
				3263
				3264	Matches only when the selector of the objCMessageExpr is NULL. This may
				3265	represent an error condition in the tree!
				3266	</pre></td></tr>
				3267
				3268
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3269	<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]	3270	<tr><td colspan="4" class="doc" id="hasSelector0"><pre>Matches when BaseName == Selector.getAsString()
				3271
				3272	matcher = objCMessageExpr(hasSelector("loadHTMLString:baseURL:"));
				3273	matches the outer message expr in the code below, but NOT the message
				3274	invocation for self.bodyView.
				3275	[self.bodyView loadHTMLString:html baseURL:NULL];
				3276	</pre></td></tr>
				3277
				3278
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3279	<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]	3280	<tr><td colspan="4" class="doc" id="hasUnarySelector0"><pre>Matches when the selector is a Unary Selector
				3281
				3282	matcher = objCMessageExpr(matchesSelector(hasUnarySelector());
				3283	matches self.bodyView in the code below, but NOT the outer message
				3284	invocation of "loadHTMLString:baseURL:".
				3285	[self.bodyView loadHTMLString:html baseURL:NULL];
				3286	</pre></td></tr>
				3287
				3288
George Karpenkov	b5ea4df	2018-07-16 20:22:12 +0000	[diff] [blame]	3289	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMessageExpr.html">ObjCMessageExpr</a>></td><td class="name" onclick="toggle('isInstanceMessage0')"><a name="isInstanceMessage0Anchor">isInstanceMessage</a></td><td></td></tr>
				3290	<tr><td colspan="4" class="doc" id="isInstanceMessage0"><pre>Returns true when the Objective-C message is sent to an instance.
				3291
				3292	Example
				3293	matcher = objcMessagaeExpr(isInstanceMessage())
				3294	matches
				3295	NSString *x = @"hello";
George Karpenkov	daac52c	2018-07-23 22:29:10 +0000	[diff] [blame]	3296	[x containsString:@"h"];
George Karpenkov	b5ea4df	2018-07-16 20:22:12 +0000	[diff] [blame]	3297	but not
George Karpenkov	daac52c	2018-07-23 22:29:10 +0000	[diff] [blame]	3298	[NSString stringWithFormat:@"format"];
George Karpenkov	b5ea4df	2018-07-16 20:22:12 +0000	[diff] [blame]	3299	</pre></td></tr>
				3300
				3301
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3302	<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]	3303	<tr><td colspan="4" class="doc" id="matchesSelector0"><pre>Matches ObjC selectors whose name contains
				3304	a substring matched by the given RegExp.
				3305	matcher = objCMessageExpr(matchesSelector("loadHTMLStringmatches the outer message expr in the code below, but NOT the message
				3306	invocation for self.bodyView.
				3307	[self.bodyView loadHTMLString:html baseURL:NULL];
				3308	</pre></td></tr>
				3309
				3310
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3311	<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]	3312	<tr><td colspan="4" class="doc" id="numSelectorArgs0"><pre>Matches when the selector has the specified number of arguments
				3313
				3314	matcher = objCMessageExpr(numSelectorArgs(0));
				3315	matches self.bodyView in the code below
				3316
				3317	matcher = objCMessageExpr(numSelectorArgs(2));
				3318	matches the invocation of "loadHTMLString:baseURL:" but not that
				3319	of self.bodyView
				3320	[self.bodyView loadHTMLString:html baseURL:NULL];
				3321	</pre></td></tr>
				3322
				3323
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	3324	<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>
				3325	<tr><td colspan="4" class="doc" id="isDefinition2"><pre>Matches if a declaration has a body attached.
				3326
				3327	Example matches A, va, fa
				3328	class A {};
				3329	class B; Doesn't match, as it has no body.
				3330	int va;
				3331	extern int vb; Doesn't match, as it doesn't define the variable.
				3332	void fa() {}
				3333	void fb(); Doesn't match, as it has no body.
				3334	@interface X
				3335	- (void)ma; Doesn't match, interface is declaration.
				3336	@end
				3337	@implementation X
				3338	- (void)ma {}
				3339	@end
				3340
				3341	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>>,
				3342	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMethodDecl.html">ObjCMethodDecl</a>>
				3343	</pre></td></tr>
				3344
				3345
Aaron Ballman	5f8980a	2017-11-21 19:22:34 +0000	[diff] [blame]	3346	<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>
				3347	<tr><td colspan="4" class="doc" id="hasDefaultArgument0"><pre>Matches a declaration that has default arguments.
				3348
				3349	Example matches y (matcher = parmVarDecl(hasDefaultArgument()))
				3350	void x(int val) {}
				3351	void y(int val = 0) {}
				3352	</pre></td></tr>
				3353
				3354
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3355	<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]	3356	<tr><td colspan="4" class="doc" id="asString0"><pre>Matches if the matched type is represented by the given string.
				3357
				3358	Given
				3359	class Y { public: void x(); };
				3360	void z() { Y* y; y->x(); }
				3361	cxxMemberCallExpr(on(hasType(asString("class Y *"))))
				3362	matches y->x()
				3363	</pre></td></tr>
				3364
				3365
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3366	<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]	3367	<tr><td colspan="4" class="doc" id="equalsBoundNode3"><pre>Matches if a node equals a previously bound node.
				3368
				3369	Matches a node if it equals the node previously bound to ID.
				3370
				3371	Given
				3372	class X { int a; int b; };
				3373	cxxRecordDecl(
				3374	has(fieldDecl(hasName("a"), hasType(type().bind("t")))),
				3375	has(fieldDecl(hasName("b"), hasType(type(equalsBoundNode("t"))))))
				3376	matches the class X, as a and b have the same type.
				3377
				3378	Note that when multiple matches are involved via forEach* matchers,
				3379	equalsBoundNodes acts as a filter.
				3380	For example:
				3381	compoundStmt(
				3382	forEachDescendant(varDecl().bind("d")),
				3383	forEachDescendant(declRefExpr(to(decl(equalsBoundNode("d"))))))
				3384	will trigger a match for each combination of variable declaration
				3385	and reference to that variable declaration within a compound statement.
				3386	</pre></td></tr>
				3387
				3388
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3389	<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]	3390	<tr><td colspan="4" class="doc" id="hasLocalQualifiers0"><pre>Matches QualType nodes that have local CV-qualifiers attached to
				3391	the node, not hidden within a typedef.
				3392
				3393	Given
				3394	typedef const int const_int;
				3395	const_int i;
				3396	int *const j;
				3397	int *volatile k;
				3398	int m;
				3399	varDecl(hasType(hasLocalQualifiers())) matches only j and k.
				3400	i is const-qualified but the qualifier is not local.
				3401	</pre></td></tr>
				3402
				3403
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3404	<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]	3405	<tr><td colspan="4" class="doc" id="isAnyCharacter0"><pre>Matches QualType nodes that are of character type.
				3406
				3407	Given
				3408	void a(char);
				3409	void b(wchar_t);
				3410	void c(double);
				3411	functionDecl(hasAnyParameter(hasType(isAnyCharacter())))
				3412	matches "a(char)", "b(wchar_t)", but not "c(double)".
				3413	</pre></td></tr>
				3414
				3415
Aaron Ballman	eb7e5d9	2016-02-18 16:36:01 +0000	[diff] [blame]	3416	<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]	3417	<tr><td colspan="4" class="doc" id="isAnyPointer0"><pre>Matches QualType nodes that are of any pointer type; this includes
				3418	the Objective-C object pointer type, which is different despite being
				3419	syntactically similar.
Aaron Ballman	eb7e5d9	2016-02-18 16:36:01 +0000	[diff] [blame]	3420
				3421	Given
				3422	int *i = nullptr;
Alexander Kornienko	7d20a5a	2016-04-13 11:13:08 +0000	[diff] [blame]	3423
				3424	@interface Foo
				3425	@end
				3426	Foo *f;
				3427
Aaron Ballman	eb7e5d9	2016-02-18 16:36:01 +0000	[diff] [blame]	3428	int j;
				3429	varDecl(hasType(isAnyPointer()))
Alexander Kornienko	7d20a5a	2016-04-13 11:13:08 +0000	[diff] [blame]	3430	matches "int i" and "Foo f", but not "int j".
Aaron Ballman	eb7e5d9	2016-02-18 16:36:01 +0000	[diff] [blame]	3431	</pre></td></tr>
				3432
				3433
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3434	<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]	3435	<tr><td colspan="4" class="doc" id="isConstQualified0"><pre>Matches QualType nodes that are const-qualified, i.e., that
				3436	include "top-level" const.
				3437
				3438	Given
				3439	void a(int);
				3440	void b(int const);
				3441	void c(const int);
				3442	void d(const int*);
				3443	void e(int const) {};
				3444	functionDecl(hasAnyParameter(hasType(isConstQualified())))
				3445	matches "void b(int const)", "void c(const int)" and
				3446	"void e(int const) {}". It does not match d as there
				3447	is no top-level const on the parameter type "const int *".
				3448	</pre></td></tr>
				3449
				3450
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3451	<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]	3452	<tr><td colspan="4" class="doc" id="isInteger0"><pre>Matches QualType nodes that are of integer type.
				3453
				3454	Given
				3455	void a(int);
				3456	void b(long);
				3457	void c(double);
				3458	functionDecl(hasAnyParameter(hasType(isInteger())))
				3459	matches "a(int)", "b(long)", but not "c(double)".
				3460	</pre></td></tr>
				3461
				3462
Clement Courbet	4251759	2016-07-12 06:36:00 +0000	[diff] [blame]	3463	<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>
				3464	<tr><td colspan="4" class="doc" id="isSignedInteger0"><pre>Matches QualType nodes that are of signed integer type.
				3465
				3466	Given
				3467	void a(int);
				3468	void b(unsigned long);
				3469	void c(double);
Aaron Ballman	75de707	2016-08-18 12:26:17 +0000	[diff] [blame]	3470	functionDecl(hasAnyParameter(hasType(isSignedInteger())))
Clement Courbet	4251759	2016-07-12 06:36:00 +0000	[diff] [blame]	3471	matches "a(int)", but not "b(unsigned long)" and "c(double)".
				3472	</pre></td></tr>
				3473
				3474
				3475	<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>
				3476	<tr><td colspan="4" class="doc" id="isUnsignedInteger0"><pre>Matches QualType nodes that are of unsigned integer type.
				3477
				3478	Given
				3479	void a(int);
				3480	void b(unsigned long);
				3481	void c(double);
Aaron Ballman	75de707	2016-08-18 12:26:17 +0000	[diff] [blame]	3482	functionDecl(hasAnyParameter(hasType(isUnsignedInteger())))
Clement Courbet	4251759	2016-07-12 06:36:00 +0000	[diff] [blame]	3483	matches "b(unsigned long)", but not "a(int)" and "c(double)".
				3484	</pre></td></tr>
				3485
				3486
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3487	<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]	3488	<tr><td colspan="4" class="doc" id="isVolatileQualified0"><pre>Matches QualType nodes that are volatile-qualified, i.e., that
				3489	include "top-level" volatile.
				3490
				3491	Given
				3492	void a(int);
				3493	void b(int volatile);
				3494	void c(volatile int);
				3495	void d(volatile int*);
				3496	void e(int volatile) {};
				3497	functionDecl(hasAnyParameter(hasType(isVolatileQualified())))
				3498	matches "void b(int volatile)", "void c(volatile int)" and
				3499	"void e(int volatile) {}". It does not match d as there
				3500	is no top-level volatile on the parameter type "volatile int *".
				3501	</pre></td></tr>
				3502
				3503
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3504	<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]	3505	<tr><td colspan="4" class="doc" id="isClass0"><pre>Matches RecordDecl object that are spelled with "class."
				3506
				3507	Example matches C, but not S or U.
				3508	struct S {};
				3509	class C {};
				3510	union U {};
				3511	</pre></td></tr>
				3512
				3513
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3514	<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]	3515	<tr><td colspan="4" class="doc" id="isStruct0"><pre>Matches RecordDecl object that are spelled with "struct."
				3516
				3517	Example matches S, but not C or U.
				3518	struct S {};
				3519	class C {};
				3520	union U {};
				3521	</pre></td></tr>
				3522
				3523
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3524	<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]	3525	<tr><td colspan="4" class="doc" id="isUnion0"><pre>Matches RecordDecl object that are spelled with "union."
				3526
				3527	Example matches U, but not C or S.
				3528	struct S {};
				3529	class C {};
				3530	union U {};
				3531	</pre></td></tr>
				3532
				3533
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3534	<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]	3535	<tr><td colspan="4" class="doc" id="equalsBoundNode0"><pre>Matches if a node equals a previously bound node.
				3536
				3537	Matches a node if it equals the node previously bound to ID.
				3538
				3539	Given
				3540	class X { int a; int b; };
				3541	cxxRecordDecl(
				3542	has(fieldDecl(hasName("a"), hasType(type().bind("t")))),
				3543	has(fieldDecl(hasName("b"), hasType(type(equalsBoundNode("t"))))))
				3544	matches the class X, as a and b have the same type.
				3545
				3546	Note that when multiple matches are involved via forEach* matchers,
				3547	equalsBoundNodes acts as a filter.
				3548	For example:
				3549	compoundStmt(
				3550	forEachDescendant(varDecl().bind("d")),
				3551	forEachDescendant(declRefExpr(to(decl(equalsBoundNode("d"))))))
				3552	will trigger a match for each combination of variable declaration
				3553	and reference to that variable declaration within a compound statement.
				3554	</pre></td></tr>
				3555
				3556
Samuel Benzaquen	a4076ea	2016-05-04 20:45:00 +0000	[diff] [blame]	3557	<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>
				3558	<tr><td colspan="4" class="doc" id="equalsNode1"><pre>Matches if a node equals another node.
				3559
				3560	Stmt has pointer identity in the AST.
				3561	</pre></td></tr>
				3562
				3563
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3564	<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]	3565	<tr><td colspan="4" class="doc" id="isExpansionInFileMatching1"><pre>Matches AST nodes that were expanded within files whose name is
				3566	partially matching a given regex.
				3567
				3568	Example matches Y but not X
				3569	(matcher = cxxRecordDecl(isExpansionInFileMatching("AST.*"))
				3570	#include "ASTMatcher.h"
				3571	class X {};
				3572	ASTMatcher.h:
				3573	class Y {};
				3574
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3575	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]	3576	</pre></td></tr>
				3577
				3578
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3579	<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]	3580	<tr><td colspan="4" class="doc" id="isExpansionInMainFile1"><pre>Matches AST nodes that were expanded within the main-file.
				3581
				3582	Example matches X but not Y
				3583	(matcher = cxxRecordDecl(isExpansionInMainFile())
				3584	#include <Y.h>
				3585	class X {};
				3586	Y.h:
				3587	class Y {};
				3588
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3589	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]	3590	</pre></td></tr>
				3591
				3592
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3593	<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]	3594	<tr><td colspan="4" class="doc" id="isExpansionInSystemHeader1"><pre>Matches AST nodes that were expanded within system-header-files.
				3595
				3596	Example matches Y but not X
				3597	(matcher = cxxRecordDecl(isExpansionInSystemHeader())
				3598	#include <SystemHeader.h>
				3599	class X {};
				3600	SystemHeader.h:
				3601	class Y {};
				3602
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3603	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]	3604	</pre></td></tr>
				3605
				3606
Etienne Bergeron	3588be7	2016-05-12 04:20:04 +0000	[diff] [blame]	3607	<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>
				3608	<tr><td colspan="4" class="doc" id="hasSize1"><pre>Matches nodes that have the specified size.
				3609
				3610	Given
				3611	int a[42];
				3612	int b[2 * 21];
				3613	int c[41], d[43];
				3614	char *s = "abcd";
				3615	wchar_t *ws = L"abcd";
				3616	char *w = "a";
				3617	constantArrayType(hasSize(42))
				3618	matches "int a[42]" and "int b[2 * 21]"
				3619	stringLiteral(hasSize(4))
				3620	matches "abcd", L"abcd"
				3621	</pre></td></tr>
				3622
				3623
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3624	<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]	3625	<tr><td colspan="4" class="doc" id="isDefinition0"><pre>Matches if a declaration has a body attached.
				3626
				3627	Example matches A, va, fa
				3628	class A {};
				3629	class B; Doesn't match, as it has no body.
				3630	int va;
				3631	extern int vb; Doesn't match, as it doesn't define the variable.
				3632	void fa() {}
				3633	void fb(); Doesn't match, as it has no body.
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	3634	@interface X
				3635	- (void)ma; Doesn't match, interface is declaration.
				3636	@end
				3637	@implementation X
				3638	- (void)ma {}
				3639	@end
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3640
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	3641	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>>,
				3642	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]	3643	</pre></td></tr>
				3644
				3645
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3646	<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]	3647	<tr><td colspan="4" class="doc" id="equalsIntegralValue0"><pre>Matches a TemplateArgument of integral type with a given value.
				3648
				3649	Note that 'Value' is a string as the template argument's value is
				3650	an arbitrary precision integer. 'Value' must be euqal to the canonical
				3651	representation of that integral value in base 10.
				3652
				3653	Given
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3654	template<int T> struct C {};
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3655	C<42> c;
				3656	classTemplateSpecializationDecl(
				3657	hasAnyTemplateArgument(equalsIntegralValue("42")))
				3658	matches the implicit instantiation of C in C<42>.
				3659	</pre></td></tr>
				3660
				3661
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3662	<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]	3663	<tr><td colspan="4" class="doc" id="isIntegral0"><pre>Matches a TemplateArgument that is an integral value.
				3664
				3665	Given
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	3666	template<int T> struct C {};
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3667	C<42> c;
				3668	classTemplateSpecializationDecl(
				3669	hasAnyTemplateArgument(isIntegral()))
				3670	matches the implicit instantiation of C in C<42>
				3671	with isIntegral() matching 42.
				3672	</pre></td></tr>
				3673
				3674
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3675	<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]	3676	<tr><td colspan="4" class="doc" id="templateArgumentCountIs1"><pre>Matches if the number of template arguments equals N.
				3677
				3678	Given
				3679	template<typename T> struct C {};
				3680	C<int> c;
				3681	classTemplateSpecializationDecl(templateArgumentCountIs(1))
				3682	matches C<int>.
				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_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]	3687	<tr><td colspan="4" class="doc" id="isExpansionInFileMatching2"><pre>Matches AST nodes that were expanded within files whose name is
				3688	partially matching a given regex.
				3689
				3690	Example matches Y but not X
				3691	(matcher = cxxRecordDecl(isExpansionInFileMatching("AST.*"))
				3692	#include "ASTMatcher.h"
				3693	class X {};
				3694	ASTMatcher.h:
				3695	class Y {};
				3696
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3697	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]	3698	</pre></td></tr>
				3699
				3700
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3701	<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]	3702	<tr><td colspan="4" class="doc" id="isExpansionInMainFile2"><pre>Matches AST nodes that were expanded within the main-file.
				3703
				3704	Example matches X but not Y
				3705	(matcher = cxxRecordDecl(isExpansionInMainFile())
				3706	#include <Y.h>
				3707	class X {};
				3708	Y.h:
				3709	class Y {};
				3710
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3711	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]	3712	</pre></td></tr>
				3713
				3714
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3715	<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]	3716	<tr><td colspan="4" class="doc" id="isExpansionInSystemHeader2"><pre>Matches AST nodes that were expanded within system-header-files.
				3717
				3718	Example matches Y but not X
				3719	(matcher = cxxRecordDecl(isExpansionInSystemHeader())
				3720	#include <SystemHeader.h>
				3721	class X {};
				3722	SystemHeader.h:
				3723	class Y {};
				3724
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3725	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]	3726	</pre></td></tr>
				3727
				3728
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3729	<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]	3730	<tr><td colspan="4" class="doc" id="booleanType0"><pre>Matches type bool.
				3731
				3732	Given
				3733	struct S { bool func(); };
				3734	functionDecl(returns(booleanType()))
				3735	matches "bool func();"
				3736	</pre></td></tr>
				3737
				3738
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3739	<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]	3740	<tr><td colspan="4" class="doc" id="equalsBoundNode2"><pre>Matches if a node equals a previously bound node.
				3741
				3742	Matches a node if it equals the node previously bound to ID.
				3743
				3744	Given
				3745	class X { int a; int b; };
				3746	cxxRecordDecl(
				3747	has(fieldDecl(hasName("a"), hasType(type().bind("t")))),
				3748	has(fieldDecl(hasName("b"), hasType(type(equalsBoundNode("t"))))))
				3749	matches the class X, as a and b have the same type.
				3750
				3751	Note that when multiple matches are involved via forEach* matchers,
				3752	equalsBoundNodes acts as a filter.
				3753	For example:
				3754	compoundStmt(
				3755	forEachDescendant(varDecl().bind("d")),
				3756	forEachDescendant(declRefExpr(to(decl(equalsBoundNode("d"))))))
				3757	will trigger a match for each combination of variable declaration
				3758	and reference to that variable declaration within a compound statement.
				3759	</pre></td></tr>
				3760
				3761
Samuel Benzaquen	a4076ea	2016-05-04 20:45:00 +0000	[diff] [blame]	3762	<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>
				3763	<tr><td colspan="4" class="doc" id="equalsNode2"><pre>Matches if a node equals another node.
				3764
				3765	Type has pointer identity in the AST.
				3766	</pre></td></tr>
				3767
				3768
Aaron Ballman	eb7e5d9	2016-02-18 16:36:01 +0000	[diff] [blame]	3769	<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>
				3770	<tr><td colspan="4" class="doc" id="realFloatingPointType0"><pre>Matches any real floating-point type (float, double, long double).
				3771
				3772	Given
				3773	int i;
				3774	float f;
				3775	realFloatingPointType()
				3776	matches "float f" but not "int i"
				3777	</pre></td></tr>
				3778
				3779
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3780	<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]	3781	<tr><td colspan="4" class="doc" id="voidType0"><pre>Matches type void.
				3782
				3783	Given
				3784	struct S { void func(); };
				3785	functionDecl(returns(voidType()))
				3786	matches "void func();"
				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_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]	3791	<tr><td colspan="4" class="doc" id="ofKind0"><pre>Matches unary expressions of a certain kind.
				3792
				3793	Given
				3794	int x;
				3795	int s = sizeof(x) + alignof(x)
				3796	unaryExprOrTypeTraitExpr(ofKind(UETT_SizeOf))
				3797	matches sizeof(x)
				3798	</pre></td></tr>
				3799
				3800
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3801	<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]	3802	<tr><td colspan="4" class="doc" id="hasOperatorName1"><pre>Matches the operator Name of operator expressions (binary or
				3803	unary).
				3804
				3805	Example matches a \|\| b (matcher = binaryOperator(hasOperatorName("\|\|")))
				3806	!(a \|\| b)
				3807	</pre></td></tr>
				3808
				3809
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3810	<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]	3811	<tr><td colspan="4" class="doc" id="hasAutomaticStorageDuration0"><pre>Matches a variable declaration that has automatic storage duration.
				3812
				3813	Example matches x, but not y, z, or a.
				3814	(matcher = varDecl(hasAutomaticStorageDuration())
				3815	void f() {
				3816	int x;
				3817	static int y;
				3818	thread_local int z;
				3819	}
				3820	int a;
				3821	</pre></td></tr>
				3822
				3823
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3824	<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]	3825	<tr><td colspan="4" class="doc" id="hasGlobalStorage0"><pre>Matches a variable declaration that does not have local storage.
				3826
				3827	Example matches y and z (matcher = varDecl(hasGlobalStorage())
				3828	void f() {
				3829	int x;
				3830	static int y;
				3831	}
				3832	int z;
				3833	</pre></td></tr>
				3834
				3835
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3836	<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]	3837	<tr><td colspan="4" class="doc" id="hasLocalStorage0"><pre>Matches a variable declaration that has function scope and is a
				3838	non-static local variable.
				3839
				3840	Example matches x (matcher = varDecl(hasLocalStorage())
				3841	void f() {
				3842	int x;
				3843	static int y;
				3844	}
				3845	int z;
				3846	</pre></td></tr>
				3847
				3848
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3849	<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]	3850	<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]	3851	It includes the variable declared at namespace scope and those declared
				3852	with "static" and "extern" storage class specifiers.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3853
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3854	void f() {
				3855	int x;
				3856	static int y;
				3857	thread_local int z;
				3858	}
				3859	int a;
Haojian Wu	398a8ea	2016-09-27 07:53:20 +0000	[diff] [blame]	3860	static int b;
				3861	extern int c;
				3862	varDecl(hasStaticStorageDuration())
				3863	matches the function declaration y, a, b and c.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3864	</pre></td></tr>
				3865
				3866
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3867	<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]	3868	<tr><td colspan="4" class="doc" id="hasThreadStorageDuration0"><pre>Matches a variable declaration that has thread storage duration.
				3869
				3870	Example matches z, but not x, z, or a.
				3871	(matcher = varDecl(hasThreadStorageDuration())
				3872	void f() {
				3873	int x;
				3874	static int y;
				3875	thread_local int z;
				3876	}
				3877	int a;
				3878	</pre></td></tr>
				3879
				3880
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3881	<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>
Gabor Horvath	3cd0aa3	2018-05-08 11:53:32 +0000	[diff] [blame]	3882	<tr><td colspan="4" class="doc" id="isConstexpr0"><pre>Matches constexpr variable and function declarations,
				3883	and if constexpr.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3884
				3885	Given:
				3886	constexpr int foo = 42;
				3887	constexpr int bar();
Gabor Horvath	3cd0aa3	2018-05-08 11:53:32 +0000	[diff] [blame]	3888	void baz() { if constexpr(1 > 0) {} }
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3889	varDecl(isConstexpr())
				3890	matches the declaration of foo.
				3891	functionDecl(isConstexpr())
				3892	matches the declaration of bar.
Gabor Horvath	3cd0aa3	2018-05-08 11:53:32 +0000	[diff] [blame]	3893	ifStmt(isConstexpr())
				3894	matches the if statement in baz.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3895	</pre></td></tr>
				3896
				3897
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3898	<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]	3899	<tr><td colspan="4" class="doc" id="isDefinition1"><pre>Matches if a declaration has a body attached.
				3900
				3901	Example matches A, va, fa
				3902	class A {};
				3903	class B; Doesn't match, as it has no body.
				3904	int va;
				3905	extern int vb; Doesn't match, as it doesn't define the variable.
				3906	void fa() {}
				3907	void fb(); Doesn't match, as it has no body.
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	3908	@interface X
				3909	- (void)ma; Doesn't match, interface is declaration.
				3910	@end
				3911	@implementation X
				3912	- (void)ma {}
				3913	@end
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3914
Dave Lee	be39868	2017-11-14 14:17:26 +0000	[diff] [blame]	3915	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>>,
				3916	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]	3917	</pre></td></tr>
				3918
				3919
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3920	<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]	3921	<tr><td colspan="4" class="doc" id="isExceptionVariable0"><pre>Matches a variable declaration that is an exception variable from
				3922	a C++ catch block, or an Objective-C statement.
				3923
				3924	Example matches x (matcher = varDecl(isExceptionVariable())
				3925	void f(int y) {
				3926	try {
				3927	} catch (int x) {
				3928	}
				3929	}
				3930	</pre></td></tr>
				3931
				3932
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3933	<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]	3934	<tr><td colspan="4" class="doc" id="isExplicitTemplateSpecialization1"><pre>Matches explicit template specializations of function, class, or
				3935	static member variable template instantiations.
				3936
				3937	Given
				3938	template<typename T> void A(T t) { }
				3939	template<> void A(int N) { }
				3940	functionDecl(isExplicitTemplateSpecialization())
				3941	matches the specialization A<int>().
				3942
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3943	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]	3944	</pre></td></tr>
				3945
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	3946
Benjamin Kramer	87e6d99	2016-08-04 10:02:03 +0000	[diff] [blame]	3947	<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]	3948	<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]	3949
				3950	Given:
				3951	extern "C" void f() {}
				3952	extern "C" { void g() {} }
				3953	void h() {}
Alexander Shaposhnikov	f681c4e	2017-09-22 19:29:38 +0000	[diff] [blame]	3954	extern "C" int x = 1;
				3955	extern "C" int y = 2;
				3956	int z = 3;
Benjamin Kramer	87e6d99	2016-08-04 10:02:03 +0000	[diff] [blame]	3957	functionDecl(isExternC())
Alexander Shaposhnikov	f681c4e	2017-09-22 19:29:38 +0000	[diff] [blame]	3958	matches the declaration of f and g, but not the declaration of h.
				3959	varDecl(isExternC())
				3960	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]	3961	</pre></td></tr>
				3962
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	3963
Haojian Wu	b3d2546	2016-09-26 16:01:52 +0000	[diff] [blame]	3964	<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]	3965	<tr><td colspan="4" class="doc" id="isStaticStorageClass1"><pre>Matches variablefunction declarations that have "static" storage
				3966	class specifier ("static" keyword) written in the source.
Haojian Wu	b3d2546	2016-09-26 16:01:52 +0000	[diff] [blame]	3967
				3968	Given:
				3969	static void f() {}
				3970	static int i = 0;
Haojian Wu	398a8ea	2016-09-27 07:53:20 +0000	[diff] [blame]	3971	extern int j;
				3972	int k;
Haojian Wu	b3d2546	2016-09-26 16:01:52 +0000	[diff] [blame]	3973	functionDecl(isStaticStorageClass())
				3974	matches the function declaration f.
				3975	varDecl(isStaticStorageClass())
				3976	matches the variable declaration i.
				3977	</pre></td></tr>
				3978
				3979
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3980	<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]	3981	<tr><td colspan="4" class="doc" id="isTemplateInstantiation1"><pre>Matches template instantiations of function, class, or static
				3982	member variable template instantiations.
				3983
				3984	Given
				3985	template <typename T> class X {}; class A {}; X<A> x;
				3986	or
				3987	template <typename T> class X {}; class A {}; template class X<A>;
Eric Liu	09ee48e	2018-02-21 14:22:42 +0000	[diff] [blame]	3988	or
				3989	template <typename T> class X {}; class A {}; extern template class X<A>;
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	3990	cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
				3991	matches the template instantiation of X<A>.
				3992
				3993	But given
				3994	template <typename T> class X {}; class A {};
				3995	template <> class X<A> {}; X<A> x;
				3996	cxxRecordDecl(hasName("::X"), isTemplateInstantiation())
				3997	does not match, as X<A> is an explicit template specialization.
				3998
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	3999	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]	4000	</pre></td></tr>
				4001
				4002
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4003	<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]	4004	<tr><td colspan="4" class="doc" id="isInstantiated0"><pre>Matches declarations that are template instantiations or are inside
				4005	template instantiations.
				4006
				4007	Given
				4008	template<typename T> void A(T t) { T i; }
				4009	A(0);
				4010	A(0U);
				4011	functionDecl(isInstantiated())
				4012	matches 'A(int) {...};' and 'A(unsigned) {...}'.
				4013	</pre></td></tr>
				4014
				4015
Aaron Ballman	eb7e5d9	2016-02-18 16:36:01 +0000	[diff] [blame]	4016	<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>
				4017	<tr><td colspan="4" class="doc" id="nullPointerConstant0"><pre>Matches expressions that resolve to a null pointer constant, such as
				4018	GNU's __null, C++11's nullptr, or C's NULL macro.
				4019
				4020	Given:
				4021	void *v1 = NULL;
				4022	void *v2 = nullptr;
				4023	void *v3 = __null; GNU extension
				4024	char cp = (char )0;
				4025	int *ip = 0;
				4026	int i = 0;
				4027	expr(nullPointerConstant())
				4028	matches the initializer for v1, v2, v3, cp, and ip. Does not match the
				4029	initializer for i.
				4030	</pre></td></tr>
				4031
				4032
Samuel Benzaquen	a4076ea	2016-05-04 20:45:00 +0000	[diff] [blame]	4033	<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>
				4034	<tr><td colspan="4" class="doc" id="hasAnyName0"><pre>Matches NamedDecl nodes that have any of the specified names.
				4035
				4036	This matcher is only provided as a performance optimization of hasName.
				4037	hasAnyName(a, b, c)
				4038	is equivalent to, but faster than
				4039	anyOf(hasName(a), hasName(b), hasName(c))
				4040	</pre></td></tr>
				4041
				4042
George Karpenkov	88a16a0	2018-03-29 00:51:12 +0000	[diff] [blame]	4043	<tr><td>Matcher<internal::Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMessageExpr.html">ObjCMessageExpr</a>>></td><td class="name" onclick="toggle('hasAnySelector0')"><a name="hasAnySelector0Anchor">hasAnySelector</a></td><td>StringRef, ..., StringRef</td></tr>
				4044	<tr><td colspan="4" class="doc" id="hasAnySelector0"><pre>Matches when at least one of the supplied string equals to the
				4045	Selector.getAsString()
				4046
				4047	matcher = objCMessageExpr(hasSelector("methodA:", "methodB:"));
				4048	matches both of the expressions below:
				4049	[myObj methodA:argA];
				4050	[myObj methodB:argB];
				4051	</pre></td></tr>
				4052
				4053
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4054	<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]	4055	<tr><td colspan="4" class="doc" id="isInTemplateInstantiation0"><pre>Matches statements inside of a template instantiation.
				4056
				4057	Given
				4058	int j;
				4059	template<typename T> void A(T t) { T i; j += 42;}
				4060	A(0);
				4061	A(0U);
				4062	declStmt(isInTemplateInstantiation())
				4063	matches 'int i;' and 'unsigned i'.
				4064	unless(stmt(isInTemplateInstantiation()))
				4065	will NOT match j += 42; as it's shared between the template definition and
				4066	instantiation.
				4067	</pre></td></tr>
				4068
Benjamin Kramer	7d0cc23	2015-11-20 07:57:46 +0000	[diff] [blame]	4069	<!--END_NARROWING_MATCHERS -->
				4070	</table>
				4071
				4072	<!-- ======================================================================= -->
				4073	<h2 id="traversal-matchers">AST Traversal Matchers</h2>
				4074	<!-- ======================================================================= -->
				4075
				4076	<p>Traversal matchers specify the relationship to other nodes that are
				4077	reachable from the current node.</p>
				4078
				4079	<p>Note that there are special traversal matchers (has, hasDescendant, forEach and
				4080	forEachDescendant) which work on all nodes and allow users to write more generic
				4081	match expressions.</p>
				4082
				4083	<table>
				4084	<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]	4085	<!-- START_TRAVERSAL_MATCHERS -->
				4086
				4087	<tr><td>Matcher<></td><td class="name" onclick="toggle('eachOf0')"><a name="eachOf0Anchor">eachOf</a></td><td>Matcher<>, ..., Matcher<*></td></tr>
				4088	<tr><td colspan="4" class="doc" id="eachOf0"><pre>Matches if any of the given matchers matches.
				4089
				4090	Unlike anyOf, eachOf will generate a match result for each
				4091	matching submatcher.
				4092
				4093	For example, in:
				4094	class A { int a; int b; };
				4095	The matcher:
				4096	cxxRecordDecl(eachOf(has(fieldDecl(hasName("a")).bind("v")),
				4097	has(fieldDecl(hasName("b")).bind("v"))))
				4098	will generate two results binding "v", the first of which binds
				4099	the field declaration of a, the second the field declaration of
				4100	b.
				4101
				4102	Usable as: Any Matcher
				4103	</pre></td></tr>
				4104
				4105
				4106	<tr><td>Matcher<></td><td class="name" onclick="toggle('forEachDescendant0')"><a name="forEachDescendant0Anchor">forEachDescendant</a></td><td>Matcher<></td></tr>
				4107	<tr><td colspan="4" class="doc" id="forEachDescendant0"><pre>Matches AST nodes that have descendant AST nodes that match the
				4108	provided matcher.
				4109
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	4110	Example matches X, A, A::X, B, B::C, B::C::X
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4111	(matcher = cxxRecordDecl(forEachDescendant(cxxRecordDecl(hasName("X")))))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	4112	class X {};
				4113	class A { class X {}; }; Matches A, because A::X is a class of name
				4114	X inside A.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4115	class B { class C { class X {}; }; };
				4116
				4117	DescendantT must be an AST base type.
				4118
				4119	As opposed to 'hasDescendant', 'forEachDescendant' will cause a match for
				4120	each result that matches instead of only on the first one.
				4121
				4122	Note: Recursively combined ForEachDescendant can cause many matches:
				4123	cxxRecordDecl(forEachDescendant(cxxRecordDecl(
				4124	forEachDescendant(cxxRecordDecl())
				4125	)))
				4126	will match 10 times (plus injected class name matches) on:
				4127	class A { class B { class C { class D { class E {}; }; }; }; };
				4128
				4129	Usable as: Any Matcher
				4130	</pre></td></tr>
				4131
				4132
				4133	<tr><td>Matcher<></td><td class="name" onclick="toggle('forEach0')"><a name="forEach0Anchor">forEach</a></td><td>Matcher<></td></tr>
				4134	<tr><td colspan="4" class="doc" id="forEach0"><pre>Matches AST nodes that have child AST nodes that match the
				4135	provided matcher.
				4136
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	4137	Example matches X, Y, Y::X, Z::Y, Z::Y::X
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4138	(matcher = cxxRecordDecl(forEach(cxxRecordDecl(hasName("X")))
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	4139	class X {};
				4140	class Y { class X {}; }; Matches Y, because Y::X is a class of name X
				4141	inside Y.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4142	class Z { class Y { class X {}; }; }; Does not match Z.
				4143
				4144	ChildT must be an AST base type.
				4145
				4146	As opposed to 'has', 'forEach' will cause a match for each result that
				4147	matches instead of only on the first one.
				4148
				4149	Usable as: Any Matcher
				4150	</pre></td></tr>
				4151
				4152
				4153	<tr><td>Matcher<></td><td class="name" onclick="toggle('hasAncestor0')"><a name="hasAncestor0Anchor">hasAncestor</a></td><td>Matcher<></td></tr>
				4154	<tr><td colspan="4" class="doc" id="hasAncestor0"><pre>Matches AST nodes that have an ancestor that matches the provided
				4155	matcher.
				4156
				4157	Given
				4158	void f() { if (true) { int x = 42; } }
				4159	void g() { for (;;) { int x = 43; } }
				4160	expr(integerLiteral(hasAncestor(ifStmt()))) matches 42, but not 43.
				4161
				4162	Usable as: Any Matcher
				4163	</pre></td></tr>
				4164
				4165
				4166	<tr><td>Matcher<></td><td class="name" onclick="toggle('hasDescendant0')"><a name="hasDescendant0Anchor">hasDescendant</a></td><td>Matcher<></td></tr>
				4167	<tr><td colspan="4" class="doc" id="hasDescendant0"><pre>Matches AST nodes that have descendant AST nodes that match the
				4168	provided matcher.
				4169
				4170	Example matches X, Y, Z
				4171	(matcher = cxxRecordDecl(hasDescendant(cxxRecordDecl(hasName("X")))))
				4172	class X {}; Matches X, because X::X is a class of name X inside X.
				4173	class Y { class X {}; };
				4174	class Z { class Y { class X {}; }; };
				4175
				4176	DescendantT must be an AST base type.
				4177
				4178	Usable as: Any Matcher
				4179	</pre></td></tr>
				4180
				4181
				4182	<tr><td>Matcher<></td><td class="name" onclick="toggle('has0')"><a name="has0Anchor">has</a></td><td>Matcher<></td></tr>
				4183	<tr><td colspan="4" class="doc" id="has0"><pre>Matches AST nodes that have child AST nodes that match the
				4184	provided matcher.
				4185
				4186	Example matches X, Y
				4187	(matcher = cxxRecordDecl(has(cxxRecordDecl(hasName("X")))
				4188	class X {}; Matches X, because X::X is a class of name X inside X.
				4189	class Y { class X {}; };
				4190	class Z { class Y { class X {}; }; }; Does not match Z.
				4191
				4192	ChildT must be an AST base type.
				4193
				4194	Usable as: Any Matcher
Aaron Ballman	ba8dbbe	2016-06-06 18:52:17 +0000	[diff] [blame]	4195	Note that has is direct matcher, so it also matches things like implicit
				4196	casts and paren casts. If you are matching with expr then you should
				4197	probably consider using ignoringParenImpCasts like:
				4198	has(ignoringParenImpCasts(expr())).
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4199	</pre></td></tr>
				4200
				4201
				4202	<tr><td>Matcher<></td><td class="name" onclick="toggle('hasParent0')"><a name="hasParent0Anchor">hasParent</a></td><td>Matcher<></td></tr>
				4203	<tr><td colspan="4" class="doc" id="hasParent0"><pre>Matches AST nodes that have a parent that matches the provided
				4204	matcher.
				4205
				4206	Given
				4207	void f() { for (;;) { int x = 42; if (true) { int x = 43; } } }
				4208	compoundStmt(hasParent(ifStmt())) matches "{ int x = 43; }".
				4209
				4210	Usable as: Any Matcher
				4211	</pre></td></tr>
				4212
				4213
Etienne Bergeron	5500f95	2016-05-30 15:25:25 +0000	[diff] [blame]	4214	<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>
				4215	<tr><td colspan="4" class="doc" id="hasCondition5"><pre>Matches the condition expression of an if statement, for loop,
				4216	switch statement or conditional operator.
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	4217
				4218	Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true))))
				4219	if (true) {}
				4220	</pre></td></tr>
				4221
				4222
				4223	<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>
				4224	<tr><td colspan="4" class="doc" id="hasFalseExpression0"><pre>Matches the false branch expression of a conditional operator
				4225	(binary or ternary).
				4226
				4227	Example matches b
				4228	condition ? a : b
				4229	condition ?: b
				4230	</pre></td></tr>
				4231
				4232
				4233	<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>
				4234	<tr><td colspan="4" class="doc" id="hasTrueExpression0"><pre>Matches the true branch expression of a conditional operator.
				4235
				4236	Example 1 (conditional ternary operator): matches a
				4237	condition ? a : b
				4238
				4239	Example 2 (conditional binary operator): matches opaqueValueExpr(condition)
				4240	condition ?: b
				4241	</pre></td></tr>
				4242
				4243
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4244	<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]	4245	<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]	4246	matches the given matcher.
				4247
				4248	The associated declaration is:
				4249	- for type nodes, the declaration of the underlying type
				4250	- for CallExpr, the declaration of the callee
				4251	- for MemberExpr, the declaration of the referenced member
				4252	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	4253	- for CXXNewExpr, the declaration of the operator new
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	4254
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4255	For type nodes, hasDeclaration will generally match the declaration of the
				4256	sugared type. Given
				4257	class X {};
				4258	typedef X Y;
				4259	Y y;
				4260	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				4261	typedefDecl. A common use case is to match the underlying, desugared type.
				4262	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				4263	varDecl(hasType(hasUnqualifiedDesugaredType(
				4264	recordType(hasDeclaration(decl())))))
				4265	In this matcher, the decl will match the CXXRecordDecl of class X.
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	4266
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	4267	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>>,
				4268	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>>,
				4269	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>>,
				4270	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>>,
				4271	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>>,
				4272	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>>,
				4273	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]	4274	</pre></td></tr>
				4275
				4276
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4277	<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]	4278	<tr><td colspan="4" class="doc" id="hasBase0"><pre>Matches the base expression of an array subscript expression.
				4279
				4280	Given
				4281	int i[5];
				4282	void f() { i[1] = 42; }
				4283	arraySubscriptExpression(hasBase(implicitCastExpr(
				4284	hasSourceExpression(declRefExpr()))))
				4285	matches i[1] with the declRefExpr() matching i
				4286	</pre></td></tr>
				4287
				4288
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4289	<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]	4290	<tr><td colspan="4" class="doc" id="hasIndex0"><pre>Matches the index expression of an array subscript expression.
				4291
				4292	Given
				4293	int i[5];
				4294	void f() { i[1] = 42; }
				4295	arraySubscriptExpression(hasIndex(integerLiteral()))
				4296	matches i[1] with the integerLiteral() matching 1
				4297	</pre></td></tr>
				4298
				4299
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4300	<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]	4301	<tr><td colspan="4" class="doc" id="hasLHS1"><pre>Matches the left hand side of binary operator expressions.
				4302
				4303	Example matches a (matcher = binaryOperator(hasLHS()))
				4304	a \|\| b
				4305	</pre></td></tr>
				4306
				4307
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4308	<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]	4309	<tr><td colspan="4" class="doc" id="hasRHS1"><pre>Matches the right hand side of binary operator expressions.
				4310
				4311	Example matches b (matcher = binaryOperator(hasRHS()))
				4312	a \|\| b
				4313	</pre></td></tr>
				4314
				4315
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4316	<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]	4317	<tr><td colspan="4" class="doc" id="hasElementTypeLoc0"><pre>Matches arrays and C99 complex types that have a specific element
				4318	type.
				4319
				4320	Given
				4321	struct A {};
				4322	A a[7];
				4323	int b[7];
				4324	arrayType(hasElementType(builtinType()))
				4325	matches "int b[7]"
				4326
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4327	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]	4328	</pre></td></tr>
				4329
				4330
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4331	<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]	4332	<tr><td colspan="4" class="doc" id="hasElementType0"><pre>Matches arrays and C99 complex types that have a specific element
				4333	type.
				4334
				4335	Given
				4336	struct A {};
				4337	A a[7];
				4338	int b[7];
				4339	arrayType(hasElementType(builtinType()))
				4340	matches "int b[7]"
				4341
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4342	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]	4343	</pre></td></tr>
				4344
				4345
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4346	<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]	4347	<tr><td colspan="4" class="doc" id="hasValueTypeLoc0"><pre>Matches atomic types with a specific value type.
				4348
				4349	Given
				4350	_Atomic(int) i;
				4351	_Atomic(float) f;
				4352	atomicType(hasValueType(isInteger()))
				4353	matches "_Atomic(int) i"
				4354
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4355	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]	4356	</pre></td></tr>
				4357
				4358
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4359	<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]	4360	<tr><td colspan="4" class="doc" id="hasValueType0"><pre>Matches atomic types with a specific value type.
				4361
				4362	Given
				4363	_Atomic(int) i;
				4364	_Atomic(float) f;
				4365	atomicType(hasValueType(isInteger()))
				4366	matches "_Atomic(int) i"
				4367
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4368	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]	4369	</pre></td></tr>
				4370
				4371
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4372	<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]	4373	<tr><td colspan="4" class="doc" id="hasDeducedType0"><pre>Matches AutoType nodes where the deduced type is a specific type.
				4374
				4375	Note: There is no TypeLoc for the deduced type and thus no
				4376	getDeducedLoc() matcher.
				4377
				4378	Given
				4379	auto a = 1;
				4380	auto b = 2.0;
				4381	autoType(hasDeducedType(isInteger()))
				4382	matches "auto a"
				4383
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4384	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]	4385	</pre></td></tr>
				4386
				4387
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4388	<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]	4389	<tr><td colspan="4" class="doc" id="hasEitherOperand0"><pre>Matches if either the left hand side or the right hand side of a
				4390	binary operator matches.
				4391	</pre></td></tr>
				4392
				4393
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4394	<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]	4395	<tr><td colspan="4" class="doc" id="hasLHS0"><pre>Matches the left hand side of binary operator expressions.
				4396
				4397	Example matches a (matcher = binaryOperator(hasLHS()))
				4398	a \|\| b
				4399	</pre></td></tr>
				4400
				4401
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4402	<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]	4403	<tr><td colspan="4" class="doc" id="hasRHS0"><pre>Matches the right hand side of binary operator expressions.
				4404
				4405	Example matches b (matcher = binaryOperator(hasRHS()))
				4406	a \|\| b
				4407	</pre></td></tr>
				4408
				4409
George Karpenkov	b4c0cbd	2018-05-16 22:47:03 +0000	[diff] [blame]	4410	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BlockDecl.html">BlockDecl</a>></td><td class="name" onclick="toggle('hasAnyParameter2')"><a name="hasAnyParameter2Anchor">hasAnyParameter</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParmVarDecl.html">ParmVarDecl</a>> InnerMatcher</td></tr>
				4411	<tr><td colspan="4" class="doc" id="hasAnyParameter2"><pre>Matches any parameter of a function or an ObjC method declaration or a
				4412	block.
				4413
				4414	Does not match the 'this' parameter of a method.
				4415
				4416	Given
				4417	class X { void f(int x, int y, int z) {} };
				4418	cxxMethodDecl(hasAnyParameter(hasName("y")))
				4419	matches f(int x, int y, int z) {}
				4420	with hasAnyParameter(...)
				4421	matching int y
				4422
				4423	For ObjectiveC, given
				4424	@interface I - (void) f:(int) y; @end
				4425
				4426	the matcher objcMethodDecl(hasAnyParameter(hasName("y")))
				4427	matches the declaration of method f with hasParameter
				4428	matching y.
				4429
				4430	For blocks, given
				4431	b = ^(int y) { printf("%d", y) };
				4432
				4433	the matcher blockDecl(hasAnyParameter(hasName("y")))
				4434	matches the declaration of the block b with hasParameter
				4435	matching y.
				4436	</pre></td></tr>
				4437
				4438
				4439	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1BlockDecl.html">BlockDecl</a>></td><td class="name" onclick="toggle('hasParameter2')"><a name="hasParameter2Anchor">hasParameter</a></td><td>unsigned N, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParmVarDecl.html">ParmVarDecl</a>> InnerMatcher</td></tr>
				4440	<tr><td colspan="4" class="doc" id="hasParameter2"><pre>Matches the n'th parameter of a function or an ObjC method
				4441	declaration or a block.
				4442
				4443	Given
				4444	class X { void f(int x) {} };
				4445	cxxMethodDecl(hasParameter(0, hasType(varDecl())))
				4446	matches f(int x) {}
				4447	with hasParameter(...)
				4448	matching int x
				4449
				4450	For ObjectiveC, given
				4451	@interface I - (void) f:(int) y; @end
				4452
				4453	the matcher objcMethodDecl(hasParameter(0, hasName("y")))
				4454	matches the declaration of method f with hasParameter
				4455	matching y.
				4456	</pre></td></tr>
				4457
				4458
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4459	<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]	4460	<tr><td colspan="4" class="doc" id="pointeeLoc0"><pre>Narrows PointerType (and similar) matchers to those where the
				4461	pointee matches a given matcher.
				4462
				4463	Given
				4464	int *a;
				4465	int const *b;
				4466	float const *f;
				4467	pointerType(pointee(isConstQualified(), isInteger()))
				4468	matches "int const *b"
				4469
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4470	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>>,
				4471	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]	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_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]	4476	<tr><td colspan="4" class="doc" id="pointee0"><pre>Narrows PointerType (and similar) matchers to those where the
				4477	pointee matches a given matcher.
				4478
				4479	Given
				4480	int *a;
				4481	int const *b;
				4482	float const *f;
				4483	pointerType(pointee(isConstQualified(), isInteger()))
				4484	matches "int const *b"
				4485
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4486	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>>,
				4487	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]	4488	</pre></td></tr>
				4489
				4490
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4491	<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]	4492	<tr><td colspan="4" class="doc" id="forEachArgumentWithParam1"><pre>Matches all arguments and their respective ParmVarDecl.
				4493
				4494	Given
				4495	void f(int i);
				4496	int y;
				4497	f(y);
Clement Courbet	4251759	2016-07-12 06:36:00 +0000	[diff] [blame]	4498	callExpr(
				4499	forEachArgumentWithParam(
				4500	declRefExpr(to(varDecl(hasName("y")))),
				4501	parmVarDecl(hasType(isInteger()))
				4502	))
Aaron Ballman	d7b18b9	2016-01-18 20:28:57 +0000	[diff] [blame]	4503	matches f(y);
				4504	with declRefExpr(...)
				4505	matching int y
				4506	and parmVarDecl(...)
				4507	matching int i
				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_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]	4512	<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]	4513	expression, or an ObjC-message-send expression.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4514
				4515	Given
				4516	void x(int, int, int) { int y; x(1, y, 42); }
				4517	callExpr(hasAnyArgument(declRefExpr()))
				4518	matches x(1, y, 42)
				4519	with hasAnyArgument(...)
				4520	matching y
George Karpenkov	a763fdf	2018-03-07 02:32:44 +0000	[diff] [blame]	4521
				4522	For ObjectiveC, given
				4523	@interface I - (void) f:(int) y; @end
Clement Courbet	2513aa0	2018-03-21 10:48:00 +0000	[diff] [blame]	4524	void foo(I *i) { [i f:12]; }
George Karpenkov	a763fdf	2018-03-07 02:32:44 +0000	[diff] [blame]	4525	objcMessageExpr(hasAnyArgument(integerLiteral(equals(12))))
				4526	matches [i f:12]
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4527	</pre></td></tr>
				4528
				4529
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4530	<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]	4531	<tr><td colspan="4" class="doc" id="hasArgument1"><pre>Matches the n'th argument of a call expression or a constructor
				4532	call expression.
				4533
				4534	Example matches y in x(y)
				4535	(matcher = callExpr(hasArgument(0, declRefExpr())))
				4536	void x(int) { int y; x(y); }
				4537	</pre></td></tr>
				4538
				4539
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4540	<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]	4541	<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]	4542	matches the given matcher.
				4543
				4544	The associated declaration is:
				4545	- for type nodes, the declaration of the underlying type
				4546	- for CallExpr, the declaration of the callee
				4547	- for MemberExpr, the declaration of the referenced member
				4548	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	4549	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4550
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4551	For type nodes, hasDeclaration will generally match the declaration of the
				4552	sugared type. Given
				4553	class X {};
				4554	typedef X Y;
				4555	Y y;
				4556	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				4557	typedefDecl. A common use case is to match the underlying, desugared type.
				4558	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				4559	varDecl(hasType(hasUnqualifiedDesugaredType(
				4560	recordType(hasDeclaration(decl())))))
				4561	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4562
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	4563	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>>,
				4564	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>>,
				4565	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>>,
				4566	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>>,
				4567	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>>,
				4568	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>>,
				4569	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]	4570	</pre></td></tr>
				4571
				4572
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4573	<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]	4574	<tr><td colspan="4" class="doc" id="forEachConstructorInitializer0"><pre>Matches each constructor initializer in a constructor definition.
				4575
				4576	Given
				4577	class A { A() : i(42), j(42) {} int i; int j; };
				4578	cxxConstructorDecl(forEachConstructorInitializer(
				4579	forField(decl().bind("x"))
				4580	))
				4581	will trigger two matches, binding for 'i' and 'j' respectively.
				4582	</pre></td></tr>
				4583
				4584
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4585	<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]	4586	<tr><td colspan="4" class="doc" id="hasAnyConstructorInitializer0"><pre>Matches a constructor initializer.
				4587
				4588	Given
				4589	struct Foo {
				4590	Foo() : foo_(1) { }
				4591	int foo_;
				4592	};
				4593	cxxRecordDecl(has(cxxConstructorDecl(
				4594	hasAnyConstructorInitializer(anything())
				4595	)))
				4596	record matches Foo, hasAnyConstructorInitializer matches foo_(1)
				4597	</pre></td></tr>
				4598
				4599
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4600	<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]	4601	<tr><td colspan="4" class="doc" id="forField0"><pre>Matches the field declaration of a constructor initializer.
				4602
				4603	Given
				4604	struct Foo {
				4605	Foo() : foo_(1) { }
				4606	int foo_;
				4607	};
				4608	cxxRecordDecl(has(cxxConstructorDecl(hasAnyConstructorInitializer(
				4609	forField(hasName("foo_"))))))
				4610	matches Foo
				4611	with forField matching foo_
				4612	</pre></td></tr>
				4613
				4614
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4615	<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]	4616	<tr><td colspan="4" class="doc" id="withInitializer0"><pre>Matches the initializer expression of a constructor initializer.
				4617
				4618	Given
				4619	struct Foo {
				4620	Foo() : foo_(1) { }
				4621	int foo_;
				4622	};
				4623	cxxRecordDecl(has(cxxConstructorDecl(hasAnyConstructorInitializer(
				4624	withInitializer(integerLiteral(equals(1)))))))
				4625	matches Foo
				4626	with withInitializer matching (1)
				4627	</pre></td></tr>
				4628
				4629
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4630	<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]	4631	<tr><td colspan="4" class="doc" id="hasBody3"><pre>Matches a 'for', 'while', 'do while' statement or a function
				4632	definition that has a given body.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4633
				4634	Given
				4635	for (;;) {}
				4636	hasBody(compoundStmt())
				4637	matches 'for (;;) {}'
				4638	with compoundStmt()
				4639	matching '{}'
				4640	</pre></td></tr>
				4641
				4642
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4643	<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]	4644	<tr><td colspan="4" class="doc" id="hasLoopVariable0"><pre>Matches the initialization statement of a for loop.
				4645
				4646	Example:
				4647	forStmt(hasLoopVariable(anything()))
				4648	matches 'int x' in
				4649	for (int x : a) { }
				4650	</pre></td></tr>
				4651
				4652
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4653	<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]	4654	<tr><td colspan="4" class="doc" id="hasRangeInit0"><pre>Matches the range initialization statement of a for loop.
				4655
				4656	Example:
				4657	forStmt(hasRangeInit(anything()))
				4658	matches 'a' in
				4659	for (int x : a) { }
				4660	</pre></td></tr>
				4661
				4662
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4663	<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]	4664	<tr><td colspan="4" class="doc" id="onImplicitObjectArgument0"><pre></pre></td></tr>
				4665
				4666
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4667	<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]	4668	<tr><td colspan="4" class="doc" id="on0"><pre>Matches on the implicit object argument of a member call expression.
				4669
				4670	Example matches y.x()
				4671	(matcher = cxxMemberCallExpr(on(hasType(cxxRecordDecl(hasName("Y"))))))
				4672	class Y { public: void x(); };
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	4673	void z() { Y y; y.x(); }
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4674
				4675	FIXME: Overload to allow directly matching types?
				4676	</pre></td></tr>
				4677
				4678
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4679	<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]	4680	<tr><td colspan="4" class="doc" id="thisPointerType1"><pre>Overloaded to match the type's declaration.
				4681	</pre></td></tr>
				4682
				4683
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4684	<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]	4685	<tr><td colspan="4" class="doc" id="thisPointerType0"><pre>Matches if the expression's type either matches the specified
				4686	matcher, or is a pointer to a type that matches the InnerMatcher.
				4687	</pre></td></tr>
				4688
				4689
Clement Courbet	6ecaec8	2016-07-05 07:49:31 +0000	[diff] [blame]	4690	<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>
Alexander Kornienko	2a8c18d	2018-04-06 15:14:32 +0000	[diff] [blame]	4691	<tr><td colspan="4" class="doc" id="forEachOverridden0"><pre>Matches each method overridden by the given method. This matcher may
Clement Courbet	6ecaec8	2016-07-05 07:49:31 +0000	[diff] [blame]	4692	produce multiple matches.
				4693
				4694	Given
				4695	class A { virtual void f(); };
				4696	class B : public A { void f(); };
				4697	class C : public B { void f(); };
				4698	cxxMethodDecl(ofClass(hasName("C")),
				4699	forEachOverridden(cxxMethodDecl().bind("b"))).bind("d")
				4700	matches once, with "b" binding "A::f" and "d" binding "C::f" (Note
				4701	that B::f is not overridden by C::f).
				4702
				4703	The check can produce multiple matches in case of multiple inheritance, e.g.
				4704	class A1 { virtual void f(); };
				4705	class A2 { virtual void f(); };
				4706	class C : public A1, public A2 { void f(); };
				4707	cxxMethodDecl(ofClass(hasName("C")),
				4708	forEachOverridden(cxxMethodDecl().bind("b"))).bind("d")
				4709	matches twice, once with "b" binding "A1::f" and "d" binding "C::f", and
				4710	once with "b" binding "A2::f" and "d" binding "C::f".
				4711	</pre></td></tr>
				4712
				4713
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4714	<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]	4715	<tr><td colspan="4" class="doc" id="ofClass0"><pre>Matches the class declaration that the given method declaration
				4716	belongs to.
				4717
				4718	FIXME: Generalize this for other kinds of declarations.
				4719	FIXME: What other kind of declarations would we need to generalize
				4720	this to?
				4721
				4722	Example matches A() in the last line
				4723	(matcher = cxxConstructExpr(hasDeclaration(cxxMethodDecl(
				4724	ofClass(hasName("A"))))))
				4725	class A {
				4726	public:
				4727	A();
				4728	};
				4729	A a = A();
				4730	</pre></td></tr>
				4731
				4732
Adam Balogh	da488a6	2017-11-23 12:43:20 +0000	[diff] [blame]	4733	<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>
				4734	<tr><td colspan="4" class="doc" id="hasArraySize0"><pre>Matches array new expressions with a given array size.
				4735
				4736	Given:
				4737	MyClass *p1 = new MyClass[10];
				4738	cxxNewExpr(hasArraySize(intgerLiteral(equals(10))))
				4739	matches the expression 'new MyClass[10]'.
				4740	</pre></td></tr>
				4741
				4742
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4743	<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]	4744	<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]	4745	matches the given matcher.
				4746
				4747	The associated declaration is:
				4748	- for type nodes, the declaration of the underlying type
				4749	- for CallExpr, the declaration of the callee
				4750	- for MemberExpr, the declaration of the referenced member
				4751	- for CXXConstructExpr, the declaration of the constructor
				4752	- for CXXNewExpr, the declaration of the operator new
				4753
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4754	For type nodes, hasDeclaration will generally match the declaration of the
				4755	sugared type. Given
				4756	class X {};
				4757	typedef X Y;
				4758	Y y;
				4759	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				4760	typedefDecl. A common use case is to match the underlying, desugared type.
				4761	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				4762	varDecl(hasType(hasUnqualifiedDesugaredType(
				4763	recordType(hasDeclaration(decl())))))
				4764	In this matcher, the decl will match the CXXRecordDecl of class X.
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	4765
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	4766	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>>,
				4767	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>>,
				4768	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>>,
				4769	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>>,
				4770	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>>,
				4771	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>>,
				4772	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]	4773	</pre></td></tr>
				4774
				4775
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4776	<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]	4777	<tr><td colspan="4" class="doc" id="hasMethod0"><pre>Matches the first method of a class or struct that satisfies InnerMatcher.
				4778
				4779	Given:
				4780	class A { void func(); };
				4781	class B { void member(); };
				4782
				4783	cxxRecordDecl(hasMethod(hasName("func"))) matches the declaration of
				4784	A but not B.
				4785	</pre></td></tr>
				4786
				4787
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4788	<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]	4789	<tr><td colspan="4" class="doc" id="isDerivedFrom0"><pre>Matches C++ classes that are directly or indirectly derived from
				4790	a class matching Base.
				4791
				4792	Note that a class is not considered to be derived from itself.
				4793
				4794	Example matches Y, Z, C (Base == hasName("X"))
				4795	class X;
				4796	class Y : public X {}; directly derived
				4797	class Z : public Y {}; indirectly derived
				4798	typedef X A;
				4799	typedef A B;
				4800	class C : public B {}; derived from a typedef of X
				4801
				4802	In the following example, Bar matches isDerivedFrom(hasName("X")):
				4803	class Foo;
				4804	typedef Foo X;
				4805	class Bar : public Foo {}; derived from a type that X is a typedef of
				4806	</pre></td></tr>
				4807
				4808
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4809	<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]	4810	<tr><td colspan="4" class="doc" id="isSameOrDerivedFrom0"><pre>Similar to isDerivedFrom(), but also matches classes that directly
				4811	match Base.
				4812	</pre></td></tr>
				4813
				4814
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4815	<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]	4816	<tr><td colspan="4" class="doc" id="callee1"><pre>Matches if the call expression's callee's declaration matches the
				4817	given matcher.
				4818
				4819	Example matches y.x() (matcher = callExpr(callee(
				4820	cxxMethodDecl(hasName("x")))))
				4821	class Y { public: void x(); };
				4822	void z() { Y y; y.x(); }
				4823	</pre></td></tr>
				4824
				4825
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4826	<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]	4827	<tr><td colspan="4" class="doc" id="callee0"><pre>Matches if the call expression's callee expression matches.
				4828
				4829	Given
				4830	class Y { void x() { this->x(); x(); Y y; y.x(); } };
				4831	void f() { f(); }
				4832	callExpr(callee(expr()))
				4833	matches this->x(), x(), y.x(), f()
				4834	with callee(...)
				4835	matching this->x, x, y.x, f respectively
				4836
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4837	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]	4838	because this introduces ambiguous overloads with calls to Callee taking a
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4839	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]	4840	implemented in terms of implicit casts.
				4841	</pre></td></tr>
				4842
				4843
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4844	<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]	4845	<tr><td colspan="4" class="doc" id="forEachArgumentWithParam0"><pre>Matches all arguments and their respective ParmVarDecl.
				4846
				4847	Given
				4848	void f(int i);
				4849	int y;
				4850	f(y);
Clement Courbet	4251759	2016-07-12 06:36:00 +0000	[diff] [blame]	4851	callExpr(
				4852	forEachArgumentWithParam(
				4853	declRefExpr(to(varDecl(hasName("y")))),
				4854	parmVarDecl(hasType(isInteger()))
				4855	))
Aaron Ballman	d7b18b9	2016-01-18 20:28:57 +0000	[diff] [blame]	4856	matches f(y);
				4857	with declRefExpr(...)
				4858	matching int y
				4859	and parmVarDecl(...)
				4860	matching int i
				4861	</pre></td></tr>
				4862
				4863
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4864	<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]	4865	<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]	4866	expression, or an ObjC-message-send expression.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4867
				4868	Given
				4869	void x(int, int, int) { int y; x(1, y, 42); }
				4870	callExpr(hasAnyArgument(declRefExpr()))
				4871	matches x(1, y, 42)
				4872	with hasAnyArgument(...)
				4873	matching y
George Karpenkov	a763fdf	2018-03-07 02:32:44 +0000	[diff] [blame]	4874
				4875	For ObjectiveC, given
				4876	@interface I - (void) f:(int) y; @end
Clement Courbet	2513aa0	2018-03-21 10:48:00 +0000	[diff] [blame]	4877	void foo(I *i) { [i f:12]; }
George Karpenkov	a763fdf	2018-03-07 02:32:44 +0000	[diff] [blame]	4878	objcMessageExpr(hasAnyArgument(integerLiteral(equals(12))))
				4879	matches [i f:12]
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4880	</pre></td></tr>
				4881
				4882
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4883	<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]	4884	<tr><td colspan="4" class="doc" id="hasArgument0"><pre>Matches the n'th argument of a call expression or a constructor
				4885	call expression.
				4886
				4887	Example matches y in x(y)
				4888	(matcher = callExpr(hasArgument(0, declRefExpr())))
				4889	void x(int) { int y; x(y); }
				4890	</pre></td></tr>
				4891
				4892
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4893	<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]	4894	<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]	4895	matches the given matcher.
				4896
				4897	The associated declaration is:
				4898	- for type nodes, the declaration of the underlying type
				4899	- for CallExpr, the declaration of the callee
				4900	- for MemberExpr, the declaration of the referenced member
				4901	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	4902	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4903
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	4904	For type nodes, hasDeclaration will generally match the declaration of the
				4905	sugared type. Given
				4906	class X {};
				4907	typedef X Y;
				4908	Y y;
				4909	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				4910	typedefDecl. A common use case is to match the underlying, desugared type.
				4911	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				4912	varDecl(hasType(hasUnqualifiedDesugaredType(
				4913	recordType(hasDeclaration(decl())))))
				4914	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4915
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	4916	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>>,
				4917	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>>,
				4918	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>>,
				4919	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>>,
				4920	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>>,
				4921	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>>,
				4922	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]	4923	</pre></td></tr>
				4924
				4925
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4926	<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]	4927	<tr><td colspan="4" class="doc" id="hasCaseConstant0"><pre>If the given case statement does not use the GNU case range
				4928	extension, matches the constant given in the statement.
				4929
				4930	Given
				4931	switch (1) { case 1: case 1+1: case 3 ... 4: ; }
				4932	caseStmt(hasCaseConstant(integerLiteral()))
				4933	matches "case 1:"
				4934	</pre></td></tr>
				4935
				4936
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4937	<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]	4938	<tr><td colspan="4" class="doc" id="hasSourceExpression0"><pre>Matches if the cast's source expression
				4939	or opaque value's source expression matches the given matcher.
				4940
				4941	Example 1: matches "a string"
				4942	(matcher = castExpr(hasSourceExpression(cxxConstructExpr())))
				4943	class URL { URL(string); };
				4944	URL url = "a string";
				4945
				4946	Example 2: matches 'b' (matcher =
				4947	opaqueValueExpr(hasSourceExpression(implicitCastExpr(declRefExpr())))
				4948	int a = b ?: 1;
				4949	</pre></td></tr>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4950
				4951
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4952	<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]	4953	<tr><td colspan="4" class="doc" id="hasAnyTemplateArgument0"><pre>Matches classTemplateSpecializations, templateSpecializationType and
				4954	functionDecl that have at least one TemplateArgument matching the given
				4955	InnerMatcher.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4956
				4957	Given
				4958	template<typename T> class A {};
				4959	template<> class A<double> {};
				4960	A<int> a;
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	4961
Haojian Wu	99e39a7	2016-07-29 17:30:13 +0000	[diff] [blame]	4962	template<typename T> f() {};
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	4963	void func() { f<int>(); };
				4964
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4965	classTemplateSpecializationDecl(hasAnyTemplateArgument(
				4966	refersToType(asString("int"))))
				4967	matches the specialization A<int>
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	4968
				4969	functionDecl(hasAnyTemplateArgument(refersToType(asString("int"))))
				4970	matches the specialization f<int>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4971	</pre></td></tr>
				4972
				4973
Manuel Klimek	696e505	2017-08-02 13:04:44 +0000	[diff] [blame]	4974	<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>
				4975	<tr><td colspan="4" class="doc" id="hasSpecializedTemplate0"><pre>Matches the specialized template of a specialization declaration.
				4976
				4977	Given
				4978	tempalate<typename T> class A {};
				4979	typedef A<int> B;
				4980	classTemplateSpecializationDecl(hasSpecializedTemplate(classTemplateDecl()))
				4981	matches 'B' with classTemplateDecl() matching the class template
				4982	declaration of 'A'.
				4983	</pre></td></tr>
				4984
				4985
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	4986	<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]	4987	<tr><td colspan="4" class="doc" id="hasTemplateArgument0"><pre>Matches classTemplateSpecializations, templateSpecializationType and
				4988	functionDecl where the n'th TemplateArgument matches the given InnerMatcher.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4989
				4990	Given
				4991	template<typename T, typename U> class A {};
				4992	A<bool, int> b;
				4993	A<int, bool> c;
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	4994
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	4995	template<typename T> void f() {}
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	4996	void func() { f<int>(); };
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	4997	classTemplateSpecializationDecl(hasTemplateArgument(
				4998	1, refersToType(asString("int"))))
				4999	matches the specialization A<bool, int>
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	5000
				5001	functionDecl(hasTemplateArgument(0, refersToType(asString("int"))))
				5002	matches the specialization f<int>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5003	</pre></td></tr>
				5004
				5005
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5006	<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]	5007	<tr><td colspan="4" class="doc" id="hasElementTypeLoc1"><pre>Matches arrays and C99 complex types that have a specific element
				5008	type.
				5009
				5010	Given
				5011	struct A {};
				5012	A a[7];
				5013	int b[7];
				5014	arrayType(hasElementType(builtinType()))
				5015	matches "int b[7]"
				5016
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5017	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]	5018	</pre></td></tr>
				5019
				5020
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5021	<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]	5022	<tr><td colspan="4" class="doc" id="hasElementType1"><pre>Matches arrays and C99 complex types that have a specific element
				5023	type.
				5024
				5025	Given
				5026	struct A {};
				5027	A a[7];
				5028	int b[7];
				5029	arrayType(hasElementType(builtinType()))
				5030	matches "int b[7]"
				5031
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5032	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]	5033	</pre></td></tr>
				5034
				5035
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5036	<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]	5037	<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]	5038	a given matcher. Also matches StmtExprs that have CompoundStmt as children.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5039
				5040	Given
				5041	{ {}; 1+2; }
				5042	hasAnySubstatement(compoundStmt())
				5043	matches '{ {}; 1+2; }'
				5044	with compoundStmt()
				5045	matching '{}'
				5046	</pre></td></tr>
				5047
				5048
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5049	<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]	5050	<tr><td colspan="4" class="doc" id="hasDecayedType0"><pre>Matches the decayed type, whos decayed type matches InnerMatcher
				5051	</pre></td></tr>
				5052
				5053
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5054	<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]	5055	<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]	5056	matches the given matcher.
				5057
				5058	The associated declaration is:
				5059	- for type nodes, the declaration of the underlying type
				5060	- for CallExpr, the declaration of the callee
				5061	- for MemberExpr, the declaration of the referenced member
				5062	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	5063	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5064
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5065	For type nodes, hasDeclaration will generally match the declaration of the
				5066	sugared type. Given
				5067	class X {};
				5068	typedef X Y;
				5069	Y y;
				5070	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				5071	typedefDecl. A common use case is to match the underlying, desugared type.
				5072	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				5073	varDecl(hasType(hasUnqualifiedDesugaredType(
				5074	recordType(hasDeclaration(decl())))))
				5075	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5076
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	5077	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>>,
				5078	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>>,
				5079	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>>,
				5080	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>>,
				5081	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>>,
				5082	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>>,
				5083	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]	5084	</pre></td></tr>
				5085
				5086
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5087	<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]	5088	<tr><td colspan="4" class="doc" id="throughUsingDecl0"><pre>Matches a DeclRefExpr that refers to a declaration through a
				5089	specific using shadow declaration.
				5090
				5091	Given
				5092	namespace a { void f() {} }
				5093	using a::f;
				5094	void g() {
				5095	f(); Matches this ..
				5096	a::f(); .. but not this.
				5097	}
				5098	declRefExpr(throughUsingDecl(anything()))
				5099	matches f()
				5100	</pre></td></tr>
				5101
				5102
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5103	<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]	5104	<tr><td colspan="4" class="doc" id="to0"><pre>Matches a DeclRefExpr that refers to a declaration that matches the
				5105	specified matcher.
				5106
				5107	Example matches x in if(x)
				5108	(matcher = declRefExpr(to(varDecl(hasName("x")))))
				5109	bool x;
				5110	if (x) {}
				5111	</pre></td></tr>
				5112
				5113
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5114	<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]	5115	<tr><td colspan="4" class="doc" id="containsDeclaration0"><pre>Matches the n'th declaration of a declaration statement.
				5116
				5117	Note that this does not work for global declarations because the AST
				5118	breaks up multiple-declaration DeclStmt's into multiple single-declaration
				5119	DeclStmt's.
				5120	Example: Given non-global declarations
				5121	int a, b = 0;
				5122	int c;
				5123	int d = 2, e;
				5124	declStmt(containsDeclaration(
				5125	0, varDecl(hasInitializer(anything()))))
				5126	matches only 'int d = 2, e;', and
				5127	declStmt(containsDeclaration(1, varDecl()))
				5128	matches 'int a, b = 0' as well as 'int d = 2, e;'
				5129	but 'int c;' is not matched.
				5130	</pre></td></tr>
				5131
				5132
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5133	<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]	5134	<tr><td colspan="4" class="doc" id="hasSingleDecl0"><pre>Matches the Decl of a DeclStmt which has a single declaration.
				5135
				5136	Given
				5137	int a, b;
				5138	int c;
				5139	declStmt(hasSingleDecl(anything()))
				5140	matches 'int c;' but not 'int a, b;'.
				5141	</pre></td></tr>
				5142
				5143
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5144	<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]	5145	<tr><td colspan="4" class="doc" id="hasTypeLoc0"><pre>Matches if the type location of the declarator decl's type matches
				5146	the inner matcher.
				5147
				5148	Given
				5149	int x;
				5150	declaratorDecl(hasTypeLoc(loc(asString("int"))))
				5151	matches int x
				5152	</pre></td></tr>
				5153
				5154
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5155	<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]	5156	<tr><td colspan="4" class="doc" id="hasDeclContext0"><pre>Matches declarations whose declaration context, interpreted as a
				5157	Decl, matches InnerMatcher.
				5158
				5159	Given
				5160	namespace N {
				5161	namespace M {
				5162	class D {};
				5163	}
				5164	}
				5165
				5166	cxxRcordDecl(hasDeclContext(namedDecl(hasName("M")))) matches the
				5167	declaration of class D.
				5168	</pre></td></tr>
				5169
				5170
Jonas Toth	acf8367	2018-07-26 13:02:05 +0000	[diff] [blame]	5171	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DecltypeType.html">DecltypeType</a>></td><td class="name" onclick="toggle('hasUnderlyingType0')"><a name="hasUnderlyingType0Anchor">hasUnderlyingType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Type.html">Type</a>></td></tr>
				5172	<tr><td colspan="4" class="doc" id="hasUnderlyingType0"><pre>Matches DecltypeType nodes to find out the underlying type.
				5173
				5174	Given
				5175	decltype(1) a = 1;
				5176	decltype(2.0) b = 2.0;
				5177	decltypeType(hasUnderlyingType(isInteger()))
				5178	matches "auto a"
				5179
				5180	Usable as: Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1DecltypeType.html">DecltypeType</a>>
				5181	</pre></td></tr>
				5182
				5183
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5184	<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]	5185	<tr><td colspan="4" class="doc" id="hasBody0"><pre>Matches a 'for', 'while', 'do while' statement or a function
				5186	definition that has a given body.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5187
				5188	Given
				5189	for (;;) {}
				5190	hasBody(compoundStmt())
				5191	matches 'for (;;) {}'
				5192	with compoundStmt()
				5193	matching '{}'
				5194	</pre></td></tr>
				5195
				5196
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5197	<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]	5198	<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]	5199	switch statement or conditional operator.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5200
				5201	Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true))))
				5202	if (true) {}
				5203	</pre></td></tr>
				5204
				5205
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5206	<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]	5207	<tr><td colspan="4" class="doc" id="hasQualifier0"><pre>Matches ElaboratedTypes whose qualifier, a NestedNameSpecifier,
				5208	matches InnerMatcher if the qualifier exists.
				5209
				5210	Given
				5211	namespace N {
				5212	namespace M {
				5213	class D {};
				5214	}
				5215	}
				5216	N::M::D d;
				5217
				5218	elaboratedType(hasQualifier(hasPrefix(specifiesNamespace(hasName("N"))))
				5219	matches the type of the variable declaration of d.
				5220	</pre></td></tr>
				5221
				5222
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5223	<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]	5224	<tr><td colspan="4" class="doc" id="namesType0"><pre>Matches ElaboratedTypes whose named type matches InnerMatcher.
				5225
				5226	Given
				5227	namespace N {
				5228	namespace M {
				5229	class D {};
				5230	}
				5231	}
				5232	N::M::D d;
				5233
				5234	elaboratedType(namesType(recordType(
				5235	hasDeclaration(namedDecl(hasName("D")))))) matches the type of the variable
				5236	declaration of d.
				5237	</pre></td></tr>
				5238
				5239
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5240	<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]	5241	<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]	5242	matches the given matcher.
				5243
				5244	The associated declaration is:
				5245	- for type nodes, the declaration of the underlying type
				5246	- for CallExpr, the declaration of the callee
				5247	- for MemberExpr, the declaration of the referenced member
				5248	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	5249	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5250
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5251	For type nodes, hasDeclaration will generally match the declaration of the
				5252	sugared type. Given
				5253	class X {};
				5254	typedef X Y;
				5255	Y y;
				5256	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				5257	typedefDecl. A common use case is to match the underlying, desugared type.
				5258	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				5259	varDecl(hasType(hasUnqualifiedDesugaredType(
				5260	recordType(hasDeclaration(decl())))))
				5261	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5262
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	5263	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>>,
				5264	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>>,
				5265	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>>,
				5266	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>>,
				5267	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>>,
				5268	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>>,
				5269	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]	5270	</pre></td></tr>
				5271
				5272
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5273	<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]	5274	<tr><td colspan="4" class="doc" id="hasDestinationType0"><pre>Matches casts whose destination type matches a given matcher.
				5275
				5276	(Note: Clang's AST refers to other conversions as "casts" too, and calls
				5277	actual casts "explicit" casts.)
				5278	</pre></td></tr>
				5279
				5280
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	5281	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</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>
				5282	<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]	5283	declaration's type.
				5284
				5285	In case of a value declaration (for example a variable declaration),
				5286	this resolves one layer of indirection. For example, in the value
				5287	declaration "X x;", cxxRecordDecl(hasName("X")) matches the declaration of
				5288	X, while varDecl(hasType(cxxRecordDecl(hasName("X")))) matches the
				5289	declaration of x.
				5290
				5291	Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X")))))
				5292	and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X")))))
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	5293	and friend class X (matcher = friendDecl(hasType("X"))
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5294	class X {};
				5295	void y(X &x) { x; X z; }
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	5296	class Y { friend class X; };
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5297
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5298	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]	5299	</pre></td></tr>
				5300
				5301
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5302	<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]	5303	<tr><td colspan="4" class="doc" id="hasType0"><pre>Matches if the expression's or declaration's type matches a type
				5304	matcher.
				5305
				5306	Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X")))))
				5307	and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X")))))
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	5308	and U (matcher = typedefDecl(hasType(asString("int")))
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	5309	and friend class X (matcher = friendDecl(hasType("X"))
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5310	class X {};
				5311	void y(X &x) { x; X z; }
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	5312	typedef int U;
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	5313	class Y { friend class X; };
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5314	</pre></td></tr>
				5315
				5316
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5317	<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]	5318	<tr><td colspan="4" class="doc" id="ignoringImpCasts0"><pre>Matches expressions that match InnerMatcher after any implicit casts
				5319	are stripped off.
				5320
				5321	Parentheses and explicit casts are not discarded.
				5322	Given
				5323	int arr[5];
				5324	int a = 0;
				5325	char b = 0;
				5326	const int c = a;
				5327	int *d = arr;
				5328	long e = (long) 0l;
				5329	The matchers
				5330	varDecl(hasInitializer(ignoringImpCasts(integerLiteral())))
				5331	varDecl(hasInitializer(ignoringImpCasts(declRefExpr())))
				5332	would match the declarations for a, b, c, and d, but not e.
				5333	While
				5334	varDecl(hasInitializer(integerLiteral()))
				5335	varDecl(hasInitializer(declRefExpr()))
				5336	only match the declarations for b, c, and d.
				5337	</pre></td></tr>
				5338
				5339
Clement Courbet	369e975	2018-03-21 10:54:29 +0000	[diff] [blame]	5340	<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]	5341	<tr><td colspan="4" class="doc" id="ignoringImplicit0"><pre>Matches expressions that match InnerMatcher after any implicit AST
				5342	nodes are stripped off.
				5343
				5344	Parentheses and explicit casts are not discarded.
				5345	Given
				5346	class C {};
				5347	C a = C();
				5348	C b;
				5349	C c = b;
				5350	The matchers
				5351	varDecl(hasInitializer(ignoringImplicit(cxxConstructExpr())))
				5352	would match the declarations for a, b, and c.
				5353	While
				5354	varDecl(hasInitializer(cxxConstructExpr()))
				5355	only match the declarations for b and c.
				5356	</pre></td></tr>
				5357
				5358
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5359	<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]	5360	<tr><td colspan="4" class="doc" id="ignoringParenCasts0"><pre>Matches expressions that match InnerMatcher after parentheses and
				5361	casts are stripped off.
				5362
				5363	Implicit and non-C Style casts are also discarded.
				5364	Given
				5365	int a = 0;
				5366	char b = (0);
				5367	void* c = reinterpret_cast<char*>(0);
				5368	char d = char(0);
				5369	The matcher
				5370	varDecl(hasInitializer(ignoringParenCasts(integerLiteral())))
				5371	would match the declarations for a, b, c, and d.
				5372	while
				5373	varDecl(hasInitializer(integerLiteral()))
				5374	only match the declaration for a.
				5375	</pre></td></tr>
				5376
				5377
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5378	<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]	5379	<tr><td colspan="4" class="doc" id="ignoringParenImpCasts0"><pre>Matches expressions that match InnerMatcher after implicit casts and
				5380	parentheses are stripped off.
				5381
				5382	Explicit casts are not discarded.
				5383	Given
				5384	int arr[5];
				5385	int a = 0;
				5386	char b = (0);
				5387	const int c = a;
				5388	int *d = (arr);
				5389	long e = ((long) 0l);
				5390	The matchers
				5391	varDecl(hasInitializer(ignoringParenImpCasts(integerLiteral())))
				5392	varDecl(hasInitializer(ignoringParenImpCasts(declRefExpr())))
				5393	would match the declarations for a, b, c, and d, but not e.
				5394	while
				5395	varDecl(hasInitializer(integerLiteral()))
				5396	varDecl(hasInitializer(declRefExpr()))
				5397	would only match the declaration for a.
				5398	</pre></td></tr>
				5399
				5400
Malcolm Parsons	4ca3d18	2016-12-24 13:35:14 +0000	[diff] [blame]	5401	<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>
				5402	<tr><td colspan="4" class="doc" id="hasInClassInitializer0"><pre>Matches non-static data members that have an in-class initializer.
				5403
				5404	Given
				5405	class C {
				5406	int a = 2;
				5407	int b = 3;
				5408	int c;
				5409	};
				5410	fieldDecl(hasInClassInitializer(integerLiteral(equals(2))))
				5411	matches 'int a;' but not 'int b;'.
				5412	fieldDecl(hasInClassInitializer(anything()))
				5413	matches 'int a;' and 'int b;' but not 'int c;'.
				5414	</pre></td></tr>
				5415
				5416
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5417	<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]	5418	<tr><td colspan="4" class="doc" id="hasBody1"><pre>Matches a 'for', 'while', 'do while' statement or a function
				5419	definition that has a given body.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5420
				5421	Given
				5422	for (;;) {}
				5423	hasBody(compoundStmt())
				5424	matches 'for (;;) {}'
				5425	with compoundStmt()
				5426	matching '{}'
				5427	</pre></td></tr>
				5428
				5429
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5430	<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]	5431	<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]	5432	switch statement or conditional operator.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5433
				5434	Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true))))
				5435	if (true) {}
				5436	</pre></td></tr>
				5437
				5438
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5439	<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]	5440	<tr><td colspan="4" class="doc" id="hasIncrement0"><pre>Matches the increment statement of a for loop.
				5441
				5442	Example:
				5443	forStmt(hasIncrement(unaryOperator(hasOperatorName("++"))))
				5444	matches '++x' in
				5445	for (x; x < N; ++x) { }
				5446	</pre></td></tr>
				5447
				5448
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5449	<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]	5450	<tr><td colspan="4" class="doc" id="hasLoopInit0"><pre>Matches the initialization statement of a for loop.
				5451
				5452	Example:
				5453	forStmt(hasLoopInit(declStmt()))
				5454	matches 'int x = 0' in
				5455	for (int x = 0; x < N; ++x) { }
				5456	</pre></td></tr>
				5457
				5458
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	5459	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FriendDecl.html">FriendDecl</a>></td><td class="name" onclick="toggle('hasType5')"><a name="hasType5Anchor">hasType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
				5460	<tr><td colspan="4" class="doc" id="hasType5"><pre>Overloaded to match the declaration of the expression's or value
				5461	declaration's type.
				5462
				5463	In case of a value declaration (for example a variable declaration),
				5464	this resolves one layer of indirection. For example, in the value
				5465	declaration "X x;", cxxRecordDecl(hasName("X")) matches the declaration of
				5466	X, while varDecl(hasType(cxxRecordDecl(hasName("X")))) matches the
				5467	declaration of x.
				5468
				5469	Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X")))))
				5470	and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X")))))
				5471	and friend class X (matcher = friendDecl(hasType("X"))
				5472	class X {};
				5473	void y(X &x) { x; X z; }
				5474	class Y { friend class X; };
				5475
				5476	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>>
				5477	</pre></td></tr>
				5478
				5479
				5480	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1FriendDecl.html">FriendDecl</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>
				5481	<tr><td colspan="4" class="doc" id="hasType1"><pre>Matches if the expression's or declaration's type matches a type
				5482	matcher.
				5483
				5484	Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X")))))
				5485	and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X")))))
				5486	and U (matcher = typedefDecl(hasType(asString("int")))
				5487	and friend class X (matcher = friendDecl(hasType("X"))
				5488	class X {};
				5489	void y(X &x) { x; X z; }
				5490	typedef int U;
				5491	class Y { friend class X; };
				5492	</pre></td></tr>
				5493
				5494
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5495	<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>
George Karpenkov	b4c0cbd	2018-05-16 22:47:03 +0000	[diff] [blame]	5496	<tr><td colspan="4" class="doc" id="hasAnyParameter0"><pre>Matches any parameter of a function or an ObjC method declaration or a
				5497	block.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5498
				5499	Does not match the 'this' parameter of a method.
				5500
				5501	Given
				5502	class X { void f(int x, int y, int z) {} };
				5503	cxxMethodDecl(hasAnyParameter(hasName("y")))
				5504	matches f(int x, int y, int z) {}
				5505	with hasAnyParameter(...)
				5506	matching int y
George Karpenkov	9d1d0c4	2018-03-29 00:51:11 +0000	[diff] [blame]	5507
				5508	For ObjectiveC, given
				5509	@interface I - (void) f:(int) y; @end
				5510
				5511	the matcher objcMethodDecl(hasAnyParameter(hasName("y")))
				5512	matches the declaration of method f with hasParameter
				5513	matching y.
George Karpenkov	b4c0cbd	2018-05-16 22:47:03 +0000	[diff] [blame]	5514
				5515	For blocks, given
				5516	b = ^(int y) { printf("%d", y) };
				5517
				5518	the matcher blockDecl(hasAnyParameter(hasName("y")))
				5519	matches the declaration of the block b with hasParameter
				5520	matching y.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5521	</pre></td></tr>
				5522
				5523
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	5524	<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>
				5525	<tr><td colspan="4" class="doc" id="hasAnyTemplateArgument2"><pre>Matches classTemplateSpecializations, templateSpecializationType and
				5526	functionDecl that have at least one TemplateArgument matching the given
				5527	InnerMatcher.
				5528
				5529	Given
				5530	template<typename T> class A {};
				5531	template<> class A<double> {};
				5532	A<int> a;
				5533
Haojian Wu	99e39a7	2016-07-29 17:30:13 +0000	[diff] [blame]	5534	template<typename T> f() {};
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	5535	void func() { f<int>(); };
				5536
				5537	classTemplateSpecializationDecl(hasAnyTemplateArgument(
				5538	refersToType(asString("int"))))
				5539	matches the specialization A<int>
				5540
				5541	functionDecl(hasAnyTemplateArgument(refersToType(asString("int"))))
				5542	matches the specialization f<int>
				5543	</pre></td></tr>
				5544
				5545
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5546	<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]	5547	<tr><td colspan="4" class="doc" id="hasBody4"><pre>Matches a 'for', 'while', 'do while' statement or a function
				5548	definition that has a given body.
				5549
				5550	Given
				5551	for (;;) {}
				5552	hasBody(compoundStmt())
				5553	matches 'for (;;) {}'
				5554	with compoundStmt()
				5555	matching '{}'
				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_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>
George Karpenkov	9d1d0c4	2018-03-29 00:51:11 +0000	[diff] [blame]	5560	<tr><td colspan="4" class="doc" id="hasParameter0"><pre>Matches the n'th parameter of a function or an ObjC method
George Karpenkov	b4c0cbd	2018-05-16 22:47:03 +0000	[diff] [blame]	5561	declaration or a block.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5562
				5563	Given
				5564	class X { void f(int x) {} };
				5565	cxxMethodDecl(hasParameter(0, hasType(varDecl())))
				5566	matches f(int x) {}
				5567	with hasParameter(...)
				5568	matching int x
George Karpenkov	9d1d0c4	2018-03-29 00:51:11 +0000	[diff] [blame]	5569
				5570	For ObjectiveC, given
				5571	@interface I - (void) f:(int) y; @end
				5572
				5573	the matcher objcMethodDecl(hasParameter(0, hasName("y")))
				5574	matches the declaration of method f with hasParameter
				5575	matching y.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5576	</pre></td></tr>
				5577
				5578
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	5579	<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>
				5580	<tr><td colspan="4" class="doc" id="hasTemplateArgument2"><pre>Matches classTemplateSpecializations, templateSpecializationType and
				5581	functionDecl where the n'th TemplateArgument matches the given InnerMatcher.
				5582
				5583	Given
				5584	template<typename T, typename U> class A {};
				5585	A<bool, int> b;
				5586	A<int, bool> c;
				5587
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	5588	template<typename T> void f() {}
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	5589	void func() { f<int>(); };
				5590	classTemplateSpecializationDecl(hasTemplateArgument(
				5591	1, refersToType(asString("int"))))
				5592	matches the specialization A<bool, int>
				5593
				5594	functionDecl(hasTemplateArgument(0, refersToType(asString("int"))))
				5595	matches the specialization f<int>
				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_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]	5600	<tr><td colspan="4" class="doc" id="returns0"><pre>Matches the return type of a function declaration.
				5601
				5602	Given:
				5603	class X { int f() { return 1; } };
				5604	cxxMethodDecl(returns(asString("int")))
				5605	matches int f() { return 1; }
				5606	</pre></td></tr>
				5607
				5608
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5609	<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]	5610	<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]	5611	switch statement or conditional operator.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5612
				5613	Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true))))
				5614	if (true) {}
				5615	</pre></td></tr>
				5616
				5617
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5618	<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]	5619	<tr><td colspan="4" class="doc" id="hasConditionVariableStatement0"><pre>Matches the condition variable statement in an if statement.
				5620
				5621	Given
				5622	if (A* a = GetAPointer()) {}
				5623	hasConditionVariableStatement(...)
				5624	matches 'A* a = GetAPointer()'.
				5625	</pre></td></tr>
				5626
				5627
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5628	<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]	5629	<tr><td colspan="4" class="doc" id="hasElse0"><pre>Matches the else-statement of an if statement.
				5630
				5631	Examples matches the if statement
				5632	(matcher = ifStmt(hasElse(cxxBoolLiteral(equals(true)))))
				5633	if (false) false; else true;
				5634	</pre></td></tr>
				5635
				5636
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5637	<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]	5638	<tr><td colspan="4" class="doc" id="hasThen0"><pre>Matches the then-statement of an if statement.
				5639
				5640	Examples matches the if statement
				5641	(matcher = ifStmt(hasThen(cxxBoolLiteral(equals(true)))))
				5642	if (false) true; else false;
				5643	</pre></td></tr>
				5644
				5645
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5646	<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]	5647	<tr><td colspan="4" class="doc" id="hasImplicitDestinationType0"><pre>Matches implicit casts whose destination type matches a given
				5648	matcher.
				5649
				5650	FIXME: Unit test this matcher
				5651	</pre></td></tr>
				5652
				5653
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	5654	<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>
				5655	<tr><td colspan="4" class="doc" id="hasSyntacticForm0"><pre>Matches the syntactic form of init list expressions
				5656	(if expression have it).
				5657	</pre></td></tr>
				5658
				5659
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5660	<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]	5661	<tr><td colspan="4" class="doc" id="hasDeclaration9"><pre>Matches a node if the declaration associated with that node
				5662	matches the given matcher.
				5663
				5664	The associated declaration is:
				5665	- for type nodes, the declaration of the underlying type
				5666	- for CallExpr, the declaration of the callee
				5667	- for MemberExpr, the declaration of the referenced member
				5668	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	5669	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5670
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5671	For type nodes, hasDeclaration will generally match the declaration of the
				5672	sugared type. Given
				5673	class X {};
				5674	typedef X Y;
				5675	Y y;
				5676	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				5677	typedefDecl. A common use case is to match the underlying, desugared type.
				5678	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				5679	varDecl(hasType(hasUnqualifiedDesugaredType(
				5680	recordType(hasDeclaration(decl())))))
				5681	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5682
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	5683	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>>,
				5684	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>>,
				5685	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>>,
				5686	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>>,
				5687	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>>,
				5688	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>>,
				5689	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
				5690	</pre></td></tr>
				5691
				5692
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5693	<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]	5694	<tr><td colspan="4" class="doc" id="hasDeclaration8"><pre>Matches a node if the declaration associated with that node
				5695	matches the given matcher.
				5696
				5697	The associated declaration is:
				5698	- for type nodes, the declaration of the underlying type
				5699	- for CallExpr, the declaration of the callee
				5700	- for MemberExpr, the declaration of the referenced member
				5701	- for CXXConstructExpr, the declaration of the constructor
				5702	- for CXXNewExpr, the declaration of the operator new
				5703
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5704	For type nodes, hasDeclaration will generally match the declaration of the
				5705	sugared type. Given
				5706	class X {};
				5707	typedef X Y;
				5708	Y y;
				5709	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				5710	typedefDecl. A common use case is to match the underlying, desugared type.
				5711	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				5712	varDecl(hasType(hasUnqualifiedDesugaredType(
				5713	recordType(hasDeclaration(decl())))))
				5714	In this matcher, the decl will match the CXXRecordDecl of class X.
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	5715
				5716	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>>,
				5717	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>>,
				5718	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>>,
				5719	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>>,
				5720	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>>,
				5721	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>>,
				5722	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]	5723	</pre></td></tr>
				5724
				5725
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5726	<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]	5727	<tr><td colspan="4" class="doc" id="hasDeclaration7"><pre>Matches a node if the declaration associated with that node
				5728	matches the given matcher.
				5729
				5730	The associated declaration is:
				5731	- for type nodes, the declaration of the underlying type
				5732	- for CallExpr, the declaration of the callee
				5733	- for MemberExpr, the declaration of the referenced member
				5734	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	5735	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5736
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	5737	For type nodes, hasDeclaration will generally match the declaration of the
				5738	sugared type. Given
				5739	class X {};
				5740	typedef X Y;
				5741	Y y;
				5742	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				5743	typedefDecl. A common use case is to match the underlying, desugared type.
				5744	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				5745	varDecl(hasType(hasUnqualifiedDesugaredType(
				5746	recordType(hasDeclaration(decl())))))
				5747	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5748
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	5749	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>>,
				5750	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>>,
				5751	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>>,
				5752	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>>,
				5753	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>>,
				5754	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>>,
				5755	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]	5756	</pre></td></tr>
				5757
				5758
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5759	<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]	5760	<tr><td colspan="4" class="doc" id="hasObjectExpression0"><pre>Matches a member expression where the object expression is
				5761	matched by a given matcher.
				5762
				5763	Given
				5764	struct X { int m; };
				5765	void f(X x) { x.m; m; }
				5766	memberExpr(hasObjectExpression(hasType(cxxRecordDecl(hasName("X")))))))
				5767	matches "x.m" and "m"
				5768	with hasObjectExpression(...)
				5769	matching "x" and the implicit object expression of "m" which has type X*.
				5770	</pre></td></tr>
				5771
				5772
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5773	<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]	5774	<tr><td colspan="4" class="doc" id="member0"><pre>Matches a member expression where the member is matched by a
				5775	given matcher.
				5776
				5777	Given
				5778	struct { int first, second; } first, second;
				5779	int i(second.first);
				5780	int j(first.second);
				5781	memberExpr(member(hasName("first")))
				5782	matches second.first
				5783	but not first.second (because the member name there is "second").
				5784	</pre></td></tr>
				5785
				5786
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5787	<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]	5788	<tr><td colspan="4" class="doc" id="pointeeLoc1"><pre>Narrows PointerType (and similar) matchers to those where the
				5789	pointee matches a given matcher.
				5790
				5791	Given
				5792	int *a;
				5793	int const *b;
				5794	float const *f;
				5795	pointerType(pointee(isConstQualified(), isInteger()))
				5796	matches "int const *b"
				5797
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5798	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>>,
				5799	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]	5800	</pre></td></tr>
				5801
				5802
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5803	<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]	5804	<tr><td colspan="4" class="doc" id="pointee1"><pre>Narrows PointerType (and similar) matchers to those where the
				5805	pointee matches a given matcher.
				5806
				5807	Given
				5808	int *a;
				5809	int const *b;
				5810	float const *f;
				5811	pointerType(pointee(isConstQualified(), isInteger()))
				5812	matches "int const *b"
				5813
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5814	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>>,
				5815	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]	5816	</pre></td></tr>
				5817
				5818
Martin Bohme	8cef2c2	2016-08-09 15:07:52 +0000	[diff] [blame]	5819	<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>
				5820	<tr><td colspan="4" class="doc" id="hasUnderlyingDecl0"><pre>Matches a NamedDecl whose underlying declaration matches the given
				5821	matcher.
				5822
				5823	Given
				5824	namespace N { template<class T> void f(T t); }
				5825	template <class T> void g() { using N::f; f(T()); }
				5826	unresolvedLookupExpr(hasAnyDeclaration(
				5827	namedDecl(hasUnderlyingDecl(hasName("::N::f")))))
				5828	matches the use of f in g() .
				5829	</pre></td></tr>
				5830
				5831
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5832	<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]	5833	<tr><td colspan="4" class="doc" id="hasPrefix1"><pre>Matches on the prefix of a NestedNameSpecifierLoc.
				5834
				5835	Given
				5836	struct A { struct B { struct C {}; }; };
				5837	A::B::C c;
				5838	nestedNameSpecifierLoc(hasPrefix(loc(specifiesType(asString("struct A")))))
				5839	matches "A::"
				5840	</pre></td></tr>
				5841
				5842
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5843	<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]	5844	<tr><td colspan="4" class="doc" id="specifiesTypeLoc0"><pre>Matches nested name specifier locs that specify a type matching the
				5845	given TypeLoc.
				5846
				5847	Given
				5848	struct A { struct B { struct C {}; }; };
				5849	A::B::C c;
				5850	nestedNameSpecifierLoc(specifiesTypeLoc(loc(type(
				5851	hasDeclaration(cxxRecordDecl(hasName("A")))))))
				5852	matches "A::"
				5853	</pre></td></tr>
				5854
				5855
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5856	<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]	5857	<tr><td colspan="4" class="doc" id="hasPrefix0"><pre>Matches on the prefix of a NestedNameSpecifier.
				5858
				5859	Given
				5860	struct A { struct B { struct C {}; }; };
				5861	A::B::C c;
				5862	nestedNameSpecifier(hasPrefix(specifiesType(asString("struct A")))) and
				5863	matches "A::"
				5864	</pre></td></tr>
				5865
				5866
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5867	<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]	5868	<tr><td colspan="4" class="doc" id="specifiesNamespace0"><pre>Matches nested name specifiers that specify a namespace matching the
				5869	given namespace matcher.
				5870
				5871	Given
				5872	namespace ns { struct A {}; }
				5873	ns::A a;
				5874	nestedNameSpecifier(specifiesNamespace(hasName("ns")))
				5875	matches "ns::"
				5876	</pre></td></tr>
				5877
				5878
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5879	<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]	5880	<tr><td colspan="4" class="doc" id="specifiesType0"><pre>Matches nested name specifiers that specify a type matching the
				5881	given QualType matcher without qualifiers.
				5882
				5883	Given
				5884	struct A { struct B { struct C {}; }; };
				5885	A::B::C c;
				5886	nestedNameSpecifier(specifiesType(
				5887	hasDeclaration(cxxRecordDecl(hasName("A")))
				5888	))
				5889	matches "A::"
				5890	</pre></td></tr>
				5891
				5892
George Karpenkov	a763fdf	2018-03-07 02:32:44 +0000	[diff] [blame]	5893	<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>
				5894	<tr><td colspan="4" class="doc" id="hasAnyArgument2"><pre>Matches any argument of a call expression or a constructor call
				5895	expression, or an ObjC-message-send expression.
				5896
				5897	Given
				5898	void x(int, int, int) { int y; x(1, y, 42); }
				5899	callExpr(hasAnyArgument(declRefExpr()))
				5900	matches x(1, y, 42)
				5901	with hasAnyArgument(...)
				5902	matching y
				5903
				5904	For ObjectiveC, given
				5905	@interface I - (void) f:(int) y; @end
Clement Courbet	2513aa0	2018-03-21 10:48:00 +0000	[diff] [blame]	5906	void foo(I *i) { [i f:12]; }
George Karpenkov	a763fdf	2018-03-07 02:32:44 +0000	[diff] [blame]	5907	objcMessageExpr(hasAnyArgument(integerLiteral(equals(12))))
				5908	matches [i f:12]
				5909	</pre></td></tr>
				5910
				5911
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5912	<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]	5913	<tr><td colspan="4" class="doc" id="hasArgument2"><pre>Matches the n'th argument of a call expression or a constructor
				5914	call expression.
				5915
				5916	Example matches y in x(y)
				5917	(matcher = callExpr(hasArgument(0, declRefExpr())))
				5918	void x(int) { int y; x(y); }
				5919	</pre></td></tr>
				5920
				5921
George Karpenkov	b5ea4df	2018-07-16 20:22:12 +0000	[diff] [blame]	5922	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMessageExpr.html">ObjCMessageExpr</a>></td><td class="name" onclick="toggle('hasReceiver0')"><a name="hasReceiver0Anchor">hasReceiver</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Expr.html">Expr</a>> InnerMatcher</td></tr>
				5923	<tr><td colspan="4" class="doc" id="hasReceiver0"><pre>Matches if the Objective-C message is sent to an instance,
				5924	and the inner matcher matches on that instance.
				5925
				5926	For example the method call in
				5927	NSString *x = @"hello";
George Karpenkov	daac52c	2018-07-23 22:29:10 +0000	[diff] [blame]	5928	[x containsString:@"h"];
George Karpenkov	b5ea4df	2018-07-16 20:22:12 +0000	[diff] [blame]	5929	is matched by
				5930	objcMessageExpr(hasReceiver(declRefExpr(to(varDecl(hasName("x"))))))
				5931	</pre></td></tr>
				5932
				5933
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	5934	<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]	5935	<tr><td colspan="4" class="doc" id="hasReceiverType0"><pre>Matches on the receiver of an ObjectiveC Message expression.
				5936
				5937	Example
Jakub Kuderski	64b6c78	2017-05-05 21:01:12 +0000	[diff] [blame]	5938	matcher = objCMessageExpr(hasReceiverType(asString("UIWebView *")));
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	5939	matches the [webView ...] message invocation.
				5940	NSString *webViewJavaScript = ...
				5941	UIWebView *webView = ...
				5942	[webView stringByEvaluatingJavaScriptFromString:webViewJavascript];
				5943	</pre></td></tr>
				5944
				5945
George Karpenkov	9d1d0c4	2018-03-29 00:51:11 +0000	[diff] [blame]	5946	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMethodDecl.html">ObjCMethodDecl</a>></td><td class="name" onclick="toggle('hasAnyParameter1')"><a name="hasAnyParameter1Anchor">hasAnyParameter</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParmVarDecl.html">ParmVarDecl</a>> InnerMatcher</td></tr>
George Karpenkov	b4c0cbd	2018-05-16 22:47:03 +0000	[diff] [blame]	5947	<tr><td colspan="4" class="doc" id="hasAnyParameter1"><pre>Matches any parameter of a function or an ObjC method declaration or a
				5948	block.
George Karpenkov	9d1d0c4	2018-03-29 00:51:11 +0000	[diff] [blame]	5949
				5950	Does not match the 'this' parameter of a method.
				5951
				5952	Given
				5953	class X { void f(int x, int y, int z) {} };
				5954	cxxMethodDecl(hasAnyParameter(hasName("y")))
				5955	matches f(int x, int y, int z) {}
				5956	with hasAnyParameter(...)
				5957	matching int y
				5958
				5959	For ObjectiveC, given
				5960	@interface I - (void) f:(int) y; @end
				5961
				5962	the matcher objcMethodDecl(hasAnyParameter(hasName("y")))
				5963	matches the declaration of method f with hasParameter
				5964	matching y.
George Karpenkov	b4c0cbd	2018-05-16 22:47:03 +0000	[diff] [blame]	5965
				5966	For blocks, given
				5967	b = ^(int y) { printf("%d", y) };
				5968
				5969	the matcher blockDecl(hasAnyParameter(hasName("y")))
				5970	matches the declaration of the block b with hasParameter
				5971	matching y.
George Karpenkov	9d1d0c4	2018-03-29 00:51:11 +0000	[diff] [blame]	5972	</pre></td></tr>
				5973
				5974
				5975	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ObjCMethodDecl.html">ObjCMethodDecl</a>></td><td class="name" onclick="toggle('hasParameter1')"><a name="hasParameter1Anchor">hasParameter</a></td><td>unsigned N, Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ParmVarDecl.html">ParmVarDecl</a>> InnerMatcher</td></tr>
				5976	<tr><td colspan="4" class="doc" id="hasParameter1"><pre>Matches the n'th parameter of a function or an ObjC method
George Karpenkov	b4c0cbd	2018-05-16 22:47:03 +0000	[diff] [blame]	5977	declaration or a block.
George Karpenkov	9d1d0c4	2018-03-29 00:51:11 +0000	[diff] [blame]	5978
				5979	Given
				5980	class X { void f(int x) {} };
				5981	cxxMethodDecl(hasParameter(0, hasType(varDecl())))
				5982	matches f(int x) {}
				5983	with hasParameter(...)
				5984	matching int x
				5985
				5986	For ObjectiveC, given
				5987	@interface I - (void) f:(int) y; @end
				5988
				5989	the matcher objcMethodDecl(hasParameter(0, hasName("y")))
				5990	matches the declaration of method f with hasParameter
				5991	matching y.
				5992	</pre></td></tr>
				5993
				5994
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	5995	<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]	5996	<tr><td colspan="4" class="doc" id="hasSourceExpression1"><pre>Matches if the cast's source expression
				5997	or opaque value's source expression matches the given matcher.
				5998
				5999	Example 1: matches "a string"
				6000	(matcher = castExpr(hasSourceExpression(cxxConstructExpr())))
				6001	class URL { URL(string); };
				6002	URL url = "a string";
				6003
				6004	Example 2: matches 'b' (matcher =
				6005	opaqueValueExpr(hasSourceExpression(implicitCastExpr(declRefExpr())))
				6006	int a = b ?: 1;
				6007	</pre></td></tr>
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	6008
				6009
Martin Bohme	8cef2c2	2016-08-09 15:07:52 +0000	[diff] [blame]	6010	<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>
				6011	<tr><td colspan="4" class="doc" id="hasAnyDeclaration0"><pre>Matches an OverloadExpr if any of the declarations in the set of
				6012	overloads matches the given matcher.
				6013
				6014	Given
				6015	template <typename T> void foo(T);
				6016	template <typename T> void bar(T);
				6017	template <typename T> void baz(T t) {
				6018	foo(t);
				6019	bar(t);
				6020	}
				6021	unresolvedLookupExpr(hasAnyDeclaration(
				6022	functionTemplateDecl(hasName("foo"))))
				6023	matches foo in foo(t); but not bar in bar(t);
				6024	</pre></td></tr>
				6025
				6026
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6027	<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]	6028	<tr><td colspan="4" class="doc" id="innerType0"><pre>Matches ParenType nodes where the inner type is a specific type.
				6029
				6030	Given
				6031	int (*ptr_to_array)[4];
				6032	int (*ptr_to_func)(int);
				6033
				6034	varDecl(hasType(pointsTo(parenType(innerType(functionType()))))) matches
				6035	ptr_to_func but not ptr_to_array.
				6036
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6037	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]	6038	</pre></td></tr>
				6039
				6040
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6041	<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]	6042	<tr><td colspan="4" class="doc" id="pointeeLoc2"><pre>Narrows PointerType (and similar) matchers to those where the
				6043	pointee matches a given matcher.
				6044
				6045	Given
				6046	int *a;
				6047	int const *b;
				6048	float const *f;
				6049	pointerType(pointee(isConstQualified(), isInteger()))
				6050	matches "int const *b"
				6051
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6052	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>>,
				6053	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]	6054	</pre></td></tr>
				6055
				6056
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6057	<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]	6058	<tr><td colspan="4" class="doc" id="pointee2"><pre>Narrows PointerType (and similar) matchers to those where the
				6059	pointee matches a given matcher.
				6060
				6061	Given
				6062	int *a;
				6063	int const *b;
				6064	float const *f;
				6065	pointerType(pointee(isConstQualified(), isInteger()))
				6066	matches "int const *b"
				6067
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6068	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>>,
				6069	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]	6070	</pre></td></tr>
				6071
				6072
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6073	<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]	6074	<tr><td colspan="4" class="doc" id="hasCanonicalType0"><pre>Matches QualTypes whose canonical type matches InnerMatcher.
				6075
				6076	Given:
				6077	typedef int &int_ref;
				6078	int a;
				6079	int_ref b = a;
				6080
				6081	varDecl(hasType(qualType(referenceType()))))) will not match the
				6082	declaration of b but varDecl(hasType(qualType(hasCanonicalType(referenceType())))))) does.
				6083	</pre></td></tr>
				6084
				6085
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6086	<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]	6087	<tr><td colspan="4" class="doc" id="hasDeclaration6"><pre>Matches a node if the declaration associated with that node
				6088	matches the given matcher.
				6089
				6090	The associated declaration is:
				6091	- for type nodes, the declaration of the underlying type
				6092	- for CallExpr, the declaration of the callee
				6093	- for MemberExpr, the declaration of the referenced member
				6094	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	6095	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6096
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6097	For type nodes, hasDeclaration will generally match the declaration of the
				6098	sugared type. Given
				6099	class X {};
				6100	typedef X Y;
				6101	Y y;
				6102	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				6103	typedefDecl. A common use case is to match the underlying, desugared type.
				6104	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				6105	varDecl(hasType(hasUnqualifiedDesugaredType(
				6106	recordType(hasDeclaration(decl())))))
				6107	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6108
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	6109	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>>,
				6110	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>>,
				6111	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>>,
				6112	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>>,
				6113	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>>,
				6114	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>>,
				6115	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]	6116	</pre></td></tr>
				6117
				6118
Aaron Ballman	ba8dbbe	2016-06-06 18:52:17 +0000	[diff] [blame]	6119	<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>
				6120	<tr><td colspan="4" class="doc" id="ignoringParens0"><pre>Matches types that match InnerMatcher after any parens are stripped.
				6121
				6122	Given
				6123	void (*fp)(void);
				6124	The matcher
				6125	varDecl(hasType(pointerType(pointee(ignoringParens(functionType())))))
				6126	would match the declaration for fp.
				6127	</pre></td></tr>
				6128
				6129
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6130	<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]	6131	<tr><td colspan="4" class="doc" id="pointsTo1"><pre>Overloaded to match the pointee type's declaration.
				6132	</pre></td></tr>
				6133
				6134
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6135	<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]	6136	<tr><td colspan="4" class="doc" id="pointsTo0"><pre>Matches if the matched type is a pointer type and the pointee type
				6137	matches the specified matcher.
				6138
				6139	Example matches y->x()
				6140	(matcher = cxxMemberCallExpr(on(hasType(pointsTo
				6141	cxxRecordDecl(hasName("Y")))))))
				6142	class Y { public: void x(); };
				6143	void z() { Y *y; y->x(); }
				6144	</pre></td></tr>
				6145
				6146
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6147	<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]	6148	<tr><td colspan="4" class="doc" id="references1"><pre>Overloaded to match the referenced type's declaration.
				6149	</pre></td></tr>
				6150
				6151
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6152	<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]	6153	<tr><td colspan="4" class="doc" id="references0"><pre>Matches if the matched type is a reference type and the referenced
				6154	type matches the specified matcher.
				6155
				6156	Example matches X &x and const X &y
				6157	(matcher = varDecl(hasType(references(cxxRecordDecl(hasName("X"))))))
				6158	class X {
				6159	void a(X b) {
				6160	X &x = b;
				6161	const X &y = b;
				6162	}
				6163	};
				6164	</pre></td></tr>
				6165
				6166
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6167	<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]	6168	<tr><td colspan="4" class="doc" id="hasDeclaration5"><pre>Matches a node if the declaration associated with that node
				6169	matches the given matcher.
				6170
				6171	The associated declaration is:
				6172	- for type nodes, the declaration of the underlying type
				6173	- for CallExpr, the declaration of the callee
				6174	- for MemberExpr, the declaration of the referenced member
				6175	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	6176	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6177
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6178	For type nodes, hasDeclaration will generally match the declaration of the
				6179	sugared type. Given
				6180	class X {};
				6181	typedef X Y;
				6182	Y y;
				6183	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				6184	typedefDecl. A common use case is to match the underlying, desugared type.
				6185	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				6186	varDecl(hasType(hasUnqualifiedDesugaredType(
				6187	recordType(hasDeclaration(decl())))))
				6188	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6189
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	6190	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>>,
				6191	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>>,
				6192	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>>,
				6193	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>>,
				6194	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>>,
				6195	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>>,
				6196	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]	6197	</pre></td></tr>
				6198
				6199
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6200	<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]	6201	<tr><td colspan="4" class="doc" id="pointeeLoc3"><pre>Narrows PointerType (and similar) matchers to those where the
				6202	pointee matches a given matcher.
				6203
				6204	Given
				6205	int *a;
				6206	int const *b;
				6207	float const *f;
				6208	pointerType(pointee(isConstQualified(), isInteger()))
				6209	matches "int const *b"
				6210
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6211	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>>,
				6212	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]	6213	</pre></td></tr>
				6214
				6215
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6216	<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]	6217	<tr><td colspan="4" class="doc" id="pointee3"><pre>Narrows PointerType (and similar) matchers to those where the
				6218	pointee matches a given matcher.
				6219
				6220	Given
				6221	int *a;
				6222	int const *b;
				6223	float const *f;
				6224	pointerType(pointee(isConstQualified(), isInteger()))
				6225	matches "int const *b"
				6226
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6227	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>>,
				6228	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]	6229	</pre></td></tr>
				6230
				6231
Alexander Kornienko	976921d	2016-03-22 11:03:03 +0000	[diff] [blame]	6232	<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>
				6233	<tr><td colspan="4" class="doc" id="hasReturnValue0"><pre>Matches the return value expression of a return statement
				6234
				6235	Given
				6236	return a + b;
				6237	hasReturnValue(binaryOperator())
				6238	matches 'return a + b'
				6239	with binaryOperator()
				6240	matching 'a + b'
				6241	</pre></td></tr>
				6242
				6243
Aaron Ballman	a35b8fc	2016-03-09 17:11:51 +0000	[diff] [blame]	6244	<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>
				6245	<tr><td colspan="4" class="doc" id="hasAnySubstatement1"><pre>Matches compound statements where at least one substatement matches
				6246	a given matcher. Also matches StmtExprs that have CompoundStmt as children.
				6247
				6248	Given
				6249	{ {}; 1+2; }
				6250	hasAnySubstatement(compoundStmt())
				6251	matches '{ {}; 1+2; }'
				6252	with compoundStmt()
				6253	matching '{}'
				6254	</pre></td></tr>
				6255
				6256
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6257	<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]	6258	<tr><td colspan="4" class="doc" id="alignOfExpr0"><pre>Same as unaryExprOrTypeTraitExpr, but only matching
				6259	alignof.
				6260	</pre></td></tr>
				6261
				6262
Gabor Horvath	1b3f8db	2016-05-04 11:59:39 +0000	[diff] [blame]	6263	<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]	6264	<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]	6265
				6266	Given:
				6267	F& operator=(const F& o) {
				6268	std::copy_if(o.begin(), o.end(), begin(), [](V v) { return v > 0; });
				6269	return *this;
				6270	}
				6271	returnStmt(forFunction(hasName("operator=")))
				6272	matches 'return *this'
				6273	but does match 'return > 0'
				6274	</pre></td></tr>
				6275
				6276
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6277	<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]	6278	<tr><td colspan="4" class="doc" id="sizeOfExpr0"><pre>Same as unaryExprOrTypeTraitExpr, but only matching
				6279	sizeof.
				6280	</pre></td></tr>
				6281
				6282
Malcolm Parsons	77f039b	2016-12-08 11:46:22 +0000	[diff] [blame]	6283	<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>
				6284	<tr><td colspan="4" class="doc" id="hasReplacementType0"><pre>Matches template type parameter substitutions that have a replacement
				6285	type that matches the provided matcher.
				6286
				6287	Given
				6288	template <typename T>
				6289	double F(T t);
				6290	int i;
				6291	double j = F(i);
				6292
				6293	substTemplateTypeParmType(hasReplacementType(type())) matches int
				6294	</pre></td></tr>
				6295
				6296
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6297	<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]	6298	<tr><td colspan="4" class="doc" id="forEachSwitchCase0"><pre>Matches each case or default statement belonging to the given switch
				6299	statement. This matcher may produce multiple matches.
				6300
				6301	Given
				6302	switch (1) { case 1: case 2: default: switch (2) { case 3: case 4: ; } }
				6303	switchStmt(forEachSwitchCase(caseStmt().bind("c"))).bind("s")
				6304	matches four times, with "c" binding each of "case 1:", "case 2:",
				6305	"case 3:" and "case 4:", and "s" respectively binding "switch (1)",
				6306	"switch (1)", "switch (2)" and "switch (2)".
				6307	</pre></td></tr>
				6308
				6309
Etienne Bergeron	5500f95	2016-05-30 15:25:25 +0000	[diff] [blame]	6310	<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>
				6311	<tr><td colspan="4" class="doc" id="hasCondition4"><pre>Matches the condition expression of an if statement, for loop,
				6312	switch statement or conditional operator.
				6313
				6314	Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true))))
				6315	if (true) {}
				6316	</pre></td></tr>
				6317
				6318
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6319	<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]	6320	<tr><td colspan="4" class="doc" id="hasDeclaration4"><pre>Matches a node if the declaration associated with that node
				6321	matches the given matcher.
				6322
				6323	The associated declaration is:
				6324	- for type nodes, the declaration of the underlying type
				6325	- for CallExpr, the declaration of the callee
				6326	- for MemberExpr, the declaration of the referenced member
				6327	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	6328	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6329
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6330	For type nodes, hasDeclaration will generally match the declaration of the
				6331	sugared type. Given
				6332	class X {};
				6333	typedef X Y;
				6334	Y y;
				6335	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				6336	typedefDecl. A common use case is to match the underlying, desugared type.
				6337	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				6338	varDecl(hasType(hasUnqualifiedDesugaredType(
				6339	recordType(hasDeclaration(decl())))))
				6340	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6341
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	6342	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>>,
				6343	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>>,
				6344	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>>,
				6345	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>>,
				6346	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>>,
				6347	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>>,
				6348	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]	6349	</pre></td></tr>
				6350
				6351
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6352	<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]	6353	<tr><td colspan="4" class="doc" id="isExpr0"><pre>Matches a sugar TemplateArgument that refers to a certain expression.
				6354
				6355	Given
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	6356	struct B { int next; };
				6357	template<int(B::*next_ptr)> struct A {};
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6358	A<&B::next> a;
				6359	templateSpecializationType(hasAnyTemplateArgument(
				6360	isExpr(hasDescendant(declRefExpr(to(fieldDecl(hasName("next"))))))))
				6361	matches the specialization A<&B::next> with fieldDecl(...) matching
				6362	B::next
				6363	</pre></td></tr>
				6364
				6365
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6366	<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]	6367	<tr><td colspan="4" class="doc" id="refersToDeclaration0"><pre>Matches a canonical TemplateArgument that refers to a certain
				6368	declaration.
				6369
				6370	Given
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	6371	struct B { int next; };
				6372	template<int(B::*next_ptr)> struct A {};
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6373	A<&B::next> a;
				6374	classTemplateSpecializationDecl(hasAnyTemplateArgument(
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	6375	refersToDeclaration(fieldDecl(hasName("next")))))
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6376	matches the specialization A<&B::next> with fieldDecl(...) matching
				6377	B::next
				6378	</pre></td></tr>
				6379
				6380
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6381	<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]	6382	<tr><td colspan="4" class="doc" id="refersToIntegralType0"><pre>Matches a TemplateArgument that referes to an integral type.
				6383
				6384	Given
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	6385	template<int T> struct C {};
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6386	C<42> c;
				6387	classTemplateSpecializationDecl(
				6388	hasAnyTemplateArgument(refersToIntegralType(asString("int"))))
				6389	matches the implicit instantiation of C in C<42>.
				6390	</pre></td></tr>
				6391
				6392
Haojian Wu	b33b02e	2016-07-29 15:45:11 +0000	[diff] [blame]	6393	<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>
				6394	<tr><td colspan="4" class="doc" id="refersToTemplate0"><pre>Matches a TemplateArgument that refers to a certain template.
				6395
				6396	Given
				6397	template<template <typename> class S> class X {};
				6398	template<typename T> class Y {};"
				6399	X<Y> xi;
				6400	classTemplateSpecializationDecl(hasAnyTemplateArgument(
				6401	refersToTemplate(templateName())))
				6402	matches the specialization X<Y>
				6403	</pre></td></tr>
				6404
				6405
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6406	<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]	6407	<tr><td colspan="4" class="doc" id="refersToType0"><pre>Matches a TemplateArgument that refers to a certain type.
				6408
				6409	Given
				6410	struct X {};
				6411	template<typename T> struct A {};
				6412	A<X> a;
				6413	classTemplateSpecializationDecl(hasAnyTemplateArgument(
				6414	refersToType(class(hasName("X")))))
				6415	matches the specialization A<X>
				6416	</pre></td></tr>
				6417
				6418
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6419	<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]	6420	<tr><td colspan="4" class="doc" id="hasAnyTemplateArgument1"><pre>Matches classTemplateSpecializations, templateSpecializationType and
				6421	functionDecl that have at least one TemplateArgument matching the given
				6422	InnerMatcher.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6423
				6424	Given
				6425	template<typename T> class A {};
				6426	template<> class A<double> {};
				6427	A<int> a;
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	6428
Haojian Wu	99e39a7	2016-07-29 17:30:13 +0000	[diff] [blame]	6429	template<typename T> f() {};
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	6430	void func() { f<int>(); };
				6431
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6432	classTemplateSpecializationDecl(hasAnyTemplateArgument(
				6433	refersToType(asString("int"))))
				6434	matches the specialization A<int>
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	6435
				6436	functionDecl(hasAnyTemplateArgument(refersToType(asString("int"))))
				6437	matches the specialization f<int>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6438	</pre></td></tr>
				6439
				6440
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6441	<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]	6442	<tr><td colspan="4" class="doc" id="hasDeclaration3"><pre>Matches a node if the declaration associated with that node
				6443	matches the given matcher.
				6444
				6445	The associated declaration is:
				6446	- for type nodes, the declaration of the underlying type
				6447	- for CallExpr, the declaration of the callee
				6448	- for MemberExpr, the declaration of the referenced member
				6449	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	6450	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6451
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6452	For type nodes, hasDeclaration will generally match the declaration of the
				6453	sugared type. Given
				6454	class X {};
				6455	typedef X Y;
				6456	Y y;
				6457	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				6458	typedefDecl. A common use case is to match the underlying, desugared type.
				6459	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				6460	varDecl(hasType(hasUnqualifiedDesugaredType(
				6461	recordType(hasDeclaration(decl())))))
				6462	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6463
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	6464	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>>,
				6465	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>>,
				6466	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>>,
				6467	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>>,
				6468	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>>,
				6469	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>>,
				6470	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]	6471	</pre></td></tr>
				6472
				6473
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6474	<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]	6475	<tr><td colspan="4" class="doc" id="hasTemplateArgument1"><pre>Matches classTemplateSpecializations, templateSpecializationType and
				6476	functionDecl where the n'th TemplateArgument matches the given InnerMatcher.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6477
				6478	Given
				6479	template<typename T, typename U> class A {};
				6480	A<bool, int> b;
				6481	A<int, bool> c;
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	6482
Fangrui Song	55942ab	2018-01-22 22:34:15 +0000	[diff] [blame]	6483	template<typename T> void f() {}
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	6484	void func() { f<int>(); };
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6485	classTemplateSpecializationDecl(hasTemplateArgument(
				6486	1, refersToType(asString("int"))))
				6487	matches the specialization A<bool, int>
Haojian Wu	d898b09	2016-07-29 13:57:27 +0000	[diff] [blame]	6488
				6489	functionDecl(hasTemplateArgument(0, refersToType(asString("int"))))
				6490	matches the specialization f<int>
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6491	</pre></td></tr>
				6492
				6493
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6494	<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]	6495	<tr><td colspan="4" class="doc" id="hasDeclaration2"><pre>Matches a node if the declaration associated with that node
				6496	matches the given matcher.
				6497
				6498	The associated declaration is:
				6499	- for type nodes, the declaration of the underlying type
				6500	- for CallExpr, the declaration of the callee
				6501	- for MemberExpr, the declaration of the referenced member
				6502	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	6503	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6504
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6505	For type nodes, hasDeclaration will generally match the declaration of the
				6506	sugared type. Given
				6507	class X {};
				6508	typedef X Y;
				6509	Y y;
				6510	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				6511	typedefDecl. A common use case is to match the underlying, desugared type.
				6512	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				6513	varDecl(hasType(hasUnqualifiedDesugaredType(
				6514	recordType(hasDeclaration(decl())))))
				6515	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6516
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	6517	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>>,
				6518	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>>,
				6519	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>>,
				6520	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>>,
				6521	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>>,
				6522	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>>,
				6523	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]	6524	</pre></td></tr>
				6525
				6526
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6527	<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]	6528	<tr><td colspan="4" class="doc" id="findAll0"><pre>Matches if the node or any descendant matches.
				6529
				6530	Generates results for each match.
				6531
				6532	For example, in:
				6533	class A { class B {}; class C {}; };
				6534	The matcher:
				6535	cxxRecordDecl(hasName("::A"),
				6536	findAll(cxxRecordDecl(isDefinition()).bind("m")))
				6537	will generate results for A, B and C.
				6538
				6539	Usable as: Any Matcher
				6540	</pre></td></tr>
				6541
				6542
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	6543	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1TypedefNameDecl.html">TypedefNameDecl</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>
				6544	<tr><td colspan="4" class="doc" id="hasType2"><pre>Matches if the expression's or declaration's type matches a type
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	6545	matcher.
				6546
				6547	Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X")))))
				6548	and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X")))))
				6549	and U (matcher = typedefDecl(hasType(asString("int")))
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	6550	and friend class X (matcher = friendDecl(hasType("X"))
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	6551	class X {};
				6552	void y(X &x) { x; X z; }
				6553	typedef int U;
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	6554	class Y { friend class X; };
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	6555	</pre></td></tr>
				6556
				6557
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6558	<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]	6559	<tr><td colspan="4" class="doc" id="hasDeclaration1"><pre>Matches a node if the declaration associated with that node
				6560	matches the given matcher.
				6561
				6562	The associated declaration is:
				6563	- for type nodes, the declaration of the underlying type
				6564	- for CallExpr, the declaration of the callee
				6565	- for MemberExpr, the declaration of the referenced member
				6566	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	6567	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6568
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6569	For type nodes, hasDeclaration will generally match the declaration of the
				6570	sugared type. Given
				6571	class X {};
				6572	typedef X Y;
				6573	Y y;
				6574	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				6575	typedefDecl. A common use case is to match the underlying, desugared type.
				6576	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				6577	varDecl(hasType(hasUnqualifiedDesugaredType(
				6578	recordType(hasDeclaration(decl())))))
				6579	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6580
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	6581	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>>,
				6582	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>>,
				6583	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>>,
				6584	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>>,
				6585	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>>,
				6586	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>>,
				6587	Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1UnresolvedUsingType.html">UnresolvedUsingType</a>>
				6588	</pre></td></tr>
				6589
				6590
				6591	<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>
				6592	<tr><td colspan="4" class="doc" id="hasUnqualifiedDesugaredType0"><pre>Matches if the matched type matches the unqualified desugared
				6593	type of the matched node.
				6594
				6595	For example, in:
				6596	class A {};
				6597	using B = A;
George Karpenkov	daac52c	2018-07-23 22:29:10 +0000	[diff] [blame]	6598	The matcher type(hasUnqualifiedDesugaredType(recordType())) matches
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	6599	both B and A.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6600	</pre></td></tr>
				6601
				6602
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6603	<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]	6604	<tr><td colspan="4" class="doc" id="hasArgumentOfType0"><pre>Matches unary expressions that have a specific type of argument.
				6605
				6606	Given
				6607	int a, c; float b; int s = sizeof(a) + sizeof(b) + alignof(c);
				6608	unaryExprOrTypeTraitExpr(hasArgumentOfType(asString("int"))
				6609	matches sizeof(a) and alignof(c)
				6610	</pre></td></tr>
				6611
				6612
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6613	<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]	6614	<tr><td colspan="4" class="doc" id="hasUnaryOperand0"><pre>Matches if the operand of a unary operator matches.
				6615
				6616	Example matches true (matcher = hasUnaryOperand(
				6617	cxxBoolLiteral(equals(true))))
				6618	!true
				6619	</pre></td></tr>
				6620
				6621
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6622	<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]	6623	<tr><td colspan="4" class="doc" id="hasDeclaration0"><pre>Matches a node if the declaration associated with that node
				6624	matches the given matcher.
				6625
				6626	The associated declaration is:
				6627	- for type nodes, the declaration of the underlying type
				6628	- for CallExpr, the declaration of the callee
				6629	- for MemberExpr, the declaration of the referenced member
				6630	- for CXXConstructExpr, the declaration of the constructor
Malcolm Parsons	7d96c33	2016-10-31 22:04:07 +0000	[diff] [blame]	6631	- for CXXNewExpr, the declaration of the operator new
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6632
Benjamin Kramer	ae7ff38	2018-01-17 16:50:14 +0000	[diff] [blame]	6633	For type nodes, hasDeclaration will generally match the declaration of the
				6634	sugared type. Given
				6635	class X {};
				6636	typedef X Y;
				6637	Y y;
				6638	in varDecl(hasType(hasDeclaration(decl()))) the decl will match the
				6639	typedefDecl. A common use case is to match the underlying, desugared type.
				6640	This can be achieved by using the hasUnqualifiedDesugaredType matcher:
				6641	varDecl(hasType(hasUnqualifiedDesugaredType(
				6642	recordType(hasDeclaration(decl())))))
				6643	In this matcher, the decl will match the CXXRecordDecl of class X.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6644
Manuel Klimek	a37e110	2016-12-01 15:45:06 +0000	[diff] [blame]	6645	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>>,
				6646	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>>,
				6647	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>>,
				6648	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>>,
				6649	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>>,
				6650	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>>,
				6651	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]	6652	</pre></td></tr>
				6653
				6654
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6655	<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]	6656	<tr><td colspan="4" class="doc" id="hasAnyUsingShadowDecl0"><pre>Matches any using shadow declaration.
				6657
				6658	Given
				6659	namespace X { void b(); }
				6660	using X::b;
				6661	usingDecl(hasAnyUsingShadowDecl(hasName("b"))))
				6662	matches using X::b </pre></td></tr>
				6663
				6664
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6665	<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]	6666	<tr><td colspan="4" class="doc" id="hasTargetDecl0"><pre>Matches a using shadow declaration where the target declaration is
				6667	matched by the given matcher.
				6668
				6669	Given
				6670	namespace X { int a; void b(); }
				6671	using X::a;
				6672	using X::b;
				6673	usingDecl(hasAnyUsingShadowDecl(hasTargetDecl(functionDecl())))
				6674	matches using X::b but not using X::a </pre></td></tr>
				6675
				6676
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	6677	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ValueDecl.html">ValueDecl</a>></td><td class="name" onclick="toggle('hasType6')"><a name="hasType6Anchor">hasType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>> InnerMatcher</td></tr>
				6678	<tr><td colspan="4" class="doc" id="hasType6"><pre>Overloaded to match the declaration of the expression's or value
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6679	declaration's type.
				6680
				6681	In case of a value declaration (for example a variable declaration),
				6682	this resolves one layer of indirection. For example, in the value
				6683	declaration "X x;", cxxRecordDecl(hasName("X")) matches the declaration of
				6684	X, while varDecl(hasType(cxxRecordDecl(hasName("X")))) matches the
				6685	declaration of x.
				6686
				6687	Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X")))))
				6688	and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X")))))
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	6689	and friend class X (matcher = friendDecl(hasType("X"))
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6690	class X {};
				6691	void y(X &x) { x; X z; }
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	6692	class Y { friend class X; };
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6693
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6694	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]	6695	</pre></td></tr>
				6696
				6697
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	6698	<tr><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1ValueDecl.html">ValueDecl</a>></td><td class="name" onclick="toggle('hasType3')"><a name="hasType3Anchor">hasType</a></td><td>Matcher<<a href="http://clang.llvm.org/doxygen/classclang_1_1QualType.html">QualType</a>> InnerMatcher</td></tr>
				6699	<tr><td colspan="4" class="doc" id="hasType3"><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]	6700	matcher.
				6701
				6702	Example matches x (matcher = expr(hasType(cxxRecordDecl(hasName("X")))))
				6703	and z (matcher = varDecl(hasType(cxxRecordDecl(hasName("X")))))
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	6704	and U (matcher = typedefDecl(hasType(asString("int")))
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	6705	and friend class X (matcher = friendDecl(hasType("X"))
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6706	class X {};
				6707	void y(X &x) { x; X z; }
Aaron Ballman	7e7b7b2	2016-02-01 14:11:47 +0000	[diff] [blame]	6708	typedef int U;
George Karpenkov	ba02bc5	2018-07-06 21:36:04 +0000	[diff] [blame]	6709	class Y { friend class X; };
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6710	</pre></td></tr>
				6711
				6712
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6713	<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]	6714	<tr><td colspan="4" class="doc" id="hasInitializer0"><pre>Matches a variable declaration that has an initializer expression
				6715	that matches the given matcher.
				6716
				6717	Example matches x (matcher = varDecl(hasInitializer(callExpr())))
				6718	bool y() { return true; }
				6719	bool x = y();
				6720	</pre></td></tr>
				6721
				6722
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6723	<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]	6724	<tr><td colspan="4" class="doc" id="hasSizeExpr0"><pre>Matches VariableArrayType nodes that have a specific size
				6725	expression.
				6726
				6727	Given
				6728	void f(int b) {
				6729	int a[b];
				6730	}
				6731	variableArrayType(hasSizeExpr(ignoringImpCasts(declRefExpr(to(
				6732	varDecl(hasName("b")))))))
				6733	matches "int a[b]"
				6734	</pre></td></tr>
				6735
				6736
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6737	<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]	6738	<tr><td colspan="4" class="doc" id="hasBody2"><pre>Matches a 'for', 'while', 'do while' statement or a function
				6739	definition that has a given body.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6740
				6741	Given
				6742	for (;;) {}
				6743	hasBody(compoundStmt())
				6744	matches 'for (;;) {}'
				6745	with compoundStmt()
				6746	matching '{}'
				6747	</pre></td></tr>
				6748
				6749
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6750	<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]	6751	<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]	6752	switch statement or conditional operator.
Benjamin Kramer	611d33a	2015-11-20 07:46:19 +0000	[diff] [blame]	6753
				6754	Example matches true (matcher = hasCondition(cxxBoolLiteral(equals(true))))
				6755	if (true) {}
				6756	</pre></td></tr>
				6757
				6758
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6759	<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]	6760	<tr><td colspan="4" class="doc" id="loc1"><pre>Matches NestedNameSpecifierLocs for which the given inner
				6761	NestedNameSpecifier-matcher matches.
				6762	</pre></td></tr>
				6763
				6764
Aaron Ballman	672dde2	2016-01-22 23:15:00 +0000	[diff] [blame]	6765	<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]	6766	<tr><td colspan="4" class="doc" id="loc0"><pre>Matches TypeLocs for which the given inner
				6767	QualType-matcher matches.
				6768	</pre></td></tr>
				6769
Benjamin Kramer	7d0cc23	2015-11-20 07:57:46 +0000	[diff] [blame]	6770	<!--END_TRAVERSAL_MATCHERS -->
				6771	</table>
				6772
				6773	</div>
				6774	</body>
				6775	</html>
				6776
				6777