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