Ted Kremenek | d2fa566 | 2009-08-26 22:36:44 +0000 | [diff] [blame] | 1 | //===- CIndex.cpp - Clang-C Source Indexing Library -----------------------===// |
| 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 implements the Clang-C Source Indexing library. |
| 11 | // |
| 12 | //===----------------------------------------------------------------------===// |
| 13 | |
| 14 | #include "clang-c/Index.h" |
Steve Naroff | 5039819 | 2009-08-28 15:28:48 +0000 | [diff] [blame] | 15 | #include "clang/Index/Program.h" |
| 16 | #include "clang/Index/Indexer.h" |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 17 | #include "clang/Index/ASTLocation.h" |
| 18 | #include "clang/Index/Utils.h" |
Steve Naroff | 5039819 | 2009-08-28 15:28:48 +0000 | [diff] [blame] | 19 | #include "clang/AST/DeclVisitor.h" |
Steve Naroff | fb57042 | 2009-09-22 19:25:29 +0000 | [diff] [blame] | 20 | #include "clang/AST/StmtVisitor.h" |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 21 | #include "clang/AST/Decl.h" |
Benjamin Kramer | d01a0bc | 2009-08-29 12:56:35 +0000 | [diff] [blame] | 22 | #include "clang/Basic/FileManager.h" |
Steve Naroff | 2d4d629 | 2009-08-31 14:26:51 +0000 | [diff] [blame] | 23 | #include "clang/Basic/SourceManager.h" |
Benjamin Kramer | d01a0bc | 2009-08-29 12:56:35 +0000 | [diff] [blame] | 24 | #include "clang/Frontend/ASTUnit.h" |
Benjamin Kramer | 20d7581 | 2009-10-18 16:13:48 +0000 | [diff] [blame] | 25 | #include "llvm/Config/config.h" |
Douglas Gregor | 0246575 | 2009-10-16 21:24:31 +0000 | [diff] [blame] | 26 | #include "llvm/Support/MemoryBuffer.h" |
| 27 | #include "llvm/System/Path.h" |
Benjamin Kramer | 0829a83 | 2009-10-18 11:19:36 +0000 | [diff] [blame] | 28 | #include "llvm/System/Program.h" |
Benjamin Kramer | d01a0bc | 2009-08-29 12:56:35 +0000 | [diff] [blame] | 29 | #include <cstdio> |
Benjamin Kramer | 20d7581 | 2009-10-18 16:13:48 +0000 | [diff] [blame] | 30 | #ifdef LLVM_ON_WIN32 |
| 31 | #define WIN32_LEAN_AND_MEAN |
| 32 | #include <windows.h> |
| 33 | #else |
Steve Naroff | 5b7d8e2 | 2009-10-15 20:04:39 +0000 | [diff] [blame] | 34 | #include <dlfcn.h> |
Daniel Dunbar | a47dd19 | 2009-10-17 23:53:11 +0000 | [diff] [blame] | 35 | #endif |
Ted Kremenek | 74cd069 | 2009-10-15 23:21:22 +0000 | [diff] [blame] | 36 | #include <vector> |
Steve Naroff | 5b7d8e2 | 2009-10-15 20:04:39 +0000 | [diff] [blame] | 37 | |
Steve Naroff | 5039819 | 2009-08-28 15:28:48 +0000 | [diff] [blame] | 38 | using namespace clang; |
| 39 | using namespace idx; |
| 40 | |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 41 | namespace { |
| 42 | |
Steve Naroff | 4ade6d6 | 2009-09-23 17:52:52 +0000 | [diff] [blame] | 43 | static enum CXCursorKind TranslateDeclRefExpr(DeclRefExpr *DRE) |
| 44 | { |
| 45 | NamedDecl *D = DRE->getDecl(); |
| 46 | if (isa<VarDecl>(D)) |
| 47 | return CXCursor_VarRef; |
| 48 | else if (isa<FunctionDecl>(D)) |
| 49 | return CXCursor_FunctionRef; |
| 50 | else if (isa<EnumConstantDecl>(D)) |
| 51 | return CXCursor_EnumConstantRef; |
| 52 | else |
| 53 | return CXCursor_NotImplemented; |
| 54 | } |
| 55 | |
| 56 | #if 0 |
| 57 | // Will be useful one day. |
Steve Naroff | fb57042 | 2009-09-22 19:25:29 +0000 | [diff] [blame] | 58 | class CRefVisitor : public StmtVisitor<CRefVisitor> { |
| 59 | CXDecl CDecl; |
| 60 | CXDeclIterator Callback; |
| 61 | CXClientData CData; |
| 62 | |
| 63 | void Call(enum CXCursorKind CK, Stmt *SRef) { |
| 64 | CXCursor C = { CK, CDecl, SRef }; |
| 65 | Callback(CDecl, C, CData); |
| 66 | } |
| 67 | |
| 68 | public: |
| 69 | CRefVisitor(CXDecl C, CXDeclIterator cback, CXClientData D) : |
| 70 | CDecl(C), Callback(cback), CData(D) {} |
| 71 | |
| 72 | void VisitStmt(Stmt *S) { |
| 73 | for (Stmt::child_iterator C = S->child_begin(), CEnd = S->child_end(); |
| 74 | C != CEnd; ++C) |
| 75 | Visit(*C); |
| 76 | } |
| 77 | void VisitDeclRefExpr(DeclRefExpr *Node) { |
Steve Naroff | 4ade6d6 | 2009-09-23 17:52:52 +0000 | [diff] [blame] | 78 | Call(TranslateDeclRefExpr(Node), Node); |
Steve Naroff | fb57042 | 2009-09-22 19:25:29 +0000 | [diff] [blame] | 79 | } |
| 80 | void VisitMemberExpr(MemberExpr *Node) { |
| 81 | Call(CXCursor_MemberRef, Node); |
| 82 | } |
| 83 | void VisitObjCMessageExpr(ObjCMessageExpr *Node) { |
| 84 | Call(CXCursor_ObjCSelectorRef, Node); |
| 85 | } |
| 86 | void VisitObjCIvarRefExpr(ObjCIvarRefExpr *Node) { |
| 87 | Call(CXCursor_ObjCIvarRef, Node); |
| 88 | } |
| 89 | }; |
Steve Naroff | 4ade6d6 | 2009-09-23 17:52:52 +0000 | [diff] [blame] | 90 | #endif |
Steve Naroff | fb57042 | 2009-09-22 19:25:29 +0000 | [diff] [blame] | 91 | |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 92 | // Translation Unit Visitor. |
| 93 | class TUVisitor : public DeclVisitor<TUVisitor> { |
| 94 | CXTranslationUnit TUnit; |
| 95 | CXTranslationUnitIterator Callback; |
Steve Naroff | 2b8ee6c | 2009-09-01 15:55:40 +0000 | [diff] [blame] | 96 | CXClientData CData; |
| 97 | |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 98 | // MaxPCHLevel - the maximum PCH level of declarations that we will pass on |
| 99 | // to the visitor. Declarations with a PCH level greater than this value will |
| 100 | // be suppressed. |
| 101 | unsigned MaxPCHLevel; |
| 102 | |
Steve Naroff | 2b8ee6c | 2009-09-01 15:55:40 +0000 | [diff] [blame] | 103 | void Call(enum CXCursorKind CK, NamedDecl *ND) { |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 104 | // Filter any declarations that have a PCH level greater than what we allow. |
| 105 | if (ND->getPCHLevel() > MaxPCHLevel) |
| 106 | return; |
| 107 | |
Steve Naroff | fb57042 | 2009-09-22 19:25:29 +0000 | [diff] [blame] | 108 | CXCursor C = { CK, ND, 0 }; |
Steve Naroff | 2b8ee6c | 2009-09-01 15:55:40 +0000 | [diff] [blame] | 109 | Callback(TUnit, C, CData); |
| 110 | } |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 111 | public: |
Steve Naroff | 2b8ee6c | 2009-09-01 15:55:40 +0000 | [diff] [blame] | 112 | TUVisitor(CXTranslationUnit CTU, |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 113 | CXTranslationUnitIterator cback, CXClientData D, |
| 114 | unsigned MaxPCHLevel) : |
| 115 | TUnit(CTU), Callback(cback), CData(D), MaxPCHLevel(MaxPCHLevel) {} |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 116 | |
| 117 | void VisitTranslationUnitDecl(TranslationUnitDecl *D) { |
| 118 | VisitDeclContext(dyn_cast<DeclContext>(D)); |
| 119 | } |
| 120 | void VisitDeclContext(DeclContext *DC) { |
| 121 | for (DeclContext::decl_iterator |
| 122 | I = DC->decls_begin(), E = DC->decls_end(); I != E; ++I) |
| 123 | Visit(*I); |
| 124 | } |
Steve Naroff | 2b8ee6c | 2009-09-01 15:55:40 +0000 | [diff] [blame] | 125 | void VisitTypedefDecl(TypedefDecl *ND) { |
| 126 | Call(CXCursor_TypedefDecl, ND); |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 127 | } |
| 128 | void VisitTagDecl(TagDecl *ND) { |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 129 | switch (ND->getTagKind()) { |
| 130 | case TagDecl::TK_struct: |
| 131 | Call(CXCursor_StructDecl, ND); |
| 132 | break; |
| 133 | case TagDecl::TK_class: |
| 134 | Call(CXCursor_ClassDecl, ND); |
| 135 | break; |
| 136 | case TagDecl::TK_union: |
| 137 | Call(CXCursor_UnionDecl, ND); |
| 138 | break; |
| 139 | case TagDecl::TK_enum: |
| 140 | Call(CXCursor_EnumDecl, ND); |
| 141 | break; |
| 142 | } |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 143 | } |
Steve Naroff | af08ddc | 2009-09-03 15:49:00 +0000 | [diff] [blame] | 144 | void VisitVarDecl(VarDecl *ND) { |
| 145 | Call(CXCursor_VarDecl, ND); |
| 146 | } |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 147 | void VisitFunctionDecl(FunctionDecl *ND) { |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 148 | Call(ND->isThisDeclarationADefinition() ? CXCursor_FunctionDefn |
| 149 | : CXCursor_FunctionDecl, ND); |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 150 | } |
| 151 | void VisitObjCInterfaceDecl(ObjCInterfaceDecl *ND) { |
Steve Naroff | 2b8ee6c | 2009-09-01 15:55:40 +0000 | [diff] [blame] | 152 | Call(CXCursor_ObjCInterfaceDecl, ND); |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 153 | } |
| 154 | void VisitObjCCategoryDecl(ObjCCategoryDecl *ND) { |
Steve Naroff | 2b8ee6c | 2009-09-01 15:55:40 +0000 | [diff] [blame] | 155 | Call(CXCursor_ObjCCategoryDecl, ND); |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 156 | } |
| 157 | void VisitObjCProtocolDecl(ObjCProtocolDecl *ND) { |
Steve Naroff | 2b8ee6c | 2009-09-01 15:55:40 +0000 | [diff] [blame] | 158 | Call(CXCursor_ObjCProtocolDecl, ND); |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 159 | } |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 160 | void VisitObjCImplementationDecl(ObjCImplementationDecl *ND) { |
| 161 | Call(CXCursor_ObjCClassDefn, ND); |
| 162 | } |
| 163 | void VisitObjCCategoryImplDecl(ObjCCategoryImplDecl *ND) { |
| 164 | Call(CXCursor_ObjCCategoryDefn, ND); |
| 165 | } |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 166 | }; |
| 167 | |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 168 | // Declaration visitor. |
| 169 | class CDeclVisitor : public DeclVisitor<CDeclVisitor> { |
| 170 | CXDecl CDecl; |
| 171 | CXDeclIterator Callback; |
| 172 | CXClientData CData; |
| 173 | |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 174 | // MaxPCHLevel - the maximum PCH level of declarations that we will pass on |
| 175 | // to the visitor. Declarations with a PCH level greater than this value will |
| 176 | // be suppressed. |
| 177 | unsigned MaxPCHLevel; |
| 178 | |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 179 | void Call(enum CXCursorKind CK, NamedDecl *ND) { |
Steve Naroff | af08ddc | 2009-09-03 15:49:00 +0000 | [diff] [blame] | 180 | // Disable the callback when the context is equal to the visiting decl. |
| 181 | if (CDecl == ND && !clang_isReference(CK)) |
| 182 | return; |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 183 | |
| 184 | // Filter any declarations that have a PCH level greater than what we allow. |
| 185 | if (ND->getPCHLevel() > MaxPCHLevel) |
| 186 | return; |
| 187 | |
Steve Naroff | fb57042 | 2009-09-22 19:25:29 +0000 | [diff] [blame] | 188 | CXCursor C = { CK, ND, 0 }; |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 189 | Callback(CDecl, C, CData); |
| 190 | } |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 191 | public: |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 192 | CDeclVisitor(CXDecl C, CXDeclIterator cback, CXClientData D, |
| 193 | unsigned MaxPCHLevel) : |
| 194 | CDecl(C), Callback(cback), CData(D), MaxPCHLevel(MaxPCHLevel) {} |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 195 | |
Steve Naroff | af08ddc | 2009-09-03 15:49:00 +0000 | [diff] [blame] | 196 | void VisitObjCCategoryDecl(ObjCCategoryDecl *ND) { |
| 197 | // Issue callbacks for the containing class. |
| 198 | Call(CXCursor_ObjCClassRef, ND); |
| 199 | // FIXME: Issue callbacks for protocol refs. |
| 200 | VisitDeclContext(dyn_cast<DeclContext>(ND)); |
| 201 | } |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 202 | void VisitObjCInterfaceDecl(ObjCInterfaceDecl *D) { |
Steve Naroff | af08ddc | 2009-09-03 15:49:00 +0000 | [diff] [blame] | 203 | // Issue callbacks for super class. |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 204 | if (D->getSuperClass()) |
| 205 | Call(CXCursor_ObjCSuperClassRef, D); |
| 206 | |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 207 | for (ObjCProtocolDecl::protocol_iterator I = D->protocol_begin(), |
| 208 | E = D->protocol_end(); I != E; ++I) |
| 209 | Call(CXCursor_ObjCProtocolRef, *I); |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 210 | VisitDeclContext(dyn_cast<DeclContext>(D)); |
| 211 | } |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 212 | void VisitObjCProtocolDecl(ObjCProtocolDecl *PID) { |
| 213 | for (ObjCProtocolDecl::protocol_iterator I = PID->protocol_begin(), |
| 214 | E = PID->protocol_end(); I != E; ++I) |
| 215 | Call(CXCursor_ObjCProtocolRef, *I); |
| 216 | |
| 217 | VisitDeclContext(dyn_cast<DeclContext>(PID)); |
| 218 | } |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 219 | void VisitTagDecl(TagDecl *D) { |
| 220 | VisitDeclContext(dyn_cast<DeclContext>(D)); |
| 221 | } |
| 222 | void VisitObjCImplementationDecl(ObjCImplementationDecl *D) { |
| 223 | VisitDeclContext(dyn_cast<DeclContext>(D)); |
| 224 | } |
| 225 | void VisitObjCCategoryImplDecl(ObjCCategoryImplDecl *D) { |
| 226 | VisitDeclContext(dyn_cast<DeclContext>(D)); |
| 227 | } |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 228 | void VisitDeclContext(DeclContext *DC) { |
| 229 | for (DeclContext::decl_iterator |
| 230 | I = DC->decls_begin(), E = DC->decls_end(); I != E; ++I) |
| 231 | Visit(*I); |
| 232 | } |
| 233 | void VisitEnumConstantDecl(EnumConstantDecl *ND) { |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 234 | Call(CXCursor_EnumConstantDecl, ND); |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 235 | } |
| 236 | void VisitFieldDecl(FieldDecl *ND) { |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 237 | Call(CXCursor_FieldDecl, ND); |
| 238 | } |
Steve Naroff | af08ddc | 2009-09-03 15:49:00 +0000 | [diff] [blame] | 239 | void VisitVarDecl(VarDecl *ND) { |
| 240 | Call(CXCursor_VarDecl, ND); |
| 241 | } |
| 242 | void VisitParmVarDecl(ParmVarDecl *ND) { |
| 243 | Call(CXCursor_ParmDecl, ND); |
| 244 | } |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 245 | void VisitObjCPropertyDecl(ObjCPropertyDecl *ND) { |
| 246 | Call(CXCursor_ObjCPropertyDecl, ND); |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 247 | } |
| 248 | void VisitObjCIvarDecl(ObjCIvarDecl *ND) { |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 249 | Call(CXCursor_ObjCIvarDecl, ND); |
| 250 | } |
Steve Naroff | af08ddc | 2009-09-03 15:49:00 +0000 | [diff] [blame] | 251 | void VisitFunctionDecl(FunctionDecl *ND) { |
| 252 | if (ND->isThisDeclarationADefinition()) { |
| 253 | VisitDeclContext(dyn_cast<DeclContext>(ND)); |
Steve Naroff | 4ade6d6 | 2009-09-23 17:52:52 +0000 | [diff] [blame] | 254 | #if 0 |
| 255 | // Not currently needed. |
| 256 | CompoundStmt *Body = dyn_cast<CompoundStmt>(ND->getBody()); |
Steve Naroff | fb57042 | 2009-09-22 19:25:29 +0000 | [diff] [blame] | 257 | CRefVisitor RVisit(CDecl, Callback, CData); |
Steve Naroff | 4ade6d6 | 2009-09-23 17:52:52 +0000 | [diff] [blame] | 258 | RVisit.Visit(Body); |
| 259 | #endif |
Steve Naroff | af08ddc | 2009-09-03 15:49:00 +0000 | [diff] [blame] | 260 | } |
| 261 | } |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 262 | void VisitObjCMethodDecl(ObjCMethodDecl *ND) { |
| 263 | if (ND->getBody()) { |
| 264 | Call(ND->isInstanceMethod() ? CXCursor_ObjCInstanceMethodDefn |
| 265 | : CXCursor_ObjCClassMethodDefn, ND); |
Steve Naroff | af08ddc | 2009-09-03 15:49:00 +0000 | [diff] [blame] | 266 | VisitDeclContext(dyn_cast<DeclContext>(ND)); |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 267 | } else |
| 268 | Call(ND->isInstanceMethod() ? CXCursor_ObjCInstanceMethodDecl |
| 269 | : CXCursor_ObjCClassMethodDecl, ND); |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 270 | } |
| 271 | }; |
| 272 | |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 273 | class CIndexer : public Indexer { |
| 274 | public: |
Benjamin Kramer | 5e4bc59 | 2009-10-18 16:11:04 +0000 | [diff] [blame] | 275 | explicit CIndexer(Program *prog) : Indexer(*prog), OnlyLocalDecls(false) {} |
Ted Kremenek | dff7689 | 2009-10-17 06:21:47 +0000 | [diff] [blame] | 276 | |
| 277 | virtual ~CIndexer() { delete &getProgram(); } |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 278 | |
| 279 | /// \brief Whether we only want to see "local" declarations (that did not |
| 280 | /// come from a previous precompiled header). If false, we want to see all |
| 281 | /// declarations. |
| 282 | bool getOnlyLocalDecls() const { return OnlyLocalDecls; } |
| 283 | void setOnlyLocalDecls(bool Local = true) { OnlyLocalDecls = Local; } |
Benjamin Kramer | 9670762 | 2009-10-18 11:10:55 +0000 | [diff] [blame] | 284 | |
Benjamin Kramer | 5e4bc59 | 2009-10-18 16:11:04 +0000 | [diff] [blame] | 285 | /// \brief Get the path of the clang binary. |
| 286 | static const llvm::sys::Path& getClangPath(); |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 287 | private: |
| 288 | bool OnlyLocalDecls; |
Benjamin Kramer | 5e4bc59 | 2009-10-18 16:11:04 +0000 | [diff] [blame] | 289 | static llvm::sys::Path ClangPath; |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 290 | }; |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 291 | |
Benjamin Kramer | 5e4bc59 | 2009-10-18 16:11:04 +0000 | [diff] [blame] | 292 | llvm::sys::Path CIndexer::ClangPath; |
Ted Kremenek | d2fa566 | 2009-08-26 22:36:44 +0000 | [diff] [blame] | 293 | |
Benjamin Kramer | 5e4bc59 | 2009-10-18 16:11:04 +0000 | [diff] [blame] | 294 | const llvm::sys::Path& CIndexer::getClangPath() { |
| 295 | // Did we already compute the path? |
| 296 | if (!ClangPath.empty()) |
| 297 | return ClangPath; |
| 298 | |
Steve Naroff | 5b7d8e2 | 2009-10-15 20:04:39 +0000 | [diff] [blame] | 299 | // Find the location where this library lives (libCIndex.dylib). |
Benjamin Kramer | 20d7581 | 2009-10-18 16:13:48 +0000 | [diff] [blame] | 300 | #ifdef LLVM_ON_WIN32 |
| 301 | MEMORY_BASIC_INFORMATION mbi; |
| 302 | char path[MAX_PATH]; |
Benjamin Kramer | edcd828 | 2009-10-18 16:20:58 +0000 | [diff] [blame] | 303 | VirtualQuery((void *)(uintptr_t)clang_createTranslationUnit, &mbi, |
Benjamin Kramer | 20d7581 | 2009-10-18 16:13:48 +0000 | [diff] [blame] | 304 | sizeof(mbi)); |
| 305 | GetModuleFileNameA((HINSTANCE)mbi.AllocationBase, path, MAX_PATH); |
| 306 | |
| 307 | llvm::sys::Path CIndexPath(path); |
| 308 | #else |
Steve Naroff | 5b7d8e2 | 2009-10-15 20:04:39 +0000 | [diff] [blame] | 309 | // This silly cast below avoids a C++ warning. |
| 310 | Dl_info info; |
| 311 | if (dladdr((void *)(uintptr_t)clang_createTranslationUnit, &info) == 0) |
| 312 | assert(0 && "Call to dladdr() failed"); |
| 313 | |
| 314 | llvm::sys::Path CIndexPath(info.dli_fname); |
Daniel Dunbar | a47dd19 | 2009-10-17 23:53:11 +0000 | [diff] [blame] | 315 | #endif |
Benjamin Kramer | 5e4bc59 | 2009-10-18 16:11:04 +0000 | [diff] [blame] | 316 | |
Steve Naroff | 5b7d8e2 | 2009-10-15 20:04:39 +0000 | [diff] [blame] | 317 | // We now have the CIndex directory, locate clang relative to it. |
Benjamin Kramer | 5e4bc59 | 2009-10-18 16:11:04 +0000 | [diff] [blame] | 318 | CIndexPath.eraseComponent(); |
| 319 | CIndexPath.eraseComponent(); |
| 320 | CIndexPath.appendComponent("bin"); |
| 321 | CIndexPath.appendComponent("clang"); |
| 322 | |
| 323 | // Cache our result. |
| 324 | ClangPath = CIndexPath; |
| 325 | return ClangPath; |
| 326 | } |
| 327 | |
| 328 | } |
| 329 | |
| 330 | extern "C" { |
| 331 | |
| 332 | CXIndex clang_createIndex() |
| 333 | { |
| 334 | return new CIndexer(new Program()); |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 335 | } |
| 336 | |
Steve Naroff | 2bd6b9f | 2009-09-17 18:33:27 +0000 | [diff] [blame] | 337 | void clang_disposeIndex(CXIndex CIdx) |
| 338 | { |
| 339 | assert(CIdx && "Passed null CXIndex"); |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 340 | delete static_cast<CIndexer *>(CIdx); |
Steve Naroff | 2bd6b9f | 2009-09-17 18:33:27 +0000 | [diff] [blame] | 341 | } |
| 342 | |
Steve Naroff | 5039819 | 2009-08-28 15:28:48 +0000 | [diff] [blame] | 343 | // FIXME: need to pass back error info. |
| 344 | CXTranslationUnit clang_createTranslationUnit( |
| 345 | CXIndex CIdx, const char *ast_filename) |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 346 | { |
Steve Naroff | 5039819 | 2009-08-28 15:28:48 +0000 | [diff] [blame] | 347 | assert(CIdx && "Passed null CXIndex"); |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 348 | CIndexer *CXXIdx = static_cast<CIndexer *>(CIdx); |
Steve Naroff | 5039819 | 2009-08-28 15:28:48 +0000 | [diff] [blame] | 349 | std::string astName(ast_filename); |
| 350 | std::string ErrMsg; |
| 351 | |
Daniel Dunbar | 31b87d8 | 2009-09-21 03:03:39 +0000 | [diff] [blame] | 352 | return ASTUnit::LoadFromPCHFile(astName, CXXIdx->getDiagnostics(), |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 353 | CXXIdx->getFileManager(), &ErrMsg, |
Ted Kremenek | 5cf4876 | 2009-10-17 00:34:24 +0000 | [diff] [blame] | 354 | CXXIdx->getOnlyLocalDecls(), |
| 355 | /* UseBumpAllocator = */ true); |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 356 | } |
| 357 | |
Steve Naroff | 5b7d8e2 | 2009-10-15 20:04:39 +0000 | [diff] [blame] | 358 | CXTranslationUnit clang_createTranslationUnitFromSourceFile( |
| 359 | CXIndex CIdx, |
| 360 | const char *source_filename, |
| 361 | int num_command_line_args, const char **command_line_args) |
| 362 | { |
Ted Kremenek | 74cd069 | 2009-10-15 23:21:22 +0000 | [diff] [blame] | 363 | // Build up the arguments for involing clang. |
Benjamin Kramer | 5e4bc59 | 2009-10-18 16:11:04 +0000 | [diff] [blame] | 364 | llvm::sys::Path ClangPath = static_cast<CIndexer *>(CIdx)->getClangPath(); |
Ted Kremenek | 74cd069 | 2009-10-15 23:21:22 +0000 | [diff] [blame] | 365 | std::vector<const char *> argv; |
Benjamin Kramer | 5e4bc59 | 2009-10-18 16:11:04 +0000 | [diff] [blame] | 366 | argv.push_back(ClangPath.c_str()); |
Ted Kremenek | 74cd069 | 2009-10-15 23:21:22 +0000 | [diff] [blame] | 367 | argv.push_back("-emit-ast"); |
| 368 | argv.push_back(source_filename); |
| 369 | argv.push_back("-o"); |
Steve Naroff | 37b5ac2 | 2009-10-15 20:50:09 +0000 | [diff] [blame] | 370 | // Generate a temporary name for the AST file. |
| 371 | char astTmpFile[L_tmpnam]; |
Ted Kremenek | 74cd069 | 2009-10-15 23:21:22 +0000 | [diff] [blame] | 372 | argv.push_back(tmpnam(astTmpFile)); |
Benjamin Kramer | b14346b | 2009-10-18 16:52:07 +0000 | [diff] [blame^] | 373 | for (int i = 0; i < num_command_line_args; i++) |
Ted Kremenek | 74cd069 | 2009-10-15 23:21:22 +0000 | [diff] [blame] | 374 | argv.push_back(command_line_args[i]); |
| 375 | argv.push_back(NULL); |
| 376 | |
Steve Naroff | 5b7d8e2 | 2009-10-15 20:04:39 +0000 | [diff] [blame] | 377 | // Generate the AST file in a separate process. |
Benjamin Kramer | 5e4bc59 | 2009-10-18 16:11:04 +0000 | [diff] [blame] | 378 | llvm::sys::Program::ExecuteAndWait(ClangPath, &argv[0]); |
Benjamin Kramer | 0829a83 | 2009-10-18 11:19:36 +0000 | [diff] [blame] | 379 | |
Steve Naroff | 37b5ac2 | 2009-10-15 20:50:09 +0000 | [diff] [blame] | 380 | // Finally, we create the translation unit from the ast file. |
Steve Naroff | e19944c | 2009-10-15 22:23:48 +0000 | [diff] [blame] | 381 | ASTUnit *ATU = static_cast<ASTUnit *>( |
| 382 | clang_createTranslationUnit(CIdx, astTmpFile)); |
| 383 | ATU->unlinkTemporaryFile(); |
| 384 | return ATU; |
Steve Naroff | 5b7d8e2 | 2009-10-15 20:04:39 +0000 | [diff] [blame] | 385 | } |
| 386 | |
Steve Naroff | 2bd6b9f | 2009-09-17 18:33:27 +0000 | [diff] [blame] | 387 | void clang_disposeTranslationUnit( |
| 388 | CXTranslationUnit CTUnit) |
| 389 | { |
| 390 | assert(CTUnit && "Passed null CXTranslationUnit"); |
| 391 | delete static_cast<ASTUnit *>(CTUnit); |
| 392 | } |
| 393 | |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 394 | void clang_wantOnlyLocalDeclarations(CXIndex CIdx) { |
| 395 | static_cast<CIndexer *>(CIdx)->setOnlyLocalDecls(true); |
| 396 | } |
| 397 | |
Steve Naroff | af08ddc | 2009-09-03 15:49:00 +0000 | [diff] [blame] | 398 | const char *clang_getTranslationUnitSpelling(CXTranslationUnit CTUnit) |
| 399 | { |
| 400 | assert(CTUnit && "Passed null CXTranslationUnit"); |
Steve Naroff | 77accc1 | 2009-09-03 18:19:54 +0000 | [diff] [blame] | 401 | ASTUnit *CXXUnit = static_cast<ASTUnit *>(CTUnit); |
| 402 | return CXXUnit->getOriginalSourceFileName().c_str(); |
Steve Naroff | af08ddc | 2009-09-03 15:49:00 +0000 | [diff] [blame] | 403 | } |
Daniel Dunbar | 1eb79b5 | 2009-08-28 16:30:07 +0000 | [diff] [blame] | 404 | |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 405 | void clang_loadTranslationUnit(CXTranslationUnit CTUnit, |
| 406 | CXTranslationUnitIterator callback, |
| 407 | CXClientData CData) |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 408 | { |
Steve Naroff | 5039819 | 2009-08-28 15:28:48 +0000 | [diff] [blame] | 409 | assert(CTUnit && "Passed null CXTranslationUnit"); |
| 410 | ASTUnit *CXXUnit = static_cast<ASTUnit *>(CTUnit); |
| 411 | ASTContext &Ctx = CXXUnit->getASTContext(); |
| 412 | |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 413 | TUVisitor DVisit(CTUnit, callback, CData, |
| 414 | CXXUnit->getOnlyLocalDecls()? 1 : Decl::MaxPCHLevel); |
Steve Naroff | 5039819 | 2009-08-28 15:28:48 +0000 | [diff] [blame] | 415 | DVisit.Visit(Ctx.getTranslationUnitDecl()); |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 416 | } |
| 417 | |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 418 | void clang_loadDeclaration(CXDecl Dcl, |
| 419 | CXDeclIterator callback, |
| 420 | CXClientData CData) |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 421 | { |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 422 | assert(Dcl && "Passed null CXDecl"); |
| 423 | |
Douglas Gregor | 7d1d49d | 2009-10-16 20:01:17 +0000 | [diff] [blame] | 424 | CDeclVisitor DVisit(Dcl, callback, CData, |
| 425 | static_cast<Decl *>(Dcl)->getPCHLevel()); |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 426 | DVisit.Visit(static_cast<Decl *>(Dcl)); |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 427 | } |
| 428 | |
Steve Naroff | 7e8f818 | 2009-08-28 12:07:44 +0000 | [diff] [blame] | 429 | // Some notes on CXEntity: |
| 430 | // |
| 431 | // - Since the 'ordinary' namespace includes functions, data, typedefs, |
| 432 | // ObjC interfaces, thecurrent algorithm is a bit naive (resulting in one |
| 433 | // entity for 2 different types). For example: |
| 434 | // |
| 435 | // module1.m: @interface Foo @end Foo *x; |
| 436 | // module2.m: void Foo(int); |
| 437 | // |
| 438 | // - Since the unique name spans translation units, static data/functions |
| 439 | // within a CXTranslationUnit are *not* currently represented by entities. |
| 440 | // As a result, there will be no entity for the following: |
| 441 | // |
| 442 | // module.m: static void Foo() { } |
| 443 | // |
| 444 | |
| 445 | |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 446 | const char *clang_getDeclarationName(CXEntity) |
| 447 | { |
| 448 | return ""; |
| 449 | } |
| 450 | const char *clang_getURI(CXEntity) |
| 451 | { |
| 452 | return ""; |
| 453 | } |
| 454 | |
| 455 | CXEntity clang_getEntity(const char *URI) |
| 456 | { |
| 457 | return 0; |
| 458 | } |
| 459 | |
| 460 | // |
| 461 | // CXDecl Operations. |
| 462 | // |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 463 | CXEntity clang_getEntityFromDecl(CXDecl) |
| 464 | { |
| 465 | return 0; |
| 466 | } |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 467 | const char *clang_getDeclSpelling(CXDecl AnonDecl) |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 468 | { |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 469 | assert(AnonDecl && "Passed null CXDecl"); |
| 470 | NamedDecl *ND = static_cast<NamedDecl *>(AnonDecl); |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 471 | |
| 472 | if (ObjCMethodDecl *OMD = dyn_cast<ObjCMethodDecl>(ND)) { |
| 473 | return OMD->getSelector().getAsString().c_str(); |
| 474 | } |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 475 | if (ND->getIdentifier()) |
| 476 | return ND->getIdentifier()->getName(); |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 477 | else |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 478 | return ""; |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 479 | } |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 480 | |
Steve Naroff | 699a07d | 2009-09-25 21:32:34 +0000 | [diff] [blame] | 481 | unsigned clang_getDeclLine(CXDecl AnonDecl) |
| 482 | { |
| 483 | assert(AnonDecl && "Passed null CXDecl"); |
| 484 | NamedDecl *ND = static_cast<NamedDecl *>(AnonDecl); |
| 485 | SourceManager &SourceMgr = ND->getASTContext().getSourceManager(); |
| 486 | return SourceMgr.getSpellingLineNumber(ND->getLocation()); |
| 487 | } |
| 488 | |
| 489 | unsigned clang_getDeclColumn(CXDecl AnonDecl) |
| 490 | { |
| 491 | assert(AnonDecl && "Passed null CXDecl"); |
| 492 | NamedDecl *ND = static_cast<NamedDecl *>(AnonDecl); |
| 493 | SourceManager &SourceMgr = ND->getASTContext().getSourceManager(); |
Steve Naroff | 7416524 | 2009-09-25 22:15:54 +0000 | [diff] [blame] | 494 | return SourceMgr.getSpellingColumnNumber(ND->getLocation()); |
Steve Naroff | 699a07d | 2009-09-25 21:32:34 +0000 | [diff] [blame] | 495 | } |
| 496 | |
Steve Naroff | ee9405e | 2009-09-25 21:45:39 +0000 | [diff] [blame] | 497 | const char *clang_getDeclSource(CXDecl AnonDecl) |
| 498 | { |
| 499 | assert(AnonDecl && "Passed null CXDecl"); |
| 500 | NamedDecl *ND = static_cast<NamedDecl *>(AnonDecl); |
| 501 | SourceManager &SourceMgr = ND->getASTContext().getSourceManager(); |
| 502 | return SourceMgr.getBufferName(ND->getLocation()); |
| 503 | } |
| 504 | |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 505 | const char *clang_getCursorSpelling(CXCursor C) |
| 506 | { |
| 507 | assert(C.decl && "CXCursor has null decl"); |
| 508 | NamedDecl *ND = static_cast<NamedDecl *>(C.decl); |
| 509 | |
| 510 | if (clang_isReference(C.kind)) { |
| 511 | switch (C.kind) { |
Steve Naroff | 1164d85 | 2009-09-02 18:58:52 +0000 | [diff] [blame] | 512 | case CXCursor_ObjCSuperClassRef: |
| 513 | { |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 514 | ObjCInterfaceDecl *OID = dyn_cast<ObjCInterfaceDecl>(ND); |
| 515 | assert(OID && "clang_getCursorLine(): Missing interface decl"); |
| 516 | return OID->getSuperClass()->getIdentifier()->getName(); |
Steve Naroff | 1164d85 | 2009-09-02 18:58:52 +0000 | [diff] [blame] | 517 | } |
Steve Naroff | af08ddc | 2009-09-03 15:49:00 +0000 | [diff] [blame] | 518 | case CXCursor_ObjCClassRef: |
| 519 | { |
Steve Naroff | 85e2db7 | 2009-10-01 00:31:07 +0000 | [diff] [blame] | 520 | if (ObjCInterfaceDecl *OID = dyn_cast<ObjCInterfaceDecl>(ND)) { |
| 521 | return OID->getIdentifier()->getName(); |
| 522 | } |
Steve Naroff | af08ddc | 2009-09-03 15:49:00 +0000 | [diff] [blame] | 523 | ObjCCategoryDecl *OID = dyn_cast<ObjCCategoryDecl>(ND); |
| 524 | assert(OID && "clang_getCursorLine(): Missing category decl"); |
| 525 | return OID->getClassInterface()->getIdentifier()->getName(); |
| 526 | } |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 527 | case CXCursor_ObjCProtocolRef: |
| 528 | { |
| 529 | ObjCProtocolDecl *OID = dyn_cast<ObjCProtocolDecl>(ND); |
| 530 | assert(OID && "clang_getCursorLine(): Missing protocol decl"); |
| 531 | return OID->getIdentifier()->getName(); |
| 532 | } |
Steve Naroff | fb57042 | 2009-09-22 19:25:29 +0000 | [diff] [blame] | 533 | case CXCursor_ObjCSelectorRef: |
| 534 | { |
| 535 | ObjCMessageExpr *OME = dyn_cast<ObjCMessageExpr>( |
| 536 | static_cast<Stmt *>(C.stmt)); |
| 537 | assert(OME && "clang_getCursorLine(): Missing message expr"); |
| 538 | return OME->getSelector().getAsString().c_str(); |
| 539 | } |
| 540 | case CXCursor_VarRef: |
| 541 | case CXCursor_FunctionRef: |
| 542 | case CXCursor_EnumConstantRef: |
| 543 | { |
| 544 | DeclRefExpr *DRE = dyn_cast<DeclRefExpr>( |
| 545 | static_cast<Stmt *>(C.stmt)); |
| 546 | assert(DRE && "clang_getCursorLine(): Missing decl ref expr"); |
| 547 | return DRE->getDecl()->getIdentifier()->getName(); |
| 548 | } |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 549 | default: |
| 550 | return "<not implemented>"; |
| 551 | } |
| 552 | } |
| 553 | return clang_getDeclSpelling(C.decl); |
| 554 | } |
| 555 | |
| 556 | const char *clang_getCursorKindSpelling(enum CXCursorKind Kind) |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 557 | { |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 558 | switch (Kind) { |
| 559 | case CXCursor_FunctionDecl: return "FunctionDecl"; |
| 560 | case CXCursor_TypedefDecl: return "TypedefDecl"; |
| 561 | case CXCursor_EnumDecl: return "EnumDecl"; |
| 562 | case CXCursor_EnumConstantDecl: return "EnumConstantDecl"; |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 563 | case CXCursor_StructDecl: return "StructDecl"; |
| 564 | case CXCursor_UnionDecl: return "UnionDecl"; |
| 565 | case CXCursor_ClassDecl: return "ClassDecl"; |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 566 | case CXCursor_FieldDecl: return "FieldDecl"; |
| 567 | case CXCursor_VarDecl: return "VarDecl"; |
| 568 | case CXCursor_ParmDecl: return "ParmDecl"; |
| 569 | case CXCursor_ObjCInterfaceDecl: return "ObjCInterfaceDecl"; |
| 570 | case CXCursor_ObjCCategoryDecl: return "ObjCCategoryDecl"; |
| 571 | case CXCursor_ObjCProtocolDecl: return "ObjCProtocolDecl"; |
| 572 | case CXCursor_ObjCPropertyDecl: return "ObjCPropertyDecl"; |
| 573 | case CXCursor_ObjCIvarDecl: return "ObjCIvarDecl"; |
Steve Naroff | c857ea4 | 2009-09-02 13:28:54 +0000 | [diff] [blame] | 574 | case CXCursor_ObjCInstanceMethodDecl: return "ObjCInstanceMethodDecl"; |
| 575 | case CXCursor_ObjCClassMethodDecl: return "ObjCClassMethodDecl"; |
| 576 | case CXCursor_FunctionDefn: return "FunctionDefn"; |
| 577 | case CXCursor_ObjCInstanceMethodDefn: return "ObjCInstanceMethodDefn"; |
| 578 | case CXCursor_ObjCClassMethodDefn: return "ObjCClassMethodDefn"; |
| 579 | case CXCursor_ObjCClassDefn: return "ObjCClassDefn"; |
| 580 | case CXCursor_ObjCCategoryDefn: return "ObjCCategoryDefn"; |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 581 | case CXCursor_ObjCSuperClassRef: return "ObjCSuperClassRef"; |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 582 | case CXCursor_ObjCProtocolRef: return "ObjCProtocolRef"; |
Steve Naroff | af08ddc | 2009-09-03 15:49:00 +0000 | [diff] [blame] | 583 | case CXCursor_ObjCClassRef: return "ObjCClassRef"; |
Steve Naroff | fb57042 | 2009-09-22 19:25:29 +0000 | [diff] [blame] | 584 | case CXCursor_ObjCSelectorRef: return "ObjCSelectorRef"; |
| 585 | |
| 586 | case CXCursor_VarRef: return "VarRef"; |
| 587 | case CXCursor_FunctionRef: return "FunctionRef"; |
| 588 | case CXCursor_EnumConstantRef: return "EnumConstantRef"; |
| 589 | case CXCursor_MemberRef: return "MemberRef"; |
| 590 | |
Steve Naroff | 77128dd | 2009-09-15 20:25:34 +0000 | [diff] [blame] | 591 | case CXCursor_InvalidFile: return "InvalidFile"; |
| 592 | case CXCursor_NoDeclFound: return "NoDeclFound"; |
| 593 | case CXCursor_NotImplemented: return "NotImplemented"; |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 594 | default: return "<not implemented>"; |
| 595 | } |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 596 | } |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 597 | |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 598 | static enum CXCursorKind TranslateKind(Decl *D) { |
| 599 | switch (D->getKind()) { |
| 600 | case Decl::Function: return CXCursor_FunctionDecl; |
| 601 | case Decl::Typedef: return CXCursor_TypedefDecl; |
| 602 | case Decl::Enum: return CXCursor_EnumDecl; |
| 603 | case Decl::EnumConstant: return CXCursor_EnumConstantDecl; |
| 604 | case Decl::Record: return CXCursor_StructDecl; // FIXME: union/class |
| 605 | case Decl::Field: return CXCursor_FieldDecl; |
| 606 | case Decl::Var: return CXCursor_VarDecl; |
| 607 | case Decl::ParmVar: return CXCursor_ParmDecl; |
| 608 | case Decl::ObjCInterface: return CXCursor_ObjCInterfaceDecl; |
Steve Naroff | fb57042 | 2009-09-22 19:25:29 +0000 | [diff] [blame] | 609 | case Decl::ObjCCategory: return CXCursor_ObjCCategoryDecl; |
| 610 | case Decl::ObjCProtocol: return CXCursor_ObjCProtocolDecl; |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 611 | case Decl::ObjCMethod: { |
| 612 | ObjCMethodDecl *MD = dyn_cast<ObjCMethodDecl>(D); |
| 613 | if (MD->isInstanceMethod()) |
| 614 | return CXCursor_ObjCInstanceMethodDecl; |
| 615 | return CXCursor_ObjCClassMethodDecl; |
| 616 | } |
| 617 | default: break; |
| 618 | } |
Steve Naroff | 77128dd | 2009-09-15 20:25:34 +0000 | [diff] [blame] | 619 | return CXCursor_NotImplemented; |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 620 | } |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 621 | // |
| 622 | // CXCursor Operations. |
| 623 | // |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 624 | CXCursor clang_getCursor(CXTranslationUnit CTUnit, const char *source_name, |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 625 | unsigned line, unsigned column) |
| 626 | { |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 627 | assert(CTUnit && "Passed null CXTranslationUnit"); |
| 628 | ASTUnit *CXXUnit = static_cast<ASTUnit *>(CTUnit); |
| 629 | |
| 630 | FileManager &FMgr = CXXUnit->getFileManager(); |
| 631 | const FileEntry *File = FMgr.getFile(source_name, |
Steve Naroff | 77128dd | 2009-09-15 20:25:34 +0000 | [diff] [blame] | 632 | source_name+strlen(source_name)); |
| 633 | if (!File) { |
Steve Naroff | fb57042 | 2009-09-22 19:25:29 +0000 | [diff] [blame] | 634 | CXCursor C = { CXCursor_InvalidFile, 0, 0 }; |
Steve Naroff | 77128dd | 2009-09-15 20:25:34 +0000 | [diff] [blame] | 635 | return C; |
| 636 | } |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 637 | SourceLocation SLoc = |
| 638 | CXXUnit->getSourceManager().getLocation(File, line, column); |
| 639 | |
| 640 | ASTLocation ALoc = ResolveLocationInAST(CXXUnit->getASTContext(), SLoc); |
| 641 | |
Argyrios Kyrtzidis | f4526e3 | 2009-09-29 19:44:27 +0000 | [diff] [blame] | 642 | Decl *Dcl = ALoc.getParentDecl(); |
Argyrios Kyrtzidis | 05a7651 | 2009-09-29 19:45:58 +0000 | [diff] [blame] | 643 | if (ALoc.isNamedRef()) |
| 644 | Dcl = ALoc.AsNamedRef().ND; |
Argyrios Kyrtzidis | f4526e3 | 2009-09-29 19:44:27 +0000 | [diff] [blame] | 645 | Stmt *Stm = ALoc.dyn_AsStmt(); |
Steve Naroff | 4ade6d6 | 2009-09-23 17:52:52 +0000 | [diff] [blame] | 646 | if (Dcl) { |
| 647 | if (Stm) { |
| 648 | if (DeclRefExpr *DRE = dyn_cast<DeclRefExpr>(Stm)) { |
| 649 | CXCursor C = { TranslateDeclRefExpr(DRE), Dcl, Stm }; |
| 650 | return C; |
| 651 | } else if (ObjCMessageExpr *MExp = dyn_cast<ObjCMessageExpr>(Stm)) { |
| 652 | CXCursor C = { CXCursor_ObjCSelectorRef, Dcl, MExp }; |
| 653 | return C; |
Steve Naroff | 85e2db7 | 2009-10-01 00:31:07 +0000 | [diff] [blame] | 654 | } |
Steve Naroff | 4ade6d6 | 2009-09-23 17:52:52 +0000 | [diff] [blame] | 655 | // Fall through...treat as a decl, not a ref. |
| 656 | } |
Steve Naroff | 85e2db7 | 2009-10-01 00:31:07 +0000 | [diff] [blame] | 657 | if (ALoc.isNamedRef()) { |
| 658 | if (isa<ObjCInterfaceDecl>(Dcl)) { |
| 659 | CXCursor C = { CXCursor_ObjCClassRef, Dcl, ALoc.getParentDecl() }; |
| 660 | return C; |
| 661 | } |
| 662 | if (isa<ObjCProtocolDecl>(Dcl)) { |
| 663 | CXCursor C = { CXCursor_ObjCProtocolRef, Dcl, ALoc.getParentDecl() }; |
| 664 | return C; |
| 665 | } |
| 666 | } |
| 667 | CXCursor C = { TranslateKind(Dcl), Dcl, 0 }; |
Steve Naroff | 77128dd | 2009-09-15 20:25:34 +0000 | [diff] [blame] | 668 | return C; |
| 669 | } |
Steve Naroff | fb57042 | 2009-09-22 19:25:29 +0000 | [diff] [blame] | 670 | CXCursor C = { CXCursor_NoDeclFound, 0, 0 }; |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 671 | return C; |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 672 | } |
| 673 | |
Steve Naroff | 77128dd | 2009-09-15 20:25:34 +0000 | [diff] [blame] | 674 | CXCursor clang_getCursorFromDecl(CXDecl AnonDecl) |
| 675 | { |
| 676 | assert(AnonDecl && "Passed null CXDecl"); |
| 677 | NamedDecl *ND = static_cast<NamedDecl *>(AnonDecl); |
| 678 | |
Steve Naroff | fb57042 | 2009-09-22 19:25:29 +0000 | [diff] [blame] | 679 | CXCursor C = { TranslateKind(ND), ND, 0 }; |
Steve Naroff | 77128dd | 2009-09-15 20:25:34 +0000 | [diff] [blame] | 680 | return C; |
| 681 | } |
| 682 | |
| 683 | unsigned clang_isInvalid(enum CXCursorKind K) |
| 684 | { |
| 685 | return K >= CXCursor_FirstInvalid && K <= CXCursor_LastInvalid; |
| 686 | } |
| 687 | |
Steve Naroff | 89922f8 | 2009-08-31 00:59:03 +0000 | [diff] [blame] | 688 | unsigned clang_isDeclaration(enum CXCursorKind K) |
| 689 | { |
| 690 | return K >= CXCursor_FirstDecl && K <= CXCursor_LastDecl; |
| 691 | } |
Steve Naroff | 2d4d629 | 2009-08-31 14:26:51 +0000 | [diff] [blame] | 692 | |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 693 | unsigned clang_isReference(enum CXCursorKind K) |
| 694 | { |
| 695 | return K >= CXCursor_FirstRef && K <= CXCursor_LastRef; |
| 696 | } |
| 697 | |
| 698 | unsigned clang_isDefinition(enum CXCursorKind K) |
| 699 | { |
| 700 | return K >= CXCursor_FirstDefn && K <= CXCursor_LastDefn; |
| 701 | } |
| 702 | |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 703 | CXCursorKind clang_getCursorKind(CXCursor C) |
| 704 | { |
| 705 | return C.kind; |
| 706 | } |
| 707 | |
Steve Naroff | 699a07d | 2009-09-25 21:32:34 +0000 | [diff] [blame] | 708 | static Decl *getDeclFromExpr(Stmt *E) { |
| 709 | if (DeclRefExpr *RefExpr = dyn_cast<DeclRefExpr>(E)) |
| 710 | return RefExpr->getDecl(); |
| 711 | if (MemberExpr *ME = dyn_cast<MemberExpr>(E)) |
| 712 | return ME->getMemberDecl(); |
| 713 | if (ObjCIvarRefExpr *RE = dyn_cast<ObjCIvarRefExpr>(E)) |
| 714 | return RE->getDecl(); |
| 715 | |
| 716 | if (CallExpr *CE = dyn_cast<CallExpr>(E)) |
| 717 | return getDeclFromExpr(CE->getCallee()); |
| 718 | if (CastExpr *CE = dyn_cast<CastExpr>(E)) |
| 719 | return getDeclFromExpr(CE->getSubExpr()); |
| 720 | if (ObjCMessageExpr *OME = dyn_cast<ObjCMessageExpr>(E)) |
| 721 | return OME->getMethodDecl(); |
| 722 | |
| 723 | return 0; |
| 724 | } |
| 725 | |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 726 | CXDecl clang_getCursorDecl(CXCursor C) |
| 727 | { |
Steve Naroff | 699a07d | 2009-09-25 21:32:34 +0000 | [diff] [blame] | 728 | if (clang_isDeclaration(C.kind)) |
| 729 | return C.decl; |
| 730 | |
| 731 | if (clang_isReference(C.kind)) { |
Steve Naroff | 85e2db7 | 2009-10-01 00:31:07 +0000 | [diff] [blame] | 732 | if (C.stmt) { |
Steve Naroff | f9adf8f | 2009-10-05 17:58:19 +0000 | [diff] [blame] | 733 | if (C.kind == CXCursor_ObjCClassRef || |
| 734 | C.kind == CXCursor_ObjCProtocolRef) |
Steve Naroff | 85e2db7 | 2009-10-01 00:31:07 +0000 | [diff] [blame] | 735 | return static_cast<Stmt *>(C.stmt); |
| 736 | else |
| 737 | return getDeclFromExpr(static_cast<Stmt *>(C.stmt)); |
| 738 | } else |
Steve Naroff | 699a07d | 2009-09-25 21:32:34 +0000 | [diff] [blame] | 739 | return C.decl; |
| 740 | } |
| 741 | return 0; |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 742 | } |
| 743 | |
Steve Naroff | 85e2db7 | 2009-10-01 00:31:07 +0000 | [diff] [blame] | 744 | |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 745 | static SourceLocation getLocationFromCursor(CXCursor C, |
| 746 | SourceManager &SourceMgr, |
| 747 | NamedDecl *ND) { |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 748 | if (clang_isReference(C.kind)) { |
| 749 | switch (C.kind) { |
Steve Naroff | 85e2db7 | 2009-10-01 00:31:07 +0000 | [diff] [blame] | 750 | case CXCursor_ObjCClassRef: |
| 751 | { |
| 752 | if (isa<ObjCInterfaceDecl>(ND)) { |
| 753 | // FIXME: This is a hack (storing the parent decl in the stmt slot). |
| 754 | NamedDecl *parentDecl = static_cast<NamedDecl *>(C.stmt); |
| 755 | return parentDecl->getLocation(); |
| 756 | } |
| 757 | ObjCCategoryDecl *OID = dyn_cast<ObjCCategoryDecl>(ND); |
| 758 | assert(OID && "clang_getCursorLine(): Missing category decl"); |
| 759 | return OID->getClassInterface()->getLocation(); |
| 760 | } |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 761 | case CXCursor_ObjCSuperClassRef: |
Steve Naroff | 1164d85 | 2009-09-02 18:58:52 +0000 | [diff] [blame] | 762 | { |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 763 | ObjCInterfaceDecl *OID = dyn_cast<ObjCInterfaceDecl>(ND); |
| 764 | assert(OID && "clang_getCursorLine(): Missing interface decl"); |
Steve Naroff | 1164d85 | 2009-09-02 18:58:52 +0000 | [diff] [blame] | 765 | return OID->getSuperClassLoc(); |
| 766 | } |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 767 | case CXCursor_ObjCProtocolRef: |
| 768 | { |
| 769 | ObjCProtocolDecl *OID = dyn_cast<ObjCProtocolDecl>(ND); |
| 770 | assert(OID && "clang_getCursorLine(): Missing protocol decl"); |
| 771 | return OID->getLocation(); |
| 772 | } |
Steve Naroff | fb57042 | 2009-09-22 19:25:29 +0000 | [diff] [blame] | 773 | case CXCursor_ObjCSelectorRef: |
| 774 | { |
| 775 | ObjCMessageExpr *OME = dyn_cast<ObjCMessageExpr>( |
| 776 | static_cast<Stmt *>(C.stmt)); |
| 777 | assert(OME && "clang_getCursorLine(): Missing message expr"); |
| 778 | return OME->getLeftLoc(); /* FIXME: should be a range */ |
| 779 | } |
| 780 | case CXCursor_VarRef: |
| 781 | case CXCursor_FunctionRef: |
| 782 | case CXCursor_EnumConstantRef: |
| 783 | { |
| 784 | DeclRefExpr *DRE = dyn_cast<DeclRefExpr>( |
| 785 | static_cast<Stmt *>(C.stmt)); |
| 786 | assert(DRE && "clang_getCursorLine(): Missing decl ref expr"); |
| 787 | return DRE->getLocation(); |
| 788 | } |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 789 | default: |
Steve Naroff | 1164d85 | 2009-09-02 18:58:52 +0000 | [diff] [blame] | 790 | return SourceLocation(); |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 791 | } |
| 792 | } else { // We have a declaration or a definition. |
Steve Naroff | 9efa767 | 2009-09-04 15:44:05 +0000 | [diff] [blame] | 793 | SourceLocation SLoc; |
| 794 | switch (ND->getKind()) { |
| 795 | case Decl::ObjCInterface: |
| 796 | { |
| 797 | SLoc = dyn_cast<ObjCInterfaceDecl>(ND)->getClassLoc(); |
| 798 | break; |
| 799 | } |
| 800 | case Decl::ObjCProtocol: |
| 801 | { |
| 802 | SLoc = ND->getLocation(); /* FIXME: need to get the name location. */ |
| 803 | break; |
| 804 | } |
| 805 | default: |
| 806 | { |
| 807 | SLoc = ND->getLocation(); |
| 808 | break; |
| 809 | } |
| 810 | } |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 811 | if (SLoc.isInvalid()) |
| 812 | return SourceLocation(); |
Steve Naroff | 1164d85 | 2009-09-02 18:58:52 +0000 | [diff] [blame] | 813 | return SourceMgr.getSpellingLoc(SLoc); // handles macro instantiations. |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 814 | } |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 815 | } |
| 816 | |
Steve Naroff | 2d4d629 | 2009-08-31 14:26:51 +0000 | [diff] [blame] | 817 | unsigned clang_getCursorLine(CXCursor C) |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 818 | { |
Steve Naroff | 2d4d629 | 2009-08-31 14:26:51 +0000 | [diff] [blame] | 819 | assert(C.decl && "CXCursor has null decl"); |
| 820 | NamedDecl *ND = static_cast<NamedDecl *>(C.decl); |
Steve Naroff | 2d4d629 | 2009-08-31 14:26:51 +0000 | [diff] [blame] | 821 | SourceManager &SourceMgr = ND->getASTContext().getSourceManager(); |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 822 | |
| 823 | SourceLocation SLoc = getLocationFromCursor(C, SourceMgr, ND); |
Steve Naroff | 2d4d629 | 2009-08-31 14:26:51 +0000 | [diff] [blame] | 824 | return SourceMgr.getSpellingLineNumber(SLoc); |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 825 | } |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 826 | |
Steve Naroff | 2d4d629 | 2009-08-31 14:26:51 +0000 | [diff] [blame] | 827 | unsigned clang_getCursorColumn(CXCursor C) |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 828 | { |
Steve Naroff | 2d4d629 | 2009-08-31 14:26:51 +0000 | [diff] [blame] | 829 | assert(C.decl && "CXCursor has null decl"); |
| 830 | NamedDecl *ND = static_cast<NamedDecl *>(C.decl); |
Steve Naroff | 2d4d629 | 2009-08-31 14:26:51 +0000 | [diff] [blame] | 831 | SourceManager &SourceMgr = ND->getASTContext().getSourceManager(); |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 832 | |
| 833 | SourceLocation SLoc = getLocationFromCursor(C, SourceMgr, ND); |
Steve Naroff | 2d4d629 | 2009-08-31 14:26:51 +0000 | [diff] [blame] | 834 | return SourceMgr.getSpellingColumnNumber(SLoc); |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 835 | } |
Steve Naroff | 2d4d629 | 2009-08-31 14:26:51 +0000 | [diff] [blame] | 836 | const char *clang_getCursorSource(CXCursor C) |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 837 | { |
Steve Naroff | 2d4d629 | 2009-08-31 14:26:51 +0000 | [diff] [blame] | 838 | assert(C.decl && "CXCursor has null decl"); |
| 839 | NamedDecl *ND = static_cast<NamedDecl *>(C.decl); |
Steve Naroff | 2d4d629 | 2009-08-31 14:26:51 +0000 | [diff] [blame] | 840 | SourceManager &SourceMgr = ND->getASTContext().getSourceManager(); |
Steve Naroff | f334b4e | 2009-09-02 18:26:48 +0000 | [diff] [blame] | 841 | |
| 842 | SourceLocation SLoc = getLocationFromCursor(C, SourceMgr, ND); |
Douglas Gregor | 0246575 | 2009-10-16 21:24:31 +0000 | [diff] [blame] | 843 | if (SLoc.isFileID()) |
| 844 | return SourceMgr.getBufferName(SLoc); |
| 845 | |
| 846 | // Retrieve the file in which the macro was instantiated, then provide that |
| 847 | // buffer name. |
| 848 | // FIXME: Do we want to give specific macro-instantiation information? |
| 849 | const llvm::MemoryBuffer *Buffer |
| 850 | = SourceMgr.getBuffer(SourceMgr.getDecomposedSpellingLoc(SLoc).first); |
| 851 | if (!Buffer) |
| 852 | return 0; |
| 853 | |
| 854 | return Buffer->getBufferIdentifier(); |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 855 | } |
| 856 | |
Steve Naroff | 4ade6d6 | 2009-09-23 17:52:52 +0000 | [diff] [blame] | 857 | void clang_getDefinitionSpellingAndExtent(CXCursor C, |
| 858 | const char **startBuf, |
| 859 | const char **endBuf, |
| 860 | unsigned *startLine, |
| 861 | unsigned *startColumn, |
| 862 | unsigned *endLine, |
| 863 | unsigned *endColumn) |
| 864 | { |
| 865 | assert(C.decl && "CXCursor has null decl"); |
| 866 | NamedDecl *ND = static_cast<NamedDecl *>(C.decl); |
| 867 | FunctionDecl *FD = dyn_cast<FunctionDecl>(ND); |
| 868 | CompoundStmt *Body = dyn_cast<CompoundStmt>(FD->getBody()); |
| 869 | |
| 870 | SourceManager &SM = FD->getASTContext().getSourceManager(); |
| 871 | *startBuf = SM.getCharacterData(Body->getLBracLoc()); |
| 872 | *endBuf = SM.getCharacterData(Body->getRBracLoc()); |
| 873 | *startLine = SM.getSpellingLineNumber(Body->getLBracLoc()); |
| 874 | *startColumn = SM.getSpellingColumnNumber(Body->getLBracLoc()); |
| 875 | *endLine = SM.getSpellingLineNumber(Body->getRBracLoc()); |
| 876 | *endColumn = SM.getSpellingColumnNumber(Body->getRBracLoc()); |
| 877 | } |
| 878 | |
| 879 | |
Steve Naroff | 600866c | 2009-08-27 19:51:58 +0000 | [diff] [blame] | 880 | } // end extern "C" |