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