blob: fe7829ec5098da25e1db271abc0184eedab0c8bc [file] [log] [blame]
Chris Lattnerec659fc2006-10-29 22:09:44 +00001//===--- IdentifierTable.cpp - Hash table for identifier lookup -----------===//
Chris Lattner22eb9722006-06-18 05:43:12 +00002//
3// The LLVM Compiler Infrastructure
4//
Chris Lattner5b12ab82007-12-29 19:59:25 +00005// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
Chris Lattner22eb9722006-06-18 05:43:12 +00007//
8//===----------------------------------------------------------------------===//
9//
Chris Lattnerc79f6fb2006-07-04 17:53:21 +000010// This file implements the IdentifierInfo, IdentifierVisitor, and
Chris Lattner91cbf112006-07-03 04:28:52 +000011// IdentifierTable interfaces.
Chris Lattner22eb9722006-06-18 05:43:12 +000012//
13//===----------------------------------------------------------------------===//
14
Adrian Prantla4ce9062013-06-07 22:29:12 +000015#include "clang/Basic/CharInfo.h"
Benjamin Kramerf3ca26982014-05-10 16:31:55 +000016#include "clang/Basic/IdentifierTable.h"
Chandler Carruth5553d0d2014-01-07 11:51:46 +000017#include "clang/Basic/LangOptions.h"
Benjamin Kramerf3ca26982014-05-10 16:31:55 +000018#include "clang/Basic/OperatorKinds.h"
Douglas Gregor813a0662015-06-19 18:14:38 +000019#include "clang/Basic/Specifiers.h"
Chris Lattnerdadc7622007-10-05 20:15:24 +000020#include "llvm/ADT/DenseMap.h"
Chandler Carruth3a022472012-12-04 09:13:33 +000021#include "llvm/ADT/FoldingSet.h"
Benjamin Kramerf3ca26982014-05-10 16:31:55 +000022#include "llvm/ADT/SmallString.h"
David Blaikie8a40f702012-01-17 06:56:22 +000023#include "llvm/Support/ErrorHandling.h"
Chandler Carruth3a022472012-12-04 09:13:33 +000024#include "llvm/Support/raw_ostream.h"
Chris Lattnerc25d8a72009-03-02 22:20:04 +000025#include <cstdio>
Ted Kremenekf25f4a32007-10-23 22:18:37 +000026
Chris Lattner22eb9722006-06-18 05:43:12 +000027using namespace clang;
28
29//===----------------------------------------------------------------------===//
Chris Lattnerc79f6fb2006-07-04 17:53:21 +000030// IdentifierInfo Implementation
Chris Lattner22eb9722006-06-18 05:43:12 +000031//===----------------------------------------------------------------------===//
32
Ted Kremenek52f73ca2009-01-20 23:28:34 +000033IdentifierInfo::IdentifierInfo() {
Chris Lattner3bc804e2006-10-28 23:46:24 +000034 TokenID = tok::identifier;
Douglas Gregor2ad7ee92008-11-06 16:32:23 +000035 ObjCOrBuiltinID = 0;
Chris Lattnera441ca62007-10-07 07:09:52 +000036 HasMacro = false;
Alexander Kornienko1d26c022012-09-25 17:18:14 +000037 HadMacro = false;
Chris Lattner3bc804e2006-10-28 23:46:24 +000038 IsExtension = false;
Richard Smith31d51842015-05-14 04:00:59 +000039 IsFutureCompatKeyword = false;
Chris Lattner3bc804e2006-10-28 23:46:24 +000040 IsPoisoned = false;
Chris Lattner5b9f4892006-11-21 17:23:33 +000041 IsCPPOperatorKeyword = false;
Chris Lattnerad89ec02009-01-21 07:43:11 +000042 NeedsHandleIdentifier = false;
Sebastian Redld44cd6a2010-08-18 23:57:06 +000043 IsFromAST = false;
Douglas Gregor935bc7a22011-10-27 09:33:13 +000044 ChangedAfterLoad = false;
Richard Smithd79514e2016-02-05 19:03:40 +000045 FEChangedAfterLoad = false;
Argyrios Kyrtzidis3084a612010-08-11 22:55:12 +000046 RevertedTokenID = false;
Douglas Gregor935bc7a22011-10-27 09:33:13 +000047 OutOfDate = false;
Ted Kremenekc1e4dd02012-03-01 22:07:04 +000048 IsModulesImport = false;
Craig Topperf1186c52014-05-08 06:41:40 +000049 FETokenInfo = nullptr;
50 Entry = nullptr;
Chris Lattner3bc804e2006-10-28 23:46:24 +000051}
52
Chris Lattner91cbf112006-07-03 04:28:52 +000053//===----------------------------------------------------------------------===//
Chris Lattner22eb9722006-06-18 05:43:12 +000054// IdentifierTable Implementation
55//===----------------------------------------------------------------------===//
56
Angel Garcia Gomez637d1e62015-10-20 13:23:58 +000057IdentifierIterator::~IdentifierIterator() { }
Douglas Gregor57756ea2010-10-14 22:11:03 +000058
Angel Garcia Gomez637d1e62015-10-20 13:23:58 +000059IdentifierInfoLookup::~IdentifierInfoLookup() {}
Ted Kremeneka705b042009-01-15 18:47:46 +000060
Douglas Gregor57756ea2010-10-14 22:11:03 +000061namespace {
62 /// \brief A simple identifier lookup iterator that represents an
63 /// empty sequence of identifiers.
64 class EmptyLookupIterator : public IdentifierIterator
65 {
66 public:
Craig Topper3164f332014-03-11 03:39:26 +000067 StringRef Next() override { return StringRef(); }
Douglas Gregor57756ea2010-10-14 22:11:03 +000068 };
69}
70
Argyrios Kyrtzidis9aca3c62013-04-17 22:10:55 +000071IdentifierIterator *IdentifierInfoLookup::getIdentifiers() {
Douglas Gregor57756ea2010-10-14 22:11:03 +000072 return new EmptyLookupIterator();
73}
74
Ted Kremeneka705b042009-01-15 18:47:46 +000075IdentifierTable::IdentifierTable(const LangOptions &LangOpts,
76 IdentifierInfoLookup* externalLookup)
77 : HashTable(8192), // Start with space for 8K identifiers.
78 ExternalLookup(externalLookup) {
Chris Lattnerda933aa2006-10-29 23:49:15 +000079
Chris Lattnerf2e3ac32006-10-27 03:59:10 +000080 // Populate the identifier table with info about keywords for the current
81 // language.
Chris Lattner25e0d542006-10-18 06:07:05 +000082 AddKeywords(LangOpts);
Ted Kremenek94666032012-03-01 22:53:32 +000083
84
85 // Add the '_experimental_modules_import' contextual keyword.
Douglas Gregorc50d4922012-12-11 22:11:52 +000086 get("import").setModulesImport(true);
Chris Lattner91cbf112006-07-03 04:28:52 +000087}
Chris Lattner22eb9722006-06-18 05:43:12 +000088
Chris Lattner25e0d542006-10-18 06:07:05 +000089//===----------------------------------------------------------------------===//
90// Language Keyword Implementation
91//===----------------------------------------------------------------------===//
92
Eli Friedman2b680b42009-04-28 03:13:54 +000093// Constants for TokenKinds.def
94namespace {
95 enum {
Dylan Noblesmith92c07c22011-04-09 13:34:05 +000096 KEYC99 = 0x1,
97 KEYCXX = 0x2,
Richard Smith89645bc2013-01-02 12:01:23 +000098 KEYCXX11 = 0x4,
Dylan Noblesmith92c07c22011-04-09 13:34:05 +000099 KEYGNU = 0x8,
100 KEYMS = 0x10,
101 BOOLSUPPORT = 0x20,
102 KEYALTIVEC = 0x40,
103 KEYNOCXX = 0x80,
104 KEYBORLAND = 0x100,
105 KEYOPENCL = 0x200,
Benjamin Kramere56f3932011-12-23 17:00:35 +0000106 KEYC11 = 0x400,
John McCall31168b02011-06-15 23:02:42 +0000107 KEYARC = 0x800,
David Majnemer28aae9c2015-03-18 04:15:23 +0000108 KEYNOMS18 = 0x01000,
Anastasia Stulovab1152f12015-03-18 12:55:29 +0000109 KEYNOOPENCL = 0x02000,
110 WCHARSUPPORT = 0x04000,
111 HALFSUPPORT = 0x08000,
Hubert Tong6e04f982015-06-05 01:10:24 +0000112 KEYCONCEPTS = 0x10000,
Douglas Gregorab209d82015-07-07 03:58:42 +0000113 KEYOBJC2 = 0x20000,
Ulrich Weigand3c5038a2015-07-30 14:08:36 +0000114 KEYZVECTOR = 0x40000,
Richard Smitheb7927e2015-10-22 03:52:15 +0000115 KEYCOROUTINES = 0x80000,
Richard Smithc7bf3802016-07-23 02:32:21 +0000116 KEYMODULES = 0x100000,
Richard Smith6c74e322017-08-13 21:32:33 +0000117 KEYCXX2A = 0x200000,
118 KEYALLCXX = KEYCXX | KEYCXX11 | KEYCXX2A,
119 KEYALL = (0x3fffff & ~KEYNOMS18 &
Anastasia Stulovab1152f12015-03-18 12:55:29 +0000120 ~KEYNOOPENCL) // KEYNOMS18 and KEYNOOPENCL are used to exclude.
Eli Friedman2b680b42009-04-28 03:13:54 +0000121 };
Serge Pavlov77af3812014-10-29 10:59:18 +0000122
123 /// \brief How a keyword is treated in the selected standard.
124 enum KeywordStatus {
125 KS_Disabled, // Disabled
126 KS_Extension, // Is an extension
127 KS_Enabled, // Enabled
128 KS_Future // Is a keyword in future standard
129 };
Alexander Kornienkoab9db512015-06-22 23:07:51 +0000130}
Serge Pavlov77af3812014-10-29 10:59:18 +0000131
132/// \brief Translates flags as specified in TokenKinds.def into keyword status
133/// in the given language standard.
Serge Pavlov83cf0782014-12-11 12:18:08 +0000134static KeywordStatus getKeywordStatus(const LangOptions &LangOpts,
Serge Pavlov77af3812014-10-29 10:59:18 +0000135 unsigned Flags) {
136 if (Flags == KEYALL) return KS_Enabled;
137 if (LangOpts.CPlusPlus && (Flags & KEYCXX)) return KS_Enabled;
138 if (LangOpts.CPlusPlus11 && (Flags & KEYCXX11)) return KS_Enabled;
Richard Smith6c74e322017-08-13 21:32:33 +0000139 if (LangOpts.CPlusPlus2a && (Flags & KEYCXX2A)) return KS_Enabled;
Serge Pavlov77af3812014-10-29 10:59:18 +0000140 if (LangOpts.C99 && (Flags & KEYC99)) return KS_Enabled;
141 if (LangOpts.GNUKeywords && (Flags & KEYGNU)) return KS_Extension;
142 if (LangOpts.MicrosoftExt && (Flags & KEYMS)) return KS_Extension;
143 if (LangOpts.Borland && (Flags & KEYBORLAND)) return KS_Extension;
144 if (LangOpts.Bool && (Flags & BOOLSUPPORT)) return KS_Enabled;
145 if (LangOpts.Half && (Flags & HALFSUPPORT)) return KS_Enabled;
146 if (LangOpts.WChar && (Flags & WCHARSUPPORT)) return KS_Enabled;
147 if (LangOpts.AltiVec && (Flags & KEYALTIVEC)) return KS_Enabled;
148 if (LangOpts.OpenCL && (Flags & KEYOPENCL)) return KS_Enabled;
149 if (!LangOpts.CPlusPlus && (Flags & KEYNOCXX)) return KS_Enabled;
150 if (LangOpts.C11 && (Flags & KEYC11)) return KS_Enabled;
151 // We treat bridge casts as objective-C keywords so we can warn on them
152 // in non-arc mode.
153 if (LangOpts.ObjC2 && (Flags & KEYARC)) return KS_Enabled;
Douglas Gregorab209d82015-07-07 03:58:42 +0000154 if (LangOpts.ObjC2 && (Flags & KEYOBJC2)) return KS_Enabled;
Richard Smithc7bf3802016-07-23 02:32:21 +0000155 if (LangOpts.ConceptsTS && (Flags & KEYCONCEPTS)) return KS_Enabled;
Gor Nishanov4ffb4342016-10-02 03:31:58 +0000156 if (LangOpts.CoroutinesTS && (Flags & KEYCOROUTINES)) return KS_Enabled;
Richard Smithc7bf3802016-07-23 02:32:21 +0000157 if (LangOpts.ModulesTS && (Flags & KEYMODULES)) return KS_Enabled;
Richard Smith6c74e322017-08-13 21:32:33 +0000158 if (LangOpts.CPlusPlus && (Flags & KEYALLCXX)) return KS_Future;
Serge Pavlov77af3812014-10-29 10:59:18 +0000159 return KS_Disabled;
Eli Friedman2b680b42009-04-28 03:13:54 +0000160}
161
Chris Lattner25e0d542006-10-18 06:07:05 +0000162/// AddKeyword - This method is used to associate a token ID with specific
163/// identifiers because they are language keywords. This causes the lexer to
164/// automatically map matching identifiers to specialized token codes.
Chris Lattner0e62c1c2011-07-23 10:55:15 +0000165static void AddKeyword(StringRef Keyword,
Eli Friedman2b680b42009-04-28 03:13:54 +0000166 tok::TokenKind TokenCode, unsigned Flags,
Chris Lattner25e0d542006-10-18 06:07:05 +0000167 const LangOptions &LangOpts, IdentifierTable &Table) {
Serge Pavlov83cf0782014-12-11 12:18:08 +0000168 KeywordStatus AddResult = getKeywordStatus(LangOpts, Flags);
Richard Smith4dd85d62011-10-11 19:57:52 +0000169
Alp Tokerbfa39342014-01-14 12:51:41 +0000170 // Don't add this keyword under MSVCCompat.
David Majnemer28aae9c2015-03-18 04:15:23 +0000171 if (LangOpts.MSVCCompat && (Flags & KEYNOMS18) &&
David Majnemerb710a932015-05-11 03:57:49 +0000172 !LangOpts.isCompatibleWithMSVC(LangOptions::MSVC2015))
Anastasia Stulovab1152f12015-03-18 12:55:29 +0000173 return;
174
175 // Don't add this keyword under OpenCL.
176 if (LangOpts.OpenCL && (Flags & KEYNOOPENCL))
177 return;
178
Eli Friedman2b680b42009-04-28 03:13:54 +0000179 // Don't add this keyword if disabled in this language.
Serge Pavlov77af3812014-10-29 10:59:18 +0000180 if (AddResult == KS_Disabled) return;
Eli Friedman2b680b42009-04-28 03:13:54 +0000181
Richard Smith4dd85d62011-10-11 19:57:52 +0000182 IdentifierInfo &Info =
Serge Pavlov77af3812014-10-29 10:59:18 +0000183 Table.get(Keyword, AddResult == KS_Future ? tok::identifier : TokenCode);
184 Info.setIsExtensionToken(AddResult == KS_Extension);
Richard Smith31d51842015-05-14 04:00:59 +0000185 Info.setIsFutureCompatKeyword(AddResult == KS_Future);
Chris Lattner25e0d542006-10-18 06:07:05 +0000186}
187
Chris Lattner5b9f4892006-11-21 17:23:33 +0000188/// AddCXXOperatorKeyword - Register a C++ operator keyword alternative
189/// representations.
Chris Lattner0e62c1c2011-07-23 10:55:15 +0000190static void AddCXXOperatorKeyword(StringRef Keyword,
Chris Lattner5b9f4892006-11-21 17:23:33 +0000191 tok::TokenKind TokenCode,
192 IdentifierTable &Table) {
Argyrios Kyrtzidis3084a612010-08-11 22:55:12 +0000193 IdentifierInfo &Info = Table.get(Keyword, TokenCode);
Ted Kremenekf25f4a32007-10-23 22:18:37 +0000194 Info.setIsCPlusPlusOperatorKeyword();
Chris Lattner5b9f4892006-11-21 17:23:33 +0000195}
196
James Dennett0d8a3f82012-06-15 21:27:44 +0000197/// AddObjCKeyword - Register an Objective-C \@keyword like "class" "selector"
198/// or "property".
Chris Lattner0e62c1c2011-07-23 10:55:15 +0000199static void AddObjCKeyword(StringRef Name,
Kovarththanan Rajaratnam00682a42010-03-12 11:27:37 +0000200 tok::ObjCKeywordKind ObjCID,
Chris Lattner25e0d542006-10-18 06:07:05 +0000201 IdentifierTable &Table) {
Kovarththanan Rajaratnam00682a42010-03-12 11:27:37 +0000202 Table.get(Name).setObjCKeywordID(ObjCID);
Chris Lattner25e0d542006-10-18 06:07:05 +0000203}
204
205/// AddKeywords - Add all keywords to the symbol table.
206///
207void IdentifierTable::AddKeywords(const LangOptions &LangOpts) {
Chris Lattner25e0d542006-10-18 06:07:05 +0000208 // Add keywords and tokens for the current language.
209#define KEYWORD(NAME, FLAGS) \
Chris Lattner0e62c1c2011-07-23 10:55:15 +0000210 AddKeyword(StringRef(#NAME), tok::kw_ ## NAME, \
Eli Friedman2b680b42009-04-28 03:13:54 +0000211 FLAGS, LangOpts, *this);
212#define ALIAS(NAME, TOK, FLAGS) \
Chris Lattner0e62c1c2011-07-23 10:55:15 +0000213 AddKeyword(StringRef(NAME), tok::kw_ ## TOK, \
Eli Friedman2b680b42009-04-28 03:13:54 +0000214 FLAGS, LangOpts, *this);
Chris Lattner5b9f4892006-11-21 17:23:33 +0000215#define CXX_KEYWORD_OPERATOR(NAME, ALIAS) \
Chris Lattner3e7592e2006-12-04 07:48:37 +0000216 if (LangOpts.CXXOperatorNames) \
Chris Lattner0e62c1c2011-07-23 10:55:15 +0000217 AddCXXOperatorKeyword(StringRef(#NAME), tok::ALIAS, *this);
Chris Lattner25e0d542006-10-18 06:07:05 +0000218#define OBJC1_AT_KEYWORD(NAME) \
219 if (LangOpts.ObjC1) \
Chris Lattner0e62c1c2011-07-23 10:55:15 +0000220 AddObjCKeyword(StringRef(#NAME), tok::objc_##NAME, *this);
Chris Lattner25e0d542006-10-18 06:07:05 +0000221#define OBJC2_AT_KEYWORD(NAME) \
222 if (LangOpts.ObjC2) \
Chris Lattner0e62c1c2011-07-23 10:55:15 +0000223 AddObjCKeyword(StringRef(#NAME), tok::objc_##NAME, *this);
John McCall39439732011-04-09 22:50:59 +0000224#define TESTING_KEYWORD(NAME, FLAGS)
Chris Lattner25e0d542006-10-18 06:07:05 +0000225#include "clang/Basic/TokenKinds.def"
John McCall39439732011-04-09 22:50:59 +0000226
227 if (LangOpts.ParseUnknownAnytype)
228 AddKeyword("__unknown_anytype", tok::kw___unknown_anytype, KEYALL,
229 LangOpts, *this);
Aaron Ballman674cf262015-05-26 19:44:52 +0000230
Saleem Abdulrasoold170c4b2015-10-04 17:51:05 +0000231 if (LangOpts.DeclSpecKeyword)
Aaron Ballman674cf262015-05-26 19:44:52 +0000232 AddKeyword("__declspec", tok::kw___declspec, KEYALL, LangOpts, *this);
Chris Lattner25e0d542006-10-18 06:07:05 +0000233}
234
Serge Pavlov83cf0782014-12-11 12:18:08 +0000235/// \brief Checks if the specified token kind represents a keyword in the
236/// specified language.
237/// \returns Status of the keyword in the language.
238static KeywordStatus getTokenKwStatus(const LangOptions &LangOpts,
239 tok::TokenKind K) {
240 switch (K) {
241#define KEYWORD(NAME, FLAGS) \
242 case tok::kw_##NAME: return getKeywordStatus(LangOpts, FLAGS);
243#include "clang/Basic/TokenKinds.def"
244 default: return KS_Disabled;
245 }
246}
247
248/// \brief Returns true if the identifier represents a keyword in the
249/// specified language.
Alex Lorenzf1278212017-04-11 15:01:53 +0000250bool IdentifierInfo::isKeyword(const LangOptions &LangOpts) const {
Serge Pavlov83cf0782014-12-11 12:18:08 +0000251 switch (getTokenKwStatus(LangOpts, getTokenID())) {
252 case KS_Enabled:
253 case KS_Extension:
254 return true;
255 default:
256 return false;
257 }
258}
259
Alex Lorenzf1278212017-04-11 15:01:53 +0000260/// \brief Returns true if the identifier represents a C++ keyword in the
261/// specified language.
262bool IdentifierInfo::isCPlusPlusKeyword(const LangOptions &LangOpts) const {
263 if (!LangOpts.CPlusPlus || !isKeyword(LangOpts))
264 return false;
265 // This is a C++ keyword if this identifier is not a keyword when checked
266 // using LangOptions without C++ support.
267 LangOptions LangOptsNoCPP = LangOpts;
268 LangOptsNoCPP.CPlusPlus = false;
269 LangOptsNoCPP.CPlusPlus11 = false;
Richard Smith6c74e322017-08-13 21:32:33 +0000270 LangOptsNoCPP.CPlusPlus2a = false;
Alex Lorenzf1278212017-04-11 15:01:53 +0000271 return !isKeyword(LangOptsNoCPP);
272}
273
Chris Lattnerff067ce2007-10-07 07:52:34 +0000274tok::PPKeywordKind IdentifierInfo::getPPKeywordID() const {
275 // We use a perfect hash function here involving the length of the keyword,
276 // the first and third character. For preprocessor ID's there are no
277 // collisions (if there were, the switch below would complain about duplicate
278 // case values). Note that this depends on 'if' being null terminated.
Mike Stump11289f42009-09-09 15:08:12 +0000279
Chris Lattnerff067ce2007-10-07 07:52:34 +0000280#define HASH(LEN, FIRST, THIRD) \
281 (LEN << 5) + (((FIRST-'a') + (THIRD-'a')) & 31)
282#define CASE(LEN, FIRST, THIRD, NAME) \
283 case HASH(LEN, FIRST, THIRD): \
284 return memcmp(Name, #NAME, LEN) ? tok::pp_not_keyword : tok::pp_ ## NAME
Mike Stump11289f42009-09-09 15:08:12 +0000285
Chris Lattnerff067ce2007-10-07 07:52:34 +0000286 unsigned Len = getLength();
Chris Lattnerd2b8ce42007-10-10 20:59:57 +0000287 if (Len < 2) return tok::pp_not_keyword;
Daniel Dunbar1c0761d2009-10-17 18:13:02 +0000288 const char *Name = getNameStart();
Chris Lattnerff067ce2007-10-07 07:52:34 +0000289 switch (HASH(Len, Name[0], Name[2])) {
290 default: return tok::pp_not_keyword;
291 CASE( 2, 'i', '\0', if);
292 CASE( 4, 'e', 'i', elif);
293 CASE( 4, 'e', 's', else);
294 CASE( 4, 'l', 'n', line);
295 CASE( 4, 's', 'c', sccs);
296 CASE( 5, 'e', 'd', endif);
297 CASE( 5, 'e', 'r', error);
298 CASE( 5, 'i', 'e', ident);
299 CASE( 5, 'i', 'd', ifdef);
300 CASE( 5, 'u', 'd', undef);
301
302 CASE( 6, 'a', 's', assert);
303 CASE( 6, 'd', 'f', define);
304 CASE( 6, 'i', 'n', ifndef);
305 CASE( 6, 'i', 'p', import);
306 CASE( 6, 'p', 'a', pragma);
Douglas Gregor0bf886d2012-01-03 18:24:14 +0000307
Chris Lattnerff067ce2007-10-07 07:52:34 +0000308 CASE( 7, 'd', 'f', defined);
309 CASE( 7, 'i', 'c', include);
310 CASE( 7, 'w', 'r', warning);
311
312 CASE( 8, 'u', 'a', unassert);
313 CASE(12, 'i', 'c', include_next);
Mike Stump11289f42009-09-09 15:08:12 +0000314
Douglas Gregor663b48f2012-01-03 19:48:16 +0000315 CASE(14, '_', 'p', __public_macro);
316
317 CASE(15, '_', 'p', __private_macro);
318
Chris Lattner14a7f392009-04-08 18:24:34 +0000319 CASE(16, '_', 'i', __include_macros);
Chris Lattnerff067ce2007-10-07 07:52:34 +0000320#undef CASE
321#undef HASH
322 }
323}
Chris Lattner25e0d542006-10-18 06:07:05 +0000324
325//===----------------------------------------------------------------------===//
326// Stats Implementation
327//===----------------------------------------------------------------------===//
328
Chris Lattner22eb9722006-06-18 05:43:12 +0000329/// PrintStats - Print statistics about how well the identifier table is doing
330/// at hashing identifiers.
331void IdentifierTable::PrintStats() const {
Chris Lattner2b9e19b2006-10-29 23:43:13 +0000332 unsigned NumBuckets = HashTable.getNumBuckets();
333 unsigned NumIdentifiers = HashTable.getNumItems();
334 unsigned NumEmptyBuckets = NumBuckets-NumIdentifiers;
Chris Lattner22eb9722006-06-18 05:43:12 +0000335 unsigned AverageIdentifierSize = 0;
336 unsigned MaxIdentifierLength = 0;
Mike Stump11289f42009-09-09 15:08:12 +0000337
Chris Lattner2b9e19b2006-10-29 23:43:13 +0000338 // TODO: Figure out maximum times an identifier had to probe for -stats.
Ted Kremenek52f73ca2009-01-20 23:28:34 +0000339 for (llvm::StringMap<IdentifierInfo*, llvm::BumpPtrAllocator>::const_iterator
Chris Lattnerb055f2d2007-02-11 08:19:57 +0000340 I = HashTable.begin(), E = HashTable.end(); I != E; ++I) {
341 unsigned IdLen = I->getKeyLength();
342 AverageIdentifierSize += IdLen;
343 if (MaxIdentifierLength < IdLen)
344 MaxIdentifierLength = IdLen;
345 }
Mike Stump11289f42009-09-09 15:08:12 +0000346
Chris Lattner23b7eb62007-06-15 23:05:46 +0000347 fprintf(stderr, "\n*** Identifier Table Stats:\n");
348 fprintf(stderr, "# Identifiers: %d\n", NumIdentifiers);
349 fprintf(stderr, "# Empty Buckets: %d\n", NumEmptyBuckets);
350 fprintf(stderr, "Hash density (#identifiers per bucket): %f\n",
351 NumIdentifiers/(double)NumBuckets);
352 fprintf(stderr, "Ave identifier length: %f\n",
353 (AverageIdentifierSize/(double)NumIdentifiers));
354 fprintf(stderr, "Max identifier length: %d\n", MaxIdentifierLength);
Mike Stump11289f42009-09-09 15:08:12 +0000355
Chris Lattner22eb9722006-06-18 05:43:12 +0000356 // Compute statistics about the memory allocated for identifiers.
Chris Lattner2b9e19b2006-10-29 23:43:13 +0000357 HashTable.getAllocator().PrintStats();
Chris Lattner22eb9722006-06-18 05:43:12 +0000358}
Steve Narofff73590d2007-09-27 14:38:14 +0000359
Steve Naroffe61bfa82007-10-05 18:42:47 +0000360//===----------------------------------------------------------------------===//
361// SelectorTable Implementation
362//===----------------------------------------------------------------------===//
363
Chris Lattnerdadc7622007-10-05 20:15:24 +0000364unsigned llvm::DenseMapInfo<clang::Selector>::getHashValue(clang::Selector S) {
365 return DenseMapInfo<void*>::getHashValue(S.getAsOpaquePtr());
366}
367
Douglas Gregor77324f32008-11-17 14:58:09 +0000368namespace clang {
Steve Naroffe61bfa82007-10-05 18:42:47 +0000369/// MultiKeywordSelector - One of these variable length records is kept for each
370/// selector containing more than one keyword. We use a folding set
Mike Stump11289f42009-09-09 15:08:12 +0000371/// to unique aggregate names (keyword selectors in ObjC parlance). Access to
Steve Naroffe61bfa82007-10-05 18:42:47 +0000372/// this class is provided strictly through Selector.
Mike Stump11289f42009-09-09 15:08:12 +0000373class MultiKeywordSelector
Douglas Gregor77324f32008-11-17 14:58:09 +0000374 : public DeclarationNameExtra, public llvm::FoldingSetNode {
Douglas Gregor77324f32008-11-17 14:58:09 +0000375 MultiKeywordSelector(unsigned nKeys) {
376 ExtraKindOrNumArgs = NUM_EXTRA_KINDS + nKeys;
377 }
Mike Stump11289f42009-09-09 15:08:12 +0000378public:
Steve Naroffe61bfa82007-10-05 18:42:47 +0000379 // Constructor for keyword selectors.
380 MultiKeywordSelector(unsigned nKeys, IdentifierInfo **IIV) {
381 assert((nKeys > 1) && "not a multi-keyword selector");
Douglas Gregor77324f32008-11-17 14:58:09 +0000382 ExtraKindOrNumArgs = NUM_EXTRA_KINDS + nKeys;
Mike Stump11289f42009-09-09 15:08:12 +0000383
Steve Naroffe61bfa82007-10-05 18:42:47 +0000384 // Fill in the trailing keyword array.
385 IdentifierInfo **KeyInfo = reinterpret_cast<IdentifierInfo **>(this+1);
386 for (unsigned i = 0; i != nKeys; ++i)
387 KeyInfo[i] = IIV[i];
Mike Stump11289f42009-09-09 15:08:12 +0000388 }
389
Chris Lattnerf7f34d02007-10-07 01:33:16 +0000390 // getName - Derive the full selector name and return it.
391 std::string getName() const;
Mike Stump11289f42009-09-09 15:08:12 +0000392
Douglas Gregor77324f32008-11-17 14:58:09 +0000393 unsigned getNumArgs() const { return ExtraKindOrNumArgs - NUM_EXTRA_KINDS; }
Mike Stump11289f42009-09-09 15:08:12 +0000394
Steve Naroffe61bfa82007-10-05 18:42:47 +0000395 typedef IdentifierInfo *const *keyword_iterator;
396 keyword_iterator keyword_begin() const {
397 return reinterpret_cast<keyword_iterator>(this+1);
398 }
Mike Stump11289f42009-09-09 15:08:12 +0000399 keyword_iterator keyword_end() const {
400 return keyword_begin()+getNumArgs();
Steve Naroffe61bfa82007-10-05 18:42:47 +0000401 }
Chris Lattnerf7f34d02007-10-07 01:33:16 +0000402 IdentifierInfo *getIdentifierInfoForSlot(unsigned i) const {
Douglas Gregor77324f32008-11-17 14:58:09 +0000403 assert(i < getNumArgs() && "getIdentifierInfoForSlot(): illegal index");
Steve Naroffe61bfa82007-10-05 18:42:47 +0000404 return keyword_begin()[i];
405 }
Mike Stump11289f42009-09-09 15:08:12 +0000406 static void Profile(llvm::FoldingSetNodeID &ID,
Steve Naroffe61bfa82007-10-05 18:42:47 +0000407 keyword_iterator ArgTys, unsigned NumArgs) {
408 ID.AddInteger(NumArgs);
Chris Lattnerf7f34d02007-10-07 01:33:16 +0000409 for (unsigned i = 0; i != NumArgs; ++i)
410 ID.AddPointer(ArgTys[i]);
Steve Naroffe61bfa82007-10-05 18:42:47 +0000411 }
412 void Profile(llvm::FoldingSetNodeID &ID) {
Douglas Gregor77324f32008-11-17 14:58:09 +0000413 Profile(ID, keyword_begin(), getNumArgs());
Steve Naroffe61bfa82007-10-05 18:42:47 +0000414 }
415};
Chris Lattnerdadc7622007-10-05 20:15:24 +0000416} // end namespace clang.
Steve Naroffe61bfa82007-10-05 18:42:47 +0000417
418unsigned Selector::getNumArgs() const {
419 unsigned IIF = getIdentifierInfoFlag();
Douglas Gregor93a586f2012-05-04 18:24:37 +0000420 if (IIF <= ZeroArg)
Steve Naroffe61bfa82007-10-05 18:42:47 +0000421 return 0;
422 if (IIF == OneArg)
423 return 1;
Douglas Gregor93a586f2012-05-04 18:24:37 +0000424 // We point to a MultiKeywordSelector.
425 MultiKeywordSelector *SI = getMultiKeywordSelector();
Mike Stump11289f42009-09-09 15:08:12 +0000426 return SI->getNumArgs();
Steve Naroffe61bfa82007-10-05 18:42:47 +0000427}
428
Chris Lattnerf7f34d02007-10-07 01:33:16 +0000429IdentifierInfo *Selector::getIdentifierInfoForSlot(unsigned argIndex) const {
Douglas Gregor93a586f2012-05-04 18:24:37 +0000430 if (getIdentifierInfoFlag() < MultiArg) {
Chris Lattnerf7f34d02007-10-07 01:33:16 +0000431 assert(argIndex == 0 && "illegal keyword index");
Douglas Gregor70091b82009-04-26 22:20:50 +0000432 return getAsIdentifierInfo();
Steve Naroffe61bfa82007-10-05 18:42:47 +0000433 }
Douglas Gregor93a586f2012-05-04 18:24:37 +0000434 // We point to a MultiKeywordSelector.
435 MultiKeywordSelector *SI = getMultiKeywordSelector();
Steve Naroffe61bfa82007-10-05 18:42:47 +0000436 return SI->getIdentifierInfoForSlot(argIndex);
437}
438
Chris Lattner0e62c1c2011-07-23 10:55:15 +0000439StringRef Selector::getNameForSlot(unsigned int argIndex) const {
Douglas Gregoraf2a6ae2011-02-18 22:29:55 +0000440 IdentifierInfo *II = getIdentifierInfoForSlot(argIndex);
Chris Lattner0e62c1c2011-07-23 10:55:15 +0000441 return II? II->getName() : StringRef();
Douglas Gregoraf2a6ae2011-02-18 22:29:55 +0000442}
443
Chris Lattnerf7f34d02007-10-07 01:33:16 +0000444std::string MultiKeywordSelector::getName() const {
Dylan Noblesmith2c1dd272012-02-05 02:13:05 +0000445 SmallString<256> Str;
Daniel Dunbar1c0761d2009-10-17 18:13:02 +0000446 llvm::raw_svector_ostream OS(Str);
Chris Lattnerf7f34d02007-10-07 01:33:16 +0000447 for (keyword_iterator I = keyword_begin(), E = keyword_end(); I != E; ++I) {
448 if (*I)
Daniel Dunbar07d07852009-10-18 21:17:35 +0000449 OS << (*I)->getName();
Daniel Dunbar1c0761d2009-10-17 18:13:02 +0000450 OS << ':';
Steve Naroffe61bfa82007-10-05 18:42:47 +0000451 }
Mike Stump11289f42009-09-09 15:08:12 +0000452
Daniel Dunbar1c0761d2009-10-17 18:13:02 +0000453 return OS.str();
Steve Naroffe61bfa82007-10-05 18:42:47 +0000454}
455
Chris Lattnere4b95692008-11-24 03:33:13 +0000456std::string Selector::getAsString() const {
Douglas Gregor70091b82009-04-26 22:20:50 +0000457 if (InfoPtr == 0)
458 return "<null selector>";
459
Douglas Gregor93a586f2012-05-04 18:24:37 +0000460 if (getIdentifierInfoFlag() < MultiArg) {
Ted Kremenek5f080b42009-03-06 23:36:28 +0000461 IdentifierInfo *II = getAsIdentifierInfo();
Mike Stump11289f42009-09-09 15:08:12 +0000462
Chandler Carruth59666772016-11-04 06:32:57 +0000463 if (getNumArgs() == 0) {
464 assert(II && "If the number of arguments is 0 then II is guaranteed to "
465 "not be null.");
Daniel Dunbar07d07852009-10-18 21:17:35 +0000466 return II->getName();
Chandler Carruth59666772016-11-04 06:32:57 +0000467 }
Ted Kremenek5f080b42009-03-06 23:36:28 +0000468
Daniel Dunbar1c0761d2009-10-17 18:13:02 +0000469 if (!II)
470 return ":";
471
Daniel Dunbar07d07852009-10-18 21:17:35 +0000472 return II->getName().str() + ":";
Steve Naroffe61bfa82007-10-05 18:42:47 +0000473 }
Mike Stump11289f42009-09-09 15:08:12 +0000474
Douglas Gregor93a586f2012-05-04 18:24:37 +0000475 // We have a multiple keyword selector.
476 return getMultiKeywordSelector()->getName();
Steve Naroffe61bfa82007-10-05 18:42:47 +0000477}
478
Aaron Ballmanb190f972014-01-03 17:59:55 +0000479void Selector::print(llvm::raw_ostream &OS) const {
480 OS << getAsString();
481}
482
John McCallb4526252011-03-02 01:50:55 +0000483/// Interpreting the given string using the normal CamelCase
484/// conventions, determine whether the given string starts with the
485/// given "word", which is assumed to end in a lowercase letter.
Chris Lattner0e62c1c2011-07-23 10:55:15 +0000486static bool startsWithWord(StringRef name, StringRef word) {
John McCallb4526252011-03-02 01:50:55 +0000487 if (name.size() < word.size()) return false;
Jordan Rosea7d03842013-02-08 22:30:41 +0000488 return ((name.size() == word.size() || !isLowercase(name[word.size()])) &&
489 name.startswith(word));
John McCallb4526252011-03-02 01:50:55 +0000490}
491
492ObjCMethodFamily Selector::getMethodFamilyImpl(Selector sel) {
493 IdentifierInfo *first = sel.getIdentifierInfoForSlot(0);
494 if (!first) return OMF_None;
495
Chris Lattner0e62c1c2011-07-23 10:55:15 +0000496 StringRef name = first->getName();
John McCallb4526252011-03-02 01:50:55 +0000497 if (sel.isUnarySelector()) {
498 if (name == "autorelease") return OMF_autorelease;
499 if (name == "dealloc") return OMF_dealloc;
Nico Weber1fb82662011-08-28 22:35:17 +0000500 if (name == "finalize") return OMF_finalize;
John McCallb4526252011-03-02 01:50:55 +0000501 if (name == "release") return OMF_release;
502 if (name == "retain") return OMF_retain;
503 if (name == "retainCount") return OMF_retainCount;
Douglas Gregor33823722011-06-11 01:09:30 +0000504 if (name == "self") return OMF_self;
Fariborz Jahanian78e9deb2014-08-22 16:57:26 +0000505 if (name == "initialize") return OMF_initialize;
John McCallb4526252011-03-02 01:50:55 +0000506 }
Alex Lorenz0e23c612017-03-06 15:58:34 +0000507
508 if (name == "performSelector" || name == "performSelectorInBackground" ||
509 name == "performSelectorOnMainThread")
510 return OMF_performSelector;
John McCallb4526252011-03-02 01:50:55 +0000511
512 // The other method families may begin with a prefix of underscores.
513 while (!name.empty() && name.front() == '_')
514 name = name.substr(1);
515
516 if (name.empty()) return OMF_None;
517 switch (name.front()) {
518 case 'a':
519 if (startsWithWord(name, "alloc")) return OMF_alloc;
520 break;
521 case 'c':
522 if (startsWithWord(name, "copy")) return OMF_copy;
523 break;
524 case 'i':
525 if (startsWithWord(name, "init")) return OMF_init;
526 break;
527 case 'm':
528 if (startsWithWord(name, "mutableCopy")) return OMF_mutableCopy;
529 break;
530 case 'n':
531 if (startsWithWord(name, "new")) return OMF_new;
532 break;
533 default:
534 break;
535 }
536
537 return OMF_None;
538}
Steve Naroffe61bfa82007-10-05 18:42:47 +0000539
Fariborz Jahanian71221352013-07-23 22:42:28 +0000540ObjCInstanceTypeFamily Selector::getInstTypeMethodFamily(Selector sel) {
Fariborz Jahanian4f3a64f2013-07-23 19:31:17 +0000541 IdentifierInfo *first = sel.getIdentifierInfoForSlot(0);
542 if (!first) return OIT_None;
543
544 StringRef name = first->getName();
545
546 if (name.empty()) return OIT_None;
547 switch (name.front()) {
548 case 'a':
Fariborz Jahanian4ccdc732013-08-29 16:22:26 +0000549 if (startsWithWord(name, "array")) return OIT_Array;
Fariborz Jahanian4f3a64f2013-07-23 19:31:17 +0000550 break;
551 case 'd':
Fariborz Jahanian7c87b432013-10-10 18:23:13 +0000552 if (startsWithWord(name, "default")) return OIT_ReturnsSelf;
Fariborz Jahanian4f3a64f2013-07-23 19:31:17 +0000553 if (startsWithWord(name, "dictionary")) return OIT_Dictionary;
554 break;
Fariborz Jahanian9275c682013-08-02 20:54:18 +0000555 case 's':
Fariborz Jahanian7c87b432013-10-10 18:23:13 +0000556 if (startsWithWord(name, "shared")) return OIT_ReturnsSelf;
557 if (startsWithWord(name, "standard")) return OIT_Singleton;
Galina Kistanovaddcd2812017-06-03 06:40:10 +0000558 break;
Fariborz Jahanian1c900bc2013-09-18 20:35:47 +0000559 case 'i':
560 if (startsWithWord(name, "init")) return OIT_Init;
Fariborz Jahanian4f3a64f2013-07-23 19:31:17 +0000561 default:
562 break;
563 }
564 return OIT_None;
565}
566
Fariborz Jahanian6485fe42014-09-09 23:10:54 +0000567ObjCStringFormatFamily Selector::getStringFormatFamilyImpl(Selector sel) {
568 IdentifierInfo *first = sel.getIdentifierInfoForSlot(0);
569 if (!first) return SFF_None;
570
571 StringRef name = first->getName();
572
573 switch (name.front()) {
574 case 'a':
575 if (name == "appendFormat") return SFF_NSString;
576 break;
577
578 case 'i':
579 if (name == "initWithFormat") return SFF_NSString;
580 break;
581
582 case 'l':
583 if (name == "localizedStringWithFormat") return SFF_NSString;
584 break;
585
586 case 's':
587 if (name == "stringByAppendingFormat" ||
588 name == "stringWithFormat") return SFF_NSString;
589 break;
590 }
591 return SFF_None;
592}
593
Chris Lattner1a849942009-03-04 05:35:38 +0000594namespace {
595 struct SelectorTableImpl {
596 llvm::FoldingSet<MultiKeywordSelector> Table;
597 llvm::BumpPtrAllocator Allocator;
598 };
599} // end anonymous namespace.
600
601static SelectorTableImpl &getSelectorTableImpl(void *P) {
602 return *static_cast<SelectorTableImpl*>(P);
603}
604
Adrian Prantl6e77c962013-06-10 21:36:55 +0000605SmallString<64>
Adrian Prantla4ce9062013-06-07 22:29:12 +0000606SelectorTable::constructSetterName(StringRef Name) {
Adrian Prantl6e77c962013-06-10 21:36:55 +0000607 SmallString<64> SetterName("set");
608 SetterName += Name;
609 SetterName[3] = toUppercase(SetterName[3]);
610 return SetterName;
Adrian Prantla4ce9062013-06-07 22:29:12 +0000611}
612
Adrian Prantl6e77c962013-06-10 21:36:55 +0000613Selector
Adrian Prantla4ce9062013-06-07 22:29:12 +0000614SelectorTable::constructSetterSelector(IdentifierTable &Idents,
615 SelectorTable &SelTable,
616 const IdentifierInfo *Name) {
617 IdentifierInfo *SetterName =
618 &Idents.get(constructSetterName(Name->getName()));
Benjamin Kramer49038022012-02-04 13:45:25 +0000619 return SelTable.getUnarySelector(SetterName);
620}
621
Ted Kremenek1c2239e2011-04-18 22:47:04 +0000622size_t SelectorTable::getTotalMemory() const {
623 SelectorTableImpl &SelTabImpl = getSelectorTableImpl(Impl);
624 return SelTabImpl.Allocator.getTotalMemory();
625}
Chris Lattner1a849942009-03-04 05:35:38 +0000626
Chris Lattner5700fab2007-10-07 02:00:24 +0000627Selector SelectorTable::getSelector(unsigned nKeys, IdentifierInfo **IIV) {
628 if (nKeys < 2)
629 return Selector(IIV[0], nKeys);
Mike Stump11289f42009-09-09 15:08:12 +0000630
Chris Lattner1a849942009-03-04 05:35:38 +0000631 SelectorTableImpl &SelTabImpl = getSelectorTableImpl(Impl);
Mike Stump11289f42009-09-09 15:08:12 +0000632
Steve Naroffe61bfa82007-10-05 18:42:47 +0000633 // Unique selector, to guarantee there is one per name.
634 llvm::FoldingSetNodeID ID;
635 MultiKeywordSelector::Profile(ID, IIV, nKeys);
636
Craig Topperf1186c52014-05-08 06:41:40 +0000637 void *InsertPos = nullptr;
Chris Lattner1a849942009-03-04 05:35:38 +0000638 if (MultiKeywordSelector *SI =
639 SelTabImpl.Table.FindNodeOrInsertPos(ID, InsertPos))
Steve Naroffe61bfa82007-10-05 18:42:47 +0000640 return Selector(SI);
Mike Stump11289f42009-09-09 15:08:12 +0000641
Steve Naroffe61bfa82007-10-05 18:42:47 +0000642 // MultiKeywordSelector objects are not allocated with new because they have a
643 // variable size array (for parameter types) at the end of them.
Chris Lattner1a849942009-03-04 05:35:38 +0000644 unsigned Size = sizeof(MultiKeywordSelector) + nKeys*sizeof(IdentifierInfo *);
645 MultiKeywordSelector *SI =
Benjamin Kramerc3f89252016-10-20 14:27:22 +0000646 (MultiKeywordSelector *)SelTabImpl.Allocator.Allocate(
647 Size, alignof(MultiKeywordSelector));
Steve Naroffe61bfa82007-10-05 18:42:47 +0000648 new (SI) MultiKeywordSelector(nKeys, IIV);
Chris Lattner1a849942009-03-04 05:35:38 +0000649 SelTabImpl.Table.InsertNode(SI, InsertPos);
Steve Naroffe61bfa82007-10-05 18:42:47 +0000650 return Selector(SI);
651}
652
Steve Naroffe61bfa82007-10-05 18:42:47 +0000653SelectorTable::SelectorTable() {
Chris Lattner1a849942009-03-04 05:35:38 +0000654 Impl = new SelectorTableImpl();
Steve Naroffe61bfa82007-10-05 18:42:47 +0000655}
656
657SelectorTable::~SelectorTable() {
Chris Lattner1a849942009-03-04 05:35:38 +0000658 delete &getSelectorTableImpl(Impl);
Steve Naroffe61bfa82007-10-05 18:42:47 +0000659}
660
Douglas Gregor71395fa2009-11-04 00:56:37 +0000661const char *clang::getOperatorSpelling(OverloadedOperatorKind Operator) {
662 switch (Operator) {
663 case OO_None:
664 case NUM_OVERLOADED_OPERATORS:
Craig Topperf1186c52014-05-08 06:41:40 +0000665 return nullptr;
Kovarththanan Rajaratnam00682a42010-03-12 11:27:37 +0000666
Douglas Gregor71395fa2009-11-04 00:56:37 +0000667#define OVERLOADED_OPERATOR(Name,Spelling,Token,Unary,Binary,MemberOnly) \
668 case OO_##Name: return Spelling;
669#include "clang/Basic/OperatorKinds.def"
670 }
Kovarththanan Rajaratnam00682a42010-03-12 11:27:37 +0000671
David Blaikie8a40f702012-01-17 06:56:22 +0000672 llvm_unreachable("Invalid OverloadedOperatorKind!");
Douglas Gregor71395fa2009-11-04 00:56:37 +0000673}
Douglas Gregor813a0662015-06-19 18:14:38 +0000674
Douglas Gregoraea7afd2015-06-24 22:02:08 +0000675StringRef clang::getNullabilitySpelling(NullabilityKind kind,
676 bool isContextSensitive) {
Douglas Gregor813a0662015-06-19 18:14:38 +0000677 switch (kind) {
678 case NullabilityKind::NonNull:
Douglas Gregoraea7afd2015-06-24 22:02:08 +0000679 return isContextSensitive ? "nonnull" : "_Nonnull";
Douglas Gregor813a0662015-06-19 18:14:38 +0000680
681 case NullabilityKind::Nullable:
Douglas Gregoraea7afd2015-06-24 22:02:08 +0000682 return isContextSensitive ? "nullable" : "_Nullable";
Douglas Gregor813a0662015-06-19 18:14:38 +0000683
684 case NullabilityKind::Unspecified:
Douglas Gregoraea7afd2015-06-24 22:02:08 +0000685 return isContextSensitive ? "null_unspecified" : "_Null_unspecified";
Douglas Gregor813a0662015-06-19 18:14:38 +0000686 }
Nico Weber708aabd2015-06-20 00:06:30 +0000687 llvm_unreachable("Unknown nullability kind.");
Douglas Gregor813a0662015-06-19 18:14:38 +0000688}