xref: /llvm-project/clang/unittests/Format/TokenAnnotatorTest.cpp (revision 39e6077d97238ec13c9ed1b9dbae1e6408e5aba3)
1 //===- unittest/Format/TokenAnnotatorTest.cpp - Formatting unit tests -----===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 
9 #include "clang/Format/Format.h"
10 
11 #include "FormatTestUtils.h"
12 #include "TestLexer.h"
13 #include "gtest/gtest.h"
14 
15 namespace clang {
16 namespace format {
17 
18 // Not really the equality, but everything we need.
19 static bool operator==(const FormatToken &LHS,
20                        const FormatToken &RHS) noexcept {
21   return LHS.Tok.getKind() == RHS.Tok.getKind() &&
22          LHS.getType() == RHS.getType();
23 }
24 
25 namespace {
26 
27 class TokenAnnotatorTest : public ::testing::Test {
28 protected:
29   TokenList annotate(llvm::StringRef Code,
30                      const FormatStyle &Style = getLLVMStyle()) {
31     return TestLexer(Allocator, Buffers, Style).annotate(Code);
32   }
33   llvm::SpecificBumpPtrAllocator<FormatToken> Allocator;
34   std::vector<std::unique_ptr<llvm::MemoryBuffer>> Buffers;
35 };
36 
37 #define EXPECT_TOKEN_KIND(FormatTok, Kind)                                     \
38   EXPECT_EQ((FormatTok)->Tok.getKind(), Kind) << *(FormatTok)
39 #define EXPECT_TOKEN_TYPE(FormatTok, Type)                                     \
40   EXPECT_EQ((FormatTok)->getType(), Type) << *(FormatTok)
41 #define EXPECT_TOKEN_PRECEDENCE(FormatTok, Prec)                               \
42   EXPECT_EQ((FormatTok)->getPrecedence(), Prec) << *(FormatTok)
43 #define EXPECT_TOKEN(FormatTok, Kind, Type)                                    \
44   do {                                                                         \
45     EXPECT_TOKEN_KIND(FormatTok, Kind);                                        \
46     EXPECT_TOKEN_TYPE(FormatTok, Type);                                        \
47   } while (false)
48 
49 TEST_F(TokenAnnotatorTest, UnderstandsUsesOfStarAndAmp) {
50   auto Tokens = annotate("auto x = [](const decltype(x) &ptr) {};");
51   EXPECT_EQ(Tokens.size(), 18u) << Tokens;
52   EXPECT_TOKEN(Tokens[7], tok::kw_decltype, TT_Unknown);
53   EXPECT_TOKEN(Tokens[8], tok::l_paren, TT_TypeDeclarationParen);
54   EXPECT_TOKEN(Tokens[9], tok::identifier, TT_Unknown);
55   EXPECT_TOKEN(Tokens[10], tok::r_paren, TT_TypeDeclarationParen);
56   EXPECT_TOKEN(Tokens[11], tok::amp, TT_PointerOrReference);
57 
58   Tokens = annotate("auto x = [](const decltype(x) *ptr) {};");
59   EXPECT_EQ(Tokens.size(), 18u) << Tokens;
60   EXPECT_TOKEN(Tokens[10], tok::r_paren, TT_TypeDeclarationParen);
61   EXPECT_TOKEN(Tokens[11], tok::star, TT_PointerOrReference);
62 
63   Tokens = annotate("#define lambda [](const decltype(x) &ptr) {}");
64   EXPECT_EQ(Tokens.size(), 17u) << Tokens;
65   EXPECT_TOKEN(Tokens[7], tok::kw_decltype, TT_Unknown);
66   EXPECT_TOKEN(Tokens[8], tok::l_paren, TT_TypeDeclarationParen);
67   EXPECT_TOKEN(Tokens[9], tok::identifier, TT_Unknown);
68   EXPECT_TOKEN(Tokens[10], tok::r_paren, TT_TypeDeclarationParen);
69   EXPECT_TOKEN(Tokens[11], tok::amp, TT_PointerOrReference);
70 
71   Tokens = annotate("#define lambda [](const decltype(x) *ptr) {}");
72   EXPECT_EQ(Tokens.size(), 17u) << Tokens;
73   EXPECT_TOKEN(Tokens[10], tok::r_paren, TT_TypeDeclarationParen);
74   EXPECT_TOKEN(Tokens[11], tok::star, TT_PointerOrReference);
75 
76   Tokens = annotate("void f() {\n"
77                     "  while (p < a && *p == 'a')\n"
78                     "    p++;\n"
79                     "}");
80   EXPECT_EQ(Tokens.size(), 21u) << Tokens;
81   EXPECT_TOKEN(Tokens[10], tok::ampamp, TT_BinaryOperator);
82   EXPECT_TOKEN(Tokens[11], tok::star, TT_UnaryOperator);
83 
84   Tokens = annotate("case *x:");
85   EXPECT_EQ(Tokens.size(), 5u) << Tokens;
86   EXPECT_TOKEN(Tokens[1], tok::star, TT_UnaryOperator);
87   Tokens = annotate("case &x:");
88   EXPECT_EQ(Tokens.size(), 5u) << Tokens;
89   EXPECT_TOKEN(Tokens[1], tok::amp, TT_UnaryOperator);
90 
91   Tokens = annotate("bool b = 3 == int{3} && true;\n");
92   EXPECT_EQ(Tokens.size(), 13u) << Tokens;
93   EXPECT_TOKEN(Tokens[9], tok::ampamp, TT_BinaryOperator);
94 
95   Tokens = annotate("struct {\n"
96                     "} *ptr;");
97   EXPECT_EQ(Tokens.size(), 7u) << Tokens;
98   EXPECT_TOKEN(Tokens[3], tok::star, TT_PointerOrReference);
99   Tokens = annotate("union {\n"
100                     "} *ptr;");
101   EXPECT_EQ(Tokens.size(), 7u) << Tokens;
102   EXPECT_TOKEN(Tokens[3], tok::star, TT_PointerOrReference);
103   Tokens = annotate("class {\n"
104                     "} *ptr;");
105   EXPECT_EQ(Tokens.size(), 7u) << Tokens;
106   EXPECT_TOKEN(Tokens[3], tok::star, TT_PointerOrReference);
107 
108   Tokens = annotate("struct {\n"
109                     "} &&ptr = {};");
110   EXPECT_EQ(Tokens.size(), 10u) << Tokens;
111   EXPECT_TOKEN(Tokens[3], tok::ampamp, TT_PointerOrReference);
112   Tokens = annotate("union {\n"
113                     "} &&ptr = {};");
114   EXPECT_EQ(Tokens.size(), 10u) << Tokens;
115   EXPECT_TOKEN(Tokens[3], tok::ampamp, TT_PointerOrReference);
116   Tokens = annotate("class {\n"
117                     "} &&ptr = {};");
118   EXPECT_EQ(Tokens.size(), 10u) << Tokens;
119   EXPECT_TOKEN(Tokens[3], tok::ampamp, TT_PointerOrReference);
120   Tokens = annotate("int i = int{42} * 2;");
121   EXPECT_EQ(Tokens.size(), 11u) << Tokens;
122   EXPECT_TOKEN(Tokens[7], tok::star, TT_BinaryOperator);
123 
124   Tokens = annotate("delete[] *ptr;");
125   EXPECT_EQ(Tokens.size(), 7u) << Tokens;
126   EXPECT_TOKEN(Tokens[3], tok::star, TT_UnaryOperator);
127   Tokens = annotate("delete[] **ptr;");
128   EXPECT_EQ(Tokens.size(), 8u) << Tokens;
129   EXPECT_TOKEN(Tokens[3], tok::star, TT_UnaryOperator);
130   EXPECT_TOKEN(Tokens[4], tok::star, TT_UnaryOperator);
131   Tokens = annotate("delete[] *(ptr);");
132   EXPECT_EQ(Tokens.size(), 9u) << Tokens;
133   EXPECT_TOKEN(Tokens[3], tok::star, TT_UnaryOperator);
134 }
135 
136 TEST_F(TokenAnnotatorTest, UnderstandsUsesOfPlusAndMinus) {
137   auto Tokens = annotate("x - 0");
138   ASSERT_EQ(Tokens.size(), 4u) << Tokens;
139   EXPECT_TOKEN(Tokens[1], tok::minus, TT_BinaryOperator);
140   Tokens = annotate("0 + 0");
141   ASSERT_EQ(Tokens.size(), 4u) << Tokens;
142   EXPECT_TOKEN(Tokens[1], tok::plus, TT_BinaryOperator);
143   Tokens = annotate("x + +0");
144   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
145   EXPECT_TOKEN(Tokens[2], tok::plus, TT_UnaryOperator);
146   Tokens = annotate("x ? -0 : +0");
147   ASSERT_EQ(Tokens.size(), 8u) << Tokens;
148   EXPECT_TOKEN(Tokens[2], tok::minus, TT_UnaryOperator);
149   EXPECT_TOKEN(Tokens[5], tok::plus, TT_UnaryOperator);
150   Tokens = annotate("(-0)");
151   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
152   EXPECT_TOKEN(Tokens[1], tok::minus, TT_UnaryOperator);
153   Tokens = annotate("0, -0");
154   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
155   EXPECT_TOKEN(Tokens[2], tok::minus, TT_UnaryOperator);
156   Tokens = annotate("for (; -1;) {\n}");
157   ASSERT_EQ(Tokens.size(), 10u) << Tokens;
158   EXPECT_TOKEN(Tokens[3], tok::minus, TT_UnaryOperator);
159   Tokens = annotate("x = -1;");
160   ASSERT_EQ(Tokens.size(), 6u) << Tokens;
161   EXPECT_TOKEN(Tokens[2], tok::minus, TT_UnaryOperator);
162   Tokens = annotate("x[-1]");
163   ASSERT_EQ(Tokens.size(), 6u) << Tokens;
164   EXPECT_TOKEN(Tokens[2], tok::minus, TT_UnaryOperator);
165   Tokens = annotate("x = {-1};");
166   ASSERT_EQ(Tokens.size(), 8u) << Tokens;
167   EXPECT_TOKEN(Tokens[3], tok::minus, TT_UnaryOperator);
168   Tokens = annotate("case -x:");
169   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
170   EXPECT_TOKEN(Tokens[1], tok::minus, TT_UnaryOperator);
171   Tokens = annotate("co_await -x;");
172   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
173   EXPECT_TOKEN(Tokens[1], tok::minus, TT_UnaryOperator);
174   Tokens = annotate("co_return -x;");
175   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
176   EXPECT_TOKEN(Tokens[1], tok::minus, TT_UnaryOperator);
177   Tokens = annotate("co_yield -x;");
178   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
179   EXPECT_TOKEN(Tokens[1], tok::minus, TT_UnaryOperator);
180   Tokens = annotate("delete -x;");
181   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
182   EXPECT_TOKEN(Tokens[1], tok::minus, TT_UnaryOperator);
183   Tokens = annotate("return -x;");
184   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
185   EXPECT_TOKEN(Tokens[1], tok::minus, TT_UnaryOperator);
186   Tokens = annotate("throw -x;");
187   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
188   EXPECT_TOKEN(Tokens[1], tok::minus, TT_UnaryOperator);
189   Tokens = annotate("sizeof -x");
190   ASSERT_EQ(Tokens.size(), 4u) << Tokens;
191   EXPECT_TOKEN(Tokens[1], tok::minus, TT_UnaryOperator);
192   Tokens = annotate("co_await +x;");
193   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
194   EXPECT_TOKEN(Tokens[1], tok::plus, TT_UnaryOperator);
195   Tokens = annotate("co_return +x;");
196   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
197   EXPECT_TOKEN(Tokens[1], tok::plus, TT_UnaryOperator);
198   Tokens = annotate("co_yield +x;");
199   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
200   EXPECT_TOKEN(Tokens[1], tok::plus, TT_UnaryOperator);
201   Tokens = annotate("delete +x;");
202   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
203   EXPECT_TOKEN(Tokens[1], tok::plus, TT_UnaryOperator);
204   Tokens = annotate("return +x;");
205   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
206   EXPECT_TOKEN(Tokens[1], tok::plus, TT_UnaryOperator);
207   Tokens = annotate("throw +x;");
208   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
209   EXPECT_TOKEN(Tokens[1], tok::plus, TT_UnaryOperator);
210   Tokens = annotate("sizeof +x");
211   ASSERT_EQ(Tokens.size(), 4u) << Tokens;
212   EXPECT_TOKEN(Tokens[1], tok::plus, TT_UnaryOperator);
213   Tokens = annotate("(int)-x");
214   ASSERT_EQ(Tokens.size(), 6u) << Tokens;
215   EXPECT_TOKEN(Tokens[3], tok::minus, TT_UnaryOperator);
216   Tokens = annotate("(-x)");
217   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
218   EXPECT_TOKEN(Tokens[1], tok::minus, TT_UnaryOperator);
219   Tokens = annotate("!+x");
220   ASSERT_EQ(Tokens.size(), 4u) << Tokens;
221   EXPECT_TOKEN(Tokens[0], tok::exclaim, TT_UnaryOperator);
222   EXPECT_TOKEN(Tokens[1], tok::plus, TT_UnaryOperator);
223 }
224 
225 TEST_F(TokenAnnotatorTest, UnderstandsClasses) {
226   auto Tokens = annotate("class C {};");
227   EXPECT_EQ(Tokens.size(), 6u) << Tokens;
228   EXPECT_TOKEN(Tokens[2], tok::l_brace, TT_ClassLBrace);
229 
230   Tokens = annotate("const class C {} c;");
231   EXPECT_EQ(Tokens.size(), 8u) << Tokens;
232   EXPECT_TOKEN(Tokens[3], tok::l_brace, TT_ClassLBrace);
233 
234   Tokens = annotate("const class {} c;");
235   EXPECT_EQ(Tokens.size(), 7u) << Tokens;
236   EXPECT_TOKEN(Tokens[2], tok::l_brace, TT_ClassLBrace);
237 }
238 
239 TEST_F(TokenAnnotatorTest, UnderstandsStructs) {
240   auto Tokens = annotate("struct S {};");
241   EXPECT_EQ(Tokens.size(), 6u) << Tokens;
242   EXPECT_TOKEN(Tokens[2], tok::l_brace, TT_StructLBrace);
243 }
244 
245 TEST_F(TokenAnnotatorTest, UnderstandsUnions) {
246   auto Tokens = annotate("union U {};");
247   EXPECT_EQ(Tokens.size(), 6u) << Tokens;
248   EXPECT_TOKEN(Tokens[2], tok::l_brace, TT_UnionLBrace);
249 
250   Tokens = annotate("union U { void f() { return; } };");
251   EXPECT_EQ(Tokens.size(), 14u) << Tokens;
252   EXPECT_TOKEN(Tokens[2], tok::l_brace, TT_UnionLBrace);
253   EXPECT_TOKEN(Tokens[7], tok::l_brace, TT_FunctionLBrace);
254 }
255 
256 TEST_F(TokenAnnotatorTest, UnderstandsEnums) {
257   auto Tokens = annotate("enum E {};");
258   EXPECT_EQ(Tokens.size(), 6u) << Tokens;
259   EXPECT_TOKEN(Tokens[2], tok::l_brace, TT_EnumLBrace);
260 }
261 
262 TEST_F(TokenAnnotatorTest, UnderstandsDefaultedAndDeletedFunctions) {
263   auto Tokens = annotate("auto operator<=>(const T &) const & = default;");
264   EXPECT_EQ(Tokens.size(), 14u) << Tokens;
265   EXPECT_TOKEN(Tokens[9], tok::amp, TT_PointerOrReference);
266 
267   Tokens = annotate("template <typename T> void F(T) && = delete;");
268   EXPECT_EQ(Tokens.size(), 15u) << Tokens;
269   EXPECT_TOKEN(Tokens[10], tok::ampamp, TT_PointerOrReference);
270 }
271 
272 TEST_F(TokenAnnotatorTest, UnderstandsVariables) {
273   auto Tokens =
274       annotate("inline bool var = is_integral_v<int> && is_signed_v<int>;");
275   EXPECT_EQ(Tokens.size(), 15u) << Tokens;
276   EXPECT_TOKEN(Tokens[8], tok::ampamp, TT_BinaryOperator);
277 }
278 
279 TEST_F(TokenAnnotatorTest, UnderstandsVariableTemplates) {
280   auto Tokens =
281       annotate("template <typename T> "
282                "inline bool var = is_integral_v<int> && is_signed_v<int>;");
283   EXPECT_EQ(Tokens.size(), 20u) << Tokens;
284   EXPECT_TOKEN(Tokens[13], tok::ampamp, TT_BinaryOperator);
285 }
286 
287 TEST_F(TokenAnnotatorTest, UnderstandsTemplatesInMacros) {
288   auto Tokens =
289       annotate("#define FOO(typeName) \\\n"
290                "  { #typeName, foo<FooType>(new foo<realClass>(#typeName)) }");
291   ASSERT_EQ(Tokens.size(), 27u) << Tokens;
292   EXPECT_TOKEN(Tokens[11], tok::less, TT_TemplateOpener);
293   EXPECT_TOKEN(Tokens[13], tok::greater, TT_TemplateCloser);
294   EXPECT_TOKEN(Tokens[17], tok::less, TT_TemplateOpener);
295   EXPECT_TOKEN(Tokens[19], tok::greater, TT_TemplateCloser);
296 }
297 
298 TEST_F(TokenAnnotatorTest, UnderstandsWhitespaceSensitiveMacros) {
299   FormatStyle Style = getLLVMStyle();
300   Style.WhitespaceSensitiveMacros.push_back("FOO");
301 
302   auto Tokens = annotate("FOO(1+2 )\n", Style);
303   EXPECT_EQ(Tokens.size(), 7u) << Tokens;
304   EXPECT_TOKEN(Tokens[0], tok::identifier, TT_UntouchableMacroFunc);
305 
306   Tokens = annotate("FOO(a:b:c)\n", Style);
307   EXPECT_EQ(Tokens.size(), 9u) << Tokens;
308   EXPECT_TOKEN(Tokens[0], tok::identifier, TT_UntouchableMacroFunc);
309 }
310 
311 TEST_F(TokenAnnotatorTest, UnderstandsDelete) {
312   auto Tokens = annotate("delete (void *)p;");
313   EXPECT_EQ(Tokens.size(), 8u) << Tokens;
314   EXPECT_TOKEN(Tokens[4], tok::r_paren, TT_CastRParen);
315 
316   Tokens = annotate("delete[] (void *)p;");
317   EXPECT_EQ(Tokens.size(), 10u) << Tokens;
318   EXPECT_TOKEN(Tokens[6], tok::r_paren, TT_CastRParen);
319 
320   Tokens = annotate("delete[] /*comment*/ (void *)p;");
321   EXPECT_EQ(Tokens.size(), 11u) << Tokens;
322   EXPECT_TOKEN(Tokens[7], tok::r_paren, TT_CastRParen);
323 
324   Tokens = annotate("delete[/*comment*/] (void *)p;");
325   EXPECT_EQ(Tokens.size(), 11u) << Tokens;
326   EXPECT_TOKEN(Tokens[7], tok::r_paren, TT_CastRParen);
327 
328   Tokens = annotate("delete/*comment*/[] (void *)p;");
329   EXPECT_EQ(Tokens.size(), 11u) << Tokens;
330   EXPECT_TOKEN(Tokens[7], tok::r_paren, TT_CastRParen);
331 }
332 
333 TEST_F(TokenAnnotatorTest, UnderstandsCasts) {
334   auto Tokens = annotate("(void)p;");
335   EXPECT_EQ(Tokens.size(), 6u) << Tokens;
336   EXPECT_TOKEN(Tokens[2], tok::r_paren, TT_CastRParen);
337 
338   Tokens = annotate("auto x = (Foo)p;");
339   EXPECT_EQ(Tokens.size(), 9u) << Tokens;
340   EXPECT_TOKEN(Tokens[5], tok::r_paren, TT_CastRParen);
341 
342   Tokens = annotate("(std::vector<int>)p;");
343   EXPECT_EQ(Tokens.size(), 11u) << Tokens;
344   EXPECT_TOKEN(Tokens[7], tok::r_paren, TT_CastRParen);
345 
346   Tokens = annotate("return (Foo)p;");
347   EXPECT_EQ(Tokens.size(), 7u) << Tokens;
348   EXPECT_TOKEN(Tokens[3], tok::r_paren, TT_CastRParen);
349 
350   Tokens = annotate("throw (Foo)p;");
351   EXPECT_EQ(Tokens.size(), 7u) << Tokens;
352   EXPECT_TOKEN(Tokens[3], tok::r_paren, TT_CastRParen);
353 }
354 
355 TEST_F(TokenAnnotatorTest, UnderstandsDynamicExceptionSpecifier) {
356   auto Tokens = annotate("void f() throw(int);");
357   EXPECT_EQ(Tokens.size(), 10u) << Tokens;
358   EXPECT_TOKEN(Tokens[4], tok::kw_throw, TT_Unknown);
359 }
360 
361 TEST_F(TokenAnnotatorTest, UnderstandsFunctionRefQualifiers) {
362   auto Tokens = annotate("void f() &;");
363   EXPECT_EQ(Tokens.size(), 7u) << Tokens;
364   EXPECT_TOKEN(Tokens[4], tok::amp, TT_PointerOrReference);
365 
366   Tokens = annotate("void operator=(T) &&;");
367   EXPECT_EQ(Tokens.size(), 9u) << Tokens;
368   EXPECT_TOKEN(Tokens[6], tok::ampamp, TT_PointerOrReference);
369 
370   Tokens = annotate("template <typename T> void f() &;");
371   EXPECT_EQ(Tokens.size(), 12u) << Tokens;
372   EXPECT_TOKEN(Tokens[9], tok::amp, TT_PointerOrReference);
373 
374   Tokens = annotate("template <typename T> void operator=(T) &;");
375   EXPECT_EQ(Tokens.size(), 14u) << Tokens;
376   EXPECT_TOKEN(Tokens[11], tok::amp, TT_PointerOrReference);
377 }
378 
379 TEST_F(TokenAnnotatorTest, UnderstandsRequiresClausesAndConcepts) {
380   auto Tokens = annotate("template <typename T>\n"
381                          "concept C = (Foo && Bar) && (Bar && Baz);");
382 
383   ASSERT_EQ(Tokens.size(), 21u) << Tokens;
384   EXPECT_TOKEN(Tokens[10], tok::ampamp, TT_BinaryOperator);
385   EXPECT_TOKEN(Tokens[13], tok::ampamp, TT_BinaryOperator);
386   EXPECT_TOKEN(Tokens[16], tok::ampamp, TT_BinaryOperator);
387 
388   Tokens = annotate("template <typename T>\n"
389                     "concept C = Foo && !Bar;");
390 
391   ASSERT_EQ(Tokens.size(), 14u) << Tokens;
392   EXPECT_TOKEN(Tokens[9], tok::ampamp, TT_BinaryOperator);
393   EXPECT_TOKEN(Tokens[10], tok::exclaim, TT_UnaryOperator);
394 
395   Tokens = annotate("template <typename T>\n"
396                     "concept C = requires(T t) {\n"
397                     "  { t.foo() };\n"
398                     "} && Bar<T> && Baz<T>;");
399   ASSERT_EQ(Tokens.size(), 35u) << Tokens;
400   EXPECT_TOKEN(Tokens[8], tok::kw_requires, TT_RequiresExpression);
401   EXPECT_TOKEN(Tokens[9], tok::l_paren, TT_RequiresExpressionLParen);
402   EXPECT_TOKEN(Tokens[13], tok::l_brace, TT_RequiresExpressionLBrace);
403   EXPECT_TOKEN(Tokens[23], tok::ampamp, TT_BinaryOperator);
404   EXPECT_TOKEN(Tokens[28], tok::ampamp, TT_BinaryOperator);
405 
406   Tokens = annotate("template<typename T>\n"
407                     "requires C1<T> && (C21<T> || C22<T> && C2e<T>) && C3<T>\n"
408                     "struct Foo;");
409   ASSERT_EQ(Tokens.size(), 36u) << Tokens;
410   EXPECT_TOKEN(Tokens[5], tok::kw_requires, TT_RequiresClause);
411   EXPECT_TOKEN(Tokens[6], tok::identifier, TT_Unknown);
412   EXPECT_EQ(Tokens[6]->FakeLParens.size(), 1u);
413   EXPECT_TOKEN(Tokens[10], tok::ampamp, TT_BinaryOperator);
414   EXPECT_TOKEN(Tokens[16], tok::pipepipe, TT_BinaryOperator);
415   EXPECT_TOKEN(Tokens[21], tok::ampamp, TT_BinaryOperator);
416   EXPECT_TOKEN(Tokens[27], tok::ampamp, TT_BinaryOperator);
417   EXPECT_TOKEN(Tokens[31], tok::greater, TT_TemplateCloser);
418   EXPECT_EQ(Tokens[31]->FakeRParens, 1u);
419   EXPECT_TRUE(Tokens[31]->ClosesRequiresClause);
420 
421   Tokens =
422       annotate("template<typename T>\n"
423                "requires (C1<T> && (C21<T> || C22<T> && C2e<T>) && C3<T>)\n"
424                "struct Foo;");
425   ASSERT_EQ(Tokens.size(), 38u) << Tokens;
426   EXPECT_TOKEN(Tokens[5], tok::kw_requires, TT_RequiresClause);
427   EXPECT_TOKEN(Tokens[7], tok::identifier, TT_Unknown);
428   EXPECT_EQ(Tokens[7]->FakeLParens.size(), 1u);
429   EXPECT_TOKEN(Tokens[11], tok::ampamp, TT_BinaryOperator);
430   EXPECT_TOKEN(Tokens[17], tok::pipepipe, TT_BinaryOperator);
431   EXPECT_TOKEN(Tokens[22], tok::ampamp, TT_BinaryOperator);
432   EXPECT_TOKEN(Tokens[28], tok::ampamp, TT_BinaryOperator);
433   EXPECT_TOKEN(Tokens[32], tok::greater, TT_TemplateCloser);
434   EXPECT_EQ(Tokens[32]->FakeRParens, 1u);
435   EXPECT_TOKEN(Tokens[33], tok::r_paren, TT_Unknown);
436   EXPECT_TRUE(Tokens[33]->ClosesRequiresClause);
437 
438   Tokens = annotate("template <typename T>\n"
439                     "void foo(T) noexcept requires Bar<T>;");
440   ASSERT_EQ(Tokens.size(), 18u) << Tokens;
441   EXPECT_TOKEN(Tokens[11], tok::kw_requires, TT_RequiresClause);
442 
443   Tokens = annotate("template <typename T>\n"
444                     "requires Bar<T> || Baz<T>\n"
445                     "auto foo(T) -> int;");
446   ASSERT_EQ(Tokens.size(), 24u) << Tokens;
447   EXPECT_TOKEN(Tokens[5], tok::kw_requires, TT_RequiresClause);
448   EXPECT_EQ(Tokens[11]->FakeLParens.size(), 0u);
449   EXPECT_TRUE(Tokens[14]->ClosesRequiresClause);
450   EXPECT_TOKEN(Tokens[20], tok::arrow, TT_TrailingReturnArrow);
451 
452   Tokens = annotate("template <typename T>\n"
453                     "requires Bar<T>\n"
454                     "bool foo(T) { return false; }");
455   ASSERT_EQ(Tokens.size(), 21u) << Tokens;
456   EXPECT_TOKEN(Tokens[5], tok::kw_requires, TT_RequiresClause);
457   EXPECT_TRUE(Tokens[9]->ClosesRequiresClause);
458   EXPECT_TOKEN(Tokens[11], tok::identifier, TT_FunctionDeclarationName);
459 
460   Tokens = annotate("template <typename T>\n"
461                     "struct S {\n"
462                     "  void foo() const requires Bar<T>;\n"
463                     "  void bar() const & requires Baz<T>;\n"
464                     "  void bar() && requires Baz2<T>;\n"
465                     "  void baz() const & noexcept requires Baz<T>;\n"
466                     "  void baz() && noexcept requires Baz2<T>;\n"
467                     "};\n"
468                     "\n"
469                     "void S::bar() const & requires Baz<T> { }");
470   ASSERT_EQ(Tokens.size(), 85u) << Tokens;
471   EXPECT_TOKEN(Tokens[13], tok::kw_requires, TT_RequiresClause);
472   EXPECT_TOKEN(Tokens[25], tok::kw_requires, TT_RequiresClause);
473   EXPECT_TOKEN(Tokens[36], tok::kw_requires, TT_RequiresClause);
474   EXPECT_TOKEN(Tokens[49], tok::kw_requires, TT_RequiresClause);
475   EXPECT_TOKEN(Tokens[61], tok::kw_requires, TT_RequiresClause);
476   EXPECT_TOKEN(Tokens[77], tok::kw_requires, TT_RequiresClause);
477 
478   Tokens = annotate("void Class::member() && requires(Constant) {}");
479   ASSERT_EQ(Tokens.size(), 14u) << Tokens;
480   EXPECT_TOKEN(Tokens[7], tok::kw_requires, TT_RequiresClause);
481 
482   Tokens = annotate("void Class::member() && requires(Constant<T>) {}");
483   ASSERT_EQ(Tokens.size(), 17u) << Tokens;
484   EXPECT_TOKEN(Tokens[7], tok::kw_requires, TT_RequiresClause);
485 
486   Tokens =
487       annotate("void Class::member() && requires(Namespace::Constant<T>) {}");
488   ASSERT_EQ(Tokens.size(), 19u) << Tokens;
489   EXPECT_TOKEN(Tokens[7], tok::kw_requires, TT_RequiresClause);
490 
491   Tokens = annotate("void Class::member() && requires(typename "
492                     "Namespace::Outer<T>::Inner::Constant) {}");
493   ASSERT_EQ(Tokens.size(), 24u) << Tokens;
494   EXPECT_TOKEN(Tokens[7], tok::kw_requires, TT_RequiresClause);
495 
496   Tokens = annotate("struct [[nodiscard]] zero_t {\n"
497                     "  template<class T>\n"
498                     "    requires requires { number_zero_v<T>; }\n"
499                     "  [[nodiscard]] constexpr operator T() const { "
500                     "return number_zero_v<T>; }\n"
501                     "};");
502   ASSERT_EQ(Tokens.size(), 44u);
503   EXPECT_TOKEN(Tokens[13], tok::kw_requires, TT_RequiresClause);
504   EXPECT_TOKEN(Tokens[14], tok::kw_requires, TT_RequiresExpression);
505   EXPECT_TOKEN(Tokens[15], tok::l_brace, TT_RequiresExpressionLBrace);
506   EXPECT_TOKEN(Tokens[21], tok::r_brace, TT_Unknown);
507   EXPECT_EQ(Tokens[21]->MatchingParen, Tokens[15]);
508   EXPECT_TRUE(Tokens[21]->ClosesRequiresClause);
509 
510   Tokens =
511       annotate("template <class A, class B> concept C ="
512                "std::same_as<std::iter_value_t<A>, std::iter_value_t<B>>;");
513   ASSERT_EQ(Tokens.size(), 31u) << Tokens;
514   EXPECT_TOKEN(Tokens[8], tok::kw_concept, TT_Unknown);
515   EXPECT_TOKEN(Tokens[14], tok::less, TT_TemplateOpener);
516   EXPECT_TOKEN(Tokens[18], tok::less, TT_TemplateOpener);
517   EXPECT_TOKEN(Tokens[20], tok::greater, TT_TemplateCloser);
518   EXPECT_TOKEN(Tokens[25], tok::less, TT_TemplateOpener);
519   EXPECT_TOKEN(Tokens[27], tok::greater, TT_TemplateCloser);
520   EXPECT_TOKEN(Tokens[28], tok::greater, TT_TemplateCloser);
521 
522   Tokens = annotate("auto bar() -> int requires(is_integral_v<T>) {}");
523   ASSERT_EQ(Tokens.size(), 16u) << Tokens;
524   EXPECT_TOKEN(Tokens[6], tok::kw_requires, TT_RequiresClause);
525 
526   Tokens = annotate("auto bar() -> void requires(is_integral_v<T>) {}");
527   ASSERT_EQ(Tokens.size(), 16u) << Tokens;
528   EXPECT_TOKEN(Tokens[6], tok::kw_requires, TT_RequiresClause);
529 
530   Tokens = annotate("auto bar() -> MyType requires(is_integral_v<T>) {}");
531   ASSERT_EQ(Tokens.size(), 16u) << Tokens;
532   EXPECT_TOKEN(Tokens[6], tok::kw_requires, TT_RequiresClause);
533 
534   Tokens =
535       annotate("auto bar() -> SOME_MACRO_TYPE requires(is_integral_v<T>) {}");
536   ASSERT_EQ(Tokens.size(), 16u) << Tokens;
537   EXPECT_TOKEN(Tokens[6], tok::kw_requires, TT_RequiresClause);
538 
539   Tokens =
540       annotate("auto bar() -> qualified::type requires(is_integral_v<T>) {}");
541   ASSERT_EQ(Tokens.size(), 18u) << Tokens;
542   EXPECT_TOKEN(Tokens[8], tok::kw_requires, TT_RequiresClause);
543 
544   Tokens =
545       annotate("auto bar() -> Template<type> requires(is_integral_v<T>) {}");
546   ASSERT_EQ(Tokens.size(), 19u) << Tokens;
547   EXPECT_TOKEN(Tokens[9], tok::kw_requires, TT_RequiresClause);
548 }
549 
550 TEST_F(TokenAnnotatorTest, UnderstandsRequiresExpressions) {
551   auto Tokens = annotate("bool b = requires(int i) { i + 5; };");
552   ASSERT_EQ(Tokens.size(), 16u) << Tokens;
553   EXPECT_TOKEN(Tokens[3], tok::kw_requires, TT_RequiresExpression);
554   EXPECT_TOKEN(Tokens[4], tok::l_paren, TT_RequiresExpressionLParen);
555   EXPECT_TOKEN(Tokens[8], tok::l_brace, TT_RequiresExpressionLBrace);
556 
557   Tokens = annotate("if (requires(int i) { i + 5; }) return;");
558   ASSERT_EQ(Tokens.size(), 17u) << Tokens;
559   EXPECT_TOKEN(Tokens[2], tok::kw_requires, TT_RequiresExpression);
560   EXPECT_TOKEN(Tokens[3], tok::l_paren, TT_RequiresExpressionLParen);
561   EXPECT_TOKEN(Tokens[7], tok::l_brace, TT_RequiresExpressionLBrace);
562 
563   Tokens = annotate("if (func() && requires(int i) { i + 5; }) return;");
564   ASSERT_EQ(Tokens.size(), 21u) << Tokens;
565   EXPECT_TOKEN(Tokens[6], tok::kw_requires, TT_RequiresExpression);
566   EXPECT_TOKEN(Tokens[7], tok::l_paren, TT_RequiresExpressionLParen);
567   EXPECT_TOKEN(Tokens[11], tok::l_brace, TT_RequiresExpressionLBrace);
568 
569   Tokens = annotate("foo(requires(const T t) {});");
570   ASSERT_EQ(Tokens.size(), 13u) << Tokens;
571   EXPECT_TOKEN(Tokens[2], tok::kw_requires, TT_RequiresExpression);
572   EXPECT_TOKEN(Tokens[3], tok::l_paren, TT_RequiresExpressionLParen);
573   EXPECT_TOKEN(Tokens[8], tok::l_brace, TT_RequiresExpressionLBrace);
574 
575   Tokens = annotate("foo(requires(const int t) {});");
576   ASSERT_EQ(Tokens.size(), 13u) << Tokens;
577   EXPECT_TOKEN(Tokens[2], tok::kw_requires, TT_RequiresExpression);
578   EXPECT_TOKEN(Tokens[3], tok::l_paren, TT_RequiresExpressionLParen);
579   EXPECT_TOKEN(Tokens[8], tok::l_brace, TT_RequiresExpressionLBrace);
580 
581   Tokens = annotate("foo(requires(const T t) {});");
582   ASSERT_EQ(Tokens.size(), 13u) << Tokens;
583   EXPECT_TOKEN(Tokens[2], tok::kw_requires, TT_RequiresExpression);
584   EXPECT_TOKEN(Tokens[3], tok::l_paren, TT_RequiresExpressionLParen);
585   EXPECT_TOKEN(Tokens[8], tok::l_brace, TT_RequiresExpressionLBrace);
586 
587   Tokens = annotate("foo(requires(int const* volatile t) {});");
588   ASSERT_EQ(Tokens.size(), 15u) << Tokens;
589   EXPECT_TOKEN(Tokens[2], tok::kw_requires, TT_RequiresExpression);
590   EXPECT_TOKEN(Tokens[3], tok::l_paren, TT_RequiresExpressionLParen);
591   EXPECT_TOKEN(Tokens[10], tok::l_brace, TT_RequiresExpressionLBrace);
592 
593   Tokens = annotate("foo(requires(T const* volatile t) {});");
594   ASSERT_EQ(Tokens.size(), 15u) << Tokens;
595   EXPECT_TOKEN(Tokens[2], tok::kw_requires, TT_RequiresExpression);
596   EXPECT_TOKEN(Tokens[3], tok::l_paren, TT_RequiresExpressionLParen);
597   EXPECT_TOKEN(Tokens[10], tok::l_brace, TT_RequiresExpressionLBrace);
598 
599   Tokens =
600       annotate("foo(requires(const typename Outer<T>::Inner * const t) {});");
601   ASSERT_EQ(Tokens.size(), 21u) << Tokens;
602   EXPECT_TOKEN(Tokens[2], tok::kw_requires, TT_RequiresExpression);
603   EXPECT_TOKEN(Tokens[3], tok::l_paren, TT_RequiresExpressionLParen);
604   EXPECT_TOKEN(Tokens[16], tok::l_brace, TT_RequiresExpressionLBrace);
605 
606   Tokens = annotate("template <typename T>\n"
607                     "concept C = requires(T T) {\n"
608                     "  requires Bar<T> && Foo<T>;\n"
609                     "};");
610   ASSERT_EQ(Tokens.size(), 28u) << Tokens;
611   EXPECT_TOKEN(Tokens[8], tok::kw_requires, TT_RequiresExpression);
612   EXPECT_TOKEN(Tokens[9], tok::l_paren, TT_RequiresExpressionLParen);
613   EXPECT_TOKEN(Tokens[13], tok::l_brace, TT_RequiresExpressionLBrace);
614   EXPECT_TOKEN(Tokens[14], tok::kw_requires,
615                TT_RequiresClauseInARequiresExpression);
616 
617   Tokens = annotate("template <typename T>\n"
618                     "concept C = requires(T T) {\n"
619                     "  { t.func() } -> std::same_as<int>;"
620                     "  requires Bar<T> && Foo<T>;\n"
621                     "};");
622   ASSERT_EQ(Tokens.size(), 43u) << Tokens;
623   EXPECT_TOKEN(Tokens[8], tok::kw_requires, TT_RequiresExpression);
624   EXPECT_TOKEN(Tokens[9], tok::l_paren, TT_RequiresExpressionLParen);
625   EXPECT_TOKEN(Tokens[13], tok::l_brace, TT_RequiresExpressionLBrace);
626   EXPECT_TOKEN(Tokens[29], tok::kw_requires,
627                TT_RequiresClauseInARequiresExpression);
628 
629   // Invalid Code, but we don't want to crash. See http://llvm.org/PR54350.
630   Tokens = annotate("bool r10 = requires (struct new_struct { int x; } s) { "
631                     "requires true; };");
632   ASSERT_EQ(Tokens.size(), 21u) << Tokens;
633   EXPECT_TOKEN(Tokens[3], tok::kw_requires, TT_RequiresExpression);
634   EXPECT_TOKEN(Tokens[4], tok::l_paren, TT_RequiresExpressionLParen);
635   EXPECT_TOKEN(Tokens[14], tok::l_brace, TT_RequiresExpressionLBrace);
636 }
637 
638 TEST_F(TokenAnnotatorTest, RequiresDoesNotChangeParsingOfTheRest) {
639   const char *BaseCode = nullptr;
640   const char *ConstrainedCode = nullptr;
641   auto BaseTokenCount = 0u;
642   auto RequiresTokenCount = 0u;
643   auto PrefixTokenCount = 0u;
644 
645   auto TestRequires = [&](int Line) {
646     const auto BaseTokens = annotate(BaseCode);
647     const auto ConstrainedTokens = annotate(ConstrainedCode);
648 
649 #define LINE " (Line " << Line << ')'
650 
651     ASSERT_EQ(BaseTokens.size(), BaseTokenCount) << BaseTokens << LINE;
652     ASSERT_EQ(ConstrainedTokens.size(), BaseTokenCount + RequiresTokenCount)
653         << LINE;
654 
655     for (auto I = 0u; I < BaseTokenCount; ++I) {
656       EXPECT_EQ(
657           *BaseTokens[I],
658           *ConstrainedTokens[I < PrefixTokenCount ? I : I + RequiresTokenCount])
659           << I << LINE;
660     }
661 
662 #undef LINE
663   };
664 
665   BaseCode = "template<typename T>\n"
666              "T Pi = 3.14;";
667   ConstrainedCode = "template<typename T>\n"
668                     "  requires Foo<T>\n"
669                     "T Pi = 3.14;";
670   BaseTokenCount = 11;
671   RequiresTokenCount = 5;
672   PrefixTokenCount = 5;
673   TestRequires(__LINE__);
674 
675   BaseCode = "template<typename T>\n"
676              "struct Bar;";
677   ConstrainedCode = "template<typename T>\n"
678                     "  requires Foo<T>\n"
679                     "struct Bar;";
680   BaseTokenCount = 9;
681   TestRequires(__LINE__);
682 
683   BaseCode = "template<typename T>\n"
684              "struct Bar {\n"
685              "  T foo();\n"
686              "  T bar();\n"
687              "};";
688   ConstrainedCode = "template<typename T>\n"
689                     "  requires Foo<T>\n"
690                     "struct Bar {\n"
691                     "  T foo();\n"
692                     "  T bar();\n"
693                     "};";
694   BaseTokenCount = 21;
695   TestRequires(__LINE__);
696 
697   BaseCode = "template<typename T>\n"
698              "Bar(T) -> Bar<T>;";
699   ConstrainedCode = "template<typename T>\n"
700                     "  requires Foo<T>\n"
701                     "Bar(T) -> Bar<T>;";
702   BaseTokenCount = 16;
703   TestRequires(__LINE__);
704 
705   BaseCode = "template<typename T>\n"
706              "T foo();";
707   ConstrainedCode = "template<typename T>\n"
708                     "  requires Foo<T>\n"
709                     "T foo();";
710   BaseTokenCount = 11;
711   TestRequires(__LINE__);
712 
713   BaseCode = "template<typename T>\n"
714              "T foo() {\n"
715              "  auto bar = baz();\n"
716              "  return bar + T{};\n"
717              "}";
718   ConstrainedCode = "template<typename T>\n"
719                     "  requires Foo<T>\n"
720                     "T foo() {\n"
721                     "  auto bar = baz();\n"
722                     "  return bar + T{};\n"
723                     "}";
724   BaseTokenCount = 26;
725   TestRequires(__LINE__);
726 
727   BaseCode = "template<typename T>\n"
728              "T foo();";
729   ConstrainedCode = "template<typename T>\n"
730                     "T foo() requires Foo<T>;";
731   BaseTokenCount = 11;
732   PrefixTokenCount = 9;
733   TestRequires(__LINE__);
734 
735   BaseCode = "template<typename T>\n"
736              "T foo() {\n"
737              "  auto bar = baz();\n"
738              "  return bar + T{};\n"
739              "}";
740   ConstrainedCode = "template<typename T>\n"
741                     "T foo() requires Foo<T> {\n"
742                     "  auto bar = baz();\n"
743                     "  return bar + T{};\n"
744                     "}";
745   BaseTokenCount = 26;
746   TestRequires(__LINE__);
747 
748   BaseCode = "template<typename T>\n"
749              "T foo();";
750   ConstrainedCode = "template<typename T>\n"
751                     "  requires(Foo<T>)\n"
752                     "T foo();";
753   BaseTokenCount = 11;
754   RequiresTokenCount = 7;
755   PrefixTokenCount = 5;
756   TestRequires(__LINE__);
757 
758   BaseCode = "template<typename T>\n"
759              "Bar(T) -> Bar<typename T::I>;";
760   ConstrainedCode = "template<typename T>\n"
761                     "  requires requires(T &&t) {\n"
762                     "             typename T::I;\n"
763                     "           }\n"
764                     "Bar(T) -> Bar<typename T::I>;";
765   BaseTokenCount = 19;
766   RequiresTokenCount = 14;
767   PrefixTokenCount = 5;
768   TestRequires(__LINE__);
769 
770   BaseCode = "struct [[nodiscard]] zero_t {\n"
771              "  template<class T>\n"
772              "  [[nodiscard]] constexpr operator T() const { return v<T>; }\n"
773              "};";
774   ConstrainedCode =
775       "struct [[nodiscard]] zero_t {\n"
776       "  template<class T>\n"
777       "    requires requires { v<T>; }\n"
778       "  [[nodiscard]] constexpr operator T() const { return v<T>; }\n"
779       "};";
780   BaseTokenCount = 35;
781   RequiresTokenCount = 9;
782   PrefixTokenCount = 13;
783   TestRequires(__LINE__);
784 
785   BaseCode = "constexpr Foo(Foo const &other)\n"
786              "    : value{other.value} {\n"
787              "  do_magic();\n"
788              "  do_more_magic();\n"
789              "}";
790   ConstrainedCode = "constexpr Foo(Foo const &other)\n"
791                     "  requires std::is_copy_constructible<T>\n"
792                     "    : value{other.value} {\n"
793                     "  do_magic();\n"
794                     "  do_more_magic();\n"
795                     "}";
796   BaseTokenCount = 26;
797   RequiresTokenCount = 7;
798   PrefixTokenCount = 8;
799   TestRequires(__LINE__);
800 
801   BaseCode = "constexpr Foo(Foo const &other)\n"
802              "    : value{other.value} {\n"
803              "  do_magic();\n"
804              "  do_more_magic();\n"
805              "}";
806   ConstrainedCode = "constexpr Foo(Foo const &other)\n"
807                     "  requires (std::is_copy_constructible<T>)\n"
808                     "    : value{other.value} {\n"
809                     "  do_magic();\n"
810                     "  do_more_magic();\n"
811                     "}";
812   RequiresTokenCount = 9;
813   TestRequires(__LINE__);
814 }
815 
816 TEST_F(TokenAnnotatorTest, UnderstandsAsm) {
817   auto Tokens = annotate("__asm{\n"
818                          "a:\n"
819                          "};");
820   ASSERT_EQ(Tokens.size(), 7u) << Tokens;
821   EXPECT_TOKEN(Tokens[0], tok::kw_asm, TT_Unknown);
822   EXPECT_TOKEN(Tokens[1], tok::l_brace, TT_InlineASMBrace);
823   EXPECT_TOKEN(Tokens[4], tok::r_brace, TT_InlineASMBrace);
824 }
825 
826 TEST_F(TokenAnnotatorTest, UnderstandsObjCBlock) {
827   auto Tokens = annotate("int (^)() = ^ ()\n"
828                          "  external_source_symbol() { //\n"
829                          "  return 1;\n"
830                          "};");
831   ASSERT_EQ(Tokens.size(), 21u) << Tokens;
832   EXPECT_TOKEN(Tokens[1], tok::l_paren, TT_ObjCBlockLParen);
833   EXPECT_TOKEN(Tokens[13], tok::l_brace, TT_ObjCBlockLBrace);
834 
835   Tokens = annotate("int *p = ^int*(){ //\n"
836                     "  return nullptr;\n"
837                     "}();");
838   ASSERT_EQ(Tokens.size(), 19u) << Tokens;
839   EXPECT_TOKEN(Tokens[9], tok::l_brace, TT_ObjCBlockLBrace);
840 }
841 
842 TEST_F(TokenAnnotatorTest, UnderstandsLambdas) {
843   auto Tokens = annotate("[]() constexpr {}");
844   ASSERT_EQ(Tokens.size(), 8u) << Tokens;
845   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
846   EXPECT_TOKEN(Tokens[5], tok::l_brace, TT_LambdaLBrace);
847 
848   Tokens = annotate("[]() consteval {}");
849   ASSERT_EQ(Tokens.size(), 8u) << Tokens;
850   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
851   EXPECT_TOKEN(Tokens[5], tok::l_brace, TT_LambdaLBrace);
852 
853   Tokens = annotate("[]() mutable {}");
854   ASSERT_EQ(Tokens.size(), 8u) << Tokens;
855   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
856   EXPECT_TOKEN(Tokens[5], tok::l_brace, TT_LambdaLBrace);
857 
858   Tokens = annotate("[]() static {}");
859   ASSERT_EQ(Tokens.size(), 8u) << Tokens;
860   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
861   EXPECT_TOKEN(Tokens[5], tok::l_brace, TT_LambdaLBrace);
862 
863   Tokens = annotate("[]() -> auto {}");
864   ASSERT_EQ(Tokens.size(), 9u) << Tokens;
865   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
866   EXPECT_TOKEN(Tokens[4], tok::arrow, TT_LambdaArrow);
867   EXPECT_TOKEN(Tokens[6], tok::l_brace, TT_LambdaLBrace);
868 
869   Tokens = annotate("[]() -> auto & {}");
870   ASSERT_EQ(Tokens.size(), 10u) << Tokens;
871   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
872   EXPECT_TOKEN(Tokens[4], tok::arrow, TT_LambdaArrow);
873   EXPECT_TOKEN(Tokens[7], tok::l_brace, TT_LambdaLBrace);
874 
875   Tokens = annotate("[]() -> auto * {}");
876   ASSERT_EQ(Tokens.size(), 10u) << Tokens;
877   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
878   EXPECT_TOKEN(Tokens[4], tok::arrow, TT_LambdaArrow);
879   EXPECT_TOKEN(Tokens[7], tok::l_brace, TT_LambdaLBrace);
880 
881   Tokens = annotate("[] {}");
882   ASSERT_EQ(Tokens.size(), 5u) << Tokens;
883   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
884   EXPECT_TOKEN(Tokens[2], tok::l_brace, TT_LambdaLBrace);
885 
886   Tokens = annotate("[] noexcept {}");
887   ASSERT_EQ(Tokens.size(), 6u) << Tokens;
888   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
889   EXPECT_TOKEN(Tokens[3], tok::l_brace, TT_LambdaLBrace);
890 
891   Tokens = annotate("[] -> auto {}");
892   ASSERT_EQ(Tokens.size(), 7u) << Tokens;
893   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
894   EXPECT_TOKEN(Tokens[2], tok::arrow, TT_LambdaArrow);
895   EXPECT_TOKEN(Tokens[4], tok::l_brace, TT_LambdaLBrace);
896 
897   Tokens = annotate("[] <typename T> () {}");
898   ASSERT_EQ(Tokens.size(), 11u) << Tokens;
899   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
900   EXPECT_TOKEN(Tokens[2], tok::less, TT_TemplateOpener);
901   EXPECT_TOKEN(Tokens[8], tok::l_brace, TT_LambdaLBrace);
902 
903   Tokens = annotate("[] <typename T> {}");
904   ASSERT_EQ(Tokens.size(), 9u) << Tokens;
905   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
906   EXPECT_TOKEN(Tokens[2], tok::less, TT_TemplateOpener);
907   EXPECT_TOKEN(Tokens[6], tok::l_brace, TT_LambdaLBrace);
908 
909   Tokens = annotate("[] <typename... T> () {}");
910   ASSERT_EQ(Tokens.size(), 12u) << Tokens;
911   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
912   EXPECT_TOKEN(Tokens[2], tok::less, TT_TemplateOpener);
913   EXPECT_TOKEN(Tokens[9], tok::l_brace, TT_LambdaLBrace);
914 
915   Tokens = annotate("[] <typename... T> {}");
916   ASSERT_EQ(Tokens.size(), 10u) << Tokens;
917   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
918   EXPECT_TOKEN(Tokens[2], tok::less, TT_TemplateOpener);
919   EXPECT_TOKEN(Tokens[7], tok::l_brace, TT_LambdaLBrace);
920 
921   Tokens = annotate("[] <int... T> () {}");
922   ASSERT_EQ(Tokens.size(), 12u) << Tokens;
923   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
924   EXPECT_TOKEN(Tokens[2], tok::less, TT_TemplateOpener);
925   EXPECT_TOKEN(Tokens[9], tok::l_brace, TT_LambdaLBrace);
926 
927   Tokens = annotate("[] <int... T> {}");
928   ASSERT_EQ(Tokens.size(), 10u) << Tokens;
929   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
930   EXPECT_TOKEN(Tokens[2], tok::less, TT_TemplateOpener);
931   EXPECT_TOKEN(Tokens[7], tok::l_brace, TT_LambdaLBrace);
932 
933   Tokens = annotate("[] <Foo... T> () {}");
934   ASSERT_EQ(Tokens.size(), 12u) << Tokens;
935   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
936   EXPECT_TOKEN(Tokens[2], tok::less, TT_TemplateOpener);
937   EXPECT_TOKEN(Tokens[9], tok::l_brace, TT_LambdaLBrace);
938 
939   Tokens = annotate("[] <Foo... T> {}");
940   ASSERT_EQ(Tokens.size(), 10u) << Tokens;
941   EXPECT_TOKEN(Tokens[0], tok::l_square, TT_LambdaLSquare);
942   EXPECT_TOKEN(Tokens[2], tok::less, TT_TemplateOpener);
943   EXPECT_TOKEN(Tokens[7], tok::l_brace, TT_LambdaLBrace);
944 }
945 
946 TEST_F(TokenAnnotatorTest, UnderstandsFunctionAnnotations) {
947   auto Tokens = annotate("template <typename T>\n"
948                          "DEPRECATED(\"Use NewClass::NewFunction instead.\")\n"
949                          "string OldFunction(const string &parameter) {}");
950   ASSERT_EQ(Tokens.size(), 20u) << Tokens;
951   EXPECT_TOKEN(Tokens[8], tok::r_paren, TT_FunctionAnnotationRParen);
952 
953   Tokens = annotate("template <typename T>\n"
954                     "A(T) noexcept;");
955   ASSERT_EQ(Tokens.size(), 12u) << Tokens;
956   EXPECT_TOKEN(Tokens[8], tok::r_paren, TT_Unknown);
957 }
958 
959 TEST_F(TokenAnnotatorTest, UnderstandsVerilogOperators) {
960   auto Annotate = [this](llvm::StringRef Code) {
961     return annotate(Code, getLLVMStyle(FormatStyle::LK_Verilog));
962   };
963   // Test that unary operators get labeled as such and that operators like '++'
964   // don't get split.
965   tok::TokenKind Unary[] = {tok::plus,  tok::minus,    tok::exclaim,
966                             tok::tilde, tok::amp,      tok::pipe,
967                             tok::caret, tok::plusplus, tok::minusminus};
968   for (auto Kind : Unary) {
969     auto Tokens =
970         Annotate(std::string("x = ") + tok::getPunctuatorSpelling(Kind) + "x;");
971     ASSERT_EQ(Tokens.size(), 6u) << Tokens;
972     EXPECT_TOKEN(Tokens[2], Kind, TT_UnaryOperator);
973   }
974   // Operators formed by joining two operators like '^~'. For some of these
975   // joined operators, we don't have a separate type, so we only test for their
976   // precedence.
977   std::pair<prec::Level, std::string> JoinedBinary[] = {
978       {prec::Comma, "<->"},       {prec::Assignment, "+="},
979       {prec::Assignment, "-="},   {prec::Assignment, "*="},
980       {prec::Assignment, "/="},   {prec::Assignment, "%="},
981       {prec::Assignment, "&="},   {prec::Assignment, "^="},
982       {prec::Assignment, "<<="},  {prec::Assignment, ">>="},
983       {prec::Assignment, "<<<="}, {prec::Assignment, ">>>="},
984       {prec::LogicalOr, "||"},    {prec::LogicalAnd, "&&"},
985       {prec::Equality, "=="},     {prec::Equality, "!="},
986       {prec::Equality, "==="},    {prec::Equality, "!=="},
987       {prec::Equality, "==?"},    {prec::Equality, "!=?"},
988       {prec::ExclusiveOr, "~^"},  {prec::ExclusiveOr, "^~"},
989   };
990   for (auto Operator : JoinedBinary) {
991     auto Tokens = Annotate(std::string("x = x ") + Operator.second + " x;");
992     ASSERT_EQ(Tokens.size(), 7u) << Tokens;
993     EXPECT_TOKEN_TYPE(Tokens[3], TT_BinaryOperator);
994     EXPECT_TOKEN_PRECEDENCE(Tokens[3], Operator.first);
995   }
996   // '~^' and '^~' can be unary as well as binary operators.
997   auto Tokens = Annotate("x = ~^x;");
998   ASSERT_EQ(Tokens.size(), 6u) << Tokens;
999   EXPECT_TOKEN_TYPE(Tokens[2], TT_UnaryOperator);
1000   Tokens = Annotate("x = ^~x;");
1001   ASSERT_EQ(Tokens.size(), 6u) << Tokens;
1002   EXPECT_TOKEN_TYPE(Tokens[2], TT_UnaryOperator);
1003   // The unary operators '~&' and '~|' can only be unary operators. The current
1004   // implementation treats each of them as separate unary '~' and '&' or '|'
1005   // operators, which is enough for formatting purposes. In FormatTestVerilog,
1006   // there is a test that there is no space in between. And even if a new line
1007   // is inserted between the '~' and '|', the semantic meaning is the same as
1008   // the joined operator, so the CanBreakBefore property doesn't need to be
1009   // false for the second operator.
1010   Tokens = Annotate("x = ~&x;");
1011   ASSERT_EQ(Tokens.size(), 7u) << Tokens;
1012   EXPECT_TOKEN(Tokens[2], tok::tilde, TT_UnaryOperator);
1013   EXPECT_TOKEN(Tokens[3], tok::amp, TT_UnaryOperator);
1014   Tokens = Annotate("x = ~|x;");
1015   ASSERT_EQ(Tokens.size(), 7u) << Tokens;
1016   EXPECT_TOKEN(Tokens[2], tok::tilde, TT_UnaryOperator);
1017   EXPECT_TOKEN(Tokens[3], tok::pipe, TT_UnaryOperator);
1018   // Test for block label colons.
1019   Tokens = Annotate("begin : x\n"
1020                     "end : x");
1021   ASSERT_EQ(Tokens.size(), 7u);
1022   EXPECT_TOKEN(Tokens[1], tok::colon, TT_VerilogBlockLabelColon);
1023   EXPECT_TOKEN(Tokens[4], tok::colon, TT_VerilogBlockLabelColon);
1024   // Test that the dimension colon is annotated correctly.
1025   Tokens = Annotate("var [1 : 0] x;");
1026   ASSERT_EQ(Tokens.size(), 9u) << Tokens;
1027   EXPECT_TOKEN(Tokens[3], tok::colon, TT_BitFieldColon);
1028   Tokens = Annotate("extern function [1 : 0] x;");
1029   ASSERT_EQ(Tokens.size(), 10u) << Tokens;
1030   EXPECT_TOKEN(Tokens[4], tok::colon, TT_BitFieldColon);
1031   // Test case labels and ternary operators.
1032   Tokens = Annotate("case (x)\n"
1033                     "  x:\n"
1034                     "    x;\n"
1035                     "endcase\n");
1036   ASSERT_EQ(Tokens.size(), 10u) << Tokens;
1037   EXPECT_TOKEN(Tokens[5], tok::colon, TT_GotoLabelColon);
1038   Tokens = Annotate("case (x)\n"
1039                     "  x ? x : x:\n"
1040                     "    x;\n"
1041                     "endcase\n");
1042   ASSERT_EQ(Tokens.size(), 14u) << Tokens;
1043   EXPECT_TOKEN(Tokens[5], tok::question, TT_ConditionalExpr);
1044   EXPECT_TOKEN(Tokens[7], tok::colon, TT_ConditionalExpr);
1045   EXPECT_TOKEN(Tokens[9], tok::colon, TT_GotoLabelColon);
1046 }
1047 
1048 } // namespace
1049 } // namespace format
1050 } // namespace clang
1051