CXCursor.cpp revision 21ff2e516b0e0bc8c1dbf965cb3d44bac3c64330 
1//===- CXCursor.cpp - Routines for manipulating CXCursors -----------------===//
2//
3//                     The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9//
10// This file defines routines for manipulating CXCursors. It should be the
11// only file that has internal knowledge of the encoding of the data in
12// CXCursor.
13//
14//===----------------------------------------------------------------------===//
15
16#include "CXTranslationUnit.h"
17#include "CXCursor.h"
18#include "CXString.h"
19#include "clang/Frontend/ASTUnit.h"
20#include "clang/AST/Decl.h"
21#include "clang/AST/DeclCXX.h"
22#include "clang/AST/DeclObjC.h"
23#include "clang/AST/Expr.h"
24#include "clang/AST/ExprCXX.h"
25#include "clang-c/Index.h"
26#include "llvm/Support/ErrorHandling.h"
27
28using namespace clang;
29using namespace cxcursor;
30
31CXCursor cxcursor::MakeCXCursorInvalid(CXCursorKind K) {
32  assert(K >= CXCursor_FirstInvalid && K <= CXCursor_LastInvalid);
33  CXCursor C = { K, { 0, 0, 0 } };
34  return C;
35}
36
37static CXCursorKind GetCursorKind(const Attr *A) {
38  assert(A && "Invalid arguments!");
39  switch (A->getKind()) {
40    default: break;
41    case attr::IBAction: return CXCursor_IBActionAttr;
42    case attr::IBOutlet: return CXCursor_IBOutletAttr;
43    case attr::IBOutletCollection: return CXCursor_IBOutletCollectionAttr;
44  }
45
46  return CXCursor_UnexposedAttr;
47}
48
49CXCursor cxcursor::MakeCXCursor(const Attr *A, Decl *Parent,
50                                CXTranslationUnit TU) {
51  assert(A && Parent && TU && "Invalid arguments!");
52  CXCursor C = { GetCursorKind(A), { Parent, (void*)A, TU } };
53  return C;
54}
55
56CXCursor cxcursor::MakeCXCursor(Decl *D, CXTranslationUnit TU,
57                                bool FirstInDeclGroup) {
58  assert(D && TU && "Invalid arguments!");
59  CXCursor C = { getCursorKindForDecl(D),
60                 { D, (void*)(intptr_t) (FirstInDeclGroup ? 1 : 0), TU }
61               };
62  return C;
63}
64
65CXCursor cxcursor::MakeCXCursor(Stmt *S, Decl *Parent,
66                                CXTranslationUnit TU) {
67  assert(S && TU && "Invalid arguments!");
68  CXCursorKind K = CXCursor_NotImplemented;
69
70  switch (S->getStmtClass()) {
71  case Stmt::NoStmtClass:
72    break;
73
74  case Stmt::NullStmtClass:
75  case Stmt::CompoundStmtClass:
76  case Stmt::CaseStmtClass:
77  case Stmt::DefaultStmtClass:
78  case Stmt::IfStmtClass:
79  case Stmt::SwitchStmtClass:
80  case Stmt::WhileStmtClass:
81  case Stmt::DoStmtClass:
82  case Stmt::ForStmtClass:
83  case Stmt::GotoStmtClass:
84  case Stmt::IndirectGotoStmtClass:
85  case Stmt::ContinueStmtClass:
86  case Stmt::BreakStmtClass:
87  case Stmt::ReturnStmtClass:
88  case Stmt::DeclStmtClass:
89  case Stmt::AsmStmtClass:
90  case Stmt::ObjCAtTryStmtClass:
91  case Stmt::ObjCAtCatchStmtClass:
92  case Stmt::ObjCAtFinallyStmtClass:
93  case Stmt::ObjCAtThrowStmtClass:
94  case Stmt::ObjCAtSynchronizedStmtClass:
95  case Stmt::ObjCForCollectionStmtClass:
96  case Stmt::CXXCatchStmtClass:
97  case Stmt::CXXTryStmtClass:
98  case Stmt::CXXForRangeStmtClass:
99    K = CXCursor_UnexposedStmt;
100    break;
101
102  case Stmt::LabelStmtClass:
103    K = CXCursor_LabelStmt;
104    break;
105
106  case Stmt::PredefinedExprClass:
107  case Stmt::IntegerLiteralClass:
108  case Stmt::FloatingLiteralClass:
109  case Stmt::ImaginaryLiteralClass:
110  case Stmt::StringLiteralClass:
111  case Stmt::CharacterLiteralClass:
112  case Stmt::ParenExprClass:
113  case Stmt::UnaryOperatorClass:
114  case Stmt::OffsetOfExprClass:
115  case Stmt::UnaryExprOrTypeTraitExprClass:
116  case Stmt::ArraySubscriptExprClass:
117  case Stmt::BinaryOperatorClass:
118  case Stmt::CompoundAssignOperatorClass:
119  case Stmt::ConditionalOperatorClass:
120  case Stmt::BinaryConditionalOperatorClass:
121  case Stmt::ImplicitCastExprClass:
122  case Stmt::CStyleCastExprClass:
123  case Stmt::CompoundLiteralExprClass:
124  case Stmt::ExtVectorElementExprClass:
125  case Stmt::InitListExprClass:
126  case Stmt::DesignatedInitExprClass:
127  case Stmt::ImplicitValueInitExprClass:
128  case Stmt::ParenListExprClass:
129  case Stmt::VAArgExprClass:
130  case Stmt::AddrLabelExprClass:
131  case Stmt::StmtExprClass:
132  case Stmt::ChooseExprClass:
133  case Stmt::GenericSelectionExprClass:
134  case Stmt::GNUNullExprClass:
135  case Stmt::CXXStaticCastExprClass:
136  case Stmt::CXXDynamicCastExprClass:
137  case Stmt::CXXReinterpretCastExprClass:
138  case Stmt::CXXConstCastExprClass:
139  case Stmt::CXXFunctionalCastExprClass:
140  case Stmt::CXXTypeidExprClass:
141  case Stmt::CXXUuidofExprClass:
142  case Stmt::CXXBoolLiteralExprClass:
143  case Stmt::CXXNullPtrLiteralExprClass:
144  case Stmt::CXXThisExprClass:
145  case Stmt::CXXThrowExprClass:
146  case Stmt::CXXDefaultArgExprClass:
147  case Stmt::CXXScalarValueInitExprClass:
148  case Stmt::CXXNewExprClass:
149  case Stmt::CXXDeleteExprClass:
150  case Stmt::CXXPseudoDestructorExprClass:
151  case Stmt::UnresolvedLookupExprClass:
152  case Stmt::UnaryTypeTraitExprClass:
153  case Stmt::BinaryTypeTraitExprClass:
154  case Stmt::ArrayTypeTraitExprClass:
155  case Stmt::ExpressionTraitExprClass:
156  case Stmt::DependentScopeDeclRefExprClass:
157  case Stmt::CXXBindTemporaryExprClass:
158  case Stmt::ExprWithCleanupsClass:
159  case Stmt::CXXUnresolvedConstructExprClass:
160  case Stmt::CXXDependentScopeMemberExprClass:
161  case Stmt::UnresolvedMemberExprClass:
162  case Stmt::CXXNoexceptExprClass:
163  case Stmt::ObjCStringLiteralClass:
164  case Stmt::ObjCEncodeExprClass:
165  case Stmt::ObjCSelectorExprClass:
166  case Stmt::ObjCProtocolExprClass:
167  case Stmt::ObjCIsaExprClass:
168  case Stmt::ShuffleVectorExprClass:
169  case Stmt::BlockExprClass:
170  case Stmt::OpaqueValueExprClass:
171  case Stmt::PackExpansionExprClass:
172  case Stmt::SizeOfPackExprClass:
173    K = CXCursor_UnexposedExpr;
174    break;
175
176  case Stmt::DeclRefExprClass:
177  case Stmt::BlockDeclRefExprClass:
178  case Stmt::SubstNonTypeTemplateParmPackExprClass:
179    // FIXME: UnresolvedLookupExpr?
180    // FIXME: DependentScopeDeclRefExpr?
181    K = CXCursor_DeclRefExpr;
182    break;
183
184  case Stmt::MemberExprClass:
185  case Stmt::ObjCIvarRefExprClass:
186  case Stmt::ObjCPropertyRefExprClass:
187    // FIXME: UnresolvedMemberExpr?
188    // FIXME: CXXDependentScopeMemberExpr?
189    K = CXCursor_MemberRefExpr;
190    break;
191
192  case Stmt::CallExprClass:
193  case Stmt::CXXOperatorCallExprClass:
194  case Stmt::CXXMemberCallExprClass:
195  case Stmt::CUDAKernelCallExprClass:
196  case Stmt::CXXConstructExprClass:
197  case Stmt::CXXTemporaryObjectExprClass:
198    // FIXME: CXXUnresolvedConstructExpr
199    K = CXCursor_CallExpr;
200    break;
201
202  case Stmt::ObjCMessageExprClass:
203    K = CXCursor_ObjCMessageExpr;
204    break;
205  }
206
207  CXCursor C = { K, { Parent, S, TU } };
208  return C;
209}
210
211CXCursor cxcursor::MakeCursorObjCSuperClassRef(ObjCInterfaceDecl *Super,
212                                               SourceLocation Loc,
213                                               CXTranslationUnit TU) {
214  assert(Super && TU && "Invalid arguments!");
215  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
216  CXCursor C = { CXCursor_ObjCSuperClassRef, { Super, RawLoc, TU } };
217  return C;
218}
219
220std::pair<ObjCInterfaceDecl *, SourceLocation>
221cxcursor::getCursorObjCSuperClassRef(CXCursor C) {
222  assert(C.kind == CXCursor_ObjCSuperClassRef);
223  return std::make_pair(static_cast<ObjCInterfaceDecl *>(C.data[0]),
224           SourceLocation::getFromRawEncoding(
225                                      reinterpret_cast<uintptr_t>(C.data[1])));
226}
227
228CXCursor cxcursor::MakeCursorObjCProtocolRef(ObjCProtocolDecl *Super,
229                                             SourceLocation Loc,
230                                             CXTranslationUnit TU) {
231  assert(Super && TU && "Invalid arguments!");
232  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
233  CXCursor C = { CXCursor_ObjCProtocolRef, { Super, RawLoc, TU } };
234  return C;
235}
236
237std::pair<ObjCProtocolDecl *, SourceLocation>
238cxcursor::getCursorObjCProtocolRef(CXCursor C) {
239  assert(C.kind == CXCursor_ObjCProtocolRef);
240  return std::make_pair(static_cast<ObjCProtocolDecl *>(C.data[0]),
241           SourceLocation::getFromRawEncoding(
242                                      reinterpret_cast<uintptr_t>(C.data[1])));
243}
244
245CXCursor cxcursor::MakeCursorObjCClassRef(ObjCInterfaceDecl *Class,
246                                          SourceLocation Loc,
247                                          CXTranslationUnit TU) {
248  // 'Class' can be null for invalid code.
249  if (!Class)
250    return MakeCXCursorInvalid(CXCursor_InvalidCode);
251  assert(TU && "Invalid arguments!");
252  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
253  CXCursor C = { CXCursor_ObjCClassRef, { Class, RawLoc, TU } };
254  return C;
255}
256
257std::pair<ObjCInterfaceDecl *, SourceLocation>
258cxcursor::getCursorObjCClassRef(CXCursor C) {
259  assert(C.kind == CXCursor_ObjCClassRef);
260  return std::make_pair(static_cast<ObjCInterfaceDecl *>(C.data[0]),
261           SourceLocation::getFromRawEncoding(
262                                      reinterpret_cast<uintptr_t>(C.data[1])));
263}
264
265CXCursor cxcursor::MakeCursorTypeRef(TypeDecl *Type, SourceLocation Loc,
266                                     CXTranslationUnit TU) {
267  assert(Type && TU && "Invalid arguments!");
268  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
269  CXCursor C = { CXCursor_TypeRef, { Type, RawLoc, TU } };
270  return C;
271}
272
273std::pair<TypeDecl *, SourceLocation>
274cxcursor::getCursorTypeRef(CXCursor C) {
275  assert(C.kind == CXCursor_TypeRef);
276  return std::make_pair(static_cast<TypeDecl *>(C.data[0]),
277           SourceLocation::getFromRawEncoding(
278                                      reinterpret_cast<uintptr_t>(C.data[1])));
279}
280
281CXCursor cxcursor::MakeCursorTemplateRef(TemplateDecl *Template,
282                                         SourceLocation Loc,
283                                         CXTranslationUnit TU) {
284  assert(Template && TU && "Invalid arguments!");
285  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
286  CXCursor C = { CXCursor_TemplateRef, { Template, RawLoc, TU } };
287  return C;
288}
289
290std::pair<TemplateDecl *, SourceLocation>
291cxcursor::getCursorTemplateRef(CXCursor C) {
292  assert(C.kind == CXCursor_TemplateRef);
293  return std::make_pair(static_cast<TemplateDecl *>(C.data[0]),
294                        SourceLocation::getFromRawEncoding(
295                                       reinterpret_cast<uintptr_t>(C.data[1])));
296}
297
298CXCursor cxcursor::MakeCursorNamespaceRef(NamedDecl *NS, SourceLocation Loc,
299                                          CXTranslationUnit TU) {
300
301  assert(NS && (isa<NamespaceDecl>(NS) || isa<NamespaceAliasDecl>(NS)) && TU &&
302         "Invalid arguments!");
303  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
304  CXCursor C = { CXCursor_NamespaceRef, { NS, RawLoc, TU } };
305  return C;
306}
307
308std::pair<NamedDecl *, SourceLocation>
309cxcursor::getCursorNamespaceRef(CXCursor C) {
310  assert(C.kind == CXCursor_NamespaceRef);
311  return std::make_pair(static_cast<NamedDecl *>(C.data[0]),
312                        SourceLocation::getFromRawEncoding(
313                                       reinterpret_cast<uintptr_t>(C.data[1])));
314}
315
316CXCursor cxcursor::MakeCursorMemberRef(FieldDecl *Field, SourceLocation Loc,
317                                       CXTranslationUnit TU) {
318
319  assert(Field && TU && "Invalid arguments!");
320  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
321  CXCursor C = { CXCursor_MemberRef, { Field, RawLoc, TU } };
322  return C;
323}
324
325std::pair<FieldDecl *, SourceLocation>
326cxcursor::getCursorMemberRef(CXCursor C) {
327  assert(C.kind == CXCursor_MemberRef);
328  return std::make_pair(static_cast<FieldDecl *>(C.data[0]),
329                        SourceLocation::getFromRawEncoding(
330                                       reinterpret_cast<uintptr_t>(C.data[1])));
331}
332
333CXCursor cxcursor::MakeCursorCXXBaseSpecifier(CXXBaseSpecifier *B,
334                                              CXTranslationUnit TU){
335  CXCursor C = { CXCursor_CXXBaseSpecifier, { B, 0, TU } };
336  return C;
337}
338
339CXXBaseSpecifier *cxcursor::getCursorCXXBaseSpecifier(CXCursor C) {
340  assert(C.kind == CXCursor_CXXBaseSpecifier);
341  return static_cast<CXXBaseSpecifier*>(C.data[0]);
342}
343
344CXCursor cxcursor::MakePreprocessingDirectiveCursor(SourceRange Range,
345                                                    CXTranslationUnit TU) {
346  CXCursor C = { CXCursor_PreprocessingDirective,
347                 { reinterpret_cast<void *>(Range.getBegin().getRawEncoding()),
348                   reinterpret_cast<void *>(Range.getEnd().getRawEncoding()),
349                   TU }
350               };
351  return C;
352}
353
354SourceRange cxcursor::getCursorPreprocessingDirective(CXCursor C) {
355  assert(C.kind == CXCursor_PreprocessingDirective);
356  return SourceRange(SourceLocation::getFromRawEncoding(
357                                      reinterpret_cast<uintptr_t> (C.data[0])),
358                     SourceLocation::getFromRawEncoding(
359                                      reinterpret_cast<uintptr_t> (C.data[1])));
360}
361
362CXCursor cxcursor::MakeMacroDefinitionCursor(MacroDefinition *MI,
363                                             CXTranslationUnit TU) {
364  CXCursor C = { CXCursor_MacroDefinition, { MI, 0, TU } };
365  return C;
366}
367
368MacroDefinition *cxcursor::getCursorMacroDefinition(CXCursor C) {
369  assert(C.kind == CXCursor_MacroDefinition);
370  return static_cast<MacroDefinition *>(C.data[0]);
371}
372
373CXCursor cxcursor::MakeMacroInstantiationCursor(MacroInstantiation *MI,
374                                                CXTranslationUnit TU) {
375  CXCursor C = { CXCursor_MacroInstantiation, { MI, 0, TU } };
376  return C;
377}
378
379MacroInstantiation *cxcursor::getCursorMacroInstantiation(CXCursor C) {
380  assert(C.kind == CXCursor_MacroInstantiation);
381  return static_cast<MacroInstantiation *>(C.data[0]);
382}
383
384CXCursor cxcursor::MakeInclusionDirectiveCursor(InclusionDirective *ID,
385                                                CXTranslationUnit TU) {
386  CXCursor C = { CXCursor_InclusionDirective, { ID, 0, TU } };
387  return C;
388}
389
390InclusionDirective *cxcursor::getCursorInclusionDirective(CXCursor C) {
391  assert(C.kind == CXCursor_InclusionDirective);
392  return static_cast<InclusionDirective *>(C.data[0]);
393}
394
395CXCursor cxcursor::MakeCursorLabelRef(LabelStmt *Label, SourceLocation Loc,
396                                      CXTranslationUnit TU) {
397
398  assert(Label && TU && "Invalid arguments!");
399  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
400  CXCursor C = { CXCursor_LabelRef, { Label, RawLoc, TU } };
401  return C;
402}
403
404std::pair<LabelStmt*, SourceLocation>
405cxcursor::getCursorLabelRef(CXCursor C) {
406  assert(C.kind == CXCursor_LabelRef);
407  return std::make_pair(static_cast<LabelStmt *>(C.data[0]),
408                        SourceLocation::getFromRawEncoding(
409                                       reinterpret_cast<uintptr_t>(C.data[1])));
410}
411
412CXCursor cxcursor::MakeCursorOverloadedDeclRef(OverloadExpr *E,
413                                               CXTranslationUnit TU) {
414  assert(E && TU && "Invalid arguments!");
415  OverloadedDeclRefStorage Storage(E);
416  void *RawLoc = reinterpret_cast<void *>(E->getNameLoc().getRawEncoding());
417  CXCursor C = {
418                 CXCursor_OverloadedDeclRef,
419                 { Storage.getOpaqueValue(), RawLoc, TU }
420               };
421  return C;
422}
423
424CXCursor cxcursor::MakeCursorOverloadedDeclRef(Decl *D,
425                                               SourceLocation Loc,
426                                               CXTranslationUnit TU) {
427  assert(D && TU && "Invalid arguments!");
428  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
429  OverloadedDeclRefStorage Storage(D);
430  CXCursor C = {
431    CXCursor_OverloadedDeclRef,
432    { Storage.getOpaqueValue(), RawLoc, TU }
433  };
434  return C;
435}
436
437CXCursor cxcursor::MakeCursorOverloadedDeclRef(TemplateName Name,
438                                               SourceLocation Loc,
439                                               CXTranslationUnit TU) {
440  assert(Name.getAsOverloadedTemplate() && TU && "Invalid arguments!");
441  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
442  OverloadedDeclRefStorage Storage(Name.getAsOverloadedTemplate());
443  CXCursor C = {
444    CXCursor_OverloadedDeclRef,
445    { Storage.getOpaqueValue(), RawLoc, TU }
446  };
447  return C;
448}
449
450std::pair<cxcursor::OverloadedDeclRefStorage, SourceLocation>
451cxcursor::getCursorOverloadedDeclRef(CXCursor C) {
452  assert(C.kind == CXCursor_OverloadedDeclRef);
453  return std::make_pair(OverloadedDeclRefStorage::getFromOpaqueValue(C.data[0]),
454                        SourceLocation::getFromRawEncoding(
455                                       reinterpret_cast<uintptr_t>(C.data[1])));
456}
457
458Decl *cxcursor::getCursorDecl(CXCursor Cursor) {
459  return (Decl *)Cursor.data[0];
460}
461
462Expr *cxcursor::getCursorExpr(CXCursor Cursor) {
463  return dyn_cast_or_null<Expr>(getCursorStmt(Cursor));
464}
465
466Stmt *cxcursor::getCursorStmt(CXCursor Cursor) {
467  if (Cursor.kind == CXCursor_ObjCSuperClassRef ||
468      Cursor.kind == CXCursor_ObjCProtocolRef ||
469      Cursor.kind == CXCursor_ObjCClassRef)
470    return 0;
471
472  return (Stmt *)Cursor.data[1];
473}
474
475Attr *cxcursor::getCursorAttr(CXCursor Cursor) {
476  return (Attr *)Cursor.data[1];
477}
478
479ASTContext &cxcursor::getCursorContext(CXCursor Cursor) {
480  return getCursorASTUnit(Cursor)->getASTContext();
481}
482
483ASTUnit *cxcursor::getCursorASTUnit(CXCursor Cursor) {
484  return static_cast<ASTUnit *>(static_cast<CXTranslationUnit>(Cursor.data[2])
485                                  ->TUData);
486}
487
488CXTranslationUnit cxcursor::getCursorTU(CXCursor Cursor) {
489  return static_cast<CXTranslationUnit>(Cursor.data[2]);
490}
491
492bool cxcursor::operator==(CXCursor X, CXCursor Y) {
493  return X.kind == Y.kind && X.data[0] == Y.data[0] && X.data[1] == Y.data[1] &&
494         X.data[2] == Y.data[2];
495}
496
497// FIXME: Remove once we can model DeclGroups and their appropriate ranges
498// properly in the ASTs.
499bool cxcursor::isFirstInDeclGroup(CXCursor C) {
500  assert(clang_isDeclaration(C.kind));
501  return ((uintptr_t) (C.data[1])) != 0;
502}
503
504//===----------------------------------------------------------------------===//
505// CXCursorSet.
506//===----------------------------------------------------------------------===//
507
508typedef llvm::DenseMap<CXCursor, unsigned> CXCursorSet_Impl;
509
510static inline CXCursorSet packCXCursorSet(CXCursorSet_Impl *setImpl) {
511  return (CXCursorSet) setImpl;
512}
513static inline CXCursorSet_Impl *unpackCXCursorSet(CXCursorSet set) {
514  return (CXCursorSet_Impl*) set;
515}
516namespace llvm {
517template<> struct DenseMapInfo<CXCursor> {
518public:
519  static inline CXCursor getEmptyKey() {
520    return MakeCXCursorInvalid(CXCursor_InvalidFile);
521  }
522  static inline CXCursor getTombstoneKey() {
523    return MakeCXCursorInvalid(CXCursor_NoDeclFound);
524  }
525  static inline unsigned getHashValue(const CXCursor &cursor) {
526    return llvm::DenseMapInfo<std::pair<void*,void*> >
527      ::getHashValue(std::make_pair(cursor.data[0], cursor.data[1]));
528  }
529  static inline bool isEqual(const CXCursor &x, const CXCursor &y) {
530    return x.kind == y.kind &&
531           x.data[0] == y.data[0] &&
532           x.data[1] == y.data[1];
533  }
534};
535}
536
537extern "C" {
538CXCursorSet clang_createCXCursorSet() {
539  return packCXCursorSet(new CXCursorSet_Impl());
540}
541
542void clang_disposeCXCursorSet(CXCursorSet set) {
543  delete unpackCXCursorSet(set);
544}
545
546unsigned clang_CXCursorSet_contains(CXCursorSet set, CXCursor cursor) {
547  CXCursorSet_Impl *setImpl = unpackCXCursorSet(set);
548  if (!setImpl)
549    return 0;
550  return setImpl->find(cursor) == setImpl->end();
551}
552
553unsigned clang_CXCursorSet_insert(CXCursorSet set, CXCursor cursor) {
554  // Do not insert invalid cursors into the set.
555  if (cursor.kind >= CXCursor_FirstInvalid &&
556      cursor.kind <= CXCursor_LastInvalid)
557    return 1;
558
559  CXCursorSet_Impl *setImpl = unpackCXCursorSet(set);
560  if (!setImpl)
561    return 1;
562  unsigned &entry = (*setImpl)[cursor];
563  unsigned flag = entry == 0 ? 1 : 0;
564  entry = 1;
565  return flag;
566}
567} // end: extern "C"
568