1 //===- Registry.cpp - Matcher registry ------------------------------------===//
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
7 //===----------------------------------------------------------------------===//
10 /// Registry map populated at static initialization time.
12 //===----------------------------------------------------------------------===//
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/STLExtras.h"
21 #include "llvm/ADT/StringMap.h"
22 #include "llvm/ADT/StringRef.h"
23 #include "llvm/Support/ManagedStatic.h"
24 #include "llvm/Support/raw_ostream.h"
35 namespace ast_matchers
{
40 using internal::MatcherDescriptor
;
42 using ConstructorMap
=
43 llvm::StringMap
<std::unique_ptr
<const MatcherDescriptor
>>;
50 const ConstructorMap
&constructors() const { return Constructors
; }
53 void registerMatcher(StringRef MatcherName
,
54 std::unique_ptr
<MatcherDescriptor
> Callback
);
56 ConstructorMap Constructors
;
61 void RegistryMaps::registerMatcher(
62 StringRef MatcherName
, std::unique_ptr
<MatcherDescriptor
> Callback
) {
63 assert(!Constructors
.contains(MatcherName
));
64 Constructors
[MatcherName
] = std::move(Callback
);
67 #define REGISTER_MATCHER(name) \
68 registerMatcher(#name, internal::makeMatcherAutoMarshall( \
69 ::clang::ast_matchers::name, #name));
71 #define REGISTER_MATCHER_OVERLOAD(name) \
72 registerMatcher(#name, \
73 std::make_unique<internal::OverloadedMatcherDescriptor>(name##Callbacks))
75 #define SPECIFIC_MATCHER_OVERLOAD(name, Id) \
76 static_cast<::clang::ast_matchers::name##_Type##Id>( \
77 ::clang::ast_matchers::name)
79 #define MATCHER_OVERLOAD_ENTRY(name, Id) \
80 internal::makeMatcherAutoMarshall(SPECIFIC_MATCHER_OVERLOAD(name, Id), \
83 #define REGISTER_OVERLOADED_2(name) \
85 std::unique_ptr<MatcherDescriptor> name##Callbacks[] = { \
86 MATCHER_OVERLOAD_ENTRY(name, 0), \
87 MATCHER_OVERLOAD_ENTRY(name, 1)}; \
88 REGISTER_MATCHER_OVERLOAD(name); \
91 #define REGISTER_REGEX_MATCHER(name) \
92 registerMatcher(#name, internal::makeMatcherRegexMarshall(name, name))
94 /// Generate a registry map with all the known matchers.
95 /// Please keep sorted alphabetically!
96 RegistryMaps::RegistryMaps() {
97 // TODO: Here is the list of the missing matchers, grouped by reason.
99 // Polymorphic + argument overload:
105 registerMatcher("mapAnyOf",
106 std::make_unique
<internal::MapAnyOfBuilderDescriptor
>());
108 REGISTER_OVERLOADED_2(callee
);
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
);
120 std::unique_ptr
<MatcherDescriptor
> equalsCallbacks
[] = {
121 MATCHER_OVERLOAD_ENTRY(equals
, 0),
122 MATCHER_OVERLOAD_ENTRY(equals
, 1),
123 MATCHER_OVERLOAD_ENTRY(equals
, 2),
125 REGISTER_MATCHER_OVERLOAD(equals
);
127 REGISTER_REGEX_MATCHER(isExpansionInFileMatching
);
128 REGISTER_REGEX_MATCHER(matchesName
);
129 REGISTER_REGEX_MATCHER(matchesSelector
);
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(arrayInitIndexExpr
);
138 REGISTER_MATCHER(arrayInitLoopExpr
);
139 REGISTER_MATCHER(argumentCountIs
);
140 REGISTER_MATCHER(argumentCountAtLeast
);
141 REGISTER_MATCHER(arraySubscriptExpr
);
142 REGISTER_MATCHER(arrayType
);
143 REGISTER_MATCHER(asString
);
144 REGISTER_MATCHER(asmStmt
);
145 REGISTER_MATCHER(atomicExpr
);
146 REGISTER_MATCHER(atomicType
);
147 REGISTER_MATCHER(attr
);
148 REGISTER_MATCHER(autoType
);
149 REGISTER_MATCHER(autoreleasePoolStmt
)
150 REGISTER_MATCHER(binaryConditionalOperator
);
151 REGISTER_MATCHER(binaryOperator
);
152 REGISTER_MATCHER(binaryOperation
);
153 REGISTER_MATCHER(bindingDecl
);
154 REGISTER_MATCHER(blockDecl
);
155 REGISTER_MATCHER(blockExpr
);
156 REGISTER_MATCHER(blockPointerType
);
157 REGISTER_MATCHER(booleanType
);
158 REGISTER_MATCHER(breakStmt
);
159 REGISTER_MATCHER(builtinType
);
160 REGISTER_MATCHER(cStyleCastExpr
);
161 REGISTER_MATCHER(callExpr
);
162 REGISTER_MATCHER(capturesThis
);
163 REGISTER_MATCHER(capturesVar
);
164 REGISTER_MATCHER(caseStmt
);
165 REGISTER_MATCHER(castExpr
);
166 REGISTER_MATCHER(characterLiteral
);
167 REGISTER_MATCHER(chooseExpr
);
168 REGISTER_MATCHER(classTemplateDecl
);
169 REGISTER_MATCHER(classTemplatePartialSpecializationDecl
);
170 REGISTER_MATCHER(classTemplateSpecializationDecl
);
171 REGISTER_MATCHER(complexType
);
172 REGISTER_MATCHER(compoundLiteralExpr
);
173 REGISTER_MATCHER(compoundStmt
);
174 REGISTER_MATCHER(coawaitExpr
);
175 REGISTER_MATCHER(conceptDecl
);
176 REGISTER_MATCHER(conditionalOperator
);
177 REGISTER_MATCHER(constantArrayType
);
178 REGISTER_MATCHER(constantExpr
);
179 REGISTER_MATCHER(containsDeclaration
);
180 REGISTER_MATCHER(continueStmt
);
181 REGISTER_MATCHER(convertVectorExpr
);
182 REGISTER_MATCHER(coreturnStmt
);
183 REGISTER_MATCHER(coroutineBodyStmt
);
184 REGISTER_MATCHER(coyieldExpr
);
185 REGISTER_MATCHER(cudaKernelCallExpr
);
186 REGISTER_MATCHER(cxxBaseSpecifier
);
187 REGISTER_MATCHER(cxxBindTemporaryExpr
);
188 REGISTER_MATCHER(cxxBoolLiteral
);
189 REGISTER_MATCHER(cxxCatchStmt
);
190 REGISTER_MATCHER(cxxConstCastExpr
);
191 REGISTER_MATCHER(cxxConstructExpr
);
192 REGISTER_MATCHER(cxxConstructorDecl
);
193 REGISTER_MATCHER(cxxConversionDecl
);
194 REGISTER_MATCHER(cxxCtorInitializer
);
195 REGISTER_MATCHER(cxxDeductionGuideDecl
);
196 REGISTER_MATCHER(cxxDefaultArgExpr
);
197 REGISTER_MATCHER(cxxDeleteExpr
);
198 REGISTER_MATCHER(cxxDependentScopeMemberExpr
);
199 REGISTER_MATCHER(cxxDestructorDecl
);
200 REGISTER_MATCHER(cxxDynamicCastExpr
);
201 REGISTER_MATCHER(cxxForRangeStmt
);
202 REGISTER_MATCHER(cxxFunctionalCastExpr
);
203 REGISTER_MATCHER(cxxMemberCallExpr
);
204 REGISTER_MATCHER(cxxMethodDecl
);
205 REGISTER_MATCHER(cxxNewExpr
);
206 REGISTER_MATCHER(cxxNoexceptExpr
);
207 REGISTER_MATCHER(cxxNullPtrLiteralExpr
);
208 REGISTER_MATCHER(cxxOperatorCallExpr
);
209 REGISTER_MATCHER(cxxRecordDecl
);
210 REGISTER_MATCHER(cxxReinterpretCastExpr
);
211 REGISTER_MATCHER(cxxRewrittenBinaryOperator
);
212 REGISTER_MATCHER(cxxStaticCastExpr
);
213 REGISTER_MATCHER(cxxStdInitializerListExpr
);
214 REGISTER_MATCHER(cxxTemporaryObjectExpr
);
215 REGISTER_MATCHER(cxxThisExpr
);
216 REGISTER_MATCHER(cxxThrowExpr
);
217 REGISTER_MATCHER(cxxTryStmt
);
218 REGISTER_MATCHER(cxxUnresolvedConstructExpr
);
219 REGISTER_MATCHER(decayedType
);
220 REGISTER_MATCHER(decl
);
221 REGISTER_MATCHER(decompositionDecl
);
222 REGISTER_MATCHER(declCountIs
);
223 REGISTER_MATCHER(declRefExpr
);
224 REGISTER_MATCHER(declStmt
);
225 REGISTER_MATCHER(declaratorDecl
);
226 REGISTER_MATCHER(decltypeType
);
227 REGISTER_MATCHER(deducedTemplateSpecializationType
);
228 REGISTER_MATCHER(defaultStmt
);
229 REGISTER_MATCHER(dependentCoawaitExpr
);
230 REGISTER_MATCHER(dependentSizedArrayType
);
231 REGISTER_MATCHER(dependentSizedExtVectorType
);
232 REGISTER_MATCHER(designatedInitExpr
);
233 REGISTER_MATCHER(designatorCountIs
);
234 REGISTER_MATCHER(doStmt
);
235 REGISTER_MATCHER(eachOf
);
236 REGISTER_MATCHER(elaboratedType
);
237 REGISTER_MATCHER(elaboratedTypeLoc
);
238 REGISTER_MATCHER(usingType
);
239 REGISTER_MATCHER(enumConstantDecl
);
240 REGISTER_MATCHER(enumDecl
);
241 REGISTER_MATCHER(enumType
);
242 REGISTER_MATCHER(equalsBoundNode
);
243 REGISTER_MATCHER(equalsIntegralValue
);
244 REGISTER_MATCHER(explicitCastExpr
);
245 REGISTER_MATCHER(expr
);
246 REGISTER_MATCHER(exprWithCleanups
);
247 REGISTER_MATCHER(fieldDecl
);
248 REGISTER_MATCHER(fixedPointLiteral
);
249 REGISTER_MATCHER(floatLiteral
);
250 REGISTER_MATCHER(forCallable
);
251 REGISTER_MATCHER(forDecomposition
);
252 REGISTER_MATCHER(forEach
);
253 REGISTER_MATCHER(forEachArgumentWithParam
);
254 REGISTER_MATCHER(forEachArgumentWithParamType
);
255 REGISTER_MATCHER(forEachConstructorInitializer
);
256 REGISTER_MATCHER(forEachDescendant
);
257 REGISTER_MATCHER(forEachLambdaCapture
);
258 REGISTER_MATCHER(forEachOverridden
);
259 REGISTER_MATCHER(forEachSwitchCase
);
260 REGISTER_MATCHER(forEachTemplateArgument
);
261 REGISTER_MATCHER(forField
);
262 REGISTER_MATCHER(forFunction
);
263 REGISTER_MATCHER(forStmt
);
264 REGISTER_MATCHER(friendDecl
);
265 REGISTER_MATCHER(functionDecl
);
266 REGISTER_MATCHER(functionProtoType
);
267 REGISTER_MATCHER(functionTemplateDecl
);
268 REGISTER_MATCHER(functionType
);
269 REGISTER_MATCHER(genericSelectionExpr
);
270 REGISTER_MATCHER(gnuNullExpr
);
271 REGISTER_MATCHER(gotoStmt
);
272 REGISTER_MATCHER(has
);
273 REGISTER_MATCHER(hasAncestor
);
274 REGISTER_MATCHER(hasAnyArgument
);
275 REGISTER_MATCHER(hasAnyBase
);
276 REGISTER_MATCHER(hasAnyBinding
);
277 REGISTER_MATCHER(hasAnyBody
);
278 REGISTER_MATCHER(hasAnyCapture
);
279 REGISTER_MATCHER(hasAnyClause
);
280 REGISTER_MATCHER(hasAnyConstructorInitializer
);
281 REGISTER_MATCHER(hasAnyDeclaration
);
282 REGISTER_MATCHER(hasAnyName
);
283 REGISTER_MATCHER(hasAnyOperatorName
);
284 REGISTER_MATCHER(hasAnyOverloadedOperatorName
);
285 REGISTER_MATCHER(hasAnyParameter
);
286 REGISTER_MATCHER(hasAnyPlacementArg
);
287 REGISTER_MATCHER(hasAnySelector
);
288 REGISTER_MATCHER(hasAnySubstatement
);
289 REGISTER_MATCHER(hasAnyTemplateArgument
);
290 REGISTER_MATCHER(hasAnyTemplateArgumentLoc
);
291 REGISTER_MATCHER(hasAnyUsingShadowDecl
);
292 REGISTER_MATCHER(hasArgument
);
293 REGISTER_MATCHER(hasArgumentOfType
);
294 REGISTER_MATCHER(hasArraySize
);
295 REGISTER_MATCHER(hasAttr
);
296 REGISTER_MATCHER(hasAutomaticStorageDuration
);
297 REGISTER_MATCHER(hasBase
);
298 REGISTER_MATCHER(hasBinding
);
299 REGISTER_MATCHER(hasBitWidth
);
300 REGISTER_MATCHER(hasBody
);
301 REGISTER_MATCHER(hasCanonicalType
);
302 REGISTER_MATCHER(hasCaseConstant
);
303 REGISTER_MATCHER(hasCastKind
);
304 REGISTER_MATCHER(hasCondition
);
305 REGISTER_MATCHER(hasConditionVariableStatement
);
306 REGISTER_MATCHER(hasDecayedType
);
307 REGISTER_MATCHER(hasDeclContext
);
308 REGISTER_MATCHER(hasDeclaration
);
309 REGISTER_MATCHER(hasDeducedType
);
310 REGISTER_MATCHER(hasDefaultArgument
);
311 REGISTER_MATCHER(hasDefinition
);
312 REGISTER_MATCHER(hasDescendant
);
313 REGISTER_MATCHER(hasDestinationType
);
314 REGISTER_MATCHER(hasDirectBase
);
315 REGISTER_MATCHER(hasDynamicExceptionSpec
);
316 REGISTER_MATCHER(hasEitherOperand
);
317 REGISTER_MATCHER(hasElementType
);
318 REGISTER_MATCHER(hasElse
);
319 REGISTER_MATCHER(hasExplicitSpecifier
);
320 REGISTER_MATCHER(hasExternalFormalLinkage
);
321 REGISTER_MATCHER(hasFalseExpression
);
322 REGISTER_MATCHER(hasGlobalStorage
);
323 REGISTER_MATCHER(hasImplicitDestinationType
);
324 REGISTER_MATCHER(hasInClassInitializer
);
325 REGISTER_MATCHER(hasIncrement
);
326 REGISTER_MATCHER(hasIndex
);
327 REGISTER_MATCHER(hasInit
);
328 REGISTER_MATCHER(hasInitializer
);
329 REGISTER_MATCHER(hasInitStatement
);
330 REGISTER_MATCHER(hasKeywordSelector
);
331 REGISTER_MATCHER(hasLHS
);
332 REGISTER_MATCHER(hasLocalQualifiers
);
333 REGISTER_MATCHER(hasLocalStorage
);
334 REGISTER_MATCHER(hasLoopInit
);
335 REGISTER_MATCHER(hasLoopVariable
);
336 REGISTER_MATCHER(hasMemberName
);
337 REGISTER_MATCHER(hasMethod
);
338 REGISTER_MATCHER(hasName
);
339 REGISTER_MATCHER(hasNamedTypeLoc
);
340 REGISTER_MATCHER(hasNullSelector
);
341 REGISTER_MATCHER(hasObjectExpression
);
342 REGISTER_MATCHER(hasOperands
);
343 REGISTER_MATCHER(hasOperatorName
);
344 REGISTER_MATCHER(hasOverloadedOperatorName
);
345 REGISTER_MATCHER(hasParameter
);
346 REGISTER_MATCHER(hasParent
);
347 REGISTER_MATCHER(hasPointeeLoc
);
348 REGISTER_MATCHER(hasQualifier
);
349 REGISTER_MATCHER(hasRHS
);
350 REGISTER_MATCHER(hasRangeInit
);
351 REGISTER_MATCHER(hasReceiver
);
352 REGISTER_MATCHER(hasReceiverType
);
353 REGISTER_MATCHER(hasReferentLoc
);
354 REGISTER_MATCHER(hasReplacementType
);
355 REGISTER_MATCHER(hasReturnTypeLoc
);
356 REGISTER_MATCHER(hasReturnValue
);
357 REGISTER_MATCHER(hasPlacementArg
);
358 REGISTER_MATCHER(hasSelector
);
359 REGISTER_MATCHER(hasSingleDecl
);
360 REGISTER_MATCHER(hasSize
);
361 REGISTER_MATCHER(hasSizeExpr
);
362 REGISTER_MATCHER(hasSourceExpression
);
363 REGISTER_MATCHER(hasSpecializedTemplate
);
364 REGISTER_MATCHER(hasStaticStorageDuration
);
365 REGISTER_MATCHER(hasStructuredBlock
);
366 REGISTER_MATCHER(hasSyntacticForm
);
367 REGISTER_MATCHER(hasTargetDecl
);
368 REGISTER_MATCHER(hasTemplateArgument
);
369 REGISTER_MATCHER(hasTemplateArgumentLoc
);
370 REGISTER_MATCHER(hasThen
);
371 REGISTER_MATCHER(hasThreadStorageDuration
);
372 REGISTER_MATCHER(hasTrailingReturn
);
373 REGISTER_MATCHER(hasTrueExpression
);
374 REGISTER_MATCHER(hasTypeLoc
);
375 REGISTER_MATCHER(hasUnaryOperand
);
376 REGISTER_MATCHER(hasUnarySelector
);
377 REGISTER_MATCHER(hasUnderlyingDecl
);
378 REGISTER_MATCHER(hasUnderlyingType
);
379 REGISTER_MATCHER(hasUnqualifiedDesugaredType
);
380 REGISTER_MATCHER(hasUnqualifiedLoc
);
381 REGISTER_MATCHER(hasValueType
);
382 REGISTER_MATCHER(ifStmt
);
383 REGISTER_MATCHER(ignoringElidableConstructorCall
);
384 REGISTER_MATCHER(ignoringImpCasts
);
385 REGISTER_MATCHER(ignoringImplicit
);
386 REGISTER_MATCHER(ignoringParenCasts
);
387 REGISTER_MATCHER(ignoringParenImpCasts
);
388 REGISTER_MATCHER(imaginaryLiteral
);
389 REGISTER_MATCHER(implicitCastExpr
);
390 REGISTER_MATCHER(implicitValueInitExpr
);
391 REGISTER_MATCHER(incompleteArrayType
);
392 REGISTER_MATCHER(indirectFieldDecl
);
393 REGISTER_MATCHER(initListExpr
);
394 REGISTER_MATCHER(injectedClassNameType
);
395 REGISTER_MATCHER(innerType
);
396 REGISTER_MATCHER(integerLiteral
);
397 REGISTER_MATCHER(invocation
);
398 REGISTER_MATCHER(isAllowedToContainClauseKind
);
399 REGISTER_MATCHER(isAnonymous
);
400 REGISTER_MATCHER(isAnyCharacter
);
401 REGISTER_MATCHER(isAnyPointer
);
402 REGISTER_MATCHER(isArray
);
403 REGISTER_MATCHER(isArrow
);
404 REGISTER_MATCHER(isAssignmentOperator
);
405 REGISTER_MATCHER(isAtPosition
);
406 REGISTER_MATCHER(isBaseInitializer
);
407 REGISTER_MATCHER(isBitField
);
408 REGISTER_MATCHER(isCatchAll
);
409 REGISTER_MATCHER(isClass
);
410 REGISTER_MATCHER(isClassMessage
);
411 REGISTER_MATCHER(isClassMethod
);
412 REGISTER_MATCHER(isComparisonOperator
);
413 REGISTER_MATCHER(isConst
);
414 REGISTER_MATCHER(isConstQualified
);
415 REGISTER_MATCHER(isConsteval
);
416 REGISTER_MATCHER(isConstexpr
);
417 REGISTER_MATCHER(isConstinit
);
418 REGISTER_MATCHER(isCopyAssignmentOperator
);
419 REGISTER_MATCHER(isCopyConstructor
);
420 REGISTER_MATCHER(isDefaultConstructor
);
421 REGISTER_MATCHER(isDefaulted
);
422 REGISTER_MATCHER(isDefinition
);
423 REGISTER_MATCHER(isDelegatingConstructor
);
424 REGISTER_MATCHER(isDeleted
);
425 REGISTER_MATCHER(isEnum
);
426 REGISTER_MATCHER(isExceptionVariable
);
427 REGISTER_MATCHER(isExpandedFromMacro
);
428 REGISTER_MATCHER(isExpansionInMainFile
);
429 REGISTER_MATCHER(isExpansionInSystemHeader
);
430 REGISTER_MATCHER(isExplicit
);
431 REGISTER_MATCHER(isExplicitTemplateSpecialization
);
432 REGISTER_MATCHER(isExpr
);
433 REGISTER_MATCHER(isExternC
);
434 REGISTER_MATCHER(isFinal
);
435 REGISTER_MATCHER(isPrivateKind
);
436 REGISTER_MATCHER(isFirstPrivateKind
);
437 REGISTER_MATCHER(isImplicit
);
438 REGISTER_MATCHER(isInAnonymousNamespace
);
439 REGISTER_MATCHER(isInStdNamespace
);
440 REGISTER_MATCHER(isInTemplateInstantiation
);
441 REGISTER_MATCHER(isInitCapture
);
442 REGISTER_MATCHER(isInline
);
443 REGISTER_MATCHER(isInstanceMessage
);
444 REGISTER_MATCHER(isInstanceMethod
);
445 REGISTER_MATCHER(isInstantiated
);
446 REGISTER_MATCHER(isInstantiationDependent
);
447 REGISTER_MATCHER(isInteger
);
448 REGISTER_MATCHER(isIntegral
);
449 REGISTER_MATCHER(isLambda
);
450 REGISTER_MATCHER(isListInitialization
);
451 REGISTER_MATCHER(isMain
);
452 REGISTER_MATCHER(isMemberInitializer
);
453 REGISTER_MATCHER(isMoveAssignmentOperator
);
454 REGISTER_MATCHER(isMoveConstructor
);
455 REGISTER_MATCHER(isNoReturn
);
456 REGISTER_MATCHER(isNoThrow
);
457 REGISTER_MATCHER(isNoneKind
);
458 REGISTER_MATCHER(isOverride
);
459 REGISTER_MATCHER(isPrivate
);
460 REGISTER_MATCHER(isProtected
);
461 REGISTER_MATCHER(isPublic
);
462 REGISTER_MATCHER(isPure
);
463 REGISTER_MATCHER(isScoped
);
464 REGISTER_MATCHER(isSharedKind
);
465 REGISTER_MATCHER(isSignedInteger
);
466 REGISTER_MATCHER(isStandaloneDirective
);
467 REGISTER_MATCHER(isStaticLocal
);
468 REGISTER_MATCHER(isStaticStorageClass
);
469 REGISTER_MATCHER(isStruct
);
470 REGISTER_MATCHER(isTemplateInstantiation
);
471 REGISTER_MATCHER(isTypeDependent
);
472 REGISTER_MATCHER(isUnion
);
473 REGISTER_MATCHER(isUnsignedInteger
);
474 REGISTER_MATCHER(isUserProvided
);
475 REGISTER_MATCHER(isValueDependent
);
476 REGISTER_MATCHER(isVariadic
);
477 REGISTER_MATCHER(isVirtual
);
478 REGISTER_MATCHER(isVirtualAsWritten
);
479 REGISTER_MATCHER(isVolatileQualified
);
480 REGISTER_MATCHER(isWeak
);
481 REGISTER_MATCHER(isWritten
);
482 REGISTER_MATCHER(lValueReferenceType
);
483 REGISTER_MATCHER(labelDecl
);
484 REGISTER_MATCHER(labelStmt
);
485 REGISTER_MATCHER(lambdaCapture
);
486 REGISTER_MATCHER(lambdaExpr
);
487 REGISTER_MATCHER(linkageSpecDecl
);
488 REGISTER_MATCHER(macroQualifiedType
);
489 REGISTER_MATCHER(materializeTemporaryExpr
);
490 REGISTER_MATCHER(member
);
491 REGISTER_MATCHER(memberExpr
);
492 REGISTER_MATCHER(memberHasSameNameAsBoundNode
);
493 REGISTER_MATCHER(memberPointerType
);
494 REGISTER_MATCHER(namedDecl
);
495 REGISTER_MATCHER(namesType
);
496 REGISTER_MATCHER(namespaceAliasDecl
);
497 REGISTER_MATCHER(namespaceDecl
);
498 REGISTER_MATCHER(nestedNameSpecifier
);
499 REGISTER_MATCHER(nestedNameSpecifierLoc
);
500 REGISTER_MATCHER(nonTypeTemplateParmDecl
);
501 REGISTER_MATCHER(nullPointerConstant
);
502 REGISTER_MATCHER(nullStmt
);
503 REGISTER_MATCHER(numSelectorArgs
);
504 REGISTER_MATCHER(objcCatchStmt
);
505 REGISTER_MATCHER(objcCategoryDecl
);
506 REGISTER_MATCHER(objcCategoryImplDecl
);
507 REGISTER_MATCHER(objcFinallyStmt
);
508 REGISTER_MATCHER(objcImplementationDecl
);
509 REGISTER_MATCHER(objcInterfaceDecl
);
510 REGISTER_MATCHER(objcIvarDecl
);
511 REGISTER_MATCHER(objcIvarRefExpr
);
512 REGISTER_MATCHER(objcMessageExpr
);
513 REGISTER_MATCHER(objcMethodDecl
);
514 REGISTER_MATCHER(objcObjectPointerType
);
515 REGISTER_MATCHER(objcPropertyDecl
);
516 REGISTER_MATCHER(objcProtocolDecl
);
517 REGISTER_MATCHER(objcStringLiteral
);
518 REGISTER_MATCHER(objcThrowStmt
);
519 REGISTER_MATCHER(objcTryStmt
);
520 REGISTER_MATCHER(ofClass
);
521 REGISTER_MATCHER(ofKind
);
522 REGISTER_MATCHER(ompDefaultClause
);
523 REGISTER_MATCHER(ompExecutableDirective
);
524 REGISTER_MATCHER(on
);
525 REGISTER_MATCHER(onImplicitObjectArgument
);
526 REGISTER_MATCHER(opaqueValueExpr
);
527 REGISTER_MATCHER(optionally
);
528 REGISTER_MATCHER(parameterCountIs
);
529 REGISTER_MATCHER(parenExpr
);
530 REGISTER_MATCHER(parenListExpr
);
531 REGISTER_MATCHER(parenType
);
532 REGISTER_MATCHER(parmVarDecl
);
533 REGISTER_MATCHER(pointee
);
534 REGISTER_MATCHER(pointerType
);
535 REGISTER_MATCHER(pointerTypeLoc
);
536 REGISTER_MATCHER(predefinedExpr
);
537 REGISTER_MATCHER(qualType
);
538 REGISTER_MATCHER(qualifiedTypeLoc
);
539 REGISTER_MATCHER(rValueReferenceType
);
540 REGISTER_MATCHER(realFloatingPointType
);
541 REGISTER_MATCHER(recordDecl
);
542 REGISTER_MATCHER(recordType
);
543 REGISTER_MATCHER(referenceType
);
544 REGISTER_MATCHER(referenceTypeLoc
);
545 REGISTER_MATCHER(refersToDeclaration
);
546 REGISTER_MATCHER(refersToIntegralType
);
547 REGISTER_MATCHER(refersToTemplate
);
548 REGISTER_MATCHER(refersToType
);
549 REGISTER_MATCHER(requiresZeroInitialization
);
550 REGISTER_MATCHER(returnStmt
);
551 REGISTER_MATCHER(returns
);
552 REGISTER_MATCHER(sizeOfExpr
);
553 REGISTER_MATCHER(specifiesNamespace
);
554 REGISTER_MATCHER(specifiesType
);
555 REGISTER_MATCHER(specifiesTypeLoc
);
556 REGISTER_MATCHER(statementCountIs
);
557 REGISTER_MATCHER(staticAssertDecl
);
558 REGISTER_MATCHER(stmt
);
559 REGISTER_MATCHER(stmtExpr
);
560 REGISTER_MATCHER(stringLiteral
);
561 REGISTER_MATCHER(substNonTypeTemplateParmExpr
);
562 REGISTER_MATCHER(substTemplateTypeParmType
);
563 REGISTER_MATCHER(switchCase
);
564 REGISTER_MATCHER(switchStmt
);
565 REGISTER_MATCHER(tagDecl
);
566 REGISTER_MATCHER(tagType
);
567 REGISTER_MATCHER(templateArgument
);
568 REGISTER_MATCHER(templateArgumentCountIs
);
569 REGISTER_MATCHER(templateArgumentLoc
);
570 REGISTER_MATCHER(templateName
);
571 REGISTER_MATCHER(templateSpecializationType
);
572 REGISTER_MATCHER(templateSpecializationTypeLoc
);
573 REGISTER_MATCHER(templateTemplateParmDecl
);
574 REGISTER_MATCHER(templateTypeParmDecl
);
575 REGISTER_MATCHER(templateTypeParmType
);
576 REGISTER_MATCHER(throughUsingDecl
);
577 REGISTER_MATCHER(to
);
578 REGISTER_MATCHER(translationUnitDecl
);
579 REGISTER_MATCHER(type
);
580 REGISTER_MATCHER(typeAliasDecl
);
581 REGISTER_MATCHER(typeAliasTemplateDecl
);
582 REGISTER_MATCHER(typeLoc
);
583 REGISTER_MATCHER(typedefDecl
);
584 REGISTER_MATCHER(typedefNameDecl
);
585 REGISTER_MATCHER(typedefType
);
586 REGISTER_MATCHER(unaryExprOrTypeTraitExpr
);
587 REGISTER_MATCHER(unaryOperator
);
588 REGISTER_MATCHER(unaryTransformType
);
589 REGISTER_MATCHER(unless
);
590 REGISTER_MATCHER(unresolvedLookupExpr
);
591 REGISTER_MATCHER(unresolvedMemberExpr
);
592 REGISTER_MATCHER(unresolvedUsingTypenameDecl
);
593 REGISTER_MATCHER(unresolvedUsingValueDecl
);
594 REGISTER_MATCHER(userDefinedLiteral
);
595 REGISTER_MATCHER(usesADL
);
596 REGISTER_MATCHER(usingDecl
);
597 REGISTER_MATCHER(usingEnumDecl
);
598 REGISTER_MATCHER(usingDirectiveDecl
);
599 REGISTER_MATCHER(valueDecl
);
600 REGISTER_MATCHER(varDecl
);
601 REGISTER_MATCHER(variableArrayType
);
602 REGISTER_MATCHER(voidType
);
603 REGISTER_MATCHER(whileStmt
);
604 REGISTER_MATCHER(withInitializer
);
607 RegistryMaps::~RegistryMaps() = default;
609 static llvm::ManagedStatic
<RegistryMaps
> RegistryData
;
611 ASTNodeKind
Registry::nodeMatcherType(MatcherCtor Ctor
) {
612 return Ctor
->nodeMatcherType();
615 internal::MatcherDescriptorPtr::MatcherDescriptorPtr(MatcherDescriptor
*Ptr
)
618 internal::MatcherDescriptorPtr::~MatcherDescriptorPtr() { delete Ptr
; }
620 bool Registry::isBuilderMatcher(MatcherCtor Ctor
) {
621 return Ctor
->isBuilderMatcher();
624 internal::MatcherDescriptorPtr
625 Registry::buildMatcherCtor(MatcherCtor Ctor
, SourceRange NameRange
,
626 ArrayRef
<ParserValue
> Args
, Diagnostics
*Error
) {
627 return internal::MatcherDescriptorPtr(
628 Ctor
->buildMatcherCtor(NameRange
, Args
, Error
).release());
632 std::optional
<MatcherCtor
> Registry::lookupMatcherCtor(StringRef MatcherName
) {
633 auto it
= RegistryData
->constructors().find(MatcherName
);
634 return it
== RegistryData
->constructors().end() ? std::optional
<MatcherCtor
>()
638 static llvm::raw_ostream
&operator<<(llvm::raw_ostream
&OS
,
639 const std::set
<ASTNodeKind
> &KS
) {
641 for (std::set
<ASTNodeKind
>::const_iterator I
= KS
.begin(), E
= KS
.end();
654 std::vector
<ArgKind
> Registry::getAcceptedCompletionTypes(
655 ArrayRef
<std::pair
<MatcherCtor
, unsigned>> Context
) {
656 ASTNodeKind InitialTypes
[] = {
657 ASTNodeKind::getFromNodeKind
<Decl
>(),
658 ASTNodeKind::getFromNodeKind
<QualType
>(),
659 ASTNodeKind::getFromNodeKind
<Type
>(),
660 ASTNodeKind::getFromNodeKind
<Stmt
>(),
661 ASTNodeKind::getFromNodeKind
<NestedNameSpecifier
>(),
662 ASTNodeKind::getFromNodeKind
<NestedNameSpecifierLoc
>(),
663 ASTNodeKind::getFromNodeKind
<TypeLoc
>()};
665 // Starting with the above seed of acceptable top-level matcher types, compute
666 // the acceptable type set for the argument indicated by each context element.
667 std::set
<ArgKind
> TypeSet
;
668 for (auto IT
: InitialTypes
) {
669 TypeSet
.insert(ArgKind::MakeMatcherArg(IT
));
671 for (const auto &CtxEntry
: Context
) {
672 MatcherCtor Ctor
= CtxEntry
.first
;
673 unsigned ArgNumber
= CtxEntry
.second
;
674 std::vector
<ArgKind
> NextTypeSet
;
675 for (const ArgKind
&Kind
: TypeSet
) {
676 if (Kind
.getArgKind() == Kind
.AK_Matcher
&&
677 Ctor
->isConvertibleTo(Kind
.getMatcherKind()) &&
678 (Ctor
->isVariadic() || ArgNumber
< Ctor
->getNumArgs()))
679 Ctor
->getArgKinds(Kind
.getMatcherKind(), ArgNumber
, NextTypeSet
);
682 TypeSet
.insert(NextTypeSet
.begin(), NextTypeSet
.end());
684 return std::vector
<ArgKind
>(TypeSet
.begin(), TypeSet
.end());
687 std::vector
<MatcherCompletion
>
688 Registry::getMatcherCompletions(ArrayRef
<ArgKind
> AcceptedTypes
) {
689 std::vector
<MatcherCompletion
> Completions
;
691 // Search the registry for acceptable matchers.
692 for (const auto &M
: RegistryData
->constructors()) {
693 const MatcherDescriptor
& Matcher
= *M
.getValue();
694 StringRef Name
= M
.getKey();
696 std::set
<ASTNodeKind
> RetKinds
;
697 unsigned NumArgs
= Matcher
.isVariadic() ? 1 : Matcher
.getNumArgs();
698 bool IsPolymorphic
= Matcher
.isPolymorphic();
699 std::vector
<std::vector
<ArgKind
>> ArgsKinds(NumArgs
);
700 unsigned MaxSpecificity
= 0;
701 bool NodeArgs
= false;
702 for (const ArgKind
& Kind
: AcceptedTypes
) {
703 if (Kind
.getArgKind() != Kind
.AK_Matcher
&&
704 Kind
.getArgKind() != Kind
.AK_Node
) {
708 if (Kind
.getArgKind() == Kind
.AK_Node
) {
710 unsigned Specificity
;
711 ASTNodeKind LeastDerivedKind
;
712 if (Matcher
.isConvertibleTo(Kind
.getNodeKind(), &Specificity
,
713 &LeastDerivedKind
)) {
714 if (MaxSpecificity
< Specificity
)
715 MaxSpecificity
= Specificity
;
716 RetKinds
.insert(LeastDerivedKind
);
717 for (unsigned Arg
= 0; Arg
!= NumArgs
; ++Arg
)
718 Matcher
.getArgKinds(Kind
.getNodeKind(), Arg
, ArgsKinds
[Arg
]);
723 unsigned Specificity
;
724 ASTNodeKind LeastDerivedKind
;
725 if (Matcher
.isConvertibleTo(Kind
.getMatcherKind(), &Specificity
,
726 &LeastDerivedKind
)) {
727 if (MaxSpecificity
< Specificity
)
728 MaxSpecificity
= Specificity
;
729 RetKinds
.insert(LeastDerivedKind
);
730 for (unsigned Arg
= 0; Arg
!= NumArgs
; ++Arg
)
731 Matcher
.getArgKinds(Kind
.getMatcherKind(), Arg
, ArgsKinds
[Arg
]);
738 if (!RetKinds
.empty() && MaxSpecificity
> 0) {
740 llvm::raw_string_ostream
OS(Decl
);
742 std::string TypedText
= std::string(Name
);
749 OS
<< "Matcher<T> " << Name
<< "(Matcher<T>";
751 OS
<< "Matcher<" << RetKinds
<< "> " << Name
<< "(";
752 for (const std::vector
<ArgKind
> &Arg
: ArgsKinds
) {
753 if (&Arg
!= &ArgsKinds
[0])
756 bool FirstArgKind
= true;
757 std::set
<ASTNodeKind
> MatcherKinds
;
758 // Two steps. First all non-matchers, then matchers only.
759 for (const ArgKind
&AK
: Arg
) {
760 if (AK
.getArgKind() == ArgKind::AK_Matcher
) {
761 MatcherKinds
.insert(AK
.getMatcherKind());
765 FirstArgKind
= false;
769 if (!MatcherKinds
.empty()) {
770 if (!FirstArgKind
) OS
<< "|";
771 OS
<< "Matcher<" << MatcherKinds
<< ">";
775 if (Matcher
.isVariadic())
780 if (ArgsKinds
.empty())
782 else if (ArgsKinds
[0][0].getArgKind() == ArgKind::AK_String
)
786 Completions
.emplace_back(TypedText
, OS
.str(), MaxSpecificity
);
793 VariantMatcher
Registry::constructMatcher(MatcherCtor Ctor
,
794 SourceRange NameRange
,
795 ArrayRef
<ParserValue
> Args
,
796 Diagnostics
*Error
) {
797 return Ctor
->create(NameRange
, Args
, Error
);
800 VariantMatcher
Registry::constructBoundMatcher(MatcherCtor Ctor
,
801 SourceRange NameRange
,
803 ArrayRef
<ParserValue
> Args
,
804 Diagnostics
*Error
) {
805 VariantMatcher Out
= constructMatcher(Ctor
, NameRange
, Args
, Error
);
806 if (Out
.isNull()) return Out
;
808 std::optional
<DynTypedMatcher
> Result
= Out
.getSingleMatcher();
810 std::optional
<DynTypedMatcher
> Bound
= Result
->tryBind(BindID
);
812 return VariantMatcher::SingleMatcher(*Bound
);
815 Error
->addError(NameRange
, Error
->ET_RegistryNotBindable
);
816 return VariantMatcher();
819 } // namespace dynamic
820 } // namespace ast_matchers
