1//===- Registry.cpp - Matcher registry ------------------------------------===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9/// \file
10/// Registry map populated at static initialization time.
11//
12//===----------------------------------------------------------------------===//
13
14#include "clang/ASTMatchers/Dynamic/Registry.h"
15#include "Marshallers.h"
16#include "clang/AST/ASTTypeTraits.h"
17#include "clang/ASTMatchers/ASTMatchers.h"
18#include "clang/ASTMatchers/Dynamic/Diagnostics.h"
19#include "clang/ASTMatchers/Dynamic/VariantValue.h"
20#include "llvm/ADT/Optional.h"
21#include "llvm/ADT/STLExtras.h"
22#include "llvm/ADT/StringMap.h"
23#include "llvm/ADT/StringRef.h"
24#include "llvm/Support/ManagedStatic.h"
25#include "llvm/Support/raw_ostream.h"
26#include <cassert>
27#include <iterator>
28#include <memory>
29#include <set>
30#include <string>
31#include <utility>
32#include <vector>
33
34using namespace clang::ast_type_traits;
35
36namespace clang {
37namespace ast_matchers {
38namespace dynamic {
39
40namespace {
41
42using internal::MatcherDescriptor;
43
44using ConstructorMap =
45    llvm::StringMap<std::unique_ptr<const MatcherDescriptor>>;
46
47class RegistryMaps {
48public:
49  RegistryMaps();
50  ~RegistryMaps();
51
52  const ConstructorMap &constructors() const { return Constructors; }
53
54private:
55  void registerMatcher(StringRef MatcherName,
56                       std::unique_ptr<MatcherDescriptor> Callback);
57
58  ConstructorMap Constructors;
59};
60
61} // namespace
62
63void RegistryMaps::registerMatcher(
64    StringRef MatcherName, std::unique_ptr<MatcherDescriptor> Callback) {
65  assert(Constructors.find(MatcherName) == Constructors.end());
66  Constructors[MatcherName] = std::move(Callback);
67}
68
69#define REGISTER_MATCHER(name)                                                 \
70  registerMatcher(#name, internal::makeMatcherAutoMarshall(                    \
71                             ::clang::ast_matchers::name, #name));
72
73#define REGISTER_MATCHER_OVERLOAD(name)                                        \
74  registerMatcher(#name,                                                       \
75      std::make_unique<internal::OverloadedMatcherDescriptor>(name##Callbacks))
76
77#define SPECIFIC_MATCHER_OVERLOAD(name, Id)                                    \
78  static_cast<::clang::ast_matchers::name##_Type##Id>(                         \
79      ::clang::ast_matchers::name)
80
81#define MATCHER_OVERLOAD_ENTRY(name, Id)                                       \
82        internal::makeMatcherAutoMarshall(SPECIFIC_MATCHER_OVERLOAD(name, Id), \
83                                          #name)
84
85#define REGISTER_OVERLOADED_2(name)                                            \
86  do {                                                                         \
87    std::unique_ptr<MatcherDescriptor> name##Callbacks[] = {                   \
88        MATCHER_OVERLOAD_ENTRY(name, 0),                                       \
89        MATCHER_OVERLOAD_ENTRY(name, 1)};                                      \
90    REGISTER_MATCHER_OVERLOAD(name);                                           \
91  } while (false)
92
93#define REGISTER_REGEX_MATCHER(name)                                           \
94  registerMatcher(#name, internal::makeMatcherRegexMarshall(name, name))
95
96/// Generate a registry map with all the known matchers.
97/// Please keep sorted alphabetically!
98RegistryMaps::RegistryMaps() {
99  // TODO: Here is the list of the missing matchers, grouped by reason.
100  //
101  // Polymorphic + argument overload:
102  // findAll
103  //
104  // Other:
105  // equalsNode
106
107  REGISTER_OVERLOADED_2(callee);
108  REGISTER_OVERLOADED_2(hasAnyCapture);
109  REGISTER_OVERLOADED_2(hasPrefix);
110  REGISTER_OVERLOADED_2(hasType);
111  REGISTER_OVERLOADED_2(ignoringParens);
112  REGISTER_OVERLOADED_2(isDerivedFrom);
113  REGISTER_OVERLOADED_2(isDirectlyDerivedFrom);
114  REGISTER_OVERLOADED_2(isSameOrDerivedFrom);
115  REGISTER_OVERLOADED_2(loc);
116  REGISTER_OVERLOADED_2(pointsTo);
117  REGISTER_OVERLOADED_2(references);
118  REGISTER_OVERLOADED_2(thisPointerType);
119
120  std::unique_ptr<MatcherDescriptor> equalsCallbacks[] = {
121      MATCHER_OVERLOAD_ENTRY(equals, 0),
122      MATCHER_OVERLOAD_ENTRY(equals, 1),
123      MATCHER_OVERLOAD_ENTRY(equals, 2),
124  };
125  REGISTER_MATCHER_OVERLOAD(equals);
126
127  REGISTER_REGEX_MATCHER(isExpansionInFileMatching);
128  REGISTER_REGEX_MATCHER(matchesName);
129  REGISTER_REGEX_MATCHER(matchesSelector);
130
131  REGISTER_MATCHER(accessSpecDecl);
132  REGISTER_MATCHER(addrLabelExpr);
133  REGISTER_MATCHER(alignOfExpr);
134  REGISTER_MATCHER(allOf);
135  REGISTER_MATCHER(anyOf);
136  REGISTER_MATCHER(anything);
137  REGISTER_MATCHER(argumentCountIs);
138  REGISTER_MATCHER(arraySubscriptExpr);
139  REGISTER_MATCHER(arrayType);
140  REGISTER_MATCHER(asString);
141  REGISTER_MATCHER(asmStmt);
142  REGISTER_MATCHER(atomicExpr);
143  REGISTER_MATCHER(atomicType);
144  REGISTER_MATCHER(autoType);
145  REGISTER_MATCHER(autoreleasePoolStmt)
146  REGISTER_MATCHER(binaryConditionalOperator);
147  REGISTER_MATCHER(binaryOperator);
148  REGISTER_MATCHER(blockDecl);
149  REGISTER_MATCHER(blockExpr);
150  REGISTER_MATCHER(blockPointerType);
151  REGISTER_MATCHER(booleanType);
152  REGISTER_MATCHER(breakStmt);
153  REGISTER_MATCHER(builtinType);
154  REGISTER_MATCHER(cStyleCastExpr);
155  REGISTER_MATCHER(callExpr);
156  REGISTER_MATCHER(caseStmt);
157  REGISTER_MATCHER(castExpr);
158  REGISTER_MATCHER(characterLiteral);
159  REGISTER_MATCHER(chooseExpr);
160  REGISTER_MATCHER(classTemplateDecl);
161  REGISTER_MATCHER(classTemplatePartialSpecializationDecl);
162  REGISTER_MATCHER(classTemplateSpecializationDecl);
163  REGISTER_MATCHER(complexType);
164  REGISTER_MATCHER(compoundLiteralExpr);
165  REGISTER_MATCHER(compoundStmt);
166  REGISTER_MATCHER(conditionalOperator);
167  REGISTER_MATCHER(constantArrayType);
168  REGISTER_MATCHER(constantExpr);
169  REGISTER_MATCHER(containsDeclaration);
170  REGISTER_MATCHER(continueStmt);
171  REGISTER_MATCHER(cudaKernelCallExpr);
172  REGISTER_MATCHER(cxxBindTemporaryExpr);
173  REGISTER_MATCHER(cxxBoolLiteral);
174  REGISTER_MATCHER(cxxCatchStmt);
175  REGISTER_MATCHER(cxxConstCastExpr);
176  REGISTER_MATCHER(cxxConstructExpr);
177  REGISTER_MATCHER(cxxConstructorDecl);
178  REGISTER_MATCHER(cxxConversionDecl);
179  REGISTER_MATCHER(cxxCtorInitializer);
180  REGISTER_MATCHER(cxxDeductionGuideDecl);
181  REGISTER_MATCHER(cxxDefaultArgExpr);
182  REGISTER_MATCHER(cxxDeleteExpr);
183  REGISTER_MATCHER(cxxDependentScopeMemberExpr);
184  REGISTER_MATCHER(cxxDestructorDecl);
185  REGISTER_MATCHER(cxxDynamicCastExpr);
186  REGISTER_MATCHER(cxxForRangeStmt);
187  REGISTER_MATCHER(cxxFunctionalCastExpr);
188  REGISTER_MATCHER(cxxMemberCallExpr);
189  REGISTER_MATCHER(cxxMethodDecl);
190  REGISTER_MATCHER(cxxNewExpr);
191  REGISTER_MATCHER(cxxNoexceptExpr);
192  REGISTER_MATCHER(cxxNullPtrLiteralExpr);
193  REGISTER_MATCHER(cxxOperatorCallExpr);
194  REGISTER_MATCHER(cxxRecordDecl);
195  REGISTER_MATCHER(cxxReinterpretCastExpr);
196  REGISTER_MATCHER(cxxStaticCastExpr);
197  REGISTER_MATCHER(cxxStdInitializerListExpr);
198  REGISTER_MATCHER(cxxTemporaryObjectExpr);
199  REGISTER_MATCHER(cxxThisExpr);
200  REGISTER_MATCHER(cxxThrowExpr);
201  REGISTER_MATCHER(cxxTryStmt);
202  REGISTER_MATCHER(cxxUnresolvedConstructExpr);
203  REGISTER_MATCHER(decayedType);
204  REGISTER_MATCHER(decl);
205  REGISTER_MATCHER(declCountIs);
206  REGISTER_MATCHER(declRefExpr);
207  REGISTER_MATCHER(declStmt);
208  REGISTER_MATCHER(declaratorDecl);
209  REGISTER_MATCHER(decltypeType);
210  REGISTER_MATCHER(deducedTemplateSpecializationType);
211  REGISTER_MATCHER(defaultStmt);
212  REGISTER_MATCHER(dependentSizedArrayType);
213  REGISTER_MATCHER(designatedInitExpr);
214  REGISTER_MATCHER(designatorCountIs);
215  REGISTER_MATCHER(doStmt);
216  REGISTER_MATCHER(eachOf);
217  REGISTER_MATCHER(elaboratedType);
218  REGISTER_MATCHER(enumConstantDecl);
219  REGISTER_MATCHER(enumDecl);
220  REGISTER_MATCHER(enumType);
221  REGISTER_MATCHER(equalsBoundNode);
222  REGISTER_MATCHER(equalsIntegralValue);
223  REGISTER_MATCHER(explicitCastExpr);
224  REGISTER_MATCHER(expr);
225  REGISTER_MATCHER(exprWithCleanups);
226  REGISTER_MATCHER(fieldDecl);
227  REGISTER_MATCHER(floatLiteral);
228  REGISTER_MATCHER(forEach);
229  REGISTER_MATCHER(forEachArgumentWithParam);
230  REGISTER_MATCHER(forEachConstructorInitializer);
231  REGISTER_MATCHER(forEachDescendant);
232  REGISTER_MATCHER(forEachOverridden);
233  REGISTER_MATCHER(forEachSwitchCase);
234  REGISTER_MATCHER(forField);
235  REGISTER_MATCHER(forFunction);
236  REGISTER_MATCHER(forStmt);
237  REGISTER_MATCHER(friendDecl);
238  REGISTER_MATCHER(functionDecl);
239  REGISTER_MATCHER(functionProtoType);
240  REGISTER_MATCHER(functionTemplateDecl);
241  REGISTER_MATCHER(functionType);
242  REGISTER_MATCHER(gnuNullExpr);
243  REGISTER_MATCHER(gotoStmt);
244  REGISTER_MATCHER(has);
245  REGISTER_MATCHER(hasAncestor);
246  REGISTER_MATCHER(hasAnyArgument);
247  REGISTER_MATCHER(hasAnyBase);
248  REGISTER_MATCHER(hasAnyClause);
249  REGISTER_MATCHER(hasAnyConstructorInitializer);
250  REGISTER_MATCHER(hasAnyDeclaration);
251  REGISTER_MATCHER(hasAnyName);
252  REGISTER_MATCHER(hasAnyOperatorName);
253  REGISTER_MATCHER(hasAnyOverloadedOperatorName);
254  REGISTER_MATCHER(hasAnyParameter);
255  REGISTER_MATCHER(hasAnyPlacementArg);
256  REGISTER_MATCHER(hasAnySelector);
257  REGISTER_MATCHER(hasAnySubstatement);
258  REGISTER_MATCHER(hasAnyTemplateArgument);
259  REGISTER_MATCHER(hasAnyUsingShadowDecl);
260  REGISTER_MATCHER(hasArgument);
261  REGISTER_MATCHER(hasArgumentOfType);
262  REGISTER_MATCHER(hasArraySize);
263  REGISTER_MATCHER(hasAttr);
264  REGISTER_MATCHER(hasAutomaticStorageDuration);
265  REGISTER_MATCHER(hasBase);
266  REGISTER_MATCHER(hasBitWidth);
267  REGISTER_MATCHER(hasBody);
268  REGISTER_MATCHER(hasCanonicalType);
269  REGISTER_MATCHER(hasCaseConstant);
270  REGISTER_MATCHER(hasCastKind);
271  REGISTER_MATCHER(hasCondition);
272  REGISTER_MATCHER(hasConditionVariableStatement);
273  REGISTER_MATCHER(hasDecayedType);
274  REGISTER_MATCHER(hasDeclContext);
275  REGISTER_MATCHER(hasDeclaration);
276  REGISTER_MATCHER(hasDeducedType);
277  REGISTER_MATCHER(hasDefaultArgument);
278  REGISTER_MATCHER(hasDefinition);
279  REGISTER_MATCHER(hasDescendant);
280  REGISTER_MATCHER(hasDestinationType);
281  REGISTER_MATCHER(hasDirectBase);
282  REGISTER_MATCHER(hasDynamicExceptionSpec);
283  REGISTER_MATCHER(hasEitherOperand);
284  REGISTER_MATCHER(hasElementType);
285  REGISTER_MATCHER(hasElse);
286  REGISTER_MATCHER(hasExplicitSpecifier);
287  REGISTER_MATCHER(hasExternalFormalLinkage);
288  REGISTER_MATCHER(hasFalseExpression);
289  REGISTER_MATCHER(hasGlobalStorage);
290  REGISTER_MATCHER(hasImplicitDestinationType);
291  REGISTER_MATCHER(hasInClassInitializer);
292  REGISTER_MATCHER(hasIncrement);
293  REGISTER_MATCHER(hasIndex);
294  REGISTER_MATCHER(hasInit);
295  REGISTER_MATCHER(hasInitializer);
296  REGISTER_MATCHER(hasInitStatement);
297  REGISTER_MATCHER(hasKeywordSelector);
298  REGISTER_MATCHER(hasLHS);
299  REGISTER_MATCHER(hasLocalQualifiers);
300  REGISTER_MATCHER(hasLocalStorage);
301  REGISTER_MATCHER(hasLoopInit);
302  REGISTER_MATCHER(hasLoopVariable);
303  REGISTER_MATCHER(hasMethod);
304  REGISTER_MATCHER(hasName);
305  REGISTER_MATCHER(hasNullSelector);
306  REGISTER_MATCHER(hasObjectExpression);
307  REGISTER_MATCHER(hasOperands);
308  REGISTER_MATCHER(hasOperatorName);
309  REGISTER_MATCHER(hasOverloadedOperatorName);
310  REGISTER_MATCHER(hasParameter);
311  REGISTER_MATCHER(hasParent);
312  REGISTER_MATCHER(hasQualifier);
313  REGISTER_MATCHER(hasRHS);
314  REGISTER_MATCHER(hasRangeInit);
315  REGISTER_MATCHER(hasReceiver);
316  REGISTER_MATCHER(hasReceiverType);
317  REGISTER_MATCHER(hasReplacementType);
318  REGISTER_MATCHER(hasReturnValue);
319  REGISTER_MATCHER(hasPlacementArg);
320  REGISTER_MATCHER(hasSelector);
321  REGISTER_MATCHER(hasSingleDecl);
322  REGISTER_MATCHER(hasSize);
323  REGISTER_MATCHER(hasSizeExpr);
324  REGISTER_MATCHER(hasSourceExpression);
325  REGISTER_MATCHER(hasSpecializedTemplate);
326  REGISTER_MATCHER(hasStaticStorageDuration);
327  REGISTER_MATCHER(hasStructuredBlock);
328  REGISTER_MATCHER(hasSyntacticForm);
329  REGISTER_MATCHER(hasTargetDecl);
330  REGISTER_MATCHER(hasTemplateArgument);
331  REGISTER_MATCHER(hasThen);
332  REGISTER_MATCHER(hasThreadStorageDuration);
333  REGISTER_MATCHER(hasTrailingReturn);
334  REGISTER_MATCHER(hasTrueExpression);
335  REGISTER_MATCHER(hasTypeLoc);
336  REGISTER_MATCHER(hasUnaryOperand);
337  REGISTER_MATCHER(hasUnarySelector);
338  REGISTER_MATCHER(hasUnderlyingDecl);
339  REGISTER_MATCHER(hasUnderlyingType);
340  REGISTER_MATCHER(hasUnqualifiedDesugaredType);
341  REGISTER_MATCHER(hasValueType);
342  REGISTER_MATCHER(ifStmt);
343  REGISTER_MATCHER(ignoringElidableConstructorCall);
344  REGISTER_MATCHER(ignoringImpCasts);
345  REGISTER_MATCHER(ignoringImplicit);
346  REGISTER_MATCHER(ignoringParenCasts);
347  REGISTER_MATCHER(ignoringParenImpCasts);
348  REGISTER_MATCHER(imaginaryLiteral);
349  REGISTER_MATCHER(implicitCastExpr);
350  REGISTER_MATCHER(implicitValueInitExpr);
351  REGISTER_MATCHER(incompleteArrayType);
352  REGISTER_MATCHER(indirectFieldDecl);
353  REGISTER_MATCHER(initListExpr);
354  REGISTER_MATCHER(injectedClassNameType);
355  REGISTER_MATCHER(innerType);
356  REGISTER_MATCHER(integerLiteral);
357  REGISTER_MATCHER(isAllowedToContainClauseKind);
358  REGISTER_MATCHER(isAnonymous);
359  REGISTER_MATCHER(isAnyCharacter);
360  REGISTER_MATCHER(isAnyPointer);
361  REGISTER_MATCHER(isArray);
362  REGISTER_MATCHER(isArrow);
363  REGISTER_MATCHER(isAssignmentOperator);
364  REGISTER_MATCHER(isAtPosition);
365  REGISTER_MATCHER(isBaseInitializer);
366  REGISTER_MATCHER(isBitField);
367  REGISTER_MATCHER(isCatchAll);
368  REGISTER_MATCHER(isClass);
369  REGISTER_MATCHER(isClassMessage);
370  REGISTER_MATCHER(isClassMethod);
371  REGISTER_MATCHER(isComparisonOperator);
372  REGISTER_MATCHER(isConst);
373  REGISTER_MATCHER(isConstQualified);
374  REGISTER_MATCHER(isConstexpr);
375  REGISTER_MATCHER(isCopyAssignmentOperator);
376  REGISTER_MATCHER(isCopyConstructor);
377  REGISTER_MATCHER(isDefaultConstructor);
378  REGISTER_MATCHER(isDefaulted);
379  REGISTER_MATCHER(isDefinition);
380  REGISTER_MATCHER(isDelegatingConstructor);
381  REGISTER_MATCHER(isDeleted);
382  REGISTER_MATCHER(isEnum);
383  REGISTER_MATCHER(isExceptionVariable);
384  REGISTER_MATCHER(isExpandedFromMacro);
385  REGISTER_MATCHER(isExpansionInMainFile);
386  REGISTER_MATCHER(isExpansionInSystemHeader);
387  REGISTER_MATCHER(isExplicit);
388  REGISTER_MATCHER(isExplicitTemplateSpecialization);
389  REGISTER_MATCHER(isExpr);
390  REGISTER_MATCHER(isExternC);
391  REGISTER_MATCHER(isFinal);
392  REGISTER_MATCHER(isFirstPrivateKind);
393  REGISTER_MATCHER(isImplicit);
394  REGISTER_MATCHER(isInStdNamespace);
395  REGISTER_MATCHER(isInTemplateInstantiation);
396  REGISTER_MATCHER(isInline);
397  REGISTER_MATCHER(isInstanceMessage);
398  REGISTER_MATCHER(isInstanceMethod);
399  REGISTER_MATCHER(isInstantiated);
400  REGISTER_MATCHER(isInstantiationDependent);
401  REGISTER_MATCHER(isInteger);
402  REGISTER_MATCHER(isIntegral);
403  REGISTER_MATCHER(isLambda);
404  REGISTER_MATCHER(isListInitialization);
405  REGISTER_MATCHER(isMain);
406  REGISTER_MATCHER(isMemberInitializer);
407  REGISTER_MATCHER(isMoveAssignmentOperator);
408  REGISTER_MATCHER(isMoveConstructor);
409  REGISTER_MATCHER(isNoReturn);
410  REGISTER_MATCHER(isNoThrow);
411  REGISTER_MATCHER(isNoneKind);
412  REGISTER_MATCHER(isOverride);
413  REGISTER_MATCHER(isPrivate);
414  REGISTER_MATCHER(isProtected);
415  REGISTER_MATCHER(isPublic);
416  REGISTER_MATCHER(isPure);
417  REGISTER_MATCHER(isScoped);
418  REGISTER_MATCHER(isSharedKind);
419  REGISTER_MATCHER(isSignedInteger);
420  REGISTER_MATCHER(isStandaloneDirective);
421  REGISTER_MATCHER(isStaticLocal);
422  REGISTER_MATCHER(isStaticStorageClass);
423  REGISTER_MATCHER(isStruct);
424  REGISTER_MATCHER(isTemplateInstantiation);
425  REGISTER_MATCHER(isTypeDependent);
426  REGISTER_MATCHER(isUnion);
427  REGISTER_MATCHER(isUnsignedInteger);
428  REGISTER_MATCHER(isUserProvided);
429  REGISTER_MATCHER(isValueDependent);
430  REGISTER_MATCHER(isVariadic);
431  REGISTER_MATCHER(isVirtual);
432  REGISTER_MATCHER(isVirtualAsWritten);
433  REGISTER_MATCHER(isVolatileQualified);
434  REGISTER_MATCHER(isWritten);
435  REGISTER_MATCHER(lValueReferenceType);
436  REGISTER_MATCHER(labelDecl);
437  REGISTER_MATCHER(labelStmt);
438  REGISTER_MATCHER(lambdaExpr);
439  REGISTER_MATCHER(linkageSpecDecl);
440  REGISTER_MATCHER(materializeTemporaryExpr);
441  REGISTER_MATCHER(member);
442  REGISTER_MATCHER(memberExpr);
443  REGISTER_MATCHER(memberPointerType);
444  REGISTER_MATCHER(namedDecl);
445  REGISTER_MATCHER(namesType);
446  REGISTER_MATCHER(namespaceAliasDecl);
447  REGISTER_MATCHER(namespaceDecl);
448  REGISTER_MATCHER(nestedNameSpecifier);
449  REGISTER_MATCHER(nestedNameSpecifierLoc);
450  REGISTER_MATCHER(nonTypeTemplateParmDecl);
451  REGISTER_MATCHER(nullPointerConstant);
452  REGISTER_MATCHER(nullStmt);
453  REGISTER_MATCHER(numSelectorArgs);
454  REGISTER_MATCHER(objcCatchStmt);
455  REGISTER_MATCHER(objcCategoryDecl);
456  REGISTER_MATCHER(objcCategoryImplDecl);
457  REGISTER_MATCHER(objcFinallyStmt);
458  REGISTER_MATCHER(objcImplementationDecl);
459  REGISTER_MATCHER(objcInterfaceDecl);
460  REGISTER_MATCHER(objcIvarDecl);
461  REGISTER_MATCHER(objcIvarRefExpr);
462  REGISTER_MATCHER(objcMessageExpr);
463  REGISTER_MATCHER(objcMethodDecl);
464  REGISTER_MATCHER(objcObjectPointerType);
465  REGISTER_MATCHER(objcPropertyDecl);
466  REGISTER_MATCHER(objcProtocolDecl);
467  REGISTER_MATCHER(objcThrowStmt);
468  REGISTER_MATCHER(objcTryStmt);
469  REGISTER_MATCHER(ofClass);
470  REGISTER_MATCHER(ofKind);
471  REGISTER_MATCHER(ompDefaultClause);
472  REGISTER_MATCHER(ompExecutableDirective);
473  REGISTER_MATCHER(on);
474  REGISTER_MATCHER(onImplicitObjectArgument);
475  REGISTER_MATCHER(opaqueValueExpr);
476  REGISTER_MATCHER(optionally);
477  REGISTER_MATCHER(parameterCountIs);
478  REGISTER_MATCHER(parenExpr);
479  REGISTER_MATCHER(parenListExpr);
480  REGISTER_MATCHER(parenType);
481  REGISTER_MATCHER(parmVarDecl);
482  REGISTER_MATCHER(pointee);
483  REGISTER_MATCHER(pointerType);
484  REGISTER_MATCHER(predefinedExpr);
485  REGISTER_MATCHER(qualType);
486  REGISTER_MATCHER(rValueReferenceType);
487  REGISTER_MATCHER(realFloatingPointType);
488  REGISTER_MATCHER(recordDecl);
489  REGISTER_MATCHER(recordType);
490  REGISTER_MATCHER(referenceType);
491  REGISTER_MATCHER(refersToDeclaration);
492  REGISTER_MATCHER(refersToIntegralType);
493  REGISTER_MATCHER(refersToTemplate);
494  REGISTER_MATCHER(refersToType);
495  REGISTER_MATCHER(requiresZeroInitialization);
496  REGISTER_MATCHER(returnStmt);
497  REGISTER_MATCHER(returns);
498  REGISTER_MATCHER(sizeOfExpr);
499  REGISTER_MATCHER(specifiesNamespace);
500  REGISTER_MATCHER(specifiesType);
501  REGISTER_MATCHER(specifiesTypeLoc);
502  REGISTER_MATCHER(statementCountIs);
503  REGISTER_MATCHER(staticAssertDecl);
504  REGISTER_MATCHER(stmt);
505  REGISTER_MATCHER(stmtExpr);
506  REGISTER_MATCHER(stringLiteral);
507  REGISTER_MATCHER(substNonTypeTemplateParmExpr);
508  REGISTER_MATCHER(substTemplateTypeParmType);
509  REGISTER_MATCHER(switchCase);
510  REGISTER_MATCHER(switchStmt);
511  REGISTER_MATCHER(tagDecl);
512  REGISTER_MATCHER(tagType);
513  REGISTER_MATCHER(templateArgument);
514  REGISTER_MATCHER(templateArgumentCountIs);
515  REGISTER_MATCHER(templateName);
516  REGISTER_MATCHER(templateSpecializationType);
517  REGISTER_MATCHER(templateTypeParmDecl);
518  REGISTER_MATCHER(templateTypeParmType);
519  REGISTER_MATCHER(throughUsingDecl);
520  REGISTER_MATCHER(to);
521  REGISTER_MATCHER(translationUnitDecl);
522  REGISTER_MATCHER(type);
523  REGISTER_MATCHER(typeAliasDecl);
524  REGISTER_MATCHER(typeAliasTemplateDecl);
525  REGISTER_MATCHER(typeLoc);
526  REGISTER_MATCHER(typedefDecl);
527  REGISTER_MATCHER(typedefNameDecl);
528  REGISTER_MATCHER(typedefType);
529  REGISTER_MATCHER(unaryExprOrTypeTraitExpr);
530  REGISTER_MATCHER(unaryOperator);
531  REGISTER_MATCHER(unaryTransformType);
532  REGISTER_MATCHER(unless);
533  REGISTER_MATCHER(unresolvedLookupExpr);
534  REGISTER_MATCHER(unresolvedMemberExpr);
535  REGISTER_MATCHER(unresolvedUsingTypenameDecl);
536  REGISTER_MATCHER(unresolvedUsingValueDecl);
537  REGISTER_MATCHER(userDefinedLiteral);
538  REGISTER_MATCHER(usesADL);
539  REGISTER_MATCHER(usingDecl);
540  REGISTER_MATCHER(usingDirectiveDecl);
541  REGISTER_MATCHER(valueDecl);
542  REGISTER_MATCHER(varDecl);
543  REGISTER_MATCHER(variableArrayType);
544  REGISTER_MATCHER(voidType);
545  REGISTER_MATCHER(whileStmt);
546  REGISTER_MATCHER(withInitializer);
547}
548
549RegistryMaps::~RegistryMaps() = default;
550
551static llvm::ManagedStatic<RegistryMaps> RegistryData;
552
553// static
554llvm::Optional<MatcherCtor> Registry::lookupMatcherCtor(StringRef MatcherName) {
555  auto it = RegistryData->constructors().find(MatcherName);
556  return it == RegistryData->constructors().end()
557             ? llvm::Optional<MatcherCtor>()
558             : it->second.get();
559}
560
561static llvm::raw_ostream &operator<<(llvm::raw_ostream &OS,
562                                     const std::set<ASTNodeKind> &KS) {
563  unsigned Count = 0;
564  for (std::set<ASTNodeKind>::const_iterator I = KS.begin(), E = KS.end();
565       I != E; ++I) {
566    if (I != KS.begin())
567      OS << "|";
568    if (Count++ == 3) {
569      OS << "...";
570      break;
571    }
572    OS << *I;
573  }
574  return OS;
575}
576
577std::vector<ArgKind> Registry::getAcceptedCompletionTypes(
578    ArrayRef<std::pair<MatcherCtor, unsigned>> Context) {
579  ASTNodeKind InitialTypes[] = {
580      ASTNodeKind::getFromNodeKind<Decl>(),
581      ASTNodeKind::getFromNodeKind<QualType>(),
582      ASTNodeKind::getFromNodeKind<Type>(),
583      ASTNodeKind::getFromNodeKind<Stmt>(),
584      ASTNodeKind::getFromNodeKind<NestedNameSpecifier>(),
585      ASTNodeKind::getFromNodeKind<NestedNameSpecifierLoc>(),
586      ASTNodeKind::getFromNodeKind<TypeLoc>()};
587
588  // Starting with the above seed of acceptable top-level matcher types, compute
589  // the acceptable type set for the argument indicated by each context element.
590  std::set<ArgKind> TypeSet(std::begin(InitialTypes), std::end(InitialTypes));
591  for (const auto &CtxEntry : Context) {
592    MatcherCtor Ctor = CtxEntry.first;
593    unsigned ArgNumber = CtxEntry.second;
594    std::vector<ArgKind> NextTypeSet;
595    for (const ArgKind &Kind : TypeSet) {
596      if (Kind.getArgKind() == Kind.AK_Matcher &&
597          Ctor->isConvertibleTo(Kind.getMatcherKind()) &&
598          (Ctor->isVariadic() || ArgNumber < Ctor->getNumArgs()))
599        Ctor->getArgKinds(Kind.getMatcherKind(), ArgNumber, NextTypeSet);
600    }
601    TypeSet.clear();
602    TypeSet.insert(NextTypeSet.begin(), NextTypeSet.end());
603  }
604  return std::vector<ArgKind>(TypeSet.begin(), TypeSet.end());
605}
606
607std::vector<MatcherCompletion>
608Registry::getMatcherCompletions(ArrayRef<ArgKind> AcceptedTypes) {
609  std::vector<MatcherCompletion> Completions;
610
611  // Search the registry for acceptable matchers.
612  for (const auto &M : RegistryData->constructors()) {
613    const MatcherDescriptor& Matcher = *M.getValue();
614    StringRef Name = M.getKey();
615
616    std::set<ASTNodeKind> RetKinds;
617    unsigned NumArgs = Matcher.isVariadic() ? 1 : Matcher.getNumArgs();
618    bool IsPolymorphic = Matcher.isPolymorphic();
619    std::vector<std::vector<ArgKind>> ArgsKinds(NumArgs);
620    unsigned MaxSpecificity = 0;
621    for (const ArgKind& Kind : AcceptedTypes) {
622      if (Kind.getArgKind() != Kind.AK_Matcher)
623        continue;
624      unsigned Specificity;
625      ASTNodeKind LeastDerivedKind;
626      if (Matcher.isConvertibleTo(Kind.getMatcherKind(), &Specificity,
627                                  &LeastDerivedKind)) {
628        if (MaxSpecificity < Specificity)
629          MaxSpecificity = Specificity;
630        RetKinds.insert(LeastDerivedKind);
631        for (unsigned Arg = 0; Arg != NumArgs; ++Arg)
632          Matcher.getArgKinds(Kind.getMatcherKind(), Arg, ArgsKinds[Arg]);
633        if (IsPolymorphic)
634          break;
635      }
636    }
637
638    if (!RetKinds.empty() && MaxSpecificity > 0) {
639      std::string Decl;
640      llvm::raw_string_ostream OS(Decl);
641
642      if (IsPolymorphic) {
643        OS << "Matcher<T> " << Name << "(Matcher<T>";
644      } else {
645        OS << "Matcher<" << RetKinds << "> " << Name << "(";
646        for (const std::vector<ArgKind> &Arg : ArgsKinds) {
647          if (&Arg != &ArgsKinds[0])
648            OS << ", ";
649
650          bool FirstArgKind = true;
651          std::set<ASTNodeKind> MatcherKinds;
652          // Two steps. First all non-matchers, then matchers only.
653          for (const ArgKind &AK : Arg) {
654            if (AK.getArgKind() == ArgKind::AK_Matcher) {
655              MatcherKinds.insert(AK.getMatcherKind());
656            } else {
657              if (!FirstArgKind) OS << "|";
658              FirstArgKind = false;
659              OS << AK.asString();
660            }
661          }
662          if (!MatcherKinds.empty()) {
663            if (!FirstArgKind) OS << "|";
664            OS << "Matcher<" << MatcherKinds << ">";
665          }
666        }
667      }
668      if (Matcher.isVariadic())
669        OS << "...";
670      OS << ")";
671
672      std::string TypedText = std::string(Name);
673      TypedText += "(";
674      if (ArgsKinds.empty())
675        TypedText += ")";
676      else if (ArgsKinds[0][0].getArgKind() == ArgKind::AK_String)
677        TypedText += "\"";
678
679      Completions.emplace_back(TypedText, OS.str(), MaxSpecificity);
680    }
681  }
682
683  return Completions;
684}
685
686VariantMatcher Registry::constructMatcher(MatcherCtor Ctor,
687                                          SourceRange NameRange,
688                                          ArrayRef<ParserValue> Args,
689                                          Diagnostics *Error) {
690  return Ctor->create(NameRange, Args, Error);
691}
692
693VariantMatcher Registry::constructBoundMatcher(MatcherCtor Ctor,
694                                               SourceRange NameRange,
695                                               StringRef BindID,
696                                               ArrayRef<ParserValue> Args,
697                                               Diagnostics *Error) {
698  VariantMatcher Out = constructMatcher(Ctor, NameRange, Args, Error);
699  if (Out.isNull()) return Out;
700
701  llvm::Optional<DynTypedMatcher> Result = Out.getSingleMatcher();
702  if (Result.hasValue()) {
703    llvm::Optional<DynTypedMatcher> Bound = Result->tryBind(BindID);
704    if (Bound.hasValue()) {
705      return VariantMatcher::SingleMatcher(*Bound);
706    }
707  }
708  Error->addError(NameRange, Error->ET_RegistryNotBindable);
709  return VariantMatcher();
710}
711
712} // namespace dynamic
713} // namespace ast_matchers
714} // namespace clang
715