CXCursor.cpp revision ee8aff06f6a96214731de17b2cb6df407c6c1820 
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*) (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::SwitchCaseClass:
90  case Stmt::AsmStmtClass:
91  case Stmt::ObjCAtTryStmtClass:
92  case Stmt::ObjCAtCatchStmtClass:
93  case Stmt::ObjCAtFinallyStmtClass:
94  case Stmt::ObjCAtThrowStmtClass:
95  case Stmt::ObjCAtSynchronizedStmtClass:
96  case Stmt::ObjCForCollectionStmtClass:
97  case Stmt::CXXCatchStmtClass:
98  case Stmt::CXXTryStmtClass:
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::SizeOfAlignOfExprClass:
116  case Stmt::ArraySubscriptExprClass:
117  case Stmt::BinaryOperatorClass:
118  case Stmt::CompoundAssignOperatorClass:
119  case Stmt::ConditionalOperatorClass:
120  case Stmt::ImplicitCastExprClass:
121  case Stmt::CStyleCastExprClass:
122  case Stmt::CompoundLiteralExprClass:
123  case Stmt::ExtVectorElementExprClass:
124  case Stmt::InitListExprClass:
125  case Stmt::DesignatedInitExprClass:
126  case Stmt::ImplicitValueInitExprClass:
127  case Stmt::ParenListExprClass:
128  case Stmt::VAArgExprClass:
129  case Stmt::AddrLabelExprClass:
130  case Stmt::StmtExprClass:
131  case Stmt::ChooseExprClass:
132  case Stmt::GNUNullExprClass:
133  case Stmt::CXXStaticCastExprClass:
134  case Stmt::CXXDynamicCastExprClass:
135  case Stmt::CXXReinterpretCastExprClass:
136  case Stmt::CXXConstCastExprClass:
137  case Stmt::CXXFunctionalCastExprClass:
138  case Stmt::CXXTypeidExprClass:
139  case Stmt::CXXUuidofExprClass:
140  case Stmt::CXXBoolLiteralExprClass:
141  case Stmt::CXXNullPtrLiteralExprClass:
142  case Stmt::CXXThisExprClass:
143  case Stmt::CXXThrowExprClass:
144  case Stmt::CXXDefaultArgExprClass:
145  case Stmt::CXXScalarValueInitExprClass:
146  case Stmt::CXXNewExprClass:
147  case Stmt::CXXDeleteExprClass:
148  case Stmt::CXXPseudoDestructorExprClass:
149  case Stmt::UnresolvedLookupExprClass:
150  case Stmt::UnaryTypeTraitExprClass:
151  case Stmt::BinaryTypeTraitExprClass:
152  case Stmt::DependentScopeDeclRefExprClass:
153  case Stmt::CXXBindTemporaryExprClass:
154  case Stmt::ExprWithCleanupsClass:
155  case Stmt::CXXUnresolvedConstructExprClass:
156  case Stmt::CXXDependentScopeMemberExprClass:
157  case Stmt::UnresolvedMemberExprClass:
158  case Stmt::CXXNoexceptExprClass:
159  case Stmt::ObjCStringLiteralClass:
160  case Stmt::ObjCEncodeExprClass:
161  case Stmt::ObjCSelectorExprClass:
162  case Stmt::ObjCProtocolExprClass:
163  case Stmt::ObjCIsaExprClass:
164  case Stmt::ShuffleVectorExprClass:
165  case Stmt::BlockExprClass:
166  case Stmt::OpaqueValueExprClass:
167  case Stmt::PackExpansionExprClass:
168  case Stmt::SizeOfPackExprClass:
169    K = CXCursor_UnexposedExpr;
170    break;
171
172  case Stmt::DeclRefExprClass:
173  case Stmt::BlockDeclRefExprClass:
174    // FIXME: UnresolvedLookupExpr?
175    // FIXME: DependentScopeDeclRefExpr?
176    K = CXCursor_DeclRefExpr;
177    break;
178
179  case Stmt::MemberExprClass:
180  case Stmt::ObjCIvarRefExprClass:
181  case Stmt::ObjCPropertyRefExprClass:
182    // FIXME: UnresolvedMemberExpr?
183    // FIXME: CXXDependentScopeMemberExpr?
184    K = CXCursor_MemberRefExpr;
185    break;
186
187  case Stmt::CallExprClass:
188  case Stmt::CXXOperatorCallExprClass:
189  case Stmt::CXXMemberCallExprClass:
190  case Stmt::CXXConstructExprClass:
191  case Stmt::CXXTemporaryObjectExprClass:
192    // FIXME: CXXUnresolvedConstructExpr
193    K = CXCursor_CallExpr;
194    break;
195
196  case Stmt::ObjCMessageExprClass:
197    K = CXCursor_ObjCMessageExpr;
198    break;
199  }
200
201  CXCursor C = { K, { Parent, S, TU } };
202  return C;
203}
204
205CXCursor cxcursor::MakeCursorObjCSuperClassRef(ObjCInterfaceDecl *Super,
206                                               SourceLocation Loc,
207                                               CXTranslationUnit TU) {
208  assert(Super && TU && "Invalid arguments!");
209  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
210  CXCursor C = { CXCursor_ObjCSuperClassRef, { Super, RawLoc, TU } };
211  return C;
212}
213
214std::pair<ObjCInterfaceDecl *, SourceLocation>
215cxcursor::getCursorObjCSuperClassRef(CXCursor C) {
216  assert(C.kind == CXCursor_ObjCSuperClassRef);
217  return std::make_pair(static_cast<ObjCInterfaceDecl *>(C.data[0]),
218           SourceLocation::getFromRawEncoding(
219                                      reinterpret_cast<uintptr_t>(C.data[1])));
220}
221
222CXCursor cxcursor::MakeCursorObjCProtocolRef(ObjCProtocolDecl *Super,
223                                             SourceLocation Loc,
224                                             CXTranslationUnit TU) {
225  assert(Super && TU && "Invalid arguments!");
226  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
227  CXCursor C = { CXCursor_ObjCProtocolRef, { Super, RawLoc, TU } };
228  return C;
229}
230
231std::pair<ObjCProtocolDecl *, SourceLocation>
232cxcursor::getCursorObjCProtocolRef(CXCursor C) {
233  assert(C.kind == CXCursor_ObjCProtocolRef);
234  return std::make_pair(static_cast<ObjCProtocolDecl *>(C.data[0]),
235           SourceLocation::getFromRawEncoding(
236                                      reinterpret_cast<uintptr_t>(C.data[1])));
237}
238
239CXCursor cxcursor::MakeCursorObjCClassRef(ObjCInterfaceDecl *Class,
240                                          SourceLocation Loc,
241                                          CXTranslationUnit TU) {
242  // 'Class' can be null for invalid code.
243  if (!Class)
244    return MakeCXCursorInvalid(CXCursor_InvalidCode);
245  assert(TU && "Invalid arguments!");
246  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
247  CXCursor C = { CXCursor_ObjCClassRef, { Class, RawLoc, TU } };
248  return C;
249}
250
251std::pair<ObjCInterfaceDecl *, SourceLocation>
252cxcursor::getCursorObjCClassRef(CXCursor C) {
253  assert(C.kind == CXCursor_ObjCClassRef);
254  return std::make_pair(static_cast<ObjCInterfaceDecl *>(C.data[0]),
255           SourceLocation::getFromRawEncoding(
256                                      reinterpret_cast<uintptr_t>(C.data[1])));
257}
258
259CXCursor cxcursor::MakeCursorTypeRef(TypeDecl *Type, SourceLocation Loc,
260                                     CXTranslationUnit TU) {
261  assert(Type && TU && "Invalid arguments!");
262  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
263  CXCursor C = { CXCursor_TypeRef, { Type, RawLoc, TU } };
264  return C;
265}
266
267std::pair<TypeDecl *, SourceLocation>
268cxcursor::getCursorTypeRef(CXCursor C) {
269  assert(C.kind == CXCursor_TypeRef);
270  return std::make_pair(static_cast<TypeDecl *>(C.data[0]),
271           SourceLocation::getFromRawEncoding(
272                                      reinterpret_cast<uintptr_t>(C.data[1])));
273}
274
275CXCursor cxcursor::MakeCursorTemplateRef(TemplateDecl *Template,
276                                         SourceLocation Loc,
277                                         CXTranslationUnit TU) {
278  assert(Template && TU && "Invalid arguments!");
279  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
280  CXCursor C = { CXCursor_TemplateRef, { Template, RawLoc, TU } };
281  return C;
282}
283
284std::pair<TemplateDecl *, SourceLocation>
285cxcursor::getCursorTemplateRef(CXCursor C) {
286  assert(C.kind == CXCursor_TemplateRef);
287  return std::make_pair(static_cast<TemplateDecl *>(C.data[0]),
288                        SourceLocation::getFromRawEncoding(
289                                       reinterpret_cast<uintptr_t>(C.data[1])));
290}
291
292CXCursor cxcursor::MakeCursorNamespaceRef(NamedDecl *NS, SourceLocation Loc,
293                                          CXTranslationUnit TU) {
294
295  assert(NS && (isa<NamespaceDecl>(NS) || isa<NamespaceAliasDecl>(NS)) && TU &&
296         "Invalid arguments!");
297  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
298  CXCursor C = { CXCursor_NamespaceRef, { NS, RawLoc, TU } };
299  return C;
300}
301
302std::pair<NamedDecl *, SourceLocation>
303cxcursor::getCursorNamespaceRef(CXCursor C) {
304  assert(C.kind == CXCursor_NamespaceRef);
305  return std::make_pair(static_cast<NamedDecl *>(C.data[0]),
306                        SourceLocation::getFromRawEncoding(
307                                       reinterpret_cast<uintptr_t>(C.data[1])));
308}
309
310CXCursor cxcursor::MakeCursorMemberRef(FieldDecl *Field, SourceLocation Loc,
311                                       CXTranslationUnit TU) {
312
313  assert(Field && TU && "Invalid arguments!");
314  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
315  CXCursor C = { CXCursor_MemberRef, { Field, RawLoc, TU } };
316  return C;
317}
318
319std::pair<FieldDecl *, SourceLocation>
320cxcursor::getCursorMemberRef(CXCursor C) {
321  assert(C.kind == CXCursor_MemberRef);
322  return std::make_pair(static_cast<FieldDecl *>(C.data[0]),
323                        SourceLocation::getFromRawEncoding(
324                                       reinterpret_cast<uintptr_t>(C.data[1])));
325}
326
327CXCursor cxcursor::MakeCursorCXXBaseSpecifier(CXXBaseSpecifier *B,
328                                              CXTranslationUnit TU){
329  CXCursor C = { CXCursor_CXXBaseSpecifier, { B, 0, TU } };
330  return C;
331}
332
333CXXBaseSpecifier *cxcursor::getCursorCXXBaseSpecifier(CXCursor C) {
334  assert(C.kind == CXCursor_CXXBaseSpecifier);
335  return static_cast<CXXBaseSpecifier*>(C.data[0]);
336}
337
338CXCursor cxcursor::MakePreprocessingDirectiveCursor(SourceRange Range,
339                                                    CXTranslationUnit TU) {
340  CXCursor C = { CXCursor_PreprocessingDirective,
341                 { reinterpret_cast<void *>(Range.getBegin().getRawEncoding()),
342                   reinterpret_cast<void *>(Range.getEnd().getRawEncoding()),
343                   TU }
344               };
345  return C;
346}
347
348SourceRange cxcursor::getCursorPreprocessingDirective(CXCursor C) {
349  assert(C.kind == CXCursor_PreprocessingDirective);
350  return SourceRange(SourceLocation::getFromRawEncoding(
351                                      reinterpret_cast<uintptr_t> (C.data[0])),
352                     SourceLocation::getFromRawEncoding(
353                                      reinterpret_cast<uintptr_t> (C.data[1])));
354}
355
356CXCursor cxcursor::MakeMacroDefinitionCursor(MacroDefinition *MI,
357                                             CXTranslationUnit TU) {
358  CXCursor C = { CXCursor_MacroDefinition, { MI, 0, TU } };
359  return C;
360}
361
362MacroDefinition *cxcursor::getCursorMacroDefinition(CXCursor C) {
363  assert(C.kind == CXCursor_MacroDefinition);
364  return static_cast<MacroDefinition *>(C.data[0]);
365}
366
367CXCursor cxcursor::MakeMacroInstantiationCursor(MacroInstantiation *MI,
368                                                CXTranslationUnit TU) {
369  CXCursor C = { CXCursor_MacroInstantiation, { MI, 0, TU } };
370  return C;
371}
372
373MacroInstantiation *cxcursor::getCursorMacroInstantiation(CXCursor C) {
374  assert(C.kind == CXCursor_MacroInstantiation);
375  return static_cast<MacroInstantiation *>(C.data[0]);
376}
377
378CXCursor cxcursor::MakeInclusionDirectiveCursor(InclusionDirective *ID,
379                                                CXTranslationUnit TU) {
380  CXCursor C = { CXCursor_InclusionDirective, { ID, 0, TU } };
381  return C;
382}
383
384InclusionDirective *cxcursor::getCursorInclusionDirective(CXCursor C) {
385  assert(C.kind == CXCursor_InclusionDirective);
386  return static_cast<InclusionDirective *>(C.data[0]);
387}
388
389CXCursor cxcursor::MakeCursorLabelRef(LabelStmt *Label, SourceLocation Loc,
390                                      CXTranslationUnit TU) {
391
392  assert(Label && TU && "Invalid arguments!");
393  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
394  CXCursor C = { CXCursor_LabelRef, { Label, RawLoc, TU } };
395  return C;
396}
397
398std::pair<LabelStmt*, SourceLocation>
399cxcursor::getCursorLabelRef(CXCursor C) {
400  assert(C.kind == CXCursor_LabelRef);
401  return std::make_pair(static_cast<LabelStmt *>(C.data[0]),
402                        SourceLocation::getFromRawEncoding(
403                                       reinterpret_cast<uintptr_t>(C.data[1])));
404}
405
406CXCursor cxcursor::MakeCursorOverloadedDeclRef(OverloadExpr *E,
407                                               CXTranslationUnit TU) {
408  assert(E && TU && "Invalid arguments!");
409  OverloadedDeclRefStorage Storage(E);
410  void *RawLoc = reinterpret_cast<void *>(E->getNameLoc().getRawEncoding());
411  CXCursor C = {
412                 CXCursor_OverloadedDeclRef,
413                 { Storage.getOpaqueValue(), RawLoc, TU }
414               };
415  return C;
416}
417
418CXCursor cxcursor::MakeCursorOverloadedDeclRef(Decl *D,
419                                               SourceLocation Loc,
420                                               CXTranslationUnit TU) {
421  assert(D && TU && "Invalid arguments!");
422  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
423  OverloadedDeclRefStorage Storage(D);
424  CXCursor C = {
425    CXCursor_OverloadedDeclRef,
426    { Storage.getOpaqueValue(), RawLoc, TU }
427  };
428  return C;
429}
430
431CXCursor cxcursor::MakeCursorOverloadedDeclRef(TemplateName Name,
432                                               SourceLocation Loc,
433                                               CXTranslationUnit TU) {
434  assert(Name.getAsOverloadedTemplate() && TU && "Invalid arguments!");
435  void *RawLoc = reinterpret_cast<void *>(Loc.getRawEncoding());
436  OverloadedDeclRefStorage Storage(Name.getAsOverloadedTemplate());
437  CXCursor C = {
438    CXCursor_OverloadedDeclRef,
439    { Storage.getOpaqueValue(), RawLoc, TU }
440  };
441  return C;
442}
443
444std::pair<cxcursor::OverloadedDeclRefStorage, SourceLocation>
445cxcursor::getCursorOverloadedDeclRef(CXCursor C) {
446  assert(C.kind == CXCursor_OverloadedDeclRef);
447  return std::make_pair(OverloadedDeclRefStorage::getFromOpaqueValue(C.data[0]),
448                        SourceLocation::getFromRawEncoding(
449                                       reinterpret_cast<uintptr_t>(C.data[1])));
450}
451
452Decl *cxcursor::getCursorDecl(CXCursor Cursor) {
453  return (Decl *)Cursor.data[0];
454}
455
456Expr *cxcursor::getCursorExpr(CXCursor Cursor) {
457  return dyn_cast_or_null<Expr>(getCursorStmt(Cursor));
458}
459
460Stmt *cxcursor::getCursorStmt(CXCursor Cursor) {
461  if (Cursor.kind == CXCursor_ObjCSuperClassRef ||
462      Cursor.kind == CXCursor_ObjCProtocolRef ||
463      Cursor.kind == CXCursor_ObjCClassRef)
464    return 0;
465
466  return (Stmt *)Cursor.data[1];
467}
468
469Attr *cxcursor::getCursorAttr(CXCursor Cursor) {
470  return (Attr *)Cursor.data[1];
471}
472
473ASTContext &cxcursor::getCursorContext(CXCursor Cursor) {
474  return getCursorASTUnit(Cursor)->getASTContext();
475}
476
477ASTUnit *cxcursor::getCursorASTUnit(CXCursor Cursor) {
478  return static_cast<ASTUnit *>(static_cast<CXTranslationUnit>(Cursor.data[2])
479                                  ->TUData);
480}
481
482CXTranslationUnit cxcursor::getCursorTU(CXCursor Cursor) {
483  return static_cast<CXTranslationUnit>(Cursor.data[2]);
484}
485
486bool cxcursor::operator==(CXCursor X, CXCursor Y) {
487  return X.kind == Y.kind && X.data[0] == Y.data[0] && X.data[1] == Y.data[1] &&
488         X.data[2] == Y.data[2];
489}
490
491// FIXME: Remove once we can model DeclGroups and their appropriate ranges
492// properly in the ASTs.
493bool cxcursor::isFirstInDeclGroup(CXCursor C) {
494  assert(clang_isDeclaration(C.kind));
495  return ((uintptr_t) (C.data[1])) != 0;
496}
497
498//===----------------------------------------------------------------------===//
499// CXCursorSet.
500//===----------------------------------------------------------------------===//
501
502typedef llvm::DenseMap<CXCursor, unsigned> CXCursorSet_Impl;
503
504static inline CXCursorSet packCXCursorSet(CXCursorSet_Impl *setImpl) {
505  return (CXCursorSet) setImpl;
506}
507static inline CXCursorSet_Impl *unpackCXCursorSet(CXCursorSet set) {
508  return (CXCursorSet_Impl*) set;
509}
510namespace llvm {
511template<> struct DenseMapInfo<CXCursor> {
512public:
513  static inline CXCursor getEmptyKey() {
514    return MakeCXCursorInvalid(CXCursor_InvalidFile);
515  }
516  static inline CXCursor getTombstoneKey() {
517    return MakeCXCursorInvalid(CXCursor_NoDeclFound);
518  }
519  static inline unsigned getHashValue(const CXCursor &cursor) {
520    return llvm::DenseMapInfo<std::pair<void*,void*> >
521      ::getHashValue(std::make_pair(cursor.data[0], cursor.data[1]));
522  }
523  static inline bool isEqual(const CXCursor &x, const CXCursor &y) {
524    return x.kind == y.kind &&
525           x.data[0] == y.data[0] &&
526           x.data[1] == y.data[1];
527  }
528};
529}
530
531extern "C" {
532CXCursorSet clang_createCXCursorSet() {
533  return packCXCursorSet(new CXCursorSet_Impl());
534}
535
536void clang_disposeCXCursorSet(CXCursorSet set) {
537  delete unpackCXCursorSet(set);
538}
539
540unsigned clang_CXCursorSet_contains(CXCursorSet set, CXCursor cursor) {
541  CXCursorSet_Impl *setImpl = unpackCXCursorSet(set);
542  if (!setImpl)
543    return 0;
544  return setImpl->find(cursor) == setImpl->end();
545}
546
547unsigned clang_CXCursorSet_insert(CXCursorSet set, CXCursor cursor) {
548  // Do not insert invalid cursors into the set.
549  if (cursor.kind >= CXCursor_FirstInvalid &&
550      cursor.kind <= CXCursor_LastInvalid)
551    return 1;
552
553  CXCursorSet_Impl *setImpl = unpackCXCursorSet(set);
554  if (!setImpl)
555    return 1;
556  unsigned &entry = (*setImpl)[cursor];
557  unsigned flag = entry == 0 ? 1 : 0;
558  entry = 1;
559  return flag;
560}
561} // end: extern "C"
562
563