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