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

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