ASTMatchers.h revision afbcab8d10d4208c7ad8da79e948432117d4a326
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 48e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper#include "clang/AST/DeclTemplate.h" 494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek#include "clang/ASTMatchers/ASTMatchersInternal.h" 504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek#include "clang/ASTMatchers/ASTMatchersMacros.h" 514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek#include "llvm/ADT/Twine.h" 52e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper#include "llvm/Support/Regex.h" 53425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer#include <iterator> 544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimeknamespace clang { 564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimeknamespace ast_matchers { 574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Maps string IDs to AST nodes matched by parts of a matcher. 594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// The bound nodes are generated by calling \c bind("id") on the node matchers 6125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// of the nodes we want to access later. 624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// The instances of BoundNodes are created by \c MatchFinder when the user's 644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// callbacks are executed every time a match is found. 654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekclass BoundNodes { 664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekpublic: 6725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek /// \brief Returns the AST node bound to \c ID. 68a78d0d6203a990b88c9c3e4c4f2a277001e8bd46Manuel Klimek /// 6925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek /// Returns NULL if there was no node bound to \c ID or if there is a node but 704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek /// it cannot be converted to the specified type. 71ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek template <typename T> 72a78d0d6203a990b88c9c3e4c4f2a277001e8bd46Manuel Klimek const T *getNodeAs(StringRef ID) const { 73ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek return MyBoundNodes.getNodeAs<T>(ID); 74ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek } 75ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek 76ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek /// \brief Deprecated. Please use \c getNodeAs instead. 774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek /// @{ 784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek template <typename T> 794da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek const T *getDeclAs(StringRef ID) const { 80a78d0d6203a990b88c9c3e4c4f2a277001e8bd46Manuel Klimek return getNodeAs<T>(ID); 814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek template <typename T> 834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek const T *getStmtAs(StringRef ID) const { 84a78d0d6203a990b88c9c3e4c4f2a277001e8bd46Manuel Klimek return getNodeAs<T>(ID); 854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek /// @} 874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekprivate: 894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek /// \brief Create BoundNodes from a pre-filled map of bindings. 90ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek BoundNodes(internal::BoundNodesMap &MyBoundNodes) 91ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek : MyBoundNodes(MyBoundNodes) {} 924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 93ec2a396c6f11b4017e30f1865f7b62c5a42425b8Manuel Klimek internal::BoundNodesMap MyBoundNodes; 944da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek friend class internal::BoundNodesTree; 964da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek}; 974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 9825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \brief If the provided matcher matches a node, binds the node to \c ID. 994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 10025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// FIXME: Do we want to support this now that we have bind()? 1014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimektemplate <typename T> 1024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekinternal::Matcher<T> id(const std::string &ID, 1039f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek const internal::BindableMatcher<T> &InnerMatcher) { 1049f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek return InnerMatcher.bind(ID); 1054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 1064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Types of matchers for the top-level classes in the AST class 1084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// hierarchy. 1094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// @{ 110e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jaspertypedef internal::Matcher<Decl> DeclarationMatcher; 111e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jaspertypedef internal::Matcher<Stmt> StatementMatcher; 112ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jaspertypedef internal::Matcher<QualType> TypeMatcher; 113ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jaspertypedef internal::Matcher<TypeLoc> TypeLocMatcher; 114a7564433191601cb8851196b8dde39392c9c05eeDaniel Jaspertypedef internal::Matcher<NestedNameSpecifier> NestedNameSpecifierMatcher; 115a7564433191601cb8851196b8dde39392c9c05eeDaniel Jaspertypedef internal::Matcher<NestedNameSpecifierLoc> NestedNameSpecifierLocMatcher; 1164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// @} 1174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches any node. 1194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 1204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Useful when another matcher requires a child matcher, but there's no 1214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// additional constraint. This will often be used with an explicit conversion 12225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// to an \c internal::Matcher<> type such as \c TypeMatcher. 1234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 12425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Example: \c DeclarationMatcher(anything()) matches all declarations, e.g., 12525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// "int* p" and "void f()" in 1274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int* p; 1284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f(); 12925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 13025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 13125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 1324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekinline internal::PolymorphicMatcherWithParam0<internal::TrueMatcher> anything() { 1334da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::PolymorphicMatcherWithParam0<internal::TrueMatcher>(); 1344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 1354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 136715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// \brief Matches declarations. 137715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// 138715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// Examples matches \c X, \c C, and the friend declaration inside \c C; 139715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// \code 140715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// void X(); 141715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// class C { 142715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// friend X; 143715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// }; 144715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// \endcode 145715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimekconst internal::VariadicDynCastAllOfMatcher<Decl, Decl> decl; 146715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek 1474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a declaration of anything that could have a name. 1484da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 14925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Example matches \c X, \c S, the anonymous union type, \c i, and \c U; 15025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// typedef int X; 1524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct S { 1534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// union { 1544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int i; 1554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// } U; 1564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 15725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1582dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, NamedDecl> namedDecl; 1594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches C++ class declarations. 1614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Example matches \c X, \c Z 16325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X; 1654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// template<class T> class Z {}; 16625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 168e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Decl, 1692dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXRecordDecl> recordDecl; 170e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 1718456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// \brief Matches C++ class template declarations. 1728456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// 17325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Example matches \c Z 17425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1758456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// template<class T> class Z {}; 17625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1778456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenkoconst internal::VariadicDynCastAllOfMatcher< 1788456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko Decl, 1792dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper ClassTemplateDecl> classTemplateDecl; 1808456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko 181e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches C++ class template specializations. 182e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 183e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 18425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 185e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// template<typename T> class A {}; 186e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// template<> class A<double> {}; 187e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A<int> a; 18825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1892dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// classTemplateSpecializationDecl() 190e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches the specializations \c A<int> and \c A<double> 191e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher< 192e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Decl, 1932dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper ClassTemplateSpecializationDecl> classTemplateSpecializationDecl; 194e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 195e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches classTemplateSpecializations that have at least one 19625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// TemplateArgument matching the given InnerMatcher. 197e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 198e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 19925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 200e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// template<typename T> class A {}; 201e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// template<> class A<double> {}; 202e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A<int> a; 20325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2042dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// classTemplateSpecializationDecl(hasAnyTemplateArgument( 205e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// refersToType(asString("int")))) 206e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches the specialization \c A<int> 207e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(ClassTemplateSpecializationDecl, hasAnyTemplateArgument, 20825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<TemplateArgument>, InnerMatcher) { 209e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const TemplateArgumentList &List = Node.getTemplateArgs(); 210e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper for (unsigned i = 0; i < List.size(); ++i) { 21125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek if (InnerMatcher.matches(List.get(i), Finder, Builder)) 212e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return true; 213e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper } 214e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return false; 215e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 216e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 217089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// \brief Matches expressions that match InnerMatcher after any implicit casts 218089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// are stripped off. 219089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// 220089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// Parentheses and explicit casts are not discarded. 221089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// Given 22225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 223089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int arr[5]; 224089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int a = 0; 225089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// char b = 0; 226089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// const int c = a; 227089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int *d = arr; 228089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// long e = (long) 0l; 22925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 230089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// The matchers 23125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2322dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(ignoringImpCasts(integerLiteral()))) 2332dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(ignoringImpCasts(declRefExpr()))) 23425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 235089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// would match the declarations for a, b, c, and d, but not e. 23625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// While 23725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2382dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(integerLiteral())) 2392dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(declRefExpr())) 24025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 241089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// only match the declarations for b, c, and d. 242089e5b3bf2e57da0173b170ad501867b43395385Sam PanzerAST_MATCHER_P(Expr, ignoringImpCasts, 243089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer internal::Matcher<Expr>, InnerMatcher) { 244089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer return InnerMatcher.matches(*Node.IgnoreImpCasts(), Finder, Builder); 245089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer} 246089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer 247089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// \brief Matches expressions that match InnerMatcher after parentheses and 248089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// casts are stripped off. 249089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// 250089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// Implicit and non-C Style casts are also discarded. 251089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// Given 25225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 253089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int a = 0; 254089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// char b = (0); 255089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// void* c = reinterpret_cast<char*>(0); 256089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// char d = char(0); 25725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 258089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// The matcher 2592dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(ignoringParenCasts(integerLiteral()))) 260089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// would match the declarations for a, b, c, and d. 261089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// while 2622dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(integerLiteral())) 263089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// only match the declaration for a. 264089e5b3bf2e57da0173b170ad501867b43395385Sam PanzerAST_MATCHER_P(Expr, ignoringParenCasts, internal::Matcher<Expr>, InnerMatcher) { 265089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer return InnerMatcher.matches(*Node.IgnoreParenCasts(), Finder, Builder); 266089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer} 267089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer 268089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// \brief Matches expressions that match InnerMatcher after implicit casts and 269089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// parentheses are stripped off. 270089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// 271089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// Explicit casts are not discarded. 272089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// Given 27325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 274089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int arr[5]; 275089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int a = 0; 276089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// char b = (0); 277089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// const int c = a; 278089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int *d = (arr); 279089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// long e = ((long) 0l); 28025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 281089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// The matchers 2822dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(ignoringParenImpCasts(integerLiteral()))) 2832dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(ignoringParenImpCasts(declRefExpr()))) 284089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// would match the declarations for a, b, c, and d, but not e. 285089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// while 2862dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(integerLiteral())) 2872dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// varDecl(hasInitializer(declRefExpr())) 288089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// would only match the declaration for a. 289089e5b3bf2e57da0173b170ad501867b43395385Sam PanzerAST_MATCHER_P(Expr, ignoringParenImpCasts, 290089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer internal::Matcher<Expr>, InnerMatcher) { 291089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer return InnerMatcher.matches(*Node.IgnoreParenImpCasts(), Finder, Builder); 292089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer} 293089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer 294e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches classTemplateSpecializations where the n'th TemplateArgument 29525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// matches the given InnerMatcher. 296e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 297e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 29825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 299e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// template<typename T, typename U> class A {}; 300e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A<bool, int> b; 301e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A<int, bool> c; 30225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 3032dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// classTemplateSpecializationDecl(hasTemplateArgument( 304e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1, refersToType(asString("int")))) 305e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches the specialization \c A<bool, int> 306e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P2(ClassTemplateSpecializationDecl, hasTemplateArgument, 30725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek unsigned, N, internal::Matcher<TemplateArgument>, InnerMatcher) { 308e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const TemplateArgumentList &List = Node.getTemplateArgs(); 309e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper if (List.size() <= N) 310e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return false; 31125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek return InnerMatcher.matches(List.get(N), Finder, Builder); 312e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 313e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 314e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches a TemplateArgument that refers to a certain type. 315e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 316e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 31725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 318e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// struct X {}; 319e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// template<typename T> struct A {}; 320e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A<X> a; 32125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 3222dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// classTemplateSpecializationDecl(hasAnyTemplateArgument( 323e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// refersToType(class(hasName("X"))))) 324e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches the specialization \c A<X> 325e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(TemplateArgument, refersToType, 32625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<QualType>, InnerMatcher) { 327e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper if (Node.getKind() != TemplateArgument::Type) 328e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return false; 32925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek return InnerMatcher.matches(Node.getAsType(), Finder, Builder); 330e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 331e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 332e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches a TemplateArgument that refers to a certain declaration. 333e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 334e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 33525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 336e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// template<typename T> struct A {}; 337e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// struct B { B* next; }; 338e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A<&B::next> a; 33925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 3402dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// classTemplateSpecializationDecl(hasAnyTemplateArgument( 3412dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// refersToDeclaration(fieldDecl(hasName("next")))) 3422dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// matches the specialization \c A<&B::next> with \c fieldDecl(...) matching 343e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \c B::next 344e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(TemplateArgument, refersToDeclaration, 34525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<Decl>, InnerMatcher) { 346aaa8e45b8e392a1f1b7498e2f00c6ed66d41119aDaniel Jasper if (Node.getKind() == TemplateArgument::Declaration) 347aaa8e45b8e392a1f1b7498e2f00c6ed66d41119aDaniel Jasper return InnerMatcher.matches(*Node.getAsDecl(), Finder, Builder); 348e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return false; 349e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 3504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 3514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches C++ constructor declarations. 3524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 3534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches Foo::Foo() and Foo::Foo(int) 35425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 3554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Foo { 3564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// public: 3574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo(); 3584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo(int); 3594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int DoSomething(); 3604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 36125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 3624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 363e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Decl, 3642dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXConstructorDecl> constructorDecl; 365e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 366e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches explicit C++ destructor declarations. 367e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 368e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Example matches Foo::~Foo() 36925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 370e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// class Foo { 371e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// public: 372e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// virtual ~Foo(); 373e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// }; 37425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 3752dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher< 3762dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper Decl, 3772dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXDestructorDecl> destructorDecl; 378e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 379e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches enum declarations. 380e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 381e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Example matches X 38225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 383e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// enum X { 384e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A, B, C 385e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// }; 38625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 387e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, EnumDecl> enumDecl; 388e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 389e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches enum constants. 390e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 391e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Example matches A, B, C 39225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 393e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// enum X { 394e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// A, B, C 395e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// }; 39625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 397e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher< 398e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Decl, 3992dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper EnumConstantDecl> enumConstantDecl; 4004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 4014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches method declarations. 4024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 4034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches y 40425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 4054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X { void y() }; 40625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 4072dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, CXXMethodDecl> methodDecl; 4084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 4094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches variable declarations. 4104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 4114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Note: this does not match declarations of member variables, which are 4124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// "field" declarations in Clang parlance. 4134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 4144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches a 41525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 4164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int a; 41725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 4182dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, VarDecl> varDecl; 4194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 4204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches field declarations. 4214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 4224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 42325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 4244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X { int m; }; 42525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 4262dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// fieldDecl() 4274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'm'. 4282dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, FieldDecl> fieldDecl; 4294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 4304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches function declarations. 4314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 4324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches f 43325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 4344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f(); 43525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 4362dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, FunctionDecl> functionDecl; 4374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 4388456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// \brief Matches C++ function template declarations. 4398456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// 4408456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// Example matches f 44125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 4428456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// template<class T> void f(T t) {} 44325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 4448456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenkoconst internal::VariadicDynCastAllOfMatcher< 4458456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko Decl, 4462dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper FunctionTemplateDecl> functionTemplateDecl; 4474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 4484da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches statements. 4494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 4504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 45125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 4524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// { ++a; } 45325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 4542dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// stmt() 4554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches both the compound statement '{ ++a; }' and '++a'. 4562dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, Stmt> stmt; 4574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 4584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches declaration statements. 4594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 4604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 46125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 4624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int a; 46325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 4642dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// declStmt() 4654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'int a'. 4664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 467e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 4682dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper DeclStmt> declStmt; 4694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 4704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches member expressions. 4714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 4724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 47325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 4744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { 4754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void x() { this->x(); x(); Y y; y.x(); a; this->b; Y::b; } 4764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int a; static int b; 4774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 47825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 4792dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// memberExpr() 4804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches this->x, x, y.x, a, this->b 4812dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, MemberExpr> memberExpr; 4824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 4834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches call expressions. 4844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 4859f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek/// Example matches x.y() and y() 48625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 4874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// X x; 4884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// x.y(); 4899f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek/// y(); 49025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 4912dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CallExpr> callExpr; 492e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 49331f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// \brief Matches lambda expressions. 49431f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// 49531f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// Example matches [&](){return 5;} 49631f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// \code 49731f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// [&](){return 5;} 49831f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// \endcode 49931f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, LambdaExpr> lambdaExpr; 50031f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper 5019f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek/// \brief Matches member call expressions. 5029f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek/// 5039f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek/// Example matches x.y() 50425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 5059f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek/// X x; 5069f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek/// x.y(); 50725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 5082dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher< 5092dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper Stmt, 5102dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXMemberCallExpr> memberCallExpr; 5119f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimek 512e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches init list expressions. 513e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 514e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 51525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 516e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int a[] = { 1, 2 }; 517e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// struct B { int x, y; }; 518e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// B b = { 5, 6 }; 51925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 520e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// initList() 521e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches "{ 1, 2 }" and "{ 5, 6 }" 522e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, InitListExpr> initListExpr; 523e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 524e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches using declarations. 525e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 526e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 52725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 528e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// namespace X { int x; } 529e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// using X::x; 53025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 531e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// usingDecl() 532e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \code using X::x \endcode 533e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher<Decl, UsingDecl> usingDecl; 5344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 5354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches constructor call expressions (including implicit ones). 5364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 5374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches string(ptr, n) and ptr within arguments of f 5382dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = constructExpr()) 53925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 5404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f(const string &a, const string &b); 5414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// char *ptr; 5424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int n; 5434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// f(string(ptr, n), ptr); 54425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 5454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 546e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 5472dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXConstructExpr> constructExpr; 5484da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 54970b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// \brief Matches implicit and explicit this expressions. 55070b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// 55170b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// Example matches the implicit this expression in "return i". 55270b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// (matcher = thisExpr()) 55370b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// \code 55470b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// struct foo { 55570b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// int i; 55670b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// int f() { return i; } 55770b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// }; 55870b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek/// \endcode 55970b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimekconst internal::VariadicDynCastAllOfMatcher<Stmt, CXXThisExpr> thisExpr; 56070b9db9879c1cb8b8ca7d6c9809e35361cab83dcManuel Klimek 5614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches nodes where temporaries are created. 5624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 5634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches FunctionTakesString(GetStringByValue()) 5642dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = bindTemporaryExpr()) 56525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 5664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// FunctionTakesString(GetStringByValue()); 5674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// FunctionTakesStringByPointer(GetStringPointer()); 56825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 5694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 570e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 5712dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXBindTemporaryExpr> bindTemporaryExpr; 5724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 573e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// \brief Matches nodes where temporaries are materialized. 574e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// 575e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// Example: Given 576e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// \code 577e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// struct T {void func()}; 578e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// T f(); 579e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// void g(T); 580e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// \endcode 581e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// materializeTemporaryExpr() matches 'f()' in these statements 582e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// \code 583e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// T u(f()); 584e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// g(f()); 585e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// \endcode 586e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// but does not match 587e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// \code 588e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// f(); 589e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// f().func(); 590e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer/// \endcode 591e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzerconst internal::VariadicDynCastAllOfMatcher< 592e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer Stmt, 593e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer MaterializeTemporaryExpr> materializeTemporaryExpr; 594e16acd3817e501ee2bcf5f631b6911021fa88ba7Sam Panzer 5954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches new expressions. 5964da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 5974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 59825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 5994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// new X; 60025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 6012dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// newExpr() 6024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'new X'. 6032dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CXXNewExpr> newExpr; 604e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 605e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches delete expressions. 606e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 607e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 60825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 609e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// delete X; 61025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 6112dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// deleteExpr() 612e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches 'delete X'. 6132dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CXXDeleteExpr> deleteExpr; 614e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 615e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches array subscript expressions. 616e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 617e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 61825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 619e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int i = a[1]; 62025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 621e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// arraySubscriptExpr() 622e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches "a[1]" 623e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher< 624e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 625e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper ArraySubscriptExpr> arraySubscriptExpr; 6264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 6274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the value of a default argument at the call site. 6284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches the CXXDefaultArgExpr placeholder inserted for the 6304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// default value of the second parameter in the call expression f(42) 6312dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = defaultArgExpr()) 63225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 6334da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f(int x, int y = 0); 6344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// f(42); 63525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 6364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 637e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 6382dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXDefaultArgExpr> defaultArgExpr; 6394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 6404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches overloaded operator calls. 6414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Note that if an operator isn't overloaded, it won't match. Instead, use 6434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// binaryOperator matcher. 6444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Currently it does not match operators such as new delete. 6454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// FIXME: figure out why these do not match? 6464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches both operator<<((o << b), c) and operator<<(o, b) 6482dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = operatorCallExpr()) 64925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 6504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// ostream &operator<< (ostream &out, int i) { }; 6514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// ostream &o; int b = 1, c = 1; 6524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// o << b << c; 65325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 6544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 655e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 6562dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXOperatorCallExpr> operatorCallExpr; 6574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 6584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches expressions. 6594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches x() 66125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 6624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f() { x(); } 66325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 6642dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, Expr> expr; 6654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 6664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches expressions that refer to declarations. 6674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches x in if (x) 66925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 6704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// bool x; 6714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// if (x) {} 67225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 6732dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, DeclRefExpr> declRefExpr; 6744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 6754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if statements. 6764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches 'if (x) {}' 67825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 6794da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// if (x) {} 68025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 681e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, IfStmt> ifStmt; 6824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 6834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches for statements. 6844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 6854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches 'for (;;) {}' 68625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 6874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// for (;;) {} 68831f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// int i[] = {1, 2, 3}; for (auto a : i); 68925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 6902dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, ForStmt> forStmt; 6914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 69231f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// \brief Matches range-based for statements. 69331f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// 69431f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// forRangeStmt() matches 'for (auto a : i)' 69531f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// \code 69631f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// int i[] = {1, 2, 3}; for (auto a : i); 69731f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// for(int j = 0; j < 5; ++j); 69831f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// \endcode 69931f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CXXForRangeStmt> forRangeStmt; 70031f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper 7016a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// \brief Matches the increment statement of a for loop. 7026a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// 7036a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// Example: 7046a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// forStmt(hasIncrement(unaryOperator(hasOperatorName("++")))) 7056a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// matches '++x' in 70625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 7076a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// for (x; x < N; ++x) { } 70825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 7096a12449ec8862211856447d3df4c082a346339f2Daniel JasperAST_MATCHER_P(ForStmt, hasIncrement, internal::Matcher<Stmt>, 7106a12449ec8862211856447d3df4c082a346339f2Daniel Jasper InnerMatcher) { 7116a12449ec8862211856447d3df4c082a346339f2Daniel Jasper const Stmt *const Increment = Node.getInc(); 7126a12449ec8862211856447d3df4c082a346339f2Daniel Jasper return (Increment != NULL && 7136a12449ec8862211856447d3df4c082a346339f2Daniel Jasper InnerMatcher.matches(*Increment, Finder, Builder)); 7146a12449ec8862211856447d3df4c082a346339f2Daniel Jasper} 7156a12449ec8862211856447d3df4c082a346339f2Daniel Jasper 7166a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// \brief Matches the initialization statement of a for loop. 7176a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// 7186a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// Example: 7192dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// forStmt(hasLoopInit(declStmt())) 7206a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// matches 'int x = 0' in 72125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 7226a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// for (int x = 0; x < N; ++x) { } 72325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 7246a12449ec8862211856447d3df4c082a346339f2Daniel JasperAST_MATCHER_P(ForStmt, hasLoopInit, internal::Matcher<Stmt>, 7256a12449ec8862211856447d3df4c082a346339f2Daniel Jasper InnerMatcher) { 7266a12449ec8862211856447d3df4c082a346339f2Daniel Jasper const Stmt *const Init = Node.getInit(); 7276a12449ec8862211856447d3df4c082a346339f2Daniel Jasper return (Init != NULL && InnerMatcher.matches(*Init, Finder, Builder)); 7286a12449ec8862211856447d3df4c082a346339f2Daniel Jasper} 7296a12449ec8862211856447d3df4c082a346339f2Daniel Jasper 7304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches while statements. 7314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 7324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 73325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 7344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// while (true) {} 73525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 7364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// whileStmt() 7374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'while (true) {}'. 7382dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, WhileStmt> whileStmt; 7394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 7404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches do statements. 7414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 7424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 74325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 7444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// do {} while (true); 74525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 7464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// doStmt() 7474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'do {} while(true)' 748e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, DoStmt> doStmt; 7494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 750b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches break statements. 751b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 752b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// Given 753b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 754b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// while (true) { break; } 755b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 756b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// breakStmt() 757b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'break' 758b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, BreakStmt> breakStmt; 759b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 760b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches continue statements. 761b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 762b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// Given 763b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 764b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// while (true) { continue; } 765b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 766b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// continueStmt() 767b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'continue' 768b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, ContinueStmt> continueStmt; 769b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 770b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches return statements. 771b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 772b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// Given 773b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 774b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// return 1; 775b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 776b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// returnStmt() 777b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'return 1' 778b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, ReturnStmt> returnStmt; 779b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 780b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches goto statements. 781b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 782b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// Given 783b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 784b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// goto FOO; 785b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// FOO: bar(); 786b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 787b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// gotoStmt() 788b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'goto FOO' 789b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, GotoStmt> gotoStmt; 790b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 791b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches label statements. 792b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 793b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// Given 794b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 795b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// goto FOO; 796b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// FOO: bar(); 797b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 798b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// labelStmt() 799b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'FOO:' 800b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, LabelStmt> labelStmt; 801b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 802b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches switch statements. 803b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 804b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// Given 805b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 806b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// switch(a) { case 42: break; default: break; } 807b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 808b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// switchStmt() 809b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'switch(a)'. 810b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, SwitchStmt> switchStmt; 811b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 8124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches case and default statements inside switch statements. 8134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 8144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 81525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 8164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// switch(a) { case 42: break; default: break; } 81725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 8184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// switchCase() 8194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'case 42: break;' and 'default: break;'. 8202dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, SwitchCase> switchCase; 8214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 8224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches compound statements. 8234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 8244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches '{}' and '{{}}'in 'for (;;) {{}}' 82525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 8264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// for (;;) {{}} 82725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 8282dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CompoundStmt> compoundStmt; 8294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 830b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches catch statements. 831b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 832b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 833b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// try {} catch(int i) {} 834b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 835b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// catchStmt() 836b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'catch(int i)' 837b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CXXCatchStmt> catchStmt; 838b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 839b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches try statements. 840b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 841b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 842b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// try {} catch(int i) {} 843b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 844b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// tryStmt() 845b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'try {}' 846b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CXXTryStmt> tryStmt; 847b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 848b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches throw expressions. 849b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 850b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 851b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// try { throw 5; } catch(int i) {} 852b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 853b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// throwExpr() 854b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches 'throw 5' 855b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CXXThrowExpr> throwExpr; 856b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 857b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches null statements. 858b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 859b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 860b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// foo();; 861b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 862b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// nullStmt() 863b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches the second ';' 864b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, NullStmt> nullStmt; 865b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 866b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \brief Matches asm statements. 867b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// 868b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \code 869b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// int i = 100; 870b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// __asm("mov al, 2"); 871b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// \endcode 872b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// asmStmt() 873b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper/// matches '__asm("mov al, 2")' 874b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, AsmStmt> asmStmt; 875b54b7646b2d00a85d80e40adf7c49553f150c736Daniel Jasper 8764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches bool literals. 8774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 8784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches true 87925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 8804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// true 88125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 8824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 8833680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 884e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper CXXBoolLiteralExpr> boolLiteral; 8854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 8864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches string literals (also matches wide string literals). 8874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 8884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches "abcd", L"abcd" 88925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 8904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// char *s = "abcd"; wchar_t *ws = L"abcd" 89125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 8924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 8933680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 894e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper StringLiteral> stringLiteral; 8954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 8964da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches character literals (also matches wchar_t). 8974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 8984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Not matching Hex-encoded chars (e.g. 0x1234, which is a IntegerLiteral), 8994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// though. 9004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 9014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches 'a', L'a' 90225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 9034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// char ch = 'a'; wchar_t chw = L'a'; 90425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 9054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 9063680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 907e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper CharacterLiteral> characterLiteral; 9084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 9094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches integer literals of all sizes / encodings. 9104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 9114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Not matching character-encoded integers such as L'a'. 9124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 9134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches 1, 1L, 0x1, 1U 9144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 9153680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 916e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper IntegerLiteral> integerLiteral; 9174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 91831f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// \brief Matches user defined literal operator call. 91931f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// 92031f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// Example match: "foo"_suffix 92131f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasperconst internal::VariadicDynCastAllOfMatcher< 92231f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper Stmt, 92331f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper UserDefinedLiteral> userDefinedLiteral; 92431f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper 925afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith/// \brief Matches compound (i.e. non-scalar) literals 926afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith/// 927afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith/// Example match: {1}, (1, 2) 928afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith/// \code 929afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith/// int array[4] = {1}; vector int myvec = (vector int)(1, 2); 930afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith/// \endcode 931afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smithconst internal::VariadicDynCastAllOfMatcher< 932afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith Stmt, 933afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith CompoundLiteralExpr> compoundLiteralExpr; 934afbcab8d10d4208c7ad8da79e948432117d4a326Richard Smith 93531f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper/// \brief Matches nullptr literal. 93631f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasperconst internal::VariadicDynCastAllOfMatcher< 93731f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper Stmt, 93831f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper CXXNullPtrLiteralExpr> nullPtrLiteralExpr; 93931f7c08a0d2b140bf31a08894d1948649de53c15Daniel Jasper 9404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches binary operator expressions. 9414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 9424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches a || b 94325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 9444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// !(a || b) 94525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 9464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 947e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 948e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper BinaryOperator> binaryOperator; 9494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 9504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches unary operator expressions. 9514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 9524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches !a 95325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 9544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// !a || b 95525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 9564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 957e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 958e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper UnaryOperator> unaryOperator; 9594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 9604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches conditional operator expressions. 9614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 9624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches a ? b : c 96325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 9644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// (a ? b : c) + 42 96525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 9664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 967e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 968e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper ConditionalOperator> conditionalOperator; 9694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 9704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a reinterpret_cast expression. 9714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 9724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Either the source expression or the destination type can be matched 9734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// using has(), but hasDestinationType() is more specific and can be 9744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// more readable. 9754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 9764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches reinterpret_cast<char*>(&p) in 97725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 9784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void* p = reinterpret_cast<char*>(&p); 97925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 9804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 9813680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 9822dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXReinterpretCastExpr> reinterpretCastExpr; 9834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 9844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a C++ static_cast expression. 9854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 9864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \see hasDestinationType 9874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \see reinterpretCast 9884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 9894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example: 9902dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// staticCastExpr() 9914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 9924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// static_cast<long>(8) 9934da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// in 99425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 9954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// long eight(static_cast<long>(8)); 99625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 9974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 9983680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 9992dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXStaticCastExpr> staticCastExpr; 10004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 10014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a dynamic_cast expression. 10024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 10034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example: 10042dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// dynamicCastExpr() 10054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 10064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// dynamic_cast<D*>(&b); 10074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// in 100825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 10094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct B { virtual ~B() {} }; struct D : B {}; 10104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// B b; 10114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// D* p = dynamic_cast<D*>(&b); 101225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 10134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 10143680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 10152dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXDynamicCastExpr> dynamicCastExpr; 10164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 10174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a const_cast expression. 10184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 10194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example: Matches const_cast<int*>(&r) in 102025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 10214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int n = 42; 102225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// const int &r(n); 10234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int* p = const_cast<int*>(&r); 102425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 10254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 10263680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 10272dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXConstCastExpr> constCastExpr; 10284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1029e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper/// \brief Matches a C-style cast expression. 1030e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper/// 1031e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper/// Example: Matches (int*) 2.2f in 1032e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper/// \code 1033e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper/// int i = (int) 2.2f; 1034e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper/// \endcode 1035e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasperconst internal::VariadicDynCastAllOfMatcher< 1036e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper Stmt, 1037e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper CStyleCastExpr> cStyleCastExpr; 1038e6d2a96cc9689be584c3bfc09ac527a03a25b3bcDaniel Jasper 10394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches explicit cast expressions. 10404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 10414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Matches any cast expression written in user code, whether it be a 10424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// C-style cast, a functional-style cast, or a keyword cast. 10434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 10444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Does not match implicit conversions. 10454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 10464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Note: the name "explicitCast" is chosen to match Clang's terminology, as 10474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Clang uses the term "cast" to apply to implicit conversions as well as to 10484da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// actual cast expressions. 10494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 10504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \see hasDestinationType. 10514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 10524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example: matches all five of the casts in 105325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 10544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int((int)(reinterpret_cast<int>(static_cast<int>(const_cast<int>(42))))) 105525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 10564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// but does not match the implicit conversion in 105725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 10584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// long ell = 42; 105925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 10604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 10613680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 10622dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper ExplicitCastExpr> explicitCastExpr; 10634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 10644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the implicit cast nodes of Clang's AST. 10654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 10664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// This matches many different places, including function call return value 10674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// eliding, as well as any type conversions. 10684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 10693680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 10702dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper ImplicitCastExpr> implicitCastExpr; 10714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1072089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// \brief Matches any cast nodes of Clang's AST. 1073089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// 1074089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// Example: castExpr() matches each of the following: 107525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1076089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// (int) 3; 1077089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// const_cast<Expr *>(SubExpr); 1078089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// char c = 0; 107925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1080089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// but does not match 108125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1082089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int i = (0); 1083089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer/// int k = 0; 108425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 10853680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasperconst internal::VariadicDynCastAllOfMatcher<Stmt, CastExpr> castExpr; 1086089e5b3bf2e57da0173b170ad501867b43395385Sam Panzer 10874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches functional cast expressions 10884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 10894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example: Matches Foo(bar); 109025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 10914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo f = bar; 10924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo g = (Foo) bar; 10934da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo h = Foo(bar); 109425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 10954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekconst internal::VariadicDynCastAllOfMatcher< 10963680b4f7494b6744b9c5a25f83b63cd8b7e434fcDaniel Jasper Stmt, 10972dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper CXXFunctionalCastExpr> functionalCastExpr; 10984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1099a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// \brief Matches \c QualTypes in the clang AST. 1100a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasperconst internal::VariadicAllOfMatcher<QualType> qualType; 1101a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper 1102a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// \brief Matches \c Types in the clang AST. 1103a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<Type, Type> type; 1104a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper 1105a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// \brief Matches \c TypeLocs in the clang AST. 1106a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasperconst internal::VariadicDynCastAllOfMatcher<TypeLoc, TypeLoc> typeLoc; 1107a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper 11087387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// \brief Matches if any of the given matchers matches. 11097387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// 11107387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// Unlike \c anyOf, \c eachOf will generate a match result for each 11117387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// matching submatcher. 11127387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// 11137387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// For example, in: 11147387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// \code 11157387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// class A { int a; int b; }; 11167387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// \endcode 11177387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// The matcher: 11187387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// \code 11197387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// recordDecl(eachOf(has(fieldDecl(hasName("a")).bind("v")), 11207387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// has(fieldDecl(hasName("b")).bind("v")))) 11217387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// \endcode 11227387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// will generate two results binding "v", the first of which binds 11237387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// the field declaration of \c a, the second the field declaration of 11247387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// \c b. 11257387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// 11267387673f83b8b37f660422947c9990778ba88193Manuel Klimek/// Usable as: Any Matcher 11277387673f83b8b37f660422947c9990778ba88193Manuel Klimektemplate <typename M1, typename M2> 11287387673f83b8b37f660422947c9990778ba88193Manuel Klimekinternal::PolymorphicMatcherWithParam2<internal::EachOfMatcher, M1, M2> 11297387673f83b8b37f660422947c9990778ba88193Manuel KlimekeachOf(const M1 &P1, const M2 &P2) { 11307387673f83b8b37f660422947c9990778ba88193Manuel Klimek return internal::PolymorphicMatcherWithParam2<internal::EachOfMatcher, M1, 11317387673f83b8b37f660422947c9990778ba88193Manuel Klimek M2>(P1, P2); 11327387673f83b8b37f660422947c9990778ba88193Manuel Klimek} 11337387673f83b8b37f660422947c9990778ba88193Manuel Klimek 11344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Various overloads for the anyOf matcher. 11354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// @{ 113625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek 113725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \brief Matches if any of the given matchers matches. 113825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 113925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 114025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimektemplate<typename M1, typename M2> 114125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimekinternal::PolymorphicMatcherWithParam2<internal::AnyOfMatcher, M1, M2> 114225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel KlimekanyOf(const M1 &P1, const M2 &P2) { 11434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::PolymorphicMatcherWithParam2<internal::AnyOfMatcher, 114425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek M1, M2 >(P1, P2); 11454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 114625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimektemplate<typename M1, typename M2, typename M3> 114725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimekinternal::PolymorphicMatcherWithParam2<internal::AnyOfMatcher, M1, 114825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::PolymorphicMatcherWithParam2<internal::AnyOfMatcher, M2, M3> > 114925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel KlimekanyOf(const M1 &P1, const M2 &P2, const M3 &P3) { 11504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return anyOf(P1, anyOf(P2, P3)); 11514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 115225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimektemplate<typename M1, typename M2, typename M3, typename M4> 115325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimekinternal::PolymorphicMatcherWithParam2<internal::AnyOfMatcher, M1, 115425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::PolymorphicMatcherWithParam2<internal::AnyOfMatcher, M2, 11554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek internal::PolymorphicMatcherWithParam2<internal::AnyOfMatcher, 115625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek M3, M4> > > 115725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel KlimekanyOf(const M1 &P1, const M2 &P2, const M3 &P3, const M4 &P4) { 1158ff2fcb8db242a54f72bbb4e5595261e12672ed66Daniel Jasper return anyOf(P1, anyOf(P2, anyOf(P3, P4))); 11594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 116025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimektemplate<typename M1, typename M2, typename M3, typename M4, typename M5> 116125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimekinternal::PolymorphicMatcherWithParam2<internal::AnyOfMatcher, M1, 116225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::PolymorphicMatcherWithParam2<internal::AnyOfMatcher, M2, 116325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::PolymorphicMatcherWithParam2<internal::AnyOfMatcher, M3, 11644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek internal::PolymorphicMatcherWithParam2<internal::AnyOfMatcher, 116525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek M4, M5> > > > 116625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel KlimekanyOf(const M1 &P1, const M2 &P2, const M3 &P3, const M4 &P4, const M5 &P5) { 11674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return anyOf(P1, anyOf(P2, anyOf(P3, anyOf(P4, P5)))); 11684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 116925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek 11704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// @} 11714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 11724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Various overloads for the allOf matcher. 11734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// @{ 117425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek 117525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \brief Matches if all given matchers match. 117625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 117725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 117825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimektemplate<typename M1, typename M2> 117925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimekinternal::PolymorphicMatcherWithParam2<internal::AllOfMatcher, M1, M2> 118025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel KlimekallOf(const M1 &P1, const M2 &P2) { 11814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::PolymorphicMatcherWithParam2<internal::AllOfMatcher, 118225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek M1, M2>(P1, P2); 11834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 118425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimektemplate<typename M1, typename M2, typename M3> 118525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimekinternal::PolymorphicMatcherWithParam2<internal::AllOfMatcher, M1, 118625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::PolymorphicMatcherWithParam2<internal::AllOfMatcher, M2, M3> > 118725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel KlimekallOf(const M1 &P1, const M2 &P2, const M3 &P3) { 11886a12449ec8862211856447d3df4c082a346339f2Daniel Jasper return allOf(P1, allOf(P2, P3)); 11894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 119025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek 11914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// @} 11924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1193e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches sizeof (C99), alignof (C++11) and vec_step (OpenCL) 1194e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1195e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 119625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1197e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Foo x = bar; 1198e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int y = sizeof(x) + alignof(x); 119925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1200e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// unaryExprOrTypeTraitExpr() 1201e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \c sizeof(x) and \c alignof(x) 1202e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperconst internal::VariadicDynCastAllOfMatcher< 1203e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Stmt, 1204e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper UnaryExprOrTypeTraitExpr> unaryExprOrTypeTraitExpr; 1205e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 1206e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches unary expressions that have a specific type of argument. 1207e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1208e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 120925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1210e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int a, c; float b; int s = sizeof(a) + sizeof(b) + alignof(c); 121125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1212e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// unaryExprOrTypeTraitExpr(hasArgumentOfType(asString("int")) 1213e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \c sizeof(a) and \c alignof(c) 1214e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(UnaryExprOrTypeTraitExpr, hasArgumentOfType, 121525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<QualType>, InnerMatcher) { 1216e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const QualType ArgumentType = Node.getTypeOfArgument(); 121725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek return InnerMatcher.matches(ArgumentType, Finder, Builder); 1218e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 1219e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 1220e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches unary expressions of a certain kind. 1221e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1222e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 122325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1224e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int x; 1225e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int s = sizeof(x) + alignof(x) 122625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1227e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// unaryExprOrTypeTraitExpr(ofKind(UETT_SizeOf)) 1228e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \c sizeof(x) 1229e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(UnaryExprOrTypeTraitExpr, ofKind, UnaryExprOrTypeTrait, Kind) { 1230e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return Node.getKind() == Kind; 1231e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 1232e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 1233e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Same as unaryExprOrTypeTraitExpr, but only matching 1234e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// alignof. 1235e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperinline internal::Matcher<Stmt> alignOfExpr( 123625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek const internal::Matcher<UnaryExprOrTypeTraitExpr> &InnerMatcher) { 1237e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return internal::Matcher<Stmt>(unaryExprOrTypeTraitExpr(allOf( 123825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek ofKind(UETT_AlignOf), InnerMatcher))); 1239e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 1240e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 1241e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Same as unaryExprOrTypeTraitExpr, but only matching 1242e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// sizeof. 1243e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperinline internal::Matcher<Stmt> sizeOfExpr( 124425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek const internal::Matcher<UnaryExprOrTypeTraitExpr> &InnerMatcher) { 1245e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return internal::Matcher<Stmt>(unaryExprOrTypeTraitExpr(allOf( 124625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek ofKind(UETT_SizeOf), InnerMatcher))); 1247e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 1248e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 12494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches NamedDecl nodes that have the specified name. 12504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 12514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Supports specifying enclosing namespaces or classes by prefixing the name 12524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with '<enclosing>::'. 12534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Does not match typedefs of an underlying type with the given name. 12544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 12554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches X (Name == "X") 125625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 12574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X; 125825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 12594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 12604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches X (Name is one of "::a::b::X", "a::b::X", "b::X", "X") 126125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 126225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// namespace a { namespace b { class X; } } 126325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1264e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(NamedDecl, hasName, std::string, Name) { 12654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek assert(!Name.empty()); 12664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek const std::string FullNameString = "::" + Node.getQualifiedNameAsString(); 1267cfa88f893915ceb8ae4ce2f17c46c24a4d67502fDmitri Gribenko const StringRef FullName = FullNameString; 1268cfa88f893915ceb8ae4ce2f17c46c24a4d67502fDmitri Gribenko const StringRef Pattern = Name; 12694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek if (Pattern.startswith("::")) { 12704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return FullName == Pattern; 12714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } else { 12724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return FullName.endswith(("::" + Pattern).str()); 12734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 12744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 12754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 127631bdf071afc18bb9551e4f4254be297333200c4aManuel Klimek/// \brief Matches NamedDecl nodes whose fully qualified names contain 127731bdf071afc18bb9551e4f4254be297333200c4aManuel Klimek/// a substring matched by the given RegExp. 1278e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1279e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Supports specifying enclosing namespaces or classes by 1280e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// prefixing the name with '<enclosing>::'. Does not match typedefs 1281e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// of an underlying type with the given name. 1282e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1283e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Example matches X (regexp == "::X") 128425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1285e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// class X; 128625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1287e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1288e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Example matches X (regexp is one of "::X", "^foo::.*X", among others) 128925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 129025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// namespace foo { namespace bar { class X; } } 129125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1292e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(NamedDecl, matchesName, std::string, RegExp) { 1293e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper assert(!RegExp.empty()); 1294e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper std::string FullNameString = "::" + Node.getQualifiedNameAsString(); 1295e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper llvm::Regex RE(RegExp); 1296e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return RE.match(FullNameString); 1297e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 1298e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 12994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches overloaded operator names. 13004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 13014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Matches overloaded operator names specified in strings without the 13024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// "operator" prefix, such as "<<", for OverloadedOperatorCall's. 13034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 13044da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches a << b 13052dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher == operatorCallExpr(hasOverloadedOperatorName("<<"))) 130625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 13074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// a << b; 13084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// c && d; // assuming both operator<< 13094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// // and operator&& are overloaded somewhere. 131025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1311e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CXXOperatorCallExpr, 13124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek hasOverloadedOperatorName, std::string, Name) { 1313e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return getOperatorSpelling(Node.getOperator()) == Name; 13144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 13154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 13164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches C++ classes that are directly or indirectly derived from 131720b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper/// a class matching \c Base. 13184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 131976dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper/// Note that a class is not considered to be derived from itself. 13204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 132176dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper/// Example matches Y, Z, C (Base == hasName("X")) 132225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 132376dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper/// class X; 13244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y : public X {}; // directly derived 13254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Z : public Y {}; // indirectly derived 13264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// typedef X A; 13274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// typedef A B; 13284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class C : public B {}; // derived from a typedef of X 132925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 13304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 133120b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper/// In the following example, Bar matches isDerivedFrom(hasName("X")): 133225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 13334da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Foo; 13344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// typedef Foo X; 13354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Bar : public Foo {}; // derived from a type that X is a typedef of 133625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 133720b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel JasperAST_MATCHER_P(CXXRecordDecl, isDerivedFrom, 133820b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper internal::Matcher<NamedDecl>, Base) { 133920b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper return Finder->classIsDerivedFrom(&Node, Base, Builder); 134020b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper} 134120b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper 134220b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper/// \brief Overloaded method as shortcut for \c isDerivedFrom(hasName(...)). 134320b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasperinline internal::Matcher<CXXRecordDecl> isDerivedFrom(StringRef BaseName) { 134420b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper assert(!BaseName.empty()); 134520b802d186dfc5db9b4a9ce83e9f31fa5aa4efccDaniel Jasper return isDerivedFrom(hasName(BaseName)); 13464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 13474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 134876dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper/// \brief Similar to \c isDerivedFrom(), but also matches classes that directly 134976dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper/// match \c Base. 135063d88728d862f8a69b3291e533d193d1d8513f5aDaniel Jasperinline internal::Matcher<CXXRecordDecl> isSameOrDerivedFrom( 135163d88728d862f8a69b3291e533d193d1d8513f5aDaniel Jasper internal::Matcher<NamedDecl> Base) { 135276dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper return anyOf(Base, isDerivedFrom(Base)); 135376dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper} 135476dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper 135563d88728d862f8a69b3291e533d193d1d8513f5aDaniel Jasper/// \brief Overloaded method as shortcut for 135663d88728d862f8a69b3291e533d193d1d8513f5aDaniel Jasper/// \c isSameOrDerivedFrom(hasName(...)). 135763d88728d862f8a69b3291e533d193d1d8513f5aDaniel Jasperinline internal::Matcher<CXXRecordDecl> isSameOrDerivedFrom( 135863d88728d862f8a69b3291e533d193d1d8513f5aDaniel Jasper StringRef BaseName) { 135976dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper assert(!BaseName.empty()); 136063d88728d862f8a69b3291e533d193d1d8513f5aDaniel Jasper return isSameOrDerivedFrom(hasName(BaseName)); 136176dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper} 136276dafa7e6487c0b51fadebd16bdefe0e0e23d595Daniel Jasper 13634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches AST nodes that have child AST nodes that match the 13644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// provided matcher. 13654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 13662dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches X, Y (matcher = recordDecl(has(recordDecl(hasName("X"))) 136725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 13684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X {}; // Matches X, because X::X is a class of name X inside X. 13694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { class X {}; }; 13704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Z { class Y { class X {}; }; }; // Does not match Z. 137125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 13724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 13734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// ChildT must be an AST base type. 137425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 137525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 13764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimektemplate <typename ChildT> 13774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekinternal::ArgumentAdaptingMatcher<internal::HasMatcher, ChildT> has( 13784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek const internal::Matcher<ChildT> &ChildMatcher) { 13794da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::ArgumentAdaptingMatcher<internal::HasMatcher, 13804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek ChildT>(ChildMatcher); 13814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 13824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 13834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches AST nodes that have descendant AST nodes that match the 13844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// provided matcher. 13854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 13864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches X, Y, Z 13872dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = recordDecl(hasDescendant(recordDecl(hasName("X"))))) 138825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 13894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X {}; // Matches X, because X::X is a class of name X inside X. 13904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { class X {}; }; 13914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Z { class Y { class X {}; }; }; 139225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 13934da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 13944da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// DescendantT must be an AST base type. 139525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 139625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 13974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimektemplate <typename DescendantT> 13984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekinternal::ArgumentAdaptingMatcher<internal::HasDescendantMatcher, DescendantT> 13994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel KlimekhasDescendant(const internal::Matcher<DescendantT> &DescendantMatcher) { 14004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::ArgumentAdaptingMatcher< 14014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek internal::HasDescendantMatcher, 14024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek DescendantT>(DescendantMatcher); 14034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 14044da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 14054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches AST nodes that have child AST nodes that match the 14064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// provided matcher. 14074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 14082dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches X, Y (matcher = recordDecl(forEach(recordDecl(hasName("X"))) 140925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 14104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X {}; // Matches X, because X::X is a class of name X inside X. 14114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { class X {}; }; 14124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Z { class Y { class X {}; }; }; // Does not match Z. 141325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 14144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 14154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// ChildT must be an AST base type. 14164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 14174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// As opposed to 'has', 'forEach' will cause a match for each result that 14184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches instead of only on the first one. 141925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 142025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 14214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimektemplate <typename ChildT> 14224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekinternal::ArgumentAdaptingMatcher<internal::ForEachMatcher, ChildT> forEach( 142325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek const internal::Matcher<ChildT> &ChildMatcher) { 14244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::ArgumentAdaptingMatcher< 14254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek internal::ForEachMatcher, 14264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek ChildT>(ChildMatcher); 14274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 14284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 14294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches AST nodes that have descendant AST nodes that match the 14304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// provided matcher. 14314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 14324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches X, A, B, C 14332dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = recordDecl(forEachDescendant(recordDecl(hasName("X"))))) 143425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 14354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X {}; // Matches X, because X::X is a class of name X inside X. 14364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class A { class X {}; }; 14374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class B { class C { class X {}; }; }; 143825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 14394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 14404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// DescendantT must be an AST base type. 14414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 14424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// As opposed to 'hasDescendant', 'forEachDescendant' will cause a match for 14434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// each result that matches instead of only on the first one. 14444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 14454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Note: Recursively combined ForEachDescendant can cause many matches: 14462dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// recordDecl(forEachDescendant(recordDecl(forEachDescendant(recordDecl())))) 14474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// will match 10 times (plus injected class name matches) on: 144825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 14494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class A { class B { class C { class D { class E {}; }; }; }; }; 145025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 145125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 145225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 14534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimektemplate <typename DescendantT> 1454a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasperinternal::ArgumentAdaptingMatcher<internal::ForEachDescendantMatcher, 1455a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper DescendantT> 14564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel KlimekforEachDescendant( 145725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek const internal::Matcher<DescendantT> &DescendantMatcher) { 14584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::ArgumentAdaptingMatcher< 14594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek internal::ForEachDescendantMatcher, 14604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek DescendantT>(DescendantMatcher); 14614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 14624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1463152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// \brief Matches if the node or any descendant matches. 1464152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// 1465152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// Generates results for each match. 1466152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// 1467152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// For example, in: 1468152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// \code 1469152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// class A { class B {}; class C {}; }; 1470152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// \endcode 1471152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// The matcher: 1472152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// \code 1473152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// recordDecl(hasName("::A"), findAll(recordDecl(isDefinition()).bind("m"))) 1474152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// \endcode 1475152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// will generate results for \c A, \c B and \c C. 1476152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// 1477152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek/// Usable as: Any Matcher 1478152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimektemplate <typename T> 1479152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimekinternal::PolymorphicMatcherWithParam2< 1480152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek internal::EachOfMatcher, internal::Matcher<T>, 1481152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek internal::ArgumentAdaptingMatcher<internal::ForEachDescendantMatcher, T> > 1482152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel KlimekfindAll(const internal::Matcher<T> &Matcher) { 1483152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek return eachOf(Matcher, forEachDescendant(Matcher)); 1484152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek} 1485152ea0e4711f7aed75f6a1d1995b0bd94eb31c98Manuel Klimek 1486c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// \brief Matches AST nodes that have a parent that matches the provided 1487c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// matcher. 1488c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// 1489c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// Given 1490c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// \code 1491c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// void f() { for (;;) { int x = 42; if (true) { int x = 43; } } } 1492c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// \endcode 1493c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// \c compoundStmt(hasParent(ifStmt())) matches "{ int x = 43; }". 1494c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// 1495c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper/// Usable as: Any Matcher 1496c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jaspertemplate <typename ParentT> 1497c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasperinternal::ArgumentAdaptingMatcher<internal::HasParentMatcher, ParentT> 1498c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel JasperhasParent(const internal::Matcher<ParentT> &ParentMatcher) { 1499c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper return internal::ArgumentAdaptingMatcher< 1500c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper internal::HasParentMatcher, 1501c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper ParentT>(ParentMatcher); 1502c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper} 1503c99a3ad8c2bf29da45a0c64b88d58bfbd2f78ef2Daniel Jasper 1504579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// \brief Matches AST nodes that have an ancestor that matches the provided 1505579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// matcher. 1506579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// 1507579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// Given 1508579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// \code 1509579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// void f() { if (true) { int x = 42; } } 1510579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// void g() { for (;;) { int x = 43; } } 1511579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// \endcode 1512a1a4c0385a0fd458243d9e357e1eceb137f29abfNick Lewycky/// \c expr(integerLiteral(hasAncestor(ifStmt()))) matches \c 42, but not 43. 1513579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// 1514579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek/// Usable as: Any Matcher 1515579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimektemplate <typename AncestorT> 1516579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimekinternal::ArgumentAdaptingMatcher<internal::HasAncestorMatcher, AncestorT> 1517579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel KlimekhasAncestor(const internal::Matcher<AncestorT> &AncestorMatcher) { 1518579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek return internal::ArgumentAdaptingMatcher< 1519579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek internal::HasAncestorMatcher, 1520579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek AncestorT>(AncestorMatcher); 1521579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek} 1522579b120038ca817e0ce423303ebc1b4e0c6cbbe1Manuel Klimek 15234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the provided matcher does not match. 15244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 15252dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches Y (matcher = recordDecl(unless(hasName("X")))) 152625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 15274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X {}; 15284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y {}; 152925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 153025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 153125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Any Matcher 15324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimektemplate <typename M> 153325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimekinternal::PolymorphicMatcherWithParam1<internal::NotMatcher, M> 153425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimekunless(const M &InnerMatcher) { 15354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::PolymorphicMatcherWithParam1< 15364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek internal::NotMatcher, M>(InnerMatcher); 15374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 15384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 15394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a type if the declaration of the type matches the given 15404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matcher. 1541297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// 1542c711af2ddbbb1d46223cc9379d32a203fb5bc7f4Daniel Jasper/// Usable as: Matcher<QualType>, Matcher<CallExpr>, Matcher<CXXConstructExpr>, 1543c711af2ddbbb1d46223cc9379d32a203fb5bc7f4Daniel Jasper/// Matcher<MemberExpr> 15444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekinline internal::PolymorphicMatcherWithParam1< internal::HasDeclarationMatcher, 1545e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Decl> > 1546e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper hasDeclaration(const internal::Matcher<Decl> &InnerMatcher) { 15474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::PolymorphicMatcherWithParam1< 15484da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek internal::HasDeclarationMatcher, 1549e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Decl> >(InnerMatcher); 15504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 15514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 15524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches on the implicit object argument of a member call expression. 15534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 15542dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches y.x() (matcher = callExpr(on(hasType(recordDecl(hasName("Y")))))) 155525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 15564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { public: void x(); }; 15574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void z() { Y y; y.x(); }", 155825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 15594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 15604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// FIXME: Overload to allow directly matching types? 1561e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CXXMemberCallExpr, on, internal::Matcher<Expr>, 15624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 1563f8c12146fa2153a6d97b7c92d27d2ece0cd26e79Dmitri Gribenko const Expr *ExprNode = Node.getImplicitObjectArgument() 1564f8c12146fa2153a6d97b7c92d27d2ece0cd26e79Dmitri Gribenko ->IgnoreParenImpCasts(); 15654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (ExprNode != NULL && 15664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*ExprNode, Finder, Builder)); 15674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 15684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 15694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the call expression's callee expression matches. 15704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 15714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 157225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 15734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { void x() { this->x(); x(); Y y; y.x(); } }; 15744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f() { f(); } 157525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 15762dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// callExpr(callee(expr())) 15774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches this->x(), x(), y.x(), f() 15784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with callee(...) 15794da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matching this->x, x, y.x, f respectively 15804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 1581e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Note: Callee cannot take the more general internal::Matcher<Expr> 15824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// because this introduces ambiguous overloads with calls to Callee taking a 1583e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// internal::Matcher<Decl>, as the matcher hierarchy is purely 15844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// implemented in terms of implicit casts. 1585e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CallExpr, callee, internal::Matcher<Stmt>, 15864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 1587e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Expr *ExprNode = Node.getCallee(); 15884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (ExprNode != NULL && 15894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*ExprNode, Finder, Builder)); 15904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 15914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 15924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the call expression's callee's declaration matches the 15934da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// given matcher. 15944da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 15952dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches y.x() (matcher = callExpr(callee(methodDecl(hasName("x"))))) 159625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 15974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { public: void x(); }; 15984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void z() { Y y; y.x(); 159925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1600e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperinline internal::Matcher<CallExpr> callee( 1601e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const internal::Matcher<Decl> &InnerMatcher) { 1602e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return internal::Matcher<CallExpr>(hasDeclaration(InnerMatcher)); 16034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 16044da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 16054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the expression's or declaration's type matches a type 16064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matcher. 16074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16082dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches x (matcher = expr(hasType(recordDecl(hasName("X"))))) 16092dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// and z (matcher = varDecl(hasType(recordDecl(hasName("X"))))) 161025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 16114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X {}; 16124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void y(X &x) { x; X z; } 161325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1614e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_POLYMORPHIC_MATCHER_P(hasType, internal::Matcher<QualType>, 16154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 1616e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper TOOLING_COMPILE_ASSERT((llvm::is_base_of<Expr, NodeType>::value || 1617e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper llvm::is_base_of<ValueDecl, NodeType>::value), 16184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek instantiated_with_wrong_types); 16194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return InnerMatcher.matches(Node.getType(), Finder, Builder); 16204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 16214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 16224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Overloaded to match the declaration of the expression's or value 16234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// declaration's type. 16244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// In case of a value declaration (for example a variable declaration), 16264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// this resolves one layer of indirection. For example, in the value 16272dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// declaration "X x;", recordDecl(hasName("X")) matches the declaration of X, 16282dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// while varDecl(hasType(recordDecl(hasName("X")))) matches the declaration 16294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// of x." 16304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16312dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches x (matcher = expr(hasType(recordDecl(hasName("X"))))) 16322dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// and z (matcher = varDecl(hasType(recordDecl(hasName("X"))))) 163325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 16344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X {}; 16354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void y(X &x) { x; X z; } 163625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1637297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// 1638297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// Usable as: Matcher<Expr>, Matcher<ValueDecl> 16394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekinline internal::PolymorphicMatcherWithParam1< 16404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek internal::matcher_hasTypeMatcher, 1641e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<QualType> > 1642e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperhasType(const internal::Matcher<Decl> &InnerMatcher) { 1643e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return hasType(internal::Matcher<QualType>( 16444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek hasDeclaration(InnerMatcher))); 16454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 16464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1647e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches if the matched type is represented by the given string. 1648e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1649e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 165025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1651e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// class Y { public: void x(); }; 1652e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// void z() { Y* y; y->x(); } 165325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 16542dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// callExpr(on(hasType(asString("class Y *")))) 1655e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches y->x() 1656e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(QualType, asString, std::string, Name) { 1657e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return Name == Node.getAsString(); 1658e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 1659e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 16604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the matched type is a pointer type and the pointee type 16614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches the specified matcher. 16624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches y->x() 16642dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = callExpr(on(hasType(pointsTo(recordDecl(hasName("Y"))))))) 166525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 16664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { public: void x(); }; 16674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void z() { Y *y; y->x(); } 166825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 16694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel KlimekAST_MATCHER_P( 1670e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper QualType, pointsTo, internal::Matcher<QualType>, 16714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 1672e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return (!Node.isNull() && Node->isPointerType() && 16734da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(Node->getPointeeType(), Finder, Builder)); 16744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 16754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 16764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Overloaded to match the pointee type's declaration. 1677e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperinline internal::Matcher<QualType> pointsTo( 1678e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const internal::Matcher<Decl> &InnerMatcher) { 1679e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return pointsTo(internal::Matcher<QualType>( 16804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek hasDeclaration(InnerMatcher))); 16814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 16824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 16834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the matched type is a reference type and the referenced 16844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// type matches the specified matcher. 16854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 16864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches X &x and const X &y 16872dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = varDecl(hasType(references(recordDecl(hasName("X")))))) 168825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 16894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X { 16904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void a(X b) { 16914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// X &x = b; 16924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// const X &y = b; 16934da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 169425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1695e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(QualType, references, internal::Matcher<QualType>, 16964da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 1697e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return (!Node.isNull() && Node->isReferenceType() && 16984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(Node->getPointeeType(), Finder, Builder)); 16994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 17004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 17014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Overloaded to match the referenced type's declaration. 1702e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperinline internal::Matcher<QualType> references( 1703e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const internal::Matcher<Decl> &InnerMatcher) { 1704e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return references(internal::Matcher<QualType>( 17054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek hasDeclaration(InnerMatcher))); 17064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 17074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1708e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CXXMemberCallExpr, onImplicitObjectArgument, 1709e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 1710f8c12146fa2153a6d97b7c92d27d2ece0cd26e79Dmitri Gribenko const Expr *ExprNode = Node.getImplicitObjectArgument(); 17114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (ExprNode != NULL && 17124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*ExprNode, Finder, Builder)); 17134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 17144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 17154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the expression's type either matches the specified 17164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matcher, or is a pointer to a type that matches the InnerMatcher. 17179f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimekinline internal::Matcher<CXXMemberCallExpr> thisPointerType( 1718e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const internal::Matcher<QualType> &InnerMatcher) { 17194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return onImplicitObjectArgument( 17204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek anyOf(hasType(InnerMatcher), hasType(pointsTo(InnerMatcher)))); 17214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 17224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 17234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Overloaded to match the type's declaration. 17249f17408d50c1d76c5eab435e4ceb924cc10757abManuel Klimekinline internal::Matcher<CXXMemberCallExpr> thisPointerType( 1725e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const internal::Matcher<Decl> &InnerMatcher) { 17264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return onImplicitObjectArgument( 17274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek anyOf(hasType(InnerMatcher), hasType(pointsTo(InnerMatcher)))); 17284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 17294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 17304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a DeclRefExpr that refers to a declaration that matches the 17314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// specified matcher. 17324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 17334da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches x in if(x) 17342dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = declRefExpr(to(varDecl(hasName("x"))))) 173525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 17364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// bool x; 17374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// if (x) {} 173825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1739e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(DeclRefExpr, to, internal::Matcher<Decl>, 17404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 1741e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Decl *DeclNode = Node.getDecl(); 17424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (DeclNode != NULL && 17434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*DeclNode, Finder, Builder)); 17444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 17454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1746e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches a \c DeclRefExpr that refers to a declaration through a 1747e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// specific using shadow declaration. 1748e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1749e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// FIXME: This currently only works for functions. Fix. 1750e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 1751e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 175225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1753e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// namespace a { void f() {} } 1754e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// using a::f; 1755e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// void g() { 1756e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// f(); // Matches this .. 1757e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// a::f(); // .. but not this. 1758e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// } 175925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 17602dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// declRefExpr(throughUsingDeclaration(anything())) 1761e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \c f() 1762e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(DeclRefExpr, throughUsingDecl, 176325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<UsingShadowDecl>, InnerMatcher) { 1764e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const NamedDecl *FoundDecl = Node.getFoundDecl(); 1765cfa88f893915ceb8ae4ce2f17c46c24a4d67502fDmitri Gribenko if (const UsingShadowDecl *UsingDecl = dyn_cast<UsingShadowDecl>(FoundDecl)) 176625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek return InnerMatcher.matches(*UsingDecl, Finder, Builder); 1767e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return false; 1768e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 1769e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 1770425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// \brief Matches the Decl of a DeclStmt which has a single declaration. 1771425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// 1772425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// Given 177325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1774425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int a, b; 1775425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int c; 177625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 17772dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// declStmt(hasSingleDecl(anything())) 1778425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// matches 'int c;' but not 'int a, b;'. 1779425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam PanzerAST_MATCHER_P(DeclStmt, hasSingleDecl, internal::Matcher<Decl>, InnerMatcher) { 1780425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer if (Node.isSingleDecl()) { 1781425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer const Decl *FoundDecl = Node.getSingleDecl(); 1782425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer return InnerMatcher.matches(*FoundDecl, Finder, Builder); 1783425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer } 1784425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer return false; 1785425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer} 1786425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer 17874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a variable declaration that has an initializer expression 17884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// that matches the given matcher. 17894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 17902dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches x (matcher = varDecl(hasInitializer(callExpr()))) 179125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 17924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// bool y() { return true; } 17934da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// bool x = y(); 179425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 17954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel KlimekAST_MATCHER_P( 1796e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper VarDecl, hasInitializer, internal::Matcher<Expr>, 17974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 1798e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Expr *Initializer = Node.getAnyInitializer(); 17994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (Initializer != NULL && 18004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*Initializer, Finder, Builder)); 18014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 18024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 18034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Checks that a call expression or a constructor call expression has 18044da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// a specific number of arguments (including absent default arguments). 18054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 18062dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// Example matches f(0, 0) (matcher = callExpr(argumentCountIs(2))) 180725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 18084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f(int x, int y); 18094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// f(0, 0); 181025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 18114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel KlimekAST_POLYMORPHIC_MATCHER_P(argumentCountIs, unsigned, N) { 1812e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper TOOLING_COMPILE_ASSERT((llvm::is_base_of<CallExpr, NodeType>::value || 1813e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper llvm::is_base_of<CXXConstructExpr, 18144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek NodeType>::value), 18154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek instantiated_with_wrong_types); 18164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return Node.getNumArgs() == N; 18174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 18184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 18194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the n'th argument of a call expression or a constructor 18204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// call expression. 18214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 18224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches y in x(y) 18232dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = callExpr(hasArgument(0, declRefExpr()))) 182425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 18254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void x(int) { int y; x(y); } 182625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 18274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel KlimekAST_POLYMORPHIC_MATCHER_P2( 1828e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper hasArgument, unsigned, N, internal::Matcher<Expr>, InnerMatcher) { 1829e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper TOOLING_COMPILE_ASSERT((llvm::is_base_of<CallExpr, NodeType>::value || 1830e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper llvm::is_base_of<CXXConstructExpr, 18314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek NodeType>::value), 18324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek instantiated_with_wrong_types); 18334da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (N < Node.getNumArgs() && 18344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches( 18354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek *Node.getArg(N)->IgnoreParenImpCasts(), Finder, Builder)); 18364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 18374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 1838425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// \brief Matches declaration statements that contain a specific number of 1839425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// declarations. 1840425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// 1841425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// Example: Given 184225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1843425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int a, b; 1844425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int c; 1845425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int d = 2, e; 184625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1847425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// declCountIs(2) 1848425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// matches 'int a, b;' and 'int d = 2, e;', but not 'int c;'. 1849425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam PanzerAST_MATCHER_P(DeclStmt, declCountIs, unsigned, N) { 1850217c484522926f9fc664ec3bfaf3cffe456244b0Benjamin Kramer return std::distance(Node.decl_begin(), Node.decl_end()) == (ptrdiff_t)N; 1851425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer} 1852425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer 1853425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// \brief Matches the n'th declaration of a declaration statement. 1854425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// 1855425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// Note that this does not work for global declarations because the AST 1856425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// breaks up multiple-declaration DeclStmt's into multiple single-declaration 1857425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// DeclStmt's. 1858425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// Example: Given non-global declarations 185925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1860425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int a, b = 0; 1861425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int c; 1862425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// int d = 2, e; 186325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 18642dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// declStmt(containsDeclaration( 18652dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// 0, varDecl(hasInitializer(anything())))) 1866425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// matches only 'int d = 2, e;', and 18672dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// declStmt(containsDeclaration(1, varDecl())) 186825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 1869425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// matches 'int a, b = 0' as well as 'int d = 2, e;' 1870425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer/// but 'int c;' is not matched. 187125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 1872425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam PanzerAST_MATCHER_P2(DeclStmt, containsDeclaration, unsigned, N, 1873425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer internal::Matcher<Decl>, InnerMatcher) { 1874425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer const unsigned NumDecls = std::distance(Node.decl_begin(), Node.decl_end()); 1875425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer if (N >= NumDecls) 1876425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer return false; 1877425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer DeclStmt::const_decl_iterator Iterator = Node.decl_begin(); 1878425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer std::advance(Iterator, N); 1879425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer return InnerMatcher.matches(**Iterator, Finder, Builder); 1880425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer} 1881425f41b370a8795fbca9ffc3b35e9b0ccbb15d97Sam Panzer 18824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a constructor initializer. 18834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 18844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 188525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 18864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct Foo { 18874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo() : foo_(1) { } 18884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int foo_; 18894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 189025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 18912dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// recordDecl(has(constructorDecl(hasAnyConstructorInitializer(anything())))) 1892e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// record matches Foo, hasAnyConstructorInitializer matches foo_(1) 1893e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CXXConstructorDecl, hasAnyConstructorInitializer, 1894e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<CXXCtorInitializer>, InnerMatcher) { 1895e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper for (CXXConstructorDecl::init_const_iterator I = Node.init_begin(); 18964da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek I != Node.init_end(); ++I) { 18974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek if (InnerMatcher.matches(**I, Finder, Builder)) { 18984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return true; 18994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 19004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 19014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return false; 19024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 19034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 19044da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the field declaration of a constructor initializer. 19054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 19064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 190725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 19084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct Foo { 19094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo() : foo_(1) { } 19104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int foo_; 19114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 191225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 19132dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// recordDecl(has(constructorDecl(hasAnyConstructorInitializer( 19144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// forField(hasName("foo_")))))) 19154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches Foo 19164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with forField matching foo_ 1917e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CXXCtorInitializer, forField, 1918e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<FieldDecl>, InnerMatcher) { 1919e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const FieldDecl *NodeAsDecl = Node.getMember(); 19204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (NodeAsDecl != NULL && 19214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*NodeAsDecl, Finder, Builder)); 19224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 19234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 19244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the initializer expression of a constructor initializer. 19254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 19264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 192725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 19284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct Foo { 19294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo() : foo_(1) { } 19304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int foo_; 19314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 193225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 19332dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// recordDecl(has(constructorDecl(hasAnyConstructorInitializer( 19344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// withInitializer(integerLiteral(equals(1))))))) 19354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches Foo 19364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with withInitializer matching (1) 1937e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CXXCtorInitializer, withInitializer, 1938e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 1939e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Expr* NodeAsExpr = Node.getInit(); 19404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (NodeAsExpr != NULL && 19414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*NodeAsExpr, Finder, Builder)); 19424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 19434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 19444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a contructor initializer if it is explicitly written in 19454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// code (as opposed to implicitly added by the compiler). 19464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 19474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 194825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 19494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct Foo { 19504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo() { } 19514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Foo(int) : foo_("A") { } 19524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// string foo_; 19534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 195425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 19552dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// constructorDecl(hasAnyConstructorInitializer(isWritten())) 19564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// will match Foo(int), but not Foo() 1957e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER(CXXCtorInitializer, isWritten) { 19584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return Node.isWritten(); 19594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 19604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 19614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a constructor declaration that has been implicitly added 19624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// by the compiler (eg. implicit default/copy constructors). 1963e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER(CXXConstructorDecl, isImplicit) { 19644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return Node.isImplicit(); 19654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 19664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 19674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches any argument of a call expression or a constructor call 19684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// expression. 19694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 19704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 197125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 19724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void x(int, int, int) { int y; x(1, y, 42); } 197325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 19742dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// callExpr(hasAnyArgument(declRefExpr())) 19754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches x(1, y, 42) 19764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with hasAnyArgument(...) 19774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matching y 1978e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_POLYMORPHIC_MATCHER_P(hasAnyArgument, internal::Matcher<Expr>, 19794da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 1980e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper TOOLING_COMPILE_ASSERT((llvm::is_base_of<CallExpr, NodeType>::value || 1981e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper llvm::is_base_of<CXXConstructExpr, 19824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek NodeType>::value), 19834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek instantiated_with_wrong_types); 19844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek for (unsigned I = 0; I < Node.getNumArgs(); ++I) { 19854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek if (InnerMatcher.matches(*Node.getArg(I)->IgnoreParenImpCasts(), 19864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek Finder, Builder)) { 19874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return true; 19884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 19894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 19904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return false; 19914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 19924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 19934da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the n'th parameter of a function declaration. 19944da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 19954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 199625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 19974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X { void f(int x) {} }; 199825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 19992dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// methodDecl(hasParameter(0, hasType(varDecl()))) 20004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches f(int x) {} 20014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with hasParameter(...) 20024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matching int x 2003e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P2(FunctionDecl, hasParameter, 2004e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper unsigned, N, internal::Matcher<ParmVarDecl>, 20054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 20064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (N < Node.getNumParams() && 20074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches( 20084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek *Node.getParamDecl(N), Finder, Builder)); 20094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 20104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 20114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches any parameter of a function declaration. 20124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 20134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Does not match the 'this' parameter of a method. 20144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 20154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 201625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 20174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class X { void f(int x, int y, int z) {} }; 201825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 20192dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// methodDecl(hasAnyParameter(hasName("y"))) 20204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches f(int x, int y, int z) {} 20214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with hasAnyParameter(...) 20224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matching int y 2023e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(FunctionDecl, hasAnyParameter, 2024e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<ParmVarDecl>, InnerMatcher) { 20254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek for (unsigned I = 0; I < Node.getNumParams(); ++I) { 20264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek if (InnerMatcher.matches(*Node.getParamDecl(I), Finder, Builder)) { 20274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return true; 20284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 20294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 20304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return false; 20314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 20324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 203336e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// \brief Matches \c FunctionDecls that have a specific parameter count. 203436e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// 203536e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// Given 203636e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// \code 203736e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// void f(int i) {} 203836e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// void g(int i, int j) {} 203936e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// \endcode 204036e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// functionDecl(parameterCountIs(2)) 204136e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper/// matches g(int i, int j) {} 204236e29d6732814e958aea4b2f403cec63d7ed3116Daniel JasperAST_MATCHER_P(FunctionDecl, parameterCountIs, unsigned, N) { 204336e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper return Node.getNumParams() == N; 204436e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper} 204536e29d6732814e958aea4b2f403cec63d7ed3116Daniel Jasper 2046e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches the return type of a function declaration. 2047e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 2048e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given: 204925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2050e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// class X { int f() { return 1; } }; 205125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 20522dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// methodDecl(returns(asString("int"))) 2053e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches int f() { return 1; } 205425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel KlimekAST_MATCHER_P(FunctionDecl, returns, 205525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<QualType>, InnerMatcher) { 205625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek return InnerMatcher.matches(Node.getResultType(), Finder, Builder); 2057e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 2058e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 20598cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper/// \brief Matches extern "C" function declarations. 20608cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper/// 20618cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper/// Given: 206225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 20638cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper/// extern "C" void f() {} 20648cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper/// extern "C" { void g() {} } 20658cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper/// void h() {} 206625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 20672dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// functionDecl(isExternC()) 20688cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper/// matches the declaration of f and g, but not the declaration h 20698cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel JasperAST_MATCHER(FunctionDecl, isExternC) { 20708cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper return Node.isExternC(); 20718cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper} 20728cc7efa2da2c6be43cbd3d09a9ae01353bb921d2Daniel Jasper 20736a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// \brief Matches the condition expression of an if statement, for loop, 20746a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// or conditional operator. 20754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 20764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches true (matcher = hasCondition(boolLiteral(equals(true)))) 207725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 20784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// if (true) {} 207925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2080e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_POLYMORPHIC_MATCHER_P(hasCondition, internal::Matcher<Expr>, 20814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher) { 20824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek TOOLING_COMPILE_ASSERT( 2083e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper (llvm::is_base_of<IfStmt, NodeType>::value) || 20846a12449ec8862211856447d3df4c082a346339f2Daniel Jasper (llvm::is_base_of<ForStmt, NodeType>::value) || 20856a12449ec8862211856447d3df4c082a346339f2Daniel Jasper (llvm::is_base_of<WhileStmt, NodeType>::value) || 20866a12449ec8862211856447d3df4c082a346339f2Daniel Jasper (llvm::is_base_of<DoStmt, NodeType>::value) || 2087e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper (llvm::is_base_of<ConditionalOperator, NodeType>::value), 20886a12449ec8862211856447d3df4c082a346339f2Daniel Jasper has_condition_requires_if_statement_conditional_operator_or_loop); 2089e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Expr *const Condition = Node.getCond(); 20904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (Condition != NULL && 20914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*Condition, Finder, Builder)); 20924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 20934da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 20944da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the condition variable statement in an if statement. 20954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 20964da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 209725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 20984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// if (A* a = GetAPointer()) {} 209925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 21004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// hasConditionVariableStatment(...) 21014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'A* a = GetAPointer()'. 2102e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(IfStmt, hasConditionVariableStatement, 2103e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<DeclStmt>, InnerMatcher) { 2104e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const DeclStmt* const DeclarationStatement = 21054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek Node.getConditionVariableDeclStmt(); 21064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return DeclarationStatement != NULL && 21074da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*DeclarationStatement, Finder, Builder); 21084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 21094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 2110e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches the index expression of an array subscript expression. 2111e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 2112e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 211325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2114e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int i[5]; 2115e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// void f() { i[1] = 42; } 211625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2117e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// arraySubscriptExpression(hasIndex(integerLiteral())) 2118e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \c i[1] with the \c integerLiteral() matching \c 1 2119e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(ArraySubscriptExpr, hasIndex, 212025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<Expr>, InnerMatcher) { 2121e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper if (const Expr* Expression = Node.getIdx()) 212225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek return InnerMatcher.matches(*Expression, Finder, Builder); 2123e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return false; 2124e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 2125e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 2126e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches the base expression of an array subscript expression. 2127e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 2128e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 212925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2130e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// int i[5]; 2131e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// void f() { i[1] = 42; } 213225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 21332dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// arraySubscriptExpression(hasBase(implicitCastExpr( 21342dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// hasSourceExpression(declRefExpr())))) 21352dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// matches \c i[1] with the \c declRefExpr() matching \c i 2136e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(ArraySubscriptExpr, hasBase, 213725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<Expr>, InnerMatcher) { 2138e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper if (const Expr* Expression = Node.getBase()) 213925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek return InnerMatcher.matches(*Expression, Finder, Builder); 2140e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return false; 2141e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 2142e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 21436a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// \brief Matches a 'for', 'while', or 'do while' statement that has 21446a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// a given body. 21454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 21464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 214725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 21484da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// for (;;) {} 214925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 21502dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// hasBody(compoundStmt()) 21514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches 'for (;;) {}' 21522dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// with compoundStmt() 21534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matching '{}' 21546a12449ec8862211856447d3df4c082a346339f2Daniel JasperAST_POLYMORPHIC_MATCHER_P(hasBody, internal::Matcher<Stmt>, 21556a12449ec8862211856447d3df4c082a346339f2Daniel Jasper InnerMatcher) { 21566a12449ec8862211856447d3df4c082a346339f2Daniel Jasper TOOLING_COMPILE_ASSERT( 21576a12449ec8862211856447d3df4c082a346339f2Daniel Jasper (llvm::is_base_of<DoStmt, NodeType>::value) || 21586a12449ec8862211856447d3df4c082a346339f2Daniel Jasper (llvm::is_base_of<ForStmt, NodeType>::value) || 21596a12449ec8862211856447d3df4c082a346339f2Daniel Jasper (llvm::is_base_of<WhileStmt, NodeType>::value), 21606a12449ec8862211856447d3df4c082a346339f2Daniel Jasper has_body_requires_for_while_or_do_statement); 2161e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Stmt *const Statement = Node.getBody(); 21624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (Statement != NULL && 21634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*Statement, Finder, Builder)); 21644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 21654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 21664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches compound statements where at least one substatement matches 21674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// a given matcher. 21684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 21694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 217025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 21714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// { {}; 1+2; } 217225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 21732dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// hasAnySubstatement(compoundStmt()) 21744da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches '{ {}; 1+2; }' 21752dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// with compoundStmt() 21764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matching '{}' 2177e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CompoundStmt, hasAnySubstatement, 2178e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Stmt>, InnerMatcher) { 2179e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper for (CompoundStmt::const_body_iterator It = Node.body_begin(); 21804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek It != Node.body_end(); 21814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek ++It) { 21824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek if (InnerMatcher.matches(**It, Finder, Builder)) return true; 21834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek } 21844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return false; 21854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 21864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 21874da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Checks that a compound statement contains a specific number of 21884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// child statements. 21894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 21904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example: Given 219125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 21924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// { for (;;) {} } 219325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 21942dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// compoundStmt(statementCountIs(0))) 21954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches '{}' 21964da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// but does not match the outer compound statement. 2197e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CompoundStmt, statementCountIs, unsigned, N) { 21984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return Node.size() == N; 21994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 22004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 22014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches literals that are equal to the given value. 22024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 22034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches true (matcher = boolLiteral(equals(true))) 220425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 22054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// true 220625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2207297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// 2208297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// Usable as: Matcher<CharacterLiteral>, Matcher<CXXBoolLiteral>, 2209297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// Matcher<FloatingLiteral>, Matcher<IntegerLiteral> 22104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimektemplate <typename ValueT> 22114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekinternal::PolymorphicMatcherWithParam1<internal::ValueEqualsMatcher, ValueT> 22124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekequals(const ValueT &Value) { 22134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::PolymorphicMatcherWithParam1< 22144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek internal::ValueEqualsMatcher, 22154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek ValueT>(Value); 22164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 22174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 22184da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the operator Name of operator expressions (binary or 22194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// unary). 22204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 22214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches a || b (matcher = binaryOperator(hasOperatorName("||"))) 222225466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 22234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// !(a || b) 222425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 22254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel KlimekAST_POLYMORPHIC_MATCHER_P(hasOperatorName, std::string, Name) { 22264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek TOOLING_COMPILE_ASSERT( 2227e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper (llvm::is_base_of<BinaryOperator, NodeType>::value) || 2228e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper (llvm::is_base_of<UnaryOperator, NodeType>::value), 22294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek has_condition_requires_if_statement_or_conditional_operator); 22304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return Name == Node.getOpcodeStr(Node.getOpcode()); 22314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 22324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 22334da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the left hand side of binary operator expressions. 22344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 22354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches a (matcher = binaryOperator(hasLHS())) 223625466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 22374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// a || b 223825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2239e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(BinaryOperator, hasLHS, 2240e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 2241e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Expr *LeftHandSide = Node.getLHS(); 22424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (LeftHandSide != NULL && 22434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*LeftHandSide, Finder, Builder)); 22444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 22454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 22464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the right hand side of binary operator expressions. 22474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 22484da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches b (matcher = binaryOperator(hasRHS())) 224925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 22504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// a || b 225125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2252e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(BinaryOperator, hasRHS, 2253e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 2254e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Expr *RightHandSide = Node.getRHS(); 22554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (RightHandSide != NULL && 22564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*RightHandSide, Finder, Builder)); 22574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 22584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 22594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if either the left hand side or the right hand side of a 22604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// binary operator matches. 2261e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperinline internal::Matcher<BinaryOperator> hasEitherOperand( 2262e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const internal::Matcher<Expr> &InnerMatcher) { 22634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return anyOf(hasLHS(InnerMatcher), hasRHS(InnerMatcher)); 22644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 22654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 22664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if the operand of a unary operator matches. 22674da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 22689158a5624154bc43bbbf059c07a2f7b2cd45c1a1Alexander Kornienko/// Example matches true (matcher = hasUnaryOperand(boolLiteral(equals(true)))) 226925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 22704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// !true 227125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2272e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(UnaryOperator, hasUnaryOperand, 2273e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 2274e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Expr * const Operand = Node.getSubExpr(); 22754da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (Operand != NULL && 22764da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*Operand, Finder, Builder)); 22774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 22784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 2279715c9568ee5d75f25dab98229c87bcec880daf5dManuel Klimek/// \brief Matches if the cast's source expression matches the given matcher. 22804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 22814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example: matches "a string" (matcher = 22822dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// hasSourceExpression(constructExpr())) 228325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 22844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class URL { URL(string); }; 22854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// URL url = "a string"; 2286715c9568ee5d75f25dab98229c87bcec880daf5dManuel KlimekAST_MATCHER_P(CastExpr, hasSourceExpression, 2287e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 2288e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const Expr* const SubExpression = Node.getSubExpr(); 22894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (SubExpression != NULL && 22904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*SubExpression, Finder, Builder)); 22914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 22924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 22934da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches casts whose destination type matches a given matcher. 22944da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 22954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// (Note: Clang's AST refers to other conversions as "casts" too, and calls 22964da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// actual casts "explicit" casts.) 2297e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(ExplicitCastExpr, hasDestinationType, 2298e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<QualType>, InnerMatcher) { 2299e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const QualType NodeType = Node.getTypeAsWritten(); 23004da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return InnerMatcher.matches(NodeType, Finder, Builder); 23014da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 23024da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 23034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches implicit casts whose destination type matches a given 23044da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matcher. 23054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 23064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// FIXME: Unit test this matcher 2307e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(ImplicitCastExpr, hasImplicitDestinationType, 2308e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<QualType>, InnerMatcher) { 23094da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return InnerMatcher.matches(Node.getType(), Finder, Builder); 23104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 23114da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 23124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the true branch expression of a conditional operator. 23134da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 23144da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches a 231525466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 23164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// condition ? a : b 231725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2318e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(ConditionalOperator, hasTrueExpression, 2319e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 2320e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Expr *Expression = Node.getTrueExpr(); 23214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (Expression != NULL && 23224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*Expression, Finder, Builder)); 23234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 23244da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 23254da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the false branch expression of a conditional operator. 23264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 23274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches b 232825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 23294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// condition ? a : b 233025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2331e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(ConditionalOperator, hasFalseExpression, 2332e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 2333e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper Expr *Expression = Node.getFalseExpr(); 23344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (Expression != NULL && 23354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*Expression, Finder, Builder)); 23364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 23374da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 23384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches if a declaration has a body attached. 23394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 23404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches A, va, fa 234125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 23424da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class A {}; 23434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class B; // Doesn't match, as it has no body. 23444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int va; 23454da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// extern int vb; // Doesn't match, as it doesn't define the variable. 23464da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void fa() {} 23474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void fb(); // Doesn't match, as it has no body. 234825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2349297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// 2350297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// Usable as: Matcher<TagDecl>, Matcher<VarDecl>, Matcher<FunctionDecl> 23514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekinline internal::PolymorphicMatcherWithParam0<internal::IsDefinitionMatcher> 23524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel KlimekisDefinition() { 23534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::PolymorphicMatcherWithParam0< 23544da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek internal::IsDefinitionMatcher>(); 23554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 23564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 23574da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches the class declaration that the given method declaration 23584da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// belongs to. 23594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 23604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// FIXME: Generalize this for other kinds of declarations. 23614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// FIXME: What other kind of declarations would we need to generalize 23624da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// this to? 23634da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 23644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Example matches A() in the last line 23652dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// (matcher = constructExpr(hasDeclaration(methodDecl( 23664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// ofClass(hasName("A")))))) 236725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 23684da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class A { 23694da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// public: 23704da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// A(); 23714da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 23724da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// A a = A(); 237325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2374e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(CXXMethodDecl, ofClass, 2375e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<CXXRecordDecl>, InnerMatcher) { 2376e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper const CXXRecordDecl *Parent = Node.getParent(); 23774da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return (Parent != NULL && 23784da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek InnerMatcher.matches(*Parent, Finder, Builder)); 23794da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 23804da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 23814da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches member expressions that are called with '->' as opposed 23824da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// to '.'. 23834da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 23844da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Member calls on the implicit this pointer match as called with '->'. 23854da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 23864da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 238725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 23884da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// class Y { 23894da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void x() { this->x(); x(); Y y; y.x(); a; this->b; Y::b; } 23904da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int a; 23914da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// static int b; 23924da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// }; 239325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 23942dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// memberExpr(isArrow()) 23954da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches this->x, x, y.x, a, this->b 2396e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperinline internal::Matcher<MemberExpr> isArrow() { 23974da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return makeMatcher(new internal::IsArrowMatcher()); 23984da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 23994da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 24006a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// \brief Matches QualType nodes that are of integer type. 24016a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// 24026a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// Given 240325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 24046a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// void a(int); 24056a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// void b(long); 24066a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// void c(double); 240725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 24082dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// functionDecl(hasAnyParameter(hasType(isInteger()))) 24096a12449ec8862211856447d3df4c082a346339f2Daniel Jasper/// matches "a(int)", "b(long)", but not "c(double)". 24106a12449ec8862211856447d3df4c082a346339f2Daniel JasperAST_MATCHER(QualType, isInteger) { 24116a12449ec8862211856447d3df4c082a346339f2Daniel Jasper return Node->isIntegerType(); 24126a12449ec8862211856447d3df4c082a346339f2Daniel Jasper} 24136a12449ec8862211856447d3df4c082a346339f2Daniel Jasper 2414e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches QualType nodes that are const-qualified, i.e., that 24154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// include "top-level" const. 24164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 24174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 241825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 24194da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void a(int); 24204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void b(int const); 24214da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void c(const int); 24224da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void d(const int*); 24234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void e(int const) {}; 242425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 24252dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// functionDecl(hasAnyParameter(hasType(isConstQualified()))) 24264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches "void b(int const)", "void c(const int)" and 24274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// "void e(int const) {}". It does not match d as there 24284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// is no top-level const on the parameter type "const int *". 2429e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasperinline internal::Matcher<QualType> isConstQualified() { 24304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return makeMatcher(new internal::IsConstQualifiedMatcher()); 24314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 24324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 24334da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a member expression where the member is matched by a 24344da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// given matcher. 24354da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 24364da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 243725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 24384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct { int first, second; } first, second; 24394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int i(second.first); 24404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// int j(first.second); 244125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 24422dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// memberExpr(member(hasName("first"))) 24434da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches second.first 24444da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// but not first.second (because the member name there is "second"). 2445e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(MemberExpr, member, 2446e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<ValueDecl>, InnerMatcher) { 24474da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return InnerMatcher.matches(*Node.getMemberDecl(), Finder, Builder); 24484da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 24494da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 24504da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches a member expression where the object expression is 24514da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matched by a given matcher. 24524da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 24534da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 245425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 24554da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// struct X { int m; }; 24564da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// void f(X x) { x.m; m; } 245725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 24582dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// memberExpr(hasObjectExpression(hasType(recordDecl(hasName("X"))))))) 24594da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches "x.m" and "m" 24604da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// with hasObjectExpression(...) 24614da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matching "x" and the implicit object expression of "m" which has type X*. 2462e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(MemberExpr, hasObjectExpression, 2463e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 24644da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return InnerMatcher.matches(*Node.getBase(), Finder, Builder); 24654da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 24664da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 2467e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches any using shadow declaration. 2468e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 2469e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 247025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2471e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// namespace X { void b(); } 2472e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// using X::b; 247325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 2474e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// usingDecl(hasAnyUsingShadowDecl(hasName("b")))) 2475e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \code using X::b \endcode 2476e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(UsingDecl, hasAnyUsingShadowDecl, 247725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<UsingShadowDecl>, InnerMatcher) { 2478e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper for (UsingDecl::shadow_iterator II = Node.shadow_begin(); 2479e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper II != Node.shadow_end(); ++II) { 248025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek if (InnerMatcher.matches(**II, Finder, Builder)) 2481e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return true; 2482e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper } 2483e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper return false; 2484e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 2485e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 2486e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// \brief Matches a using shadow declaration where the target declaration is 2487e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matched by the given matcher. 2488e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// 2489e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// Given 249025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 2491e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// namespace X { int a; void b(); } 2492e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// using X::a; 2493e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// using X::b; 249425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 24952dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// usingDecl(hasAnyUsingShadowDecl(hasTargetDecl(functionDecl()))) 2496e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// matches \code using X::b \endcode 2497e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper/// but not \code using X::a \endcode 2498e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel JasperAST_MATCHER_P(UsingShadowDecl, hasTargetDecl, 249925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek internal::Matcher<NamedDecl>, InnerMatcher) { 250025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek return InnerMatcher.matches(*Node.getTargetDecl(), Finder, Builder); 2501e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper} 2502e0e6b9e79a0c4edae92abd3928263875c78e23aaDaniel Jasper 25034da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// \brief Matches template instantiations of function, class, or static 25044da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// member variable template instantiations. 25054da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 25064da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// Given 250725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 25084da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// template <typename T> class X {}; class A {}; X<A> x; 250925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 25104da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// or 251125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 25124da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// template <typename T> class X {}; class A {}; template class X<A>; 251325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 25142dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// recordDecl(hasName("::X"), isTemplateInstantiation()) 25154da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// matches the template instantiation of X<A>. 25164da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// 25174da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// But given 251825466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 251925466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// template <typename T> class X {}; class A {}; 25204da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// template <> class X<A> {}; X<A> x; 252125466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 25222dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// recordDecl(hasName("::X"), isTemplateInstantiation()) 25234da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek/// does not match, as X<A> is an explicit template specialization. 2524297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// 2525297f71daa4eec8beb2eb29573e0892539f8e7172Manuel Klimek/// Usable as: Matcher<FunctionDecl>, Matcher<VarDecl>, Matcher<CXXRecordDecl> 25264da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimekinline internal::PolymorphicMatcherWithParam0< 25274da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek internal::IsTemplateInstantiationMatcher> 25284da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel KlimekisTemplateInstantiation() { 25294da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek return internal::PolymorphicMatcherWithParam0< 25304da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek internal::IsTemplateInstantiationMatcher>(); 25314da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} 25324da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 25338456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// \brief Matches explicit template specializations of function, class, or 25348456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// static member variable template instantiations. 25358456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// 25368456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// Given 253725466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \code 25388456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// template<typename T> void A(T t) { } 25398456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// template<> void A(int N) { } 254025466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// \endcode 25412dc75ed2ef2fa3cbfd8b2ed88eb2369f3fcd98a9Daniel Jasper/// functionDecl(isExplicitTemplateSpecialization()) 25428456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko/// matches the specialization A<int>(). 254325466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// 254425466496a2ace2aa533abc7bac1e92a4f425e2b1Manuel Klimek/// Usable as: Matcher<FunctionDecl>, Matcher<VarDecl>, Matcher<CXXRecordDecl> 25458456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenkoinline internal::PolymorphicMatcherWithParam0< 25468456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko internal::IsExplicitTemplateSpecializationMatcher> 25478456ae602783b615019a42f7d5c6f0e71639b11bDmitri GribenkoisExplicitTemplateSpecialization() { 25488456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko return internal::PolymorphicMatcherWithParam0< 25498456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko internal::IsExplicitTemplateSpecializationMatcher>(); 25508456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko} 25518456ae602783b615019a42f7d5c6f0e71639b11bDmitri Gribenko 2552ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches \c TypeLocs for which the given inner 2553ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// QualType-matcher matches. 2554ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasperinline internal::BindableMatcher<TypeLoc> loc( 2555ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper const internal::Matcher<QualType> &InnerMatcher) { 2556ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper return internal::BindableMatcher<TypeLoc>( 2557ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper new internal::TypeLocTypeMatcher(InnerMatcher)); 2558ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper} 2559ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2560ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches builtin Types. 2561ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2562ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2563ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2564ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// struct A {}; 2565ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// A a; 2566ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int b; 2567ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// float c; 2568ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// bool d; 2569ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2570ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// builtinType() 2571ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int b", "float c" and "bool d" 2572ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(BuiltinType, builtinType); 2573ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2574ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches all kinds of arrays. 2575ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2576ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2577ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2578ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int a[] = { 2, 3 }; 2579ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int b[4]; 2580ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// void f() { int c[a[0]]; } 2581ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2582ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// arrayType() 2583ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int a[]", "int b[4]" and "int c[a[0]]"; 2584ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(ArrayType, arrayType); 2585ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2586ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches C99 complex types. 2587ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2588ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2589ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2590ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// _Complex float f; 2591ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2592ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// complexType() 2593ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "_Complex float f" 2594ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(ComplexType, complexType); 2595ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2596ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches arrays and C99 complex types that have a specific element 2597ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// type. 2598ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2599ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2600ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2601ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// struct A {}; 2602ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// A a[7]; 2603ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int b[7]; 2604ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2605ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// arrayType(hasElementType(builtinType())) 2606ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int b[7]" 2607ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2608ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Usable as: Matcher<ArrayType>, Matcher<ComplexType> 2609ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPELOC_TRAVERSE_MATCHER(hasElementType, getElement); 2610ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2611ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches C arrays with a specified constant size. 2612ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2613ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2614ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2615ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// void() { 2616ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int a[2]; 2617ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int b[] = { 2, 3 }; 2618ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int c[b[0]]; 2619ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// } 2620ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2621ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// constantArrayType() 2622ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int a[2]" 2623ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(ConstantArrayType, constantArrayType); 2624ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2625ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches \c ConstantArrayType nodes that have the specified size. 2626ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2627ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2628ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2629ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int a[42]; 2630ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int b[2 * 21]; 2631ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int c[41], d[43]; 2632ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2633ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// constantArrayType(hasSize(42)) 2634ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int a[42]" and "int b[2 * 21]" 2635ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_MATCHER_P(ConstantArrayType, hasSize, unsigned, N) { 2636ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper return Node.getSize() == N; 2637ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper} 2638ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2639ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches C++ arrays whose size is a value-dependent expression. 2640ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2641ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2642ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2643ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// template<typename T, int Size> 2644ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// class array { 2645ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// T data[Size]; 2646ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// }; 2647ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2648ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// dependentSizedArrayType 2649ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "T data[Size]" 2650ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(DependentSizedArrayType, dependentSizedArrayType); 2651ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2652ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches C arrays with unspecified size. 2653ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2654ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2655ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2656ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int a[] = { 2, 3 }; 2657ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int b[42]; 2658ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// void f(int c[]) { int d[a[0]]; }; 2659ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2660ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// incompleteArrayType() 2661ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int a[]" and "int c[]" 2662ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(IncompleteArrayType, incompleteArrayType); 2663ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2664ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches C arrays with a specified size that is not an 2665ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// integer-constant-expression. 2666ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2667ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2668ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2669ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// void f() { 2670ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int a[] = { 2, 3 } 2671ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int b[42]; 2672ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int c[a[0]]; 2673ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2674ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// variableArrayType() 2675ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int c[a[0]]" 2676ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(VariableArrayType, variableArrayType); 2677ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2678ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches \c VariableArrayType nodes that have a specific size 2679ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// expression. 2680ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2681ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2682ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2683ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// void f(int b) { 2684ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int a[b]; 2685ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// } 2686ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2687ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// variableArrayType(hasSizeExpr(ignoringImpCasts(declRefExpr(to( 2688ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// varDecl(hasName("b"))))))) 2689ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int a[b]" 2690ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_MATCHER_P(VariableArrayType, hasSizeExpr, 2691ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper internal::Matcher<Expr>, InnerMatcher) { 2692ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper return InnerMatcher.matches(*Node.getSizeExpr(), Finder, Builder); 2693ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper} 2694ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2695ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches atomic types. 2696ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2697ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2698ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2699ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// _Atomic(int) i; 2700ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2701ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// atomicType() 2702ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "_Atomic(int) i" 2703ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(AtomicType, atomicType); 2704ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2705ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches atomic types with a specific value type. 2706ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2707ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2708ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2709ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// _Atomic(int) i; 2710ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// _Atomic(float) f; 2711ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2712ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// atomicType(hasValueType(isInteger())) 2713ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "_Atomic(int) i" 2714ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2715ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Usable as: Matcher<AtomicType> 2716ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPELOC_TRAVERSE_MATCHER(hasValueType, getValue); 2717ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2718ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches types nodes representing C++11 auto types. 2719ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2720ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given: 2721ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2722ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// auto n = 4; 2723ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int v[] = { 2, 3 } 2724ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// for (auto i : v) { } 2725ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2726ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// autoType() 2727ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "auto n" and "auto i" 2728ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(AutoType, autoType); 2729ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2730ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches \c AutoType nodes where the deduced type is a specific type. 2731ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2732ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Note: There is no \c TypeLoc for the deduced type and thus no 2733ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \c getDeducedLoc() matcher. 2734ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2735ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2736ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2737ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// auto a = 1; 2738ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// auto b = 2.0; 2739ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2740ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// autoType(hasDeducedType(isInteger())) 2741ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "auto a" 2742ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2743ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Usable as: Matcher<AutoType> 2744ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_TRAVERSE_MATCHER(hasDeducedType, getDeducedType); 2745ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2746a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// \brief Matches \c FunctionType nodes. 2747a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// 2748a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// Given 2749a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// \code 2750a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// int (*f)(int); 2751a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// void g(); 2752a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// \endcode 2753a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// functionType() 2754a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper/// matches "int (*f)(int)" and the type of "g". 2755a267cf6f87dc695143d65fc61ec1744564f55932Daniel JasperAST_TYPE_MATCHER(FunctionType, functionType); 2756a267cf6f87dc695143d65fc61ec1744564f55932Daniel Jasper 2757ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches block pointer types, i.e. types syntactically represented as 2758ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// "void (^)(int)". 2759ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2760ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// The \c pointee is always required to be a \c FunctionType. 2761ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(BlockPointerType, blockPointerType); 2762ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2763ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches member pointer types. 2764ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2765ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2766ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// struct A { int i; } 2767ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// A::* ptr = A::i; 2768ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2769ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// memberPointerType() 2770ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "A::* ptr" 2771ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(MemberPointerType, memberPointerType); 2772ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2773ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches pointer types. 2774ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2775ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2776ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2777ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int *a; 2778ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int &b = *a; 2779ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int c = 5; 2780ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2781ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// pointerType() 2782ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int *a" 2783ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(PointerType, pointerType); 2784ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2785ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches reference types. 2786ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2787ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2788ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2789ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int *a; 2790ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int &b = *a; 2791ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int c = 5; 2792ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2793ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// pointerType() 2794ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int &b" 2795ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(ReferenceType, referenceType); 2796ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2797ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Narrows PointerType (and similar) matchers to those where the 2798ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \c pointee matches a given matcher. 2799ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2800ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2801ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2802ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int *a; 2803ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// int const *b; 2804ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// float const *f; 2805ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2806ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// pointerType(pointee(isConstQualified(), isInteger())) 2807ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "int const *b" 2808ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2809ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Usable as: Matcher<BlockPointerType>, Matcher<MemberPointerType>, 2810ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Matcher<PointerType>, Matcher<ReferenceType> 2811ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPELOC_TRAVERSE_MATCHER(pointee, getPointee); 2812ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2813ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches typedef types. 2814ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2815ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2816ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2817ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// typedef int X; 2818ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2819ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// typedefType() 2820ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "typedef int X" 2821ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_TYPE_MATCHER(TypedefType, typedefType); 2822ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2823ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches \c TypedefTypes referring to a specific 2824ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \c TypedefNameDecl. 2825ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_MATCHER_P(TypedefType, hasDecl, 2826ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper internal::Matcher<TypedefNameDecl>, InnerMatcher) { 2827ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper return InnerMatcher.matches(*Node.getDecl(), Finder, Builder); 2828ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper} 2829ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2830a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \brief Matches nested name specifiers. 2831a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// 2832a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// Given 2833a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \code 2834a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// namespace ns { 2835a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// struct A { static void f(); }; 2836a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// void A::f() {} 2837a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// void g() { A::f(); } 2838a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// } 2839a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// ns::A a; 2840a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \endcode 2841a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// nestedNameSpecifier() 2842a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// matches "ns::" and both "A::" 2843a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasperconst internal::VariadicAllOfMatcher<NestedNameSpecifier> nestedNameSpecifier; 2844a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper 2845a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \brief Same as \c nestedNameSpecifier but matches \c NestedNameSpecifierLoc. 2846a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasperconst internal::VariadicAllOfMatcher< 2847a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper NestedNameSpecifierLoc> nestedNameSpecifierLoc; 2848a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper 2849a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \brief Matches \c NestedNameSpecifierLocs for which the given inner 2850a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// NestedNameSpecifier-matcher matches. 2851a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasperinline internal::BindableMatcher<NestedNameSpecifierLoc> loc( 2852a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper const internal::Matcher<NestedNameSpecifier> &InnerMatcher) { 2853a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper return internal::BindableMatcher<NestedNameSpecifierLoc>( 2854a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper new internal::LocMatcher<NestedNameSpecifierLoc, NestedNameSpecifier>( 2855a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper InnerMatcher)); 2856a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper} 2857a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper 2858a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \brief Matches nested name specifiers that specify a type matching the 2859a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// given \c QualType matcher without qualifiers. 2860a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// 2861a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// Given 2862a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \code 2863a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// struct A { struct B { struct C {}; }; }; 2864a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// A::B::C c; 2865a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \endcode 2866a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// nestedNameSpecifier(specifiesType(hasDeclaration(recordDecl(hasName("A"))))) 2867a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// matches "A::" 2868a7564433191601cb8851196b8dde39392c9c05eeDaniel JasperAST_MATCHER_P(NestedNameSpecifier, specifiesType, 2869a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper internal::Matcher<QualType>, InnerMatcher) { 2870a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper if (Node.getAsType() == NULL) 2871a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper return false; 2872a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper return InnerMatcher.matches(QualType(Node.getAsType(), 0), Finder, Builder); 2873a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper} 2874a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper 2875ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches nested name specifier locs that specify a type matching the 2876ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// given \c TypeLoc. 2877ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2878ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2879ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2880ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// struct A { struct B { struct C {}; }; }; 2881ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// A::B::C c; 2882ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2883ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// nestedNameSpecifierLoc(specifiesTypeLoc(loc(type( 2884ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// hasDeclaration(recordDecl(hasName("A"))))))) 2885ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "A::" 2886ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel JasperAST_MATCHER_P(NestedNameSpecifierLoc, specifiesTypeLoc, 2887ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper internal::Matcher<TypeLoc>, InnerMatcher) { 2888ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper return InnerMatcher.matches(Node.getTypeLoc(), Finder, Builder); 2889ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper} 2890ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2891ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches on the prefix of a \c NestedNameSpecifier. 2892a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// 2893a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// Given 2894a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \code 2895a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// struct A { struct B { struct C {}; }; }; 2896a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// A::B::C c; 2897a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \endcode 2898a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// nestedNameSpecifier(hasPrefix(specifiesType(asString("struct A")))) and 2899ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "A::" 2900ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasperinline internal::Matcher<NestedNameSpecifier> hasPrefix( 2901ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper const internal::Matcher<NestedNameSpecifier> &InnerMatcher) { 2902ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper return internal::makeMatcher( 2903ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper new internal::NestedNameSpecifierPrefixMatcher(InnerMatcher)); 2904ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper} 2905ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper 2906ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \brief Matches on the prefix of a \c NestedNameSpecifierLoc. 2907ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// 2908ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// Given 2909ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \code 2910ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// struct A { struct B { struct C {}; }; }; 2911ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// A::B::C c; 2912ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// \endcode 2913a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// nestedNameSpecifierLoc(hasPrefix(loc(specifiesType(asString("struct A"))))) 2914ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper/// matches "A::" 2915ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasperinline internal::Matcher<NestedNameSpecifierLoc> hasPrefix( 2916ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper const internal::Matcher<NestedNameSpecifierLoc> &InnerMatcher) { 2917ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper return internal::makeMatcher( 2918ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper new internal::NestedNameSpecifierLocPrefixMatcher(InnerMatcher)); 2919ce62007526cdf718faed10df5e9fc7c3cd160cdeDaniel Jasper} 2920a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper 2921a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \brief Matches nested name specifiers that specify a namespace matching the 2922a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// given namespace matcher. 2923a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// 2924a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// Given 2925a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \code 2926a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// namespace ns { struct A {}; } 2927a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// ns::A a; 2928a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// \endcode 2929a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// nestedNameSpecifier(specifiesNamespace(hasName("ns"))) 2930a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper/// matches "ns::" 2931a7564433191601cb8851196b8dde39392c9c05eeDaniel JasperAST_MATCHER_P(NestedNameSpecifier, specifiesNamespace, 2932a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper internal::Matcher<NamespaceDecl>, InnerMatcher) { 2933a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper if (Node.getAsNamespace() == NULL) 2934a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper return false; 2935a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper return InnerMatcher.matches(*Node.getAsNamespace(), Finder, Builder); 2936a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper} 2937a7564433191601cb8851196b8dde39392c9c05eeDaniel Jasper 29384da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} // end namespace ast_matchers 29394da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek} // end namespace clang 29404da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek 29414da216637fa1ad4bdfd31bc265edb57ca35c2c12Manuel Klimek#endif // LLVM_CLANG_AST_MATCHERS_AST_MATCHERS_H 2942