ASTMatchers.h revision 6bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89
14da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek//===--- ASTMatchers.h - Structural query framework -------------*- C++ -*-===// 24da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// 34da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// The LLVM Compiler Infrastructure 44da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// 54da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// This file is distributed under the University of Illinois Open Source 64da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// License. See LICENSE.TXT for details. 74da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// 84da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek//===----------------------------------------------------------------------===// 94da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// 104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// This file implements matchers to be used together with the MatchFinder to 114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// match AST nodes. 124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// 134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// Matchers are created by generator functions, which can be combined in 144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// a functional in-language DSL to express queries over the C++ AST. 154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// 164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// For example, to match a class with a certain name, one would call: 172dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper// recordDecl(hasName("MyClass")) 184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// which returns a matcher that can be used to find all AST nodes that declare 194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// a class named 'MyClass'. 204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// 214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// For more complicated match expressions we're often interested in accessing 224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// multiple parts of the matched AST nodes once a match is found. In that case, 234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// use the id(...) matcher around the match expressions that match the nodes 244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// you want to access. 254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// 264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// For example, when we're interested in child classes of a certain class, we 274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// would write: 282dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper// recordDecl(hasName("MyClass"), hasChild(id("child", recordDecl()))) 294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// When the match is found via the MatchFinder, a user provided callback will 304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// be called with a BoundNodes instance that contains a mapping from the 314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// strings that we provided for the id(...) calls to the nodes that were 324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// matched. 334da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// In the given example, each time our matcher finds a match we get a callback 344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// where "child" is bound to the CXXRecordDecl node of the matching child 354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// class declaration. 364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// 374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// See ASTMatchersInternal.h for a more in-depth explanation of the 384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// implementation details of the matcher framework. 394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// 404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// See ASTMatchFinder.h for how to use the generated matchers to run over 414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// an AST. 424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek// 434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek//===----------------------------------------------------------------------===// 444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek#ifndef LLVM_CLANG_AST_MATCHERS_AST_MATCHERS_H 464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek#define LLVM_CLANG_AST_MATCHERS_AST_MATCHERS_H 474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 48de9ed71c696bee936a21323f61548164de0eda13Enea Zaffanella#include "clang/AST/DeclFriend.h" 49e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper#include "clang/AST/DeclTemplate.h" 504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek#include "clang/ASTMatchers/ASTMatchersInternal.h" 514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek#include "clang/ASTMatchers/ASTMatchersMacros.h" 524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek#include "llvm/ADT/Twine.h" 53e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper#include "llvm/Support/Regex.h" 54425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer#include <iterator> 554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimeknamespace clang { 574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimeknamespace ast_matchers { 584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Maps string IDs to AST nodes matched by parts of a matcher. 604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// The bound nodes are generated by calling \c bind("id") on the node matchers 6225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// of the nodes we want to access later. 634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// The instances of BoundNodes are created by \c MatchFinder when the user's 654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// callbacks are executed every time a match is found. 664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekclass BoundNodes { 674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekpublic: 6825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek /// \brief Returns the AST node bound to \c ID. 69a78d0d6203a990b88c9c3e4c4f2a277001e8bd46Manuel Klimek /// 7025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek /// Returns NULL if there was no node bound to \c ID or if there is a node but 714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek /// it cannot be converted to the specified type. 72ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek template <typename T> 73a78d0d6203a990b88c9c3e4c4f2a277001e8bd46Manuel Klimek const T *getNodeAs(StringRef ID) const { 74ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek return MyBoundNodes.getNodeAs<T>(ID); 75ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek } 76ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek 77ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek /// \brief Deprecated. Please use \c getNodeAs instead. 784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek /// @{ 794da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek template <typename T> 804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek const T *getDeclAs(StringRef ID) const { 81a78d0d6203a990b88c9c3e4c4f2a277001e8bd46Manuel Klimek return getNodeAs<T>(ID); 824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek template <typename T> 844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek const T *getStmtAs(StringRef ID) const { 85a78d0d6203a990b88c9c3e4c4f2a277001e8bd46Manuel Klimek return getNodeAs<T>(ID); 864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek /// @} 884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 893f0e0402d8cd40b428f975f1a3607dbbd94d2ca6Peter Collingbourne /// \brief Type of mapping from binding identifiers to bound nodes. This type 903f0e0402d8cd40b428f975f1a3607dbbd94d2ca6Peter Collingbourne /// is an associative container with a key type of \c std::string and a value 913f0e0402d8cd40b428f975f1a3607dbbd94d2ca6Peter Collingbourne /// type of \c clang::ast_type_traits::DynTypedNode 923f0e0402d8cd40b428f975f1a3607dbbd94d2ca6Peter Collingbourne typedef internal::BoundNodesMap::IDToNodeMap IDToNodeMap; 933f0e0402d8cd40b428f975f1a3607dbbd94d2ca6Peter Collingbourne 943f0e0402d8cd40b428f975f1a3607dbbd94d2ca6Peter Collingbourne /// \brief Retrieve mapping from binding identifiers to bound nodes. 953f0e0402d8cd40b428f975f1a3607dbbd94d2ca6Peter Collingbourne const IDToNodeMap &getMap() const { 963f0e0402d8cd40b428f975f1a3607dbbd94d2ca6Peter Collingbourne return MyBoundNodes.getMap(); 973f0e0402d8cd40b428f975f1a3607dbbd94d2ca6Peter Collingbourne } 983f0e0402d8cd40b428f975f1a3607dbbd94d2ca6Peter Collingbourne 994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekprivate: 1004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek /// \brief Create BoundNodes from a pre-filled map of bindings. 101ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek BoundNodes(internal::BoundNodesMap &MyBoundNodes) 102ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek : MyBoundNodes(MyBoundNodes) {} 1034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 104ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek internal::BoundNodesMap MyBoundNodes; 1054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 106054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek friend class internal::BoundNodesTreeBuilder; 1074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek}; 1084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 10925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \brief If the provided matcher matches a node, binds the node to \c ID. 1104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 11125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// FIXME: Do we want to support this now that we have bind()? 1124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimektemplate <typename T> 1134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekinternal::Matcher<T> id(const std::string &ID, 1149f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek const internal::BindableMatcher<T> &InnerMatcher) { 1159f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek return InnerMatcher.bind(ID); 1164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 1174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Types of matchers for the top-level classes in the AST class 1194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// hierarchy. 1204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// @{ 121e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jaspertypedef internal::Matcher<Decl> DeclarationMatcher; 122e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jaspertypedef internal::Matcher<Stmt> StatementMatcher; 123ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jaspertypedef internal::Matcher<QualType> TypeMatcher; 124ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jaspertypedef internal::Matcher<TypeLoc> TypeLocMatcher; 125a7564433191601cb8851196b8dde39392c9c05eeDaniel Jaspertypedef internal::Matcher<NestedNameSpecifier> NestedNameSpecifierMatcher; 126a7564433191601cb8851196b8dde39392c9c05eeDaniel Jaspertypedef internal::Matcher<NestedNameSpecifierLoc> NestedNameSpecifierLocMatcher; 1274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// @} 1284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches any node. 1304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 1314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Useful when another matcher requires a child matcher, but there's no 1324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// additional constraint. This will often be used with an explicit conversion 13325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// to an \c internal::Matcher<> type such as \c TypeMatcher. 1344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 13525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Example: \c DeclarationMatcher(anything()) matches all declarations, e.g., 13625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// "int* p" and "void f()" in 1384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int* p; 1394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f(); 14025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 14125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 14225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 143abe922342d67d4ffe05b366a5a2af972185272f8Daniel Jasperinline internal::PolymorphicMatcherWithParam0<internal::TrueMatcher> 144abe922342d67d4ffe05b366a5a2af972185272f8Daniel Jasperanything() { 1454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::PolymorphicMatcherWithParam0<internal::TrueMatcher>(); 1464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 1474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 148715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// \brief Matches declarations. 149715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// 150715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// Examples matches \c X, \c C, and the friend declaration inside \c C; 151715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// \code 152715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// void X(); 153715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// class C { 154715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// friend X; 155715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// }; 156715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// \endcode 15706b247f0ffb69854e32150c80f347a9376d3709bManuel Klimekconst internal::VariadicAllOfMatcher<Decl> decl; 158715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek 1594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a declaration of anything that could have a name. 1604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Example matches \c X, \c S, the anonymous union type, \c i, and \c U; 16225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// typedef int X; 1644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct S { 1654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// union { 1664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int i; 1674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// } U; 1684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 16925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1702dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, NamedDecl> namedDecl; 1714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 172abe922342d67d4ffe05b366a5a2af972185272f8Daniel Jasper/// \brief Matches a declaration of a namespace. 173abe922342d67d4ffe05b366a5a2af972185272f8Daniel Jasper/// 174abe922342d67d4ffe05b366a5a2af972185272f8Daniel Jasper/// Given 175abe922342d67d4ffe05b366a5a2af972185272f8Daniel Jasper/// \code 176abe922342d67d4ffe05b366a5a2af972185272f8Daniel Jasper/// namespace {} 177abe922342d67d4ffe05b366a5a2af972185272f8Daniel Jasper/// namespace test {} 178abe922342d67d4ffe05b366a5a2af972185272f8Daniel Jasper/// \endcode 179abe922342d67d4ffe05b366a5a2af972185272f8Daniel Jasper/// namespaceDecl() 180abe922342d67d4ffe05b366a5a2af972185272f8Daniel Jasper/// matches "namespace {}" and "namespace test {}" 181abe922342d67d4ffe05b366a5a2af972185272f8Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, NamespaceDecl> namespaceDecl; 182abe922342d67d4ffe05b366a5a2af972185272f8Daniel Jasper 1834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches C++ class declarations. 1844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 18525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Example matches \c X, \c Z 18625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X; 1884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// template<class T> class Z {}; 18925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 191e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Decl, 1922dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXRecordDecl> recordDecl; 193e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 1948456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// \brief Matches C++ class template declarations. 1958456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// 19625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Example matches \c Z 19725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1988456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// template<class T> class Z {}; 19925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2008456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenkoconst internal::VariadicDynCastAllOfMatcher< 2018456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko Decl, 2022dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper ClassTemplateDecl> classTemplateDecl; 2038456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko 204e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches C++ class template specializations. 205e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 206e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 20725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 208e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// template<typename T> class A {}; 209e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// template<> class A<double> {}; 210e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A<int> a; 21125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2122dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// classTemplateSpecializationDecl() 213e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches the specializations \c A<int> and \c A<double> 214e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher< 215e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Decl, 2162dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper ClassTemplateSpecializationDecl> classTemplateSpecializationDecl; 217e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 2181a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// \brief Matches declarator declarations (field, variable, function 2191a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// and non-type template parameter declarations). 2201a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// 2211a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// Given 2221a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// \code 2231a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// class X { int y; }; 2241a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// \endcode 2251a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// declaratorDecl() 2261a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// matches \c int y. 2271a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimekconst internal::VariadicDynCastAllOfMatcher<Decl, DeclaratorDecl> 2281a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek declaratorDecl; 2291a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek 2301a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// \brief Matches parameter variable declarations. 2311a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// 2321a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// Given 2331a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// \code 2341a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// void f(int x); 2351a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// \endcode 2361a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// parmVarDecl() 2371a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// matches \c int x. 2381a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimekconst internal::VariadicDynCastAllOfMatcher<Decl, ParmVarDecl> parmVarDecl; 2391a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek 240f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// \brief Matches C++ access specifier declarations. 241f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// 242f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// Given 243f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// \code 244f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// class C { 245f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// public: 246f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// int a; 247f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// }; 248f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// \endcode 249f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// accessSpecDecl() 250f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// matches 'public:' 251f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasperconst internal::VariadicDynCastAllOfMatcher< 252f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper Decl, 253f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper AccessSpecDecl> accessSpecDecl; 254f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper 25506963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// \brief Matches constructor initializers. 25606963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// 25706963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// Examples matches \c i(42). 25806963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// \code 25906963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// class C { 26006963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// C() : i(42) {} 26106963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// int i; 26206963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// }; 26306963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// \endcode 26406963013d1972f1f7a58875bb40976b60522700bManuel Klimekconst internal::VariadicAllOfMatcher<CXXCtorInitializer> ctorInitializer; 26506963013d1972f1f7a58875bb40976b60522700bManuel Klimek 266f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// \brief Matches public C++ declarations. 267f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// 268f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// Given 269f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// \code 270f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// class C { 271f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// public: int a; 272f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// protected: int b; 273f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// private: int c; 274f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// }; 275f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// \endcode 276f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// fieldDecl(isPublic()) 277f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// matches 'int a;' 278f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel JasperAST_MATCHER(Decl, isPublic) { 279f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper return Node.getAccess() == AS_public; 280f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper} 281f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper 282f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// \brief Matches protected C++ declarations. 283f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// 284f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// Given 285f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// \code 286f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// class C { 287f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// public: int a; 288f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// protected: int b; 289f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// private: int c; 290f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// }; 291f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// \endcode 292f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// fieldDecl(isProtected()) 293f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// matches 'int b;' 294f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel JasperAST_MATCHER(Decl, isProtected) { 295f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper return Node.getAccess() == AS_protected; 296f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper} 297f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper 298f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// \brief Matches private C++ declarations. 299f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// 300f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// Given 301f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// \code 302f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// class C { 303f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// public: int a; 304f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// protected: int b; 305f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// private: int c; 306f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// }; 307f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// \endcode 308f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// fieldDecl(isPrivate()) 309f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper/// matches 'int c;' 310f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel JasperAST_MATCHER(Decl, isPrivate) { 311f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper return Node.getAccess() == AS_private; 312f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper} 313f3197e9eb02120522c1f60f88dacc1cfe5b210f0Daniel Jasper 3146bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// \brief Matches a declaration that has been implicitly added 3156bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// by the compiler (eg. implicit default/copy constructors). 3166bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen HinesAST_MATCHER(Decl, isImplicit) { 3176bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return Node.isImplicit(); 3186bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines} 3196bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines 320e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches classTemplateSpecializations that have at least one 32125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// TemplateArgument matching the given InnerMatcher. 322e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 323e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 32425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 325e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// template<typename T> class A {}; 326e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// template<> class A<double> {}; 327e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A<int> a; 32825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 3292dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// classTemplateSpecializationDecl(hasAnyTemplateArgument( 330e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// refersToType(asString("int")))) 331e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches the specialization \c A<int> 332651f13cea278ec967336033dd032faef0e9fc2ecStephen HinesAST_POLYMORPHIC_MATCHER_P( 333651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines hasAnyTemplateArgument, 334651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines AST_POLYMORPHIC_SUPPORTED_TYPES_2(ClassTemplateSpecializationDecl, 335651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines TemplateSpecializationType), 336651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines internal::Matcher<TemplateArgument>, InnerMatcher) { 337651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines llvm::ArrayRef<TemplateArgument> List = 338651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines internal::getTemplateSpecializationArgs(Node); 339054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek return matchesFirstInRange(InnerMatcher, List.begin(), List.end(), Finder, 340054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek Builder); 341e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 342e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 343089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// \brief Matches expressions that match InnerMatcher after any implicit casts 344089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// are stripped off. 345089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// 346089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// Parentheses and explicit casts are not discarded. 347089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// Given 34825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 349089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int arr[5]; 350089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int a = 0; 351089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// char b = 0; 352089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// const int c = a; 353089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int *d = arr; 354089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// long e = (long) 0l; 35525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 356089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// The matchers 35725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 3582dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(ignoringImpCasts(integerLiteral()))) 3592dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(ignoringImpCasts(declRefExpr()))) 36025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 361089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// would match the declarations for a, b, c, and d, but not e. 36225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// While 36325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 3642dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(integerLiteral())) 3652dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(declRefExpr())) 36625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 367089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// only match the declarations for b, c, and d. 368089e5b3bf2e57da0173b170ad501867b43395385Sam PanzerAST_MATCHER_P(Expr, ignoringImpCasts, 369089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer internal::Matcher<Expr>, InnerMatcher) { 370089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer return InnerMatcher.matches(*Node.IgnoreImpCasts(), Finder, Builder); 371089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer} 372089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer 373089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// \brief Matches expressions that match InnerMatcher after parentheses and 374089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// casts are stripped off. 375089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// 376089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// Implicit and non-C Style casts are also discarded. 377089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// Given 37825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 379089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int a = 0; 380089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// char b = (0); 381089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// void* c = reinterpret_cast<char*>(0); 382089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// char d = char(0); 38325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 384089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// The matcher 3852dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(ignoringParenCasts(integerLiteral()))) 386089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// would match the declarations for a, b, c, and d. 387089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// while 3882dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(integerLiteral())) 389089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// only match the declaration for a. 390089e5b3bf2e57da0173b170ad501867b43395385Sam PanzerAST_MATCHER_P(Expr, ignoringParenCasts, internal::Matcher<Expr>, InnerMatcher) { 391089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer return InnerMatcher.matches(*Node.IgnoreParenCasts(), Finder, Builder); 392089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer} 393089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer 394089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// \brief Matches expressions that match InnerMatcher after implicit casts and 395089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// parentheses are stripped off. 396089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// 397089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// Explicit casts are not discarded. 398089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// Given 39925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 400089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int arr[5]; 401089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int a = 0; 402089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// char b = (0); 403089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// const int c = a; 404089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int *d = (arr); 405089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// long e = ((long) 0l); 40625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 407089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// The matchers 4082dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(ignoringParenImpCasts(integerLiteral()))) 4092dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(ignoringParenImpCasts(declRefExpr()))) 410089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// would match the declarations for a, b, c, and d, but not e. 411089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// while 4122dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(integerLiteral())) 4132dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(declRefExpr())) 414089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// would only match the declaration for a. 415089e5b3bf2e57da0173b170ad501867b43395385Sam PanzerAST_MATCHER_P(Expr, ignoringParenImpCasts, 416089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer internal::Matcher<Expr>, InnerMatcher) { 417089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer return InnerMatcher.matches(*Node.IgnoreParenImpCasts(), Finder, Builder); 418089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer} 419089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer 420e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches classTemplateSpecializations where the n'th TemplateArgument 42125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// matches the given InnerMatcher. 422e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 423e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 42425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 425e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// template<typename T, typename U> class A {}; 426e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A<bool, int> b; 427e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A<int, bool> c; 42825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 4292dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// classTemplateSpecializationDecl(hasTemplateArgument( 430e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1, refersToType(asString("int")))) 431e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches the specialization \c A<bool, int> 432651f13cea278ec967336033dd032faef0e9fc2ecStephen HinesAST_POLYMORPHIC_MATCHER_P2( 433651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines hasTemplateArgument, 434651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines AST_POLYMORPHIC_SUPPORTED_TYPES_2(ClassTemplateSpecializationDecl, 435651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines TemplateSpecializationType), 436651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines unsigned, N, internal::Matcher<TemplateArgument>, InnerMatcher) { 437651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines llvm::ArrayRef<TemplateArgument> List = 438651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines internal::getTemplateSpecializationArgs(Node); 439e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper if (List.size() <= N) 440e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return false; 441651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines return InnerMatcher.matches(List[N], Finder, Builder); 442e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 443e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 444e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches a TemplateArgument that refers to a certain type. 445e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 446e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 44725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 448e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// struct X {}; 449e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// template<typename T> struct A {}; 450e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A<X> a; 45125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 4522dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// classTemplateSpecializationDecl(hasAnyTemplateArgument( 453e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// refersToType(class(hasName("X"))))) 454e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches the specialization \c A<X> 455e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(TemplateArgument, refersToType, 45625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<QualType>, InnerMatcher) { 457e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper if (Node.getKind() != TemplateArgument::Type) 458e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return false; 45925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek return InnerMatcher.matches(Node.getAsType(), Finder, Builder); 460e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 461e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 462651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \brief Matches a canonical TemplateArgument that refers to a certain 463651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// declaration. 464e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 465e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 46625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 467e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// template<typename T> struct A {}; 468e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// struct B { B* next; }; 469e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A<&B::next> a; 47025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 4712dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// classTemplateSpecializationDecl(hasAnyTemplateArgument( 4722dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// refersToDeclaration(fieldDecl(hasName("next")))) 4732dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// matches the specialization \c A<&B::next> with \c fieldDecl(...) matching 474e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \c B::next 475e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(TemplateArgument, refersToDeclaration, 47625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<Decl>, InnerMatcher) { 477aaa8e45b8e392a1f1b7498e2f00c6ed66d41119aDaniel Jasper if (Node.getKind() == TemplateArgument::Declaration) 478aaa8e45b8e392a1f1b7498e2f00c6ed66d41119aDaniel Jasper return InnerMatcher.matches(*Node.getAsDecl(), Finder, Builder); 479e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return false; 480e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 4814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 482651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \brief Matches a sugar TemplateArgument that refers to a certain expression. 483651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// 484651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// Given 485651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \code 486651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// template<typename T> struct A {}; 487651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// struct B { B* next; }; 488651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// A<&B::next> a; 489651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \endcode 490651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// templateSpecializationType(hasAnyTemplateArgument( 491651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// isExpr(hasDescendant(declRefExpr(to(fieldDecl(hasName("next")))))))) 492651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// matches the specialization \c A<&B::next> with \c fieldDecl(...) matching 493651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \c B::next 494651f13cea278ec967336033dd032faef0e9fc2ecStephen HinesAST_MATCHER_P(TemplateArgument, isExpr, internal::Matcher<Expr>, InnerMatcher) { 495651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines if (Node.getKind() == TemplateArgument::Expression) 496651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines return InnerMatcher.matches(*Node.getAsExpr(), Finder, Builder); 497651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines return false; 498651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines} 499651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines 5004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches C++ constructor declarations. 5014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 5024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches Foo::Foo() and Foo::Foo(int) 50325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 5044da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Foo { 5054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// public: 5064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo(); 5074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo(int); 5084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int DoSomething(); 5094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 51025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 5114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 512e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Decl, 5132dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXConstructorDecl> constructorDecl; 514e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 515e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches explicit C++ destructor declarations. 516e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 517e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Example matches Foo::~Foo() 51825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 519e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// class Foo { 520e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// public: 521e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// virtual ~Foo(); 522e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// }; 52325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 5242dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher< 5252dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper Decl, 5262dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXDestructorDecl> destructorDecl; 527e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 528e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches enum declarations. 529e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 530e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Example matches X 53125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 532e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// enum X { 533e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A, B, C 534e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// }; 53525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 536e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, EnumDecl> enumDecl; 537e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 538e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches enum constants. 539e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 540e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Example matches A, B, C 54125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 542e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// enum X { 543e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A, B, C 544e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// }; 54525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 546e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher< 547e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Decl, 5482dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper EnumConstantDecl> enumConstantDecl; 5494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 5504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches method declarations. 5514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 5524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches y 55325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 554651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// class X { void y(); }; 55525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 5562dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, CXXMethodDecl> methodDecl; 5574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 5584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches variable declarations. 5594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 5604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Note: this does not match declarations of member variables, which are 5614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// "field" declarations in Clang parlance. 5624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 5634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches a 56425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 5654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int a; 56625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 5672dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, VarDecl> varDecl; 5684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 5694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches field declarations. 5704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 5714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 57225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 5734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X { int m; }; 57425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 5752dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// fieldDecl() 5764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'm'. 5772dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, FieldDecl> fieldDecl; 5784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 5794da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches function declarations. 5804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 5814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches f 58225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 5834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f(); 58425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 5852dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, FunctionDecl> functionDecl; 5864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 5878456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// \brief Matches C++ function template declarations. 5888456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// 5898456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// Example matches f 59025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 5918456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// template<class T> void f(T t) {} 59225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 5938456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenkoconst internal::VariadicDynCastAllOfMatcher< 5948456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko Decl, 5952dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper FunctionTemplateDecl> functionTemplateDecl; 5964da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 597de9ed71c696bee936a21323f61548164de0eda13Enea Zaffanella/// \brief Matches friend declarations. 598de9ed71c696bee936a21323f61548164de0eda13Enea Zaffanella/// 599de9ed71c696bee936a21323f61548164de0eda13Enea Zaffanella/// Given 600de9ed71c696bee936a21323f61548164de0eda13Enea Zaffanella/// \code 601de9ed71c696bee936a21323f61548164de0eda13Enea Zaffanella/// class X { friend void foo(); }; 602de9ed71c696bee936a21323f61548164de0eda13Enea Zaffanella/// \endcode 603de9ed71c696bee936a21323f61548164de0eda13Enea Zaffanella/// friendDecl() 604de9ed71c696bee936a21323f61548164de0eda13Enea Zaffanella/// matches 'friend void foo()'. 605de9ed71c696bee936a21323f61548164de0eda13Enea Zaffanellaconst internal::VariadicDynCastAllOfMatcher<Decl, FriendDecl> friendDecl; 606de9ed71c696bee936a21323f61548164de0eda13Enea Zaffanella 6074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches statements. 6084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 61025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 6114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// { ++a; } 61225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 6132dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// stmt() 6144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches both the compound statement '{ ++a; }' and '++a'. 61506b247f0ffb69854e32150c80f347a9376d3709bManuel Klimekconst internal::VariadicAllOfMatcher<Stmt> stmt; 6164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 6174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches declaration statements. 6184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 62025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 6214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int a; 62225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 6232dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// declStmt() 6244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'int a'. 6254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 626e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 6272dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper DeclStmt> declStmt; 6284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 6294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches member expressions. 6304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 63225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 6334da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { 6344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void x() { this->x(); x(); Y y; y.x(); a; this->b; Y::b; } 6354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int a; static int b; 6364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 63725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 6382dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// memberExpr() 6394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches this->x, x, y.x, a, this->b 6402dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, MemberExpr> memberExpr; 6414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 6424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches call expressions. 6434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6449f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek/// Example matches x.y() and y() 64525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 6464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// X x; 6474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// x.y(); 6489f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek/// y(); 64925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 6502dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CallExpr> callExpr; 651e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 65231f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// \brief Matches lambda expressions. 65331f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// 65431f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// Example matches [&](){return 5;} 65531f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// \code 65631f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// [&](){return 5;} 65731f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// \endcode 65831f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, LambdaExpr> lambdaExpr; 65931f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper 6609f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek/// \brief Matches member call expressions. 6619f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek/// 6629f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek/// Example matches x.y() 66325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 6649f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek/// X x; 6659f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek/// x.y(); 66625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 6672dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher< 6682dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper Stmt, 6692dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXMemberCallExpr> memberCallExpr; 6709f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek 671651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \brief Matches expressions that introduce cleanups to be run at the end 672651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// of the sub-expression's evaluation. 673651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// 674651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// Example matches std::string() 675651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \code 676651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// const std::string str = std::string(); 677651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \endcode 678651f13cea278ec967336033dd032faef0e9fc2ecStephen Hinesconst internal::VariadicDynCastAllOfMatcher<Stmt, ExprWithCleanups> 679651f13cea278ec967336033dd032faef0e9fc2ecStephen HinesexprWithCleanups; 680651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines 681e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches init list expressions. 682e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 683e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 68425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 685e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int a[] = { 1, 2 }; 686e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// struct B { int x, y; }; 687e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// B b = { 5, 6 }; 68825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 689e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// initList() 690e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches "{ 1, 2 }" and "{ 5, 6 }" 691e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, InitListExpr> initListExpr; 692e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 693e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches using declarations. 694e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 695e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 69625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 697e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// namespace X { int x; } 698e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// using X::x; 69925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 700e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// usingDecl() 701e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \code using X::x \endcode 702e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, UsingDecl> usingDecl; 7034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 704d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanella/// \brief Matches unresolved using value declarations. 705d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanella/// 706d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanella/// Given 707d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanella/// \code 708d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanella/// template<typename X> 709d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanella/// class C : private X { 710d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanella/// using X::x; 711d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanella/// }; 712d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanella/// \endcode 713d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanella/// unresolvedUsingValueDecl() 714d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanella/// matches \code using X::x \endcode 715d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanellaconst internal::VariadicDynCastAllOfMatcher< 716d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanella Decl, 717d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanella UnresolvedUsingValueDecl> unresolvedUsingValueDecl; 718d4de59d3e54421ef88316d650e35802ba9c572cfEnea Zaffanella 7194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches constructor call expressions (including implicit ones). 7204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 7214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches string(ptr, n) and ptr within arguments of f 7222dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = constructExpr()) 72325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 7244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f(const string &a, const string &b); 7254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// char *ptr; 7264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int n; 7274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// f(string(ptr, n), ptr); 72825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 7294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 730e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 7312dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXConstructExpr> constructExpr; 7324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 733bd9cbd22b832ce65a085801259cf2d3df77830e4Enea Zaffanella/// \brief Matches unresolved constructor call expressions. 734bd9cbd22b832ce65a085801259cf2d3df77830e4Enea Zaffanella/// 735bd9cbd22b832ce65a085801259cf2d3df77830e4Enea Zaffanella/// Example matches T(t) in return statement of f 736bd9cbd22b832ce65a085801259cf2d3df77830e4Enea Zaffanella/// (matcher = unresolvedConstructExpr()) 737bd9cbd22b832ce65a085801259cf2d3df77830e4Enea Zaffanella/// \code 738bd9cbd22b832ce65a085801259cf2d3df77830e4Enea Zaffanella/// template <typename T> 739bd9cbd22b832ce65a085801259cf2d3df77830e4Enea Zaffanella/// void f(const T& t) { return T(t); } 740bd9cbd22b832ce65a085801259cf2d3df77830e4Enea Zaffanella/// \endcode 741bd9cbd22b832ce65a085801259cf2d3df77830e4Enea Zaffanellaconst internal::VariadicDynCastAllOfMatcher< 742bd9cbd22b832ce65a085801259cf2d3df77830e4Enea Zaffanella Stmt, 743bd9cbd22b832ce65a085801259cf2d3df77830e4Enea Zaffanella CXXUnresolvedConstructExpr> unresolvedConstructExpr; 744bd9cbd22b832ce65a085801259cf2d3df77830e4Enea Zaffanella 74570b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// \brief Matches implicit and explicit this expressions. 74670b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// 74770b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// Example matches the implicit this expression in "return i". 74870b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// (matcher = thisExpr()) 74970b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// \code 75070b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// struct foo { 75170b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// int i; 75270b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// int f() { return i; } 75370b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// }; 75470b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// \endcode 75570b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimekconst internal::VariadicDynCastAllOfMatcher<Stmt, CXXThisExpr> thisExpr; 75670b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek 7574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches nodes where temporaries are created. 7584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 7594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches FunctionTakesString(GetStringByValue()) 7602dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = bindTemporaryExpr()) 76125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 7624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// FunctionTakesString(GetStringByValue()); 7634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// FunctionTakesStringByPointer(GetStringPointer()); 76425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 7654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 766e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 7672dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXBindTemporaryExpr> bindTemporaryExpr; 7684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 769e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// \brief Matches nodes where temporaries are materialized. 770e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// 771e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// Example: Given 772e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// \code 773e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// struct T {void func()}; 774e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// T f(); 775e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// void g(T); 776e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// \endcode 777e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// materializeTemporaryExpr() matches 'f()' in these statements 778e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// \code 779e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// T u(f()); 780e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// g(f()); 781e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// \endcode 782e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// but does not match 783e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// \code 784e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// f(); 785e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// f().func(); 786e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// \endcode 787e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzerconst internal::VariadicDynCastAllOfMatcher< 788e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer Stmt, 789e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer MaterializeTemporaryExpr> materializeTemporaryExpr; 790e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer 7914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches new expressions. 7924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 7934da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 79425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 7954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// new X; 79625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 7972dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// newExpr() 7984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'new X'. 7992dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CXXNewExpr> newExpr; 800e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 801e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches delete expressions. 802e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 803e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 80425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 805e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// delete X; 80625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 8072dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// deleteExpr() 808e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches 'delete X'. 8092dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CXXDeleteExpr> deleteExpr; 810e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 811e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches array subscript expressions. 812e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 813e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 81425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 815e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int i = a[1]; 81625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 817e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// arraySubscriptExpr() 818e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches "a[1]" 819e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher< 820e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 821e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper ArraySubscriptExpr> arraySubscriptExpr; 8224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 8234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the value of a default argument at the call site. 8244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 8254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches the CXXDefaultArgExpr placeholder inserted for the 8264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// default value of the second parameter in the call expression f(42) 8272dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = defaultArgExpr()) 82825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 8294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f(int x, int y = 0); 8304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// f(42); 83125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 8324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 833e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 8342dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXDefaultArgExpr> defaultArgExpr; 8354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 8364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches overloaded operator calls. 8374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 8384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Note that if an operator isn't overloaded, it won't match. Instead, use 8394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// binaryOperator matcher. 8404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Currently it does not match operators such as new delete. 8414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// FIXME: figure out why these do not match? 8424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 8434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches both operator<<((o << b), c) and operator<<(o, b) 8442dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = operatorCallExpr()) 84525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 8464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// ostream &operator<< (ostream &out, int i) { }; 8474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// ostream &o; int b = 1, c = 1; 8484da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// o << b << c; 84925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 8504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 851e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 8522dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXOperatorCallExpr> operatorCallExpr; 8534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 8544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches expressions. 8554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 8564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches x() 85725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 8584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f() { x(); } 85925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 8602dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, Expr> expr; 8614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 8624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches expressions that refer to declarations. 8634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 8644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches x in if (x) 86525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 8664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// bool x; 8674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// if (x) {} 86825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 8692dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, DeclRefExpr> declRefExpr; 8704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 8714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if statements. 8724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 8734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches 'if (x) {}' 87425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 8754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// if (x) {} 87625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 877e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, IfStmt> ifStmt; 8784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 8794da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches for statements. 8804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 8814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches 'for (;;) {}' 88225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 8834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// for (;;) {} 88431f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// int i[] = {1, 2, 3}; for (auto a : i); 88525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 8862dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, ForStmt> forStmt; 8874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 8886a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// \brief Matches the increment statement of a for loop. 8896a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// 8906a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// Example: 8916a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// forStmt(hasIncrement(unaryOperator(hasOperatorName("++")))) 8926a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// matches '++x' in 89325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 8946a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// for (x; x < N; ++x) { } 89525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 8966a12449ec8862211856447d3df4c082a346339f2Daniel JasperAST_MATCHER_P(ForStmt, hasIncrement, internal::Matcher<Stmt>, 8976a12449ec8862211856447d3df4c082a346339f2Daniel Jasper InnerMatcher) { 8986a12449ec8862211856447d3df4c082a346339f2Daniel Jasper const Stmt *const Increment = Node.getInc(); 8996bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (Increment != nullptr && 9006a12449ec8862211856447d3df4c082a346339f2Daniel Jasper InnerMatcher.matches(*Increment, Finder, Builder)); 9016a12449ec8862211856447d3df4c082a346339f2Daniel Jasper} 9026a12449ec8862211856447d3df4c082a346339f2Daniel Jasper 9036a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// \brief Matches the initialization statement of a for loop. 9046a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// 9056a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// Example: 9062dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// forStmt(hasLoopInit(declStmt())) 9076a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// matches 'int x = 0' in 90825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 9096a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// for (int x = 0; x < N; ++x) { } 91025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 9116a12449ec8862211856447d3df4c082a346339f2Daniel JasperAST_MATCHER_P(ForStmt, hasLoopInit, internal::Matcher<Stmt>, 9126a12449ec8862211856447d3df4c082a346339f2Daniel Jasper InnerMatcher) { 9136a12449ec8862211856447d3df4c082a346339f2Daniel Jasper const Stmt *const Init = Node.getInit(); 9146bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (Init != nullptr && InnerMatcher.matches(*Init, Finder, Builder)); 9156a12449ec8862211856447d3df4c082a346339f2Daniel Jasper} 9166a12449ec8862211856447d3df4c082a346339f2Daniel Jasper 917651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \brief Matches range-based for statements. 918651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// 919651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// forRangeStmt() matches 'for (auto a : i)' 920651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \code 921651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// int i[] = {1, 2, 3}; for (auto a : i); 922651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// for(int j = 0; j < 5; ++j); 923651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \endcode 924651f13cea278ec967336033dd032faef0e9fc2ecStephen Hinesconst internal::VariadicDynCastAllOfMatcher<Stmt, CXXForRangeStmt> forRangeStmt; 925651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines 926651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \brief Matches the initialization statement of a for loop. 927651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// 928651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// Example: 929651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// forStmt(hasLoopVariable(anything())) 930651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// matches 'int x' in 931651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \code 932651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// for (int x : a) { } 933651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \endcode 934651f13cea278ec967336033dd032faef0e9fc2ecStephen HinesAST_MATCHER_P(CXXForRangeStmt, hasLoopVariable, internal::Matcher<VarDecl>, 935651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines InnerMatcher) { 936651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines const VarDecl *const Var = Node.getLoopVariable(); 9376bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (Var != nullptr && InnerMatcher.matches(*Var, Finder, Builder)); 9386bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines} 9396bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines 9406bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// \brief Matches the range initialization statement of a for loop. 9416bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// 9426bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// Example: 9436bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// forStmt(hasRangeInit(anything())) 9446bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// matches 'a' in 9456bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// \code 9466bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// for (int x : a) { } 9476bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// \endcode 9486bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen HinesAST_MATCHER_P(CXXForRangeStmt, hasRangeInit, internal::Matcher<Expr>, 9496bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines InnerMatcher) { 9506bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines const Expr *const Init = Node.getRangeInit(); 9516bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (Init != nullptr && InnerMatcher.matches(*Init, Finder, Builder)); 952651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines} 953651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines 9544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches while statements. 9554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 9564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 95725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 9584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// while (true) {} 95925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 9604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// whileStmt() 9614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'while (true) {}'. 9622dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, WhileStmt> whileStmt; 9634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 9644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches do statements. 9654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 9664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 96725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 9684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// do {} while (true); 96925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 9704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// doStmt() 9714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'do {} while(true)' 972e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, DoStmt> doStmt; 9734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 974b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches break statements. 975b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 976b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// Given 977b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 978b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// while (true) { break; } 979b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 980b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// breakStmt() 981b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'break' 982b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, BreakStmt> breakStmt; 983b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 984b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches continue statements. 985b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 986b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// Given 987b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 988b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// while (true) { continue; } 989b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 990b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// continueStmt() 991b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'continue' 992b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, ContinueStmt> continueStmt; 993b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 994b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches return statements. 995b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 996b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// Given 997b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 998b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// return 1; 999b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 1000b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// returnStmt() 1001b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'return 1' 1002b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, ReturnStmt> returnStmt; 1003b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 1004b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches goto statements. 1005b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 1006b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// Given 1007b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 1008b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// goto FOO; 1009b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// FOO: bar(); 1010b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 1011b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// gotoStmt() 1012b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'goto FOO' 1013b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, GotoStmt> gotoStmt; 1014b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 1015b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches label statements. 1016b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 1017b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// Given 1018b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 1019b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// goto FOO; 1020b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// FOO: bar(); 1021b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 1022b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// labelStmt() 1023b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'FOO:' 1024b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, LabelStmt> labelStmt; 1025b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 1026b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches switch statements. 1027b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 1028b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// Given 1029b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 1030b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// switch(a) { case 42: break; default: break; } 1031b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 1032b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// switchStmt() 1033b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'switch(a)'. 1034b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, SwitchStmt> switchStmt; 1035b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 10364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches case and default statements inside switch statements. 10374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 10384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 103925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 10404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// switch(a) { case 42: break; default: break; } 104125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 10424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// switchCase() 10434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'case 42: break;' and 'default: break;'. 10442dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, SwitchCase> switchCase; 10454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1046acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// \brief Matches case statements inside switch statements. 1047acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// 1048acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// Given 1049acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// \code 1050acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// switch(a) { case 42: break; default: break; } 1051acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// \endcode 1052acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// caseStmt() 1053acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// matches 'case 42: break;'. 1054acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourneconst internal::VariadicDynCastAllOfMatcher<Stmt, CaseStmt> caseStmt; 1055acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne 1056acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// \brief Matches default statements inside switch statements. 1057acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// 1058acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// Given 1059acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// \code 1060acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// switch(a) { case 42: break; default: break; } 1061acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// \endcode 1062acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// defaultStmt() 1063acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// matches 'default: break;'. 1064acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourneconst internal::VariadicDynCastAllOfMatcher<Stmt, DefaultStmt> defaultStmt; 1065acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne 10664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches compound statements. 10674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 10684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches '{}' and '{{}}'in 'for (;;) {{}}' 106925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 10704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// for (;;) {{}} 107125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 10722dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CompoundStmt> compoundStmt; 10734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1074b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches catch statements. 1075b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 1076b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 1077b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// try {} catch(int i) {} 1078b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 1079b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// catchStmt() 1080b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'catch(int i)' 1081b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CXXCatchStmt> catchStmt; 1082b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 1083b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches try statements. 1084b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 1085b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 1086b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// try {} catch(int i) {} 1087b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 1088b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// tryStmt() 1089b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'try {}' 1090b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CXXTryStmt> tryStmt; 1091b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 1092b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches throw expressions. 1093b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 1094b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 1095b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// try { throw 5; } catch(int i) {} 1096b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 1097b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// throwExpr() 1098b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'throw 5' 1099b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CXXThrowExpr> throwExpr; 1100b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 1101b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches null statements. 1102b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 1103b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 1104b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// foo();; 1105b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 1106b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// nullStmt() 1107b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches the second ';' 1108b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, NullStmt> nullStmt; 1109b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 1110b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches asm statements. 1111b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 1112b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 1113b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// int i = 100; 1114b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// __asm("mov al, 2"); 1115b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 1116b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// asmStmt() 1117b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches '__asm("mov al, 2")' 1118b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, AsmStmt> asmStmt; 1119b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 11204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches bool literals. 11214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 11224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches true 112325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 11244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// true 112525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 11264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 11273680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 1128e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper CXXBoolLiteralExpr> boolLiteral; 11294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 11304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches string literals (also matches wide string literals). 11314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 11324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches "abcd", L"abcd" 113325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 11344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// char *s = "abcd"; wchar_t *ws = L"abcd" 113525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 11364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 11373680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 1138e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper StringLiteral> stringLiteral; 11394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 11404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches character literals (also matches wchar_t). 11414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 11424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Not matching Hex-encoded chars (e.g. 0x1234, which is a IntegerLiteral), 11434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// though. 11444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 11454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches 'a', L'a' 114625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 11474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// char ch = 'a'; wchar_t chw = L'a'; 114825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 11494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 11503680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 1151e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper CharacterLiteral> characterLiteral; 11524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1153c5ae717c2b774bfce6bce4bb51072f664b2d54aaDaniel Jasper/// \brief Matches integer literals of all sizes / encodings, e.g. 1154c5ae717c2b774bfce6bce4bb51072f664b2d54aaDaniel Jasper/// 1, 1L, 0x1 and 1U. 11554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 1156c5ae717c2b774bfce6bce4bb51072f664b2d54aaDaniel Jasper/// Does not match character-encoded integers such as L'a'. 11574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 11583680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 1159e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper IntegerLiteral> integerLiteral; 11604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1161c5ae717c2b774bfce6bce4bb51072f664b2d54aaDaniel Jasper/// \brief Matches float literals of all sizes / encodings, e.g. 1162c5ae717c2b774bfce6bce4bb51072f664b2d54aaDaniel Jasper/// 1.0, 1.0f, 1.0L and 1e10. 1163c5ae717c2b774bfce6bce4bb51072f664b2d54aaDaniel Jasper/// 1164c5ae717c2b774bfce6bce4bb51072f664b2d54aaDaniel Jasper/// Does not match implicit conversions such as 1165c5ae717c2b774bfce6bce4bb51072f664b2d54aaDaniel Jasper/// \code 1166c5ae717c2b774bfce6bce4bb51072f664b2d54aaDaniel Jasper/// float a = 10; 1167c5ae717c2b774bfce6bce4bb51072f664b2d54aaDaniel Jasper/// \endcode 1168c5ae717c2b774bfce6bce4bb51072f664b2d54aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher< 1169c5ae717c2b774bfce6bce4bb51072f664b2d54aaDaniel Jasper Stmt, 1170c5ae717c2b774bfce6bce4bb51072f664b2d54aaDaniel Jasper FloatingLiteral> floatLiteral; 1171c5ae717c2b774bfce6bce4bb51072f664b2d54aaDaniel Jasper 117231f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// \brief Matches user defined literal operator call. 117331f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// 117431f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// Example match: "foo"_suffix 117531f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasperconst internal::VariadicDynCastAllOfMatcher< 117631f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper Stmt, 117731f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper UserDefinedLiteral> userDefinedLiteral; 117831f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper 1179afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith/// \brief Matches compound (i.e. non-scalar) literals 1180afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith/// 1181afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith/// Example match: {1}, (1, 2) 1182afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith/// \code 1183afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith/// int array[4] = {1}; vector int myvec = (vector int)(1, 2); 1184afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith/// \endcode 1185afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smithconst internal::VariadicDynCastAllOfMatcher< 1186afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith Stmt, 1187afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith CompoundLiteralExpr> compoundLiteralExpr; 1188afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith 118931f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// \brief Matches nullptr literal. 119031f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasperconst internal::VariadicDynCastAllOfMatcher< 119131f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper Stmt, 119231f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper CXXNullPtrLiteralExpr> nullPtrLiteralExpr; 119331f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper 11944da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches binary operator expressions. 11954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 11964da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches a || b 119725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 11984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// !(a || b) 119925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 12004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 1201e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 1202e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper BinaryOperator> binaryOperator; 12034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 12044da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches unary operator expressions. 12054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 12064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches !a 120725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 12084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// !a || b 120925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 12104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 1211e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 1212e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper UnaryOperator> unaryOperator; 12134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 12144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches conditional operator expressions. 12154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 12164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches a ? b : c 121725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 12184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// (a ? b : c) + 42 121925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 12204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 1221e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 1222e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper ConditionalOperator> conditionalOperator; 12234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 12244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a reinterpret_cast expression. 12254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 12264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Either the source expression or the destination type can be matched 12274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// using has(), but hasDestinationType() is more specific and can be 12284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// more readable. 12294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 12304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches reinterpret_cast<char*>(&p) in 123125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 12324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void* p = reinterpret_cast<char*>(&p); 123325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 12344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 12353680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 12362dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXReinterpretCastExpr> reinterpretCastExpr; 12374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 12384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a C++ static_cast expression. 12394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 12404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \see hasDestinationType 12414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \see reinterpretCast 12424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 12434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example: 12442dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// staticCastExpr() 12454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 12464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// static_cast<long>(8) 12474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// in 124825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 12494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// long eight(static_cast<long>(8)); 125025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 12514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 12523680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 12532dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXStaticCastExpr> staticCastExpr; 12544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 12554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a dynamic_cast expression. 12564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 12574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example: 12582dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// dynamicCastExpr() 12594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 12604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// dynamic_cast<D*>(&b); 12614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// in 126225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 12634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct B { virtual ~B() {} }; struct D : B {}; 12644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// B b; 12654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// D* p = dynamic_cast<D*>(&b); 126625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 12674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 12683680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 12692dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXDynamicCastExpr> dynamicCastExpr; 12704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 12714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a const_cast expression. 12724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 12734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example: Matches const_cast<int*>(&r) in 127425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 12754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int n = 42; 127625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// const int &r(n); 12774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int* p = const_cast<int*>(&r); 127825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 12794da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 12803680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 12812dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXConstCastExpr> constCastExpr; 12824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1283e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper/// \brief Matches a C-style cast expression. 1284e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper/// 1285e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper/// Example: Matches (int*) 2.2f in 1286e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper/// \code 1287e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper/// int i = (int) 2.2f; 1288e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper/// \endcode 1289e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasperconst internal::VariadicDynCastAllOfMatcher< 1290e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper Stmt, 1291e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper CStyleCastExpr> cStyleCastExpr; 1292e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper 12934da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches explicit cast expressions. 12944da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 12954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Matches any cast expression written in user code, whether it be a 12964da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// C-style cast, a functional-style cast, or a keyword cast. 12974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 12984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Does not match implicit conversions. 12994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 13004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Note: the name "explicitCast" is chosen to match Clang's terminology, as 13014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Clang uses the term "cast" to apply to implicit conversions as well as to 13024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// actual cast expressions. 13034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 13044da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \see hasDestinationType. 13054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 13064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example: matches all five of the casts in 130725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 13084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int((int)(reinterpret_cast<int>(static_cast<int>(const_cast<int>(42))))) 130925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 13104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// but does not match the implicit conversion in 131125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 13124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// long ell = 42; 131325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 13144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 13153680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 13162dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper ExplicitCastExpr> explicitCastExpr; 13174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 13184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the implicit cast nodes of Clang's AST. 13194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 13204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// This matches many different places, including function call return value 13214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// eliding, as well as any type conversions. 13224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 13233680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 13242dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper ImplicitCastExpr> implicitCastExpr; 13254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1326089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// \brief Matches any cast nodes of Clang's AST. 1327089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// 1328089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// Example: castExpr() matches each of the following: 132925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1330089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// (int) 3; 1331089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// const_cast<Expr *>(SubExpr); 1332089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// char c = 0; 133325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1334089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// but does not match 133525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1336089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int i = (0); 1337089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int k = 0; 133825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 13393680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CastExpr> castExpr; 1340089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer 13414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches functional cast expressions 13424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 13434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example: Matches Foo(bar); 134425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 13454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo f = bar; 13464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo g = (Foo) bar; 13474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo h = Foo(bar); 134825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 13494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 13503680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 13512dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXFunctionalCastExpr> functionalCastExpr; 13524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 13531245a54ca6e9c5b14196461dc3f84b24ea6594b1Enea Zaffanella/// \brief Matches functional cast expressions having N != 1 arguments 13541245a54ca6e9c5b14196461dc3f84b24ea6594b1Enea Zaffanella/// 13551245a54ca6e9c5b14196461dc3f84b24ea6594b1Enea Zaffanella/// Example: Matches Foo(bar, bar) 13561245a54ca6e9c5b14196461dc3f84b24ea6594b1Enea Zaffanella/// \code 13571245a54ca6e9c5b14196461dc3f84b24ea6594b1Enea Zaffanella/// Foo h = Foo(bar, bar); 13581245a54ca6e9c5b14196461dc3f84b24ea6594b1Enea Zaffanella/// \endcode 13591245a54ca6e9c5b14196461dc3f84b24ea6594b1Enea Zaffanellaconst internal::VariadicDynCastAllOfMatcher< 13601245a54ca6e9c5b14196461dc3f84b24ea6594b1Enea Zaffanella Stmt, 13611245a54ca6e9c5b14196461dc3f84b24ea6594b1Enea Zaffanella CXXTemporaryObjectExpr> temporaryObjectExpr; 13621245a54ca6e9c5b14196461dc3f84b24ea6594b1Enea Zaffanella 1363a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// \brief Matches \c QualTypes in the clang AST. 1364a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasperconst internal::VariadicAllOfMatcher<QualType> qualType; 1365a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper 1366a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// \brief Matches \c Types in the clang AST. 136706b247f0ffb69854e32150c80f347a9376d3709bManuel Klimekconst internal::VariadicAllOfMatcher<Type> type; 1368a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper 1369a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// \brief Matches \c TypeLocs in the clang AST. 137006b247f0ffb69854e32150c80f347a9376d3709bManuel Klimekconst internal::VariadicAllOfMatcher<TypeLoc> typeLoc; 1371a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper 13727387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// \brief Matches if any of the given matchers matches. 13737387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// 13747387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// Unlike \c anyOf, \c eachOf will generate a match result for each 13757387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// matching submatcher. 13767387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// 13777387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// For example, in: 13787387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// \code 13797387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// class A { int a; int b; }; 13807387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// \endcode 13817387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// The matcher: 13827387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// \code 13837387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// recordDecl(eachOf(has(fieldDecl(hasName("a")).bind("v")), 13847387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// has(fieldDecl(hasName("b")).bind("v")))) 13857387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// \endcode 13867387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// will generate two results binding "v", the first of which binds 13877387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// the field declaration of \c a, the second the field declaration of 13887387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// \c b. 13897387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// 13907387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// Usable as: Any Matcher 1391651f13cea278ec967336033dd032faef0e9fc2ecStephen Hinesconst internal::VariadicOperatorMatcherFunc<2, UINT_MAX> eachOf = { 1392d36e46350b50907425bba0db1b3ddfb46cc1637fSamuel Benzaquen internal::EachOfVariadicOperator 1393d36e46350b50907425bba0db1b3ddfb46cc1637fSamuel Benzaquen}; 139425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek 139525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \brief Matches if any of the given matchers matches. 139625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 139725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 1398651f13cea278ec967336033dd032faef0e9fc2ecStephen Hinesconst internal::VariadicOperatorMatcherFunc<2, UINT_MAX> anyOf = { 1399d36e46350b50907425bba0db1b3ddfb46cc1637fSamuel Benzaquen internal::AnyOfVariadicOperator 1400d36e46350b50907425bba0db1b3ddfb46cc1637fSamuel Benzaquen}; 140125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek 140225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \brief Matches if all given matchers match. 140325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 140425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 1405651f13cea278ec967336033dd032faef0e9fc2ecStephen Hinesconst internal::VariadicOperatorMatcherFunc<2, UINT_MAX> allOf = { 1406d36e46350b50907425bba0db1b3ddfb46cc1637fSamuel Benzaquen internal::AllOfVariadicOperator 1407d36e46350b50907425bba0db1b3ddfb46cc1637fSamuel Benzaquen}; 14084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1409e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches sizeof (C99), alignof (C++11) and vec_step (OpenCL) 1410e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1411e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 141225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1413e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Foo x = bar; 1414e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int y = sizeof(x) + alignof(x); 141525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1416e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// unaryExprOrTypeTraitExpr() 1417e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \c sizeof(x) and \c alignof(x) 1418e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher< 1419e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 1420e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper UnaryExprOrTypeTraitExpr> unaryExprOrTypeTraitExpr; 1421e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 1422e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches unary expressions that have a specific type of argument. 1423e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1424e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 142525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1426e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int a, c; float b; int s = sizeof(a) + sizeof(b) + alignof(c); 142725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1428e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// unaryExprOrTypeTraitExpr(hasArgumentOfType(asString("int")) 1429e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \c sizeof(a) and \c alignof(c) 1430e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(UnaryExprOrTypeTraitExpr, hasArgumentOfType, 143125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<QualType>, InnerMatcher) { 1432e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const QualType ArgumentType = Node.getTypeOfArgument(); 143325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek return InnerMatcher.matches(ArgumentType, Finder, Builder); 1434e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 1435e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 1436e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches unary expressions of a certain kind. 1437e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1438e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 143925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1440e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int x; 1441e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int s = sizeof(x) + alignof(x) 144225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1443e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// unaryExprOrTypeTraitExpr(ofKind(UETT_SizeOf)) 1444e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \c sizeof(x) 1445e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(UnaryExprOrTypeTraitExpr, ofKind, UnaryExprOrTypeTrait, Kind) { 1446e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return Node.getKind() == Kind; 1447e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 1448e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 1449e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Same as unaryExprOrTypeTraitExpr, but only matching 1450e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// alignof. 1451e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperinline internal::Matcher<Stmt> alignOfExpr( 145225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek const internal::Matcher<UnaryExprOrTypeTraitExpr> &InnerMatcher) { 1453415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek return stmt(unaryExprOrTypeTraitExpr(allOf( 145425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek ofKind(UETT_AlignOf), InnerMatcher))); 1455e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 1456e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 1457e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Same as unaryExprOrTypeTraitExpr, but only matching 1458e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// sizeof. 1459e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperinline internal::Matcher<Stmt> sizeOfExpr( 146025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek const internal::Matcher<UnaryExprOrTypeTraitExpr> &InnerMatcher) { 1461415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek return stmt(unaryExprOrTypeTraitExpr( 1462415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek allOf(ofKind(UETT_SizeOf), InnerMatcher))); 1463e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 1464e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 14654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches NamedDecl nodes that have the specified name. 14664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 14674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Supports specifying enclosing namespaces or classes by prefixing the name 14684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with '<enclosing>::'. 14694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Does not match typedefs of an underlying type with the given name. 14704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 14714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches X (Name == "X") 147225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 14734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X; 147425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 14754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 14764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches X (Name is one of "::a::b::X", "a::b::X", "b::X", "X") 147725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 147825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// namespace a { namespace b { class X; } } 147925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1480e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(NamedDecl, hasName, std::string, Name) { 14814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek assert(!Name.empty()); 14824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek const std::string FullNameString = "::" + Node.getQualifiedNameAsString(); 1483cfa88f893915ceb8ae4ce2f17c46c24a4d67502fDmitri Gribenko const StringRef FullName = FullNameString; 1484cfa88f893915ceb8ae4ce2f17c46c24a4d67502fDmitri Gribenko const StringRef Pattern = Name; 14854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek if (Pattern.startswith("::")) { 14864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return FullName == Pattern; 14874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } else { 14884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return FullName.endswith(("::" + Pattern).str()); 14894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 14904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 14914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 149231bdf071afc18bb9551e4f4254be297333200c4aManuel Klimek/// \brief Matches NamedDecl nodes whose fully qualified names contain 149331bdf071afc18bb9551e4f4254be297333200c4aManuel Klimek/// a substring matched by the given RegExp. 1494e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1495e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Supports specifying enclosing namespaces or classes by 1496e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// prefixing the name with '<enclosing>::'. Does not match typedefs 1497e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// of an underlying type with the given name. 1498e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1499e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Example matches X (regexp == "::X") 150025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1501e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// class X; 150225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1503e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1504e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Example matches X (regexp is one of "::X", "^foo::.*X", among others) 150525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 150625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// namespace foo { namespace bar { class X; } } 150725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1508e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(NamedDecl, matchesName, std::string, RegExp) { 1509e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper assert(!RegExp.empty()); 1510e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper std::string FullNameString = "::" + Node.getQualifiedNameAsString(); 1511e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper llvm::Regex RE(RegExp); 1512e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return RE.match(FullNameString); 1513e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 1514e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 15154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches overloaded operator names. 15164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 15174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Matches overloaded operator names specified in strings without the 15186a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// "operator" prefix: e.g. "<<". 15194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 15206a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// Given: 152125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 15226a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// class A { int operator*(); }; 15236a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// const A &operator<<(const A &a, const A &b); 15246a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// A a; 15256a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// a << a; // <-- This matches 152625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 15276a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// 15286a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// \c operatorCallExpr(hasOverloadedOperatorName("<<"))) matches the specified 15296a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// line and \c recordDecl(hasMethod(hasOverloadedOperatorName("*"))) matches 15306a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// the declaration of \c A. 15316a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// 15326a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// Usable as: Matcher<CXXOperatorCallExpr>, Matcher<CXXMethodDecl> 15336a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vaneinline internal::PolymorphicMatcherWithParam1< 1534ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen internal::HasOverloadedOperatorNameMatcher, StringRef, 1535ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen AST_POLYMORPHIC_SUPPORTED_TYPES_2(CXXOperatorCallExpr, CXXMethodDecl)> 15366a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin VanehasOverloadedOperatorName(const StringRef Name) { 15376a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane return internal::PolymorphicMatcherWithParam1< 1538ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen internal::HasOverloadedOperatorNameMatcher, StringRef, 1539ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen AST_POLYMORPHIC_SUPPORTED_TYPES_2(CXXOperatorCallExpr, CXXMethodDecl)>( 1540ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen Name); 15414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 15424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 15434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches C++ classes that are directly or indirectly derived from 154420b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper/// a class matching \c Base. 15454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 154676dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper/// Note that a class is not considered to be derived from itself. 15474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 154876dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper/// Example matches Y, Z, C (Base == hasName("X")) 154925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 155076dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper/// class X; 15514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y : public X {}; // directly derived 15524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Z : public Y {}; // indirectly derived 15534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// typedef X A; 15544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// typedef A B; 15554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class C : public B {}; // derived from a typedef of X 155625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 15574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 155820b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper/// In the following example, Bar matches isDerivedFrom(hasName("X")): 155925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 15604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Foo; 15614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// typedef Foo X; 15624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Bar : public Foo {}; // derived from a type that X is a typedef of 156325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 156420b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel JasperAST_MATCHER_P(CXXRecordDecl, isDerivedFrom, 156520b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper internal::Matcher<NamedDecl>, Base) { 156620b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper return Finder->classIsDerivedFrom(&Node, Base, Builder); 156720b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper} 156820b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper 156920b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper/// \brief Overloaded method as shortcut for \c isDerivedFrom(hasName(...)). 15700e1896a753845deee5206b28cdbde1640abb9cacSamuel BenzaquenAST_MATCHER_P_OVERLOAD(CXXRecordDecl, isDerivedFrom, StringRef, BaseName, 1) { 157120b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper assert(!BaseName.empty()); 15720e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen return isDerivedFrom(hasName(BaseName)).matches(Node, Finder, Builder); 15734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 15744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 157576dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper/// \brief Similar to \c isDerivedFrom(), but also matches classes that directly 157676dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper/// match \c Base. 15770e1896a753845deee5206b28cdbde1640abb9cacSamuel BenzaquenAST_MATCHER_P_OVERLOAD(CXXRecordDecl, isSameOrDerivedFrom, 15780e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen internal::Matcher<NamedDecl>, Base, 0) { 15790e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen return Matcher<CXXRecordDecl>(anyOf(Base, isDerivedFrom(Base))) 15800e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen .matches(Node, Finder, Builder); 158176dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper} 158276dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper 158363d88728d862f8a69b3291e533d193d1d8513f5aDaniel Jasper/// \brief Overloaded method as shortcut for 158463d88728d862f8a69b3291e533d193d1d8513f5aDaniel Jasper/// \c isSameOrDerivedFrom(hasName(...)). 15850e1896a753845deee5206b28cdbde1640abb9cacSamuel BenzaquenAST_MATCHER_P_OVERLOAD(CXXRecordDecl, isSameOrDerivedFrom, StringRef, BaseName, 15860e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen 1) { 158776dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper assert(!BaseName.empty()); 15880e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen return isSameOrDerivedFrom(hasName(BaseName)).matches(Node, Finder, Builder); 158976dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper} 159076dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper 15916a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// \brief Matches the first method of a class or struct that satisfies \c 15926a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// InnerMatcher. 15936a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// 15946a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// Given: 15956a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// \code 15966a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// class A { void func(); }; 15976a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// class B { void member(); }; 15986a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// \code 15996a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// 16006a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// \c recordDecl(hasMethod(hasName("func"))) matches the declaration of \c A 16016a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// but not \c B. 16026a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin VaneAST_MATCHER_P(CXXRecordDecl, hasMethod, internal::Matcher<CXXMethodDecl>, 16036a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane InnerMatcher) { 1604054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek return matchesFirstInPointerRange(InnerMatcher, Node.method_begin(), 1605054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek Node.method_end(), Finder, Builder); 16066a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane} 16076a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane 16084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches AST nodes that have child AST nodes that match the 16094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// provided matcher. 16104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16112dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches X, Y (matcher = recordDecl(has(recordDecl(hasName("X"))) 161225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 16134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X {}; // Matches X, because X::X is a class of name X inside X. 16144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { class X {}; }; 16154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Z { class Y { class X {}; }; }; // Does not match Z. 161625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 16174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// ChildT must be an AST base type. 161925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 162025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 1621799bf2d371bb1cba04317c216ce1cd707d389c74Eric Christopherconst internal::ArgumentAdaptingMatcherFunc<internal::HasMatcher> 1622799bf2d371bb1cba04317c216ce1cd707d389c74Eric ChristopherLLVM_ATTRIBUTE_UNUSED has = {}; 16234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 16244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches AST nodes that have descendant AST nodes that match the 16254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// provided matcher. 16264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches X, Y, Z 16282dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = recordDecl(hasDescendant(recordDecl(hasName("X"))))) 162925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 16304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X {}; // Matches X, because X::X is a class of name X inside X. 16314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { class X {}; }; 16324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Z { class Y { class X {}; }; }; 163325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 16344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// DescendantT must be an AST base type. 163625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 163725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 1638ee0da9520fe94f701240e9e1c97773ee412be102Samuel Benzaquenconst internal::ArgumentAdaptingMatcherFunc<internal::HasDescendantMatcher> 1639799bf2d371bb1cba04317c216ce1cd707d389c74Eric ChristopherLLVM_ATTRIBUTE_UNUSED hasDescendant = {}; 16404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 16414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches AST nodes that have child AST nodes that match the 16424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// provided matcher. 16434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16442dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches X, Y (matcher = recordDecl(forEach(recordDecl(hasName("X"))) 164525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 16464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X {}; // Matches X, because X::X is a class of name X inside X. 16474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { class X {}; }; 16484da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Z { class Y { class X {}; }; }; // Does not match Z. 164925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 16504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// ChildT must be an AST base type. 16524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// As opposed to 'has', 'forEach' will cause a match for each result that 16544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches instead of only on the first one. 165525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 165625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 1657799bf2d371bb1cba04317c216ce1cd707d389c74Eric Christopherconst internal::ArgumentAdaptingMatcherFunc<internal::ForEachMatcher> 1658799bf2d371bb1cba04317c216ce1cd707d389c74Eric ChristopherLLVM_ATTRIBUTE_UNUSED forEach = {}; 16594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 16604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches AST nodes that have descendant AST nodes that match the 16614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// provided matcher. 16624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches X, A, B, C 16642dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = recordDecl(forEachDescendant(recordDecl(hasName("X"))))) 166525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 16664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X {}; // Matches X, because X::X is a class of name X inside X. 16674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class A { class X {}; }; 16684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class B { class C { class X {}; }; }; 166925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 16704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// DescendantT must be an AST base type. 16724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// As opposed to 'hasDescendant', 'forEachDescendant' will cause a match for 16744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// each result that matches instead of only on the first one. 16754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Note: Recursively combined ForEachDescendant can cause many matches: 16772dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// recordDecl(forEachDescendant(recordDecl(forEachDescendant(recordDecl())))) 16784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// will match 10 times (plus injected class name matches) on: 167925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 16804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class A { class B { class C { class D { class E {}; }; }; }; }; 168125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 168225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 168325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 1684ee0da9520fe94f701240e9e1c97773ee412be102Samuel Benzaquenconst internal::ArgumentAdaptingMatcherFunc<internal::ForEachDescendantMatcher> 1685799bf2d371bb1cba04317c216ce1cd707d389c74Eric ChristopherLLVM_ATTRIBUTE_UNUSED forEachDescendant = {}; 16864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1687152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// \brief Matches if the node or any descendant matches. 1688152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// 1689152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// Generates results for each match. 1690152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// 1691152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// For example, in: 1692152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// \code 1693152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// class A { class B {}; class C {}; }; 1694152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// \endcode 1695152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// The matcher: 1696152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// \code 1697152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// recordDecl(hasName("::A"), findAll(recordDecl(isDefinition()).bind("m"))) 1698152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// \endcode 1699152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// will generate results for \c A, \c B and \c C. 1700152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// 1701152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// Usable as: Any Matcher 1702152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimektemplate <typename T> 1703d36e46350b50907425bba0db1b3ddfb46cc1637fSamuel Benzaqueninternal::Matcher<T> findAll(const internal::Matcher<T> &Matcher) { 1704152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek return eachOf(Matcher, forEachDescendant(Matcher)); 1705152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek} 1706152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek 1707c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// \brief Matches AST nodes that have a parent that matches the provided 1708c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// matcher. 1709c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// 1710c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// Given 1711c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// \code 1712c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// void f() { for (;;) { int x = 42; if (true) { int x = 43; } } } 1713c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// \endcode 1714c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// \c compoundStmt(hasParent(ifStmt())) matches "{ int x = 43; }". 1715c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// 1716c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// Usable as: Any Matcher 1717ee0da9520fe94f701240e9e1c97773ee412be102Samuel Benzaquenconst internal::ArgumentAdaptingMatcherFunc< 1718ee0da9520fe94f701240e9e1c97773ee412be102Samuel Benzaquen internal::HasParentMatcher, internal::TypeList<Decl, Stmt>, 17199e046e1575fb957a8acb76666c67ed509e7ffe96Eric Christopher internal::TypeList<Decl, Stmt> > LLVM_ATTRIBUTE_UNUSED hasParent = {}; 1720c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper 1721579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// \brief Matches AST nodes that have an ancestor that matches the provided 1722579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// matcher. 1723579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// 1724579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// Given 1725579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// \code 1726579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// void f() { if (true) { int x = 42; } } 1727579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// void g() { for (;;) { int x = 43; } } 1728579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// \endcode 1729a1a4c0385a0fd458243d9e357e1eceb137f29abfNick Lewycky/// \c expr(integerLiteral(hasAncestor(ifStmt()))) matches \c 42, but not 43. 1730579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// 1731579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// Usable as: Any Matcher 1732ee0da9520fe94f701240e9e1c97773ee412be102Samuel Benzaquenconst internal::ArgumentAdaptingMatcherFunc< 1733ee0da9520fe94f701240e9e1c97773ee412be102Samuel Benzaquen internal::HasAncestorMatcher, internal::TypeList<Decl, Stmt>, 17349e046e1575fb957a8acb76666c67ed509e7ffe96Eric Christopher internal::TypeList<Decl, Stmt> > LLVM_ATTRIBUTE_UNUSED hasAncestor = {}; 1735579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek 17364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the provided matcher does not match. 17374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 17382dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches Y (matcher = recordDecl(unless(hasName("X")))) 173925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 17404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X {}; 17414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y {}; 174225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 174325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 174425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 1745651f13cea278ec967336033dd032faef0e9fc2ecStephen Hinesconst internal::VariadicOperatorMatcherFunc<1, 1> unless = { 1746651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines internal::NotUnaryOperator 1747651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines}; 17484da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 174903a83238c39e290ed6e2ced7663efa9fa8c19158Manuel Klimek/// \brief Matches a node if the declaration associated with that node 175003a83238c39e290ed6e2ced7663efa9fa8c19158Manuel Klimek/// matches the given matcher. 175103a83238c39e290ed6e2ced7663efa9fa8c19158Manuel Klimek/// 175203a83238c39e290ed6e2ced7663efa9fa8c19158Manuel Klimek/// The associated declaration is: 175303a83238c39e290ed6e2ced7663efa9fa8c19158Manuel Klimek/// - for type nodes, the declaration of the underlying type 175403a83238c39e290ed6e2ced7663efa9fa8c19158Manuel Klimek/// - for CallExpr, the declaration of the callee 175503a83238c39e290ed6e2ced7663efa9fa8c19158Manuel Klimek/// - for MemberExpr, the declaration of the referenced member 175603a83238c39e290ed6e2ced7663efa9fa8c19158Manuel Klimek/// - for CXXConstructExpr, the declaration of the constructor 175703a83238c39e290ed6e2ced7663efa9fa8c19158Manuel Klimek/// 175803a83238c39e290ed6e2ced7663efa9fa8c19158Manuel Klimek/// Also usable as Matcher<T> for any T supporting the getDecl() member 175903a83238c39e290ed6e2ced7663efa9fa8c19158Manuel Klimek/// function. e.g. various subtypes of clang::Type and various expressions. 17606c1dc7870f457803a9b256ed868da82532be820bSamuel Benzaquen/// 17616c1dc7870f457803a9b256ed868da82532be820bSamuel Benzaquen/// Usable as: Matcher<CallExpr>, Matcher<CXXConstructExpr>, 17626c1dc7870f457803a9b256ed868da82532be820bSamuel Benzaquen/// Matcher<DeclRefExpr>, Matcher<EnumType>, Matcher<InjectedClassNameType>, 17636c1dc7870f457803a9b256ed868da82532be820bSamuel Benzaquen/// Matcher<LabelStmt>, Matcher<MemberExpr>, Matcher<QualType>, 17646c1dc7870f457803a9b256ed868da82532be820bSamuel Benzaquen/// Matcher<RecordType>, Matcher<TagType>, 17656c1dc7870f457803a9b256ed868da82532be820bSamuel Benzaquen/// Matcher<TemplateSpecializationType>, Matcher<TemplateTypeParmType>, 17666c1dc7870f457803a9b256ed868da82532be820bSamuel Benzaquen/// Matcher<TypedefType>, Matcher<UnresolvedUsingType> 17676c1dc7870f457803a9b256ed868da82532be820bSamuel Benzaqueninline internal::PolymorphicMatcherWithParam1< 17686c1dc7870f457803a9b256ed868da82532be820bSamuel Benzaquen internal::HasDeclarationMatcher, internal::Matcher<Decl>, 17696c1dc7870f457803a9b256ed868da82532be820bSamuel Benzaquen void(internal::HasDeclarationSupportedTypes)> 17706c1dc7870f457803a9b256ed868da82532be820bSamuel BenzaquenhasDeclaration(const internal::Matcher<Decl> &InnerMatcher) { 17714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::PolymorphicMatcherWithParam1< 17726c1dc7870f457803a9b256ed868da82532be820bSamuel Benzaquen internal::HasDeclarationMatcher, internal::Matcher<Decl>, 17736c1dc7870f457803a9b256ed868da82532be820bSamuel Benzaquen void(internal::HasDeclarationSupportedTypes)>(InnerMatcher); 17744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 17754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 17764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches on the implicit object argument of a member call expression. 17774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 17782dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches y.x() (matcher = callExpr(on(hasType(recordDecl(hasName("Y")))))) 177925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 17804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { public: void x(); }; 17814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void z() { Y y; y.x(); }", 178225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 17834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 17844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// FIXME: Overload to allow directly matching types? 1785e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CXXMemberCallExpr, on, internal::Matcher<Expr>, 17864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 1787f8c12146fa2153a6d97b7c92d27d2ece0cd26e79Dmitri Gribenko const Expr *ExprNode = Node.getImplicitObjectArgument() 1788f8c12146fa2153a6d97b7c92d27d2ece0cd26e79Dmitri Gribenko ->IgnoreParenImpCasts(); 17896bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (ExprNode != nullptr && 17904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*ExprNode, Finder, Builder)); 17914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 17924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 17934da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the call expression's callee expression matches. 17944da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 17954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 179625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 17974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { void x() { this->x(); x(); Y y; y.x(); } }; 17984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f() { f(); } 179925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 18002dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// callExpr(callee(expr())) 18014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches this->x(), x(), y.x(), f() 18024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with callee(...) 18034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matching this->x, x, y.x, f respectively 18044da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 1805e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Note: Callee cannot take the more general internal::Matcher<Expr> 18064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// because this introduces ambiguous overloads with calls to Callee taking a 1807e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// internal::Matcher<Decl>, as the matcher hierarchy is purely 18084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// implemented in terms of implicit casts. 1809e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CallExpr, callee, internal::Matcher<Stmt>, 18104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 1811e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Expr *ExprNode = Node.getCallee(); 18126bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (ExprNode != nullptr && 18134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*ExprNode, Finder, Builder)); 18144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 18154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 18164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the call expression's callee's declaration matches the 18174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// given matcher. 18184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 18192dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches y.x() (matcher = callExpr(callee(methodDecl(hasName("x"))))) 182025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 18214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { public: void x(); }; 18224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void z() { Y y; y.x(); 182325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 18240e1896a753845deee5206b28cdbde1640abb9cacSamuel BenzaquenAST_MATCHER_P_OVERLOAD(CallExpr, callee, internal::Matcher<Decl>, InnerMatcher, 18250e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen 1) { 18260e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen return callExpr(hasDeclaration(InnerMatcher)).matches(Node, Finder, Builder); 18274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 18284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 18294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the expression's or declaration's type matches a type 18304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matcher. 18314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 18322dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches x (matcher = expr(hasType(recordDecl(hasName("X"))))) 18332dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// and z (matcher = varDecl(hasType(recordDecl(hasName("X"))))) 183425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 18354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X {}; 18364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void y(X &x) { x; X z; } 183725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 18380e1896a753845deee5206b28cdbde1640abb9cacSamuel BenzaquenAST_POLYMORPHIC_MATCHER_P_OVERLOAD( 18390e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen hasType, AST_POLYMORPHIC_SUPPORTED_TYPES_2(Expr, ValueDecl), 18400e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen internal::Matcher<QualType>, InnerMatcher, 0) { 18414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return InnerMatcher.matches(Node.getType(), Finder, Builder); 18424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 18434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 18444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Overloaded to match the declaration of the expression's or value 18454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// declaration's type. 18464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 18474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// In case of a value declaration (for example a variable declaration), 18484da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// this resolves one layer of indirection. For example, in the value 18492dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// declaration "X x;", recordDecl(hasName("X")) matches the declaration of X, 18502dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// while varDecl(hasType(recordDecl(hasName("X")))) matches the declaration 18514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// of x." 18524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 18532dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches x (matcher = expr(hasType(recordDecl(hasName("X"))))) 18542dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// and z (matcher = varDecl(hasType(recordDecl(hasName("X"))))) 185525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 18564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X {}; 18574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void y(X &x) { x; X z; } 185825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1859297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// 1860297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// Usable as: Matcher<Expr>, Matcher<ValueDecl> 18610e1896a753845deee5206b28cdbde1640abb9cacSamuel BenzaquenAST_POLYMORPHIC_MATCHER_P_OVERLOAD( 18620e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen hasType, AST_POLYMORPHIC_SUPPORTED_TYPES_2(Expr, ValueDecl), 18630e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen internal::Matcher<Decl>, InnerMatcher, 1) { 18640e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen return qualType(hasDeclaration(InnerMatcher)) 18650e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen .matches(Node.getType(), Finder, Builder); 18664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 18674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 18681a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// \brief Matches if the type location of the declarator decl's type matches 18691a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// the inner matcher. 18701a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// 18711a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// Given 18721a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// \code 18731a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// int x; 18741a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// \endcode 18751a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// declaratorDecl(hasTypeLoc(loc(asString("int")))) 18761a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek/// matches int x 18771a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel KlimekAST_MATCHER_P(DeclaratorDecl, hasTypeLoc, internal::Matcher<TypeLoc>, Inner) { 18781a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek if (!Node.getTypeSourceInfo()) 18791a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek // This happens for example for implicit destructors. 18801a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek return false; 18811a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek return Inner.matches(Node.getTypeSourceInfo()->getTypeLoc(), Finder, Builder); 18821a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek} 18831a68afd5bbecd05a3bb22854954aa4e5448c4470Manuel Klimek 1884e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches if the matched type is represented by the given string. 1885e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1886e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 188725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1888e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// class Y { public: void x(); }; 1889e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// void z() { Y* y; y->x(); } 189025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 18912dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// callExpr(on(hasType(asString("class Y *")))) 1892e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches y->x() 1893e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(QualType, asString, std::string, Name) { 1894e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return Name == Node.getAsString(); 1895e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 1896e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 18974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the matched type is a pointer type and the pointee type 18984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches the specified matcher. 18994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 19004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches y->x() 19012dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = callExpr(on(hasType(pointsTo(recordDecl(hasName("Y"))))))) 190225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 19034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { public: void x(); }; 19044da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void z() { Y *y; y->x(); } 190525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 19064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel KlimekAST_MATCHER_P( 1907e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper QualType, pointsTo, internal::Matcher<QualType>, 19084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 1909e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return (!Node.isNull() && Node->isPointerType() && 19104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(Node->getPointeeType(), Finder, Builder)); 19114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 19124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 19134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Overloaded to match the pointee type's declaration. 19140e1896a753845deee5206b28cdbde1640abb9cacSamuel BenzaquenAST_MATCHER_P_OVERLOAD(QualType, pointsTo, internal::Matcher<Decl>, 19150e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen InnerMatcher, 1) { 19160e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen return pointsTo(qualType(hasDeclaration(InnerMatcher))) 19170e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen .matches(Node, Finder, Builder); 19184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 19194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 19204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the matched type is a reference type and the referenced 19214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// type matches the specified matcher. 19224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 19234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches X &x and const X &y 19242dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = varDecl(hasType(references(recordDecl(hasName("X")))))) 192525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 19264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X { 19274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void a(X b) { 19284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// X &x = b; 19294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// const X &y = b; 19304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 193125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1932e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(QualType, references, internal::Matcher<QualType>, 19334da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 1934e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return (!Node.isNull() && Node->isReferenceType() && 19354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(Node->getPointeeType(), Finder, Builder)); 19364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 19374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 19386a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// \brief Matches QualTypes whose canonical type matches InnerMatcher. 19396a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// 19406a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// Given: 19416a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// \code 19426a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// typedef int &int_ref; 19436a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// int a; 19446a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// int_ref b = a; 19456a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// \code 19466a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// 19476a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// \c varDecl(hasType(qualType(referenceType()))))) will not match the 19486a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// declaration of b but \c 19496a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane/// varDecl(hasType(qualType(hasCanonicalType(referenceType())))))) does. 19506a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin VaneAST_MATCHER_P(QualType, hasCanonicalType, internal::Matcher<QualType>, 19516a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane InnerMatcher) { 195254eeac9cb538e4fc4eecd81f2eda8f6fa727ca76Edwin Vane if (Node.isNull()) 195354eeac9cb538e4fc4eecd81f2eda8f6fa727ca76Edwin Vane return false; 19546a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane return InnerMatcher.matches(Node.getCanonicalType(), Finder, Builder); 19556a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane} 19566a19a97e57c8678adb0505a07c97d7ccadc8fe4eEdwin Vane 19574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Overloaded to match the referenced type's declaration. 19580e1896a753845deee5206b28cdbde1640abb9cacSamuel BenzaquenAST_MATCHER_P_OVERLOAD(QualType, references, internal::Matcher<Decl>, 19590e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen InnerMatcher, 1) { 19600e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen return references(qualType(hasDeclaration(InnerMatcher))) 19610e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen .matches(Node, Finder, Builder); 19624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 19634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1964e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CXXMemberCallExpr, onImplicitObjectArgument, 1965e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 1966f8c12146fa2153a6d97b7c92d27d2ece0cd26e79Dmitri Gribenko const Expr *ExprNode = Node.getImplicitObjectArgument(); 19676bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (ExprNode != nullptr && 19684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*ExprNode, Finder, Builder)); 19694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 19704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 19714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the expression's type either matches the specified 19724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matcher, or is a pointer to a type that matches the InnerMatcher. 19730e1896a753845deee5206b28cdbde1640abb9cacSamuel BenzaquenAST_MATCHER_P_OVERLOAD(CXXMemberCallExpr, thisPointerType, 19740e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen internal::Matcher<QualType>, InnerMatcher, 0) { 19754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return onImplicitObjectArgument( 19760e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen anyOf(hasType(InnerMatcher), hasType(pointsTo(InnerMatcher)))) 19770e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen .matches(Node, Finder, Builder); 19784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 19794da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 19804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Overloaded to match the type's declaration. 19810e1896a753845deee5206b28cdbde1640abb9cacSamuel BenzaquenAST_MATCHER_P_OVERLOAD(CXXMemberCallExpr, thisPointerType, 19820e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen internal::Matcher<Decl>, InnerMatcher, 1) { 19834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return onImplicitObjectArgument( 19840e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen anyOf(hasType(InnerMatcher), hasType(pointsTo(InnerMatcher)))) 19850e1896a753845deee5206b28cdbde1640abb9cacSamuel Benzaquen .matches(Node, Finder, Builder); 19864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 19874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 19884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a DeclRefExpr that refers to a declaration that matches the 19894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// specified matcher. 19904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 19914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches x in if(x) 19922dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = declRefExpr(to(varDecl(hasName("x"))))) 199325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 19944da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// bool x; 19954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// if (x) {} 199625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1997e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(DeclRefExpr, to, internal::Matcher<Decl>, 19984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 1999e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Decl *DeclNode = Node.getDecl(); 20006bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (DeclNode != nullptr && 20014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*DeclNode, Finder, Builder)); 20024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 20034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 2004e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches a \c DeclRefExpr that refers to a declaration through a 2005e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// specific using shadow declaration. 2006e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 2007e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// FIXME: This currently only works for functions. Fix. 2008e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 2009e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 201025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2011e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// namespace a { void f() {} } 2012e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// using a::f; 2013e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// void g() { 2014e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// f(); // Matches this .. 2015e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// a::f(); // .. but not this. 2016e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// } 201725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 20182dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// declRefExpr(throughUsingDeclaration(anything())) 2019e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \c f() 2020e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(DeclRefExpr, throughUsingDecl, 202125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<UsingShadowDecl>, InnerMatcher) { 2022e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const NamedDecl *FoundDecl = Node.getFoundDecl(); 2023cfa88f893915ceb8ae4ce2f17c46c24a4d67502fDmitri Gribenko if (const UsingShadowDecl *UsingDecl = dyn_cast<UsingShadowDecl>(FoundDecl)) 202425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek return InnerMatcher.matches(*UsingDecl, Finder, Builder); 2025e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return false; 2026e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 2027e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 2028425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// \brief Matches the Decl of a DeclStmt which has a single declaration. 2029425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// 2030425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// Given 203125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2032425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int a, b; 2033425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int c; 203425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 20352dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// declStmt(hasSingleDecl(anything())) 2036425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// matches 'int c;' but not 'int a, b;'. 2037425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam PanzerAST_MATCHER_P(DeclStmt, hasSingleDecl, internal::Matcher<Decl>, InnerMatcher) { 2038425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer if (Node.isSingleDecl()) { 2039425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer const Decl *FoundDecl = Node.getSingleDecl(); 2040425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer return InnerMatcher.matches(*FoundDecl, Finder, Builder); 2041425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer } 2042425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer return false; 2043425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer} 2044425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer 20454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a variable declaration that has an initializer expression 20464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// that matches the given matcher. 20474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 20482dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches x (matcher = varDecl(hasInitializer(callExpr()))) 204925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 20504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// bool y() { return true; } 20514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// bool x = y(); 205225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 20534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel KlimekAST_MATCHER_P( 2054e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper VarDecl, hasInitializer, internal::Matcher<Expr>, 20554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 2056e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Expr *Initializer = Node.getAnyInitializer(); 20576bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (Initializer != nullptr && 20584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*Initializer, Finder, Builder)); 20594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 20604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 20614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Checks that a call expression or a constructor call expression has 20624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// a specific number of arguments (including absent default arguments). 20634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 20642dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches f(0, 0) (matcher = callExpr(argumentCountIs(2))) 206525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 20664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f(int x, int y); 20674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// f(0, 0); 206825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2069ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel BenzaquenAST_POLYMORPHIC_MATCHER_P(argumentCountIs, AST_POLYMORPHIC_SUPPORTED_TYPES_2( 2070ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen CallExpr, CXXConstructExpr), 2071ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen unsigned, N) { 20724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return Node.getNumArgs() == N; 20734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 20744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 20754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the n'th argument of a call expression or a constructor 20764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// call expression. 20774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 20784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches y in x(y) 20792dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = callExpr(hasArgument(0, declRefExpr()))) 208025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 20814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void x(int) { int y; x(y); } 208225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 20834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel KlimekAST_POLYMORPHIC_MATCHER_P2( 2084ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen hasArgument, 2085ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen AST_POLYMORPHIC_SUPPORTED_TYPES_2(CallExpr, CXXConstructExpr), 2086ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen unsigned, N, internal::Matcher<Expr>, InnerMatcher) { 20874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (N < Node.getNumArgs() && 20884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches( 20894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek *Node.getArg(N)->IgnoreParenImpCasts(), Finder, Builder)); 20904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 20914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 2092425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// \brief Matches declaration statements that contain a specific number of 2093425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// declarations. 2094425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// 2095425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// Example: Given 209625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2097425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int a, b; 2098425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int c; 2099425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int d = 2, e; 210025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2101425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// declCountIs(2) 2102425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// matches 'int a, b;' and 'int d = 2, e;', but not 'int c;'. 2103425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam PanzerAST_MATCHER_P(DeclStmt, declCountIs, unsigned, N) { 2104217c484522926f9fc664ec3bfaf3cffe456244b0Benjamin Kramer return std::distance(Node.decl_begin(), Node.decl_end()) == (ptrdiff_t)N; 2105425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer} 2106425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer 2107425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// \brief Matches the n'th declaration of a declaration statement. 2108425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// 2109425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// Note that this does not work for global declarations because the AST 2110425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// breaks up multiple-declaration DeclStmt's into multiple single-declaration 2111425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// DeclStmt's. 2112425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// Example: Given non-global declarations 211325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2114425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int a, b = 0; 2115425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int c; 2116425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int d = 2, e; 211725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 21182dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// declStmt(containsDeclaration( 21192dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// 0, varDecl(hasInitializer(anything())))) 2120425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// matches only 'int d = 2, e;', and 21212dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// declStmt(containsDeclaration(1, varDecl())) 212225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2123425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// matches 'int a, b = 0' as well as 'int d = 2, e;' 2124425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// but 'int c;' is not matched. 212525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2126425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam PanzerAST_MATCHER_P2(DeclStmt, containsDeclaration, unsigned, N, 2127425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer internal::Matcher<Decl>, InnerMatcher) { 2128425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer const unsigned NumDecls = std::distance(Node.decl_begin(), Node.decl_end()); 2129425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer if (N >= NumDecls) 2130425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer return false; 2131425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer DeclStmt::const_decl_iterator Iterator = Node.decl_begin(); 2132425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer std::advance(Iterator, N); 2133425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer return InnerMatcher.matches(**Iterator, Finder, Builder); 2134425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer} 2135425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer 21364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a constructor initializer. 21374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 21384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 213925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 21404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct Foo { 21414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo() : foo_(1) { } 21424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int foo_; 21434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 214425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 21452dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// recordDecl(has(constructorDecl(hasAnyConstructorInitializer(anything())))) 2146e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// record matches Foo, hasAnyConstructorInitializer matches foo_(1) 2147e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CXXConstructorDecl, hasAnyConstructorInitializer, 2148e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<CXXCtorInitializer>, InnerMatcher) { 2149054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek return matchesFirstInPointerRange(InnerMatcher, Node.init_begin(), 2150054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek Node.init_end(), Finder, Builder); 21514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 21524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 21534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the field declaration of a constructor initializer. 21544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 21554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 215625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 21574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct Foo { 21584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo() : foo_(1) { } 21594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int foo_; 21604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 216125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 21622dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// recordDecl(has(constructorDecl(hasAnyConstructorInitializer( 21634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// forField(hasName("foo_")))))) 21644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches Foo 21654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with forField matching foo_ 2166e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CXXCtorInitializer, forField, 2167e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<FieldDecl>, InnerMatcher) { 2168e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const FieldDecl *NodeAsDecl = Node.getMember(); 21696bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (NodeAsDecl != nullptr && 21704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*NodeAsDecl, Finder, Builder)); 21714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 21724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 21734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the initializer expression of a constructor initializer. 21744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 21754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 217625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 21774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct Foo { 21784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo() : foo_(1) { } 21794da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int foo_; 21804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 218125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 21822dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// recordDecl(has(constructorDecl(hasAnyConstructorInitializer( 21834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// withInitializer(integerLiteral(equals(1))))))) 21844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches Foo 21854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with withInitializer matching (1) 2186e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CXXCtorInitializer, withInitializer, 2187e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 2188e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Expr* NodeAsExpr = Node.getInit(); 21896bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (NodeAsExpr != nullptr && 21904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*NodeAsExpr, Finder, Builder)); 21914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 21924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 2193e575359c34a9248c55ec0c03a8fc945f1ee4cb01Benjamin Kramer/// \brief Matches a constructor initializer if it is explicitly written in 21944da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// code (as opposed to implicitly added by the compiler). 21954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 21964da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 219725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 21984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct Foo { 21994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo() { } 22004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo(int) : foo_("A") { } 22014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// string foo_; 22024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 220325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 22042dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// constructorDecl(hasAnyConstructorInitializer(isWritten())) 22054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// will match Foo(int), but not Foo() 2206e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER(CXXCtorInitializer, isWritten) { 22074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return Node.isWritten(); 22084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 22094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 22104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches any argument of a call expression or a constructor call 22114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// expression. 22124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 22134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 221425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 22154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void x(int, int, int) { int y; x(1, y, 42); } 221625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 22172dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// callExpr(hasAnyArgument(declRefExpr())) 22184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches x(1, y, 42) 22194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with hasAnyArgument(...) 22204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matching y 2221054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek/// 2222054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek/// FIXME: Currently this will ignore parentheses and implicit casts on 2223054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek/// the argument before applying the inner matcher. We'll want to remove 2224054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek/// this to allow for greater control by the user once \c ignoreImplicit() 2225054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek/// has been implemented. 2226ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel BenzaquenAST_POLYMORPHIC_MATCHER_P(hasAnyArgument, AST_POLYMORPHIC_SUPPORTED_TYPES_2( 2227ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen CallExpr, CXXConstructExpr), 2228ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen internal::Matcher<Expr>, InnerMatcher) { 22294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek for (unsigned I = 0; I < Node.getNumArgs(); ++I) { 2230054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek BoundNodesTreeBuilder Result(*Builder); 2231054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek if (InnerMatcher.matches(*Node.getArg(I)->IgnoreParenImpCasts(), Finder, 2232054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek &Result)) { 2233054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek *Builder = Result; 22344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return true; 22354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 22364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 22374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return false; 22384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 22394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 2240651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \brief Matches a constructor call expression which uses list initialization. 2241651f13cea278ec967336033dd032faef0e9fc2ecStephen HinesAST_MATCHER(CXXConstructExpr, isListInitialization) { 2242651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines return Node.isListInitialization(); 2243651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines} 2244651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines 22454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the n'th parameter of a function declaration. 22464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 22474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 224825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 22494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X { void f(int x) {} }; 225025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 22512dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// methodDecl(hasParameter(0, hasType(varDecl()))) 22524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches f(int x) {} 22534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with hasParameter(...) 22544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matching int x 2255e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P2(FunctionDecl, hasParameter, 2256e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper unsigned, N, internal::Matcher<ParmVarDecl>, 22574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 22584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (N < Node.getNumParams() && 22594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches( 22604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek *Node.getParamDecl(N), Finder, Builder)); 22614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 22624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 22634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches any parameter of a function declaration. 22644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 22654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Does not match the 'this' parameter of a method. 22664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 22674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 226825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 22694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X { void f(int x, int y, int z) {} }; 227025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 22712dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// methodDecl(hasAnyParameter(hasName("y"))) 22724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches f(int x, int y, int z) {} 22734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with hasAnyParameter(...) 22744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matching int y 2275e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(FunctionDecl, hasAnyParameter, 2276e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<ParmVarDecl>, InnerMatcher) { 2277054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek return matchesFirstInPointerRange(InnerMatcher, Node.param_begin(), 2278054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek Node.param_end(), Finder, Builder); 22794da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 22804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 228136e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// \brief Matches \c FunctionDecls that have a specific parameter count. 228236e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// 228336e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// Given 228436e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// \code 228536e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// void f(int i) {} 228636e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// void g(int i, int j) {} 228736e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// \endcode 228836e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// functionDecl(parameterCountIs(2)) 228936e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// matches g(int i, int j) {} 229036e29d6732814e958aea4b2f403cec63d7ed3116Daniel JasperAST_MATCHER_P(FunctionDecl, parameterCountIs, unsigned, N) { 229136e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper return Node.getNumParams() == N; 229236e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper} 229336e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper 2294e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches the return type of a function declaration. 2295e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 2296e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given: 229725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2298e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// class X { int f() { return 1; } }; 229925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 23002dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// methodDecl(returns(asString("int"))) 2301e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches int f() { return 1; } 230225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel KlimekAST_MATCHER_P(FunctionDecl, returns, 230325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<QualType>, InnerMatcher) { 2304651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines return InnerMatcher.matches(Node.getReturnType(), Finder, Builder); 2305e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 2306e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 23078cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper/// \brief Matches extern "C" function declarations. 23088cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper/// 23098cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper/// Given: 231025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 23118cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper/// extern "C" void f() {} 23128cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper/// extern "C" { void g() {} } 23138cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper/// void h() {} 231425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 23152dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// functionDecl(isExternC()) 23168cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper/// matches the declaration of f and g, but not the declaration h 23178cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel JasperAST_MATCHER(FunctionDecl, isExternC) { 23188cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper return Node.isExternC(); 23198cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper} 23208cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper 23216a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// \brief Matches the condition expression of an if statement, for loop, 23226a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// or conditional operator. 23234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 23244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches true (matcher = hasCondition(boolLiteral(equals(true)))) 232525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 23264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// if (true) {} 232725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2328ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel BenzaquenAST_POLYMORPHIC_MATCHER_P( 2329ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen hasCondition, AST_POLYMORPHIC_SUPPORTED_TYPES_5( 2330ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen IfStmt, ForStmt, WhileStmt, DoStmt, ConditionalOperator), 2331ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen internal::Matcher<Expr>, InnerMatcher) { 2332e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Expr *const Condition = Node.getCond(); 23336bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (Condition != nullptr && 23344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*Condition, Finder, Builder)); 23354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 23364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 23376bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// \brief Matches the then-statement of an if statement. 23386bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// 23396bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// Examples matches the if statement 23406bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// (matcher = ifStmt(hasThen(boolLiteral(equals(true))))) 23416bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// \code 23426bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// if (false) true; else false; 23436bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// \endcode 23446bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen HinesAST_MATCHER_P(IfStmt, hasThen, internal::Matcher<Stmt>, InnerMatcher) { 23456bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines const Stmt *const Then = Node.getThen(); 23466bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (Then != nullptr && InnerMatcher.matches(*Then, Finder, Builder)); 23476bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines} 23486bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines 23496bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// \brief Matches the else-statement of an if statement. 23506bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// 23516bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// Examples matches the if statement 23526bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// (matcher = ifStmt(hasElse(boolLiteral(equals(true))))) 23536bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// \code 23546bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// if (false) false; else true; 23556bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines/// \endcode 23566bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen HinesAST_MATCHER_P(IfStmt, hasElse, internal::Matcher<Stmt>, InnerMatcher) { 23576bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines const Stmt *const Else = Node.getElse(); 23586bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (Else != nullptr && InnerMatcher.matches(*Else, Finder, Builder)); 23596bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines} 23606bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines 2361cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// \brief Matches if a node equals a previously bound node. 2362cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// 2363cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// Matches a node if it equals the node previously bound to \p ID. 2364cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// 2365cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// Given 2366cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// \code 2367cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// class X { int a; int b; }; 2368cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// \endcode 2369cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// recordDecl( 2370cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// has(fieldDecl(hasName("a"), hasType(type().bind("t")))), 2371cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// has(fieldDecl(hasName("b"), hasType(type(equalsBoundNode("t")))))) 2372cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// matches the class \c X, as \c a and \c b have the same type. 2373cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// 2374cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// Note that when multiple matches are involved via \c forEach* matchers, 2375cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// \c equalsBoundNodes acts as a filter. 2376cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// For example: 2377cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// compoundStmt( 2378cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// forEachDescendant(varDecl().bind("d")), 2379cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// forEachDescendant(declRefExpr(to(decl(equalsBoundNode("d")))))) 2380cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// will trigger a match for each combination of variable declaration 2381cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek/// and reference to that variable declaration within a compound statement. 2382ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel BenzaquenAST_POLYMORPHIC_MATCHER_P(equalsBoundNode, AST_POLYMORPHIC_SUPPORTED_TYPES_4( 2383ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen Stmt, Decl, Type, QualType), 2384ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen std::string, ID) { 2385cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek // FIXME: Figure out whether it makes sense to allow this 2386cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek // on any other node types. 2387cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek // For *Loc it probably does not make sense, as those seem 2388cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek // unique. For NestedNameSepcifier it might make sense, as 2389cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek // those also have pointer identity, but I'm not sure whether 2390cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek // they're ever reused. 2391cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek internal::NotEqualsBoundNodePredicate Predicate; 2392cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek Predicate.ID = ID; 2393cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek Predicate.Node = ast_type_traits::DynTypedNode::create(Node); 2394cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek return Builder->removeBindings(Predicate); 2395cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek} 2396cf52ca6bb6dd76a1bd967bc422287fafafa1e45aManuel Klimek 23974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the condition variable statement in an if statement. 23984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 23994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 240025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 24014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// if (A* a = GetAPointer()) {} 240225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2403063820655db8121f0022a7c51458463c7250324cBenjamin Kramer/// hasConditionVariableStatement(...) 24044da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'A* a = GetAPointer()'. 2405e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(IfStmt, hasConditionVariableStatement, 2406e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<DeclStmt>, InnerMatcher) { 2407e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const DeclStmt* const DeclarationStatement = 24084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek Node.getConditionVariableDeclStmt(); 24096bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return DeclarationStatement != nullptr && 24104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*DeclarationStatement, Finder, Builder); 24114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 24124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 2413e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches the index expression of an array subscript expression. 2414e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 2415e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 241625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2417e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int i[5]; 2418e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// void f() { i[1] = 42; } 241925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2420e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// arraySubscriptExpression(hasIndex(integerLiteral())) 2421e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \c i[1] with the \c integerLiteral() matching \c 1 2422e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(ArraySubscriptExpr, hasIndex, 242325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<Expr>, InnerMatcher) { 2424e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper if (const Expr* Expression = Node.getIdx()) 242525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek return InnerMatcher.matches(*Expression, Finder, Builder); 2426e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return false; 2427e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 2428e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 2429e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches the base expression of an array subscript expression. 2430e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 2431e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 243225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2433e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int i[5]; 2434e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// void f() { i[1] = 42; } 243525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 24362dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// arraySubscriptExpression(hasBase(implicitCastExpr( 24372dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// hasSourceExpression(declRefExpr())))) 24382dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// matches \c i[1] with the \c declRefExpr() matching \c i 2439e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(ArraySubscriptExpr, hasBase, 244025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<Expr>, InnerMatcher) { 2441e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper if (const Expr* Expression = Node.getBase()) 244225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek return InnerMatcher.matches(*Expression, Finder, Builder); 2443e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return false; 2444e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 2445e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 24466a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// \brief Matches a 'for', 'while', or 'do while' statement that has 24476a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// a given body. 24484da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 24494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 245025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 24514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// for (;;) {} 245225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 24532dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// hasBody(compoundStmt()) 24544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'for (;;) {}' 24552dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// with compoundStmt() 24564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matching '{}' 24576bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen HinesAST_POLYMORPHIC_MATCHER_P(hasBody, 24586bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines AST_POLYMORPHIC_SUPPORTED_TYPES_4(DoStmt, ForStmt, 24596bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines WhileStmt, 24606bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines CXXForRangeStmt), 24616bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines internal::Matcher<Stmt>, InnerMatcher) { 2462e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Stmt *const Statement = Node.getBody(); 24636bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (Statement != nullptr && 24644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*Statement, Finder, Builder)); 24654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 24664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 24674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches compound statements where at least one substatement matches 24684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// a given matcher. 24694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 24704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 247125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 24724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// { {}; 1+2; } 247325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 24742dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// hasAnySubstatement(compoundStmt()) 24754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches '{ {}; 1+2; }' 24762dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// with compoundStmt() 24774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matching '{}' 2478e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CompoundStmt, hasAnySubstatement, 2479e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Stmt>, InnerMatcher) { 2480054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek return matchesFirstInPointerRange(InnerMatcher, Node.body_begin(), 2481054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek Node.body_end(), Finder, Builder); 24824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 24834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 24844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Checks that a compound statement contains a specific number of 24854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// child statements. 24864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 24874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example: Given 248825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 24894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// { for (;;) {} } 249025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 24912dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// compoundStmt(statementCountIs(0))) 24924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches '{}' 24934da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// but does not match the outer compound statement. 2494e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CompoundStmt, statementCountIs, unsigned, N) { 24954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return Node.size() == N; 24964da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 24974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 24984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches literals that are equal to the given value. 24994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 25004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches true (matcher = boolLiteral(equals(true))) 250125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 25024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// true 250325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2504297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// 2505297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// Usable as: Matcher<CharacterLiteral>, Matcher<CXXBoolLiteral>, 2506297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// Matcher<FloatingLiteral>, Matcher<IntegerLiteral> 25074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimektemplate <typename ValueT> 25084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekinternal::PolymorphicMatcherWithParam1<internal::ValueEqualsMatcher, ValueT> 25094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekequals(const ValueT &Value) { 25104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::PolymorphicMatcherWithParam1< 25114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek internal::ValueEqualsMatcher, 25124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek ValueT>(Value); 25134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 25144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 25154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the operator Name of operator expressions (binary or 25164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// unary). 25174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 25184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches a || b (matcher = binaryOperator(hasOperatorName("||"))) 251925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 25204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// !(a || b) 252125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2522ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel BenzaquenAST_POLYMORPHIC_MATCHER_P(hasOperatorName, AST_POLYMORPHIC_SUPPORTED_TYPES_2( 2523ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen BinaryOperator, UnaryOperator), 2524ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen std::string, Name) { 25254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return Name == Node.getOpcodeStr(Node.getOpcode()); 25264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 25274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 25284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the left hand side of binary operator expressions. 25294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 25304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches a (matcher = binaryOperator(hasLHS())) 253125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 25324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// a || b 253325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2534e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(BinaryOperator, hasLHS, 2535e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 2536e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Expr *LeftHandSide = Node.getLHS(); 25376bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (LeftHandSide != nullptr && 25384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*LeftHandSide, Finder, Builder)); 25394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 25404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 25414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the right hand side of binary operator expressions. 25424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 25434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches b (matcher = binaryOperator(hasRHS())) 254425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 25454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// a || b 254625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2547e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(BinaryOperator, hasRHS, 2548e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 2549e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Expr *RightHandSide = Node.getRHS(); 25506bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (RightHandSide != nullptr && 25514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*RightHandSide, Finder, Builder)); 25524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 25534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 25544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if either the left hand side or the right hand side of a 25554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// binary operator matches. 2556e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperinline internal::Matcher<BinaryOperator> hasEitherOperand( 2557e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const internal::Matcher<Expr> &InnerMatcher) { 25584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return anyOf(hasLHS(InnerMatcher), hasRHS(InnerMatcher)); 25594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 25604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 25614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the operand of a unary operator matches. 25624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 25639158a5624154bc43bbbf059c07a2f7b2cd45c1a1Alexander Kornienko/// Example matches true (matcher = hasUnaryOperand(boolLiteral(equals(true)))) 256425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 25654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// !true 256625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2567e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(UnaryOperator, hasUnaryOperand, 2568e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 2569e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Expr * const Operand = Node.getSubExpr(); 25706bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (Operand != nullptr && 25714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*Operand, Finder, Builder)); 25724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 25734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 2574715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// \brief Matches if the cast's source expression matches the given matcher. 25754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 25764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example: matches "a string" (matcher = 25772dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// hasSourceExpression(constructExpr())) 257825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 25794da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class URL { URL(string); }; 25804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// URL url = "a string"; 2581715c9568ee5d75f25dab98229c87bcec880daf5dManuel KlimekAST_MATCHER_P(CastExpr, hasSourceExpression, 2582e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 2583e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Expr* const SubExpression = Node.getSubExpr(); 25846bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (SubExpression != nullptr && 25854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*SubExpression, Finder, Builder)); 25864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 25874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 25884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches casts whose destination type matches a given matcher. 25894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 25904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// (Note: Clang's AST refers to other conversions as "casts" too, and calls 25914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// actual casts "explicit" casts.) 2592e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(ExplicitCastExpr, hasDestinationType, 2593e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<QualType>, InnerMatcher) { 2594e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const QualType NodeType = Node.getTypeAsWritten(); 25954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return InnerMatcher.matches(NodeType, Finder, Builder); 25964da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 25974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 25984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches implicit casts whose destination type matches a given 25994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matcher. 26004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 26014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// FIXME: Unit test this matcher 2602e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(ImplicitCastExpr, hasImplicitDestinationType, 2603e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<QualType>, InnerMatcher) { 26044da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return InnerMatcher.matches(Node.getType(), Finder, Builder); 26054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 26064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 26074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the true branch expression of a conditional operator. 26084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 26094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches a 261025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 26114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// condition ? a : b 261225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2613e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(ConditionalOperator, hasTrueExpression, 2614e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 2615e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Expr *Expression = Node.getTrueExpr(); 26166bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (Expression != nullptr && 26174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*Expression, Finder, Builder)); 26184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 26194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 26204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the false branch expression of a conditional operator. 26214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 26224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches b 262325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 26244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// condition ? a : b 262525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2626e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(ConditionalOperator, hasFalseExpression, 2627e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 2628e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Expr *Expression = Node.getFalseExpr(); 26296bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (Expression != nullptr && 26304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*Expression, Finder, Builder)); 26314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 26324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 26334da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if a declaration has a body attached. 26344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 26354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches A, va, fa 263625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 26374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class A {}; 26384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class B; // Doesn't match, as it has no body. 26394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int va; 26404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// extern int vb; // Doesn't match, as it doesn't define the variable. 26414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void fa() {} 26424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void fb(); // Doesn't match, as it has no body. 264325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2644297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// 2645297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// Usable as: Matcher<TagDecl>, Matcher<VarDecl>, Matcher<FunctionDecl> 2646ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel BenzaquenAST_POLYMORPHIC_MATCHER(isDefinition, AST_POLYMORPHIC_SUPPORTED_TYPES_3( 2647ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen TagDecl, VarDecl, FunctionDecl)) { 2648415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek return Node.isThisDeclarationADefinition(); 26494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 26504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 26514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the class declaration that the given method declaration 26524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// belongs to. 26534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 26544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// FIXME: Generalize this for other kinds of declarations. 26554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// FIXME: What other kind of declarations would we need to generalize 26564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// this to? 26574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 26584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches A() in the last line 26592dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = constructExpr(hasDeclaration(methodDecl( 26604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// ofClass(hasName("A")))))) 266125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 26624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class A { 26634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// public: 26644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// A(); 26654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 26664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// A a = A(); 266725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2668e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CXXMethodDecl, ofClass, 2669e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<CXXRecordDecl>, InnerMatcher) { 2670e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const CXXRecordDecl *Parent = Node.getParent(); 26716bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return (Parent != nullptr && 26724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*Parent, Finder, Builder)); 26734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 26744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 26755771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// \brief Matches if the given method declaration is virtual. 26765771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// 26775771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// Given 26785771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// \code 26795771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// class A { 26805771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// public: 26815771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// virtual void x(); 26825771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// }; 26835771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// \endcode 26845771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// matches A::x 26855771a2f0830228ac50e3473740e24d9dca67b54fEdwin VaneAST_MATCHER(CXXMethodDecl, isVirtual) { 26865771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane return Node.isVirtual(); 26875771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane} 26885771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane 2689651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \brief Matches if the given method declaration is pure. 2690651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// 2691651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// Given 2692651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \code 2693651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// class A { 2694651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// public: 2695651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// virtual void x() = 0; 2696651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// }; 2697651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// \endcode 2698651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines/// matches A::x 2699651f13cea278ec967336033dd032faef0e9fc2ecStephen HinesAST_MATCHER(CXXMethodDecl, isPure) { 2700651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines return Node.isPure(); 2701651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines} 2702651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines 270332a6ebc63900b85780328c337787bb7adad2bcabEdwin Vane/// \brief Matches if the given method declaration is const. 270432a6ebc63900b85780328c337787bb7adad2bcabEdwin Vane/// 270532a6ebc63900b85780328c337787bb7adad2bcabEdwin Vane/// Given 270632a6ebc63900b85780328c337787bb7adad2bcabEdwin Vane/// \code 270732a6ebc63900b85780328c337787bb7adad2bcabEdwin Vane/// struct A { 270832a6ebc63900b85780328c337787bb7adad2bcabEdwin Vane/// void foo() const; 270932a6ebc63900b85780328c337787bb7adad2bcabEdwin Vane/// void bar(); 271032a6ebc63900b85780328c337787bb7adad2bcabEdwin Vane/// }; 271132a6ebc63900b85780328c337787bb7adad2bcabEdwin Vane/// \endcode 271232a6ebc63900b85780328c337787bb7adad2bcabEdwin Vane/// 271332a6ebc63900b85780328c337787bb7adad2bcabEdwin Vane/// methodDecl(isConst()) matches A::foo() but not A::bar() 271432a6ebc63900b85780328c337787bb7adad2bcabEdwin VaneAST_MATCHER(CXXMethodDecl, isConst) { 271532a6ebc63900b85780328c337787bb7adad2bcabEdwin Vane return Node.isConst(); 271632a6ebc63900b85780328c337787bb7adad2bcabEdwin Vane} 271732a6ebc63900b85780328c337787bb7adad2bcabEdwin Vane 27185771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// \brief Matches if the given method declaration overrides another method. 27195771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// 27205771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// Given 27215771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// \code 27225771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// class A { 27235771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// public: 27245771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// virtual void x(); 27255771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// }; 27265771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// class B : public A { 27275771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// public: 27285771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// virtual void x(); 27295771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// }; 27305771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// \endcode 27315771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane/// matches B::x 27325771a2f0830228ac50e3473740e24d9dca67b54fEdwin VaneAST_MATCHER(CXXMethodDecl, isOverride) { 27335771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane return Node.size_overridden_methods() > 0; 27345771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane} 27355771a2f0830228ac50e3473740e24d9dca67b54fEdwin Vane 27364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches member expressions that are called with '->' as opposed 27374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// to '.'. 27384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 27394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Member calls on the implicit this pointer match as called with '->'. 27404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 27414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 274225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 27434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { 27444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void x() { this->x(); x(); Y y; y.x(); a; this->b; Y::b; } 27454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int a; 27464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// static int b; 27474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 274825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 27492dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// memberExpr(isArrow()) 27504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches this->x, x, y.x, a, this->b 2751415514d5fbc2761b7f2938aa9112b079249820d6Manuel KlimekAST_MATCHER(MemberExpr, isArrow) { 2752415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek return Node.isArrow(); 27534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 27544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 27556a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// \brief Matches QualType nodes that are of integer type. 27566a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// 27576a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// Given 275825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 27596a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// void a(int); 27606a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// void b(long); 27616a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// void c(double); 276225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 27632dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// functionDecl(hasAnyParameter(hasType(isInteger()))) 27646a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// matches "a(int)", "b(long)", but not "c(double)". 27656a12449ec8862211856447d3df4c082a346339f2Daniel JasperAST_MATCHER(QualType, isInteger) { 27666a12449ec8862211856447d3df4c082a346339f2Daniel Jasper return Node->isIntegerType(); 27676a12449ec8862211856447d3df4c082a346339f2Daniel Jasper} 27686a12449ec8862211856447d3df4c082a346339f2Daniel Jasper 2769e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches QualType nodes that are const-qualified, i.e., that 27704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// include "top-level" const. 27714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 27724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 277325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 27744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void a(int); 27754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void b(int const); 27764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void c(const int); 27774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void d(const int*); 27784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void e(int const) {}; 277925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 27802dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// functionDecl(hasAnyParameter(hasType(isConstQualified()))) 27814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches "void b(int const)", "void c(const int)" and 27824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// "void e(int const) {}". It does not match d as there 27834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// is no top-level const on the parameter type "const int *". 2784415514d5fbc2761b7f2938aa9112b079249820d6Manuel KlimekAST_MATCHER(QualType, isConstQualified) { 2785415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek return Node.isConstQualified(); 27864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 27874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 27887b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane/// \brief Matches QualType nodes that have local CV-qualifiers attached to 27897b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane/// the node, not hidden within a typedef. 27907b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane/// 27917b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane/// Given 27927b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane/// \code 27937b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane/// typedef const int const_int; 27947b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane/// const_int i; 27957b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane/// int *const j; 27967b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane/// int *volatile k; 27977b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane/// int m; 27987b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane/// \endcode 27997b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane/// \c varDecl(hasType(hasLocalQualifiers())) matches only \c j and \c k. 28007b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane/// \c i is const-qualified but the qualifier is not local. 28017b69cd09440976d6b93a0db661a770b2337be8d2Edwin VaneAST_MATCHER(QualType, hasLocalQualifiers) { 28027b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane return Node.hasLocalQualifiers(); 28037b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane} 28047b69cd09440976d6b93a0db661a770b2337be8d2Edwin Vane 28054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a member expression where the member is matched by a 28064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// given matcher. 28074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 28084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 280925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 28104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct { int first, second; } first, second; 28114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int i(second.first); 28124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int j(first.second); 281325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 28142dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// memberExpr(member(hasName("first"))) 28154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches second.first 28164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// but not first.second (because the member name there is "second"). 2817e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(MemberExpr, member, 2818e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<ValueDecl>, InnerMatcher) { 28194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return InnerMatcher.matches(*Node.getMemberDecl(), Finder, Builder); 28204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 28214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 28224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a member expression where the object expression is 28234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matched by a given matcher. 28244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 28254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 282625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 28274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct X { int m; }; 28284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f(X x) { x.m; m; } 282925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 28302dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// memberExpr(hasObjectExpression(hasType(recordDecl(hasName("X"))))))) 28314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches "x.m" and "m" 28324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with hasObjectExpression(...) 28334da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matching "x" and the implicit object expression of "m" which has type X*. 2834e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(MemberExpr, hasObjectExpression, 2835e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 28364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return InnerMatcher.matches(*Node.getBase(), Finder, Builder); 28374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 28384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 2839e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches any using shadow declaration. 2840e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 2841e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 284225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2843e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// namespace X { void b(); } 2844e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// using X::b; 284525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2846e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// usingDecl(hasAnyUsingShadowDecl(hasName("b")))) 2847e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \code using X::b \endcode 2848e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(UsingDecl, hasAnyUsingShadowDecl, 284925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<UsingShadowDecl>, InnerMatcher) { 2850054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek return matchesFirstInPointerRange(InnerMatcher, Node.shadow_begin(), 2851054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek Node.shadow_end(), Finder, Builder); 2852e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 2853e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 2854e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches a using shadow declaration where the target declaration is 2855e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matched by the given matcher. 2856e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 2857e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 285825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2859e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// namespace X { int a; void b(); } 2860e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// using X::a; 2861e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// using X::b; 286225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 28632dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// usingDecl(hasAnyUsingShadowDecl(hasTargetDecl(functionDecl()))) 2864e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \code using X::b \endcode 2865e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// but not \code using X::a \endcode 2866e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(UsingShadowDecl, hasTargetDecl, 286725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<NamedDecl>, InnerMatcher) { 286825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek return InnerMatcher.matches(*Node.getTargetDecl(), Finder, Builder); 2869e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 2870e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 28714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches template instantiations of function, class, or static 28724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// member variable template instantiations. 28734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 28744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 287525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 28764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// template <typename T> class X {}; class A {}; X<A> x; 287725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 28784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// or 287925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 28804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// template <typename T> class X {}; class A {}; template class X<A>; 288125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 28822dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// recordDecl(hasName("::X"), isTemplateInstantiation()) 28834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches the template instantiation of X<A>. 28844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 28854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// But given 288625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 288725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// template <typename T> class X {}; class A {}; 28884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// template <> class X<A> {}; X<A> x; 288925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 28902dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// recordDecl(hasName("::X"), isTemplateInstantiation()) 28914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// does not match, as X<A> is an explicit template specialization. 2892297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// 2893297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// Usable as: Matcher<FunctionDecl>, Matcher<VarDecl>, Matcher<CXXRecordDecl> 2894ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel BenzaquenAST_POLYMORPHIC_MATCHER( 2895ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen isTemplateInstantiation, 2896ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen AST_POLYMORPHIC_SUPPORTED_TYPES_3(FunctionDecl, VarDecl, CXXRecordDecl)) { 2897415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek return (Node.getTemplateSpecializationKind() == TSK_ImplicitInstantiation || 2898415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek Node.getTemplateSpecializationKind() == 2899415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek TSK_ExplicitInstantiationDefinition); 29004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 29014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 29028456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// \brief Matches explicit template specializations of function, class, or 29038456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// static member variable template instantiations. 29048456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// 29058456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// Given 290625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 29078456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// template<typename T> void A(T t) { } 29088456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// template<> void A(int N) { } 290925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 29102dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// functionDecl(isExplicitTemplateSpecialization()) 29118456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// matches the specialization A<int>(). 291225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 291325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Matcher<FunctionDecl>, Matcher<VarDecl>, Matcher<CXXRecordDecl> 2914ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel BenzaquenAST_POLYMORPHIC_MATCHER( 2915ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen isExplicitTemplateSpecialization, 2916ef7eb024397a6a9d1455b31bc7b10288a817ac3bSamuel Benzaquen AST_POLYMORPHIC_SUPPORTED_TYPES_3(FunctionDecl, VarDecl, CXXRecordDecl)) { 2917415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek return (Node.getTemplateSpecializationKind() == TSK_ExplicitSpecialization); 29188456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko} 29198456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko 2920ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches \c TypeLocs for which the given inner 2921ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// QualType-matcher matches. 2922651f13cea278ec967336033dd032faef0e9fc2ecStephen HinesAST_MATCHER_FUNCTION_P_OVERLOAD(internal::BindableMatcher<TypeLoc>, loc, 2923651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines internal::Matcher<QualType>, InnerMatcher, 0) { 2924ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper return internal::BindableMatcher<TypeLoc>( 2925ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper new internal::TypeLocTypeMatcher(InnerMatcher)); 2926ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper} 2927ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2928ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches builtin Types. 2929ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2930ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2931ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2932ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// struct A {}; 2933ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// A a; 2934ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int b; 2935ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// float c; 2936ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// bool d; 2937ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2938ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// builtinType() 2939ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int b", "float c" and "bool d" 2940ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(BuiltinType, builtinType); 2941ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2942ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches all kinds of arrays. 2943ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2944ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2945ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2946ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int a[] = { 2, 3 }; 2947ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int b[4]; 2948ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// void f() { int c[a[0]]; } 2949ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2950ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// arrayType() 2951ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int a[]", "int b[4]" and "int c[a[0]]"; 2952ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(ArrayType, arrayType); 2953ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2954ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches C99 complex types. 2955ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2956ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2957ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2958ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// _Complex float f; 2959ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2960ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// complexType() 2961ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "_Complex float f" 2962ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(ComplexType, complexType); 2963ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2964ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches arrays and C99 complex types that have a specific element 2965ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// type. 2966ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2967ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2968ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2969ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// struct A {}; 2970ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// A a[7]; 2971ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int b[7]; 2972ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2973ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// arrayType(hasElementType(builtinType())) 2974ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int b[7]" 2975ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2976ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Usable as: Matcher<ArrayType>, Matcher<ComplexType> 29773f84bb341bfb1312842b09db71d76bc3898ba247Samuel BenzaquenAST_TYPELOC_TRAVERSE_MATCHER( 29783f84bb341bfb1312842b09db71d76bc3898ba247Samuel Benzaquen hasElementType, getElement, 29793f84bb341bfb1312842b09db71d76bc3898ba247Samuel Benzaquen AST_POLYMORPHIC_SUPPORTED_TYPES_2(ArrayType, ComplexType)); 2980ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2981ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches C arrays with a specified constant size. 2982ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2983ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2984ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2985ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// void() { 2986ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int a[2]; 2987ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int b[] = { 2, 3 }; 2988ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int c[b[0]]; 2989ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// } 2990ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2991ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// constantArrayType() 2992ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int a[2]" 2993ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(ConstantArrayType, constantArrayType); 2994ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2995ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches \c ConstantArrayType nodes that have the specified size. 2996ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2997ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2998ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2999ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int a[42]; 3000ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int b[2 * 21]; 3001ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int c[41], d[43]; 3002ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3003ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// constantArrayType(hasSize(42)) 3004ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int a[42]" and "int b[2 * 21]" 3005ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_MATCHER_P(ConstantArrayType, hasSize, unsigned, N) { 3006ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper return Node.getSize() == N; 3007ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper} 3008ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3009ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches C++ arrays whose size is a value-dependent expression. 3010ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3011ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 3012ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3013ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// template<typename T, int Size> 3014ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// class array { 3015ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// T data[Size]; 3016ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// }; 3017ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3018ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// dependentSizedArrayType 3019ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "T data[Size]" 3020ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(DependentSizedArrayType, dependentSizedArrayType); 3021ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3022ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches C arrays with unspecified size. 3023ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3024ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 3025ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3026ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int a[] = { 2, 3 }; 3027ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int b[42]; 3028ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// void f(int c[]) { int d[a[0]]; }; 3029ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3030ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// incompleteArrayType() 3031ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int a[]" and "int c[]" 3032ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(IncompleteArrayType, incompleteArrayType); 3033ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3034ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches C arrays with a specified size that is not an 3035ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// integer-constant-expression. 3036ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3037ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 3038ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3039ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// void f() { 3040ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int a[] = { 2, 3 } 3041ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int b[42]; 3042ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int c[a[0]]; 3043ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3044ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// variableArrayType() 3045ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int c[a[0]]" 3046ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(VariableArrayType, variableArrayType); 3047ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3048ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches \c VariableArrayType nodes that have a specific size 3049ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// expression. 3050ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3051ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 3052ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3053ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// void f(int b) { 3054ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int a[b]; 3055ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// } 3056ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3057ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// variableArrayType(hasSizeExpr(ignoringImpCasts(declRefExpr(to( 3058ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// varDecl(hasName("b"))))))) 3059ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int a[b]" 3060ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_MATCHER_P(VariableArrayType, hasSizeExpr, 3061ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 3062ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper return InnerMatcher.matches(*Node.getSizeExpr(), Finder, Builder); 3063ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper} 3064ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3065ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches atomic types. 3066ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3067ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 3068ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3069ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// _Atomic(int) i; 3070ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3071ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// atomicType() 3072ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "_Atomic(int) i" 3073ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(AtomicType, atomicType); 3074ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3075ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches atomic types with a specific value type. 3076ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3077ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 3078ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3079ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// _Atomic(int) i; 3080ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// _Atomic(float) f; 3081ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3082ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// atomicType(hasValueType(isInteger())) 3083ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "_Atomic(int) i" 3084ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3085ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Usable as: Matcher<AtomicType> 30863f84bb341bfb1312842b09db71d76bc3898ba247Samuel BenzaquenAST_TYPELOC_TRAVERSE_MATCHER(hasValueType, getValue, 30873f84bb341bfb1312842b09db71d76bc3898ba247Samuel Benzaquen AST_POLYMORPHIC_SUPPORTED_TYPES_1(AtomicType)); 3088ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3089ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches types nodes representing C++11 auto types. 3090ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3091ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given: 3092ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3093ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// auto n = 4; 3094ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int v[] = { 2, 3 } 3095ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// for (auto i : v) { } 3096ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3097ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// autoType() 3098ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "auto n" and "auto i" 3099ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(AutoType, autoType); 3100ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3101ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches \c AutoType nodes where the deduced type is a specific type. 3102ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3103ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Note: There is no \c TypeLoc for the deduced type and thus no 3104ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \c getDeducedLoc() matcher. 3105ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3106ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 3107ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3108ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// auto a = 1; 3109ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// auto b = 2.0; 3110ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3111ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// autoType(hasDeducedType(isInteger())) 3112ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "auto a" 3113ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3114ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Usable as: Matcher<AutoType> 31153f84bb341bfb1312842b09db71d76bc3898ba247Samuel BenzaquenAST_TYPE_TRAVERSE_MATCHER(hasDeducedType, getDeducedType, 31163f84bb341bfb1312842b09db71d76bc3898ba247Samuel Benzaquen AST_POLYMORPHIC_SUPPORTED_TYPES_1(AutoType)); 3117ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3118a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// \brief Matches \c FunctionType nodes. 3119a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// 3120a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// Given 3121a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// \code 3122a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// int (*f)(int); 3123a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// void g(); 3124a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// \endcode 3125a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// functionType() 3126a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// matches "int (*f)(int)" and the type of "g". 3127a267cf6f87dc695143d65fc61ec1744564f55932Daniel JasperAST_TYPE_MATCHER(FunctionType, functionType); 3128a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper 312988be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// \brief Matches \c ParenType nodes. 313088be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// 313188be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// Given 313288be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// \code 313388be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// int (*ptr_to_array)[4]; 313488be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// int *array_of_ptrs[4]; 313588be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// \endcode 313688be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// 313788be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// \c varDecl(hasType(pointsTo(parenType()))) matches \c ptr_to_array but not 313888be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// \c array_of_ptrs. 313988be2fdec7a1375bc729a6499629532e7872f11aEdwin VaneAST_TYPE_MATCHER(ParenType, parenType); 314088be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane 314188be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// \brief Matches \c ParenType nodes where the inner type is a specific type. 314288be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// 314388be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// Given 314488be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// \code 314588be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// int (*ptr_to_array)[4]; 314688be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// int (*ptr_to_func)(int); 314788be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// \endcode 314888be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// 314988be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// \c varDecl(hasType(pointsTo(parenType(innerType(functionType()))))) matches 315088be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// \c ptr_to_func but not \c ptr_to_array. 315188be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// 315288be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane/// Usable as: Matcher<ParenType> 31533f84bb341bfb1312842b09db71d76bc3898ba247Samuel BenzaquenAST_TYPE_TRAVERSE_MATCHER(innerType, getInnerType, 31543f84bb341bfb1312842b09db71d76bc3898ba247Samuel Benzaquen AST_POLYMORPHIC_SUPPORTED_TYPES_1(ParenType)); 315588be2fdec7a1375bc729a6499629532e7872f11aEdwin Vane 3156ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches block pointer types, i.e. types syntactically represented as 3157ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// "void (^)(int)". 3158ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3159ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// The \c pointee is always required to be a \c FunctionType. 3160ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(BlockPointerType, blockPointerType); 3161ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3162ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches member pointer types. 3163ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 3164ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3165ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// struct A { int i; } 3166ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// A::* ptr = A::i; 3167ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3168ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// memberPointerType() 3169ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "A::* ptr" 3170ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(MemberPointerType, memberPointerType); 3171ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3172ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches pointer types. 3173ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3174ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 3175ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3176ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int *a; 3177ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int &b = *a; 3178ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int c = 5; 3179ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3180ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// pointerType() 3181ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int *a" 3182ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(PointerType, pointerType); 3183ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3184f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// \brief Matches both lvalue and rvalue reference types. 3185ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3186ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 3187ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3188ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int *a; 3189ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int &b = *a; 3190f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// int &&c = 1; 3191f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// auto &d = b; 3192f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// auto &&e = c; 3193f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// auto &&f = 2; 3194f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// int g = 5; 3195ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3196f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// 3197f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// \c referenceType() matches the types of \c b, \c c, \c d, \c e, and \c f. 3198ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(ReferenceType, referenceType); 3199ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3200f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// \brief Matches lvalue reference types. 3201f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// 3202f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// Given: 3203f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// \code 3204f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// int *a; 3205f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// int &b = *a; 3206f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// int &&c = 1; 3207f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// auto &d = b; 3208f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// auto &&e = c; 3209f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// auto &&f = 2; 3210f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// int g = 5; 3211f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// \endcode 3212f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// 3213f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// \c lValueReferenceType() matches the types of \c b, \c d, and \c e. \c e is 3214f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// matched since the type is deduced as int& by reference collapsing rules. 3215f4b48042724d2253d0426cadcb93e24eeb47e264Edwin VaneAST_TYPE_MATCHER(LValueReferenceType, lValueReferenceType); 3216f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane 3217f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// \brief Matches rvalue reference types. 3218f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// 3219f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// Given: 3220f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// \code 3221f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// int *a; 3222f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// int &b = *a; 3223f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// int &&c = 1; 3224f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// auto &d = b; 3225f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// auto &&e = c; 3226f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// auto &&f = 2; 3227f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// int g = 5; 3228f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// \endcode 3229f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// 3230f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// \c rValueReferenceType() matches the types of \c c and \c f. \c e is not 3231f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane/// matched as it is deduced to int& by reference collapsing rules. 3232f4b48042724d2253d0426cadcb93e24eeb47e264Edwin VaneAST_TYPE_MATCHER(RValueReferenceType, rValueReferenceType); 3233f4b48042724d2253d0426cadcb93e24eeb47e264Edwin Vane 3234ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Narrows PointerType (and similar) matchers to those where the 3235ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \c pointee matches a given matcher. 3236ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3237ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 3238ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3239ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int *a; 3240ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int const *b; 3241ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// float const *f; 3242ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3243ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// pointerType(pointee(isConstQualified(), isInteger())) 3244ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int const *b" 3245ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3246ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Usable as: Matcher<BlockPointerType>, Matcher<MemberPointerType>, 3247ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Matcher<PointerType>, Matcher<ReferenceType> 32483f84bb341bfb1312842b09db71d76bc3898ba247Samuel BenzaquenAST_TYPELOC_TRAVERSE_MATCHER( 32493f84bb341bfb1312842b09db71d76bc3898ba247Samuel Benzaquen pointee, getPointee, 32503f84bb341bfb1312842b09db71d76bc3898ba247Samuel Benzaquen AST_POLYMORPHIC_SUPPORTED_TYPES_4(BlockPointerType, MemberPointerType, 32513f84bb341bfb1312842b09db71d76bc3898ba247Samuel Benzaquen PointerType, ReferenceType)); 3252ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3253ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches typedef types. 3254ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3255ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 3256ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3257ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// typedef int X; 3258ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3259ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// typedefType() 3260ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "typedef int X" 3261ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(TypedefType, typedefType); 3262ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 32633abf77872ca6c520903f9174cf6cd89a50df2714Edwin Vane/// \brief Matches template specialization types. 32643abf77872ca6c520903f9174cf6cd89a50df2714Edwin Vane/// 32653abf77872ca6c520903f9174cf6cd89a50df2714Edwin Vane/// Given 32663abf77872ca6c520903f9174cf6cd89a50df2714Edwin Vane/// \code 32673abf77872ca6c520903f9174cf6cd89a50df2714Edwin Vane/// template <typename T> 32683abf77872ca6c520903f9174cf6cd89a50df2714Edwin Vane/// class C { }; 32693abf77872ca6c520903f9174cf6cd89a50df2714Edwin Vane/// 32703abf77872ca6c520903f9174cf6cd89a50df2714Edwin Vane/// template class C<int>; // A 32713abf77872ca6c520903f9174cf6cd89a50df2714Edwin Vane/// C<char> var; // B 32723abf77872ca6c520903f9174cf6cd89a50df2714Edwin Vane/// \code 32733abf77872ca6c520903f9174cf6cd89a50df2714Edwin Vane/// 32743abf77872ca6c520903f9174cf6cd89a50df2714Edwin Vane/// \c templateSpecializationType() matches the type of the explicit 32753abf77872ca6c520903f9174cf6cd89a50df2714Edwin Vane/// instantiation in \c A and the type of the variable declaration in \c B. 32763abf77872ca6c520903f9174cf6cd89a50df2714Edwin VaneAST_TYPE_MATCHER(TemplateSpecializationType, templateSpecializationType); 32773abf77872ca6c520903f9174cf6cd89a50df2714Edwin Vane 32782d77634e839880704d51656bebd1d2daff661d4eEnea Zaffanella/// \brief Matches types nodes representing unary type transformations. 32792d77634e839880704d51656bebd1d2daff661d4eEnea Zaffanella/// 32802d77634e839880704d51656bebd1d2daff661d4eEnea Zaffanella/// Given: 32812d77634e839880704d51656bebd1d2daff661d4eEnea Zaffanella/// \code 32822d77634e839880704d51656bebd1d2daff661d4eEnea Zaffanella/// typedef __underlying_type(T) type; 32832d77634e839880704d51656bebd1d2daff661d4eEnea Zaffanella/// \endcode 32842d77634e839880704d51656bebd1d2daff661d4eEnea Zaffanella/// unaryTransformType() 32852d77634e839880704d51656bebd1d2daff661d4eEnea Zaffanella/// matches "__underlying_type(T)" 32862d77634e839880704d51656bebd1d2daff661d4eEnea ZaffanellaAST_TYPE_MATCHER(UnaryTransformType, unaryTransformType); 32872d77634e839880704d51656bebd1d2daff661d4eEnea Zaffanella 3288742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \brief Matches record types (e.g. structs, classes). 3289742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// 3290742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// Given 3291742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \code 3292742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// class C {}; 3293742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// struct S {}; 3294742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// 3295742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// C c; 3296742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// S s; 3297742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \code 3298742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// 3299742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \c recordType() matches the type of the variable declarations of both \c c 3300742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// and \c s. 3301742d9e77e32f014194679575c97c6bb4fd0998c4Edwin VaneAST_TYPE_MATCHER(RecordType, recordType); 3302742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane 3303742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \brief Matches types specified with an elaborated type keyword or with a 3304742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// qualified name. 3305742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// 3306742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// Given 3307742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \code 3308742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// namespace N { 3309742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// namespace M { 3310742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// class D {}; 3311742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// } 3312742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// } 3313742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// class C {}; 3314742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// 3315742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// class C c; 3316742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// N::M::D d; 3317742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \code 3318742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// 3319742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \c elaboratedType() matches the type of the variable declarations of both 3320742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \c c and \c d. 3321742d9e77e32f014194679575c97c6bb4fd0998c4Edwin VaneAST_TYPE_MATCHER(ElaboratedType, elaboratedType); 3322742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane 3323742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \brief Matches ElaboratedTypes whose qualifier, a NestedNameSpecifier, 3324aec89ac22e1876bb1cfff9062c882a622bc84510Edwin Vane/// matches \c InnerMatcher if the qualifier exists. 3325742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// 3326742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// Given 3327742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \code 3328742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// namespace N { 3329742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// namespace M { 3330742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// class D {}; 3331742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// } 3332742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// } 3333742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// N::M::D d; 3334742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \code 3335742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// 3336742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \c elaboratedType(hasQualifier(hasPrefix(specifiesNamespace(hasName("N")))) 3337742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// matches the type of the variable declaration of \c d. 3338742d9e77e32f014194679575c97c6bb4fd0998c4Edwin VaneAST_MATCHER_P(ElaboratedType, hasQualifier, 3339742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane internal::Matcher<NestedNameSpecifier>, InnerMatcher) { 3340aec89ac22e1876bb1cfff9062c882a622bc84510Edwin Vane if (const NestedNameSpecifier *Qualifier = Node.getQualifier()) 3341aec89ac22e1876bb1cfff9062c882a622bc84510Edwin Vane return InnerMatcher.matches(*Qualifier, Finder, Builder); 3342aec89ac22e1876bb1cfff9062c882a622bc84510Edwin Vane 3343aec89ac22e1876bb1cfff9062c882a622bc84510Edwin Vane return false; 3344742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane} 3345742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane 3346742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \brief Matches ElaboratedTypes whose named type matches \c InnerMatcher. 3347742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// 3348742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// Given 3349742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \code 3350742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// namespace N { 3351742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// namespace M { 3352742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// class D {}; 3353742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// } 3354742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// } 3355742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// N::M::D d; 3356742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \code 3357742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// 3358742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \c elaboratedType(namesType(recordType( 3359742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// hasDeclaration(namedDecl(hasName("D")))))) matches the type of the variable 3360742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// declaration of \c d. 3361742d9e77e32f014194679575c97c6bb4fd0998c4Edwin VaneAST_MATCHER_P(ElaboratedType, namesType, internal::Matcher<QualType>, 3362742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane InnerMatcher) { 3363742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane return InnerMatcher.matches(Node.getNamedType(), Finder, Builder); 3364742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane} 3365742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane 3366742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \brief Matches declarations whose declaration context, interpreted as a 3367742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// Decl, matches \c InnerMatcher. 3368742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// 3369742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// Given 3370742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \code 3371742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// namespace N { 3372742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// namespace M { 3373742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// class D {}; 3374742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// } 3375742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// } 3376742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \code 3377742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// 3378742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// \c recordDecl(hasDeclContext(namedDecl(hasName("M")))) matches the 3379742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane/// declaration of \c class \c D. 3380742d9e77e32f014194679575c97c6bb4fd0998c4Edwin VaneAST_MATCHER_P(Decl, hasDeclContext, internal::Matcher<Decl>, InnerMatcher) { 3381742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane return InnerMatcher.matches(*Decl::castFromDeclContext(Node.getDeclContext()), 3382742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane Finder, Builder); 3383742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane} 3384742d9e77e32f014194679575c97c6bb4fd0998c4Edwin Vane 3385a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \brief Matches nested name specifiers. 3386a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// 3387a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// Given 3388a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \code 3389a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// namespace ns { 3390a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// struct A { static void f(); }; 3391a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// void A::f() {} 3392a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// void g() { A::f(); } 3393a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// } 3394a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// ns::A a; 3395a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \endcode 3396a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// nestedNameSpecifier() 3397a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// matches "ns::" and both "A::" 3398a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasperconst internal::VariadicAllOfMatcher<NestedNameSpecifier> nestedNameSpecifier; 3399a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper 3400a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \brief Same as \c nestedNameSpecifier but matches \c NestedNameSpecifierLoc. 3401a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasperconst internal::VariadicAllOfMatcher< 3402a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper NestedNameSpecifierLoc> nestedNameSpecifierLoc; 3403a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper 3404a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \brief Matches \c NestedNameSpecifierLocs for which the given inner 3405a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// NestedNameSpecifier-matcher matches. 3406651f13cea278ec967336033dd032faef0e9fc2ecStephen HinesAST_MATCHER_FUNCTION_P_OVERLOAD( 3407651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines internal::BindableMatcher<NestedNameSpecifierLoc>, loc, 3408651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines internal::Matcher<NestedNameSpecifier>, InnerMatcher, 1) { 3409a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper return internal::BindableMatcher<NestedNameSpecifierLoc>( 3410a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper new internal::LocMatcher<NestedNameSpecifierLoc, NestedNameSpecifier>( 3411a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper InnerMatcher)); 3412a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper} 3413a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper 3414a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \brief Matches nested name specifiers that specify a type matching the 3415a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// given \c QualType matcher without qualifiers. 3416a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// 3417a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// Given 3418a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \code 3419a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// struct A { struct B { struct C {}; }; }; 3420a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// A::B::C c; 3421a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \endcode 3422a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// nestedNameSpecifier(specifiesType(hasDeclaration(recordDecl(hasName("A"))))) 3423a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// matches "A::" 3424a7564433191601cb8851196b8dde39392c9c05eeDaniel JasperAST_MATCHER_P(NestedNameSpecifier, specifiesType, 3425a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper internal::Matcher<QualType>, InnerMatcher) { 34266bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines if (!Node.getAsType()) 3427a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper return false; 3428a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper return InnerMatcher.matches(QualType(Node.getAsType(), 0), Finder, Builder); 3429a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper} 3430a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper 3431ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches nested name specifier locs that specify a type matching the 3432ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// given \c TypeLoc. 3433ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3434ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 3435ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3436ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// struct A { struct B { struct C {}; }; }; 3437ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// A::B::C c; 3438ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3439ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// nestedNameSpecifierLoc(specifiesTypeLoc(loc(type( 3440ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// hasDeclaration(recordDecl(hasName("A"))))))) 3441ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "A::" 3442ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_MATCHER_P(NestedNameSpecifierLoc, specifiesTypeLoc, 3443ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper internal::Matcher<TypeLoc>, InnerMatcher) { 3444651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines return Node && InnerMatcher.matches(Node.getTypeLoc(), Finder, Builder); 3445ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper} 3446ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3447ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches on the prefix of a \c NestedNameSpecifier. 3448a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// 3449a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// Given 3450a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \code 3451a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// struct A { struct B { struct C {}; }; }; 3452a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// A::B::C c; 3453a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \endcode 3454a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// nestedNameSpecifier(hasPrefix(specifiesType(asString("struct A")))) and 3455ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "A::" 3456415514d5fbc2761b7f2938aa9112b079249820d6Manuel KlimekAST_MATCHER_P_OVERLOAD(NestedNameSpecifier, hasPrefix, 3457415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek internal::Matcher<NestedNameSpecifier>, InnerMatcher, 3458415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek 0) { 3459415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek NestedNameSpecifier *NextNode = Node.getPrefix(); 34606bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines if (!NextNode) 3461415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek return false; 3462415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek return InnerMatcher.matches(*NextNode, Finder, Builder); 3463ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper} 3464ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 3465ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches on the prefix of a \c NestedNameSpecifierLoc. 3466ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 3467ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 3468ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 3469ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// struct A { struct B { struct C {}; }; }; 3470ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// A::B::C c; 3471ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 3472a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// nestedNameSpecifierLoc(hasPrefix(loc(specifiesType(asString("struct A"))))) 3473ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "A::" 3474415514d5fbc2761b7f2938aa9112b079249820d6Manuel KlimekAST_MATCHER_P_OVERLOAD(NestedNameSpecifierLoc, hasPrefix, 3475415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek internal::Matcher<NestedNameSpecifierLoc>, InnerMatcher, 3476415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek 1) { 3477415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek NestedNameSpecifierLoc NextNode = Node.getPrefix(); 3478415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek if (!NextNode) 3479415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek return false; 3480415514d5fbc2761b7f2938aa9112b079249820d6Manuel Klimek return InnerMatcher.matches(NextNode, Finder, Builder); 3481ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper} 3482a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper 3483a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \brief Matches nested name specifiers that specify a namespace matching the 3484a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// given namespace matcher. 3485a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// 3486a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// Given 3487a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \code 3488a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// namespace ns { struct A {}; } 3489a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// ns::A a; 3490a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \endcode 3491a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// nestedNameSpecifier(specifiesNamespace(hasName("ns"))) 3492a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// matches "ns::" 3493a7564433191601cb8851196b8dde39392c9c05eeDaniel JasperAST_MATCHER_P(NestedNameSpecifier, specifiesNamespace, 3494a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper internal::Matcher<NamespaceDecl>, InnerMatcher) { 34956bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines if (!Node.getAsNamespace()) 3496a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper return false; 3497a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper return InnerMatcher.matches(*Node.getAsNamespace(), Finder, Builder); 3498a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper} 3499a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper 3500fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek/// \brief Overloads for the \c equalsNode matcher. 3501fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek/// FIXME: Implement for other node types. 3502fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek/// @{ 3503fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek 3504fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek/// \brief Matches if a node equals another node. 3505fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek/// 3506fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek/// \c Decl has pointer identity in the AST. 35076bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hinesinline internal::Matcher<Decl> equalsNode(const Decl *Node) { 35086bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return internal::makeMatcher(new internal::EqualsNodeMatcher<Decl>(Node)); 3509fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek} 3510fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek/// \brief Matches if a node equals another node. 3511fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek/// 3512fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek/// \c Stmt has pointer identity in the AST. 3513fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek/// 35146bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hinesinline internal::Matcher<Stmt> equalsNode(const Stmt *Node) { 35156bcf27bb9a4b5c3f79cb44c0e4654a6d7619ad89Stephen Hines return internal::makeMatcher(new internal::EqualsNodeMatcher<Stmt>(Node)); 3516fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek} 3517fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek 3518fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek/// @} 3519fa37c5ca61af275a329386407e58cf70f4d9f596Manuel Klimek 3520acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// \brief Matches each case or default statement belonging to the given switch 3521acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// statement. This matcher may produce multiple matches. 3522acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// 3523acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// Given 3524acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// \code 3525acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// switch (1) { case 1: case 2: default: switch (2) { case 3: case 4: ; } } 3526acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// \endcode 3527acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// switchStmt(forEachSwitchCase(caseStmt().bind("c"))).bind("s") 3528acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// matches four times, with "c" binding each of "case 1:", "case 2:", 3529acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// "case 3:" and "case 4:", and "s" respectively binding "switch (1)", 3530acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// "switch (1)", "switch (2)" and "switch (2)". 3531acf02715ab1aa1e5a791f20e0d1ca217af256823Peter CollingbourneAST_MATCHER_P(SwitchStmt, forEachSwitchCase, internal::Matcher<SwitchCase>, 3532acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne InnerMatcher) { 3533054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek BoundNodesTreeBuilder Result; 3534acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne // FIXME: getSwitchCaseList() does not necessarily guarantee a stable 3535acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne // iteration order. We should use the more general iterating matchers once 3536acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne // they are capable of expressing this matcher (for example, it should ignore 3537acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne // case statements belonging to nested switch statements). 3538acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne bool Matched = false; 3539acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne for (const SwitchCase *SC = Node.getSwitchCaseList(); SC; 3540acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne SC = SC->getNextSwitchCase()) { 3541054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek BoundNodesTreeBuilder CaseBuilder(*Builder); 3542acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne bool CaseMatched = InnerMatcher.matches(*SC, Finder, &CaseBuilder); 3543acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne if (CaseMatched) { 3544acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne Matched = true; 3545054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek Result.addMatch(CaseBuilder); 3546acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne } 3547acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne } 3548054d049174eb1ec8e93a4a0831c0d8caac00cb3aManuel Klimek *Builder = Result; 3549acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne return Matched; 3550acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne} 3551acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne 355206963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// \brief Matches each constructor initializer in a constructor definition. 355306963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// 355406963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// Given 355506963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// \code 355606963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// class A { A() : i(42), j(42) {} int i; int j; }; 355706963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// \endcode 355806963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// constructorDecl(forEachConstructorInitializer(forField(decl().bind("x")))) 355906963013d1972f1f7a58875bb40976b60522700bManuel Klimek/// will trigger two matches, binding for 'i' and 'j' respectively. 356006963013d1972f1f7a58875bb40976b60522700bManuel KlimekAST_MATCHER_P(CXXConstructorDecl, forEachConstructorInitializer, 356106963013d1972f1f7a58875bb40976b60522700bManuel Klimek internal::Matcher<CXXCtorInitializer>, InnerMatcher) { 356206963013d1972f1f7a58875bb40976b60522700bManuel Klimek BoundNodesTreeBuilder Result; 356306963013d1972f1f7a58875bb40976b60522700bManuel Klimek bool Matched = false; 3564651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines for (const auto *I : Node.inits()) { 356506963013d1972f1f7a58875bb40976b60522700bManuel Klimek BoundNodesTreeBuilder InitBuilder(*Builder); 3566651f13cea278ec967336033dd032faef0e9fc2ecStephen Hines if (InnerMatcher.matches(*I, Finder, &InitBuilder)) { 356706963013d1972f1f7a58875bb40976b60522700bManuel Klimek Matched = true; 356806963013d1972f1f7a58875bb40976b60522700bManuel Klimek Result.addMatch(InitBuilder); 356906963013d1972f1f7a58875bb40976b60522700bManuel Klimek } 357006963013d1972f1f7a58875bb40976b60522700bManuel Klimek } 357106963013d1972f1f7a58875bb40976b60522700bManuel Klimek *Builder = Result; 357206963013d1972f1f7a58875bb40976b60522700bManuel Klimek return Matched; 357306963013d1972f1f7a58875bb40976b60522700bManuel Klimek} 357406963013d1972f1f7a58875bb40976b60522700bManuel Klimek 3575acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// \brief If the given case statement does not use the GNU case range 3576acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// extension, matches the constant given in the statement. 3577acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// 3578acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// Given 3579acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// \code 3580acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// switch (1) { case 1: case 1+1: case 3 ... 4: ; } 3581acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// \endcode 3582acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// caseStmt(hasCaseConstant(integerLiteral())) 3583acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne/// matches "case 1:" 3584acf02715ab1aa1e5a791f20e0d1ca217af256823Peter CollingbourneAST_MATCHER_P(CaseStmt, hasCaseConstant, internal::Matcher<Expr>, 3585acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne InnerMatcher) { 3586acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne if (Node.getRHS()) 3587acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne return false; 3588acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne 3589acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne return InnerMatcher.matches(*Node.getLHS(), Finder, Builder); 3590acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne} 3591acf02715ab1aa1e5a791f20e0d1ca217af256823Peter Collingbourne 35924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} // end namespace ast_matchers 35934da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} // end namespace clang 35944da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 35954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek#endif // LLVM_CLANG_AST_MATCHERS_AST_MATCHERS_H 3596