1 //===- CXCursor.cpp - Routines for manipulating CXCursors -----------------===//
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 // This file defines routines for manipulating CXCursors. It should be the
10 // only file that has internal knowledge of the encoding of the data in
11 // CXCursor.
12 //
13 //===----------------------------------------------------------------------===//
14 
15 #include "CXCursor.h"
16 #include "CXString.h"
17 #include "CXTranslationUnit.h"
18 #include "CXType.h"
19 #include "clang-c/Index.h"
20 #include "clang/AST/Attr.h"
21 #include "clang/AST/Decl.h"
22 #include "clang/AST/DeclCXX.h"
23 #include "clang/AST/DeclObjC.h"
24 #include "clang/AST/DeclTemplate.h"
25 #include "clang/AST/Expr.h"
26 #include "clang/AST/ExprCXX.h"
27 #include "clang/AST/ExprObjC.h"
28 #include "clang/Frontend/ASTUnit.h"
29 #include "llvm/Support/ErrorHandling.h"
30 
31 using namespace clang;
32 using namespace cxcursor;
33 
34 CXCursor cxcursor::MakeCXCursorInvalid(CXCursorKind K, CXTranslationUnit TU) {
35   assert(K >= CXCursor_FirstInvalid && K <= CXCursor_LastInvalid);
36   CXCursor C = {K, 0, {nullptr, nullptr, TU}};
37   return C;
38 }
39 
40 static CXCursorKind GetCursorKind(const Attr *A) {
41   assert(A && "Invalid arguments!");
42   switch (A->getKind()) {
43   default:
44     break;
45   case attr::IBAction:
46     return CXCursor_IBActionAttr;
47   case attr::IBOutlet:
48     return CXCursor_IBOutletAttr;
49   case attr::IBOutletCollection:
50     return CXCursor_IBOutletCollectionAttr;
51   case attr::Final:
52     return CXCursor_CXXFinalAttr;
53   case attr::Override:
54     return CXCursor_CXXOverrideAttr;
55   case attr::Annotate:
56     return CXCursor_AnnotateAttr;
57   case attr::AsmLabel:
58     return CXCursor_AsmLabelAttr;
59   case attr::Packed:
60     return CXCursor_PackedAttr;
61   case attr::Pure:
62     return CXCursor_PureAttr;
63   case attr::Const:
64     return CXCursor_ConstAttr;
65   case attr::NoDuplicate:
66     return CXCursor_NoDuplicateAttr;
67   case attr::CUDAConstant:
68     return CXCursor_CUDAConstantAttr;
69   case attr::CUDADevice:
70     return CXCursor_CUDADeviceAttr;
71   case attr::CUDAGlobal:
72     return CXCursor_CUDAGlobalAttr;
73   case attr::CUDAHost:
74     return CXCursor_CUDAHostAttr;
75   case attr::CUDAShared:
76     return CXCursor_CUDASharedAttr;
77   case attr::Visibility:
78     return CXCursor_VisibilityAttr;
79   case attr::DLLExport:
80     return CXCursor_DLLExport;
81   case attr::DLLImport:
82     return CXCursor_DLLImport;
83   case attr::NSReturnsRetained:
84     return CXCursor_NSReturnsRetained;
85   case attr::NSReturnsNotRetained:
86     return CXCursor_NSReturnsNotRetained;
87   case attr::NSReturnsAutoreleased:
88     return CXCursor_NSReturnsAutoreleased;
89   case attr::NSConsumesSelf:
90     return CXCursor_NSConsumesSelf;
91   case attr::NSConsumed:
92     return CXCursor_NSConsumed;
93   case attr::ObjCException:
94     return CXCursor_ObjCException;
95   case attr::ObjCNSObject:
96     return CXCursor_ObjCNSObject;
97   case attr::ObjCIndependentClass:
98     return CXCursor_ObjCIndependentClass;
99   case attr::ObjCPreciseLifetime:
100     return CXCursor_ObjCPreciseLifetime;
101   case attr::ObjCReturnsInnerPointer:
102     return CXCursor_ObjCReturnsInnerPointer;
103   case attr::ObjCRequiresSuper:
104     return CXCursor_ObjCRequiresSuper;
105   case attr::ObjCRootClass:
106     return CXCursor_ObjCRootClass;
107   case attr::ObjCSubclassingRestricted:
108     return CXCursor_ObjCSubclassingRestricted;
109   case attr::ObjCExplicitProtocolImpl:
110     return CXCursor_ObjCExplicitProtocolImpl;
111   case attr::ObjCDesignatedInitializer:
112     return CXCursor_ObjCDesignatedInitializer;
113   case attr::ObjCRuntimeVisible:
114     return CXCursor_ObjCRuntimeVisible;
115   case attr::ObjCBoxable:
116     return CXCursor_ObjCBoxable;
117   case attr::FlagEnum:
118     return CXCursor_FlagEnum;
119   case attr::Convergent:
120     return CXCursor_ConvergentAttr;
121   case attr::WarnUnused:
122     return CXCursor_WarnUnusedAttr;
123   case attr::WarnUnusedResult:
124     return CXCursor_WarnUnusedResultAttr;
125   case attr::Aligned:
126     return CXCursor_AlignedAttr;
127   }
128 
129   return CXCursor_UnexposedAttr;
130 }
131 
132 CXCursor cxcursor::MakeCXCursor(const Attr *A, const Decl *Parent,
133                                 CXTranslationUnit TU) {
134   assert(A && Parent && TU && "Invalid arguments!");
135   CXCursor C = {GetCursorKind(A), 0, {Parent, A, TU}};
136   return C;
137 }
138 
139 CXCursor cxcursor::MakeCXCursor(const Decl *D, CXTranslationUnit TU,
140                                 SourceRange RegionOfInterest,
141                                 bool FirstInDeclGroup) {
142   assert(D && TU && "Invalid arguments!");
143 
144   CXCursorKind K = getCursorKindForDecl(D);
145 
146   if (K == CXCursor_ObjCClassMethodDecl ||
147       K == CXCursor_ObjCInstanceMethodDecl) {
148     int SelectorIdIndex = -1;
149     // Check if cursor points to a selector id.
150     if (RegionOfInterest.isValid() &&
151         RegionOfInterest.getBegin() == RegionOfInterest.getEnd()) {
152       SmallVector<SourceLocation, 16> SelLocs;
153       cast<ObjCMethodDecl>(D)->getSelectorLocs(SelLocs);
154       SmallVectorImpl<SourceLocation>::iterator I =
155           llvm::find(SelLocs, RegionOfInterest.getBegin());
156       if (I != SelLocs.end())
157         SelectorIdIndex = I - SelLocs.begin();
158     }
159     CXCursor C = {K,
160                   SelectorIdIndex,
161                   {D, (void *)(intptr_t)(FirstInDeclGroup ? 1 : 0), TU}};
162     return C;
163   }
164 
165   CXCursor C = {K, 0, {D, (void *)(intptr_t)(FirstInDeclGroup ? 1 : 0), TU}};
166   return C;
167 }
168 
169 CXCursor cxcursor::MakeCXCursor(const Stmt *S, const Decl *Parent,
170                                 CXTranslationUnit TU,
171                                 SourceRange RegionOfInterest) {
172   assert(S && TU && "Invalid arguments!");
173   CXCursorKind K = CXCursor_NotImplemented;
174 
175   switch (S->getStmtClass()) {
176   case Stmt::NoStmtClass:
177     break;
178 
179   case Stmt::CaseStmtClass:
180     K = CXCursor_CaseStmt;
181     break;
182 
183   case Stmt::DefaultStmtClass:
184     K = CXCursor_DefaultStmt;
185     break;
186 
187   case Stmt::IfStmtClass:
188     K = CXCursor_IfStmt;
189     break;
190 
191   case Stmt::SwitchStmtClass:
192     K = CXCursor_SwitchStmt;
193     break;
194 
195   case Stmt::WhileStmtClass:
196     K = CXCursor_WhileStmt;
197     break;
198 
199   case Stmt::DoStmtClass:
200     K = CXCursor_DoStmt;
201     break;
202 
203   case Stmt::ForStmtClass:
204     K = CXCursor_ForStmt;
205     break;
206 
207   case Stmt::GotoStmtClass:
208     K = CXCursor_GotoStmt;
209     break;
210 
211   case Stmt::IndirectGotoStmtClass:
212     K = CXCursor_IndirectGotoStmt;
213     break;
214 
215   case Stmt::ContinueStmtClass:
216     K = CXCursor_ContinueStmt;
217     break;
218 
219   case Stmt::BreakStmtClass:
220     K = CXCursor_BreakStmt;
221     break;
222 
223   case Stmt::ReturnStmtClass:
224     K = CXCursor_ReturnStmt;
225     break;
226 
227   case Stmt::GCCAsmStmtClass:
228     K = CXCursor_GCCAsmStmt;
229     break;
230 
231   case Stmt::MSAsmStmtClass:
232     K = CXCursor_MSAsmStmt;
233     break;
234 
235   case Stmt::ObjCAtTryStmtClass:
236     K = CXCursor_ObjCAtTryStmt;
237     break;
238 
239   case Stmt::ObjCAtCatchStmtClass:
240     K = CXCursor_ObjCAtCatchStmt;
241     break;
242 
243   case Stmt::ObjCAtFinallyStmtClass:
244     K = CXCursor_ObjCAtFinallyStmt;
245     break;
246 
247   case Stmt::ObjCAtThrowStmtClass:
248     K = CXCursor_ObjCAtThrowStmt;
249     break;
250 
251   case Stmt::ObjCAtSynchronizedStmtClass:
252     K = CXCursor_ObjCAtSynchronizedStmt;
253     break;
254 
255   case Stmt::ObjCAutoreleasePoolStmtClass:
256     K = CXCursor_ObjCAutoreleasePoolStmt;
257     break;
258 
259   case Stmt::ObjCForCollectionStmtClass:
260     K = CXCursor_ObjCForCollectionStmt;
261     break;
262 
263   case Stmt::CXXCatchStmtClass:
264     K = CXCursor_CXXCatchStmt;
265     break;
266 
267   case Stmt::CXXTryStmtClass:
268     K = CXCursor_CXXTryStmt;
269     break;
270 
271   case Stmt::CXXForRangeStmtClass:
272     K = CXCursor_CXXForRangeStmt;
273     break;
274 
275   case Stmt::SEHTryStmtClass:
276     K = CXCursor_SEHTryStmt;
277     break;
278 
279   case Stmt::SEHExceptStmtClass:
280     K = CXCursor_SEHExceptStmt;
281     break;
282 
283   case Stmt::SEHFinallyStmtClass:
284     K = CXCursor_SEHFinallyStmt;
285     break;
286 
287   case Stmt::SEHLeaveStmtClass:
288     K = CXCursor_SEHLeaveStmt;
289     break;
290 
291   case Stmt::CoroutineBodyStmtClass:
292   case Stmt::CoreturnStmtClass:
293     K = CXCursor_UnexposedStmt;
294     break;
295 
296   case Stmt::ArrayTypeTraitExprClass:
297   case Stmt::AsTypeExprClass:
298   case Stmt::AtomicExprClass:
299   case Stmt::BinaryConditionalOperatorClass:
300   case Stmt::TypeTraitExprClass:
301   case Stmt::CoawaitExprClass:
302   case Stmt::DependentCoawaitExprClass:
303   case Stmt::CoyieldExprClass:
304   case Stmt::CXXBindTemporaryExprClass:
305   case Stmt::CXXDefaultArgExprClass:
306   case Stmt::CXXDefaultInitExprClass:
307   case Stmt::CXXFoldExprClass:
308   case Stmt::CXXRewrittenBinaryOperatorClass:
309   case Stmt::CXXStdInitializerListExprClass:
310   case Stmt::CXXScalarValueInitExprClass:
311   case Stmt::CXXUuidofExprClass:
312   case Stmt::ChooseExprClass:
313   case Stmt::DesignatedInitExprClass:
314   case Stmt::DesignatedInitUpdateExprClass:
315   case Stmt::ArrayInitLoopExprClass:
316   case Stmt::ArrayInitIndexExprClass:
317   case Stmt::ExprWithCleanupsClass:
318   case Stmt::ExpressionTraitExprClass:
319   case Stmt::ExtVectorElementExprClass:
320   case Stmt::ImplicitCastExprClass:
321   case Stmt::ImplicitValueInitExprClass:
322   case Stmt::NoInitExprClass:
323   case Stmt::MaterializeTemporaryExprClass:
324   case Stmt::ObjCIndirectCopyRestoreExprClass:
325   case Stmt::OffsetOfExprClass:
326   case Stmt::ParenListExprClass:
327   case Stmt::PredefinedExprClass:
328   case Stmt::ShuffleVectorExprClass:
329   case Stmt::SourceLocExprClass:
330   case Stmt::ConvertVectorExprClass:
331   case Stmt::VAArgExprClass:
332   case Stmt::ObjCArrayLiteralClass:
333   case Stmt::ObjCDictionaryLiteralClass:
334   case Stmt::ObjCBoxedExprClass:
335   case Stmt::ObjCSubscriptRefExprClass:
336   case Stmt::RecoveryExprClass:
337   case Stmt::SYCLUniqueStableNameExprClass:
338     K = CXCursor_UnexposedExpr;
339     break;
340 
341   case Stmt::OpaqueValueExprClass:
342     if (Expr *Src = cast<OpaqueValueExpr>(S)->getSourceExpr())
343       return MakeCXCursor(Src, Parent, TU, RegionOfInterest);
344     K = CXCursor_UnexposedExpr;
345     break;
346 
347   case Stmt::PseudoObjectExprClass:
348     return MakeCXCursor(cast<PseudoObjectExpr>(S)->getSyntacticForm(), Parent,
349                         TU, RegionOfInterest);
350 
351   case Stmt::CompoundStmtClass:
352     K = CXCursor_CompoundStmt;
353     break;
354 
355   case Stmt::NullStmtClass:
356     K = CXCursor_NullStmt;
357     break;
358 
359   case Stmt::LabelStmtClass:
360     K = CXCursor_LabelStmt;
361     break;
362 
363   case Stmt::AttributedStmtClass:
364     K = CXCursor_UnexposedStmt;
365     break;
366 
367   case Stmt::DeclStmtClass:
368     K = CXCursor_DeclStmt;
369     break;
370 
371   case Stmt::CapturedStmtClass:
372     K = CXCursor_UnexposedStmt;
373     break;
374 
375   case Stmt::IntegerLiteralClass:
376     K = CXCursor_IntegerLiteral;
377     break;
378 
379   case Stmt::FixedPointLiteralClass:
380     K = CXCursor_FixedPointLiteral;
381     break;
382 
383   case Stmt::FloatingLiteralClass:
384     K = CXCursor_FloatingLiteral;
385     break;
386 
387   case Stmt::ImaginaryLiteralClass:
388     K = CXCursor_ImaginaryLiteral;
389     break;
390 
391   case Stmt::StringLiteralClass:
392     K = CXCursor_StringLiteral;
393     break;
394 
395   case Stmt::CharacterLiteralClass:
396     K = CXCursor_CharacterLiteral;
397     break;
398 
399   case Stmt::ConstantExprClass:
400     return MakeCXCursor(cast<ConstantExpr>(S)->getSubExpr(), Parent, TU,
401                         RegionOfInterest);
402 
403   case Stmt::ParenExprClass:
404     K = CXCursor_ParenExpr;
405     break;
406 
407   case Stmt::UnaryOperatorClass:
408     K = CXCursor_UnaryOperator;
409     break;
410 
411   case Stmt::UnaryExprOrTypeTraitExprClass:
412   case Stmt::CXXNoexceptExprClass:
413     K = CXCursor_UnaryExpr;
414     break;
415 
416   case Stmt::MSPropertySubscriptExprClass:
417   case Stmt::ArraySubscriptExprClass:
418     K = CXCursor_ArraySubscriptExpr;
419     break;
420 
421   case Stmt::MatrixSubscriptExprClass:
422     // TODO: add support for MatrixSubscriptExpr.
423     K = CXCursor_UnexposedExpr;
424     break;
425 
426   case Stmt::OMPArraySectionExprClass:
427     K = CXCursor_OMPArraySectionExpr;
428     break;
429 
430   case Stmt::OMPArrayShapingExprClass:
431     K = CXCursor_OMPArrayShapingExpr;
432     break;
433 
434   case Stmt::OMPIteratorExprClass:
435     K = CXCursor_OMPIteratorExpr;
436     break;
437 
438   case Stmt::BinaryOperatorClass:
439     K = CXCursor_BinaryOperator;
440     break;
441 
442   case Stmt::CompoundAssignOperatorClass:
443     K = CXCursor_CompoundAssignOperator;
444     break;
445 
446   case Stmt::ConditionalOperatorClass:
447     K = CXCursor_ConditionalOperator;
448     break;
449 
450   case Stmt::CStyleCastExprClass:
451     K = CXCursor_CStyleCastExpr;
452     break;
453 
454   case Stmt::CompoundLiteralExprClass:
455     K = CXCursor_CompoundLiteralExpr;
456     break;
457 
458   case Stmt::InitListExprClass:
459     K = CXCursor_InitListExpr;
460     break;
461 
462   case Stmt::AddrLabelExprClass:
463     K = CXCursor_AddrLabelExpr;
464     break;
465 
466   case Stmt::StmtExprClass:
467     K = CXCursor_StmtExpr;
468     break;
469 
470   case Stmt::GenericSelectionExprClass:
471     K = CXCursor_GenericSelectionExpr;
472     break;
473 
474   case Stmt::GNUNullExprClass:
475     K = CXCursor_GNUNullExpr;
476     break;
477 
478   case Stmt::CXXStaticCastExprClass:
479     K = CXCursor_CXXStaticCastExpr;
480     break;
481 
482   case Stmt::CXXDynamicCastExprClass:
483     K = CXCursor_CXXDynamicCastExpr;
484     break;
485 
486   case Stmt::CXXReinterpretCastExprClass:
487     K = CXCursor_CXXReinterpretCastExpr;
488     break;
489 
490   case Stmt::CXXConstCastExprClass:
491     K = CXCursor_CXXConstCastExpr;
492     break;
493 
494   case Stmt::CXXFunctionalCastExprClass:
495     K = CXCursor_CXXFunctionalCastExpr;
496     break;
497 
498   case Stmt::CXXAddrspaceCastExprClass:
499     K = CXCursor_CXXAddrspaceCastExpr;
500     break;
501 
502   case Stmt::CXXTypeidExprClass:
503     K = CXCursor_CXXTypeidExpr;
504     break;
505 
506   case Stmt::CXXBoolLiteralExprClass:
507     K = CXCursor_CXXBoolLiteralExpr;
508     break;
509 
510   case Stmt::CXXNullPtrLiteralExprClass:
511     K = CXCursor_CXXNullPtrLiteralExpr;
512     break;
513 
514   case Stmt::CXXThisExprClass:
515     K = CXCursor_CXXThisExpr;
516     break;
517 
518   case Stmt::CXXThrowExprClass:
519     K = CXCursor_CXXThrowExpr;
520     break;
521 
522   case Stmt::CXXNewExprClass:
523     K = CXCursor_CXXNewExpr;
524     break;
525 
526   case Stmt::CXXDeleteExprClass:
527     K = CXCursor_CXXDeleteExpr;
528     break;
529 
530   case Stmt::ObjCStringLiteralClass:
531     K = CXCursor_ObjCStringLiteral;
532     break;
533 
534   case Stmt::ObjCEncodeExprClass:
535     K = CXCursor_ObjCEncodeExpr;
536     break;
537 
538   case Stmt::ObjCSelectorExprClass:
539     K = CXCursor_ObjCSelectorExpr;
540     break;
541 
542   case Stmt::ObjCProtocolExprClass:
543     K = CXCursor_ObjCProtocolExpr;
544     break;
545 
546   case Stmt::ObjCBoolLiteralExprClass:
547     K = CXCursor_ObjCBoolLiteralExpr;
548     break;
549 
550   case Stmt::ObjCAvailabilityCheckExprClass:
551     K = CXCursor_ObjCAvailabilityCheckExpr;
552     break;
553 
554   case Stmt::ObjCBridgedCastExprClass:
555     K = CXCursor_ObjCBridgedCastExpr;
556     break;
557 
558   case Stmt::BlockExprClass:
559     K = CXCursor_BlockExpr;
560     break;
561 
562   case Stmt::PackExpansionExprClass:
563     K = CXCursor_PackExpansionExpr;
564     break;
565 
566   case Stmt::SizeOfPackExprClass:
567     K = CXCursor_SizeOfPackExpr;
568     break;
569 
570   case Stmt::DeclRefExprClass:
571     if (const ImplicitParamDecl *IPD = dyn_cast_or_null<ImplicitParamDecl>(
572             cast<DeclRefExpr>(S)->getDecl())) {
573       if (const ObjCMethodDecl *MD =
574               dyn_cast<ObjCMethodDecl>(IPD->getDeclContext())) {
575         if (MD->getSelfDecl() == IPD) {
576           K = CXCursor_ObjCSelfExpr;
577           break;
578         }
579       }
580     }
581 
582     K = CXCursor_DeclRefExpr;
583     break;
584 
585   case Stmt::DependentScopeDeclRefExprClass:
586   case Stmt::SubstNonTypeTemplateParmExprClass:
587   case Stmt::SubstNonTypeTemplateParmPackExprClass:
588   case Stmt::FunctionParmPackExprClass:
589   case Stmt::UnresolvedLookupExprClass:
590   case Stmt::TypoExprClass: // A typo could actually be a DeclRef or a MemberRef
591     K = CXCursor_DeclRefExpr;
592     break;
593 
594   case Stmt::CXXDependentScopeMemberExprClass:
595   case Stmt::CXXPseudoDestructorExprClass:
596   case Stmt::MemberExprClass:
597   case Stmt::MSPropertyRefExprClass:
598   case Stmt::ObjCIsaExprClass:
599   case Stmt::ObjCIvarRefExprClass:
600   case Stmt::ObjCPropertyRefExprClass:
601   case Stmt::UnresolvedMemberExprClass:
602     K = CXCursor_MemberRefExpr;
603     break;
604 
605   case Stmt::CallExprClass:
606   case Stmt::CXXOperatorCallExprClass:
607   case Stmt::CXXMemberCallExprClass:
608   case Stmt::CUDAKernelCallExprClass:
609   case Stmt::CXXConstructExprClass:
610   case Stmt::CXXInheritedCtorInitExprClass:
611   case Stmt::CXXTemporaryObjectExprClass:
612   case Stmt::CXXUnresolvedConstructExprClass:
613   case Stmt::UserDefinedLiteralClass:
614     K = CXCursor_CallExpr;
615     break;
616 
617   case Stmt::LambdaExprClass:
618     K = CXCursor_LambdaExpr;
619     break;
620 
621   case Stmt::ObjCMessageExprClass: {
622     K = CXCursor_ObjCMessageExpr;
623     int SelectorIdIndex = -1;
624     // Check if cursor points to a selector id.
625     if (RegionOfInterest.isValid() &&
626         RegionOfInterest.getBegin() == RegionOfInterest.getEnd()) {
627       SmallVector<SourceLocation, 16> SelLocs;
628       cast<ObjCMessageExpr>(S)->getSelectorLocs(SelLocs);
629       SmallVectorImpl<SourceLocation>::iterator I =
630           llvm::find(SelLocs, RegionOfInterest.getBegin());
631       if (I != SelLocs.end())
632         SelectorIdIndex = I - SelLocs.begin();
633     }
634     CXCursor C = {K, 0, {Parent, S, TU}};
635     return getSelectorIdentifierCursor(SelectorIdIndex, C);
636   }
637 
638   case Stmt::ConceptSpecializationExprClass:
639     K = CXCursor_ConceptSpecializationExpr;
640     break;
641 
642   case Stmt::RequiresExprClass:
643     K = CXCursor_RequiresExpr;
644     break;
645 
646   case Stmt::MSDependentExistsStmtClass:
647     K = CXCursor_UnexposedStmt;
648     break;
649   case Stmt::OMPCanonicalLoopClass:
650     K = CXCursor_OMPCanonicalLoop;
651     break;
652   case Stmt::OMPMetaDirectiveClass:
653     K = CXCursor_OMPMetaDirective;
654     break;
655   case Stmt::OMPParallelDirectiveClass:
656     K = CXCursor_OMPParallelDirective;
657     break;
658   case Stmt::OMPSimdDirectiveClass:
659     K = CXCursor_OMPSimdDirective;
660     break;
661   case Stmt::OMPTileDirectiveClass:
662     K = CXCursor_OMPTileDirective;
663     break;
664   case Stmt::OMPUnrollDirectiveClass:
665     K = CXCursor_OMPUnrollDirective;
666     break;
667   case Stmt::OMPForDirectiveClass:
668     K = CXCursor_OMPForDirective;
669     break;
670   case Stmt::OMPForSimdDirectiveClass:
671     K = CXCursor_OMPForSimdDirective;
672     break;
673   case Stmt::OMPSectionsDirectiveClass:
674     K = CXCursor_OMPSectionsDirective;
675     break;
676   case Stmt::OMPSectionDirectiveClass:
677     K = CXCursor_OMPSectionDirective;
678     break;
679   case Stmt::OMPSingleDirectiveClass:
680     K = CXCursor_OMPSingleDirective;
681     break;
682   case Stmt::OMPMasterDirectiveClass:
683     K = CXCursor_OMPMasterDirective;
684     break;
685   case Stmt::OMPCriticalDirectiveClass:
686     K = CXCursor_OMPCriticalDirective;
687     break;
688   case Stmt::OMPParallelForDirectiveClass:
689     K = CXCursor_OMPParallelForDirective;
690     break;
691   case Stmt::OMPParallelForSimdDirectiveClass:
692     K = CXCursor_OMPParallelForSimdDirective;
693     break;
694   case Stmt::OMPParallelMasterDirectiveClass:
695     K = CXCursor_OMPParallelMasterDirective;
696     break;
697   case Stmt::OMPParallelMaskedDirectiveClass:
698     K = CXCursor_OMPParallelMaskedDirective;
699     break;
700   case Stmt::OMPParallelSectionsDirectiveClass:
701     K = CXCursor_OMPParallelSectionsDirective;
702     break;
703   case Stmt::OMPTaskDirectiveClass:
704     K = CXCursor_OMPTaskDirective;
705     break;
706   case Stmt::OMPTaskyieldDirectiveClass:
707     K = CXCursor_OMPTaskyieldDirective;
708     break;
709   case Stmt::OMPBarrierDirectiveClass:
710     K = CXCursor_OMPBarrierDirective;
711     break;
712   case Stmt::OMPTaskwaitDirectiveClass:
713     K = CXCursor_OMPTaskwaitDirective;
714     break;
715   case Stmt::OMPTaskgroupDirectiveClass:
716     K = CXCursor_OMPTaskgroupDirective;
717     break;
718   case Stmt::OMPFlushDirectiveClass:
719     K = CXCursor_OMPFlushDirective;
720     break;
721   case Stmt::OMPDepobjDirectiveClass:
722     K = CXCursor_OMPDepobjDirective;
723     break;
724   case Stmt::OMPScanDirectiveClass:
725     K = CXCursor_OMPScanDirective;
726     break;
727   case Stmt::OMPOrderedDirectiveClass:
728     K = CXCursor_OMPOrderedDirective;
729     break;
730   case Stmt::OMPAtomicDirectiveClass:
731     K = CXCursor_OMPAtomicDirective;
732     break;
733   case Stmt::OMPTargetDirectiveClass:
734     K = CXCursor_OMPTargetDirective;
735     break;
736   case Stmt::OMPTargetDataDirectiveClass:
737     K = CXCursor_OMPTargetDataDirective;
738     break;
739   case Stmt::OMPTargetEnterDataDirectiveClass:
740     K = CXCursor_OMPTargetEnterDataDirective;
741     break;
742   case Stmt::OMPTargetExitDataDirectiveClass:
743     K = CXCursor_OMPTargetExitDataDirective;
744     break;
745   case Stmt::OMPTargetParallelDirectiveClass:
746     K = CXCursor_OMPTargetParallelDirective;
747     break;
748   case Stmt::OMPTargetParallelForDirectiveClass:
749     K = CXCursor_OMPTargetParallelForDirective;
750     break;
751   case Stmt::OMPTargetUpdateDirectiveClass:
752     K = CXCursor_OMPTargetUpdateDirective;
753     break;
754   case Stmt::OMPTeamsDirectiveClass:
755     K = CXCursor_OMPTeamsDirective;
756     break;
757   case Stmt::OMPCancellationPointDirectiveClass:
758     K = CXCursor_OMPCancellationPointDirective;
759     break;
760   case Stmt::OMPCancelDirectiveClass:
761     K = CXCursor_OMPCancelDirective;
762     break;
763   case Stmt::OMPTaskLoopDirectiveClass:
764     K = CXCursor_OMPTaskLoopDirective;
765     break;
766   case Stmt::OMPTaskLoopSimdDirectiveClass:
767     K = CXCursor_OMPTaskLoopSimdDirective;
768     break;
769   case Stmt::OMPMasterTaskLoopDirectiveClass:
770     K = CXCursor_OMPMasterTaskLoopDirective;
771     break;
772   case Stmt::OMPMaskedTaskLoopDirectiveClass:
773     K = CXCursor_OMPMaskedTaskLoopDirective;
774     break;
775   case Stmt::OMPMasterTaskLoopSimdDirectiveClass:
776     K = CXCursor_OMPMasterTaskLoopSimdDirective;
777     break;
778   case Stmt::OMPMaskedTaskLoopSimdDirectiveClass:
779     K = CXCursor_OMPMaskedTaskLoopSimdDirective;
780     break;
781   case Stmt::OMPParallelMasterTaskLoopDirectiveClass:
782     K = CXCursor_OMPParallelMasterTaskLoopDirective;
783     break;
784   case Stmt::OMPParallelMasterTaskLoopSimdDirectiveClass:
785     K = CXCursor_OMPParallelMasterTaskLoopSimdDirective;
786     break;
787   case Stmt::OMPDistributeDirectiveClass:
788     K = CXCursor_OMPDistributeDirective;
789     break;
790   case Stmt::OMPDistributeParallelForDirectiveClass:
791     K = CXCursor_OMPDistributeParallelForDirective;
792     break;
793   case Stmt::OMPDistributeParallelForSimdDirectiveClass:
794     K = CXCursor_OMPDistributeParallelForSimdDirective;
795     break;
796   case Stmt::OMPDistributeSimdDirectiveClass:
797     K = CXCursor_OMPDistributeSimdDirective;
798     break;
799   case Stmt::OMPTargetParallelForSimdDirectiveClass:
800     K = CXCursor_OMPTargetParallelForSimdDirective;
801     break;
802   case Stmt::OMPTargetSimdDirectiveClass:
803     K = CXCursor_OMPTargetSimdDirective;
804     break;
805   case Stmt::OMPTeamsDistributeDirectiveClass:
806     K = CXCursor_OMPTeamsDistributeDirective;
807     break;
808   case Stmt::OMPTeamsDistributeSimdDirectiveClass:
809     K = CXCursor_OMPTeamsDistributeSimdDirective;
810     break;
811   case Stmt::OMPTeamsDistributeParallelForSimdDirectiveClass:
812     K = CXCursor_OMPTeamsDistributeParallelForSimdDirective;
813     break;
814   case Stmt::OMPTeamsDistributeParallelForDirectiveClass:
815     K = CXCursor_OMPTeamsDistributeParallelForDirective;
816     break;
817   case Stmt::OMPTargetTeamsDirectiveClass:
818     K = CXCursor_OMPTargetTeamsDirective;
819     break;
820   case Stmt::OMPTargetTeamsDistributeDirectiveClass:
821     K = CXCursor_OMPTargetTeamsDistributeDirective;
822     break;
823   case Stmt::OMPTargetTeamsDistributeParallelForDirectiveClass:
824     K = CXCursor_OMPTargetTeamsDistributeParallelForDirective;
825     break;
826   case Stmt::OMPTargetTeamsDistributeParallelForSimdDirectiveClass:
827     K = CXCursor_OMPTargetTeamsDistributeParallelForSimdDirective;
828     break;
829   case Stmt::OMPTargetTeamsDistributeSimdDirectiveClass:
830     K = CXCursor_OMPTargetTeamsDistributeSimdDirective;
831     break;
832   case Stmt::OMPInteropDirectiveClass:
833     K = CXCursor_OMPInteropDirective;
834     break;
835   case Stmt::OMPDispatchDirectiveClass:
836     K = CXCursor_OMPDispatchDirective;
837     break;
838   case Stmt::OMPMaskedDirectiveClass:
839     K = CXCursor_OMPMaskedDirective;
840     break;
841   case Stmt::OMPGenericLoopDirectiveClass:
842     K = CXCursor_OMPGenericLoopDirective;
843     break;
844   case Stmt::OMPTeamsGenericLoopDirectiveClass:
845     K = CXCursor_OMPTeamsGenericLoopDirective;
846     break;
847   case Stmt::OMPTargetTeamsGenericLoopDirectiveClass:
848     K = CXCursor_OMPTargetTeamsGenericLoopDirective;
849     break;
850   case Stmt::OMPParallelGenericLoopDirectiveClass:
851     K = CXCursor_OMPParallelGenericLoopDirective;
852     break;
853   case Stmt::OMPTargetParallelGenericLoopDirectiveClass:
854     K = CXCursor_OMPTargetParallelGenericLoopDirective;
855     break;
856   case Stmt::BuiltinBitCastExprClass:
857     K = CXCursor_BuiltinBitCastExpr;
858   }
859 
860   CXCursor C = {K, 0, {Parent, S, TU}};
861   return C;
862 }
863 
864 CXCursor cxcursor::MakeCursorObjCSuperClassRef(ObjCInterfaceDecl *Super,
865                                                SourceLocation Loc,
866                                                CXTranslationUnit TU) {
867   assert(Super && TU && "Invalid arguments!");
868   void *RawLoc = Loc.getPtrEncoding();
869   CXCursor C = {CXCursor_ObjCSuperClassRef, 0, {Super, RawLoc, TU}};
870   return C;
871 }
872 
873 std::pair<const ObjCInterfaceDecl *, SourceLocation>
874 cxcursor::getCursorObjCSuperClassRef(CXCursor C) {
875   assert(C.kind == CXCursor_ObjCSuperClassRef);
876   return std::make_pair(static_cast<const ObjCInterfaceDecl *>(C.data[0]),
877                         SourceLocation::getFromPtrEncoding(C.data[1]));
878 }
879 
880 CXCursor cxcursor::MakeCursorObjCProtocolRef(const ObjCProtocolDecl *Proto,
881                                              SourceLocation Loc,
882                                              CXTranslationUnit TU) {
883   assert(Proto && TU && "Invalid arguments!");
884   void *RawLoc = Loc.getPtrEncoding();
885   CXCursor C = {CXCursor_ObjCProtocolRef, 0, {Proto, RawLoc, TU}};
886   return C;
887 }
888 
889 std::pair<const ObjCProtocolDecl *, SourceLocation>
890 cxcursor::getCursorObjCProtocolRef(CXCursor C) {
891   assert(C.kind == CXCursor_ObjCProtocolRef);
892   return std::make_pair(static_cast<const ObjCProtocolDecl *>(C.data[0]),
893                         SourceLocation::getFromPtrEncoding(C.data[1]));
894 }
895 
896 CXCursor cxcursor::MakeCursorObjCClassRef(const ObjCInterfaceDecl *Class,
897                                           SourceLocation Loc,
898                                           CXTranslationUnit TU) {
899   // 'Class' can be null for invalid code.
900   if (!Class)
901     return MakeCXCursorInvalid(CXCursor_InvalidCode);
902   assert(TU && "Invalid arguments!");
903   void *RawLoc = Loc.getPtrEncoding();
904   CXCursor C = {CXCursor_ObjCClassRef, 0, {Class, RawLoc, TU}};
905   return C;
906 }
907 
908 std::pair<const ObjCInterfaceDecl *, SourceLocation>
909 cxcursor::getCursorObjCClassRef(CXCursor C) {
910   assert(C.kind == CXCursor_ObjCClassRef);
911   return std::make_pair(static_cast<const ObjCInterfaceDecl *>(C.data[0]),
912                         SourceLocation::getFromPtrEncoding(C.data[1]));
913 }
914 
915 CXCursor cxcursor::MakeCursorTypeRef(const TypeDecl *Type, SourceLocation Loc,
916                                      CXTranslationUnit TU) {
917   assert(Type && TU && "Invalid arguments!");
918   void *RawLoc = Loc.getPtrEncoding();
919   CXCursor C = {CXCursor_TypeRef, 0, {Type, RawLoc, TU}};
920   return C;
921 }
922 
923 std::pair<const TypeDecl *, SourceLocation>
924 cxcursor::getCursorTypeRef(CXCursor C) {
925   assert(C.kind == CXCursor_TypeRef);
926   return std::make_pair(static_cast<const TypeDecl *>(C.data[0]),
927                         SourceLocation::getFromPtrEncoding(C.data[1]));
928 }
929 
930 CXCursor cxcursor::MakeCursorTemplateRef(const TemplateDecl *Template,
931                                          SourceLocation Loc,
932                                          CXTranslationUnit TU) {
933   assert(Template && TU && "Invalid arguments!");
934   void *RawLoc = Loc.getPtrEncoding();
935   CXCursor C = {CXCursor_TemplateRef, 0, {Template, RawLoc, TU}};
936   return C;
937 }
938 
939 std::pair<const TemplateDecl *, SourceLocation>
940 cxcursor::getCursorTemplateRef(CXCursor C) {
941   assert(C.kind == CXCursor_TemplateRef);
942   return std::make_pair(static_cast<const TemplateDecl *>(C.data[0]),
943                         SourceLocation::getFromPtrEncoding(C.data[1]));
944 }
945 
946 CXCursor cxcursor::MakeCursorNamespaceRef(const NamedDecl *NS,
947                                           SourceLocation Loc,
948                                           CXTranslationUnit TU) {
949 
950   assert(NS && (isa<NamespaceDecl>(NS) || isa<NamespaceAliasDecl>(NS)) && TU &&
951          "Invalid arguments!");
952   void *RawLoc = Loc.getPtrEncoding();
953   CXCursor C = {CXCursor_NamespaceRef, 0, {NS, RawLoc, TU}};
954   return C;
955 }
956 
957 std::pair<const NamedDecl *, SourceLocation>
958 cxcursor::getCursorNamespaceRef(CXCursor C) {
959   assert(C.kind == CXCursor_NamespaceRef);
960   return std::make_pair(static_cast<const NamedDecl *>(C.data[0]),
961                         SourceLocation::getFromPtrEncoding(C.data[1]));
962 }
963 
964 CXCursor cxcursor::MakeCursorVariableRef(const VarDecl *Var, SourceLocation Loc,
965                                          CXTranslationUnit TU) {
966 
967   assert(Var && TU && "Invalid arguments!");
968   void *RawLoc = Loc.getPtrEncoding();
969   CXCursor C = {CXCursor_VariableRef, 0, {Var, RawLoc, TU}};
970   return C;
971 }
972 
973 std::pair<const VarDecl *, SourceLocation>
974 cxcursor::getCursorVariableRef(CXCursor C) {
975   assert(C.kind == CXCursor_VariableRef);
976   return std::make_pair(static_cast<const VarDecl *>(C.data[0]),
977                         SourceLocation::getFromPtrEncoding(C.data[1]));
978 }
979 
980 CXCursor cxcursor::MakeCursorMemberRef(const FieldDecl *Field,
981                                        SourceLocation Loc,
982                                        CXTranslationUnit TU) {
983 
984   assert(Field && TU && "Invalid arguments!");
985   void *RawLoc = Loc.getPtrEncoding();
986   CXCursor C = {CXCursor_MemberRef, 0, {Field, RawLoc, TU}};
987   return C;
988 }
989 
990 std::pair<const FieldDecl *, SourceLocation>
991 cxcursor::getCursorMemberRef(CXCursor C) {
992   assert(C.kind == CXCursor_MemberRef);
993   return std::make_pair(static_cast<const FieldDecl *>(C.data[0]),
994                         SourceLocation::getFromPtrEncoding(C.data[1]));
995 }
996 
997 CXCursor cxcursor::MakeCursorCXXBaseSpecifier(const CXXBaseSpecifier *B,
998                                               CXTranslationUnit TU) {
999   CXCursor C = {CXCursor_CXXBaseSpecifier, 0, {B, nullptr, TU}};
1000   return C;
1001 }
1002 
1003 const CXXBaseSpecifier *cxcursor::getCursorCXXBaseSpecifier(CXCursor C) {
1004   assert(C.kind == CXCursor_CXXBaseSpecifier);
1005   return static_cast<const CXXBaseSpecifier *>(C.data[0]);
1006 }
1007 
1008 CXCursor cxcursor::MakePreprocessingDirectiveCursor(SourceRange Range,
1009                                                     CXTranslationUnit TU) {
1010   CXCursor C = {
1011       CXCursor_PreprocessingDirective,
1012       0,
1013       {Range.getBegin().getPtrEncoding(), Range.getEnd().getPtrEncoding(), TU}};
1014   return C;
1015 }
1016 
1017 SourceRange cxcursor::getCursorPreprocessingDirective(CXCursor C) {
1018   assert(C.kind == CXCursor_PreprocessingDirective);
1019   SourceRange Range(SourceLocation::getFromPtrEncoding(C.data[0]),
1020                     SourceLocation::getFromPtrEncoding(C.data[1]));
1021   ASTUnit *TU = getCursorASTUnit(C);
1022   return TU->mapRangeFromPreamble(Range);
1023 }
1024 
1025 CXCursor cxcursor::MakeMacroDefinitionCursor(const MacroDefinitionRecord *MI,
1026                                              CXTranslationUnit TU) {
1027   CXCursor C = {CXCursor_MacroDefinition, 0, {MI, nullptr, TU}};
1028   return C;
1029 }
1030 
1031 const MacroDefinitionRecord *cxcursor::getCursorMacroDefinition(CXCursor C) {
1032   assert(C.kind == CXCursor_MacroDefinition);
1033   return static_cast<const MacroDefinitionRecord *>(C.data[0]);
1034 }
1035 
1036 CXCursor cxcursor::MakeMacroExpansionCursor(MacroExpansion *MI,
1037                                             CXTranslationUnit TU) {
1038   CXCursor C = {CXCursor_MacroExpansion, 0, {MI, nullptr, TU}};
1039   return C;
1040 }
1041 
1042 CXCursor cxcursor::MakeMacroExpansionCursor(MacroDefinitionRecord *MI,
1043                                             SourceLocation Loc,
1044                                             CXTranslationUnit TU) {
1045   assert(Loc.isValid());
1046   CXCursor C = {CXCursor_MacroExpansion, 0, {MI, Loc.getPtrEncoding(), TU}};
1047   return C;
1048 }
1049 
1050 const IdentifierInfo *cxcursor::MacroExpansionCursor::getName() const {
1051   if (isPseudo())
1052     return getAsMacroDefinition()->getName();
1053   return getAsMacroExpansion()->getName();
1054 }
1055 const MacroDefinitionRecord *
1056 cxcursor::MacroExpansionCursor::getDefinition() const {
1057   if (isPseudo())
1058     return getAsMacroDefinition();
1059   return getAsMacroExpansion()->getDefinition();
1060 }
1061 SourceRange cxcursor::MacroExpansionCursor::getSourceRange() const {
1062   if (isPseudo())
1063     return getPseudoLoc();
1064   return getAsMacroExpansion()->getSourceRange();
1065 }
1066 
1067 CXCursor cxcursor::MakeInclusionDirectiveCursor(InclusionDirective *ID,
1068                                                 CXTranslationUnit TU) {
1069   CXCursor C = {CXCursor_InclusionDirective, 0, {ID, nullptr, TU}};
1070   return C;
1071 }
1072 
1073 const InclusionDirective *cxcursor::getCursorInclusionDirective(CXCursor C) {
1074   assert(C.kind == CXCursor_InclusionDirective);
1075   return static_cast<const InclusionDirective *>(C.data[0]);
1076 }
1077 
1078 CXCursor cxcursor::MakeCursorLabelRef(LabelStmt *Label, SourceLocation Loc,
1079                                       CXTranslationUnit TU) {
1080 
1081   assert(Label && TU && "Invalid arguments!");
1082   void *RawLoc = Loc.getPtrEncoding();
1083   CXCursor C = {CXCursor_LabelRef, 0, {Label, RawLoc, TU}};
1084   return C;
1085 }
1086 
1087 std::pair<const LabelStmt *, SourceLocation>
1088 cxcursor::getCursorLabelRef(CXCursor C) {
1089   assert(C.kind == CXCursor_LabelRef);
1090   return std::make_pair(static_cast<const LabelStmt *>(C.data[0]),
1091                         SourceLocation::getFromPtrEncoding(C.data[1]));
1092 }
1093 
1094 CXCursor cxcursor::MakeCursorOverloadedDeclRef(const OverloadExpr *E,
1095                                                CXTranslationUnit TU) {
1096   assert(E && TU && "Invalid arguments!");
1097   OverloadedDeclRefStorage Storage(E);
1098   void *RawLoc = E->getNameLoc().getPtrEncoding();
1099   CXCursor C = {
1100       CXCursor_OverloadedDeclRef, 0, {Storage.getOpaqueValue(), RawLoc, TU}};
1101   return C;
1102 }
1103 
1104 CXCursor cxcursor::MakeCursorOverloadedDeclRef(const Decl *D,
1105                                                SourceLocation Loc,
1106                                                CXTranslationUnit TU) {
1107   assert(D && TU && "Invalid arguments!");
1108   void *RawLoc = Loc.getPtrEncoding();
1109   OverloadedDeclRefStorage Storage(D);
1110   CXCursor C = {
1111       CXCursor_OverloadedDeclRef, 0, {Storage.getOpaqueValue(), RawLoc, TU}};
1112   return C;
1113 }
1114 
1115 CXCursor cxcursor::MakeCursorOverloadedDeclRef(TemplateName Name,
1116                                                SourceLocation Loc,
1117                                                CXTranslationUnit TU) {
1118   assert(Name.getAsOverloadedTemplate() && TU && "Invalid arguments!");
1119   void *RawLoc = Loc.getPtrEncoding();
1120   OverloadedDeclRefStorage Storage(Name.getAsOverloadedTemplate());
1121   CXCursor C = {
1122       CXCursor_OverloadedDeclRef, 0, {Storage.getOpaqueValue(), RawLoc, TU}};
1123   return C;
1124 }
1125 
1126 std::pair<cxcursor::OverloadedDeclRefStorage, SourceLocation>
1127 cxcursor::getCursorOverloadedDeclRef(CXCursor C) {
1128   assert(C.kind == CXCursor_OverloadedDeclRef);
1129   return std::make_pair(OverloadedDeclRefStorage::getFromOpaqueValue(
1130                             const_cast<void *>(C.data[0])),
1131                         SourceLocation::getFromPtrEncoding(C.data[1]));
1132 }
1133 
1134 const Decl *cxcursor::getCursorDecl(CXCursor Cursor) {
1135   return static_cast<const Decl *>(Cursor.data[0]);
1136 }
1137 
1138 const Expr *cxcursor::getCursorExpr(CXCursor Cursor) {
1139   return dyn_cast_or_null<Expr>(getCursorStmt(Cursor));
1140 }
1141 
1142 const Stmt *cxcursor::getCursorStmt(CXCursor Cursor) {
1143   if (Cursor.kind == CXCursor_ObjCSuperClassRef ||
1144       Cursor.kind == CXCursor_ObjCProtocolRef ||
1145       Cursor.kind == CXCursor_ObjCClassRef)
1146     return nullptr;
1147 
1148   return static_cast<const Stmt *>(Cursor.data[1]);
1149 }
1150 
1151 const Attr *cxcursor::getCursorAttr(CXCursor Cursor) {
1152   return static_cast<const Attr *>(Cursor.data[1]);
1153 }
1154 
1155 ASTContext &cxcursor::getCursorContext(CXCursor Cursor) {
1156   return getCursorASTUnit(Cursor)->getASTContext();
1157 }
1158 
1159 ASTUnit *cxcursor::getCursorASTUnit(CXCursor Cursor) {
1160   CXTranslationUnit TU = getCursorTU(Cursor);
1161   if (!TU)
1162     return nullptr;
1163   return cxtu::getASTUnit(TU);
1164 }
1165 
1166 CXTranslationUnit cxcursor::getCursorTU(CXCursor Cursor) {
1167   return static_cast<CXTranslationUnit>(const_cast<void *>(Cursor.data[2]));
1168 }
1169 
1170 void cxcursor::getOverriddenCursors(CXCursor cursor,
1171                                     SmallVectorImpl<CXCursor> &overridden) {
1172   assert(clang_isDeclaration(cursor.kind));
1173   const NamedDecl *D = dyn_cast_or_null<NamedDecl>(getCursorDecl(cursor));
1174   if (!D)
1175     return;
1176 
1177   CXTranslationUnit TU = getCursorTU(cursor);
1178   SmallVector<const NamedDecl *, 8> OverDecls;
1179   D->getASTContext().getOverriddenMethods(D, OverDecls);
1180 
1181   for (SmallVectorImpl<const NamedDecl *>::iterator I = OverDecls.begin(),
1182                                                     E = OverDecls.end();
1183        I != E; ++I) {
1184     overridden.push_back(MakeCXCursor(*I, TU));
1185   }
1186 }
1187 
1188 std::pair<int, SourceLocation>
1189 cxcursor::getSelectorIdentifierIndexAndLoc(CXCursor cursor) {
1190   if (cursor.kind == CXCursor_ObjCMessageExpr) {
1191     if (cursor.xdata != -1)
1192       return std::make_pair(cursor.xdata,
1193                             cast<ObjCMessageExpr>(getCursorExpr(cursor))
1194                                 ->getSelectorLoc(cursor.xdata));
1195   } else if (cursor.kind == CXCursor_ObjCClassMethodDecl ||
1196              cursor.kind == CXCursor_ObjCInstanceMethodDecl) {
1197     if (cursor.xdata != -1)
1198       return std::make_pair(cursor.xdata,
1199                             cast<ObjCMethodDecl>(getCursorDecl(cursor))
1200                                 ->getSelectorLoc(cursor.xdata));
1201   }
1202 
1203   return std::make_pair(-1, SourceLocation());
1204 }
1205 
1206 CXCursor cxcursor::getSelectorIdentifierCursor(int SelIdx, CXCursor cursor) {
1207   CXCursor newCursor = cursor;
1208 
1209   if (cursor.kind == CXCursor_ObjCMessageExpr) {
1210     if (SelIdx == -1 ||
1211         unsigned(SelIdx) >=
1212             cast<ObjCMessageExpr>(getCursorExpr(cursor))->getNumSelectorLocs())
1213       newCursor.xdata = -1;
1214     else
1215       newCursor.xdata = SelIdx;
1216   } else if (cursor.kind == CXCursor_ObjCClassMethodDecl ||
1217              cursor.kind == CXCursor_ObjCInstanceMethodDecl) {
1218     if (SelIdx == -1 ||
1219         unsigned(SelIdx) >=
1220             cast<ObjCMethodDecl>(getCursorDecl(cursor))->getNumSelectorLocs())
1221       newCursor.xdata = -1;
1222     else
1223       newCursor.xdata = SelIdx;
1224   }
1225 
1226   return newCursor;
1227 }
1228 
1229 CXCursor cxcursor::getTypeRefCursor(CXCursor cursor) {
1230   if (cursor.kind != CXCursor_CallExpr)
1231     return cursor;
1232 
1233   if (cursor.xdata == 0)
1234     return cursor;
1235 
1236   const Expr *E = getCursorExpr(cursor);
1237   TypeSourceInfo *Type = nullptr;
1238   if (const CXXUnresolvedConstructExpr *UnCtor =
1239           dyn_cast<CXXUnresolvedConstructExpr>(E)) {
1240     Type = UnCtor->getTypeSourceInfo();
1241   } else if (const CXXTemporaryObjectExpr *Tmp =
1242                  dyn_cast<CXXTemporaryObjectExpr>(E)) {
1243     Type = Tmp->getTypeSourceInfo();
1244   }
1245 
1246   if (!Type)
1247     return cursor;
1248 
1249   CXTranslationUnit TU = getCursorTU(cursor);
1250   QualType Ty = Type->getType();
1251   TypeLoc TL = Type->getTypeLoc();
1252   SourceLocation Loc = TL.getBeginLoc();
1253 
1254   if (const ElaboratedType *ElabT = Ty->getAs<ElaboratedType>()) {
1255     Ty = ElabT->getNamedType();
1256     ElaboratedTypeLoc ElabTL = TL.castAs<ElaboratedTypeLoc>();
1257     Loc = ElabTL.getNamedTypeLoc().getBeginLoc();
1258   }
1259 
1260   if (const TypedefType *Typedef = Ty->getAs<TypedefType>())
1261     return MakeCursorTypeRef(Typedef->getDecl(), Loc, TU);
1262   if (const TagType *Tag = Ty->getAs<TagType>())
1263     return MakeCursorTypeRef(Tag->getDecl(), Loc, TU);
1264   if (const TemplateTypeParmType *TemplP = Ty->getAs<TemplateTypeParmType>())
1265     return MakeCursorTypeRef(TemplP->getDecl(), Loc, TU);
1266 
1267   return cursor;
1268 }
1269 
1270 bool cxcursor::operator==(CXCursor X, CXCursor Y) {
1271   return X.kind == Y.kind && X.data[0] == Y.data[0] && X.data[1] == Y.data[1] &&
1272          X.data[2] == Y.data[2];
1273 }
1274 
1275 // FIXME: Remove once we can model DeclGroups and their appropriate ranges
1276 // properly in the ASTs.
1277 bool cxcursor::isFirstInDeclGroup(CXCursor C) {
1278   assert(clang_isDeclaration(C.kind));
1279   return ((uintptr_t)(C.data[1])) != 0;
1280 }
1281 
1282 //===----------------------------------------------------------------------===//
1283 // libclang CXCursor APIs
1284 //===----------------------------------------------------------------------===//
1285 
1286 int clang_Cursor_isNull(CXCursor cursor) {
1287   return clang_equalCursors(cursor, clang_getNullCursor());
1288 }
1289 
1290 CXTranslationUnit clang_Cursor_getTranslationUnit(CXCursor cursor) {
1291   return getCursorTU(cursor);
1292 }
1293 
1294 int clang_Cursor_getNumArguments(CXCursor C) {
1295   if (clang_isDeclaration(C.kind)) {
1296     const Decl *D = cxcursor::getCursorDecl(C);
1297     if (const ObjCMethodDecl *MD = dyn_cast_or_null<ObjCMethodDecl>(D))
1298       return MD->param_size();
1299     if (const FunctionDecl *FD = dyn_cast_or_null<FunctionDecl>(D))
1300       return FD->param_size();
1301   }
1302 
1303   if (clang_isExpression(C.kind)) {
1304     const Expr *E = cxcursor::getCursorExpr(C);
1305     if (const CallExpr *CE = dyn_cast<CallExpr>(E)) {
1306       return CE->getNumArgs();
1307     }
1308     if (const CXXConstructExpr *CE = dyn_cast<CXXConstructExpr>(E)) {
1309       return CE->getNumArgs();
1310     }
1311   }
1312 
1313   return -1;
1314 }
1315 
1316 CXCursor clang_Cursor_getArgument(CXCursor C, unsigned i) {
1317   if (clang_isDeclaration(C.kind)) {
1318     const Decl *D = cxcursor::getCursorDecl(C);
1319     if (const ObjCMethodDecl *MD = dyn_cast_or_null<ObjCMethodDecl>(D)) {
1320       if (i < MD->param_size())
1321         return cxcursor::MakeCXCursor(MD->parameters()[i],
1322                                       cxcursor::getCursorTU(C));
1323     } else if (const FunctionDecl *FD = dyn_cast_or_null<FunctionDecl>(D)) {
1324       if (i < FD->param_size())
1325         return cxcursor::MakeCXCursor(FD->parameters()[i],
1326                                       cxcursor::getCursorTU(C));
1327     }
1328   }
1329 
1330   if (clang_isExpression(C.kind)) {
1331     const Expr *E = cxcursor::getCursorExpr(C);
1332     if (const CallExpr *CE = dyn_cast<CallExpr>(E)) {
1333       if (i < CE->getNumArgs()) {
1334         return cxcursor::MakeCXCursor(CE->getArg(i), getCursorDecl(C),
1335                                       cxcursor::getCursorTU(C));
1336       }
1337     }
1338     if (const CXXConstructExpr *CE = dyn_cast<CXXConstructExpr>(E)) {
1339       if (i < CE->getNumArgs()) {
1340         return cxcursor::MakeCXCursor(CE->getArg(i), getCursorDecl(C),
1341                                       cxcursor::getCursorTU(C));
1342       }
1343     }
1344   }
1345 
1346   return clang_getNullCursor();
1347 }
1348 
1349 int clang_Cursor_getNumTemplateArguments(CXCursor C) {
1350   if (clang_getCursorKind(C) != CXCursor_FunctionDecl) {
1351     return -1;
1352   }
1353 
1354   const FunctionDecl *FD =
1355       llvm::dyn_cast_or_null<clang::FunctionDecl>(getCursorDecl(C));
1356   if (!FD) {
1357     return -1;
1358   }
1359 
1360   const FunctionTemplateSpecializationInfo *SpecInfo =
1361       FD->getTemplateSpecializationInfo();
1362   if (!SpecInfo) {
1363     return -1;
1364   }
1365 
1366   return SpecInfo->TemplateArguments->size();
1367 }
1368 
1369 enum CXGetTemplateArgumentStatus {
1370   /** The operation completed successfully */
1371   CXGetTemplateArgumentStatus_Success = 0,
1372 
1373   /** The specified cursor did not represent a FunctionDecl. */
1374   CXGetTemplateArgumentStatus_CursorNotFunctionDecl = -1,
1375 
1376   /** The specified cursor was not castable to a FunctionDecl. */
1377   CXGetTemplateArgumentStatus_BadFunctionDeclCast = -2,
1378 
1379   /** A NULL FunctionTemplateSpecializationInfo was retrieved. */
1380   CXGetTemplateArgumentStatus_NullTemplSpecInfo = -3,
1381 
1382   /** An invalid (OOB) argument index was specified */
1383   CXGetTemplateArgumentStatus_InvalidIndex = -4
1384 };
1385 
1386 static int clang_Cursor_getTemplateArgument(CXCursor C, unsigned I,
1387                                             TemplateArgument *TA) {
1388   if (clang_getCursorKind(C) != CXCursor_FunctionDecl) {
1389     return CXGetTemplateArgumentStatus_CursorNotFunctionDecl;
1390   }
1391 
1392   const FunctionDecl *FD =
1393       llvm::dyn_cast_or_null<clang::FunctionDecl>(getCursorDecl(C));
1394   if (!FD) {
1395     return CXGetTemplateArgumentStatus_BadFunctionDeclCast;
1396   }
1397 
1398   const FunctionTemplateSpecializationInfo *SpecInfo =
1399       FD->getTemplateSpecializationInfo();
1400   if (!SpecInfo) {
1401     return CXGetTemplateArgumentStatus_NullTemplSpecInfo;
1402   }
1403 
1404   if (I >= SpecInfo->TemplateArguments->size()) {
1405     return CXGetTemplateArgumentStatus_InvalidIndex;
1406   }
1407 
1408   *TA = SpecInfo->TemplateArguments->get(I);
1409   return 0;
1410 }
1411 
1412 enum CXTemplateArgumentKind clang_Cursor_getTemplateArgumentKind(CXCursor C,
1413                                                                  unsigned I) {
1414   TemplateArgument TA;
1415   if (clang_Cursor_getTemplateArgument(C, I, &TA)) {
1416     return CXTemplateArgumentKind_Invalid;
1417   }
1418 
1419   switch (TA.getKind()) {
1420   case TemplateArgument::Null:
1421     return CXTemplateArgumentKind_Null;
1422   case TemplateArgument::Type:
1423     return CXTemplateArgumentKind_Type;
1424   case TemplateArgument::Declaration:
1425     return CXTemplateArgumentKind_Declaration;
1426   case TemplateArgument::NullPtr:
1427     return CXTemplateArgumentKind_NullPtr;
1428   case TemplateArgument::Integral:
1429     return CXTemplateArgumentKind_Integral;
1430   case TemplateArgument::Template:
1431     return CXTemplateArgumentKind_Template;
1432   case TemplateArgument::TemplateExpansion:
1433     return CXTemplateArgumentKind_TemplateExpansion;
1434   case TemplateArgument::Expression:
1435     return CXTemplateArgumentKind_Expression;
1436   case TemplateArgument::Pack:
1437     return CXTemplateArgumentKind_Pack;
1438   }
1439 
1440   return CXTemplateArgumentKind_Invalid;
1441 }
1442 
1443 CXType clang_Cursor_getTemplateArgumentType(CXCursor C, unsigned I) {
1444   TemplateArgument TA;
1445   if (clang_Cursor_getTemplateArgument(C, I, &TA) !=
1446       CXGetTemplateArgumentStatus_Success) {
1447     return cxtype::MakeCXType(QualType(), getCursorTU(C));
1448   }
1449 
1450   if (TA.getKind() != TemplateArgument::Type) {
1451     return cxtype::MakeCXType(QualType(), getCursorTU(C));
1452   }
1453 
1454   return cxtype::MakeCXType(TA.getAsType(), getCursorTU(C));
1455 }
1456 
1457 long long clang_Cursor_getTemplateArgumentValue(CXCursor C, unsigned I) {
1458   TemplateArgument TA;
1459   if (clang_Cursor_getTemplateArgument(C, I, &TA) !=
1460       CXGetTemplateArgumentStatus_Success) {
1461     assert(0 && "Unable to retrieve TemplateArgument");
1462     return 0;
1463   }
1464 
1465   if (TA.getKind() != TemplateArgument::Integral) {
1466     assert(0 && "Passed template argument is not Integral");
1467     return 0;
1468   }
1469 
1470   return TA.getAsIntegral().getSExtValue();
1471 }
1472 
1473 unsigned long long clang_Cursor_getTemplateArgumentUnsignedValue(CXCursor C,
1474                                                                  unsigned I) {
1475   TemplateArgument TA;
1476   if (clang_Cursor_getTemplateArgument(C, I, &TA) !=
1477       CXGetTemplateArgumentStatus_Success) {
1478     assert(0 && "Unable to retrieve TemplateArgument");
1479     return 0;
1480   }
1481 
1482   if (TA.getKind() != TemplateArgument::Integral) {
1483     assert(0 && "Passed template argument is not Integral");
1484     return 0;
1485   }
1486 
1487   return TA.getAsIntegral().getZExtValue();
1488 }
1489 
1490 //===----------------------------------------------------------------------===//
1491 // CXCursorSet.
1492 //===----------------------------------------------------------------------===//
1493 
1494 typedef llvm::DenseMap<CXCursor, unsigned> CXCursorSet_Impl;
1495 
1496 static inline CXCursorSet packCXCursorSet(CXCursorSet_Impl *setImpl) {
1497   return (CXCursorSet)setImpl;
1498 }
1499 static inline CXCursorSet_Impl *unpackCXCursorSet(CXCursorSet set) {
1500   return (CXCursorSet_Impl *)set;
1501 }
1502 namespace llvm {
1503 template <> struct DenseMapInfo<CXCursor> {
1504 public:
1505   static inline CXCursor getEmptyKey() {
1506     return MakeCXCursorInvalid(CXCursor_InvalidFile);
1507   }
1508   static inline CXCursor getTombstoneKey() {
1509     return MakeCXCursorInvalid(CXCursor_NoDeclFound);
1510   }
1511   static inline unsigned getHashValue(const CXCursor &cursor) {
1512     return llvm::DenseMapInfo<std::pair<const void *, const void *>>::
1513         getHashValue(std::make_pair(cursor.data[0], cursor.data[1]));
1514   }
1515   static inline bool isEqual(const CXCursor &x, const CXCursor &y) {
1516     return x.kind == y.kind && x.data[0] == y.data[0] && x.data[1] == y.data[1];
1517   }
1518 };
1519 } // namespace llvm
1520 
1521 CXCursorSet clang_createCXCursorSet() {
1522   return packCXCursorSet(new CXCursorSet_Impl());
1523 }
1524 
1525 void clang_disposeCXCursorSet(CXCursorSet set) {
1526   delete unpackCXCursorSet(set);
1527 }
1528 
1529 unsigned clang_CXCursorSet_contains(CXCursorSet set, CXCursor cursor) {
1530   CXCursorSet_Impl *setImpl = unpackCXCursorSet(set);
1531   if (!setImpl)
1532     return 0;
1533   return setImpl->find(cursor) != setImpl->end();
1534 }
1535 
1536 unsigned clang_CXCursorSet_insert(CXCursorSet set, CXCursor cursor) {
1537   // Do not insert invalid cursors into the set.
1538   if (cursor.kind >= CXCursor_FirstInvalid &&
1539       cursor.kind <= CXCursor_LastInvalid)
1540     return 1;
1541 
1542   CXCursorSet_Impl *setImpl = unpackCXCursorSet(set);
1543   if (!setImpl)
1544     return 1;
1545   unsigned &entry = (*setImpl)[cursor];
1546   unsigned flag = entry == 0 ? 1 : 0;
1547   entry = 1;
1548   return flag;
1549 }
1550 
1551 CXCompletionString clang_getCursorCompletionString(CXCursor cursor) {
1552   enum CXCursorKind kind = clang_getCursorKind(cursor);
1553   if (clang_isDeclaration(kind)) {
1554     const Decl *decl = getCursorDecl(cursor);
1555     if (const NamedDecl *namedDecl = dyn_cast_or_null<NamedDecl>(decl)) {
1556       ASTUnit *unit = getCursorASTUnit(cursor);
1557       CodeCompletionResult Result(namedDecl, CCP_Declaration);
1558       CodeCompletionString *String = Result.CreateCodeCompletionString(
1559           unit->getASTContext(), unit->getPreprocessor(),
1560           CodeCompletionContext::CCC_Other,
1561           unit->getCodeCompletionTUInfo().getAllocator(),
1562           unit->getCodeCompletionTUInfo(), true);
1563       return String;
1564     }
1565   } else if (kind == CXCursor_MacroDefinition) {
1566     const MacroDefinitionRecord *definition = getCursorMacroDefinition(cursor);
1567     const IdentifierInfo *Macro = definition->getName();
1568     ASTUnit *unit = getCursorASTUnit(cursor);
1569     CodeCompletionResult Result(
1570         Macro,
1571         unit->getPreprocessor().getMacroDefinition(Macro).getMacroInfo());
1572     CodeCompletionString *String = Result.CreateCodeCompletionString(
1573         unit->getASTContext(), unit->getPreprocessor(),
1574         CodeCompletionContext::CCC_Other,
1575         unit->getCodeCompletionTUInfo().getAllocator(),
1576         unit->getCodeCompletionTUInfo(), false);
1577     return String;
1578   }
1579   return nullptr;
1580 }
1581 
1582 namespace {
1583 struct OverridenCursorsPool {
1584   typedef SmallVector<CXCursor, 2> CursorVec;
1585   std::vector<CursorVec *> AllCursors;
1586   std::vector<CursorVec *> AvailableCursors;
1587 
1588   ~OverridenCursorsPool() {
1589     for (std::vector<CursorVec *>::iterator I = AllCursors.begin(),
1590                                             E = AllCursors.end();
1591          I != E; ++I) {
1592       delete *I;
1593     }
1594   }
1595 };
1596 } // namespace
1597 
1598 void *cxcursor::createOverridenCXCursorsPool() {
1599   return new OverridenCursorsPool();
1600 }
1601 
1602 void cxcursor::disposeOverridenCXCursorsPool(void *pool) {
1603   delete static_cast<OverridenCursorsPool *>(pool);
1604 }
1605 
1606 void clang_getOverriddenCursors(CXCursor cursor, CXCursor **overridden,
1607                                 unsigned *num_overridden) {
1608   if (overridden)
1609     *overridden = nullptr;
1610   if (num_overridden)
1611     *num_overridden = 0;
1612 
1613   CXTranslationUnit TU = cxcursor::getCursorTU(cursor);
1614 
1615   if (!overridden || !num_overridden || !TU)
1616     return;
1617 
1618   if (!clang_isDeclaration(cursor.kind))
1619     return;
1620 
1621   OverridenCursorsPool &pool =
1622       *static_cast<OverridenCursorsPool *>(TU->OverridenCursorsPool);
1623 
1624   OverridenCursorsPool::CursorVec *Vec = nullptr;
1625 
1626   if (!pool.AvailableCursors.empty()) {
1627     Vec = pool.AvailableCursors.back();
1628     pool.AvailableCursors.pop_back();
1629   } else {
1630     Vec = new OverridenCursorsPool::CursorVec();
1631     pool.AllCursors.push_back(Vec);
1632   }
1633 
1634   // Clear out the vector, but don't free the memory contents.  This
1635   // reduces malloc() traffic.
1636   Vec->clear();
1637 
1638   // Use the first entry to contain a back reference to the vector.
1639   // This is a complete hack.
1640   CXCursor backRefCursor = MakeCXCursorInvalid(CXCursor_InvalidFile, TU);
1641   backRefCursor.data[0] = Vec;
1642   assert(cxcursor::getCursorTU(backRefCursor) == TU);
1643   Vec->push_back(backRefCursor);
1644 
1645   // Get the overridden cursors.
1646   cxcursor::getOverriddenCursors(cursor, *Vec);
1647 
1648   // Did we get any overridden cursors?  If not, return Vec to the pool
1649   // of available cursor vectors.
1650   if (Vec->size() == 1) {
1651     pool.AvailableCursors.push_back(Vec);
1652     return;
1653   }
1654 
1655   // Now tell the caller about the overridden cursors.
1656   assert(Vec->size() > 1);
1657   *overridden = &((*Vec)[1]);
1658   *num_overridden = Vec->size() - 1;
1659 }
1660 
1661 void clang_disposeOverriddenCursors(CXCursor *overridden) {
1662   if (!overridden)
1663     return;
1664 
1665   // Use pointer arithmetic to get back the first faux entry
1666   // which has a back-reference to the TU and the vector.
1667   --overridden;
1668   OverridenCursorsPool::CursorVec *Vec =
1669       static_cast<OverridenCursorsPool::CursorVec *>(
1670           const_cast<void *>(overridden->data[0]));
1671   CXTranslationUnit TU = getCursorTU(*overridden);
1672 
1673   assert(Vec && TU);
1674 
1675   OverridenCursorsPool &pool =
1676       *static_cast<OverridenCursorsPool *>(TU->OverridenCursorsPool);
1677 
1678   pool.AvailableCursors.push_back(Vec);
1679 }
1680 
1681 int clang_Cursor_isDynamicCall(CXCursor C) {
1682   const Expr *E = nullptr;
1683   if (clang_isExpression(C.kind))
1684     E = getCursorExpr(C);
1685   if (!E)
1686     return 0;
1687 
1688   if (const ObjCMessageExpr *MsgE = dyn_cast<ObjCMessageExpr>(E)) {
1689     if (MsgE->getReceiverKind() != ObjCMessageExpr::Instance)
1690       return false;
1691     if (auto *RecE = dyn_cast<ObjCMessageExpr>(
1692             MsgE->getInstanceReceiver()->IgnoreParenCasts())) {
1693       if (RecE->getMethodFamily() == OMF_alloc)
1694         return false;
1695     }
1696     return true;
1697   }
1698 
1699   if (auto *PropRefE = dyn_cast<ObjCPropertyRefExpr>(E)) {
1700     return !PropRefE->isSuperReceiver();
1701   }
1702 
1703   const MemberExpr *ME = nullptr;
1704   if (isa<MemberExpr>(E))
1705     ME = cast<MemberExpr>(E);
1706   else if (const CallExpr *CE = dyn_cast<CallExpr>(E))
1707     ME = dyn_cast_or_null<MemberExpr>(CE->getCallee());
1708 
1709   if (ME) {
1710     if (const CXXMethodDecl *MD =
1711             dyn_cast_or_null<CXXMethodDecl>(ME->getMemberDecl()))
1712       return MD->isVirtual() &&
1713              ME->performsVirtualDispatch(
1714                  cxcursor::getCursorContext(C).getLangOpts());
1715   }
1716 
1717   return 0;
1718 }
1719 
1720 CXType clang_Cursor_getReceiverType(CXCursor C) {
1721   CXTranslationUnit TU = cxcursor::getCursorTU(C);
1722   const Expr *E = nullptr;
1723   if (clang_isExpression(C.kind))
1724     E = getCursorExpr(C);
1725 
1726   if (const ObjCMessageExpr *MsgE = dyn_cast_or_null<ObjCMessageExpr>(E))
1727     return cxtype::MakeCXType(MsgE->getReceiverType(), TU);
1728 
1729   if (auto *PropRefE = dyn_cast<ObjCPropertyRefExpr>(E)) {
1730     return cxtype::MakeCXType(
1731         PropRefE->getReceiverType(cxcursor::getCursorContext(C)), TU);
1732   }
1733 
1734   const MemberExpr *ME = nullptr;
1735   if (isa<MemberExpr>(E))
1736     ME = cast<MemberExpr>(E);
1737   else if (const CallExpr *CE = dyn_cast<CallExpr>(E))
1738     ME = dyn_cast_or_null<MemberExpr>(CE->getCallee());
1739 
1740   if (ME) {
1741     if (isa_and_nonnull<CXXMethodDecl>(ME->getMemberDecl())) {
1742       auto receiverTy = ME->getBase()->IgnoreImpCasts()->getType();
1743       return cxtype::MakeCXType(receiverTy, TU);
1744     }
1745   }
1746 
1747   return cxtype::MakeCXType(QualType(), TU);
1748 }
1749