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